릴리즈: 0.0.12 - 리플레이 경계 지문이 바뀌는 브레이킹 릴리즈

package.json과 lockfile을 0.0.12로 올리고 CHANGELOG의 Unreleased를 0.0.12 절로 연다.
README 두 판과 패키지 계약과 릴리즈 문서의 설치 핀을 같은 값으로 옮겼고, api 레퍼런스에
rebaseLinear·rebaseTo·boundaryEpoch를 0.0.12 표식과 함께 적었다.

이 릴리즈의 브레이킹은 하나로 모인다: 페이지 해시 믹서가 레인마다 사슬 둘로 갈라지면서
h0 값이 바뀐다. 옛 저널과 이미지는 PYPROC_REPLAY_MISMATCH로 명시 거부되고, 이관은
이전 버전에서 export 후 업그레이드 후 open이거나 forget이다(CHANGELOG에 동사까지 적었다).
함께 나가는 것: 체크포인트 노드의 희소 해시 저장, /home의 파일 단위 내용주소 커밋(옛 v1 팩은
계속 읽힌다), Web Machine IndexedDB 스키마 v3와 blob 크기 색인, 선형 역사에서 메모리 한계가
실제로 걸리게 하는 rebaseLinear(기본 꺼짐).

CHANGELOG 정정도 함께 한다: /home 항목이 이미 게시된 0.0.11 절에 잘못 들어가 있었다.
줄 끝이 CRLF와 LF로 섞여 앵커 탐색이 어긋난 것이 원인이라 파일 전체를 CRLF로 통일했다.

검증: npm test 3364 passed 0 failed, test:browser 129/129, test:installed 37/37,
test:golden 8/8, test:types 0, test:package ok, test:contracts 7 suites.

Author: eddmpython

CHANGELOG.md

@@ -8,6 +8,12 @@ happen only on an explicit maintainer decision; the Unreleased section accumulat
 
 ## Unreleased
 
+<!-- unreleased-subpaths: -->
+소비자가 핀한 버전에 아직 없는 subpath 목록이다(위 주석이 기계 판독 정본). 출하 문서가 이 이름을
+예시로 쓰면 미출하 표식이 함께 있어야 하고, tests/contracts/publicSurface.mjs가 그것을 문다.
+
+## 0.0.12 - 2026-08-03
+
 ### Breaking
 
 - **The page-hash mixer splits each lane into two accumulator chains, so the replay boundary
@@ -31,6 +37,18 @@ happen only on an explicit maintainer decision; the Unreleased section accumulat
 
 ### Changed
 
+- **`/home` is committed as one content-addressed blob per file.** It used to be concatenated into a
+  single pack, so one changed byte in one file changed the pack's address and the whole tree was
+  re-read, re-hashed, and re-written on every commit. Now an unchanged file is already in the store
+  and costs no write at all: a commit that changed nothing under `/home` writes zero home blobs, and
+  a commit that changed one file writes one. `journal.commit()` reports that as `home.wrote`, which
+  is now a count rather than a boolean.
+
+  Older generations keep working - the v1 pack layout is still read, so upgrading does not lose a
+  journal or an image. The **new** layout is not readable by older pyproc versions, so a
+  `.pymachine` file exported after this change must be opened with this version or later; an older
+  reader refuses it with `PYPROC_MACHINE_FORMAT_INVALID` rather than restoring a partial tree.
+
 - **The Web Machine IndexedDB schema is now version 3, with a blob size index.** Asking how much a
   store holds - `inspectStorage()`, and every recovery-window plan - used to require deserializing
   every blob value just to read its length, so the question cost a full read of the database. Sizes
@@ -76,9 +94,7 @@ happen only on an explicit maintainer decision; the Unreleased section accumulat
   started by `history.watch()`, so the interval no longer holds the runtime and the reactive
   controller for the life of the tab.
 
