Skip to content

feat(flow-agent): add flow-agent command group, deprecate app call/list (prepare 2.10.0) - #320

Merged
lishengzxc merged 2 commits into
mainfrom
feat/flow-agent-command-group
Nov 13, 2026
Merged

lishengzxc merged 2 commits into
mainfrom
feat/flow-agent-command-group

Conversation

@lishengzxc

Copy link
Copy Markdown
Contributor

Summary

Add a canonical bl flow-agent command group (13 commands) for managing Bailian applications, and deprecate the bl app group down to just call / list (kept as deprecated wrappers pointing at flow-agent call / flow-agent list). The 11 control-plane commands now live only under flow-agent.

Both groups are real entries in the canonical commands map — no commandAliases is used.

What changed

  • packages/cli/src/deprecated.ts (new): product-layer deprecatedCommand(command, replacementPath) wrapper — [Deprecated]/[已废弃] description prefix, a leading deprecation note, and a stderr warning on invocation (ctx.output.info, text mode). Preserves auth/risk/flags/prepare/validate via spread. No core/runtime changes.
  • packages/cli/src/commands.ts: register 13 flow-agent * paths (original command objects); remove the 11 app control-plane paths; keep app call / app list as deprecated wrappers.
  • tools/generate-reference.ts: GROUP_OWNER_SKILL registers flow-agent → bailian-cli.
  • Command implementations (packages/commands/src/commands/app/) and export names are unchanged (capability-based layout; product paths decided by the entry map).

Docs

  • Regenerated reference: new flow-agent.md (13 commands); app.md now only call/list, both marked [Deprecated].
  • bailian-cli SKILL routing/examples/workflows switched to flow-agent; bailian-gen / bailian-protocol / bailian-managed-agent hand-offs updated.
  • README app list → flow-agent list; packages/cli/README* copies synced byte-for-byte (cmp verified) so the release assertReadmeSync self-check passes.
  • Amended the unreleased 2.9.0 bilingual CHANGELOG: Added uses flow-agent naming, new Deprecated/已弃用 section for app call/list.

Tests

  • app-control.e2e.test.ts: control-plane cases migrated to flow-agent * paths; app call/list kept as library-level contracts.
  • New product-level flow-agent-deprecation.e2e.test.ts (uses the real product map): registration counts, [Deprecated] help, stderr warning in text mode, clean JSON stdout, removed app create → exit 2, flow-agent help not deprecated.
  • registry.smoke assertions updated for the [Deprecated] description prefix.

Note: the commands-library harness loads raw exports by name (bypassing the product map), so deprecation marking is asserted at the product level, not in commands e2e.

Verification (Node v22.23.0, maxWorkers=2)

  • pnpm run check: 0 errors (2 pre-existing warnings), exit 0.
  • commands app-control.e2e: 55 passed / 1 skipped (live), 2.70s.
  • cli flow-agent-deprecation.e2e: 7 passed, 4.85s.
  • cli registry.smoke: 447 passed, 10.73s.
  • bl flow-agent --help shows 13 commands (no deprecation); bl app --help shows only call/list, both [Deprecated].

Register bl flow-agent (13 commands) as the canonical application group; keep only app call/list as deprecated wrappers pointing at flow-agent. Product-layer deprecation (description prefix + note + stderr warning), no commandAliases. Migrate e2e to flow-agent, add product-level deprecation tests, sync skill reference/routing/READMEs (cli copies byte-identical), amend 2.9.0 CHANGELOG.
Bump seven packages 2.9.0 -> 2.10.0; add 2.10.0 CHANGELOG (flow-agent command group, app call/list deprecated) and restore the published 2.9.0 entry; sync SKILL metadata.
@lishengzxc lishengzxc changed the title feat(flow-agent): add flow-agent command group, deprecate app call/list feat(flow-agent): add flow-agent command group, deprecate app call/list (prepare 2.10.0) Nov 13, 2026
@lishengzxc
lishengzxc merged commit eef8336 into main Nov 13, 2026
7 checks passed
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