Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
22 changes: 22 additions & 0 deletions docs/guides/context-delivery.md
Original file line number Diff line number Diff line change
Expand Up @@ -227,6 +227,28 @@ is not the raw authority response; a missing `should_run` is not a denial.
Do not change an experiment's frozen mode, source or clock by changing machine
settings. Trials retain their explicit configuration and original authority.

### Roll back to another runtime

To disable progressive or differential presentation, use the existing settings
on the current runtime. An older release may read fewer persisted formats.
Qualify the exact target on the affected Host and authority provider before
switching:

1. On isolated state, verify that the target reads the current Goal
requirements and the original capture. Include
[record-format outcomes](../reference/goal-acceptance-observations.md#long-horizon-record-storage)
when present. Reading a saved capture alone does not show that the target
can read current authority or finish its pending settlement.
2. Quiesce new admissions on the affected entrypoint. Retain the original
runtime, captures and receipts; reconcile in-flight Turns through that
runtime and their original identities.
3. Switch only to a target that can read the retained state and continue
work. Before reopening normal scheduling, check that new admission sees
the same requirements and that the earlier effects remain settled once.
If the target cannot read the current format, keep a compatible runtime
and use its presentation settings. Never restore an older authority
snapshot over committed requirements.

### Troubleshoot without changing task history

| Observation | Check next |
Expand Down
14 changes: 14 additions & 0 deletions docs/guides/context-delivery.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,20 @@ CLI 使用同一个 `context_delivery` 机器 namespace,详见
展示封装不是原始权威响应;封装中缺少 `should_run` 不表示拒绝准入。不能通过改机器
设置改变某个实验冻结的模式、来源或时钟;trial 保留原显式配置与权限。

### 回退到另一个运行时

只需关闭渐进或差分展示时,在当前运行时使用原有设置即可。旧版可能支持较少的
持久化格式;切换前,应在受影响的宿主和状态后端上验证确切的目标版本:

1. 在隔离状态上确认目标版本能读当前 Goal 的验收要求及原捕获。若已采用
[记录格式](../reference/goal-acceptance-observations.md#long-horizon-record-storage),
应覆盖该格式。能打开历史捕获,不说明它能读取当前权威状态或完成仍待结算的轮次。
2. 暂停受影响入口的新准入。保留原运行时、捕获和回执,用原运行时和原身份核对、
结清在途 Turn。
3. 只切换到可读保留状态且能继续工作的版本。恢复常规调度前,确认新准入仍看到原
验收要求,且此前效果只结算过一次。若目标版本不能读当前格式,就保留兼容运行时,
用它的设置关闭展示。不要用旧权威快照覆盖已提交的验收要求。

### 排障不改写任务历史

| 观察 | 下一检查 |
Expand Down
Loading