stroid 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -7,23 +7,112 @@
 
 ---
 
->[!NOTE]
+>[!WARNING]
 ><details open>
-><summary><strong> Unreleased </strong></summary>
-></details>
+><summary><strong>0.1.5 --> 2026-04-09</strong></summary>
+>
+>### Add
+>
+>- Added an optional fourth `hydrateStores(..., options, trust, consistency?)` argument for post-hydration consistency contracts, including snapshot metadata, per-store authorities, per-store reconciliation policies, and `onDrift` diagnostics.
+>- Added large-payload hydration parity coverage plus a dedicated `benchmark:hydration-large-payload` script to measure clone cost, queued replay cost, and retained heap across multi-hundred-KB to multi-MB state sizes.
+>- Added hydration boot-window write deferral with deterministic replay for early `effect`, `storage`, `network`, and `sync` writes, plus policy execution for `server_wins`, `client_wins`, `merge`, and `invalidate_and_refetch`.
+>- Added manual hydration boot-window control through `HydrationResult.bootWindow`, including `bootWindow: { mode: "manual" }`, optional `fallbackMs`, and runtime metrics that expose whether manual close is available.
+>- Added `stroid/runtime-tools` hydration observability helpers: `getHydrationConsistency()`, `getHydrationDriftEvents()`, and `getHydrationDriftMetrics()`.
+>- Added `stroid/server/portable` for explicit request-scope hand-off across serverless and framework boundaries, including `createRequestScope(...)`, capture/resume coverage, and a local provider-model certification for AWS Lambda, Vercel render-to-action hand-off, and Cloudflare Workers-style isolates.
+>- Added request-bound callback helpers for server runtimes: `createStoreForRequest(...).bind(...)` and `createRequestScope(...).bind(...)`, so pre-bound async callbacks can re-enter captured request registry/carrier context deterministically.
+>- Added React 18 concurrency certification for `useStore(...)`, including no-tearing regression coverage under `useTransition` and `useDeferredValue`, plus a dedicated `benchmark:react-concurrency` script that validates the existing `useSyncExternalStore` hook path.
+>- Added a concrete Next.js App Router render-to-server-action hand-off example, regression coverage, and `benchmark:next-server-actions`, so request-scoped state capture and resume is now documented and locally certified instead of only described as a manual boundary.
+>- Added a dedicated `stroid/query` entrypoint for `reactQueryKey` and `swrKey`, so cache-key helpers can be imported without pulling the heavier async query fetcher surface.
+>- Added SSR async-context benchmark commands `benchmark:ssr-als-audit` and `benchmark:ssr-gaps`, plus seeded report outputs under `scripts/benchmark-results/ssr/` for replayable audit runs.
+>
+>### Change
+>
+>- Reduced cold and write-path overhead by lazily short-circuiting feature lifecycle dispatch when no registered runtime hooks apply to a store, avoiding unnecessary per-store context allocation on `createStore(...)` and `setStore(...)`.
+>- Added an internal large-snapshot hydration gate: when consistency mode is enabled and no explicit boot window is provided, payloads above ~256KB now use a short timer boot-window path so early writes can route through the existing hydration queue.
+>- Added request-scope carrier memoization during SSR hydration runs to reduce repeated AsyncLocalStorage lookups for carrier access inside the same request boundary.
+>- Hardened `createStoreForRequest().hydrate(...)` to scrub finished carrier state after snapshot sync, then added detached-continuation regression coverage and a warm-container SSR certification benchmark for sequential request reuse.
+>- Hardened hydration reconciliation so throwing custom `merge(...)` or normalization callbacks now fall back safely to the hydrated baseline, then added randomized replay certification coverage and a dedicated `benchmark:hydration-randomized` script.
+>- Hardened hydration replay ordering by draining deferred writes through their monotonic enqueue sequence, then added long-lived websocket/sync stream regression coverage plus `benchmark:websocket-stream` to certify pre-close queueing and post-close continuation order.
+>- Hardened integration, regression, and public type coverage for post-hydration drift governance, including early effect input, stale storage restore ordering, websocket/sync burst replay, and invalidation-driven async refetch recovery.
+>- Upgraded `benchmark:hydration-divergence` into a first-class hydration guarantee suite with `try`, `hit`, `stress`, and `hammer` campaigns under the manual-close boundary, and folded that certification into `benchmark:guarantees`.
+>- Reduced `stroid/persist` import retention by routing the leaf entrypoint to the direct feature installer, and regrouped `runtime-tools` internals plus query-key helpers for narrower future tree-shaking work.
+>- Removed the dead `computed-types` JavaScript build entry and added `module` plus explicit `./query` export metadata for bundler compatibility.
+>- Removed incorrect `sideEffects` metadata that pointed at unpublished source paths; the package now stays conservative until the remaining import-time effects are isolated explicitly.
+>- Added computed topo-order memoization with graph-version invalidation so unchanged computed graphs no longer re-run dependency ordering on every flush.
+>- Added async slot indexing and incremental prune cadence, reducing repeated full-map scans in `pruneAsyncCache`, `clearAsyncMeta`, and inflight slot counting paths.
+>- Added `getAsyncMetrics(name?)` per-store reporting while preserving the existing global aggregate metrics shape.
+>- Added configurable `resetStore` clone strategy (`deep` / `shallow` / `none`) via per-store `resetClone` and global `configureStroid({ resetCloneMode })`.
+>- Reorganized stress benchmark runner scripts under `scripts/core/` and updated benchmark npm commands accordingly.
+>- Reorganized benchmark scripts by domain under `scripts/core`, `scripts/ssr`, `scripts/hydration`, `scripts/react`, `scripts/guarantees`, and `scripts/comparison`, then updated benchmark command wiring.
+>- Added manual `workflow_dispatch` support to the Scorecard workflow so code-scanning and supply-chain checks can be re-run on demand after hardening changes.
+>
+>### Fix
+>
+>- Fixed `runtime-admin.clearAllStores()` so it now honors the same `setStoreBatch` transaction guard as the core admin path, preventing destructive clears and cache resets from executing inside active batches.
+>- Fixed store delete/clear teardown so hydration consistency metadata and deferred hydration writes are purged per deleted store, preventing stale post-clear replay against recreated stores.
+>- Hardened `hydrateStores(..., trust.validate)` so Promise-returning async validators are rejected explicitly instead of being coerced to truthy values, preventing silent untrusted hydration.
+>- Replaced flaky/false-positive regressions with deterministic assertions (`computed-cycle`, `selector-cache-growth`, `async-flush-ordering`, and concurrent batch ordering), and added targeted coverage for URL-string `fetchStore(...)` resolution after `deleteStore(...)` plus concurrent same-key `hydrateStores(...)` races.
+>- Hardened structural-sharing coverage to certify large non-Immer path writes keep untouched branch references stable while updating only the targeted branch.
+>- Added stricter performance guardrails for notification flush timing (warmup + median threshold), warning-set cleanup growth across delete/recreate churn, and GC-backed create/delete heap baseline checks.
+>- Added an explicit `storeDeleteCleanup` lifecycle phase in the delete path so async cleanup handlers run in a dedicated teardown stage before `afterStoreDelete`, then added regression coverage for cleanup ordering and immediate async metadata removal.
+>- Fixed async deletion hardening for caller-provided `AbortSignal`: `deleteStore()` now aborts in-flight `fetchStore(...)` requests even when callers supply their own signal, preventing hung network work after store teardown and clearing async metadata deterministically.
+>- Hardened `subscribeStore(...)` unsubscription semantics with an idempotent guard so duplicate unsubscribe calls detach exactly once, including when other subscribers keep the store listener set alive.
+>- Added concurrent async store churn regression coverage that races create/fetch/delete across many stores and asserts no post-delete resurrection or hanging in-flight requests.
+>- Hardened production snapshot delivery safety for `snapshot: "ref"` / `"shallow"` by enforcing a shallow-frozen snapshot envelope across environments and applying `snapshotSafety` mutation handling beyond dev-only checks.
+>- Added production-only regression coverage proving ref-snapshot mutation attempts now warn and preserve committed store state during subscriber delivery.
+>- Added adversarial notification reentrancy stress regressions that force unbounded inline feedback loops through the safety-pass guard and certify runtime recovery plus queue cleanup after teardown.
+>- Added a `bench:stress` notification reentrancy benchmark track (`notify_reentrant_cycle_250`) to track bounded cyclic fanout performance under hostile subscriber write patterns.
+>- Fixed chunked notification delivery context in request-scoped runtimes so continuation slices now execute under the same registry as the originating flush, preventing subscriber writes from escaping to the global registry.
+>- Fixed `createStoreForRequest().hydrate(...)` finalization so queued notification side effects are drained before request snapshot sync, ensuring `snapshot()` includes subscriber-driven writes from the same hydrate pass.
+>- Added regression coverage for portable chunk-continuation registry continuity and request-snapshot coherence after chunked subscriber side effects (sync and delayed async chunk paths).
+>- Fixed root API report surface by exporting previously leaked public dependency types (computed/store/hydration/config/runtime option helpers), removing `ae-forgotten-export` warnings from `docs/api/stroid.api.md`.
+>- Fixed root TypeScript config scope so `tsc -p tsconfig.json --noEmit` now validates the source runtime surface directly instead of traversing docs/test/example-only graphs that require separate tooling configs.
+>- Fixed store-destroy teardown so deleted stores now clear pending notify queue references and drop cached feature-hook contexts immediately, preventing long-run subscriber/context retention across create/delete churn.
+>- Fixed `resetStore()` so it now returns `reason: "no-initial-state"` when a store exists but its reset snapshot is missing, instead of collapsing that branch into `not-found`.
+>- Fixed workflow hardening gaps flagged by code scanning: added explicit top-level token permissions where missing and pinned GitHub Actions to immutable commit SHAs.
+>- Fixed STATUS commit validation for Dependabot updates by accepting the bot-generated optional `(deps)` / `(deps-dev)` scope suffix while preserving STATUS-code enforcement.
+>- Fixed `getAsyncMetrics(...)` public typings so `getAsyncMetrics()` remains non-null while `getAsyncMetrics(name)` is correctly typed as nullable per-store lookup.
+>- Fixed SSR isolation benchmark request stability by retrying transient loopback `fetch` failures in the React streaming HTTP certification phase.
+>- Fixed integration/regression harness imports to follow the new benchmark shared-helper locations after script folder reorganization.
+>- Fixed request-scope carrier fallback behavior so active registry reads do not incorrectly fall back to unrelated AsyncLocalStorage state, preventing render/action cross-context drift under concurrent SSR workloads.
+>- Fixed portable request-scope async lifecycle tracking so `createRequestScope(...).run(async ...)` keeps `scope.bind(...)` callbacks registry-bound until the run promise settles.
+>- Fixed request-bound callback safety so `createStoreForRequest(...).bind(...)` and `createRequestScope(...).bind(...)` no longer silently execute against the global registry outside active request lifecycles; they now fail fast with explicit lifecycle-bound errors and include regression coverage.
+>- Fixed `createStoreForRequest(...).bind(...)` carrier routing so bound callbacks now use the registry-owned active carrier instead of ambient AsyncLocalStorage fallback, preventing cross-request callback corruption and detached stale-carrier writes under concurrent SSR overlap.
+>- Fixed `createStoreForRequest(...).capture()` carrier selection so request capture now reads only the registry-owned active carrier, preventing cross-request snapshot contamination during concurrent hydrate overlap and non-ALS callback capture paths.
+>- Fixed SSR gap probe flakiness by introducing per-request probe barriers before hydrate completion, removing lost-probe races at high concurrency sizes.
+>
+>### Docs
 >
