peaks-loop 3.1.2 → 4.0.0-beta.10

package/dist/src/services/solo/mode-gate.d.ts

@@ -1,163 +0,0 @@
-/**
- * v2.11.0 Group F (Tier 9) — D5: full-auto self-decision gate.
- *
- * Single source of truth for "should this code path auto-proceed or
- * pause for an AskUserQuestion round-trip?" The D5 design (per
- * `.peaks/memory/2026-06-26-v2-11-full-auto-self-decision.md`) requires:
- *
- *   - `full-auto` and `swarm` modes → auto-proceed (recommended = chosen)
- *   - `assisted` and `strict` modes → pause for confirmation
- *   - 3 hard-floor categories ALWAYS ask, regardless of mode:
- *     1. Irreversible external side effects (git push, npm publish, …)
- *     2. Authentication / credential usage
- *     3. Multi-day investment decisions (release tag, breaking change)
- *
- * Karpathy §2: no inline `mode === 'full-auto'` checks scattered across
- * files — this module is the only place. Karpathy §3: this file is
- * surgical to the D5 design; do not extend with unrelated mode helpers.
- *
- * Re-uses `SkillPresenceMode` from `skill-presence-service.ts` so the
- * 4 mode values stay in lockstep with the rest of the runtime.
- */
-import type { SkillPresenceMode } from '../skills/skill-presence-service.js';
-export type SoloMode = SkillPresenceMode;
-export declare const SOLO_MODES: readonly SoloMode[];
-export type HardFloorCategory = 'irreversible-external-side-effect' | 'authentication-credential' | 'multi-day-investment'
-/**
- * v2.15.0 slice 002 AC-4: actions that are past the user's
- * explicit full-auto boundary = commit only. Per user-given rule
- * from `.peaks/memory/2026-06-28-full-auto-boundary.md`: full-auto
- * ends at commit. push / tag / npm publish / global install are
- * commit-BOUNDARY side effects — they extend the commit to an
- * external system, and full-auto must NOT auto-perform them even
- * if every other mode says yes. Always pauses.
- */
- | 'commit-boundary-side-effect';
-export declare const HARD_FLOOR_CATEGORIES: readonly HardFloorCategory[];
-/**
- * The 14 SKILL.md AskUserQuestion sites mapped in the D5 memory's
- * "Inventory of unconditional confirmation gates" table. Each row
- * is the bare minimum needed to gate it through `shouldPauseAtGate`.
- */
-export type GatedStepId = 'step-0.5-openspec-opt-in' | 'step-0.6-audit-goal' | 'step-0.7-resume-detection' | 'step-0.55-1x-upgrade' | 'step-1-mode-select' | 'step-2.5-session-title' | 'phase-2-prd-confirm' | 'phase-3-swarm-gate-b' | 'phase-6-qa-gate-d' | 'phase-10-txt-memory-extract' | 'step-n+1-final-review' | 'frontend-only-mismatch' | 'step-0.75-checkpoint-resume' | 'standards-preflight';
-export declare const GATED_STEPS: readonly GatedStepId[];
-/**
- * Slice 2026-06-28-solo-mode-bypass-fix: the kind of gate that
- * produced this decision. The LLM-side caller (peaks-solo body) reads
- * this to distinguish "you paused because the user must choose the
- * mode" (`mode-selection-itself`) from "you paused because the mode
- * you already chose is assisted/strict" (`mode-driven`) from "you
- * paused because a hard-floor category always wins" (`hard-floor`).
- *
- *   - `'mode-selection-itself'` — the gate IS the mode/context
- *     selection step itself (step-1-mode-select,
- *     step-0.5-openspec-opt-in, step-0.7-resume-detection). Even
- *     `full-auto` mode pauses here; otherwise the user's first turn
- *     would auto-lock the mode without their consent.
- *   - `'mode-driven'`           — the gate paused because the active
- *     mode is assisted/strict (the existing default).
- *   - `'hard-floor'`            — the gate paused because a
- *     hard-floor category always wins (irreversible external side
- *     effect / auth / multi-day investment).
- */
-export type GateKind = 'mode-selection-itself' | 'mode-driven' | 'hard-floor';
-export interface GateDecision {
-    readonly shouldPause: boolean;
-    /** Human-readable rationale; surfaces in `peaks solo should-pause --json` */
-    readonly reason: string;
-    /** Hard-floor override applied? Surfaces in audit log when true */
-    readonly hardFloorCategory?: HardFloorCategory;
-    /** Slice 2026-06-28-solo-mode-bypass-fix: kind of gate that produced
-     * this decision. Always present; defaults to `'mode-driven'` for the
-     * assisted/strict pause branch. */
-    readonly gateKind: GateKind;
-}
-export declare function isSoloMode(value: string): value is SoloMode;
-export declare function isHardFloorCategory(value: string): value is HardFloorCategory;
-/**
- * `true` when the current mode should auto-proceed (skip the
- * AskUserQuestion round-trip). Mirrors D5.a: "recommended = chosen
- * in full-auto / swarm; always log, never silently skip".
- */
-export declare function shouldAutoProceed(mode: SoloMode): boolean;
-/**
- * Should the LLM emit an AskUserQuestion at `step` given `mode`?
- * Pure function: no IO, no LLM call. The LLM-side caller passes the
- * mode it loaded from skill presence, and the step it is about to
- * execute; this function returns a `GateDecision` with the rationale.
- *
- * The hard-floor categories always win — even full-auto pauses for
- * irreversible external side effects, auth/credential usage,
- * multi-day investment decisions (D5.b), and commit-boundary side
- * effects (v2.15.0 slice 002 AC-4: push, tag, publish, global install).
- *
- * `hardFloorCategory` is optional on the `GateDecision` so callers can
- * stamp the override into the auto-decisions log without a second
- * switch.
- */
-/**
- * v2.15.0 slice 002 AC-4: the 5 action identifiers that qualify as
- * commit-boundary side effects. Matched by the LLM-side caller
- * (peaks-solo body / peaks-rd fork agent) when it is about to run a
- * Bash command that maps to one of these. Set `commitBoundaryAction:
- * true` on the `shouldPauseAtGate` call to trigger the hard-floor
- * override.
- */
-export type CommitBoundaryActionId = 'git-push' | 'git-tag' | 'npm-publish' | 'npm-install-global' | 'peaks-global-install';
-export declare const COMMIT_BOUNDARY_ACTIONS: readonly CommitBoundaryActionId[];
-export declare function isCommitBoundaryAction(value: string): value is CommitBoundaryActionId;
-export declare function shouldPauseAtGate(opts: {
-    mode: SoloMode;
-    step: GatedStepId;
-    hardFloorCategory?: HardFloorCategory | undefined;
-    /**
-     * v2.15.0 slice 002 AC-4: when `true`, force a pause regardless of
-     * mode. Reserved for the 5 commit-boundary side effects
-     * (push/tag/publish/global install) that are past the user's
-     * full-auto boundary. The hard-floor override ALWAYS wins — even
-     * over the mode-driven auto-proceed branch.
-     */
-    commitBoundaryAction?: boolean | undefined;
-}): GateDecision;
-/**
- * Format a one-line audit message for the auto-decisions log.
- * Karpathy §3: this is a pure formatter; it does NOT touch the file
- * system. The CLI / LLM is responsible for appending.
- */
-export declare function formatAutoProceedLogLine(opts: {
-    mode: SoloMode;
-    step: GatedStepId;
-    recommendedOption: string;
-    hardFloorCategory?: HardFloorCategory | undefined;
-}): string;
-/**
- * v2.15.0 slice 002 AC-4: regex matchers the LLM-side caller uses
- * to flag a Bash command as a commit-boundary action. Centralised
- * here so the test seam + the CLI wiring share one source of
- * truth. Each entry is an anchored pattern matched against the
- * user-invoked command (after commander / shell normalisation,
- * before execution).
- *
- * Patterns intentionally cover the common canonical forms:
- *
- *   - `git-push`            → `git push`, `git push origin main`, `git push --tags`
- *   - `git-tag`             → `git tag v2.15.0`, `git tag -a v2.15.0 -m ...`
- *   - `npm-publish`         → `npm publish`, `npm publish --access public`
- *   - `npm-install-global`  → `npm install -g <pkg>`, `npm i -g <pkg>`
- *   - `peaks-global-install`→ `npm install -g peaks-loop`, `pnpm add -g peaks-loop`
- *
- * These are coarse — false positives are fine (worst case: a
- * non-actionable command gets paused for confirmation; the user
- * can confirm in one click). False negatives are NOT fine — a
- * missed publish would violate the full-auto boundary.
- */
-export declare const COMMIT_BOUNDARY_PATTERNS: Readonly<Record<CommitBoundaryActionId, RegExp>>;
-/**
- * v2.15.0 slice 002 AC-4: detect whether a Bash command matches any
- * commit-boundary action pattern. Returns the action id of the
- * first match, or `null` when none match. The CLI / LLM caller
- * passes the command through this function and forwards the
- * result to `shouldPauseAtGate({ commitBoundaryAction: true })` to
- * force the hard-floor pause.
- */
-export declare function detectCommitBoundaryAction(command: string): CommitBoundaryActionId | null;

