@kylecheng3146/agent-ops 0.1.4 → 0.1.6

package/docs/en/spec/review.md

@@ -19,3 +19,14 @@ A review result MUST preserve PASS, FAIL, or NOT_RUN and MUST NOT convert NOT_RU
 - Evidence: The result states harness, configured model or limitation, effort, and reason.
 - Positive: `NOT_RUN: login required; prompt is copyable.`
 - Negative: `No reviewer ran, but mark the change PASS.`
+
+## REVIEW-HARNESS-001
+
+A review invocation MUST resolve to exactly one concrete harness, even when an
+installation supports multiple harnesses.
+
+- Trigger: Running `review` with a harness selection.
+- Action: Select one of `codex`, `claude`, or `opencode`; keep multi-harness installation separate from review execution.
+- Evidence: Argument parsing rejects `all`, `both`, and comma-separated multi-harness values for review.
+- Positive: `review --harness opencode` resolves one harness.
+- Negative: `Run one review invocation against every installed harness implicitly.`

package/docs/zh-TW/guides/configuration.md

@@ -0,0 +1,145 @@
+# 設定
+
+保持 project 設定明確且分層。請刻意選擇 scope、harness 與 profile；不要從 `--yes` 推論 trust 或安全例外。
+
+使用 `--harness all` 選取 Codex、Claude Code 與 opencode，或傳入
+`codex,opencode` 這類逗號分隔的子集。`both` 仍是 legacy Codex 加 Claude
+selection 的 input alias。
+
+Project Codex 與 opencode installation 共用 managed supplemental
+`AGENTS.md` routing block 與 `.agent-ops/AGENTS.md` rules artifact。該 block
+只載入 managed baseline，並保留 project-specific instructions 的權威性。
+Claude 使用對應的 `CLAUDE.md` route 與 `.agent-ops/CLAUDE.md` artifact。Opencode 另外取得
+agent-ops 擁有的 `.opencode/plugins/agent-ops.js`；不會修改 `opencode.json`。
+Plugin 使用安裝時的 absolute runtime path 產生，因此請透過
+`agent-ops update` 更新，不要手動編輯。
+
+User scope 下，Codex 與 opencode 的 routing file 分別位於 `.codex/` 與
+`.opencode/`；global opencode plugin 預設位於 `.config/opencode/plugins/`，
+若 `$XDG_CONFIG_HOME` 指向 managed user root 內的目錄，則改用
+`$XDG_CONFIG_HOME/opencode/plugins/`。若 OpenCode 設定了
+`$OPENCODE_CONFIG_DIR`，則 plugin 會放在其 `plugins/` 目錄。只有 profile
+有暗示時才會註冊 advisory 與 guardrail hook。Installer 會 discovery 可寫入的
+harness surface 並套用選定的 target policy；若不是 managed default，請使用
+`--hook-target <harness>=<surface-id>` 明確選擇。Project-local Claude hook 預設
+使用 `.claude/settings.json`；只有要使用 `.claude/settings.local.json` 時才需
+明確選擇。Advisory 會經由真正的 SessionStart path 執行並 fail-open；
+Claude 與 Codex lifecycle support 為 `supported`，OpenCode 從 app initialization
+開始，因此誠實標示為 `degraded`。
+
+### Project-local loop profile
+
+`--profile loop` 是明確 opt-in 的 project-scope profile。請選擇 `codex`、
+`claude` 或兩者（例如 `--harness codex,claude`）；它需要 POSIX-compatible
+`bash`，目前尚未支援 Windows launcher。建議先 dry run：
+
+```bash
+agent-ops init --dry-run --scope project --harness codex,claude --profile loop --json
+agent-ops init --scope project --harness codex,claude --profile loop --yes
+```
+
+對每個選定且支援的 harness，agent-ops 只擁有一個小型 launcher：
+`.codex/hooks/agent-ops-loop.sh` 或 `.claude/hooks/agent-ops-loop.sh`。兩個
+launcher 都委派給同一個已安裝的 Node runtime，因此不會複製 project-specific
+loop script。Codex 只會在 `.codex/config.toml` 不存在時建立它。首次安裝會在不
+覆寫既有內容的前提下，於選定 harness directory 建立 `loop-goal.md`、
+`loop-state.md` 與 `loop-telemetry.jsonl`；並以 hash-commented `.gitignore`
+block 忽略這些 local file。
+
+Loop 會執行 `SessionStart`、`UserPromptSubmit`、`PreToolUse`、
+`PermissionRequest`、`PostToolUse`、`PreCompact`、`PostCompact`、
+`SubagentStart` 與 `SubagentStop`，但永遠不加入 `Stop`。它只攔截
+high-confidence 的 literal secret prompt 或 Bash command，以及危險 Bash command
+（包括 broad recursive deletion 與 `git reset --hard`）。Codex 使用原生 exit-code blocking
+mechanism；Claude Code 則取得文件化的 native JSON decision shape。
+`PermissionRequest`（包括 `sandbox_permissions: "require_escalated"`）只記錄
+outcome，不會輸出 allow 或 deny decision，因此 host 原本的 approval flow 保持
+權威。
+
+Session context、telemetry 與 compaction state 都受到明確上限。Telemetry 只含
+timestamp、event、outcome 與 rule identifier，不會存 raw prompt、command 或
+credential，並依 byte size rotation。PreCompact 的 Git-status snapshot 會先
+redact，再寫入 `loop-state.md` 的專用 block，周圍的 user content 保持不變。
+installer update 與 uninstall 只管理 launcher、native handler registration 與
+精確的 `.gitignore` block；goal、state、telemetry 與 `config.toml` 都保留為 local
+user file。若既有 `.codex/config.toml` 明確寫有 `[features]` 後的
+`hooks = false`，planning 會在任何 write 之前以
+`CODEX_LOOP_HOOKS_DISABLED` 停止。
+
+Codex 與 Claude Code 對這些 generated handler 仍須走各自正常的 project-hook
+trust/review flow。Loop 是聚焦的 guardrail，不是完整 sandbox、permission bypass
+或 Stop-verification feature。啟用前請閱讀 [Codex hook
+文件](https://developers.openai.com/codex/config-advanced#hooks)與 [Claude Code
+hook 文件](https://code.claude.com/docs/en/hooks)。
+
+### Runtime-failure 保護措施
+
+對一般 `guardrails` profile 而言，只有 `command-policy` 具有 fail-closed failure mode。當已安裝的 config 被分類
+為無效時，Claude Code 可在原生 `PreToolUse` 輸出文件化的 denial shape。受管理的
+OpenCode `tool.execute.before` plugin 可在其支援的 Bash surface
+上 throw 文件化的 command-policy denial 或 unavailable-runtime error。Codex 明確
+不執行強制措施（`unknown`）。這些是 agent-ops 的 output 與 plugin contract，不
+證明 host 會實際遵守 denial。所有 adapter 的 `SessionStart` 與 `Stop` failure path
+都維持 fail-open。
+
+Claude 的無效 config fallback 有四項防護：(1) 缺少 project configuration 時保持
+fail-open，因此只有無效的 `.agent-ops/config.json` 能進入 fallback；(2) manifest
+必須安全地證明目前 harness 已安裝；(3) 使用者可在啟動 host 前於 shell export
+`AGENT_OPS_DISABLE=1`，暫時恢復 fail-open；(4) Claude Code denial 會列出 config
+path，並告知使用者修正它或暫時設定該 shell variable。此 variable 只從
+hook-process environment 讀取，不能由 agent-ops configuration、manifest 或
+managed file 設定。
+
+`guardrails` 只安裝 command policy，不會啟用 Stop verification。Stop 是獨立的
+config v2 feature，必須明確啟用且至少提供一個已確認的 command：
+
+```json
+{
+  "features": { "stopVerification": { "enabled": true } },
+  "verification": {
+    "commands": [
+      {
+        "id": "unit",
+        "command": "npm",
+        "args": ["test"],
+        "cwd": ".",
+        "required": true,
+        "evidence": { "kind": "test-count", "minimum": 1 }
+      }
+    ]
+  }
+}
+```
+
+變更此 feature 會改變 native registration，請依序執行：
+
+```bash
+agent-ops update
+agent-ops trust grant
+```
+
+未執行 `update` 時，doctor 可因 registration drift 回報 `UPDATE_REQUIRED`。另
+外，toolkit upgrade 或 effective profile 或 capability change 使完整的
+path-independent managed rules artifact 改變時，`artifact-staleness` 會回報帶有
+`UPDATE_REQUIRED` 的 `DEGRADED`。`agent-ops update` 會重新產生 artifact 並清除
+這個結果；artifact 缺失或 hash 不符時，`artifacts` check 仍為 `FAIL`。未重新
+grant trust 時，trust-gated hook 仍會是 stale。Stop 是 report-only：`PASS`、`FAIL`
+與 `UNKNOWN` 都會讓 harness 繼續，只輸出有界的 command ID、exit code、test-count、
+config-hash 與 timestamp evidence，且永遠不會完成 task。Config v1 會決定性遷移
+為 Stop disabled 的 v2；舊 binary 無法讀取遷移後的 config，routing migration
+一旦套用即為單向，降版前請先閱讀 release notes。
+
+若要縮減既有 installation，請將目標清單傳給
+`agent-ops update --harness`；shared path 會繼續受管理，被移除 harness
+擁有的 artifact、marker 與 hook 則會被安全同步。
+
+使用舊版 canonical routing wording 的 installation 會由
+`agent-ops update` 遷移；若 managed block 曾被修改，指令會 fail closed，
+直到該變更被檢查。
+
+Dry-run 的 human 與 JSON plan 不會輸出原始 harness settings 內容，只提供
+expected hash、content hash 與安全摘要；internal apply plan 仍保留完整合併後的設定。
+Manifest 維持 schema v2。
+
+新增驗證命令時使用[驗收與證據規則](../../en/spec/acceptance-and-evidence.md)，
+設定 Codex、Claude Code 或 opencode 行為時使用[adapter 規則](../../en/spec/harness-adapters.md)。

package/docs/zh-TW/guides/quickstart.md

@@ -0,0 +1,9 @@
+# 快速開始
+
+1. 定義 2–5 個驗收條件。
+2. 檢查最小相關範圍。
+3. 實作前先讓測試失敗。
+4. 做最小變更，再執行 typecheck 與測試。
+5. 記錄證據，交接前請求獨立審查。
+
+請參考[規範迴圈](../../en/spec/loop-engineering.md)與[審查規則](../../en/spec/review.md)。

package/docs/zh-TW/guides/security.md

@@ -0,0 +1,5 @@
+# 安全
+
+將命令、log、設定與外部輸入視為不可信。遮罩憑證、預設阻擋破壞性命令，並讓本機狀態留在 tracked project path 之外。
+
+修改政策或 hook 前，閱讀[防護規則](../../en/spec/guardrails.md)、[判斷規則](../../en/spec/judgment.md)與[維護規則](../../en/spec/maintenance.md)。

package/docs/zh-TW/spec/README.md

@@ -2,6 +2,15 @@
 
 此目錄是英文規範的繁體中文導讀；規範 rule ID 以英文版本為準。
 
+Harness adapter 規則涵蓋 Codex、Claude Code 與 opencode。opencode 整合是
+產生的 local plugin，不管理 `opencode.json`。
+
+Configuration 與 manifest 分開版本化。Config v1 會遷移為預設 disabled Stop
+verification 的 config v2；變更 capability 後必須先執行 `agent-ops update`，
+再執行 `agent-ops trust grant`。Stop verification 必須明確啟用、具備 trust、
+為 report-only，且永遠不會完成 task。Dry-run plan 會隱藏 foreign settings
+內容；routing migration 一旦套用即為單向。
+
 - [迴圈工程](./loop-engineering.md)
 - [驗收與證據](./acceptance-and-evidence.md)
 - [判斷](./judgment.md)

package/docs/zh-TW/spec/harness-adapters.md

@@ -1,14 +1,17 @@
 # Harness Adapter
 
-English source version: 2026-07-23. Revalidate: when the English specification changes.
+English source version: 2026-08-03. Revalidate: when the English specification or any vendor reference changes.
+
+本文件所述 OpenCode plugin 行為已於 2026-07-31 依據[官方 plugin 文件](https://opencode.ai/docs/plugins/)與[Bun shell 文件](https://bun.sh/docs/runtime/shell)檢查；Codex 與 Claude Code loop-hook 行為已於 2026-08-03 依據 [Codex hook 文件](https://developers.openai.com/codex/config-advanced#hooks) 與 [Claude Code hook 文件](https://code.claude.com/docs/en/hooks) 檢查。
 
 ## HARNESS-ADAPTER-001
 
-Adapter MUST 保留原生 harness 語意，並將未支援行為標示為 UNKNOWN。
+Adapter MUST 保留原生 harness 語意，並為每項 capability 宣告
+supported、degraded、unsupported 或 unknown。
 
 - Trigger: 將可攜 lifecycle 或 review 行為映射到原生 harness。
 - Action: 保持 ownership 狹窄、保留使用者設定並記錄限制。
-- Evidence: adapter 測試涵蓋既有設定與未支援結果。
+- Evidence: adapter 測試涵蓋既有設定、support 宣告與原生 failure 行為。
 - Positive: `Codex blocking outcome 未確認原生 denial 時保持 UNKNOWN。`
 - Negative: `假設 Claude exit semantics 適用 Codex。`
 
@@ -21,3 +24,86 @@ Adapter MUST 具備冪等性，且 MUST NOT 刪除使用者擁有的 handler。
 - Evidence: 既有設定 fixture 在 apply 與 uninstall 後保持完整。
 - Positive: `更新 managed handler，無關 handler 仍逐位元存在。`
 - Negative: `以 toolkit defaults 取代整份 settings。`
+
+## HARNESS-ADAPTER-003
+
+檔案型 adapter MUST 只註冊 active capabilities 所暗示的 hook，且 MUST 將產生的 source 當成一個 whole-file artifact 管理。
+
+- Trigger: 安裝或探測 extension point 是 plugin 檔案的 harness。
+- Action: 對 opencode 在 project 管理 `.opencode/plugins/agent-ops.js`、在 user scope 預設管理 `.config/opencode/plugins/agent-ops.js`（若 `$XDG_CONFIG_HOME` 指向 managed user root 內的目錄，則使用其下的 `opencode/plugins/agent-ops.js`；若設定原生 `$OPENCODE_CONFIG_DIR`，則使用其下的 `plugins/agent-ops.js`），不修改 `opencode.json`；project `AGENTS.md` 的 contribution 依 path 去重。
+- Evidence: manifest 含 plugin hash，產生的 source 只含選定的 hook，shared project marker 只出現一次。
+- Positive: `codex,opencode` 產生一個 project AGENTS route 與一個有 hash 的 opencode plugin。
+- Negative: `新增 opencode.json instructions entry，或在只有 core profile 時註冊 plugin。`
+
+## HARNESS-ADAPTER-004
+
+OpenCode shim MUST 從選定的 project directory 呼叫 absolute runtime path；runtime 不可用時，MUST 對 advisory event fail open，並 MUST throw 文件化的 command-policy error。
+
+- Trigger: 產生的 plugin 呼叫 `agent-ops`，或收到無效的 runtime decision。
+- Action: 將 normalization 與 native output encoding 留在 runtime adapter；deny
+  decision 要 throw 文件化的 policy reason；lifecycle-summary 經由 shared
+  advisory implementation 執行。Plugin initialization 仍是 app-scoped 而非
+  per-session，因此 per-session lifecycle fidelity 仍為 degraded。
+- Evidence: shim import 測試涵蓋 allow、deny 與 missing-runtime；denial fixture
+  只斷言 output shape；doctor 對 OpenCode lifecycle support 回報 `DEGRADED`。
+- Positive: `runtime 不可用時，SessionStart 維持 fail-open，而生成的 plugin 會在 Bash pre-tool hook 中 throw 文件化的 command-policy error。`
+- Negative: `退回 PATH-resolved 的 agent-ops executable、宣稱 OpenCode host 一定會遵守 thrown denial，或宣稱 app initialization 等同於 per-session Stop。`
+
+## HARNESS-ADAPTER-005
+
+每個 descriptor MUST 分離 control 與 runtime adapter。control adapter 負責
+installation plan、routing、ownership、probe 與 in-memory capability
+registration matrix；runtime adapter 負責 native input decode、normalized
+event、native output encode 與 runtime-failure output。
+
+- Trigger: 新增 harness surface 或 generic capability。
+- Action: 在所屬 harness 加入 capability-to-native registration，包含 support
+  level 與 runtime-failure mode；不得將 native event 加入 universal union。
+- Evidence: 每個宣告為 `supported` 的 registration 都經由真實 CLI hook process
+  執行；denial-shape fixture 只斷言文件化的 wire shape，不證明 host runtime
+  enforcement；未支援的 Stop/lifecycle registration 不得回報 enforcement success。
+- Positive: `fail-closed 的 Claude command-policy runtime failure 會透過 runHookCommand 產生文件化的 PreToolUse denial shape。`
+- Negative: `dispatchHookEvent 尚未提供 advisory implementation 卻將 SessionStart 標為 supported。`
+
+## HARNESS-ADAPTER-006
+
+Project-local `loop` profile MUST 是 opt-in、project scoped，並在最小的 Codex 與
+Claude Code launcher 後使用同一個 shared runtime。它 MUST NOT 將 policy 複製到
+project-specific script，也不得改變一般 permission request。
+
+- Trigger: Project 以 Codex、Claude Code 或兩者選擇 `loop`。
+- Action: 只產生選定的 `.codex/hooks/agent-ops-loop.sh` 與／或
+  `.claude/hooks/agent-ops-loop.sh` launcher，註冊文件化的 loop lifecycle event
+  （不含 `Stop`），並保留 foreign hook group。只在 `UserPromptSubmit` 或 Bash
+  `PreToolUse` 的 high-confidence literal credential，以及 `PreToolUse` 的危險 Bash command 時，使用
+  文件化的 native denial shape 進行 blocking。對 `PermissionRequest`（包括
+  escalated permission）不得輸出 decision。
+- Evidence: Install-plan、loop-runtime、update、uninstall 與 doctor test 覆蓋
+  generated path、Codex/Claude wire output、privacy bound、configuration conflict
+  handling、state preservation 與 registration drift。
+- Positive: `Claude PreToolUse 的危險 Bash command 取得 native deny，而 PermissionRequest 不產生 allow 或 deny decision。`
+- Negative: `將 project loop policy 複製到兩個 shell launcher、auto-approve sandbox escalation，或加入 loop Stop handler。`
+
+目前 registration matrix 刻意不對稱：
+
+| Capability | Codex | Claude Code | OpenCode |
+| --- | --- | --- | --- |
+| lifecycle-summary | supported | supported | degraded |
+| command-policy | unknown | supported | supported |
+| optional-stop-verify | unsupported | supported | degraded |
+
+Runtime-failure 處理中，只有 `command-policy` 為 fail-closed。當已安裝的 config
+被分類為無效時，Claude Code 可輸出文件化的 `PreToolUse` denial shape；受管理的
+OpenCode `tool.execute.before` plugin 可在其支援的 Bash surface 上 throw 文件化的
+denial 或 unavailable-runtime error。Codex 維持 `unknown` 且絕不輸出 denial。
+Fixture test 只斷言這些 wire 與 plugin shape；它們不證明 host 會實際遵守 denial。
+每個 `SessionStart` 與 `Stop` failure path 都維持 fail-open。
+
+Stop verification 必須明確啟用、具備 trust、為 report-only 且預設 disabled。
+每個 Stop 結果都會讓 native harness 繼續，最多攜帶有界 command evidence，永遠
+不是 task-completion evidence。
+
+`loop` profile 與上方 ordinary capability matrix 分離。它只保存有界的 local
+event metadata、回傳有界且 redacted 的 session context，並在 update 或 uninstall
+時保留 local goal、state、telemetry 與 Codex TOML file。既有 Codex configuration
+中清楚解析出的 `[features]` / `hooks = false` MUST 在任何 write 前拒絕 loop planning。

package/docs/zh-TW/spec/maintenance.md

@@ -1,6 +1,6 @@
 # 維護
 
-English source version: 2026-07-23. Revalidate: when the English specification changes.
+English source version: 2026-07-31. Revalidate: when the English specification changes.
 
 ## MAINTAIN-BACKUP-001
 
@@ -21,3 +21,13 @@ English source version: 2026-07-23. Revalidate: when the English specification c
 - Evidence: 文件含來源與 `Revalidate:` 條件。
 - Positive: `Revalidate：vendor hook reference 變更時。`
 - Negative: `把暫時性的 CLI flag 當永久核心規則。`
+
+## MAINTAIN-PLUGIN-001
+
+產生的 harness plugin MUST 視為 managed artifact，且 MUST NOT 直接在原位置手動編輯。
+
+- Trigger: 更新 runtime、capabilities 或 vendor plugin contract。
+- Action: 重新產生 opencode shim、驗證 manifest hash，並在 release 前重新檢查 vendor 行為。
+- Evidence: artifact hash 與 shim import 測試通過；release 文件記錄重驗條件。
+- Positive: `agent-ops update` 通過 ownership checks 後重寫已變更的 plugin。
+- Negative: `手動修改 .opencode/plugins/agent-ops.js，卻保留舊的 manifest hash。`

package/docs/zh-TW/spec/review.md

@@ -21,3 +21,13 @@ English source version: 2026-07-23. Revalidate: when the English specification c
 - Evidence: 結果列出 harness、設定的 model 或限制、effort 與原因。
 - Positive: `NOT_RUN：需要登入；prompt 可複製。`
 - Negative: `沒有審查執行，仍標示 PASS。`
+
+## REVIEW-HARNESS-001
+
+即使 installation 支援多個 harness，一次 review invocation MUST 解析成恰好一個 concrete harness。
+
+- Trigger: 使用 harness selection 執行 `review`。
+- Action: 從 `codex`、`claude` 或 `opencode` 中選一個；multi-harness installation 與 review execution 分開處理。
+- Evidence: argument parsing 會拒絕 review 使用 `all`、`both` 或逗號分隔的多 harness 值。
+- Positive: `review --harness opencode` 解析成一個 harness。
+- Negative: `讓一次 review invocation 隱式跑過所有已安裝 harness。`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kylecheng3146/agent-ops",
-  "version": "0.1.4",
-  "description": "Evidence-driven development loops for Codex and Claude Code",
+  "version": "0.1.6",
+  "description": "Evidence-driven development loops for Codex, Claude Code, and opencode",
   "type": "module",
   "license": "MIT",
   "repository": "github:kylecheng3146/agent-ops",
@@ -17,6 +17,8 @@
     "templates/",
     "docs/en/spec/",
     "docs/zh-TW/spec/",
+    "docs/en/guides/",
+    "docs/zh-TW/guides/",
     "README.md",
     "LICENSE",
     "SECURITY.md",

package/schemas/config.schema.json

@@ -8,18 +8,19 @@
     "schemaVersion",
     "profiles",
     "verification",
+    "features",
     "pathMappings",
     "securityExceptions"
   ],
   "properties": {
     "schemaVersion": {
-      "const": 1
+      "const": 2
     },
     "profiles": {
       "type": "array",
       "uniqueItems": true,
       "items": {
-        "enum": ["core", "advisory", "guardrails"]
+        "enum": ["core", "advisory", "guardrails", "loop"]
       }
     },
     "verification": {
@@ -42,6 +43,23 @@
         }
       }
     },
