@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/core/utils/claude-cli-spawn.d.ts

@@ -0,0 +1,106 @@
+/**
+ * claude-cli-spawn.ts — Public helper for spawning the `claude` CLI,
+ * parsing the stream-json output across CLI versions, and returning the
+ * raw assistant text.
+ *
+ * Origin: extracted from `src/skills/distill/distiller.ts`
+ * (spec 1851 R-B commit `03fbda1d`) so multiple call-sites (claudemd,
+ * knowledge build, patch web, …) can share the same plumbing instead of
+ * each re-implementing spawn + JSON merge + timeout + cancel.
+ *
+ * Spec: docs/design/2026-05-29/0902-ai-config-removal-master-spec.md §2.6
+ * Decision: f5a5b030 (Option B — claude CLI shell-out everywhere)
+ *
+ * OAuth / `--bare` history (2026-05-29):
+ *  - The CLI's `--bare` flag skips Keychain reads and forces auth via
+ *    `ANTHROPIC_API_KEY` only. Subscription users (no API key) hit an
+ *    immediate "Not logged in" failure under `--bare`. The distiller hit
+ *    this first (fixed in commit `6b02f87b`); this shared helper hit the
+ *    same bug for `cf claudemd`, `cf knowledge build`, `cf patch` etc.
+ *  - Fix mirrors the distiller: default `bareMode` is now `false`, and
+ *    daemon-recursion (spawned child's hooks firing back into the daemon)
+ *    is broken by setting `CLAUDE_FORGE_INTERNAL_SPAWN=1` on the child
+ *    env. Every entry-point hook short-circuits when EITHER
+ *    `CLAUDE_FORGE_INTERNAL_SPAWN` or `CLAUDE_FORGE_DISTILL_SPAWN`
+ *    (legacy) is non-empty. See src/hooks/*.sh.
+ *
+ * Design notes:
+ *  - We do NOT couple to envelope parsing. Each caller defines its own
+ *    `---X---...---END---` envelope (SKILL / SKIP / CLAUDEMD / PATCH …) and
+ *    parses the returned string itself.
+ *  - The CLI's stream-json schema differs between Claude Code versions; the
+ *    merge accepts the union of common shapes (assistant_message /
+ *    content_block_delta / message_delta / text_delta / result).
+ *  - `findClaudeBin` is reused from `src/skills/distill/claude-cli-resolver.ts`
+ *    (do not duplicate — both call sites must hit the same 5-min PATH cache).
+ */
+export interface ClaudeCliProgressEvent {
+    /** Event type as reported by the CLI (e.g. `content_block_delta`). */
+    type: string;
+    /** Running total of assistant text characters accumulated so far. */
+    charCount?: number;
+    /** Raw JSON event for callers that want to inspect everything. */
+    raw?: unknown;
+}
+export interface ClaudeCliSpawnOpts {
+    /** Sub-agent name passed to `--agent <name>`. */
+    agent: string;
+    /** Text sent to the spawned `claude` process via stdin. */
+    prompt: string;
+    /**
+     * Pass `--bare` (skip hooks/LSP/auto-memory/MCP).  Default: `false`.
+     *
+     * IMPORTANT: `--bare` also forces auth via `ANTHROPIC_API_KEY` only and
+     * skips Keychain reads, so subscription users (no API key) get
+     * "Not logged in" instantly. Daemon-recursion is instead broken via the
+     * `CLAUDE_FORGE_INTERNAL_SPAWN=1` env we always set on the child — every
+     * entry-point hook short-circuits when this env is non-empty. Only set
+     * `bareMode: true` when you explicitly want a hermetic headless run AND
+     * have `ANTHROPIC_API_KEY` exported (CI / batch tooling).
+     */
+    bareMode?: boolean;
+    /**
+     * Allowed tool list forwarded as `--allowedTools "Tool1 Tool2"`.  Default
+     * empty (CLI uses agent's own `tools:` frontmatter).
+     */
+    allowedTools?: string[];
+    /** Aborts the subprocess on `signal.abort()` (sends SIGTERM). */
+    cancelSignal?: AbortSignal;
+    /** Hard timeout in ms.  Default: 600 000 (10 min, same as distiller). */
+    timeoutMs?: number;
+    /** Streaming progress hook invoked for every parsed stream-json line. */
+    onProgress?: (event: ClaudeCliProgressEvent) => void;
+    /** Optional override for the `claude` binary path (else PATH probe). */
+    claudeBin?: string;
+}
+export declare class ClaudeCliMissingError extends Error {
+    constructor();
+}
+export declare class ClaudeCliExitError extends Error {
+    readonly exitCode: number;
+    readonly stderrSnippet: string;
+    constructor(exitCode: number, stderr: string);
+}
+export declare class ClaudeCliTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+export declare class ClaudeCliCancelledError extends Error {
+    constructor();
+}
+/**
+ * Spawn `claude -p --agent <name> [--bare] --output-format stream-json
+ *   --verbose --include-partial-messages --input-format text
+ *   [--allowedTools "..."]`
+ * with the given prompt on stdin, then collect the assistant's text from
+ * the stream-json output.
+ *
+ * `--bare` is opt-in (`bareMode: true`); the default keeps OAuth Keychain
+ * reads working for subscription users. Recursion is broken via the
+ * `CLAUDE_FORGE_INTERNAL_SPAWN=1` env we set on the child.
+ *
+ * Returns the raw assistant text (the caller is responsible for envelope
+ * parsing, e.g. `parseSkillBlock` / `parseClaudeMdBlock`).
+ */
+export declare function spawnClaudeCli(opts: ClaudeCliSpawnOpts): Promise<string>;
+//# sourceMappingURL=claude-cli-spawn.d.ts.map