-<!-- unreleased-subpaths: -->
-소비자가 핀한 버전에 아직 없는 subpath 목록이다(위 주석이 기계 판독 정본). 출하 문서가 이 이름을
-예시로 쓰면 미출하 표식이 함께 있어야 하고, tests/contracts/publicSurface.mjs가 그것을 문다.
+한국어 요약: 리플레이 경계 지문(h0)이 바뀌는 브레이킹 릴리즈다. 페이지 해시 믹서가 레인마다 사슬 둘로 갈라지고, 체크포인트 노드는 바뀐 페이지의 해시만 담고, `/home`은 파일마다 내용주소 blob 하나로 커밋되고, Web Machine IndexedDB는 스키마 v3에 blob 크기 색인을 갖는다. 옛 저널과 이미지는 `PYPROC_REPLAY_MISMATCH`로 명시 거부되므로, 지키려는 상태는 이전 버전에서 `history.export()`로 내보낸 뒤 업그레이드하고 `open()`한다. 크래시 복구 캐시일 뿐인 저널은 `history.forget()`으로 버린다. `setRetentionPolicy({ rebaseLinear: true })`는 선형 역사에서 메모리 한계가 실제로 걸리게 하는 새 옵션이고, 경계를 옮기는 대가 때문에 기본값은 꺼짐이다.
 
 ## 0.0.11 - 2026-08-02
 
@@ -125,19 +141,6 @@ Users upgrading directly from 0.0.9 must also apply the 0.0.10 migration from ro
 
 ### Changed
 
-- **`/home` is committed as one content-addressed blob per file.** It used to be concatenated into a
-  single pack, so one changed byte in one file changed the pack's address and the whole tree was
-  re-read, re-hashed, and re-written on every commit. Now an unchanged file is already in the store
-  and costs no write at all: a commit that changed nothing under `/home` writes zero home blobs, and
-  a commit that changed one file writes one. `journal.commit()` reports that as `home.wrote`, which
-  is now a count rather than a boolean.
-
-  Older generations keep working - the v1 pack layout is still read, so upgrading does not lose a
-  journal or an image. The **new** layout is not readable by older pyproc versions, so a
-  `.pymachine` file exported after this change must be opened with this version or later; an older
-  reader refuses it with `PYPROC_MACHINE_FORMAT_INVALID` rather than restoring a partial tree.
-
-
 - Durable RPC now has one normative retry boundary. A direct durable controller may resend the same
   request id once only when it can prove a proxy-free session. A normal follower, a live timeout,
   a vanished caller, or an unportable heap returns non-retryable `PYPROC_RPC_OUTCOME_UNKNOWN`

README.ko.md

@@ -153,7 +153,7 @@ fail-closed network policy를 적용하면 선택한 데이터도 code 실행 
 ## 빠른 시작
 
 ```sh
-npm install pyproc@0.0.11 --save-exact
+npm install pyproc@0.0.12 --save-exact
 npx pyproc-engine --out public/vendor/pyodide
 ```
 
