docs(refresh): channel-neutral wording + real npm preview matrix (issue #639) - #869
docs(refresh): channel-neutral wording + real npm preview matrix (issue #639)#869vansin wants to merge 1 commit into
Conversation
…issue #639) Doc-only refresh from 通信狗 review (issue #639). No behavior changes, no runtime/config edits — every touched file is markdown or a package.json `description` field. ## Version facts sourced from npm at commit time Verified via `npm view <pkg> dist-tags` on 2026-08-14: latest : agent-network 2.2.21 / agent-node 2.4.13 / commhub-server 0.8.8 preview : agent-network 2.3.0-preview.39 / agent-node 2.5.0-preview.31 commhub-server 0.9.0-preview.29 local anet: v2.3.0-preview.38 (matches preview channel, one behind head) ## Per-file changes P0-1 CHANGELOG.md banner - Drop hardcoded "当前 stable 是 v0.10.11" (out of date). - Point readers at npm `latest` + docs-site/docs/changelog.md as the live source; keep the v0.10.15 archival anchor + v0.8.1 OSS-first note. File still an archive of pre-2026-04 v1.0.0-preview history. P0-2 docs/getting-started.md - Runtime table now includes `grok-build-acp` (needs `grok login`). - Note that @Preview additionally ships `codex-app-server` and `opencode-cli`; the authoritative full runtime table is at anet.sh/guide/runtimes. - `anet ls` → `anet node ls` (matches current CLI). P0-3 docs-site/docs/{,en/}guide/getting-started.md - Add a preview-channel warning next to the admin/anethub line: @Preview prints a one-time random password on first `anet hub start`, don't hard-code `anethub`. This aligns with the README + cli.md wording that already carries the note. P0-4 AGENTS.md 项目结构 - Drop "39 命令" / "4 runtime" hardcoded counts (both drift). - Point at docs-site/docs/guide/cli.md as canonical CLI list. - Split runtimes into stable (4: claude-code-cli / claude-agent-sdk / codex-sdk / grok-build-acp) + preview extra (2: codex-app-server / opencode-cli); mark `grok-build-cli` as unreleased in any channel. P0-5 docs/version/README.md + docs/plans/release-plan.md + docs/version/0.11.0/README.md - Backfill preview matrix from `npm view <pkg>@preview` (was pinned at .34/.26/.20 — now .39/.31/.29). Added timestamp + reminder to re-check `npm view` before editing. - WAIC 7-月-下旬 anchor is out of the window; strike-through the completed date, keep the archival link to waic-release.md, and replace with "current promote status per release-plan". - release-plan.md defaults table gains a commhub-server column so readers see all three packages, not just two. P1-6 docs-site/docs/guide/architecture.md - "14 张表" → "20+ 张表(含 sessions / tasks / nodes / users / networks / SkillHub / providers / vault 等，实数按 schema 版本浮动)"; EN mirrors it. Fixes both the two mermaid diagrams and the paragraph. P1-7 docs/architecture.md - Runtime paragraph now says "stable 4 + preview 2" and points at anet.sh/guide/runtimes as authoritative. - 14 cli.ts deep `#L<line>` anchors defanged (link stays, line number dropped — they rot every release; kept the function name in the link text so intent survives). - Directory tree gains an "已不完整，以仓库实际为准" note so readers don't treat it as canonical. P1-8 server/package.json + server/README.md - package.json `description` now says "MCP tools (17 collaboration- core + node/provider ops tools; authoritative list at docs-site/docs/api/mcp-tools.md)" — was "and 17 MCP tools" (readers took it as the total). - server/README.md MCP section gains one line saying the 17 in the table are the collaboration-core subset; full list at docs-site/docs/api/mcp-tools.md. P1-9 README.md + README.en.md - "能做什么" / "What it does" gain one bullet pointing at Codex TUI co-presence and OpenCode as preview-channel additions with a link to the Runtime page. ## Not touched (per review scope) - docs/v3-postgresql-design.md archive banner (do not edit) - upgrade-v2 archive banner (do not edit) - grok-copresence danger banner (do not edit) - runtimes 官方表 (canonical, do not edit) ## Verification `grep -c` on the touched files confirms: - `14 张表` remaining in docs-site/docs/guide/architecture.md: 0 - `39 命令` remaining in AGENTS.md: 0 - stale `cli.ts#L<n>` deep anchors in docs/architecture.md: 0 - `anet ls` (bare, without node prefix) in docs/getting-started.md: 0
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0c3b76f030
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | 通道 | @sleep2agi/agent-network | @sleep2agi/agent-node | @sleep2agi/commhub-server | 说明 | | ||
| |---|---|---|---|---| | ||
| | **latest**（稳定） | 2.2.21 | 2.4.13 | 0.8.8 | 4 个 stable runtime；⚠ 带 Windows 跨盘 `anet --version` 崩溃（#446） | | ||
| | **preview** | **2.3.0-preview.39** | **2.5.0-preview.31** | **0.9.0-preview.29** | 迭代中：Windows 修复 + `codex-app-server` flag + OpenCode `1.18.1`。preview 还额外暴露 `codex-app-server` / `opencode-cli` 两个 runtime。**promote 门禁** = 全 Linux 门禁真绿 + Windows 复验 PASS + 审计发现的 stop 孤儿窗（OpenCode 节点 stop 可留 detached ACP 孤儿）修复合入并复跑受影响门禁。 | |
There was a problem hiding this comment.
For release operators using this living document, the refreshed table identifies .39 / .31 as the current preview, but the immediately following section still calls .34 / .26 the “next preview” and directs them to the already superseded draft #454. This leaves two incompatible release candidates in the same plan and risks applying obsolete gate instructions; update or archive that subsequent section together with the version refresh.
AGENTS.md reference: AGENTS.md:L24-L24
Useful? React with 👍 / 👎.
| ``` | ||
|
|
||
| verify [`cli.ts:228 loadProfile`](https://github.com/sleep2agi/agent-network/blob/main/agent-network/bin/cli.ts#L228): | ||
| verify [`cli.ts:228 loadProfile`](https://github.com/sleep2agi/agent-network/blob/main/agent-network/bin/cli.ts): |
There was a problem hiding this comment.
For readers using these links to verify the architecture, removing every #L… fragment now opens the top of a roughly 13,000-line file while the visible labels still advertise obsolete locations such as cli.ts:228 (the referenced loadProfile is around line 1208 in this revision). The same mismatch remains across the edited saveProfile, setupCommand, runCommand, ensureMcpJson, configuration, and dashboard links, so the change neither provides working navigation nor fully removes the line numbers that were meant to stop drifting; retain a navigable stable target or remove the numeric labels as well.
Useful? React with 👍 / 👎.
| | `list_tasks` | Task list, filterable by `network_id` | | ||
| | `get_completions` | Completion history | | ||
|
|
||
| > The table above lists the 17 **collaboration-core** tools. Node lifecycle / provider ops tools ship on the same MCP surface — the authoritative full list is [docs-site/docs/api/mcp-tools.md](../docs-site/docs/api/mcp-tools.md). Don't read the count above as "17 tools total". |
There was a problem hiding this comment.
The linked docs-site/docs/api/mcp-tools.md explicitly says it documents only the 17 collaboration-core tools and leaves the operational tools unexpanded, so it cannot serve as the “authoritative full list” promised here. This matters when server users need to discover the rest of the MCP surface—the source currently registers roughly 46 tools, including SkillHub and internal task-consumption tools that the linked page does not enumerate; either expand that page into a complete inventory or link to a source/generated list that is complete.
Useful? React with 👍 / 👎.
独立复核:版本数字与 npm 实况逐一吻合;改动面确如所述(复核于
|
1 participant
Doc-only refresh from 通信狗 review (issue #639). No behavior changes,
no runtime/config edits — every touched file is markdown or a
package.jsondescriptionfield.Author alias: 通信文档马
Version facts sourced from npm at commit time
Verified via
npm view <pkg> dist-tagson 2026-08-14:Local
anet -vat authoring time:v2.3.0-preview.38 / 2.4.13 / 0.8.8.Changed (9 items across 15 files, +71 -46)
P0-1 CHANGELOG.md banner
当前 stable 是 v0.10.11(out of date).latest+docs-site/docs/changelog.mdas thelive source; keep v0.10.15 archival anchor and v0.8.1 OSS-first note.
P0-2 docs/getting-started.md
grok-build-acprow (needsgrok login).@previewadditionally shipscodex-app-serverandopencode-cli; authoritative full runtime table isanet.sh/guide/runtimes.anet ls→anet node ls(matches current CLI).P0-3 docs-site/docs/{,en/}guide/getting-started.md
@previewprints a one-time random password on firstanet hub start; do not hard-codeanethub. Wording mirrorsREADME.
P0-4 AGENTS.md 项目结构
39 命令/4 runtimehardcoded counts (both drift).docs-site/docs/guide/cli.mdas canonical CLI list.codex-sdk / grok-build-acp) + preview extra (2: codex-app-server /
opencode-cli); mark
grok-build-clias unreleased in any channel.P0-5 docs/version + docs/plans/release-plan.md
docs/version/README.md,docs/plans/release-plan.md,docs/version/0.11.0/README.mdbackfill preview matrix fromnpm view <pkg>@preview(was pinned at .34/.26/.20 — now.39/.31/.29). Added timestamp + reminder to re-check
npm viewbefore editing.
completed date, keep the archival link to waic-release.md, and
replace with 'current promote status per release-plan'.
release-plan.mddefaults table gains a commhub-server column soreaders see all three packages, not just two.
P1-6 docs-site/docs/{,en/}guide/architecture.md
14 张表→20+ 张表(含 sessions / tasks / nodes / users / networks / SkillHub / providers / vault 等，实数按 schema 版本浮动); EN mirrors it. Fixes both mermaid diagrams and prose.P1-7 docs/architecture.md
anet.sh/guide/runtimesas authoritative.cli.ts#L<line>deep anchors defanged — link kept, linenumber dropped (they rot every release; function name in link
text preserves intent).
P1-8 server/package.json + server/README.md
server/package.jsondescriptionnow saysMCP tools (17 collaboration-core + node/provider ops tools; authoritative list at docs-site/docs/api/mcp-tools.md)— wasand 17 MCP tools(readers took it as the total).
server/README.mdMCP section gains one line saying the 17 inthe table are the collaboration-core subset; full list at
docs-site/docs/api/mcp-tools.md.P1-9 README.md + README.en.md
Codex TUI co-presence and OpenCode as preview-channel additions
with a link to the Runtime page.
Not touched (per review scope)
docs/v3-postgresql-design.mdarchive banner (do not edit)Verification (grep after commit)
14 张表remaining indocs-site/docs/guide/architecture.md: 039 命令remaining inAGENTS.md: 0cli.ts#L<n>deep anchors indocs/architecture.md: 0anet lsindocs/getting-started.md: 0Closes #639