+>- Added a dedicated Post-Hydration Consistency guide with adoption defaults and updated the README, server guide, runtime-tools guide, benchmark report, version migration guide, and `NEXT_PHASE.md` status note to reflect the shipped consistency layer.
+>- Added bundle-sensitive import guidance and bundle-closure benchmark notes to the README and docs, including the new `stroid/query` path, the measurable `stroid/persist` win, and the current root-entry limitations.
+>- Documented runtime caveats for validated store names, direct-Promise async fetches, BroadcastChannel startup/BFCache limits, and Safari/WebKit storage eviction in the README and guides.
+>- Added `STATUS.md` so the commit and issue-close workflow referenced by `CONTRIBUTING.md` is now present in the repository.
+>- Documented async metrics per-store reads and reset clone-mode controls in README and guide docs.
+>- Added seeded SSR ladder/gap benchmark report notes to `docs/STROID/BENCHMARK.md` and documented SSR benchmark regression-gate coverage in `docs/STROID/GITHUB_ACTION.md`.
+></details>
+
 
 ---
 >[!WARNING]
 ><details >
 ><summary><strong>0.1.4 --> 2026-3-30 </strong></summary>
-
+>
+>### Breaking
+>
+>- None.
+>
+>### Add
+>
+>- None.
+>
+>### Fix
+>
 >- Fixed async persist hydration so Promise-returning `persist.driver.getItem()` now loads stored state even when crypto hooks and checksums stay synchronous.
 >- Fixed persist hydration payload guards so falsy serialized values (`""`, `"0"`, `"false"`) now hydrate correctly instead of being treated as missing data.
 >- Fixed async persist clear detection so `onStorageCleared` now resolves Promise-based drivers instead of treating every pending read as "present".
 >- Fixed focus revalidation cleanup so queued staggered and batched refetch timers are cancelled when the returned cleanup runs.
 >- Fixed async inflight dedupe contracts so raw callers no longer inherit another caller's transformed result for the same cache slot.
