peaks-loop 4.0.0-beta.9 → 4.0.3

package/dist/services/doctor/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * peaks-loop-doctor area (consolidated into peaks-loop).
+ *
+ * Re-exports the runDoctor check pipeline plus the public type
+ * contract (DoctorCheck / DoctorReport / DoctorOptions and the
+ * injectable probe types).
+ *
+ * Main peaks-loop package consumes via `workspace:*` dep:
+ *
+ *   import { runDoctor } from './doctor/index.js';
+ *
+ * The doctor service is probe-driven: cross-domain utilities
+ * (loadSkillRegistry, getSkillPresence, planStatusLineInstall,
+ * findProjectRoot, isValidSessionId) are injected at the
+ * call-site in main `src/cli/commands/core/doctor-command.ts`,
+ * so this package stays standalone and does NOT depend on
+ * the main peaks-loop package (avoiding circular deps).
+ *
+ * See .peaks/_runtime/2026-07-17-session-1d5ac0/rd/slice-3b-doctor.md
+ * for the slice-3b Option C decision rationale.
+ */
+export { runDoctor, isWorkspaceInitializedAt, compareDistVersion, inspectWorkspaceLayout, collectGateguardEntries, type DoctorCheck, type DoctorReport, type DoctorOptions, type CodegraphCapabilityProbe, type DistVersionComparison, type DistVersionProbe, type WorkspaceLayoutInspection, type WorkspaceLayoutProbe, type GateguardHookLocation, type GateguardProbeResult, type GateguardProbe, } from './doctor-service.js';

package/dist/services/doctor/index.js

@@ -0,0 +1,22 @@
+/**
+ * peaks-loop-doctor area (consolidated into peaks-loop).
+ *
+ * Re-exports the runDoctor check pipeline plus the public type
+ * contract (DoctorCheck / DoctorReport / DoctorOptions and the
+ * injectable probe types).
+ *
+ * Main peaks-loop package consumes via `workspace:*` dep:
+ *
+ *   import { runDoctor } from './doctor/index.js';
+ *
+ * The doctor service is probe-driven: cross-domain utilities
+ * (loadSkillRegistry, getSkillPresence, planStatusLineInstall,
+ * findProjectRoot, isValidSessionId) are injected at the
+ * call-site in main `src/cli/commands/core/doctor-command.ts`,
+ * so this package stays standalone and does NOT depend on
+ * the main peaks-loop package (avoiding circular deps).
+ *
+ * See .peaks/_runtime/2026-07-17-session-1d5ac0/rd/slice-3b-doctor.md
+ * for the slice-3b Option C decision rationale.
+ */
+export { runDoctor, isWorkspaceInitializedAt, compareDistVersion, inspectWorkspaceLayout, collectGateguardEntries, } from './doctor-service.js';

package/dist/services/env/shell-probe.d.ts

