soloforge 1.2.19 → 1.3.0

package/dist/engine/mechanism_contract_registry.js

@@ -31,14 +31,14 @@ export const P0_MECHANISM_CONTRACTS = [
         tests: ["tests/engine/intent_router.test.ts"],
         lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
     },
-    // ── 2. classifier ──
+    // ── 2. classifier (deprecated → mc-intent-router) ──
     {
         id: "mc-classifier",
-        name: "Classifier",
+        name: "Classifier (deprecated → mc-intent-router)",
         owner_module: "src/engine/classifier.ts",
         owner_exports: ["classify"],
         mechanism_type: "classification",
-        status: "advisory",
+        status: "deprecated",
         trigger: "sf_classify 调用时，routeIntent 之后",
         required_inputs: ["intent", "route_decision"],
         preconditions: ["route_decision 已由 intent_router 生成"],
@@ -51,7 +51,7 @@ export const P0_MECHANISM_CONTRACTS = [
         degradation_behavior: "classifier 仅提供兼容字段和辅助分类，不能重新夺回入口裁决权；route_decision 始终由 intent_router 决定",
         tests: ["tests/engine/classifier.test.ts"],
         lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
-        notes: "classifier 不能重新夺回入口裁决权，route_decision 才是入口裁决的唯一来源",
+        notes: "已废弃: classifier 是 intent_router 的一部分，正式机制 ID 为 mc-intent-router。owner_mechanism_id 必须指向 mc-intent-router。",
     },
     // ── 3. intent_expander ──
     {
@@ -75,14 +75,14 @@ export const P0_MECHANISM_CONTRACTS = [
         tests: ["tests/engine/intent_expander_integration.test.ts"],
         lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
     },
-    // ── 4. knowledge_matching ──
+    // ── 4. knowledge_matching (deprecated → mc-knowledge-injection-boundary) ──
     {
         id: "mc-knowledge-matching",
-        name: "Knowledge Matching",
+        name: "Knowledge Matching (deprecated → mc-knowledge-injection-boundary)",
         owner_module: "src/knowledge/index_manager.ts",
         owner_exports: ["KnowledgeIndexManager"],
         mechanism_type: "knowledge_matching",
-        status: "advisory",
+        status: "deprecated",
         trigger: "expand() 内部调用 knowledgeIndex.query()",
         required_inputs: ["route_decision", "output_artifact.kind", "pipeline_hint", "knowledge_index"],
         preconditions: ["knowledge index 已 build"],
@@ -97,7 +97,7 @@ export const P0_MECHANISM_CONTRACTS = [
         degradation_behavior: "整体 advisory，但 required branch（prototype_spec → 原型说明模版）为 enforced：缺失时必须报错而非静默降级。其他分支缺失时优雅降级为空匹配",
         tests: ["tests/engine/intent_expander_integration.test.ts"],
         lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
-        notes: "整体 advisory，required branch enforced。prototype_spec 对应的 acceptance_template 不可缺失",
+        notes: "已废弃: knowledge_matching 是 knowledge_injection_boundary 的一部分，正式机制 ID 为 mc-knowledge-injection-boundary。",
     },
     // ── 5. knowledge_injection_boundary ──
     {
@@ -190,14 +190,14 @@ export const P0_MECHANISM_CONTRACTS = [
         tests: ["tests/engine/verifier_phase25.test.ts"],
         lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
     },
-    // ── 8. workspace_resumer ──
+    // ── 8. workspace_resumer (deprecated → mc-task-context-lifecycle) ──
     {
         id: "mc-workspace-resumer",
-        name: "Workspace Resumer",
+        name: "Workspace Resumer (deprecated → mc-task-context-lifecycle)",
         owner_module: "src/engine/workspace_resumer.ts",
         owner_exports: ["scanAndResume", "cleanupStaleTasks"],
         mechanism_type: "state_lifecycle",
-        status: "enforced",
+        status: "deprecated",
         trigger: "sf_status action=resume 或会话启动时",
         required_inputs: ["task_state_directory", "current_task_pointer", "active_task_list"],
         preconditions: ["stateDir 存在"],
@@ -220,6 +220,7 @@ export const P0_MECHANISM_CONTRACTS = [
         degradation_behavior: "corrupt task 标记为 unrecoverable，不阻塞其他任务恢复",
         tests: ["tests/engine/workspace_resumer.test.ts"],
         lifecycle_tests: ["tests/engine/workspace_resumer.test.ts", "tests/adapters/tools_lifecycle.test.ts"],
+        notes: "已废弃: workspace_resumer 是 task_context_lifecycle 的一部分，正式机制 ID 为 mc-task-context-lifecycle。",
     },
     // ── 9. core_engineering_principles ──
     {
@@ -249,8 +250,8 @@ export const P0_MECHANISM_CONTRACTS = [
     },
     // ── 交付 ──
     {
-        id: "mc-delivery",
-        name: "Delivery",
+        id: "mc-delivery-gate",
+        name: "Delivery Gate",
         owner_module: "src/engine/delivery.ts",
         owner_exports: ["deliver", "generateChangelogEntry"],
         mechanism_type: "delivery",
@@ -369,13 +370,446 @@ export const P0_MECHANISM_CONTRACTS = [
         tests: ["tests/engine/config_precedence_contract.test.ts"],
         lifecycle_tests: ["tests/engine/config_precedence_contract.test.ts"],
     },
+    // ══ 扩展平台机制契约 ══
+    // ── 16. extension_contract (problem-39) ──
+    {
+        id: "mc-extension-contract",
+        name: "扩展生命周期与权限管控",
+        owner_module: "src/engine/extension_contract.ts",
+        owner_exports: ["validateExtensionManifest", "evaluateExtensionLifecycle", "grantExtensionPermissions"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "扩展注册与权限申请时",
+        required_inputs: ["extension_manifest", "capability_declaration"],
+        preconditions: ["extension_id 非空"],
+        outputs: ["ExtensionManifest", "ExtensionLifecycleResult", "PermissionGrantResult"],
+        downstream_consumers: ["sf_expand", "sf_verify"],
+        failure_modes: ["第三方扩展自称 enforced", "高风险权限未审批", "非法生命周期转移"],
+        degradation_behavior: "扩展不合规时拒绝注册",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 17. platform_compatibility (problem-40) ──
+    {
+        id: "mc-platform-compatibility",
+        name: "跨平台路径安全",
+        owner_module: "src/engine/platform_context.ts",
+        owner_exports: ["normalizePathRef", "checkPathSafety", "detectPlatformContext"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "文件路径操作时",
+        required_inputs: ["raw_path", "platform_context", "scope_boundary"],
+        preconditions: ["scope_boundary 已设定"],
+        outputs: ["NormalizedPathRef", "PathSafetyCheck"],
+        downstream_consumers: ["sf_expand", "sf_verify"],
+        failure_modes: ["路径逃逸未检测", "大小写冲突", "scope 边界绕过"],
+        degradation_behavior: "路径不安全时拒绝操作",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 18. metric_governance (problem-19) ──
+    {
+        id: "mc-metric-governance",
+        name: "指标治理",
+        owner_module: "src/engine/metric_governance.ts",
+        owner_exports: ["evaluateMetrics", "evaluateGovernanceAction", "createGovernanceFinding"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "治理指标评估时",
+        required_inputs: ["metric_samples"],
+        preconditions: [],
+        outputs: ["MetricsEvaluationResult", "GovernanceFinding"],
+        downstream_consumers: ["sf_verify", "sf_learn"],
+        failure_modes: ["skipped 算 passed", "高风险动作自动触发"],
+        degradation_behavior: "指标不合规时标记为 failed",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 19. decision_svereignty (problem-16) ──
+    {
+        id: "mc-decision-sovereignty",
+        name: "技术决策主权",
+        owner_module: "src/engine/technology_decision.ts",
+        owner_exports: ["validateTechnologyDecision", "evaluateDecisionExecution", "createDecisionRecord"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "技术决策评估时",
+        required_inputs: ["decision_contract", "decision_record"],
+        preconditions: [],
+        outputs: ["TechnologyDecisionContract", "DecisionValidationResult"],
+        downstream_consumers: ["sf_expand", "sf_verify"],
+        failure_modes: ["architecture 无 human gate", "推荐状态可执行"],
+        degradation_behavior: "决策不合规时拒绝执行",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 20. brainstorm_contract (problem-41) ──
+    {
+        id: "mc-brainstorm-contract",
+        name: "脑暴与方案探索",
+        owner_module: "src/engine/brainstorm_contract.ts",
+        owner_exports: ["validateBrainstormSession", "canBrainstormAutoExecute", "createBrainstormSession"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "技术选择脑暴时",
+        required_inputs: ["problem_statement", "trigger"],
+        preconditions: [],
+        outputs: ["BrainstormSession", "BrainstormValidationResult"],
+        downstream_consumers: ["sf_expand"],
+        failure_modes: ["脑暴无候选方案", "脑暴绕过决策主权"],
+        degradation_behavior: "脑暴不完整时阻断",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 21. detail_discipline (problem-26) ──
+    {
+        id: "mc-detail-discipline",
+        name: "细节纪律",
+        owner_module: "src/engine/detail_discipline.ts",
+        owner_exports: ["performDetailCheck", "checkDetailGateIntegration", "createDetailDisciplineContract"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "实现阶段细节检查时",
+        required_inputs: ["contract", "task_id", "phase"],
+        preconditions: [],
+        outputs: ["DetailDisciplineCheck", "DetailGateIntegrationResult"],
+        downstream_consumers: ["sf_expand", "sf_verify", "delivery"],
+        failure_modes: ["缺失关键维度", "未接入交付 gate"],
+        degradation_behavior: "细节不足时阻断",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 22. first_principles (problem-27) ──
+    {
+        id: "mc-first-principles",
+        name: "第一性原理",
+        owner_module: "src/engine/first_principles.ts",
+        owner_exports: ["performFirstPrinciplesCheck", "validateFirstPrinciplesForHighImpact", "createFirstPrinciplesFrame"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "高影响变更推理时",
+        required_inputs: ["problem_id", "user_goal"],
+        preconditions: [],
+        outputs: ["FirstPrinciplesFrame", "FirstPrinciplesCheckResult"],
+        downstream_consumers: ["sf_expand"],
+        failure_modes: ["缺少 fundamental_need", "无法阻断错误前提"],
+        degradation_behavior: "推理不完整时阻断",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 23. architecture_design (problem-49) ──
+    {
+        id: "mc-architecture-design",
+        name: "架构设计审查",
+        owner_module: "src/engine/architecture_design_contract.ts",
+        owner_exports: ["reviewArchitectureDesign", "validateOutputDirectoryDecision", "validateMermaidDiagrams"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "架构设计阶段时",
+        required_inputs: ["architecture_contract"],
+        preconditions: [],
+        outputs: ["ArchitectureDesignContract", "ArchitectureReviewResult"],
+        downstream_consumers: ["sf_expand", "sf_verify"],
+        failure_modes: ["输出目录未确认", "Mermaid 不可渲染"],
+        degradation_behavior: "设计不合规时阻断交付",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 24. existing_system_analysis (problem-50) ──
+    {
+        id: "mc-existing-system-analysis",
+        name: "现有系统分析与差距分析",
+        owner_module: "src/engine/existing_system_analysis.ts",
+        owner_exports: ["detectProjectContext", "checkAnalysisGate", "createExistingSystemAnalysis"],
+        mechanism_type: "analysis",
+        status: "enforced",
+        trigger: "existing_system 项目启动时",
+        required_inputs: ["has_existing_system", "has_new_requirement"],
+        preconditions: [],
+        outputs: ["ProjectContext", "AnalysisGateResult"],
+        downstream_consumers: ["sf_expand"],
+        failure_modes: ["existing_system 未分析"],
+        degradation_behavior: "未分析时阻断后续流程",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 25. coding_readiness (problem-51) ──
+    {
+        id: "mc-coding-readiness",
+        name: "编码准备门与测试优先",
+        owner_module: "src/engine/coding_readiness_gate.ts",
+        owner_exports: ["evaluateCodingReadiness", "createTestFirstPlan", "performMainlineConsumptionCheck"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "编码开始前",
+        required_inputs: ["coding_readiness_contract", "preconditions"],
+        preconditions: [],
+        outputs: ["ReadinessEvaluationResult", "TestFirstPlan"],
+        downstream_consumers: ["sf_expand"],
+        failure_modes: ["编码作为第一步", "blocked 状态允许编码"],
+        degradation_behavior: "准备不足时阻断编码",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 26. local_acceptance (problem-52) ──
+    {
+        id: "mc-local-acceptance",
+        name: "本地 Docker/浏览器验收",
+        owner_module: "src/engine/local_docker_acceptance.ts",
+        owner_exports: ["validateFinalAccess", "requiresLocalAcceptance", "performBrowserAcceptance"],
+        mechanism_type: "verification",
+        status: "enforced",
+        trigger: "本地验收阶段",
+        required_inputs: ["final_access", "project_run_mode"],
+        preconditions: [],
+        outputs: ["LocalDockerAcceptanceContract", "FinalAccessValidationResult"],
+        downstream_consumers: ["sf_verify", "delivery"],
+        failure_modes: ["无本地 URL", "浏览器验收失败未修复"],
+        degradation_behavior: "验收不通过时阻断交付",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 27. workflow_template_pack (problem-53) ──
+    {
+        id: "mc-workflow-template-pack",
+        name: "工作流模板包消费",
+        owner_module: "src/engine/workflow_template_pack.ts",
+        owner_exports: ["validateWorkflowTemplatePack", "advanceTemplateConsumptionStatus", "createTemplateConsumptionEvidence"],
+        mechanism_type: "artifact_management",
+        status: "enforced",
+        trigger: "模板消费验证时",
+        required_inputs: ["pack_contract", "consumption_evidences"],
+        preconditions: [],
+        outputs: ["WorkflowTemplatePackContract", "PackValidationResult"],
+        downstream_consumers: ["sf_expand", "sf_verify"],
+        failure_modes: ["模板停在中间状态", "消费 pipeline 不完整"],
+        degradation_behavior: "消费不完整时阻断",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 28. evolution_regression (problem-54) ──
+    {
+        id: "mc-evolution-regression",
+        name: "演进回归与新问题门控",
+        owner_module: "src/engine/evolution_regression_gate.ts",
+        owner_exports: ["performEvolutionGate", "checkDuplicateIssue", "createNewIssueRegressionGate"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "新问题登记时",
+        required_inputs: ["issue_candidate"],
+        preconditions: [],
+        outputs: ["NewIssueRegressionGate", "EvolutionGateResult"],
+        downstream_consumers: ["sf_expand"],
+        failure_modes: ["重复问题未检测", "无门控被接受"],
+        degradation_behavior: "门控未通过时拒绝问题",
+        tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+    },
+    // ── 29. plan_proposal_gate (problem-55) ──
+    {
+        id: "mc-plan-proposal-gate",
+        name: "Plan / Proposal First Gate",
+        owner_module: "src/engine/plan_proposal_gate.ts",
+        owner_exports: ["evaluatePlanProposalGate", "requirePlanBeforeAction", "validateActionWithinPlan", "createPlanProposalEvidence", "inferPlanGateTaskType"],
+        mechanism_type: "planning",
+        status: "enforced",
+        trigger: "classify/route 后、expand/executing 前",
+        required_inputs: ["task_id", "task_type", "user_intent"],
+        preconditions: ["sf_classify 已完成"],
+        outputs: ["PlanProposalGateResult", "PlanProposalEvidence", "UserConfirmationRef", "VerificationPlanRef"],
+        downstream_consumers: ["sf_expand", "sf_execute", "sf_deliver", "ToolInvocation", "CommandContract"],
+        failure_modes: ["缺计划执行写入", "高风险无确认", "计划外动作", "review 被升级为执行"],
+        degradation_behavior: "Plan Gate 未通过时阻断写入/编码/构建/Docker/迁移/发布/交付",
+        tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+    },
+    // ── 30. core_experience_principle (problem-56) ──
+    {
+        id: "mc-core-experience-principle",
+        name: "Core Experience Principle",
+        owner_module: "src/engine/core_experience_principle.ts",
+        owner_exports: ["evaluateCoreExperiencePrinciple", "evaluateNoFalseCompletion", "evaluateMechanismFriction", "evaluateUserVisibleOutput", "createCoreExperiencePrincipleContract"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "新增机制/模板/workflow/Batch 问题时",
+        required_inputs: ["task_id", "workflow_id", "mechanism_evaluation_params"],
+        preconditions: ["新增机制已注册"],
+        outputs: ["CoreExperiencePrincipleEvaluation", "UserPathFrictionReport", "EvidenceSufficiencyReport", "RepairOrManualRequiredDecision"],
+        downstream_consumers: ["sf_verify", "sf_deliver", "validate-mechanisms", "ReleaseGate"],
+        failure_modes: ["机制未接主线", "用户路径过长", "硬规则降级", "假完成"],
+        degradation_behavior: "体验原则违反时阻断交付/发布",
+        tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+    },
+    // ── 31. knowledge_asset_governance (problem-57) ──
+    {
+        id: "mc-knowledge-asset-governance",
+        name: "Knowledge Asset Governance",
+        owner_module: "src/engine/knowledge_asset_schema.ts",
+        owner_exports: ["validateKnowledgeAssets", "buildKnowledgeAssetRegistry", "detectDuplicateAndConflicts", "resolveCanonicalAuthority"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "知识资产新增/修改/同步/迁移时",
+        required_inputs: ["knowledge_assets", "template_paths"],
+        preconditions: ["templates/knowledge/** 存在"],
+        outputs: ["KnowledgeAssetAuditReport", "KnowledgeConsumptionSnapshot", "KnowledgeAssetGenerationGateResult", "KnowledgeAssetMigrationPlan"],
+        downstream_consumers: ["intent_router", "intent_expander", "verifier", "adapter_prompt", "sync/migration", "observability"],
+        failure_modes: ["缺 frontmatter", "重复 canonical", "owner 缺失", "deprecated 被注入", "消费链路不可追踪"],
+        degradation_behavior: "知识资产审计失败时阻断注入",
+        tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+    },
+    // ══ DL-only 机制补入 MC ══
+    // ── 32. workflow_contract ──
+    {
+        id: "mc-workflow-contract",
+        name: "工作流契约",
+        owner_module: "src/engine/workflow_contract_registry.ts",
+        owner_exports: ["resolveWorkflow", "validateWorkflowContracts"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "sf_classify/sf_expand 路由后",
+        required_inputs: ["route_decision", "workflow_id"],
+        preconditions: ["route 已确定"],
+        outputs: ["WorkflowContract", "WorkflowTrace"],
+        downstream_consumers: ["sf_expand", "sf_verify", "sf_deliver"],
+        failure_modes: ["workflow 缺失 required_mechanism", "workflow 与 route 不匹配"],
+        degradation_behavior: "workflow 未命中时降级为默认 workflow",
+        tests: ["tests/engine/workflow_contract_registry.test.ts"],
+        lifecycle_tests: ["tests/engine/workflow_contract_registry.test.ts"],
+    },
+    // ── 33. tool_invocation_contract ──
+    {
+        id: "mc-tool-invocation-contract",
+        name: "工具调用契约",
+        owner_module: "src/adapters/claude_code/tools.ts",
+        owner_exports: ["registerTools", "checkWriteToolPlanGate"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "MCP tool 调用时",
+        required_inputs: ["tool_name", "tool_args"],
+        preconditions: [],
+        outputs: ["ToolResult"],
+        downstream_consumers: ["sf_classify", "sf_expand", "sf_verify", "sf_learn", "sf_deliver"],
+        failure_modes: ["tool 参数缺失", "tool 返回结构不符合契约"],
+        degradation_behavior: "tool 调用失败时返回错误信息",
+        tests: ["tests/adapters/tools_lifecycle.test.ts"],
+        lifecycle_tests: ["tests/adapters/tools_lifecycle.test.ts"],
+    },
+    // ── 34. main_path_integration ──
+    {
+        id: "mc-main-path-integration",
+        name: "主链路集成",
+        owner_module: "src/engine/main_path_integration_contract.ts",
+        owner_exports: ["orphanGate", "auditIntegration", "validateMainPathIntegration"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "sf_verify 验证阶段",
+        required_inputs: ["changed_files", "route_decision"],
+        preconditions: [],
+        outputs: ["MainPathIntegrationReport"],
+        downstream_consumers: ["sf_verify", "sf_learn"],
+        failure_modes: ["孤岛模块未接入主链路"],
+        degradation_behavior: "孤岛模块不阻断但报告为 finding",
+        tests: ["tests/engine/main_path_integration_contract.test.ts"],
+        lifecycle_tests: ["tests/engine/main_path_integration_contract.test.ts"],
+    },
+    // ── 35. privacy_boundary ──
+    {
+        id: "mc-privacy-boundary",
+        name: "隐私边界",
+        owner_module: "src/engine/privacy_secret_contract.ts",
+        owner_exports: ["scanTextSensitivity", "evaluatePrivacyGate", "redactSensitiveText"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "sf_expand 扩展前",
+        required_inputs: ["intent", "input_materials"],
+        preconditions: [],
+        outputs: ["PrivacyCheckResult"],
+        downstream_consumers: ["sf_expand", "sf_deliver"],
+        failure_modes: ["敏感数据泄漏到 prompt", "生产数据进入代码"],
+        degradation_behavior: "隐私检查失败时阻断扩展",
+        tests: ["tests/engine/privacy_secret_contract.test.ts"],
+        lifecycle_tests: ["tests/engine/privacy_secret_contract.test.ts"],
+    },
+    // ── 36. command_execution ──
+    {
+        id: "mc-command-execution",
+        name: "命令执行契约",
+        owner_module: "src/engine/command_execution_contract.ts",
+        owner_exports: ["validateCommand"],
+        mechanism_type: "safety",
+        status: "enforced",
+        trigger: "命令执行前",
+        required_inputs: ["command", "risk_level"],
+        preconditions: [],
+        outputs: ["CommandValidationResult"],
+        downstream_consumers: ["sf_verify", "sf_deliver"],
+        failure_modes: ["destructive 命令未确认", "命令注入"],
+        degradation_behavior: "高风险命令需要人工确认",
+        tests: ["tests/engine/command_execution_contract.test.ts"],
+        lifecycle_tests: ["tests/engine/command_execution_contract.test.ts"],
+    },
+    // ── 37. guard_evaluation ──
+    {
+        id: "mc-guard-evaluation",
+        name: "护栏评估",
+        owner_module: "src/engine/enforcement_guard.ts",
+        owner_exports: ["listAllGuards", "evaluateWriteGuard", "validateGuardContractIds"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "sf_expand/sf_verify 阶段",
+        required_inputs: ["route", "mechanism_status"],
+        preconditions: [],
+        outputs: ["GuardEvaluationResult"],
+        downstream_consumers: ["sf_expand", "sf_verify", "sf_deliver"],
+        failure_modes: ["required 机制未 enforced", "guard 绕过"],
+        degradation_behavior: "guard 失败时阻断流程",
+        tests: ["tests/engine/verification_scenario_matrix.test.ts"],
+        lifecycle_tests: ["tests/engine/verification_scenario_matrix.test.ts"],
+    },
+    // ── 38. registry_infrastructure ──
+    {
+        id: "mc-registry-infrastructure",
+        name: "注册表基础设施",
+        owner_module: "src/engine/consumable_asset_registry.ts",
+        owner_exports: ["listBuiltinConsumableAssets", "findConsumableAssetByPath"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "初始化时",
+        required_inputs: ["asset_path", "mechanism_id"],
+        preconditions: [],
+        outputs: ["ConsumableAssetRef[]"],
+        downstream_consumers: ["intent_router", "intent_expander", "verifier", "claude_md"],
+        failure_modes: ["资产注册不一致", "owner_mechanism_id 不存在"],
+        degradation_behavior: "注册表不一致时报告为 finding",
+        tests: ["tests/engine/consumable_asset_registry.test.ts"],
+        lifecycle_tests: ["tests/engine/consumable_asset_registry.test.ts"],
+    },
+    // ── 39. instruction_contract ──
+    {
+        id: "mc-instruction-contract",
+        name: "施工指令契约",
+        owner_module: "src/engine/instruction_contract.ts",
+        owner_exports: ["validateInstructionContract", "registerInstructionIssueCandidate", "checkInstructionCompleteness", "enforceInstructionBeforeImplementation"],
+        mechanism_type: "governance",
+        status: "enforced",
+        trigger: "写操作/实现/编码前",
+        required_inputs: ["task_id", "goal", "scope", "non_goals", "output_location", "acceptance_criteria", "bypass_prohibited"],
+        preconditions: [],
+        outputs: ["InstructionValidationResult", "InstructionEnforcementResult"],
+        downstream_consumers: ["sf_expand", "registerSafeTool middleware", "sf_verify", "sf_deliver"],
+        failure_modes: ["施工指令缺失必填字段", "blocked 状态指令被放行", "空值假通过"],
+        degradation_behavior: "指令不完整时阻断，不可降级",
+        tests: ["tests/engine/instruction_contract.test.ts"],
+        lifecycle_tests: ["tests/engine/instruction_contract.test.ts"],
+    },
 ];
 // ── 查询函数 ──
 /**
  * 执行 listMechanismContracts 操作
  */
 export function listMechanismContracts() {
-    console.error("[soloForge] 机制契约: listMechanismContracts() 列出所有机制契约");
     return P0_MECHANISM_CONTRACTS;
 }
 /**
@@ -384,14 +818,12 @@ export function listMechanismContracts() {
  * @returns 匹配的机制契约，未找到时返回 undefined
  */
 export function findMechanismContractById(id) {
-    console.error("[soloForge] 机制契约: findMechanismContractById() 查找契约, id=%s", id);
     return P0_MECHANISM_CONTRACTS.find((c) => c.id === id);
 }
 /**
  * 执行 listMechanismContractsByStatus 操作
  */
 export function listMechanismContractsByStatus(status) {
-    console.error("[soloForge] 机制契约: listMechanismContractsByStatus() 按状态筛选, status=%s", status);
     return P0_MECHANISM_CONTRACTS.filter((c) => c.status === status);
 }
 // ── 治理验证 ──
@@ -402,7 +834,6 @@ export function listMechanismContractsByStatus(status) {
  * @returns 治理发现列表（hard_fail 为硬性错误，advisory 为建议项）
  */
 export function validateMechanismContracts(contracts = P0_MECHANISM_CONTRACTS, rootDir = process.cwd()) {
-    console.error("[soloForge] 机制契约: validateMechanismContracts() 开始执行");
     const findings = [];
     const seenIds = new Set();
     for (const c of contracts) {