45 lines
5.0 KiB
Markdown
45 lines
5.0 KiB
Markdown
# 内置本地Git交付契约
|
|
|
|
1.25.5起,默认开放模式在自动写入前保存本地Git基线,文件和本地Git按保存的操作权限执行;下方早期逐项审查条款按历史受控模式理解。终端Git与结束报告的最新源码修复见文末,正式仍为1.25.8,尚未部署该修复。
|
|
|
|
本切片把已审核文件、实际工程检查、只读提交预览、持久提交job和交付报告绑定到同一个Task。代码检查不等同于业务需求已验收;报告只陈述已有证据。
|
|
|
|
## 准入与范围
|
|
|
|
- 当前工程必须是自己的Git仓库,已有HEAD;不自动初始化、推送或创建worktree。
|
|
- 本机需要可用的Git;当前实现使用Git索引及prepare/commit引用事务,已在Git for Windows 2.54.0验证。便携包随附Node/npm,Git使用本机安装。
|
|
- 只接受当前Task中已应用的普通文本文件。连续提案的基线链必须一致,当前文件SHA256必须等于最新已应用提案。
|
|
- Git HEAD中的内容必须与该修改链起点一致。选中文件已有其他人的工作区修改、暂存修改、未合并或特殊索引标记时拒绝提交。
|
|
- 新文件必须由本Task从不存在的基线创建。其他未跟踪文件不会进入提交。
|
|
- 完整有界源码快照和至少一项实际有测试数量的通过记录必须一致;跳过、取消、未知、损坏日志和过期检查均不能准入。
|
|
- 不执行自定义Git内容过滤器、外部diff或fsmonitor。本地提交不执行仓库hooks和GPG签名,预览明确说明该策略;依赖这些检查的团队工程须通过自己的Git流程交付。
|
|
- 源码指纹与Git执行基线分别保存。文件未变化时,提交不使已有测试过期。
|
|
|
|
## 提交与保留
|
|
|
|
确认只接收已保存的planId。预览包含任务、HEAD/ref、作者、实际消息、明确文件清单、diff、检查记录和策略;任一基线变化需要新计划。
|
|
|
|
执行宿主持有项目互斥。Git使用参数数组、明确路径、受限环境和独立索引构建交付树;原索引持有标准index.lock,保留不属于此任务的所有索引条目。Git引用事务先比较原HEAD并prepare锁定HEAD和当前分支,再核对实际分支引用后commit或abort;支持已有命名分支。提交记录含唯一Workbench-Delivery trailer,禁止以重试生成第二个提交。
|
|
|
|
完成必须核对实际提交的父节点、树、路径、文件blob、唯一trailer、原工作区源码与无关索引条目。未知状态不会伪装成完成。
|
|
|
|
## 停止与恢复
|
|
|
|
job持久保存queued/preparing/prepared/publishing/committed/completed阶段及索引锁的本次身份。发布前停止不会更新HEAD;已发布后的停止继续核对实际结果,不能假定取消了提交。
|
|
|
|
服务实际退出后不自动重放。显式“核对提交结果”先只读确认预期提交和引用;只有本次持有的遗留索引锁及原索引SHA均匹配、原进程已结束时,才修复本次索引发布。遇到外部索引/引用变化保留需处理状态,不删除别人的锁、不覆盖外部修改。
|
|
|
|
## 交付报告
|
|
|
|
JSON和Markdown工件从实际Task、Run、模型快照、usage、提案、检查日志、源指纹及Git结果生成;带SHA256并可查看/下载。无需额外模型调用。报告明确区分待审核、需检查、检查通过待提交、已验证提交和结果待核对,不把模型文字中的“完成”作为交付证据。
|
|
|
|
## 终端Git与任务结束报告(源码修复)
|
|
|
|
实际`run_command`执行前后只读核对Git状态。已应用的本任务文件在暂存前进入Run所属基线,支持先`git add`、随后另次`git commit`。提交链、每次提交路径、最终文件blob、当前源码及原非目标索引一致时,保存独立`terminal-git-evidence`工件;报告的`terminalGit`和`gitOutcome.sources`显示终端来源,不补造内置`delivery_job`。
|
|
|
|
命令输出中的“committed”不作为证明。额外文件、中间提交夹带后又撤回的文件、外部HEAD/索引漂移、原证据损坏和源码后续变化分别保留为未核对或过期。证据核对失败不阻止实际终端命令,也不重试或回放副作用。终端命令失败但先前已产生真实提交时,分别记录提交与原退出码。
|
|
|
|
有改动、检查、交付或阶段报告的执行Run结束后,追加JSON/Markdown终态报告及`run.finalDeliveryReport`引用。`lifecycle`记录snapshot/final、真实Run状态和结束时间。原in_progress报告保留原字节;最终报告不会将失败Run改成成功。普通问候、诊断、worker及已切换Task不追加主线终态报告;报告生成失败保存在`finalDeliveryReportError`,不重放命令。
|
|
|
|
当前可匹配范围是已有已应用提案的任务文件。纯终端写入、未能核对的Git布局或非线性提交保留实际观察及原因,不冒充已认证交付。命令窗口内HEAD发生变化只能证明观察到提交,不能证明某进程是创建者。源码验收与历史失败见[AI阶段验收](QA-TERMINAL-DELIVERY-AI.md);正式发行、真实供应商使用情况另记。
|