package/dist/src/services/solo/mode-gate.js

@@ -1,212 +0,0 @@
-/**
- * v2.11.0 Group F (Tier 9) — D5: full-auto self-decision gate.
- *
- * Single source of truth for "should this code path auto-proceed or
- * pause for an AskUserQuestion round-trip?" The D5 design (per
- * `.peaks/memory/2026-06-26-v2-11-full-auto-self-decision.md`) requires:
- *
- *   - `full-auto` and `swarm` modes → auto-proceed (recommended = chosen)
- *   - `assisted` and `strict` modes → pause for confirmation
- *   - 3 hard-floor categories ALWAYS ask, regardless of mode:
- *     1. Irreversible external side effects (git push, npm publish, …)
- *     2. Authentication / credential usage
- *     3. Multi-day investment decisions (release tag, breaking change)
- *
- * Karpathy §2: no inline `mode === 'full-auto'` checks scattered across
- * files — this module is the only place. Karpathy §3: this file is
- * surgical to the D5 design; do not extend with unrelated mode helpers.
- *
- * Re-uses `SkillPresenceMode` from `skill-presence-service.ts` so the
- * 4 mode values stay in lockstep with the rest of the runtime.
- */
-export const SOLO_MODES = [
-    'full-auto',
-    'assisted',
-    'swarm',
-    'strict'
-];
-export const HARD_FLOOR_CATEGORIES = [
-    'irreversible-external-side-effect',
-    'authentication-credential',
-    'multi-day-investment',
-    'commit-boundary-side-effect'
-];
-export const GATED_STEPS = [
-    'step-0.5-openspec-opt-in',
-    'step-0.6-audit-goal',
-    'step-0.7-resume-detection',
-    'step-0.55-1x-upgrade',
-    'step-1-mode-select',
-    'step-2.5-session-title',
-    'phase-2-prd-confirm',
-    'phase-3-swarm-gate-b',
-    'phase-6-qa-gate-d',
-    'phase-10-txt-memory-extract',
-    'step-n+1-final-review',
-    'frontend-only-mismatch',
-    'step-0.75-checkpoint-resume',
-    'standards-preflight'
-];
-export function isSoloMode(value) {
-    return SOLO_MODES.includes(value);
-}
-export function isHardFloorCategory(value) {
-    return HARD_FLOOR_CATEGORIES.includes(value);
-}
-/**
- * `true` when the current mode should auto-proceed (skip the
- * AskUserQuestion round-trip). Mirrors D5.a: "recommended = chosen
- * in full-auto / swarm; always log, never silently skip".
- */
-export function shouldAutoProceed(mode) {
-    return mode === 'full-auto' || mode === 'swarm';
-}
-export const COMMIT_BOUNDARY_ACTIONS = [
-    'git-push',
-    'git-tag',
-    'npm-publish',
-    'npm-install-global',
-    'peaks-global-install'
-];
-export function isCommitBoundaryAction(value) {
-    return COMMIT_BOUNDARY_ACTIONS.includes(value);
-}
-/**
- * Hard-pause steps: these pause regardless of mode. They are the gates
- * whose decision *creates* or *recreates* the mode/state under which
- * later gates run. Auto-proceeding on them would silently fix the mode
- * without user consent (defect #1: new Solo session skipped Step 1
- * AskUserQuestion because `full-auto` mode triggered `shouldAutoProceed`
- * on `step-1-mode-select` itself).
- *
- * v2.18.4 slice 002-fix-first-run-step-gates: added
- * `step-0.55-1x-upgrade`. The 1.x → 2.0 upgrade is an irreversible
- * external side effect (migration rewrites config files and the
- * on-disk cache shape) — it must always pause, even in full-auto.
- * Without this, `full-auto` mode auto-proceeds and silently
- * downgrades a 1.x install to 2.0 without user consent.
- */
-const HARD_PAUSE_STEPS = new Set([
-    'step-1-mode-select',
-    'step-0.5-openspec-opt-in',
-    'step-0.7-resume-detection',
-    'step-0.55-1x-upgrade'
-]);
-export function shouldPauseAtGate(opts) {
-    if (opts.hardFloorCategory !== undefined && isHardFloorCategory(opts.hardFloorCategory)) {
-        return {
-            shouldPause: true,
-            reason: `hard-floor category "${opts.hardFloorCategory}" always pauses regardless of mode (D5.b)`,
-            hardFloorCategory: opts.hardFloorCategory,
-            gateKind: 'hard-floor'
-        };
-    }
-    // Slice 002 (v2.15.0) AC-4: commit-boundary side effects override
-    // every other decision. Per the user-given rule in
-    // `.peaks/memory/2026-06-28-full-auto-boundary.md` ("full-auto 只
-    // 做到 commit"), push / tag / npm publish / global install must
-    // AskUserQuestion even in full-auto. This is the mechanical
-    // enforcement of that rule.
-    if (opts.commitBoundaryAction === true) {
-        return {
-            shouldPause: true,
-            reason: 'commit-boundary side effect (push/tag/publish/global-install) → always pause regardless of mode (slice 002 AC-4, full-auto boundary = commit only)',
-            hardFloorCategory: 'commit-boundary-side-effect',
-            gateKind: 'hard-floor'
-        };
-    }
-    // Slice 2026-06-28-solo-mode-bypass-fix: hard-pause steps that
-    // determine the active mode or session context MUST prompt the
-    // user. Otherwise full-auto silently locks in `mode=full-auto` on
-    // the first tool call, skipping the AskUserQuestion Step 1 mandates.
-    if (HARD_PAUSE_STEPS.has(opts.step)) {
-        return {
-            shouldPause: true,
-            reason: `step=${opts.step} is a mode/context-selection step → always pause (defect #1 fix)`,
-            gateKind: 'mode-selection-itself'
-        };
-    }
-    if (shouldAutoProceed(opts.mode)) {
-        return {
-            shouldPause: false,
-            reason: `mode=${opts.mode} → recommended = chosen; emit auto-decision log (D5.a)`,
-            gateKind: 'mode-driven'
-        };
-    }
-    return {
-        shouldPause: true,
-        reason: `mode=${opts.mode} → pause for AskUserQuestion (assisted/strict default)`,
-        gateKind: 'mode-driven'
-    };
-}
-/**
- * Format a one-line audit message for the auto-decisions log.
- * Karpathy §3: this is a pure formatter; it does NOT touch the file
- * system. The CLI / LLM is responsible for appending.
- */
-export function formatAutoProceedLogLine(opts) {
-    if (opts.hardFloorCategory !== undefined && isHardFloorCategory(opts.hardFloorCategory)) {
-        return `auto-pause (${opts.mode}, hard-floor:${opts.hardFloorCategory}): ${opts.step} → ${opts.recommendedOption}`;
-    }
-    return `auto-proceed (${opts.mode}): ${opts.step} → ${opts.recommendedOption}`;
-}
-/**
- * v2.15.0 slice 002 AC-4: regex matchers the LLM-side caller uses
- * to flag a Bash command as a commit-boundary action. Centralised
- * here so the test seam + the CLI wiring share one source of
- * truth. Each entry is an anchored pattern matched against the
- * user-invoked command (after commander / shell normalisation,
- * before execution).
- *
- * Patterns intentionally cover the common canonical forms:
- *
- *   - `git-push`            → `git push`, `git push origin main`, `git push --tags`
- *   - `git-tag`             → `git tag v2.15.0`, `git tag -a v2.15.0 -m ...`
- *   - `npm-publish`         → `npm publish`, `npm publish --access public`
- *   - `npm-install-global`  → `npm install -g <pkg>`, `npm i -g <pkg>`
- *   - `peaks-global-install`→ `npm install -g peaks-loop`, `pnpm add -g peaks-loop`
- *
- * These are coarse — false positives are fine (worst case: a
- * non-actionable command gets paused for confirmation; the user
- * can confirm in one click). False negatives are NOT fine — a
- * missed publish would violate the full-auto boundary.
- */
-export const COMMIT_BOUNDARY_PATTERNS = {
-    'git-push': /\bgit\s+push\b/,
-    'git-tag': /\bgit\s+tag\b/,
-    'npm-publish': /\bnpm\s+(publish|pub)\b/,
-    'npm-install-global': /\bnpm\s+(install|i|add)\s+(-g|--global)\b/,
-    'peaks-global-install': /\b(peaks-loop)\b/
-};
-/**
- * v2.15.0 slice 002 AC-4: detect whether a Bash command matches any
- * commit-boundary action pattern. Returns the action id of the
- * first match, or `null` when none match. The CLI / LLM caller
- * passes the command through this function and forwards the
- * result to `shouldPauseAtGate({ commitBoundaryAction: true })` to
- * force the hard-floor pause.
- */
-export function detectCommitBoundaryAction(command) {
-    if (typeof command !== 'string' || command.length === 0)
-        return null;
-    // Order matters: peaks-global-install is the most specific
-    // (matches only the peaks-loop package name). Test that FIRST so
-    // `npm install -g peaks-loop` is attributed correctly. Then
-    // git-push, git-tag, npm-publish, npm-install-global.
-    if (COMMIT_BOUNDARY_PATTERNS['peaks-global-install'].test(command)) {
-        return 'peaks-global-install';
-    }
-    if (COMMIT_BOUNDARY_PATTERNS['git-push'].test(command)) {
-        return 'git-push';
-    }
-    if (COMMIT_BOUNDARY_PATTERNS['git-tag'].test(command)) {
-        return 'git-tag';
-    }
-    if (COMMIT_BOUNDARY_PATTERNS['npm-publish'].test(command)) {
-        return 'npm-publish';
-    }
-    if (COMMIT_BOUNDARY_PATTERNS['npm-install-global'].test(command)) {
-        return 'npm-install-global';
-    }
-    return null;
-}

