peaks-loop 3.0.0 → 3.0.1

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

@@ -1,7 +1,7 @@
 /**
  * peaks 自有 hook 协议 + slim IDE adapter 接口。
  *
- * peaks-cli 不再适配 IDE 私有的 hook 协议;反之 peaks 定义自己的 canonical
+ * peaks-loop 不再适配 IDE 私有的 hook 协议;反之 peaks 定义自己的 canonical
  * schema,每个 IDE 只需要填 4 字符串 + 1 settings 函数,新 IDE 适配变成"填表"。
  *
  * 不可消除的 per-IDE 字段(诚实交代,见 PRD R-1..R-4):
@@ -97,9 +97,9 @@ export interface IdeAdapter {
     readonly skillInstall?: IdeSkillInstall;
     /**
      * v2.13.0 auto-compact (AC-1 + AC-3): per-IDE compact-capability
-     * descriptor. When `undefined`, peaks-cli falls back to the
+     * descriptor. When `undefined`, peaks-loop falls back to the
      * `llm-self-compress` pathway (the LLM summarizes its own context).
-     * Adapters that fill this expose a 4-stage protocol so peaks-cli
+     * Adapters that fill this expose a 4-stage protocol so peaks-loop
      * can drive compact autonomously:
      *
      *   1. `envVarForContextPercent` — env-var the IDE sets per turn
@@ -108,10 +108,10 @@ export interface IdeAdapter {
      *      accepts to trigger compact (e.g. `/compact`). Dispatched
      *      by AC-3.
      *   3. `compactPathway` — `'shell-exec' | 'ide-native' |
-     *      'llm-self-compress' | 'noop'`. `shell-exec` means peaks-cli
+     *      'llm-self-compress' | 'noop'`. `shell-exec` means peaks-loop
      *      spawns `compactCommand` via `child_process.spawn` (zero IDE
      *      hook required). `ide-native` means the IDE exposes a hook
-     *      surface peaks-cli can write to. `llm-self-compress` is the
+     *      surface peaks-loop can write to. `llm-self-compress` is the
      *      fallback when no compact capability is registered.
      *   4. `postCompactDetectCommand` (optional) — command the LLM
      *      runner can invoke after compact to confirm ratio dropped.
@@ -142,16 +142,16 @@ export interface IdeCompactProfile {
      */
     readonly compactCommand: string;
     /**
-     * `shell-exec` — peaks-cli spawns the command via child_process
+     * `shell-exec` — peaks-loop spawns the command via child_process
      *                (works for any IDE that accepts a slash command
      *                via a shell-spawnable entry point).
-     * `ide-native` — peaks-cli writes to an IDE-specific hook file;
+     * `ide-native` — peaks-loop writes to an IDE-specific hook file;
      *                used when the IDE requires a registered hook
      *                rather than a runtime command.
-     * `llm-self-compress` — peaks-cli prompts the LLM to summarize
+     * `llm-self-compress` — peaks-loop prompts the LLM to summarize
      *                its own context (no IDE integration required;
      *                least precise but always available).
-     * `noop` — peaks-cli records the intent but performs no action;
+     * `noop` — peaks-loop records the intent but performs no action;
      *          used by IDEs that explicitly opt out (e.g. legacy
      *          adapters still on the v2.11.x model).
      */

package/dist/src/services/legacy/legacy-detector.d.ts

