Skip to content

Commit 788d915

Browse files
committed
docs(rfc): retain roadmap overview and clarify execution cards
Signed-off-by: huangruiteng <huangrt01@163.com>
1 parent 35ef3ba commit 788d915

4 files changed

Lines changed: 34 additions & 5 deletions

‎docs/architecture/rfcs/shared-goal-authority-state-provider-v0.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2522,6 +2522,15 @@ one-way projections. Do not add a third TS-Markdown backend, bidirectional
25222522
live synchronization, or per-command split authority. Unsupported post-cutover
25232523
commands fail closed; they do not fall back to the old writer.
25242524

2525+
#### Refactoring roadmap overview
2526+
2527+
The original direction remains; execution cards expand these stages rather than cancel them:
2528+
2529+
1. **Close TS transactions and consumers.** Follow [T0–T3](typescript-control-plane-migration-v0.md#execution-cards-after-the-current-stack) to consolidate rules and delete duplicate decisions.
2530+
2. **Permanent projection closure.** D1 below retains Markdown as a long-lived one-way display, never a second business authority.
2531+
3. **One qualified local profile and fenced cutover.** D2/D3 require the real backend, capacity, soak and explicit promotion approval.
2532+
4. **Retirement with named callers.** T4 removes obsolete business writers after their callers exit; permanent rendering and required import/export remain.
2533+
25252534
#### Durability execution cards
25262535

25272536
Use the [TS execution cards](typescript-control-plane-migration-v0.md#execution-cards-after-the-current-stack)
@@ -2550,6 +2559,8 @@ source paths, authorize monitor writeback, or change provider/promotion holds.
25502559
Todo-section renderer and canonical journal/outbox. #4097 already recovers
25512560
missing Todo sections with `recovery_scope=todo_sections_only`; reuse it.
25522561
It cannot recover lost independent Goal narrative.
2562+
The shipped boundary is the [active-state projection contract](../../reference/protocols/active-state-structured-projection-v0.md).
2563+
Direct Markdown edits must not import themselves into authority; validated edit/import tooling is a separate proposal, never a second writer hidden inside rendering.
25532564
- Evaluate #4101's receipt-retention candidate against its actual merged head;
25542565
do not replace it with another delivery queue. A committed business result
25552566
and pending projection delivery must remain separately observable.

‎docs/architecture/rfcs/shared-goal-authority-state-provider-v0.zh-CN.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2000,6 +2000,15 @@ CLI / Agent / Dashboard → 唯一 TS Todo 事务 owner → canonical authority
20002000
供数;cutover 后,所选 canonical provider 向单向投影供数。不增加第三种 TS-Markdown
20012001
backend、实时双向同步或按命令拆开的权威;晋升后不支持的命令 fail closed,不能回退旧 writer。
20022002

2003+
#### 重构主线总览
2004+
2005+
以下规划保留原有方向;执行卡是它们的展开,不是替代或取消:
2006+
2007+
1. **闭合 TS 事务与 consumer。** 按 [T0–T3](typescript-control-plane-migration-v0.zh-CN.md#当前-stack-合入后的执行卡) 收口规则并删除重复决策。
2008+
2. **永久投影闭合。** 见下方 D1:Markdown 长期保留为单向展示,不恢复为业务权威。
2009+
3. **一个已资格化的本地 profile 与 fenced cutover。** 见 D2、D3:真实 backend、容量、soak 与显式 promotion 批准缺一不可。
2010+
4. **列明 caller 后退役。** 按 T4 删除无调用者的旧业务 writer;永久 renderer 和必要 import/export 保留。
2011+
20032012
#### 持久化执行卡
20042013

20052014
命令清单、update/monitor 事务和 consumer 删除统一按
@@ -2023,6 +2032,8 @@ summary,之前消费 legacy summary;真实 CLI 覆盖容量变化和 promote
20232032
- 从 `loopx/control_plane/todos/provider_projection.py`、既有 Todo-section renderer、
20242033
canonical journal/outbox 入手。复用 #4097 已有的缺失 Todo section 恢复及
20252034
`recovery_scope=todo_sections_only`;它不能恢复丢失的独立 Goal 正文。
2035+
已交付边界以 [active-state projection contract](../../reference/protocols/active-state-structured-projection-v0.md) 为准。
2036+
直接编辑 Markdown 不得自动导入 authority;显式验证的 edit/import 工具另提方案,不能隐藏在 renderer 中成为第二个 writer。
20262037
- 按 #4101 实际合入 head 评估 receipt-retention 候选,不再建一条 delivery queue。
20272038
业务已提交与投影尚 pending 必须分别可观测。
20282039
- 验证 crash/retry、并发 revision、缺失/陈旧/非法 display、交付前 receipt

‎docs/architecture/rfcs/typescript-control-plane-migration-v0.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,10 @@ label; no legacy prediction is retained without a concrete display consumer.
203203
Unknown refreshes interrupt statistics, not Todo/replan obligations; no new
204204
persistent delivery ledger is added. Surface-only supervision and the
205205
independent small-delivery rule remain unchanged.
206+
This exemption requires the parsed target identity and a supported task class;
207+
monitor baseline, capability and PR repository/number also bind to the current
208+
Todo. Missing actors or stale/mismatched conditions cannot relax supervision.
209+
Incomplete legacy conditions remain readable, but are not positive wait proof.
206210
- Legacy outcome-marker/hint configuration remains readable and preserves
207211
whether an outcome floor is configured. Its words no longer classify runs.
208212
No persisted history is rewritten and no new default-off flag restores the
@@ -310,9 +314,9 @@ is not a claim of zero behavior change or full Todo writer closure.
310314
#### Execution cards after the current stack
311315

312316
This is a **conditional execution plan**, not a merged-status declaration.
313-
At the 2026-09-09 checkpoint, #4053, #4117 and #4129 are merged; #4122
317+
At the 2026-09-09 checkpoint, #4053, #4117, #4129, #4122
314318
(resume diagnosis/planning), #4134 (delivery history) and #4136 (claim diagnosis)
315-
are open. The canonical delivery-response follow-up is stacked on #4136.
319+
are merged. The canonical delivery-response follow-up targets that landed main.
316320
Check their actual merge commits before starting. #4121 (SQLite candidate)
317321
and #4101 (projection receipt retention) are independent candidates, not
318322
implicit prerequisites or approved defaults.

‎docs/architecture/rfcs/typescript-control-plane-migration-v0.zh-CN.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,9 @@ classification 保留为历史标签;没有明确展示消费者时,不保
155155
无绑定的旧 blocker 标签不能建立该例外;其他可执行工作仍由 canonical planner
156156
选择。unknown 刷新中断统计,不清除 Todo/replan 义务,不新增持久化交付账本。
157157
连续表层交付监督与独立的小规模交付规则保持不变。
158+
该例外必须匹配解析后的 target identity 和合法 task class;monitor baseline、
159+
capability、PR repository/number 也绑定当前 Todo。缺失 actor 或陈旧/错配的
160+
condition 不能解除监督。旧式不完整条件仍可读取,但不构成正向等待证明。
158161
- 新交付声明通过现有 writer API 写显式 enum,例如
159162
`refresh-state --delivery-outcome ... --delivery-batch-scale ...`。
160163
纯状态刷新仍可不声明交付;本批不强迫每次刷新声明进展。既有写入 enum 校验、
@@ -239,9 +242,9 @@ generation fence、claim/exclusion、capacity 和 PR 等待语义保持。非法
239242

240243
#### 当前 stack 合入后的执行卡
241244

242-
这是**条件式执行规划**,不是已合并声明。2026-09-09 核查时,#4053、#4117、
243-
#4129 已合并;#4122(resume 诊断/规划)、#4134(交付历史)、#4136(声明诊断)
244-
仍 open;canonical delivery-response 后续批次叠在 #4136 上。执行前核验实际 merge
245+
这是**条件式执行规划**,不是所有阶段已完成的声明。2026-09-09 核查时,#4053、#4117、
246+
#4129、#4122(resume 诊断/规划)、#4134(交付历史)、#4136(声明诊断)均已合并;
247+
canonical delivery-response 后续批次基于这些已合入的 main。执行前核验实际 merge
245248
commit。#4121(SQLite 候选)和 #4101(投影 receipt 保留)是独立候选,不自动成为
246249
依赖或已批准的默认配置。
247250

0 commit comments

Comments
 (0)