->- Fixed computed identity checks so stable object outputs no longer trigger redundant `replaceStore()` writes during dependency >recompute or `hydrateStores()` recompute.
+>- Fixed computed identity checks so stable object outputs no longer trigger redundant `replaceStore()` writes during dependency recompute or `hydrateStores()` recompute.
 >- Fixed request-scoped selectors so `createSelector(...)` now reads carrier-backed state during `createStoreForRequest().hydrate(...)`.
 >- Fixed `resetStore()` in request scope so `onReset(prev)` receives the live pre-reset value instead of the registry placeholder.
 >- Fixed `deleteStore()` in request scope so `onDelete(prev)` receives the live pre-delete value.
@@ -39,31 +128,45 @@
 ><details>
 ><summary><strong>0.1.4-beta.0 --> 2026-03-23</strong></summary>
 >
->- Fixed the published ESM package layout so `stroid`, `stroid/psr`, and sibling entrypoints share one runtime registry/computed graph instead of shipping isolated bundled state.
->- Hardened public PSR package-level contract coverage to verify built `dist` entrypoints can detect, read, subscribe to, and patch stores created through the main `stroid` entrypoint.
->- Tightened public PSR patch rejection semantics with stable `unsupported-op` and `unsupported-path-shape` reason codes for unsupported patch forms.
->- Expanded the public PSR patch surface to support nested `merge`, `delete`, and `insert`, with canonical path-array behavior and `failedPatchId` reporting for both single and atomic failures.
+>### Breaking
+>
+>- Breaking: changed `stroid/persist`, `stroid/sync`, and `stroid/devtools` to side-effect-free modules that export explicit installers (`installPersist`, `installSync`, `installDevtools`) instead of auto-registering on import.
+>
+>### Add
+>
 >- Added `stroid/psr` as a dedicated native PSR contract entrypoint with committed-only no-track snapshot reads, observation helpers, and explicit timing-contract reporting.
 >- Added a canonical `RuntimePatch` model under the PSR surface and lowered `setStore`, `replaceStore`, `resetStore`, and `hydrateStores` into serializable runtime patch records internally.
 >- Added public PSR patch-write APIs via `applyStorePatch()` and `applyStorePatchesAtomic()` for canonical `set` and root-level `merge` patches.
