feat(rrlab): declarative plugin shape

[rqbazan]

Summary

Three logically-grouped changes that the squash unified:

1. Declarative plugin shape (decision 009).
2. Dogfooding oxc({ only: ['tsc'] }) at the repo root.
3. tsgolint cleanup the dogfood swap surfaced (19 warnings → 0).

---

1. Declarative plugin shape — decision 009

Plugins now declare capabilities (a { kind: service } map) instead of implementing an imperative setup().

Kernel (@rrlab/cli/plugin):

• definePlugin centralizes only narrowing, typed against keyof ReturnType<capabilities>.
• Bin probes are deduplicated across services that share a pkg.
• A single canonical "requires X to be installed" error is emitted when a peer-installed tool is missing.
• New helpers decideScaffold and pickPreset absorb the install-time prompts that were duplicated across plugins.

Discipline:

• test/integration/plugin-discipline.test.ts enforces (via AST/regex scan over each plugin's sources) that plugin code does not touch ctx.prompts directly.

UX:

• rr check's help summary lists the actual underlying tools instead of the generic (run-run) label — e.g. (biome, oxlint) when biome composes jsc and oxc provides tsc.
• Composed providers flatten: biome + biome → biome.
• @rrlab/oxc-plugin drops the oxlint:tsc UI qualifier — it was inconsistent with how biome (3 capabilities) and ts (1 capability) label themselves; the command name already disambiguates the mode.

Decisions log:

• 007 (per-plugin only) → Superseded by 009.
• 008 (@rrlab/plugin package split) → Rejected (record preserved for the reasoning).
• decisions/README.md adds Rejected as a fourth status.

---

2. Dogfooded oxc({ only: ['tsc'] })

• Root run-run.config.mts swaps ts() for oxc({ only: ['tsc'] }).
• rr tsc now runs oxlint --type-aware --type-check via oxlint-tsgolint instead of TypeScript's tsc.
• Adds oxlint, oxfmt, and oxlint-tsgolint as workspace-root devDependencies.

This is the exact configuration the centralized only narrowing was designed for, so the swap also validates the kernel work in (1).

---

3. tsgolint cleanup — 19 warnings → 0 across 8 packages

run-run/cli:

• Doctor, Formatter, Linter, StaticChecker, TypeChecker, Packer switch from method syntax to function-typed property syntax in types/tool.ts and plugin/types.ts. Reflects reality — none of the impls bind this — and fixes 7 unbound-method warnings in composed-jsc.test.ts where vi.mocked(linter.lint) / expect(formatter.format) were flagged.
• PluginDefinition.install / uninstall annotated with this: void in define-plugin.ts to satisfy unbound-method when forwarded as property references.
• plugins.ts drops ?? {} fallbacks in spreads (3 unicorn(no-useless-fallback-in-spread) warnings).
• plugins.ts:215 stringifies the unknown branch in a template literal with String(err) (restrict-template-expressions).
• ctx.ts:57 captures plugin.apiVersion to a got: number local before the guard so the template literal isn't typed never.

shared/loggy:

• LogFnOptions | unknown → LogFnOptions | string in info, trace, warn, start, success. The | unknown collapsed to unknown, losing design intent; | string matches the actual call sites.
• New LogFn type in types.ts codifies the signature. AnyLogger's log methods upgrade from AnyLogFn (permissive) to LogFn so consumers get useful parameter typing instead of unknown[]. debug and error stay as AnyLogFn — they don't take LogFnOptions.

IDE:

• .vscode/settings.json enables oxc.typeAware: true so the IDE matches the CLI's tsgolint behaviour.

---

Test plan

• pnpm rr check (lint + format + tsc) green across all 8 packages — 0 warnings, 0 errors under oxc({ only: ['tsc'] }).
• pnpm test green — new tests: define-plugin, bin-probe, decide-scaffold, pick-preset, only, plugin-discipline, plus per-plugin setup.test.ts.
• Lefthook pre-commit (jscheck + tscheck) passed on the squashed commit.
• Manual smoke: rr check --help shows real tool names (e.g. (biome, oxlint)) instead of (run-run).
• Manual smoke: install a plugin with a missing peer tool, confirm the canonical "requires X to be installed" error appears once.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 9887d65

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
@rrlab/biome-plugin	Major
@rrlab/oxc-plugin	Major
@rrlab/ts-plugin	Major
@rrlab/tsdown-plugin	Major
@rrlab/cli	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vland-bot]

Preview release

Latest commit: 9887d65

Some packages have been released:

Package	Version	Install
@rrlab/biome-plugin	0.1.2-git-9887d65.0	@rrlab/biome-plugin@0.1.2-git-9887d65.0
@rrlab/cli	0.0.4-git-9887d65.0	@rrlab/cli@0.0.4-git-9887d65.0
@rrlab/oxc-plugin	0.1.2-git-9887d65.0	@rrlab/oxc-plugin@0.1.2-git-9887d65.0
@rrlab/ts-plugin	0.1.2-git-9887d65.0	@rrlab/ts-plugin@0.1.2-git-9887d65.0
@rrlab/tsdown-plugin	0.1.2-git-9887d65.0	@rrlab/tsdown-plugin@0.1.2-git-9887d65.0
@vlandoss/loggy	0.2.2-git-9887d65.0	@vlandoss/loggy@0.2.2-git-9887d65.0
@vlandoss/vland	0.3.1-git-9887d65.0	@vlandoss/vland@0.3.1-git-9887d65.0

Note

Use the PR number as tag to install any package. For instance:

pnpm add @rrlab/biome-plugin@pr-229