@winspan/claude-forge 8.41.0 → 8.50.6

package/dist/daemon/services/task-segmenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-segmenter.d.ts","sourceRoot":"","sources":["../../../src/daemon/services/task-segmenter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAmBlE,qBAAa,aAAa;IAGZ,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,YAAY,CAAuD;gBAEvD,OAAO,EAAE,aAAa;IAE1C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAoB7F,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOnD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAezB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlD,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAU/D,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;CAMrB"}

package/dist/{intelligence → daemon/services}/task-segmenter.js

@@ -1,5 +1,8 @@
 import { randomUUID } from 'node:crypto';
-import { logger } from '../core/utils/logger.js';
+import { logger } from '../../core/utils/logger.js';
+import { timestampToMs } from '../../core/utils/time.js';
+import { truncateSessionId } from '../../core/utils/session.js';
+import { truncateString } from '../../core/utils/format.js';
 const NEW_TASK_KEYWORDS = [
     '帮我', '实现', '修复', '添加', '重构', '优化', '创建', '删除',
     '升级', '迁移', '部署', '配置', '设计', '提交', '推送',
@@ -18,9 +21,12 @@ export class TaskSegmenter {
     }
     processPrompt(sessionId, prompt, timestamp, eventId) {
         const key = sessionId;
-        const current = this.currentTasks.get(key);
-        const now = new Date(timestamp.endsWith('Z') ? timestamp : timestamp + 'Z').getTime();
+        const current = this.currentTasks.get(key) ?? this.recoverActiveTask(key);
+        const now = timestampToMs(timestamp);
         if (!current || this.shouldStartNewTask(prompt, now, current)) {
+            if (current) {
+                this.storage.updateTask(current.id, { status: 'completed', end_time: timestamp });
+            }
             const taskId = this.createTask(sessionId, prompt, timestamp);
             this.currentTasks.set(key, { id: taskId, lastTime: now });
             if (eventId)
@@ -33,11 +39,28 @@ export class TaskSegmenter {
         return current.id;
     }
     linkEvent(sessionId, eventId) {
-        const current = this.currentTasks.get(sessionId);
+        const current = this.currentTasks.get(sessionId) ?? this.recoverActiveTask(sessionId);
         if (current) {
             this.storage.linkEventToTask(current.id, eventId);
         }
     }
+    /**
+     * 从数据库恢复 session 的 active 任务到内存 Map。
+     * 用于 daemon 重启后内存丢失场景的 lazy 恢复。
+     * 找不到 active 任务时返回 null（不报错）。
+     */
+    recoverActiveTask(sessionId) {
+        const tasks = this.storage.queryTasks({ session_id: sessionId, limit: 5 });
+        const activeTask = tasks.find(t => t.status === 'active');
+        if (!activeTask)
+            return null;
+        const anchor = activeTask.end_time ?? activeTask.start_time;
+        const lastTime = timestampToMs(anchor);
+        const entry = { id: activeTask.id, lastTime };
+        this.currentTasks.set(sessionId, entry);
+        logger.info(`[TaskSegmenter] Recovered active task ${truncateString(activeTask.id, 8)} for session ${truncateSessionId(sessionId)} from DB`);
+        return entry;
+    }
     getCurrentTaskId(sessionId) {
         return this.currentTasks.get(sessionId)?.id ?? null;
     }
@@ -65,7 +88,7 @@ export class TaskSegmenter {
         const taskId = randomUUID();
         const title = this.extractTitle(prompt);
         this.storage.writeTask({ id: taskId, session_id: sessionId, title, start_time: timestamp });
-        logger.info(`[TaskSegmenter] New task: "${title}" (${taskId.slice(0, 8)})`);
+        logger.info(`[TaskSegmenter] New task: "${title}" (${truncateString(taskId, 8)})`);
         return taskId;
     }
     extractTitle(prompt) {
@@ -73,7 +96,7 @@ export class TaskSegmenter {
         const firstLine = cleaned.split('\n')[0].trim();
         if (firstLine.length <= 60)
             return firstLine || '(无标题)';
-        return firstLine.slice(0, 57) + '...';
+        return truncateString(firstLine, 60);
     }
 }
 //# sourceMappingURL=task-segmenter.js.map

package/dist/daemon/services/task-segmenter.js.map

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

package/dist/daemon/services/weekly-report.d.ts

@@ -0,0 +1,91 @@
+/**
+ * WeeklyReportGenerator — 周报生成引擎
+ *
+ * 基于现有 events / sessions / routing_events / skill_invocations / tasks 表
+ * 聚合上一周（ISO week，周一 00:00 — 周日 23:59）的关键指标，并提供
+ * Markdown 渲染输出。
+ *
+ * 不修改任何 schema：完全基于现有表。
+ */
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+export interface WeeklyReport {
+    generatedAt: string;
+    week: {
+        start: string;
+        end: string;
+        isoWeekNumber: number;
+    };
+    overview: {
+        totalSessions: number;
+        totalEvents: number;
+        totalTasks: number;
+        activeProjects: string[];
+        activeDays: number;
+    };
+    agentDelegation: {
+        totalPrompts: number;
+        delegations: number;
+        rate: string;
+        weekOverWeek: string;
+        topAgents: Array<{
+            agent: string;
+            count: number;
+        }>;
+    };
+    skills: {
+        invocations: number;
+        distinct: number;
+        topSkills: Array<{
+            skill_id: string;
+            count: number;
+        }>;
+        neverUsed: string[];
+    };
+    tools: {
+        totalCalls: number;
+        topTools: Array<{
+            name: string;
+            count: number;
+        }>;
+        failureRate: string;
+    };
+    files: {
+        topEdited: Array<{
+            path: string;
+            editCount: number;
+        }>;
+        totalEdits: number;
+    };
+    anomalies: Array<{
+        type: string;
+        description: string;
+    }>;
+}
+export declare class WeeklyReportGenerator {
+    private storage;
+    private skillRegistry?;
+    constructor(storage: SQLiteStorage, skillRegistry?: {
+        getAll(): Array<{
+            id: string;
+        }>;
+    } | undefined);
+    /**
+     * 生成周报
+     * @param weekOffset 周偏移：0 = 本周, -1 = 上周, -2 = 上上周
+     */
+    generate(weekOffset?: number): WeeklyReport;
+    private aggregateOverview;
+    private aggregateAgentDelegation;
+    private computeAgentRate;
+    private aggregateSkills;
+    private aggregateTools;
+    private aggregateFiles;
+    private aggregateAnomalies;
+    /**
+     * 计算 ISO 周的起止时间（周一 00:00:00 — 下周一 00:00:00）。
+     * weekOffset: 0 = 本周, -1 = 上周, -2 = 上上周
+     */
+    private computeWeekRange;
+    toMarkdown(report: WeeklyReport): string;
+}
+//# sourceMappingURL=weekly-report.d.ts.map

package/dist/daemon/services/weekly-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly-report.d.ts","sourceRoot":"","sources":["../../../src/daemon/services/weekly-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,eAAe,EAAE;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACpD,CAAC;IACF,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtD,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtD,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAYD,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,aAAa,CAAC;gBADd,OAAO,EAAE,aAAa,EACtB,aAAa,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,YAAA;IAG7D;;;OAGG;IACH,QAAQ,CAAC,UAAU,GAAE,MAAU,GAAG,YAAY;IA6B9C,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,wBAAwB;IAmBhC,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,cAAc;IA8CtB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,kBAAkB;IAS1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2BxB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;CAyGzC"}

package/dist/daemon/services/weekly-report.js

@@ -0,0 +1,327 @@
+/**
+ * WeeklyReportGenerator — 周报生成引擎
+ *
+ * 基于现有 events / sessions / routing_events / skill_invocations / tasks 表
+ * 聚合上一周（ISO week，周一 00:00 — 周日 23:59）的关键指标，并提供
+ * Markdown 渲染输出。
+ *
+ * 不修改任何 schema：完全基于现有表。
+ */
+const FILE_EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+export class WeeklyReportGenerator {
+    storage;
+    skillRegistry;
+    constructor(storage, skillRegistry) {
+        this.storage = storage;
+        this.skillRegistry = skillRegistry;
+    }
+    /**
+     * 生成周报
+     * @param weekOffset 周偏移：0 = 本周, -1 = 上周, -2 = 上上周
+     */
+    generate(weekOffset = 0) {
+        const week = this.computeWeekRange(weekOffset);
+        const previousWeek = this.computeWeekRange(weekOffset - 1);
+        const overview = this.aggregateOverview(week);
+        const agentDelegation = this.aggregateAgentDelegation(week, previousWeek);
+        const skills = this.aggregateSkills(week);
+        const tools = this.aggregateTools(week);
+        const files = this.aggregateFiles(week);
+        const anomalies = this.aggregateAnomalies(week);
+        return {
+            generatedAt: new Date().toISOString(),
+            week: {
+                start: week.startISO,
+                end: week.endISO,
+                isoWeekNumber: week.isoWeekNumber,
+            },
+            overview,
+            agentDelegation,
+            skills,
+            tools,
+            files,
+            anomalies,
+        };
+    }
+    // ── Aggregation methods ──────────────────────────────────────────────
+    aggregateOverview(week) {
+        const db = this.storage.getDatabase();
+        const eventsRow = db.prepare(`SELECT COUNT(*) as cnt, COUNT(DISTINCT session_id) as sessionCount,
+              COUNT(DISTINCT date(timestamp)) as dayCount
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?`).get(week.startISO, week.endISO);
+        const projectRows = db.prepare(`SELECT DISTINCT project_path
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?
+              AND project_path IS NOT NULL AND project_path != ''`).all(week.startISO, week.endISO);
+        const tasksRow = db.prepare(`SELECT COUNT(*) as cnt
+         FROM tasks
+        WHERE start_time >= ? AND start_time < ?`).get(week.startISO, week.endISO);
+        return {
+            totalSessions: eventsRow.sessionCount || 0,
+            totalEvents: eventsRow.cnt || 0,
+            totalTasks: tasksRow.cnt || 0,
+            activeProjects: projectRows.map(r => r.project_path),
+            activeDays: eventsRow.dayCount || 0,
+        };
+    }
+    aggregateAgentDelegation(week, previousWeek) {
+        const current = this.computeAgentRate(week);
+        const previous = this.computeAgentRate(previousWeek);
+        const diff = current.rateNum - previous.rateNum;
+        const weekOverWeek = `${diff >= 0 ? '+' : ''}${diff.toFixed(1)}pp`;
+        return {
+            totalPrompts: current.totalPrompts,
+            delegations: current.delegations,
+            rate: `${current.rateNum.toFixed(1)}%`,
+            weekOverWeek,
+            topAgents: current.topAgents,
+        };
+    }
+    computeAgentRate(week) {
+        const events = this.storage.queryRoutingEvents({
+            since_ts: week.startMs,
+            limit: 100000,
+        }).filter(e => e.ts < week.endMs);
+        const totalPrompts = events.length;
+        const delegations = events.filter(e => e.obeyed === 1).length;
+        const rateNum = totalPrompts > 0 ? (delegations / totalPrompts) * 100 : 0;
+        const agentMap = new Map();
+        for (const e of events) {
+            if (e.obeyed === 1 && e.routed_to_name) {
+                agentMap.set(e.routed_to_name, (agentMap.get(e.routed_to_name) || 0) + 1);
+            }
+        }
+        const topAgents = Array.from(agentMap.entries())
+            .map(([agent, count]) => ({ agent, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5);
+        return { totalPrompts, delegations, rateNum, topAgents };
+    }
+    aggregateSkills(week) {
+        const invocations = this.storage.querySkillInvocations({
+            since: week.startMs,
+            limit: 100000,
+        }).filter(inv => inv.timestamp < week.endMs);
+        const skillMap = new Map();
+        for (const inv of invocations) {
+            skillMap.set(inv.skill_id, (skillMap.get(inv.skill_id) || 0) + 1);
+        }
+        const topSkills = Array.from(skillMap.entries())
+            .map(([skill_id, count]) => ({ skill_id, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5);
+        const allSkillIds = this.skillRegistry
+            ? this.skillRegistry.getAll().map(s => s.id)
+            : [];
+        const usedSet = new Set(skillMap.keys());
+        const neverUsed = allSkillIds.filter(id => !usedSet.has(id));
+        return {
+            invocations: invocations.length,
+            distinct: skillMap.size,
+            topSkills,
+            neverUsed,
+        };
+    }
+    aggregateTools(week) {
+        const db = this.storage.getDatabase();
+        const toolRows = db.prepare(`SELECT tool_name, COUNT(*) as cnt
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?
+              AND tool_name IS NOT NULL AND tool_name != ''
+              AND hook_type = 'PreToolUse'
+        GROUP BY tool_name
+        ORDER BY cnt DESC`).all(week.startISO, week.endISO);
+        const totalCalls = toolRows.reduce((sum, r) => sum + r.cnt, 0);
+        const topTools = toolRows.slice(0, 5).map(r => ({ name: r.tool_name, count: r.cnt }));
+        // Failure detection: PostToolUse with error keyword in tool_output
+        const failureRow = db.prepare(`SELECT COUNT(*) as failed
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?
+              AND hook_type = 'PostToolUse'
+              AND tool_output IS NOT NULL
+              AND (tool_output LIKE '%"error"%'
+                OR tool_output LIKE '%"is_error":true%'
+                OR tool_output LIKE '%"isError":true%')`).get(week.startISO, week.endISO);
+        const postCallRow = db.prepare(`SELECT COUNT(*) as total
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?
+              AND hook_type = 'PostToolUse'`).get(week.startISO, week.endISO);
+        const failureRate = postCallRow.total > 0
+            ? `${((failureRow.failed / postCallRow.total) * 100).toFixed(1)}%`
+            : '0.0%';
+        return {
+            totalCalls,
+            topTools,
+            failureRate,
+        };
+    }
+    aggregateFiles(week) {
+        const db = this.storage.getDatabase();
+        const placeholders = Array.from(FILE_EDIT_TOOLS).map(() => '?').join(',');
+        const rows = db.prepare(`SELECT tool_input
+         FROM events
+        WHERE timestamp >= ? AND timestamp < ?
+              AND hook_type = 'PreToolUse'
+              AND tool_name IN (${placeholders})
+              AND tool_input IS NOT NULL`).all(week.startISO, week.endISO, ...Array.from(FILE_EDIT_TOOLS));
+        const fileMap = new Map();
+        let totalEdits = 0;
+        for (const row of rows) {
+            try {
+                const input = JSON.parse(row.tool_input);
+                const path = input.file_path || input.notebook_path;
+                if (typeof path === 'string' && path.length > 0) {
+                    fileMap.set(path, (fileMap.get(path) || 0) + 1);
+                    totalEdits++;
+                }
+            }
+            catch {
+                // skip malformed JSON
+            }
+        }
+        const topEdited = Array.from(fileMap.entries())
+            .map(([path, editCount]) => ({ path, editCount }))
+            .sort((a, b) => b.editCount - a.editCount)
+            .slice(0, 5);
+        return { topEdited, totalEdits };
+    }
+    aggregateAnomalies(_week) {
+        // anti-pattern-detector.ts is being implemented by another agent.
+        // Return empty array until it's available.
+        return [];
+    }
+    // ── Helper methods ──────────────────────────────────────────────────
+    /**
+     * 计算 ISO 周的起止时间（周一 00:00:00 — 下周一 00:00:00）。
+     * weekOffset: 0 = 本周, -1 = 上周, -2 = 上上周
+     */
+    computeWeekRange(weekOffset) {
+        const now = new Date();
+        // 计算本周一（ISO week 起点）
+        const dayOfWeek = now.getDay(); // 0=Sun, 1=Mon, ...
+        const daysFromMonday = (dayOfWeek + 6) % 7; // Mon=0, Tue=1, ..., Sun=6
+        const monday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - daysFromMonday + weekOffset * 7, 0, 0, 0, 0);
+        const nextMonday = new Date(monday);
+        nextMonday.setDate(monday.getDate() + 7);
+        return {
+            startMs: monday.getTime(),
+            endMs: nextMonday.getTime(),
+            startISO: monday.toISOString(),
+            endISO: nextMonday.toISOString(),
+            isoWeekNumber: getISOWeekNumber(monday),
+        };
+    }
+    // ── Markdown rendering ──────────────────────────────────────────────
+    toMarkdown(report) {
+        const { week, overview, agentDelegation, skills, tools, files, anomalies } = report;
+        const lines = [];
+        lines.push(`# 周报 — 第 ${week.isoWeekNumber} 周`);
+        lines.push('');
+        lines.push(`**周期**: ${week.start.slice(0, 10)} ~ ${week.end.slice(0, 10)}`);
+        lines.push(`**生成时间**: ${report.generatedAt}`);
+        lines.push('');
+        lines.push('## 概览');
+        lines.push('');
+        lines.push(`- 总会话数: **${overview.totalSessions}**`);
+        lines.push(`- 总事件数: **${overview.totalEvents}**`);
+        lines.push(`- 总任务数: **${overview.totalTasks}**`);
+        lines.push(`- 活跃天数: **${overview.activeDays}** 天`);
+        lines.push(`- 活跃项目: ${overview.activeProjects.length} 个`);
+        if (overview.activeProjects.length > 0) {
+            for (const p of overview.activeProjects) {
+                lines.push(`  - \`${p}\``);
+            }
+        }
+        lines.push('');
+        lines.push('## Agent 委托');
+        lines.push('');
+        lines.push(`- 总路由数: **${agentDelegation.totalPrompts}**`);
+        lines.push(`- 委托数: **${agentDelegation.delegations}**`);
+        lines.push(`- 委托率: **${agentDelegation.rate}** (环比 ${agentDelegation.weekOverWeek})`);
+        if (agentDelegation.topAgents.length > 0) {
+            lines.push('');
+            lines.push('**Top Agents**:');
+            lines.push('');
+            lines.push('| Agent | 调用次数 |');
+            lines.push('| --- | ---: |');
+            for (const a of agentDelegation.topAgents) {
+                lines.push(`| ${a.agent} | ${a.count} |`);
+            }
+        }
+        lines.push('');
+        lines.push('## Skills');
+        lines.push('');
+        lines.push(`- 调用总数: **${skills.invocations}**`);
+        lines.push(`- 不同 Skill: **${skills.distinct}**`);
+        if (skills.topSkills.length > 0) {
+            lines.push('');
+            lines.push('**Top Skills**:');
+            lines.push('');
+            lines.push('| Skill | 调用次数 |');
+            lines.push('| --- | ---: |');
+            for (const s of skills.topSkills) {
+                lines.push(`| ${s.skill_id} | ${s.count} |`);
+            }
+        }
+        if (skills.neverUsed.length > 0) {
+            lines.push('');
+            lines.push(`**从未使用** (${skills.neverUsed.length}): ${skills.neverUsed.map(s => `\`${s}\``).join(', ')}`);
+        }
+        lines.push('');
+        lines.push('## Tools');
+        lines.push('');
+        lines.push(`- 调用总数: **${tools.totalCalls}**`);
+        lines.push(`- 失败率: **${tools.failureRate}**`);
+        if (tools.topTools.length > 0) {
+            lines.push('');
+            lines.push('**Top Tools**:');
+            lines.push('');
+            lines.push('| Tool | 调用次数 |');
+            lines.push('| --- | ---: |');
+            for (const t of tools.topTools) {
+                lines.push(`| ${t.name} | ${t.count} |`);
+            }
+        }
+        lines.push('');
+        lines.push('## Files');
+        lines.push('');
+        lines.push(`- 编辑总数: **${files.totalEdits}**`);
+        if (files.topEdited.length > 0) {
+            lines.push('');
+            lines.push('**Top Edited**:');
+            lines.push('');
+            lines.push('| 文件 | 编辑次数 |');
+            lines.push('| --- | ---: |');
+            for (const f of files.topEdited) {
+                lines.push(`| \`${f.path}\` | ${f.editCount} |`);
+            }
+        }
+        lines.push('');
+        lines.push('## 异常');
+        lines.push('');
+        if (anomalies.length === 0) {
+            lines.push('本周无异常。');
+        }
+        else {
+            for (const a of anomalies) {
+                lines.push(`- **${a.type}**: ${a.description}`);
+            }
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+/**
+ * 计算 ISO 8601 周数。
+ */
+function getISOWeekNumber(date) {
+    const target = new Date(date.getTime());
+    // ISO 周以周四为锚点
+    target.setHours(0, 0, 0, 0);
+    target.setDate(target.getDate() + 3 - ((target.getDay() + 6) % 7));
+    const week1 = new Date(target.getFullYear(), 0, 4);
+    return 1 + Math.round(((target.getTime() - week1.getTime()) / 86400000
+        - 3 + ((week1.getDay() + 6) % 7)) / 7);
+}
+//# sourceMappingURL=weekly-report.js.map

package/dist/daemon/services/weekly-report.js.map

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

package/dist/hooks/hook-lib.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# Claude Forge - Hook shared library
+# Source this file at the top of each hook script:
+#   source "$(dirname "$0")/hook-lib.sh"
+#
+# Provides:
+#   - SOCKET_PATH, QUEUE_DIR shared variables
+#   - send_event_or_enqueue() function
+
+SOCKET_PATH="${CLAUDE_FORGE_SOCKET:-$HOME/.claude-forge/daemon.sock}"
+QUEUE_DIR="$HOME/.claude-forge/queue"
+
+# send_event_or_enqueue <event_json> [timeout_seconds]
+#
+# 1. If socket file does not exist → enqueue in background → return empty string
+# 2. If socket exists → send via nc with timeout
+#    - nc exit code != 0 → enqueue in background → return empty string
+#    - nc exit code == 0 → return daemon response on stdout
+#
+# The caller reads REPLY_RESPONSE after calling this function:
+#   send_event_or_enqueue "$EVENT" 10
+#   RESPONSE="$HOOK_RESPONSE"
+#
+# macOS BSD nc notes:
+#   - `nc -U` opens a Unix domain socket connection
+#   - `-w N` sets idle timeout (seconds); on macOS this is the "connection timeout"
+#     for UDP but for TCP/Unix it's inactivity timeout after connection
+#   - Exit code: 0 = success (data sent + connection closed by remote), 1 = error
+#   - An empty response (daemon returns nothing) still exits 0 if the connection
+#     was established and closed cleanly → we check exit code, NOT response content
+
+HOOK_RESPONSE=""
+
+send_event_or_enqueue() {
+  local event_json="$1"
+  local timeout_secs="${2:-10}"
+
+  HOOK_RESPONSE=""
+
+  # Fast path: no socket file → daemon is not running
+  if [ ! -S "$SOCKET_PATH" ]; then
+    _enqueue_event_bg "$event_json"
+    return 0
+  fi
+
+  # Socket exists: try to send; capture exit code separately from stdout
+  local tmp_response
+  tmp_response=$(echo "$event_json" | nc -U -w "$timeout_secs" "$SOCKET_PATH" 2>/dev/null)
+  local nc_exit=$?
+
+  if [ $nc_exit -ne 0 ]; then
+    # nc failed (connection refused, socket disappeared between check and send, etc.)
+    _enqueue_event_bg "$event_json"
+    return 0
+  fi
+
+  # Success: pass response back to caller
+  HOOK_RESPONSE="$tmp_response"
+}
+
+# _enqueue_event_bg <event_json>
+# Forks a background subshell to write the event JSON to the queue directory.
+# The main hook process is never blocked by this operation.
+_enqueue_event_bg() {
+  local event_json="$1"
+  (
+    mkdir -p "$QUEUE_DIR"
+    # Timestamp with second precision (BSD date has no %N nanoseconds)
+    local ts
+    ts=$(date -u +"%Y%m%dT%H%M%S")
+    # UUID: prefer uuidgen (macOS), fall back to /proc on Linux
+    local uuid
+    uuid=$(uuidgen 2>/dev/null \
+      || cat /proc/sys/kernel/random/uuid 2>/dev/null \
+      || printf '%s-%s' "$$" "$RANDOM")
+    local filename="${ts}-${uuid}.json"
+    # Atomic write: write to temp file, then rename
+    local tmp_file="$QUEUE_DIR/.tmp-${filename}"
+    printf '%s' "$event_json" > "$tmp_file" && mv "$tmp_file" "$QUEUE_DIR/${filename}"
+  ) &
+}

package/dist/hooks/notification.sh

@@ -1,7 +1,9 @@
 #!/usr/bin/env bash
 # Claude Forge - Notification Hook
 
-SOCKET_PATH="${CLAUDE_FORGE_SOCKET:-$HOME/.claude-forge/daemon.sock}"
+# shellcheck source=./hook-lib.sh
+source "$(dirname "$0")/hook-lib.sh"
+
 AUTH_TOKEN=$(cat "$HOME/.claude-forge/daemon.token" 2>/dev/null || echo '')
 
 # 读取 stdin
@@ -14,7 +16,7 @@ SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // .sessionId // ""')
 SESSION_ID="${SESSION_ID:-${CLAUDE_CODE_SESSION_ID:-cli}}"
 
 # 构造事件 JSON（原始 INPUT 作为 tool_input，保留完整通知内容）
-TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S")
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
 TOOL_INPUT=$(echo "$INPUT" | jq -c '.')
 EVENT=$(jq -n \
   --arg hook_type "Notification" \
@@ -27,5 +29,7 @@ EVENT=$(jq -n \
     project_path: $project_path, tool_name: "notification",
     tool_input: $tool_input, _auth: $auth}')
 
-echo "$EVENT" | nc -U -w 1 "$SOCKET_PATH" 2>/dev/null || true
+# 发送到 daemon（1 秒超时；失败时入队）
+send_event_or_enqueue "$EVENT" 1
+
 exit 0