soloforge 1.2.20 → 1.3.0

package/dist/engine/dual_layer_mechanism_registry.js

@@ -34,6 +34,7 @@ const KNOWN_REGISTRIES = new Set([
     "user_feedback_contract",
     "decision_contract",
     "dual_layer_mechanism_registry",
+    "contract_registry",
 ]);
 // ── 契约到 LayerMap 的转换 ──
 function contractToLayerMap(c) {
@@ -476,8 +477,9 @@ const MECHANISM_CONTRACTS = [
         owner_issue_id: "问题十七",
         priority: "P1",
         template_layer: {
-            required: false,
+            required: true,
             assets: [
+                { path: "templates/knowledge/rules/任务上下文生命周期规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
                 { path: "templates/knowledge/patterns/core/任务上下文生命周期.md", asset_kind: "capability_knowledge_doc", consumption_mode: "supporting" },
             ],
             injected_routes: ["code_execution", "multi_stage_plan", "read_only_analysis"],
@@ -784,14 +786,739 @@ const MECHANISM_CONTRACTS = [
         },
         status: "dual_layer_enforced",
     },
+    // ══ 扩展平台双层机制 ══
+    // ── 15. 决策主权 ──
+    {
+        mechanism_id: "mc-decision-sovereignty",
+        mechanism_name: "技术决策主权",
+        owner_issue_id: "问题十六",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/技术决策主权规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+                { path: "templates/knowledge/procedures/架构设计工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "supporting" },
+            ],
+            injected_routes: ["code_execution", "multi_stage_plan"],
+            injected_workflows: ["code_change", "architecture_design", "existing_system_gap_analysis"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/technology_decision.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["validateTechnologyDecision", "evaluateDecisionExecution"],
+            state_effects: ["decision_status → allow/block"],
+            hard_fail_conditions: ["architecture 决策无 human gate", "推荐状态允许执行"],
+            degradation_behavior: "决策不合规时阻断执行",
+        },
+        evidence_layer: {
+            outputs: ["TechnologyDecisionContract", "DecisionValidationResult"],
+            reports: ["DecisionReview"],
+            diagnostic_codes: ["no-human-gate", "executing-recommended"],
+            task_context_facts: ["decision_scope", "decision_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["decision_human_gate_present"],
+            regression_cases: ["architecture_requires_human_gate", "recommended_cannot_execute"],
+            drift_checks: ["decision_status_matches_workflow"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 16. 脑暴与方案探索 ──
+    {
+        mechanism_id: "mc-brainstorm-contract",
+        mechanism_name: "脑暴与方案探索",
+        owner_issue_id: "问题四十一",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/脑暴与方案探索规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+                { path: "templates/knowledge/procedures/架构设计工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "supporting" },
+            ],
+            injected_routes: ["multi_stage_plan", "single_artifact"],
+            injected_workflows: ["architecture_design", "existing_system_gap_analysis"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/brainstorm_contract.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["validateBrainstormSession", "canBrainstormAutoExecute"],
+            state_effects: ["brainstorm_status → allow/block auto-execute"],
+            hard_fail_conditions: ["脑暴无候选方案", "脑暴绕过决策主权"],
+            degradation_behavior: "脑暴不完整时阻断",
+        },
+        evidence_layer: {
+            outputs: ["BrainstormSession", "BrainstormValidationResult"],
+            reports: ["BrainstormReview"],
+            diagnostic_codes: ["empty-session", "auto-execute-blocked"],
+            task_context_facts: ["brainstorm_trigger", "brainstorm_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["brainstorm_has_options"],
+            regression_cases: ["cannot_auto_execute", "empty_session_invalid"],
+            drift_checks: ["brainstorm_options_match_decision"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 17. 细节纪律 ──
+    {
+        mechanism_id: "mc-detail-discipline",
+        mechanism_name: "细节纪律",
+        owner_issue_id: "问题二十六",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/细节纪律规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+                { path: "templates/knowledge/procedures/测试优先编码工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "supporting" },
+            ],
+            injected_routes: ["code_execution", "verification_only"],
+            injected_workflows: ["code_change", "test_first_coding", "local_browser_acceptance"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/detail_discipline.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["performDetailCheck", "checkDetailGateIntegration"],
+            state_effects: ["detail_check_status → allow/block delivery"],
+            hard_fail_conditions: ["缺失关键维度", "blocking 检查未接入交付 gate"],
+            degradation_behavior: "细节不足时阻断交付",
+        },
+        evidence_layer: {
+            outputs: ["DetailDisciplineCheck", "DetailGateIntegrationResult"],
+            reports: ["DetailDisciplineReport"],
+            diagnostic_codes: ["missing-dimension", "gate-not-integrated"],
+            task_context_facts: ["detail_check_status", "blocking"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["detail_dimensions_covered"],
+            regression_cases: ["blocking_without_gate_fails", "missing_dimension_blocks"],
+            drift_checks: ["detail_check_matches_workflow"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 18. 第一性原理 ──
+    {
+        mechanism_id: "mc-first-principles",
+        mechanism_name: "第一性原理",
+        owner_issue_id: "问题二十七",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/第一性原理推理规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+                { path: "templates/knowledge/procedures/架构设计工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "supporting" },
+            ],
+            injected_routes: ["multi_stage_plan", "single_artifact"],
+            injected_workflows: ["architecture_design", "existing_system_gap_analysis"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/first_principles.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["performFirstPrinciplesCheck", "validateFirstPrinciplesForHighImpact"],
+            state_effects: ["first_principles_status → allow/block"],
+            hard_fail_conditions: ["缺少 fundamental_need", "高影响变更未推理"],
+            degradation_behavior: "推理不完整时阻断",
+        },
+        evidence_layer: {
+            outputs: ["FirstPrinciplesFrame", "FirstPrinciplesCheckResult"],
+            reports: ["FirstPrinciplesReview"],
+            diagnostic_codes: ["missing-fundamental-need", "high-impact-unframed"],
+            task_context_facts: ["first_principles_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["fundamental_need_present"],
+            regression_cases: ["missing_fundamental_need_fails", "high_impact_requires_frame"],
+            drift_checks: ["principles_frame_matches_decision"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 19. 架构设计审查 ──
+    {
+        mechanism_id: "mc-architecture-design",
+        mechanism_name: "架构设计审查",
+        owner_issue_id: "问题四十九",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/架构设计工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["multi_stage_plan", "single_artifact"],
+            injected_workflows: ["architecture_design"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/architecture_design_contract.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["reviewArchitectureDesign", "validateOutputDirectoryDecision"],
+            state_effects: ["architecture_review → allow/block delivery"],
+            hard_fail_conditions: ["输出目录未确认", "Mermaid 不可渲染"],
+            degradation_behavior: "设计不合规时阻断交付",
+        },
+        evidence_layer: {
+            outputs: ["ArchitectureDesignContract", "ArchitectureReviewResult"],
+            reports: ["ArchitectureDesignReview"],
+            diagnostic_codes: ["directory-not-confirmed", "mermaid-render-failed"],
+            task_context_facts: ["architecture_design_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["output_directory_confirmed"],
+            regression_cases: ["unconfirmed_directory_blocks", "mermaid_render_check"],
+            drift_checks: ["architecture_contract_matches_workflow"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 20. 现有系统分析 ──
+    {
+        mechanism_id: "mc-existing-system-analysis",
+        mechanism_name: "现有系统差距分析",
+        owner_issue_id: "问题五十",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/现有系统差距分析工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["read_only_analysis", "multi_stage_plan"],
+            injected_workflows: ["existing_system_gap_analysis"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/existing_system_analysis.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["detectProjectContext", "checkAnalysisGate"],
+            state_effects: ["analysis_gate → allow/block coding"],
+            hard_fail_conditions: ["existing_system 未分析", "未知项目类型未 human gate"],
+            degradation_behavior: "未分析时阻断编码",
+        },
+        evidence_layer: {
+            outputs: ["ProjectContextDetection", "AnalysisGateResult"],
+            reports: ["ExistingSystemAnalysisReport"],
+            diagnostic_codes: ["analysis-not-done", "unknown-project-type"],
+            task_context_facts: ["analysis_gate_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["analysis_gate_checked"],
+            regression_cases: ["unanalyzed_blocks_coding", "unknown_type_requires_human"],
+            drift_checks: ["analysis_matches_coding_readiness"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 21. 编码准备门 ──
+    {
+        mechanism_id: "mc-coding-readiness",
+        mechanism_name: "编码准备门",
+        owner_issue_id: "问题五十一",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/测试优先编码工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution"],
+            injected_workflows: ["test_first_coding", "code_change"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/coding_readiness_gate.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["evaluateCodingReadiness", "createTestFirstPlan"],
+            state_effects: ["coding_readiness → allow/block implementation"],
+            hard_fail_conditions: ["缺少验证计划", "编码不是第一步但无准备"],
+            degradation_behavior: "编码准备不足时阻断实现",
+        },
+        evidence_layer: {
+            outputs: ["CodingReadinessContract", "CodingReadinessEvaluation"],
+            reports: ["CodingReadinessReport"],
+            diagnostic_codes: ["no-verification-plan", "coding-first-without-prep"],
+            task_context_facts: ["coding_readiness_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["verification_plan_present"],
+            regression_cases: ["no_plan_blocks_coding", "test_first_required"],
+            drift_checks: ["readiness_matches_code_change"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 22. 本地浏览器验收 ──
+    {
+        mechanism_id: "mc-local-acceptance",
+        mechanism_name: "本地浏览器验收",
+        owner_issue_id: "问题五十二",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/本地浏览器验收工作流.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["verification_only", "read_only_analysis"],
+            injected_workflows: ["local_browser_acceptance"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/local_docker_acceptance.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["validateFinalAccess", "performBrowserAcceptance"],
+            state_effects: ["final_access → allow/block delivery"],
+            hard_fail_conditions: ["无本地 URL", "有可运行服务但只停在单测"],
+            degradation_behavior: "无本地 URL 时阻断交付",
+        },
+        evidence_layer: {
+            outputs: ["LocalDockerAcceptanceContract", "FinalAccessValidation"],
+            reports: ["LocalAcceptanceReport"],
+            diagnostic_codes: ["no-local-url", "unit-test-only"],
+            task_context_facts: ["acceptance_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["final_urls_provided"],
+            regression_cases: ["no_url_blocks_delivery", "docker_priority"],
+            drift_checks: ["acceptance_matches_delivery"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 23. 演进回归门控 ──
+    {
+        mechanism_id: "mc-evolution-regression",
+        mechanism_name: "演进回归门控",
+        owner_issue_id: "问题五十四",
+        priority: "P2",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/演进回归门控规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+                { path: "templates/knowledge/rules/演进回归规则.md", asset_kind: "knowledge_rule", consumption_mode: "supporting" },
+            ],
+            injected_routes: ["operation"],
+            injected_workflows: [],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/evolution_regression_gate.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["performEvolutionGate", "checkDuplicateIssue"],
+            state_effects: ["evolution_gate → allow/block new issue"],
+            hard_fail_conditions: ["重复问题未检测", "pending 状态通过"],
+            degradation_behavior: "演进门控不通过时阻断",
+        },
+        evidence_layer: {
+            outputs: ["EvolutionGateResult", "DuplicateCheckResult"],
+            reports: ["EvolutionRegressionReport"],
+            diagnostic_codes: ["duplicate-issue", "pending-gate"],
+            task_context_facts: ["evolution_gate_status"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["evolution_gate_checked"],
+            regression_cases: ["pending_blocks", "duplicate_detected"],
+            drift_checks: ["evolution_gate_matches_issues"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 机制 ──
+    // ── plan_proposal_gate (问题五十五) ──
+    {
+        mechanism_id: "mc-plan-proposal-gate",
+        mechanism_name: "Plan / Proposal First Gate",
+        owner_issue_id: "问题五十五",
+        priority: "P0",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/计划前置门规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_change", "operation", "analysis", "review"],
+            injected_workflows: ["all"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/plan_proposal_gate.ts"],
+            registries: ["mechanism_contract_registry", "contract_registry"],
+            entrypoints: ["evaluatePlanProposalGate", "requirePlanBeforeAction", "validateActionWithinPlan"],
+            state_effects: ["plan_gate_status → passed/blocked/manual_required"],
+            hard_fail_conditions: ["缺计划写入", "高风险无确认", "计划外动作", "review被升级为执行"],
+            degradation_behavior: "Plan Gate 未通过时阻断所有写入动作",
+        },
+        evidence_layer: {
+            outputs: ["PlanProposalGateResult", "PlanProposalEvidence", "UserConfirmationRef", "VerificationPlanRef"],
+            reports: ["PlanProposalGateEvaluation"],
+            diagnostic_codes: ["SF-PLAN-5001", "SF-PLAN-5002", "SF-PLAN-5003", "SF-PLAN-5010"],
+            task_context_facts: ["plan_proposal_gate", "plan_proposal_evidence", "user_confirmation_ref", "verification_plan_ref"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+            runtime_checks: ["plan_gate_evaluated_before_write", "confirmation_required_for_high_risk"],
+            regression_cases: ["code_change_no_plan_blocked", "high_risk_no_confirmation_blocked", "scope_expand_requires_reconfirm"],
+            drift_checks: ["plan_gate_status_matches_actual"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── core_experience_principle (问题五十六) ──
+    {
+        mechanism_id: "mc-core-experience-principle",
+        mechanism_name: "Core Experience Principle",
+        owner_issue_id: "问题五十六",
+        priority: "P0",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/核心体验原则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["all"],
+            injected_workflows: ["all"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/core_experience_principle.ts"],
+            registries: ["mechanism_contract_registry", "contract_registry"],
+            entrypoints: ["evaluateCoreExperiencePrinciple", "evaluateNoFalseCompletion", "evaluateMechanismFriction"],
+            state_effects: ["evaluation → passed/blocked/manual_required"],
+            hard_fail_conditions: ["机制未接主线", "用户路径过长", "硬规则降级为warning", "假完成"],
+            degradation_behavior: "体验原则违反时阻断 Release Gate",
+        },
+        evidence_layer: {
+            outputs: ["CoreExperiencePrincipleEvaluation", "UserPathFrictionReport", "RepairOrManualRequiredDecision"],
+            reports: ["CoreExperiencePrincipleReport"],
+            diagnostic_codes: ["SF-EXP-5601", "SF-EXP-5602", "SF-EXP-5603", "SF-EXP-5605", "SF-EXP-5607"],
+            task_context_facts: ["core_experience_evaluation"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+            runtime_checks: ["all_new_mechanisms_evaluated", "no_fake_completion"],
+            regression_cases: ["false_completion_blocked", "hard_fail_downgrade_blocked", "heavy_process_on_low_risk_blocked"],
+            drift_checks: ["core_experience_vs_new_mechanisms"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── knowledge_asset_governance (问题五十七) ──
+    {
+        mechanism_id: "mc-knowledge-asset-governance",
+        mechanism_name: "Knowledge Asset Governance",
+        owner_issue_id: "问题五十七",
+        priority: "P0",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/知识资产治理规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["knowledge_index_build", "intent_route", "intent_expand", "template_sync", "release_migration"],
+            injected_workflows: ["knowledge_index_build", "intent_expand", "template_sync"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/knowledge_asset_schema.ts"],
+            registries: ["mechanism_contract_registry", "contract_registry", "consumable_asset_registry"],
+            entrypoints: ["validateKnowledgeAssets", "buildKnowledgeAssetRegistry", "detectDuplicateAndConflicts", "resolveCanonicalAuthority"],
+            state_effects: ["audit → passed/failed", "consumption_snapshot → indexed/injected/filtered/degraded/conflict_resolutions"],
+            hard_fail_conditions: ["缺 frontmatter", "重复 canonical", "owner 缺失", "deprecated 被注入", "消费链路不可追踪"],
+            degradation_behavior: "知识资产审计失败时阻断 prompt 注入",
+        },
+        evidence_layer: {
+            outputs: ["KnowledgeAssetAuditReport", "KnowledgeConsumptionSnapshot", "MigrationDryRunResult"],
+            reports: ["KnowledgeAssetAuditReport", "MigrationCompatibilityReport"],
+            diagnostic_codes: ["SF-KA-5701", "SF-KA-5702", "SF-KA-5703", "SF-KA-5704", "SF-KA-5705", "SF-KA-5706", "SF-KA-5709"],
+            task_context_facts: ["knowledge_audit_passed", "consumption_snapshot_verified"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/release_gate_scenario_matrix.test.ts"],
+            runtime_checks: ["templates/knowledge 全量扫描", "消费链路可追踪"],
+            regression_cases: ["missing_frontmatter_blocked", "duplicate_canonical_blocked", "deprecated_injection_blocked", "user_modified_protected"],
+            drift_checks: ["knowledge_registry_vs_actual_assets"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 31. 意图扩展 ──
+    {
+        mechanism_id: "mc-intent-expander",
+        mechanism_name: "意图扩展",
+        owner_issue_id: "问题三",
+        priority: "P0",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/任务拆解流程.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution", "read_only_analysis", "single_artifact", "source_extraction"],
+            injected_workflows: ["code_change", "planning"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/intent_expander.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["expand"],
+            state_effects: ["expansion → prompt/scope/acceptance_criteria", "matched_knowledge → template_injection"],
+            hard_fail_conditions: ["expansion 无 route_decision", "required 模板缺失且未报错"],
+            degradation_behavior: "confidence < 阈值时返回 clarification prompt 而非执行指令",
+        },
+        evidence_layer: {
+            outputs: ["ExpandResult", "prompt", "scope", "acceptance_criteria"],
+            reports: ["ExpansionReport"],
+            diagnostic_codes: ["expansion-low-confidence", "expansion-missing-required-template"],
+            task_context_facts: ["expansion", "prompt"],
+        },
+        verification_layer: {
+            tests: ["tests/engine/intent_expander_integration.test.ts"],
+            runtime_checks: ["expansion_requires_route_decision"],
+            regression_cases: ["source_extraction_no_code_modification", "read_only_no_modification"],
+            drift_checks: ["expander_routes_match_intent_router"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 32. 扩展生命周期与权限管控 ──
+    {
+        mechanism_id: "mc-extension-contract",
+        mechanism_name: "扩展生命周期与权限管控",
+        owner_issue_id: "问题三十九",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/扩展生命周期规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution", "multi_stage_plan"],
+            injected_workflows: ["code_change"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/extension_contract.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["validateExtensionManifest", "evaluateExtensionLifecycle", "grantExtensionPermissions"],
+            state_effects: ["extension registration → validated", "permission grant → approved"],
+            hard_fail_conditions: ["第三方扩展自称 enforced", "高风险权限未审批"],
+            degradation_behavior: "扩展不合规时拒绝注册",
+        },
+        evidence_layer: {
+            outputs: ["ExtensionManifest", "ExtensionLifecycleResult", "PermissionGrantResult"],
+            reports: ["ExtensionValidationReport"],
+            diagnostic_codes: ["SF-EXT-3901", "SF-EXT-3902"],
+            task_context_facts: [],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["extension_manifest_validation"],
+            regression_cases: ["third_party_enforced_blocked", "lifecycle_transition_valid"],
+            drift_checks: ["extension_contract_registry_sync"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 33. 跨平台路径安全 ──
+    {
+        mechanism_id: "mc-platform-compatibility",
+        mechanism_name: "跨平台路径安全",
+        owner_issue_id: "问题四十",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/跨平台路径安全规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution", "multi_stage_plan"],
+            injected_workflows: ["code_change"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/platform_context.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["normalizePathRef", "checkPathSafety", "detectPlatformContext"],
+            state_effects: ["path normalization → safe_path", "scope boundary → validated"],
+            hard_fail_conditions: ["路径逃逸未检测", "scope 边界绕过"],
+            degradation_behavior: "路径不安全时拒绝操作",
+        },
+        evidence_layer: {
+            outputs: ["NormalizedPathRef", "PathSafetyCheck"],
+            reports: ["PlatformCompatibilityReport"],
+            diagnostic_codes: ["SF-PLAT-4001", "SF-PLAT-4002"],
+            task_context_facts: [],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["path_safety_check"],
+            regression_cases: ["symlink_escape_blocked", "case_conflict_detected"],
+            drift_checks: ["platform_context_registry_sync"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 34. 工作流模板包消费 ──
+    {
+        mechanism_id: "mc-workflow-template-pack",
+        mechanism_name: "工作流模板包消费",
+        owner_issue_id: "问题五十三",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/工作流模板包规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution", "multi_stage_plan"],
+            injected_workflows: ["code_change"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/workflow_template_pack.ts"],
+            registries: ["mechanism_contract_registry", "consumable_asset_registry"],
+            entrypoints: ["validateWorkflowTemplatePack", "advanceTemplateConsumptionStatus", "createTemplateConsumptionEvidence"],
+            state_effects: ["template status → missing/file_created/indexed/registered/injected/consumed/verified"],
+            hard_fail_conditions: ["模板停在中间状态", "消费 pipeline 不完整"],
+            degradation_behavior: "消费不完整时阻断",
+        },
+        evidence_layer: {
+            outputs: ["WorkflowTemplatePackContract", "PackValidationResult"],
+            reports: ["TemplatePackReport"],
+            diagnostic_codes: ["SF-WTP-5301", "SF-WTP-5302"],
+            task_context_facts: [],
+        },
+        verification_layer: {
+            tests: ["tests/engine/extension_scenario_matrix.test.ts"],
+            runtime_checks: ["template_pack_pipeline_validation"],
+            regression_cases: ["template_stuck_in_middle_state"],
+            drift_checks: ["template_pack_vs_consumable_assets"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 35. 指标治理 ──
+    {
+        mechanism_id: "mc-metric-governance",
+        mechanism_name: "指标治理",
+        owner_issue_id: "问题十九",
+        priority: "P1",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/procedures/性能流水线.md", asset_kind: "pipeline_procedure", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_execution", "multi_stage_plan"],
+            injected_workflows: ["verification", "delivery"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/metric_governance.ts"],
+            registries: ["mechanism_contract_registry"],
+            entrypoints: ["evaluateMetrics", "evaluateGovernanceAction"],
+            state_effects: ["metric evaluation → passed/failed", "governance action → approved/blocked"],
+            hard_fail_conditions: ["skipped 算 passed", "空数组伪造 passed"],
+            degradation_behavior: "指标不合规时标记为 failed",
+        },
+        evidence_layer: {
+            outputs: ["MetricsEvaluationResult", "GovernanceFinding", "MetricSample[]"],
+            reports: ["MetricGovernanceReport"],
+            diagnostic_codes: ["SF-METRIC-1901", "SF-METRIC-1902"],
+            task_context_facts: [],
+        },
+        verification_layer: {
+            tests: ["tests/engine/observability.test.ts"],
+            runtime_checks: ["metric_sample_real_source"],
+            regression_cases: ["empty_array_not_passed", "insufficient_history_guard"],
+            drift_checks: ["metric_governance_vs_delivery"],
+        },
+        status: "dual_layer_enforced",
+    },
+    // ── 36. 施工指令契约 ──
+    {
+        mechanism_id: "mc-instruction-contract",
+        mechanism_name: "施工指令契约",
+        owner_issue_id: "问题五十八",
+        priority: "P0",
+        template_layer: {
+            required: true,
+            assets: [
+                { path: "templates/knowledge/rules/施工指令契约规则.md", asset_kind: "knowledge_rule", consumption_mode: "required" },
+            ],
+            injected_routes: ["code_change", "multi_stage_plan", "artifact_generation"],
+            injected_workflows: ["code_change", "planning"],
+            target_hosts: ["claude_code"],
+            language_policy: "zh_first",
+        },
+        enforcement_layer: {
+            required: true,
+            enforcers: ["src/engine/instruction_contract.ts"],
+            registries: ["mechanism_contract_registry", "consumable_asset_registry"],
+            entrypoints: ["validateInstructionContract", "enforceInstructionBeforeImplementation", "checkInstructionCompleteness", "registerInstructionIssueCandidate"],
+            state_effects: ["instruction draft → confirmed → executing → completed/blocked"],
+            hard_fail_conditions: ["施工指令缺失必填字段", "blocked 状态被放行", "空值假通过"],
+            degradation_behavior: "指令不完整时阻断，不可降级",
+        },
+        evidence_layer: {
+            outputs: ["InstructionValidationResult", "InstructionEnforcementResult", "InstructionCompletenessResult"],
+            reports: ["InstructionContractReport"],
+            diagnostic_codes: ["SF-INSTR-5801", "SF-INSTR-5802"],
+            task_context_facts: [],
+        },
+        verification_layer: {
+            tests: ["tests/engine/instruction_contract.test.ts"],
+            runtime_checks: ["instruction_completeness_gate"],
+            regression_cases: ["missing_goal_hard_fail", "empty_scope_hard_fail", "blocked_status_not_bypassed"],
+            drift_checks: ["instruction_contract_vs_plan_gate"],
+        },
+        status: "dual_layer_enforced",
+    },
 ];
+// ── 已废弃机制 ID 别名映射 ──
+// 旧 ID → 正式 ID。旧 ID 在 MC 中标记为 deprecated，模板/知识资产必须指向正式 ID。
+export const MECHANISM_ALIASES = {
+    "mc-classifier": "mc-intent-router",
+    "mc-knowledge-matching": "mc-knowledge-injection-boundary",
+    "mc-workspace-resumer": "mc-task-context-lifecycle",
+    "mc-delivery": "mc-delivery-gate",
+    "mc-metric-contract": "mc-metric-governance",
+};
+/** 将机制 ID 解析为正式 ID（处理别名） */
+export function resolveMechanismId(id) {
+    return MECHANISM_ALIASES[id] ?? id;
+}
+/** 获取所有正式机制 ID 集合 */
+export function getAllCanonicalMechanismIds() {
+    return new Set(MECHANISM_CONTRACTS.map((c) => c.mechanism_id));
+}
 // ── 查询函数 ──
 /**
  * 列出所有机制的层级映射。
  * @returns 机制层级映射列表
  */
 export function listMechanismLayerMaps() {
-    console.error("[soloForge] 双层机制: listMechanismLayerMaps() — 共", MECHANISM_CONTRACTS.length, "个契约");
     return MECHANISM_CONTRACTS.map(contractToLayerMap);
 }
 /**
@@ -800,7 +1527,6 @@ export function listMechanismLayerMaps() {
  * @returns 机制层级映射，未找到时返回 undefined
  */
 export function findLayerMapByMechanismId(id) {
-    console.error("[soloForge] 双层机制: findLayerMapByMechanismId() — id:", id);
     return MECHANISM_CONTRACTS.map(contractToLayerMap).find((m) => m.mechanism_id === id);
 }
 /**
@@ -809,7 +1535,6 @@ export function findLayerMapByMechanismId(id) {
  * @returns 指定优先级的机制层级映射列表
  */
 export function listLayerMapsByPriority(priority) {
-    console.error("[soloForge] 双层机制: listLayerMapsByPriority() — priority:", priority);
     return MECHANISM_CONTRACTS.map(contractToLayerMap).filter((m) => m.priority === priority);
 }
 /**
@@ -818,7 +1543,6 @@ export function listLayerMapsByPriority(priority) {
  * @returns 指定状态的机制层级映射列表
  */
 export function listLayerMapsByStatus(status) {
-    console.error("[soloForge] 双层机制: listLayerMapsByStatus() — status:", status);
     return MECHANISM_CONTRACTS.map(contractToLayerMap).filter((m) => m.status === status);
 }
 /**
@@ -828,7 +1552,6 @@ export function listLayerMapsByStatus(status) {
  * @returns 双层完整性检查结果
  */
 export function checkDualLayerCompleteness(map) {
-    console.error("[soloForge] 双层机制: checkDualLayerCompleteness() — mechanism_id:", map.mechanism_id);
     const missing = [];
     const has_template_layer = map.template_assets.length > 0;
     const has_code_layer = map.code_enforcers.length > 0;
@@ -846,7 +1569,7 @@ export function checkDualLayerCompleteness(map) {
     if (!has_registries)
         missing.push("registries");
     if (missing.length > 0) {
-        console.error("[soloForge] 双层机制: 完整性缺失 —", map.mechanism_id, "missing:", missing.join(", "));
+        // 完整性缺失仅通过返回值传达，不输出噪音日志
     }
     return {
         mechanism_id: map.mechanism_id,
@@ -871,13 +1594,11 @@ const INFRASTRUCTURE_EXCEPTIONS = new Set([
  * 检查 ID 唯一性、模板/代码缺口、文件存在性、入口点等。
  * @param maps - 机制层级映射列表（默认使用所有契约）
  * @param rootDir - 项目根目录（默认当前目录）
- * @param options.batch1_mode - 是否启用 batch1 模式（可选）
  * @returns 治理发现列表
  */
-export function validateMechanismLayerMaps(maps = MECHANISM_CONTRACTS.map(contractToLayerMap), rootDir = process.cwd(), options) {
+export function validateMechanismLayerMaps(maps = MECHANISM_CONTRACTS.map(contractToLayerMap), rootDir = process.cwd(), _options) {
     const findings = [];
     const seenIds = new Set();
-    console.error(`[soloForge] 双层机制: 开始治理验证 — 共 ${maps.length} 个机制`);
     // 预加载消费资产路径用于交叉验证
     const consumablePaths = new Set(listBuiltinConsumableAssets().map((a) => a.path));
     // 预加载已知机制 ID 用于孤立执行器检查
@@ -1071,7 +1792,6 @@ export function validateMechanismLayerMaps(maps = MECHANISM_CONTRACTS.map(contra
             });
         }
     }
-    console.error(`[soloForge] 双层机制: 治理验证完成 — 发现 ${findings.length} 个问题`);
     return findings;
 }
 //# sourceMappingURL=dual_layer_mechanism_registry.js.map