package/dist/core/utils/claude-cli-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli-spawn.d.ts","sourceRoot":"","sources":["../../../src/core/utils/claude-cli-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAOH,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACrD,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;;CAO/C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBACnB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,SAAS,EAAE,MAAM;CAK9B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgI9E"}

package/dist/core/utils/claude-cli-spawn.js

@@ -0,0 +1,219 @@
+/**
+ * claude-cli-spawn.ts — Public helper for spawning the `claude` CLI,
+ * parsing the stream-json output across CLI versions, and returning the
+ * raw assistant text.
+ *
+ * Origin: extracted from `src/skills/distill/distiller.ts`
+ * (spec 1851 R-B commit `03fbda1d`) so multiple call-sites (claudemd,
+ * knowledge build, patch web, …) can share the same plumbing instead of
+ * each re-implementing spawn + JSON merge + timeout + cancel.
+ *
+ * Spec: docs/design/2026-05-29/0902-ai-config-removal-master-spec.md §2.6
+ * Decision: f5a5b030 (Option B — claude CLI shell-out everywhere)
+ *
+ * OAuth / `--bare` history (2026-05-29):
+ *  - The CLI's `--bare` flag skips Keychain reads and forces auth via
+ *    `ANTHROPIC_API_KEY` only. Subscription users (no API key) hit an
+ *    immediate "Not logged in" failure under `--bare`. The distiller hit
+ *    this first (fixed in commit `6b02f87b`); this shared helper hit the
+ *    same bug for `cf claudemd`, `cf knowledge build`, `cf patch` etc.
+ *  - Fix mirrors the distiller: default `bareMode` is now `false`, and
+ *    daemon-recursion (spawned child's hooks firing back into the daemon)
+ *    is broken by setting `CLAUDE_FORGE_INTERNAL_SPAWN=1` on the child
+ *    env. Every entry-point hook short-circuits when EITHER
+ *    `CLAUDE_FORGE_INTERNAL_SPAWN` or `CLAUDE_FORGE_DISTILL_SPAWN`
+ *    (legacy) is non-empty. See src/hooks/*.sh.
+ *
+ * Design notes:
+ *  - We do NOT couple to envelope parsing. Each caller defines its own
+ *    `---X---...---END---` envelope (SKILL / SKIP / CLAUDEMD / PATCH …) and
+ *    parses the returned string itself.
+ *  - The CLI's stream-json schema differs between Claude Code versions; the
+ *    merge accepts the union of common shapes (assistant_message /
+ *    content_block_delta / message_delta / text_delta / result).
+ *  - `findClaudeBin` is reused from `src/skills/distill/claude-cli-resolver.ts`
+ *    (do not duplicate — both call sites must hit the same 5-min PATH cache).
+ */
+import { spawn } from 'node:child_process';
+import { findClaudeBin } from '../../skills/distill/claude-cli-resolver.js';
+export class ClaudeCliMissingError extends Error {
+    constructor() {
+        super('[claude-cli-spawn] claude CLI not found on PATH. Install via `brew install claude` or `npm i -g @anthropic-ai/claude-code`.');
+        this.name = 'ClaudeCliMissingError';
+    }
+}
+export class ClaudeCliExitError extends Error {
+    exitCode;
+    stderrSnippet;
+    constructor(exitCode, stderr) {
+        super(`[claude-cli-spawn] claude CLI exited ${exitCode}: ${stderr.slice(0, 500)}`);
+        this.name = 'ClaudeCliExitError';
+        this.exitCode = exitCode;
+        this.stderrSnippet = stderr.slice(0, 500);
+    }
+}
+export class ClaudeCliTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`[claude-cli-spawn] claude CLI timeout after ${timeoutMs}ms`);
+        this.name = 'ClaudeCliTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class ClaudeCliCancelledError extends Error {
+    constructor() {
+        super('[claude-cli-spawn] cancelled by user');
+        this.name = 'ClaudeCliCancelledError';
+    }
+}
+// ── Implementation ────────────────────────────────────────────────────────
+const DEFAULT_TIMEOUT_MS = 600_000;
+/**
+ * Spawn `claude -p --agent <name> [--bare] --output-format stream-json
+ *   --verbose --include-partial-messages --input-format text
+ *   [--allowedTools "..."]`
+ * with the given prompt on stdin, then collect the assistant's text from
+ * the stream-json output.
+ *
+ * `--bare` is opt-in (`bareMode: true`); the default keeps OAuth Keychain
+ * reads working for subscription users. Recursion is broken via the
+ * `CLAUDE_FORGE_INTERNAL_SPAWN=1` env we set on the child.
+ *
+ * Returns the raw assistant text (the caller is responsible for envelope
+ * parsing, e.g. `parseSkillBlock` / `parseClaudeMdBlock`).
+ */
+export async function spawnClaudeCli(opts) {
+    const claudeBin = opts.claudeBin ?? findClaudeBin();
+    if (!claudeBin)
+        throw new ClaudeCliMissingError();
+    const args = [
+        '-p',
+        '--agent', opts.agent,
+    ];
+    if (opts.bareMode === true)
+        args.push('--bare');
+    args.push('--output-format', 'stream-json', 
+    // claude CLI rejects `--print --output-format=stream-json` without --verbose:
+    // "When using --print, --output-format=stream-json requires --verbose".
+    // Same regression as spec 1443 (commit b2e87f45) for distiller.ts; the
+    // 2026-05-29 shared-helper extraction missed this flag.
+    '--verbose', '--include-partial-messages', '--input-format', 'text');
+    if (opts.allowedTools && opts.allowedTools.length > 0) {
+        args.push('--allowedTools', opts.allowedTools.join(' '));
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(claudeBin, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                // Recursion guard: every entry-point hook in src/hooks/*.sh
+                // short-circuits when this env is non-empty, preventing the spawned
+                // claude subprocess from firing its hooks back into the daemon.
+                CLAUDE_FORGE_INTERNAL_SPAWN: '1',
+            },
+        });
+        let assistantText = '';
+        let stderr = '';
+        let buffer = '';
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            fn();
+        };
+        const cancelHandler = () => {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            settle(() => reject(new ClaudeCliCancelledError()));
+        };
+        opts.cancelSignal?.addEventListener('abort', cancelHandler);
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const timeoutId = setTimeout(() => {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            settle(() => reject(new ClaudeCliTimeoutError(timeoutMs)));
+        }, timeoutMs);
+        child.stdout.on('data', (chunk) => {
+            buffer += chunk.toString('utf-8');
+            let nl;
+            while ((nl = buffer.indexOf('\n')) >= 0) {
+                const line = buffer.slice(0, nl).trim();
+                buffer = buffer.slice(nl + 1);
+                if (!line)
+                    continue;
+                try {
+                    const ev = JSON.parse(line);
+                    const before = assistantText.length;
+                    // CLI stream-json event shapes vary across versions; accept the
+                    // union of common forms and extract any text we can find.
+                    if (ev.type === 'assistant' || ev.type === 'assistant_message') {
+                        const content = ev.content;
+                        if (Array.isArray(content)) {
+                            for (const c of content) {
+                                if (c && typeof c === 'object' && typeof c.text === 'string') {
+                                    assistantText += c.text;
+                                }
+                            }
+                        }
+                        else if (typeof ev.text === 'string') {
+                            assistantText += ev.text;
+                        }
+                    }
+                    else if (ev.type === 'content_block_delta') {
+                        const delta = ev.delta;
+                        if (delta && typeof delta.text === 'string')
+                            assistantText += delta.text;
+                    }
+                    else if (ev.type === 'message_delta' || ev.type === 'text_delta') {
+                        const delta = ev.delta;
+                        if (typeof delta === 'string')
+                            assistantText += delta;
+                    }
+                    else if (ev.type === 'result') {
+                        const result = ev.result;
+                        if (typeof result === 'string' && !assistantText)
+                            assistantText = result;
+                    }
+                    // Always notify caller, even when no text was extracted from this
+                    // line (callers use the event types for spinner / SSE bridging).
+                    void before;
+                    opts.onProgress?.({
+                        type: ev.type ?? 'unknown',
+                        charCount: assistantText.length,
+                        raw: ev,
+                    });
+                }
+                catch {
+                    // Ignore non-JSON lines — stream-json normally never emits them,
+                    // but defensive against partial buffering bugs in older CLI builds.
+                }
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString('utf-8');
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeoutId);
+            opts.cancelSignal?.removeEventListener('abort', cancelHandler);
+            if (code === 0) {
+                settle(() => resolve(assistantText));
+            }
+            else {
+                settle(() => reject(new ClaudeCliExitError(code ?? -1, stderr)));
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timeoutId);
+            opts.cancelSignal?.removeEventListener('abort', cancelHandler);
+            settle(() => reject(new Error(`[claude-cli-spawn] claude CLI spawn error: ${err.message}`)));
+        });
+        child.stdin.write(opts.prompt);
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=claude-cli-spawn.js.map

