Skip to content

Commit a38d31c

Browse files
cocolordTRAE CLI
andcommitted
docs: record canonical claim conflict adoption in TS migration
Signed-off-by: lusendong.6789 <lusendong.6789@bytedance.com> Co-authored-by: TRAE CLI <traecli@bytedance.com>
1 parent 2761dc2 commit a38d31c

2 files changed

Lines changed: 14 additions & 0 deletions

File tree

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

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1151,6 +1151,18 @@ debit. This closes the demonstrated T3 consumer gap, not D1–D3, provider
11511151
promotion, or the remaining Python transaction adapters. See the
11521152
[operating contract](../../quota-allocation.md#receipt-backed-settlement-progress).
11531153

1154+
**Canonical claim contention.** The TS claim command now retries a conclusive
1155+
provider revision CAS rejection at most twice, using the same operation and
1156+
lease keys. Every attempt rereads the receipt and complete authority and
1157+
revalidates source registration, Todo eligibility, acceptance and lease scopes.
1158+
An explicit provider revision or transfer grant stays pinned; ambiguous writes
1159+
retain existing receipt recovery. Independent claims can both finish while
1160+
same-Todo or overlapping-scope claims still admit one owner. This adopts the
1161+
shared-authority conflict contract at the canonical writer; it does not reserve
1162+
recommendations, change local writer serialization, or qualify sustained
1163+
multi-host throughput. CLI claim callers inherit the behavior; no frontend or
1164+
Lark action contract changes.
1165+
11541166
**Long-history transport boundary.** Replan history still has one TS decision
11551167
owner. Small requests retain the inline codec; larger complete fact snapshots
11561168
travel through a private, digest-bound local file reference. The same reducer

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -838,6 +838,8 @@ T3/D1 reader,未完成全部 Todo writer、retention/compaction 或 promotion
838838

839839
配额准入与结算消费者现在从统一 Todo reader 读取完整来源,在显示压缩前解析显式 Todo 选择。它删除直接追加 Markdown 候选的路径,保留 promote 前的事件适配;promote 后权威为空或不可读都不能复活展示行。结算进度由现有 TS 回执链归约,Python 负责完整身份命令及 JSON/Markdown 展示。现有幂等 writer 可补齐缺失的 spend 回执而不再次扣款。这关闭已复现的 T3 消费者缺口,不代表 D1–D3、provider promotion 或剩余 Python 事务适配已完成。操作语义见[结算进度契约](../../quota-allocation.md#receipt-backed-settlement-progress)。
840840

841+
**Canonical claim 争抢。** TS claim 命令现在对明确的 provider revision CAS 拒绝最多重试两次,保持同一 operation 与 lease key;每次重新读取回执和完整权威,复核来源注册、Todo 资格、acceptance 和 lease 写范围。显式 provider revision 或 transfer grant 保持固定,写入结果不明确时沿用回执恢复。独立认领可以同时完成,同 Todo 或重叠写范围仍只接受一方。这让 canonical writer 采用 shared-authority 冲突契约,不预留推荐项、不改变本机 writer 串行化,也不证明持续多主机吞吐。CLI claim 调用方继承该行为,frontend/Lark 动作契约不变。
842+
841843
**长历史传输边界。** Replan 历史仍由一个 TS owner 决策。小请求保留 inline
842844
codec;较大的完整事实快照通过私有临时文件和摘要绑定的引用传递。同一 reducer
843845
校验全部记录、agent 作用域内的 ACK 及重试身份;RPC 预算和展示窗口都不允许截断

0 commit comments

Comments
 (0)