@@ -1,7 +1,7 @@
 /**
  * v2.15.0 follow-up — G8: legacy code detector.
  *
- * 12 Gaps memory: when peaks-cli is applied to a 存量老项目 (legacy
+ * 12 Gaps memory: when peaks-loop is applied to a 存量老项目 (legacy
  * codebase), it is helpful to surface a quick inventory of "what
  * smells old" so the LLM / operator knows where to focus.
  *

package/dist/src/services/legacy/legacy-detector.js

@@ -1,7 +1,7 @@
 /**
  * v2.15.0 follow-up — G8: legacy code detector.
  *
- * 12 Gaps memory: when peaks-cli is applied to a 存量老项目 (legacy
+ * 12 Gaps memory: when peaks-loop is applied to a 存量老项目 (legacy
  * codebase), it is helpful to surface a quick inventory of "what
  * smells old" so the LLM / operator knows where to focus.
  *

package/dist/src/services/log/log-commands-service.d.ts

@@ -12,7 +12,7 @@
  */
 import { type LogEntry } from './logger.js';
 /**
- * Return all `peaks-cli-*.log` files in the log dir, sorted by
+ * Return all `peaks-loop-*.log` files in the log dir, sorted by
  * date descending (newest first). Returns `[]` when the dir is
  * missing or unreadable. Non-matching entries (e.g. a stray
  * README) are filtered out.

package/dist/src/services/log/log-commands-service.js

@@ -15,7 +15,7 @@ import { join } from 'node:path';
 import { buildLogFileName, readLogEntries, resolveLogDir } from './logger.js';
 const LOG_FILE_NAME_PATTERN = /^peaks-loop-\d{4}-\d{2}-\d{2}\.log$/;
 /**
- * Return all `peaks-cli-*.log` files in the log dir, sorted by
+ * Return all `peaks-loop-*.log` files in the log dir, sorted by
  * date descending (newest first). Returns `[]` when the dir is
  * missing or unreadable. Non-matching entries (e.g. a stray
  * README) are filtered out.

package/dist/src/services/log/logger.d.ts

@@ -1,10 +1,10 @@
 /**
- * JSONL file logger for peaks-cli.
+ * JSONL file logger for peaks-loop.
  *
  * Slice 2026-06-16-cli-logging (G1, G2, G5, G6, G7).
  *
- * Default-on file logging: every peaks-cli invocation writes a
- * structured log entry to `<homedir>/.peaks/logs/peaks-cli-YYYY-MM-DD.log`
+ * Default-on file logging: every peaks-loop invocation writes a
+ * structured log entry to `<homedir>/.peaks/logs/peaks-loop-YYYY-MM-DD.log`
  * (UTC date stamp). One JSON object per line.
  *
  * Hard contracts enforced here:

package/dist/src/services/log/logger.js

@@ -1,10 +1,10 @@
 /**
- * JSONL file logger for peaks-cli.
+ * JSONL file logger for peaks-loop.
  *
  * Slice 2026-06-16-cli-logging (G1, G2, G5, G6, G7).
  *
- * Default-on file logging: every peaks-cli invocation writes a
- * structured log entry to `<homedir>/.peaks/logs/peaks-cli-YYYY-MM-DD.log`
+ * Default-on file logging: every peaks-loop invocation writes a
+ * structured log entry to `<homedir>/.peaks/logs/peaks-loop-YYYY-MM-DD.log`
  * (UTC date stamp). One JSON object per line.
  *
  * Hard contracts enforced here:

package/dist/src/services/log/redact.d.ts

@@ -1,5 +1,5 @@
 /**
- * Secret redaction for peaks-cli JSONL log lines.
+ * Secret redaction for peaks-loop JSONL log lines.
  *
  * Slice 2026-06-16-cli-logging (G6). The logger must NEVER write
  * a raw secret to disk. We redact at two levels:

package/dist/src/services/log/redact.js

@@ -1,5 +1,5 @@
 /**
- * Secret redaction for peaks-cli JSONL log lines.
+ * Secret redaction for peaks-loop JSONL log lines.
  *
  * Slice 2026-06-16-cli-logging (G6). The logger must NEVER write
  * a raw secret to disk. We redact at two levels:

package/dist/src/services/loop/evaluator-dispatcher.d.ts

@@ -19,7 +19,7 @@ export interface EvaluatorVerdictEnvelope {
     readonly wallSeconds: number;
     /** When true, the evaluator fell back to a stub because the binary was
      *  unavailable in this environment. Surfaces in the verdict envelope so
-     *  the user can rerun on a real peaks-cli install. */
+     *  the user can rerun on a real peaks-loop install. */
     readonly degraded: boolean;
 }
 export interface DispatchOptions {

package/dist/src/services/loop/evaluator-dispatcher.js

@@ -3,7 +3,7 @@
  *
  * Evaluator-as-primitive dispatcher. Each of the 4 evaluator types
  * (karpathy / code-review / security-review / perf-baseline) maps to
- * an existing peaks-cli CLI surface; the dispatcher shells out to the
+ * an existing peaks-loop CLI surface; the dispatcher shells out to the
  * same binary so verdict shape stays byte-compatible with the
  * `verdict-aggregator` envelope union (`karpathy` / `security` / `perf`).
  *
@@ -195,7 +195,7 @@ function dispatchCanaryWatch(opts, started) {
 function parseGenericEnvelope(stdout, exitCode, started, kind, summaryPrefix) {
     const wall = (Date.now() - started) / 1000;
     const parsed = safeJson(stdout);
-    if (parsed === null) {
+    if (!parsed.ok) {
         return {
             kind,
             passed: exitCode === 0,
@@ -206,7 +206,7 @@ function parseGenericEnvelope(stdout, exitCode, started, kind, summaryPrefix) {
             degraded: true
         };
     }
-    const obj = parsed;
+    const obj = parsed.value;
     const data = (obj['data'] ?? obj);
     return {
         kind,
@@ -308,7 +308,7 @@ function gateActionFromVerdict(verdict) {
 function parseKarpathyEnvelope(stdout, exitCode, started) {
     const wall = (Date.now() - started) / 1000;
     const parsed = safeJson(stdout);
-    if (parsed === null) {
+    if (!parsed.ok) {
         return {
             kind: 'karpathy',
             passed: exitCode === 0,
@@ -319,7 +319,7 @@ function parseKarpathyEnvelope(stdout, exitCode, started) {
             degraded: true
         };
     }
-    const obj = parsed;
+    const obj = parsed.value;
     const data = (obj['data'] ?? obj);
     const passed = data['passed'] === true;
     const gateAction = typeof data['gateAction'] === 'string' ? gateActionFromVerdict(data['gateAction']) : (passed ? 'pass' : 'block');
@@ -342,7 +342,7 @@ function parseCodeReviewEnvelope(stdout, exitCode, started) {
 function parseSecurityEnvelope(stdout, exitCode, started) {
     const wall = (Date.now() - started) / 1000;
     const parsed = safeJson(stdout);
-    if (parsed === null) {
+    if (!parsed.ok) {
         return {
             kind: 'security-review',
             passed: exitCode === 0,
@@ -353,7 +353,7 @@ function parseSecurityEnvelope(stdout, exitCode, started) {
             degraded: true
         };
     }
-    const obj = parsed;
+    const obj = parsed.value;
     const data = (obj['data'] ?? obj);
     const verdict = typeof data['verdict'] === 'string' ? data['verdict'] : (exitCode === 0 ? 'pass' : 'warn');
     const violationsRaw = Array.isArray(data['violations']) ? data['violations'] : [];
@@ -371,7 +371,7 @@ function parseSecurityEnvelope(stdout, exitCode, started) {
 function parsePerfEnvelope(stdout, exitCode, started) {
     const wall = (Date.now() - started) / 1000;
     const parsed = safeJson(stdout);
-    if (parsed === null) {
+    if (!parsed.ok) {
         return {
             kind: 'perf-baseline',
             passed: exitCode === 0,
@@ -382,7 +382,7 @@ function parsePerfEnvelope(stdout, exitCode, started) {
             degraded: true
         };
     }
-    const obj = parsed;
+    const obj = parsed.value;
     const data = (obj['data'] ?? obj);
     const verdict = typeof data['verdict'] === 'string' ? data['verdict'] : (exitCode === 0 ? 'pass' : 'warn');
     const violationsRaw = Array.isArray(data['violations']) ? data['violations'] : [];
@@ -400,7 +400,7 @@ function parsePerfEnvelope(stdout, exitCode, started) {
 function parseVerdictAggregateEnvelope(stdout, exitCode, started) {
     const wall = (Date.now() - started) / 1000;
     const parsed = safeJson(stdout);
-    if (parsed === null) {
+    if (!parsed.ok) {
         return {
             kind: 'verdict-aggregate',
             passed: exitCode === 0,
@@ -411,7 +411,7 @@ function parseVerdictAggregateEnvelope(stdout, exitCode, started) {
             degraded: true
         };
     }
-    const obj = parsed;
+    const obj = parsed.value;
     const data = (obj['data'] ?? obj);
     const verdict = typeof data['verdict'] === 'string' ? data['verdict'] : (exitCode === 0 ? 'pass' : 'block');
     const reasonsRaw = Array.isArray(data['reasons']) ? data['reasons'] : [];
@@ -457,13 +457,14 @@ function normalizeViolation(raw) {
     return out;
 }
 function safeJson(raw) {
-    if (typeof raw !== 'string' || raw.length === 0)
-        return null;
+    if (typeof raw !== 'string' || raw.length === 0) {
+        return { ok: false, reason: 'PARSE_ERROR' };
+    }
     try {
-        return JSON.parse(raw);
+        return { ok: true, value: JSON.parse(raw) };
     }
     catch {
-        return null;
+        return { ok: false, reason: 'PARSE_ERROR' };
     }
 }
 // Tiny ergonomic helper so we can re-emit an envelope with a different `kind`.

package/dist/src/services/loop/monotonic-guard.js

@@ -137,6 +137,12 @@ export function checkMonotonicImprovement(previous, current, options = {}) {
         code: 'MONOTONIC_OK'
     };
 }
+function classifyFsError(err) {
+    const code = err?.code;
+    if (code === 'ENOENT')
+        return 'NOT_FOUND';
+    return 'IO_ERROR';
+}
 /** Read `.peaks/_sub_agents/<sid>/shared/` cross-session signal — on
  *  any IO error, return `null` so the guard never crashes on missing
  *  cross-batch signal (per Slice C (b) case "跨 session 读
@@ -149,13 +155,17 @@ export function loadCrossSessionSignal(projectRoot, sid) {
     const fs = require('node:fs');
     const path = require('node:path');
     const sharedDir = path.join(projectRoot, '.peaks', '_sub_agents', sid, 'shared');
-    let entries;
-    try {
-        entries = fs.readdirSync(sharedDir);
-    }
-    catch {
+    const readdir = (() => {
+        try {
+            return { ok: true, value: fs.readdirSync(sharedDir) };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!readdir.ok)
         return null; // missing dir or permission denied — both are no-ops.
-    }
+    const entries = readdir.value;
     // Pick the highest cycle number from the filenames; tolerate garbage.
     let best = null;
     for (const entry of entries) {
@@ -169,20 +179,27 @@ export function loadCrossSessionSignal(projectRoot, sid) {
     if (best === null)
         return null;
     const target = path.join(sharedDir, `cycle-${best}.json`);
-    let raw;
-    try {
-        raw = fs.readFileSync(target, 'utf8');
-    }
-    catch {
+    const readFile = (() => {
+        try {
+            return { ok: true, value: fs.readFileSync(target, 'utf8') };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!readFile.ok)
         return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
+    const parse = (() => {
+        try {
+            return { ok: true, value: JSON.parse(readFile.value) };
+        }
+        catch {
+            return { ok: false, reason: 'PARSE_ERROR' };
+        }
+    })();
+    if (!parse.ok)
         return null;
-    }
+    const parsed = parse.value;
     if (parsed === null || typeof parsed !== 'object')
         return null;
     const obj = parsed;

package/dist/src/services/loop/monotonic-runner.d.ts

@@ -26,6 +26,9 @@ export interface RunMonotonicResult {
     readonly persistedAt: string | null;
     readonly rows: readonly MonotonicScoreRow[];
     readonly report: MonotonicReport;
+    /** Additive surface for non-fatal persistence warnings (e.g. mkdir
+     *  failure). Optional so existing destructures keep compiling. */
+    readonly warnings?: readonly string[];
 }
 /** Resolve the slice dir used by both writer + reader — keeps tests
  *  insulated from real sessions. */

package/dist/src/services/loop/monotonic-runner.js

@@ -22,6 +22,12 @@ import { join } from 'node:path';
 import { dispatchEvaluator } from './evaluator-dispatcher.js';
 import { checkMonotonicImprovement, toScoreRow, DEFAULT_MONOTONIC_THRESHOLD } from './monotonic-guard.js';
 import { findProjectRoot } from '../config/config-safety.js';
+function classifyFsError(err) {
+    const code = err?.code;
+    if (code === 'ENOENT')
+        return 'NOT_FOUND';
+    return 'IO_ERROR';
+}
 /** Set of evaluator kinds the loop walker actually scores — keeps the
  *  guard surface tight (the verdict-aggregate is the cross-source merge
  *  and not a per-cycle input). */
@@ -51,13 +57,17 @@ function loadMostRecentCycleFromSubAgents(projectRoot, sid) {
 function loadMostRecentCycle(dir) {
     if (!existsSync(dir))
         return null;
-    let entries;
-    try {
-        entries = require('node:fs').readdirSync(dir);
-    }
-    catch {
+    const readdir = (() => {
+        try {
+            return { ok: true, value: require('node:fs').readdirSync(dir) };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!readdir.ok)
         return null;
-    }
+    const entries = readdir.value;
     let bestCycle = null;
     for (const entry of entries) {
         const m = entry.match(/^cycle-(\d+)\.json$/);
@@ -70,23 +80,30 @@ function loadMostRecentCycle(dir) {
     if (bestCycle === null)
         return null;
     const target = join(dir, `cycle-${bestCycle}.json`);
-    let raw;
-    try {
-        raw = readFileSync(target, 'utf8');
-    }
-    catch {
+    const readFile = (() => {
+        try {
+            return { ok: true, value: readFileSync(target, 'utf8') };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!readFile.ok)
         return null;
-    }
-    return parseCycle(raw, bestCycle);
+    return parseCycle(readFile.value, bestCycle);
 }
 function parseCycle(raw, fallbackCycle) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
+    const parse = (() => {
+        try {
+            return { ok: true, value: JSON.parse(raw) };
+        }
+        catch {
+            return { ok: false, reason: 'PARSE_ERROR' };
+        }
+    })();
+    if (!parse.ok)
         return null;
-    }
+    const parsed = parse.value;
     if (parsed === null || typeof parsed !== 'object')
         return null;
     const obj = parsed;
@@ -155,13 +172,20 @@ export function runMonotonicCheck(options) {
     const previousCycle = loadPreviousCycle(options.projectRoot, options.sid, options.rid);
     const report = checkMonotonicImprovement(previousCycle, currentCycle, { threshold });
     let persistedAt = null;
+    const envelopeWarns = [];
     if (persist) {
         const dir = sliceDir(options.projectRoot, options.sid, options.rid);
-        try {
-            mkdirSync(dir, { recursive: true });
-        }
-        catch {
-            // swallow — persist failure is non-fatal
+        const mkdir = (() => {
+            try {
+                mkdirSync(dir, { recursive: true });
+                return { ok: true, value: undefined };
+            }
+            catch (err) {
+                return { ok: false, reason: classifyFsError(err) };
+            }
+        })();
+        if (!mkdir.ok) {
+            envelopeWarns.push(`mkdir-failed: ${dir} (${mkdir.reason})`);
         }
         const path = join(dir, `cycle-${cycle}.json`);
         const payload = JSON.stringify({
@@ -171,12 +195,21 @@ export function runMonotonicCheck(options) {
             persistedAt: new Date().toISOString(),
             scores: rows
         });
-        try {
-            writeFileSync(path, payload, 'utf8');
+        const writeFile = (() => {
+            try {
+                writeFileSync(path, payload, 'utf8');
+                return { ok: true, value: undefined };
+            }
+            catch (err) {
+                return { ok: false, reason: classifyFsError(err) };
+            }
+        })();
+        if (writeFile.ok) {
             persistedAt = path;
         }
-        catch {
+        else {
             persistedAt = null;
+            envelopeWarns.push(`write-failed: ${path} (${writeFile.reason})`);
         }
     }
     return {
@@ -187,7 +220,8 @@ export function runMonotonicCheck(options) {
         previousCycle: previousCycle === null ? null : previousCycle.cycle,
         persistedAt,
         rows,
-        report
+        report,
+        ...(envelopeWarns.length > 0 ? { warnings: envelopeWarns } : {})
     };
 }
 /** Helper for tests + CLI — resolve project root + sid consistently. */

package/dist/src/services/loop/run-driver.js

@@ -33,6 +33,12 @@ import { dispatchEvaluator } from './evaluator-dispatcher.js';
 import { checkMonotonicImprovement, toScoreRow, DEFAULT_MONOTONIC_THRESHOLD } from './monotonic-guard.js';
 import { nextCycleIndex, sliceDir } from './monotonic-runner.js';
 import { findProjectRoot } from '../config/config-safety.js';
+function classifyFsError(err) {
+    const code = err?.code;
+    if (code === 'ENOENT')
+        return 'NOT_FOUND';
+    return 'IO_ERROR';
+}
 const ALLOWED_EVALUATOR_KINDS = new Set([
     'karpathy',
     'code-review',
@@ -65,12 +71,17 @@ export function cyclesDir(projectRoot, sid, rid) {
  *  `cycle-<N>.json`. Returns the persisted path on success. */
 function persistCycleRecord(projectRoot, sid, rid, cycle, rows) {
     const dir = cyclesDir(projectRoot, sid, rid);
-    try {
-        mkdirSync(dir, { recursive: true });
-    }
-    catch {
+    const mkdir = (() => {
+        try {
+            mkdirSync(dir, { recursive: true });
+            return { ok: true, value: undefined };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!mkdir.ok)
         return null;
-    }
     const path = join(dir, `cycle-${cycle}.json`);
     const payload = JSON.stringify({
         cycle,
@@ -79,13 +90,16 @@ function persistCycleRecord(projectRoot, sid, rid, cycle, rows) {
         persistedAt: new Date().toISOString(),
         scores: rows
     });
-    try {
-        writeFileSync(path, payload, 'utf8');
-        return path;
-    }
-    catch {
-        return null;
-    }
+    const writeFile = (() => {
+        try {
+            writeFileSync(path, payload, 'utf8');
+            return { ok: true, value: undefined };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    return writeFile.ok ? path : null;
 }
 /** Internal: build a CycleRecord from a (current, previous) pair. */
 function buildCycleRecord(cycle, rows, previous, threshold, persistedAt) {
@@ -332,20 +346,27 @@ function parseCycleFromPath(path, fallbackCycle) {
     // small and avoids leaking its internals).
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const fs = require('node:fs');
-    let raw;
-    try {
-        raw = fs.readFileSync(path, 'utf8');
-    }
-    catch {
+    const readFile = (() => {
+        try {
+            return { ok: true, value: fs.readFileSync(path, 'utf8') };
+        }
+        catch (err) {
+            return { ok: false, reason: classifyFsError(err) };
+        }
+    })();
+    if (!readFile.ok)
         return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
+    const parse = (() => {
+        try {
+            return { ok: true, value: JSON.parse(readFile.value) };
+        }
+        catch {
+            return { ok: false, reason: 'PARSE_ERROR' };
+        }
+    })();
+    if (!parse.ok)
         return null;
-    }
+    const parsed = parse.value;
     if (parsed === null || typeof parsed !== 'object')
         return null;
     const obj = parsed;

package/dist/src/services/memory/llm-reranker.d.ts

@@ -8,7 +8,7 @@
  * Architecture note (locked decision — see
  * `.peaks/memory/2026-06-18-peaks-zvec-spike-proposal.md` §Y2):
  *
- *   - "Active IDE LLM" is a deliberate abstraction: peaks-cli itself
+ *   - "Active IDE LLM" is a deliberate abstraction: peaks-loop itself
  *     has NO direct LLM API key. The chat call is performed by the
  *     active IDE (Claude Code / Trae / Cursor / Codex / ...) using
  *     its own authentication chain.

package/dist/src/services/memory/llm-reranker.js

@@ -8,7 +8,7 @@
  * Architecture note (locked decision — see
  * `.peaks/memory/2026-06-18-peaks-zvec-spike-proposal.md` §Y2):
  *
- *   - "Active IDE LLM" is a deliberate abstraction: peaks-cli itself
+ *   - "Active IDE LLM" is a deliberate abstraction: peaks-loop itself
  *     has NO direct LLM API key. The chat call is performed by the
  *     active IDE (Claude Code / Trae / Cursor / Codex / ...) using
  *     its own authentication chain.

package/dist/src/services/mut/production-stryker.d.ts

@@ -1,7 +1,2 @@
-/**
- * Production Stryker invoker. Uses @stryker-mutator/core programmatic API.
- * Note: this is a thin wrapper — actual Stryker invocation requires the
- * Stryker config in `stryker.conf.js` to live at the project root.
- */
 import type { StrykerInvoker } from './mut-runner.js';
 export declare function createProductionStrykerInvoker(): StrykerInvoker;