->- Hardened transaction commit semantics so failed batched commits roll back staged store state, reset metrics, and queued notifications, while commit-phase feature hook errors no longer break atomic batches.
 >- Added computed classification descriptors plus snapshot evaluation APIs for Phase 5 PSR-native integration, defaulting unclassified computeds to `opaque` so only explicitly deterministic nodes are simulated.
+>- Added a Phase 8 faithfulness suite that locks preview-vs-commit equivalence for deterministic public PSR flows, verifies public atomic rollback visibility rules, exercises async-boundary stop conditions, and smoke-tests production usage from only public entrypoints.
+>- Added a 250K unique-subscriber benchmark, a 250K concurrent subscriber benchmark with real-world multi-store fanout scenarios, and lean performance-suite coverage for concurrent subscriber and sync broadcast timing; refreshed benchmark harnesses to use explicit feature installers and truly unique subscriber callbacks.
+>
+>### Change
+>
+>- Expanded the public PSR patch surface to support nested `merge`, `delete`, and `insert`, with canonical path-array behavior and `failedPatchId` reporting for both single and atomic failures.
+>- Hardened public PSR package-level contract coverage to verify built `dist` entrypoints can detect, read, subscribe to, and patch stores created through the main `stroid` entrypoint.
+>- Tightened public PSR patch rejection semantics with stable `unsupported-op` and `unsupported-path-shape` reason codes for unsupported patch forms.
 >- Hardened Phase 6 graph identity with stable runtime node IDs, store-granularity runtime graphs, typed dependency edges, and PSR graph reads that accept both stable node IDs and legacy computed store names.
 >- Hardened Phase 7 timing semantics with explicit governance modes, mutation authority, causality-boundary reporting, and concrete contract reasons for async persistence, sync authority sharing, and async-boundary computed propagation.
