docs(session): clarify bulk migration cache ownership
Name the JSONL backend and explain that its cache reuses recently decoded logs. This makes the bounded-batch rationale concrete without duplicating private implementation constant names in the operational description.
This commit is contained in:
1 parent
0e46c4ed26
commit
84659abe3d
3 files changed
+4
-4
No files matched your search
+2
-2
@@ -2,5 +2,5 @@
|
||||
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
||||
# after editing either side, bring the other along and re-record with:
|
||||
# pnpm run verify-translation-pairing --write .agents/notes/implemented/architecture/2026-08-31-released-session-format-migrations.md
|
||||
2026-08-31-released-session-format-migrations.md: 796697528a1c090aed373573063907a1653db645
|
||||
2026-08-31-released-session-format-migrations.zh.md: 447c115154abd84479c7f7dfaae9410df91bd674
|
||||
2026-08-31-released-session-format-migrations.md: 273b51ac7ce9c507c2322499788dc2084b857415
|
||||
2026-08-31-released-session-format-migrations.zh.md: 69132ec1763ad12b51480e150c3968aa1dcacf61
|
||||
+1
-1
@@ -105,7 +105,7 @@ Preparation forwards cancellation through source reads and observes it at the ex
|
||||
|
||||
The Stage pipeline ends at one prepared current artifact. [Historical Session read preparation](2026-09-05-read-only-session-migration-preparation.md) defines how read open consumes that artifact immediately while write open performs encode, verification, and publication before returning append access.
|
||||
|
||||
The bulk V4 migration command shares one persistence Context across a bounded job queue, retaining the provider’s existing two-Worker verification limit and small decoded-log cache. A child’s concurrent publication can change its parent’s selected child generation; the ordinary revision check refuses that attempt. The command defers only this source-change error for one sequential retry after the initial queue drains, collecting fresh evidence without relaxing publication checks or retrying unrelated failures.
|
||||
The bulk V4 migration command shares one JSONL persistence Context across a bounded job queue, retaining the backend’s two-Worker verification limit and cache for reusing recently decoded logs. A child’s concurrent publication can change its parent’s selected child generation; the ordinary revision check refuses that attempt. The command defers only this source-change error for one sequential retry after the initial queue drains, collecting fresh evidence without relaxing publication checks or retrying unrelated failures.
|
||||
|
||||
### Durable format and publication rules
|
||||
|
||||
|
||||
+1
-1
@@ -105,7 +105,7 @@ Preparation 会把 cancellation 传给 source read,并在现有的约 500 ms D
|
||||
|
||||
Stage pipeline 终止于一份 prepared current artifact。[历史 Session 只读迁移准备](2026-09-05-read-only-session-migration-preparation.zh.md)定义 read open 如何立即消费该 artifact,以及 write open 如何在返回 append 权限前完成 encode、verification 与 publication。
|
||||
|
||||
批量 V4 迁移命令在有界任务队列中共享一个 persistence Context,保留 provider 现有的双 Worker 校验上限和小型解码日志缓存。子 Session 并发发布可能改变父 Session 选中的子代际;普通修订检查会拒绝这次尝试。命令只把这种源变化错误延后到初始队列清空后串行重试一次,重新收集证据,不放宽发布检查,也不重试无关失败。
|
||||
批量 V4 迁移命令在有界任务队列中共享一个 JSONL persistence Context,保留 backend 的双 Worker 校验上限,以及复用近期已解码日志的缓存。子 Session 并发发布可能改变父 Session 选中的子代际;普通修订检查会拒绝这次尝试。命令只把这种源变化错误延后到初始队列清空后串行重试一次,重新收集证据,不放宽发布检查,也不重试无关失败。
|
||||
|
||||
### Durable format 与 publication 规则
|
||||
|
||||
|
||||
Reference in new issue
Block a user