@cosmicdrift/kumiko-framework 0.258.0 → 0.258.1

package/src/pipeline/__tests__/ctx-bridge.integration.test.ts

@@ -26,7 +26,7 @@ import { setupTestStack, type TestStack, TestUsers, unsafeCreateEntityTable } fr
 const bagEntity = createEntity({
   table: "ctx_bags",
   fields: {
-    label: createTextField({ required: true }),
+    label: createTextField({ personal: false, reason: "test_fixture", required: true }),
     counter: createNumberField({ default: 0 }),
   },
 });
@@ -37,8 +37,10 @@ const bagTable = buildEntityTable("bag", bagEntity);
 const secretEntity = createEntity({
   table: "ctx_secrets",
   fields: {
-    owner: createTextField({ required: true }),
+    owner: createTextField({ personal: false, reason: "test_fixture", required: true }),
     token: createTextField({
+      personal: false,
+      reason: "test_fixture",
       required: true,
       access: { read: access.privileged, write: access.privileged },
     }),
@@ -53,7 +55,7 @@ const secretTable = buildEntityTable("secret", secretEntity);
 const echoEntity = createEntity({
   table: "ctx_echoes",
   fields: {
-    bagId: createTextField({ required: true }),
+    bagId: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 const echoTable = buildEntityTable("echo", echoEntity);

package/src/pipeline/__tests__/dispatcher.test.ts

@@ -11,7 +11,13 @@ import { createDispatcher } from "../dispatcher";
 const streamCleanupState = { closed: false };
 
 const echoFeature = defineFeature("echo", (r) => {
-  r.entity("item", createEntity({ table: "Items", fields: { name: createTextField() } }));
+  r.entity(
+    "item",
+    createEntity({
+      table: "Items",
+      fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+    }),
+  );
 
   r.writeHandler(
     "item:create",
@@ -119,7 +125,13 @@ describe("dispatcher.write", () => {
     // it must SKIP the rate-limit — not throw "no RateLimitResolver is
     // configured". (The HTTP path still has the resolver for real anon writes.)
     const rlFeature = defineFeature("rl", (r) => {
-      r.entity("item", createEntity({ table: "Items", fields: { name: createTextField() } }));
+      r.entity(
+        "item",
+        createEntity({
+          table: "Items",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "item:create",
         z.object({ name: z.string() }),
@@ -144,7 +156,13 @@ describe("dispatcher.write", () => {
     // rate-limiting feature. User buckets cannot skip (unlike ip+no-IP), so we
     // fail loud at first write instead of silently running uncapped.
     const rlFeature = defineFeature("rl-user", (r) => {
-      r.entity("item", createEntity({ table: "Items", fields: { name: createTextField() } }));
+      r.entity(
+        "item",
+        createEntity({
+          table: "Items",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "item:create",
         z.object({ name: z.string() }),
@@ -174,7 +192,13 @@ describe("dispatcher.write", () => {
     // gegen denselben SessionUser — sonst ist's nicht der gleiche.
     const captured: { fromEvent?: unknown; fromCtx?: unknown } = {};
     const aliasFeature = defineFeature("alias", (r) => {
-      r.entity("item", createEntity({ table: "Items", fields: { name: createTextField() } }));
+      r.entity(
+        "item",
+        createEntity({
+          table: "Items",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "item:create",
         z.object({ name: z.string() }),
@@ -676,7 +700,13 @@ describe("dispatcher feature-gate", () => {
   function toggled() {
     return defineFeature("toggled", (r) => {
       r.toggleable({ default: true });
-      r.entity("widget", createEntity({ table: "Widgets", fields: { name: createTextField() } }));
+      r.entity(
+        "widget",
+        createEntity({
+          table: "Widgets",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.queryHandler("widget:list", z.object({}).passthrough(), async () => ({ items: [] }), {
         access: { openToAll: true },
       });
@@ -941,7 +971,13 @@ describe("write-handler shape guard", () => {
 
   function brokenFeature() {
     return defineFeature("broken", (r) => {
-      r.entity("item", createEntity({ table: "Items", fields: { name: createTextField() } }));
+      r.entity(
+        "item",
+        createEntity({
+          table: "Items",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "item:create",
         z.object({ name: z.string() }),

package/src/pipeline/__tests__/domain-events-projections.integration.test.ts

@@ -35,8 +35,8 @@ import {
 const shipmentEntity = createEntity({
   table: "read_domain_shipments",
   fields: {
-    cargo: createTextField({ required: true }),
-    status: createTextField({ required: true }),
+    cargo: createTextField({ personal: false, reason: "test_fixture", required: true }),
+    status: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 

package/src/pipeline/__tests__/fetch-for-writing.integration.test.ts

@@ -22,7 +22,7 @@ import { setupTestStack, type TestStack, TestUsers, unsafeCreateEntityTable } fr
 const cartEntity = createEntity({
   table: "read_f4w_carts",
   fields: {
-    customer: createTextField({ required: true }),
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 

package/src/pipeline/__tests__/lifecycle-pipeline.test.ts

@@ -15,7 +15,13 @@ import { buildEventId, createLifecycleHooks, type SystemHooks } from "../lifecyc
 
 function makeRegistry(hooks?: { preSave?: PreSaveHookFn[]; postSave?: PostSaveHookFn[] }) {
   const feature = defineFeature("test", (r) => {
-    r.entity("user", createEntity({ table: "Users", fields: { email: createTextField() } }));
+    r.entity(
+      "user",
+      createEntity({
+        table: "Users",
+        fields: { email: createTextField({ personal: false, reason: "test_fixture" }) },
+      }),
+    );
     // Dummy handler so hook targets resolve (boot validation requires it)
     r.writeHandler("user", z.object({}), async () => ({ isSuccess: true as const, data: null }), {
       access: { openToAll: true },
@@ -422,7 +428,13 @@ describe("Sprint 8a: per-tenant entity-hook filter", () => {
     const calls: Array<{ tenant: string }> = [];
 
     const featureA = defineFeature("feat-a", (r) => {
-      r.entity("widget", createEntity({ table: "Widgets", fields: { name: createTextField() } }));
+      r.entity(
+        "widget",
+        createEntity({
+          table: "Widgets",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "widget:create",
         z.object({ name: z.string() }),
@@ -550,7 +562,13 @@ describe("runPreDelete", () => {
   test("runs feature + entity + system hooks, all inTransaction (throw on error)", async () => {
     const calls: string[] = [];
     const feature = defineFeature("test", (r) => {
-      r.entity("user", createEntity({ table: "Users", fields: { email: createTextField() } }));
+      r.entity(
+        "user",
+        createEntity({
+          table: "Users",
+          fields: { email: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler("user", z.object({}), async () => ({ isSuccess: true as const, data: null }), {
         access: { openToAll: true },
       });
@@ -580,7 +598,13 @@ describe("runPreDelete", () => {
 
   test("a hook throwing aborts the delete (rejects, not swallowed)", async () => {
     const feature = defineFeature("test", (r) => {
-      r.entity("user", createEntity({ table: "Users", fields: { email: createTextField() } }));
+      r.entity(
+        "user",
+        createEntity({
+          table: "Users",
+          fields: { email: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler("user", z.object({}), async () => ({ isSuccess: true as const, data: null }), {
         access: { openToAll: true },
       });
@@ -620,7 +644,13 @@ describe("runPostDelete", () => {
   test("runs feature then system hooks (best-effort by default phase)", async () => {
     const calls: string[] = [];
     const feature = defineFeature("test", (r) => {
-      r.entity("user", createEntity({ table: "Users", fields: { email: createTextField() } }));
+      r.entity(
+        "user",
+        createEntity({
+          table: "Users",
+          fields: { email: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler("user", z.object({}), async () => ({ isSuccess: true as const, data: null }), {
         access: { openToAll: true },
       });
@@ -647,7 +677,13 @@ describe("runPostDelete", () => {
 
   test("inTransaction phase: hook errors throw", async () => {
     const feature = defineFeature("test", (r) => {
-      r.entity("user", createEntity({ table: "Users", fields: { email: createTextField() } }));
+      r.entity(
+        "user",
+        createEntity({
+          table: "Users",
+          fields: { email: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler("user", z.object({}), async () => ({ isSuccess: true as const, data: null }), {
         access: { openToAll: true },
       });

package/src/pipeline/__tests__/load-aggregate-query.integration.test.ts

@@ -29,8 +29,8 @@ import {
 const invoiceEntity = createEntity({
   table: "read_asof_invoices",
   fields: {
-    customer: createTextField({ required: true }),
-    status: createTextField({ required: true }),
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
+    status: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 const invoiceTable = buildEntityTable("asof-invoice", invoiceEntity);

package/src/pipeline/__tests__/msp-multi-hop.integration.test.ts

@@ -30,7 +30,7 @@ import {
 const orderEntity = createEntity({
   table: "read_mmh_orders",
   fields: {
-    item: createTextField({ required: true }),
+    item: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 

package/src/pipeline/__tests__/msp-rebuild.integration.test.ts

@@ -40,13 +40,17 @@ import {
 
 const invoiceEntity = createEntity({
   table: "read_mspreb_invoices",
-  fields: { customer: createTextField({ required: true }) },
+  fields: {
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
+  },
 });
 const invoiceTable = buildEntityTable("msp-reb-invoice", invoiceEntity);
 
 const paymentEntity = createEntity({
   table: "read_mspreb_payments",
-  fields: { customer: createTextField({ required: true }) },
+  fields: {
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
+  },
 });
 const paymentTable = buildEntityTable("msp-reb-payment", paymentEntity);
 

package/src/pipeline/__tests__/multi-stream-projection.integration.test.ts

@@ -26,13 +26,17 @@ import {
 
 const shipmentEntity = createEntity({
   table: "read_msp_shipments",
-  fields: { customer: createTextField({ required: true }) },
+  fields: {
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
+  },
 });
 const shipmentTable = buildEntityTable("msp-shipment", shipmentEntity);
 
 const refundEntity = createEntity({
   table: "read_msp_refunds",
-  fields: { customer: createTextField({ required: true }) },
+  fields: {
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
+  },
 });
 const refundTable = buildEntityTable("msp-refund", refundEntity);
 

package/src/pipeline/__tests__/perf-rebuild.integration.test.ts

@@ -52,7 +52,7 @@ const taskCountProjection: ProjectionDefinition = {
 
 const taskEntity = createEntity({
   table: "perf_rebuild_tasks",
-  fields: { title: createTextField({ required: true }) },
+  fields: { title: createTextField({ personal: false, reason: "test_fixture", required: true }) },
 });
 
 const feature = defineFeature("perfrebuild", (r) => {

package/src/pipeline/__tests__/post-query-hook.integration.test.ts

@@ -20,7 +20,7 @@ import { setupTestStack, type TestStack, TestUsers } from "../../stack";
 const widgetEntity = createEntity({
   table: "read_post_query_widgets",
   fields: {
-    name: createTextField({ required: true }),
+    name: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 
@@ -78,11 +78,11 @@ const postQueryFeature = defineFeature("postquerytest", (r) => {
 
 const gadgetEntity = createEntity({
   table: "read_post_query_gadgets",
-  fields: { name: createTextField({ required: true }) },
+  fields: { name: createTextField({ personal: false, reason: "test_fixture", required: true }) },
 });
 const gizmoEntity = createEntity({
   table: "read_post_query_gizmos",
-  fields: { name: createTextField({ required: true }) },
+  fields: { name: createTextField({ personal: false, reason: "test_fixture", required: true }) },
 });
 
 const dropRowHook: PostQueryHookFn = async () => ({ rows: [] });

package/src/pipeline/__tests__/projection-rebuild.integration.test.ts

@@ -47,8 +47,8 @@ import {
 const itemEntity = createEntity({
   table: "read_rebuild_items",
   fields: {
-    groupId: createTextField({ required: true }),
-    name: createTextField({ required: true }),
+    groupId: createTextField({ personal: false, reason: "test_fixture", required: true }),
+    name: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
   softDelete: true,
 });
@@ -586,7 +586,7 @@ describe("rebuildProjection — online shadow-swap mechanics", () => {
   // list/progress tests above keep seeing exactly one registered projection.
   const swapEntity = createEntity({
     table: "read_swap_indexed",
-    fields: { label: createTextField({ required: true }) },
+    fields: { label: createTextField({ personal: false, reason: "test_fixture", required: true }) },
   });
   const swapTable = buildEntityTable("swap-indexed", swapEntity);
   // Empty apply: a 0-event rebuild still builds the shadow + swaps it in, so

package/src/pipeline/__tests__/query-projection.integration.test.ts

@@ -25,7 +25,7 @@ import {
 
 const widgetEntity = createEntity({
   table: "read_qp_widgets",
-  fields: { name: createTextField({ required: true }) },
+  fields: { name: createTextField({ personal: false, reason: "test_fixture", required: true }) },
 });
 const widgetTable = buildEntityTable("qp-widget", widgetEntity);
 

package/src/pipeline/__tests__/rebuild-poison-quarantine.integration.test.ts

@@ -48,8 +48,8 @@ const POISON_SQL = "poison-sql";
 const itemEntity = createEntity({
   table: "read_poison_items",
   fields: {
-    groupId: createTextField({ required: true }),
-    name: createTextField({ required: true }),
+    groupId: createTextField({ personal: false, reason: "test_fixture", required: true }),
+    name: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 const itemTable = buildEntityTable("poison-item", itemEntity);

package/src/pipeline/__tests__/search-consumer-named-events.integration.test.ts

@@ -18,7 +18,13 @@ import { SEARCH_CONSUMER_NAME } from "../system-hooks";
 const noteEntity = createEntity({
   table: "read_named_search_notes",
   fields: {
-    label: createTextField({ required: true, maxLength: 100, searchable: true }),
+    label: createTextField({
+      personal: false,
+      reason: "test_fixture",
+      required: true,
+      maxLength: 100,
+      searchable: true,
+    }),
   },
   softDelete: true,
 });
@@ -29,7 +35,12 @@ const noteTable = buildEntityTable("note", noteEntity);
 const ghostEntity = createEntity({
   table: "read_named_search_ghosts",
   fields: {
-    note: createTextField({ required: true, maxLength: 50 }),
+    note: createTextField({
+      personal: false,
+      reason: "test_fixture",
+      required: true,
+      maxLength: 50,
+    }),
   },
 });
 

package/src/pipeline/__tests__/try-append-event.integration.test.ts

@@ -37,7 +37,7 @@ const TAE_AGGREGATE_TYPE = "taeDoc";
 const markerEntity = createEntity({
   table: "tae_markers",
   fields: {
-    note: createTextField({ required: true }),
+    note: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 const markerTable = buildEntityTable("taeMarker", markerEntity);

package/src/search/__tests__/reindex-entity.integration.test.ts

@@ -31,7 +31,12 @@ const widgetEntity = createEntity({
   table: "read_reindex_widgets",
   softDelete: true,
   fields: {
-    name: createTextField({ required: true, searchable: true }),
+    name: createTextField({
+      personal: false,
+      reason: "test_fixture",
+      required: true,
+      searchable: true,
+    }),
   },
 });
 

package/src/search/__tests__/search-pii-derived-index.integration.test.ts

@@ -20,7 +20,13 @@ const contactEntity = createEntity({
   fields: {
     // personal: "self" → subject = entity id. find: "fuzzy" → searchable via derived index.
     label: createTextField({ required: true, maxLength: 100, personal: "self", find: "fuzzy" }),
-    note: createTextField({ required: true, maxLength: 100, searchable: true }),
+    note: createTextField({
+      personal: false,
+      reason: "test_fixture",
+      required: true,
+      maxLength: 100,
+      searchable: true,
+    }),
   },
 });
 

package/src/stack/__tests__/ownership-boot-guard.integration.test.ts

@@ -38,7 +38,7 @@ function memoEntity(access: Parameters<typeof createEntity>[0]["access"]) {
     table: "fwbootguard_memos",
     fields: {
       ownerId: createTextField({ required: true }),
-      title: createTextField({ required: true }),
+      title: createTextField({ personal: false, reason: "test_fixture", required: true }),
     },
     ...(access ? { access } : {}),
   });

package/src/testing/__tests__/e2e-generator.test.ts

@@ -16,7 +16,12 @@ import { generateE2ESpec, generateZodFixture } from "../e2e-generator";
 const taskEntity = createEntity({
   table: "tasks",
   fields: {
-    title: createTextField({ required: true, maxLength: 200 }),
+    title: createTextField({
+      personal: false,
+      reason: "test_fixture",
+      required: true,
+      maxLength: 200,
+    }),
     done: createBooleanField({ default: false }),
     status: createSelectField({ options: ["todo", "doing", "done"] as const }),
   },
@@ -92,7 +97,7 @@ describe("generateE2ESpec", () => {
     const entity = createEntity({
       table: "events",
       fields: {
-        title: createTextField({ required: true }),
+        title: createTextField({ personal: false, reason: "test_fixture", required: true }),
         day: createDateField(),
         at: createTimestampField(),
       },
@@ -180,9 +185,14 @@ describe("generateE2ESpec", () => {
     const contactEntity = createEntity({
       table: "contacts",
       fields: {
-        name: createTextField({ required: true }),
-        email: createTextField({ required: true, format: "email" }),
-        homepage: createTextField({ format: "url" }),
+        name: createTextField({ personal: false, reason: "test_fixture", required: true }),
+        email: createTextField({
+          personal: false,
+          reason: "test_fixture",
+          required: true,
+          format: "email",
+        }),
+        homepage: createTextField({ personal: false, reason: "test_fixture", format: "url" }),
       },
     });
     const feature = defineFeature("contacts", (r) => {

package/src/testing/shared-entities.ts

@@ -17,7 +17,9 @@ import {
 // Used by every pipeline test that only needs SOMETHING to write events
 // against (event-dispatcher*, event-retention, event-dedup, …).
 export const sharedWidgetEntity = createEntity({
-  fields: { name: createTextField({ required: true }) },
+  fields: {
+    name: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+  },
   softDelete: true,
 });
 export const sharedWidgetTable = buildEntityTable("widget", sharedWidgetEntity);
@@ -55,7 +57,7 @@ export const sharedUserTable = buildEntityTable("user", sharedUserEntity);
 // projection-rebuild — tests that need "a thing you can CRUD".
 export const sharedItemEntity = createEntity({
   fields: {
-    name: createTextField({ required: true }),
+    name: createTextField({ required: true, personal: false, reason: "test_fixture" }),
     price: createNumberField(),
   },
   softDelete: true,