@kylecheng3146/agent-ops 0.1.14 → 0.1.16

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

@@ -42,26 +42,28 @@ Claude 與 Codex lifecycle support 為 `supported`，OpenCode 從 app initializa
 ```
 
 `targets` 是**有序的後備鏈**。每次 review 都鎖定 staged／unstaged／untracked
-變更（或乾淨的 `--base <ref>...HEAD`），並要求必要驗證的最新 PASS evidence；
-完整原生 schema report 會顯示給人看，但不會持久化。
+變更（或乾淨的 `--base <ref>...HEAD`）。裸跑使用內建 `change-quality` 準則；
+`--task` 使用 task criteria，並要求必要驗證的最新 PASS evidence。完整 report
+會顯示給人看，PASS 後只持久化 source-fingerprint attestation。
 
-每次嘗試都從新的暫存 cwd 與最小環境啟動。目前只有 Claude 具備完整的
-context-isolation 合約，能自動執行：
+每次嘗試都從新的暫存 cwd 與原生唯讀模式啟動。Claude 使用完整 safe-mode
+隔離；Codex 與 Agy 為了支援既有 OAuth 登入而保留登入環境，因此 context
+隔離較弱，但仍不能修改 repository：
 
 | 目標 | 呼叫方式 | 唯讀 |
 | --- | --- | --- |
-| `codex` | `codex exec` | 保留設定；`capability-unavailable` |
-| `agy`（Antigravity）| `agy -p` | 保留設定；`capability-unavailable` |
+| `codex` | `codex exec` | `-s read-only --ephemeral --ignore-user-config` |
+| `agy`（Antigravity）| `agy -p` | `--sandbox --mode plan --disable-slash-commands` |
 | `claude` | `claude -p` | `--permission-mode plan --safe-mode` |
 
 `opencode` **不是** review 目標，即使它是支援的 harness。它的 `--agent plan`
 會被判定為 subagent 而遭拒，並靜默退回可寫入的 agent，因此無法滿足唯讀前置
 條件。沒有唯讀旗標的目標會被跳過，不會在無沙箱狀態下執行。
 
-只有在「根本沒審到」時才換下一家 —— 執行檔不存在、spawn 失敗、或逾時
-（每個目標預設 120 秒，可用 `timeoutMs` 覆寫）。`FAIL` 判定是**終局**：
-拿到真實判定後絕不再試下一家，否則就變成自動化的 review shopping。
-無法解析的輸出同樣終局，因為那代表 prompt 約定或 CLI 版本不合，該浮出來修。
+只要沒有取得有效 verdict 就換下一家，包括執行檔不存在、spawn 失敗、逾時
+（每個目標預設 300 秒）、登入失敗、輸出過大或無法解析。文字與 JSON 輸出
+都會保留每次 attempt 及原因。`PASS` 或 `FAIL` 判定是**終局**，因此不會產生
+自動化的 review shopping。
 
 若 host 是 Claude Code（`CLAUDECODE` 已設定），`claude` 會被移到鏈尾。
 當它是唯一設定的目標時仍會執行，並附上 `reviewer == host` 警告。
@@ -90,18 +92,24 @@ agent-ops doctor --check-auth # 每個目標一次真實 print 呼叫
 ### Project-local loop profile
 
 `--profile loop` 是明確 opt-in 的 project-scope profile。請選擇 `codex`、
-`claude` 或兩者（例如 `--harness codex,claude`）；它需要 POSIX-compatible
-`bash`，目前尚未支援 Windows launcher。建議先 dry run：
+`claude` 或兩者（例如 `--harness codex,claude`）。Claude Code 已支援原生
+Windows，會使用產生的 PowerShell launcher；Codex 的 loop launcher 仍需要
+POSIX-compatible `bash`。建議先 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` 不存在時建立它。首次安裝會在不
+在原生 Windows 上，除非 Codex 是在 POSIX environment 執行，請選擇
+`--harness claude`；Codex loop 仍會呼叫 `bash`。
+
+對每個選定且支援的 harness，agent-ops 擁有最小的 native launcher：Codex 是
+`.codex/hooks/agent-ops-loop.sh`；Claude Code 是
+`.claude/hooks/agent-ops-loop.sh` 與 `.claude/hooks/agent-ops-loop.ps1`。兩個
+Claude launcher 都委派給同一個已安裝的 Node runtime，因此不會複製
+project-specific loop script。Windows 產生的 settings 會選用 PowerShell
+launcher。Codex 只會在 `.codex/config.toml` 不存在時建立它。首次安裝會在不
 覆寫既有內容的前提下，於選定 harness directory 建立 `loop-goal.md`、
 `loop-state.md` 與 `loop-telemetry.jsonl`；並以 hash-commented `.gitignore`
 block 忽略這些 local file。
@@ -175,7 +183,6 @@ config v2 feature，必須明確啟用且至少提供一個已確認的 command
 
 ```bash
 agent-ops update
-agent-ops trust grant
 ```
 
 未執行 `update` 時，doctor 可因 registration drift 回報 `UPDATE_REQUIRED`。另
@@ -183,12 +190,12 @@ agent-ops trust grant
 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。
+project update 經確認後，若有 verifier 會自動更新 stale trust binding。
 
 doctor 從不寫入檔案，部分結果本來就無法修復：安裝根目錄以外的 surface，
 或 harness 依 descriptor 宣告只部分支援的 capability（例如 opencode 的
 `lifecycle-summary`），會永久回報 `UNKNOWN` 或 `DEGRADED` 且 exit 0。若 CI
-需要自動修復，請直接呼叫 `agent-ops update` / `agent-ops trust grant`，
+需要自動修復，請直接呼叫 `agent-ops update`；也可手動呼叫 `agent-ops trust grant`，
 不要解析 doctor 的輸出。
 
 Stop 是 report-only：`PASS`、`FAIL`

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

@@ -6,8 +6,8 @@ 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、
+verification 的 config v2；變更 capability 後必須執行經確認的 project
+`agent-ops update`，有 verifier 時會一併更新 trust。Stop verification 必須明確啟用、具備 trust、
 為 report-only，且永遠不會完成 task。Dry-run plan 會隱藏 foreign settings
 內容；routing migration 一旦套用即為單向。
 

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

@@ -72,8 +72,8 @@ 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
+- Action: 只產生選定的 `.codex/hooks/agent-ops-loop.sh` 與／或 Claude 的
+  `.claude/hooks/agent-ops-loop.sh`、`.claude/hooks/agent-ops-loop.ps1` launcher，註冊文件化的 loop lifecycle event
   （不含 `Stop`），並保留 foreign hook group。只在 `UserPromptSubmit` 或 Bash
   `PreToolUse` 的 high-confidence literal credential，以及 `PreToolUse` 的危險 Bash command 時，使用
   文件化的 native denial shape 進行 blocking。對 `PermissionRequest`（包括

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kylecheng3146/agent-ops",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Evidence-driven development loops for Codex, Claude Code, and opencode",
   "type": "module",
   "license": "MIT",