peaks-loop 4.0.0-beta.9 → 4.0.1

package/dist/services/ide/ide-registry.js

@@ -4,6 +4,8 @@ import { CURSOR_ADAPTER } from './adapters/cursor-adapter.js';
 import { CODEX_ADAPTER } from './adapters/codex-adapter.js';
 import { HERMES_ADAPTER } from './adapters/hermes-adapter.js';
 import { OPENCLAW_ADAPTER } from './adapters/openclaw-adapter.js';
+import { QODER_ADAPTER } from './adapters/qoder-adapter.js';
+import { TONGYI_LINGMA_ADAPTER } from './adapters/tongyi-lingma-adapter.js';
 import { ZCODE_ADAPTER } from './adapters/zcode-adapter.js';
 /**
  * Built-in IDE adapter registry。Map<IdeId, IdeAdapter> 是单一来源。
@@ -25,6 +27,8 @@ const ADAPTERS = new Map([
     ['codex', CODEX_ADAPTER],
     ['hermes', HERMES_ADAPTER],
     ['openclaw', OPENCLAW_ADAPTER],
+    ['qoder', QODER_ADAPTER],
+    ['tongyi-lingma', TONGYI_LINGMA_ADAPTER],
     ['zcode', ZCODE_ADAPTER],
 ]);
 /** Get the adapter for a given IDE id. Throws on unsupported IDE. */
@@ -59,5 +63,7 @@ export function _resetAdaptersForTesting() {
     ADAPTERS.set('codex', CODEX_ADAPTER);
     ADAPTERS.set('hermes', HERMES_ADAPTER);
     ADAPTERS.set('openclaw', OPENCLAW_ADAPTER);
+    ADAPTERS.set('qoder', QODER_ADAPTER);
+    ADAPTERS.set('tongyi-lingma', TONGYI_LINGMA_ADAPTER);
     ADAPTERS.set('zcode', ZCODE_ADAPTER);
 }

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

@@ -181,7 +181,7 @@ export interface IdeCompactProfile {
     readonly compactPathway: 'shell-exec' | 'ide-native' | 'llm-self-compress' | 'noop';
     /**
      * Optional command the runner invokes post-compact to confirm
-     * ratio dropped (e.g. `peaks context now --json`). When omitted,
+     * ratio dropped (e.g. `peaks compact auto --json`). When omitted,
      * the orchestrator polls `envVarForContextPercent` directly.
      */
     readonly postCompactDetectCommand?: string;

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

@@ -9,7 +9,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles: z.ZodDefault<z.ZodNumber>;
     blockedReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -18,7 +18,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -27,7 +27,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -36,7 +36,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -45,7 +45,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -54,7 +54,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -63,7 +63,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     repairCycles?: number | undefined;
     blockedReason?: string | undefined;
 }>, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     repairCycles: number;
@@ -72,7 +72,7 @@ export declare const SliceStateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.
     failureReason?: string | undefined;
     blockedReason?: string | undefined;
 }, {
-    status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+    status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
     label: string;
     sliceId: string;
     commitSha?: string | undefined;
@@ -99,13 +99,13 @@ export declare const JobStateSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         at: string;
         reason: string;
-        from: "rotating";
         to: "single";
+        from: "rotating";
     }, {
         at: string;
         reason: string;
-        from: "rotating";
         to: "single";
+        from: "rotating";
     }>>;
     slices: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
         sliceId: z.ZodString;