->- Added a Phase 8 faithfulness suite that locks preview-vs-commit equivalence for deterministic public PSR flows, verifies public atomic rollback visibility rules, exercises async-boundary stop conditions, and smoke-tests production usage from only public entrypoints.
 >- Expanded built-package PSR contract tests to cover committed-final subscription timing, idempotent unsubscribe behavior, computed-settle notification ordering, and timing/governance downgrade claims.
->- Added a dedicated public PSR guide and support matrix covering patch support, reason codes, runtime node ID treatment, subscription timing, and downgrade rules.
 >- Hardened production SSR computed registration so computed stores inherit explicit global SSR opt-in from already-global dependencies and fail cleanly without leaving stray computed registrations when global creation is unsupported.
->- Added a 250K unique-subscriber benchmark, a 250K concurrent subscriber benchmark with real-world multi-store fanout scenarios, and lean performance-suite coverage for concurrent subscriber and sync broadcast timing; refreshed benchmark harnesses to use explicit feature installers and truly unique subscriber callbacks.
+>- Updated package exports, docs, and feature-install guidance to make optional feature registration explicit and more tree-shakeable.
+>- Stopped publishing `.map` source maps in the npm tarball to reduce package weight while keeping local build/debug output unchanged.
+>- Removed dead `./vue` and `./svelte` package exports that did not have built output behind them.
+>
+>### Fix
+>
+>- Fixed the published ESM package layout so `stroid`, `stroid/psr`, and sibling entrypoints share one runtime registry/computed graph instead of shipping isolated bundled state.
+>- Hardened transaction commit semantics so failed batched commits roll back staged store state, reset metrics, and queued notifications, while commit-phase feature hook errors no longer break atomic batches.
 >- Fixed `createStoreForRequest` so the documented callback API now exposes `api.snapshot()`.
 >- Fixed `createStoreForRequest().set(name, object)` so later external mutation of the caller payload no longer mutates request state.
 >- Fixed `createStoreForRequest()` so request-scope writes made during `hydrate()` now persist into later `snapshot()` output and repeated `hydrate()` calls.
 >- Fixed `fetchStore()` timeouts without a caller-provided signal so the internally created request is now aborted when the timeout fires.
 >- Fixed `fetchStore()` request versioning so a timed-out request can no longer reuse a cleared version and overwrite a newer in-flight response.
