peaks-loop 4.1.1 → 4.1.3

package/dist/cli/commands/loop-eval-spec-lint-command.js

@@ -0,0 +1,42 @@
+import { lintSpecFile } from '../../services/loop/spec-service.js';
+import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
+import { fail, ok } from 'peaks-loop-shared/result';
+import { loopSpecParent } from './loop-eval-parents.js';
+export function registerLoopSpecLintCommand(program, io) {
+    const spec = loopSpecParent(program);
+    addJsonOption(spec
+        .command('lint')
+        .description('Slice E.2: schema-validate a spec.yaml file (path required).')
+        .argument('<file>', 'path to spec.yaml')
+        .option('--rid <rid>', 'override the rid embedded in the spec (default: inferred from path)')).action((file, options) => runLoopSpecLint(file, options, io));
+}
+function reportLoopSpecLintFailure(io, error, file, asJson) {
+    printResult(io, fail('loop.spec.lint', 'LOOP_SPEC_LINT_FAILED', getErrorMessage(error), { file }, [
+        'Verify the file path and rid flag.'
+    ]), asJson);
+    process.exitCode = 1;
+}
+function runLoopSpecLint(file, options, io) {
+    try {
+        const result = lintSpecFile(file, options.rid);
+        if (result.spec === null) {
+            printResult(io, fail('loop.spec.lint', 'SPEC_LINT_FAILED', result.report.errors.join('; '), { file, raw: result.raw.slice(0, 200) }, ['Verify the file path and YAML syntax.']), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        printResult(io, ok('loop.spec.lint', {
+            file,
+            spec: result.spec,
+            lint: {
+                ok: result.report.ok,
+                errors: result.report.errors,
+                warnings: result.report.warnings
+            }
+        }, [], []), options.json);
+        if (!result.report.ok)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        reportLoopSpecLintFailure(io, error, file, options.json);
+    }
+}

package/dist/cli/commands/loop-eval-workflow-commands.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+export declare function registerWorkflowEvalWorkflowCommands(program: Command, io: ProgramIO): void;

package/dist/cli/commands/loop-eval-workflow-commands.js

@@ -0,0 +1,141 @@
+import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
+import { fail, ok } from 'peaks-loop-shared/result';
+import { resolveWorkflow, planWorkflow, planWorkflowRun } from '../../services/workflow/workflow-loader.js';
+import { findProjectRoot } from '../../services/config/config-safety.js';
+import { workflowCommandParent } from './loop-eval-parents.js';
+export function registerWorkflowEvalWorkflowCommands(program, io) {
+    const workflow = workflowCommandParent(program);
+    // peaks workflow run <id>
+    addJsonOption(workflow
+        .command('run')
+        .description('Slice A.3: replay a captured workflow (.peaks/workflows/<id>.yaml) deterministically. Returns the run-plan order + per-phase status without re-deriving the phase plan.')
+        .argument('<id>', 'workflow id (matches .peaks/workflows/<id>.yaml)')
+        .requiredOption('--session <sid>', 'session id (from peaks workspace init)')
+        .option('--project <path>', 'project root (default: cwd)')).action((id, options) => runWorkflowRun(id, options, io));
+    // peaks workflow graph <id>  (dry-run graph render)
+    // Renamed from `plan` to `graph` to avoid collision with the existing
+    // `peaks workflow plan <read|refresh|detect-trigger>` family registered
+    // Reuse the existing `graph` parent if `registerWorkflowLifecycleCommand`
+    // already created one (it owns `peaks workflow graph show|list`).
+    const existingGraph = workflow.commands.find((c) => c.name() === 'graph');
+    const graphParent = existingGraph ??
+        workflow
+            .command('graph')
+            .description('workflow graph read commands (slice A.3 dry-run + slice 4.0.8 lifecycle)');
+    addJsonOption(graphParent
+        .description('Slice A.3 dry-run: render the workflow graph (phases + parallel groups + evaluators + budget). No phase is executed.')
+        .argument('<id>', 'workflow id')
+        .requiredOption('--session <sid>', 'session id')
+        .option('--project <path>', 'project root (default: cwd)')).action((id, options) => runWorkflowGraph(id, options, io));
+    // peaks workflow lint <id>
+    addJsonOption(workflow
+        .command('lint')
+        .description('Slice A.3: validate a workflow spec (phases / gates / evaluators / parallel groups / budget).')
+        .argument('<id>', 'workflow id')
+        .requiredOption('--session <sid>', 'session id')
+        .option('--project <path>', 'project root (default: cwd)')).action((id, options) => runWorkflowLint(id, options, io));
+}
+function reportWorkflowRunFailure(io, error, sessionId, asJson) {
+    printResult(io, fail('workflow.run', 'WORKFLOW_RUN_FAILED', getErrorMessage(error), { sessionId }, [
+        'Verify the workflow id and session binding.'
+    ]), asJson);
+    process.exitCode = 1;
+}
+function reportWorkflowGraphFailure(io, error, sessionId, asJson) {
+    printResult(io, fail('workflow.graph', 'WORKFLOW_GRAPH_FAILED', getErrorMessage(error), { sessionId }, [
+        'Verify the workflow id and session binding.'
+    ]), asJson);
+    process.exitCode = 1;
+}
+function reportWorkflowLintFailure(io, error, sessionId, asJson) {
+    printResult(io, fail('workflow.lint', 'WORKFLOW_LINT_FAILED', getErrorMessage(error), { sessionId }, [
+        'Verify the workflow file syntax.'
+    ]), asJson);
+    process.exitCode = 1;
+}
+function workflowRunData(sessionId, resolved, runPlan) {
+    return {
+        sessionId,
+        workflow: { id: resolved.spec.id, label: resolved.spec.label, source: resolved.source },
+        runPlan,
+        lintWarnings: resolved.lint.warnings
+    };
+}
+function workflowGraphData(sessionId, graph, resolved) {
+    return {
+        sessionId,
+        graph,
+        lintWarnings: resolved.lint.warnings
+    };
+}
+function runWorkflowRun(id, options, io) {
+    try {
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
+        const resolved = resolveWorkflow(projectRoot, id);
+        if (resolved.source.kind === 'missing') {
+            printResult(io, fail('workflow.run', 'WORKFLOW_NOT_FOUND', `workflow "${id}" not found`, { sessionId: options.session }, [`peaks workflow lint ${id} --session ${options.session} --json`]), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        if (!resolved.lint.ok) {
+            printResult(io, fail('workflow.run', 'WORKFLOW_LINT_FAILED', `workflow "${id}" has ${resolved.lint.errors.length} lint error(s): ${resolved.lint.errors.join('; ')}`, resolved.lint, [`peaks workflow lint ${id} --session ${options.session} --json`]), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        const runPlan = planWorkflowRun(resolved.spec);
+        const data = workflowRunData(options.session, resolved, runPlan);
+        const actions = [
+            `Run \`peaks workflow plan ${id} --session ${options.session} --json\` to preview the graph.`
+        ];
+        printResult(io, ok('workflow.run', data, [], actions), options.json);
+    }
+    catch (error) {
+        reportWorkflowRunFailure(io, error, options.session, options.json);
+    }
+}
+function runWorkflowGraph(id, options, io) {
+    try {
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
+        const resolved = resolveWorkflow(projectRoot, id);
+        if (resolved.source.kind === 'missing') {
+            printResult(io, fail('workflow.graph', 'WORKFLOW_NOT_FOUND', `workflow "${id}" not found`, { sessionId: options.session }, [`Create .peaks/workflows/${id}.yaml or use the bundled default-fullauto-md.`]), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        if (!resolved.lint.ok) {
+            printResult(io, fail('workflow.graph', 'WORKFLOW_LINT_FAILED', `workflow "${id}" has ${resolved.lint.errors.length} lint error(s): ${resolved.lint.errors.join('; ')}`, resolved.lint, [`peaks workflow lint ${id} --session ${options.session} --json`]), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        const graph = planWorkflow(resolved.spec, resolved.source);
+        const data = workflowGraphData(options.session, graph, resolved);
+        const actions = [
+            `Run \`peaks workflow run ${id} --session ${options.session} --json\` to materialize the run-plan order.`
+        ];
+        printResult(io, ok('workflow.graph', data, [], actions), options.json);
+    }
+    catch (error) {
+        reportWorkflowGraphFailure(io, error, options.session, options.json);
+    }
+}
+function runWorkflowLint(id, options, io) {
+    try {
+        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
+        const resolved = resolveWorkflow(projectRoot, id);
+        if (resolved.source.kind === 'missing') {
+            printResult(io, fail('workflow.lint', 'WORKFLOW_NOT_FOUND', `workflow "${id}" not found`, { sessionId: options.session }, [`Create .peaks/workflows/${id}.yaml`]), options.json);
+            process.exitCode = 1;
+            return;
+        }
+        printResult(io, ok('workflow.lint', {
+            sessionId: options.session,
+            source: resolved.source,
+            lint: resolved.lint
+        }, [], []), options.json);
+        if (!resolved.lint.ok)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        reportWorkflowLintFailure(io, error, options.session, options.json);
+    }
+}

package/dist/cli/commands/mcp-commands.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+import { type ProgramIO } from '../cli-helpers.js';
+/** Absolute path of the MCP server's process entry. */
+export declare function mcpServerEntryPath(): string;
+/** The exact command this launcher will spawn, resolved without spawning it. */
+export declare function mcpServeInvocation(entry?: string): {
+    command: string;
+    args: string[];
+};
+export declare function registerMcpCommands(program: Command, io: ProgramIO): void;

package/dist/cli/commands/mcp-commands.js

@@ -0,0 +1,157 @@
+// src/cli/commands/mcp-commands.ts
+//
+// `peaks mcp` — the command family around the read-only MCP surface. This slice
+// delivers `serve`; `install` / `uninstall` / `status` are the distribution
+// slice's (spec §12, segment ③).
+//
+// WHY THIS FILE DOES NOT IMPORT THE SERVER. The design's load-bearing invariant
+// is that `src/services/mcp/` is a DELETABLE PIPE (spec §1): remove it and the
+// CLI is unchanged, the interceptor is unchanged, and a harness that used MCP
+// simply falls back to Bash. That invariant is an assertion about import edges,
+// and it is enforced by `tests/unit/standards/no-mcp-source-import.test.ts` —
+// which reports an edge from any module outside the MCP root, this file
+// included. So the server is reached the way the design says a server is
+// reached: as a PROCESS, by path.
+//
+// The path is computed here rather than asked for, because asking would be the
+// import. `SOURCE_TREE` / `TREE_DIR` are the same two facts every other
+// self-spawn in this tree derives the same way (see `daemon-supervisor.ts`):
+// this file's own extension says which tree it was loaded from, and its own
+// directory says where that tree is.
+import { spawn } from 'node:child_process';
+import { dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { installMcpForAdapter, resolveMcpServerArgv, spawnMcpInstallRunner, uninstallMcpForAdapter } from '../../services/distribution/mcp-install.js';
+import { detectIdeFromContext } from '../../services/ide/hook-translator.js';
+import { resolveIdeOptionHelp, tryGetAdapter } from '../../services/ide/ide-registry.js';
+import { interpreterArgs } from '../../services/web/daemon-supervisor.js';
+import { printResult } from '../cli-helpers.js';
+import { fail, ok } from 'peaks-loop-shared/result';
+/** This file's directory — `<root>/src/cli/commands` or `<root>/dist/cli/commands`. */
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+/** `<root>/src` or `<root>/dist`. */
+const TREE_DIR = resolve(MODULE_DIR, '..', '..');
+/** Compiled trees run `.js` under node; the source tree is TypeScript. */
+const SOURCE_TREE = extname(fileURLToPath(import.meta.url)) === '.ts';
+/** Absolute path of the MCP server's process entry. */
+export function mcpServerEntryPath() {
+    return join(TREE_DIR, 'services', 'mcp', SOURCE_TREE ? 'server-main.ts' : 'server-main.js');
+}
+/** The exact command this launcher will spawn, resolved without spawning it. */
+export function mcpServeInvocation(entry = mcpServerEntryPath()) {
+    return { command: process.execPath, args: interpreterArgs(entry) };
+}
+/**
+ * Hand the process over to the MCP server: the child inherits all three standard
+ * streams, so the harness's stdin/stdout pipe IS the server's pipe and this
+ * process adds a frame of indirection and nothing else.
+ */
+function runMcpServe(io, options) {
+    const invocation = mcpServeInvocation();
+    const child = spawn(invocation.command, invocation.args, {
+        stdio: 'inherit',
+        cwd: options.project ?? process.cwd(),
+        // Windows contract: a spawned child must not allocate a console window.
+        windowsHide: true
+    });
+    child.on('error', (error) => {
+        printResult(io, fail('mcp.serve', 'MCP_SERVE_SPAWN_FAILED', `Could not start the MCP server: ${error.message}`, {
+            entry: invocation.args.at(-1) ?? ''
+        }, ['Check that the build is present, or run `pnpm build`']), options.json === true);
+        process.exitCode = 1;
+    });
+    child.on('exit', (code, signal) => {
+        // The child's status IS this command's status — an MCP client reads the
+        // server's exit, so masking it would be the only lie this launcher told.
+        if (signal !== null) {
+            process.exitCode = 1;
+            return;
+        }
+        process.exitCode = code ?? 0;
+    });
+}
+export function registerMcpCommands(program, io) {
+    const mcp = program
+        .command('mcp')
+        .description('Serve peaks-loop read-only capabilities over MCP (stdio)');
+    mcp
+        .command('serve')
+        .description('Run the read-only MCP server on stdio until the caller closes it')
+        .option('--project <path>', 'project the server runs the CLI in (default: current directory)')
+        .action((options) => {
+        runMcpServe(io, options);
+    });
+    registerMcpRegistrationCommands(mcp, io);
+}
+function resolveTargetAdapter(options) {
+    const ide = options.ide !== undefined && options.ide.length > 0
+        ? options.ide
+        : detectIdeFromContext({ env: process.env, cwd: process.cwd(), parsedStdin: null });
+    const adapter = tryGetAdapter(ide);
+    return adapter === undefined ? { kind: 'unsupported', ide } : { kind: 'adapter', adapter };
+}
+/** One envelope line per adapter: what was registered, or why nothing was. */
+function reportRegistration(result, verb) {
+    if (result.skipped) {
+        return `${result.ideId}: skipped — ${result.reason}`;
+    }
+    const { report } = result;
+    return `${result.ideId}: ${verb} ${report.ok ? 'ok' : 'FAILED'} — ${report.detail}`;
+}
+/** The `data` BOTH envelopes carry, so the failure path is never a thinner shape. */
+function registrationEnvelopeData(result, verb) {
+    return {
+        ide: result.ideId,
+        skipped: result.skipped,
+        summary: reportRegistration(result, verb),
+        registration: result
+    };
+}
+function runMcpRegistration(io, verb, options) {
+    const target = resolveTargetAdapter(options);
+    if (target.kind === 'unsupported') {
+        printResult(io, fail(`mcp.${verb}`, 'MCP_HARNESS_UNSUPPORTED', `No adapter is registered for harness '${target.ide}'.`, { ide: target.ide }, ['Pass --ide with a registered adapter id']), options.json === true);
+        process.exitCode = 1;
+        return;
+    }
+    const { adapter } = target;
+    const serverArgv = resolveMcpServerArgv();
+    const result = verb === 'install'
+        ? installMcpForAdapter(adapter, serverArgv, spawnMcpInstallRunner)
+        : uninstallMcpForAdapter(adapter, serverArgv, spawnMcpInstallRunner);
+    const report = result.skipped ? undefined : result.report;
+    if (report !== undefined && !report.ok) {
+        printResult(io, fail(`mcp.${verb}`, 'MCP_REGISTRATION_FAILED', report.detail, registrationEnvelopeData(result, verb), ['Run the harness command by hand to see its own error']), options.json === true);
+        process.exitCode = 1;
+        return;
+    }
+    printResult(io, ok(`mcp.${verb}`, registrationEnvelopeData(result, verb)), options.json === true);
+}
+/**
+ * `peaks mcp install` / `peaks mcp uninstall` — the distribution half of the MCP
+ * surface, and an explicit pair on purpose (spec §8.3 Q19): an uninstall that
+ * only ran from a package manager's hook is skipped whenever the manager decides
+ * to skip it, and the leftover registration then makes the NEXT install fail on
+ * a duplicate. Neither command starts a process; they register one.
+ */
+function registerMcpRegistrationCommands(mcp, io) {
+    mcp
+        .command('install')
+        .description('Register the peaks MCP server with the detected harness. Removes the name ' +
+        'from every declared scope first, because the harness registers non-idempotently. ' +
+        'A harness whose adapter declares no registration entry is skipped, not failed.')
+        .option('--ide <id>', resolveIdeOptionHelp())
+        .option('--json', 'JSON envelope output')
+        .action((options) => {
+        runMcpRegistration(io, 'install', options);
+    });
+    mcp
+        .command('uninstall')
+        .description('Remove the peaks MCP registration from the harness, sweeping every scope it ' +
+        'may hold. Explicit, because no package-manager hook is relied on.')
+        .option('--ide <id>', resolveIdeOptionHelp())
+        .option('--json', 'JSON envelope output')
+        .action((options) => {
+        runMcpRegistration(io, 'uninstall', options);
+    });
+}

package/dist/cli/commands/memory-commands.d.ts

@@ -26,7 +26,6 @@ export interface MemoryReindexCommandOptions {
     summary?: boolean;
 }
 /**
- * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
  * `memory reindex`. The full report's arrays stay on disk / in the default
  * envelope; this replaces them with `{count, names}` views (≤ 2 KB).
  */

package/dist/cli/commands/memory-commands.js

@@ -11,7 +11,6 @@ import { getErrorMessage, printResult } from '../cli-helpers.js';
 import { join } from 'node:path';
 const VALID_KINDS = VALID_PROJECT_MEMORY_KINDS;
 /**
- * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
  * `memory reindex`. The full report's arrays stay on disk / in the default
  * envelope; this replaces them with `{count, names}` views (≤ 2 KB).
  */

package/dist/cli/commands/observability-commands.d.ts

@@ -1,13 +1,7 @@
 /**
  * `peaks observability <subcommand>` — Slice B/C of v2.11.1.
  *
- * Slice B ships 4 read-only subcommands (AC-1 to AC-4):
- *   - `peaks observability status`         (AC-1)
- *   - `peaks observability slices`         (AC-2)
- *   - `peaks observability fanout`         (AC-3)
- *   - `peaks observability repair-cycles`  (AC-4)
  *
- * `peaks observability report` (AC-5) lands in Slice D when the
  * markdown report formatter is implemented.
  *
  * Read-only — never writes. Reads the JSONL metrics files emitted

package/dist/cli/commands/observability-commands.js

@@ -1,13 +1,7 @@
 /**
  * `peaks observability <subcommand>` — Slice B/C of v2.11.1.
  *
- * Slice B ships 4 read-only subcommands (AC-1 to AC-4):
- *   - `peaks observability status`         (AC-1)
- *   - `peaks observability slices`         (AC-2)
- *   - `peaks observability fanout`         (AC-3)
- *   - `peaks observability repair-cycles`  (AC-4)
  *
- * `peaks observability report` (AC-5) lands in Slice D when the
  * markdown report formatter is implemented.
  *
  * Read-only — never writes. Reads the JSONL metrics files emitted

package/dist/cli/commands/outer-cache-commands.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-06-session-outer-cache (G1 / G2) — per-project outer-session
  * cache CLI surface.
  *
  * Writes and reads `.peaks/_runtime/.outer-session-cache.json` so that
@@ -90,7 +89,6 @@ export function registerOuterCacheCommands(program, io) {
         const capturedAt = new Date().toISOString();
         const payload = { outerSessionId, capturedAt };
         try {
-            // Slice 2026-08-06-session-cacde8-A.5c: atomic write (temp +
             // rename) so a power-loss mid-write cannot leave the cache file
             // truncated. `atomicWriteJson` owns its own
             // `mkdirSync(dir, { recursive: true })` so the inline mkdir

package/dist/cli/commands/playwright-commands.d.ts

@@ -83,7 +83,6 @@ export declare function registerBrowserActionCommand(program: Command): void;
  * Resolve and validate a caller-supplied `--user-data-dir`. The dir must
  * live under `projectRoot` so a malicious `--user-data-dir /etc/foo`
  * cannot coerce the playwright-mcp browser into writing state to an
- * arbitrary filesystem path (slice 2026-06-23-audit-3rd #5).
  *
  * Resolves `..` segments before checking, so a path like
  * `<projectRoot>/../escape` is correctly normalized and rejected.

package/dist/cli/commands/playwright-commands.js

@@ -427,7 +427,6 @@ function isSupportedIntent(value) {
  * Resolve and validate a caller-supplied `--user-data-dir`. The dir must
  * live under `projectRoot` so a malicious `--user-data-dir /etc/foo`
  * cannot coerce the playwright-mcp browser into writing state to an
- * arbitrary filesystem path (slice 2026-06-23-audit-3rd #5).
  *
  * Resolves `..` segments before checking, so a path like
  * `<projectRoot>/../escape` is correctly normalized and rejected.

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

@@ -1,7 +1,6 @@
 /**
  * `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`.

package/dist/cli/commands/prd-commands.d.ts

@@ -9,7 +9,6 @@
  *   peaks prd handoff show   — print the raw handoff markdown
  *
  * Help text MUST NOT reference the legacy `peaks prd write-handoff`
- * subcommand (AC-1 in the v2.11.0 PRD). The legacy service module at
  * `services/handoff/` is a separate slice-025 layout (different
  * schema) and is intentionally not exposed here.
  */

package/dist/cli/commands/prd-commands.js

@@ -9,7 +9,6 @@
  *   peaks prd handoff show   — print the raw handoff markdown
  *
  * Help text MUST NOT reference the legacy `peaks prd write-handoff`
- * subcommand (AC-1 in the v2.11.0 PRD). The legacy service module at
  * `services/handoff/` is a separate slice-025 layout (different
  * schema) and is intentionally not exposed here.
  */
@@ -60,7 +59,6 @@ export function registerPrdCommands(program, io) {
             const body = await resolveBody(options.body);
             const projectRoot = options.project ?? process.cwd();
             const writtenAt = new Date().toISOString();
-            // B2 / F1 of `rid-b1-qa`: the ONLY production caller of `initHandoff`
             // used to pass no `gateEvidence`, so no capsule written by this command
             // ever carried the field. It is derived now — from the request type
             // recorded on this rid's PRD artifact — and `undefined` (no artifact, or

package/dist/cli/commands/preferences-commands.js

@@ -150,7 +150,6 @@ export function registerPreferencesCommands(program) {
             const hadKey = Object.prototype.hasOwnProperty.call(raw, opts.key);
             if (hadKey) {
                 delete raw[opts.key];
-                // Slice 2026-06-23-audit-4th #A2: write atomically (tmp+rename)
                 // so a crash mid-write cannot leave a half-written file. Same
                 // pattern as preferences-service.savePreferences (post-fix) and
                 // dispatch-record-writer.writeAtomic. renameSync is imported
@@ -171,7 +170,6 @@ export function registerPreferencesCommands(program) {
             process.exit(1);
         }
     });
-    // Slice 2026-06-23-audit-4th #C1: peaks preferences migrate — apply
     // the v1 → v2 (and future) schema migration. Default is dry-run
     // (preview the change list + migrated JSON without writing); pass
     // --apply to write. Without this CLI, an old preferences.json

package/dist/cli/commands/primer-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice rid-statusline-stale-ux AC-2: `peaks session primer --project <path>`.
  *
  * Lightweight SessionStart primer that fires rotation + presence
  * cleanup BEFORE the first statusline render of a fresh session.

package/dist/cli/commands/primer-command.js

@@ -1,5 +1,4 @@
 /**
- * Slice rid-statusline-stale-ux AC-2: `peaks session primer --project <path>`.
  *
  * Lightweight SessionStart primer that fires rotation + presence
  * cleanup BEFORE the first statusline render of a fresh session.

package/dist/cli/commands/project-commands.js

@@ -80,7 +80,6 @@ export function registerProjectCommands(program, io) {
                 path: result.path,
                 sessionCount: result.sessionCount,
                 content: result.content,
-                // Slice 2026-07-15-project-scan-bootstrap (G1 + G2): the
                 // context command also bootstraps the project-scan tree.
                 // The envelope surfaces write counts + duration so the LLM
                 // (and the user) see what landed.

package/dist/cli/commands/qa-commands.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-06-16-playwright-restart-loop — G1, G2, G4, G5, G6.
  *
  * `peaks qa run` — runs a peaks-qa slice for the active project.
  *

package/dist/cli/commands/qa-commands.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-06-16-playwright-restart-loop — G1, G2, G4, G5, G6.
  *
  * `peaks qa run` — runs a peaks-qa slice for the active project.
  *
@@ -284,7 +283,6 @@ export function registerQaCommands(program, io) {
             process.exitCode = 1;
         }
     });
-    // rid-012 (2026-07-27) — screenshot archive.
     // Enforces peaks-qa SKILL.md "Hard contracts for browser validation"
     // Contract 1: every Playwright `browser_take_screenshot` MUST land under
     // `.peaks/_runtime/<sessionId>/qa/screenshots/`, not at the project root.

package/dist/cli/commands/release-commands.js

@@ -29,17 +29,12 @@ const CANARY_PERCENTS = {
     10: 'canary-10',
     50: 'canary-50'
 };
-// rid-010 — extracted canary action handler so AC-8 can drive the canary
 // precheck-guard via direct function call (not via program.parseAsync with a
 // mocked service). Returns the result envelope for the caller to print.
 export function executeCanaryAction(opts, io, projectRoot) {
-    // rid-010 — precheck guard (Layer A or Layer B blocker refuses canary).
-    // rid-011 — changeset hard gate runs inline in the canary closure BEFORE
     // this function is called (step 0 short-circuits with CHANGESET_BLOCKED).
     // Layers C/D default warning → do not block canary; --strict upgrade would
-    // be a separate flag (out of scope for rid-011).
     // Layers C/D default warning → do not block canary; --strict upgrade would
-    // be a separate flag (out of scope for rid-010).
     const precheck = runAllLayers({ projectRoot, strict: false });
     const blockerEntry = Object.entries(precheck.layers).find(([, l]) => l.status === 'blocker');
     if (blockerEntry !== undefined) {
@@ -113,7 +108,6 @@ export function registerReleaseCommands(program, io) {
             currentStage: result.record.currentStage
         }, [], ['Run `peaks release canary --percent 10` to begin the canary phase.']), opts.json ?? false);
     });
-    // 2. canary — rid-010 wires precheck as the first step via executeCanaryAction
     addJsonOption(release
         .command('canary')
         .description('Advance the active release to a canary stage. Two percent values supported: ' +
@@ -124,7 +118,6 @@ export function registerReleaseCommands(program, io) {
         .option('--note <text>', 'optional note for the stage transition')
         .option('--project <path>', 'project root (default: cwd)')).action((opts) => {
         const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        // rid-011 — changeset hard gate (step 0).
         const gate = runChangesetHardGate(projectRoot);
         if (gate.state === 'staged-present') {
             process.exitCode = 1;
@@ -286,7 +279,6 @@ export function registerReleaseCommands(program, io) {
         .option('--note <text>', 'optional hotfix note')
         .option('--project <path>', 'project root (default: cwd)')).action((version, opts) => {
         const projectRoot = opts.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        // rid-011 — changeset hard gate (step 0). No --skip-changeset-check override.
         const changesetGate = runChangesetHardGate(projectRoot);
         if (changesetGate.state === 'staged-present') {
             process.exitCode = 1;
@@ -312,7 +304,6 @@ export function registerReleaseCommands(program, io) {
             currentStage: result.record.currentStage
         }, [], ['Hotfix started at canary-10. Run `peaks release canary --percent 50` to advance.']), opts.json ?? false);
     });
-    // 8. precheck — rid-010 (Phase 4 slice 1) — 4-layer version precheck.
     addJsonOption(release
         .command('precheck')
         .description('Run the 4-layer version precheck (rootVsShared / tagCollision / ' +

package/dist/cli/commands/request-command-options.d.ts

@@ -0,0 +1,49 @@
+import type { RequestArtifactRole, RequestArtifactState, RequestType } from '../../services/artifacts/request-artifact-service.js';
+export type RequestInitOptions = {
+    role: string;
+    id: string;
+    project: string;
+    sessionId?: string;
+    apply?: boolean;
+    type?: RequestType;
+    callerId?: string;
+    json?: boolean;
+};
+export type RequestListOptions = {
+    project: string;
+    sessionId?: string;
+    role?: RequestArtifactRole;
+    summary?: boolean;
+    json?: boolean;
+};
+export type RequestShowOptions = {
+    role: RequestArtifactRole;
+    project: string;
+    sessionId?: string;
+    json?: boolean;
+    pretty?: boolean;
+    compact?: boolean;
+};
+export type RequestTransitionOptions = {
+    role: RequestArtifactRole;
+    project: string;
+    state: RequestArtifactState;
+    sessionId?: string;
+    reason?: string;
+    allowIncomplete?: boolean;
+    confirm?: boolean;
+    forceConfirm?: boolean;
+    json?: boolean;
+};
+export type RequestLintOptions = {
+    role: RequestArtifactRole;
+    project: string;
+    sessionId?: string;
+    json?: boolean;
+};
+export type RequestRepairStatusOptions = {
+    project: string;
+    sessionId?: string;
+    maxCycles?: string;
+    json?: boolean;
+};

package/dist/cli/commands/request-command-options.js

@@ -0,0 +1 @@
+export {};