@kudzujs/core 0.10.2 → 0.11.0

package/PERFORMANCE.md

@@ -6,6 +6,54 @@ Reproducibility classes: `npm run benchmark`, `npm run benchmark:keyed`, `npm ru
 
 The maintained 2026-08-13 comparison used Node 24.14.0 and an Intel Core i5-9500 Linux x64 host, one warm-up, and seven alternating fresh-process samples against clean `v0.8.44`. A narrow fast path skips Kudzu semantic transformation for 450 plain `.ts` modules whose runtime edges are exclusively resolvable relative TypeScript imports or exports; all other modules retain the existing transformer. Compile median fell from 2,323.9 ms to 1,413.2 ms (39.2%) and clean-build median from 3,325.3 ms to 2,382.4 ms (28.4%); every paired sample improved. Compile peak-RSS median fell from 571.2 MiB to 552.6 MiB, while build peak RSS was 570.9 MiB versus 568.8 MiB. Compiler scratch fell from 7,328,390 to 1,971,061 bytes. Both targets emitted the same 50 static HTML files, 10,980 bytes, and deploy SHA-256 `e107d78a7f55bc8a1af0ea6e53efeffa19b3d44d21c892484d103fa346e7ba7b`. This is a source-scale compiler comparison, not a cross-framework result.
 
+## 0.11.0 Project Owned Fetch Lifecycle
+
+Measured 2026-08-22 on macOS arm64 with Node 25.6.1 and Chrome
+151.0.7922.172. `RUNS=21 npm run benchmark:project-navigation` uses fresh Chrome
+profiles, waits for the initial project fetch and persisted workspace update,
+then measures list-to-detail completion including route-effect cancellation.
+
+The two-route session uses 15 unique JavaScript files totaling 54,770 raw /
+20,763 aggregate gzip bytes. Navigation samples are
+`[1.1, 0.8, 0.7, 0.8, 0.7, 0.8, 0.8, 0.7, 0.7, 0.9, 0.9, 0.9, 0.7, 0.8, 0.7, 1.3, 0.8, 0.8, 0.6, 0.9, 0.9]`
+ms, with a 0.8 ms median and 0.6/1.3 ms minimum/maximum.
+
+Compared with the `0.10.3` release, the authored fetch effect, loading/error
+conditions, and refetch state add 1,208 raw / 440 aggregate gzip session bytes.
+`/help` remains 0 B JavaScript. The measured interval is unchanged, but the new
+fetch-completion prerequisite makes this an acceptance-safe no-regression check,
+not a latency improvement claim. No compiler or browser-runtime source changed.
+
+## 0.10.3 Project Persistence Recipe
+
+Measured 2026-08-22 on macOS arm64 with Node 25.6.1 and Chrome
+151.0.7922.172. `RUNS=21 npm run benchmark:project-navigation` uses fresh Chrome
+profiles and exact extensionless application routes. Every accepted sample
+updates workspace state, verifies layout identity and persisted state, then
+measures list-to-detail completion.
+
+The 0.10.2 release baseline and 0.10.3 candidate were measured with the same
+21-profile timing protocol and host; the candidate additionally verifies its
+persistence write before timing:
+
+| Revision | Session JS raw/gzip | Navigation median | Min/max |
+|---|---:|---:|---:|
+| `0.10.2` | 46,418 / 17,045 B | 1.9 ms | 1.3 / 5.5 ms |
+| `0.10.3` candidate | 53,562 / 20,323 B | 1.5 ms | 1.3 / 5.6 ms |
+
+Baseline samples:
+`[1.3, 1.8, 1.6, 1.9, 1.3, 1.3, 1.9, 5.1, 1.7, 1.4, 1.9, 5.0, 4.7, 1.9, 1.7, 5.5, 2.2, 1.7, 1.5, 2.0, 5.2]`.
+
+Candidate samples:
+`[2.6, 1.5, 1.8, 1.3, 1.5, 1.4, 1.7, 1.3, 1.5, 1.5, 1.9, 1.7, 1.6, 5.6, 1.5, 1.6, 1.5, 1.5, 1.5, 1.5, 1.6]`.
+
+The +7,144 raw / +3,278 aggregate gzip bytes are the measured cost of two
+authored layout effects, their route-owned entries, and one native clear
+handler. The median changes from 1.9 to 1.5 ms with overlapping ranges, so no
+latency improvement or regression is claimed. No compiler or browser-runtime
+source changed. `/help` remains 0 B JavaScript, so unused routes pay no
+persistence cost.
+
 ## 0.10.2 Project Shared-Layout Navigation
 
 Measured 2026-08-22 on macOS arm64 with Node 25.6.1 and Chrome

package/README.md

@@ -12,9 +12,9 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 *Watch: React-shaped TSX to static HTML and route-specific ESM in 22 seconds.*
 
-> Experimental `0.10.x`: the compiler API and supported TSX surface may change.
+> Experimental `0.11.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.10.2 - Shared-layout navigation.** The tracked project application now preserves workspace state across explicit list/detail navigation while route drafts reset, direct loads start fresh, and static routes remain outside the runtime group. Read the [release notes](./RELEASES.md#0102---shared-layout-navigation), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.10.2), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.11.0 - Owned fetch lifecycle.** The tracked project application now owns loading, accessible HTTP errors, explicit refetch, stale completion rejection, cancellation, and route-release behavior without a query runtime. Read the [release notes](./RELEASES.md#0110---owned-fetch-lifecycle), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.11.0), or follow the [architecture packet](./docs/next-architecture/README.md).
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)