->- Breaking: changed `stroid/persist`, `stroid/sync`, and `stroid/devtools` to side-effect-free modules that export explicit installers (`installPersist`, `installSync`, `installDevtools`) instead of auto-registering on import.
->- Updated package exports, docs, and feature-install guidance to make optional feature registration explicit and more tree-shakeable.
->- Stopped publishing `.map` source maps in the npm tarball to reduce package weight while keeping local build/debug output unchanged.
->- Removed dead `./vue` and `./svelte` package exports that did not have built output behind them.
+>
+>### Docs
+>
+>- Added a dedicated public PSR guide and support matrix covering patch support, reason codes, runtime node ID treatment, subscription timing, and downgrade rules.
 ></details>
 >
 ---
@@ -71,6 +174,16 @@
 ><details>
 ><summary><strong>0.1.3 --> 2026-03-22</strong></summary>
 >
+>### Breaking
+>
+>- None.
+>
+>### Add
+>
+>- None.
+>
+>### Fix
+>
 >- Fixed async rate limiting so `fetchStore(..., { cacheKey })` is throttled per `cacheSlot` instead of incorrectly sharing one counter across the whole store name.
 >- Fixed `createSelector` dependency tracking for object-valued reads so cached selector results no longer go stale when object references change without primitive leaf access.
 >- Fixed `setStoreBatch` teardown so a later commit-phase feature error does not discard notifications that were already queued by earlier successful commits.
@@ -94,8 +207,9 @@
 ><details>
 ><summary><strong>0.1.2 --> 2026-03-19</strong></summary>
 >
-> **Note:** This release contains breaking changes to the `stroid/core` export surface and hydration defaults to improve bundle size and security.
+>### Breaking
 >
+>- Breaking changes to the `stroid/core` export surface and hydration defaults to improve bundle size and security.
 >- `hydrateStores` now requires an explicit trust argument at the TypeScript level (compile-time enforcement).
 >- Default snapshot mode changed to `"shallow"` (was `"deep"`). Override per-store with `snapshot: "deep"` or globally with `configureStroid({ defaultSnapshotMode: "deep" })`.
 >
@@ -111,7 +225,7 @@
 >- `Array.from` elimination: replaced per-flush subscriber array allocations with a registry-level reusable buffer.
 >- `buildFlushPlan` collapse: reduced passes, preserved `pendingBuffer` semantics, and removed the terminal `orderedNames.slice()` allocation.
 >
->### Added
+>### Add
 >
 >- `allowTrusted` hydration flag (aliasing `allowHydration`; `allowUntrusted` deprecated).
 >- `allowTrustedHydration` config alias.
@@ -139,7 +253,7 @@
 >- Reserved `stroid/vue` and `stroid/svelte` entry points (adapter placeholders, not implemented).
 >- `onStoreLifecycle` registry hook for single-listener lifecycle events (devtools-oriented).
 >
->### Changed
+>### Change
 >
 >- `createStoreForRequest` now hydrates with `{ allowTrusted: true }`.
 >- `getStore` now respects `snapshot` mode (`deep`/`shallow`/`ref`) for both whole-store and path reads.
@@ -163,7 +277,7 @@
 >- `deepClone` throws on non-cloneable values.
 >- `endTransaction` now executes all pending commit callbacks, capturing the first error while allowing remaining commits to run.
 >
->### Fixed
+>### Fix
 >
 >- Helper store typings align with stricter `createStore` overloads.
 >- `replaceStore` now participates in `setStoreBatch` transactions.
@@ -200,20 +314,20 @@
 >
 >- If you used `stroid/core` for batching, reset, or hydration — import those from `stroid` instead.
 >
