peaks-loop 4.0.0-beta.5 → 4.0.0-beta.7

package/CHANGELOG.md

@@ -2,6 +2,68 @@
 
 ## [Unreleased]
 
+## 4.0.0-beta.7 — 2026-07-09
+
+### Added — zcode adapter (9th IDE) + runtime model detection
+
+- **`peaks ide model --current` CLI** — `src/cli/commands/ide-commands.ts` (80 lines) + register in `src/cli/program.ts`. Outputs `{ modelId, detected, registeredAdapters }`. Available as a top-level primitive (not adapter-specific).
+- **`detectCurrentIdeModel()` service** — `src/services/ide/current-model-detector.ts` (43 lines). Walks the adapter registry in insertion order, calls each adapter's optional `detectCurrentModel()` with try/catch isolation — one bad adapter cannot poison the chain.
+- **zcode-adapter `detectCurrentModel()` method** — `src/services/ide/adapters/zcode-adapter.ts`. Reads `~/.zcode/v2/config.json`, resolves active provider via 4-tier priority chain (env override → non-`builtin:` provider → first enabled → first provider), returns the model's id. Live test: `peaks ide model --current` against a real z-code installation → `"modelId": "M3"`.
+- **`IdeAdapter` interface optional field** — `readonly detectCurrentModel?: () => Promise<string | undefined>` in `src/services/ide/ide-types.ts`. Back-compat: 8 existing adapters without the field are unaffected.
+- **`getStrongestModelIdAsync()` async variant** — `src/services/config/model-routing.ts`. Sync `getStrongestModelId()` is unchanged (rd-service compat); new async variant lets future async callers fall back to runtime probe instead of `'claude-opus-4-7'`.
+
+### Changed — install no longer writes hardcoded default model
+
+- **`scripts/install-skills.mjs`** — removed `model: 'sonnet'` default and `providers.minimax.model` default from `createConfigDefaults()`. After install, `~/.peaks/config.json` no longer contains a Claude model recommendation; users set their own via `peaks config set model <id>` (or leave unset and the back-compat fallback applies).
+- **`STRONGEST_MODEL_ID` constant removed** — replaced by `getStrongestModelId(config?)` function in `src/services/config/model-routing.ts`. Resolution order: `config.model` → `PEAKS_STRONGEST_MODEL_DEFAULT` env var → back-compat `'claude-opus-4-7'`.
+- **`workflow-router-service.ts` / `minimax-worker-service.ts` / `rd-service.ts`** — threaded dynamic modelId through 16 call sites in `workflow-router-service.ts`, replaced literal `'claude-opus-4-7'` in `minimax-worker-service.ts` (×2) and `rd-service.ts`.
+
+### Added — zcode IDE (peaks-loop's 9th)
+
+- **`IdeId` union type** — `'zcode'` added in `src/services/ide/ide-types.ts`.
+- **`ZCODE_ADAPTER`** — new `src/services/ide/adapters/zcode-adapter.ts` (98 lines). Template: `claude-code-adapter.ts` with `compact.compactCommand` / `hookEvent` / `toolMatcher` / `envVar` degraded (z-code is a desktop application, no CLI binary; UNVERIFIED sentinel strings used where the interface requires non-optional types).
+- **`IDE_DETECTION_DIRS` + `IDE_SKILL_INSTALL_PROFILES`** — `scripts/install-skills.mjs`. New `{ id: 'zcode', dir: '.zcode' }` detection entry + zcode profile (skillsDir `~/.zcode/skills`, env override `PEAKS_ZCODE_SKILLS_DIR`).
+- **`ide-registry.ts`** — registers `ZCODE_ADAPTER` alongside the existing 8 adapters (claude-code / trae / trae-cn / codex / cursor / qoder / tongyi-lingma / hermes / openclaw).
+- **`tests/unit/ide/zcode-adapter.test.ts`** — 10 cases (T-1 id, T-2 dirName, T-3 standards rootFile = `CLAUDE.md`, T-4 rulesDir = `.claude/rules`, T-5 skillsDir, T-6 compactCommand undefined, T-7 hookEvent is string, T-8 type test, T-9 IDE_DETECTION_DIRS contains, T-10 IDE_SKILL_INSTALL_PROFILES contains).
+- **`tests/unit/ide/zcode-adapter-detect-model.test.ts`** — 14 cases (pure resolver + env-fixture file IO + path helper).
+- **`tests/unit/cli/ide-commands.test.ts`** — 5 cases (CLI + top-level command registration).
+- **Fixture sync** — `tests/unit/install-skills-script.test.ts` + `tests/unit/cli-program.workflow.test.ts` (Strategy A: env-var override, no hardcoded literals) + `tests/unit/ide/ide-registry.test.ts` (whitelist 6 → 7 adapters).
+
+### Documentation — SKILL.md sync with 4.0.0-beta.6 CLI reality
+
+- **`skills/peaks-code/SKILL.md`** — added inline `> CLI reality check` blocks at §Step 0.8 (D-001 `peaks code detect-job` is `peaks job init`), §Step 0.8 third paragraph (D-003 `JOB_SHAPE_NOT_DECIDED` is now passive `done: 0` warning, not exception), §Step 2.5 (D-002 `peaks session title` takes positional sid, not `--session-id` flag), §Step 11c + 11d (D-010 `<!-- peaks-memory:start -->` block requires YAML frontmatter `title:` + `kind:` + `---` + closing `<!-- peaks-memory:end -->`, otherwise `extractedCount: 0` silently). New **§CLI Drift Index** section after Boundaries provides single landing page for D-001/002/003/010 with inline-anchor table.
+- **`skills/peaks-slice-decompose/SKILL.md`** — new **§SC template hard rules (sediment 2026-07-09)** section with 3 rules: Rule 1 ESM/CJS pre-flight before specifying export syntax (D-009c), Rule 2 whitelist fixture sync is a primary task not collateral (D-009a), Rule 3 adapter-interface optional fields > required (D-009b reciprocal).
+
+### Verification (4.0.0-beta.7)
+
+- `pnpm tsc -p tsconfig.json --noEmit` — 0 errors
+- `pnpm vitest run tests/unit/ide/ tests/unit/cli/ide-commands.test.ts` — 15 files / 211 tests / 0 failed
+- `peaks workflow verify-pipeline --rid 003-add-zcode-adapter` — `ok=true, complete=true`, 9/9 gate PASS
+- `node bin/peaks.js ide model --current` (against real z-code installation) — `modelId: "M3"`, `detected: true`
+
+### Sediment (Step 11) — 7 lessons in `.peaks/memory/`
+
+| File | Topic |
+|---|---|
+| `z-code-peaks-loop-9-ide-adapter-vendor-neutrality-adapter.md` | z-code 9th IDE + vendor-neutrality adapter pattern |
+| `peaks-loop-install-model-getstrongestmodelid-fallback.md` | install no longer hardcodes default model |
+| `desktop-application-ide-adapter-z-code-cli.md` | desktop-app IDE adapter field-degradation decision |
+| `peaks-code-runbook-4-0-0-beta-6-skill-md-cli-d-001-d-002-d-003-d-010.md` | 4 SKILL.md / CLI drift points |
+| `2026-07-09-zcode-adapter-overview.md` | RID 003 overall summary (project record) |
+| `peaks-ide-runtime-detect-zcode-only.md` | `peaks ide model --current` z-code 4-tier priority chain |
+| `ide-adapter-detectcurrentmodel-optional-interface-pattern.md` | optional interface field extension pattern |
+
+### Known follow-ups (S3-cleanup backlog)
+
+- **Slice C extension** — other 8 IDEs' `detectCurrentModel()` (claude-code / trae / cursor / codex / qoder / tongyi-lingma / hermes / openclaw). Currently only z-code has a working detector; all 8 still fall through to the back-compat `'claude-opus-4-7'`.
+- **zai / GLM provider entry** — `D-008`: peaks-loop has no built-in provider entry for z-code's default `builtin:zai` (GLM) or `builtin:bigmodel` providers. Users on those providers must add custom `provider.<uuid>` entries to their `~/.peaks/config.json` themselves.
+- **zcode-adapter UNVERIFIED sentinel values** — `hookEvent: 'PreToolUse'`, `toolMatcher: 'Bash'`, `envVar: 'ZCODE_PROJECT_DIR'` are placeholder guesses based on Anthropic-compatible protocol. Real z-code desktop application dogfood will reveal the actual values; replace once known.
+- **`IdeAdapter` interface optional fields** — `D-009b` proposes converting `hookEvent` / `toolMatcher` / `envVar` to optional types, or adding an `unverified: boolean` flag, so future adapters with unknown protocols don't need to fabricate sentinel values.
+
+### Breaking changes
+
+None. All 8 pre-existing adapters continue to load without changes. CLI subcommands `peaks ide *` and `peaks ide model --current` are additive.
+
 ## 4.0.0-beta.5 — 2026-07-08
 
 ### Added — peaks-solo dispatcher (分诊员)

