weichen
3695237454
Why: The approved document dependencies have been reviewed and merged. Their actual immutable merge commits must be fixed before final host validation, while operational activation remains a separate gate. Evidence: Independent document replay and verified PR merges are recorded in the task card. The staged host combination passed make test with actual merged child pointers; final commit build/CI remains pending and will be recorded outside source. Impact: Advance only the two reviewed merged child pins, expose the real plan path, and record partial stage-seven approval and pending activation. Preserve current main components and existing admission/owner boundaries. Refs: Guidelines PR #5 (2f5b198); Documents PR #96 (129cc35); Dev PR #519; implementation plan U4-U6; Issue #518
4.0 KiB
4.0 KiB
CLI/git 门禁能力矩阵
适配对象：通过 shell/git 操作本仓的执行者。要求来自固定的 Development-Guidelines
standards/tool-adaptation.md 与根 AGENTS.md；本表登记机制范围，不复制另一套规则。
历史治理可靠性记录见 .task/feature-governance-reliability.md；本轮调度与恢复候选的
实际 SELF 命令记录见 .task/feature-merge-queue-policy-draft.md。历史测试不代替当前对象回归。
| 要求 | 执行能力及范围 | 机制 | 复验入口 |
|---|---|---|---|
| A1 启动/恢复 | 本地命令阻断；首次调用及阶段授权仍属 manual | 默认严格 READY；显式 local 验证既有任务/R0及 LOCAL_READY；start 固定严格用途，resume 验证后导入 | tests/test_task.py、tests/test_task_recovery.py、tests/test_evidence.py |
| A2 同步 | 本地命令阻断；最终准入由平台承担 | 合并父仓、保护组件分支、物化固定指针、同基线幂等、完整最终 SHA | tests/test_task.py、make test-worktree |
| A3 集成分支 | 本地提交闸；平台状态须独立核验 | pre-commit 拒绝 main/master 与坏分支名 | 本地 hook 负例；远端缺 CI/陈旧候选/直推等负例另验 |
| A4 提交格式 | 主题行 enforced(local)，body manual | commit-msg 校验宽度/句点；任务工具生成四段 body | tests/test_task.py；人工核对 PR/卡片同源 |
| A5 回收 | 本地命令检查；写者退出由 owner 确认 | 登记根目录、锁/操作状态、父子仓与唯一文件、合入核验 | tests/test_task.py |
| A6 秘密 | 本地脱敏及 CI 获取边界；权限与宿主隔离另验 | 命令/输出/摘要脱敏，凭据不持久写 Git 配置 | tests/test_evidence.py、tests/test_ci_credentials.py |
| A7 证据 | 本地 SELF 收据；外部来源独立核验 | 首次捕获、完整脱敏输出/摘要、对象记录、原样导入 | tests/test_evidence.py；CI/审阅链接另核 |
| A8 阶段评审与迭代 | manual（人工/Agent 执行）；前序人工决策，智能体 Review/合入；模板和提示不构成批准身份校验或全流程阻断 | policy/delivery.md；任务卡分别记录阶段结论、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | tests/test_task.py 核对模板及钩子不自动写入；智能体核对 Review、冲突及匹配 HEAD 的 CI/平台准入；人工批准范围仍须核验 |
| A9 长期方向与后续任务 | manual；模板不校验规划有效性或自动调度任务 | policy/delivery.md；PROJECT.md 提供规划入口，任务卡关联规划/里程碑并记录下一步建议 | tests/test_task.py 核对生成字段与未授权默认值；人工核对当前规划、进展、重复任务和建议依据 |
| A10 交付窗口 | manual（待启用）；无自动互斥或接管 | policy/merge-queue.md；Issue #518 与协调者已登记，本候选固定实际合入规范版本；Dev 组合验收、平台正负例及全部写入者覆盖待完成 | tests/test_merge_queue_trial.py 临时 Git 场景 SELF；平台/真实 CI 三任务试行 NOT_RUN |
| A11 固定后证据 | manual 选择源码外位置；工具捕获绝对未用路径/原始输出；无 OS 冻结 | policy/governance.md；RECEIPT 捕获，后续授权闭合再原样导入 | tests/test_evidence.py 固定对象、权限、覆盖拒绝、原样导入与幂等 |
失败处理
网络不可达、引用缺失、必要解释器不可用均显式失败，不能给 READY 或同步成功。 命令非零、管道失败及证据写入失败返回非零；保留已有收据，不覆盖历史结果。 工作区回收被拒时保留现场；本地及远端回收分开报告。具体操作见 开发门禁。
平台与历史证据
2026-09-30 记录曾报告 11 个组合仓 main 已启用禁直推与陈旧候选保护；这是历史结论， 本次代码/文档修复不据此认定当前远端准入有效。正式审核仍须核验当前配置和匹配负例， 与本地回归分开记录。机制升级只复用未变化范围的证据。