@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/daemon/services/violation-reporter.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Violation Reporter — Phase C feedback loop
+ *
+ * Produces a markdown summary of recent main-thread violations so the next
+ * session can read them at the top of CLAUDE.md (forge:violations block).
+ *
+ * Three signal sources, merged + deduped + capped:
+ *   1. routing_events.obeyed = 0 (within rolling window)
+ *   2. UserPromptSubmit events whose user_prompt contains explicit
+ *      "you broke the rule" keywords
+ *   3. tool_intercepts rows with decision='deny' or 'warn' (Phase 2).
+ *      decision='dry_run' is intentionally EXCLUDED — when the kill switch
+ *      is off the intercept never fired and the main thread had no chance
+ *      to "correct" itself, so counting it as a violation would be noise.
+ *
+ * Pure functions: input is the storage facade + filter options, output is
+ * either an array of Violation rows or the rendered markdown body.
+ */
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+/**
+ * Prompt-text prefixes that identify tool-generated or system messages
+ * masquerading as user_prompt rows. These must not be scanned for
+ * violation keywords because they reflect agent reports / image attachments
+ * / framework reminders, not the human's actual unhappiness.
+ *
+ * Historical export name (single source of truth lives in
+ * `core/utils/noise-prompt.ts` as `NOISE_PROMPT_PREFIXES`). Kept here as a
+ * re-export so existing call sites (`import { TOOL_MESSAGE_PREFIXES }` from
+ * violation-reporter) and the `__testing` shim continue to work unchanged.
+ */
+export declare const TOOL_MESSAGE_PREFIXES: ReadonlyArray<string>;
+export type ViolationSignal = 'routing_disobeyed' | 'user_keyword' | 'tool_intercept';
+export interface Violation {
+    /** ISO timestamp of when the violation occurred */
+    timestamp: string;
+    /** ≤ 80 char summary of the prompt or routing reason */
+    user_prompt_summary: string;
+    /** Source signal that flagged this row */
+    signal: ViolationSignal;
+    /** Routed-to agent name (only meaningful for routing_disobeyed) */
+    expected_agent?: string;
+    /** First matched keyword (only meaningful for user_keyword) */
+    detected_keyword?: string;
+    /** PreToolUse rule id (only meaningful for tool_intercept) */
+    rule_id?: string;
+    /** Tool name that triggered the intercept (only meaningful for tool_intercept) */
+    tool_name?: string;
+    /** Decision severity: deny → high, warn → medium (only meaningful for tool_intercept) */
+    severity?: 'high' | 'medium';
+    /** Short hint copied from tool_intercepts.hint (only meaningful for tool_intercept) */
+    note?: string;
+}
+export interface CollectViolationsOptions {
+    /** Restrict to one session; omit to consider all sessions in the window */
+    sessionId?: string;
+    /** Restrict to one project (events table only) */
+    projectPath?: string;
+    /** Rolling window length in days (default 7) */
+    days?: number;
+    /** Cap on number of violations returned (default 5) */
+    limit?: number;
+}
+/**
+ * Collect violations from both signal sources, merge + dedupe + slice.
+ *
+ * Dedupe key: `${truncatedPrompt}|${minute-bucketed-timestamp}` — same prompt
+ * within the same minute counts once even if multiple sources triggered.
+ */
+export declare function collectViolations(storage: SQLiteStorage, options?: CollectViolationsOptions): Violation[];
+/**
+ * Count violations in the rolling window WITHOUT the user-facing `limit` cap.
+ *
+ * Why a separate function vs. reusing collectViolations():
+ *   collectViolations applies `.slice(0, limit)` at the end (default 5 in
+ *   /api/violations) for the markdown report + Stop hook. The Web KPI
+ *   "近 7d 共 N 条 violation" wants the TRUE deduped count regardless of
+ *   limit, so this function returns the same merged-deduped set's length
+ *   plus a per-signal breakdown (so the InterceptsTab "tool intercept (7d)"
+ *   stat can also bind to an unbounded count).
+ *
+ * The scan is still bounded by MAX_SCAN (200) per source as a pathological-
+ * read guard — same as collectViolations. If the window contains more than
+ * MAX_SCAN raw rows per source the returned counts are floor-estimates, not
+ * undercounts caused by the user-facing limit. Callers needing a true >200
+ * count should add cursor-style pagination (Phase 8+ work).
+ *
+ * Added 2026-05-26 to fix "Violations page 近 7d 共 N 条" + "tool intercept
+ * (7d)" both stuck at ≤20 (=limit) regardless of true volume.
+ */
+export declare function countViolationsBySignal(storage: SQLiteStorage, options?: CollectViolationsOptions): {
+    total: number;
+    by_signal: Record<ViolationSignal, number>;
+};
+/**
+ * Render the violation list as markdown suitable for embedding in the
+ * forge:violations block body. Returns '' for an empty list (caller should
+ * check this and skip writing the block to avoid polluting CLAUDE.md).
+ */
+export declare function generateViolationReport(violations: Violation[]): string;
+declare function matchKeyword(prompt: string): string | null;
+/**
+ * True if the user_prompt row is actually a tool-generated or system
+ * message (task-notification, system-reminder, image attachment, etc.)
+ * rather than a real human prompt.
+ *
+ * Unlike {@link isNoisePrompt} (core/utils), this function applies a
+ * stricter rule: ANY prompt that starts with a known envelope prefix is
+ * considered a tool message, regardless of what follows the first newline.
+ * The "envelope-with-content" exception in isNoisePrompt is intentional for
+ * other consumers (e.g. auto-spec triggers where "[Image #2]\n<real question>"
+ * should still fire), but violation-reporter must skip all envelope rows to
+ * avoid false positives from agent-reported violation summaries embedded inside
+ * <task-notification> or <system-reminder> envelopes.
+ */
+declare function isToolMessage(prompt: string): boolean;
+declare function dedupe(items: Violation[]): Violation[];
+export declare function formatRelative(iso: string): string;
+/** Exported for tests only */
+export declare const __testing: {
+    VIOLATION_KEYWORDS: readonly string[];
+    TOOL_MESSAGE_PREFIXES: readonly string[];
+    SUMMARY_MAX: number;
+    DEFAULT_DAYS: number;
+    DEFAULT_LIMIT: number;
+    matchKeyword: typeof matchKeyword;
+    isToolMessage: typeof isToolMessage;
+    dedupe: typeof dedupe;
+};
+export {};
+//# sourceMappingURL=violation-reporter.d.ts.map