package/dist/core/utils/claude-cli-spawn.js.map

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

package/dist/core/utils/forge-resume-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forge-resume-block.d.ts","sourceRoot":"","sources":["../../../src/core/utils/forge-resume-block.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED,mBAAmB;AACnB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc1E"}
+{"version":3,"file":"forge-resume-block.d.ts","sourceRoot":"","sources":["../../../src/core/utils/forge-resume-block.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED,mBAAmB;AACnB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc1E"}

package/dist/core/utils/forge-resume-block.js

@@ -6,6 +6,7 @@
  * - 检测：`hasForgeResumeBlock`（含旧版 `<!-- forge:resume -->` 与新版 begin 标记）
  */
 import { randomUUID } from 'crypto';
+import { formatLocalDisplay } from './time.js';
 /** 旧版续接块（正文裸放，易被 HTML 注释子串破坏） */
 const LEGACY_RESUME_BLOCK_RE = /\n*<!-- forge:resume -->[\s\S]*?<!-- forge:end-resume -->\s*/g;
 /** forge:resume-begin / end 之间的 UUID（randomUUID 小写） */
@@ -18,7 +19,7 @@ function scopedResumeBlockRe() {
  */
 export function buildForgeResumeEnvelope(innerUtf8Markdown) {
     const id = randomUUID();
-    const iso = new Date().toISOString();
+    const stamp = formatLocalDisplay(Date.now());
     const body = innerUtf8Markdown.trim();
     return [
         `<!-- forge:resume-begin:${id} -->`,
@@ -26,7 +27,7 @@ export function buildForgeResumeEnvelope(innerUtf8Markdown) {
         body,
         '```',
         '',
-        `_生成时间: ${iso}_`,
+        `_生成时间: ${stamp}_`,
         `<!-- forge:resume-end:${id} -->`,
     ].join('\n');
 }

package/dist/core/utils/forge-resume-block.js.map

@@ -1 +1 @@
-{"version":3,"file":"forge-resume-block.js","sourceRoot":"","sources":["../../../src/core/utils/forge-resume-block.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,iCAAiC;AACjC,MAAM,sBAAsB,GAAG,+DAA+D,CAAC;AAE/F,uDAAuD;AACvD,MAAM,WAAW,GAAG,8DAA8D,CAAC;AAEnF,SAAS,mBAAmB;IAC1B,OAAO,IAAI,MAAM,CACf,gCAAgC,WAAW,kDAAkD,EAC7F,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,iBAAyB;IAChE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAEtC,OAAO;QACL,2BAA2B,EAAE,MAAM;QACnC,sBAAsB;QACtB,IAAI;QACJ,KAAK;QACL,EAAE;QACF,UAAU,GAAG,GAAG;QAChB,yBAAyB,EAAE,MAAM;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACzC,IAAI,MAAM,CAAC,2BAA2B,WAAW,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CACvE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAC/B,IAAI,MAAM,CAAC,2BAA2B,WAAW,oEAAoE,WAAW,MAAM,CAAC,CACxI,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"forge-resume-block.js","sourceRoot":"","sources":["../../../src/core/utils/forge-resume-block.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,iCAAiC;AACjC,MAAM,sBAAsB,GAAG,+DAA+D,CAAC;AAE/F,uDAAuD;AACvD,MAAM,WAAW,GAAG,8DAA8D,CAAC;AAEnF,SAAS,mBAAmB;IAC1B,OAAO,IAAI,MAAM,CACf,gCAAgC,WAAW,kDAAkD,EAC7F,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,iBAAyB;IAChE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAEtC,OAAO;QACL,2BAA2B,EAAE,MAAM;QACnC,sBAAsB;QACtB,IAAI;QACJ,KAAK;QACL,EAAE;QACF,UAAU,KAAK,GAAG;QAClB,yBAAyB,EAAE,MAAM;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACzC,IAAI,MAAM,CAAC,2BAA2B,WAAW,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CACvE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAC/B,IAAI,MAAM,CAAC,2BAA2B,WAAW,oEAAoE,WAAW,MAAM,CAAC,CACxI,CAAC;IACF,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/core/utils/logger.d.ts

@@ -15,8 +15,20 @@ export declare const logger: {
 };
 export declare function setLogLevel(level: LogLevel): void;
 /**
- * Enable file logging (for daemon mode)
- * @param filePath Path to log file
+ * Enable file logging (for daemon mode).
+ *
+ * @param filePath Path to log file. Pass `null` to disable file logging and
+ *                 restore stderr-only output (used by tests / shutdown paths).
+ *
+ * Wiring contract (Stage D, 2026-05-27): the daemon entrypoint
+ * (`src/daemon/index.ts`) MUST call this once with `FORGE_PATHS.daemonLog()`
+ * before any `logger.info/debug/warn/error` call. Without the wire-call the
+ * logger silently writes to stderr only, which is redirected to `/dev/null`
+ * in detached production daemon mode — making all subsystem startup logs
+ * (ConfigStore.seedDefaults, InterceptRevive, Storage init, IntentEngine
+ * probe, etc.) disappear from disk. See
+ * `docs/implementation/2026-05-27/HHMM-stage-d-file-logging-wire-changelog.md`
+ * for the root-cause trace.
  */
-export declare function enableFileLogging(filePath: string): void;
+export declare function enableFileLogging(filePath: string | null): void;
 //# sourceMappingURL=logger.d.ts.map

package/dist/core/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAyFD,eAAO,MAAM,MAAM;mBACF,MAAM,GAAG,IAAI;kBAId,MAAM,GAAG,IAAI;kBAIb,MAAM,GAAG,IAAI;mBAIZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMxD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAyFD,eAAO,MAAM,MAAM;mBACF,MAAM,GAAG,IAAI;kBAId,MAAM,GAAG,IAAI;kBAIb,MAAM,GAAG,IAAI;mBAIZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAY/D"}

package/dist/core/utils/logger.js

@@ -111,10 +111,28 @@ export function setLogLevel(level) {
     currentLevel = level;
 }
 /**
- * Enable file logging (for daemon mode)
- * @param filePath Path to log file
+ * Enable file logging (for daemon mode).
+ *
+ * @param filePath Path to log file. Pass `null` to disable file logging and
+ *                 restore stderr-only output (used by tests / shutdown paths).
+ *
+ * Wiring contract (Stage D, 2026-05-27): the daemon entrypoint
+ * (`src/daemon/index.ts`) MUST call this once with `FORGE_PATHS.daemonLog()`
+ * before any `logger.info/debug/warn/error` call. Without the wire-call the
+ * logger silently writes to stderr only, which is redirected to `/dev/null`
+ * in detached production daemon mode — making all subsystem startup logs
+ * (ConfigStore.seedDefaults, InterceptRevive, Storage init, IntentEngine
+ * probe, etc.) disappear from disk. See
+ * `docs/implementation/2026-05-27/HHMM-stage-d-file-logging-wire-changelog.md`
+ * for the root-cause trace.
  */
 export function enableFileLogging(filePath) {
+    if (filePath === null) {
+        logFilePath = null;
+        lastSizeCheck = 0;
+        cachedSize = 0;
+        return;
+    }
     logFilePath = filePath;
     const dir = path.dirname(filePath);
     if (!fs.existsSync(dir)) {

package/dist/core/utils/logger.js.map

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

package/dist/core/utils/noise-prompt.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Noise-prompt detection utility.
+ *
+ * Several daemon services need to detect when a `user_prompt` (or task title)
+ * is actually a tool-generated envelope rather than real human input:
+ *   - `<task-notification>`, `<system-reminder>`, `<local-command-stdout>`,
+ *     `<command-message>`, `<command-name>`, `[Image #N]`
+ *
+ * These envelopes ride the same UserPromptSubmit hook as real prompts because
+ * Claude Code pipes framework reminders through it. Each consumer's reaction
+ * to noise differs (skip auto-spec, skip task creation, filter resume render),
+ * so behavior decisions stay at the call site; this module just answers the
+ * question "is this prompt noise?".
+ *
+ * This file is the single source of truth for the prefix list — it is
+ * intentionally placed under `core/utils/` so non-daemon code (claudemd
+ * resume-manager etc.) can import without depending on `daemon/services/`.
+ *
+ * `daemon/services/violation-reporter.ts` re-exports {@link NOISE_PROMPT_PREFIXES}
+ * under its historical name `TOOL_MESSAGE_PREFIXES` for back-compat with
+ * existing tests and call sites.
+ */
+/**
+ * Prompt-text prefixes that identify tool-generated or system messages
+ * masquerading as `user_prompt` rows. These must not be scanned for
+ * violation keywords / auto-spec triggers / task creation because they
+ * reflect agent reports / image attachments / framework reminders, not the
+ * human's actual prompt.
+ *
+ * Extending the list: add the new prefix here and add a unit test in
+ * `noise-prompt.test.ts`. Do NOT re-declare this list anywhere else.
+ */
+export declare const NOISE_PROMPT_PREFIXES: ReadonlyArray<string>;
+/**
+ * True if `text` (trimStart'd) starts with any known tool/system envelope
+ * prefix. Returns false for empty/undefined input (callers that want to treat
+ * empty as noise should handle it themselves — see `resume-manager.ts`).
+ *
+ * Envelope-with-content rule: when the prefix is followed by a newline and
+ * substantive text (trimmed length >= 3), the prompt is NOT considered noise.
+ * Example: "[Image #2]\n这个任务为什么没有在管理后台显示？" → false.
+ * Pure envelopes (no newline, or only whitespace after newline) → true.
+ *
+ * @deprecated since 2026-06-01 (spec b1480935 Option A). Prefer
+ * {@link classifyPromptKind} which returns granular kind labels
+ * (`'agent-callback'` / `'image'` / `'system'` / `'user'`). Kept as a read-side
+ * fallback during migration; `task-segmenter` no longer short-circuits on
+ * noise — every prompt now flows through createTask with a kind tag.
+ */
+export declare function isNoisePrompt(text: string | undefined | null): boolean;
+/**
+ * Possible task-kind classifications for a UserPromptSubmit payload (spec
+ * b1480935 Option A, 2026-06-01).
+ *
+ * - `user`           : real human prompt (the default)
+ * - `agent-callback` : `<task-notification>` envelope emitted after a
+ *                      sub-agent finishes
+ * - `image`          : `[Image #N]` attachment marker with no substantive
+ *                      caption (an envelope-only image; image-with-caption
+ *                      stays `user` per the substantive-content rule below)
+ * - `system`         : framework envelopes (`<system-reminder>`,
+ *                      `<local-command-stdout>`, `<command-message>`,
+ *                      `<command-name>`)
+ */
+export type PromptKind = 'user' | 'agent-callback' | 'image' | 'system';
+/**
+ * Single-prefix kind map. Used by {@link classifyPromptKind} and by the
+ * boot-time backfill (see `core/storage/base.ts`) so the same prefix → kind
+ * decision is made in TWO places without re-encoding the rule per consumer.
+ *
+ * Order matters only for backfill SQL readability — JS `for...of` iteration
+ * is stable.
+ */
+export declare const NOISE_PREFIX_TO_KIND: ReadonlyArray<{
+    prefix: string;
+    kind: PromptKind;
+}>;
+/**
+ * Classify a UserPromptSubmit payload into one of {@link PromptKind}.
+ *
+ * Decision rules (spec b1480935 Option A, 2026-06-01):
+ *   1. null / undefined / empty / whitespace-only → `'user'` (default; matches
+ *      the historical TaskSegmenter behaviour which still created a task row
+ *      for a fully-empty prompt — back-compat).
+ *   2. Match against {@link NOISE_PREFIX_TO_KIND}. If no prefix matches,
+ *      return `'user'`.
+ *   3. **Substantive-content carve-out**: when the matched prefix is followed
+ *      by a newline AND the remainder (trimmed) has length >= 3, the prompt
+ *      is treated as a REAL user prompt (kind=`'user'`). This is the same
+ *      "image-with-caption" rule that `isNoisePrompt` already implements;
+ *      reused here so e.g. `"[Image #2]\n请帮忙看下"` keeps surfacing as
+ *      a normal user task and not a muted `'image'` chip.
+ *
+ * Pure function — no side effects, no I/O, deterministic.
+ */
+export declare function classifyPromptKind(text: string | undefined | null): PromptKind;
+//# sourceMappingURL=noise-prompt.d.ts.map

package/dist/core/utils/noise-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-prompt.d.ts","sourceRoot":"","sources":["../../../src/core/utils/noise-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAOvD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAWtE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAOpF,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,UAAU,CAoB9E"}