@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/core/utils/noise-prompt.js

@@ -0,0 +1,127 @@
+/**
+ * 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 const NOISE_PROMPT_PREFIXES = [
+    '<task-notification>',
+    '<system-reminder>',
+    '<local-command-stdout>',
+    '<command-message>',
+    '<command-name>',
+    '[Image #',
+];
+/**
+ * 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 function isNoisePrompt(text) {
+    if (!text)
+        return false;
+    const trimmed = text.trimStart();
+    if (!NOISE_PROMPT_PREFIXES.some((p) => trimmed.startsWith(p)))
+        return false;
+    // Strip everything up to and including the first newline, then check
+    // whether substantive content follows.
+    const newlineIdx = trimmed.indexOf('\n');
+    if (newlineIdx === -1)
+        return true; // no newline → pure envelope
+    const remainder = trimmed.slice(newlineIdx + 1).trim();
+    return remainder.length < 3; // short/empty remainder → still noise
+}
+/**
+ * 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 const NOISE_PREFIX_TO_KIND = [
+    { prefix: '<task-notification>', kind: 'agent-callback' },
+    { prefix: '[Image #', kind: 'image' },
+    { prefix: '<system-reminder>', kind: 'system' },
+    { prefix: '<local-command-stdout>', kind: 'system' },
+    { prefix: '<command-message>', kind: 'system' },
+    { prefix: '<command-name>', kind: 'system' },
+];
+/**
+ * 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 function classifyPromptKind(text) {
+    if (!text)
+        return 'user';
+    const trimmed = text.trimStart();
+    if (trimmed.trim().length === 0)
+        return 'user';
+    for (const { prefix, kind } of NOISE_PREFIX_TO_KIND) {
+        if (!trimmed.startsWith(prefix))
+            continue;
+        // Substantive-content carve-out: envelope + newline + real text → 'user'.
+        // Mirrors the isNoisePrompt rule so the upgrade is behaviour-preserving
+        // for image-with-caption / system-with-question payloads.
+        const newlineIdx = trimmed.indexOf('\n');
+        if (newlineIdx !== -1) {
+            const remainder = trimmed.slice(newlineIdx + 1).trim();
+            if (remainder.length >= 3)
+                return 'user';
+        }
+        return kind;
+    }
+    return 'user';
+}
+//# sourceMappingURL=noise-prompt.js.map

package/dist/core/utils/noise-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-prompt.js","sourceRoot":"","sources":["../../../src/core/utils/noise-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA0B;IAC1D,qBAAqB;IACrB,mBAAmB;IACnB,wBAAwB;IACxB,mBAAmB;IACnB,gBAAgB;IAChB,UAAU;CACX,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,IAA+B;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5E,qEAAqE;IACrE,uCAAuC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,6BAA6B;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,sCAAsC;AACrE,CAAC;AAkBD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwD;IACvF,EAAE,MAAM,EAAE,qBAAqB,EAAK,IAAI,EAAE,gBAAgB,EAAE;IAC5D,EAAE,MAAM,EAAE,UAAU,EAAgB,IAAI,EAAE,OAAO,EAAE;IACnD,EAAE,MAAM,EAAE,mBAAmB,EAAO,IAAI,EAAE,QAAQ,EAAE;IACpD,EAAE,MAAM,EAAE,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpD,EAAE,MAAM,EAAE,mBAAmB,EAAO,IAAI,EAAE,QAAQ,EAAE;IACpD,EAAE,MAAM,EAAE,gBAAgB,EAAU,IAAI,EAAE,QAAQ,EAAE;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/C,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAE1C,0EAA0E;QAC1E,wEAAwE;QACxE,0DAA0D;QAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -2,8 +2,4 @@
  * Expand ~ to the user's home directory
  */
 export declare function expandPath(p: string): string;
-/**
- * Return path relative to cwd
- */
-export declare function relPath(p: string): string;
 //# sourceMappingURL=path.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/core/utils/path.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/core/utils/path.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C"}

package/dist/core/utils/path.js

@@ -1,5 +1,4 @@
 import { homedir } from 'node:os';
-import { relative } from 'node:path';
 /**
  * Expand ~ to the user's home directory
  */
