@kylecheng3146/agent-ops 0.1.20 → 0.1.21

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

@@ -6,9 +6,11 @@
 `codex,opencode` 這類逗號分隔的子集。`both` 仍是 legacy Codex 加 Claude
 selection 的 input alias。
 
-Project agy、Codex 與 opencode installation 共用 managed supplemental
-`AGENTS.md` routing block 與 `.agent-ops/AGENTS.md` rules artifact。該 block
-只載入 managed baseline，並保留 project-specific instructions 的權威性。
+Project agy 使用 managed supplemental `GEMINI.md` routing block 與
+`.agent-ops/GEMINI.md` baseline；這符合 agy CLI 官方文件所述，啟動時會讀取
+workspace root 的 `GEMINI.md` 或 `AGENTS.md`。Codex 與 opencode 共用
+`AGENTS.md` route 與 `.agent-ops/AGENTS.md` 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 產生，因此請透過
@@ -131,6 +133,20 @@ agy 會安裝原生 `PreInvocation` 與 `PreToolUse(run_command)` 子集，docto
 位於 `.gemini/config/hooks.json`；user scope 會修改共享 Gemini rule surface
 `.gemini/GEMINI.md`。機器可讀的 `/hooks` 診斷要求 agy 1.1.12 以上。
 
+`agy` 搭配 `loop` 時，互動式 installer 會建議啟用
+`features.completionGate.enabled`；非互動安裝必須明確傳入
+`--completion-gate`。閘門使用官方定義的 `conversationId`、
+`terminationReason` 與 `fullyIdle` Stop 欄位，只有在本次 conversation 產生
+Git-visible net change 且缺少當前 task、驗證或 review 證據時，才回傳官方定義的
+`decision: "continue"`。純問答、分析、唯讀診斷、錯誤、max-step 與 non-idle Stop
+都正常結束；本版不改變 Codex、Claude Code 或 OpenCode 的 Stop 行為。Headless
+請使用 `agent-ops agy-run -- <agy arguments>`；使用者可核准一次
+`agent-ops allow-stop --session <conversationId>`，該命令由官方定義的
+`force_ask` 強制詢問。
+
+官方依據：[agy CLI workspace rule file](https://www.antigravity.google/docs/cli/best-practices/)
+與 [Antigravity hook contract](https://www.antigravity.google/docs/hooks/)。
+
 完整 Codex/Claude loop 會執行 `SessionStart`、`UserPromptSubmit`、`PreToolUse`、
 `PermissionRequest`、`PostToolUse`、`PreCompact`、`PostCompact`、
 `SubagentStart` 與 `SubagentStop`，但永遠不加入 `Stop`。它只攔截
@@ -164,8 +180,8 @@ hook 文件](https://code.claude.com/docs/en/hooks)。
 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。
+證明 host 會實際遵守 denial。所有 `SessionStart` 與一般 Stop verification failure
+path 都維持 fail-open；只有明確啟用的 agy completion gate 會在 final Stop fail-closed。
 
 Claude 的無效 config fallback 有四項防護：(1) 缺少 project configuration 時保持
 fail-open，因此只有無效的 `.agent-ops/config.json` 能進入 fallback；(2) manifest
@@ -176,7 +192,7 @@ hook-process environment 讀取，不能由 agent-ops configuration、manifest
 managed file 設定。
 
 `guardrails` 只安裝 command policy，不會啟用 Stop verification。Stop 是獨立的
-config v2 feature，必須明確啟用且至少提供一個已確認的 command：
+config v3 feature，必須明確啟用且至少提供一個已確認的 command：
 
 ```json
 {

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

@@ -3,12 +3,12 @@
 此目錄是英文規範的繁體中文導讀；規範 rule ID 以英文版本為準。
 
 Harness adapter 規則涵蓋 agy、Codex、Claude Code 與 opencode。opencode 整合是
-產生的 local plugin，不管理 `opencode.json`。agy 在 project scope 共用
-`AGENTS.md` routing、使用原生 hooks，對不足以完整支援 loop 的 lifecycle
+產生的 local plugin，不管理 `opencode.json`。agy 在 project scope 使用
+`GEMINI.md` routing 與原生 hooks，對不足以完整支援 loop 的 lifecycle
 能力明確標示 degraded。
 
-Configuration 與 manifest 分開版本化。Config v1 會遷移為預設 disabled Stop
-verification 的 config v2；變更 capability 後必須執行經確認的 project
+Configuration 與 manifest 分開版本化。舊 config 會遷移為 Stop verification 與
+agy completion gate 預設 disabled 的 config v3；變更 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

@@ -92,6 +92,7 @@ script，也不得改變一般 permission request。
 | --- | --- | --- | --- | --- |
 | lifecycle-summary | degraded | supported | supported | degraded |
 | command-policy | supported | unknown | supported | supported |
+| completion-gate | supported | unsupported | unsupported | unsupported |
 | optional-stop-verify | degraded | unsupported | supported | degraded |
 
 Runtime-failure 處理中，只有 `command-policy` 為 fail-closed。當已安裝的 config
@@ -101,11 +102,13 @@ denial 或 unavailable-runtime error。Codex 維持 `unknown` 且絕不輸出 de
 Fixture test 只斷言這些 wire 與 plugin shape；它們不證明 host 會實際遵守 denial。
 每個 `SessionStart` 與 `Stop` failure path 都維持 fail-open。
 
-agy adapter 在 project scope 與 Codex、OpenCode 共用 `AGENTS.md` routing；user
+agy adapter 在 project scope 使用原生 `GEMINI.md` routing 到
+`.agent-ops/GEMINI.md`；user
 scope 管理 `.agent-ops/GEMINI.md` 與 shared `.gemini/GEMINI.md` rule surface。
 其 native hook 使用 camelCase input，command-policy block 回傳
-`decision: "deny"`，且不會強迫 Stop 繼續。在 Windows 透過 `cmd /c` 呼叫產生的
-command。
+`decision: "deny"`。只有明確啟用 completion gate 時，未具完備證據的 final
+changed conversation 才回傳 `decision: "continue"`；唯讀 conversation 正常
+結束。在 Windows 透過 `cmd /c` 呼叫產生的 command。
 
 Stop verification 必須明確啟用、具備 trust、為 report-only 且預設 disabled。
 每個 Stop 結果都會讓 native harness 繼續，最多攜帶有界 command evidence，永遠

package/package.json

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

package/schemas/config.schema.json

@@ -14,7 +14,7 @@
   ],
   "properties": {
     "schemaVersion": {
-      "const": 2
+      "const": 3
     },
     "profiles": {
       "type": "array",
@@ -75,8 +75,18 @@
     "features": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["stopVerification"],
+      "required": ["completionGate", "stopVerification"],
       "properties": {
+        "completionGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled"],
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            }
+          }
+        },
         "stopVerification": {
           "type": "object",
           "additionalProperties": false,