agentflowctl 0.15.0 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +15 -0
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -1,5 +1,8 @@
1
1
  # agentflowctl
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/agentflowctl.svg)](https://www.npmjs.com/package/agentflowctl)
4
+ [![GitHub release](https://img.shields.io/github/v/release/gogogohuang/agentflowctl)](https://github.com/gogogohuang/agentflowctl/releases)
5
+
3
6
  讓 Claude Code、Codex、Gemini CLI 等 agent 在同一個專案裡分工:整理需求、規劃、寫測試與程式、交叉審查,最後建立 PR。agentflowctl 負責推進流程,並用檔案、測試和檢查結果決定能否進到下一步。
4
7
 
5
8
  目前內建支援三種 LLM CLI:**Claude Code、Codex、Gemini CLI**。未來可擴充自定義 LLM adapter,讓其他模型供應商加入流程。目前若要串接其他 CLI,可使用 `command` adapter,自行提供執行命令;需要模型驗證時,也須提供探測命令。
@@ -215,6 +218,18 @@ Codex 另有幾點差異:
215
218
 
216
219
  環境變數對新啟動的 agentflowctl 程序生效。`AGENTFLOWCTL_MAX_ATTEMPTS` 是單一關卡的重試上限(至少 3),單一 run 可用 `run`/`resume` 的 `--max-attempts` 覆蓋;計畫審查何時交付仲裁與它無關:意見沒有變化,或第 2 輪(修訂過一次)仍被要求修改時就交付,兩家 agent 時自動進入雙盲交叉仲裁,有第三方時由第三方單獨仲裁;`maxAgentRuns` 則是整次 run 的 agent 執行次數上限。修正成功、或計畫審查與程式碼審查整組完成一輪有效審查後,該關的失敗次數會歸零,所以上限只計算連續失敗。分層計畫審查時,同一輪裡只要有一次審查呼叫真的執行成功,計畫審查的失敗次數也會歸零;所以索引與各群輪流各失敗一次、每次重跑都有進展時,不會因累計達上限而失敗。
217
220
 
221
+ ## 發版(維護者)
222
+
223
+ 在 clone 下來的 repo 裡用 `pnpm release <patch|minor|major|x.y.z> [--dry-run]` 發版,只能在 `main` 執行:
224
+
225
+ ```bash
226
+ pnpm release patch --dry-run # 只檢查與驗證,不建立 Release
227
+ pnpm release minor # 確認後建立 v0.x+1.0 的 GitHub Release
228
+ pnpm release 1.0.0 # 指定版本,必須大於目前最新的 tag
229
+ ```
230
+
231
+ 腳本會先檢查目前在 `main`、工作區乾淨、與 `origin/main` 同步、`gh` 已登入、新 tag 不存在,再跑 typecheck、test、build,列出自上個 tag 以來的 commit 並等你輸入 `y` 確認,然後用 `gh release create --generate-notes` 建立 Release。npm 由 Release 觸發的 `npm-publish.yml` 發布;版本號取自 tag,腳本不會改 `package.json`。
232
+
218
233
  ## 更多文件
219
234
 
220
235
  - [完整指令、設定與流程說明](docs/reference.md):選項、角色分配、審查規則、log、額度處理與技術細節。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agentflowctl",
3
3
  "license": "MIT",
4
- "version": "0.15.0",
4
+ "version": "0.15.1",
5
5
  "description": "跨廠商 AI 開發 harness:Claude Code、Codex、Gemini 輪流實作、審查、修正",
6
6
  "keywords": [
7
7
  "ai",
@@ -41,7 +41,8 @@
41
41
  "build": "tsc",
42
42
  "typecheck": "tsc --noEmit",
43
43
  "test": "vitest run",
44
- "prepublishOnly": "pnpm run typecheck && pnpm test && pnpm run build"
44
+ "prepublishOnly": "pnpm run typecheck && pnpm test && pnpm run build",
45
+ "release": "bash scripts/release.sh"
45
46
  },
46
47
  "dependencies": {
47
48
  "commander": "^12.1.0",