peaks-loop 4.1.1 → 4.1.2

package/dist/services/session/binding-store.js

@@ -6,7 +6,6 @@
  *
  * v2.16.0 schema is a multi-instance registry with conflict-detection
  * sentinel fields (ownerHint, pid, lastHeartbeat, instances Map).
- * See PRD `001-2026-06-29-v2-16-0-change-id-axis-removal` AC-8.
  *
  * The store keeps a one-shot migration from the legacy schema:
  * legacy single-session binding → v2.16.0 instances Map with one entry,
@@ -60,7 +59,6 @@ function getCurrentOuterSessionId() {
  * both env vars unset returns the literal `'unknown'` sentinel
  * for every process. Suffixing with `process.pid` makes the
  * callerId process-unique without changing the surface (no new
- * env var, no new schema field), preserving the AC-5 hard rule
  * that "one Claude instance keeps one sid across multiple
  * peaks-* skill activations" — a single process keeps a constant
  * pid across the whole run, including `/compact`.
@@ -144,7 +142,6 @@ export function readBinding(projectRoot) {
         typeof legacyShape.createdAt === 'string' &&
         typeof legacyShape.projectRoot === 'string') {
         // Auto-migrate marks lastHeartbeat as `now` (not `createdAt`) so the
-        // migrated instance does NOT immediately appear stale to AC-10.
         // Legacy bindings date from the pre-v2.16.0 single-session era;
         // their createdAt predates the binding sentinel concept entirely.
         const migratedAt = nowIso();
@@ -226,7 +223,6 @@ export function registerInstance(projectRoot, opts) {
         }
         // Auto-resume: caller already has an instance in this scope —
         // append roles and refresh heartbeat instead of creating a new
-        // sid. This is the AC-5 Claude-instance-level hard rule: a
         // single Claude caller keeps one sid across multiple peaks-*
         // skill activations.
         const existingSidForCaller = Object.entries(existing.instances).find(([, inst]) => inst.callerId === callerId)?.[0];
@@ -283,7 +279,6 @@ export function registerInstance(projectRoot, opts) {
 }
 /**
  * Touch the `lastHeartbeat` for a specific instance. Used by the
- * Doctor periodic loop (AC-10) and by the Skill presence `startup`
  * gate.
  */
 export function heartbeat(projectRoot, sid) {
@@ -307,7 +302,6 @@ export function heartbeat(projectRoot, sid) {
 }
 /**
  * Drop an instance entry from the binding. Used when the last peaks-*
- * skill on a Claude instance exits (AC-7: all skills inactive →
  * no record). Returns the updated binding (or null if no instances
  * remain and the caller wants to delete the binding entirely).
  */
@@ -328,7 +322,6 @@ export function dropInstance(projectRoot, sid) {
 /**
  * Drop stale instances (lastHeartbeat older than `ttlMs`). Returns
  * the list of dropped sid values so the caller can log them. Used
- * by AC-10 Doctor.
  */
 export function dropStale(projectRoot, ttlMs) {
     const existing = readBinding(projectRoot);

package/dist/services/session/caller-binding-service.d.ts

@@ -1,5 +1,4 @@
 /**
- * Caller-Binding Service (slice 020 — caller-keyed session binding).
  *
  * Each caller has its own on-disk binding file at
  * `.peaks/_runtime/callers/<callerId>.json`. This service is the
@@ -33,7 +32,6 @@ export declare function getActiveSkillFileForCaller(projectRoot: string, peakSes
  * Resolve a stable, deterministic callerId for a legacy single-file
  * binding (M2). The hash input priority is:
  *
- *   1. `outerSessionId` (slice 018 stamped this on the per-peak
  *      session.json for sessions created after the slice shipped).
  *   2. `claudeSessionId` (legacy field name on pre-018 presence
  *      files; honour the read side so v1.2.x data does not lose its
@@ -59,11 +57,9 @@ export declare function getCallerBinding(projectRoot: string, callerId: string):
  *
  * `getCallerBinding` answers a SHAPE question: "is there a well-formed
  * binding file for this caller?". Session resolution needs a second
- * answer: "is that binding still USABLE?". Slice 2026-09-12
  * (rid=caller-binding-staleness) found it is not when the bound session's
  * directory is gone — the binding was still trusted, so a command
  * resolved the dead session id and `mkdir`'d a fresh tree under
- * `.peaks/_runtime/<gone-sid>/...` for a session that no longer exists.
  *
  * Returns a tagged result rather than `null` so the fall-through is
  * observable to the caller instead of silent:
@@ -88,7 +84,6 @@ export declare function resolveCallerBinding(projectRoot: string, callerId: stri
  * must be a valid session id, projectRoot is canonicalized). Idempotent:
  * re-writing the same callerId overwrites the file.
  *
- * Slice 2026-08-06-session-cacde8-A.5b: writes via `atomicWriteJson`
  * (temp-file-then-rename) so a power-loss mid-write cannot leave the
  * caller-binding file in a half-truncated state. `atomicWriteJson`
  * owns its own `mkdirSync(dir, { recursive: true })`, so the inline
@@ -99,7 +94,6 @@ export declare function setCallerBinding(projectRoot: string, callerId: string,
 /**
  * Repoint an EXISTING per-caller binding at a new peak session id.
  *
- * Slice 2026-09-10 (rid=rebind-must-update-caller-binding): an explicit
  * `peaks workspace init --session-id <X> --allow-session-rebind` rewrites
  * the project-global `.peaks/_runtime/session.json`. Without this call the
  * per-caller file keeps shadowing it for `getSessionIdCanonical`, so the

package/dist/services/session/caller-binding-service.js

@@ -1,5 +1,4 @@
 /**
- * Caller-Binding Service (slice 020 — caller-keyed session binding).
  *
  * Each caller has its own on-disk binding file at
  * `.peaks/_runtime/callers/<callerId>.json`. This service is the
@@ -50,7 +49,6 @@ export function getActiveSkillFileForCaller(projectRoot, peakSessionId, callerId
  * Resolve a stable, deterministic callerId for a legacy single-file
  * binding (M2). The hash input priority is:
  *
- *   1. `outerSessionId` (slice 018 stamped this on the per-peak
  *      session.json for sessions created after the slice shipped).
  *   2. `claudeSessionId` (legacy field name on pre-018 presence
  *      files; honour the read side so v1.2.x data does not lose its
@@ -112,7 +110,6 @@ export function resolveCallerBinding(projectRoot, callerId) {
  * must be a valid session id, projectRoot is canonicalized). Idempotent:
  * re-writing the same callerId overwrites the file.
  *
- * Slice 2026-08-06-session-cacde8-A.5b: writes via `atomicWriteJson`
  * (temp-file-then-rename) so a power-loss mid-write cannot leave the
  * caller-binding file in a half-truncated state. `atomicWriteJson`
  * owns its own `mkdirSync(dir, { recursive: true })`, so the inline
@@ -133,7 +130,6 @@ export function setCallerBinding(projectRoot, callerId, binding) {
 /**
  * Repoint an EXISTING per-caller binding at a new peak session id.
  *
- * Slice 2026-09-10 (rid=rebind-must-update-caller-binding): an explicit
  * `peaks workspace init --session-id <X> --allow-session-rebind` rewrites
  * the project-global `.peaks/_runtime/session.json`. Without this call the
  * per-caller file keeps shadowing it for `getSessionIdCanonical`, so the

package/dist/services/session/caller-id-types.d.ts

@@ -1,5 +1,4 @@
 /**
- * Caller-Id Resolution types (slice 020 — caller-keyed session binding,
  * refactored in slice 4.0.8 to be adapter-owned per RD §5).
  *
  * Per RD §5 + C1 user-confirmed product decision (binding 2026-08-03):
@@ -14,7 +13,6 @@
  * core resolution path only ever emits `'env-flag' | 'adapter' | 'none'`
  * via the new `CallerProjection.source` field.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 export type CallerIdSource = 'flag' | 'env' | 'fallback' | 'none';
@@ -59,7 +57,6 @@ export interface CallerProjection {
  * On-disk shape of `.peaks/_runtime/callers/<callerId>.json`. One file
  * per caller; two callers may point to the same `peakSessionId` (D6).
  *
- * Slice 2026-09-12 (rid=caller-binding-staleness): the former
  * `lastActivityAt` field is REMOVED. It promised "bumped on every
  * `peaks <cmd>` that touches the binding" but was written only at first
  * bind and at an explicit rebind — never on reuse — so no freshness

package/dist/services/session/caller-id-types.js

@@ -1,5 +1,4 @@
 /**
- * Caller-Id Resolution types (slice 020 — caller-keyed session binding,
  * refactored in slice 4.0.8 to be adapter-owned per RD §5).
  *
  * Per RD §5 + C1 user-confirmed product decision (binding 2026-08-03):
@@ -14,7 +13,6 @@
  * core resolution path only ever emits `'env-flag' | 'adapter' | 'none'`
  * via the new `CallerProjection.source` field.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 /**

package/dist/services/session/getSessionDir.js

@@ -1,7 +1,6 @@
 /**
  * Canonical session-directory resolver.
  *
- * As of slice 2026-06-05-peaks-runtime-layer the per-session workspace
  * lives at `<root>/.peaks/_runtime/<sessionId>/`, NOT at the legacy
  * `<root>/.peaks/<sessionId>/` location. All **write** paths MUST route
  * through this helper. The legacy top-level path survives only as a

package/dist/services/session/index.js

@@ -1,6 +1,5 @@
 export { ensureSession, getSessionId, resolveCallerBoundSession, getCurrentSessionDir, listSessions, getSessionMeta, setSessionMeta, setSessionTitle, listSessionMetas, getProjectScanPath, hasProjectScan, setCurrentSessionBinding, rotateSessionBinding } from './session-manager.js';
 export { getSessionDir } from './getSessionDir.js';
-// Slice 020 — caller-keyed session binding. The new canonical path.
 export { resolveCallerId } from './resolve-caller-id.js';
 export { getCallerBindingFile, getActiveSkillFileForCaller, synthesiseLegacyCallerId, getCallerBinding, resolveCallerBinding, setCallerBinding, listCallerBindings } from './caller-binding-service.js';
 // Slice 4.0.8 (C1): PLATFORM_FALLBACKS is deleted. Re-export kept as

package/dist/services/session/platform-fallbacks.d.ts

@@ -11,8 +11,6 @@
  * This file remains for one minor release as a no-op stub so legacy
  * imports keep type-checking. The named export is now an empty
  * readonly array; tests asserting `PLATFORM_FALLBACKS.length === 1`
- * (slice 020 A5) have been moved into the 4.0.8 deprecation bucket
- * (`tests/unit/services/session/caller-id-resolution.test.ts` will be
  * updated in a follow-up slice — out of scope for the 4.0.8 contract
  * freeze).
  *
@@ -21,7 +19,6 @@
  * (`getAdapter(ide).resolveCallerId(env)`), with `PEAKS_CALLER_ID` /
  * `--caller-id <id>` as the vendor-neutral short-circuits.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 export interface PlatformFallback {

package/dist/services/session/platform-fallbacks.js

@@ -11,8 +11,6 @@
  * This file remains for one minor release as a no-op stub so legacy
  * imports keep type-checking. The named export is now an empty
  * readonly array; tests asserting `PLATFORM_FALLBACKS.length === 1`
- * (slice 020 A5) have been moved into the 4.0.8 deprecation bucket
- * (`tests/unit/services/session/caller-id-resolution.test.ts` will be
  * updated in a follow-up slice — out of scope for the 4.0.8 contract
  * freeze).
  *
@@ -21,7 +19,6 @@
  * (`getAdapter(ide).resolveCallerId(env)`), with `PEAKS_CALLER_ID` /
  * `--caller-id <id>` as the vendor-neutral short-circuits.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 /**

package/dist/services/session/resolve-caller-id.d.ts

@@ -1,5 +1,4 @@
 /**
- * Caller-Id Resolution (slice 020 — caller-keyed session binding,
  * refactored in slice 4.0.8 to be adapter-owned per RD §5 + C1).
  *
  * As of 4.0.8 the per-platform `PLATFORM_FALLBACKS` table is DELETED.
@@ -30,7 +29,6 @@
  * mutate state. The caller (a CLI command, a service, a test) decides
  * what to do with the resolved id.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 import { CallerIdError, type CallerProjection, type CallerProjectionSource } from './caller-id-types.js';

package/dist/services/session/resolve-caller-id.js

@@ -1,5 +1,4 @@
 /**
- * Caller-Id Resolution (slice 020 — caller-keyed session binding,
  * refactored in slice 4.0.8 to be adapter-owned per RD §5 + C1).
  *
  * As of 4.0.8 the per-platform `PLATFORM_FALLBACKS` table is DELETED.
@@ -30,7 +29,6 @@
  * mutate state. The caller (a CLI command, a service, a test) decides
  * what to do with the resolved id.
  *
- * See `.peaks/_runtime/2026-08-03-session-bee258/rd/requests/001-2026-08-03-presence-lease-graph-design.md`
  * for the slice 4.0.8 contract.
  */
 import { CALLER_ID_REGEX, CallerIdError } from './caller-id-types.js';

package/dist/services/session/session-binding-bridge.d.ts

@@ -48,7 +48,6 @@ export declare function ensureSession(projectRoot: string): Promise<string>;
 /**
  * Outer-session-aware wrapper around `ensureSession`.
  *
- * Slice 018 (auto-roll on outer-mismatch). When the current outer
  * session id (sourced from `PEAKS_OUTER_SESSION_ID` with
  * `CLAUDE_CODE_SESSION_ID` as the Claude-Code fallback) differs from
  * the outer session id recorded on the *bound* peaks session's
@@ -69,7 +68,6 @@ export declare function ensureSession(projectRoot: string): Promise<string>;
  *   3. The bound session's recorded outer session id matches the
  *      current one (reconnect within the same Claude session) — this
  *      is the common case, not a swap.
- *   4. Slice 2026-08-06-session-cacde8-A.3: same-process re-resolve —
  *      `lastResolvedOuter.value` was already set to `currentOuterSessionId`
  *      in this process and `boundOuter` equals that same value. Long-
  *      running presence-lease writers that re-resolve within a single

package/dist/services/session/session-binding-bridge.js

@@ -32,7 +32,6 @@ import { getSessionId, getSessionIdCanonical, getSessionMeta, rotateSessionBindi
 const SESSION_FILE = join('_runtime', 'session.json');
 const LEGACY_SESSION_FILE = '.session.json';
 const META_FILE = 'session.json';
-// Slice 2026-08-06-session-outer-cache: per-project file cache for the
 // outer (Claude Code / Trae / IDE) session id. Written by the
 // SessionStart hook via `peaks outer-cache write` so that peaks CLI
 // sub-processes (which do NOT inherit CLAUDE_CODE_SESSION_ID) can still
@@ -130,7 +129,6 @@ function writeSessionMeta(projectRoot, sessionId, meta) {
     }
     writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf8');
 }
-// Slice 2026-08-06-session-cacde8-A.3: module-scoped state populated on
 // every non-throw `getCurrentOuterSessionId` call. The 4th rotation
 // guard in `ensureSessionWithRotation` short-circuits when both
 // `currentOuterSessionId` and `boundOuter` equal the last-resolved
@@ -151,7 +149,6 @@ function getCurrentOuterSessionId(projectRoot) {
             resolved = claude;
         }
         else {
-            // Slice 2026-08-06-session-outer-cache (G1): when the peaks CLI runs
             // as a sub-process of Claude Code (or any IDE that does not export
             // CLAUDE_CODE_SESSION_ID into the child env), the env vars above are
             // undefined. Fall back to the per-project file cache written by the
@@ -195,7 +192,6 @@ export function _resetLastResolvedOuterForTest() {
     lastResolvedOuter = null;
 }
 /**
- * Slice 2026-08-06-session-cacde8-A.5a: resolve the current callerId
  * (if any) and look up the per-caller binding. Returns the bound
  * sessionId + creation timestamp, or `null` when caller-id
  * resolution fails (`PEAKS_CALLER_NOT_RESOLVED`) or no per-caller
@@ -204,7 +200,6 @@ export function _resetLastResolvedOuterForTest() {
  * written by a previous call from the same caller is preferred over
  * a stale `session.json` (the legacy single-file binding).
  *
- * Slice 2026-09-12 (rid=caller-binding-staleness): the binding is only
  * usable when its bound session directory still exists
  * (`resolveCallerBinding`). A binding pointing at a deleted session
  * directory is treated as absent, so `ensureSession` falls through and
@@ -235,7 +230,6 @@ function resolveCallerBindingForEnsure(projectRoot) {
     }
 }
 export async function ensureSession(projectRoot) {
-    // Slice 2026-08-06-session-cacde8-A.5a: 3-tier read order —
     // (1) per-caller binding (caller-keyed, primary), (2) legacy
     // `session.json`, (3) fresh-generate. The per-caller lookup is
     // preferred when `resolveCallerProjection` succeeds AND the
@@ -251,7 +245,6 @@ export async function ensureSession(projectRoot) {
         if (outerSessionId !== undefined) {
             setSessionMeta(projectRoot, callerBinding.sessionId, { outerSessionId });
         }
-        // Slice 2026-08-06-session-cacde8-A.5a: dual-write — also write
         // the legacy `session.json` (denormalized cache) when missing,
         // so legacy consumers (e.g. `getSessionId` callers without a
         // resolved callerId) still find the binding. The per-caller
@@ -268,7 +261,6 @@ export async function ensureSession(projectRoot) {
     }
     const existing = readSessionFile(projectRoot);
     if (existing) {
-        // Slice 2026-08-06-session-outer-cache (G3 / AC8-AC11): on every
         // already-bound invocation, stamp the current outer-session-id
         // onto the bound session's meta so the on-disk
         // `.peaks/_runtime/<sid>/session.json` always reflects the latest
@@ -284,7 +276,6 @@ export async function ensureSession(projectRoot) {
         }
         return existing.sessionId;
     }
-    // Slice 007 — sub-agent session sharing. When the strict-equality
     // read returns null (e.g. the binding was written with the relative
     // form "." from inside the project dir, but the caller passes the
     // absolute realpath), fall through to the canonical-fallback read.
@@ -309,7 +300,6 @@ export async function ensureSession(projectRoot) {
         createdAt: now,
         projectRoot
     };
-    // Slice 2026-08-06-session-cacde8-A.5a: dual-write on fresh-generate.
     // The per-caller file is the 4.0.8 source of truth; the legacy
     // `session.json` is a denormalized cache for consumers that have
     // not migrated to `getCallerBinding`. Per-caller file is written
@@ -345,7 +335,6 @@ export async function ensureSession(projectRoot) {
     writeSessionFile(projectRoot, info);
     await initWorkspace({ projectRoot, sessionId });
     // Initialize session metadata inside the session directory.
-    // Slice 2026-08-06-session-outer-cache (G1): pass `projectRoot` so
     // the env → file-cache → undefined resolution chain also reads the
     // SessionStart-written cache on first bind.
     const outerSessionId = getCurrentOuterSessionId(projectRoot);
@@ -360,7 +349,6 @@ export async function ensureSession(projectRoot) {
 /**
  * Outer-session-aware wrapper around `ensureSession`.
  *
- * Slice 018 (auto-roll on outer-mismatch). When the current outer
  * session id (sourced from `PEAKS_OUTER_SESSION_ID` with
  * `CLAUDE_CODE_SESSION_ID` as the Claude-Code fallback) differs from
  * the outer session id recorded on the *bound* peaks session's
@@ -381,7 +369,6 @@ export async function ensureSession(projectRoot) {
  *   3. The bound session's recorded outer session id matches the
  *      current one (reconnect within the same Claude session) — this
  *      is the common case, not a swap.
- *   4. Slice 2026-08-06-session-cacde8-A.3: same-process re-resolve —
  *      `lastResolvedOuter.value` was already set to `currentOuterSessionId`
  *      in this process and `boundOuter` equals that same value. Long-
  *      running presence-lease writers that re-resolve within a single
@@ -403,7 +390,6 @@ export async function ensureSession(projectRoot) {
  */
 export async function ensureSessionWithRotation(projectRoot, options) {
     const skipRotate = options?.skipRotateOnOuterMismatch === true;
-    // Slice 2026-08-06-session-outer-cache (G1): pass `projectRoot` so
     // the rotation-decision comparison sees the SessionStart cache
     // when the env vars are unset (sub-process / nested invocation).
     const currentOuterSessionId = getCurrentOuterSessionId(projectRoot);
@@ -419,7 +405,6 @@ export async function ensureSessionWithRotation(projectRoot, options) {
     if (boundSessionId !== null && currentOuterSessionId !== undefined) {
         const boundMeta = getSessionMeta(projectRoot, boundSessionId);
         const boundOuter = boundMeta?.outerSessionId;
-        // Slice 2026-08-06-session-cacde8-A.3: 4th guard — same-process
         // re-resolve. When `lastResolvedOuter` was already set to the
         // current outer AND the bound session's recorded outer equals
         // the same value, the rotation decision was already evaluated

package/dist/services/session/session-checkpoint-service.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-timestamp>.json`. Idempotent —

package/dist/services/session/session-checkpoint-service.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-timestamp>.json`. Idempotent —

package/dist/services/session/session-manager.d.ts

@@ -41,7 +41,6 @@ export type SessionMeta = {
  * `.peaks/.session.json` if present so a stale read from another
  * tool cannot re-bind the project after rotation. Also drops the
  * ROTATING caller's per-caller binding when it points at the rotated-out
- * session (slice 2026-09-12, rid=caller-binding-staleness) — see
  * `clearRotatedCallerBinding`.
  *
  * Returns the id of the session that was unbound, or `null` if
@@ -49,7 +48,6 @@ export type SessionMeta = {
  * with that — at minimum surface it in the CLI response so the
  * user can find the directory again if they need to.
  *
- * Slice 008 (F22 fix): the read uses the canonicalize-on-read
  * variant so a binding written with `projectRoot: "."` (relative
  * form, anchored from inside the project dir) is still found when
  * the caller passes the absolute realpath. Pre-F22 the
@@ -86,7 +84,6 @@ export declare function setSessionTitle(projectRoot: string, sessionId: string,
  * List all session directories under .peaks with their metadata.
  * Returns sessions sorted by sessionId descending (most recent first).
  *
- * As of slice 2026-06-06-session-layout-canonicalize the session
  * dirs live at the canonical runtime home `.peaks/_runtime/<sid>/`.
  * The legacy top-level layout is read for back-compat (one minor
  * release) but is not authoritative.
@@ -133,7 +130,6 @@ export declare function getSessionIdCanonical(projectRoot: string): string | nul
  * Outcome of the caller-binding half of session resolution.
  *
  * `staleSessionId` is the id of a per-caller binding that was SKIPPED
- * because its session directory no longer exists — `null` for the
  * ordinary "no binding" case. It exists so the fall-through is
  * observable: a caller can tell "this caller has no binding" apart from
  * "this caller's binding pointed at a session tree that is gone", and
@@ -144,7 +140,6 @@ export type CallerBoundSession = {
     staleSessionId: string | null;
 };
 /**
- * Resolve the caller-binding primary source (slice 2026-09-12,
  * rid=caller-binding-staleness).
  *
  * The caller-first precedence is unchanged: this caller's binding still
@@ -162,19 +157,16 @@ export declare function resolveCallerBoundSession(projectRoot: string): CallerBo
  * Get the absolute path to the current session directory.
  * Creates the session if it doesn't exist.
  *
- * As of slice 2026-06-06-session-layout-canonicalize the canonical
  * home is `.peaks/_runtime/<sid>/`. The legacy top-level layout
  * `.peaks/_runtime/<sid>/` is the back-compat read fallback only.
  *
  * @param projectRoot - Root directory of the project
- * @returns Absolute path to session directory (e.g., "/path/to/project/.peaks/_runtime/2026-05-26-session-a3f8b1")
  */
 export declare function getCurrentSessionDir(projectRoot: string): Promise<string>;
 /**
  * List all session directories in the .peaks folder.
  * Returns session IDs (directory names) sorted by date.
  *
- * As of slice 2026-06-06-session-layout-canonicalize the canonical
  * home is `.peaks/_runtime/<sid>/`. The legacy top-level layout
  * `.peaks/_runtime/<sid>/` is read for back-compat (one minor release) so
  * pre-migration trees keep working.

package/dist/services/session/session-manager.js

@@ -15,7 +15,6 @@ import { SessionBindingSchema, SessionFileSchema } from './session-file-schema.j
 import { ensureSession } from './session-binding-bridge.js';
 import { getCallerBinding, getCallerBindingFile, resolveCallerBinding } from './caller-binding-service.js';
 import { resolveCallerProjection } from './resolve-caller-id.js';
-// As of slice 2026-06-05-peaks-runtime-layer the project-level session
 // binding lives under `.peaks/_runtime/session.json`. The legacy
 // `.peaks/.session.json` path is preserved as a read-only fallback for one
 // minor release so older CLI versions (or trees that have not been migrated
@@ -71,7 +70,6 @@ function resolveStoredAgainstCaller(stored, caller) {
 /**
  * Generate a new session ID.
  * Format: YYYY-MM-DD-session-<6位hex>
- * Example: 2026-05-26-session-a3f8b1
  */
 function generateSessionId() {
     const now = new Date();
@@ -96,7 +94,6 @@ function getSessionFilePath(projectRoot) {
  *
  * The `projectRoot` comparison is canonicalized (separator, symlink,
  * and — on Windows only — case) via `projectRootsMatch`. Before
- * slice `2026-08-04-rid-001-path-canonicalize` this was a strict
  * `===`, which returned null whenever the stored form differed
  * cosmetically from the caller-passed form. On Windows Git Bash that
  * is the common case: `peaks workspace init` stores
@@ -204,7 +201,6 @@ function writeSessionFile(projectRoot, info) {
  * `.peaks/.session.json` if present so a stale read from another
  * tool cannot re-bind the project after rotation. Also drops the
  * ROTATING caller's per-caller binding when it points at the rotated-out
- * session (slice 2026-09-12, rid=caller-binding-staleness) — see
  * `clearRotatedCallerBinding`.
  *
  * Returns the id of the session that was unbound, or `null` if
@@ -212,7 +208,6 @@ function writeSessionFile(projectRoot, info) {
  * with that — at minimum surface it in the CLI response so the
  * user can find the directory again if they need to.
  *
- * Slice 008 (F22 fix): the read uses the canonicalize-on-read
  * variant so a binding written with `projectRoot: "."` (relative
  * form, anchored from inside the project dir) is still found when
  * the caller passes the absolute realpath. Pre-F22 the
@@ -238,7 +233,6 @@ export function rotateSessionBinding(projectRoot) {
             // best-effort: a stale legacy binding is not blocking
         }
     }
-    // Slice 2026-09-12 (rid=caller-binding-staleness): the per-caller
     // binding is the FIRST thing `getSessionId` reads, so unlinking only
     // the project-global files left the rotating caller still resolving
     // the session it just rotated out of — `peaks job init` re-created
@@ -303,7 +297,6 @@ export function setCurrentSessionBinding(projectRoot, sessionId) {
     return info;
 }
 function getMetaFilePath(projectRoot, sessionId) {
-    // As of slice 2026-06-06-session-layout-canonicalize, the per-session
     // `session.json` (the file written by `setSessionMeta`) lives at the
     // canonical runtime home `.peaks/_runtime/<sid>/session.json`, NOT
     // at the top-level `.peaks/_runtime/<sid>/session.json` (which would imply
@@ -327,7 +320,6 @@ function readSessionMeta(projectRoot, sessionId) {
 }
 function writeSessionMeta(projectRoot, sessionId, meta) {
     const metaPath = getMetaFilePath(projectRoot, sessionId);
-    // As of slice 003, the meta file lives at `.peaks/_runtime/<sid>/session.json`.
     // The parent dir of that file is the canonical runtime session dir.
     const metaDir = dirname(metaPath);
     if (!existsSync(metaDir)) {
@@ -371,7 +363,6 @@ export function setSessionTitle(projectRoot, sessionId, title) {
  * List all session directories under .peaks with their metadata.
  * Returns sessions sorted by sessionId descending (most recent first).
  *
- * As of slice 2026-06-06-session-layout-canonicalize the session
  * dirs live at the canonical runtime home `.peaks/_runtime/<sid>/`.
  * The legacy top-level layout is read for back-compat (one minor
  * release) but is not authoritative.
@@ -413,7 +404,6 @@ export function listSessionMetas(projectRoot) {
 }
 /**
  * Back-compat read for the legacy top-level meta file (the one that
- * pre-slice 003 trees still have at `.peaks/_runtime/<sid>/session.json`).
  * Kept as a separate helper so the canonical reader is the default.
  */
 function readSessionMetaCompat(peaksRoot, sessionId) {
@@ -444,11 +434,9 @@ export { ensureSession, ensureSessionWithRotation } from './session-binding-brid
  * @returns Session ID or null
  */
 export function getSessionId(projectRoot) {
-    // Slice 2026-08-06-session-cacde8-A.5a: caller-binding becomes
     // primary source. Read order is (1) the per-caller binding if
     // `resolveCallerProjection` succeeds — and only when that binding is
     // still usable (`resolveCallerBoundSession` drops one whose session
-    // directory is gone, slice 2026-09-12 rid=caller-binding-staleness),
     // (2) `readSessionFile` (the legacy session.json), (3) null (no
     // binding). The legacy session.json is preserved as a fallback so a
     // project without a caller-id resolution still resolves its binding
@@ -489,7 +477,6 @@ export function getSessionId(projectRoot) {
  * so this variant is opt-in.
  */
 export function getSessionIdCanonical(projectRoot) {
-    // Slice 2026-08-06-session-cacde8-A.5a: same caller-binding primary
     // lookup as `getSessionId`; fall back to the canonical-fallback
     // `readSessionFileCanonical` if caller-binding is absent / unresolved.
     const { sessionId } = resolveCallerBoundSession(projectRoot);
@@ -499,7 +486,6 @@ export function getSessionIdCanonical(projectRoot) {
     return info?.sessionId ?? null;
 }
 /**
- * Resolve the caller-binding primary source (slice 2026-09-12,
  * rid=caller-binding-staleness).
  *
  * The caller-first precedence is unchanged: this caller's binding still
@@ -533,12 +519,10 @@ export function resolveCallerBoundSession(projectRoot) {
  * Get the absolute path to the current session directory.
  * Creates the session if it doesn't exist.
  *
- * As of slice 2026-06-06-session-layout-canonicalize the canonical
  * home is `.peaks/_runtime/<sid>/`. The legacy top-level layout
  * `.peaks/_runtime/<sid>/` is the back-compat read fallback only.
  *
  * @param projectRoot - Root directory of the project
- * @returns Absolute path to session directory (e.g., "/path/to/project/.peaks/_runtime/2026-05-26-session-a3f8b1")
  */
 export async function getCurrentSessionDir(projectRoot) {
     const sessionId = await ensureSession(projectRoot);
@@ -548,7 +532,6 @@ export async function getCurrentSessionDir(projectRoot) {
  * List all session directories in the .peaks folder.
  * Returns session IDs (directory names) sorted by date.
  *
- * As of slice 2026-06-06-session-layout-canonicalize the canonical
  * home is `.peaks/_runtime/<sid>/`. The legacy top-level layout
  * `.peaks/_runtime/<sid>/` is read for back-compat (one minor release) so
  * pre-migration trees keep working.
@@ -597,7 +580,6 @@ export function listSessions(projectRoot) {
  */
 export async function getProjectScanPath(projectRoot) {
     const sessionId = await ensureSession(projectRoot);
-    // As of slice 2026-06-05-change-id-as-unit-of-work the session dir
     // is at the canonical runtime location (gitignored). The scan is a
     // session-local artifact; it lives alongside the rest of the
     // ephemeral state under `_runtime/`. The parent `rd/` subdir is
@@ -617,7 +599,6 @@ export function hasProjectScan(projectRoot) {
     const info = readSessionFile(projectRoot);
     if (!info)
         return false;
-    // Canonical runtime location of the session dir (slice 2026-06-05).
     const scanPath = join(projectRoot, '.peaks', '_runtime', info.sessionId, 'rd', 'project-scan.md');
     return existsSync(scanPath);
 }

package/dist/services/session/session-resume-service.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/services/session/session-resume-service.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/services/share/bundle-reader.d.ts

@@ -1,7 +1,6 @@
 /**
  * bundle-reader.ts — readBundle(inPath) (spec §7A.2).
  *
- * M7 / spec §7A.2 / §10 RL-9 / acceptance AC-25 / AC-26.
  *
  * Reads a `peaks.bundle/1` tar.gz and lands the contained release
  * on the local SkillHub. The reader is the symmetrical counterpart
@@ -18,7 +17,6 @@
  *   3. The imported release ALWAYS lands as `candidate`. The
  *      reader refuses to write any other status; the receiver
  *      MUST run an independent evaluation before promoting the
- *      imported release to `stable` (AC-26 — peaks loop promote
  *      reads evolution_evaluation rows).
  *
  * Slice 4 (PRD-002b): split the four high-cohort functions
@@ -28,7 +26,7 @@
  * (readBundle, ReadBundleArgs, ReadBundleResult, the four error
  * classes) is preserved verbatim.
  */
-import type Database from 'better-sqlite3';
+import { type SqliteDatabase } from '../sqlite/sqlite-driver.js';
 import { SHARE_BUNDLE_ERROR_CODES, type PeaksBundleKind } from './bundle-types.js';
 /**
  * Thrown when `format_version_major !== 1`. This is the explicit
@@ -66,7 +64,7 @@ export declare class BundleMalformedError extends Error {
     constructor(message: string);
 }
 export type ReadBundleArgs = {
-    db: Database.Database;
+    db: SqliteDatabase;
     /** Blobs root for content-addressed file write-back. */
     blobsDir: string;
     /** Input `.tar.gz` bundle path. */
@@ -81,7 +79,6 @@ export type ReadBundleArgs = {
 /**
  * Successful read result. The reader lands the bundle as a
  * `candidate` regardless of any other lifecycle status on the
- * source — this is the hard import rule per spec §7A.2 / AC-25.
  */
 export type ReadBundleResult = {
     /** Anchor asset id actually written. */