3.8 KiB
3.8 KiB
R0 Failure Semantics Baseline
Date: 2026-09-14
Scope: current V3.8 Python-exception behavior
Storage root: pytest tmp_path only
Isolation contract
すべてのfailure injectionは一時Run Storage rootで実施した。
real h3_continuum storage touched: NO
existing Take / revision touched: NO
user backend 8188 touched: NO
GPU used: NO
public workflow changed: NO
このbaselineは、catch可能なPython exceptionがRunStorageController.__exit__()へ到達する場合を記録する。OS強制終了、電源断、process killの挙動を成功扱いしない。
Results
| Injection point | Committed records after cleanup | Manifest status | Canonical pointer | Current observable behavior |
|---|---|---|---|---|
| before Sampling | 0 | interrupted |
none | errorを記録し、review pause metadataを除去 |
| after Sampling / before chunk commit | 0 | interrupted |
none | sampled resultは永続化されない |
| after first entry of terminal physical group | 1 | interrupted |
none | terminal pairの片側raw/recordがinterrupted revision内に見える |
| before manifest update (one-shot exception) | 1 | interrupted |
none | in-memory recordを__exit__()が再度manifestへ書き、interruptedとして回収 |
| after manifest update | 1 | interrupted |
none | committed recordを保持してinterrupted化 |
| before output projection | 1 | interrupted |
none | recordを保持してinterrupted化 |
| during output projection | 1 | interrupted |
none | recordを保持してinterrupted化 |
| before storage finalize | 1 | interrupted |
none | in-progress recordを保持してinterrupted化 |
before canonical pointer update (first _write_project) |
1 | interrupted |
none | finalize途中のmanifestをexception cleanupがinterruptedへ戻し、2回目のproject writeはcanonicalを設定しない |
Assertions are implemented in:
tests/test_runtime_redesign_r0_characterization.py
Current write ordering
commit_chunk()
validate one logical entry
→ write temporary safetensors
→ fsync temporary
→ os.replace to chunk_000N.safetensors
→ fsync chunks directory
→ construct one record
→ replace manifest chunks in memory
→ write manifest
この処理はphysical group単位ではなくlogical entry単位である。terminal merged pairでも、1件目commitと2件目commitの間に例外が起きる窓がある。
finalize()
validate committed prefix and Session length
→ set status / review metadata
→ write manifest
→ build branch provenance
→ write manifest again
→ write project with set_canonical=True
Python exceptionが上位のstorage scopeへ戻れば、__exit__()はstatusをinterruptedへ変更し、canonical指定なしでprojectを再書込する。
Process-crash limitations
このR0 testは、次を保証しない。
os.replace(raw)直後、manifest更新前にprocessが消失した場合のorphan raw回収- 既存
chunk_000N.safetensorsを上書き中にprocessが消失した場合の旧manifest/raw整合性 - terminal pairの両entryを不可分にpublishすること
- manifest provenance書込後、project canonical更新前にprocessが消失した場合の再起動時selection
これらはR5のprocess-crash consistency対象である。R0でwrite orderやschemaを変更していない。
R5-approved delta boundary
将来R5で許可される差分はV9どおり次に限定する。
- physical group全entryを先にvalidate
- immutable transaction raw filenames
- raw durabilityとSHA verification後にmanifestを1回でswitch
commit_group()はcanonical pointerを更新しない- canonical pointerはsuccessful finalize後だけ更新
Sampling結果、Session/State/Assembly、Review user-visible semantics、Run Storage v3 readabilityは変更しない。