peaks-loop 4.1.0 → 4.1.2

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

@@ -12,7 +12,6 @@ import { codegraphRefreshNotice, refreshCodegraphAfterSlice } from '../../servic
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { isUnsafePathInput } from '../../shared/path-safety.js';
 /**
- * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
  * `request list`. `count` is the true total; `names` carries
  * `role/requestId (state)` labels for the first N entries. The full `items`
  * array (with paths + timestamps) is one flag away — omit `--summary`.
@@ -38,7 +37,6 @@ export function registerRequestCommands(program, io) {
         .option('--session-id <session>', 'override the default date-stamped session id')
         .option('--apply', 'write the artifact file (default: preview only)')
         .option('--type <type>', `request type (${VALID_REQUEST_TYPES.join(' | ')}); default: feature`, parseRequestType)
-        // Slice 020 — caller-keyed session binding. Per-invocation override
         // (D4 priority level 1). When set, the resolved callerId is surfaced
         // in the JSON envelope; the on-disk artifact records it in the
         // artifact body so future reads know which caller produced it.
@@ -70,7 +68,6 @@ export function registerRequestCommands(program, io) {
             if (options.type !== undefined) {
                 serviceOptions.requestType = options.type;
             }
-            // Slice 020.1 — resolve the callerId via D4 priority (flag > env >
             // platform fallback > reject). The CLI integration layer is the
             // single entry point for the resolver; we do not pre-judge whether
             // the caller passed a flag. D2 (no callerId available) and D5
@@ -286,7 +283,6 @@ export function registerRequestCommands(program, io) {
                 process.exitCode = 1;
                 return;
             }
-            // Slice 2026-07-01-strategic-compact-cli — slice-boundary pre-compact
             // hook. When transitioning across the RD → QA boundary (rd:qa-handoff),
             // check the active session's context-fill ratio. If it is in the
             // 0.85–0.95 pre-compact zone, write a checkpoint BEFORE the
@@ -297,9 +293,7 @@ export function registerRequestCommands(program, io) {
             // waiting; it does not refuse anything, because peaks-loop has no
             // executor for a running session and a refusal it cannot enforce only
             // deadlocked the runner (slice
-            // 2026-09-13-auto-compact-trigger-ownership).
             let preCompact = null;
-            // 2026-09-03-codegraph-autorefresh: auto codegraph re-index on the
             // RD → QA slice-complete boundary. Set only for rd:qa-handoff; null
             // otherwise. Best-effort and fail-silent — never blocks the transition.
             let codegraphRefresh = null;
@@ -337,9 +331,7 @@ export function registerRequestCommands(program, io) {
                 // `codegraphRefreshNotice` for why `no-codegraph-dir` stays silent.
                 codegraphWarning = codegraphRefreshNotice(codegraphRefresh);
             }
-            // v2.13.2 AC-4 — auto-regen prd/handoff.md on prd:handed-off success.
             // Only fires when the handoff is missing; existing handoffs are not overwritten.
-            // Slice 2026-08-12 best-practice-scan (Slice F) — auto-trigger BPS as a
             // post-step after peaks-prd's businessGoal artifact transitions to
             // `handed-off` (the canonical "complete" state in the prd state machine).
             // The trigger is fire-and-forget: failure NEVER blocks the transition.
@@ -371,7 +363,6 @@ export function registerRequestCommands(program, io) {
                 printResult(io, ok('request.transition', { ...result, handoffAutoRegen, bestPracticeScanTrigger: bpsTrigger }, notes), options.json);
                 return;
             }
-            // Slice 2026-07-01-strategic-compact-cli: stitch the pre-compact
             // checkpoint signal into the final response envelope. When the
             // hook did not trigger (zone is not pre-compact OR the
             // transition is not a slice boundary), preCompact is null and
@@ -395,7 +386,6 @@ export function registerRequestCommands(program, io) {
                 throw error;
             }
             if (error instanceof PrerequisitesNotSatisfiedError) {
-                // v2.13.3 AC-3 — surface `warnings` (soft-block entries from
                 // the 1-minor-release back-compat window, e.g. MUT_REPORT) so
                 // the operator sees both the hard-blocked `missing` paths and
                 // the soft-blocked ones. `warnings` is always present (possibly

package/dist/cli/commands/request-format-helpers.d.ts

@@ -1,6 +1,5 @@
 /**
  * Format / parse helpers extracted from `request-commands.ts`
- * (slice 2026-09-06-split-batch-b) so the command file stays under the
  * 800-line cap. Behaviour-preserving verbatim move.
  */
 import { type RequestArtifactRole, type RequestArtifactState, type RequestType } from '../../services/artifacts/request-artifact-service.js';