package/RELEASES.md

@@ -1,5 +1,99 @@
 # Kudzu Releases
 
+## 0.11.0 - Owned Fetch Lifecycle
+
+Kudzu 0.11.0 proves browser-only server data as application-owned state, one
+native fetch effect, and exact route lifetime rather than a query framework.
+
+### Changed in 0.11.0
+
+- Added accessible loading, success, and HTTP error states to the maintained
+  project application.
+- Added explicit refetch and recovery through one primitive request dependency.
+- Proved that a delayed prior continuation cannot overwrite newer keyed data.
+- Added authored `AbortController` cleanup for dependency replacement and route
+  removal, with late route work denied state authority.
+- Updated `create-kudzu@0.1.108` to generate projects on
+  `@kudzujs/core@^0.11.0`.
+
+### Output Evidence
+
+- The application fixture emits 19 files, 67,886 raw / 24,077 aggregate gzip
+  bytes, and deploy digest
+  `9c06d2a5d47b4ea2ae54cebbc0448bf161907691ee37a02a5dae0e7c37779ae4`.
+- The list/detail session uses 15 unique JavaScript files totaling 54,770 raw /
+  20,763 aggregate gzip bytes; `/help` remains 0 B JavaScript.
+- Twenty-one fresh Chrome profiles record a 0.8 ms navigation median and
+  0.6/1.3 ms range after fetch completion and persisted workspace setup.
+- No semantic primitive, compiler pass, production compiler line, runtime
+  concept, cache, Provider, retry scheduler, or query runtime was added.
+
+### Validation
+
+- Required Chrome proves loading, stale completion rejection, accessible HTTP
+  failure, recovery, cancellation, and route-removal authority loss.
+- The full suite, package smoke, registry metadata, and fresh installation are
+  release gates.
+
+### Limits
+
+Shared request deduplication, invalidation, optimistic mutation, retries,
+polling, and retained caches remain later evidence packets.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.11.0
+```
+
+## 0.10.3 - Application-Owned Persistence
+
+Kudzu 0.10.3 proves guarded browser persistence as application code composed
+from ordinary state, effects, and native Web Storage.
+
+### Changed in 0.10.3
+
+- Added a versioned workspace restore recipe with deterministic static fallback
+  and exact value/schema/version validation.
+- Added a readiness guard so dependency persistence cannot overwrite storage
+  before mount restoration completes.
+- Added application-owned logout clearing and visible state reset in one native
+  handler.
+- Added required-Chrome cases for valid, absent, malformed, wrong-schema, and
+  wrong-version records, persistence writes, and logout removal.
+- Updated `create-kudzu@0.1.107` to generate projects on
+  `@kudzujs/core@^0.10.3`.
+
+### Output Evidence
+
+- The application fixture emits 19 files, 65,376 raw / 23,471 aggregate gzip
+  bytes, and deploy digest
+  `bb58826876bdf090a85d2c1f8a1edcbbc9abd35d5335eb3d1e7fb1fafe6bed72`.
+- The list/detail session uses 15 unique JavaScript files totaling 53,562 raw /
+  20,323 aggregate gzip bytes; `/help` remains 0 B JavaScript.
+- Matched 21-profile navigation medians are 1.9 ms for 0.10.2 and 1.5 ms for
+  0.10.3 with overlapping ranges, so no latency change is claimed.
+- No semantic primitive, compiler pass, production compiler line, runtime
+  concept, persistence API, store, or storage runtime was added.
+
+### Validation
+
+- Required Chrome proves restore, fallback, write, clear, conditional/keyed
+  release and fresh remount, route draft reset, and fresh direct documents.
+- The full suite, package smoke, registry metadata, and fresh installation are
+  release gates.
+
+### Limits
+
+Schema migration chains, expiry, encryption, cross-tab storage events, and
+server synchronization remain application concerns or later evidence packets.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.10.3
+```
+
 ## 0.10.2 - Shared-layout navigation
 
 Kudzu 0.10.2 extends the tracked project-management application with explicit

