peaks-loop 4.0.11 → 4.0.12

package/dist/services/doctor/doctor-service/types.d.ts

@@ -55,6 +55,15 @@ export type WorkspaceLayoutInspection = {
      * to an empty array when the field is missing.
      */
     perChangeIdDirs?: string[];
+    /**
+     * Slice 4.0.11 statusline-sid-scoped-lease C — single-slot
+     * presence files that are stale after the sid-scoped lease
+     * projection shipped in 4.0.8. Reported separately from
+     * `legacyDotfiles` so the doctor message names the specific
+     * "stale single-slot presence" condition. Optional for back-compat
+     * with probes injected by older tests.
+     */
+    staleSingleSlotFiles?: string[];
 };
 export type WorkspaceLayoutProbe = () => WorkspaceLayoutInspection;
 /**

package/dist/services/hooks/presence-marker-detector.d.ts

@@ -13,10 +13,12 @@ export declare const PRESENCE_MARKER_WARNING: readonly ["Peaks skill context may
 /**
  * Pure read-only presence-marker detection. No I/O side effects.
  *
- * Slice 4.0.8: the canonical 4.0.7 behavior is preserved (read legacy
- * `active-skill.json` or `.peaks/.active-skill.json`, project the
- * `Peaks-Loop Skill:` marker). The new diagnostic for a broken
- * canonical graph is surfaced via the `warning` field, NOT swallowed,
- * so the statusline / hook / doctor consumers can render it.
+ * Slice 4.0.11 statusline-sid-scoped-lease C: the deprecated
+ * `.peaks/_runtime/active-skill.json` (and legacy
+ * `.peaks/.active-skill.json`) read paths are removed. The
+ * canonical sid-scoped lease projection at
+ * `.peaks/_runtime/<sid>/leases/presence-*.json` is the only source.
+ * The `warning` field is preserved for downstream consumers
+ * (statusline, doctor, hooks).
  */
 export declare function detectPresenceMarker(input: DetectPresenceMarkerInput): DetectPresenceMarkerResult;

package/dist/services/hooks/presence-marker-detector.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { getSessionId } from '../session/session-manager.js';
+import { listPresenceLeases } from '../skills/presence-lease-service.js';
 /**
  * Slice 028 (Q1=A): hook-based skill-presence marker detection.
  *
@@ -17,7 +17,7 @@ import { resolve } from 'node:path';
  * `detectPresenceMarker({ project, latestAssistantMessage })`
  * and gets back:
  *
- *   - `active`:      whether an active-skill marker was found on disk.
+ *   - `active`:      whether an active lease was found on disk.
  *   - `skill?`:      the active skill name, if any.
  *   - `markerFound`: whether the latest assistant message carries the
  *                    expected `Peaks-Loop Skill:` / `Peaks-Loop Gate:`
@@ -30,94 +30,52 @@ import { resolve } from 'node:path';
  * expected to provide the absolute project root (peaks-loop convention
  * from the standards-commands family — see dev-preference rule
  * `project-option-is-canonical-project-root-source`).
+ *
+ * Slice 4.0.11 statusline-sid-scoped-lease C: the deprecated
+ * project-level `active-skill.json` single-slot file is REMOVED
+ * from this module. The canonical sid-scoped lease projection
+ * (`.peaks/_runtime/<sid>/leases/presence-*.json`) is the only
+ * source of truth; no legacy fallback is retained.
  */
-const PRESENCE_CANONICAL_PATH = '.peaks/_runtime/active-skill.json';
-const PRESENCE_LEGACY_PATH = '.peaks/.active-skill.json';
 const MARKER_PRIMARY = 'Peaks-Loop Skill:';
 const MARKER_SECONDARY = 'Peaks-Loop Gate:';
