chaitin / chaitin/agent-compose
[CLI]: legacy alias 缺少统一成熟度标记与弃用周期
Open
@eetoc is already working on this.
Since Aug 10, 2026.
enhancement
priority:P3
triage:needs-info
- Dominant language
- Go
- Stars
- 241
- Forks
- 45
- Avg merge
- 19h 10m
- Merged PRs (30d)
- 46
Description
拆自 #387。
现状
命令树同时注册新命令、legacy sandbox/image commands、deprecated inspect/session 和 exec target flags，但没有完整清单说明 stable、alias、deprecated、experimental。
问题
维护者不知道何时可删除，用户也无法规划迁移；不同入口 warning 格式和 JSON 模式行为可能不一致。
建议
为每个公开 command/flag 标注成熟度，定义至少保留版本数、替代入口和统一 warning 规则。
验收
- 公共命令清单含成熟度
- deprecated 有删除版本/周期
- JSON 模式 warning 仅进 stderr
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.