package/dist/src/cli/commands/adapter-commands-s2a.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `peaks adapter *` — vendor adapter registry CLI surface.
+ *
+ * Slice S2-a of RD-2 (2026-07-08 session). Two subcommands:
+ *
+ *   list     — list registered user adapters (persisted at
+ *              `.peaks/runtime/adapters.json`).
+ *   register — register a new adapter. Vendor verb strings live in
+ *              the binary the user picks, NOT in peaks-loop source.
+ *
+ * This file coexists with the older `adapter-commands.ts` (slice
+ * 2026-07-04-cli-15a) which exposes `peaks skill adapter <verb>` —
+ * a different surface for skill materialization (resolveScratchDir /
+ * materialize / publish). The two surfaces do NOT collide because
+ * one is `peaks skill adapter` and the other is `peaks adapter`.
+ */
+import type { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+export interface AdapterListOptions {
+    json?: boolean;
+    project?: string;
+}
+export interface AdapterRegisterOptions {
+    json?: boolean;
+    id?: string;
+    /** Display name override (defaults to the id). */
+    name?: string;
+    binary?: string;
+    /** Repeated --arg values. */
+    arg?: string[];
+    force?: boolean;
+    project?: string;
+}
+export declare function registerAdapterS2ACommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/adapter-commands-s2a.js

@@ -0,0 +1,92 @@
+import { existsSync } from 'node:fs';
+import { addJsonOption, printResult } from '../cli-helpers.js';
+import { fail, ok, getErrorMessage } from '../../shared/result.js';
+import { AdapterRegistry } from '../../services/adapter/adapter-registry.js';
+import { registryFileFor } from './runtime-commands.js';
+function resolveProjectRoot(explicit) {
+    if (explicit !== undefined && explicit.length > 0)
+        return explicit;
+    return process.cwd();
+}
+export function registerAdapterS2ACommands(program, io) {
+    const adapter = program
+        .command('adapter')
+        .description('Vendor adapter registry (user-registered, persisted to .peaks/runtime/adapters.json)');
+    // -----------------------------------------------------------------
+    // 1. peaks adapter list [--json] [--project <root>]
+    // -----------------------------------------------------------------
+    addJsonOption(adapter
+        .command('list')
+        .description('List user-registered vendor adapters')
+        .option('--project <path>', 'project root (defaults to cwd)')).action((options) => {
+        try {
+            const projectRoot = resolveProjectRoot(options.project);
+            const file = registryFileFor(projectRoot);
+            const reg = new AdapterRegistry();
+            if (existsSync(file))
+                reg.load(file);
+            const records = reg.list();
+            printResult(io, ok('adapter.list', { projectRoot, file, records, count: records.length }, [], [
+                records.length === 0
+                    ? 'No adapters registered yet. Run `peaks adapter register --id <vendor> --binary <cmd>` to add one.'
+                    : `Run \`peaks runtime compact --via <id>\` to invoke a registered adapter.`
+            ]), options.json);
+        }
+        catch (error) {
+            printResult(io, fail('adapter.list', 'ADAPTER_LIST_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        }
+    });
+    // -----------------------------------------------------------------
+    // 2. peaks adapter register --id <id> --binary <cmd> [--arg <a>]... [--force]
+    // -----------------------------------------------------------------
+    addJsonOption(adapter
+        .command('register')
+        .description('Register a new vendor adapter; persists to .peaks/runtime/adapters.json')
+        .requiredOption('--id <id>', 'vendor adapter id (lowercase, e.g. my-cli)')
+        .option('--name <name>', 'human-readable display name (defaults to <id>)')
+        .requiredOption('--binary <cmd>', 'binary name to invoke for compact (e.g. my-cli)')
+        .option('--arg <value>', 'extra arg appended before --force (repeatable)', (value, previous = []) => [...previous, value])
+        .option('--force', 'overwrite an existing adapter with the same id')
+        .option('--project <path>', 'project root (defaults to cwd)')).action((options) => {
+        try {
+            const projectRoot = resolveProjectRoot(options.project);
+            const file = registryFileFor(projectRoot);
+            const reg = new AdapterRegistry();
+            if (existsSync(file))
+                reg.load(file);
+            const id = options.id ?? '';
+            const record = options.arg !== undefined
+                ? { id, displayName: options.name ?? id, binary: options.binary ?? '', args: options.arg }
+                : { id, displayName: options.name ?? id, binary: options.binary ?? '' };
+            let result;
+            try {
+                result = reg.register(record, { force: options.force === true });
+            }
+            catch (validationError) {
+                printResult(io, fail('adapter.register', 'INVALID_ADAPTER_RECORD', getErrorMessage(validationError), { id }, [
+                    'Use --id with /^[a-z0-9][a-z0-9._-]*$/, --binary as a binary name (no path separators).'
+                ]), options.json);
+                process.exitCode = 1;
+                return;
+            }
+            reg.persist(file);
+            const warnings = [];
+            if (!result.created && options.force !== true) {
+                warnings.push(`adapter "${id}" already registered; pass --force to overwrite`);
+            }
+            printResult(io, ok('adapter.register', {
+                projectRoot,
+                file,
+                adapter: result.record,
+                created: result.created
+            }, warnings, [
+                `Run \`peaks runtime compact --via ${id}\` to invoke it.`
+            ]), options.json);
+        }
+        catch (error) {
+            printResult(io, fail('adapter.register', 'ADAPTER_REGISTER_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/cli/commands/ide-commands.d.ts

@@ -0,0 +1,25 @@
+/**
+ * peaks ide * CLI (Slice 2026-07-09 add-zcode-adapter, Slice C).
+ *
+ * Slice C adds ONE verb:
+ *
+ *   peaks ide model --current
+ *
+ * Outputs the currently-active model id detected from the host
+ * environment (so far: only the `zcode` adapter opts in via
+ * `IdeAdapter.detectCurrentModel?`). The CLI is the read-only
+ * debugging surface for runtime model probing. It does NOT set any
+ * state — `peaks config set model` remains the canonical write path.
+ *
+ * Future slices will extend this surface with `peaks ide list`,
+ * `peaks ide detect`, etc. — this slice keeps the surface minimal
+ * (per Karpathy guideline #2 — Simplicity First).
+ *
+ * Vendor-neutrality: this file delegates to
+ * `src/services/ide/current-model-detector.ts` which walks every
+ * registered adapter. This file does NOT import any specific
+ * adapter.
+ */
+import { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+export declare function registerIdeCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/ide-commands.js

@@ -0,0 +1,42 @@
+import { detectCurrentIdeModel } from '../../services/ide/current-model-detector.js';
+import { addJsonOption, printResult } from '../cli-helpers.js';
+import { fail, ok } from '../../shared/result.js';
+import { listAdapterIds } from '../../services/ide/ide-registry.js';
+export function registerIdeCommands(program, io) {
+    const ide = program.command('ide').description('Read-only introspection helpers for the registered IDE adapter layer (slice 2026-07-09 add-zcode-adapter, Slice C)');
+    addJsonOption(ide
+        .command('model')
+        .description('Inspect the IDE adapter model surface. Slice C supports `--current` only.')
+        .option('--current', 'Print the model id the active IDE adapter reports as currently configured')
+        .action(async (options) => {
+        if (options.current) {
+            await runIdeModelCurrent(io, options);
+            return;
+        }
+        // No verb supplied — Commander would normally show help; we
+        // emit a structured error instead so the JSON envelope stays
+        // consistent for LLM callers.
+        printResult(io, fail('ide.model', 'MISSING_VERB', 'Specify a verb: --current. Future slices may add --configured / --default.', { registeredAdapters: listAdapterIds() }, ['Rerun with --current to read the runtime-detected model id.']), options.json);
+    }));
+}
+async function runIdeModelCurrent(io, options) {
+    try {
+        const modelId = await detectCurrentIdeModel();
+        if (modelId === undefined) {
+            printResult(io, ok('ide.model.current', {
+                modelId: null,
+                detected: false,
+                registeredAdapters: listAdapterIds(),
+            }), options.json);
+            return;
+        }
+        printResult(io, ok('ide.model.current', {
+            modelId,
+            detected: true,
+            registeredAdapters: listAdapterIds(),
+        }), options.json);
+    }
+    catch (error) {
+        printResult(io, fail('ide.model.current', 'DETECTION_FAILED', 'Runtime model detection failed; falling back to configured model. See logs.', { error: error instanceof Error ? error.message : String(error) }, ['Check `PEAKS_LOG_LEVEL=debug peaks ide model --current` for the underlying error.']), options.json);
+    }
+}

package/dist/src/cli/commands/polyrepo-commands.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `peaks polyrepo *` — polyrepo workflow CLI surface.
+ *
+ * Slice S2-b of RD-2 (2026-07-08 session). Three subcommands:
+ *
+ *   init      — scan the parent dir for child git repos + write a
+ *               polyrepo manifest to `.peaks/polyrepo.json`.
+ *   status    — read the persisted manifest + report children.
+ *   dispatch  — mirror a PRD/RD/QA artifact from the parent into
+ *               each target child's
+ *               `.peaks/_runtime/<sid>/<role>/` directory.
+ *
+ * Per the project's two-axis convention, all reviewable artifacts
+ * live under `.peaks/_runtime/<sid>/<role>/` — never as top-level
+ * siblings of `.peaks/_runtime/`.
+ */
+import type { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+export interface PolyrepoInitOptions {
+    json?: boolean;
+    root?: string;
+    children?: string;
+}
+export interface PolyrepoStatusOptions {
+    json?: boolean;
+    root?: string;
+}
+export interface PolyrepoDispatchOptions {
+    json?: boolean;
+    root?: string;
+    rid?: string;
+    to?: string;
+    role?: 'prd' | 'rd' | 'qa';
+    artifact?: string;
+    sid?: string;
+}
+export declare function registerPolyrepoCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/polyrepo-commands.js

@@ -0,0 +1,155 @@
+import { existsSync } from 'node:fs';
+import { addJsonOption, printResult } from '../cli-helpers.js';
+import { fail, ok, getErrorMessage } from '../../shared/result.js';
+import { PolyrepoService } from '../../services/polyrepo/polyrepo-service.js';
+function parseChildren(raw) {
+    if (raw === undefined || raw.length === 0)
+        return undefined;
+    return raw.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function resolveRoot(explicit) {
+    if (explicit !== undefined && explicit.length > 0)
+        return explicit;
+    return process.cwd();
+}
+export function registerPolyrepoCommands(program, io) {
+    const polyrepo = program
+        .command('polyrepo')
+        .description('Polyrepo workflow (parent dir + child git repos with their own .peaks/ subsets)');
+    // -----------------------------------------------------------------
+    // 1. peaks polyrepo init [--children <dir1,dir2>] [--root <dir>]
+    // -----------------------------------------------------------------
+    addJsonOption(polyrepo
+        .command('init')
+        .description('Scan the parent dir for child git repos and write .peaks/polyrepo.json')
+        .option('--children <list>', 'comma-separated child directory names (defaults to auto-discovery)')
+        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
+        try {
+            const root = resolveRoot(options.root);
+            const svc = new PolyrepoService();
+            const children = parseChildren(options.children);
+            const result = children === undefined
+                ? svc.init({ root })
+                : svc.init({ root, children });
+            printResult(io, ok('polyrepo.init', {
+                root: result.manifest.root,
+                detectedAt: result.manifest.detectedAt,
+                children: result.manifest.children,
+                manifestPath: `${result.manifest.root}/.peaks/polyrepo.json`,
+                created: result.created
+            }, [], [
+                result.manifest.children.length === 0
+                    ? 'No child git repos detected. Pass --children <dir1,dir2> to override.'
+                    : `Run \`peaks polyrepo dispatch --rid <rid> --to <child-id>\` to mirror an artifact into one or more children.`
+            ]), options.json);
+        }
+        catch (error) {
+            printResult(io, fail('polyrepo.init', 'POLYREPO_INIT_FAILED', getErrorMessage(error), {}, ['Verify --root exists and is a directory']), options.json);
+            process.exitCode = 1;
+        }
+    });
+    // -----------------------------------------------------------------
+    // 2. peaks polyrepo status [--root <dir>]
+    // -----------------------------------------------------------------
+    addJsonOption(polyrepo
+        .command('status')
+        .description('Report the persisted polyrepo manifest + children')
+        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
+        try {
+            const root = resolveRoot(options.root);
+            const svc = new PolyrepoService();
+            const result = svc.status(root);
+            if (!result.manifestExists) {
+                printResult(io, ok('polyrepo.status', { ...result, initialized: false }, [], [
+                    'No polyrepo manifest found. Run `peaks polyrepo init [--children <list>]` first.'
+                ]), options.json);
+                return;
+            }
+            printResult(io, ok('polyrepo.status', { ...result, initialized: true }, [], [
+                result.children.length === 0
+                    ? 'Manifest exists but has no children. Re-run `peaks polyrepo init --children <list>`.'
+                    : `Run \`peaks polyrepo dispatch --rid <rid> --to <child-id>\` to mirror an artifact.`
+            ]), options.json);
+        }
+        catch (error) {
+            printResult(io, fail('polyrepo.status', 'POLYREPO_STATUS_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        }
+    });
+    // -----------------------------------------------------------------
+    // 3. peaks polyrepo dispatch --rid <rid> [--to <child-id>] --role <prd|rd|qa> --artifact <path>
+    // -----------------------------------------------------------------
+    addJsonOption(polyrepo
+        .command('dispatch')
+        .description('Mirror a PRD/RD/QA artifact from the parent into one or more children')
+        .requiredOption('--rid <rid>', 'request id (used in the on-disk filename)')
+        .option('--to <list>', 'comma-separated child ids (defaults to all children in the manifest)')
+        .requiredOption('--role <role>', 'artifact role: prd | rd | qa')
+        .requiredOption('--artifact <path>', 'source artifact path (relative to --root or absolute)')
+        .option('--sid <sid>', 'session id override (defaults to the canonical binding)')
+        .option('--root <path>', 'parent root (defaults to cwd)')).action((options) => {
+        try {
+            const root = resolveRoot(options.root);
+            const sid = options.sid ?? 'default';
+            const rid = options.rid ?? '';
+            const role = options.role;
+            if (role !== 'prd' && role !== 'rd' && role !== 'qa') {
+                printResult(io, fail('polyrepo.dispatch', 'INVALID_ROLE', `--role must be prd | rd | qa (got "${role}")`, {}, [
+                    'Re-run with --role prd (or rd / qa).'
+                ]), options.json);
+                process.exitCode = 1;
+                return;
+            }
+            const artifact = options.artifact ?? '';
+            if (!existsSync(artifact)) {
+                printResult(io, fail('polyrepo.dispatch', 'ARTIFACT_NOT_FOUND', `source artifact does not exist: ${artifact}`, {}, [
+                    'Verify the path or pass an absolute path.'
+                ]), options.json);
+                process.exitCode = 1;
+                return;
+            }
+            // Resolve targets from the manifest first so we can default to
+            // "all children" when --to is omitted.
+            const svc = new PolyrepoService();
+            const status = svc.status(root);
+            if (!status.manifestExists) {
+                printResult(io, fail('polyrepo.dispatch', 'NO_MANIFEST', `no polyrepo manifest at ${root}/.peaks/polyrepo.json`, {}, [
+                    'Run `peaks polyrepo init` first.'
+                ]), options.json);
+                process.exitCode = 1;
+                return;
+            }
+            let targets;
+            if (options.to !== undefined && options.to.length > 0) {
+                targets = options.to.split(',').map((s) => s.trim()).filter((s) => s.length > 0);
+            }
+            else {
+                targets = status.children.map((c) => c.id);
+            }
+            const result = svc.dispatch(root, {
+                sid, rid, targets, role, artifactPath: artifact
+            });
+            const allOk = result.perChild.every((c) => c.ok);
+            printResult(io, ok('polyrepo.dispatch', {
+                root,
+                sid,
+                rid,
+                role,
+                artifact,
+                dispatch: result.dispatch,
+                perChild: result.perChild,
+                allOk
+            }, result.warnings, [
+                allOk
+                    ? `Mirrored artifact to ${result.perChild.length} child(ren).`
+                    : `One or more child mirrors failed; inspect perChild[].ok.`
+            ]), options.json);
+            if (!allOk)
+                process.exitCode = 1;
+        }
+        catch (error) {
+            printResult(io, fail('polyrepo.dispatch', 'POLYREPO_DISPATCH_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/cli/commands/runtime-commands.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `peaks runtime *` — vendor-runtime detection + compact CLI surface.
+ *
+ * Slice S2-a of RD-2 (2026-07-08 session). Four subcommands:
+ *
+ *   detect    — print which vendor is the active AI runtime
+ *               (claude-code / codex / copilot / unknown).
+ *   list      — list the built-in vendor adapters registered by
+ *               RuntimeService (Claude Code / Codex / Copilot).
+ *   compact   — invoke a vendor's compact verb via the adapter. The
+ *               adapter (NOT this file) chooses the vendor verb;
+ *               see src/services/runtime/vendors/<vendor>.ts.
+ *
+ * Vendor verb strings (`claude --compact`, `codex --compact`,
+ * `copilot compact`) MUST live ONLY in `src/services/runtime/vendors/`
+ * — verified by AC-1: `rg -n "claude --compact|codex --compact|copilot
+ * compact" src/services/code/` returns 0 matches.
+ *
+ * `peaks runtime compact --via <id>` first consults the user
+ * adapter registry (`.peaks/runtime/adapters.json`) for the id, then
+ * falls back to the built-in adapter list. Missing vendor CLI
+ * surfaces as exitCode=127 + warning, NOT as a fatal error — vendor
+ * neutrality demands peaks-loop stay alive.
+ */
+import type { Command } from 'commander';
+import { join } from 'node:path';
+import { type ProgramIO } from '../cli-helpers.js';
+export interface RuntimeDetectOptions {
+    json?: boolean;
+}
+export interface RuntimeListOptions {
+    json?: boolean;
+}
+export interface RuntimeCompactOptions {
+    json?: boolean;
+    /** Vendor adapter id (built-in or registered). */
+    via?: string;
+    force?: boolean;
+    /** Override the project root (defaults to .peaks runtime lookup). */
+    project?: string;
+}
+export declare function registerRuntimeCommands(program: Command, io: ProgramIO): void;
+/** Internal helper exposed for tests + future programmatic callers:
+ *  resolve the registry file location, ensuring the parent dir
+ *  exists. Idempotent. */
+export declare function ensureRegistryDir(registryFile: string): void;
+/** Internal helper for tests: locate the registry file under the
+ *  given project root. Thin wrapper so tests can stub the resolution. */
+export declare function registryFileFor(projectRoot: string): string;
+/** Re-export the path join helper for completeness; not strictly
+ *  needed by callers but keeps the module self-contained. */
+export { join };