autosnippet 3.2.21 → 3.3.2

package/dist/lib/infrastructure/database/drizzle/schema.js

@@ -10,6 +10,7 @@
  *        bootstrap_dim_files, code_entities
  *   002: tasks, task_dependencies, task_events
  *   003: remote_commands
+ *   004: evolution_proposals (+ knowledge_entries.staging_deadline)
  *   内联: remote_state
  *   内部: schema_migrations
  */
@@ -77,6 +78,8 @@ export const knowledgeEntries = sqliteTable('knowledge_entries', {
     publishedBy: text('publishedBy'),
     // Content hash
     contentHash: text('contentHash'),
+    // M2: Staging support (migration 004)
+    stagingDeadline: integer('staging_deadline'),
 }, (table) => [
     index('idx_ke3_lifecycle').on(table.lifecycle),
     index('idx_ke3_language').on(table.language),
@@ -275,75 +278,7 @@ export const codeEntities = sqliteTable('code_entities', {
     index('idx_ce_superclass').on(table.superclass),
 ]);
 // ═══════════════════════════════════════════════════════════════
-// 11. tasks — 任务表 (migration 002)
-// ═══════════════════════════════════════════════════════════════
-export const tasks = sqliteTable('tasks', {
-    id: text('id').primaryKey(),
-    parentId: text('parent_id'),
-    childSeq: integer('child_seq').default(0),
-    title: text('title').notNull(),
-    description: text('description').default(''),
-    design: text('design').default(''),
-    acceptance: text('acceptance').default(''),
-    notes: text('notes').default(''),
-    status: text('status').notNull().default('open'),
-    priority: integer('priority').notNull().default(2),
-    taskType: text('task_type').notNull().default('task'),
-    closeReason: text('close_reason').default(''),
-    contentHash: text('content_hash').default(''),
-    failCount: integer('fail_count').default(0),
-    lastFailReason: text('last_fail_reason').default(''),
-    assignee: text('assignee').default(''),
-    createdBy: text('created_by').default('agent'),
-    createdAt: integer('created_at').notNull(),
-    updatedAt: integer('updated_at').notNull(),
-    closedAt: integer('closed_at'),
-    metadata: text('metadata').default('{}'),
-}, (table) => [
-    index('idx_tasks_status').on(table.status),
-    index('idx_tasks_priority').on(table.priority),
-    index('idx_tasks_parent').on(table.parentId),
-    index('idx_tasks_type').on(table.taskType),
-    index('idx_tasks_assignee').on(table.assignee),
-    index('idx_tasks_created').on(table.createdAt),
-    index('idx_tasks_hash').on(table.contentHash),
-]);
-// ═══════════════════════════════════════════════════════════════
-// 12. task_dependencies — 任务依赖表 (migration 002)
-// ═══════════════════════════════════════════════════════════════
-export const taskDependencies = sqliteTable('task_dependencies', {
-    id: integer('id').primaryKey({ autoIncrement: true }),
-    taskId: text('task_id').notNull(),
-    dependsOnId: text('depends_on_id').notNull(),
-    depType: text('dep_type').notNull().default('blocks'),
-    metadata: text('metadata').default('{}'),
-    createdAt: integer('created_at').notNull(),
-    createdBy: text('created_by').default('agent'),
-}, (table) => [
-    uniqueIndex('task_dependencies_unique').on(table.taskId, table.dependsOnId, table.depType),
-    index('idx_td_task').on(table.taskId),
-    index('idx_td_depends_on').on(table.dependsOnId),
-    index('idx_td_type').on(table.depType),
-]);
-// ═══════════════════════════════════════════════════════════════
-// 13. task_events — 任务事件审计表 (migration 002)
-// ═══════════════════════════════════════════════════════════════
-export const taskEvents = sqliteTable('task_events', {
-    id: integer('id').primaryKey({ autoIncrement: true }),
-    taskId: text('task_id').notNull(),
-    eventType: text('event_type').notNull(),
-    actor: text('actor').default('agent'),
-    oldValue: text('old_value'),
-    newValue: text('new_value'),
-    comment: text('comment'),
-    createdAt: integer('created_at').notNull(),
-}, (table) => [
-    index('idx_te_task').on(table.taskId),
-    index('idx_te_type').on(table.eventType),
-    index('idx_te_created').on(table.createdAt),
-]);
-// ═══════════════════════════════════════════════════════════════
-// 14. remote_commands — 远程指令队列 (migration 003)
+// 11. remote_commands — 远程指令队列 (migration 003)
 // ═══════════════════════════════════════════════════════════════
 export const remoteCommands = sqliteTable('remote_commands', {
     id: text('id').primaryKey(),
@@ -370,3 +305,27 @@ export const remoteState = sqliteTable('remote_state', {
     value: text('value'),
     updatedAt: integer('updated_at'),
 });
+// ═══════════════════════════════════════════════════════════════
+// 16. evolution_proposals — 知识进化提案 (M2 Recipe 治理)
+// ═══════════════════════════════════════════════════════════════
+export const evolutionProposals = sqliteTable('evolution_proposals', {
+    id: text('id').primaryKey(),
+    type: text('type').notNull(),
+    targetRecipeId: text('target_recipe_id').notNull(),
+    relatedRecipeIds: text('related_recipe_ids').default('[]'),
+    confidence: real('confidence').notNull().default(0),
+    source: text('source').notNull(),
+    description: text('description').default(''),
+    evidence: text('evidence').default('[]'),
+    status: text('status').notNull().default('pending'),
+    proposedAt: integer('proposed_at').notNull(),
+    expiresAt: integer('expires_at').notNull(),
+    resolvedAt: integer('resolved_at'),
+    resolvedBy: text('resolved_by'),
+    resolution: text('resolution'),
+}, (table) => [
+    index('idx_ep_status').on(table.status),
+    index('idx_ep_target').on(table.targetRecipeId),
+    index('idx_ep_expires').on(table.expiresAt),
+    index('idx_ep_source').on(table.source),
+]);

package/dist/lib/infrastructure/database/migrations/004_evolution_proposals.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Migration 004 — Evolution Proposals + Staging Support
+ *
+ * M2 Recipe 治理所需的 schema 扩展：
+ *   1. evolution_proposals 表 — 存储进化提案（矛盾/冗余/衰退/增强）
+ *   2. knowledge_entries 添加 staging_deadline 列
+ */
+export default function migrate(db: import('better-sqlite3').Database): void;

package/dist/lib/infrastructure/database/migrations/004_evolution_proposals.js

@@ -0,0 +1,43 @@
+/**
+ * Migration 004 — Evolution Proposals + Staging Support
+ *
+ * M2 Recipe 治理所需的 schema 扩展：
+ *   1. evolution_proposals 表 — 存储进化提案（矛盾/冗余/衰退/增强）
+ *   2. knowledge_entries 添加 staging_deadline 列
+ */
+export default function migrate(db) {
+    db.exec(`
+    -- 进化提案表
+    CREATE TABLE IF NOT EXISTS evolution_proposals (
+      id              TEXT PRIMARY KEY,
+      type            TEXT NOT NULL,
+      target_recipe_id TEXT NOT NULL,
+      related_recipe_ids TEXT DEFAULT '[]',
+      confidence      REAL NOT NULL DEFAULT 0,
+      source          TEXT NOT NULL,
+      description     TEXT DEFAULT '',
+      evidence        TEXT DEFAULT '[]',
+      status          TEXT NOT NULL DEFAULT 'pending',
+      proposed_at     INTEGER NOT NULL,
+      expires_at      INTEGER NOT NULL,
+      resolved_at     INTEGER,
+      resolved_by     TEXT,
+      resolution      TEXT,
+
+      FOREIGN KEY (target_recipe_id) REFERENCES knowledge_entries(id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_ep_status ON evolution_proposals(status);
+    CREATE INDEX IF NOT EXISTS idx_ep_target ON evolution_proposals(target_recipe_id);
+    CREATE INDEX IF NOT EXISTS idx_ep_expires ON evolution_proposals(expires_at);
+    CREATE INDEX IF NOT EXISTS idx_ep_source ON evolution_proposals(source);
+  `);
+    // knowledge_entries 添加 staging_deadline 列（兼容已有数据）
+    // 使用 ALTER TABLE — SQLite 不支持 IF NOT EXISTS for columns，需要 try/catch
+    try {
+        db.exec(`ALTER TABLE knowledge_entries ADD COLUMN staging_deadline INTEGER`);
+    }
+    catch {
+        // 列已存在，忽略
+    }
+}

package/dist/lib/infrastructure/logging/Logger.d.ts

@@ -23,5 +23,7 @@ export declare class Logger {
     static info(message: string, meta?: Record<string, unknown>): void;
     static warn(message: string, meta?: Record<string, unknown>): void;
     static error(message: string, meta?: Record<string, unknown>): void;
+    /** 审计日志 — 写入独立 audit.log，不受 LOG_LEVEL 控制 */
+    static audit(event: string, meta?: Record<string, unknown>): void;
 }
 export default Logger;

package/dist/lib/infrastructure/logging/Logger.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import winston from 'winston';
+import pathGuard from '../../shared/PathGuard.js';
 // Agent 系统相关标签 — 终端高亮显示
 const AGENT_TAGS = [
     'AgentRuntime',
@@ -11,7 +12,7 @@ const AGENT_TAGS = [
     'CircuitBreaker',
     'EventAggregator',
 ];
-const MUTED_PREFIXES = ['HTTP Request', 'Tool registered:', '📊 性能统计已更新'];
+const MUTED_PREFIXES = ['Tool registered:'];
 // ANSI 颜色常量 — 保证深色终端可读性
 const C = {
     reset: '\x1b[0m',
@@ -33,6 +34,19 @@ const LEVEL_COLORS = {
     info: C.green,
     debug: C.blue,
 };
+/**
+ * 静音过滤器（winston format）
+ * 通过 transform 返回 false 彻底丢弃匹配消息，避免空行。
+ * 注意：printf 返回 '' 并不会被 winston 跳过，Console transport 仍会写 '\n'。
+ */
+const muteFilter = winston.format((info) => {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI escape sequence stripping
+    const rawLevel = info.level.replace(/\u001b\[\d+m/g, '');
+    if (rawLevel === 'info' && MUTED_PREFIXES.some((p) => info.message.startsWith(p))) {
+        return false;
+    }
+    return info;
+});
 /**
  * 精简 Console 格式
  * - Agent 相关日志: 高亮 cyan/magenta，显示完整信息
@@ -50,10 +64,6 @@ const compactConsoleFormat = winston.format.printf(({ level, message, timestamp,
     // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI escape sequence stripping
     const rawLevel = level.replace(/\u001b\[\d+m/g, ''); // 去 ANSI
     const lc = LEVEL_COLORS[rawLevel] || C.gray;
-    // 静音高频噪音日志
-    if (rawLevel === 'info' && MUTED_PREFIXES.some((p) => message.startsWith(p))) {
-        return ''; // 返回空字符串会被 winston 跳过
-    }
     // 判断是否为 Agent 相关日志
     const isAgentLog = AGENT_TAGS.some((tag) => message.includes(tag) || message.startsWith(`[${tag}]`));
     if (isAgentLog) {
@@ -98,7 +108,12 @@ export class Logger {
     static instance = null;
     static getInstance(config = {}) {
         if (!this.instance) {
-            const logsDir = config.file?.path || './.autosnippet/logs';
+            const rawLogsDir = config.file?.path || './.autosnippet/logs';
+            // 与 DatabaseConnection 一致：相对路径按 PathGuard.projectRoot 解析，避免 MCP cwd 非项目目录时写到错误位置
+            const projectRoot = pathGuard.projectRoot;
+            const logsDir = projectRoot && !path.isAbsolute(rawLogsDir)
+                ? path.resolve(projectRoot, rawLogsDir)
+                : path.resolve(rawLogsDir);
             // 确保日志目录存在
             if (!fs.existsSync(logsDir)) {
                 fs.mkdirSync(logsDir, { recursive: true });
@@ -110,7 +125,7 @@ export class Logger {
             if (config.console !== false && !isMcpMode) {
                 transports.push(new winston.transports.Console({
                     stderrLevels: ['error', 'warn', 'info', 'debug'],
-                    format: winston.format.combine(winston.format.timestamp(), compactConsoleFormat),
+                    format: winston.format.combine(winston.format.timestamp(), muteFilter(), compactConsoleFormat),
                 }));
             }
             // File transports
@@ -124,6 +139,14 @@ export class Logger {
                     filename: path.join(logsDir, 'combined.log'),
                     format: winston.format.json(),
                 }));
+                // audit 独立通道 — 不受 LOG_LEVEL 影响，业务关键事件永不丢失
+                transports.push(new winston.transports.File({
+                    filename: path.join(logsDir, 'audit.log'),
+                    level: 'info',
+                    format: winston.format.combine(winston.format((info) => {
+                        return info.audit === true ? info : false;
+                    })(), winston.format.timestamp(), winston.format.json()),
+                }));
             }
             this.instance = winston.createLogger({
                 level: logLevel,
@@ -145,5 +168,9 @@ export class Logger {
     static error(message, meta = {}) {
         this.getInstance().error(message, meta);
     }
+    /** 审计日志 — 写入独立 audit.log，不受 LOG_LEVEL 控制 */
+    static audit(event, meta = {}) {
+        this.getInstance().info(event, { ...meta, audit: true });
+    }
 }
 export default Logger;

package/dist/lib/infrastructure/monitoring/ErrorTracker.js

@@ -4,6 +4,7 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import pathGuard from '../../shared/PathGuard.js';
 import Logger from '../logging/Logger.js';
 export class ErrorTracker {
     criticalErrors;
@@ -14,7 +15,8 @@ export class ErrorTracker {
     reportInterval;
     constructor(options = {}) {
         this.config = {
-            logDirectory: options.logDirectory || path.join(process.cwd(), '.autosnippet', 'logs', 'errors'),
+            logDirectory: options.logDirectory ||
+                path.join(pathGuard.projectRoot ?? process.cwd(), '.autosnippet', 'logs', 'errors'),
             maxErrorsInMemory: options.maxErrorsInMemory || 500,
             enableFileLogging: options.enableFileLogging !== false,
             enableConsoleLogging: options.enableConsoleLogging !== false,

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.d.ts

@@ -56,8 +56,8 @@ export declare class PerformanceMonitor {
     }, next: () => void) => void;
     /** 记录请求 */
     recordRequest(requestData: RequestData): void;
-    /** 计算统计数据 */
-    calculateStats(): void;
+    /** 计算统计数据。silent=true 时不输出日志（定时器调用） */
+    calculateStats(silent?: boolean): void;
     /** 获取统计信息 */
     getStats(): {
         summary: {

package/dist/lib/infrastructure/monitoring/PerformanceMonitor.js

@@ -27,7 +27,7 @@ export class PerformanceMonitor {
             maxSlowRequests: 100, // 最多保留慢请求数
         };
         // 定期计算统计数据（unref 避免阻止进程退出）
-        this.statsInterval = setInterval(() => this.calculateStats(), 30000);
+        this.statsInterval = setInterval(() => this.calculateStats(true), 30000);
         if (this.statsInterval.unref) {
             this.statsInterval.unref();
         }
@@ -117,8 +117,8 @@ export class PerformanceMonitor {
             Logger.warn(`🐢 慢请求: ${route} - ${duration}ms`);
         }
     }
-    /** 计算统计数据 */
-    calculateStats() {
+    /** 计算统计数据。silent=true 时不输出日志（定时器调用） */
+    calculateStats(silent = false) {
         const { total, errors } = this.metrics.requests;
         // 错误率
         this.metrics.errorRate = total > 0 ? ((errors / total) * 100).toFixed(2) : 0;
@@ -138,13 +138,15 @@ export class PerformanceMonitor {
             this.metrics.p95 = sorted[p95Index] || 0;
             this.metrics.p99 = sorted[p99Index] || 0;
         }
-        Logger.info('📊 性能统计已更新', {
-            requests: total,
-            errors,
-            errorRate: `${this.metrics.errorRate}%`,
-            avgResponseTime: `${this.metrics.averageResponseTime}ms`,
-            rpm: this.metrics.rpm,
-        });
+        if (!silent) {
+            Logger.debug('📊 性能统计已更新', {
+                requests: total,
+                errors,
+                errorRate: `${this.metrics.errorRate}%`,
+                avgResponseTime: `${this.metrics.averageResponseTime}ms`,
+                rpm: this.metrics.rpm,
+            });
+        }
     }
     /** 获取统计信息 */
     getStats() {

package/dist/lib/infrastructure/notification/LarkNotifier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LarkNotifier — Lark notification transport
+ *
+ * Extracted from task.ts. Sends task progress notifications via API Server → Lark.
+ * All methods are non-blocking and fire-and-forget.
+ *
+ * @module infrastructure/notification/LarkNotifier
+ */
+interface NotifyArgs {
+    id?: string;
+    title?: string;
+    reason?: string;
+    [key: string]: unknown;
+}
+interface NotifyResult {
+    success: boolean;
+    data?: unknown;
+}
+/**
+ * Send task progress notification to Lark (async, non-blocking).
+ * Fire-and-forget — failures are logged to stderr but never throw.
+ */
+export declare function notifyTaskProgress(operation: string, args: NotifyArgs, result: NotifyResult): Promise<void>;
+export {};

package/dist/lib/infrastructure/notification/LarkNotifier.js

@@ -0,0 +1,97 @@
+/**
+ * LarkNotifier — Lark notification transport
+ *
+ * Extracted from task.ts. Sends task progress notifications via API Server → Lark.
+ * All methods are non-blocking and fire-and-forget.
+ *
+ * @module infrastructure/notification/LarkNotifier
+ */
+// ── Internal Transport ──────────────────────────────
+async function sendLarkViaApi(text) {
+    try {
+        const port = process.env.PORT || 3000;
+        const resp = await fetch(`http://localhost:${port}/api/v1/remote/notify`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ text }),
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!resp.ok) {
+            process.stderr.write(`[LarkNotifier] HTTP ${resp.status}\n`);
+            return false;
+        }
+        const body = (await resp.json());
+        return body.success === true;
+    }
+    catch (err) {
+        process.stderr.write(`[LarkNotifier] notify failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return false;
+    }
+}
+async function sendScreenshotViaApi(caption = '') {
+    try {
+        const port = process.env.PORT || 3000;
+        const resp = await fetch(`http://localhost:${port}/api/v1/remote/screenshot`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ caption }),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!resp.ok) {
+            process.stderr.write(`[LarkNotifier] Screenshot HTTP ${resp.status}\n`);
+            return false;
+        }
+        const body = (await resp.json());
+        return body.success === true;
+    }
+    catch (err) {
+        process.stderr.write(`[LarkNotifier] Screenshot failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return false;
+    }
+}
+// ── Public API ──────────────────────────────────────
+/**
+ * Send task progress notification to Lark (async, non-blocking).
+ * Fire-and-forget — failures are logged to stderr but never throw.
+ */
+export async function notifyTaskProgress(operation, args, result) {
+    if (!result || result.success === false) {
+        return;
+    }
+    const data = result.data;
+    let text = '';
+    switch (operation) {
+        case 'create': {
+            const title = data?.title || args.title || '';
+            const id = data?.id || '';
+            text = `📋 新任务: ${id}\n${title}`;
+            break;
+        }
+        case 'close': {
+            const closed = (data?.closed || data);
+            const title = closed?.title || args.title || '';
+            const id = closed?.id || args.id;
+            const reason = closed?.reason || args.reason || '';
+            text = `✅ 完成: ${id}\n${title}\n原因: ${reason}`;
+            break;
+        }
+        case 'fail': {
+            const failed = (data?.failed || data);
+            const id = failed?.id || args.id;
+            const reason = failed?.reason || args.reason || '未知';
+            text = `❌ 失败: ${id}\n原因: ${reason}`;
+            break;
+        }
+        case 'record_decision': {
+            const title = args.title || '';
+            text = `📌 决策: ${title}`;
+            break;
+        }
+        default:
+            return;
+    }
+    if (text) {
+        await sendLarkViaApi(text);
+        await sendScreenshotViaApi();
+    }
+}

package/dist/lib/infrastructure/report/ReportStore.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ReportStore — 报告持久化服务
+ *
+ * 管道产物（governance / compliance / metrics / analysis）写入 JSONL，
+ * 供 API 查询历史报告。
+ *
+ * @module infrastructure/report/ReportStore
+ */
+export type ReportCategory = 'governance' | 'compliance' | 'metrics' | 'analysis';
+export interface ReportEntry {
+    /** 自动生成 `rpt-{date}-{rand}` */
+    id: string;
+    category: ReportCategory;
+    /** 如 'metabolism_cycle', 'redundancy_report' */
+    type: string;
+    /** 生产者类名 */
+    producer: string;
+    data: Record<string, unknown>;
+    timestamp: number;
+    duration_ms?: number;
+}
+export interface ReportQueryOptions {
+    category?: ReportCategory[];
+    type?: string;
+    from?: number;
+    to?: number;
+    limit?: number;
+    offset?: number;
+}
+export declare class ReportStore {
+    #private;
+    constructor(baseDir: string);
+    /** 写入一条报告（追加 JSONL） */
+    write(entry: Omit<ReportEntry, 'id'>): Promise<ReportEntry>;
+    /** 查询报告列表 */
+    query(opts?: ReportQueryOptions): Promise<{
+        reports: ReportEntry[];
+        total: number;
+    }>;
+    /** 分类统计 */
+    stats(opts?: {
+        from?: number;
+        to?: number;
+    }): Promise<Record<string, number>>;
+}

package/dist/lib/infrastructure/report/ReportStore.js

@@ -0,0 +1,133 @@
+/**
+ * ReportStore — 报告持久化服务
+ *
+ * 管道产物（governance / compliance / metrics / analysis）写入 JSONL，
+ * 供 API 查询历史报告。
+ *
+ * @module infrastructure/report/ReportStore
+ */
+import { randomBytes } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Constants ───────────────────────────────────────
+const VALID_CATEGORIES = new Set([
+    'governance',
+    'compliance',
+    'metrics',
+    'analysis',
+]);
+// ── ReportStore ─────────────────────────────────────
+export class ReportStore {
+    #baseDir;
+    constructor(baseDir) {
+        this.#baseDir = baseDir;
+    }
+    /** 写入一条报告（追加 JSONL） */
+    async write(entry) {
+        const id = ReportStore.#generateId(entry.timestamp);
+        const full = { id, ...entry };
+        const filePath = this.#resolveFile(entry.category, entry.timestamp);
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.appendFileSync(filePath, `${JSON.stringify(full)}\n`, 'utf8');
+        return full;
+    }
+    /** 查询报告列表 */
+    async query(opts = {}) {
+        const categories = opts.category?.length
+            ? opts.category.filter((c) => VALID_CATEGORIES.has(c))
+            : [...VALID_CATEGORIES];
+        const all = [];
+        for (const cat of categories) {
+            const catDir = path.join(this.#baseDir, cat);
+            if (!fs.existsSync(catDir)) {
+                continue;
+            }
+            const files = fs
+                .readdirSync(catDir)
+                .filter((f) => f.endsWith('.jsonl'))
+                .sort()
+                .reverse();
+            for (const file of files) {
+                const entries = this.#readJsonl(path.join(catDir, file));
+                all.push(...entries);
+            }
+        }
+        // 过滤
+        let filtered = all;
+        if (opts.type) {
+            filtered = filtered.filter((e) => e.type === opts.type);
+        }
+        if (opts.from) {
+            filtered = filtered.filter((e) => e.timestamp >= opts.from);
+        }
+        if (opts.to) {
+            filtered = filtered.filter((e) => e.timestamp <= opts.to);
+        }
+        // 按时间倒序
+        filtered.sort((a, b) => b.timestamp - a.timestamp);
+        const total = filtered.length;
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? 20;
+        const reports = filtered.slice(offset, offset + limit);
+        return { reports, total };
+    }
+    /** 分类统计 */
+    async stats(opts = {}) {
+        const result = {};
+        for (const cat of VALID_CATEGORIES) {
+            const catDir = path.join(this.#baseDir, cat);
+            if (!fs.existsSync(catDir)) {
+                result[cat] = 0;
+                continue;
+            }
+            const files = fs.readdirSync(catDir).filter((f) => f.endsWith('.jsonl'));
+            let count = 0;
+            for (const file of files) {
+                const entries = this.#readJsonl(path.join(catDir, file));
+                for (const e of entries) {
+                    if (opts.from && e.timestamp < opts.from) {
+                        continue;
+                    }
+                    if (opts.to && e.timestamp > opts.to) {
+                        continue;
+                    }
+                    count++;
+                }
+            }
+            result[cat] = count;
+        }
+        return result;
+    }
+    // ── Private ───────────────────────────────────────
+    #resolveFile(category, timestamp) {
+        const d = new Date(timestamp);
+        const dateStr = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+        return path.join(this.#baseDir, category, `${dateStr}.jsonl`);
+    }
+    #readJsonl(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf8');
+            const lines = content.split('\n').filter((l) => l.trim());
+            const entries = [];
+            for (const line of lines) {
+                try {
+                    entries.push(JSON.parse(line));
+                }
+                catch {
+                    // 跳过损坏行
+                }
+            }
+            return entries;
+        }
+        catch {
+            return [];
+        }
+    }
+    static #generateId(timestamp) {
+        const d = new Date(timestamp);
+        const dateStr = `${d.getFullYear()}${String(d.getMonth() + 1).padStart(2, '0')}${String(d.getDate()).padStart(2, '0')}`;
+        const rand = randomBytes(4).toString('hex');
+        return `rpt-${dateStr}-${rand}`;
+    }
+}

package/dist/lib/infrastructure/signal/SignalAggregator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SignalAggregator — 滑窗统计 + 异常检测
+ *
+ * 订阅可聚合的事实型信号，周期性写入 Report（统计）并在异常时发射 Signal。
+ *
+ * @module infrastructure/signal/SignalAggregator
+ */
+import type { ReportStore } from '../report/ReportStore.js';
+import type { SignalBus } from './SignalBus.js';
+export declare class SignalAggregator {
+    #private;
+    constructor(signalBus: SignalBus, reportStore: ReportStore, opts?: {
+        intervalMs?: number;
+        windowMs?: number;
+    });
+    start(): void;
+    stop(): void;
+}