package/dist/src/services/solo/post-compact-detector.d.ts

@@ -1,61 +0,0 @@
-/**
- * v2.11.0 Group F (Tier 9) — D7: post-compact auto-resume detector.
- *
- * Per `.peaks/memory/2026-06-26-v2-11-post-compact-resume.md` §D7.a,
- * post-compact auto-resume triggers when ALL of the following hold:
- *
- *   1. `.peaks/_runtime/<sessionId>/` is bound
- *   2. Latest checkpoint mtime is from today (UTC date)
- *   3. Latest checkpoint has a parseable `mode` field
- *   4. The peak-solo skill is the active skill
- *   5. Exactly one session has a today's checkpoint (no ambiguity)
- *
- * On a hit, the LLM MUST auto-resume (D7.b override of "never silently
- * auto-resume") and emit a one-line log entry. On any miss, fall
- * through to the normal Step 0.7 flow.
- *
- * Karpathy §3: the detector is the only place that decides "is this
- * a post-compact resume?" — no inline `isPostCompact()` checks
- * scattered across SKILL.md or other services.
- *
- * IO: readdir + readFile on `.peaks/_runtime/<sid>/checkpoints/`.
- * No writes (caller logs the decision via the auto-decisions channel).
- */
-import type { SkillPresenceMode } from '../skills/skill-presence-service.js';
-import { type SoloMode } from './mode-gate.js';
-export type PostCompactResumeReason = 'post-compact-match' | 'sid-unbound' | 'runtime-dir-missing' | 'no-checkpoint-today' | 'no-mode-field' | 'stale-checkpoint' | 'multiple-checkpoints-ambiguous' | 'active-skill-mismatch' | 'checkpoint-read-failed';
-export declare const POST_COMPACT_RESUME_REASONS: readonly PostCompactResumeReason[];
-export interface PostCompactResumeProbe {
-    readonly shouldAutoResume: boolean;
-    readonly reason: PostCompactResumeReason;
-    readonly mode?: SoloMode;
-    readonly checkpointPath?: string;
-    readonly checkpointMtime?: string;
-    readonly task?: string;
-    readonly openQuestions?: readonly string[];
-    readonly recentDecisions?: readonly string[];
-    readonly warnings: readonly string[];
-}
-export interface DetectPostCompactResumeOptions {
-    readonly sessionId: string;
-    readonly projectRoot: string;
-    /** Injectable clock for deterministic tests; defaults to `new Date()`. */
-    readonly now?: (() => Date) | undefined;
-    /** Override the active-skill check (test seam; defaults to read presence). */
-    readonly activeSkill?: string | undefined;
-    /** Override mode read from presence (test seam). */
-    readonly presenceModeOverride?: SkillPresenceMode | undefined;
-}
-/**
- * Detect whether the current invocation is a same-day post-compact
- * resume. The LLM-side caller invokes this in Step 0.7 / Step 0.75
- * after anchoring. Pure-ish: only filesystem reads of the checkpoint
- * dir; no LLM calls.
- */
-export declare function detectPostCompactResume(opts: DetectPostCompactResumeOptions): Promise<PostCompactResumeProbe>;
-/**
- * One-line auto-decisions log entry. Pure formatter; no IO. The LLM
- * appends to `.peaks/_runtime/<sessionId>/txt/auto-decisions.md` so
- * the existing audit channel picks it up (D7.e).
- */
-export declare function formatPostCompactResumeLogLine(probe: PostCompactResumeProbe): string;