@@ -9,10 +8,4 @@ export function expandPath(p) {
     }
     return p;
 }
-/**
- * Return path relative to cwd
- */
-export function relPath(p) {
-    return relative(process.cwd(), p);
-}
 //# sourceMappingURL=path.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/core/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/core/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -19,4 +19,45 @@ export declare function timeDiff(start: string, end: string): number;
  * 格式化时间差为人类可读格式
  */
 export declare function formatDuration(ms: number): string;
+/**
+ * 将"可能 naive 的 UTC ISO 串"安全转换为 Date 实例。
+ * string 入参走 normalizeTimestamp 补 Z；number 入参直通 new Date(n)（毫秒值）。
+ * 非法输入返回 epoch（不抛错）。
+ *
+ * 例：'2026-05-27T08:24:13.123' (naive UTC) → Date 表示 16:24 local (UTC+8)
+ */
+export declare function parseTimestamp(ts: string | number): Date;
+/**
+ * 格式化为本地时区显示，默认 `2026-05-27 16:24 CST`。
+ * opts.includeSeconds: 输出 `2026-05-27 16:24:13 CST`
+ * opts.dateOnly: 输出 `2026-05-27`
+ * opts.tzSuffix: 默认 'CST'；传 '' 跳过后缀
+ * 非法输入返回 '—'。
+ */
+export declare function formatLocalDisplay(ts: string | number, opts?: {
+    includeSeconds?: boolean;
+    dateOnly?: boolean;
+    tzSuffix?: string;
+}): string;
+/**
+ * 格式化为 UTC 显示，`2026-05-27 08:24 UTC`。
+ * opts.includeSeconds: 加 `:13`
+ * opts.dateOnly: 仅 `2026-05-27`（UTC 日期）
+ * 非法输入返回 '—'。
+ */
+export declare function formatUTCDisplay(ts: string | number, opts?: {
+    includeSeconds?: boolean;
+    dateOnly?: boolean;
+}): string;
+/**
+ * 相对时间：`刚刚` / `5 分钟前` / `2 小时前` / `3 天前`。
+ * 提取自 resume-manager.ts:formatRelativeTime。
+ * 非法或未来时间返回 '刚刚'。
+ */
+export declare function formatRelative(ts: string | number): string;
+/**
+ * 本地日期串（用于文件名），`2026-05-27`（本地时区）。
+ * 省略参数时使用 Date.now()。
+ */
+export declare function formatLocalDateForFilename(ts?: string | number): string;
 //# sourceMappingURL=time.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/core/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD"}
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/core/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,MAAM,CAgBR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAc1D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAOvE"}

package/dist/core/utils/time.js

@@ -35,4 +35,118 @@ export function formatDuration(ms) {
         return `${(ms / 60000).toFixed(1)}m`;
     return `${(ms / 3600000).toFixed(1)}h`;
 }