@@ -484,11 +484,11 @@ export default { server: { headers: {
 
 ## 설치와 핀
 
-npm([npmjs.com/package/pyproc](https://www.npmjs.com/package/pyproc)): `npm install pyproc@0.0.11 --save-exact`. 빌드 단계는 없다(네이티브 ESM). 플로팅 범위(`^`, `~`, `latest`)는 지원하지 않는다. 상태 커널의 replay 보장은 버전에 묶여 있다:
+npm([npmjs.com/package/pyproc](https://www.npmjs.com/package/pyproc)): `npm install pyproc@0.0.12 --save-exact`. 빌드 단계는 없다(네이티브 ESM). 플로팅 범위(`^`, `~`, `latest`)는 지원하지 않는다. 상태 커널의 replay 보장은 버전에 묶여 있다:
 
 ```jsonc
 // package.json
-"dependencies": { "pyproc": "0.0.11" }
+"dependencies": { "pyproc": "0.0.12" }
 ```
 
 `pyproc/runtime`과 typed API subpath 항목은 0.0.11에 출하된다. 아직 릴리즈하지 않은 커밋을

README.md

@@ -153,7 +153,7 @@ restored. A fail-closed network policy can also keep selected data local while c
 ## Quick start
 
 ```sh
-npm install pyproc@0.0.11 --save-exact
+npm install pyproc@0.0.12 --save-exact
 npx pyproc-engine --out public/vendor/pyodide
 ```
 
@@ -485,11 +485,11 @@ Can't set headers at all (e.g. GitHub Pages)? Register `pyprocSw.js?coi=1` and r
 
 ## Install and pinning
 
-From npm ([npmjs.com/package/pyproc](https://www.npmjs.com/package/pyproc)): `npm install pyproc@0.0.11 --save-exact`. There is no build step (native ESM). Floating ranges (`^`, `~`, `latest`) are not supported because a state kernel's replay guarantee is version-bound:
+From npm ([npmjs.com/package/pyproc](https://www.npmjs.com/package/pyproc)): `npm install pyproc@0.0.12 --save-exact`. There is no build step (native ESM). Floating ranges (`^`, `~`, `latest`) are not supported because a state kernel's replay guarantee is version-bound:
 
 ```jsonc
 // package.json
-"dependencies": { "pyproc": "0.0.11" }
+"dependencies": { "pyproc": "0.0.12" }
 ```
 
 `pyproc/runtime` and the typed API subpath entries ship in 0.0.11. A SHA pin

docs/operations/release.md

@@ -30,7 +30,7 @@
 
 ## 설치 재현성
 
-- 공식 설치 예제는 **npm 정확 버전**을 사용한다: `"pyproc": "0.0.11"`(+ 락파일). 플로팅(`^`/`~`/`latest`)은 재현 가능한 제품 입구가 아니므로 문서에 두지 않는다.
+- 공식 설치 예제는 **npm 정확 버전**을 사용한다: `"pyproc": "0.0.12"`(+ 락파일). 플로팅(`^`/`~`/`latest`)은 재현 가능한 제품 입구가 아니므로 문서에 두지 않는다.
 - 새 버전은 pyproc tarball 자체에서 npm 해석, 타입 검사, 워커 emit, 브라우저 부팅을 모두 통과해야 한다.
 - 버전이나 태그는 북극성 점수의 증거가 아니다. 제품 능력은 저장소의 실행 계약과 실패 게이트로만 판정한다.
 

docs/reference/api.md

@@ -171,8 +171,14 @@ Volatile verbs:
 - `stats()` reports exact controller-owned base/delta/hash bytes, node/branch counts,
   live depth, and the last pressure event.
 - `setRetentionPolicy(policy)` sets observable budgets (`maxNodes`, `maxDeltaBytes`,
-  `maxTotalBytes`). `pruneBranches: true` may remove only off-live-path branches;
-  the live path is never silently dropped or rebased.
+  `maxTotalBytes`). `pruneBranches: true` may remove only off-live-path branches, so a
+  linear history - the shape a per-statement checkpoint produces - gets nothing back from
+  it. `rebaseLinear: true` folds the live path into the base instead, which is what makes
+  a budget hold there. It is off by default because folding moves the replay boundary:
+  a journal or image written against the old one is refused with `PYPROC_REPLAY_MISMATCH`,
+  and time travel before the new boundary with `PYPROC_CHECKPOINT_PRUNED`. Available from
+  0.0.12, along with `rebaseTo(j)` for folding explicitly and `boundaryEpoch`, which counts
+  boundary moves so a consumer caching the fingerprint can drop its cache.
 
 Durable verbs (all take `{ dir }`, a `FileSystemDirectoryHandle`; the same `dir` shares
 one journal instance):

docs/usage/contract.md

@@ -14,7 +14,7 @@ The roles are split.
 ```jsonc
 // package.json
 "dependencies": {
-  "pyproc": "0.0.11"
+  "pyproc": "0.0.12"
 }
 ```
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "pyproc",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "A persistent Python computer in the browser: real CPython, durable workspaces, processes, rewindable history, and signed machine images. No application server. (브라우저에 영속하는 Python 컴퓨터.)",
   "type": "module",
   "repository": {