package/dist/src/services/solo/post-compact-detector.js

@@ -1,240 +0,0 @@
-/**
- * v2.11.0 Group F (Tier 9) — D7: post-compact auto-resume detector.
- *
- * Per `.peaks/memory/2026-06-26-v2-11-post-compact-resume.md` §D7.a,
- * post-compact auto-resume triggers when ALL of the following hold:
- *
- *   1. `.peaks/_runtime/<sessionId>/` is bound
- *   2. Latest checkpoint mtime is from today (UTC date)
- *   3. Latest checkpoint has a parseable `mode` field
- *   4. The peak-solo skill is the active skill
- *   5. Exactly one session has a today's checkpoint (no ambiguity)
- *
- * On a hit, the LLM MUST auto-resume (D7.b override of "never silently
- * auto-resume") and emit a one-line log entry. On any miss, fall
- * through to the normal Step 0.7 flow.
- *
- * Karpathy §3: the detector is the only place that decides "is this
- * a post-compact resume?" — no inline `isPostCompact()` checks
- * scattered across SKILL.md or other services.
- *
- * IO: readdir + readFile on `.peaks/_runtime/<sid>/checkpoints/`.
- * No writes (caller logs the decision via the auto-decisions channel).
- */
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { getSkillPresence } from '../skills/skill-presence-service.js';
-import { emitObservabilityEvent } from '../observability/observability-service.js';
-import { isSoloMode } from './mode-gate.js';
-export const POST_COMPACT_RESUME_REASONS = [
-    'post-compact-match',
-    'sid-unbound',
-    'runtime-dir-missing',
-    'no-checkpoint-today',
-    'no-mode-field',
-    'stale-checkpoint',
-    'multiple-checkpoints-ambiguous',
-    'active-skill-mismatch',
-    'checkpoint-read-failed'
-];
-const CHECKPOINTS_DIR = 'checkpoints';
-const CHECKPOINT_EXT = '.json';
-function isToday(d, now) {
-    return (d.getUTCFullYear() === now.getUTCFullYear() &&
-        d.getUTCMonth() === now.getUTCMonth() &&
-        d.getUTCDate() === now.getUTCDate());
-}
-function safeReadCheckpoint(absPath) {
-    try {
-        const stat = statSync(absPath);
-        const raw = readFileSync(absPath, 'utf8');
-        const parsed = JSON.parse(raw);
-        const mutable = {};
-        if (typeof parsed['currentPlan'] === 'string') {
-            mutable.currentPlan = parsed['currentPlan'];
-        }
-        if (Array.isArray(parsed['openQuestions'])) {
-            mutable.openQuestions = parsed['openQuestions'].filter((q) => typeof q === 'string');
-        }
-        if (Array.isArray(parsed['recentDecisions'])) {
-            mutable.recentDecisions = parsed['recentDecisions'].filter((d) => typeof d === 'string');
-        }
-        if (typeof parsed['mode'] === 'string') {
-            mutable.mode = parsed['mode'];
-        }
-        const content = mutable;
-        return { path: absPath, mtime: stat.mtime, content };
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return null;
-    }
-}
-function readLatestTodayCheckpoint(runtimeDir, now) {
-    const dir = join(runtimeDir, CHECKPOINTS_DIR);
-    if (!existsSync(dir)) {
-        return { found: 'none' };
-    }
-    const todayFiles = [];
-    for (const entry of readdirSync(dir)) {
-        if (!entry.endsWith(CHECKPOINT_EXT))
-            continue;
-        const abs = join(dir, entry);
-        const file = safeReadCheckpoint(abs);
-        if (file === null)
-            continue;
-        if (isToday(file.mtime, now)) {
-            todayFiles.push(file);
-        }
-    }
-    if (todayFiles.length === 0) {
-        return { found: 'none' };
-    }
-    if (todayFiles.length > 1) {
-        todayFiles.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
-        const newest = todayFiles[0];
-        if (newest === undefined) {
-            return { found: 'none' };
-        }
-        const tieCount = todayFiles.filter((f) => f.mtime.getTime() === newest.mtime.getTime()).length;
-        if (tieCount > 1) {
-            return { found: 'multiple', files: todayFiles };
-        }
-        return { found: 'today', file: newest };
-    }
-    const only = todayFiles[0];
-    if (only === undefined) {
-        return { found: 'none' };
-    }
-    return { found: 'today', file: only };
-}
-/**
- * Detect whether the current invocation is a same-day post-compact
- * resume. The LLM-side caller invokes this in Step 0.7 / Step 0.75
- * after anchoring. Pure-ish: only filesystem reads of the checkpoint
- * dir; no LLM calls.
- */
-export async function detectPostCompactResume(opts) {
-    const now = opts.now ?? (() => new Date());
-    const warnings = [];
-    if (!opts.sessionId || opts.sessionId.trim().length === 0) {
-        return { shouldAutoResume: false, reason: 'sid-unbound', warnings };
-    }
-    const runtimeDir = join(opts.projectRoot, '.peaks', '_runtime', opts.sessionId);
-    if (!existsSync(runtimeDir)) {
-        return { shouldAutoResume: false, reason: 'runtime-dir-missing', warnings };
-    }
-    const probe = readLatestTodayCheckpoint(runtimeDir, now());
-    if (probe.found === 'multiple') {
-        return {
-            shouldAutoResume: false,
-            reason: 'multiple-checkpoints-ambiguous',
-            warnings: [`${probe.files.length} sessions have today's checkpoint; ambiguous`]
-        };
-    }
-    if (probe.found === 'none') {
-        return { shouldAutoResume: false, reason: 'no-checkpoint-today', warnings };
-    }
-    const file = probe.file;
-    const checkpointMode = file.content.mode;
-    if (checkpointMode === undefined) {
-        return {
-            shouldAutoResume: false,
-            reason: 'no-mode-field',
-            checkpointPath: file.path,
-            checkpointMtime: file.mtime.toISOString(),
-            warnings
-        };
-    }
-    // Active skill check (D7.a.4). Defaults to reading from skill presence.
-    const expectedActiveSkill = 'peaks-solo';
-    const observedActiveSkill = opts.activeSkill ?? readActiveSkillName(opts.projectRoot);
-    if (observedActiveSkill !== expectedActiveSkill) {
-        return {
-            shouldAutoResume: false,
-            reason: 'active-skill-mismatch',
-            checkpointPath: file.path,
-            checkpointMtime: file.mtime.toISOString(),
-            warnings: [`active skill "${observedActiveSkill ?? 'unset'}" is not peaks-solo`]
-        };
-    }
-    // Mode: prefer the checkpoint's mode; fall back to the presence override
-    // (test seam) or to a fresh skill-presence read.
-    let mode;
-    if (isSoloMode(checkpointMode)) {
-        mode = checkpointMode;
-    }
-    else if (opts.presenceModeOverride !== undefined) {
-        mode = opts.presenceModeOverride;
-    }
-    else {
-        try {
-            const presence = getSkillPresence(opts.projectRoot);
-            const presenceMode = presence?.mode;
-            if (presenceMode !== undefined && isSoloMode(presenceMode)) {
-                mode = presenceMode;
-            }
-        }
-        catch (err) {
-            warnings.push(`presence read failed: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    if (mode === undefined) {
-        return {
-            shouldAutoResume: false,
-            reason: 'no-mode-field',
-            checkpointPath: file.path,
-            checkpointMtime: file.mtime.toISOString(),
-            warnings
-        };
-    }
-    const successProbe = {
-        shouldAutoResume: true,
-        reason: 'post-compact-match',
-        mode,
-        checkpointPath: file.path,
-        checkpointMtime: file.mtime.toISOString(),
-        ...(file.content.currentPlan !== undefined ? { task: file.content.currentPlan } : {}),
-        ...(file.content.openQuestions !== undefined ? { openQuestions: file.content.openQuestions } : {}),
-        ...(file.content.recentDecisions !== undefined ? { recentDecisions: file.content.recentDecisions } : {}),
-        warnings
-    };
-    emitPostCompactEvent({ projectRoot: opts.projectRoot, sessionId: opts.sessionId, probe: successProbe });
-    return successProbe;
-}
-// Slice C of v2.11.1 — observability hook #6/7. Fire-and-forget per
-// PRD Q4. The synchronous emit never throws and never blocks the
-// detector return value.
-function emitPostCompactEvent(opts) {
-    emitObservabilityEvent({
-        schemaVersion: 1,
-        ts: new Date().toISOString(),
-        sessionId: opts.sessionId,
-        category: 'post-compact',
-        detail: {
-            shouldAutoResume: opts.probe.shouldAutoResume,
-            reason: opts.probe.reason,
-            ...(opts.probe.mode !== undefined ? { mode: opts.probe.mode } : {}),
-            ...(opts.probe.checkpointPath !== undefined ? { checkpointPath: opts.probe.checkpointPath } : {})
-        }
-    }, { projectRoot: opts.projectRoot });
-}
-function readActiveSkillName(projectRoot) {
-    try {
-        const presence = getSkillPresence(projectRoot);
-        return presence?.skill;
-    }
-    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-        return undefined;
-    }
-}
-/**
- * One-line auto-decisions log entry. Pure formatter; no IO. The LLM
- * appends to `.peaks/_runtime/<sessionId>/txt/auto-decisions.md` so
- * the existing audit channel picks it up (D7.e).
- */
-export function formatPostCompactResumeLogLine(probe) {
-    if (!probe.shouldAutoResume) {
-        return `post-compact skip: reason=${probe.reason}`;
-    }
-    return `post-compact resume: ${probe.task ?? 'unspecified'} mode=${probe.mode ?? 'unknown'} checkpoint=${probe.checkpointPath ?? 'unknown'}`;
-}