peaks-loop 4.1.1 → 4.1.3

package/dist/services/skillhub/sqlite-store.d.ts

@@ -1,4 +1,4 @@
-import Database from 'better-sqlite3';
+import { type SqliteDatabase } from '../sqlite/sqlite-driver.js';
 /**
  * Open (or create) a SkillHub state database at the given path.
  *
@@ -14,9 +14,9 @@ import Database from 'better-sqlite3';
  * globbing (`*.sql`) and sorted lexicographically so future
  * `002-…`, `003-…` additions are picked up automatically.
  */
-export declare function openStateDb(path: string): Database.Database;
+export declare function openStateDb(path: string): SqliteDatabase;
 /**
  * Return the user-defined table names present in `db` (excluding SQLite
  * system tables such as `sqlite_sequence`).
  */
-export declare function listTables(db: Database.Database): string[];
+export declare function listTables(db: SqliteDatabase): string[];

package/dist/services/skillhub/sqlite-store.js

@@ -1,5 +1,5 @@
-import Database from 'better-sqlite3';
-import { readFileSync, readdirSync, existsSync, mkdirSync } from 'node:fs';
+import { openSqlite, applyPragmas } from '../sqlite/sqlite-driver.js';
+import { existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 /**
@@ -21,9 +21,8 @@ export function openStateDb(path) {
     const parent = dirname(path);
     if (!existsSync(parent))
         mkdirSync(parent, { recursive: true });
-    const db = new Database(path);
-    db.pragma('journal_mode = WAL');
-    db.pragma('foreign_keys = ON');
+    const db = openSqlite(path);
+    applyPragmas(db, ['journal_mode = WAL', 'foreign_keys = ON']);
     const here = dirname(fileURLToPath(import.meta.url));
     const migrationsDir = join(here, 'migrations');
     if (existsSync(migrationsDir)) {

package/dist/services/skills/hooks-codegate-superpowers.d.ts

@@ -15,6 +15,7 @@ interface ResolvedHookSpec {
     readonly hookEnforceSentinel: string;
     readonly hookEnforceMatcher: string;
     readonly hookEnforceEvent: string;
+    readonly hookEnforceMcpMatcher: string | undefined;
     /**
      * True when the gate-enforce entry must be materialized into the IDE's
      * MACHINE-LOCAL settings file rather than the shared one (see
@@ -72,7 +73,6 @@ export type PeaksHookEntry = {
     shell?: string;
 };
 /**
- * Slice 2026-08-06-codegate-vendor-neutral — code-gate hook entry.
  * Vendor-neutral command (`peaks code-gate --json`); the CLI adapter
  * lives in `src/cli/commands/code-gate-command.ts` and the decision
  * logic lives in `src/services/hooks/pre-tool-code-gate.ts`. The
@@ -91,13 +91,11 @@ export declare function resolveLegacySentinels(ide: IdeId): ReadonlyArray<string
  * skill id; the helper `formatSuperpowersDenyEntry` wraps it in the IDE's
  * `UseSkill(...)` envelope.
  *
- * Slice 2026-07-29-worktree-layer3-deny: the list is empty-aware. To deny a
  * new skill, append its id here and re-run `peaks hooks install`. The list
  * is also the inverse for uninstall: `removeHookInstall` rebuilds the deny
  * list by filtering out anything whose wrapped form matches one of these
  * ids.
  *
- * Slice rid-skill-persistence-001 (2026-08-12): four additional skills
  * denied so the superpowers chain cannot silently override peaks-code.
  * All four are referenced by `superpowers:using-superpowers` as the
  * "bug → systematic-debugging / TDD / verification-before-completion /

package/dist/services/skills/hooks-codegate-superpowers.js

@@ -8,6 +8,7 @@
  * type contract re-exported by the caller.
  */
 import { getAdapter } from '../ide/ide-registry.js';
+import { mcpHookMatcher } from '../ide/mcp-tool-matcher.js';
 import { HOOK_COMPACT_SETTLE_COMMAND, HOOK_COMPACT_SETTLE_EVENT, HOOK_COMPACT_SETTLE_MATCHER, HOOK_COMPACT_SETTLE_SENTINEL, HOOK_OUTER_CACHE_COMMAND, HOOK_OUTER_CACHE_EVENT, HOOK_OUTER_CACHE_SENTINEL, HOOK_POST_COMPACT_REINJECT_COMMAND, HOOK_POST_COMPACT_REINJECT_EVENT, HOOK_POST_COMPACT_REINJECT_MATCHER, HOOK_POST_COMPACT_REINJECT_SENTINEL, HOOK_WORKSPACE_INIT_COMMAND, HOOK_WORKSPACE_INIT_EVENT, HOOK_WORKSPACE_INIT_SENTINEL } from './session-start-hook-constants.js';
 /** Sentinel substring identifying a Claude-Code gate-enforce hook entry. */
 export const HOOK_ENFORCE_SENTINEL = 'peaks gate enforce';
@@ -87,6 +88,7 @@ export function resolveHookSpec(ide) {
         hookEnforceSentinel: spec.sentinel,
         hookEnforceMatcher: adapter.toolMatcher,
         hookEnforceEvent: adapter.hookEvent,
+        hookEnforceMcpMatcher: mcpHookMatcher(adapter),
         // Only Claude Code has the machine-local sibling settings file the
         // routing depends on, and only Claude Code's hook schema accepts a
         // `shell` key.
@@ -95,7 +97,6 @@ export function resolveHookSpec(ide) {
     };
 }
 /**
- * Slice 2026-08-06-codegate-vendor-neutral — code-gate hook entry.
  * Vendor-neutral command (`peaks code-gate --json`); the CLI adapter
  * lives in `src/cli/commands/code-gate-command.ts` and the decision
  * logic lives in `src/services/hooks/pre-tool-code-gate.ts`. The
@@ -106,6 +107,27 @@ export const HOOK_CODE_GATE_SENTINEL = 'peaks code-gate';
 export const HOOK_CODE_GATE_MATCHER = 'Edit|Write|MultiEdit';
 export const HOOK_CODE_GATE_EVENT = 'PreToolUse';
 export const HOOK_CODE_GATE_COMMAND = `peaks code-gate --json`;
+/**
+ * The read-only MCP surface as a hook entry: the same command under the
+ * adapter's MCP matcher, or `undefined` for a harness that declares no MCP
+ * naming. A hook fires only for the matchers its OWN entry names, so without this
+ * entry the fail-closed branch in `mcp-surface-gate.ts` never runs on a live
+ * harness. A second entry rather than a wider matcher on the Bash one: that entry
+ * is mirrored by the workspace-init template, and widening it would put installer
+ * and template out of step.
+ */
+function mcpMatcherEntry(spec) {
+    if (spec.hookEnforceMcpMatcher === undefined)
+        return undefined;
+    return {
+        sentinel: spec.hookEnforceSentinel,
+        matcher: spec.hookEnforceMcpMatcher,
+        command: spec.hookEnforceCommand,
+        event: spec.hookEnforceEvent,
+        machineLocal: spec.hookEnforceMachineLocal,
+        ...(spec.hookEnforceShell !== undefined ? { shell: spec.hookEnforceShell } : {})
+    };
+}
 export function resolveHookEntries(ide, _skipProgress = false) {
     const spec = resolveHookSpec(ide);
     const entries = [
@@ -118,6 +140,9 @@ export function resolveHookEntries(ide, _skipProgress = false) {
             ...(spec.hookEnforceShell !== undefined ? { shell: spec.hookEnforceShell } : {})
         }
     ];
+    const mcpEntry = mcpMatcherEntry(spec);
+    if (mcpEntry !== undefined)
+        entries.push(mcpEntry);
     // ── Why the three SessionStart entries below carry NO `shell` pin ─────────
     //
     // The gate-enforce entry above is shell-pinned on Windows (see
@@ -156,7 +181,6 @@ export function resolveHookEntries(ide, _skipProgress = false) {
             command: HOOK_OUTER_CACHE_COMMAND,
             event: HOOK_OUTER_CACHE_EVENT
         });
-        // Slice rid-statusline-stale-ux AC-2: SessionStart outer-cache
         // write is followed by `peaks session primer` entry so that
         // rotation + presence cleanup fire BEFORE the first statusline
         // render of a fresh session. The new subcommand is idempotent
@@ -170,7 +194,6 @@ export function resolveHookEntries(ide, _skipProgress = false) {
             command: HOOK_WORKSPACE_INIT_COMMAND,
             event: HOOK_WORKSPACE_INIT_EVENT
         });