@@ -117,7 +117,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles: z.ZodDefault<z.ZodNumber>;
         blockedReason: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -126,7 +126,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -135,7 +135,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -144,7 +144,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -153,7 +153,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -162,7 +162,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -171,7 +171,7 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }>, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -180,7 +180,7 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }, {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -191,10 +191,16 @@ export declare const JobStateSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     sessionId: string;
-    startedAt: string;
+    lastCheckpointAt: string;
     jobId: string;
+    startedAt: string;
+    parallelismHint: "serial" | "llm-decides";
+    exitPolicy: "strict" | "best-effort";
+    mainLoopStrategy: "single" | "rotating";
+    rotateEvery: number;
+    mainSessionCycle: number;
     slices: {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         repairCycles: number;
@@ -203,24 +209,19 @@ export declare const JobStateSchema: z.ZodObject<{
         failureReason?: string | undefined;
         blockedReason?: string | undefined;
     }[];
-    lastCheckpointAt: string;
-    parallelismHint: "serial" | "llm-decides";
-    exitPolicy: "strict" | "best-effort";
-    mainLoopStrategy: "single" | "rotating";
-    rotateEvery: number;
-    mainSessionCycle: number;
     mainLoopOverride?: {
         at: string;
         reason: string;
-        from: "rotating";
         to: "single";
+        from: "rotating";
     } | undefined;
 }, {
     sessionId: string;
-    startedAt: string;
+    lastCheckpointAt: string;
     jobId: string;
+    startedAt: string;
     slices: {
-        status: "pending" | "skipped" | "done" | "failed" | "blocked" | "in-progress";
+        status: "pending" | "blocked" | "failed" | "done" | "skipped" | "in-progress";
         label: string;
         sliceId: string;
         commitSha?: string | undefined;
@@ -229,7 +230,6 @@ export declare const JobStateSchema: z.ZodObject<{
         repairCycles?: number | undefined;
         blockedReason?: string | undefined;
     }[];
-    lastCheckpointAt: string;
     parallelismHint?: "serial" | "llm-decides" | undefined;
     exitPolicy?: "strict" | "best-effort" | undefined;
     mainLoopStrategy?: "single" | "rotating" | undefined;
@@ -238,8 +238,8 @@ export declare const JobStateSchema: z.ZodObject<{
     mainLoopOverride?: {
         at: string;
         reason: string;
-        from: "rotating";
         to: "single";
+        from: "rotating";
     } | undefined;
 }>;
 export declare const ResourceSnapshotSchema: z.ZodObject<{
@@ -292,10 +292,10 @@ export declare const JobStatusSummarySchema: z.ZodObject<{
         contextRatio: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    skipped: number;
-    done: number;
-    failed: number;
     blocked: number;
+    failed: number;
+    done: number;
+    skipped: number;
     total: number;
     mainLoopStrategy: "single" | "rotating";
     mainSessionCycle: number;
@@ -310,10 +310,10 @@ export declare const JobStatusSummarySchema: z.ZodObject<{
         contextRatio: number;
     } | undefined;
 }, {
-    skipped: number;
-    done: number;
-    failed: number;
     blocked: number;
+    failed: number;
+    done: number;
+    skipped: number;
     total: number;
     mainLoopStrategy: "single" | "rotating";
     mainSessionCycle: number;
@@ -330,7 +330,7 @@ export declare const JobStatusSummarySchema: z.ZodObject<{
 }>;
 export type SliceState = z.infer<typeof SliceStateSchema>;
 export type JobState = z.infer<typeof JobStateSchema>;
-export type ResourceSnapshot = z.infer<typeof ResourceSnapshotSchema>;
+export type { ResourceSnapshot } from '../job-snapshot/types.js';
 export type JobStatusSummary = z.infer<typeof JobStatusSummarySchema>;
 export declare const JobInitInputSchema: z.ZodObject<{
     jobId: z.ZodString;
@@ -374,51 +374,51 @@ export declare const JobCheckpointInputSchema: z.ZodEffects<z.ZodEffects<z.ZodOb
     json: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     project: string;
+    state: "failed" | "done" | "skipped";
     json: boolean;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
     jobId: string;
+    sliceId: string;
     reason?: string | undefined;
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
+    state: "failed" | "done" | "skipped";
     jobId: string;
-    json?: boolean | undefined;
+    sliceId: string;
     reason?: string | undefined;
+    json?: boolean | undefined;
     commitSha?: string | undefined;
 }>, {
     project: string;
+    state: "failed" | "done" | "skipped";
     json: boolean;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
     jobId: string;
+    sliceId: string;
     reason?: string | undefined;
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
+    state: "failed" | "done" | "skipped";
     jobId: string;
-    json?: boolean | undefined;
+    sliceId: string;
     reason?: string | undefined;
+    json?: boolean | undefined;
     commitSha?: string | undefined;
 }>, {
     project: string;
+    state: "failed" | "done" | "skipped";
     json: boolean;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
     jobId: string;
+    sliceId: string;
     reason?: string | undefined;
     commitSha?: string | undefined;
 }, {
     project: string;
-    state: "skipped" | "done" | "failed";
-    sliceId: string;
+    state: "failed" | "done" | "skipped";
     jobId: string;
-    json?: boolean | undefined;
+    sliceId: string;
     reason?: string | undefined;
+    json?: boolean | undefined;
     commitSha?: string | undefined;
 }>;
 export type JobCheckpointInput = z.infer<typeof JobCheckpointInputSchema>;
@@ -430,15 +430,15 @@ export declare const JobBlockInputSchema: z.ZodObject<{
     json: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    json: boolean;
     reason: string;
-    sliceId: string;
+    json: boolean;
     jobId: string;
+    sliceId: string;
 }, {
     project: string;
     reason: string;
-    sliceId: string;
     jobId: string;
+    sliceId: string;
     json?: boolean | undefined;
 }>;
 export type JobBlockInput = z.infer<typeof JobBlockInputSchema>;

package/dist/services/job-snapshot/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * peaks-loop-job-snapshot area (consolidated into peaks-loop).
+ *
+ * Public surface: runSnapshot, captureResources, and the
+ * ResourceSnapshot type.
+ */
+export { collectResourceSnapshot } from './snapshot.js';
+export type { ResourceSnapshot } from './types.js';

package/dist/services/job-snapshot/index.js

@@ -0,0 +1,7 @@
+/**
+ * peaks-loop-job-snapshot area (consolidated into peaks-loop).
+ *
+ * Public surface: runSnapshot, captureResources, and the
+ * ResourceSnapshot type.
+ */
+export { collectResourceSnapshot } from './snapshot.js';

package/dist/services/{job/job-resource-snapshot.d.ts → job-snapshot/snapshot.d.ts}

@@ -1,4 +1,4 @@
-import type { ResourceSnapshot } from './job-types.js';
+import type { ResourceSnapshot } from './types.js';
 /**
  * Collects a coarse-grained snapshot of host + project resources.
  * Numeric ranges are clamped to zod's domain — out-of-range values are clamped, not thrown,

package/dist/services/job-snapshot/types.d.ts

@@ -0,0 +1,7 @@
+export interface ResourceSnapshot {
+    capturedAt: string;
+    cpuPercent: number;
+    memMb: number;
+    diskMb: number;
+    contextRatio: number;
+}

package/dist/services/job-snapshot/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/karpathy-cost/karpathy-cost-check-service.d.ts

@@ -0,0 +1,67 @@
+import { type ResultEnvelope } from 'peaks-loop-shared/result';
+/** Threshold above which a `'block'` is downgraded to `'warn'`. */
+export declare const KARPATHY_COST_DOWNGRADE_THRESHOLD = 10;
+/** Threshold above which a sediment line is appended for human review. */
+export declare const KARPATHY_COST_REPORT_THRESHOLD = 50;
+export interface EvaluationCost {
+    readonly wallMs: number;
+    readonly subAgentsDispatched: number;
+    readonly tokensEstimated: number;
+    readonly sliceCodeSize: number;
+}
+export type GateAction = 'pass' | 'warn' | 'block';
+export interface KarpathyReviewEnvelope {
+    readonly passed?: boolean;
+    readonly violations?: ReadonlyArray<unknown>;
+    readonly gateAction?: GateAction;
+    readonly evaluationCost?: EvaluationCost;
+    readonly costRatio?: number;
+}
+export type KarpathyCostCheckDecision = {
+    readonly kind: 'no-cost-data';
+    readonly gateAction: GateAction | null;
+    readonly reason: 'envelope-missing-evaluationCost' | 'file-missing' | 'file-unreadable' | 'envelope-not-json';
+} | {
+    readonly kind: '24h-mode-active';
+    readonly gateAction: GateAction | null;
+    readonly reason: 'peaks session 24h-mode state = 24H_ACTIVE; cost-check is the OVERRIDE, not the constrained side';
+} | {
+    readonly kind: 'downgraded';
+    readonly originalGateAction: 'block';
+    readonly newGateAction: 'warn';
+    readonly costRatio: number;
+    readonly evaluationCost: EvaluationCost;
+} | {
+    readonly kind: 'reported';
+    readonly gateAction: GateAction;
+    readonly costRatio: number;
+    readonly evaluationCost: EvaluationCost;
+} | {
+    readonly kind: 'unchanged';
+    readonly gateAction: GateAction;
+    readonly costRatio: number;
+    readonly evaluationCost: EvaluationCost;
+};
+export interface KarpathyCostCheckInput {
+    /** The karpathy-review.md file content (verbatim). */
+    readonly reviewFileContent: string;
+    /** Callable that returns true if 24h-mode is active. */
+    readonly is24hModeActive: () => boolean;
+}
+export interface KarpathyCostCheckOutput {
+    readonly decision: KarpathyCostCheckDecision;
+    /** Plain-text reason line for the CLI to print under the envelope. */
+    readonly reasonLine: string;
+}
+/**
+ * Pure: decide whether to downgrade a karpathy-reviewer gateAction.
+ * No fs / no env reads — the input is pre-loaded by the CLI.
+ */
+export declare function decideKarpathyCostCheck(input: KarpathyCostCheckInput): KarpathyCostCheckOutput;
+/** Convenience: load the review file from disk and run the decision. */
+export declare function runKarpathyCostCheck(opts: {
+    readonly reviewFilePath: string;
+    readonly is24hModeActive: () => boolean;
+}): KarpathyCostCheckOutput;
+/** Envelope-shape return for the CLI. */
+export declare function buildCostCheckEnvelope(out: KarpathyCostCheckOutput): ResultEnvelope<KarpathyCostCheckDecision>;

package/dist/services/karpathy-cost/karpathy-cost-check-service.js

@@ -0,0 +1,108 @@
+// src/services/karpathy-cost/karpathy-cost-check-service.ts
+//
+// Slice 2026-07-30-karpathy-cost-self-review (slice 2/4). The
+// karpathy-reviewer's JSON envelope is extended with `evaluationCost`
+// + `costRatio` (see agents/karpathy-reviewer.md §4). This service
+// is the orchestrator-side consumer of those fields.
+//
+// The check is intentionally small and pure-with-respect-to-its-inputs:
+//   - It reads the slice's `rd/karpathy-review.md` (a JSON envelope
+//     written by karpathy-reviewer sub-agent)
+//   - It reads the 24h-mode state via a passed-in callable (NOT
+//     a direct fs read, to keep this unit-testable in isolation)
+//   - It decides whether to auto-downgrade a `'block'` gateAction
+//     to `'warn'` based on costRatio
+//   - It returns a structured result the CLI can render with
+//     printResult()
+//
+// Backward compatibility: when evaluationCost is absent the check
+// returns `'skipped-no-cost-data'` and gateAction is left untouched
+// (the existing hard gate stays in effect — missing cost data must
+// not silently downgrade a 'block').
+import { readFileSync } from 'node:fs';
+import { ok } from 'peaks-loop-shared/result';
+/** Threshold above which a `'block'` is downgraded to `'warn'`. */
+export const KARPATHY_COST_DOWNGRADE_THRESHOLD = 10;
+/** Threshold above which a sediment line is appended for human review. */
+export const KARPATHY_COST_REPORT_THRESHOLD = 50;
+/**
+ * Pure: decide whether to downgrade a karpathy-reviewer gateAction.
+ * No fs / no env reads — the input is pre-loaded by the CLI.
+ */
+export function decideKarpathyCostCheck(input) {
+    if (input.is24hModeActive()) {
+        return {
+            decision: {
+                kind: '24h-mode-active',
+                gateAction: null,
+                reason: 'peaks session 24h-mode state = 24H_ACTIVE; cost-check is the OVERRIDE, not the constrained side',
+            },
+            reasonLine: 'karpathy-cost-check: skipped (24h-mode active)',
+        };
+    }
+    let envelope;
+    try {
+        envelope = JSON.parse(input.reviewFileContent);
+    }
+    catch {
+        return {
+            decision: { kind: 'no-cost-data', gateAction: null, reason: 'envelope-not-json' },
+            reasonLine: 'karpathy-cost-check: skipped (envelope not JSON)',
+        };
+    }
+    if (!envelope.evaluationCost || typeof envelope.costRatio !== 'number') {
+        return {
+            decision: {
+                kind: 'no-cost-data',
+                gateAction: envelope.gateAction ?? null,
+                reason: 'envelope-missing-evaluationCost',
+            },
+            reasonLine: 'karpathy-cost-check: skipped (envelope missing evaluationCost/costRatio)',
+        };
+    }
+    const costRatio = envelope.costRatio;
+    const evaluationCost = envelope.evaluationCost;
+    if (envelope.gateAction === 'block' && costRatio > KARPATHY_COST_DOWNGRADE_THRESHOLD) {
+        return {
+            decision: {
+                kind: 'downgraded',
+                originalGateAction: 'block',
+                newGateAction: 'warn',
+                costRatio,
+                evaluationCost,
+            },
+            reasonLine: `karpathy-cost-check: downgraded block → warn (costRatio=${costRatio.toFixed(2)} > ${KARPATHY_COST_DOWNGRADE_THRESHOLD})`,
+        };
+    }
+    if (costRatio > KARPATHY_COST_REPORT_THRESHOLD) {
+        return {
+            decision: { kind: 'reported', gateAction: envelope.gateAction ?? 'pass', costRatio, evaluationCost },
+            reasonLine: `karpathy-cost-check: costRatio=${costRatio.toFixed(2)} > ${KARPATHY_COST_REPORT_THRESHOLD} (sediment appended)`,
+        };
+    }
+    return {
+        decision: { kind: 'unchanged', gateAction: envelope.gateAction ?? 'pass', costRatio, evaluationCost },
+        reasonLine: `karpathy-cost-check: unchanged (costRatio=${costRatio.toFixed(2)})`,
+    };
+}
+/** Convenience: load the review file from disk and run the decision. */
+export function runKarpathyCostCheck(opts) {
+    let content;
+    try {
+        content = readFileSync(opts.reviewFilePath, 'utf8');
+    }
+    catch {
+        return {
+            decision: { kind: 'no-cost-data', gateAction: null, reason: 'file-missing' },
+            reasonLine: `karpathy-cost-check: skipped (file missing: ${opts.reviewFilePath})`,
+        };
+    }
+    return decideKarpathyCostCheck({
+        reviewFileContent: content,
+        is24hModeActive: opts.is24hModeActive,
+    });
+}
+/** Envelope-shape return for the CLI. */
+export function buildCostCheckEnvelope(out) {
+    return ok('karpathy-cost-check', out.decision);
+}

package/dist/services/log/retention.d.ts

@@ -32,3 +32,19 @@ export type ApplyRetentionOptions = {
  * process between the `readdir` and the `unlink`).
  */
 export declare function applyRetention(opts?: ApplyRetentionOptions): string[];
+/**
+ * Slice 3 (on-demand-ecc) — 7-day TTL sweep over `~/.peaks/cache/ecc-<sha>/`
+ * directories. Delegates to `cleanupStaleCache` in the ECC cache
+ * service so the retention policy lives next to the cache it
+ * governs.
+ *
+ * Mirrors the `applyRetention` signature for symmetry: tests pass
+ * `nowMs` + `dirOverride`; production callers leave both unset.
+ */
+export declare function cleanupEccCache(options: {
+    retentionDays: number;
+    nowMs?: number;
+    dirOverride?: string;
+}): {
+    removed: string[];
+};

package/dist/services/log/retention.js

@@ -16,6 +16,7 @@
 import { readdirSync, statSync, unlinkSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { resolveLogDir } from './logger.js';
+import { cleanupStaleCache } from 'peaks-loop-mut';
 const LOG_FILE_NAME_PATTERN = /^peaks-loop-(\d{4}-\d{2}-\d{2})\.log$/;
 function dayDiffUtc(nowUtcMidnightMs, fileDateUtcMs) {
     const dayMs = 24 * 60 * 60 * 1000;
@@ -76,3 +77,19 @@ export function applyRetention(opts = {}) {
     }
     return removed;
 }
+/**
+ * Slice 3 (on-demand-ecc) — 7-day TTL sweep over `~/.peaks/cache/ecc-<sha>/`
+ * directories. Delegates to `cleanupStaleCache` in the ECC cache
+ * service so the retention policy lives next to the cache it
+ * governs.
+ *
+ * Mirrors the `applyRetention` signature for symmetry: tests pass
+ * `nowMs` + `dirOverride`; production callers leave both unset.
+ */
+export function cleanupEccCache(options) {
+    return cleanupStaleCache({
+        retentionDays: options.retentionDays,
+        nowMs: options.nowMs ?? Date.now(),
+        ...(options.dirOverride !== undefined ? { dirOverride: options.dirOverride } : {}),
+    });
+}