autosnippet 3.2.21 → 3.3.2

package/dist/lib/http/routes/remote.js

@@ -715,16 +715,12 @@ async function replyLark(messageId, text) {
 /**
  * 截取 IDE 窗口截图（通过 ScreenCaptureKit 原生 API，息屏时可用）
  * @param [opts.windowTitle] 窗口标题关键词（默认 "Code"）
- * @returns >}
  */
 async function captureIDEScreenshot(opts = {}) {
     try {
         const { screenshot } = await import('../../platform/ScreenCaptureService.js');
-        // 统一使用窗口截取（desktopIndependentWindow，亮屏/息屏均可用）
-        // 优先截取 IDE 窗口
         const windowTitle = opts.windowTitle || 'Code';
         let result = await screenshot({ windowTitle, format: 'png' });
-        // IDE 窗口未找到 → 尝试常见 IDE 名称
         if (!result.success) {
             for (const alt of ['Visual Studio', 'Cursor', 'Xcode', 'IntelliJ', 'WebStorm']) {
                 if (alt.toLowerCase() === windowTitle.toLowerCase()) {
@@ -736,7 +732,6 @@ async function captureIDEScreenshot(opts = {}) {
                 }
             }
         }
-        // 仍未找到 → 不指定窗口名，Swift 工具会自动选最大窗口
         if (!result.success) {
             logger.info(`[Remote/Screenshot] IDE window not found, capturing largest available window`);
             result = await screenshot({ format: 'png' });

package/dist/lib/http/routes/signals.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Signal & Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/signals/trace   — 查询信号留痕
+ *   GET /api/v1/signals/stats   — 信号统计
+ *   GET /api/v1/signals/reports — 查询管道报告
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/dist/lib/http/routes/signals.js

@@ -0,0 +1,104 @@
+/**
+ * Signal & Report API 路由
+ *
+ * 端点:
+ *   GET /api/v1/signals/trace   — 查询信号留痕
+ *   GET /api/v1/signals/stats   — 信号统计
+ *   GET /api/v1/signals/reports — 查询管道报告
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+const router = express.Router();
+/**
+ * GET /api/v1/signals/trace
+ * 查询信号留痕（支持 type / source / target / from / to / limit / offset）
+ */
+router.get('/trace', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const traceWriter = container.get('signalTraceWriter');
+        if (!traceWriter) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'SignalTraceWriter not available' },
+            });
+            return;
+        }
+        const typeParam = req.query.type;
+        const type = typeof typeParam === 'string' ? typeParam.split(',').filter(Boolean) : undefined;
+        const source = typeof req.query.source === 'string' ? req.query.source : undefined;
+        const target = typeof req.query.target === 'string' ? req.query.target : undefined;
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const limit = req.query.limit ? Math.min(Number(req.query.limit), 200) : undefined;
+        const offset = req.query.offset ? Number(req.query.offset) : undefined;
+        const result = await traceWriter.query({ type, source, target, from, to, limit, offset });
+        res.json({ success: true, data: result });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+/**
+ * GET /api/v1/signals/stats
+ * 信号统计（可选 from / to 时间范围）
+ */
+router.get('/stats', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const traceWriter = container.get('signalTraceWriter');
+        if (!traceWriter) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'SignalTraceWriter not available' },
+            });
+            return;
+        }
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const stats = await traceWriter.stats({ from, to });
+        res.json({ success: true, data: stats });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+/**
+ * GET /api/v1/signals/reports
+ * 查询管道报告（支持 category / type / from / to / limit / offset）
+ */
+router.get('/reports', async (req, res) => {
+    try {
+        const container = getServiceContainer();
+        const reportStore = container.get('reportStore');
+        if (!reportStore) {
+            res.status(503).json({
+                success: false,
+                error: { code: 'SERVICE_UNAVAILABLE', message: 'ReportStore not available' },
+            });
+            return;
+        }
+        const catParam = req.query.category;
+        const category = typeof catParam === 'string' ? catParam.split(',').filter(Boolean) : undefined;
+        const type = typeof req.query.type === 'string' ? req.query.type : undefined;
+        const from = req.query.from ? Number(req.query.from) : undefined;
+        const to = req.query.to ? Number(req.query.to) : undefined;
+        const limit = req.query.limit ? Math.min(Number(req.query.limit), 200) : undefined;
+        const offset = req.query.offset ? Number(req.query.offset) : undefined;
+        const result = await reportStore.query({ category, type, from, to, limit, offset });
+        res.json({ success: true, data: result });
+    }
+    catch (err) {
+        res.status(500).json({
+            success: false,
+            error: { code: 'INTERNAL_ERROR', message: err instanceof Error ? err.message : String(err) },
+        });
+    }
+});
+export default router;

