Skip to content

docs(rfc): correct shipped missing-display recovery checkpoint #4119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
huangruiteng merged 1 commit into from
Sep 8, 2026
Merged

docs(rfc): correct shipped missing-display recovery checkpoint #4119

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2506,11 +2506,15 @@ The next complete stage packages are:
idempotent repair and freshness/readback evidence. Pending projection delivery
is independent of business commit/replay. Direct Markdown edits must never
import themselves into authority. Explicit validated edit/import tooling is
a separate proposal, not a second writer hidden inside rendering. Current
missing-file behavior remains pending, not silent recreation: a future
explicit rebuild must distinguish recoverable Todo sections from lost human
narrative. Validate stale/missing/malformed display, crash/retry, revision
races, narrative preservation and private-field boundaries.
a separate proposal, not a second writer hidden inside rendering. Missing
displays now automatically recover Todo-only sections from canonical state
during normal projection delivery
([#4097](https://github.com/huangruiteng/loopx/pull/4097)); recovery reports
`recovery_scope=todo_sections_only` and does not restore lost Goal narrative.
The [active-state projection contract](../../reference/protocols/active-state-structured-projection-v0.md)
defines the shipped recovery boundary. Validate stale/missing/malformed
display, crash/retry, revision races, narrative preservation and private-field
boundaries.
3. **One qualified local profile and fenced cutover.** Section 7.2's embedded
candidate must prove bounded head/index growth, historical receipts, crash
recovery, real CLI readback, capacity and >=10-day soak. File-v0 conformance
Expand Down
8 changes: 5 additions & 3 deletions docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1986,9 +1986,11 @@ backend、实时双向同步或按命令拆开的权威；晋升后不支持的
journal/outbox。保留非托管的人工叙述，从已知 canonical revision 渲染托管 section，
提供幂等修复与 freshness/readback 证据。投影 pending 独立于业务 commit/replay。
直接编辑 Markdown 不能自动导入 authority；显式验证的 edit/import 工具另提方案，
不能藏在 renderer 内成为第二个 writer。当前文件缺失仍保持 pending，不静默重建；
后续显式 rebuild 要区分可恢复 Todo section 与已丢失人工叙述。验证陈旧/缺失/非法
展示、crash/retry、revision race、叙述保留与私有字段边界。
不能藏在 renderer 内成为第二个 writer。缺失 display 现已在正常投影交付时自动从
canonical state 恢复 Todo-only section（[#4097](https://github.com/huangruiteng/loopx/pull/4097)）；
恢复结果声明 `recovery_scope=todo_sections_only`，不恢复丢失的完整 Goal 叙述。
已交付边界以 [active-state projection contract](../../reference/protocols/active-state-structured-projection-v0.md)
为准。验证陈旧/缺失/非法展示、crash/retry、revision race、叙述保留与私有字段边界。
3. **一个已资格化的本地 profile 与 fenced cutover。** 第 7.2 节嵌入式候选证明
head/index 增长有界、历史 receipt、crash recovery、真实 CLI readback、容量和
>=10 天 soak；file-v0 conformance 不能代替这些证据。绑定精确 lineage/revision/
Expand Down