@kylecheng3146/agent-ops 0.1.3 → 0.1.5

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.3",
-  "description": "Evidence-driven development loops for Codex and Claude Code",
+  "version": "0.1.5",
+  "description": "Evidence-driven development loops for Codex, Claude Code, and opencode",
   "type": "module",
   "license": "MIT",
   "repository": "github:kylecheng3146/agent-ops",
@@ -17,9 +17,12 @@
     "templates/",
     "docs/en/spec/",
     "docs/zh-TW/spec/",
+    "docs/en/guides/",
+    "docs/zh-TW/guides/",
     "README.md",
     "LICENSE",
-    "SECURITY.md"
+    "SECURITY.md",
+    "postinstall.cjs"
   ],
   "publishConfig": {
     "access": "public"
@@ -30,7 +33,8 @@
     "test:compile": "node scripts/clean.mjs .tmp && tsc -p tsconfig.test.json",
     "test": "npm run test:compile && node scripts/run-tests.mjs .tmp/test-dist/tests",
     "build": "node scripts/clean.mjs dist && tsc -p tsconfig.build.json",
-    "package:check": "node scripts/package-check.mjs"
+    "package:check": "node scripts/package-check.mjs",
+    "postinstall": "node postinstall.cjs"
   },
   "devDependencies": {
     "@types/node": "26.1.1",

package/postinstall.cjs

@@ -0,0 +1,102 @@
+"use strict";
+
+const { closeSync, existsSync, openSync, readFileSync } = require("node:fs");
+const { join, resolve } = require("node:path");
+const { spawnSync } = require("node:child_process");
+const { isatty } = require("node:tty");
+
+const PACKAGE_NAME = "@kylecheng3146/agent-ops";
+const packageRoot = __dirname;
+const installRoot = resolve(process.env.INIT_CWD ?? process.cwd());
+
+function isDirectDependency() {
+  try {
+    const packageJson = JSON.parse(
+      readFileSync(join(installRoot, "package.json"), "utf8")
+    );
+    return [
+      packageJson.dependencies,
+      packageJson.devDependencies,
+      packageJson.optionalDependencies,
+      packageJson.peerDependencies
+    ].some(
+      (dependencies) =>
+        dependencies !== null &&
+        typeof dependencies === "object" &&
+        dependencies[PACKAGE_NAME] !== undefined
+    );
+  } catch {
+    return false;
+  }
+}
+
+function openTerminal() {
+  if (process.stdin.isTTY === true && process.stdout.isTTY === true) {
+    return { stdio: "inherit", close() {} };
+  }
+
+  const inputPath = process.platform === "win32" ? "CONIN$" : "/dev/tty";
+  const outputPath = process.platform === "win32" ? "CONOUT$" : "/dev/tty";
+  let inputFd;
+  let outputFd;
+  try {
+    inputFd = openSync(inputPath, "r");
+    outputFd = process.platform === "win32" ? openSync(outputPath, "a") : inputFd;
+    if (!isatty(inputFd) || !isatty(outputFd)) {
+      throw new Error("Interactive terminal is unavailable.");
+    }
+    return {
+      stdio: [inputFd, outputFd, outputFd],
+      close() {
+        if (outputFd !== inputFd) {
+          closeSync(outputFd);
+        }
+        closeSync(inputFd);
+      }
+    };
+  } catch {
+    if (outputFd !== undefined && outputFd !== inputFd) {
+      closeSync(outputFd);
+    }
+    if (inputFd !== undefined) {
+      closeSync(inputFd);
+    }
+    return null;
+  }
+}
+
+if (
+  installRoot === resolve(packageRoot) ||
+  process.env.CI !== undefined ||
+  !isDirectDependency()
+) {
+  process.exit(0);
+}
+
+const terminal = openTerminal();
+if (terminal === null) {
+  process.exit(0);
+}
+
+const cliPath = join(packageRoot, "dist", "packages", "cli", "src", "bin.js");
+if (!existsSync(cliPath)) {
+  process.stderr.write(
+    "agent-ops init was skipped because the installed CLI is unavailable.\n"
+  );
+  terminal.close();
+  process.exit(0);
+}
+
+const result = spawnSync(process.execPath, [cliPath], {
+  cwd: installRoot,
+  env: process.env,
+  stdio: terminal.stdio
+});
+terminal.close();
+
+if (result.error !== undefined || result.status !== 0) {
+  process.stderr.write(
+    "agent-ops init was not applied; package installation completed. " +
+      "Run `agent-ops` to retry.\n"
+  );
+}

package/schemas/config.schema.json

@@ -8,12 +8,13 @@
     "schemaVersion",
     "profiles",
     "verification",
+    "features",
     "pathMappings",
     "securityExceptions"
   ],
   "properties": {
     "schemaVersion": {
-      "const": 1
+      "const": 2
     },
     "profiles": {
       "type": "array",
@@ -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",

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);
-}