Skip to content

docs: neutralize am framing in specs and code comments (CH-012)#20

Merged
dccoding1118 merged 2 commits into
mainfrom
docs/ch012-neutral-terms
Jul 18, 2026
Merged

docs: neutralize am framing in specs and code comments (CH-012)#20
dccoding1118 merged 2 commits into
mainfrom
docs/ch012-neutral-terms

Conversation

@dccoding1118

Copy link
Copy Markdown
Owner

摘要

收尾 CH-012 的中立定位:把剩餘的需求/設計文件與程式碼註解裡「gogents 是 agent-manager (am) 的執行面」框架,改為 producer/consumer 中立敘述。README/AGENTS 與 install.sh 已於 #19 併入 main,本 PR 補齊規格層與註解層。

改動內容

  • requirement.md:local 任務源不再綁定 am(改為「任何 producer 皆可寫入」)。
  • R01:移除 GOGENTS_HOME 與 am AM_HOME 的對稱耦合敘述。
  • R02 / R04 / D01:config.yaml 註冊表與 runtime_state 的讀者由「am」改為「外部消費者」;runtime_state 命名說明保留 am 作為 worker 術語對應的例子
  • R07:verify 由「am 的 ticket 可宣告」改為「ticket 可宣告」。
  • R12 / D08:觀測 CLI、--json 契約、runtime remove、logs 稽核的服務對象由「am」改為「外部消費者」,am 續留為此類消費者的其中一種;JSON 範例路徑 /home/u/.am/workers/... 中立化為 /home/u/work/...
  • D07:pseudo-code 註解 am dispatch 閘門am 刪除 ticketproducer …
  • 程式碼註解:internal/foundation/config.gointernal/foundation/home.gointernal/cli/query.gointernal/source/local_test.go 四處註解同步中立化。
  • STATUS.md:CH-012 定位重寫任務收斂;新增「首版 release」與「README badges(gated on public)」兩筆。

影響範圍與風險

  • 不動任何規格語意與程式邏輯:純文字/註解改動。
  • 不動 ticket 契約欄位:worker / mission / depends_on 等 YAML 欄位與測試資料原樣保留(那是資料契約,非 am 品牌)。
  • docs/changes/ 歷史變更單刻意不改(記錄的是當時的 delta 語境)。
  • go vet ./...go test ./... 全綠。

驗收方式(請你手動驗證)

  1. 檢視 diff 的語意中立性:
    • git fetch origin && git diff origin/main...docs/ch012-neutral-terms
    • 預期:所有 am 提及皆為「例如 am/am 為其中一種」的舉例語氣,無任何句子把 gogents 定位為 am 的下屬/執行面。
  2. 確認 ticket 契約欄位未被動到:
    • git diff origin/main...docs/ch012-neutral-terms -- internal/source/local_test.go
    • 預期:僅兩處註解改動,所有 writeTicket(... worker: ...) 資料行原樣。
  3. 建置與測試:
    • go vet ./... && go test ./...
    • 預期:全數通過(no behavior change)。

dccoding1118 and others added 2 commits July 18, 2026 21:19
Complete the CH-012 neutral positioning across the remaining requirement
and design docs plus source comments: gogents is a standalone tool whose
local ticket source is written by any producer, and its observability CLI
serves external consumers generally. agent-manager stays only as one
example of such a producer / --json consumer, not as gogents's defining
"execution plane".

No spec semantics or program logic change; ticket schema fields (worker,
mission, ...) are untouched.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
First release is versioned v0.1.0 and deferred to the go-public batch so
install.sh and the badges light up together; no tag is cut this round.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dccoding1118
dccoding1118 merged commit eea93ec into main Jul 18, 2026
3 checks passed
@dccoding1118
dccoding1118 deleted the docs/ch012-neutral-terms branch July 18, 2026 13:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant