Skip to content

chore: remove legacy 'anet quickstart' command (closes #45)#46

Merged
s2agi merged 1 commit into
mainfrom
feat/issue-45-remove-quickstart
May 13, 2026
Merged

chore: remove legacy 'anet quickstart' command (closes #45)#46
s2agi merged 1 commit into
mainfrom
feat/issue-45-remove-quickstart

Conversation

@s2agi
Copy link
Copy Markdown
Contributor

@s2agi s2agi commented May 13, 2026

Author & Helpers

Author (Primary): 通信工程马

Helpers:

Tier review gate: 通信龙 (Lead, post-onboarding 单审 OK,breaking change 加 doc 双语走 PR)

Why

Closes #45

Vincent 4192 raise: "quickstart 彻底删了吧,内容都放到 demo 里面"

anet quickstart 是 v0.6 legacy 4 步 wizard,功能跟现代命令组合 redundant

  • Step 1: 配 hub URL (没起 hub,只检测健康)
  • Step 2: register/login user
  • Step 3: 创建 1 agent
  • Step 4: 打印提示

现代命令 (anet hub start + anet setup + anet register + anet login + anet node create) 已 cover 全部功能 + 更可控 + 已 maintain。demos/hello-world docker-compose 已 cover "一键起 hub + agent" use case,新增 demos/quickstart/ 会跟 hello-world 重叠 (per 调研 Option A 推荐 → 通信龙 confirm)。

What

文件 改动
agent-network/bin/cli.ts quickstartCommand() function (L2839-2976, 138 行) -138
agent-network/bin/cli.ts dispatch case "quickstart" 改 deprecation message + process.exit(1) -1 +13
agent-network/README.md 删 legacy anet quickstart -1
docs-site/docs/guide/cli.md ZH 删命令表 row -1
docs-site/docs/en/guide/cli.md EN 删命令表 row -1
docs-site/docs/guide/getting-started.md ZH 删未验证 bullet -1
docs-site/docs/en/guide/getting-started.md EN 删 Not-verified bullet -1

Total: 6 files, +13 -145

Migration path (per bottom-up SOP)

老用户跑 anet quickstart 现在输出 helpful deprecation message + exit(1)(非 silent fail):

[anet] ⚠ 'anet quickstart' 已删除(per #45)。改用现代命令组合:
  anet hub start          # 起 CommHub Server
  anet setup              # 装 runtime deps + 选 runtime (wizard)
  anet register           # 创建账号
  anet login              # 登录
  anet node create <name> # 创建 agent

或一键 demo: cd demos/hello-world && docker compose up

What's NOT changed (Frozen archive per RELEASE-SOP.md)

历史 frozen 不动:

  • docs/changelog.md / evolution-log.md / claude-code-cleanup-review.md / design-*.md
  • docs-site/docs/changelog.md / en/changelog.md
  • docs-site/docs/v0.8.0/**
  • docs-site/docs/.vitepress/dist/** (build output,rebuild 会清)

README.en.md 顶部 ## 30-second quickstart section header (general 名词 "快速入门") 跟 anet quickstart CLI 命令无关,section 内容是现代命令组合,保留

How to verify

# 1. typecheck
cd agent-network && bun install && npm run typecheck   # 应 no error

# 2. 验 deprecation message + exit code
bun bin/cli.ts quickstart; echo "exit=$?"
# 期望:
#   [anet] ⚠ 'anet quickstart' 已删除(per #45)。改用现代命令组合:
#   ...
#   或一键 demo: cd demos/hello-world && docker compose up
#   exit=1

# 3. grep verify 函数完全删除 (除 dispatch deprecation)
grep -nE "quickstartCommand|async function quickstart" bin/cli.ts
# 期望: 空 (function 已删,只剩 dispatch case "quickstart": 输出 message)

# 4. grep verify docs 提及全删 (排除 frozen archive)
grep -rln "quickstart" agent-network/ docs-site/docs/ 2>/dev/null \
  | grep -v ".vitepress/dist" \
  | grep -v "v0.8.0/" \
  | grep -v "changelog.md" \
  | grep -v "evolution-log\|claude-code-cleanup\|design-"
# 期望: agent-network/bin/cli.ts (deprecation message) only

# 5. README.en.md "30-second quickstart" section 保留确认
grep -nE "30-second quickstart" README.en.md
# 期望: L66 + L228 (section header + internal link, 保留 — 跟 CLI 命令无关)

Test evidence

本地全跑通:

  • bun install + npm run typecheck no error
  • bun bin/cli.ts quickstart 输出 deprecation banner + exit=1
  • grep quickstartCommand 空 (function 完全删)
  • ✅ 6 files diff 干净,0 误删 frozen archive,0 误改 unrelated
  • ✅ rebased on top of latest origin/main

Checklist

  • Relevant tests pass locally (typecheck + cli runtime test)
  • docs-site/docs/changelog.md updated — n/a (frozen archive 不动 per RELEASE-SOP.md,新版本发布时通信文档马 R 系列同步 changelog)
  • Docs synced (cli.md + getting-started.md ZH/EN 全 sync)
  • No secrets / tokens / private IPs / /home/<user> paths in the diff
  • Conventional Commits message (chore:)
  • No Co-Authored-By: Claude* footer (OSS rule)
  • Attribution trailer (Author-Agent: 通信工程马 + Helpers:)
  • Issue linked via Closes #45

Per Vincent issue #45 — v0.6 legacy quickstart wizard is redundant now that
modern commands cover the same user journey:
  anet hub start       # CommHub Server
  anet setup           # runtime deps + provider wizard
  anet register/login  # account
  anet node create     # agent

The interactive 4-step quickstart in cli.ts (L2839-2976, ~138 lines) only
configured a hub URL + register/login + created one agent — it didn't even
start the hub or dashboard. Functionality is fully covered by:
- anet hub start / anet hub dashboard
- anet setup (more complete wizard + runtime dep install)
- demos/hello-world docker-compose (one-shot hub + 2 agents + task)

Changes:
- agent-network/bin/cli.ts: delete quickstartCommand() function; dispatch
  case prints a deprecation message listing the modern command set and
  exits non-zero (not a silent fail — per bottom-up SOP).
- agent-network/README.md: remove L128 'anet quickstart legacy' bullet.
- docs-site/docs/{guide,en/guide}/cli.md: remove command-table row.
- docs-site/docs/{guide,en/guide}/getting-started.md: remove
  '未验证 / Not verified' bullet about quickstart.

Frozen archives (changelog.md, evolution-log.md, design-*.md, v0.8.0/**,
.vitepress/dist/**) untouched per RELEASE-SOP.md frozen-snapshot rule.
Build artifacts (dist/) will rebuild without the removed code path.

README.en.md '## 30-second quickstart' section header (general noun for
'quick start') is unrelated to the CLI command — kept.

Verified:
- npm run typecheck: pass, no error
- bun bin/cli.ts quickstart: prints deprecation banner + exits with code 1
- 6 files changed, +13 -145 (138 deleted + 7 deprecation-message lines)

Author-Agent: 通信工程马
Helpers: 通信龙 (dispatch + review), Vincent (issue raise)
@s2agi s2agi merged commit 70d3b2a into main May 13, 2026
1 of 3 checks passed
@s2agi s2agi deleted the feat/issue-45-remove-quickstart branch May 13, 2026 07:51
s2agi pushed a commit that referenced this pull request May 13, 2026
…5 vendor dropdown)

Includes:
- #45 anet quickstart removed (deprecation message migration to anet hub start + setup + register + login + node create)
- #48 5 vendor added to claude-agent-sdk model dropdown (DeepSeek-V3 / GLM-5.1 / Intern-S1-Pro / kimi-k2-0905-preview / MiMo-V2.5)

Published via:
- npm publish --tag preview (per feedback_release_preview_first SOP + feedback_npm_publish_two_phase)
- npm view @sleep2agi/agent-network@preview version → 2.1.8-preview.1

Vincent 4219 wants to verify the fix locally.

Author-Agent: 通信SDK马
Helpers: 通信龙 (dispatch), 通信工程马 (implement #45/#48), 通信牛 (review #46)
s2agi pushed a commit that referenced this pull request May 13, 2026
Two related fixes for the Phase 1 team-scale demo:

1. **Rename science-team → sci-team** per Vincent 4319 ("换个名字吧 demo
   叫 sci-team"). Affects all user-facing surfaces:
   - `anet demo` dispatch case
   - `anet demo ls` entry
   - `anet demo sci-team --help` banner + flag descriptions
   - tmux session prefix (`sci-team-<alias>`)
   - lifecycle prompts ("kill sci-team-*", "清理完成", etc.)
   - config.json `team` field default value
   Internal identifiers (`demoSciTeamCommand`, `SCI_TEAM_DIRECTIONS`,
   `sciTeamPlaceholderPrompt`, `sciTeamLifecycle`) renamed for consistency.

2. **Vincent 4317** reported `anet demo science-team` returning "Unknown
   demo" after installing 2.1.8-preview.4. Source had the dispatch case
   correctly (commit a3e6e3a from PR #53), so this was a publish-pipeline
   issue, not a registration gap: the published preview.4 dist/bin/cli.js
   was built from a stale tree before #53 merged (`strings dist/bin/cli.js
   | grep science` returned zero matches; PR #46/#48 obfuscated identifiers
   were present, confirming the dist was older than the merged source).

   No source change required for the registration itself — the next
   release (preview.5) just needs a fresh `npm run build` from current
   main before publishing. SDK马 to bump + publish per the standard SOP.

Backward compat: no alias kept for `science-team` because preview.4 was
broken end-to-end (Vincent's report = it didn't work), so no real users
have config.json with `team: "science-team"`. Clean rename.

Verified locally:
- `npm run typecheck` passes (29 identifier touches, all updated).
- `bun bin/cli.ts demo` lists `sci-team` (not science-team).
- `bun bin/cli.ts demo sci-team --help` renders the full banner.
- `bun bin/cli.ts demo science-team` now responds "Unknown demo" (rename
  is clean — old string is no longer registered).

Refs #51 (Vincent 4317 broken + 4319 rename)

Author-Agent: 通信工程马
Helpers: 通信龙 (dispatch + Vincent relay), Vincent (4317 broken report + 4319 rename + 4227 Intern verify chain)
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.

[Doc] 文档修改建议 quickstart 彻底删了吧,内容都放到 demo 里面

2 participants