package/docs/next-architecture/application-capability-release-plan.md

@@ -224,6 +224,11 @@ The list/detail session uses 10 unique JavaScript files totaling 46,418 raw /
 17,045 aggregate gzip bytes. Seven fresh Chrome profiles record list-to-detail
 completion at `[2.3, 6.5, 1.4, 1.3, 5.1, 1.3, 4.0]` ms, median 2.3 ms.
 
+Release commit `76a45c4`, tag `v0.10.2`, both CI jobs, the GitHub release,
+`@kudzujs/core@0.10.2`, `create-kudzu@0.1.106`, registry metadata, and a fresh
+registry-backed scaffold install/check passed on 2026-08-22. Publish workflow
+`32566976581` completed every version, package, publication, and registry gate.
+
 ### `0.10.3`: Persistence Recipe And State Release
 
 - **Purpose:** prove URL, storage, and server-backed persistence without adding a
@@ -236,6 +241,40 @@ completion at `[2.3, 6.5, 1.4, 1.3, 5.1, 1.3, 4.0]` ms, median 2.3 ms.
 - **Done condition:** deterministic static fallback and browser recovery pass
   with no storage runtime in unused routes.
 
+**Completion evidence:** the greenfield application layout now owns one guarded
+`localStorage` recipe composed entirely from ordinary state and two existing
+effects. Static HTML starts with `Primary`; a mount effect accepts only version
+1 records whose workspace is `Primary` or `Secondary`, while absent, malformed,
+wrong-schema, and wrong-version records fall back safely. A readiness state
+prevents the dependency effect from overwriting storage before restore.
+Workspace changes write the versioned record, and logout disables persistence,
+removes the record, and resets visible state in one synchronous handler.
+
+Required Chrome proves valid restore, every fallback, post-commit persistence,
+logout removal, conditional and keyed release/fresh remount, route draft
+release/fresh revisit, and a fresh direct document. `/help` remains outside the
+navigation group with complete HTML and 0 B JavaScript. The fixture emits 19
+files, 65,376 raw / 23,471 aggregate gzip bytes, with deploy SHA-256
+`bb58826876bdf090a85d2c1f8a1edcbbc9abd35d5335eb3d1e7fb1fafe6bed72`.
+The two-route session uses 15 unique JavaScript files totaling 53,562 raw /
+20,323 aggregate gzip bytes.
+
+This packet adds zero semantic primitives, ModuleIR kinds, compiler passes,
+production compiler lines, runtime concepts, normalization rules, adapter
+rules, public APIs, stores, or persistence runtimes. One existing positive
+application fixture gains valid, absent, malformed, wrong-schema, wrong-version,
+write, and clear browser cases. A matched 21-profile measurement records the
+authored capability cost: the 0.10.2 list/detail median of 1.9 ms and 46,418 raw /
+17,045 gzip session JavaScript becomes 1.5 ms and 53,562 / 20,323 bytes. The
+timing ranges overlap with no material loss; the 7,144 raw / 3,278 gzip byte
+increase is the explicit cost of route-owned effect/native entries, not a
+compiler or shared-runtime change.
+
+Release commit `4420ccc`, tag `v0.10.3`, both CI jobs, the GitHub release,
+`@kudzujs/core@0.10.3`, `create-kudzu@0.1.107`, registry metadata, and a fresh
+registry-backed scaffold install/check passed on 2026-08-22. Publish workflow
+`32568752477` completed every version, package, publication, and registry gate.
+
 ## `0.11.x`: Async And Server Data
 
 ### `0.11.0`: Owned Fetch Lifecycle