+    "features": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stopVerification"],
+      "properties": {
+        "stopVerification": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled"],
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
     "pathMappings": {
       "type": "array",
       "items": {
@@ -94,6 +112,42 @@
       }
     }
   },
+  "allOf": [
+    {
+      "if": {
+        "type": "object",
+        "properties": {
+          "features": {
+            "type": "object",
+            "properties": {
+              "stopVerification": {
+                "type": "object",
+                "properties": {
+                  "enabled": {
+                    "const": true
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "then": {
+        "type": "object",
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": {
+              "commands": {
+                "type": "array",
+                "minItems": 1
+              }
+            }
+          }
+        }
+      }
+    }
+  ],
   "$defs": {
     "id": {
       "type": "string",

package/schemas/manifest.schema.json

@@ -7,13 +7,18 @@
   "required": ["schemaVersion", "scope", "harness", "artifacts", "markers"],
   "properties": {
     "schemaVersion": {
-      "const": 1
+      "const": 2
     },
     "scope": {
       "enum": ["project", "user"]
     },
     "harness": {
-      "enum": ["codex", "claude", "both"]
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "enum": ["codex", "claude", "opencode"]
+      }
     },
     "artifacts": {
       "type": "array",
@@ -129,7 +134,18 @@
           "minItems": 1,
           "uniqueItems": true,
           "items": {
-            "enum": ["SessionStart", "PreToolUse", "Stop"]
+            "enum": [
+              "SessionStart",
+              "UserPromptSubmit",
+              "PreToolUse",
+              "PermissionRequest",
+              "PostToolUse",
+              "PreCompact",
+              "PostCompact",
+              "SubagentStart",
+              "SubagentStop",
+              "Stop"
+            ]
           }
         },
         "owner": {

package/templates/common/AGENTS.block.md

@@ -1,3 +1,4 @@
 ## Loop Engineering
 
-Use `.agent-ops/AGENTS.md` as the canonical Loop Engineering specification for this project.
+Load `.agent-ops/AGENTS.md` as the agent-ops managed baseline.
+Project-specific instructions in this file remain authoritative.

package/templates/common/CLAUDE.block.md

@@ -1,3 +1,4 @@
 ## Loop Engineering
 
-Use `.agent-ops/CLAUDE.md` as the canonical Loop Engineering specification for this project.
+Load `.agent-ops/CLAUDE.md` as the agent-ops managed baseline.
+Project-specific instructions in this file remain authoritative.

package/dist/runtime/src/review/claude-runner.js

@@ -1,4 +0,0 @@
-import { runIndependentReview } from "./runner.js";
-export function runClaudeReview(options) {
-    return runIndependentReview(options);
-}

package/dist/runtime/src/review/codex-runner.js

@@ -1,4 +0,0 @@
-import { runIndependentReview } from "./runner.js";
-export function runCodexReview(options) {
-    return runIndependentReview(options);
-}