@@ -0,0 +1,71 @@
+export type ShellKind = 'bash' | 'pwsh' | 'powershell' | 'cmd' | 'unknown';
+export interface ShellProbeReport {
+    /** Whether a usable bash was located. `false` ⇒ caller MUST NOT silently fall back to PowerShell. */
+    readonly available: boolean;
+    /** The recommended shell command name. `'bash'` on success, `'pwsh'` / `'powershell'` only as an explicit non-silent fallback (with available=false). */
+    readonly shell: ShellKind;
+    /** Absolute path to the resolved binary, when found. `null` otherwise. */
+    readonly path: string | null;
+    /**
+     * Why the probe returned what it returned. Always populated —
+     * `null` reasons are forbidden. `'unavailable'` carries a single-
+     * line explanation the orchestrator can render to the user.
+     */
+    readonly reason: string;
+    /** Wall-clock duration of the probe (ms). Useful for the dispatch envelope's `notes[]`. */
+    readonly elapsedMs: number;
+    /** Probe platform — `win32` triggers the Git-Bash preference. */
+    readonly platform: NodeJS.Platform;
+}
+export interface ShellProbeOptions {
+    /**
+     * Override `process.platform`. Tests use this to simulate Windows
+     * hosts on Linux CI (and vice versa) without mutating process.
+     */
+    readonly platform?: NodeJS.Platform;
+    /**
+     * Override the runner that performs the `which bash` / `where
+     * bash` probe. The default delegates to `child_process.spawn`; the
+     * test seam injects a fake.
+     */
+    readonly runner?: ShellProbeRunner;
+    /**
+     * Override the process env. Default: process.env.
+     */
+    readonly env?: NodeJS.ProcessEnv;
+    /**
+     * Probe timeout (ms). Default: 3000. A sub-agent that hangs the
+     * probe would itself be a stall; bounded so the call site fails
+     * fast and the orchestrator can surface `available: false`.
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Wall clock for tests.
+     */
+    readonly now?: () => number;
+    /**
+     * Test seam: override the literal-path probe. The default
+     * delegates to `node:fs#existsSync`; the test seam injects a
+     * fake so the Windows-no-bash scenario can be exercised on a
+     * host that has Git Bash installed (and vice versa).
+     */
+    readonly probeFile?: (absPath: string) => Promise<boolean> | boolean;
+}
+export interface ShellProbeRunner {
+    /**
+     * Run a command. Returns the captured stdout on success and
+     * throws (or returns `null`) on failure. The probe treats
+     * `null`-returns the same as thrown errors.
+     */
+    run(command: string, args: readonly string[], opts: {
+        timeoutMs: number;
+    }): Promise<{
+        stdout: string;
+    } | null>;
+}
+/**
+ * Probe the host shell. The returned report is the single source of
+ * truth: callers MUST surface `reason` when `available: false` rather
+ * than silently falling back to PowerShell.
+ */
+export declare function probeShell(options?: ShellProbeOptions): Promise<ShellProbeReport>;

package/dist/services/env/shell-probe.js