@@ -248,6 +287,36 @@ completion at `[2.3, 6.5, 1.4, 1.3, 5.1, 1.3, 4.0]` ms, median 2.3 ms.
 - **Stop condition:** a query cache is added to implement one request.
 - **Done condition:** the project list journey passes and `/help` stays zero-JS.
 
+**Completion evidence:** the project list now composes one route-owned native
+`fetch` effect with ordinary request, status, error, project, and summary state.
+The deterministic server drives initial loading, a fast explicit refetch, an
+HTTP 500 alert, and recovery. A delayed prior continuation attempts its writes
+after dependency replacement and cannot replace the newer keyed project data.
+The effect owns an `AbortController`; dependency replacement and route removal
+invoke authored abort cleanup, and late route work cannot mutate the detail
+route or recreated list ownership. Existing project filtering, nested keyed
+identity, row state, shared layout state, persistence, and logout journeys still
+pass. `/help` remains complete HTML with 0 B JavaScript.
+
+This packet adds zero semantic primitives, ModuleIR kinds, compiler passes,
+production compiler lines, runtime concepts, normalization rules, adapter
+rules, public APIs, caches, Providers, retry schedulers, or query runtimes. One
+existing positive application fixture gains loading, success, stale completion,
+HTTP failure, recovery, cancellation, and route-release cases. The fixture
+still emits 19 files and now totals 67,886 raw / 24,077 aggregate gzip bytes,
+with deploy SHA-256
+`9c06d2a5d47b4ea2ae54cebbc0448bf161907691ee37a02a5dae0e7c37779ae4`.
+The project route uses 52,130 raw / 19,502 aggregate gzip JavaScript bytes; the
+two-route session uses 54,770 / 20,763 bytes, an authored capability increase of
+1,208 raw / 440 gzip bytes over `0.10.3`. Twenty-one fresh Chrome profiles record
+0.8 ms median list-to-detail completion with a 0.6/1.3 ms range. The changed
+fetch-completion prerequisite permits no latency improvement claim; no material
+regression is present.
+
+Clean-worktree `npm run check`, 273/273 standard tests, the required project
+Chrome journey, the focused required-Chrome retry for the one full-suite browser
+timeout, and packed-package smoke pass on 2026-08-22.
+
 ### `0.11.1`: List And Detail Data Consistency Evidence
 
 - **Purpose:** expose the first real multi-consumer coordination limit.
@@ -882,5 +951,7 @@ release transaction where possible or document and publish a forward-fix patch.
 |---|---|---|---|
 | `0.10.0` | Released | Preserve the published application baseline and release evidence. | None |
 | `0.10.1` | Released | Preserve the published state-scale evidence and explicit object-field limit. | None |
-| `0.10.2` | Active | Add the shared workspace and route-owned draft journey to the greenfield application. | None |
-| `0.10.3` onward | Blocked | Wait for the preceding patch acceptance and release record. | Ordered dependency |
+| `0.10.2` | Released | Preserve the published shared-layout navigation and exact route-release evidence. | None |
+| `0.10.3` | Released | Preserve the published guarded persistence recipe and zero-runtime exclusion. | None |
+| `0.11.0` | Active | Add the owned loading/error/data/refetch and stale-response journey. | None |
+| `0.11.1` onward | Blocked | Wait for the preceding patch acceptance and release record. | Ordered dependency |

package/docs/next-architecture/versioning.md

@@ -66,7 +66,7 @@ Keep each patch behavior-preserving and independently reviewable. If a boundary
 
 ## Generator Versions
 
-`create-kudzu@0.1.106` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.10.2`.
+`create-kudzu@0.1.108` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.11.0`.
 
 ## Release Boundary
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",