package/dist/lib/http/routes/task.d.ts

@@ -1,9 +1,8 @@
 /**
- * TaskGraph HTTP API 路由
+ * Task HTTP API 路由 (v3.3 — Intent Lifecycle)
  *
  * 为 VS Code Extension `taskTool.ts` 提供 HTTP 转发端点。
- * Extension 通过 lm.registerTool 拦截 tokenBudget 后，
- * 将业务逻辑转发到此端点，由 TaskGraphService 执行。
+ * 5 operations: prime, create, close, fail, record_decision
  *
  * 端点:
  *   POST /api/v1/task  — 统一入口（operation 路由）

package/dist/lib/http/routes/task.js

@@ -1,15 +1,15 @@
 /**
- * TaskGraph HTTP API 路由
+ * Task HTTP API 路由 (v3.3 — Intent Lifecycle)
  *
  * 为 VS Code Extension `taskTool.ts` 提供 HTTP 转发端点。
- * Extension 通过 lm.registerTool 拦截 tokenBudget 后，
- * 将业务逻辑转发到此端点，由 TaskGraphService 执行。
+ * 5 operations: prime, create, close, fail, record_decision
  *
  * 端点:
  *   POST /api/v1/task  — 统一入口（operation 路由）
  */
 import express from 'express';
 import { TaskDispatchBody } from '#shared/schemas/http-requests.js';
+import { taskHandler } from '../../external/mcp/handlers/task.js';
 import { getServiceContainer } from '../../injection/ServiceContainer.js';
 import { validate } from '../middleware/validate.js';
 const router = express.Router();