@@ -0,0 +1,161 @@
+/**
+ * Slice 2026-07-29-dispatch-stall-governance / S6 — typed shell probe.
+ *
+ * Codifies the prose-only red rule recorded in
+ * .peaks/memory/2026-07-27-windows-shell-pref.md: on Windows, a
+ * sub-agent must probe `which bash` and prefer Git Bash; an
+ * unavailable bash must surface as an explicit `ShellProbeReport`
+ * (with `available: false` + a `reason`), not as a silent fallback
+ * to PowerShell.
+ *
+ * Pre-S6, the rule was *only* documented in `.peaks/memory/`; nothing
+ * in the code path enforced it, so a sub-agent could silently land on
+ * PowerShell, emit a bash-syntax command, and hang on a parser error —
+ * which the orchestrator would observe as a stall (PRD §1.6).
+ *
+ * Public surface:
+ *   - `probeShell(opts)` → `Promise<ShellProbeReport>`
+ *   - `ShellProbeReport` (typed, JSON-serializable)
+ *   - `ShellProbeRunner` (test seam: inject a fake runner)
+ *
+ * The probe is **lazy**: it only spawns a process when the caller
+ * actually invokes `probeShell`. Calling `formatTestToolDetection()`
+ * or any other dispatch hot path does NOT trigger a shell probe. The
+ * probe is opt-in at the dispatch / tool boundary; we do NOT
+ * broadcast-probe every dispatch (that would add a 50–200ms hit to
+ * the hot path).
+ *
+ * On non-Windows platforms the probe is a passthrough: `available:
+ * true`, `shell: 'bash'`, `reason: 'non-windows passthrough'`. Linux
+ * and macOS hosts already have a usable shell, so the Windows-only
+ * Git-Bash probe is unnecessary.
+ */
+import { spawn } from 'node:child_process';
+const DEFAULT_TIMEOUT_MS = 3_000;
+/** Default runner: child_process.spawn, with a 3s ceiling. */
+const defaultRunner = {
+    async run(command, args, opts) {
+        return await new Promise((resolveRun) => {
+            let resolved = false;
+            const finish = (value) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                resolveRun(value);
+            };
+            try {
+                const child = spawn(command, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+                let stdout = '';
+                child.stdout?.on('data', (chunk) => {
+                    stdout += chunk.toString('utf8');
+                });
+                child.on('error', () => finish(null));
+                child.on('close', (code) => {
+                    if (code === 0 && stdout.trim().length > 0) {
+                        finish({ stdout });
+                    }
+                    else {
+                        finish(null);
+                    }
+                });
+                const t = setTimeout(() => {
+                    child.kill();
+                    finish(null);
+                }, opts.timeoutMs);
+                t.unref?.();
+            }
+            catch {
+                finish(null);
+            }
+        });
+    }
+};
+/**
+ * Probe the host shell. The returned report is the single source of
+ * truth: callers MUST surface `reason` when `available: false` rather
+ * than silently falling back to PowerShell.
+ */
+export async function probeShell(options = {}) {
+    const platform = options.platform ?? process.platform;
+    const runner = options.runner ?? defaultRunner;
+    const env = options.env ?? process.env;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const now = options.now ?? (() => Date.now());
+    const probeFileFn = options.probeFile ?? defaultProbeFile;
+    const startedAt = now();
+    if (platform !== 'win32') {
+        return {
+            available: true,
+            shell: 'bash',
+            path: '/bin/bash',
+            reason: 'non-windows passthrough',
+            elapsedMs: now() - startedAt,
+            platform
+        };
+    }
+    // 1. Prefer Git Bash explicitly. Git for Windows installs at
+    //    `C:\Program Files\Git\bin\bash.exe` (or `C:\nvm4w\nodejs\git-
+    //    bash.exe` on the nvm4w layout). The env var `PEAKS_GIT_BASH`
+    //    lets an operator pin a non-default path without code change.
+    const pinnedGitBash = env.PEAKS_GIT_BASH;
+    const gitBashCandidates = pinnedGitBash
+        ? [pinnedGitBash]
+        : [
+            'C:\\Program Files\\Git\\bin\\bash.exe',
+            'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
+            'C:\\nvm4w\\nodejs\\git-bash.exe',
+            'C:\\Program Files\\Git\\usr\\bin\\bash.exe'
+        ];
+    for (const candidate of gitBashCandidates) {
+        if (await probeFileFn(candidate)) {
+            return {
+                available: true,
+                shell: 'bash',
+                path: candidate,
+                reason: 'Git Bash located at pinned or default path',
+                elapsedMs: now() - startedAt,
+                platform
+            };
+        }
+    }
+    // 2. Fall back to PATH lookup (`where bash` on Windows). This
+    //    catches portable Git installs that land in a non-default
+    //    directory.
+    const where = await runner.run('where', ['bash'], { timeoutMs });
+    if (where !== null && where.stdout.trim().length > 0) {
+        const first = where.stdout.split(/\r?\n/).map((l) => l.trim()).find((l) => l.length > 0);
+        if (first !== undefined) {
+            return {
+                available: true,
+                shell: 'bash',
+                path: first,
+                reason: 'bash located via `where bash` (PATH lookup)',
+                elapsedMs: now() - startedAt,
+                platform
+            };
+        }
+    }
+    // 3. Explicit unavailable report — the orchestrator MUST surface
+    //    this rather than silently falling back to PowerShell.
+    return {
+        available: false,
+        shell: 'unknown',
+        path: null,
+        reason: 'No bash found on this Windows host. Install Git for Windows ' +
+            '(https://git-scm.com/download/win) or set PEAKS_GIT_BASH to the ' +
+            'absolute path of a bash.exe binary. Per .peaks/memory/2026-07-27-' +
+            'windows-shell-pref.md, PowerShell is NOT a silent fallback.',
+        elapsedMs: now() - startedAt,
+        platform
+    };
+}
+/**
+ * Default literal-path probe. Uses Node's `fs.existsSync` (a single
+ * stat call, no spawn). Tests inject a custom `probeFile` through
+ * `ShellProbeOptions.probeFile` to simulate a no-bash Windows host
+ * without needing a host-specific override.
+ */
+async function defaultProbeFile(absPath) {
+    const { existsSync } = await import('node:fs');
+    return existsSync(absPath);
+}

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