package/dist/cli/commands/request-format-helpers.js

@@ -1,6 +1,5 @@
 /**
  * Format / parse helpers extracted from `request-commands.ts`
- * (slice 2026-09-06-split-batch-b) so the command file stays under the
  * 800-line cap. Behaviour-preserving verbatim move.
  */
 import { InvalidArgumentError } from 'commander';
@@ -34,7 +33,6 @@ export function applyPerArtifactFormat(envelope, override) {
     // The service returns `{ id, sessionId, role, body, ... }` for a
     // single-artifact show. The per-artifact `body` field is the only
     // thing that changes; we attach a `format` field to surface the
-    // choice to the caller. Slice 023 (R3) AC6 / AC7.
     const obj = envelope;
     if (typeof obj.body === 'string') {
         return {

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

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

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

@@ -23,7 +23,6 @@ function registerSCStatusCommands(sc, io) {
     });
 }
 function registerSCArtifactCommands(sc, io) {
-    // Slice 2026-06-29-change-id-root-removal: `--change-id` is no
     // longer accepted on `peaks sc impact`. The CLI surfaces a
     // per-`(module, file)` impact report without a top-level
     // change-id binding.

package/dist/cli/commands/session-24h-mode.d.ts

@@ -1,7 +1,6 @@
 /**
  * `peaks session 24h-mode` — state-only CLI for the 24h mode backbone.
  *
- * Rid-020a (state-only slice). Exposes four sub-actions so the LLM
  * orchestrator can introspect, transition, audit retry attempts, and
  * reset the 24h state machine without touching the JSON file
  * directly. The LLM is the decision-maker; the CLI is the muscle

package/dist/cli/commands/session-24h-mode.js

@@ -1,7 +1,6 @@
 /**
  * `peaks session 24h-mode` — state-only CLI for the 24h mode backbone.
  *
- * Rid-020a (state-only slice). Exposes four sub-actions so the LLM
  * orchestrator can introspect, transition, audit retry attempts, and
  * reset the 24h state machine without touching the JSON file
  * directly. The LLM is the decision-maker; the CLI is the muscle
@@ -136,7 +135,6 @@ export function registerSession24hModeCommand(session, io) {
                 exitCondition: target === 'HANDOFF' ? (merged.exitCondition ?? null) : current.exitCondition
             };
             const result = write24hState(projectRoot, sid, next);
-            // Slice 2026-09-09-mode-consolidation (Slice B): entering 24H_ACTIVE
             // is an auto-engage of the `24h` mode. Stamp it onto the presence
             // lease; every other target state leaves the mode untouched (the
             // guard in `applyAutoEngagePresenceMode` refuses non-24h modes).

package/dist/cli/commands/session-checkpoint-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * `peaks session checkpoint` — slice 011.
  *
  * Writes a JSON snapshot of the current session's state to
  * `_runtime/<sessionId>/checkpoints/<iso>.json`. Designed for skill

package/dist/cli/commands/session-checkpoint-command.js

@@ -1,5 +1,4 @@
 /**
- * `peaks session checkpoint` — slice 011.
  *
  * Writes a JSON snapshot of the current session's state to
  * `_runtime/<sessionId>/checkpoints/<iso>.json`. Designed for skill

package/dist/cli/commands/session-resume-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * `peaks session resume` — slice 011.
  *
  * Reads a checkpoint JSON (written by `peaks session checkpoint`) and
  * emits a structured markdown "resume context" block the skill can

package/dist/cli/commands/session-resume-command.js

@@ -1,5 +1,4 @@
 /**
- * `peaks session resume` — slice 011.
  *
  * Reads a checkpoint JSON (written by `peaks session checkpoint`) and
  * emits a structured markdown "resume context" block the skill can

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

@@ -1,10 +1,8 @@
 /**
  * `peaks shadcn init` — dynamic wrapper around the upstream `shadcn` CLI.
  *
- * Slice B2 of 2026-09-09-ecc-dynamic-and-cleanup: `skills/bee/peaks-rd/SKILL.md`
  * and `references/frontend-project-generation.md` already tell RD to scaffold
  * a frontend with `peaks shadcn init --preset [CODE] --template vite`, but the
- * command did not exist and `shadcn` was not a dependency. Rather than add a
  * hard dependency, this mirrors `src/services/lint/detect-ocr-18.ts` +
  * `npx-resolver.ts`: the tool is obtained on demand via
  * `npx --package shadcn@<pin> -- shadcn ...`, so the skill reference is true

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

@@ -1,7 +1,6 @@
 /**
  * `peaks sub-agent share | shared-read | await` — G8.4 + 2.7.0 await barrier.
  *
- * Pulled out of `sub-agent-commands.ts` (slice 2026-06-23-audit-p0-split)
  * to honor the 800-line file cap. These three commands share the G8.4
  * dispatcher-mediated cross-sub-agent signal channel:
  *   - `share` writes a `<role>.<event>` entry (≤ 1KB soft warn, ≥ 64KB reject).
@@ -49,7 +48,6 @@ export declare const FINALIZE_SELECTION_RULE: string;
  *
  * The branch this replaces `break`ed on the FIRST file whose record carried
  * the requestId and never looked at `status`. With a re-dispatched request
- * (this session holds six records for `2026-09-12-defect-remediation`) it
  * always resolved to the OLDEST one — the already-`done` RD record — so
  * finalizing reported success while the newer `queued` QA record stayed
  * queued forever. `--batch` never had that bug: it filters on `queued`.
@@ -65,7 +63,6 @@ export declare function registerShareCommand(parent: Command, io: ProgramIO): vo
 export declare function registerSharedReadCommand(parent: Command, io: ProgramIO): void;
 export declare function registerAwaitCommand(parent: Command, io: ProgramIO): void;
 /**
- * Slice 2026-07-17-D21: peaks sub-agent finalize — LLM-side completion
  * signal. Without this, dispatch records stay queued forever.
  *
  * Contract:

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

@@ -14,7 +14,6 @@ export const FINALIZE_SELECTION_RULE = 'prefer status=queued; among those, newes
  *
  * The branch this replaces `break`ed on the FIRST file whose record carried
  * the requestId and never looked at `status`. With a re-dispatched request
- * (this session holds six records for `2026-09-12-defect-remediation`) it
  * always resolved to the OLDEST one — the already-`done` RD record — so
  * finalizing reported success while the newer `queued` QA record stayed
  * queued forever. `--batch` never had that bug: it filters on `queued`.
@@ -71,7 +70,6 @@ export function registerShareCommand(parent, io) {
         }
         try {
             const projectRoot = options.project ?? process.cwd();
-            // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
             const sid = options.sessionId ??
                 process.env.PEAKS_SESSION_ID ??
                 getCurrentSessionId(projectRoot) ??
@@ -105,7 +103,6 @@ export function registerShareCommand(parent, io) {
                 warnings.push(`VALUE_SIZE_SOFT_WARN: ${result.entry.valueSize} > ${SHARED_CHANNEL_SOFT_VALUE_WARN} bytes`);
             }
             printResult(io, ok('sub-agent.share', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
                 envelopeVersion: '2.1.0',
                 ok: true,
                 batchId: options.batch,
@@ -119,7 +116,6 @@ export function registerShareCommand(parent, io) {
                     options.batch +
                     '`.'
             ]), asJson);
-            // Slice 2026-06-23-audit-4th #B1: structured log on success.
             try {
                 writeLogEntry({
                     ts: new Date().toISOString(),
@@ -149,7 +145,6 @@ export function registerShareCommand(parent, io) {
     });
 }
 /**
- * Slice 2026-06-23-audit-3rd #9: branch on `error.code` so the LLM-side
  * runner gets an actionable hint instead of a generic "see error
  * message" fallback. Each branch names the most likely next step.
  */
@@ -182,7 +177,6 @@ export function registerSharedReadCommand(parent, io) {
         }
         try {
             const projectRoot = options.project ?? process.cwd();
-            // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
             const sid = options.sessionId ??
                 process.env.PEAKS_SESSION_ID ??
                 getCurrentSessionId(projectRoot) ??
@@ -197,7 +191,6 @@ export function registerSharedReadCommand(parent, io) {
                 ...(options.key !== undefined ? { keyPattern: options.key } : {})
             });
             printResult(io, ok('sub-agent.shared-read', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
                 envelopeVersion: '2.1.0',
                 ok: true,
                 batchId: options.batch,
@@ -252,7 +245,6 @@ export function registerAwaitCommand(parent, io) {
             timeoutMs = n;
         }
         const projectRoot = options.project ?? process.cwd();
-        // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
         const sid = options.sessionId ??
             process.env.PEAKS_SESSION_ID ??
             getCurrentSessionId(projectRoot) ??
@@ -260,7 +252,6 @@ export function registerAwaitCommand(parent, io) {
         // Lazy-import IDE modules so `peaks sub-agent share` and
         // `peaks sub-agent shared-read` (the high-frequency G8.4 path) do not
         // pay for adapter resolution at module-load time. Slice
-        // 2026-06-23-audit-p0-cleanup.
         const { detectInstalledIde } = await import('../../services/ide/ide-detector.js');
         const { getAdapter } = await import('../../services/ide/ide-registry.js');
         const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
@@ -274,7 +265,6 @@ export function registerAwaitCommand(parent, io) {
             return;
         }
         try {
-            // Slice 2026-09-16-n1-await-reports: resolve the batch's records from the
             // session's dispatch directory. `recordPaths` used to be hardcoded to
             // `[]`, and `awaitBatch` short-circuits on an empty list
             // (await-batch.ts:134) — so `await` reported zero results and exited 0
@@ -309,7 +299,6 @@ export function registerAwaitCommand(parent, io) {
             const results = await dispatcher.awaitBatch(input);
             const summary = summarizeBatchResults(results);
             printResult(io, ok('sub-agent.await', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
                 envelopeVersion: '2.1.0',
                 batchId: options.batch,
                 ide: dispatcher.label,
@@ -321,7 +310,6 @@ export function registerAwaitCommand(parent, io) {
                     `${scan.unreadable.length} unreadable dispatch record(s) in this session were skipped and are NOT part of the results: ${scan.unreadable.join(', ')}`
                 ]
                 : [], [
-                // Slice 2026-09-15-s9: corrected. This used to tell users that the
                 // four non-Claude IDEs would report `awaitByLlm: <ide> 1.2 fallback`,
                 // the slice-1.2 marker that slice 1.3 replaced with a real
                 // file-polling await. The text survived because nothing tested it —
@@ -371,7 +359,6 @@ function safeRecordPath(p) {
     }
 }
 /**
- * Slice 2026-09-16-n1-await-reports: which on-disk records belong to a batch.
  *
  * Reuses the conventions already in the repo instead of inventing a new one:
  *   - records live at `.peaks/_sub_agents/<sid>/dispatch-<rid>-<ts>.json`

package/dist/cli/commands/skill-search-commands.d.ts

@@ -2,8 +2,6 @@
  * peaks skill search — CLI primitive for S0 of the 4.0.0-beta.5
  * peaks-solo dispatcher release.
  *
- * Spec: docs/superpowers/specs/2026-07-08-peaks-solo-dispatcher-design.md §3.2
- * Plan: docs/superpowers/plans/2026-07-08-peaks-solo-dispatcher/s0-skill-search-cli.md
  *
  * Wired into the existing `peaks skill` group by
  * `src/cli/commands/core/skill-command.ts` (one import + one call).

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

@@ -68,7 +68,6 @@ export function registerSliceCommands(program, io) {
             process.exitCode = 1;
         }
     });
-    // ---------- peaks slice ls (slice 2026-06-27-slice-ls) ----------
     // Read-only listing of every decomposition artifact under
     // .peaks/sc/slice-decomposition/. Used by operators to see what's
     // accumulated; companion to a future `peaks slice cleanup` subcommand.
@@ -393,7 +392,6 @@ function writeDecompositionFile(rid, result, projectRoot) {
 }
 /**
  * Stale threshold for slice decomposition artifacts. Matches the default
- * retention window promised by `peaks slice cleanup` (slice 2026-06-27-slice-cleanup,
  * recorded in .peaks/memory/ for follow-up). If that slice ships with a
  * different default, both must update here.
  */

package/dist/cli/commands/slice-integrate-commands.js

@@ -26,7 +26,6 @@ function loadContractsForSlices(projectRoot, sessionId, sliceIds) {
     for (const sliceId of sliceIds) {
         // Slice-id axis: the id becomes the FILENAME below, so `--slices a,../..`
         // reads a JSON file outside the contracts dir. Guarded 2026-09-14 (repair
-        // R1, security audit F3 of `2026-09-14-cli-id-escape-instrumentation`) —
         // the session guard above covers the other axis and this one was open.
         // Skipped with a warning rather than thrown, matching this function's
         // existing contract for a contract it cannot read.

package/dist/cli/commands/spill-demo-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * Rid-032: opt-in spill/hydrate round-trip for 24h mode.
  * This demo command is additive; existing deferral behavior is unchanged.
  */
 import type { Command } from 'commander';

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

@@ -106,7 +106,6 @@ export async function runDefaultStatuslineRender(options, io) {
     const seeded = options.project
         ? { ...(stdin ?? {}), workspace: { current_dir: options.project } }
         : stdin;
-    // Slice 2026-08-07-statusline-flake: accept `--now <epoch-ms>` to pin
     // `Date.now()` for deterministic lifecycle-window checks under full-
     // suite concurrency. The integration test passes a test-time `now`
     // pinned at the moment `seedLifecycle` was called so the completed-
@@ -114,7 +113,6 @@ export async function runDefaultStatuslineRender(options, io) {
     // subprocess sat descheduled. Production callers omit the flag.
     const now = options.now !== undefined ? Number(options.now) : Date.now();
     const model = buildStatusLineModel(seeded, now);
-    // Slice 2026-09-13-statusline-window-witness (AC1): capture the harness's OWN
     // context numbers from the payload it just piped in. The project root and the
     // canonical session id are taken from the model that was JUST built, so the
     // witness lands under the same session this render already resolved — a second
@@ -261,7 +259,6 @@ export function registerStatusLineCommands(program, io) {
             process.exitCode = 1;
         }
     });
-    // peaks statusline compact (slice 2026-07-30-compact-visibility)
     //
     // --session-id contract: this flag is registered on the compact
     // subcommand but NOT on the default `peaks statusline` render path.
@@ -303,7 +300,6 @@ export function registerStatusLineCommands(program, io) {
                 ? merged.project
                 : (findProjectRoot(process.cwd()) ?? process.cwd());
             const sid = merged.sessionId ?? getSessionIdCanonical(projectRoot) ?? null;
-            // Slice 2026-08-07-statusline-flake: honor `--now` (epoch ms)
             // when present so deterministic lifecycle-window checks stay
             // in-range under full-suite concurrency. See `--now` doc on
             // the parent `statusline` command.

package/dist/cli/commands/sub-agent/detached.js

@@ -6,7 +6,6 @@
  *
  * Default mode is in-process (backward compat — existing 106+ tests untouched).
  * This handler only fires when the user explicitly passes --mode detached.
- * Spec: docs/superpowers/specs/2026-08-10-peaks-detached-sub-agent-design.md §3.1 §5.3
  */
 import { dispatchDetached, ResourceBudgetGuard } from 'peaks-loop-internal-runtime';
 export async function dispatch(f) {
@@ -59,7 +58,6 @@ export async function dispatch(f) {
     });
     // The launch outcome is the envelope's `ok`, not a footnote. A vendor CLI
     // that is not installed is an expected environment, and the dispatch record
-    // already says `status: 'failed'`; the envelope used to say `ok: true` with
     // `pid: -1` and a "⏳ Spawning …" hint, so the two surfaces disagreed and the
     // orchestrator read a launch that never happened as a running one.
     //

package/dist/cli/commands/sub-agent-commands.d.ts

@@ -1,10 +1,8 @@
 /**
- * `peaks sub-agent` CLI command group — slice 2026-06-07-sub-agent-context-governance.
  *
  * Thin entry point that wires the four sub-command registrars
  * (`dispatch`, `heartbeat`, `share`, `shared-read`, `await`) to the
  * parent `sub-agent` command. The actual implementations live in
- * sibling files (slice 2026-06-23-audit-p0-split refactor):
  *
  *   - `dispatch-commands.ts`  — `dispatch` single-dispatch action
  *   - `dispatch-from-dag.ts`  — `dispatch --from-dag` codepath (slice 9 perf)
@@ -12,7 +10,6 @@
  *   - `share-commands.ts`     — `share` + `shared-read` + `await` actions (G8.4 / 2.7.0)
  *   - `sub-agent-shared.ts`   — shared types, constants, helpers
  *
- * Skill-first / CLI-auxiliary red line (PB-4 / AC-19/20):
  *   These commands are primitives that the peaks-code / peaks-rd /
  *   peaks-qa SKILL.md compose. Users do NOT invoke them directly.
  */

package/dist/cli/commands/sub-agent-shared.d.ts

@@ -1,7 +1,6 @@
 /**
  * Shared types, constants, and helpers for the `peaks sub-agent` command group.
  *
- * Slice 2026-06-23-audit-p0-split — pulled out of `sub-agent-commands.ts` (968
  * lines) to honor the 800-line file cap (Karpathy #2 Simplicity First).
  *
  * Public exports:
@@ -28,7 +27,6 @@ export type DispatchOptions = {
     force?: boolean;
     fromDag?: string;
     /**
-     * Slice 2026-07-29-worktree-l2-extended Part 2.C: dispatch isolation mode.
      * Only `worktree` is currently recognised. When set, dispatch
      * auto-spawns a worktree lease (delegates to `peaks worktree spawn`)
      * and injects `PEAKS_WORKTREE_LEASE_ID=<id>` into the dispatch
@@ -45,7 +43,6 @@ export type DispatchOptions = {
     workflowId?: string;
     graphRef?: string;
     /**
-     * rid-001 detached sub-agent dispatch (slice 2026-08-11): dispatch
      * execution mode. `in-process` (default) keeps the existing warm-path
      * CLI dispatch; `detached` shells out to
      * `peaks-loop-internal-runtime/dispatch.dispatchDetached` for vendor
@@ -54,26 +51,22 @@ export type DispatchOptions = {
      */
     mode?: 'in-process' | 'detached';
     /**
-     * rid-001 detached sub-agent dispatch: target vendor CLI when
      * --mode detached is selected. Only consulted in the detached path;
      * ignored in the default in-process path. Accepts `claude | codex
      * | copilot` (matches VendorAdapterRegistry).
      */
     vendor?: 'claude' | 'codex' | 'copilot';
     /**
-     * rid-001 Task 11.5 budget ceiling: user-overrides ResourceBudgetGuard
      * when active concurrent fan-out would otherwise throttle detached
      * dispatch. The user accepts the risk; surfaces as `warnings[]` only.
      */
     noThrottle?: boolean;
     /**
-     * rid-001 Task 11.5: override the per-tenant max-concurrent budget
      * (default 8). Effective in both detached (ResourceBudgetGuard) and
      * in-process (batch-counter) paths.
      */
     maxConcurrent?: string;
     /**
-     * F5 follow-up (sediment 2026-08-11-rid-001-redo-fake-green-recovery-closure
      * §Lesson 1): frontmatter `--must-ls-files <glob>` flag. When set, the
      * dispatch CLI runs `git ls-files <glob>` upfront, surfaces
      * `mustLsFilesVerification: { path, exists, files }` in the envelope,
@@ -139,7 +132,6 @@ export type ContractStoreModule = typeof import('../../services/dispatch/contrac
  */
 export declare function validateRole(role: string): string | null;
 /**
- * Slice F2 (rid-f2-ac1-wiring) — the dispatch-side twin of the prereq-side
  * back-compat in `artifact-prerequisites.ts` (`AUDIT_SECURITY` /
  * `AUDIT_PERF` accept `rd/security-review.md` / `rd/perf-baseline.md` via
  * `legacyRelativePaths`).

package/dist/cli/commands/sub-agent-shared.js

@@ -1,15 +1,12 @@
-// Slice F2 (rid-f2-ac1-wiring) — first caller of the RD dispatch policy
 // module. Before this wiring `src/services/rd/reviewer-dispatch-policy.ts`
 // had zero importers in src/ + packages/ + scripts/ and the 2 slots it
 // governs (`security-reviewer`, `perf-baseline-reviewer`) were neither
 // rejected nor rerouted by anything on the dispatch path.
 import { isDeprecatedReviewer } from '../../services/rd/reviewer-dispatch-policy.js';
-// Slice 2026-07-29-dispatch-stall-governance / S6 — `probeShell` is
 // re-exported here so the dispatch chokepoint (`dispatch-commands.ts`)
 // and the sub-agent batch-sync wait can lazily acquire a typed
 // shell-probe report without importing the env service at every
 // call site. Codifies .peaks/memory/2026-07-27-windows-shell-pref.md
-// at the dispatch / tool boundary (AC-6.2).
 export { probeShell } from '../../services/env/shell-probe.js';
 export const RECOMMENDED_ROLES = 'rd | qa | ui | txt | qa-business | qa-perf | qa-security | qa-business-<*> | general-purpose';
 // Slice 2026-07-29-dispatch-stall-governance / S2 — align the per-
@@ -17,7 +14,6 @@ export const RECOMMENDED_ROLES = 'rd | qa | ui | txt | qa-business | qa-perf | q
 // union. The CLI --status help, the writer's isHeartbeatStatus guard,
 // and this constant must stay byte-identical (the parity test in
 // tests/unit/dispatch/heartbeat-parity.test.ts pins it). Adding
-// `cancelled` / `no-execution` closes AC-2.1; adding `never-started`
 // and `unreadable` closes the S1 status surface.
 export const HEARTBEAT_STATUSES = [
     'queued',
@@ -58,7 +54,6 @@ export function validateRole(role) {
     return null;
 }
 /**
- * Slice F2 (rid-f2-ac1-wiring) — the dispatch-side twin of the prereq-side
  * back-compat in `artifact-prerequisites.ts` (`AUDIT_SECURITY` /
  * `AUDIT_PERF` accept `rd/security-review.md` / `rd/perf-baseline.md` via
  * `legacyRelativePaths`).

package/dist/cli/commands/sub-agent-shutdown-commands.d.ts

@@ -1,7 +1,6 @@
 /**
  * `peaks sub-agent shutdown register|unregister|list` CLI verbs.
  *
- * Slice 2026-08-01-subagent-merge-and-e2e (Task 6). The sub-agent
  * dispatches a long-lived local process (vite dev, mock API, docker
  * proxy, etc.). Before it exits, it MUST register the process with
  * `peaks sub-agent shutdown register --pid <pid> --name <label>`. The

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

@@ -1,5 +1,4 @@
 /**
- * tech-commands — change-id-axis CLI registration (rid-012).
  *
  * Adds two nested subcommands under the existing `peaks tech` parent:
  *
@@ -8,14 +7,12 @@
  *
  * These are ADDITIVE — the existing session-axis commands (`peaks tech plan`
  * / `peaks tech status`) are untouched. The new subcommands reuse the
- * rid-009 helpers (validateChangeId / planArtifactPath / buildWorkspaceUnavailable)
  * via the consumer-side wrapper in
  * `src/services/tech/tech-change-id-service.ts`.
  *
  * Hard ban:
  *   - Do NOT touch the existing `runTechPlan` / `runTechStatus` /
  *     `addTechPlanOptions` / `addTechStatusOptions` in `workflow-commands.ts`
- *     (B2 contract preservation rule from the rid-009 closure record).
  */
 import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
@@ -31,7 +28,6 @@ export declare function addTechChangeIdStatusOptions(command: Command): Command;
  *
  * The subcommand names are `plan-change-id` and `status-change-id` (NOT
  * `plan` / `status`) to avoid colliding with the existing session-axis
- * registrations at `workflow-commands.ts:441-445` (rid-012 risk register R6).
  */
 export declare function registerTechCommands(program: Command, io: ProgramIO): void;
 export type { _WorkspaceConfig };

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

@@ -1,5 +1,4 @@
 /**
- * tech-commands — change-id-axis CLI registration (rid-012).
  *
  * Adds two nested subcommands under the existing `peaks tech` parent:
  *
@@ -8,14 +7,12 @@
  *
  * These are ADDITIVE — the existing session-axis commands (`peaks tech plan`
  * / `peaks tech status`) are untouched. The new subcommands reuse the
- * rid-009 helpers (validateChangeId / planArtifactPath / buildWorkspaceUnavailable)
  * via the consumer-side wrapper in
  * `src/services/tech/tech-change-id-service.ts`.
  *
  * Hard ban:
  *   - Do NOT touch the existing `runTechPlan` / `runTechStatus` /
  *     `addTechPlanOptions` / `addTechStatusOptions` in `workflow-commands.ts`
- *     (B2 contract preservation rule from the rid-009 closure record).
  */
 import { addJsonOption, failUnsupportedNonDryRun, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
@@ -166,7 +163,6 @@ export function addTechChangeIdStatusOptions(command) {
  *
  * The subcommand names are `plan-change-id` and `status-change-id` (NOT
  * `plan` / `status`) to avoid colliding with the existing session-axis
- * registrations at `workflow-commands.ts:441-445` (rid-012 risk register R6).
  */
 export function registerTechCommands(program, io) {
     const tech = program.commands.find((c) => c.name() === 'tech');

package/dist/cli/commands/vendor-detect.d.ts

@@ -1,7 +1,6 @@
 /**
  * Phase B Task 20: peaks vendor-detect CLI.
  * Reports which vendor CLIs are installed on PATH + recommends default.
- * Spec: docs/superpowers/specs/2026-08-10-peaks-detached-sub-agent-design.md §3.3
  */
 import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';
@@ -16,8 +15,6 @@ export declare function vendorDetect(opts: {
     };
 }>;
 /**
- * `peaks vendor-detect` CLI registration (rid-001 redo).
- * Slice 2026-08-11 detached-sub-agent-design §3.3 + §5.3 — register the
  * previously-dead-coded `vendorDetect()` handler at the top-level program
  * surface so `peaks vendor-detect --json` actually reaches it (was
  * dead-coded at the CLI seam even though the handler existed).

package/dist/cli/commands/vendor-detect.js

@@ -12,8 +12,6 @@ export async function vendorDetect(opts) {
     return { ok: true, command: 'vendor-detect', data: { installed, recommended } };
 }
 /**
- * `peaks vendor-detect` CLI registration (rid-001 redo).
- * Slice 2026-08-11 detached-sub-agent-design §3.3 + §5.3 — register the
  * previously-dead-coded `vendorDetect()` handler at the top-level program
  * surface so `peaks vendor-detect --json` actually reaches it (was
  * dead-coded at the CLI seam even though the handler existed).

package/dist/cli/commands/verdict-aggregate-command.d.ts

@@ -1,5 +1,4 @@
 /**
- * v2.13.2 AC-2 — `peaks verdict aggregate` CLI surface.
  *
  * Reads the 5 envelope sources under `.peaks/_runtime/<sid>/` for a
  * given rid, runs `aggregateVerdict()`, and prints the verdict +