->### Added
+>### Add
 >
 >- Public feature installer entrypoints and a `features` option bag for custom feature registration.
 >- Optional structural sharing via `configureStroid({ mutatorProduce })` (supports a global Immer shim).
 >- `strictAsyncUsageErrors` to throw on async usage errors when enabled.
 >
->### Changed
+>### Change
 >
 >- SSR request APIs are now fully typed; `snapshotStrategy` drives the default snapshot mode.
 >- Config is registry-scoped to avoid cross-request bleed in SSR.
 >- Transaction snapshot caching scoped to the active batch.
 >- Internal layering tightened; added guard against restricted lifecycle imports.
 >
->### Fixed
+>### Fix
 >
 >- Chunked flush delivery no longer mixes snapshots within a single notification.
 >- Persist sequencing avoids stale writes when debounce timers overlap.
@@ -228,7 +342,7 @@
 ><details>
 ><summary><strong>0.1.0 --> 2026-03-14</strong></summary>
 >
->### Added
+>### Add
 >
 >- `configureStroid({ strictMissingFeatures: true })` to hard-fail when a feature is used without its side-effect import.
 >- `configureStroid({ allowUntrustedHydration: true })` to opt in to `hydrateStores` on untrusted snapshots.
@@ -240,14 +354,14 @@
 >- `configureStroid({ strictMutatorReturns: true })` to forbid mutator return values.
 >- `StrictStoreMap` opt-in type mode.
 >
->### Breaking Changes
+>### Breaking
 >
 >- Removed `mergeStore` and `chain` from the public API.
 >- `setStoreBatch` is now transactional (staged writes, atomic commit, rollback on error).
 >- `createStore`, `deleteStore`, `hydrateStores` are disallowed inside a batch.
 >- `hydrateStores` requires explicit trust via third argument or config.
 >
->### Fixed
+>### Fix
 >
 >- `deleteStore` no longer emits an intermediate null notification.
 >- Async fetch 60s timeout now clears on completion.
@@ -261,17 +375,17 @@
 ><details>
 ><summary><strong>0.0.4 --> 2026-03-06</strong></summary>
 >
->### Added
+>### Add
 >
 >- Persistence recovery hooks: `persist.onMigrationFail` and `persist.onStorageCleared`.
 >- Sync hardening: `sync.maxPayloadBytes` and snapshot requests for reconnecting tabs.
 >
->### Changed
+>### Change
 >
 >- Docs: converted repo docs into chapter-based handbook; aligned README and API chapters with real package surface.
 >- Packaging: rebuilt `dist` from current `src`; fixed `stroid/react` build entry.
 >
->### Fixed
+>### Fix
 >
 >- `hydrateStores` rejects invalid schema payloads without leaving broken store shells.
 >- Middleware throws no longer poison later notifications.
@@ -283,7 +397,7 @@
 ><details>
 ><summary><strong>0.0.3 --> 2026-03-04</strong></summary>
 >
->### Fixed
+>### Fix
 >
 >- Persistence catches `localStorage.setItem` errors (e.g., `QuotaExceededError`) and routes to `onError`.
 >- Async fetch metadata cleans up when a store is deleted.
@@ -299,14 +413,14 @@
 ><details>
 ><summary><strong>0.0.2 --> 2026-03-03</strong></summary>
 >
->### Added
+>### Add
 >
 >- SSR helpers: `createStoreForRequest` and `hydrateStores`.
 >- Store helpers: `createEntityStore`, `createListStore`, `createCounterStore`.
 >- Observability: `getHistory`, `clearHistory`, `getMetrics`.
 >- Sync tuning: optional `channel` and `conflictResolver`.
 >
->### Fixed
+>### Fix
 >
 >- Hydration safety around theme toggles.
 ></details>
@@ -323,4 +437,4 @@
 >- Safety: path/type guard warnings, persist key collision warning.
 >- CRC table lazy init.
 ></details>
->
+>