-const SKILL_NAME_RE = /"skill"\s*:\s*"([^"\\]*(?:\\.[^"\\]*)*)"/;
 export const PRESENCE_MARKER_WARNING = [
     'Peaks skill context may have been lost from this conversation; please re-invoke /peaks-<skill>.'
 ];
-function readPresenceFile(absolutePath) {
-    if (!existsSync(absolutePath))
-        return null;
-    let raw;
-    try {
-        raw = readFileSync(absolutePath, 'utf8');
-    }
-    catch (err) { // TODO(g2): legacy silent catch — now narrows to IO errors only (grace: 1 minor release, v2.14.0)
-        if (err instanceof ReferenceError)
-            throw err; // surface module-load bugs
-        if (err instanceof SyntaxError)
-            throw err; // surface parse bugs
-        return null; // only swallow IO errors
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (err) { // TODO(g2): legacy silent catch — now narrows to IO errors only (grace: 1 minor release, v2.14.0)
-        if (err instanceof ReferenceError)
-            throw err; // surface module-load bugs
-        if (err instanceof SyntaxError)
-            throw err; // surface parse bugs
-        return null; // only swallow IO errors
-    }
-    if (parsed === null || typeof parsed !== 'object')
+/**
+ * Slice 4.0.11 statusline-sid-scoped-lease C: read the canonical
+ * sid-scoped lease projection. Returns the in-flight lease with the
+ * most recent `lastHeartbeat`, or null when no leases exist for the
+ * bound session. Picked the most-recent-in-flight lease (mirrors the
+ * statusline `callerId === null` back-compat path).
+ */
+function readCanonicalLease(projectRoot) {
+    const sessionId = getSessionId(projectRoot);
+    if (sessionId === null)
         return null;
-    const skillMatch = SKILL_NAME_RE.exec(JSON.stringify(parsed));
-    if (skillMatch === null)
+    const leases = listPresenceLeases(projectRoot, sessionId);
+    const inFlight = leases.filter((l) => l.status === 'running' || l.status === 'preparing');
+    if (inFlight.length === 0)
         return null;
-    if (typeof skillMatch[1] !== 'string' || skillMatch[1].length === 0)
+    // Sort by lastHeartbeat desc, return the freshest.
+    inFlight.sort((a, b) => b.lastHeartbeat.localeCompare(a.lastHeartbeat));
+    const freshest = inFlight[0];
+    if (freshest === undefined)
         return null;
-    return { skill: skillMatch[1] };
+    return { skill: freshest.skill };
 }
 /**
- * Slice 4.0.8: surface a typed `PEAKS_GRAPH_REF_BROKEN` warning
- * when the canonical presence lease / index points at a missing or
- * corrupt graph. The legacy `active-skill.json` walk never
- * inspected graphRef; in 4.0.8 we surface the broken graph in the
- * `warnings` array so downstream consumers (statusline, doctor,
- * hooks) can render the diagnostic instead of silently rendering
- * "active" for a half-wired presence.
+ * Slice 4.0.11 statusline-sid-scoped-lease C: the deprecated
+ * broken-graph diagnostic walked the legacy `active-skill.json`
+ * `graphRef` field. The canonical lease projection surfaces broken
+ * graphs as a typed `PEAKS_GRAPH_REF_BROKEN` lease status at read
+ * time (see `presence-lease-service.readJsonStrict`), so a separate
+ * diagnostic walk is no longer needed. Kept as a no-op for the
+ * public-surface stability of `detectPresenceMarker` (the warning
+ * field shape stays the same); returns null unless the canonical
+ * graph lookup is wired in a future slice.
  */
-function tryDetectBrokenGraph(projectRoot) {
-    try {
-        const presenceIndexDir = resolve(projectRoot, '.peaks', '_runtime');
-        if (!existsSync(presenceIndexDir))
-            return null;
-        // Best-effort: walk a single directory level for the legacy
-        // `active-skill.json` indicator. A broken graphRef would be
-        // surfaced by the canonical lease service (PEAKS_GRAPH_REF_BROKEN
-        // is the typed error), but the marker detector is a *read* —
-        // we don't import the lease service here. The diagnostic is
-        // best-effort: we report the index file's `graphRef` field
-        // when it names a missing file.
-        const legacyPath = resolve(projectRoot, '.peaks', '_runtime', 'active-skill.json');
-        if (!existsSync(legacyPath))
-            return null;
-        const raw = readFileSync(legacyPath, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (typeof parsed.graphRef !== 'string')
-            return null;
-        const graphPath = resolve(projectRoot, '.peaks', '_runtime', parsed.graphRef);
-        if (!existsSync(graphPath))
-            return 'PEAKS_GRAPH_REF_BROKEN';
-    }
-    catch { /* swallow — diagnostic only */ }
-    return null;
-}
-function readPresenceBackCompat(project) {
-    const projectRoot = resolve(project);
-    const canonicalPath = resolve(projectRoot, PRESENCE_CANONICAL_PATH);
-    const legacyPath = resolve(projectRoot, PRESENCE_LEGACY_PATH);
-    for (const candidate of [canonicalPath, legacyPath]) {
-        const parsed = readPresenceFile(candidate);
-        if (parsed === null)
-            continue;
-        return { skill: parsed.skill, path: candidate };
-    }
+function tryDetectBrokenGraph(_projectRoot) {
     return null;
 }
 function messageHasMarker(message) {
@@ -128,16 +86,18 @@ function messageHasMarker(message) {
 /**
  * Pure read-only presence-marker detection. No I/O side effects.
  *
- * Slice 4.0.8: the canonical 4.0.7 behavior is preserved (read legacy
- * `active-skill.json` or `.peaks/.active-skill.json`, project the
- * `Peaks-Loop Skill:` marker). The new diagnostic for a broken
- * canonical graph is surfaced via the `warning` field, NOT swallowed,
- * so the statusline / hook / doctor consumers can render it.
+ * Slice 4.0.11 statusline-sid-scoped-lease C: the deprecated
+ * `.peaks/_runtime/active-skill.json` (and legacy
+ * `.peaks/.active-skill.json`) read paths are removed. The
+ * canonical sid-scoped lease projection at
+ * `.peaks/_runtime/<sid>/leases/presence-*.json` is the only source.
+ * The `warning` field is preserved for downstream consumers
+ * (statusline, doctor, hooks).
  */
 export function detectPresenceMarker(input) {
     const project = input.project;
     const message = input.latestAssistantMessage ?? '';
-    const presence = readPresenceBackCompat(project);
+    const presence = readCanonicalLease(project);
     if (presence === null) {
         return { active: false, markerFound: false };
     }

package/dist/services/migration/v2-10-to-v2-11-service.js

@@ -42,9 +42,7 @@ const SKIP_DIRS = new Set([
     'caller',
     'callers',
     'sop-state',
-    'system',
-    'active-skill.json',
-    '.active-skill.json'
+    'system'
 ]);
 const SESSION_DIR_RE = /^\d{4}-\d{2}-\d{2}-session-/;
 const TECH_DOC_MARKERS = ['## Architecture', '## Component', '## API', '## Dependencies'];

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

@@ -53,10 +53,10 @@ export type CommitBoundary = {
 };
 /**
  * Resolution sources for `resolveArtifactSession`, in priority order.
- * - `active-skill`: the orchestrator's active-skill marker
- *   (`.peaks/_runtime/active-skill.json`, with a one-minor-release
- *   fallback to `.peaks/.active-skill.json`) `sessionId` points to a
- *   session dir that owns the slice's marker artifact.
+ * - `active-skill`: the canonical sid-scoped lease projection
+ *   (`.peaks/_runtime/<sid>/leases/presence-*.json`) for the bound
+ *   session id. When at least one in-flight lease exists under the
+ *   session dir, that session owns the slice's marker artifact.
  * - `session-json`: the workspace binding in
  *   `.peaks/_runtime/session.json` (with back-compat fallback to
  *   `.peaks/.session.json`) points to a session dir that owns the
@@ -74,9 +74,13 @@ export type ResolvedArtifactSession = {
  * Resolve the session id that owns the slice's artifacts using a 3-tier
  * precedence:
  *
- *   1. `.peaks/_runtime/active-skill.json` `sessionId` (with back-compat
- *      fallback to `.peaks/.active-skill.json`) if it points to a real
- *      session that owns the slice.
+ *   1. The canonical sid-scoped lease projection under the bound
+ *      session id (workspace binding + at least one in-flight lease
+ *      in `.peaks/_runtime/<sid>/leases/`). Slice 4.0.11 statusline-
+ *      sid-scoped-lease C collapsed the previous
+ *      `.peaks/_runtime/active-skill.json` reader into this tier —
+ *      the session id is now read from the canonical workspace
+ *      binding (was tier 2), gated on a live lease.
  *   2. `.peaks/_runtime/session.json` `sessionId` (with back-compat
  *      fallback to `.peaks/.session.json`) if it points to a real
  *      session that owns the slice.

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

@@ -5,6 +5,7 @@ import { isInsidePath } from '../../shared/path-utils.js';
 import { getWorkspaceConfigForPath } from '../config/config-service.js';
 import { getArtifactRemoteRepo, getArtifactWorkspaceStatus, getLocalArtifactPath } from '../artifacts/workspace-service.js';
 import { getSessionId } from '../session/session-manager.js';
+import { listPresenceLeases } from '../skills/presence-lease-service.js';
 const REQUIRED_ARTIFACTS = [
     { name: 'retention-boundary.md', path: ['sc', 'retention-boundary.md'] },
     { name: 'change-impact.json', path: ['sc', 'change-impact.json'] },
@@ -120,33 +121,31 @@ function isRetainedArtifactFile(filePath, artifactWorkspacePath, changesRoot, ch
     }
 }
 /**
- * Read the orchestrator's active-skill marker and return its
- * `sessionId`, or null when the file is missing / malformed.
+ * Resolve the canonical sid-scoped lease session id (replaces the
+ * removed `.peaks/_runtime/active-skill.json` single-slot marker
+ * reader). Reads the workspace session binding
+ * (`.peaks/_runtime/session.json`, with back-compat fallback to
+ * `.peaks/.session.json`) and returns its `sessionId` when at least
+ * one in-flight canonical lease exists under
+ * `.peaks/_runtime/<sid>/leases/`.
  *
- * As of slice 2026-06-05-peaks-runtime-layer the canonical home is
- * `<projectRoot>/.peaks/_runtime/active-skill.json`. The legacy
- * `<projectRoot>/.peaks/.active-skill.json` is consulted as a
- * one-minor-release back-compat fallback: if the new path is
- * absent but the legacy path is present and valid, we use the
- * legacy value. The new path always wins when both exist.
+ * Slice 4.0.11 statusline-sid-scoped-lease C: the project-level
+ * `active-skill.json` is removed; the canonical sid-scoped lease
+ * projection (`.peaks/_runtime/<sid>/leases/presence-*.json`) is the
+ * authoritative source. The session-id is now read from the
+ * workspace binding (which was already tier 2 in the old resolver),
+ * gated on the existence of an in-flight lease so a stale binding
+ * with no live presence does not produce a false `active-skill`
+ * tier hit. Returns null when the session binding is missing /
+ * malformed, or when no in-flight lease exists.
  */
 function readActiveSkillSessionId(projectRoot) {
-    const newPath = join(projectRoot, '.peaks', '_runtime', 'active-skill.json');
-    const legacyPath = join(projectRoot, '.peaks', '.active-skill.json');
-    const pathToRead = existsSync(newPath) ? newPath : legacyPath;
-    if (!existsSync(pathToRead))
-        return null;
-    try {
-        const raw = readFileSync(pathToRead, 'utf8');
-        const parsed = JSON.parse(raw);
-        if (typeof parsed?.sessionId === 'string' && parsed.sessionId.length > 0) {
-            return parsed.sessionId;
-        }
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+    const sessionId = readSessionJsonBinding(projectRoot);
+    if (sessionId === null)
         return null;
-    }
-    return null;
+    const leases = listPresenceLeases(projectRoot, sessionId);
+    const hasInFlight = leases.some((l) => l.status === 'running' || l.status === 'preparing');
+    return hasInFlight ? sessionId : null;
 }
 /**
  * Read the workspace session binding and return its `sessionId`,
@@ -284,9 +283,13 @@ function readdirSyncSafe(dir) {
  * Resolve the session id that owns the slice's artifacts using a 3-tier
  * precedence:
  *
- *   1. `.peaks/_runtime/active-skill.json` `sessionId` (with back-compat
- *      fallback to `.peaks/.active-skill.json`) if it points to a real
- *      session that owns the slice.
+ *   1. The canonical sid-scoped lease projection under the bound
+ *      session id (workspace binding + at least one in-flight lease
+ *      in `.peaks/_runtime/<sid>/leases/`). Slice 4.0.11 statusline-
+ *      sid-scoped-lease C collapsed the previous
+ *      `.peaks/_runtime/active-skill.json` reader into this tier —
+ *      the session id is now read from the canonical workspace
+ *      binding (was tier 2), gated on a live lease.
  *   2. `.peaks/_runtime/session.json` `sessionId` (with back-compat
  *      fallback to `.peaks/.session.json`) if it points to a real
  *      session that owns the slice.

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

@@ -24,14 +24,14 @@ export declare const InstanceRecordSchema: z.ZodObject<{
     callerId: z.ZodString;
     lastHeartbeat: z.ZodString;
 }, "strip", z.ZodTypeAny, {
+    lastHeartbeat: string;
     startedAt: string;
     roles: string[];
     callerId: string;
-    lastHeartbeat: string;
 }, {
+    lastHeartbeat: string;
     startedAt: string;
     callerId: string;
-    lastHeartbeat: string;
     roles?: string[] | undefined;
 }>;
 export declare const BindingSchema: z.ZodObject<{
@@ -45,14 +45,14 @@ export declare const BindingSchema: z.ZodObject<{
         callerId: z.ZodString;
         lastHeartbeat: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        lastHeartbeat: string;
         startedAt: string;
         roles: string[];
         callerId: string;
-        lastHeartbeat: string;
     }, {
+        lastHeartbeat: string;
         startedAt: string;
         callerId: string;
-        lastHeartbeat: string;
         roles?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -61,10 +61,10 @@ export declare const BindingSchema: z.ZodObject<{
     pid: number;
     scope: string;
     instances: Record<string, {
+        lastHeartbeat: string;
         startedAt: string;
         roles: string[];
         callerId: string;
-        lastHeartbeat: string;
     }>;
 }, {
     lastHeartbeat: string;
@@ -72,9 +72,9 @@ export declare const BindingSchema: z.ZodObject<{
     pid: number;
     scope: string;
     instances: Record<string, {
+        lastHeartbeat: string;
         startedAt: string;
         callerId: string;
-        lastHeartbeat: string;
         roles?: string[] | undefined;
     }>;
 }>;

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

@@ -67,7 +67,7 @@ export type HookInstallOptions = {
 /** Sentinel substring identifying a Claude-Code gate-enforce hook entry. */
 export declare const HOOK_ENFORCE_SENTINEL = "peaks gate enforce";
 /** Default (claude-code) hook command — kept as a stable export for tests. */
-export declare const HOOK_ENFORCE_COMMAND = "peaks gate enforce --project \"${CLAUDE_PROJECT_DIR}\"";
+export declare const HOOK_ENFORCE_COMMAND = "peaks gate enforce --project \"${CLAUDE_PROJECT_DIR}\" --json";
 export type HookInstallPlan = {
     scope: HookScope;
     settingsPath: string;

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

@@ -11,7 +11,7 @@ import { getAdapter } from '../ide/ide-registry.js';
 /** Sentinel substring identifying a Claude-Code gate-enforce hook entry. */
 export const HOOK_ENFORCE_SENTINEL = 'peaks gate enforce';
 /** Default (claude-code) hook command — kept as a stable export for tests. */
-export const HOOK_ENFORCE_COMMAND = `peaks gate enforce --project "\${CLAUDE_PROJECT_DIR}"`;
+export const HOOK_ENFORCE_COMMAND = `peaks gate enforce --project "\${CLAUDE_PROJECT_DIR}" --json`;
 /**
  * Per-IDE hook command + sentinel. The default (Claude Code) uses the
  * legacy `peaks gate enforce` surface; Trae / Cursor / Codex (Cursor-style

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

@@ -54,7 +54,6 @@ export type SkillPresence = {
  * fallback (slice 2026-06-26-unknown-sid-fallback-fix).
  */
 export declare function getCurrentSessionId(projectRootOverride?: string): string | null;
-export declare function exportSkillPresence(projectRootOverride?: string): string;
 /**
  * Write the per-caller active-skill marker to
  * `.peaks/_runtime/<peakSid>/active-skill-<callerId>.json` (D6). Returns