@cosmicdrift/kumiko-renderer 0.14.0 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -42,4 +42,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/src/__tests__/i18n.test.tsx

@@ -1,8 +1,7 @@
-// @vitest-environment jsdom
+import { describe, expect, test } from "bun:test";
 import type { LocaleResolver } from "@cosmicdrift/kumiko-headless";
 import { act, render, renderHook } from "@testing-library/react";
 import type { ReactNode } from "react";
-import { describe, expect, test } from "vitest";
 import {
   createStaticLocaleResolver,
   LocaleProvider,
@@ -32,7 +31,6 @@ function makeStatefulResolver(initial: string): LocaleResolver {
     },
   };
 }
-
 const wrap =
   (resolver: LocaleResolver, fallbackBundles?: TranslationsByLocale[]) =>
   ({ children }: { readonly children: ReactNode }): ReactNode => (
@@ -40,7 +38,6 @@ const wrap =
       {children}
     </LocaleProvider>
   );
-
 describe("useTranslation — lookup order", () => {
   test("App-Resolver wins when it returns a non-key value", () => {
     const resolver: LocaleResolver = {
@@ -50,7 +47,6 @@ describe("useTranslation — lookup order", () => {
     const { result } = renderHook(() => useTranslation(), { wrapper: wrap(resolver) });
     expect(result.current("hello")).toBe("Resolved by app");
   });
-
   test("falls back to plugin-bundle for current locale", () => {
     const resolver = createStaticLocaleResolver({ locale: "de" });
     const bundles: TranslationsByLocale[] = [{ de: { greet: "Hallo" }, en: { greet: "Hello" } }];
@@ -59,7 +55,6 @@ describe("useTranslation — lookup order", () => {
     });
     expect(result.current("greet")).toBe("Hallo");
   });
-
   test("strips region for bundle lookup (de-AT → de)", () => {
     const resolver = createStaticLocaleResolver({ locale: "de-AT" });
     const bundles: TranslationsByLocale[] = [{ de: { greet: "Hallo" } }];
@@ -68,7 +63,6 @@ describe("useTranslation — lookup order", () => {
     });
     expect(result.current("greet")).toBe("Hallo");
   });
-
   test("falls back to fallbackLocale (en) when current locale missing", () => {
     const resolver = createStaticLocaleResolver({ locale: "fr" });
     const bundles: TranslationsByLocale[] = [{ de: { greet: "Hallo" }, en: { greet: "Hello" } }];
@@ -77,13 +71,11 @@ describe("useTranslation — lookup order", () => {
     });
     expect(result.current("greet")).toBe("Hello");
   });
-
   test("returns key as-is when nothing resolves", () => {
     const resolver = createStaticLocaleResolver({ locale: "de" });
     const { result } = renderHook(() => useTranslation(), { wrapper: wrap(resolver) });
     expect(result.current("missing.key")).toBe("missing.key");
   });
-
   test("interpolates {param}-placeholders from params arg", () => {
     const resolver = createStaticLocaleResolver({ locale: "de" });
     const bundles: TranslationsByLocale[] = [{ de: { greet: "Hallo {name}!" } }];
@@ -93,31 +85,26 @@ describe("useTranslation — lookup order", () => {
     expect(result.current("greet", { name: "Marc" })).toBe("Hallo Marc!");
   });
 });
-
 describe("useTranslation — re-render on locale change", () => {
   test("subscribe fires when setLocale runs, hook returns new value", () => {
     const resolver = makeStatefulResolver("de");
     const bundles: TranslationsByLocale[] = [{ de: { greet: "Hallo" }, en: { greet: "Hello" } }];
-
     function Probe(): ReactNode {
       const t = useTranslation();
       return <span data-testid="msg">{t("greet")}</span>;
     }
-
     const { getByTestId } = render(
       <LocaleProvider resolver={resolver} fallbackBundles={bundles}>
         <Probe />
       </LocaleProvider>,
     );
     expect(getByTestId("msg").textContent).toBe("Hallo");
-
     act(() => {
       resolver.setLocale?.("en");
     });
     expect(getByTestId("msg").textContent).toBe("Hello");
   });
 });
-
 describe("useLocale", () => {
   test("returns the resolver", () => {
     const resolver = createStaticLocaleResolver({ locale: "de" });

package/src/__tests__/qn.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { lastSegment } from "../app/qn";
 
 describe("lastSegment", () => {

package/src/__tests__/use-list-url-state.test.tsx

@@ -1,13 +1,12 @@
-// @vitest-environment jsdom
 //
 // useListUrlState pinnt den URL-State-Vertrag pro Screen-ID-Namespace:
 // `?<screenId>.sort=…&<screenId>.dir=…&<screenId>.q=…&<screenId>.page=…`.
 // Zwei Listen auf der Route teilen sich die URL ohne Param-Konflikt.
 // Page wird bei Sort/Filter-Wechsel reseted; Sort bleibt bei Search.
 
+import { describe, expect, mock, test } from "bun:test";
 import { act, renderHook } from "@testing-library/react";
 import type { ReactNode } from "react";
-import { describe, expect, test, vi } from "vitest";
 import type { NavApi } from "../app/nav";
 import { NavProvider } from "../app/nav";
 import { useListUrlState } from "../hooks/use-list-url-state";
@@ -23,8 +22,8 @@ function makeNav(initial: Record<string, string> = {}): NavApi & {
     captures: Array<Record<string, string | null>>;
   } = {
     route: undefined,
-    navigate: vi.fn(),
-    replace: vi.fn(),
+    navigate: mock(),
+    replace: mock(),
     hrefFor: () => "",
     get searchParams() {
       return params;
@@ -41,11 +40,9 @@ function makeNav(initial: Record<string, string> = {}): NavApi & {
   };
   return api;
 }
-
 function wrapper(nav: NavApi): (props: { children: ReactNode }) => ReactNode {
   return ({ children }) => <NavProvider value={nav}>{children}</NavProvider>;
 }
-
 describe("useListUrlState", () => {
   test("Default-State: kein URL-Param → sort=null, q='', page=1", () => {
     const nav = makeNav();
@@ -54,25 +51,21 @@ describe("useListUrlState", () => {
     expect(result.current.q).toBe("");
     expect(result.current.page).toBe(1);
   });
-
   test("liest sort+dir aus URL-Params (mit screenId-Prefix)", () => {
     const nav = makeNav({ "orders.sort": "createdAt", "orders.dir": "desc" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
     expect(result.current.sort).toEqual({ field: "createdAt", dir: "desc" });
   });
-
   test("ignoriert sort einer ANDEREN Liste (Namespacing)", () => {
     const nav = makeNav({ "incidents.sort": "severity", "incidents.dir": "asc" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
     expect(result.current.sort).toBeNull();
   });
-
   test("invalid dir (z.B. 'foo') → sort=null (defensive parse)", () => {
     const nav = makeNav({ "orders.sort": "name", "orders.dir": "foo" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
     expect(result.current.sort).toBeNull();
   });
-
   test("setSort schreibt sort+dir, resettet page (atomic update)", () => {
     const nav = makeNav({ "orders.page": "5" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
@@ -86,7 +79,6 @@ describe("useListUrlState", () => {
       "orders.page": null, // page-reset bei sort-change
     });
   });
-
   test("setSort(null) löscht sort+dir+page", () => {
     const nav = makeNav({
       "orders.sort": "name",
@@ -103,7 +95,6 @@ describe("useListUrlState", () => {
       "orders.page": null,
     });
   });
-
   test("setQ schreibt q + resettet page (Sort bleibt unangetastet)", () => {
     const nav = makeNav({
       "orders.sort": "name",
@@ -122,7 +113,6 @@ describe("useListUrlState", () => {
     // die Sortierung nicht.
     expect(nav.captures[0]).not.toHaveProperty("orders.sort");
   });
-
   test("setQ('') löscht den q-Key", () => {
     const nav = makeNav({ "orders.q": "acme" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
@@ -134,7 +124,6 @@ describe("useListUrlState", () => {
       "orders.page": null,
     });
   });
-
   test("setPage(1) löscht den Key (Default-Page = unprefixed URL)", () => {
     const nav = makeNav({ "orders.page": "5" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
@@ -143,7 +132,6 @@ describe("useListUrlState", () => {
     });
     expect(nav.captures[0]).toEqual({ "orders.page": null });
   });
-
   test("setPage(N>1) speichert die Page als String", () => {
     const nav = makeNav();
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });
@@ -152,7 +140,6 @@ describe("useListUrlState", () => {
     });
     expect(nav.captures[0]).toEqual({ "orders.page": "7" });
   });
-
   test("invalid page (negativ, NaN, 0) → fallback auf 1", () => {
     const nav = makeNav({ "orders.page": "-3" });
     const { result } = renderHook(() => useListUrlState("orders"), { wrapper: wrapper(nav) });

package/src/app/__tests__/action-form-shim.test.ts

@@ -0,0 +1,26 @@
+import { describe, expect, test } from "bun:test";
+import { synthesizeActionFormEntity, synthesizeActionFormScreen } from "../action-form-shim";
+
+describe("synthesizeActionFormEntity", () => {
+  test("wraps inline fields as minimal EntityDefinition", () => {
+    const entity = synthesizeActionFormEntity({
+      title: { type: "text" },
+    });
+    expect(entity.fields["title"]).toEqual({ type: "text" });
+  });
+});
+
+describe("synthesizeActionFormScreen", () => {
+  test("maps actionForm screen to entityEdit shape", () => {
+    const screen = synthesizeActionFormScreen({
+      id: "invite-user",
+      type: "actionForm",
+      handler: "users:write:invite-user",
+      layout: { sections: [{ title: "Invite", fields: ["email"] }] },
+      fields: { email: { type: "text" } },
+    });
+    expect(screen.type).toBe("entityEdit");
+    expect(screen.entity).toBe("__action-form__");
+    expect(screen.layout).toEqual({ sections: [{ title: "Invite", fields: ["email"] }] });
+  });
+});

package/CHANGELOG.md

@@ -1,472 +0,0 @@
-# @cosmicdrift/kumiko-renderer
-
-## 0.14.0
-
-### Patch Changes
-
-- @cosmicdrift/kumiko-framework@0.14.0
-- @cosmicdrift/kumiko-headless@0.14.0
-
-## 0.13.0
-
-### Patch Changes
-
-- Updated dependencies [7f56b2f]
-  - @cosmicdrift/kumiko-framework@0.13.0
-  - @cosmicdrift/kumiko-headless@0.13.0
-
-## 0.12.2
-
-### Patch Changes
-
-- Updated dependencies [597de52]
-  - @cosmicdrift/kumiko-framework@0.12.2
-  - @cosmicdrift/kumiko-headless@0.12.2
-
-## 0.12.1
-
-### Patch Changes
-
-- Updated dependencies [f2ad7c4]
-  - @cosmicdrift/kumiko-framework@0.12.1
-  - @cosmicdrift/kumiko-headless@0.12.1
-
-## 0.12.0
-
-### Patch Changes
-
-- @cosmicdrift/kumiko-framework@0.12.0
-- @cosmicdrift/kumiko-headless@0.12.0
-
-## 0.11.2
-
-### Patch Changes
-
-- Updated dependencies [92a84f0]
-  - @cosmicdrift/kumiko-framework@0.11.2
-  - @cosmicdrift/kumiko-headless@0.11.2
-
-## 0.11.1
-
-### Patch Changes
-
-- @cosmicdrift/kumiko-framework@0.11.1
-- @cosmicdrift/kumiko-headless@0.11.1
-
-## 0.11.0
-
-### Patch Changes
-
-- Updated dependencies [30ea981]
-- Updated dependencies [9347212]
-  - @cosmicdrift/kumiko-framework@0.11.0
-  - @cosmicdrift/kumiko-headless@0.11.0
-
-## 0.10.0
-
-### Patch Changes
-
-- Updated dependencies [d06f029]
-- Updated dependencies [753d392]
-  - @cosmicdrift/kumiko-framework@0.10.0
-  - @cosmicdrift/kumiko-headless@0.10.0
-
-## 0.9.0
-
-### Patch Changes
-
-- Updated dependencies [51e22f5]
-  - @cosmicdrift/kumiko-framework@0.9.0
-  - @cosmicdrift/kumiko-headless@0.9.0
-
-## 0.8.1
-
-### Patch Changes
-
-- Updated dependencies [4b5f91e]
-  - @cosmicdrift/kumiko-framework@0.8.1
-  - @cosmicdrift/kumiko-headless@0.8.1
-
-## 0.8.0
-
-### Patch Changes
-
-- Updated dependencies [f34af9a]
-- Updated dependencies [dff4123]
-  - @cosmicdrift/kumiko-framework@0.8.0
-  - @cosmicdrift/kumiko-headless@0.8.0
-
-## 0.7.0
-
-### Minor Changes
-
-- bcf43b6: es-ops: `SeedMembershipRow` exposes `streamTenantId` (stream-tenant aus `kumiko_events.v1`) neben dem payload-`tenantId`. Seed-Authors müssen den `kumiko_events`-JOIN nicht mehr selbst bauen — `m.streamTenantId` ist der korrekte Wert für `systemWriteAs`'s `tenantIdOverride` wenn das Aggregate von einem fremden Executor angelegt wurde (typisches `seedTenantMembership(by=systemAdmin)`-Pattern).
-
-### Patch Changes
-
-- Updated dependencies [bcf43b6]
-  - @cosmicdrift/kumiko-framework@0.7.0
-  - @cosmicdrift/kumiko-headless@0.7.0
-
-## 0.6.0
-
-### Minor Changes
-
-- 8489d18: feat(es-ops): Phase 1.5 — tenantIdOverride + dry-run-validator + E2E-Test + Doku
-
-  Phase 1.5 schließt die Lücken aus Phase 1 die den ersten Driver-Use-Case
-  (publicstatus admin-roles) blockten. Siehe Retro:
-  `kumiko-platform/docs/plans/features/es-ops-phase1-retro.md` (PR #9).
-
-  **A1 — tenantIdOverride:**
-  `SeedMigrationContext.systemWriteAs(qn, payload, tenantIdOverride?)`.
-  Default SYSTEM_TENANT_ID (unverändert für System-scope-Aggregates wie
-  config-values). Mit override: `createSystemUser(tenantIdOverride)` als
-  Executor, damit der Event-Store-Executor den Aggregate-Stream im
-  richtigen Tenant findet. Fix für die `version_conflict`-Klasse-Bug
-  (Memory `feedback_event_store_tenant_consistency.md`).
-
-  **A2 — dry-run-validator:**
-  Runner parsed seed-files vor `migration.run()` per regex
-  `systemWriteAs\(["']([^"']+)["']`, sammelt handler-QNs, validiert
-  gegen `registry.getWriteHandler(qn)`. Fail-fast mit klarer Message
-
-  - Datei + QN statt zur Runtime "handler not found". Catched camelCase-
-    typos (kebab-case-vs-camelCase Drift) + andere QN-Drift zur Boot-Zeit.
-    runProdApp reicht den richtigen Registry rein (`registry` neu in
-    RunPendingSeedMigrationsArgs).
-
-  **A3 — E2E-Test:**
-  `packages/bundled-features/src/__tests__/es-ops-e2e.integration.ts`
-  mit `setupTestStack`-Pattern: tenant+config Features echt geladen,
-  echtes Membership-Aggregate via TenantHandlers.addMember im Demo-Tenant,
-  seed-migration ruft update-member-roles mit tenantIdOverride → write
-  geht durch, Marker landed, Event in Store, Read-Model aktualisiert.
-  Plus typo-Test: seed mit camelCase fail-t Dry-Run mit
-  `/dry-run found.*unknown handler-QN/`. **TDD-First**: ohne A1+A2 wäre
-  der test rot.
-
-  **A4 — Doku:**
-  `framework/src/es-ops/README.md` erweitert um „Wann brauche ich
-  tenantIdOverride?" + „Deployment-Anforderungen" (Docker COPY, Idempotenz,
-  Multi-Replica) + „Lokaler Smoke vor Push". Recipe-README + seed-files
-  auf neue API aktualisiert.
-
-  **A5 — Smoke-Skript-Template:**
-  `samples/recipes/seed-migration/scripts/smoke.ts` als copy-paste-Template
-  für App-Authors: Bun-runnable, offline (read-only, kein DB-Write),
-  validiert Module-Load + QN-Resolution + System-User-Access. Recipe-
-  README dokumentiert Pflicht-Pattern.
-
-  **Bonus-Fix:**
-  `tenant:write:create`-access auf `["system", "SystemAdmin"]` erweitert
-  (symmetrisch zu update-member-roles). Aufgedeckt durch Recipe-Smoke +
-  initial-tenants-Seed. Pinning-Test in `tenant.integration.ts` updated.
-
-  **Test-State:** 45/45 grün (Pre-Push). Typecheck clean. Biome clean.
-  as-cast-Audit clean. Guard-silent-skip clean. Recipe-Smoke clean.
-
-  **Folge-Step (separater PR):** publicstatus driver-sample reaktivieren
-  mit lokalem Pre-Push-Smoke gegen publicstatus' echtes Feature-Set.
-
-### Patch Changes
-
-- Updated dependencies [8489d18]
-  - @cosmicdrift/kumiko-framework@0.6.0
-  - @cosmicdrift/kumiko-headless@0.6.0
-
-## 0.5.2
-
-### Patch Changes
-
-- 4f0d781: fix(tenant): updateMemberRoles erlaubt "system"-Rolle (symmetrisch zu create)
-
-  Drift innerhalb des tenant-Features: `tenant:write:create` akzeptierte
-  `["system", "SystemAdmin"]`, `tenant:write:update-member-roles` aber
-  nur `["SystemAdmin"]`. Konsequenz: ops-tooling und seed-migrations
-  (`createSystemUser` mit `roles: ["system"]`) konnten den Handler nicht
-  aufrufen — `access_denied`.
-
-  Live entdeckt beim ersten Driver-Sample der es-ops Phase 1: publicstatus
-  seed `2026-05-20-fix-admin-roles.ts` rief `update-member-roles` via
-  `systemWriteAs` → access_denied → Pod CrashLoopBackOff.
-
-  Plus access-rule-Pinning-Test in `tenant.integration.ts`-scenario-7.
-
-- Updated dependencies [4f0d781]
-  - @cosmicdrift/kumiko-framework@0.5.2
-  - @cosmicdrift/kumiko-headless@0.5.2
-
-## 0.5.1
-
-### Patch Changes
-
-- 0e00015: fix(es-ops): path.resolve statt path.join für seedsDir → seed-files
-
-  Bun's `await import()` braucht absolute Pfade. Wenn der App-Author
-  `runProdApp({ seedsDir: "./seeds" })` setzt (relativ), würde
-  `path.join("./seeds", "foo.ts")` einen relativen Pfad liefern → Bun's
-  Import-Resolver such relativ zum `runner.ts`-Modul (nicht zum
-  `process.cwd()`) → `Cannot find module 'seeds/...' from '<runner-path>'`.
-
-  `path.resolve` löst gegen `process.cwd()` auf → absolute Pfade →
-  Import funktioniert. Aufgedeckt beim ersten Live-Boot der publicstatus-
-  Driver-Migration (Pod CrashLoopBackOff).
-
-- Updated dependencies [0e00015]
-  - @cosmicdrift/kumiko-framework@0.5.1
-  - @cosmicdrift/kumiko-headless@0.5.1
-
-## 0.5.0
-
-### Minor Changes
-
-- 7ff69ab: feat(es-ops): Phase 1 — file-based seed-migrations
-
-  Neues first-class Operations-Pattern fürs Framework. Liefert `seed-migrations`
-  als drizzle-migrate-equivalent für Event-Sourcing-Aggregate-Updates die
-  idempotent-Seeder nicht erfassen können (z.B. „Member hat schon eine
-  Rolle, aber jetzt soll noch eine dazukommen").
-
-  Public-API:
-
-  - `runProdApp({ seedsDir })` — Auto-apply pending Migrations beim Boot
-  - `SeedMigration`-Interface (default-Export einer `seeds/<id>.ts`-File)
-  - `SeedMigrationContext` mit `systemWriteAs` (ruft existing write-handler
-    als System-User) + Read-Helpers (`findUserByEmail`,
-    `findMembershipsOfUser`, `findTenants`)
-  - CLI: `bunx kumiko ops seed:new|status|apply`
-  - Tracking-Table `kumiko_es_operations` mit `operation_type`-Discriminator
-    (vorbereitet auf Phase 2+ Operations: projection-rebuild, event-replay,
-    stream-migration, ...)
-  - Env-Flags: `KUMIKO_SKIP_ES_OPS=1` (alle skippen für Recovery),
-    `KUMIKO_SKIP_ES_OPS_<ID>=1` (einzelne kaputte skippen)
-
-  Garantien: single-run via tracking, atomic via per-migration-Tx,
-  chronological order via filename-prefix, fail-stop bei Failure (kein
-  Partial-Apply), ES-konform via Handler-Dispatch.
-
-  Sub-path-Export: `@cosmicdrift/kumiko-framework/es-ops`
-
-  Plan-Doc: `kumiko-platform/docs/plans/features/es-ops.md`
-  Recipe: `samples/recipes/seed-migration/`
-  Driver-Use-Case: publicstatus admin-roles-drift (parallel-Branch
-  `feat/es-ops-driver-admin-roles`).
-
-  Phase 2+ skizziert + offen markiert — Implementation pro Use-Case.
-
-### Patch Changes
-
-- Updated dependencies [7ff69ab]
-  - @cosmicdrift/kumiko-framework@0.5.0
-  - @cosmicdrift/kumiko-headless@0.5.0
-
-## 0.4.1
-
-### Patch Changes
-
-- 010b410: feat(auth-email-password): "Bestätigungs-Mail erneut senden" im LoginScreen
-
-  LoginScreen bietet bei reason=email_not_verified jetzt einen Resend-Link
-  im Fehler-Banner — der existierende `requestEmailVerification`-Endpoint
-  wird direkt aufgerufen, der Banner wechselt nach Erfolg zum Info-Variant
-  ("Wir haben dir eine neue Bestätigungs-Mail geschickt.").
-
-  UX-Details:
-
-  - Bei 429 → inline-Hint "Bitte warte kurz und versuche es erneut."
-  - Bei Netzwerk/sonstigen Fehlern → inline-Hint "Konnte nicht senden."
-  - Anti-Typo-Gate: ändert der User die Email-Eingabe nach dem Login-Fail,
-    verschwindet der Resend-Link — sonst würde Resend silent-success an die
-    geänderte (potentiell typoed) Adresse gehen ohne User-Feedback.
-  - Andere Failure-Codes (invalid_credentials etc.) zeigen weiterhin keinen
-    Resend-Link.
-
-  i18n: 4 neue Keys (DE+EN) im `auth.login.resend*`-Namespace, additive.
-  Apps die ihre Translations override-en müssen nichts ändern.
-
-  Additive UI-Feature — keine API-Breaks, keine Schema-Migration.
-
-- Updated dependencies [010b410]
-  - @cosmicdrift/kumiko-framework@0.4.1
-  - @cosmicdrift/kumiko-headless@0.4.1
-
-## 0.4.0
-
-### Minor Changes
-
-- 825e7d2: Visual-Tree V.1.4 → V.1.6 — Feature-complete Editor + Folder-Hierarchy + Roving-tabindex.
-
-  **V.1.4** — explicit `folder?: string` Schema-Field auf text-block-entity. Slug bleibt
-  kebab-only validiert, Folder explizit gesetzt. Tree gruppiert via `groupBlocksByFolder`
-  (ersetzt `groupBlocksBySlugPrefix`). `Subscribe<T>` Signature um optional `emitError`
-  erweitert für explicit async-error-Pfade. ProviderBranch zeigt Error-Banner mit
-  Retry-Button. Drift-Test pinnt seedTextBlock-vs-set.write Slug-Validation.
-
-  **V.1.4b** — URL-State-Routing für Editor-Target via `nav.searchParams`. F5 + Back-Button
-  stellen den Editor-State wieder her. Format: `?t=text-content:edit&a_slug=...&a_lang=...`.
-  Plus `useDispatchTarget` hook ersetzt globalen `dispatchTarget` als empfohlenen Production-
-  Pfad (legacy bleibt für Test-Hooks).
-
-  **V.1.5** — Arrow-Key-Navigation (`<aside role="tree">`, ARIA-tree-Pattern) + SSE-driven
-  Tree-Refresh. `ClientFeatureDefinition.treeEntities?: string[]` listet Entity-Namen pro
-  Provider; live-events triggern provider-re-mount → Stale-Tree-state="stub"→"filled"
-  flippt nach save automatisch.
-
-  **V.1.5c+d** — Active-Node-Highlight (explicit blue + 2px border-l + scrollIntoView),
-  VS-Code-Polish (compact spacing, focus-visible, folder-icon-color text-amber, indent-
-  guides per ancestor-depth), Folder-Wrapper für legal-pages ("📁 Legal" + slug-first
-  Verschachtelung) und text-content ("📁 Content").
-
-  **V.1.6** — Multi-level Folder-Splitting (`folder="page/marketing"` → nested folders,
-  walk-or-create-pattern, folder/leaf-collision-tolerant). Roving-tabindex (nur focused-
-  treeitem hat tabIndex=0, Tab cyclt aus dem Tree raus).
-
-  35/35 kumiko check PASS, 13/13 group-blocks + 22/22 text-content integration tests grün.
-  Browser + Keyboard lokal validated.
-
-  **Breaking**: `TreeContext` Type entfernt (V.1.2 SR2-Rip — war nie genutzt). Provider sind
-  session-bound: `TreeChildrenSubscribe = () => Subscribe<T>` statt `(ctx) => Subscribe<T>`.
-
-  **V.1.7-Followups**: useEffect-deps in VisualTree-focus-init (Performance), Cancellation-
-  Token in TreeProvider's fetch (emit-after-unmount-warning), inline-rename, drag-drop,
-  file-icons per slug-extension, parent-jump bei ArrowLeft auf collapsed-item.
-
-### Patch Changes
-
-- Updated dependencies [825e7d2]
-  - @cosmicdrift/kumiko-framework@0.4.0
-  - @cosmicdrift/kumiko-headless@0.4.0
-
-## 0.3.0
-
-### Minor Changes
-
-- 0.3.0 bringt zwei neue Subsysteme (Step-Engine Tier-3 + Visual-Tree) plus
-  eine AST-Codemod-Pipeline als Vorarbeit für den L2-AI-Layer.
-
-  ### Breaking Changes
-
-  - `skipTransitionGuard` → `unsafeSkipTransitionGuard` (Rename in
-    feature-ast + engine). Der `unsafe`-Prefix macht die Tragweite des
-    Casts sichtbar und ist konsistent zur `unsafeProjectionUpsert`- und
-    `r.rawTable`-Konvention. Migration: 1:1-Ersetzung, keine Verhaltens-Änderung.
-
-  ### Features
-
-  - **Step-Engine M.4 — Tier-3 Workflow-Engine.** Neue Step-Vocabulary
-    `wait`, `waitForEvent`, `retry` ermöglicht persistierte Long-Running-Flows
-    über Job-Boundaries hinweg. Q7 Snapshot-at-Start hängt jedem Step-Run
-    einen SHA-256-Fingerprint des Aggregat-Zustands an, sodass Replays
-    deterministisch gegen den ursprünglichen Eingangszustand laufen.
-  - **Visual-Tree V.1.x — Tree-API + Editor-Panel.** Neue `VisualTree`-
-    Component plus TreeProvider-Pattern; erste TreeProviders für
-    `text-content` und `legal-pages` (CMS-light + Impressum/Privacy).
-    Fundament für den späteren No-Code-Designer (~3000 LOC, 98 Tests).
-  - **Codemod-Pipeline.** AST-basierte Patcher-Module für strukturelle
-    Feature-Edits — wird vom kommenden L2-AI-Layer als Tool-Surface
-    verwendet, ist aber eigenständig nutzbar für ts-morph-style Migrationen.
-  - **user-data-rights Sample-Recipe.** DSGVO Art. 15/17/18/20 vollständig
-    als Sample-Recipe (`samples/recipes/`) inklusive README — zeigt die
-    Export- und Forget-Pipeline gegen den `compliance-profiles`-Default
-    (`eu-dsgvo`).
-
-  ### Fixes
-
-  - `tier-engine`: auto-default-tier-Hook benutzt jetzt `ctx.db.raw` für
-    Event-Store-Operationen (#37, vorher: stiller Bug, 22 Tage live).
-  - `engine`: unsafe-projection-upsert nutzt `as never` statt `as any` —
-    schmaler Cast-Surface, weniger Compiler-Knebel.
-  - `visual-tree`: runtime-isolation marker für client-konsumierte Files,
-    damit der Multi-Entry-Build den richtigen Bundle-Split bekommt.
-  - `feature-ast`: vollständiger `unsafeSkipTransitionGuard`-Rename (war
-    in zwei Modulen noch der alte Name).
-  - `framework`: Error-Reasons + `noConsole`-Lint + No-Date-API-Guard
-    wieder push-ready.
-
-  ### Library-Updates
-
-  hono 4.12, jose 6.2, stripe 22.1, meilisearch 0.58, marked 18,
-  bun-types 1.3.13, lucide-react 1.14, bullmq 5.76, ioredis 5.10,
-  i18next 26.0, react + radix-ui-primitives auf aktuelle Minors.
-
-### Patch Changes
-
-- Updated dependencies
-  - @cosmicdrift/kumiko-framework@0.3.0
-  - @cosmicdrift/kumiko-headless@0.3.0
-
-## 0.2.3
-
-### Patch Changes
-
-- @cosmicdrift/kumiko-framework@0.2.3
-- @cosmicdrift/kumiko-headless@0.2.3
-
-## 0.2.2
-
-### Patch Changes
-
-- 7a7da3e: Re-publish 0.2.1 → 0.2.2 mit korrekt aufgelösten cross-package-Versionen.
-  0.2.1 hatte `workspace:*` als Wert in den dependencies (npm publish ohne
-  yarn-pack rewrite), Konsumenten bekamen "Workspace not found".
-
-  publish-with-oidc.sh nutzt jetzt `yarn pack` (rewrited workspace:\*) +
-  `npm publish <tarball>` (OIDC + provenance).
-
-- Updated dependencies [7a7da3e]
-  - @cosmicdrift/kumiko-framework@0.2.2
-  - @cosmicdrift/kumiko-headless@0.2.2
-
-## 0.2.1
-
-### Patch Changes
-
-- 48b7f6a: CI: switch publish to npm-CLI with OIDC Trusted Publishing + provenance.
-  No source changes — verifies the new publish path produces a verified-
-  provenance attestation on npmjs.com instead of token-based publish.
-- Updated dependencies [48b7f6a]
-  - @cosmicdrift/kumiko-framework@0.2.1
-  - @cosmicdrift/kumiko-headless@0.2.1
-
-## 0.2.0
-
-### Minor Changes
-
-- 6c70b6f: fix(tenant): seedTenant idempotent gegen Event-Store-Projection-Drift.
-
-  Verhindert version_conflict beim App-Boot wenn Aggregat existiert aber
-  Projection-Row fehlt (rebuild-drift, async-lag, manueller DB-Eingriff).
-
-### Patch Changes
-
-- Updated dependencies [6c70b6f]
-  - @cosmicdrift/kumiko-framework@0.2.0
-  - @cosmicdrift/kumiko-headless@0.2.0
-
-## 0.1.0
-
-### Minor Changes
-
-- 59ba6d7: Initial public release of Kumiko — AI-native backend builder.
-
-  What ships in 0.1.0:
-
-  - **Engine** (`@cosmicdrift/kumiko-framework`): `defineFeature`, `r.entity`, `r.writeHandler`, `r.queryHandler`, `r.projection`, `r.multiStreamProjection`, `r.hook`, `r.translations`, `r.crud`, `r.referenceData`, `r.screen`, `r.nav`, `r.authClaims`, full lifecycle pipeline with field-level access checks
-  - **Pipeline** (`@cosmicdrift/kumiko-framework`): `createDispatcher`, JWT auth via jose, Zod schema validation, role-based access checks, command/write/query split
-  - **DB** (`@cosmicdrift/kumiko-framework`): Drizzle helpers (`buildDrizzleTable`, `applyCursorQuery`), CRUD executor, Postgres dialect, optimistic locking, soft delete, multi-tenant scoping
-  - **Event sourcing** (`@cosmicdrift/kumiko-framework`): aggregate streams, single + multi-stream projections, event upcasters, asOf queries, archive support, AsyncDaemon-pattern dispatcher
-  - **Bundled features** (`@cosmicdrift/kumiko-bundled-features`): auth-email-password, sessions, tenants, users, jobs, secrets, file-provider-s3, mail-transport-smtp/inmemory, billing-foundation, cap-counter, channel-in-app, delivery, feature-toggles, legal-pages
-  - **Renderer** (`@cosmicdrift/kumiko-renderer`, `@cosmicdrift/kumiko-renderer-web`): schema-driven CRUD UI for React + Expo Web, override paths, list debounce, theme tokens
-  - **Headless** (`@cosmicdrift/kumiko-headless`): view-models for list/edit screens, locale-aware
-  - **Dev server** (`@cosmicdrift/kumiko-dev-server`): `runDevApp`, `runProdApp`, `kumiko-build` for production bundles (client + server), Docker-ready
-  - **Realtime** (`@cosmicdrift/kumiko-dispatcher-live`): SSE broadcast across tenants, Redis Pub/Sub backend
-  - **CLI** (`bin/kumiko.ts`): interactive dev menu, test runners, check pipeline (Biome + TypeScript + 18 guards + Vitest)
-
-  This is a pre-1.0 release — APIs may change between minor versions. Breaking changes will be documented per release.
-
-### Patch Changes
-
-- Updated dependencies [59ba6d7]
-  - @cosmicdrift/kumiko-framework@0.1.0
-  - @cosmicdrift/kumiko-headless@0.1.0