soloforge 1.1.2 → 1.1.31

package/dist/server/tools/gate_checks.js

@@ -0,0 +1,213 @@
+// ── 门控检查函数 ──
+// 所有 gate-check 函数的独立模块
+import { hasWriteSideEffect, } from "../../engine/contracts/tool_invocation_contract_registry.js";
+import { TOOL_DIAGNOSTIC_CODES } from "../../engine/audit/diagnostic_registry.js";
+import { lazyInstructionContract, lazyArchitectureDesign, lazyArchitectureWorkshop, lazyExistingSystemAnalysis, lazyCodingReadiness, lazyLocalAcceptance, } from "./lazy_loaders.js";
+export function checkWriteToolPlanGate(params) {
+    if (!hasWriteSideEffect(params.sideEffects))
+        return { allowed: true };
+    if (!params.ctx || !params.ctx.plan_proposal_gate) {
+        return {
+            allowed: false,
+            diagnostic_code: TOOL_DIAGNOSTIC_CODES.planGate,
+            violation_type: "guard_blocked",
+            reason: `工具 ${params.toolName} 执行前缺少 Plan Proposal Gate`,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * 施工指令契约门 — 写操作前检查施工指令完整性。
+ * 通过引擎模块函数真实消费。
+ * 调用链 1: registerInstructionIssueCandidate（无契约时创建候选 draft）
+ * 调用链 2: enforceInstructionBeforeImplementation → checkInstructionCompleteness → validateInstructionContract
+ */
+export async function checkInstructionContractGate(params) {
+    if (!hasWriteSideEffect(params.sideEffects))
+        return { allowed: true };
+    if (!params.ctx)
+        return { allowed: true };
+    let instruction = params.ctx.instruction_contract;
+    const instrModule = await lazyInstructionContract();
+    // 无契约时消费 registerInstructionIssueCandidate — 创建 draft 候选并保存
+    if (!instruction && params.task_id) {
+        instruction = instrModule.registerInstructionIssueCandidate({
+            task_id: params.task_id,
+            description: params.toolName,
+            source: "auto_detected",
+            suggested_fields: {},
+        });
+        params.ctx.instruction_contract = instruction;
+        if (params.taskContextMgr) {
+            await params.taskContextMgr.save(params.ctx);
+        }
+    }
+    if (!instruction)
+        return { allowed: true };
+    // 消费 enforceInstructionBeforeImplementation（链式消费 checkInstructionCompleteness + validateInstructionContract）
+    const result = await instrModule.enforceInstructionBeforeImplementation(instruction, params.toolName);
+    // Draft 状态不阻断 — 仅在 confirmed/executing/blocked 状态时强制
+    if (instruction?.status === "draft") {
+        return { allowed: true, findings: result.allowed ? [] : [result.reason_zh] };
+    }
+    if (!result.allowed) {
+        return {
+            allowed: false,
+            diagnostic_code: result.diagnostic_code,
+            violation_type: "guard_blocked",
+            reason: result.reason_zh,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * 设计产物编码门 — 依赖设计包的任务，在真实复验完成前不得写入业务实现。
+ * 仅阻断文件/配置/外部交付写入；任务状态、设计文档复验和讨论本身仍可推进。
+ */
+export function checkDesignArtifactWriteGate(params) {
+    const implementationWrite = params.sideEffects.some((effect) => ["file_write", "config_write", "external_write", "git_commit", "git_push", "pr_create"].includes(effect));
+    if (!implementationWrite || !params.ctx?.design_artifact_pack)
+        return { allowed: true };
+    if (params.ctx.design_artifact_pack.status === "implementation_ready")
+        return { allowed: true };
+    return {
+        allowed: false,
+        diagnostic_code: "SF-DESIGN-PACK-NOT-READY",
+        reason: `工具 ${params.toolName} 依赖的设计产物包状态为 ${params.ctx.design_artifact_pack.status}，未完成真实复验，不得写入实现或交付`,
+    };
+}
+/**
+ * 架构设计门 — 架构设计类任务膨胀前执行 reviewArchitectureDesign。
+ * Architecture Design Contract enforcement。
+ */
+export async function checkArchitectureDesignGate(params) {
+    const route = params.route;
+    if (route !== "artifact_generation" && route !== "analysis")
+        return { allowed: true };
+    if (!params.ctx)
+        return { allowed: true };
+    const expansion = params.ctx.expansion;
+    if (!expansion)
+        return { allowed: true };
+    const archModule = await lazyArchitectureDesign();
+    const contract = expansion.architecture_contract;
+    if (contract) {
+        const result = archModule.reviewArchitectureDesign(contract);
+        if (!result.passed) {
+            return {
+                allowed: false,
+                reason_zh: "架构设计审查未通过",
+                findings: result.review.missing_sections ?? ["架构设计审查失败"],
+            };
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * 架构决策研讨门 — 正式架构设计前六域决策必须闭合。
+ * 与是否存在施工指令契约无关，架构设计路由必经此门。
+ */
+export async function checkArchitectureDecisionWorkshopGate(params) {
+    const workshopModule = await lazyArchitectureWorkshop();
+    if (!workshopModule.requiresArchitectureDecisionWorkshop(params.workflowIntent, params.ctx.intent)) {
+        return { allowed: true };
+    }
+    const existing = params.ctx.architecture_decision_workshop;
+    const contract = existing ?? workshopModule.createArchitectureDecisionWorkshop(params.ctx.task_id, params.projectContext ?? "new_system");
+    if (params.projectContext === "existing_system" && contract.project_context !== "existing_system") {
+        contract.project_context = "existing_system";
+    }
+    const evaluatedContract = workshopModule.applyArchitectureWorkshopGate(contract) ?? contract;
+    const gate = workshopModule.evaluateArchitectureDecisionWorkshop(evaluatedContract);
+    params.ctx.architecture_decision_workshop = evaluatedContract;
+    return {
+        allowed: gate.allowed,
+        findings: gate.blocking_findings,
+        next_domain: gate.next_domain,
+        contract: evaluatedContract,
+    };
+}
+/**
+ * 现有系统分析门 — 现有项目编码前必须先做分析。
+ * Existing System Analysis Contract enforcement。
+ */
+export async function checkExistingSystemAnalysisGate(params) {
+    const archModule = await lazyExistingSystemAnalysis();
+    const context = archModule.detectProjectContext(params.hasExistingCode, params.hasPackageJson, params.hasSrcDir);
+    const gateResult = archModule.checkAnalysisGate(context, params.hasAnalysis, params.hasGapAnalysis);
+    if (!gateResult.allowed) {
+        return {
+            allowed: false,
+            reason_zh: gateResult.reason,
+            missing_analysis: gateResult.missing_analysis,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * 编码就绪门 — 编码前必须有测试计划 + 验收标准。
+ * Coding Readiness / Test-First enforcement。
+ */
+export async function checkCodingReadinessGate(params) {
+    if (!params.ctx)
+        return { allowed: true };
+    const readinessModule = await lazyCodingReadiness();
+    const contract = params.ctx.coding_readiness_contract;
+    if (!contract) {
+        return {
+            allowed: true,
+            reason_zh: "无编码就绪契约（非编码任务），放行",
+        };
+    }
+    const result = readinessModule.evaluateCodingReadiness(contract, false, false, false);
+    if (!result.allowed) {
+        return {
+            allowed: false,
+            reason_zh: result.reason,
+            missing_preconditions: result.missing_preconditions,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * 本地验收门 — 前端/全栈交付前必须有本地访问证据。
+ * Local Docker / Browser Acceptance enforcement。
+ */
+export async function checkLocalAcceptanceGate(params) {
+    const acceptanceModule = await lazyLocalAcceptance();
+    const requirement = acceptanceModule.requiresLocalAcceptance(params.hasFrontend, params.hasBackend, params.hasDockerCompose, params.hasDockerfile);
+    if (!requirement.required)
+        return { allowed: true };
+    if (!params.ctx) {
+        return {
+            allowed: false,
+            reason_zh: "需要本地验收但无任务上下文",
+            required_but_missing: ["local_acceptance_evidence"],
+        };
+    }
+    const evidence = params.ctx.local_acceptance_evidence;
+    if (!evidence) {
+        return {
+            allowed: false,
+            reason_zh: `项目需要本地验收（模式: ${requirement.run_mode}）但缺少验收证据`,
+            required_but_missing: ["local_acceptance_evidence", "final_access_url"],
+        };
+    }
+    if (evidence.run_mode === "not_applicable") {
+        return {
+            allowed: false,
+            reason_zh: "该项目需要本地验收，不得以 not_applicable 代替真实访问证据",
+            required_but_missing: ["manual_review", "final_access_url"],
+        };
+    }
+    const finalAccessResult = acceptanceModule.validateFinalAccess(evidence.final_access, requirement.run_mode);
+    if (!finalAccessResult.passed) {
+        return {
+            allowed: false,
+            reason_zh: `本地验收证据不完整: ${finalAccessResult.blocking_reasons.join("; ")}`,
+            required_but_missing: ["validated_final_access"],
+        };
+    }
+    return { allowed: true };
+}
+//# sourceMappingURL=gate_checks.js.map

package/dist/server/tools/gate_checks.js.map

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

package/dist/server/tools/index.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SoloForgeDeps } from "./types.js";
+export type { SoloForgeDeps } from "./types.js";
+export { requiresDecisionSovereignty, requiresDetailDiscipline, requiresFirstPrinciples, requiresBrainstorm, checkDecisionSovereigntyGate, checkDetailDisciplineGate, checkFirstPrinciplesGate, checkBrainstormGate, } from "./cep_assessment.js";
+export { checkWriteToolPlanGate, checkArchitectureDecisionWorkshopGate, checkDesignArtifactWriteGate, } from "./gate_checks.js";
+/**
+ * 注册所有 SoloForge MCP 工具到服务器实例。
+ * @param server - McpServer 实例
+ * @param deps - 工具依赖项（配置、知识索引、任务上下文）
+ */
+export declare function registerTools(server: McpServer, deps: SoloForgeDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,qCAAqC,EACrC,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEzF"}

package/dist/server/tools/index.js

@@ -0,0 +1,81 @@
+import { debug, internalWarn } from "../../engine/core/logger.js";
+import { lazyLLM, lazyIO } from "./lazy_loaders.js";
+import { listToolInvocationContracts } from "../../engine/contracts/tool_invocation_contract_registry.js";
+import { registerClassifyExpandTools } from "./tool_groups/classify_expand.js";
+import { registerVerifyLearnTools } from "./tool_groups/verify_learn.js";
+import { registerStatusPlanTools, registerAnalyzeReviewTools } from "./tool_groups/status_plan_analyze_review.js";
+import { registerScaffoldAcceptTools, registerDeliverTools } from "./tool_groups/scaffold_accept_deliver.js";
+import { registerAuxiliaryTools } from "./tool_groups/auxiliary.js";
+import { registerKnowledgeTools } from "./tool_groups/knowledge.js";
+import { registerAdminTools } from "./tool_groups/admin.js";
+export { requiresDecisionSovereignty, requiresDetailDiscipline, requiresFirstPrinciples, requiresBrainstorm, checkDecisionSovereigntyGate, checkDetailDisciplineGate, checkFirstPrinciplesGate, checkBrainstormGate, } from "./cep_assessment.js";
+export { checkWriteToolPlanGate, checkArchitectureDecisionWorkshopGate, checkDesignArtifactWriteGate, } from "./gate_checks.js";
+/**
+ * 注册所有 SoloForge MCP 工具到服务器实例。
+ * @param server - McpServer 实例
+ * @param deps - 工具依赖项（配置、知识索引、任务上下文）
+ */
+export async function registerTools(server, deps) {
+    debug("工具注册", "开始注册 MCP 工具...");
+    const { config, knowledgeIndex, taskContext } = deps;
+    const projectPath = config._projectPath || process.cwd();
+    // H1: LLM Gateway — Token 预算熔断，防止单任务 Token 超支
+    const gateway = deps.gateway ?? new (await lazyLLM()).LLMGateway();
+    // H4: IO Controller — 工作区互斥锁，防止外部修改导致的静默覆盖
+    const ioController = new (await lazyIO()).IOController(projectPath);
+    const ctx = {
+        server,
+        config,
+        knowledgeIndex,
+        taskContext,
+        gateway,
+        ioController,
+        projectPath,
+    };
+    debug("工具注册", "批量注册核心/辅助/知识维护工具...");
+    await registerClassifyExpandTools(ctx);
+    await registerVerifyLearnTools(ctx);
+    await registerStatusPlanTools(ctx);
+    await registerAnalyzeReviewTools(ctx);
+    await registerScaffoldAcceptTools(ctx);
+    await registerDeliverTools(ctx);
+    await registerAuxiliaryTools(ctx);
+    await registerKnowledgeTools(ctx);
+    await registerAdminTools(ctx);
+    // ── 启动时工具契约覆盖预检 ──
+    debug("工具注册", "执行工具契约覆盖预检...");
+    const contracts = listToolInvocationContracts();
+    const contractNames = new Set(contracts.map((c) => c.tool_name));
+    // 已注册的工具名称列表（来自各 tool_groups 的 registerSafeTool 调用）
+    const registeredTools = [
+        "sf_classify", "sf_expand",
+        "sf_verify", "sf_learn", "sf_record_verification_execution",
+        "sf_status", "sf_plan", "sf_plan_advance",
+        "sf_analyze", "sf_review",
+        "sf_scaffold", "sf_accept",
+        "sf_deliver",
+        "sf_debug", "sf_explore", "sf_feasibility_check",
+        "sf_test_guide", "sf_test_quality", "sf_dependency_scan",
+        "sf_debt_report", "sf_contract_check", "sf_coord_check",
+        "sf_navigation", "sf_observability", "sf_team_status",
+        "sf_governance_report", "sf_escape_report",
+        "sf_knowledge_add", "sf_knowledge_update", "sf_knowledge_audit",
+        "sf_capability_update",
+        "sf_onboard", "sf_resume_workspace", "sf_migration_check",
+        "sf_audit_integration", "sf_audit_sample",
+    ];
+    // 检查 1: 每个已注册工具都有对应的 invocation contract
+    for (const toolName of registeredTools) {
+        if (!contractNames.has(toolName)) {
+            internalWarn("工具契约预检", `工具 ${toolName} 已注册但无对应的 invocation contract`);
+        }
+    }
+    // 检查 2: 每个 invocation contract 都有对应的已注册工具
+    for (const contractName of contractNames) {
+        if (!registeredTools.includes(contractName)) {
+            internalWarn("工具契约预检", `invocation contract ${contractName} 无对应的已注册工具`);
+        }
+    }
+    debug("工具注册", "工具契约覆盖预检完成。");
+}
+//# sourceMappingURL=index.js.map

package/dist/server/tools/index.js.map

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

package/dist/server/tools/lazy_loaders.d.ts

@@ -0,0 +1,69 @@
+export declare function createLazy<T>(loader: () => Promise<T>): () => Promise<T>;
+export declare const lazyClassifier: () => Promise<typeof import("../../engine/pipeline/classifier.js")>;
+export declare const lazyIntentRouter: () => Promise<typeof import("../../engine/pipeline/intent_router.js")>;
+export declare const lazyExpander: () => Promise<typeof import("../../engine/pipeline/intent_expander.js")>;
+export declare const lazyVerifier: () => Promise<typeof import("../../engine/release/verifier.js")>;
+export declare const lazyEvolver: () => Promise<typeof import("../../engine/audit/evolver.js")>;
+export declare const lazyPlanner: () => Promise<typeof import("../../engine/pipeline/task_planner.js")>;
+export declare const lazyImpact: () => Promise<typeof import("../../engine/impact_analyzer.js")>;
+export declare const lazyReviewer: () => Promise<typeof import("../../engine/audit/code_reviewer.js")>;
+export declare const lazyDebt: () => Promise<typeof import("../../engine/audit/debt_tracker.js")>;
+export declare const lazyScaffolder: () => Promise<typeof import("../../engine/templates/scaffolder.js")>;
+export declare const lazyDelivery: () => Promise<typeof import("../../engine/audit/delivery.js")>;
+export declare const lazyChangeCoord: () => Promise<typeof import("../../engine/change_coordinator.js")>;
+export declare const lazyTeam: () => Promise<typeof import("../../engine/team_awareness.js")>;
+export declare const lazyContractGuard: () => Promise<typeof import("../../engine/contracts/contract_guard.js")>;
+export declare const lazyOnboarding: () => Promise<typeof import("../../engine/onboarding.js")>;
+export declare const lazyGitDeps: () => Promise<typeof import("../../git/git_deps.js")>;
+export declare const lazyKnowledge: () => Promise<typeof import("../../engine/knowledge/knowledge_manager.js")>;
+export declare const lazyFeasibility: () => Promise<typeof import("../../engine/feasibility_checker.js")>;
+export declare const lazyDebugger: () => Promise<typeof import("../../engine/audit/debugger.js")>;
+export declare const lazyObservability: () => Promise<typeof import("../../engine/audit/observability.js")>;
+export declare const lazyGovernance: () => Promise<typeof import("../../engine/audit/governance_report.js")>;
+export declare const lazyMigration: () => Promise<typeof import("../../engine/migration_guard.js")>;
+export declare const lazyTestGen: () => Promise<typeof import("../../engine/audit/test_generator.js")>;
+export declare const lazyTestQuality: () => Promise<typeof import("../../engine/audit/test_quality.js")>;
+export declare const lazyDepScan: () => Promise<typeof import("../../engine/dependency_scanner.js")>;
+export declare const lazyDebtReport: () => Promise<typeof import("../../engine/audit/debt_reporter.js")>;
+export declare const lazyExploration: () => Promise<typeof import("../../engine/exploration.js")>;
+export declare const lazyWorkspaceResumer: () => Promise<typeof import("../../engine/pipeline/workspace_resumer.js")>;
+export declare const lazyLLM: () => Promise<typeof import("../../engine/core/llm_gateway.js")>;
+export declare const lazyIO: () => Promise<typeof import("../../engine/core/io_controller.js")>;
+export declare const lazyCapability: () => Promise<typeof import("../../engine/contracts/capability_registry.js")>;
+export declare const lazyDecision: () => Promise<typeof import("../../engine/contracts/decision_contract.js")>;
+export declare const lazyAnchor: () => Promise<typeof import("../../engine/cognitive_anchor.js")>;
+export declare const lazyJob: () => Promise<typeof import("../../engine/pipeline/job_manager.js")>;
+export declare const lazyAuditPool: () => Promise<typeof import("../../engine/audit/audit_pool.js")>;
+export declare const lazyEscape: () => Promise<typeof import("../../engine/contracts/escape_report.js")>;
+export declare const lazyAuditSampler: () => Promise<typeof import("../../engine/audit/audit_sampler.js")>;
+export declare const lazyCapAdvisor: () => Promise<typeof import("../../engine/contracts/capability_action_advisor.js")>;
+export declare const lazyCapState: () => Promise<typeof import("../../engine/contracts/capability_state_store.js")>;
+export declare const lazyMainPath: () => Promise<typeof import("../../engine/audit/main_path_integration_contract.js")>;
+export declare const lazyDualLayer: () => Promise<typeof import("../../engine/contracts/dual_layer_mechanism_registry.js")>;
+export declare const lazyInputMaterial: () => Promise<typeof import("../../engine/pipeline/input_material_contract_registry.js")>;
+export declare const lazyConfigPrecedence: () => Promise<typeof import("../../engine/config/config_precedence_contract.js")>;
+export declare const lazyEnforcementGuard: () => Promise<typeof import("../../engine/contracts/enforcement_guard.js")>;
+export declare const lazyWorkspaceLease: () => Promise<typeof import("../../engine/pipeline/workspace_lease.js")>;
+export declare const lazyDeliveryReadiness: () => Promise<typeof import("../../engine/audit/delivery_readiness.js")>;
+export declare const lazyVerificationContract: () => Promise<typeof import("../../engine/contracts/verification_contract.js")>;
+export declare const lazyFailureReport: () => Promise<typeof import("../../engine/audit/failure_report.js")>;
+export declare const lazyDegradation: () => Promise<typeof import("../../engine/audit/degradation.js")>;
+export declare const lazyArchitectureDesign: () => Promise<typeof import("../../engine/contracts/architecture_design_contract.js")>;
+export declare const lazyExistingSystemAnalysis: () => Promise<typeof import("../../engine/contracts/existing_system_analysis.js")>;
+export declare const lazyCodingReadiness: () => Promise<typeof import("../../engine/contracts/coding_readiness_gate.js")>;
+export declare const lazyLocalAcceptance: () => Promise<typeof import("../../engine/contracts/local_docker_acceptance.js")>;
+export declare const lazyInstructionContract: () => Promise<typeof import("../../engine/contracts/instruction_contract.js")>;
+export declare const lazyTechnologyDecision: () => Promise<typeof import("../../engine/contracts/technology_decision.js")>;
+export declare const lazyDetailDiscipline: () => Promise<typeof import("../../engine/contracts/detail_discipline.js")>;
+export declare const lazyFirstPrinciples: () => Promise<typeof import("../../engine/contracts/first_principles.js")>;
+export declare const lazyBrainstormContract: () => Promise<typeof import("../../engine/contracts/brainstorm_contract.js")>;
+export declare const lazyArchitectureWorkshop: () => Promise<typeof import("../../engine/contracts/architecture_decision_workshop.js")>;
+export declare const lazyDesignArtifactPack: () => Promise<typeof import("../../engine/contracts/design_artifact_pack.js")>;
+export declare const lazyStandardAssetContract: () => Promise<typeof import("../../engine/templates/standard_asset_contract.js")>;
+export declare const lazyDecisionWorkshop: () => Promise<typeof import("../../engine/contracts/decision_workshop.js")>;
+export declare const lazyNavigation: () => Promise<typeof import("../../engine/workflow/next_action_planner.js")>;
+export declare const lazyOodSolid: () => Promise<typeof import("../../engine/contracts/ood_solid_contract.js")>;
+export declare const lazyBackendImplementation: () => Promise<typeof import("../../engine/contracts/backend_implementation_contract.js")>;
+export declare const lazyCodeObservability: () => Promise<typeof import("../../engine/contracts/code_maintainability_observability_contract.js")>;
+export declare const lazyTraceability: () => Promise<typeof import("../../engine/contracts/traceability.js")>;
+//# sourceMappingURL=lazy_loaders.d.ts.map

package/dist/server/tools/lazy_loaders.d.ts.map

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

package/dist/server/tools/lazy_loaders.js

@@ -0,0 +1,80 @@
+// ── 引擎模块懒加载 ──
+// 按需动态加载引擎模块，避免启动时加载 60+ 模块
+export function createLazy(loader) {
+    const mod = { loaded: null, promise: null };
+    return () => {
+        if (mod.loaded)
+            return Promise.resolve(mod.loaded);
+        if (!mod.promise)
+            mod.promise = loader().then(m => { mod.loaded = m; return m; });
+        return mod.promise;
+    };
+}
+export const lazyClassifier = createLazy(() => import("../../engine/pipeline/classifier.js"));
+export const lazyIntentRouter = createLazy(() => import("../../engine/pipeline/intent_router.js"));
+export const lazyExpander = createLazy(() => import("../../engine/pipeline/intent_expander.js"));
+export const lazyVerifier = createLazy(() => import("../../engine/release/verifier.js"));
+export const lazyEvolver = createLazy(() => import("../../engine/audit/evolver.js"));
+export const lazyPlanner = createLazy(() => import("../../engine/pipeline/task_planner.js"));
+export const lazyImpact = createLazy(() => import("../../engine/impact_analyzer.js"));
+export const lazyReviewer = createLazy(() => import("../../engine/audit/code_reviewer.js"));
+export const lazyDebt = createLazy(() => import("../../engine/audit/debt_tracker.js"));
+export const lazyScaffolder = createLazy(() => import("../../engine/templates/scaffolder.js"));
+export const lazyDelivery = createLazy(() => import("../../engine/audit/delivery.js"));
+export const lazyChangeCoord = createLazy(() => import("../../engine/change_coordinator.js"));
+export const lazyTeam = createLazy(() => import("../../engine/team_awareness.js"));
+export const lazyContractGuard = createLazy(() => import("../../engine/contracts/contract_guard.js"));
+export const lazyOnboarding = createLazy(() => import("../../engine/onboarding.js"));
+export const lazyGitDeps = createLazy(() => import("../../git/git_deps.js"));
+export const lazyKnowledge = createLazy(() => import("../../engine/knowledge/knowledge_manager.js"));
+export const lazyFeasibility = createLazy(() => import("../../engine/feasibility_checker.js"));
+export const lazyDebugger = createLazy(() => import("../../engine/audit/debugger.js"));
+export const lazyObservability = createLazy(() => import("../../engine/audit/observability.js"));
+export const lazyGovernance = createLazy(() => import("../../engine/audit/governance_report.js"));
+export const lazyMigration = createLazy(() => import("../../engine/migration_guard.js"));
+export const lazyTestGen = createLazy(() => import("../../engine/audit/test_generator.js"));
+export const lazyTestQuality = createLazy(() => import("../../engine/audit/test_quality.js"));
+export const lazyDepScan = createLazy(() => import("../../engine/dependency_scanner.js"));
+export const lazyDebtReport = createLazy(() => import("../../engine/audit/debt_reporter.js"));
+export const lazyExploration = createLazy(() => import("../../engine/exploration.js"));
+export const lazyWorkspaceResumer = createLazy(() => import("../../engine/pipeline/workspace_resumer.js"));
+export const lazyLLM = createLazy(() => import("../../engine/core/llm_gateway.js"));
+export const lazyIO = createLazy(() => import("../../engine/core/io_controller.js"));
+export const lazyCapability = createLazy(() => import("../../engine/contracts/capability_registry.js"));
+export const lazyDecision = createLazy(() => import("../../engine/contracts/decision_contract.js"));
+export const lazyAnchor = createLazy(() => import("../../engine/cognitive_anchor.js"));
+export const lazyJob = createLazy(() => import("../../engine/pipeline/job_manager.js"));
+export const lazyAuditPool = createLazy(() => import("../../engine/audit/audit_pool.js"));
+export const lazyEscape = createLazy(() => import("../../engine/contracts/escape_report.js"));
+export const lazyAuditSampler = createLazy(() => import("../../engine/audit/audit_sampler.js"));
+export const lazyCapAdvisor = createLazy(() => import("../../engine/contracts/capability_action_advisor.js"));
+export const lazyCapState = createLazy(() => import("../../engine/contracts/capability_state_store.js"));
+export const lazyMainPath = createLazy(() => import("../../engine/audit/main_path_integration_contract.js"));
+export const lazyDualLayer = createLazy(() => import("../../engine/contracts/dual_layer_mechanism_registry.js"));
+export const lazyInputMaterial = createLazy(() => import("../../engine/pipeline/input_material_contract_registry.js"));
+export const lazyConfigPrecedence = createLazy(() => import("../../engine/config/config_precedence_contract.js"));
+export const lazyEnforcementGuard = createLazy(() => import("../../engine/contracts/enforcement_guard.js"));
+export const lazyWorkspaceLease = createLazy(() => import("../../engine/pipeline/workspace_lease.js"));
+export const lazyDeliveryReadiness = createLazy(() => import("../../engine/audit/delivery_readiness.js"));
+export const lazyVerificationContract = createLazy(() => import("../../engine/contracts/verification_contract.js"));
+export const lazyFailureReport = createLazy(() => import("../../engine/audit/failure_report.js"));
+export const lazyDegradation = createLazy(() => import("../../engine/audit/degradation.js"));
+export const lazyArchitectureDesign = createLazy(() => import("../../engine/contracts/architecture_design_contract.js"));
+export const lazyExistingSystemAnalysis = createLazy(() => import("../../engine/contracts/existing_system_analysis.js"));
+export const lazyCodingReadiness = createLazy(() => import("../../engine/contracts/coding_readiness_gate.js"));
+export const lazyLocalAcceptance = createLazy(() => import("../../engine/contracts/local_docker_acceptance.js"));
+export const lazyInstructionContract = createLazy(() => import("../../engine/contracts/instruction_contract.js"));
+export const lazyTechnologyDecision = createLazy(() => import("../../engine/contracts/technology_decision.js"));
+export const lazyDetailDiscipline = createLazy(() => import("../../engine/contracts/detail_discipline.js"));
+export const lazyFirstPrinciples = createLazy(() => import("../../engine/contracts/first_principles.js"));
+export const lazyBrainstormContract = createLazy(() => import("../../engine/contracts/brainstorm_contract.js"));
+export const lazyArchitectureWorkshop = createLazy(() => import("../../engine/contracts/architecture_decision_workshop.js"));
+export const lazyDesignArtifactPack = createLazy(() => import("../../engine/contracts/design_artifact_pack.js"));
+export const lazyStandardAssetContract = createLazy(() => import("../../engine/templates/standard_asset_contract.js"));
+export const lazyDecisionWorkshop = createLazy(() => import("../../engine/contracts/decision_workshop.js"));
+export const lazyNavigation = createLazy(() => import("../../engine/workflow/next_action_planner.js"));
+export const lazyOodSolid = createLazy(() => import("../../engine/contracts/ood_solid_contract.js"));
+export const lazyBackendImplementation = createLazy(() => import("../../engine/contracts/backend_implementation_contract.js"));
+export const lazyCodeObservability = createLazy(() => import("../../engine/contracts/code_maintainability_observability_contract.js"));
+export const lazyTraceability = createLazy(() => import("../../engine/contracts/traceability.js"));
+//# sourceMappingURL=lazy_loaders.js.map

package/dist/server/tools/lazy_loaders.js.map

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

package/dist/server/tools/middleware.d.ts

@@ -0,0 +1,50 @@
+import type { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ProjectConfig } from "../../types/index.js";
+import type { KnowledgeIndexManager } from "../../knowledge/index_manager.js";
+import type { TaskContextManager } from "../../engine/pipeline/task_context.js";
+import type { LLMGateway } from "../../engine/core/llm_gateway.js";
+import type { IOController } from "../../engine/core/io_controller.js";
+/** MCP 工具 handler 参数类型 — schema 解析后的动态类型，消费者通过 args.xxx 直接访问字段 */
+export type ToolRequestArgs = Record<string, any>;
+/** MCP 工具 handler 返回类型 — 由中间件动态检查结构 */
+export type ToolHandlerResult = unknown;
+/**
+ * 工具 handler 错误返回类型 — 结构化错误信息。
+ * 用于新/修改的 handler 返回统一格式的错误，渐进式迁移。
+ */
+export interface ToolHandlerError {
+    /** 错误描述 */
+    error: string;
+    /** 诊断码 — 对应 TOOL_DIAGNOSTIC_CODES 中的条目 */
+    diagnostic_code?: string;
+    /** 恢复建议 */
+    recovery?: string;
+    /** 恢复后推荐的下一步工具 */
+    recovery_next_tools?: string[];
+    /** 恢复后禁止使用的工具 */
+    recovery_forbidden_tools?: string[];
+}
+export interface ToolRegistrationContext {
+    server: McpServer;
+    config: ProjectConfig;
+    knowledgeIndex: KnowledgeIndexManager;
+    taskContext: TaskContextManager;
+    gateway: LLMGateway;
+    ioController: IOController;
+    projectPath: string;
+}
+export interface ToolRegistrar {
+    registerSafeTool: (name: string, desc: string, schema: Record<string, z.ZodTypeAny>, handler: (args: ToolRequestArgs) => Promise<ToolHandlerResult>) => void;
+    loadRelevantAnchors: (query: {
+        module?: string;
+        file_paths?: string[];
+    }) => Promise<Array<{
+        anchor_id: string;
+        module: string;
+        summary: string;
+        stale_anchor?: boolean;
+    }> | undefined>;
+}
+export declare function createToolRegistrar(ctx: ToolRegistrationContext): ToolRegistrar;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/server/tools/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/server/tools/middleware.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAyBvE,kEAAkE;AAElE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAElD,uCAAuC;AACvC,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB;IACjB,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,EACpC,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,KAC3D,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CACjF,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,SAAS,CAClG,CAAC;CACH;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,uBAAuB,GAAG,aAAa,CAimB/E"}