@winspan/claude-forge 9.2.0 → 9.12.0

package/dist/cli/commands/loop.js

@@ -0,0 +1,408 @@
+/**
+ * `cf loop` — goal-convergence orchestration loop (unattended/CI form).
+ *
+ * Spec: docs/design/2026-06-11/0943-loop-goal-convergence-spec.md (Option A)
+ * Decision: 1f9e71be
+ *
+ * `cf loop run` drives a CLI-resident state machine (src/core/loop/loop-engine.ts):
+ * implement (coder) → verify (verify-agent) → parse `## Verdict:` → converge on
+ * PASS/SKIP, iterate on FAIL, stop-safe on BLOCKED — bounded by hard guardrails
+ * (max-iter, token budget, irreversible-op gate, no-progress detector). The
+ * loop runs ENTIRELY in this CLI process, NEVER in the daemon (core-belief
+ * «daemon 永不加硬约束新智能»).
+ *
+ * Subcommands:
+ *   cf loop run     — drive the convergence loop (see flags below)
+ *   cf loop enable  — set loop.enabled=true
+ *   cf loop disable — set loop.enabled=false
+ *   cf loop status  — print current config + last run summary
+ *
+ * The interactive form (`--interactive`) shares the SAME engine but pauses for
+ * a keypress between iterations (Q5 resolved). The native `/loop` slash-command
+ * recipe + self-discipline defaults are documented in
+ * docs/architecture/governance.md §10 — both forms enforce one invariant.
+ */
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { mkdirSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+import { FORGE_PATHS, LOOP } from '../../core/constants.js';
+import { spawnClaudeCli } from '../../core/utils/claude-cli-spawn.js';
+import { runLoop, estimateTokens, } from '../../core/loop/loop-engine.js';
+import { runOutcome } from './decisions.js';
+// ── Config keys (default-OFF feature flag, spec §D4) ────────────────────────
+export const LOOP_CONFIG_KEYS = {
+    enabled: 'loop.enabled',
+    maxIterations: 'loop.max_iterations',
+    noProgressLimit: 'loop.no_progress_limit',
+    tokenBudget: 'loop.token_budget',
+    onIrreversible: 'loop.on_irreversible',
+    coderAgent: 'loop.coder_agent',
+    verifyAgent: 'loop.verify_agent',
+    /**
+     * decision e7d13697 (Option C) — gate for the advisory `[LOOP HINT]` the
+     * daemon mints when a prompt matches a whitelisted loop-suitable scenario.
+     * Default `true` (user opted in); set `false` to suppress without code change.
+     * Read by src/daemon/services/loop-hint.ts resolveLoopHintEnabled.
+     */
+    hintEnabled: 'loop.hint_enabled',
+};
+/** Seed all loop.* defaults (writeConfigIfMissing — never clobbers user edits). */
+export function seedLoopConfig(storage) {
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.enabled, 'false');
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.maxIterations, String(LOOP.MAX_ITERATIONS));
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.noProgressLimit, String(LOOP.NO_PROGRESS_LIMIT));
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.tokenBudget, String(LOOP.DEFAULT_TOKEN_BUDGET));
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.onIrreversible, 'stop');
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.coderAgent, 'coder');
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.verifyAgent, 'verify-agent');
+    // decision e7d13697 (Option C) — advisory loop hint default ON (user opted in).
+    storage.writeConfigIfMissing(LOOP_CONFIG_KEYS.hintEnabled, 'true');
+}
+function resolveIo(io) {
+    return {
+        log: io.log ?? ((m) => process.stdout.write(m + '\n')),
+        error: io.error ?? ((m) => process.stderr.write(m + '\n')),
+    };
+}
+function openStorage(injected) {
+    if (injected)
+        return { storage: injected, own: false };
+    return { storage: new SQLiteStorage(FORGE_PATHS.database()), own: true };
+}
+function readNum(raw, fallback) {
+    if (raw == null || raw === '')
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : fallback;
+}
+/**
+ * Resolve a {@link LoopConfig} from CLI flags merged over forge_config over
+ * constant defaults. Pure (given a storage to read config from). Exported for
+ * tests.
+ */
+export function resolveLoopConfig(flags, storage) {
+    const cfgMax = readNum(storage.readConfig(LOOP_CONFIG_KEYS.maxIterations), LOOP.MAX_ITERATIONS);
+    const cfgNoProg = readNum(storage.readConfig(LOOP_CONFIG_KEYS.noProgressLimit), LOOP.NO_PROGRESS_LIMIT);
+    const cfgBudgetRaw = storage.readConfig(LOOP_CONFIG_KEYS.tokenBudget);
+    const cfgOnIrr = storage.readConfig(LOOP_CONFIG_KEYS.onIrreversible) ?? 'stop';
+    const cfgCoder = storage.readConfig(LOOP_CONFIG_KEYS.coderAgent) ?? 'coder';
+    const cfgVerify = storage.readConfig(LOOP_CONFIG_KEYS.verifyAgent) ?? 'verify-agent';
+    // Token budget: flag > config > unset. Empty config string = unset.
+    let tokenBudget;
+    if (flags.tokenBudget != null && flags.tokenBudget !== '') {
+        tokenBudget = readNum(flags.tokenBudget, NaN);
+        if (!Number.isFinite(tokenBudget) || tokenBudget <= 0)
+            tokenBudget = undefined;
+    }
+    else if (cfgBudgetRaw != null && cfgBudgetRaw !== '') {
+        const n = Number(cfgBudgetRaw);
+        tokenBudget = Number.isFinite(n) && n > 0 ? n : undefined;
+    }
+    const onIrr = (flags.onIrreversible ?? cfgOnIrr) === 'skip' ? 'skip' : 'stop';
+    return {
+        goal: flags.goal ?? '',
+        maxIterations: flags.maxIterations != null && flags.maxIterations !== ''
+            ? readNum(flags.maxIterations, cfgMax)
+            : cfgMax,
+        tokenBudget,
+        noProgressLimit: flags.stallLimit != null && flags.stallLimit !== ''
+            ? readNum(flags.stallLimit, cfgNoProg)
+            : cfgNoProg,
+        onIrreversible: onIrr,
+        allowIrreversible: !!flags.allowIrreversible,
+        coderAgent: flags.coderAgent ?? cfgCoder,
+        verifyAgent: flags.verifyAgent ?? cfgVerify,
+        decisionId: flags.decisionId,
+        dryRun: !!flags.dryRun,
+    };
+}
+// ── Production deps (git + spawn + run-log + decisions) ─────────────────────
+function gitOut(args) {
+    try {
+        return execFileSync('git', args, { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Build the per-run JSONL run-log path. Default
+ * `~/.claude-forge/loop-runs/<ts>.jsonl`.
+ */
+export function defaultRunLogPath(now = new Date()) {
+    const ts = now.toISOString().replace(/[:.]/g, '-');
+    return join(FORGE_PATHS.loopRunsDir(), `${ts}.jsonl`);
+}
+/**
+ * Construct the production dependency seam. `decisionId` gates the final
+ * outcome backfill. Per-iteration notes go to the JSONL run-log (Q4: decisions
+ * `--note` does NOT work without `--result`, so notes are engine-local and the
+ * single final `cf decisions outcome --result` is the only decisions write).
+ */
+export function buildProdDeps(cfg, runLogPath, storage) {
+    try {
+        mkdirSync(join(runLogPath, '..'), { recursive: true });
+    }
+    catch { /* ignore */ }
+    return {
+        async spawnAgent({ agent, prompt }) {
+            let reported;
+            const text = await spawnClaudeCli({
+                agent,
+                prompt,
+                timeoutMs: LOOP.DEFAULT_TIMEOUT_MS,
+                onProgress: (ev) => {
+                    const raw = ev.raw;
+                    if (raw && raw.type === 'result' && raw.usage) {
+                        reported = (raw.usage.input_tokens ?? 0) + (raw.usage.output_tokens ?? 0);
+                    }
+                },
+            });
+            return { text, tokens: estimateTokens(reported, prompt, text) };
+        },
+        async gitDiffHash() {
+            const diff = gitOut(['diff', 'HEAD']);
+            return createHash('sha1').update(diff).digest('hex');
+        },
+        async gitHeadRef() {
+            return gitOut(['rev-parse', 'HEAD']);
+        },
+        appendRunLog(record) {
+            try {
+                appendFileSync(runLogPath, JSON.stringify(record) + '\n', 'utf-8');
+            }
+            catch { /* ignore */ }
+        },
+        writeIterationNote(note) {
+            // Q4 fallback: per-iteration notes are engine-local JSONL, NOT decisions
+            // rows (decisions --note requires --result).
+            try {
+                appendFileSync(runLogPath, JSON.stringify({ kind: 'note', note, ts: new Date().toISOString() }) + '\n', 'utf-8');
+            }
+            catch { /* ignore */ }
+        },
+        writeFinalOutcome(outcome, note) {
+            // Single explicit final backfill, attributed from the VERIFY VERDICT —
+            // never auto-inferred from a commit. runOutcome reuses the existing
+            // decisions CLI (no expansion).
+            if (!cfg.decisionId)
+                return;
+            try {
+                runOutcome({ id: cfg.decisionId, result: outcome, note }, {}, storage);
+            }
+            catch { /* best-effort; run-log already has the audit trail */ }
+        },
+    };
+}
+// ── Run-summary rendering ───────────────────────────────────────────────────
+export function renderRunSummary(cfg, result) {
+    const lines = [];
+    lines.push(`loop run: ${result.exitReason} (exit ${result.exitCode})`);
+    lines.push(`  goal:            ${cfg.goal}`);
+    lines.push(`  terminal verdict: ${result.terminalVerdict ?? 'none'}`);
+    lines.push(`  outcome:         ${result.outcome}`);
+    lines.push(`  iterations:      ${result.iterations.length} / ${cfg.maxIterations}`);
+    lines.push(`  total tokens:    ${result.totalTokens}${cfg.tokenBudget != null ? ` / ${cfg.tokenBudget}` : ''}`);
+    return lines.join('\n');
+}
+function renderDryRunPlan(cfg) {
+    const lines = [];
+    lines.push('loop run --dry-run (no agents spawned, no token spend):');
+    lines.push(`  goal:             ${cfg.goal}`);
+    lines.push(`  coder agent:      ${cfg.coderAgent}`);
+    lines.push(`  verify agent:     ${cfg.verifyAgent}`);
+    lines.push(`  max iterations:   ${cfg.maxIterations} (ceiling ${LOOP.MAX_ITERATIONS_HARD_CEILING})`);
+    lines.push(`  token budget:     ${cfg.tokenBudget ?? 'unset (max-iter bound only)'}`);
+    lines.push(`  no-progress limit: ${cfg.noProgressLimit}`);
+    lines.push(`  on irreversible:  ${cfg.allowIrreversible ? 'allow (override)' : cfg.onIrreversible}`);
+    lines.push(`  decision id:      ${cfg.decisionId ?? 'none (ad-hoc, no decisions write)'}`);
+    return lines.join('\n');
+}
+// ── Subcommand handlers (testable: return exit code, accept injected storage) ──
+/**
+ * `cf loop run` core. Returns the process exit code. The agent-spawning deps
+ * default to production; tests inject `depsOverride` to avoid real `claude`.
+ */
+export async function runLoopRun(flags, io = {}, injectedStorage, depsOverride, pauseFn) {
+    const { log, error } = resolveIo(io);
+    const { storage, own } = openStorage(injectedStorage);
+    try {
+        seedLoopConfig(storage);
+        // ── Default-OFF gate ──
+        const enabled = storage.readConfig(LOOP_CONFIG_KEYS.enabled) === 'true';
+        if (!enabled && !flags.force) {
+            error(`Error: loop is disabled (${LOOP_CONFIG_KEYS.enabled}=false). ` +
+                `Run \`cf loop enable\` or pass --force to run anyway.`);
+            return 1;
+        }
+        if (!flags.goal || flags.goal.trim() === '') {
+            error('Error: --goal <text> is required.');
+            return 1;
+        }
+        const cfg = resolveLoopConfig(flags, storage);
+        if (cfg.dryRun) {
+            if (flags.json) {
+                log(JSON.stringify({ dryRun: true, iterations: [], config: cfg }));
+            }
+            else {
+                log(renderDryRunPlan(cfg));
+            }
+            return 0;
+        }
+        const runLogPath = flags.runLog ?? defaultRunLogPath();
+        const deps = depsOverride ?? buildProdDeps(cfg, runLogPath, storage);
+        // Interactive form (Q5): same engine, pause for a keypress between
+        // iterations. `spawnAgent` IS awaited by the engine, so we wrap it: before
+        // each iteration's *coder* spawn (every iteration after the first) we await
+        // the keypress gate. This keeps the engine code byte-identical between the
+        // CI and interactive forms — the only difference is the injected deps.
+        let effectiveDeps = deps;
+        if (flags.interactive && pauseFn) {
+            const pause = pauseFn;
+            let coderSpawns = 0;
+            const wrapped = {
+                ...deps,
+                async spawnAgent(args) {
+                    const isCoder = !args.agent.includes('verify');
+                    if (isCoder) {
+                        // Pause before every coder spawn except the very first iteration.
+                        if (coderSpawns > 0)
+                            await pause();
+                        coderSpawns++;
+                    }
+                    return deps.spawnAgent(args);
+                },
+            };
+            effectiveDeps = wrapped;
+        }
+        const result = await runLoop(cfg, effectiveDeps);
+        if (flags.json) {
+            log(JSON.stringify(result));
+        }
+        else {
+            log(renderRunSummary(cfg, result));
+        }
+        return result.exitCode;
+    }
+    catch (err) {
+        error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    finally {
+        if (own)
+            storage.close();
+    }
+}
+export function runEnable(io = {}, injectedStorage) {
+    const { log } = resolveIo(io);
+    const { storage, own } = openStorage(injectedStorage);
+    try {
+        seedLoopConfig(storage);
+        storage.writeConfig(LOOP_CONFIG_KEYS.enabled, 'true');
+        log(`${LOOP_CONFIG_KEYS.enabled} = true — \`cf loop run\` is now permitted.`);
+        return 0;
+    }
+    finally {
+        if (own)
+            storage.close();
+    }
+}
+export function runDisable(io = {}, injectedStorage) {
+    const { log } = resolveIo(io);
+    const { storage, own } = openStorage(injectedStorage);
+    try {
+        seedLoopConfig(storage);
+        storage.writeConfig(LOOP_CONFIG_KEYS.enabled, 'false');
+        log(`${LOOP_CONFIG_KEYS.enabled} = false — \`cf loop run\` is now refused.`);
+        return 0;
+    }
+    finally {
+        if (own)
+            storage.close();
+    }
+}
+export function runStatus(io = {}, injectedStorage, json = false) {
+    const { log } = resolveIo(io);
+    const { storage, own } = openStorage(injectedStorage);
+    try {
+        seedLoopConfig(storage);
+        const config = Object.fromEntries(Object.values(LOOP_CONFIG_KEYS).map((k) => [k, storage.readConfig(k) ?? '']));
+        if (json) {
+            log(JSON.stringify({ config }));
+        }
+        else {
+            log('loop config:');
+            for (const [k, v] of Object.entries(config)) {
+                log(`  ${k} = ${v}`);
+            }
+        }
+        return 0;
+    }
+    finally {
+        if (own)
+            storage.close();
+    }
+}
+// ── Interactive keypress pause (production) ─────────────────────────────────
+function keypressPause() {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question('  [interactive] press Enter for next iteration... ', () => {
+            rl.close();
+            resolve();
+        });
+    });
+}
+// ── Commander wiring ────────────────────────────────────────────────────────
+export function register(program) {
+    const loop = program
+        .command('loop')
+        .description('Goal-convergence orchestration loop (implement→verify→iterate until PASS)');
+    loop
+        .command('run')
+        .description('Drive the convergence loop (CLI-resident; default-OFF, irreversible-gated)')
+        .requiredOption('--goal <text>', 'The goal to converge toward')
+        .option('--decision-id <8hex>', 'Decision id the loop implements (for final outcome backfill)')
+        .option('--max-iterations <n>', `Hard iteration cap (default ${LOOP.MAX_ITERATIONS}, ceiling ${LOOP.MAX_ITERATIONS_HARD_CEILING})`)
+        .option('--token-budget <n>', `Cumulative token cap (default ${LOOP.DEFAULT_TOKEN_BUDGET}; empty = max-iter bound only)`)
+        // NOTE: must NOT be named `--no-progress-limit` — commander treats a
+        // `--no-<x>` prefix as the negation of a boolean `--<x>` flag and swallows
+        // the value. `--stall-limit` is the public name; it maps to the
+        // `loop.no_progress_limit` config / `noProgressLimit` engine field.
+        .option('--stall-limit <k>', `Consecutive no-diff FAIL iterations before stall-stop (default ${LOOP.NO_PROGRESS_LIMIT})`)
+        .option('--allow-irreversible', 'Proceed past the irreversible-op gate (opt-in; default OFF = stop)')
+        .option('--on-irreversible <stop|skip>', 'When the gate fires: stop the loop (default) or skip the op and continue')
+        .option('--coder-agent <name>', 'Implementation agent to drive (default coder)')
+        .option('--verify-agent <name>', 'Verifier agent to drive (default verify-agent)')
+        .option('--interactive', 'Pause for a keypress between iterations (shares the same engine)')
+        .option('--dry-run', 'Print the planned config/prompts WITHOUT spawning any agent')
+        .option('--json', 'Emit the final run summary as JSON')
+        .option('--run-log <path>', 'JSONL run-log path (default ~/.claude-forge/loop-runs/<ts>.jsonl)')
+        .option('--force', 'Run even when loop.enabled=false')
+        .action(async (opts) => {
+        process.exitCode = await runLoopRun(opts, {}, undefined, undefined, keypressPause);
+    });
+    loop
+        .command('enable')
+        .description('Enable the loop capability (loop.enabled=true)')
+        .action(() => {
+        process.exitCode = runEnable();
+    });
+    loop
+        .command('disable')
+        .description('Disable the loop capability (loop.enabled=false)')
+        .action(() => {
+        process.exitCode = runDisable();
+    });
+    loop
+        .command('status')
+        .description('Print current loop config')
+        .option('--json', 'Output JSON')
+        .action((opts) => {
+        process.exitCode = runStatus({}, undefined, !!opts.json);
+    });
+}
+//# sourceMappingURL=loop.js.map

package/dist/cli/commands/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/cli/commands/loop.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/maintenance.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `cf maintenance` — manual maintenance utilities (decision c425f26f, Batch 2).
+ *
+ * Boot-time migrations already run idempotent backfills automatically
+ * (runPostMigrations). This command surfaces the same engine for manual reruns
+ * when the backfill window is widened, a daemon boot was missed, or an operator
+ * just wants a deterministic re-sweep — without restarting the daemon.
+ *
+ * Subcommands:
+ *   cf maintenance backfill-spawn-fields
+ *     Re-run the events.decision_id / events.subagent_type plaintext backfill
+ *     (storage.backfillEventsDecisionId). Idempotent: a second run reports
+ *     `0 rows` once every in-window spawn already has its plaintext columns.
+ *     This is the gzip one-way-door fix's manual fallback — it decodes each
+ *     in-window spawn's gzip tool_input ONCE and writes the extracted
+ *     decision_id / subagent_type to plaintext columns.
+ */
+import type { Command } from 'commander';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+export interface BackfillSpawnFieldsOptions {
+    json?: boolean;
+    /** Test override: storage instance (otherwise opens the live DB). */
+    storage?: Pick<SQLiteStorage, 'backfillEventsDecisionId' | 'close'>;
+    /** Test override: stdout writer. */
+    out?: (s: string) => void;
+}
+/**
+ * Run the spawn-fields backfill. Returns the process exit code (0 = success).
+ * Pure-ish: storage + writer are injectable for unit tests.
+ */
+export declare function runBackfillSpawnFields(opts?: BackfillSpawnFieldsOptions): number;
+export declare function register(program: Command): void;
+//# sourceMappingURL=maintenance.d.ts.map

package/dist/cli/commands/maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,0BAA0B,GAAG,OAAO,CAAC,CAAC;IACpE,oCAAoC;IACpC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,0BAA+B,GAAG,MAAM,CA+BpF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY/C"}

package/dist/cli/commands/maintenance.js

@@ -0,0 +1,75 @@
+/**
+ * `cf maintenance` — manual maintenance utilities (decision c425f26f, Batch 2).
+ *
+ * Boot-time migrations already run idempotent backfills automatically
+ * (runPostMigrations). This command surfaces the same engine for manual reruns
+ * when the backfill window is widened, a daemon boot was missed, or an operator
+ * just wants a deterministic re-sweep — without restarting the daemon.
+ *
+ * Subcommands:
+ *   cf maintenance backfill-spawn-fields
+ *     Re-run the events.decision_id / events.subagent_type plaintext backfill
+ *     (storage.backfillEventsDecisionId). Idempotent: a second run reports
+ *     `0 rows` once every in-window spawn already has its plaintext columns.
+ *     This is the gzip one-way-door fix's manual fallback — it decodes each
+ *     in-window spawn's gzip tool_input ONCE and writes the extracted
+ *     decision_id / subagent_type to plaintext columns.
+ */
+import chalk from 'chalk';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+import { FORGE_PATHS } from '../../core/constants.js';
+/**
+ * Run the spawn-fields backfill. Returns the process exit code (0 = success).
+ * Pure-ish: storage + writer are injectable for unit tests.
+ */
+export function runBackfillSpawnFields(opts = {}) {
+    const out = opts.out ?? ((s) => process.stdout.write(s + '\n'));
+    const own = !opts.storage;
+    const storage = opts.storage ?? new SQLiteStorage(FORGE_PATHS.database());
+    try {
+        const rows = storage.backfillEventsDecisionId();
+        if (opts.json) {
+            out(JSON.stringify({ ok: true, backfilled: rows }));
+        }
+        else if (rows > 0) {
+            out(chalk.green(`Backfilled ${rows} spawn row(s) (decision_id / subagent_type plaintext columns).`));
+        }
+        else {
+            out(chalk.gray('Backfilled 0 rows — all in-window spawns already have plaintext columns (idempotent).'));
+        }
+        return 0;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) {
+            out(JSON.stringify({ ok: false, error: msg }));
+        }
+        else {
+            out(chalk.red(`backfill-spawn-fields failed: ${msg}`));
+        }
+        return 1;
+    }
+    finally {
+        if (own && 'close' in storage) {
+            try {
+                storage.close();
+            }
+            catch {
+                /* ignore close errors */
+            }
+        }
+    }
+}
+export function register(program) {
+    const maintenance = program
+        .command('maintenance')
+        .description('Manual maintenance utilities (idempotent backfills, re-sweeps)');
+    maintenance
+        .command('backfill-spawn-fields')
+        .description('Re-run the events.decision_id / subagent_type plaintext backfill (idempotent fallback)')
+        .option('--json', 'Emit the result as JSON')
+        .action((opts) => {
+        process.exitCode = runBackfillSpawnFields({ json: opts.json });
+    });
+}
+//# sourceMappingURL=maintenance.js.map

package/dist/cli/commands/maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../../src/cli/commands/maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAUtD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmC,EAAE;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,IAAI,gEAAgE,CAAC,CAAC,CAAC;QACvG,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uFAAuF,CAAC,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,IAAI,GAAG,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,gEAAgE,CAAC,CAAC;IAEjF,WAAW;SACR,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,wFAAwF,CAAC;SACrG,MAAM,CAAC,QAAQ,EAAE,yBAAyB,CAAC;SAC3C,MAAM,CAAC,CAAC,IAAwB,EAAE,EAAE;QACnC,OAAO,CAAC,QAAQ,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/mcp.d.ts

@@ -31,6 +31,29 @@ export declare function isMcpRegistered(): {
  * 获取 daemon 的 MCP server URL
  */
 export declare function getMcpServerUrl(): string;
+/**
+ * 检测「localhost 流量被 HTTP(S)_PROXY 劫持」的环境陷阱。
+ *
+ * 背景（root cause, 2026-06-09）：claude-forge MCP server 跑在 127.0.0.1 上，
+ * 但官方 `claude` 客户端在做 MCP health-check 时会遵守 `HTTP_PROXY` /
+ * `HTTPS_PROXY` / `ALL_PROXY` 环境变量。如果这些变量指向一个外部代理而
+ * `NO_PROXY` 又没排除 localhost，客户端的 `fetch` 会把对 `http://127.0.0.1:<port>/mcp`
+ * 的连接发到外部代理（外部代理无法回环到用户本机的 127.0.0.1），于是
+ * `claude mcp list` 报 `✘ Failed to connect`——但此时根本没有 TCP 连接到达
+ * daemon，端点本身是健康的。设了 `NO_PROXY=127.0.0.1,localhost,::1` 即恢复
+ * `✔ Connected`。
+ *
+ * 这个 helper 是纯函数（读环境变量，无副作用），返回 null 表示无冲突，
+ * 否则返回提示文案（caller 决定如何展示）。
+ *
+ * @param env 环境变量快照（默认 process.env，便于测试注入）
+ * @param mcpUrl MCP server URL（默认从 config 推导）
+ */
+export declare function detectLocalhostProxyConflict(env?: NodeJS.ProcessEnv, mcpUrl?: string): {
+    proxyVar: string;
+    proxyValue: string;
+    hint: string;
+} | null;
 /**
  * 注册 cf mcp 命令组
  */

package/dist/cli/commands/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAeD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAYvE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAkJD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoB/C"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAeD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAYvE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,MAA0B,GACjC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuD/D;AAmKD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoB/C"}