chaitin / chaitin/agent-compose
[API]: Scheduler list/stream 缺少统一排序、快照与终止语义
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 241
- Forks
- 45
- Avg merge
- 19h 10m
- Merged PRs (30d)
- 46
Description
拆自 #386。
现状
Scheduler runs/events 同时提供 list 和有限 stream，字段包含 cursor、checkpoint、complete、truncated、tail、limit、batch_size，但契约没有统一说明。
问题
客户端难以判断结果是否为同一快照、是否可能重复/遗漏、complete 与 truncated 如何组合、checkpoint 能否续传。
建议
定义稳定排序键、快照边界、checkpoint 生命周期、去重规则和终止状态，并让 list/stream 共享语义。
验收
- 排序与一致性有文档
- 续传无重复/遗漏测试
- complete/truncated 组合明确
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.
Research direction
Start by reading issue #386 and the existing Scheduler runs/events list and limited stream contracts, including cursor, checkpoint, complete, truncated, tail, limit, and batch_size. Done means the shared ordering, snapshot, checkpoint, deduplication, and termination semantics are documented, with tests showing continuation has no duplicates or omissions and clarifying complete/truncated combinations.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go
- Domain
- api, backend-api-design
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100