soloforge 1.2.8 → 1.2.10

package/dist/engine/implementation_roadmap_registry.js

@@ -0,0 +1,813 @@
+/**
+ * Implementation Roadmap Contract 的落地注册表。
+ *
+ * 将 42 个追踪问题映射到 4 个实施批次（P0-P3），
+ * 提供查询、校验和跨注册表一致性检查能力。
+ */
+// ── 数据 ──
+const PROBLEM_ENTRIES = [
+    // ── Pre-completed ──
+    {
+        id: "problem-1", label: "问题一",
+        title: "自动膨胀入口被 task_type 绑死，导致大量产物型/提取型/分析型语义被跳过",
+        status: "completed", priority: "pre_completed", batch_id: null,
+        completion_evidence: "4e98eb3",
+        related_mechanism_ids: ["mc-intent-router"], related_capability_ids: [],
+        owner_module: "src/engine/intent_router.ts",
+        test_files: ["tests/engine/intent_router.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-2", label: "问题二",
+        title: "setup.sh 是历史遗留入口，应删除避免安装心智冲突",
+        status: "completed", priority: "pre_completed", batch_id: null,
+        completion_evidence: "73286ef",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null,
+        test_files: ["tests/templates/no_setup_sh.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-3", label: "问题三",
+        title: "verify-test-counts.mjs 是过时测试数量门禁，应删除",
+        status: "completed", priority: "pre_completed", batch_id: null,
+        completion_evidence: "f514032",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null,
+        test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-4", label: "问题四",
+        title: "SoloForge 可消费资产缺少消费覆盖矩阵",
+        status: "completed", priority: "pre_completed", batch_id: null,
+        completion_evidence: "2d71d40",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/consumable_asset_registry.ts",
+        test_files: ["tests/engine/consumable_asset_registry.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-5", label: "问题五",
+        title: "机制层缺少自治理，无法系统发现机制失效、空转和状态污染",
+        status: "completed", priority: "pre_completed", batch_id: null,
+        completion_evidence: "a344c85",
+        related_mechanism_ids: ["mc-intent-router", "mc-classifier", "mc-intent-expander", "mc-knowledge-matching", "mc-knowledge-injection-boundary", "mc-task-context-lifecycle", "mc-verifier", "mc-workspace-resumer"],
+        related_capability_ids: [],
+        owner_module: "src/engine/mechanism_contract_registry.ts",
+        test_files: ["tests/engine/mechanism_contract_registry.test.ts"],
+        memo_section: "## ",
+    },
+    // ── P0 / Batch 1 ──
+    {
+        id: "problem-6", label: "问题六",
+        title: "项目配置不应默认自动落盘，必须区分运行时推断、现有项目探测和空项目蓝图",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        completion_evidence: "2707dbc",
+        related_mechanism_ids: ["mc-zero-config-init"], related_capability_ids: [],
+        owner_module: "src/engine/zero_config_init.ts",
+        test_files: ["tests/engine/zero_config_init.test.ts", "tests/engine/auto_init_cli.test.ts", "tests/engine/auto_init.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-8", label: "问题八",
+        title: "知识注入边界过粗，缺少分层优先级、状态约束、注入原因和排除原因",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        completion_evidence: "d4e1731",
+        related_mechanism_ids: ["mc-knowledge-injection-boundary", "mc-knowledge-matching"],
+        related_capability_ids: ["knowledge_sovereignty"],
+        owner_module: "src/engine/knowledge_injection_boundary.ts",
+        test_files: ["tests/engine/knowledge_injection_boundary.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-9", label: "问题九",
+        title: "机制层核心工作流停留在概念流程，缺少可执行契约、机制分工、降级边界和防退化治理",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: ["mc-task-context-lifecycle"],
+        related_capability_ids: ["task_context_lifecycle"],
+        owner_module: "src/engine/workflow_contract_registry.ts",
+        test_files: ["tests/engine/workflow_contract_registry.test.ts"],
+        completion_evidence: "workflow_contract_registry",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-22", label: "问题二十二",
+        title: "MCP 工具 / 适配器边界缺少 Tool Invocation Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/tool_invocation_contract_registry.ts",
+        test_files: ["tests/engine/tool_invocation_contract_registry.test.ts"],
+        completion_evidence: "tool_invocation_contract_registry",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-23", label: "问题二十三",
+        title: "外部材料摄取边界缺少 Input Material Contract",
+        status: "planned", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: ["mc-input-material-contract"], related_capability_ids: [],
+        owner_module: "src/engine/input_material_contract_registry.ts", test_files: ["tests/engine/input_material_contract_registry.test.ts"],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-24", label: "问题二十四",
+        title: "输出产物管理缺少 Artifact Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/artifact_contract_registry.ts", test_files: ["tests/engine/artifact_contract_registry.test.ts"],
+        completion_evidence: "artifact_contract_registry",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-29", label: "问题二十九",
+        title: "用户可见反馈体验缺少 User Feedback Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/user_feedback_contract.ts", test_files: ["tests/engine/user_feedback_contract.test.ts"],
+        completion_evidence: "user_feedback_contract",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-32", label: "问题三十二",
+        title: "权限、隐私与敏感信息边界缺少 Privacy / Secret / Data Sovereignty Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: ["secret_scan", "scope_hook"],
+        owner_module: "src/engine/privacy_secret_contract.ts", test_files: ["tests/engine/privacy_secret_contract.test.ts"],
+        completion_evidence: "privacy_secret_contract",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-33", label: "问题三十三",
+        title: "真实命令执行边界缺少 Command Execution Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/command_execution_contract.ts", test_files: ["tests/engine/command_execution_contract.test.ts"],
+        completion_evidence: "command_execution_contract",
+        memo_section: "## ",
+    },
+    {
+        id: "problem-37", label: "问题三十七",
+        title: "配置优先级与覆盖规则缺少 Configuration Precedence Contract",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/config_precedence_contract.ts", test_files: ["tests/engine/config_precedence_contract.test.ts"],
+        completion_evidence: "config_precedence_contract",
+        memo_section: "## ",
+    },
+    // ── P1 / Batch 2 ──
+    {
+        id: "problem-11", label: "问题十一",
+        title: "机制层强制护栏边界过窄且缺少统一 Enforcement Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: ["scope_hook", "secret_scan"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-12", label: "问题十二",
+        title: "机制层验证与交付缺少 Verification/Delivery Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: ["mc-verifier"], related_capability_ids: ["verify_command_generation"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-13", label: "问题十三",
+        title: "机制层失败处理缺少 Failure Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-15", label: "问题十五",
+        title: "机制族缺少 Mechanism Family Implementation Map",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-17", label: "问题十七",
+        title: "TaskContext 边界缺少 State Fact Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: ["mc-task-context-lifecycle"], related_capability_ids: ["task_context_lifecycle"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-18", label: "问题十八",
+        title: "降级与容错策略过粗，缺少 Degradation Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-20", label: "问题二十",
+        title: "契约治理内核缺少统一 Contract Registry",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: ["governance_runtime_loop"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-28", label: "问题二十八",
+        title: "多任务、并发与工作区污染缺少 Concurrency / Workspace Isolation Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: ["io_lock", "scope_lease"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-34", label: "问题三十四",
+        title: "测试策略缺少 Test Strategy Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-36", label: "问题三十六",
+        title: "错误码 / 诊断码体系缺少 Diagnostic Code Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-38", label: "问题三十八",
+        title: "日志 / 审计 / 可观测性存储边界缺少 Observability Storage Contract",
+        status: "planned", priority: "P1", batch_id: "batch-2",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    // ── P2 / Batch 3 ──
+    {
+        id: "problem-7", label: "问题七",
+        title: "知识生命周期缺少自治理，且 active/core、staged/draft 等概念混淆",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: ["knowledge_sovereignty"],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-10", label: "问题十",
+        title: "用户项目内缺少中文语义优先机制",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-14", label: "问题十四",
+        title: "知识演进缺少 Evidence-based Promotion Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-21", label: "问题二十一",
+        title: "文档维护边界缺少 Documentation Governance Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-25", label: "问题二十五",
+        title: "模板与知识同步升级缺少 Template Sync / Migration Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-30", label: "问题三十",
+        title: "CLI / README / 用户心智边界缺少 User Promise Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-31", label: "问题三十一",
+        title: "适配器工作流模板缺少 Adapter Prompt Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-35", label: "问题三十五",
+        title: "Release / 版本兼容 / 迁移策略缺少 Release Compatibility Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-41", label: "问题四十一",
+        title: "国际化与多语言项目覆盖缺少 Language Policy Override Contract",
+        status: "planned", priority: "P2", batch_id: "batch-3",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    // ── P3 / Batch 4 ──
+    {
+        id: "problem-16", label: "问题十六",
+        title: "自主技术选型缺少 Decision Sovereignty Contract",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-19", label: "问题十九",
+        title: "质量指标与监控缺少 Metric Contract 和 Action Binding",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-26", label: "问题二十六",
+        title: "SoloForge 缺少 Detail Discipline Contract",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-27", label: "问题二十七",
+        title: "SoloForge 缺少 First Principles Reasoning Contract",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-39", label: "问题三十九",
+        title: "插件 / 扩展机制边界缺少 Extension Contract",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-40", label: "问题四十",
+        title: "跨平台路径与环境兼容缺少 Platform Compatibility Contract",
+        status: "planned", priority: "P3", batch_id: "batch-4",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: null, test_files: [],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-42", label: "问题四十二",
+        title: "落地修复优先级与分批方案缺少 Implementation Roadmap Contract",
+        status: "completed", priority: "P3", batch_id: "batch-4",
+        completion_evidence: "roadmap_registry",
+        related_mechanism_ids: [], related_capability_ids: [],
+        owner_module: "src/engine/implementation_roadmap_registry.ts",
+        test_files: ["tests/engine/implementation_roadmap_registry.test.ts"],
+        memo_section: "## ",
+    },
+    // ── : 主链路接入防孤岛 ──
+    {
+        id: "problem-44", label: "问题四十四",
+        title: "新增能力主链路接入防孤岛机制 (Main Path Integration Contract)",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        completion_evidence: "wired_into_verifier_and_task_context_and_tools",
+        related_mechanism_ids: ["mc-verifier", "mc-task-context-lifecycle"],
+        related_capability_ids: ["verify_command_generation", "task_context_lifecycle"],
+        owner_module: "src/engine/main_path_integration_contract.ts",
+        test_files: [
+            "tests/engine/main_path_integration_contract.test.ts",
+            "tests/adapters/main_path_integration_gate.test.ts",
+        ],
+        memo_section: "## ",
+    },
+    {
+        id: "problem-45", label: "问题四十五",
+        title: "双-layer 机制治理完整性 — 所有机制必须双-layer enforced",
+        status: "completed", priority: "P0", batch_id: "batch-1",
+        related_mechanism_ids: ["mc-intent-router", "mc-workflow-contract", "mc-knowledge-injection-boundary", "mc-tool-invocation-contract", "mc-verifier", "mc-main-path-integration", "mc-privacy-boundary", "mc-command-execution", "mc-core-engineering-principles", "mc-delivery-gate", "mc-task-context-lifecycle", "mc-guard-evaluation", "mc-registry-infrastructure", "mc-zero-config-init", "mc-input-material-contract", "mc-user-feedback", "mc-artifact-contract", "mc-config-precedence"],
+        related_capability_ids: [],
+        owner_module: "src/engine/dual_layer_mechanism_registry.ts",
+        test_files: ["tests/engine/dual_layer_mechanism_registry.test.ts"],
+        completion_evidence: "dual_layer_all_18",
+        memo_section: "## ",
+    },
+];
+const IMPLEMENTATION_BATCHES = [
+    {
+        batch_id: "batch-1", priority: "P0",
+        goal: "主链路可用，不误判、不乱写",
+        included_problem_ids: ["problem-6", "problem-8", "problem-9", "problem-22", "problem-23", "problem-24", "problem-29", "problem-32", "problem-33", "problem-37", "problem-44", "problem-45"],
+        depends_on_batch_ids: [],
+        depends_on_pre_completed: ["problem-1", "problem-2", "problem-3", "problem-4", "problem-5"],
+        deliverables: [
+            "sf_expand 根据 route/execution_shape 选择 prompt",
+            "source extraction 能正确处理源码包输入",
+            "output artifact 默认写 .soloforge/output/{task_id}/",
+            "knowledge injection 生成 required/supporting/excluded report",
+            "strict controlled 工具受 next_allowed_tools 控制",
+            "基础 privacy/command guard 生效",
+            "用户反馈能区分 artifact_ready、manual_required、blocked、completed",
+            "配置解析能区分 runtime inference、confirmed config 和临时覆盖",
+        ],
+        acceptance_criteria: [
+            "从源码包抓取原型说明不得 skip",
+            "只读提取任务不得改业务源码",
+            "外部 zip 不得变成 write scope",
+            "required knowledge 缺失不得伪装完整注入",
+            "artifact 不得覆盖旧产物",
+            "sf_verify 默认 plan_only",
+            "secret 不得进入 prompt",
+            "completed 不得包含 blocking/manual_required/degraded",
+        ],
+        not_in_scope: [
+            "不做完整插件系统",
+            "不做全部 metrics/governance action",
+            "不重写所有知识生命周期",
+            "不更新正式设计文档为最终事实",
+        ],
+    },
+    {
+        batch_id: "batch-2", priority: "P1",
+        goal: "状态、证据、失败恢复和治理底座",
+        included_problem_ids: ["problem-11", "problem-12", "problem-13", "problem-15", "problem-17", "problem-18", "problem-20", "problem-28", "problem-34", "problem-36", "problem-38"],
+        depends_on_batch_ids: ["batch-1"],
+        depends_on_pre_completed: ["problem-5"],
+        deliverables: [
+            "TaskContext 只存 facts/refs",
+            "VerificationPlan 和 VerificationEvidence 分离",
+            "GuardEvaluationReport 接入写入/交付前",
+            "FailureReport + RecoveryPolicy 接入验证失败",
+            "DegradationEvent + RecoveryGate 接入能力不可用",
+            "WorkspaceLease 接入写入/交付",
+            "DiagnosticCode registry 初版",
+            "Observability storage 分层",
+            "TestStrategyContract 接入 contract registry",
+            "Mechanism family 映射表能反映真实实现状态",
+        ],
+        acceptance_criteria: [
+            "failed/blocked/requires_human 不能静默 done",
+            "delivery_readiness 不能触发 delivery execution",
+            "active write lease 冲突时 delivery blocked",
+            "blocking/critical 必须有 diagnostic code",
+            "stdout/stderr 不进 TaskContext 原文",
+            "enforced contract 无 lifecycle test 必须 fail",
+            "degradation 必须用户可见",
+            "retry budget exceeded 必须进入 FailureReport",
+        ],
+        not_in_scope: [
+            "不追求全部 capability enforced",
+            "不做复杂 dashboard",
+            "不自动降级/晋级能力状态",
+        ],
+    },
+    {
+        batch_id: "batch-3", priority: "P2",
+        goal: "知识、模板、文档和升级健康",
+        included_problem_ids: ["problem-7", "problem-10", "problem-14", "problem-21", "problem-25", "problem-30", "problem-31", "problem-35", "problem-41"],
+        depends_on_batch_ids: ["batch-1", "batch-2"],
+        depends_on_pre_completed: ["problem-4"],
+        deliverables: [
+            "Knowledge status + sovereignty 新模型",
+            "Evidence-based promotion gate",
+            "soloforge sync-templates dry-run/apply",
+            "soloforge sync-adapters dry-run/apply",
+            ".soloforge/version.json + soloforge migrate",
+            "CLI behavior matrix",
+            "README 与 CLI contract 对齐测试",
+            "LanguagePolicyConfig 支持 zh/en/bilingual",
+            "文档 eligibility 流程",
+        ],
+        acceptance_criteria: [
+            "用户修改模板不得覆盖",
+            "core knowledge 不得自动改",
+            "AI inference 不得直接 active/core",
+            "adapter prompt 不得含 forbidden claim",
+            "README 命令必须映射真实 CLI contract",
+            "migrate 默认 dry-run",
+            "未 verified 的备忘录决策不得写入正式设计文档",
+            "英文项目可配置 en_first，中文项目不被英文模板污染",
+        ],
+        not_in_scope: [
+            "不自动三方合并用户模板",
+            "不让设计文档记录施工流水",
+            "不一次性翻译所有模板",
+        ],
+    },
+    {
+        batch_id: "batch-4", priority: "P3",
+        goal: "扩展、平台兼容和高级治理",
+        included_problem_ids: ["problem-16", "problem-19", "problem-26", "problem-27", "problem-39", "problem-40", "problem-42"],
+        depends_on_batch_ids: ["batch-1", "batch-2", "batch-3"],
+        depends_on_pre_completed: [],
+        deliverables: [
+            "ExtensionManifest / ExtensionGrant",
+            "MetricContract + GovernanceFinding action binding",
+            "PlatformContext / NormalizedPathRef",
+            "TechnologyDecisionContract",
+            "DetailDisciplineCheck",
+            "FirstPrinciplesFrame",
+        ],
+        acceptance_criteria: [
+            "第三方扩展不能自称 enforced",
+            "metrics 不得把 skipped/manual_required 算 passed",
+            "symlink 外部路径不能绕过 scope",
+            "destructive tech decision 必须 human gate",
+            "高影响机制变更必须有 fundamental_need",
+            "写入/覆盖/迁移必须有细节检查",
+        ],
+        not_in_scope: [
+            "不开放不受控插件生态",
+            "不为了跨平台支持绕过安全",
+            "不把全局原则变成空泛口号",
+        ],
+    },
+];
+// ── 克隆辅助函数 ──
+function cloneProblemEntry(e) {
+    return {
+        ...e,
+        related_mechanism_ids: [...e.related_mechanism_ids],
+        related_capability_ids: [...e.related_capability_ids],
+        test_files: [...e.test_files],
+    };
+}
+function cloneBatch(b) {
+    return {
+        ...b,
+        included_problem_ids: [...b.included_problem_ids],
+        depends_on_batch_ids: [...b.depends_on_batch_ids],
+        depends_on_pre_completed: [...b.depends_on_pre_completed],
+        deliverables: [...b.deliverables],
+        acceptance_criteria: [...b.acceptance_criteria],
+        not_in_scope: [...b.not_in_scope],
+    };
+}
+// ── 查询：问题 ──
+/**
+ * 列出所有问题条目。
+ * @returns 所有问题条目的克隆副本列表
+ */
+export function listAllProblems() {
+    console.error("[soloForge] 实施路线图: listAllProblems() 开始执行，共", PROBLEM_ENTRIES.length, "条");
+    return PROBLEM_ENTRIES.map(cloneProblemEntry);
+}
+/**
+ * 根据问题 ID 查找问题条目。
+ * @param id - 问题 ID（如 "problem-1"）
+ * @returns 匹配的问题条目克隆副本，未找到则返回 undefined
+ */
+export function findProblemById(id) {
+    console.error("[soloForge] 实施路线图: findProblemById() id=", id);
+    const e = PROBLEM_ENTRIES.find((p) => p.id === id);
+    return e ? cloneProblemEntry(e) : undefined;
+}
+/**
+ * 根据状态列出问题条目。
+ * @param status - 问题状态（completed / in_progress / planned / not_started）
+ * @returns 符合条件的问题条目克隆副本列表
+ */
+export function listProblemsByStatus(status) {
+    console.error("[soloForge] 实施路线图: listProblemsByStatus() status=", status);
+    return PROBLEM_ENTRIES.filter((p) => p.status === status).map(cloneProblemEntry);
+}
+/**
+ * 根据批次 ID 列出问题条目。
+ * @param batchId - 批次 ID（如 "batch-1"）
+ * @returns 属于该批次的问题条目克隆副本列表
+ */
+export function listProblemsByBatch(batchId) {
+    console.error("[soloForge] 实施路线图: listProblemsByBatch() batchId=", batchId);
+    return PROBLEM_ENTRIES.filter((p) => p.batch_id === batchId).map(cloneProblemEntry);
+}
+// ── 查询：批次 ──
+/**
+ * 列出所有实施批次。
+ * @returns 所有实施批次的克隆副本列表
+ */
+export function listBatches() {
+    console.error("[soloForge] 实施路线图: listBatches() 开始执行，共", IMPLEMENTATION_BATCHES.length, "个批次");
+    return IMPLEMENTATION_BATCHES.map(cloneBatch);
+}
+/**
+ * 根据批次 ID 查找实施批次。
+ * @param id - 批次 ID（如 "batch-1"）
+ * @returns 匹配的实施批次克隆副本，未找到则返回 undefined
+ */
+export function findBatchById(id) {
+    console.error("[soloForge] 实施路线图: findBatchById() id=", id);
+    const b = IMPLEMENTATION_BATCHES.find((b) => b.batch_id === id);
+    return b ? cloneBatch(b) : undefined;
+}
+/**
+ * 获取指定批次的所有依赖批次 ID（递归）。
+ * @param batchId - 批次 ID
+ * @returns 所有直接和间接依赖的批次 ID 列表
+ */
+export function getBatchDependencies(batchId) {
+    console.error("[soloForge] 实施路线图: getBatchDependencies() batchId=", batchId);
+    const direct = IMPLEMENTATION_BATCHES.find((b) => b.batch_id === batchId);
+    if (!direct)
+        return [];
+    const result = new Set();
+    const queue = [...direct.depends_on_batch_ids];
+    while (queue.length > 0) {
+        const next = queue.shift();
+        if (result.has(next))
+            continue;
+        result.add(next);
+        const dep = IMPLEMENTATION_BATCHES.find((b) => b.batch_id === next);
+        if (dep)
+            queue.push(...dep.depends_on_batch_ids);
+    }
+    return [...result];
+}
+/**
+ * 检查指定批次是否全部完成。
+ * @param batchId - 批次 ID
+ * @returns 批次中所有问题是否均已标记为 completed
+ */
+export function isBatchComplete(batchId) {
+    console.error("[soloForge] 实施路线图: isBatchComplete() batchId=", batchId);
+    const batch = IMPLEMENTATION_BATCHES.find((b) => b.batch_id === batchId);
+    if (!batch)
+        return false;
+    return batch.included_problem_ids.every((pid) => {
+        const p = PROBLEM_ENTRIES.find((e) => e.id === pid);
+        return p?.status === "completed";
+    });
+}
+// ── 汇总 ──
+/**
+ * 获取各状态问题的数量汇总。
+ * @returns 各状态对应的问题数量映射
+ */
+export function getProblemStatusSummary() {
+    console.error("[soloForge] 实施路线图: getProblemStatusSummary() 开始执行");
+    const s = { completed: 0, in_progress: 0, planned: 0, not_started: 0 };
+    for (const p of PROBLEM_ENTRIES)
+        s[p.status]++;
+    return s;
+}
+/**
+ * 获取各优先级问题的数量汇总。
+ * @returns 各优先级对应的问题数量映射
+ */
+export function getProblemPrioritySummary() {
+    console.error("[soloForge] 实施路线图: getProblemPrioritySummary() 开始执行");
+    const s = { pre_completed: 0, P0: 0, P1: 0, P2: 0, P3: 0 };
+    for (const p of PROBLEM_ENTRIES)
+        s[p.priority]++;
+    return s;
+}
+// ── 校验 ──
+/**
+ * 校验实施路线图的一致性和完整性。
+ * @description 检查问题/批次唯一性、已完成问题的完成证据、前置完成规范集、
+ *              批次引用完整性、双向一致性等。
+ * @param problems - 待校验的问题列表，默认使用内置数据
+ * @param batches - 待校验的批次列表，默认使用内置数据
+ * @returns 治理发现列表（hard_fail 为硬性错误，advisory 为建议项）
+ */
+export function validateImplementationRoadmap(problems = PROBLEM_ENTRIES, batches = IMPLEMENTATION_BATCHES) {
+    console.error("[soloForge] 实施路线图: validateImplementationRoadmap() 开始校验，问题", problems.length, "条，批次", batches.length, "个");
+    const findings = [];
+    // ── 唯一性校验 ──
+    const pIds = new Set();
+    const problemMap = new Map();
+    for (const p of problems) {
+        if (pIds.has(p.id)) {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "id", message: `duplicate problem id: ${p.id}` });
+        }
+        pIds.add(p.id);
+        problemMap.set(p.id, p);
+    }
+    const bIds = new Set();
+    const batchMap = new Map();
+    for (const b of batches) {
+        if (bIds.has(b.batch_id)) {
+            findings.push({ severity: "hard_fail", subject_id: b.batch_id, field: "batch_id", message: `duplicate batch id: ${b.batch_id}` });
+        }
+        bIds.add(b.batch_id);
+        batchMap.set(b.batch_id, b);
+    }
+    // ── 已完成的问题必须有完成证据 ──
+    for (const p of problems) {
+        if (p.status === "completed" && !p.completion_evidence) {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "completion_evidence", message: `completed problem without evidence: ${p.id}` });
+        }
+    }
+    // ── 前置完成规范集：problem-1..5 必须为 pre_completed / completed / batch_id=null ──
+    for (const p of problems) {
+        const n = parseInt(p.id.replace("problem-", ""), 10);
+        if (n >= 1 && n <= 5) {
+            if (p.priority !== "pre_completed") {
+                findings.push({ severity: "hard_fail", subject_id: p.id, field: "priority", message: `problem ${p.id} must be pre_completed, got ${p.priority}` });
+            }
+            if (p.status !== "completed") {
+                findings.push({ severity: "hard_fail", subject_id: p.id, field: "status", message: `problem ${p.id} must be completed, got ${p.status}` });
+            }
+            if (p.batch_id !== null) {
+                findings.push({ severity: "hard_fail", subject_id: p.id, field: "batch_id", message: `pre_completed problem ${p.id} must have batch_id=null, got ${p.batch_id}` });
+            }
+        }
+    }
+    // ── problem 6..42 必须有非空 batch_id ──
+    for (const p of problems) {
+        const n = parseInt(p.id.replace("problem-", ""), 10);
+        if (n >= 6 && n <= 42) {
+            if (!p.batch_id) {
+                findings.push({ severity: "hard_fail", subject_id: p.id, field: "batch_id", message: `problem ${p.id} (>=6) must have a non-null batch_id` });
+            }
+        }
+    }
+    // ── 批次引用检查 ──
+    for (const b of batches) {
+        for (const pid of b.included_problem_ids) {
+            if (!pIds.has(pid)) {
+                findings.push({ severity: "hard_fail", subject_id: b.batch_id, field: "included_problem_ids", message: `batch ${b.batch_id} references non-existent problem: ${pid}` });
+            }
+        }
+        for (const bid of b.depends_on_batch_ids) {
+            if (!bIds.has(bid)) {
+                findings.push({ severity: "hard_fail", subject_id: b.batch_id, field: "depends_on_batch_ids", message: `batch ${b.batch_id} depends on non-existent batch: ${bid}` });
+            }
+        }
+    }
+    // ── 根据 batch.included_problem_ids 构建问题→批次索引 ──
+    const problemToBatch = new Map();
+    for (const b of batches) {
+        for (const pid of b.included_problem_ids) {
+            const prev = problemToBatch.get(pid);
+            if (prev) {
+                findings.push({ severity: "hard_fail", subject_id: pid, field: "batch_id", message: `problem ${pid} appears in multiple batches: ${prev} and ${b.batch_id}` });
+            }
+            problemToBatch.set(pid, b.batch_id);
+        }
+    }
+    // ── 每个非前置完成的问题必须恰好属于一个批次 ──
+    for (const p of problems) {
+        if (p.priority !== "pre_completed" && !problemToBatch.has(p.id)) {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "batch_id", message: `non-pre-completed problem ${p.id} not in any batch` });
+        }
+    }
+    // ── 前置完成的问题必须是 completed 状态 ──
+    for (const p of problems) {
+        if (p.priority === "pre_completed" && p.status !== "completed") {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "status", message: `pre_completed problem ${p.id} has status ${p.status}, expected completed` });
+        }
+    }
+    // ── 前置完成的问题不得出现在任何 batch.included_problem_ids 中 ──
+    for (const b of batches) {
+        for (const pid of b.included_problem_ids) {
+            const p = problemMap.get(pid);
+            if (p && p.priority === "pre_completed") {
+                findings.push({ severity: "hard_fail", subject_id: pid, field: "included_problem_ids", message: `pre_completed problem ${pid} must not appear in batch ${b.batch_id}.included_problem_ids` });
+            }
+        }
+    }
+    // ── 双向一致性：ProblemEntry.batch_id ↔ batch.included_problem_ids ──
+    for (const p of problems) {
+        if (p.priority === "pre_completed" || !p.batch_id)
+            continue;
+        const batch = batchMap.get(p.batch_id);
+        if (!batch) {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "batch_id", message: `problem ${p.id} references non-existent batch: ${p.batch_id}` });
+            continue;
+        }
+        if (!batch.included_problem_ids.includes(p.id)) {
+            findings.push({ severity: "hard_fail", subject_id: p.id, field: "batch_id", message: `problem ${p.id} has batch_id=${p.batch_id} but that batch does not include it` });
+        }
+    }
+    for (const b of batches) {
+        for (const pid of b.included_problem_ids) {
+            const p = problemMap.get(pid);
+            if (p && p.batch_id !== b.batch_id) {
+                findings.push({ severity: "hard_fail", subject_id: pid, field: "batch_id", message: `batch ${b.batch_id} includes ${pid} but problem has batch_id=${p.batch_id}` });
+            }
+        }
+    }
+    // ── 建议项：test_files 为空 ──
+    for (const p of problems) {
+        if (p.status === "completed" && p.test_files.length === 0) {
+            findings.push({ severity: "advisory", subject_id: p.id, field: "test_files", message: `completed problem ${p.id} has no test_files` });
+        }
+    }
+    // ── 建议项：批次 not_in_scope 为空 ──
+    for (const b of batches) {
+        if (b.not_in_scope.length === 0) {
+            findings.push({ severity: "advisory", subject_id: b.batch_id, field: "not_in_scope", message: `batch ${b.batch_id} has no not_in_scope` });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=implementation_roadmap_registry.js.map