@geeseeker/easyai-dev 3.0.0-alpha.1 → 3.0.1

package/lib/server/tools/conflict-check.js.map

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

package/lib/server/tools/context-budget.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册 context_budget 工具
+ * Token 估算 + 60%/80% 自动降级
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=context-budget.d.ts.map

package/lib/server/tools/context-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.d.ts","sourceRoot":"","sources":["../../src/tools/context-budget.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6BpE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwIhD"}

package/lib/server/tools/context-budget.js

@@ -0,0 +1,178 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { z } from "zod";
+import { getTaskDir } from "../utils/task-utils.js";
+import { parseContextJsonl, resolveUriToPath, checkStale, } from "../utils/hash-utils.js";
+// ============ 常量 ============
+/**
+ * 上下文预算阈值（Token 数）
+ * 来源：.trellis/config/context-budget.md + 架构 §6.3
+ */
+const BUDGET_THRESHOLDS = {
+    WARNING: 0.6, // 60% — 自动降级 recommended → deferred
+    CRITICAL: 0.8, // 80% — 建议新开会话
+};
+const PHASE_BUDGET = {
+    plan: 40000,
+    implement: 60000,
+    check: 30000,
+    debug: 50000,
+};
+const DEFAULT_BUDGET = 60000;
+/**
+ * 注册 context_budget 工具
+ * Token 估算 + 60%/80% 自动降级
+ */
+export function register(server) {
+    server.tool("context_budget", "估算当前任务的上下文 Token 消耗。超过 60% 时建议降级 recommended 上下文，超过 80% 时建议新开会话。可选传入 task_id 分析特定任务。", {
+        task_id: z.string().optional().describe("可选任务 ID，分析特定任务的上下文预算"),
+        phase: z.string().optional().describe("阶段标识，决定预算上限"),
+    }, async ({ task_id, phase }) => {
+        try {
+            const budget = PHASE_BUDGET[phase || "implement"] || DEFAULT_BUDGET;
+            let totalTokens = 0;
+            // 按 priority 分层统计
+            const breakdown = {
+                required: { count: 0, tokens: 0 },
+                recommended: { count: 0, tokens: 0 },
+                deferred: { count: 0, tokens: 0 },
+            };
+            // 如果指定了 task_id，读取对应的 context.jsonl
+            if (task_id) {
+                const taskDir = getTaskDir(task_id);
+                const contextPath = path.join(taskDir, "context.jsonl");
+                if (fs.existsSync(contextPath)) {
+                    const entries = parseContextJsonl(contextPath);
+                    for (const entry of entries) {
+                        const filePath = resolveUriToPath(entry.uri);
+                        let tokens = entry.token_estimate || 0;
+                        if (filePath && fs.existsSync(filePath)) {
+                            const stat = fs.statSync(filePath);
+                            tokens = Math.round(stat.size / 3);
+                        }
+                        const priority = entry.priority || "deferred";
+                        if (breakdown[priority]) {
+                            breakdown[priority].count += 1;
+                            breakdown[priority].tokens += tokens;
+                        }
+                        // deferred 仅保留 URI 引用，不计入实际预算消耗
+                        if (priority !== "deferred") {
+                            totalTokens += tokens;
+                        }
+                    }
+                    // 检查快照 stale 状态（优先本阶段快照，回退到 implement 快照）
+                    const targetPhase = phase || "implement";
+                    let snapshotPath = path.join(taskDir, `context-snapshot-${targetPhase}.jsonl`);
+                    if (!fs.existsSync(snapshotPath) && targetPhase !== "implement") {
+                        snapshotPath = path.join(taskDir, "context-snapshot-implement.jsonl");
+                    }
+                    if (fs.existsSync(snapshotPath)) {
+                        const staleResult = checkStale(snapshotPath);
+                        if (!staleResult.allFresh) {
+                            return {
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: JSON.stringify({
+                                            task_id,
+                                            phase: phase || "implement",
+                                            budget,
+                                            total_tokens: totalTokens,
+                                            usage_percent: Math.round((totalTokens / budget) * 100),
+                                            status: determineStatus(totalTokens, budget),
+                                            breakdown,
+                                            stale_warning: {
+                                                message: "⚠️ 上下文快照中检测到 stale 条目（spec 文件已变更）",
+                                                stale_count: staleResult.staleEntries.length,
+                                                stale_entries: staleResult.staleEntries,
+                                            },
+                                            ...getDegradationAdvice(totalTokens, budget),
+                                        }, null, 2),
+                                    },
+                                ],
+                            };
+                        }
+                    }
+                }
+            }
+            const usagePercent = Math.round((totalTokens / budget) * 100);
+            const status = determineStatus(totalTokens, budget);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            task_id: task_id || null,
+                            phase: phase || "implement",
+                            budget,
+                            total_tokens: totalTokens,
+                            usage_percent: usagePercent,
+                            status,
+                            breakdown,
+                            ...getDegradationAdvice(totalTokens, budget),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============ 辅助函数 ============
+/**
+ * 判断预算状态
+ */
+function determineStatus(totalTokens, budget) {
+    const ratio = totalTokens / budget;
+    if (ratio >= BUDGET_THRESHOLDS.CRITICAL)
+        return "critical";
+    if (ratio >= BUDGET_THRESHOLDS.WARNING)
+        return "warning";
+    return "normal";
+}
+/**
+ * 根据状态生成降级建议
+ */
+function getDegradationAdvice(totalTokens, budget) {
+    const status = determineStatus(totalTokens, budget);
+    if (status === "normal") {
+        return { advice: "预算充足，可正常加载所有 required + recommended 上下文" };
+    }
+    if (status === "warning") {
+        return {
+            advice: "⚠️ 超过 60% 预算，建议将 recommended 上下文降级为 deferred（仅保留 URI 引用）",
+            degradation: {
+                action: "降级 recommended → deferred",
+                reason: "上下文接近预算上限，优先保留 required 内容",
+            },
+        };
+    }
+    // critical
+    return {
+        advice: "🚨 超过 80% 预算，建议新开会话并使用恢复指令",
+        degradation: {
+            action: "停止加载新上下文 + 新开会话",
+            reason: "上下文已超预算上限",
+        },
+        recovery_instructions: {
+            step1: "新开会话",
+            step2: "调用 project_status() 恢复项目状态",
+            step3: "调用 task_get(current_task_id) 读取任务详情",
+            step4: "调用 journal_search(last_session) 恢复最近工作记录",
+        },
+    };
+}
+//# sourceMappingURL=context-budget.js.map

package/lib/server/tools/context-budget.js.map

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

package/lib/server/tools/context-generate.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册 context_generate 工具
+ * 半自动生成 context.jsonl 推荐清单
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=context-generate.d.ts.map

package/lib/server/tools/context-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-generate.d.ts","sourceRoot":"","sources":["../../src/tools/context-generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCpE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsGhD"}

package/lib/server/tools/context-generate.js

@@ -0,0 +1,208 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { z } from "zod";
+import { getProjectRoot, getTaskDir } from "../utils/task-utils.js";
+// ============ 常量 ============
+const SPEC_ROOT = ".trellis/spec";
+/**
+ * 各阶段的 priority 映射策略
+ */
+const PHASE_PRIORITY_MAP = {
+    implement: {
+        frontend: "required",
+        backend: "required",
+        guides: "recommended",
+        general: "recommended",
+    },
+    check: {
+        frontend: "recommended",
+        backend: "recommended",
+        guides: "required",
+        general: "recommended",
+    },
+    debug: {
+        frontend: "recommended",
+        backend: "recommended",
+        guides: "recommended",
+        general: "deferred",
+    },
+    plan: {
+        frontend: "recommended",
+        backend: "recommended",
+        guides: "required",
+        general: "required",
+    },
+};
+/**
+ * 注册 context_generate 工具
+ * 半自动生成 context.jsonl 推荐清单
+ */
+export function register(server) {
+    server.tool("context_generate", "半自动生成 context.jsonl 推荐清单。分析任务描述，扫描 spec 目录，返回按 phase 分配 priority 的上下文条目。PM 审核后写入 context.jsonl。", {
+        task_id: z.string().describe("任务 ID"),
+        phase: z
+            .string()
+            .describe("阶段标识：plan / implement / check / debug"),
+    }, async ({ task_id, phase }) => {
+        try {
+            const taskDir = getTaskDir(task_id);
+            const taskMdPath = path.join(taskDir, "task.md");
+            if (!fs.existsSync(taskMdPath)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: true,
+                                message: `任务 ${task_id} 的 task.md 不存在`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // 读取任务描述，提取关键词
+            const taskContent = fs.readFileSync(taskMdPath, "utf-8");
+            const keywords = extractKeywords(taskContent);
+            // 扫描 spec 目录
+            const projectRoot = getProjectRoot();
+            const specDir = path.join(projectRoot, SPEC_ROOT);
+            const specFiles = scanSpecFiles(specDir);
+            // 匹配并生成推荐清单
+            const priorityMap = PHASE_PRIORITY_MAP[phase] || PHASE_PRIORITY_MAP.implement;
+            const recommendations = specFiles.map((specFile) => {
+                const { confidence, matchedKeywords: matchedKws } = calculateConfidence(specFile, keywords);
+                const category = specFile.category;
+                const priority = priorityMap[category] || "deferred";
+                const tokenEstimate = Math.round(specFile.sizeBytes / 3);
+                return {
+                    uri: `trellis://spec/${specFile.relativePath}`,
+                    phase,
+                    priority: confidence > 0.1 ? priority : "deferred",
+                    reason: `匹配关键词: ${matchedKws.join(", ") || "目录分类"}`,
+                    confidence: Math.round(confidence * 100) / 100,
+                    token_estimate: tokenEstimate,
+                    source: "auto",
+                    content_hash: "",
+                    frozen_at: null,
+                };
+            });
+            // 按置信度排序，过滤低置信度
+            const filtered = recommendations
+                .filter((r) => r.confidence > 0.1)
+                .sort((a, b) => b.confidence - a.confidence);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            task_id,
+                            phase,
+                            total_specs_scanned: specFiles.length,
+                            recommendations_count: filtered.length,
+                            recommendations: filtered,
+                            instruction: "请审核上述推荐清单，添加/删除/调整后写入任务目录的 context.jsonl",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+/**
+ * 从任务内容中提取关键词
+ */
+function extractKeywords(content) {
+    // 提取中文和英文关键词（去除常见停用词）
+    const stopWords = new Set([
+        "的", "了", "和", "是", "在", "有", "中", "为", "以",
+        "the", "a", "an", "is", "are", "in", "of", "to", "for", "and",
+        "with", "on", "at", "by", "from", "that", "this", "be", "as",
+    ]);
+    const words = content
+        .toLowerCase()
+        .replace(/[^\w\u4e00-\u9fff]+/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 1 && !stopWords.has(w));
+    // 去重
+    return [...new Set(words)];
+}
+/**
+ * 扫描 spec 目录下的所有 .md 文件
+ */
+function scanSpecFiles(specDir) {
+    const results = [];
+    if (!fs.existsSync(specDir)) {
+        return results;
+    }
+    const categories = ["frontend", "backend", "guides", "general"];
+    for (const category of categories) {
+        const categoryDir = path.join(specDir, category);
+        if (!fs.existsSync(categoryDir) || !fs.statSync(categoryDir).isDirectory()) {
+            continue;
+        }
+        try {
+            const files = fs.readdirSync(categoryDir);
+            for (const file of files) {
+                if (!file.endsWith(".md"))
+                    continue;
+                const filePath = path.join(categoryDir, file);
+                const stat = fs.statSync(filePath);
+                results.push({
+                    relativePath: `${category}/${file.replace(/\.md$/, "")}`,
+                    category,
+                    fileName: file,
+                    sizeBytes: stat.size,
+                    matchedKeywords: [],
+                });
+            }
+        }
+        catch (err) {
+            // 跳过无法读取的目录
+            console.error(`无法读取 spec 目录 ${categoryDir}: ${err}`);
+        }
+    }
+    return results;
+}
+/**
+ * 计算 spec 文件与关键词的匹配置信度
+ * 返回置信度值和匹配的关键词列表（不修改原始对象）
+ */
+function calculateConfidence(specFile, keywords) {
+    const fileName = specFile.fileName.toLowerCase().replace(/\.md$/, "");
+    const category = specFile.category.toLowerCase();
+    let matchCount = 0;
+    const matched = [];
+    for (const keyword of keywords) {
+        // 只做正向匹配（文件名包含关键词），避免短文件名误匹配长关键词
+        if (fileName.includes(keyword)) {
+            matchCount += 2;
+            matched.push(keyword);
+        }
+        else if (category.includes(keyword)) {
+            matchCount += 1;
+            matched.push(keyword);
+        }
+    }
+    if (keywords.length === 0)
+        return { confidence: 0.3, matchedKeywords: [] };
+    return {
+        confidence: Math.min(1.0, matchCount / Math.max(keywords.length, 1)),
+        matchedKeywords: matched,
+    };
+}
+//# sourceMappingURL=context-generate.js.map

package/lib/server/tools/context-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-generate.js","sourceRoot":"","sources":["../../src/tools/context-generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpE,+BAA+B;AAE/B,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC;;GAEG;AACH,MAAM,kBAAkB,GAA2C;IACjE,SAAS,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,aAAa;KACvB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,aAAa;KACvB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,UAAU;KACpB;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,UAAU;KACpB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,iGAAiG,EACjG;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,uCAAuC,CAAC;KACrD,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAEjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,IAAI;gCACX,OAAO,EAAE,MAAM,OAAO,gBAAgB;6BACvC,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,eAAe;YACf,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YAE9C,aAAa;YACb,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAEzC,YAAY;YACZ,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC;YAC9E,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjD,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,GACjD,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC;gBACrD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;gBAEzD,OAAO;oBACL,GAAG,EAAE,kBAAkB,QAAQ,CAAC,YAAY,EAAE;oBAC9C,KAAK;oBACL,QAAQ,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;oBAClD,MAAM,EAAE,UAAU,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;oBACnD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG;oBAC9C,cAAc,EAAE,aAAa;oBAC7B,MAAM,EAAE,MAAM;oBACd,YAAY,EAAE,EAAE;oBAChB,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,gBAAgB;YAChB,MAAM,QAAQ,GAAG,eAAe;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC;iBACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;YAE/C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO;4BACP,KAAK;4BACL,mBAAmB,EAAE,SAAS,CAAC,MAAM;4BACrC,qBAAqB,EAAE,QAAQ,CAAC,MAAM;4BACtC,eAAe,EAAE,QAAQ;4BACzB,WAAW,EACT,0CAA0C;yBAC7C,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,IAAI;4BACX,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAYD;;GAEG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,sBAAsB;IACtB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACxB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;QAC3C,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;QAC7D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;KAC7D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO;SAClB,WAAW,EAAE;SACb,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;SACpC,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,KAAK;IACL,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAEhE,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3E,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAEnC,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE;oBACxD,QAAQ;oBACR,QAAQ,EAAE,IAAI;oBACd,SAAS,EAAE,IAAI,CAAC,IAAI;oBACpB,eAAe,EAAE,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY;YACZ,OAAO,CAAC,KAAK,CAAC,gBAAgB,WAAW,KAAK,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,QAAsB,EACtB,QAAkB;IAElB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,iCAAiC;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,UAAU,IAAI,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,UAAU,IAAI,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC3E,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,eAAe,EAAE,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/lib/server/tools/framework-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 框架管理工具 — framework_init / framework_check / framework_update
+ *
+ * 让 AI 通过 MCP 工具直接执行框架初始化、检查和更新，
+ * 用户无需离开 IDE，无需使用命令行。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册 framework_init 工具
+ */
+export declare function registerFrameworkInit(server: McpServer): void;
+/**
+ * 注册 framework_check 工具
+ */
+export declare function registerFrameworkCheck(server: McpServer): void;
+/**
+ * 注册 framework_update 工具
+ */
+export declare function registerFrameworkUpdate(server: McpServer): void;
+//# sourceMappingURL=framework-tools.d.ts.map

package/lib/server/tools/framework-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-tools.d.ts","sourceRoot":"","sources":["../../src/tools/framework-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqHpE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyI7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkG9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+H/D"}