peaks-loop 4.1.1 → 4.1.3

package/dist/services/observability/observability-service.d.ts

@@ -50,7 +50,6 @@ export declare function readObservabilityEvents(projectRoot: string, sessionId:
  */
 export declare function isCurrentSchemaVersion(record: unknown): record is ObservabilityEvent;
 /**
- * Slice 2026-07-29-worktree-l2-extended Part 4.A: lease lifecycle
  * observability. Each `peaks worktree spawn / renew / release /
  * gc` CLI emits a `lease` event; the auto-release hook in
  * dispatch finalization emits `autoRelease` (success) or
@@ -74,7 +73,6 @@ export declare function emitLeaseEvent(opts: {
     reason?: string;
 }): EmitResult;
 /**
- * rid-030 F-direction: per-cycle event (cycle started / completed / failed).
  * Fire-and-forget; never throws. Tagging `kind` for downstream dashboards.
  */
 export declare function emitCycleEvent(opts: {
@@ -84,7 +82,6 @@ export declare function emitCycleEvent(opts: {
     status: 'started' | 'completed' | 'failed';
 }): EmitResult;
 /**
- * rid-030 F-direction: per-token-usage event. `totalTokens` is the
  * sum the dashboard cares about; `inputTokens`/`outputTokens` are kept
  * for downstream drill-down.
  */
@@ -95,7 +92,6 @@ export declare function emitTokenUsageEvent(opts: {
     outputTokens: number;
 }): EmitResult;
 /**
- * rid-030 F-direction: per-monotonic-trigger event.
  */
 export declare function emitMonotonicTriggerEvent(opts: {
     sessionId: string;
@@ -104,7 +100,6 @@ export declare function emitMonotonicTriggerEvent(opts: {
     action: string;
 }): EmitResult;
 /**
- * rid-030 F-direction: per-subagent-dispatch event. Reuses the
  * existing `dispatch` category (rd/qa/reviewer/audit). Provides a
  * canonical emit helper so dashboards don't have to hand-author the
  * `ObservabilityEvent` envelope.

package/dist/services/observability/observability-service.js

@@ -117,7 +117,6 @@ export function emitLeaseEvent(opts) {
     }, { projectRoot: opts.projectRoot });
 }
 /**
- * rid-030 F-direction: per-cycle event (cycle started / completed / failed).
  * Fire-and-forget; never throws. Tagging `kind` for downstream dashboards.
  */
 export function emitCycleEvent(opts) {
@@ -130,7 +129,6 @@ export function emitCycleEvent(opts) {
     }, { projectRoot: opts.projectRoot });
 }
 /**
- * rid-030 F-direction: per-token-usage event. `totalTokens` is the
  * sum the dashboard cares about; `inputTokens`/`outputTokens` are kept
  * for downstream drill-down.
  */
@@ -149,7 +147,6 @@ export function emitTokenUsageEvent(opts) {
     }, { projectRoot: opts.projectRoot });
 }
 /**
- * rid-030 F-direction: per-monotonic-trigger event.
  */
 export function emitMonotonicTriggerEvent(opts) {
     return emitObservabilityEvent({
@@ -161,7 +158,6 @@ export function emitMonotonicTriggerEvent(opts) {
     }, { projectRoot: opts.projectRoot });
 }
 /**
- * rid-030 F-direction: per-subagent-dispatch event. Reuses the
  * existing `dispatch` category (rd/qa/reviewer/audit). Provides a
  * canonical emit helper so dashboards don't have to hand-author the
  * `ObservabilityEvent` envelope.

package/dist/services/observability/report-formatter.d.ts

@@ -1,13 +1,11 @@
 /**
  * Markdown report formatter for slice topology observability.
  *
- * Slice D of v2.11.1 (AC-5). Pure functions: inputs are aggregations
  * from `aggregation.ts`, outputs are stable markdown strings suitable
  * for pasting into PR descriptions or `.peaks/PROJECT.md` timeline
  * entries. The CLI subcommand `peaks observability report` wires
  * the file read + aggregation + format pipeline.
  *
- * Format contract (per PRD AC-5):
  *   - Header: scope, period, generated-at timestamp
  *   - Slice table: rid | transitions | finalState | durationMs | success
  *   - Fanout table: role | count

package/dist/services/observability/report-formatter.js

@@ -1,13 +1,11 @@
 /**
  * Markdown report formatter for slice topology observability.
  *
- * Slice D of v2.11.1 (AC-5). Pure functions: inputs are aggregations
  * from `aggregation.ts`, outputs are stable markdown strings suitable
  * for pasting into PR descriptions or `.peaks/PROJECT.md` timeline
  * entries. The CLI subcommand `peaks observability report` wires
  * the file read + aggregation + format pipeline.
  *
- * Format contract (per PRD AC-5):
  *   - Header: scope, period, generated-at timestamp
  *   - Slice table: rid | transitions | finalState | durationMs | success
  *   - Fanout table: role | count

package/dist/services/openspec/artifact-boundary.d.ts

@@ -1,7 +1,6 @@
 /**
  * Artifact boundary helpers for peaks-loop.
  *
- * Slice rid-009:
  *   - sub-slice 1: change-id validation (`validateChangeId`).
  *   - sub-slice 2: artifact path planning (`planArtifactPath` + `isPathInsideArtifactRoot` re-export).
  *   - sub-slice 3: workspace-unavailable response (`buildWorkspaceUnavailable`).
@@ -61,7 +60,6 @@ export type BoundaryError = ChangeIdError | {
  * distinguishes "empty" / "format" / "reserved" so callers can branch on
  * the cause without re-parsing the message.
  *
- * Acceptance contract (rid-009 §3.3.1, task 1):
  *   - accepts `[A-Za-z0-9][A-Za-z0-9._-]*` (existing regex semantics)
  *   - rejects empty string with `change-id-empty`
  *   - rejects `.` and `..` with `change-id-reserved`
@@ -80,7 +78,6 @@ export declare function validateChangeId(id: string): Result<{
  *
  * Single source of truth: the primitive is owned by `src/shared/path-safety.ts`;
  * this module owns the *domain* helpers (change-id + path planner) that consume
- * the primitive. Tests in `tests/unit/services/openspec/artifact-boundary.test.ts`
  * exercise the RE-EXPORT wiring; the primitive's own correctness is covered by
  * its native test file.
  */
@@ -109,7 +106,6 @@ export type PlanArtifactPathOutput = {
 /**
  * Plan an artifact-relative path under the configured Peaks artifact workspace.
  *
- * Semantics (rid-009 §3.3.2, tasks 5–9):
  *   - Backslashes in the candidate path are normalized to forward slashes for
  *     JSON safety; empty segments (`foo//bar`) are collapsed by `posix.normalize`.
  *   - If the resolved absolute path is NOT contained under `workspaceRoot`

package/dist/services/openspec/artifact-boundary.js

@@ -1,7 +1,6 @@
 /**
  * Artifact boundary helpers for peaks-loop.
  *
- * Slice rid-009:
  *   - sub-slice 1: change-id validation (`validateChangeId`).
  *   - sub-slice 2: artifact path planning (`planArtifactPath` + `isPathInsideArtifactRoot` re-export).
  *   - sub-slice 3: workspace-unavailable response (`buildWorkspaceUnavailable`).
@@ -38,7 +37,6 @@ const CHANGE_ID_FORMAT_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
  * distinguishes "empty" / "format" / "reserved" so callers can branch on
  * the cause without re-parsing the message.
  *
- * Acceptance contract (rid-009 §3.3.1, task 1):
  *   - accepts `[A-Za-z0-9][A-Za-z0-9._-]*` (existing regex semantics)
  *   - rejects empty string with `change-id-empty`
  *   - rejects `.` and `..` with `change-id-reserved`
@@ -75,7 +73,6 @@ export function validateChangeId(id) {
  *
  * Single source of truth: the primitive is owned by `src/shared/path-safety.ts`;
  * this module owns the *domain* helpers (change-id + path planner) that consume
- * the primitive. Tests in `tests/unit/services/openspec/artifact-boundary.test.ts`
  * exercise the RE-EXPORT wiring; the primitive's own correctness is covered by
  * its native test file.
  */
@@ -90,7 +87,6 @@ function interpolateTemplate(template, changeId, role, requestId) {
 /**
  * Plan an artifact-relative path under the configured Peaks artifact workspace.
  *
- * Semantics (rid-009 §3.3.2, tasks 5–9):
  *   - Backslashes in the candidate path are normalized to forward slashes for
  *     JSON safety; empty segments (`foo//bar`) are collapsed by `posix.normalize`.
  *   - If the resolved absolute path is NOT contained under `workspaceRoot`

package/dist/services/openspec/coverage-evidence-reader.d.ts

@@ -1,7 +1,6 @@
 /**
  * Coverage Evidence reader for c8 `coverage-summary.json` (Fix-6B).
  *
- * Slice rid-Fix-6B / sub-slice T1:
  *   - pure helper module, no side effects beyond FS reads
  *   - reads the istanbul-reporter JSON shape emitted by `c8 --reporter=json-summary`
  *     (the project's coverage tool — see scripts/coverage-c8.mjs)

package/dist/services/openspec/coverage-evidence-reader.js

@@ -1,7 +1,6 @@
 /**
  * Coverage Evidence reader for c8 `coverage-summary.json` (Fix-6B).
  *
- * Slice rid-Fix-6B / sub-slice T1:
  *   - pure helper module, no side effects beyond FS reads
  *   - reads the istanbul-reporter JSON shape emitted by `c8 --reporter=json-summary`
  *     (the project's coverage tool — see scripts/coverage-c8.mjs)

package/dist/services/polyrepo/polyrepo-dispatcher.js

@@ -1,5 +1,4 @@
 /**
- * Polyrepo dispatcher — slice S2-b of RD-2.
  *
  * Takes a parent root + a list of target child ids + a PRD/RD/QA
  * artifact, and mirrors the artifact into each target child's

package/dist/services/polyrepo/polyrepo-scanner.js

@@ -1,5 +1,4 @@
 /**
- * Polyrepo scanner — slice S2-b of RD-2.
  *
  * Walks a parent directory looking for child git repos. A "child
  * git repo" is defined as: a directory that contains a `.git`

package/dist/services/polyrepo/polyrepo-service.js

@@ -1,5 +1,4 @@
 /**
- * Polyrepo service — slice S2-b of RD-2.
  *
  * Thin orchestrator wrapping the scanner + dispatcher. CLI commands
  * call into this service so they don't need to know about the

package/dist/services/polyrepo/polyrepo-types.d.ts

@@ -1,5 +1,4 @@
 /**
- * Polyrepo types — slice S2-b of RD-2.
  *
  * Models a parent directory that hosts one or more child git repos,
  * each of which may carry its own `.peaks/` state. The root `.peaks/`

package/dist/services/prd/best-practice-auto-trigger.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-12 best-practice-scan — auto-trigger post-step (Slice F).
  *
  * When peaks-prd's request artifact transitions to `handed-off`, this helper
  * extracts the `businessGoal` (first non-empty bullet under `## Goals` of the
@@ -18,7 +17,6 @@
  *   - Spawn 'spawn' event        → status: 'triggered' (resolved; child detached)
  *
  * Karpathy §1 (Think Before Coding): extracted from the QA verdict
- * `verdict-rid-best-practice-scan-qa-ship.md` AC-1 PARTIAL finding. The
  * `prd:handed-off` transition in `src/cli/commands/request-commands.ts`
  * is the canonical hook point — peaks-prd's contract in
  * `skills/bee/peaks-prd/SKILL.md` §"Step 2.5 sub-step" mandates this firing

package/dist/services/prd/best-practice-auto-trigger.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-12 best-practice-scan — auto-trigger post-step (Slice F).
  *
  * When peaks-prd's request artifact transitions to `handed-off`, this helper
  * extracts the `businessGoal` (first non-empty bullet under `## Goals` of the
@@ -18,7 +17,6 @@
  *   - Spawn 'spawn' event        → status: 'triggered' (resolved; child detached)
  *
  * Karpathy §1 (Think Before Coding): extracted from the QA verdict
- * `verdict-rid-best-practice-scan-qa-ship.md` AC-1 PARTIAL finding. The
  * `prd:handed-off` transition in `src/cli/commands/request-commands.ts`
  * is the canonical hook point — peaks-prd's contract in
  * `skills/bee/peaks-prd/SKILL.md` §"Step 2.5 sub-step" mandates this firing

package/dist/services/prd/gate-evidence-derivation.d.ts

@@ -1,10 +1,8 @@
 /**
  * Where `gateEvidence` comes FROM, and where its promise is checked.
  *
- * B2 (merged with the B1 repair), rid `rid-b2-gate-evidence-wiring`.
  *
  * B1 made the field real at the SERVICE layer and QA found the hole that
- * mattered (F1 of `rid-b1-qa`): all three frontmatter producers passed
  * nothing, so no capsule on disk ever carried the field — the dead surface
  * had moved one layer out, from "no producer function" to "no production
  * caller". This module closes that by DERIVING the map instead of accepting
@@ -56,7 +54,6 @@
  * For `docs`/`chore` nothing ever reads it, so it is not declared: keeping an
  * inert statement in every docs capsule would recreate, in miniature, the exact
  * defect this whole line of work exists to remove — a claim no one reads, which
- * is how the field was dead in the first place (F1 of `rid-b2-qa`). Scope, in
  * one sentence: **this map declares the evidence paths Gate C will check for
  * this slice**, so an empty declaration is the honest one when there is no such
  * gate.
@@ -99,7 +96,6 @@ export declare function deriveGateEvidence(opts: {
  * so a caller can tell "this slice has nothing to declare" apart from "the
  * artifact could not be read".
  *
- * F4 (`rid-f4-ceiling-breach`). This used to be `catch { return undefined }`,
  * which folded those two into one value — and the repository's own ratchet
  * caught it (`capability-guard-runner/contracts/J03.ts`, rule
  * `catch-return-null`; the ceiling was written for exactly this shape). Nothing

package/dist/services/prd/gate-evidence-derivation.js

@@ -1,10 +1,8 @@
 /**
  * Where `gateEvidence` comes FROM, and where its promise is checked.
  *
- * B2 (merged with the B1 repair), rid `rid-b2-gate-evidence-wiring`.
  *
  * B1 made the field real at the SERVICE layer and QA found the hole that
- * mattered (F1 of `rid-b1-qa`): all three frontmatter producers passed
  * nothing, so no capsule on disk ever carried the field — the dead surface
  * had moved one layer out, from "no producer function" to "no production
  * caller". This module closes that by DERIVING the map instead of accepting
@@ -56,7 +54,6 @@
  * For `docs`/`chore` nothing ever reads it, so it is not declared: keeping an
  * inert statement in every docs capsule would recreate, in miniature, the exact
  * defect this whole line of work exists to remove — a claim no one reads, which
- * is how the field was dead in the first place (F1 of `rid-b2-qa`). Scope, in
  * one sentence: **this map declares the evidence paths Gate C will check for
  * this slice**, so an empty declaration is the honest one when there is no such
  * gate.
@@ -147,7 +144,6 @@ export function deriveGateEvidence(opts) {
  * so a caller can tell "this slice has nothing to declare" apart from "the
  * artifact could not be read".
  *
- * F4 (`rid-f4-ceiling-breach`). This used to be `catch { return undefined }`,
  * which folded those two into one value — and the repository's own ratchet
  * caught it (`capability-guard-runner/contracts/J03.ts`, rule
  * `catch-return-null`; the ceiling was written for exactly this shape). Nothing
@@ -163,7 +159,6 @@ export function deriveGateEvidence(opts) {
  * worse than a loud, already-duplicated one.
  */
 export async function deriveGateEvidenceForRequest(opts) {
-    // F4 (`rid-f4-ceiling-breach`). The throw from `showRequestArtifact` is
     // propagated, so a caller can tell "this slice has nothing to declare"
     // (artifact missing → `artifact === null` → `requestType === null` →
     // `undefined`) apart from "the artifact could not be read" (an id the

package/dist/services/prd/handoff-auto-regen.js

@@ -1,5 +1,4 @@
 /**
- * v2.13.2 AC-4 — prd/handoff-<rid>.md auto-regen on prd:handed-off.
  *
  * When `peaks request transition --role prd --state handed-off` succeeds
  * and this slice's capsule is missing, this helper writes a sha256-locked
@@ -8,8 +7,6 @@
  * the existing handoff is canonical (it may carry a richer body that
  * peaks-prd produced in an earlier session).
  *
- * Slice `2026-09-14-prd-capsule-rid-scoping`: the path carries the rid, so
- * "already exists" is now asked per SLICE. The pre-rid-scoping bare name is
  * deliberately NOT consulted — writing there would recreate the
  * one-slot-per-session collision for the next slice in the session.
  *
@@ -47,12 +44,10 @@ export async function autoRegenPrdHandoff(opts) {
     }
     const body = artifact.content;
     const sha256 = sha256OfBody(body);
-    // v2.13.3 AC-4 — align with `AUDIT_REQUIRES_HANDOFF` prereq which
     // pins `mustContain: ['schemaVersion: 2', 'sha256:']`. Primary field is
     // `sha256`; `handoffHash` is kept as a literal alias for the readers that
     // still use the old key.
     //
-    // Slice `2026-09-14-handoff-writer-gate-divergence`: this block used to be
     // hand-rolled here while `handoff-service.serializeHandoff` rendered the
     // SAME contract a second, incompatible way. Both now go through
     // `serializeHandoffFrontmatter`, so the two producers cannot drift again.

package/dist/services/prd/handoff-frontmatter-shape.d.ts

@@ -14,7 +14,6 @@ export declare function serializeHandoff(handoff: Handoff): string;
  * readable handoff was satisfied by a handoff the parser would not read, and
  * `peaks prd handoff verify` exited 1 on a healthy file.
  *
- * Slice `2026-09-14-handoff-writer-gate-divergence` then fixed the other half:
  * the writer no longer emits the quoted form at all (see
  * `handoff-frontmatter.ts`). This tolerance stays because handoffs already on
  * disk were written by the old writer and by hand; the writer fix must not
@@ -26,7 +25,6 @@ export declare function isSchemaVersion2(value: unknown): boolean;
  * strings — an ARRAY here is the pre-B1 shape its own test file used to
  * write, and it is a broken declaration, not a claim.
  *
- * F2 of `rid-b1-qa` removed this function's own copy of the shape rule. It
  * used to be a second predicate (same boundary, different downstream result)
  * that let the same bytes read one way here and another way through
  * `readHandoffGateEvidence`; both now ask `classifyGateEvidence`. Only

package/dist/services/prd/handoff-frontmatter-shape.js

@@ -34,7 +34,6 @@ export function serializeHandoff(handoff) {
  * readable handoff was satisfied by a handoff the parser would not read, and
  * `peaks prd handoff verify` exited 1 on a healthy file.
  *
- * Slice `2026-09-14-handoff-writer-gate-divergence` then fixed the other half:
  * the writer no longer emits the quoted form at all (see
  * `handoff-frontmatter.ts`). This tolerance stays because handoffs already on
  * disk were written by the old writer and by hand; the writer fix must not
@@ -48,7 +47,6 @@ export function isSchemaVersion2(value) {
  * strings — an ARRAY here is the pre-B1 shape its own test file used to
  * write, and it is a broken declaration, not a claim.
  *
- * F2 of `rid-b1-qa` removed this function's own copy of the shape rule. It
  * used to be a second predicate (same boundary, different downstream result)
  * that let the same bytes read one way here and another way through
  * `readHandoffGateEvidence`; both now ask `classifyGateEvidence`. Only

package/dist/services/prd/handoff-frontmatter.d.ts

@@ -1,7 +1,6 @@
 /**
  * The ONE canonical serialization of `prd/handoff.md` frontmatter.
  *
- * Why this module exists (slice `2026-09-14-handoff-writer-gate-divergence`):
  * the handoff capsule is written by two producers and read by four
  * consumers, and they did not agree on the bytes:
  *

package/dist/services/prd/handoff-frontmatter.js

@@ -1,7 +1,6 @@
 /**
  * The ONE canonical serialization of `prd/handoff.md` frontmatter.
  *
- * Why this module exists (slice `2026-09-14-handoff-writer-gate-divergence`):
  * the handoff capsule is written by two producers and read by four
  * consumers, and they did not agree on the bytes:
  *
@@ -85,7 +84,6 @@ function blockOptionalSequence(key, values) {
 function gateEvidenceBlock(evidence) {
     if (evidence === undefined)
         return [];
-    // F3 of `rid-b1-qa`: this function used to iterate only the five known keys,
     // so anything else was dropped WITHOUT A TRACE — `initHandoff({gateEvidence:
     // {projectScans: 'typo.md'}})` wrote no block at all and the capsule then
     // read back as `field-absent`, i.e. as if nothing had ever been declared.

package/dist/services/prd/handoff-gate-evidence.d.ts

@@ -56,7 +56,6 @@ export type HandoffGateEvidenceResult = {
 /**
  * THE shape rule for a `gateEvidence` value — one home, two callers.
  *
- * F2 of `rid-b1-qa` found this rule written twice (`handoff-service.ts`'s
  * `isGateEvidenceMap`, added by B1, and this module's own inline checks) with
  * the SAME accept/reject boundary but DIFFERENT results: the same bytes
  * produced a map WITH unknown keys through `readHandoff` and a map WITHOUT

package/dist/services/prd/handoff-gate-evidence.js

@@ -2,7 +2,6 @@
 //
 // The SOLE reader of the handoff frontmatter's `gateEvidence` field.
 //
-// WHAT THE FIELD IS (slice B1, rid `rid-b1-gate-evidence-producer`): a map
 // from one of five fixed gate keys to the PATH of that gate's evidence file.
 // The normative description is
 // `skills/bee/peaks-rd/references/writing-handoff-frontmatter.md:35-41`; the
@@ -12,7 +11,6 @@
 // the defect below. B1 added the producer FUNCTIONS; B2 wired their callers,
 // which is what made the difference — until then every producer passed
 // nothing, so no capsule carried the field and saying otherwise would have
-// described a fact that held only inside tests (F1 of `rid-b1-qa`). At
 // HEAD after B2: the three producers DERIVE the map from the request type
 // (`services/prd/gate-evidence-derivation.ts`), so a capsule written by
 // `peaks prd handoff init`, by the auto-regen on `prd:handed-off`, or by
@@ -24,12 +22,10 @@
 // printed by `peaks prd handoff init` (dry-run and applied), so the key set
 // does not have to be read out of this source file.
 //
-// WHAT THIS FILE USED TO SAY, AND WHY THAT WAS FALSE: its header claimed the
 // field was a `string[]` of "gate names" and that `initHandoff` wrote it.
 // Neither held. `grep -rn gateEvidence src/` hit this file and nothing else —
 // there was no producer (`HandoffFrontmatter` had no such field,
 // `serializeHandoffFrontmatter` never emitted it, `initHandoff` rejected it)
-// and no consumer. The field was prose describing data that did not exist,
 // and the comment asserting a producer was the reason nobody noticed. That
 // paragraph describes the PRE-B1 state; reading it as the current state is
 // the exact misreading that put it here.

package/dist/services/prd/handoff-path-resolution.d.ts

@@ -1,7 +1,6 @@
 /**
  * The canonical capsule path for ONE SLICE, relative to the project root.
  *
- * Slice `2026-09-14-prd-capsule-rid-scoping`: the capsule used to be one slot
  * per SESSION (`prd/handoff.md`), so the second slice's handoff silently
  * overwrote the first slice's — and `AUDIT_REQUIRES_HANDOFF` stayed green
  * because it never checked WHOSE rid the file named. Measured on
@@ -9,24 +8,18 @@
  * capsule left by a different line of work.
  *
  * This is the WRITE target, so it always carries the rid — a consumer-side
- * fallback here would leave a rid-scoped requirement with a bare-name writer,
  * which is the defect shape this slice exists to remove. Readers that must
- * tolerate pre-rid-scoping sessions call `resolveHandoffPath` instead.
  */
 export declare function handoffRelativePath(sessionId: string, requestId: string): string;
 /**
- * The capsule a CONSUMER should read for (session, requestId): the rid-scoped
- * path when it is on disk, else the pre-rid-scoping bare name. Returns null
  * when neither exists.
  *
  * Three sessions on disk still hold only the bare file
- * (`2026-09-06-session-a87ca4`, `2026-09-12-session-e37ef0`,
  * `2026-09-13-session-21878f`), so the legacy tier has to keep resolving for
  * the gate and for every reader below.
  *
  * `requestId` is optional because the detect-only audit surface reaches its
  * service without one. Such a caller can name only the bare path: a session
- * holding nothing but rid-scoped capsules reports missing rather than picking
  * among its siblings' capsules, which would re-open the cross-slice mix-up
  * this scoping exists to close (fail closed, not "some capsule is there").
  */

package/dist/services/prd/handoff-path-resolution.js

@@ -1,6 +1,5 @@
 /**
  * Slice `b1-filesplit-campaign` (wave 3) — verbatim extraction of the handoff
- * capsule PATH layer from `./handoff-service.ts` (the id guard, the rid-scoped
  * write path and the consumer-side resolver) so that module clears the 300
  * raw-line cap. No guard, no message string and no join changed;
  * `handoff-service.ts` re-exports both public names from its own path, so no
@@ -14,8 +13,6 @@ import { isUnsafePathInput } from '../../shared/path-safety.js';
 import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
 /**
  * Both ids in a handoff path are caller-supplied path segments, so both are
- * checked at the join. Added 2026-09-14 (repair R1, security audit F2 of
- * `2026-09-14-cli-id-escape-instrumentation`).
  *
  * This function was introduced by `0536d5bd` — the commit that instrumented
  * this defect class — with neither id checked, and it sat outside rule D's
@@ -48,7 +45,6 @@ function assertSafeHandoffIds(sessionId, requestId) {
 /**
  * The canonical capsule path for ONE SLICE, relative to the project root.
  *
- * Slice `2026-09-14-prd-capsule-rid-scoping`: the capsule used to be one slot
  * per SESSION (`prd/handoff.md`), so the second slice's handoff silently
  * overwrote the first slice's — and `AUDIT_REQUIRES_HANDOFF` stayed green
  * because it never checked WHOSE rid the file named. Measured on
@@ -56,27 +52,21 @@ function assertSafeHandoffIds(sessionId, requestId) {
  * capsule left by a different line of work.
  *
  * This is the WRITE target, so it always carries the rid — a consumer-side
- * fallback here would leave a rid-scoped requirement with a bare-name writer,
  * which is the defect shape this slice exists to remove. Readers that must
- * tolerate pre-rid-scoping sessions call `resolveHandoffPath` instead.
  */
 export function handoffRelativePath(sessionId, requestId) {
     assertSafeHandoffIds(sessionId, requestId);
     return join('.peaks', '_runtime', sessionId, 'prd', `handoff-${requestId}.md`);
 }
 /**
- * The capsule a CONSUMER should read for (session, requestId): the rid-scoped
- * path when it is on disk, else the pre-rid-scoping bare name. Returns null
  * when neither exists.
  *
  * Three sessions on disk still hold only the bare file
- * (`2026-09-06-session-a87ca4`, `2026-09-12-session-e37ef0`,
  * `2026-09-13-session-21878f`), so the legacy tier has to keep resolving for
  * the gate and for every reader below.
  *
  * `requestId` is optional because the detect-only audit surface reaches its
  * service without one. Such a caller can name only the bare path: a session
- * holding nothing but rid-scoped capsules reports missing rather than picking
  * among its siblings' capsules, which would re-open the cross-slice mix-up
  * this scoping exists to close (fail closed, not "some capsule is there").
  */

package/dist/services/prd/handoff-service.d.ts

@@ -4,7 +4,6 @@
  *
  * Owns the immutable handoff at
  * `.peaks/_runtime/<sessionId>/prd/handoff-<rid>.md` (one capsule per slice;
- * the pre-rid-scoping `.peaks/_runtime/<sessionId>/prd/handoff.md` stays
  * readable through `resolveHandoffPath`):
  *
  *   - `initHandoff` — pure; computes sha256 of the body and returns
@@ -50,7 +49,6 @@ export declare function initHandoff(opts: {
      *  read the type itself — so the map can be constructed without touching
      *  the disk; that is why the parameter exists rather than an internal call.
      *
-     *  SHAPE CONTRACT (F2 of `rid-b1-qa`, now enforced in both directions): a
      *  map this accepts is EXACTLY what `readHandoffGateEvidence` reports as
      *  `evidence` — `classifyGateEvidence` is the one shape rule behind both,
      *  and `parseHandoffContent` stores the classified map rather than the raw

package/dist/services/prd/handoff-service.js

@@ -4,7 +4,6 @@
  *
  * Owns the immutable handoff at
  * `.peaks/_runtime/<sessionId>/prd/handoff-<rid>.md` (one capsule per slice;
- * the pre-rid-scoping `.peaks/_runtime/<sessionId>/prd/handoff.md` stays
  * readable through `resolveHandoffPath`):
  *
  *   - `initHandoff` — pure; computes sha256 of the body and returns
@@ -202,7 +201,6 @@ function parseHandoffContent(content) {
  * So `readHandoff` succeeding is NOT evidence that a capsule is verifiable —
  * the tolerance above exists so old capsules stay READABLE, not so they become
  * acceptable. Request §三 bullet 3 asked for exactly this confirmation
- * (rid `2026-09-14-handoff-writer-gate-divergence`).
  */
 function isHandoffFrontmatter(value) {
     if (!value || typeof value !== 'object')

package/dist/services/prd/handoff-types.d.ts

@@ -15,7 +15,6 @@
  *
  * Path convention: the file lands at
  * `.peaks/_runtime/<sessionId>/prd/handoff-<rid>.md` (one capsule per slice;
- * `.peaks/_runtime/<sessionId>/prd/handoff.md` is the pre-rid-scoping tier and
  * stays readable). Gitignored session artifact; the binding to `<sessionId>` lives in
  * `.peaks/_runtime/current-change`). NEVER write under
  * `.peaks/_runtime/<change-id>/...` directly (slice 2.8.3 hard ban).
@@ -106,7 +105,6 @@ export interface HandoffFrontmatter extends HandoffAuthoredFields {
     readonly writtenAt: string;
     /** PRD goal IDs the handoff binds to (e.g. `['G1', 'G2']`). */
     readonly goals: readonly string[];
-    /** PRD acceptance-criteria IDs (e.g. `['AC-1', 'AC-2']`). */
     readonly acceptanceCriteria: readonly string[];
     /** PRD preserved-behavior IDs (e.g. `['P1', 'P12']`). */
     readonly preservedBehavior: readonly string[];

package/dist/services/prd/handoff-types.js

@@ -15,7 +15,6 @@
  *
  * Path convention: the file lands at
  * `.peaks/_runtime/<sessionId>/prd/handoff-<rid>.md` (one capsule per slice;
- * `.peaks/_runtime/<sessionId>/prd/handoff.md` is the pre-rid-scoping tier and
  * stays readable). Gitignored session artifact; the binding to `<sessionId>` lives in
  * `.peaks/_runtime/current-change`). NEVER write under
  * `.peaks/_runtime/<change-id>/...` directly (slice 2.8.3 hard ban).

package/dist/services/prd/project-scan-bootstrap-service.d.ts

@@ -1,5 +1,4 @@
 /**
- * project-scan bootstrap service — slice 2026-07-15-project-scan-bootstrap
  * (PRD G1 + G2 + G4b / AC1-AC10 / R1-R4).
  *
  * Owns the "first time a project enters Peaks-Loop" bootstrap flow:

package/dist/services/prd/project-scan-bootstrap-service.js

@@ -1,5 +1,4 @@
 /**
- * project-scan bootstrap service — slice 2026-07-15-project-scan-bootstrap
  * (PRD G1 + G2 + G4b / AC1-AC10 / R1-R4).
  *
  * Owns the "first time a project enters Peaks-Loop" bootstrap flow:
@@ -35,7 +34,6 @@ const SOURCE_FILE_EXTENSIONS = /\.(tsx?|jsx?|vue|svelte)$/;
 /**
  * Monorepo layout sentinels. A project is monorepo-shaped if it carries
  * one of these config files at its root, even when `src/` is absent.
- * Slice 2026-07-15 hot-fix (ice-cola real-world test, 2026-07-15):
  *   `pnpm-workspace.yaml` is the most common signal; `turbo.json`
  *   (Turborepo) and `nx.json` (Nx) are the others the ecosystem
  *   reaches for. lerna.json is legacy-only and intentionally omitted
@@ -123,7 +121,6 @@ function directoryContainsSourceFiles(rootDir) {
  * 1. `src/` at the root (single-package layout).
  * 2. Any of the monorepo source roots: `packages/`, `apps/`, `libs/`,
  *    `services/`, `workspaces/` — each is checked recursively for at
- *    least one matching source file. Slice 2026-07-15 hot-fix (ice-cola
  *    test, 2026-07-15): the original implementation only looked at
  *    `src/` and mis-classified monorepos as 0-1 (pnpm-workspace layout
  *    puts source under `packages/<pkg>/src/`, not `<root>/src/`).
@@ -145,7 +142,6 @@ function projectHasSourceFiles(projectRoot) {
     return false;
 }
 /** Detect 0-1: no package.json OR no source files.
- *  Slice 2026-07-15 hot-fix (ice-cola test, 2026-07-15): monorepos with
  *  source under packages/<pkg>/ are no longer mis-classified as 0-1. */
 function isZeroToOneProject(projectRoot) {
     const hasPackageJson = existsSync(join(projectRoot, 'package.json'));

package/dist/services/prd/project-scan-types.d.ts

@@ -5,7 +5,6 @@
  * that carries tech-stack snapshot + business-knowledge sediment. It
  * is the load-bearing input to peaks-prd Step 0.8 ("Read project-scan
  * before brainstorm") and the output sink for peaks-txt's sediment
- * step (Group C, AC-5).
  *
  * Layout:
  *   .peaks/project-scan/

package/dist/services/prd/project-scan-types.js

@@ -5,7 +5,6 @@
  * that carries tech-stack snapshot + business-knowledge sediment. It
  * is the load-bearing input to peaks-prd Step 0.8 ("Read project-scan
  * before brainstorm") and the output sink for peaks-txt's sediment
- * step (Group C, AC-5).
  *
  * Layout:
  *   .peaks/project-scan/

package/dist/services/preferences/preferences-service.d.ts

@@ -11,7 +11,6 @@ export declare function savePreferences(projectRoot: string, overrides: Partial<
  */
 export declare function writeAtomic(filePath: string, prefs: ProjectPreferences): void;
 /**
- * Slice 2026-06-23-audit-4th #C1: migrate a legacy preferences.json
  * (any `schema_version` older than PREFERENCES_SCHEMA_VERSION) to the
  * current shape. Returns the migrated object + a list of changes
  * applied (for surfacing in the CLI envelope and the migration log).