package/dist/daemon/services/violation-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-reporter.d.ts","sourceRoot":"","sources":["../../../src/daemon/services/violation-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAalE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAyB,CAAC;AAuDlF,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEtF,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,EAAE,eAAe,CAAC;IACxB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,wBAA6B,GACrC,SAAS,EAAE,CA8Fb;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,wBAA6B,GACrC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;CAC5C,CAeA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CA+BvE;AAID,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnD;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9C;AAED,iBAAS,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAmB/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED,8BAA8B;AAC9B,eAAO,MAAM,SAAS;;;;;;;;;CASrB,CAAC"}

package/dist/daemon/services/violation-reporter.js

@@ -0,0 +1,339 @@
+/**
+ * Violation Reporter — Phase C feedback loop
+ *
+ * Produces a markdown summary of recent main-thread violations so the next
+ * session can read them at the top of CLAUDE.md (forge:violations block).
+ *
+ * Three signal sources, merged + deduped + capped:
+ *   1. routing_events.obeyed = 0 (within rolling window)
+ *   2. UserPromptSubmit events whose user_prompt contains explicit
+ *      "you broke the rule" keywords
+ *   3. tool_intercepts rows with decision='deny' or 'warn' (Phase 2).
+ *      decision='dry_run' is intentionally EXCLUDED — when the kill switch
+ *      is off the intercept never fired and the main thread had no chance
+ *      to "correct" itself, so counting it as a violation would be noise.
+ *
+ * Pure functions: input is the storage facade + filter options, output is
+ * either an array of Violation rows or the rendered markdown body.
+ */
+import { truncateString } from '../../core/utils/format.js';
+import { NOISE_PROMPT_PREFIXES } from '../../core/utils/noise-prompt.js';
+/** Rolling window default (D4) */
+const DEFAULT_DAYS = 7;
+/** Top-N detail rendering (D4) */
+const DEFAULT_LIMIT = 5;
+/** Internal scan cap before slice; prevents pathological reads */
+const MAX_SCAN = 200;
+/** user_prompt summary truncation in the report (also dedupe key prefix) */
+const SUMMARY_MAX = 80;
+/**
+ * Prompt-text prefixes that identify tool-generated or system messages
+ * masquerading as user_prompt rows. These must not be scanned for
+ * violation keywords because they reflect agent reports / image attachments
+ * / framework reminders, not the human's actual unhappiness.
+ *
+ * Historical export name (single source of truth lives in
+ * `core/utils/noise-prompt.ts` as `NOISE_PROMPT_PREFIXES`). Kept here as a
+ * re-export so existing call sites (`import { TOOL_MESSAGE_PREFIXES }` from
+ * violation-reporter) and the `__testing` shim continue to work unchanged.
+ */
+export const TOOL_MESSAGE_PREFIXES = NOISE_PROMPT_PREFIXES;
+/**
+ * Keywords that strongly indicate the user is calling out a violation
+ * or expressing concrete dissatisfaction with the assistant's behavior.
+ *
+ * Principles:
+ *   - Must imply the user is unhappy / pointing out wrong behavior.
+ *   - Avoid bare common verbs/nouns (e.g. "改了", "用了") to dodge false
+ *     positives in normal coding prompts.
+ *   - Variants with/without space between Chinese and Latin words because
+ *     IMEs differ.
+ *
+ * Extend here as new patterns emerge.
+ */
+const VIOLATION_KEYWORDS = [
+    // Explicit rule-breaking callouts
+    '违反规则',
+    '违规',
+    '再次违反',
+    '又违反',
+    // Agent / spawn related
+    '不使用 Agent',
+    '不使用agent',
+    '没有使用 Agent',
+    '没有使用agent',
+    '应该 spawn',
+    '应该spawn',
+    '没有 spawn',
+    '没有spawn',
+    '为什么没有 spawn',
+    '为什么不 spawn',
+    '为什么不spawn',
+    // Skill related
+    '为什么 skill',
+    '为什么skill',
+    '没有调用 skill',
+    '没有调用skill',
+    'skill 没有',
+    'skill没有',
+    'skill 一直没',
+    'skill一直没',
+    '一直没有使用',
+    // Direct hook / harness / hybrid edits
+    '不要直接改',
+    '应该走 harness',
+    '应该走harness',
+    '应该走 hybrid',
+    '应该走hybrid',
+    // Soft frustration phrases (load-bearing dissatisfaction signals)
+    '丑爆了',
+    '完全看不懂',
+    '看不懂',
+];
+/**
+ * Collect violations from both signal sources, merge + dedupe + slice.
+ *
+ * Dedupe key: `${truncatedPrompt}|${minute-bucketed-timestamp}` — same prompt
+ * within the same minute counts once even if multiple sources triggered.
+ */
+export function collectViolations(storage, options = {}) {
+    const days = options.days ?? DEFAULT_DAYS;
+    const limit = options.limit ?? DEFAULT_LIMIT;
+    const cutoffMs = Date.now() - days * 24 * 3600 * 1000;
+    const cutoffIso = new Date(cutoffMs).toISOString();
+    const out = [];
+    // ── Source 1: routing_events with obeyed=0 ──────────────────────────────
+    try {
+        const rows = storage.queryRoutingEvents({
+            session_id: options.sessionId,
+            project_path: options.projectPath,
+            since_ts: cutoffMs,
+            obeyed: 0,
+            limit: MAX_SCAN,
+        });
+        for (const row of rows) {
+            out.push({
+                timestamp: new Date(row.ts).toISOString(),
+                user_prompt_summary: truncateString(row.prompt ?? '', SUMMARY_MAX),
+                signal: 'routing_disobeyed',
+                expected_agent: row.routed_to_name ?? undefined,
+            });
+        }
+    }
+    catch {
+        // storage hiccups must not break Stop flow
+    }
+    // ── Source 2: UserPromptSubmit events containing violation keywords ────
+    try {
+        const events = storage.queryEvents({
+            session_id: options.sessionId,
+            project_path: options.projectPath,
+            hook_type: 'UserPromptSubmit',
+            limit: MAX_SCAN,
+        });
+        for (const ev of events) {
+            const prompt = ev.user_prompt;
+            if (!prompt)
+                continue;
+            // Skip tool-generated and system messages that landed in user_prompt
+            // (e.g. <task-notification>, <system-reminder>, image attachments).
+            // These can themselves quote the word "违规" inside agent reports
+            // and would otherwise produce noisy false positives.
+            if (isToolMessage(prompt))
+                continue;
+            // 7-day window filter (events table stores ISO strings, not millis)
+            if (ev.timestamp < cutoffIso)
+                continue;
+            const matched = matchKeyword(prompt);
+            if (!matched)
+                continue;
+            out.push({
+                timestamp: ev.timestamp,
+                user_prompt_summary: truncateString(prompt, SUMMARY_MAX),
+                signal: 'user_keyword',
+                detected_keyword: matched,
+            });
+        }
+    }
+    catch {
+        // storage hiccups must not break Stop flow
+    }
+    // ── Source 3: tool_intercepts with decision=deny|warn (Phase 2) ─────────
+    // dry_run / bypass intentionally excluded — see file header.
+    try {
+        const intercepts = storage.queryToolIntercepts({
+            session_id: options.sessionId,
+            project_path: options.projectPath,
+            decisions: ['deny', 'warn'],
+            since: cutoffIso,
+            limit: MAX_SCAN,
+        });
+        for (const row of intercepts) {
+            out.push({
+                timestamp: row.timestamp,
+                user_prompt_summary: truncateString(`${row.tool_name} blocked by ${row.rule_id}`, SUMMARY_MAX),
+                signal: 'tool_intercept',
+                rule_id: row.rule_id,
+                tool_name: row.tool_name,
+                severity: row.decision === 'deny' ? 'high' : 'medium',
+                note: row.hint ? truncateString(row.hint, 200) : undefined,
+            });
+        }
+    }
+    catch {
+        // storage hiccups must not break Stop flow
+    }
+    // ── Dedupe + sort + slice ──────────────────────────────────────────────
+    const deduped = dedupe(out);
+    deduped.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    return deduped.slice(0, limit);
+}
+/**
+ * Count violations in the rolling window WITHOUT the user-facing `limit` cap.
+ *
+ * Why a separate function vs. reusing collectViolations():
+ *   collectViolations applies `.slice(0, limit)` at the end (default 5 in
+ *   /api/violations) for the markdown report + Stop hook. The Web KPI
+ *   "近 7d 共 N 条 violation" wants the TRUE deduped count regardless of
+ *   limit, so this function returns the same merged-deduped set's length
+ *   plus a per-signal breakdown (so the InterceptsTab "tool intercept (7d)"
+ *   stat can also bind to an unbounded count).
+ *
+ * The scan is still bounded by MAX_SCAN (200) per source as a pathological-
+ * read guard — same as collectViolations. If the window contains more than
+ * MAX_SCAN raw rows per source the returned counts are floor-estimates, not
+ * undercounts caused by the user-facing limit. Callers needing a true >200
+ * count should add cursor-style pagination (Phase 8+ work).
+ *
+ * Added 2026-05-26 to fix "Violations page 近 7d 共 N 条" + "tool intercept
+ * (7d)" both stuck at ≤20 (=limit) regardless of true volume.
+ */
+export function countViolationsBySignal(storage, options = {}) {
+    // Reuse collectViolations with a synthetic high limit so the dedupe logic
+    // stays in one place. MAX_SCAN (200) is the per-source upper bound; the
+    // post-dedupe set can't exceed 3 * MAX_SCAN = 600, so a limit of 1000 is
+    // a safe ceiling that still benefits from the slice() short-circuit.
+    const all = collectViolations(storage, { ...options, limit: 1000 });
+    const by_signal = {
+        routing_disobeyed: 0,
+        user_keyword: 0,
+        tool_intercept: 0,
+    };
+    for (const v of all) {
+        by_signal[v.signal] += 1;
+    }
+    return { total: all.length, by_signal };
+}
+/**
+ * Render the violation list as markdown suitable for embedding in the
+ * forge:violations block body. Returns '' for an empty list (caller should
+ * check this and skip writing the block to avoid polluting CLAUDE.md).
+ */
+export function generateViolationReport(violations) {
+    if (violations.length === 0)
+        return '';
+    const lines = [];
+    lines.push('## 最近违规记录');
+    lines.push('');
+    lines.push('⚠️ **以下是最近 7 天内主线程的合规问题，请在新任务开始前回顾，避免重复违规**');
+    lines.push('');
+    for (const v of violations) {
+        const when = formatRelative(v.timestamp);
+        let tag;
+        if (v.signal === 'routing_disobeyed') {
+            tag = `路由未遵守${v.expected_agent ? `（应路由到 ${v.expected_agent}）` : ''}`;
+        }
+        else if (v.signal === 'user_keyword') {
+            tag = `用户指出违规${v.detected_keyword ? `（关键词："${v.detected_keyword}"）` : ''}`;
+        }
+        else {
+            // tool_intercept
+            const sev = v.severity === 'high' ? '[deny]' : '[warn]';
+            tag = `工具拦截 ${sev}${v.rule_id ? `（规则：${v.rule_id}）` : ''}`;
+        }
+        lines.push(`- **${when}** ${tag}`);
+        lines.push(`  - 上下文：${v.user_prompt_summary || '(空)'}`);
+        if (v.signal === 'tool_intercept' && v.note) {
+            lines.push(`  - 提示：${v.note}`);
+        }
+    }
+    lines.push('');
+    lines.push('如要清空本块，运行：`cf violations clear`');
+    return lines.join('\n');
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+function matchKeyword(prompt) {
+    for (const kw of VIOLATION_KEYWORDS) {
+        if (prompt.includes(kw))
+            return kw;
+    }
+    return null;
+}
+/**
+ * True if the user_prompt row is actually a tool-generated or system
+ * message (task-notification, system-reminder, image attachment, etc.)
+ * rather than a real human prompt.
+ *
+ * Unlike {@link isNoisePrompt} (core/utils), this function applies a
+ * stricter rule: ANY prompt that starts with a known envelope prefix is
+ * considered a tool message, regardless of what follows the first newline.
+ * The "envelope-with-content" exception in isNoisePrompt is intentional for
+ * other consumers (e.g. auto-spec triggers where "[Image #2]\n<real question>"
+ * should still fire), but violation-reporter must skip all envelope rows to
+ * avoid false positives from agent-reported violation summaries embedded inside
+ * <task-notification> or <system-reminder> envelopes.
+ */
+function isToolMessage(prompt) {
+    const trimmed = prompt.trimStart();
+    return NOISE_PROMPT_PREFIXES.some((p) => trimmed.startsWith(p));
+}
+function dedupe(items) {
+    const seen = new Map();
+    for (const v of items) {
+        // Bucket to minute precision so two signals firing on the same prompt
+        // within seconds collapse into one entry.
+        const minuteBucket = v.timestamp.slice(0, 16);
+        const key = `${minuteBucket}|${v.user_prompt_summary}`;
+        const existing = seen.get(key);
+        if (!existing) {
+            seen.set(key, v);
+            continue;
+        }
+        // Prefer routing_disobeyed entry when both sources matched the same row,
+        // since it carries expected_agent metadata.
+        if (existing.signal === 'user_keyword' && v.signal === 'routing_disobeyed') {
+            seen.set(key, v);
+        }
+    }
+    return Array.from(seen.values());
+}
+export function formatRelative(iso) {
+    const t = new Date(iso).getTime();
+    if (!Number.isFinite(t))
+        return iso;
+    const diff = Date.now() - t;
+    if (diff < 0)
+        return '刚刚';
+    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} 小时前`;
+    const days = Math.floor(hours / 24);
+    return `${days} 天前`;
+}
+/** Exported for tests only */
+export const __testing = {
+    VIOLATION_KEYWORDS,
+    TOOL_MESSAGE_PREFIXES,
+    SUMMARY_MAX,
+    DEFAULT_DAYS,
+    DEFAULT_LIMIT,
+    matchKeyword,
+    isToolMessage,
+    dedupe,
+};
+//# sourceMappingURL=violation-reporter.js.map

package/dist/daemon/services/violation-reporter.js.map

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

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

@@ -2,14 +2,19 @@ export interface SkillSyncResult {
     copied: number;
     checked: number;
     skipped_userOwned: number;
+    /** Files previously managed by daemon but no longer in source — unlinked. */
+    deleted_stale: number;
 }
 /**
- * Sync official skills from dist/skills/official to ~/.claude/skills/.
+ * Sync built-in distilled skills from dist/skills/distilled to ~/.claude/skills/.
  *
  * Strategy:
- * - Only files present in the source dir (dist/skills/official) are candidates
+ * - Only files present in the source dir (dist/skills/distilled) are candidates
  * - sha256 identical → skip; different → overwrite
  * - User-only skills (not in source list) are never touched
+ * - Files previously written by daemon (tracked in `.forge-managed.json`) but
+ *   no longer in source are unlinked. User files never enter the tracker so
+ *   they are safe from this reap pass.
  * - Target dir is created if absent (first install)
  *
  * Failures are logged as warnings and never thrown — daemon startup must not be blocked.

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

@@ -1 +1 @@
-{"version":3,"file":"skill-sync.d.ts","sourceRoot":"","sources":["../../src/daemon/skill-sync.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAmD7F"}
+{"version":3,"file":"skill-sync.d.ts","sourceRoot":"","sources":["../../src/daemon/skill-sync.ts"],"names":[],"mappings":"AAyFA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAwG7F"}