+// ─── New display helpers (timezone-overhaul, spec 1635) ────────────────────
+/**
+ * 将"可能 naive 的 UTC ISO 串"安全转换为 Date 实例。
+ * string 入参走 normalizeTimestamp 补 Z；number 入参直通 new Date(n)（毫秒值）。
+ * 非法输入返回 epoch（不抛错）。
+ *
+ * 例：'2026-05-27T08:24:13.123' (naive UTC) → Date 表示 16:24 local (UTC+8)
+ */
+export function parseTimestamp(ts) {
+    if (typeof ts === 'number') {
+        return new Date(ts);
+    }
+    try {
+        return new Date(normalizeTimestamp(ts));
+    }
+    catch {
+        return new Date(0);
+    }
+}
+function pad2(n) {
+    return n < 10 ? `0${n}` : `${n}`;
+}
+/**
+ * 格式化为本地时区显示，默认 `2026-05-27 16:24 CST`。
+ * opts.includeSeconds: 输出 `2026-05-27 16:24:13 CST`
+ * opts.dateOnly: 输出 `2026-05-27`
+ * opts.tzSuffix: 默认 'CST'；传 '' 跳过后缀
+ * 非法输入返回 '—'。
+ */
+export function formatLocalDisplay(ts, opts) {
+    try {
+        const d = parseTimestamp(ts);
+        if (isNaN(d.getTime()))
+            return '—';
+        const yyyy = d.getFullYear();
+        const mm = pad2(d.getMonth() + 1);
+        const dd = pad2(d.getDate());
+        if (opts?.dateOnly)
+            return `${yyyy}-${mm}-${dd}`;
+        const hh = pad2(d.getHours());
+        const min = pad2(d.getMinutes());
+        const base = `${yyyy}-${mm}-${dd} ${hh}:${min}`;
+        const withSec = opts?.includeSeconds ? `:${pad2(d.getSeconds())}` : '';
+        const suffix = opts?.tzSuffix !== undefined ? opts.tzSuffix : 'CST';
+        return suffix ? `${base}${withSec} ${suffix}` : `${base}${withSec}`;
+    }
+    catch {
+        return '—';
+    }
+}
+/**
+ * 格式化为 UTC 显示，`2026-05-27 08:24 UTC`。
+ * opts.includeSeconds: 加 `:13`
+ * opts.dateOnly: 仅 `2026-05-27`（UTC 日期）
+ * 非法输入返回 '—'。
+ */
+export function formatUTCDisplay(ts, opts) {
+    try {
+        const d = parseTimestamp(ts);
+        if (isNaN(d.getTime()))
+            return '—';
+        const yyyy = d.getUTCFullYear();
+        const mm = pad2(d.getUTCMonth() + 1);
+        const dd = pad2(d.getUTCDate());
+        if (opts?.dateOnly)
+            return `${yyyy}-${mm}-${dd}`;
+        const hh = pad2(d.getUTCHours());
+        const min = pad2(d.getUTCMinutes());
+        const base = `${yyyy}-${mm}-${dd} ${hh}:${min}`;
+        const withSec = opts?.includeSeconds ? `:${pad2(d.getUTCSeconds())}` : '';
+        return `${base}${withSec} UTC`;
+    }
+    catch {
+        return '—';
+    }
+}
+/**
+ * 相对时间：`刚刚` / `5 分钟前` / `2 小时前` / `3 天前`。
+ * 提取自 resume-manager.ts:formatRelativeTime。
+ * 非法或未来时间返回 '刚刚'。
+ */
+export function formatRelative(ts) {
+    try {
+        const d = parseTimestamp(ts);
+        if (isNaN(d.getTime()))
+            return '—';
+        const diff = Date.now() - d.getTime();
+        const mins = Math.floor(diff / 60000);
+        if (mins < 1)
+            return '刚刚';
+        if (mins < 60)
+            return `${mins} 分钟前`;
+        const hours = Math.floor(mins / 60);
+        if (hours < 24)
+            return `${hours} 小时前`;
+        return `${Math.floor(hours / 24)} 天前`;
+    }
+    catch {
+        return '—';
+    }
+}
+/**
+ * 本地日期串（用于文件名），`2026-05-27`（本地时区）。
+ * 省略参数时使用 Date.now()。
+ */
+export function formatLocalDateForFilename(ts) {
+    const d = ts !== undefined ? parseTimestamp(ts) : new Date();
+    if (isNaN(d.getTime()))
+        return formatLocalDateForFilename();
+    const yyyy = d.getFullYear();
+    const mm = pad2(d.getMonth() + 1);
+    const dd = pad2(d.getDate());
+    return `${yyyy}-${mm}-${dd}`;
+}
 //# sourceMappingURL=time.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/core/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,GAAW;IACjD,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,IAAI,EAAE,GAAG,OAAO;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC"}
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/core/utils/time.ts"],"names":[],"mappings":"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"}

package/dist/daemon/agent-sync.d.ts

@@ -0,0 +1,24 @@
+export interface AgentSyncResult {
+    copied: number;
+    checked: number;
+    /** Files present in target but not in source list — preserved as-is. */
+    skipped_userOwned: number;
+}
+/**
+ * Sync built-in project-specific agent prompts from
+ * dist/daemon/templates/agents to ~/.claude/agents/.
+ *
+ * Strategy (identical to syncSkills):
+ * - Only files present in the source dir are candidates for write.
+ * - sha256 identical → skip; different → overwrite.
+ * - User-only agent files (not in source list) are never touched.
+ * - Target dir is created if absent (first install).
+ *
+ * Failures are logged as warnings and never thrown — daemon startup must
+ * not be blocked by sync failure.
+ */
+export declare function syncAgents(opts?: {
+    sourceDir?: string;
+    targetDir?: string;
+}): AgentSyncResult;
+//# sourceMappingURL=agent-sync.d.ts.map

