autosnippet 3.2.10 → 3.2.12

package/dist/lib/external/mcp/handlers/system.d.ts

@@ -0,0 +1,95 @@
+/**
+ * MCP Handlers — 系统类
+ * health, capabilities
+ */
+import type { KnowledgeBaseStats, McpContext } from './types.js';
+export declare function health(ctx: McpContext): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        actionHints?: string[] | undefined;
+        issues?: string[] | undefined;
+        session?: {
+            id: string;
+            readyCalled: boolean;
+            toolCallCount: number;
+            toolsUsed: string[];
+            durationMs: number;
+        } | undefined;
+        status: string;
+        version: string | null;
+        uptime: number;
+        projectRoot: string;
+        ai: {
+            provider: string;
+            hasKey: boolean;
+        };
+        checks: {
+            database: boolean;
+            gateway: boolean;
+            vectorStore: boolean;
+        };
+        services: string[];
+        knowledgeBase: KnowledgeBaseStats | null;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export declare function capabilities(): {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        count: number;
+        tier: string;
+        categoryGuide: {
+            system: string;
+            search: string;
+            browse: string;
+            graph: string;
+            structure: string;
+            submit: string;
+            guard: string;
+            skill: string;
+            bootstrap: string;
+            admin: string;
+        };
+        byCategory: Record<string, string[]>;
+        tools: {
+            name: string;
+            tier: string;
+            description: string;
+            category: string;
+            gatewayGated: boolean;
+            params: {
+                description?: {} | undefined;
+                enum?: {} | undefined;
+                default?: {} | null | undefined;
+                name: string;
+                type: {};
+                required: boolean;
+            }[];
+        }[];
+        workflows: ({
+            name: string;
+            steps: string[];
+            tips: string;
+        } | {
+            name: string;
+            steps: string[];
+            tips?: undefined;
+        })[];
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+};
+//# sourceMappingURL=system.d.ts.map

package/dist/lib/external/mcp/handlers/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/system.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkJ3C;AAID,wBAAgB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoH3B"}

package/dist/lib/external/mcp/handlers/system.js

