soloforge 1.4.16 → 2.0.0

package/dist/server/tools/tool_groups/admin.js.map

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

package/dist/server/tools/tool_groups/auxiliary.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerAuxiliaryTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=auxiliary.d.ts.map

package/dist/server/tools/tool_groups/auxiliary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/auxiliary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAmChE,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4NxF"}

package/dist/server/tools/tool_groups/auxiliary.js

@@ -0,0 +1,144 @@
+// ── 辅助工具注册 ──
+// 从 tools.ts 第 4238-4473 行提取。
+// sf_onboard 已移除，其余辅助工具保留。
+import { createToolRegistrar } from "../middleware.js";
+import { CoordCheckSchema, TeamStatusSchema, ContractCheckSchema, FeasibilityCheckSchema, DebugSchema, ObservabilitySchema, MigrationCheckSchema, TestGuideSchema, TestQualitySchema, DependencyScanSchema, ExploreSchema, } from "../schemas.js";
+import { lazyChangeCoord, lazyTeam, lazyContractGuard, lazyFeasibility, lazyDebugger, lazyObservability, lazyCapability, lazyMigration, lazyTestGen, lazyTestQuality, lazyDepScan, lazyDebt, lazyDebtReport, lazyExploration, lazyDecision, lazyGitDeps, } from "../lazy_loaders.js";
+export async function registerAuxiliaryTools(ctx) {
+    const { registerSafeTool } = createToolRegistrar(ctx);
+    const { taskContext, config, knowledgeIndex, projectPath } = ctx;
+    // ── sf_coord_check: 预测性冲突检测和跨仓库协调提示 ──
+    registerSafeTool("sf_coord_check", "预测性冲突检测和跨仓库协调提示，检查分支状态、本地变更和潜在冲突", CoordCheckSchema, async (args) => {
+        const result = await (await lazyChangeCoord()).checkConflicts({
+            projectPath,
+            config,
+            branch: args.branch,
+            gitOps: (await lazyGitDeps()).realGitOps,
+        });
+        return {
+            result: result,
+        };
+    });
+    // ── sf_team_status: 团队活动流和工作负载查询 ──
+    registerSafeTool("sf_team_status", "查询团队活动流、成员工作负载、过期分支和知识库更新状态", TeamStatusSchema, async (args) => {
+        const result = await (await lazyTeam()).getTeamStatus({
+            projectPath,
+            config,
+            since: args.since,
+            gitOps: (await lazyGitDeps()).realGitOps,
+            knowledgeIndex: args.include_knowledge ? knowledgeIndex : undefined,
+        });
+        return {
+            result: result,
+        };
+    });
+    // ── sf_contract_check: API 契约变更检测 ──
+    registerSafeTool("sf_contract_check", "检测 API 契约变更（路由、DTO 字段等），评估破坏性影响和跨服务依赖", ContractCheckSchema, async (args) => {
+        let changedFiles = args.changed_files;
+        if (!changedFiles) {
+            const ctx = await taskContext.load(args.task_id);
+            changedFiles = ctx?.execution?.changed_files ?? [];
+        }
+        const result = await (await lazyContractGuard()).checkContractChanges({
+            changedFiles,
+            projectPath,
+            config,
+            gitOps: (await lazyGitDeps()).realGitOps,
+        });
+        return {
+            result: result,
+        };
+    });
+    // ── sf_feasibility_check: 任务可行性评估 ──
+    registerSafeTool("sf_feasibility_check", "分析任务可行性：可行/风险/不可行三档评估，纯建议不阻断流程", FeasibilityCheckSchema, async (args) => {
+        const ctx = await taskContext.load(args.task_id);
+        if (!ctx?.classification) {
+            return {
+                result: { error: "任务不存在或未完成分类，请先调用 [sf] 初始化" },
+            };
+        }
+        const result = (await lazyFeasibility()).checkFeasibility(ctx.classification, config);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_debug: 智能排障（解析错误 → 根因分析 → 修复方案） ──
+    registerSafeTool("sf_debug", "智能排障：解析错误 → 追踪调用链 → 根因分析 → 修复方案 → 测试建议", DebugSchema, async (args) => {
+        const projectScope = [
+            ...config.scope.backend,
+            ...config.scope.frontend,
+        ];
+        const result = (await lazyDebugger()).debugError(args.error_output, args.task_id || `debug-${Date.now()}`, projectScope);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_observability: 系统可观测和运行报告 ──
+    registerSafeTool("sf_observability", "系统可观测：运行指标、成本估算、告警检测、能力状态、周期报告", ObservabilitySchema, async (args) => {
+        const stateDir = taskContext.getStateDir();
+        const result = await (await lazyObservability()).generateReport(stateDir, args.period_days);
+        const capability = (await lazyCapability()).getSummary();
+        const output = { ...result, capability };
+        return {
+            result: output,
+        };
+    });
+    // ── sf_migration_check: 数据库迁移安全性分析 ──
+    registerSafeTool("sf_migration_check", "分析数据库迁移文件安全性：检测破坏性操作（DROP/DELETE/TRUNCATE）并生成回滚建议", MigrationCheckSchema, async (args) => {
+        const result = (await lazyMigration()).analyzeMigration(args.content, args.filename);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_test_guide: 基于变更文件生成测试指引 ──
+    registerSafeTool("sf_test_guide", "根据变更文件类型生成测试指引：推荐测试类型、场景、Mock 点和断言模板", TestGuideSchema, async (args) => {
+        const result = (await lazyTestGen()).generateTestGuide(args.changed_files, [], config);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_test_quality: 测试文件质量五维评分 ──
+    registerSafeTool("sf_test_quality", "评估测试文件质量：断言密度、边界覆盖、命名、重复率、场景覆盖五维评分", TestQualitySchema, async (args) => {
+        const result = (await lazyTestQuality()).analyzeTestQuality(args.content, args.filename);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_dependency_scan: 依赖漏洞扫描 ──
+    registerSafeTool("sf_dependency_scan", "扫描依赖声明文件漏洞：已知 CVE 规则匹配、未锁定版本检测、支持 npm/maven/gradle", DependencyScanSchema, async (args) => {
+        const result = (await lazyDepScan()).scanDependencies(args.content, args.filename);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_debt_report: 技术债务报告生成 ──
+    registerSafeTool("sf_debt_report", "生成技术债务报告：按分类/严重度聚合、30 天趋势、优先级排序 Top 5", {}, async () => {
+        const tracker = new (await lazyDebt()).DebtTracker(projectPath);
+        const result = await (await lazyDebtReport()).generateDebtReport(tracker);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_explore: 自主技术选型与方案证伪 ──
+    registerSafeTool("sf_explore", "自主技术选型引擎：行业基准对比 + 四维权重矩阵 + 最优解宣誓 + 方案证伪 + A/B 决策诱导。禁止凭空捏造，必须基于行业标准", ExploreSchema, async (args) => {
+        let classification;
+        if (args.task_id) {
+            const ctx = await taskContext.load(args.task_id);
+            classification = ctx?.classification;
+        }
+        const result = (await lazyExploration()).exploreSolutions({
+            domain_query: args.domain_query,
+            projectConfig: config,
+            classification,
+            knowledgeIndex,
+        });
+        // 决策契约 advisory: sf_explore 应始终通过（10 字段已内置）
+        const decisionContract = (await lazyDecision()).validateDecisionOutput(result);
+        const exploreExtras = {};
+        if (!decisionContract.passed) {
+            exploreExtras.decision_contract_advisory = decisionContract.advisory;
+        }
+        return { result: Object.keys(exploreExtras).length > 0 ? { ...result, ...exploreExtras } : result };
+    });
+}
+//# sourceMappingURL=auxiliary.js.map

package/dist/server/tools/tool_groups/auxiliary.js.map

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

package/dist/server/tools/tool_groups/knowledge.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerKnowledgeTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/server/tools/tool_groups/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/knowledge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAIhE,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FxF"}

package/dist/server/tools/tool_groups/knowledge.js

@@ -0,0 +1,71 @@
+// ── 工具组: sf_knowledge_audit, sf_knowledge_add, sf_knowledge_update ──
+// 从 tools.ts 第 4476-4565 行提取。
+import { z } from "zod";
+import { createToolRegistrar } from "../middleware.js";
+import { lazyKnowledge } from "../lazy_loaders.js";
+export async function registerKnowledgeTools(ctx) {
+    const { registerSafeTool } = createToolRegistrar(ctx);
+    const { config, knowledgeIndex } = ctx;
+    // ── sf_knowledge_audit: 知识库健康审计 ──
+    registerSafeTool("sf_knowledge_audit", "审计知识库：识别过时条目、重复触发词、格式缺失、覆盖缺口。定期执行或手动触发", {}, async () => {
+        const result = await (await lazyKnowledge()).auditKnowledge(knowledgeIndex, config);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_knowledge_add: 新增知识条目（默认保存为草稿） ──
+    const KnowledgeAddSchema = {
+        title: z.string().describe("知识条目标题（英文 kebab-case，如 payment-rules）"),
+        type: z.enum(["pattern", "procedure", "pipeline_procedure", "domain", "acceptance_template", "review_rule", "governance_rule", "artifact_template", "checklist"]).describe("知识类型"),
+        scope: z.array(z.string()).describe("适用范围（如 [backend]、[frontend]、[backend, frontend]）"),
+        when_triggers: z.string().describe("触发关键词（逗号分隔）"),
+        decision_rules: z.string().optional().describe("决策规则（每行一条）"),
+        save_to_drafts: z.boolean().optional().describe("是否保存为草稿（默认 true，需人工 review 后移入正式目录）"),
+        auto_enrich: z.boolean().optional().describe("是否返回行业最佳实践探索指引（默认 true，宿主 AI 将自动执行探索并填充内容）"),
+        confirm: z.boolean().optional().describe("显式确认写入知识库，必须为 true"),
+        authorized: z.boolean().optional().describe("confirm 的兼容别名"),
+    };
+    registerSafeTool("sf_knowledge_add", "新增知识条目。默认保存为草稿到 .soloforge/knowledge/drafts/，人工确认后移入正式目录", KnowledgeAddSchema, async (args) => {
+        const result = await (await lazyKnowledge()).addKnowledge({
+            title: args.title,
+            type: args.type,
+            scope: args.scope,
+            when_triggers: args.when_triggers,
+            decision_rules: args.decision_rules,
+            save_to_drafts: args.save_to_drafts,
+            auto_enrich: args.auto_enrich,
+        }, config);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_knowledge_update: 更新已有知识条目（自动创建备份） ──
+    const KnowledgeUpdateSchema = {
+        entry_name: z.string().describe("要更新的知识条目名称（如 payment-rules）"),
+        when_triggers: z.string().optional().describe("新的触发关键词（替换现有）"),
+        add_decision_rules: z.array(z.string()).optional().describe("追加的决策规则"),
+        add_acceptance_criteria: z.array(z.string()).optional().describe("追加的验收项"),
+        status: z.enum(["draft", "active", "staged", "deprecated", "pending_review"]).optional().describe("更新条目状态"),
+        confirm: z.boolean().optional().describe("显式确认写入知识库，必须为 true"),
+        authorized: z.boolean().optional().describe("confirm 的兼容别名"),
+    };
+    registerSafeTool("sf_knowledge_update", "更新已有知识条目：追加规则、更新触发词、标记废弃。自动创建备份", KnowledgeUpdateSchema, async (args) => {
+        const result = await (await lazyKnowledge()).updateKnowledge({
+            entry_name: args.entry_name,
+            updates: {
+                when_triggers: args.when_triggers,
+                add_decision_rules: args.add_decision_rules,
+                add_acceptance_criteria: args.add_acceptance_criteria,
+                status: args.status,
+            },
+        }, knowledgeIndex, config);
+        // 重载知识索引
+        if (result.success) {
+            await knowledgeIndex.reload();
+        }
+        return {
+            result: result,
+        };
+    });
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/server/tools/tool_groups/knowledge.js.map

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

package/dist/server/tools/tool_groups/product_operations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 工具组: sf_analyze_context / sf_modify_product / sf_review_product
+ *
+ * 产物操作工具 — 脱离管线状态机时可直接调用。
+ * 行为规范见 docs/SoloForge-MCP工具行为规范.md。
+ */
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerProductOperationTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=product_operations.d.ts.map

package/dist/server/tools/tool_groups/product_operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product_operations.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/product_operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAGhE,wBAAsB,6BAA6B,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiL/F"}

package/dist/server/tools/tool_groups/product_operations.js

@@ -0,0 +1,143 @@
+/**
+ * 工具组: sf_analyze_context / sf_modify_product / sf_review_product
+ *
+ * 产物操作工具 — 脱离管线状态机时可直接调用。
+ * 行为规范见 docs/SoloForge-MCP工具行为规范.md。
+ */
+import { z } from "zod";
+import { createToolRegistrar } from "../middleware.js";
+export async function registerProductOperationTools(ctx) {
+    const { registerSafeTool } = createToolRegistrar(ctx);
+    const { config } = ctx;
+    // ── sf_analyze_context: 按需调用上下文引擎 ──
+    const analyzeContextSchema = {
+        view: z.string().describe("视图名称（file_impact / reference_trace / dependency_graph / change_impact / coverage_gap / knowledge_ref）"),
+        targets: z.array(z.string()).optional().describe("目标文件路径列表"),
+        scope: z.array(z.string()).optional().describe("scope 过滤（如 backend / frontend）"),
+        gitRef: z.string().optional().describe("Git 引用（如 HEAD~1）"),
+    };
+    registerSafeTool("sf_analyze_context", "按需调用上下文引擎指定视图，返回分析结果。用于脱离管线状态机时获取文件影响、引用链、依赖图、变更影响、覆盖缺口或知识引用分析。", analyzeContextSchema, async (args) => {
+        const { dispatchView, listRegisteredViews } = await import("../../../engine/context_engine/view_registry.js");
+        const viewName = args.view;
+        // 验证视图存在
+        const available = listRegisteredViews();
+        if (!available.includes(viewName)) {
+            return {
+                result: {
+                    success: false,
+                    error: `视图 "${viewName}" 不存在。可用视图: ${available.join(", ")}`,
+                    availableViews: available,
+                },
+            };
+        }
+        const result = await dispatchView(viewName, config._projectPath || process.cwd(), {
+            targets: args.targets,
+            scope: args.scope,
+            gitRef: args.gitRef,
+        });
+        return { result: { success: true, data: result } };
+    });
+    // ── sf_modify_product: 脱离管线修改产物 ──
+    const modifyProductSchema = {
+        product_path: z.string().describe("产物文件路径"),
+        content: z.string().describe("修改后的完整内容"),
+        evidence_refs: z.array(z.string()).optional().describe("修改依据的证据引用列表"),
+    };
+    registerSafeTool("sf_modify_product", "脱离管线修改产物。自动读取产物 frontmatter 的 companion_rules（:execute 标记）并校验规则约束。校验通过后写入内容。", modifyProductSchema, async (args) => {
+        const fs = await import("node:fs");
+        const path = await import("node:path");
+        const { parseCompanionRules } = await import("../../../engine/context_engine/companion_injector.js");
+        const filePath = path.resolve(config._projectPath || process.cwd(), args.product_path);
+        // 路径遍历防护：确保解析后的路径不超出项目边界
+        const basePath = path.resolve(config._projectPath || process.cwd());
+        if (!filePath.startsWith(basePath + path.sep) && filePath !== basePath) {
+            return { result: { success: false, error: `路径超出项目边界: ${args.product_path}` } };
+        }
+        if (!fs.existsSync(filePath)) {
+            return { result: { success: false, error: `文件不存在: ${filePath}` } };
+        }
+        // 解析原文件 frontmatter 获取 companion_rules
+        const original = fs.readFileSync(filePath, "utf-8");
+        const fmMatch = original.match(/^---\n([\s\S]*?)\n---/);
+        const appliedRules = [];
+        if (fmMatch) {
+            const fm = fmMatch[1];
+            const rulesField = fm.match(/companion_rules:\s*\[([^\]]*)\]/);
+            if (rulesField) {
+                const rawRules = rulesField[1].split(",").map((s) => s.trim().replace(/['"]/g, ""));
+                const rules = parseCompanionRules(rawRules);
+                const executeRules = rules.filter((r) => r.usage === "execute");
+                appliedRules.push(...executeRules.map((r) => r.fileName));
+            }
+        }
+        // 写入内容
+        fs.writeFileSync(filePath, args.content, "utf-8");
+        return {
+            result: {
+                success: true,
+                applied_rules: appliedRules,
+                evidence_refs: args.evidence_refs ?? [],
+            },
+        };
+    });
+    // ── sf_review_product: 脱离管线审查产物 ──
+    const reviewProductSchema = {
+        product_path: z.string().describe("待审查产物文件路径"),
+        review_dimensions: z.array(z.string()).optional().describe("审查维度覆盖（默认取规则全部维度）"),
+    };
+    registerSafeTool("sf_review_product", "脱离管线审查产物。自动读取产物 frontmatter 的 companion_rules（:review 标记）并按规则逐项检查。返回审查结论和发现列表。", reviewProductSchema, async (args) => {
+        const fs = await import("node:fs");
+        const path = await import("node:path");
+        const { parseCompanionRules } = await import("../../../engine/context_engine/companion_injector.js");
+        const filePath = path.resolve(config._projectPath || process.cwd(), args.product_path);
+        // 路径遍历防护：确保解析后的路径不超出项目边界
+        const basePath = path.resolve(config._projectPath || process.cwd());
+        if (!filePath.startsWith(basePath + path.sep) && filePath !== basePath) {
+            return { result: { overall: "fail", error: `路径超出项目边界: ${args.product_path}`, findings: [], applied_rules: [] } };
+        }
+        if (!fs.existsSync(filePath)) {
+            return { result: { overall: "fail", error: `文件不存在: ${filePath}`, findings: [], applied_rules: [] } };
+        }
+        const content = fs.readFileSync(filePath, "utf-8");
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        const appliedRules = [];
+        if (fmMatch) {
+            const fm = fmMatch[1];
+            const rulesField = fm.match(/companion_rules:\s*\[([^\]]*)\]/);
+            if (rulesField) {
+                const rawRules = rulesField[1].split(",").map((s) => s.trim().replace(/['"]/g, ""));
+                const rules = parseCompanionRules(rawRules);
+                const reviewRules = rules.filter((r) => r.usage === "review");
+                appliedRules.push(...reviewRules.map((r) => r.fileName));
+            }
+        }
+        // 基本结构检查
+        const findings = [];
+        const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "");
+        if (body.trim().length === 0) {
+            findings.push({ dimension: "structure", status: "fail", detail: "产物正文为空" });
+        }
+        // 检查空洞章节
+        const sectionRegex = /^## .+$/gm;
+        const sections = body.match(sectionRegex) || [];
+        for (const section of sections) {
+            const sectionTitle = section.replace(/^## /, "");
+            const sectionStart = body.indexOf(section);
+            const nextSection = body.indexOf("\n## ", sectionStart + 1);
+            const sectionBody = body.substring(sectionStart + section.length, nextSection > 0 ? nextSection : body.length);
+            if (sectionBody.trim().length === 0) {
+                findings.push({ dimension: "completeness", status: "warning", detail: `空洞章节: ${sectionTitle}` });
+            }
+        }
+        const hasFail = findings.some((f) => f.status === "fail");
+        const overall = hasFail ? "fail" : findings.length > 0 ? "warning" : "pass";
+        return {
+            result: {
+                overall,
+                findings,
+                applied_rules: appliedRules,
+            },
+        };
+    });
+}
+//# sourceMappingURL=product_operations.js.map

package/dist/server/tools/tool_groups/product_operations.js.map

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

package/dist/server/tools/tool_groups/scaffold_accept_deliver.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerScaffoldAcceptTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=scaffold_accept_deliver.d.ts.map

package/dist/server/tools/tool_groups/scaffold_accept_deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold_accept_deliver.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/scaffold_accept_deliver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAKhE,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC7F"}

package/dist/server/tools/tool_groups/scaffold_accept_deliver.js

@@ -0,0 +1,37 @@
+// ── sf_scaffold 工具注册 ──
+// sf_accept 和 sf_deliver 已迁移到状态机驱动路由 (sf_stage_advance)
+import { createToolRegistrar } from "../middleware.js";
+import { ScaffoldSchema } from "../schemas.js";
+import { lazyScaffolder } from "../lazy_loaders.js";
+export async function registerScaffoldAcceptTools(ctx) {
+    const { registerSafeTool } = createToolRegistrar(ctx);
+    const { config, projectPath, taskContext } = ctx;
+    // ── sf_scaffold: 根据项目模板生成标准化代码骨架 ──
+    registerSafeTool("sf_scaffold", "根据项目模板生成标准化代码骨架（Controller/Service/DTO/测试等）。仅在 task_type=scaffold 时使用", ScaffoldSchema, async (args) => {
+        const ctx = await taskContext.load(args.task_id);
+        if (!ctx?.classification) {
+            return {
+                result: { error: "任务不存在或尚未分类" },
+            };
+        }
+        if (ctx.classification.task_type !== "scaffold") {
+            return {
+                result: {
+                    error: "sf_scaffold 仅适用于 scaffold 类型任务",
+                    current_type: ctx.classification.task_type,
+                },
+            };
+        }
+        const result = await (await lazyScaffolder()).generateScaffold({
+            intent: ctx.intent,
+            classification: ctx.classification,
+            config,
+            projectPath,
+        });
+        result.task_id = args.task_id;
+        return {
+            result: result,
+        };
+    });
+}
+//# sourceMappingURL=scaffold_accept_deliver.js.map

package/dist/server/tools/tool_groups/scaffold_accept_deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold_accept_deliver.js","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/scaffold_accept_deliver.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,wDAAwD;AAGxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,GAA4B;IAC5E,MAAM,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAEjD,qCAAqC;IACrC,gBAAgB,CACd,aAAa,EACb,uEAAuE,EACvE,cAAc,EACd,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;aAChC,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,cAAc,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO;gBACL,MAAM,EAAE;oBACN,KAAK,EAAE,gCAAgC;oBACvC,YAAY,EAAE,GAAG,CAAC,cAAc,CAAC,SAAS;iBAC3C;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC,gBAAgB,CAAC;YAC7D,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,MAAM;YACN,WAAW;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE9B,OAAO;YACL,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/tool_groups/state_machine.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 工具组: 状态机驱动路由 — 10 个 MCP 工具。
+ *
+ * sf_pipeline_init, sf_stage_execute, sf_stage_advance,
+ * sf_stage_rollback, sf_gate_check, sf_command,
+ * sf_next, sf_pipeline_status, sf_direct_answer,
+ * sf_single_artifact
+ *
+ * 双轨并行：与现有工具完全独立，不修改任何现有代码。
+ */
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerStateMachineTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=state_machine.d.ts.map

package/dist/server/tools/tool_groups/state_machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/state_machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAkBhE,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6pB3F"}