Merge remote-tracking branch 'origin/master' into worktree/pr2177-export-fixes-20260811

# Conflicts:
#	docs/config-catalog.i18n.yaml
#	docs/subsystems/persistence.i18n.yaml
#	packages/session/session-persistence-jsonl/README.i18n.yaml
#	packages/session/session-persistence/README.i18n.yaml

packages/session/session-persistence-jsonl/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/session/session-persistence-jsonl/README.md
-README.md: 540ddb6db67adb1a36c8feea946b6843e614e035
+README.md: 4cff3215cdb083d2fdb7c4a8f1b60e8c4028ba84
 README.zh.md: 7e3ba5be4f2707ff6408d296ece1f43550d76286

packages/session/session-persistence-jsonl/README.md

@@ -72,6 +72,6 @@ JSONL storage does not mutate live request prefixes. A resumed loop can reuse pr
 - **Only the configured encoding and current `SESSION_FORMAT_VERSION` (v0) load** — changing compression requires a separate/fresh root or selecting the legacy raw mode; the pre-release format has no migration.
 - **The flat-file storage layout does not load** — use a separate root or move pre-release artifacts into the project/session directory layout before loading.
 - **Compressed files are not directly line-readable** — use the backend to load them, or select `compression: 'none'` before writing a fresh root when external line readers are required.
-- **Nothing deletes session files** — logs accumulate under `root` until removed externally (the seam has no deletion surface).
+- **Nothing deletes session files** — logs accumulate under `root` until removed externally (the seam has no deletion API).
 - **One live writer per session** — append and repair are coordinated only inside the owning backend instance. Another backend instance or process must not write the same session until that owner reaches quiescent disposal; initial same-id publication remains collision-safe through the POSIX no-overwrite hard link or Windows write-through rename without replacement.
 - **POSIX materialization requires hard-link support** — first append uses `link()` so same-id races fail instead of overwriting a committed log; Windows uses write-through rename without replacement.

packages/session/session-persistence-jsonl/src/index.ts

@@ -163,10 +163,10 @@ export class SessionPersistenceJsonl extends SessionPersistence implements Persi
     })
   }
 
-  // Each backend keeps the typed service surface beside its storage hooks;
+  // Each backend keeps the typed service API beside its storage hooks;
   // extracting these trivial forwards would add an inheritance layer.
   /* jscpd:ignore-start */
-  // --- SessionPersistence service surface (delegated to the coordinator) ---
+  // --- SessionPersistence service API (delegated to the coordinator) ---
 
   /** Resolve the absolute target path without touching the filesystem. */
   locate(meta: SessionHeader): SessionLocation {

packages/session/session-persistence-jsonl/src/win32.ts

@@ -38,7 +38,7 @@ const ERROR_ALREADY_EXISTS = 183
 
 let bindings: Win32Bindings | undefined
 
-/** Load the small Win32 surface lazily so non-Windows processes never load Koffi. */
+/** Load the small Win32 API lazily so non-Windows processes never load Koffi. */
 async function win32(): Promise<Win32Bindings> {
   if (bindings !== undefined) return bindings
   const koffi = (await import('koffi')).default