@fitlab-ai/agent-infra 0.9.4 → 0.9.6

package/templates/.agents/skills/run-task/reference/host-validation.zh-CN.md

@@ -5,16 +5,16 @@
 ## 必须证明的字段
 
 - 客户端版本、启用的多代理能力、启动入口与信任边界。
-- 原始 start/stop 事件能稳定给出 event type、managed agent、parent/child identity、fresh spawn mode、actual model 和 actual reasoning effort。
+- 原始 start/stop 事件，或 custom role 缺少它们时的 parent PostTool spawn/completed-wait fallback，能稳定关联 managed agent、parent/child identity、fresh spawn mode、actual model 和 actual reasoning effort。
 - 显式 requested model/effort 能传给 executor/reviewer；宿主对任一字段回退时，事件能给出对应 actual 值与独立的非空 fallback reason。
 - candidate checkout 与打包安装后的行为一致，且模型策略、receipt 与验证结果可从 `orchestration.json` 复核。
 
 ## 验证顺序
 
 1. 在干净临时仓库记录客户端版本、feature 状态和启动命令。
-2. 分别启动 fresh executor 与 fresh reviewer，保存去敏后的原始 stdin 和结构化 run；不得补写宿主未产生的字段。
+2. 分别启动 fresh executor 与 fresh reviewer，保存去敏后的原始 stdin 和结构化 run；同时验证原生 start/stop 与 parent PostTool fallback。timed-out wait 必须无动作；不得补写宿主未产生的字段。
 3. 分别验证 model/effort 的 requested/actual 一致路径、单项与双项有理由 fallback 路径，并确认缺 actual 字段会失败关闭。
 4. 对同一 commit 执行 candidate checkout 与 `npm pack` 安装验证，记录 tarball 哈希和结果。
 5. 仅把去敏摘要与非敏感 fixture 纳入版本库；token、绝对用户路径、transcript 内容和凭证必须删除或替换。
 
-任一字段无法从真实宿主稳定观察时，该客户端的 orchestration capability 保持 `unsupported`，并把缺口记录为人工验证项。
+任一字段无法从真实宿主稳定观察时，该客户端的 orchestration capability 保持 `unsupported`，并把缺口记录为人工验证项。Codex 可声明为 `experimental`，但每次 `prepare` 仍必须通过静态 preflight，且原生 start/stop 或 parent spawn/completed-wait fallback 必须形成可验证的 consumed host evidence。fallback 只允许 empty turns/协议 `inProgress` 等待；malformed、身份/传输错误或异常 terminal 都稳定暂停。

package/templates/.claude/commands/run-manual-validation.en.md

@@ -0,0 +1,9 @@
+---
+description: "Run host-side task validation and record sanitized evidence"
+usage: "/run-manual-validation <task-ref> [--scope snapshot|inplace] [--timeout <ms>] [--format text|json] -- <command...>"
+disable-model-invocation: true
+---
+
+Read and execute the run-manual-validation skill from `.agents/skills/run-manual-validation/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.claude/commands/run-manual-validation.zh-CN.md

@@ -0,0 +1,9 @@
+---
+description: "运行宿主侧任务校验并记录去敏证据"
+usage: "/run-manual-validation <task-ref> [--scope snapshot|inplace] [--timeout <ms>] [--format text|json] -- <command...>"
+disable-model-invocation: true
+---
+
+读取并执行 `.agents/skills/run-manual-validation/SKILL.md` 中的 run-manual-validation 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.codex/hooks.json

@@ -11,6 +11,56 @@
             "statusMessage": "Checking template version before git commit"
           }
         ]
+      },
+      {
+      "matcher": "^collaborationspawn_agent$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/hooks/lifecycle-delegation.js\" --client codex --event pre-tool",
+            "timeout": 15,
+            "statusMessage": "Recording Codex lifecycle spawn evidence"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+      "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/hooks/lifecycle-delegation.js\" --client codex --event post-tool",
+            "timeout": 15,
+            "statusMessage": "Recording Codex lifecycle tool completion"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/hooks/lifecycle-delegation.js\" --client codex --event subagent-start",
+            "timeout": 15,
+            "statusMessage": "Recording Codex child identity"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/hooks/lifecycle-delegation.js\" --client codex --event subagent-stop",
+            "timeout": 15,
+            "statusMessage": "Recording Codex child stop evidence"
+          }
+        ]
       }
     ]
   }

package/templates/.opencode/commands/run-manual-validation.en.md

@@ -0,0 +1,11 @@
+---
+description: "Run host-side task validation and record sanitized evidence"
+agent: general
+subtask: false
+---
+
+Run manual validation: $ARGUMENTS
+
+Read and execute the run-manual-validation skill from `.agents/skills/run-manual-validation/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.opencode/commands/run-manual-validation.zh-CN.md

@@ -0,0 +1,11 @@
+---
+description: "运行宿主侧任务校验并记录去敏证据"
+agent: general
+subtask: false
+---
+
+运行人工校验：$ARGUMENTS
+
+读取并执行 `.agents/skills/run-manual-validation/SKILL.md` 中的 run-manual-validation 技能。
+
+严格按照技能中定义的所有步骤执行。