-        // Slice 2026-08-06-codegate-vendor-neutral: code-gate entry on
         // Edit|Write|MultiEdit matcher. Vendor-neutral command
         // (`peaks code-gate --json`); the CLI adapter lives in
         // `src/cli/commands/code-gate-command.ts` and the underlying
@@ -198,7 +221,6 @@ export function resolveHookEntries(ide, _skipProgress = false) {
             command: HOOK_POST_COMPACT_REINJECT_COMMAND,
             event: HOOK_POST_COMPACT_REINJECT_EVENT
         });
-        // rid 2026-09-13-compact-event-settle: the harness's OWN "a compaction
         // completed" event, which is the only signal that settles a compact as a
         // FACT rather than as an inference from a ratio that fell.
         //
@@ -229,14 +251,11 @@ export function resolveLegacySentinels(ide) {
     if (ide === 'trae') {
         return ['peaks hook handle', LEGACY_PROGRESS_START_SENTINEL];
     }
-    // Slice 2026-08-06-session-outer-cache: include the SessionStart outer-cache
     // sentinel so uninstall strips it alongside the gate-enforce entry.
-    // Slice 2026-08-06-codegate-vendor-neutral: also include the code-gate
     // sentinel so uninstall strips the Edit|Write|MultiEdit entry alongside
     // the rest of the peaks-managed entries.
     const base = [HOOK_ENFORCE_SENTINEL, LEGACY_PROGRESS_START_SENTINEL, HOOK_CODE_GATE_SENTINEL];
     if (ide === 'claude-code') {
-        // Slice rid-statusline-stale-ux AC-2: include the SessionStart
         // workspace-init primer sentinel so uninstall strips it alongside
         // the gate-enforce entry, and so hand-added entries matching this
         // sentinel are recognized as peaks-managed (not stripped as
@@ -246,7 +265,6 @@ export function resolveLegacySentinels(ide) {
         // it) exactly like the other two SessionStart entries. Without this the
         // entry would be unremovable by `peaks hooks uninstall` — the rollback
         // path T2 requires.
-        // rid 2026-09-13-compact-event-settle: the PostCompact settle sentinel joins
         // too — same rollback argument as the reinject entry above. A hook that
         // `peaks hooks uninstall` cannot remove is a hook the user cannot get rid
         // of, and this one fires on every compaction.
@@ -260,7 +278,6 @@ export function resolveLegacySentinels(ide) {
     }
     return base;
 }
-// --- Slice 2026-07-29-worktree-layer3-deny -----------------------------------
 // Layer 3 of the Worktree Governance 3-layer design (see
 // .peaks/memory/2026-07-29-worktree-layer3-deny.md). The gateway is the IDE
 // native `permissions.deny` list — Claude Code refuses to invoke any Skill
@@ -288,13 +305,11 @@ export function resolveLegacySentinels(ide) {
  * skill id; the helper `formatSuperpowersDenyEntry` wraps it in the IDE's
  * `UseSkill(...)` envelope.
  *
- * Slice 2026-07-29-worktree-layer3-deny: the list is empty-aware. To deny a
  * new skill, append its id here and re-run `peaks hooks install`. The list
  * is also the inverse for uninstall: `removeHookInstall` rebuilds the deny
  * list by filtering out anything whose wrapped form matches one of these
  * ids.
  *
- * Slice rid-skill-persistence-001 (2026-08-12): four additional skills
  * denied so the superpowers chain cannot silently override peaks-code.
  * All four are referenced by `superpowers:using-superpowers` as the
  * "bug → systematic-debugging / TDD / verification-before-completion /
@@ -309,12 +324,10 @@ export const SUPERPOWERS_DENIED_SKILLS = [
     // `git worktree add`. Denying this Skill at the IDE layer prevents the
     // LLM from ever receiving that prompt.
     'superpowers:using-git-worktrees',
-    // Slice rid-skill-persistence-001: deny the "bug → systematic-debugging"
     // auto-route. Without this entry the chain can preempt the current bee
     // any time a bug report surfaces. Reference-only via
     // references/external-skill-invocation.md §systematic-debugging.
     'superpowers:systematic-debugging',
-    // Slice rid-skill-persistence-001: deny the TDD trigger that the chain
     // pairs with bug reports (write-a-failing-test-first). Reference-only
     // via references/external-skill-invocation.md §test-driven-development.
     'superpowers:test-driven-development',
@@ -323,7 +336,6 @@ export const SUPERPOWERS_DENIED_SKILLS = [
     // claims from peaks-code. Reference-only via
     // references/external-skill-invocation.md §verification-before-completion.
     'superpowers:verification-before-completion',
-    // Slice rid-skill-persistence-001: deny the recursive chain entrypoint
     // itself. Without this entry the chain auto-spawns another
     // "using-superpowers" Skill call right after the previous chain step,
     // creating the recursive override pattern that peaks-loop's L1 guard

package/dist/services/skills/hooks-settings-service.d.ts

@@ -14,7 +14,6 @@ export { HOOK_ENFORCE_SENTINEL, HOOK_CODE_GATE_SENTINEL, HOOK_CODE_GATE_MATCHER,
  * Slice #1 refactor: this service delegates to the `IdeAdapter` for
  * `claude-code`. Slice #2 added Trae. Adapter provides `dirName` /
  * `settingsFileName` / `envVar` / `hookEvent` / `toolMatcher`. The Claude
- * install path is byte-level-compat with slice #0 (AC-1).
  *
  * Slice #3 refactor (this commit): the service is now per-IDE aware via an
  * optional `options.ide` parameter. The CLI command is responsible for
@@ -202,7 +201,6 @@ export declare function applyHookInstall(scope: HookScope, projectRoot?: string,
 export declare function removeHookInstall(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookRemoveResult;
 export declare function readHookStatus(scope: HookScope, projectRoot?: string, options?: HookInstallOptions): HookStatus;
 /**
- * Slice 2026-07-29-worktree-l2-extended Part 27 — trigger-style deny.
  *
  * In addition to the static SUPERPOWERS_DENIED_SKILLS list, peaks
  * scans the existing settings file for "trigger phrases" that

package/dist/services/skills/hooks-settings-service.js

@@ -351,7 +351,6 @@ function shapeMatchesDesired(settings, entries, allPeaksSentinels) {
         //     Presence alone cannot see a WRONG matcher, and a wrong matcher is not
         //     cosmetic: `''` and `Bash|Task` route the same command to different
         //     tool sets, so the entry is present while the hook never fires on the
-        //     tools it was installed for. Measured (rid `2026-09-13-compact-event-settle`,
         //     residual R2): a `PostCompact` entry hand-corrupted to matcher
         //     `auto|manual` survived `peaks hooks install` unchanged, and the
         //     installer was structurally unable to repair it.
@@ -359,8 +358,16 @@ function shapeMatchesDesired(settings, entries, allPeaksSentinels) {
         //     source" — so a file written before matchers were explicit converges
         //     once instead of churning on every install.
         for (const desired of entries.filter((e) => e.event === eventKey)) {
-            const onDisk = peaksPresent.find((entry) => (entry.hooks ?? []).some((h) => String(h.command ?? '').includes(desired.sentinel)));
-            if (onDisk === undefined || (onDisk.matcher ?? '') !== desired.matcher)
+            // The identity of a desired entry is the PAIR (sentinel, matcher), not the
+            // sentinel alone: one command may legitimately be installed under several
+            // matchers (the read-only MCP surface rides `peaks gate enforce` under its
+            // own matcher set). Matching on the sentinel first found that first entry
+            // every time, so the second one never looked installed and every install
+            // rewrote the file. A wrong matcher is still un-repaired — it fails to
+            // match and the caller rewrites.
+            const onDisk = peaksPresent.find((entry) => (entry.matcher ?? '') === desired.matcher &&
+                (entry.hooks ?? []).some((h) => String(h.command ?? '').includes(desired.sentinel)));
+            if (onDisk === undefined)
                 return false;
         }
     }
@@ -483,13 +490,11 @@ export function applyHookInstall(scope, projectRoot, options) {
     if (baseResult.alreadyInstalled) {
         return { ...baseResult, applied: false };
     }
-    // Slice 2026-07-29-worktree-layer3-deny: Layer 3 — write the
     // `permissions.deny` block alongside the gate hook in a single atomic
     // write so the two halves of the install are always co-located. The
     // helper is idempotent and additive: any user-written deny entries
     // are preserved.
     //
-    // Slice 2026-07-29-worktree-l2-extended Part 29: also apply
     // withTriggeredDenyList. If the existing settings file has a
     // superpowers / git-worktree / podman-run entry (any source),
     // the install appends a defensive `Edit(deny-trigger:<phrase>)`
@@ -587,12 +592,10 @@ export function removeHookInstall(scope, projectRoot, options) {
         else {
             delete nextSettings.hooks;
         }
-        // Slice 2026-07-29-worktree-layer3-deny: Layer 3 — symmetric uninstall.
         // Strips the peaks-managed `UseSkill(...)` deny entries alongside the
         // hook entries; user-written entries are untouched. The helper self-
         // decomposes an empty `permissions` object.
         //
-        // Slice 2026-07-29-worktree-l2-extended Part 29: also strip the
         // trigger-style deny entries via withoutTriggeredDenyList. The
         // chain of helpers is order-independent (each is idempotent and
         // additive over the same set of peaks-managed entries).
@@ -662,7 +665,6 @@ export function readHookStatus(scope, projectRoot, options) {
     };
 }
 /**
- * Slice 2026-07-29-worktree-l2-extended Part 27 — trigger-style deny.
  *
  * In addition to the static SUPERPOWERS_DENIED_SKILLS list, peaks
  * scans the existing settings file for "trigger phrases" that

package/dist/services/skills/presence-lease-service.d.ts

@@ -67,7 +67,6 @@ export interface GcPresenceLeasesInput {
 }
 export declare function setPresenceLease(input: SetPresenceLeaseInput): SetPresenceLeaseResult;
 /**
- * Slice 2026-09-09-mode-consolidation (Slice B): stamp `mode` onto every
  * in-flight lease of the bound session, in place.
  *
  * Used by the 24h auto-engage path (T3/T4, `peaks code run --24h`,

package/dist/services/skills/presence-lease-service.js

@@ -176,7 +176,6 @@ export function setPresenceLease(input) {
     };
 }
 /**
- * Slice 2026-09-09-mode-consolidation (Slice B): stamp `mode` onto every
  * in-flight lease of the bound session, in place.
  *
  * Used by the 24h auto-engage path (T3/T4, `peaks code run --24h`,

package/dist/services/skills/session-start-hook-constants.d.ts

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-06-session-outer-cache (G2): per-IDE SessionStart hook
  * constants for the outer-session cache primer. Extracted from
  * `hooks-settings-service.ts` to keep that file under the Karpathy
  * 800 LOC cap.
@@ -16,7 +15,6 @@
  * in by extending `resolveHookEntries` and adding an adapter-driven
  * substitution for the `${...}` project-dir placeholder.
  *
- * Slice rid-statusline-stale-ux AC-2: renamed from
  * `outer-cache-hook-constants.ts` (per RD §10 M-3) and extended with
  * the SessionStart workspace-init primer constants. The primer fires
  * `peaks session primer --project <path>` immediately after the
@@ -71,7 +69,6 @@ export declare const HOOK_OUTER_CACHE_COMMAND = "peaks outer-cache write --proje
 /** SessionStart hook event key for Claude Code. */
 export declare const HOOK_OUTER_CACHE_EVENT = "SessionStart";
 /**
- * Slice rid-statusline-stale-ux AC-2: SessionStart workspace-init
  * primer sentinel. Identifies the SessionStart entry that runs
  * `peaks session primer --project <path>` so rotation + presence
  * cleanup fire on every fresh session, before the first statusline
@@ -84,7 +81,6 @@ export declare const HOOK_WORKSPACE_INIT_COMMAND = "peaks session primer --proje
 /** SessionStart hook event key (same as outer-cache). */
 export declare const HOOK_WORKSPACE_INIT_EVENT = "SessionStart";
 /**
- * rid `2026-09-13-compact-event-settle` — the `PostCompact` entry that lets the
  * harness's own event settle a compact, instead of the next `context-now` probe
  * inferring one from a ratio that fell.
  *

package/dist/services/skills/session-start-hook-constants.js

@@ -1,5 +1,4 @@
 /**
- * Slice 2026-08-06-session-outer-cache (G2): per-IDE SessionStart hook
  * constants for the outer-session cache primer. Extracted from
  * `hooks-settings-service.ts` to keep that file under the Karpathy
  * 800 LOC cap.
@@ -16,7 +15,6 @@
  * in by extending `resolveHookEntries` and adding an adapter-driven
  * substitution for the `${...}` project-dir placeholder.
  *
- * Slice rid-statusline-stale-ux AC-2: renamed from
  * `outer-cache-hook-constants.ts` (per RD §10 M-3) and extended with
  * the SessionStart workspace-init primer constants. The primer fires
  * `peaks session primer --project <path>` immediately after the
@@ -71,7 +69,6 @@ export const HOOK_OUTER_CACHE_COMMAND = `peaks outer-cache write --project "\${C
 /** SessionStart hook event key for Claude Code. */
 export const HOOK_OUTER_CACHE_EVENT = 'SessionStart';
 /**
- * Slice rid-statusline-stale-ux AC-2: SessionStart workspace-init
  * primer sentinel. Identifies the SessionStart entry that runs
  * `peaks session primer --project <path>` so rotation + presence
  * cleanup fire on every fresh session, before the first statusline
@@ -84,7 +81,6 @@ export const HOOK_WORKSPACE_INIT_COMMAND = `peaks session primer --project "\${C
 /** SessionStart hook event key (same as outer-cache). */
 export const HOOK_WORKSPACE_INIT_EVENT = 'SessionStart';
 /**
- * rid `2026-09-13-compact-event-settle` — the `PostCompact` entry that lets the
  * harness's own event settle a compact, instead of the next `context-now` probe
  * inferring one from a ratio that fell.
  *

package/dist/services/skills/skill-presence-service.d.ts

@@ -32,12 +32,9 @@ export type SkillPresence = {
      * between the last presence write and this one AND the bound
      * peaks session has a different (or no) recorded outer session id.
      *
-     * As of slice 018 (auto-roll on outer-mismatch), the field is
      * informational only — it tells the statusline and any log /
      * observability consumer that an outer-session swap was observed
      * on the previous heartbeat. The actual binding rotation is
-     * performed by `ensureSessionWithRotation` (slice 018), not by
-     * `setSkillPresence`. `peaks-code`'s Step 0 used to read this
      * field and turn it into an AskUserQuestion; that ask is no
      * longer needed because the rotation already happened by the time
      * the skill is invoked.
@@ -74,7 +71,6 @@ export type SkillPresence = {
  * to auto-resolve `--session-id` when the LLM driver forgets to
  * pass the flag, so dispatch records land in the right
  * `.peaks/_sub_agents/<sid>/` tree instead of an `unknown-sid`
- * fallback (slice 2026-06-26-unknown-sid-fallback-fix).
  */
 export declare function getCurrentSessionId(projectRootOverride?: string): string | null;
 /**
@@ -91,7 +87,6 @@ export declare function setSkillPresenceForCaller(projectRootOverride: string, c
 export declare function setSkillPresence(skill: string, mode?: string, gate?: string, projectRootOverride?: string): SkillPresence;
 export declare function getSkillPresence(projectRootOverride?: string): SkillPresence | null;
 /**
- * Slice 002 (v2.15.0) — presence staleness detection (AC-1).
  *
  * Compare the *outer* session id stamped onto the current presence
  * marker against the *current* outer session id (from
@@ -146,8 +141,6 @@ export declare function checkStalePresence(opts?: {
     currentOuter?: string | undefined;
 }): StalenessCheck;
 /**
- * Slice 002 (v2.15.0) — auto-clear stale presence on session
- * rotation (AC-1).
  *
  * Called from `peaks workspace init` immediately after a successful
  * `outer-session-mismatch` rotation. When the previous session's
@@ -155,7 +148,6 @@ export declare function checkStalePresence(opts?: {
  * clearing it prevents peaks-code Step 1 from picking up a stale
  * `mode` field that the user never explicitly chose.
  *
- * Slice rid-skill-persistence-001 (2026-08-12): added an outerSessionId
  * intent-source guard at the top of the function. The user constraint
  * (preserved in `.peaks/memory/2026-08-11-peaks-code-skill-persistence-pause.md`)
  * requires that "the current bee (peaks-code) can only be replaced or

package/dist/services/skills/skill-presence-service.js

@@ -25,7 +25,6 @@ export const VALID_SKILL_PRESENCE_MODES = [
     'strict',
     '24h'
 ];
-// Migration note (slice 2026-09-09-mode-consolidation): `swarm` was REMOVED
 // as a mode — parallel fan-out is now the default execution strategy in
 // every mode. A legacy on-disk `mode: 'swarm'` is normalized on read to
 // `'full-auto'` (never crash, never drop the presence).
@@ -105,7 +104,6 @@ function resolveProjectRoot(override) {
  * to auto-resolve `--session-id` when the LLM driver forgets to
  * pass the flag, so dispatch records land in the right
  * `.peaks/_sub_agents/<sid>/` tree instead of an `unknown-sid`
- * fallback (slice 2026-06-26-unknown-sid-fallback-fix).
  */
 export function getCurrentSessionId(projectRootOverride) {
     const projectRoot = resolveProjectRoot(projectRootOverride);
@@ -161,7 +159,6 @@ function readSkillPresenceFromLease(projectRootOverride) {
     // not the legacy `outerSessionId` field. Project it for back-compat
     // with `clearStalePresenceOnRotation`'s outer-mismatch check.
     //
-    // Slice 2026-09-09-mode-consolidation: `mode` is projected too (it was
     // silently dropped before, which made `getSkillPresence().mode` always
     // undefined and left every `presence.mode` consumer dead). Normalize on
     // read so a legacy `'swarm'` lease surfaces as `'full-auto'`.
@@ -206,12 +203,10 @@ function getBoundOuterSessionId(projectRootOverride) {
  * are about to stamp, the user probably closed the previous outer
  * session and is now driving peaks from a new one.
  *
- * As of slice 018 (auto-roll on outer-mismatch), the actual rotation
  * is `ensureSessionWithRotation`'s job, not this one. The presence
  * service still emits the structured `outerSessionMismatch` field on
  * the presence envelope (useful for the statusline to render a stale
  * marker and for the QA / log consumers to know an outer-session swap
- * happened), but it no longer carries the implicit "ask the user"
  * promise — `peaks-code`'s Step 0 no longer needs to surface an
  * AskUserQuestion, because the rotation already fired by the time the
  * skill is invoked.
@@ -232,12 +227,10 @@ function getPreviousOuterSessionId(projectRootOverride) {
     return undefined;
 }
 // ============================================================================
-// Slice 020 — caller-keyed active-skill marker (D6).
 // ============================================================================
 //
 // Today's per-project active-skill marker (`.peaks/_runtime/active-skill.json`)
 // races when multiple Claude Code windows (or different platforms) drive the
-// same project concurrently. Slice 020 introduces a per-caller file at
 // `.peaks/_runtime/<peakSid>/active-skill-<callerId>.json` (D6). Two callers
 // bound to the same peak session never clobber each other.
 //
@@ -311,7 +304,6 @@ export function setSkillPresence(skill, mode, gate, projectRootOverride) {
     const outerSessionId = getCurrentOuterSessionId();
     const previousOuterSessionId = getPreviousOuterSessionId(projectRootOverride);
     const now = new Date().toISOString();
-    // v2.15.0 slice 002 repair: always write `outerSessionId` (even
     // as `''`) when no harness env var is set. Without this, the JSON
     // envelope omits the key entirely, which makes downstream staleness
     // detection unreliable (consumers can't tell "no signal" from
@@ -368,7 +360,6 @@ export function setSkillPresence(skill, mode, gate, projectRootOverride) {
                     import('./presence-lease-service.js')
                 ]);
                 const projection = resolveCallerProjection({ projectRoot, env: process.env });
-                // Slice 2026-08-06-session-cacde8-A.4: derive the legacy compat
                 // shim's workflowId from `projection.callerId` (caller-keyed,
                 // matching the 4.0.8 caller-binding direction) instead of
                 // `sessionId` (sid-keyed, pre-4.0.8). `slice(0, 189)` caps the
@@ -479,8 +470,6 @@ export function checkStalePresence(opts) {
     };
 }
 /**
- * Slice 002 (v2.15.0) — auto-clear stale presence on session
- * rotation (AC-1).
  *
  * Called from `peaks workspace init` immediately after a successful
  * `outer-session-mismatch` rotation. When the previous session's
@@ -488,7 +477,6 @@ export function checkStalePresence(opts) {
  * clearing it prevents peaks-code Step 1 from picking up a stale
  * `mode` field that the user never explicitly chose.
  *
- * Slice rid-skill-persistence-001 (2026-08-12): added an outerSessionId
  * intent-source guard at the top of the function. The user constraint
  * (preserved in `.peaks/memory/2026-08-11-peaks-code-skill-persistence-pause.md`)
  * requires that "the current bee (peaks-code) can only be replaced or
@@ -525,7 +513,6 @@ export function checkStalePresence(opts) {
  * decide what the "rotated-out" id was.
  */
 export function clearStalePresenceOnRotation(opts) {
-    // Slice rid-skill-persistence-001 (2026-08-12): user-explicit intent
     // guard. When the caller has no caller-binding outerSessionId
     // (env vars unset, system-triggered rotation), refuse the mutation
     // up-front — the recorded presence may belong to a user-explicit

package/dist/services/skills/skill-statusline-model.d.ts

@@ -42,7 +42,6 @@ export type StatusLineModel = {
     compact: CompactStatuslineState;
     activeLeaf: StatusLineActiveLeaf | null;
     /**
-     * Slice 2026-08-05-statusline-sid-only-marker: the canonical session
      * id resolved for the project root (`getSessionIdCanonical`), or
      * `null` when no project root is bound or no `.peaks/_runtime/<sid>/`
      * session is on disk. The renderer reads this to append ` [shortSid]`
@@ -56,7 +55,6 @@ export type StatusLineModel = {
      */
     sessionId: string | null;
     /**
-     * Slice rid-statusline-24h-overlay (2026-08-10): the 24h-mode
      * overlay snapshot read from `.peaks/_runtime/<sid>/24h-state.json`,
      * or `null` when no file exists / file is corrupt / file has wrong
      * shape. The renderer reads this to append `[24h-<state>]` after
@@ -68,25 +66,21 @@ export type StatusLineModel = {
     twentyFourHourState: TwentyFourHourOverlay | null;
 };
 /**
- * Slice rid-statusline-24h-overlay (2026-08-10): minimal overlay
  * type returned by `read24hOverlay`. The renderer only consumes
  * `state` (to format `[24h-<state.toLowerCase()>]`). The canonical
  * schema at `src/services/24h-mode/state.ts:55-66` carries additional
  * fields (`attempts: Record<DecisionKey, number>`, `enteredAt`,
  * `checkpoints`, etc.) but the overlay is deliberately MINIMAL —
  * it tolerates forward compatibility with new states the writer
- * may add, and it never throws on malformed shapes (PRD AC-3:
  * graceful null on any invalid input).
  */
 export type TwentyFourHourOverlay = {
     state: string;
 };
 /**
- * Slice rid-statusline-24h-overlay (2026-08-10): name-distinct from
  * the canonical `read24hState` in `src/services/24h-mode/store.ts:108`.
  * The canonical reader calls `coerceSnapshot` (which throws on
  * malformed shapes via `24H_STATE_INVALID`); this overlay reader
- * returns `null` for ANY malformed shape (per PRD AC-3 — never
  * throw across the statusline boundary).
  *
  * Returns null when:

package/dist/services/skills/skill-statusline-model.js

@@ -13,11 +13,9 @@ import { decideCompactStatusline } from '../compact-statusline/compact-statuslin
 import { getSessionIdCanonical } from '../session/session-manager.js';
 import { readActiveDispatchIndex } from '../dispatch/dispatch-record-writer.js';
 /**
- * Slice rid-statusline-24h-overlay (2026-08-10): name-distinct from
  * the canonical `read24hState` in `src/services/24h-mode/store.ts:108`.
  * The canonical reader calls `coerceSnapshot` (which throws on
  * malformed shapes via `24H_STATE_INVALID`); this overlay reader
- * returns `null` for ANY malformed shape (per PRD AC-3 — never
  * throw across the statusline boundary).
  *
  * Returns null when:
@@ -44,7 +42,6 @@ export function read24hOverlay(projectRoot, sessionId) {
         parsed = JSON.parse(raw);
     }
     catch {
-        // corrupt JSON — graceful null (PRD AC-3)
         return null;
     }
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
@@ -125,7 +122,7 @@ export function readActiveLeaf(projectRoot, sessionId) {
         'never-started',
         'unreadable',
         'stale',
-        'queued' // Slice 2026-08-05 fix: stale dispatch entries stuck at 'queued' should
+        'queued'
         // not pollute statusline as in-flight leaves.
     ]);
     const inFlight = Object.values(index).filter((e) => !terminalStatuses.has(e.status));

package/dist/services/skills/skill-statusline-renderer.d.ts

@@ -20,7 +20,6 @@ export interface StatusLineRenderOptions {
 }
 export declare function formatHumanAge(ageMs: number | null): string;
 /**
- * Slice rid-statusline-24h-overlay (2026-08-10): format the 24h-mode
  * overlay suffix appended after the existing `<baseMode>` token in
  * the ACTIVE state. Returns `''` when the overlay is `null` (missing
  * file / corrupt file / wrong shape — see `read24hOverlay`).