ChatLink

ChatLink 是 ChatArch 的 link utilities 包入口。当前包保持最小 root-only CLI：公开 scaffold hello 命令已移除，真实 link 子命令尚未暴露。

快速开始

pip install ChatLink
chatlink --help
chatlink --version
chatlink --tree
chatlink --tree-brief

当前 CLI 树

以下为 chatlink --tree-brief 的注册命令面。chatlink --tree 通常额外显示参数签名；当前 root-only CLI 没有业务命令参数，因此两个视图相同。

chatlink
├── --help  # Show this message and exit.
├── --version  # Show the version and exit.
├── --tree  # Print the registered CLI tree and exit.
└── --tree-brief  # Print the registered CLI tree without parameter signatures and exit.

CLI 边界

• 当前 CLI 只有根选项，没有业务子命令。
• 已删除模板遗留的 hello 命令；不要把 scaffold/demo 命令当作公开兼容面保留。
• --tree 和 --tree-brief 由 ChatStyle 从实际 Click 命令注册面生成，用来校对 README、文档和测试。
• 后续新增真实 link utility 命令时，必须先更新 Click 注册面，再用真实 chatlink --tree 同步文档。

目录结构

• src/：包源码
• tests/code-tests/：代码测试和历史测试迁移
• tests/cli-tests/：真实 CLI 测试，doc-first
• tests/mock-cli-tests/：mock/fake CLI 测试，doc-first
• docs/：长期维护文档，由 MkDocs 构建

开发说明

扩展脚手架前，先阅读 DEVELOP.md 和 AGENTS.md。