@@ -24,357 +24,27 @@ const router = express.Router();
  */
 router.post('/', validate(TaskDispatchBody), async (req, res) => {
     const container = getServiceContainer();
-    const taskService = container.get('taskGraphService');
-    if (!taskService) {
-        return void res.status(503).json({
-            success: false,
-            message: 'TaskGraphService not available',
-        });
-    }
-    const { operation, ...params } = req.body;
+    // Build a minimal McpContext for the task handler
+    const ctx = {
+        container,
+        session: req.__mcpSession ??
+            undefined,
+        startedAt: Date.now(),
+    };
     try {
-        const result = await _dispatch(taskService, operation, params);
-        if (result.success === false) {
-            return void res.status(400).json(result);
+        const result = await taskHandler(ctx, req.body);
+        const envelope = result;
+        if (envelope.success === false) {
+            return void res.status(400).json(envelope);
         }
-        return void res.json(result);
+        return void res.json(envelope);
     }
     catch (err) {
         return void res.status(400).json({
             success: false,
-            message: err.message,
-            operation,
+            message: err instanceof Error ? err.message : String(err),
+            operation: req.body.operation,
         });
     }
 });
-/** 操作路由 — 与 MCP handler/task.js 保持一致 */
-async function _dispatch(svc, operation, params) {
-    switch (operation) {
-        case 'create':
-            return _create(svc, params);
-        case 'ready':
-            return _ready(svc, params);
-        case 'claim':
-            return _claim(svc, params);
-        case 'close':
-            return _close(svc, params);
-        case 'fail':
-            return _fail(svc, params);
-        case 'defer':
-            return _defer(svc, params);
-        case 'progress':
-            return _progress(svc, params);
-        case 'prime':
-            return _prime(svc);
-        case 'decompose':
-            return _decompose(svc, params);
-        case 'show':
-            return _show(svc, params);
-        case 'list':
-            return _list(svc, params);
-        case 'blocked':
-            return _blocked(svc);
-        case 'dep_add':
-            return _depAdd(svc, params);
-        case 'dep_tree':
-            return _depTree(svc, params);
-        case 'stats':
-            return _stats(svc);
-        case 'record_decision':
-            return _recordDecision(svc, params);
-        case 'revise_decision':
-            return _reviseDecision(svc, params);
-        case 'unpin_decision':
-            return _unpinDecision(svc, params);
-        case 'list_decisions':
-            return _list(svc, { ...params, taskType: 'decision', status: params.status || 'pinned' });
-        default:
-            return { success: false, message: `Unknown operation: ${operation}` };
-    }
-}
-// ── create ──
-async function _create(svc, args) {
-    if (!args.title) {
-        return { success: false, message: 'title is required' };
-    }
-    const { task, isDuplicate } = await svc.create({
-        title: args.title,
-        description: args.description || '',
-        design: args.design || '',
-        acceptance: args.acceptance || '',
-        priority: args.priority ?? 2,
-        taskType: args.taskType || 'task',
-        parentId: args.parentId || null,
-    });
-    return {
-        success: true,
-        data: task.toJSON(),
-        message: isDuplicate
-            ? `Duplicate detected: ${task.id} already exists`
-            : `Created ${task.id}: ${task.title}`,
-    };
-}
-// ── ready ──
-async function _ready(svc, args) {
-    const tasks = await svc.ready({
-        limit: args.limit || 5,
-        withKnowledge: args.withKnowledge !== false,
-    });
-    return {
-        success: true,
-        data: tasks.map((t) => (t.toJSON ? t.toJSON() : t)),
-        count: tasks.length,
-    };
-}
-// ── claim ──
-async function _claim(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.claim(args.id, args.assignee || 'agent');
-    return { success: true, data: task.toJSON() };
-}
-// ── close ──
-async function _close(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const { task, newlyReady } = await svc.close(args.id, args.reason || 'Completed');
-    return {
-        success: true,
-        data: task.toJSON(),
-        newlyReady,
-        message: `Closed ${task.id}. ${newlyReady.length} tasks newly ready.`,
-    };
-}
-// ── fail ──
-async function _fail(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.fail(args.id, args.reason || '');
-    return { success: true, data: task.toJSON() };
-}
-// ── defer ──
-async function _defer(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.defer(args.id, args.reason || '');
-    return { success: true, data: task.toJSON() };
-}
-// ── progress ──
-async function _progress(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.progress(args.id, args.note || args.description || '');
-    return { success: true, data: task.toJSON() };
-}
-// ── prime ──
-async function _prime(svc) {
-    const result = await svc.prime({ withKnowledge: true });
-    const decisionCount = (result.decisions || []).length;
-    const staleCount = (result.staleDecisions || []).length;
-    const decisionTitles = (result.decisions || []).map((d) => d.title).join('; ');
-    const statsLine = `${result.inProgress.length} in-progress, ${result.ready.length} ready, ${result.stats.total} total`;
-    // ── Behavioral Rules Reminder (synced with MCP handler) ──
-    result._taskRules = {
-        reminder: [
-            '📋 TASK RULES (MANDATORY):',
-            '🔑 YOU are the task operator — user speaks naturally, you translate to task operations. NEVER tell user to run task commands.',
-            '• MUST prime on EVERY message BEFORE anything else',
-            '• MUST create task for non-trivial work (≥2 files OR ≥10 lines)',
-            '• MUST claim before coding, close when done with meaningful reason',
-            '• MUST handle unfinished tasks before starting new work (ask user: Continue/Defer/Abandon)',
-            '• NEVER skip prime, NEVER start new work with open in_progress tasks',
-            '• NEVER leave tasks in in_progress when session ends — close or defer ALL',
-            '• When in doubt → create a task. When idle → ready()',
-            '• Session end → close all tasks, defer incomplete, verify zero in_progress',
-        ].join('\n'),
-        translationHint: [
-            'User Says → You Run:',
-            '"fix bug"/"implement" → create→claim→code→close',
-            '"continue" → resume in-progress→close',
-            '"pause" → defer | "abandon" → fail | "break down" → decompose',
-            '"what\'s next" → ready() | "agreed" → record_decision',
-            'Quick question → No task. Just answer.',
-        ].join('\n'),
-    };
-    // ── Resume Prompt: 有 inProgress 任务时，提示 Agent 让用户选择 ──
-    if (result.inProgress.length > 0) {
-        const taskList = result.inProgress
-            .map((t) => {
-            const age = t.updatedAt
-                ? `${Math.floor((Date.now() / 1000 - t.updatedAt) / 86400)}d ago`
-                : '';
-            return `• **${t.id}** — ${t.title}${age ? ` (${age})` : ''}`;
-        })
-            .join('\n');
-        result._resumePrompt = {
-            instruction: [
-                'There are unfinished tasks. You MUST present these options to the user BEFORE doing anything else:',
-                '',
-                '**Unfinished tasks:**',
-                taskList,
-                '',
-                'Ask the user to choose:',
-                '1. **Continue** — resume the unfinished task(s)',
-                '2. **Defer** — pause it and work on something else',
-                '3. **Abandon** — close/fail it and start fresh',
-                '',
-                "Wait for the user's answer. Do NOT auto-resume.",
-            ].join('\n'),
-            taskIds: result.inProgress.map((t) => t.id),
-        };
-    }
-    let message;
-    if (decisionCount > 0) {
-        const stalePart = staleCount > 0 ? ` ${staleCount} stale.` : '';
-        message = `⚠️ ${decisionCount} ACTIVE DECISION(S): [${decisionTitles}].${stalePart} ${statsLine}.`;
-    }
-    else {
-        message = `${statsLine}.`;
-    }
-    if (result.inProgress.length > 0) {
-        message += ` ⏸️ ${result.inProgress.length} unfinished task(s) — ask user before resuming.`;
-    }
-    return {
-        success: true,
-        data: result,
-        message,
-    };
-}
-// ── decompose ──
-async function _decompose(svc, args) {
-    const epicId = args.parentId || args.id;
-    const subtasks = args.children || args.subtasks;
-    if (!epicId) {
-        return { success: false, message: 'parentId (or id) is required' };
-    }
-    if (!subtasks || !Array.isArray(subtasks)) {
-        return { success: false, message: 'children (or subtasks) array is required' };
-    }
-    const tasks = await svc.decompose(epicId, subtasks);
-    return {
-        success: true,
-        data: tasks.map((t) => t.toJSON()),
-        count: tasks.length,
-    };
-}
-// ── show ──
-async function _show(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.show(args.id);
-    if (!task) {
-        return { success: false, message: `Task ${args.id} not found` };
-    }
-    return { success: true, data: task.toJSON() };
-}
-// ── list ──
-async function _list(svc, args) {
-    const tasks = await svc.list({ status: args.status, taskType: args.taskType, parentId: args.parentId }, { limit: args.limit || 50 });
-    return {
-        success: true,
-        data: tasks.map((t) => t.toJSON()),
-        count: tasks.length,
-    };
-}
-// ── blocked ──
-async function _blocked(svc) {
-    const tasks = await svc.blocked();
-    return {
-        success: true,
-        data: tasks.map((t) => (t.toJSON ? t.toJSON() : t)),
-        count: tasks.length,
-    };
-}
-// ── dep_add ──
-async function _depAdd(svc, args) {
-    if (!args.taskId || !args.dependsOn) {
-        return { success: false, message: 'taskId and dependsOn are required' };
-    }
-    await svc.addDependency(args.taskId, args.dependsOn, args.depType || 'blocks');
-    return {
-        success: true,
-        message: `Dependency added: ${args.taskId} ${args.depType || 'blocks'} ${args.dependsOn}`,
-    };
-}
-// ── dep_tree ──
-async function _depTree(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const tree = await svc.depTree(args.id);
-    return { success: true, data: tree };
-}
-// ── stats ──
-async function _stats(svc) {
-    const stats = await svc.stats();
-    return { success: true, data: stats };
-}
-// ── record_decision ──
-async function _recordDecision(svc, args) {
-    if (!args.title) {
-        return { success: false, message: 'title is required' };
-    }
-    if (!args.description) {
-        return { success: false, message: 'description is required' };
-    }
-    const { task, isDuplicate } = await svc.recordDecision({
-        title: args.title,
-        description: args.description,
-        rationale: args.rationale || '',
-        tags: args.tags || [],
-        relatedTaskId: args.relatedTaskId || null,
-    });
-    return {
-        success: true,
-        data: task.toJSON(),
-        message: isDuplicate
-            ? `Decision already recorded: ${task.id}`
-            : `Decision pinned: ${task.id} — "${args.title}"`,
-    };
-}
-// ── revise_decision ──
-async function _reviseDecision(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id of old decision is required' };
-    }
-    if (!args.title) {
-        return { success: false, message: 'title of new decision is required' };
-    }
-    if (!args.description) {
-        return { success: false, message: 'description of new decision is required' };
-    }
-    const result = await svc.reviseDecision({
-        oldDecisionId: args.id,
-        title: args.title,
-        description: args.description,
-        rationale: args.rationale || '',
-        reason: args.reason || '',
-    });
-    return {
-        success: true,
-        data: {
-            newDecision: result.newDecision.toJSON(),
-            superseded: result.oldDecisionId,
-        },
-        message: `Decision revised: ${result.oldDecisionId} → ${result.newDecision.id}`,
-    };
-}
-// ── unpin_decision ──
-async function _unpinDecision(svc, args) {
-    if (!args.id) {
-        return { success: false, message: 'id is required' };
-    }
-    const task = await svc.unpinDecision(args.id, args.reason || '');
-    return {
-        success: true,
-        data: task.toJSON(),
-        message: `Decision ${args.id} unpinned and closed`,
-    };
-}
 export default router;

