用途
ae-things-progress 用于汇总工作空间内的事项进展，产出日报和周报。它从 aha-links 的事实采集与输出契约适配而来，先读取“事项操作”和 CLI reference，遵从一条基本分工：CLI 负责收事实，当前会话模型负责归纳，不调用独立的报告后台。
当涉及本轮绑定事项时，先遵循“执行快照与实时上下文”读取本次执行快照，再按流程采集最新审查或周期事实；两种来源需分开表述。没有绑定时，仅使用用户明确指定的范围。
主要能力
范围与时间
通过 ae-cli things +digest 采集，支持三种范围形式：
- 按空间与时间窗：
ae-cli things +digest --agent-space-id <space-id> --from 2026-09-07T00:00:00+08:00 --to 2026-09-14T00:00:00+08:00 --time-zone Asia/Shanghai --format json - 按负责人：
ae-cli things +digest --agent-space-id <space-id> --assignee-id <member-id> --format json - 按显式事项集合：
ae-cli things +digest --agent-space-id <space-id> --thing-ids <id-a>,<id-b> --format json
规则：不猜 ID、不使用个人默认空间；不支持关注清单、群或跨空间汇总。日报按自然日，周报按周一 00:00 到下周一 00:00，默认时区 Asia/Shanghai。今日／本周的截止点用当前时刻，昨日／上周用完整周期。自定义区间必须明确，命令的 from/to 都必须含时区，区间为左闭右开。
时区处理
输出时将记录的 ISO 时间转换为报告时区，并在时间窗、采集时间和证据日期旁明确标注时区。例如 2026-09-10T04:50:00Z 在 Asia/Shanghai 应展示为 2026-09-10 12:50（Asia/Shanghai），不能删除 Z 后直接写成“上海时间 04:50”。无法可靠转换时保留原始 ISO 并标注 UTC，披露尚未转换，不能伪造本地时刻。
证据与完整性
核对 fetchedCount、truncated、consistency、collectedAt；显式集合再核对 requestedCount 和 unreadable。字段缺失时停止生成全量结论。CLI 自动分页最多每链 100 页／10000 项，异常和上限会标记截断，不能换成单页 list 冒充完整采集。
概念区分：thing 是当前状态，entries 是时间窗内记录，baseline 是利用完整业务变更记录倒推的窗口前状态；没有基线或采集发生版本变化时不要补造。lastEffectiveRecordBeforeWindow 用于定位窗口前证据。当前状态不等于周期内变化，周期末状态也不能直接用当前状态代替。
输出前比较 collectedAt 与窗口 to。当 collectedAt < to（包括用户指定尚未结束的完整自然周）时，报告必须注明“截至采集时刻的阶段汇总，周期尚未结束”；三态统计标为“采集时状态”，禁止写“周期末状态”或“无后续更新”。例：9月10日采集9月7日至14日的周报，不能断言9月14日状态与当前相同。即使窗口已结束，也只有完整的窗口后变更证据支持时才能还原周期末状态。
统计与进展判定
open／paused／done 分别统计，归档另列；最新进展来自 thing.latestProgress，历史变化读取 progress/status 记录。备注和重复过程描述不算有效进展；effectiveProgressCount 是待核查候选，正文没有新信息时排除。没有记录只能说“未记录更新”，此约束同样适用于摘要和下一步建议；open 不能证明尚未开始，只能报告当前状态和未记录事实。附件未读、不可读取、截断及多次请求的非事务采集边界必须披露。changed_during_collection 时先重读；仍有变化则保留限制，不声称静态全量。
使用方式
先写范围、时间窗、采集时间及覆盖边界，再给三态和归档统计、周期变化、阻塞、下一步。每个重要判断附事项来源和日期，区分事实、推断与建议。不默认展示内部记录 ID。
默认只输出到会话。明确要求写回时：用 +detail 完整读取目标事项的报告记录，检查同范围同周期标题，再用以下命令写入最终正文：
ae-cli things entry append --id <target-id> --type note --title "事项周报｜起止日期｜范围" --stdin --command-id <uuid> --format json
建议标题为“事项周报｜起止日期｜范围”，日报同理。已有同范围同周期报告时提示修订，不静默覆盖或重复追加；用户明确要求追加修订后才写新记录，保留原报告。写回已授权无需再问同一许可。
适用场景
适合在指定空间、负责人或事项集合范围内生成周期性的进展汇总（日报、周报），并需要明确数据边界与时间口径的场合。
限制
- 不自动发送消息、修改状态、指派负责人或建立定时任务。
- 不支持关注清单、群或跨空间汇总。
- 文件证据方面，+detail/+digest 自动翻页收集资产关联，availability=missing 或 verification_failed 的文件不算可用交付；即使 available，也只代表引用可用，不代表已读取正文或验收通过，需披露未读文件及非事务采集边界。
- 私有会话来源只在当前用户有权时读取，报告引用共享事项事实，不能把私有历史自动公开。