@@ -0,0 +1,260 @@
+/**
+ * MCP Handlers — 系统类
+ * health, capabilities
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
+import { PACKAGE_ROOT } from '../../../shared/package-root.js';
+import { envelope } from '../envelope.js';
+import { TIER_ORDER, TOOL_GATEWAY_MAP, TOOLS } from '../tools.js';
+export async function health(ctx) {
+    const checks = { database: false, gateway: false, vectorStore: false };
+    const issues = [];
+    let knowledgeBase = null;
+    // 1) AI 配置
+    let aiInfo = { provider: 'unknown', hasKey: false };
+    try {
+        const { getAiConfigInfo } = await import('#external/ai/AiFactory.js');
+        aiInfo = getAiConfigInfo();
+    }
+    catch (e) {
+        issues.push(`ai: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 2) Database 连通性 + 知识库统计
+    try {
+        const db = ctx.container.get('database');
+        if (db) {
+            db.prepare('SELECT 1').get();
+            checks.database = true;
+            // 知识库统计（轻量聚合查询）
+            try {
+                // V3: knowledge_entries 统一表（lifecycle 替代 status）
+                const rStats = db
+                    .prepare(`
+          SELECT COUNT(*) as total,
+            SUM(CASE WHEN lifecycle='active' THEN 1 ELSE 0 END) as active,
+            SUM(CASE WHEN kind='rule' THEN 1 ELSE 0 END) as rules,
+            SUM(CASE WHEN kind='pattern' THEN 1 ELSE 0 END) as patterns,
+            SUM(CASE WHEN kind='fact' THEN 1 ELSE 0 END) as facts
+          FROM knowledge_entries
+        `)
+                    .get();
+                const cPending = db
+                    .prepare(`
+          SELECT COUNT(*) as total,
+            SUM(CASE WHEN lifecycle='pending' THEN 1 ELSE 0 END) as pending
+          FROM knowledge_entries
+        `)
+                    .get();
+                knowledgeBase = {
+                    recipes: {
+                        total: rStats.total,
+                        active: rStats.active,
+                        rules: rStats.rules,
+                        patterns: rStats.patterns,
+                        facts: rStats.facts,
+                    },
+                    candidates: { total: cPending.total, pending: cPending.pending },
+                };
+            }
+            catch {
+                /* 统计查询失败不影响 health */
+            }
+        }
+    }
+    catch (e) {
+        issues.push(`database: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 3) Gateway 可用性
+    try {
+        const gw = ctx.container.get('gateway');
+        checks.gateway = !!gw;
+    }
+    catch (e) {
+        issues.push(`gateway: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 4) VectorStore 可用性
+    try {
+        const vs = ctx.container.get('vectorStore');
+        if (vs) {
+            const vsStats = typeof vs.getStats === 'function' ? await vs.getStats() : null;
+            checks.vectorStore = true;
+            if (vsStats) {
+                knowledgeBase =
+                    knowledgeBase ||
+                        {
+                            recipes: { total: 0, active: 0, rules: 0, patterns: 0, facts: 0 },
+                            candidates: { total: 0, pending: 0 },
+                        };
+                knowledgeBase.vectorIndex = {
+                    documentCount: vsStats.documentCount ?? vsStats.totalDocuments ?? 0,
+                };
+            }
+        }
+    }
+    catch (e) {
+        issues.push(`vectorStore: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 5) 版本号（从 AutoSnippet 包自身的 package.json 读取，不依赖 cwd）
+    if (!_pkgVersion) {
+        try {
+            const pkgPath = path.resolve(PACKAGE_ROOT, 'package.json');
+            _pkgVersion = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version || '2.0.0';
+        }
+        catch {
+            _pkgVersion = '2.0.0';
+        }
+    }
+    // 6) 综合状态
+    const allCritical = checks.database; // DB 是唯一硬性依赖
+    const status = allCritical ? 'ok' : 'degraded';
+    // 如果 DB 不可用但冷启动仍可执行，附加提示避免 Agent 浪费时间修复 DB
+    const actionHints = [];
+    if (!checks.database) {
+        actionHints.push('DB 不可用不影响冷启动：autosnippet_bootstrap 不依赖数据库（纯文件系统分析），可直接调用。DB 会在首次 submit_knowledge 时自动重试初始化。');
+    }
+    if (!knowledgeBase || knowledgeBase.recipes.total === 0) {
+        actionHints.push('知识库为空，建议执行冷启动：(1) 调用 autosnippet_bootstrap 获取 Mission Briefing → (2) 按维度分析代码并提交知识 → (3) 调用 autosnippet_dimension_complete 完成每个维度。');
+        actionHints.push('💡 冷启动前建议先加载 Skill 获取详细指引：autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })');
+    }
+    return envelope({
+        success: true,
+        data: {
+            status,
+            version: _pkgVersion,
+            uptime: Math.floor((Date.now() - (ctx.startedAt ?? Date.now())) / 1000),
+            projectRoot: resolveProjectRoot(ctx.container),
+            ai: aiInfo,
+            checks,
+            services: ctx.container.getServiceNames?.() ?? [],
+            knowledgeBase,
+            // P3: Session 信息
+            ...(ctx.session
+                ? {
+                    session: {
+                        id: ctx.session.id,
+                        readyCalled: ctx.session.readyCalled,
+                        toolCallCount: ctx.session.toolCallCount,
+                        toolsUsed: Array.from(ctx.session.toolsUsed),
+                        durationMs: Date.now() - ctx.session.startedAt,
+                    },
+                }
+                : {}),
+            ...(issues.length ? { issues } : {}),
+            ...(actionHints.length ? { actionHints } : {}),
+        },
+        meta: { tool: 'autosnippet_health' },
+    });
+}
+let _pkgVersion = null;
+export function capabilities() {
+    // V3 工具分类映射
+    const CATEGORY_MAP = {
+        autosnippet_health: 'system',
+        autosnippet_capabilities: 'system',
+        autosnippet_search: 'search',
+        autosnippet_knowledge: 'browse',
+        autosnippet_structure: 'structure',
+        autosnippet_graph: 'graph',
+        autosnippet_guard: 'guard',
+        autosnippet_submit_knowledge: 'submit',
+        autosnippet_submit_knowledge_batch: 'submit',
+        autosnippet_save_document: 'submit',
+        autosnippet_skill: 'skill',
+        autosnippet_bootstrap: 'bootstrap',
+        autosnippet_dimension_complete: 'bootstrap',
+        autosnippet_wiki_plan: 'wiki',
+        autosnippet_wiki_finalize: 'wiki',
+        autosnippet_enrich_candidates: 'admin',
+        autosnippet_knowledge_lifecycle: 'admin',
+        autosnippet_validate_candidate: 'admin',
+        autosnippet_check_duplicate: 'admin',
+    };
+    // 根据当前 tier 决定可见工具
+    const tierName = process.env.ASD_MCP_TIER || 'agent';
+    const maxTier = TIER_ORDER[tierName] ?? TIER_ORDER.agent;
+    const visibleTools = TOOLS.filter((t) => (TIER_ORDER[t.tier || 'agent'] ?? 0) <= maxTier);
+    const tools = visibleTools.map((t) => {
+        const props = t.inputSchema.properties || {};
+        const requiredSet = new Set(t.inputSchema.required || []);
+        const params = Object.entries(props).map(([key, schema]) => ({
+            name: key,
+            type: schema.type || 'any',
+            required: requiredSet.has(key),
+            ...(schema.default !== undefined ? { default: schema.default } : {}),
+            ...(schema.enum ? { enum: schema.enum } : {}),
+            ...(schema.description ? { description: schema.description } : {}),
+        }));
+        const gatewayInfo = TOOL_GATEWAY_MAP[t.name];
+        return {
+            name: t.name,
+            tier: t.tier || 'agent',
+            description: t.description,
+            category: CATEGORY_MAP[t.name] || 'other',
+            gatewayGated: !!gatewayInfo,
+            params,
+        };
+    });
+    // 按分类分组
+    const byCategory = {};
+    for (const t of tools) {
+        (byCategory[t.category] || (byCategory[t.category] = [])).push(t.name);
+    }
+    return envelope({
+        success: true,
+        data: {
+            count: tools.length,
+            tier: tierName,
+            categoryGuide: {
+                system: '系统状态与能力发现',
+                search: '统合搜索 — auto(BM25+semantic 融合) / keyword / semantic / context(漏斗+会话)',
+                browse: '知识浏览 — list/get/insights/confirm_usage（operation 路由）',
+                graph: '知识图谱 — query/impact/path/stats（operation 路由）',
+                structure: '项目结构 — targets/files/metadata（operation 路由）',
+                submit: '知识提交（写操作，Gateway gated）',
+                guard: '代码 Guard 检查 — code(单文件)/files(批量)（自动路由）',
+                skill: 'Skill 管理 — list/load/create/update/delete/suggest',
+                bootstrap: '冷启动 Mission Briefing — 无参数调用，返回项目分析 + 执行计划',
+                admin: '管理员工具（诊断/生命周期/校验/去重）',
+            },
+            byCategory,
+            tools,
+            workflows: [
+                {
+                    name: '知识查询',
+                    steps: [
+                        'search（推荐首选，auto mode 融合）',
+                        'knowledge op=get',
+                        'knowledge op=confirm_usage',
+                    ],
+                    tips: '精确匹配用 mode=keyword，需意图+会话上下文用 mode=context',
+                },
+                { name: '单条知识提交', steps: ['submit_knowledge（内置校验+去重）'] },
+                {
+                    name: '批量 Target 扫描',
+                    steps: [
+                        'structure op=targets',
+                        'structure op=files',
+                        '(Agent 分析)',
+                        'submit_knowledge_batch',
+                    ],
+                },
+                {
+                    name: '冷启动（外部 Agent）',
+                    steps: [
+                        '⚠️ 先加载 Skill 获取详细指引: autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })',
+                        'bootstrap（获取 Mission Briefing，无参数直接调用）',
+                        '按 Briefing 中的 submissionSchema.example 格式提交知识（注意: content 和 reasoning 都是 JSON 对象）',
+                        'Agent 分析代码 + submit_knowledge / submit_knowledge_batch × N',
+                        'dimension_complete × N',
+                        'wiki_plan → Agent 写文章 → wiki_finalize（可选）',
+                    ],
+                },
+                { name: '代码审计', steps: ['guard (code/files)', 'knowledge op=list kind=rule'] },
+            ],
+        },
+        meta: { tool: 'autosnippet_capabilities' },
+    });
+}
+//# sourceMappingURL=system.js.map

package/dist/lib/external/mcp/handlers/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/system.ts"],"names":[],"mappings":"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"}

package/dist/lib/external/mcp/handlers/task.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP Handler — autosnippet_task (Unified Task & Decision Management)
+ *
+ * Operations:
+ *   Session:   prime (session entry — loads decisions + ready tasks + stats)
+ *   Tasks:     create / ready / claim / close / fail / defer / progress
+ *              show / list / stats / blocked / decompose / dep_add / dep_tree
+ *   Decisions: record_decision / revise_decision / unpin_decision / list_decisions
+ */
+import type { McpContext } from './types.js';
+interface TaskArgs {
+    operation?: string;
+    id?: string;
+    title?: string;
+    description?: string;
+    design?: string;
+    acceptance?: string;
+    priority?: number;
+    taskType?: string;
+    parentId?: string | null;
+    limit?: number;
+    withKnowledge?: boolean;
+    status?: string;
+    subtasks?: unknown[];
+    dependsOn?: string;
+    depType?: string;
+    reason?: string;
+    rationale?: string;
+    tags?: string[];
+    relatedTaskId?: string | null;
+    [key: string]: unknown;
+}
+interface EnvelopeResult {
+    success: boolean;
+    errorCode?: string | null;
+    data?: unknown;
+    message?: string;
+    meta?: Record<string, unknown>;
+}
+/**
+ * 统一入口
+ * @param {object} ctx - { container }
+ * @param {object} args - { operation, ...params }
+ */
+export declare function taskHandler(ctx: McpContext, args: TaskArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: unknown;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+} | EnvelopeResult>;
+export {};
+//# sourceMappingURL=task.d.ts.map

package/dist/lib/external/mcp/handlers/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB7C,UAAU,QAAQ;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAoCD,UAAU,cAAc;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ;;;;;;;;;;;oBAsEhE"}