package/dist/lib/http/routes/violations.js

@@ -53,7 +53,7 @@ router.get('/stats', async (req, res) => {
 router.post('/clear', async (req, res) => {
     const container = getServiceContainer();
     const violationsStore = container.get('violationsStore');
-    const { ruleId, file, all } = req.body;
+    const { ruleId, file, all } = req.body || {};
     let cleared = 0;
     if (all) {
         cleared = (await violationsStore.clearAll());

package/dist/lib/infrastructure/audit/AuditLogger.d.ts

@@ -1,9 +1,14 @@
 import type { AuditStore } from './AuditStore.js';
+/** Minimal EventBus shape for optional audit event emission */
+interface AuditEventBus {
+    emit(event: string, data: unknown): void;
+}
 /** AuditLogger - 审计日志记录器 */
 export declare class AuditLogger {
+    #private;
     auditStore: AuditStore;
     logger: import('winston').Logger;
-    constructor(auditStore: AuditStore);
+    constructor(auditStore: AuditStore, eventBus?: AuditEventBus | null);
     /**
      * 记录审计日志
      * 兼容两种传入格式:

package/dist/lib/infrastructure/audit/AuditLogger.js

@@ -3,9 +3,11 @@ import Logger from '../../infrastructure/logging/Logger.js';
 export class AuditLogger {
     auditStore;
     logger;
-    constructor(auditStore) {
+    #eventBus;
+    constructor(auditStore, eventBus) {
         this.auditStore = auditStore;
         this.logger = Logger.getInstance();
+        this.#eventBus = eventBus ?? null;
     }
     /**
      * 记录审计日志
@@ -40,6 +42,17 @@ export class AuditLogger {
                 actor: entry.actor,
                 action: entry.action,
             });
+            // 实时推送审计事件到 Dashboard（M7 §6 audit:entry Socket.io）
+            if (this.#eventBus) {
+                this.#eventBus.emit('audit:entry', {
+                    id: auditEntry.id,
+                    timestamp: auditEntry.timestamp,
+                    actor: auditEntry.actor,
+                    action: auditEntry.action,
+                    resource: auditEntry.resource,
+                    result: auditEntry.result,
+                });
+            }
         }
         catch (error) {
             // 审计失败不应阻断业务，仅记录错误