Changelist / 2026-06-02

本次补充交付（2026-06-02 14:25 UTC）

目标

在当前长时间 build-index 尚未结束前，先把可重启、可续跑、可判断阶段切换的交付包固化下来。

本次纳入交付的内容

类别	内容
代码	chromaprint 峰值扫描等价优化；建索引进度可观测化
证据	/tmp/chroma_index_observable_smoke/chromaprint_progress.json live checkpoint
文档	CHANGELOG、changelist、delivery handoff、session handoff、AGENT memory
交接	明确旧 FMA 进程与新 observable 进程的区别

文件级变更

文件	说明
./CHANGELOG.md	补记本次 restart package 交付
./delivery-handoff-2026-06-02.md	重写为当前最短接管包
./session-handoff.md	顶部快照切到 bc6d07a + observable chromaprint
../AGENT.md	更新长期记忆，避免新 session 误判当前阶段

当前最重要的 fresh evidence

• 远程基线：bc6d07afbd1e31d3956d20e35c20c424bc21ba99
• 观测时间：2026-06-02 14:25:32 UTC
• 观测对象：/tmp/chroma_index_observable_smoke/chromaprint_progress.json
• 状态：
  • status=building
  • refs_done=1740/8000
  • elapsed_sec=1385.4
  • eta_sec=4984.254
  • hashes=229127
  • postings=1510952
• 已确认：新代码路径会持续写出 chromaprint_progress.json 与 chromaprint.pkl
• 未确认：reference_*、evaluate.py、最终 report

重要决策

1. 现在不再重复记录每一次 refs_done 的线性增长。
2. 下一个值得再次提交的节点只应是：
   • chromaprint 完成
   • reference_* 文件出现
   • evaluate.py 启动
   • 或明确失败
3. 旧的 PID=424691 只作为背景运行态，不作为新 observability 改动验证。

重启后的直接待办

1. 查看 ./session-handoff.md
2. 检查 PID=431703 是否仍在运行
3. 监控 /tmp/chroma_index_observable_smoke/
4. 出现阶段切换后，再回写文档并提交推送