@@ -73,12 +73,12 @@ export declare const EvolutionProposalInputSchema: z.ZodObject<{
     red_lines: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     source_traces: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    diff: Record<string, unknown>;
-    target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+    target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
     target_release_id: string;
     optimization_dimension: string;
     before_snapshot: Record<string, unknown>;
     after_snapshot: Record<string, unknown>;
+    diff: Record<string, unknown>;
     before_score: number;
     after_score: number;
     score_delta_min: number;
@@ -89,7 +89,7 @@ export declare const EvolutionProposalInputSchema: z.ZodObject<{
     red_lines: string[];
     source_traces: string[];
 }, {
-    target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+    target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
     target_release_id: string;
     optimization_dimension: string;
     before_score: number;
@@ -97,9 +97,9 @@ export declare const EvolutionProposalInputSchema: z.ZodObject<{
     author_id: string;
     single_object: true;
     single_optimization_dimension: true;
-    diff?: Record<string, unknown> | undefined;
     before_snapshot?: Record<string, unknown> | undefined;
     after_snapshot?: Record<string, unknown> | undefined;
+    diff?: Record<string, unknown> | undefined;
     score_delta_min?: number | undefined;
     rubric?: Record<string, unknown> | undefined;
     red_lines?: string[] | undefined;
@@ -153,13 +153,13 @@ export declare const EvolutionProposalSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     schema_version: "peaks.evolution/1";
     id: string;
-    diff: Record<string, unknown>;
     created_at: string;
-    target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+    target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
     target_release_id: string;
     optimization_dimension: string;
     before_snapshot: Record<string, unknown>;
     after_snapshot: Record<string, unknown>;
+    diff: Record<string, unknown>;
     before_score: number;
     after_score: number;
     score_delta_min: number;
@@ -175,7 +175,7 @@ export declare const EvolutionProposalSchema: z.ZodObject<{
 }, {
     id: string;
     created_at: string;
-    target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+    target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
     target_release_id: string;
     optimization_dimension: string;
     before_score: number;
@@ -187,9 +187,9 @@ export declare const EvolutionProposalSchema: z.ZodObject<{
     target_count: 1;
     score_delta: number;
     schema_version?: "peaks.evolution/1" | undefined;
-    diff?: Record<string, unknown> | undefined;
     before_snapshot?: Record<string, unknown> | undefined;
     after_snapshot?: Record<string, unknown> | undefined;
+    diff?: Record<string, unknown> | undefined;
     score_delta_min?: number | undefined;
     rubric?: Record<string, unknown> | undefined;
     red_lines?: string[] | undefined;
@@ -229,10 +229,10 @@ export declare const RegressionSkepticResultSchema: z.ZodObject<{
     safetyRegressionRisks: string[];
     blocker?: string | undefined;
 }, {
-    blocker?: string | undefined;
     driftRisks?: string[] | undefined;
     overfitRisks?: string[] | undefined;
     safetyRegressionRisks?: string[] | undefined;
+    blocker?: string | undefined;
 }>;
 export type RegressionSkepticResult = z.infer<typeof RegressionSkepticResultSchema>;
 /**
@@ -292,13 +292,13 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         schema_version: "peaks.evolution/1";
         id: string;
-        diff: Record<string, unknown>;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_snapshot: Record<string, unknown>;
         after_snapshot: Record<string, unknown>;
+        diff: Record<string, unknown>;
         before_score: number;
         after_score: number;
         score_delta_min: number;
@@ -314,7 +314,7 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
     }, {
         id: string;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_score: number;
@@ -326,9 +326,9 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
         schema_version?: "peaks.evolution/1" | undefined;
-        diff?: Record<string, unknown> | undefined;
         before_snapshot?: Record<string, unknown> | undefined;
         after_snapshot?: Record<string, unknown> | undefined;
+        diff?: Record<string, unknown> | undefined;
         score_delta_min?: number | undefined;
         rubric?: Record<string, unknown> | undefined;
         red_lines?: string[] | undefined;
@@ -360,10 +360,10 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         safetyRegressionRisks: string[];
         blocker?: string | undefined;
     }, {
-        blocker?: string | undefined;
         driftRisks?: string[] | undefined;
         overfitRisks?: string[] | undefined;
         safetyRegressionRisks?: string[] | undefined;
+        blocker?: string | undefined;
     }>;
     verdict: z.ZodEnum<["keep", "revert", "needs-user-decision"]>;
     user_confirmation_pointer: z.ZodOptional<z.ZodString>;
@@ -373,16 +373,17 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     schema_version: "peaks.evolution/1";
     id: string;
+    created_at: string;
     proposal: {
         schema_version: "peaks.evolution/1";
         id: string;
-        diff: Record<string, unknown>;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_snapshot: Record<string, unknown>;
         after_snapshot: Record<string, unknown>;
+        diff: Record<string, unknown>;
         before_score: number;
         after_score: number;
         score_delta_min: number;
@@ -396,8 +397,6 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
     };
-    created_at: string;
-    verdict: "revert" | "keep" | "needs-user-decision";
     evaluator_id: string;
     skeptic_id: string;
     evaluator_result: {
@@ -411,14 +410,16 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         safetyRegressionRisks: string[];
         blocker?: string | undefined;
     };
+    verdict: "keep" | "revert" | "needs-user-decision";
     user_confirmation_pointer?: string | undefined;
     brief_pointer?: string | undefined;
 }, {
     id: string;
+    created_at: string;
     proposal: {
         id: string;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_score: number;
@@ -430,16 +431,14 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
         schema_version?: "peaks.evolution/1" | undefined;
-        diff?: Record<string, unknown> | undefined;
         before_snapshot?: Record<string, unknown> | undefined;
         after_snapshot?: Record<string, unknown> | undefined;
+        diff?: Record<string, unknown> | undefined;
         score_delta_min?: number | undefined;
         rubric?: Record<string, unknown> | undefined;
         red_lines?: string[] | undefined;
         source_traces?: string[] | undefined;
     };
-    created_at: string;
-    verdict: "revert" | "keep" | "needs-user-decision";
     evaluator_id: string;
     skeptic_id: string;
     evaluator_result: {
@@ -448,11 +447,12 @@ export declare const EvolutionEvaluationInputSchema: z.ZodObject<{
         riskTags?: string[] | undefined;
     };
     skeptic_result: {
-        blocker?: string | undefined;
         driftRisks?: string[] | undefined;
         overfitRisks?: string[] | undefined;
         safetyRegressionRisks?: string[] | undefined;
+        blocker?: string | undefined;
     };
+    verdict: "keep" | "revert" | "needs-user-decision";
     schema_version?: "peaks.evolution/1" | undefined;
     user_confirmation_pointer?: string | undefined;
     brief_pointer?: string | undefined;
@@ -505,13 +505,13 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         schema_version: "peaks.evolution/1";
         id: string;
-        diff: Record<string, unknown>;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_snapshot: Record<string, unknown>;
         after_snapshot: Record<string, unknown>;
+        diff: Record<string, unknown>;
         before_score: number;
         after_score: number;
         score_delta_min: number;
@@ -527,7 +527,7 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
     }, {
         id: string;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_score: number;
@@ -539,9 +539,9 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
         schema_version?: "peaks.evolution/1" | undefined;
-        diff?: Record<string, unknown> | undefined;
         before_snapshot?: Record<string, unknown> | undefined;
         after_snapshot?: Record<string, unknown> | undefined;
+        diff?: Record<string, unknown> | undefined;
         score_delta_min?: number | undefined;
         rubric?: Record<string, unknown> | undefined;
         red_lines?: string[] | undefined;
@@ -573,10 +573,10 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         safetyRegressionRisks: string[];
         blocker?: string | undefined;
     }, {
-        blocker?: string | undefined;
         driftRisks?: string[] | undefined;
         overfitRisks?: string[] | undefined;
         safetyRegressionRisks?: string[] | undefined;
+        blocker?: string | undefined;
     }>;
     verdict: z.ZodEnum<["keep", "revert", "needs-user-decision"]>;
     user_confirmation_pointer: z.ZodOptional<z.ZodString>;
@@ -588,16 +588,18 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     schema_version: "peaks.evolution/1";
     id: string;
+    created_at: string;
+    score_delta: number;
     proposal: {
         schema_version: "peaks.evolution/1";
         id: string;
-        diff: Record<string, unknown>;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_snapshot: Record<string, unknown>;
         after_snapshot: Record<string, unknown>;
+        diff: Record<string, unknown>;
         before_score: number;
         after_score: number;
         score_delta_min: number;
@@ -611,9 +613,6 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
     };
-    created_at: string;
-    verdict: "revert" | "keep" | "needs-user-decision";
-    score_delta: number;
     evaluator_id: string;
     skeptic_id: string;
     evaluator_result: {
@@ -627,14 +626,17 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         safetyRegressionRisks: string[];
         blocker?: string | undefined;
     };
+    verdict: "keep" | "revert" | "needs-user-decision";
     user_confirmation_pointer?: string | undefined;
     brief_pointer?: string | undefined;
 }, {
     id: string;
+    created_at: string;
+    score_delta: number;
     proposal: {
         id: string;
         created_at: string;
-        target_kind: "bee" | "gate" | "loop" | "evaluator" | "policy";
+        target_kind: "loop" | "bee" | "gate" | "policy" | "evaluator";
         target_release_id: string;
         optimization_dimension: string;
         before_score: number;
@@ -646,17 +648,14 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         target_count: 1;
         score_delta: number;
         schema_version?: "peaks.evolution/1" | undefined;
-        diff?: Record<string, unknown> | undefined;
         before_snapshot?: Record<string, unknown> | undefined;
         after_snapshot?: Record<string, unknown> | undefined;
+        diff?: Record<string, unknown> | undefined;
         score_delta_min?: number | undefined;
         rubric?: Record<string, unknown> | undefined;
         red_lines?: string[] | undefined;
         source_traces?: string[] | undefined;
     };
-    created_at: string;
-    verdict: "revert" | "keep" | "needs-user-decision";
-    score_delta: number;
     evaluator_id: string;
     skeptic_id: string;
     evaluator_result: {
@@ -665,11 +664,12 @@ export declare const EvolutionEvaluationSchema: z.ZodObject<{
         riskTags?: string[] | undefined;
     };
     skeptic_result: {
-        blocker?: string | undefined;
         driftRisks?: string[] | undefined;
         overfitRisks?: string[] | undefined;
         safetyRegressionRisks?: string[] | undefined;
+        blocker?: string | undefined;
     };
+    verdict: "keep" | "revert" | "needs-user-decision";
     schema_version?: "peaks.evolution/1" | undefined;
     user_confirmation_pointer?: string | undefined;
     brief_pointer?: string | undefined;

package/dist/services/final-review/final-review-service.d.ts

@@ -1,4 +1,14 @@
-import type { LlmRunner } from '../audit/audit-goal-service.js';
+export interface LlmRunner {
+    call(systemPrompt: string, userPrompt: string, opts: {
+        maxTokens: number;
+    }): Promise<{
+        output: string;
+        tokens: {
+            input: number;
+            output: number;
+        };
+    }>;
+}
 import type { FinalReviewOutput } from './final-review-types.js';
 export interface PrepareFinalReviewOptions {
     readonly projectRoot: string;

package/dist/services/final-review/index.d.ts

@@ -0,0 +1,2 @@
+export { prepareFinalReview, type PrepareFinalReviewOptions, type LlmRunner, IncompleteFinalReviewError, } from './final-review-service.js';
+export type { DimensionKind, DimensionVerdict, EvidenceKind, DimensionConfidence, EvidenceItem, DimensionEvidence, FinalReviewOutput, } from './final-review-types.js';

package/dist/services/final-review/index.js

@@ -0,0 +1 @@
+export { prepareFinalReview, IncompleteFinalReviewError, } from './final-review-service.js';

package/dist/services/hooks/auto-compact-hook-install.d.ts

@@ -37,17 +37,16 @@
  */
 export declare const AUTO_COMPACT_HOOK_MATCHER = "Bash|Task";
 /**
- * Stable command the hook fires. Wraps `peaks session
- * auto-compact-hook` so the heavy lifting (ratio probe + in-band
- * `claude --compact` spawn) lives in the CLI surface, not inlined
- * into the hook.
+ * Stable command the hook fires. Wraps `peaks compact auto` so the
+ * heavy lifting (ratio probe + in-band `claude --compact` spawn)
+ * lives in the CLI surface, not inlined into the hook.
  *
  * `npx peaks` is deliberately omitted: the project-local install
  * puts `peaks` on PATH inside the consumer repo (postinstall step),
  * so the unqualified command works in the same shell the runner
  * is using.
  */
-export declare const AUTO_COMPACT_HOOK_COMMAND = "peaks session auto-compact-hook";
+export declare const AUTO_COMPACT_HOOK_COMMAND = "peaks compact auto";
 /**
  * Magic comment marker that fences the auto-compatchook block.
  * Both install (writes the marker) and remove (matches on it) use