package/dist/daemon/agent-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sync.d.ts","sourceRoot":"","sources":["../../src/daemon/agent-sync.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAgE7F"}

package/dist/daemon/agent-sync.js

@@ -0,0 +1,114 @@
+import { existsSync, readFileSync, copyFileSync, mkdirSync, readdirSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { logger } from '../core/utils/logger.js';
+/**
+ * Sync project-specific agent prompts from packaged templates to
+ * `~/.claude/agents/`.
+ *
+ * Spec: docs/design/2026-05-27/1505-agent-template-sync-spec.md (Option B).
+ * Structurally a mirror of `src/daemon/skill-sync.ts` — same SHA-256 diff,
+ * same "user files outside the source list are untouched" policy.
+ *
+ * Why both `.claude/agents/` (tracked in the repo) AND
+ * `dist/daemon/templates/agents/`?
+ *   - The in-repo copy is what main thread / sub-agents actually load when
+ *     Claude Code is run from the forge checkout (Anthropic CLI reads
+ *     `<cwd>/.claude/agents/`).
+ *   - The template copy is what gets shipped via npm install — when a user
+ *     runs `claude-forge` in any other project, their `~/.claude/agents/`
+ *     needs the 8 project-specific agents bootstrapped, otherwise
+ *     `validateAgentEnum` throws on daemon startup. That's what this sync
+ *     covers.
+ *
+ * Files named `my-*.md` (or anything not in the source list) are preserved.
+ */
+const USER_AGENTS_DIR = join(homedir(), '.claude', 'agents');
+function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+// NOTE: delete semantics deliberately NOT applied here yet.
+// See docs/design/2026-05-29/1641-skill-sync-delete-semantics-spec.md
+// Open Q1 — promote to agent-sync only after skill-sync soaks.
+function getSourceAgentsDir() {
+    // Compiled: dist/daemon/agent-sync.js → dist/daemon/templates/agents
+    // Dev (vitest): src/daemon/agent-sync.ts → src/daemon/templates/agents
+    return join(dirname(fileURLToPath(import.meta.url)), 'templates', 'agents');
+}
+/**
+ * Sync built-in project-specific agent prompts from
+ * dist/daemon/templates/agents to ~/.claude/agents/.
+ *
+ * Strategy (identical to syncSkills):
+ * - Only files present in the source dir are candidates for write.
+ * - sha256 identical → skip; different → overwrite.
+ * - User-only agent files (not in source list) are never touched.
+ * - Target dir is created if absent (first install).
+ *
+ * Failures are logged as warnings and never thrown — daemon startup must
+ * not be blocked by sync failure.
+ */
+export function syncAgents(opts) {
+    const result = { copied: 0, checked: 0, skipped_userOwned: 0 };
+    const sourceDir = opts?.sourceDir ?? getSourceAgentsDir();
+    const targetDir = opts?.targetDir ?? USER_AGENTS_DIR;
+    if (!existsSync(sourceDir)) {
+        logger.warn(`[AgentSync] source dir not found at ${sourceDir}, skipping`);
+        return result;
+    }
+    // Ensure target dir exists (first install may not have ~/.claude/agents/)
+    try {
+        mkdirSync(targetDir, { recursive: true });
+    }
+    catch {
+        /* ignore — if it already exists mkdirSync is a no-op */
+    }
+    let sourceFiles;
+    try {
+        sourceFiles = readdirSync(sourceDir).filter((f) => f.endsWith('.md'));
+    }
+    catch (err) {
+        logger.warn(`[AgentSync] failed to list ${sourceDir}: ${err}`);
+        return result;
+    }
+    const sourceSet = new Set(sourceFiles);
+    for (const file of sourceFiles) {
+        result.checked++;
+        const src = join(sourceDir, file);
+        const dest = join(targetDir, file);
+        try {
+            const srcContent = readFileSync(src);
+            if (existsSync(dest)) {
+                const destContent = readFileSync(dest);
+                if (sha256(srcContent) === sha256(destContent)) {
+                    continue; // identical — no copy needed
+                }
+            }
+            copyFileSync(src, dest);
+            result.copied++;
+            logger.info(`[AgentSync] updated ${file}`);
+        }
+        catch (err) {
+            logger.warn(`[AgentSync] failed to sync ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Count user-owned files that don't shadow a managed file. These are kept
+    // as-is (e.g. user's `my-planner.md` overrides / supplements).
+    try {
+        const targetFiles = readdirSync(targetDir).filter((f) => f.endsWith('.md'));
+        for (const f of targetFiles) {
+            if (!sourceSet.has(f))
+                result.skipped_userOwned++;
+        }
+    }
+    catch {
+        /* target dir creation may have failed silently above; ignore */
+    }
+    if (result.copied > 0) {
+        logger.info(`[AgentSync] synced ${result.copied}/${result.checked} agent files (skipped_userOwned=${result.skipped_userOwned})`);
+    }
+    return result;
+}
+//# sourceMappingURL=agent-sync.js.map

package/dist/daemon/agent-sync.js.map

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

package/dist/daemon/config-store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ConfigStore — runtime feature-flag KV (v9.x Phase 0)
+ *
+ * Wraps the `forge_config` SQLite table so handlers / services can probe a
+ * flag without recompilation. Used by Phases 1-9 of the master roadmap
+ * (PreToolUse interception / feedback loop / workflow recommender / agent
+ * writeback ...). Each phase ships behind its own flag, default OFF.
+ *
+ * MVP1 (KB injection) is already shipped, so `kb_inject.enabled` defaults to
+ * `'true'`. All other Phase-N flags default `'false'` and are flipped to
+ * `'true'` by whoever rolls out that phase (CLI `cf config set ...` or
+ * Web tuning UI in Phase 8).
+ *
+ * Seeded values are inserted only if the key is absent — user edits are
+ * preserved across daemon restarts.
+ */
+import type { SQLiteStorage, ForgeConfigRow } from '../core/storage/sqlite.js';
+/**
+ * Default feature flags seeded on daemon startup.
+ *
+ * Add new flags here as later phases land; never delete existing keys
+ * (downstream tooling may probe them and would silently get the default-false
+ * behaviour, which is the wrong silent contract).
+ */
+export declare const DEFAULT_FLAGS: Readonly<Record<string, string>>;
+export declare class ConfigStore {
+    private storage;
+    constructor(storage: SQLiteStorage);
+    /**
+     * Returns `true` only when the stored value is the literal string `'true'`.
+     * Missing keys → `false` (fail-safe default). Any other value → `false`.
+     *
+     * Callers that need richer semantics should use `get()` directly.
+     */
+    isEnabled(key: string): boolean;
+    /** Raw read. `undefined` when the key is absent. */
+    get(key: string): string | undefined;
+    /** Upsert. Values are stored verbatim — coerce to string at the call site. */
+    set(key: string, value: string): void;
+    /**
+     * Delete a key. Used by Phase D `reviveInterceptIfStale` to clean up the
+     * auto-disabled audit keys after the hysteresis window expires. Idempotent.
+     */
+    delete(key: string): boolean;
+    /** Snapshot of every row, sorted by key for deterministic CLI output. */
+    list(): ForgeConfigRow[];
+    /**
+     * Seed `DEFAULT_FLAGS` (or a caller-supplied set) into the table, skipping
+     * keys that already have a value. Safe to call on every daemon start.
+     *
+     * Returns the count of newly inserted keys (0 on subsequent restarts).
+     */
+    seedDefaults(defaults?: Readonly<Record<string, string>>): number;
+}
+//# sourceMappingURL=config-store.d.ts.map

package/dist/daemon/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/daemon/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwEzD,CAAC;AAEH,qBAAa,WAAW;IACV,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE1C;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,oDAAoD;IACpD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,8EAA8E;IAC9E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,yEAAyE;IACzE,IAAI,IAAI,cAAc,EAAE;IAIxB;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAiB,GAAG,MAAM;CASjF"}