@cosmicdrift/kumiko-framework 0.258.0 → 0.259.0

package/src/engine/__tests__/projection.test.ts

@@ -17,7 +17,7 @@ const testTable = table("test_projection", {
 function exampleEntity(name = "unit") {
   return createEntity({
     table: name,
-    fields: { name: createTextField() },
+    fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
   });
 }
 

package/src/engine/__tests__/registry.test.ts

@@ -65,11 +65,15 @@ describe("getAllQueryHandlers", () => {
   test("returns every registered query handler, qualified, across multiple features", () => {
     const taskEntity = createEntity({
       table: "registry_test_tasks",
-      fields: { title: createTextField({ required: true }) },
+      fields: {
+        title: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+      },
     });
     const noteEntity = createEntity({
       table: "registry_test_notes",
-      fields: { body: createTextField({ required: true }) },
+      fields: {
+        body: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+      },
     });
     const taskFeature = defineFeature("registry-test-task", (r) => {
       r.crud("task", taskEntity, {
@@ -283,7 +287,13 @@ describe("extensionSelector boot-validation", () => {
     });
     const consumer = defineFeature("money-horse", (r) => {
       r.requires("cap-ext");
-      r.entity("credit", createEntity({ table: "Credits", fields: { name: createTextField() } }));
+      r.entity(
+        "credit",
+        createEntity({
+          table: "Credits",
+          fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+        }),
+      );
       r.writeHandler(
         "doSomething",
         z.object({}),

package/src/engine/__tests__/schema-builder.test.ts

@@ -32,25 +32,34 @@ describe("buildInsertSchema", () => {
   test.each<SchemaCase>([
     {
       name: "required text field",
-      fields: { email: createTextField({ required: true }) },
+      fields: {
+        email: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+      },
       valid: { email: "test@test.de" },
       invalid: { email: "" },
     },
     {
       name: "optional text field",
-      fields: { name: createTextField() },
+      fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
       valid: {},
       invalid: null,
     },
     {
       name: "text field with maxLength",
-      fields: { name: createTextField({ maxLength: 5 }) },
+      fields: { name: createTextField({ maxLength: 5, personal: false, reason: "test_fixture" }) },
       valid: { name: "hello" },
       invalid: { name: "toolong" },
     },
     {
       name: "email format",
-      fields: { email: createTextField({ required: true, format: "email" }) },
+      fields: {
+        email: createTextField({
+          required: true,
+          format: "email",
+          personal: false,
+          reason: "test_fixture",
+        }),
+      },
       valid: { email: "a@b.de" },
       invalid: { email: "not-an-email" },
     },
@@ -166,8 +175,13 @@ describe("buildInsertSchema", () => {
     const entity = createEntity({
       table: "Users",
       fields: {
-        email: createTextField({ required: true, format: "email" }),
-        firstName: createTextField(),
+        email: createTextField({
+          required: true,
+          format: "email",
+          personal: false,
+          reason: "test_fixture",
+        }),
+        firstName: createTextField({ personal: false, reason: "test_fixture" }),
         isEnabled: createBooleanField({ default: true }),
         locale: createSelectField({ options: ["de", "en"] as const }),
       },
@@ -281,7 +295,9 @@ describe("buildInsertSchema", () => {
   test("required text rejects empty string", () => {
     const entity = createEntity({
       table: "Test",
-      fields: { name: createTextField({ required: true }) },
+      fields: {
+        name: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+      },
     });
     const schema = buildInsertSchema(entity);
     expect(schema.safeParse({ name: "" }).success).toBe(false);
@@ -353,7 +369,7 @@ describe("buildInsertSchema", () => {
     const entity = createEntity({
       table: "Test",
       fields: {
-        name: createTextField({ required: true }),
+        name: createTextField({ required: true, personal: false, reason: "test_fixture" }),
         address: createEmbeddedField({ street: { type: "text" } }),
       },
     });
@@ -1061,8 +1077,13 @@ describe("buildUpdateSchema", () => {
     const entity = createEntity({
       table: "Users",
       fields: {
-        email: createTextField({ required: true, format: "email" }),
-        firstName: createTextField(),
+        email: createTextField({
+          required: true,
+          format: "email",
+          personal: false,
+          reason: "test_fixture",
+        }),
+        firstName: createTextField({ personal: false, reason: "test_fixture" }),
         isEnabled: createBooleanField(),
       },
     });
@@ -1082,7 +1103,14 @@ describe("buildUpdateSchema", () => {
   test("still validates format on provided fields", () => {
     const entity = createEntity({
       table: "Users",
-      fields: { email: createTextField({ required: true, format: "email" }) },
+      fields: {
+        email: createTextField({
+          required: true,
+          format: "email",
+          personal: false,
+          reason: "test_fixture",
+        }),
+      },
     });
 
     const schema = buildUpdateSchema(entity);

package/src/engine/__tests__/screen.test.ts

@@ -16,8 +16,8 @@ function productEntity() {
   return createEntity({
     table: "products",
     fields: {
-      name: createTextField(),
-      sku: createTextField(),
+      name: createTextField({ personal: false, reason: "test_fixture" }),
+      sku: createTextField({ personal: false, reason: "test_fixture" }),
     },
   });
 }
@@ -26,7 +26,7 @@ function derivedProductEntity() {
   return createEntity({
     table: "derived_products",
     fields: {
-      name: createTextField(),
+      name: createTextField({ personal: false, reason: "test_fixture" }),
     },
     derivedFields: {
       summary: createDerivedField({
@@ -306,7 +306,10 @@ describe("r.screen() — registration", () => {
       defineFeature("billing", (r) => {
         r.entity(
           "invoice",
-          createEntity({ table: "invoices", fields: { name: createTextField() } }),
+          createEntity({
+            table: "invoices",
+            fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+          }),
         );
         r.screen({
           id: "invoice-detail",
@@ -695,7 +698,10 @@ describe("r.screen() — registration", () => {
       defineFeature("billing", (r) => {
         r.entity(
           "invoice",
-          createEntity({ table: "invoices", fields: { name: createTextField() } }),
+          createEntity({
+            table: "invoices",
+            fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+          }),
         );
         r.screen({
           id: "invoice-detail",
@@ -774,7 +780,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: [],
                 handler: "app:write:save",
               },
@@ -798,7 +804,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["sku"],
                 handler: "app:write:save",
               },
@@ -825,7 +831,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "app:write:save",
               },
@@ -849,7 +855,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "app:write:missing",
               },
@@ -886,7 +892,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "app:write:save",
                 submitLabel: "actions.save",
@@ -928,7 +934,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "app:write:save",
               },
@@ -970,7 +976,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "app:write:save",
               },
@@ -996,7 +1002,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "shop:write:save",
               },
@@ -1027,7 +1033,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "shop:write:save",
               },
@@ -1060,7 +1066,7 @@ describe("r.screen() — registration", () => {
               {
                 kind: "writeForm",
                 title: "s",
-                fieldDefs: { name: createTextField() },
+                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
                 fields: ["name"],
                 handler: "shop:write:save",
               },

package/src/engine/__tests__/search-payload-extension.test.ts

@@ -124,7 +124,12 @@ describe("buildSearchDocument — contributor precedence (base fields win)", ()
     const feature = defineFeature("test", (r) => {
       const thing = r.entity(
         "thing",
-        createEntity({ table: "things", fields: { title: createTextField({ searchable: true }) } }),
+        createEntity({
+          table: "things",
+          fields: {
+            title: createTextField({ searchable: true, personal: false, reason: "test_fixture" }),
+          },
+        }),
       );
       r.searchPayloadExtension(thing, contributor);
     });
@@ -151,7 +156,9 @@ describe("buildSearchDocument — contributor precedence (base fields win)", ()
         "thing-dedup",
         createEntity({
           table: "things_dedup",
-          fields: { title: createTextField({ searchable: true }) },
+          fields: {
+            title: createTextField({ searchable: true, personal: false, reason: "test_fixture" }),
+          },
         }),
       );
       r.searchPayloadExtension(thing, () => ({ title: "from-contributor" }));
@@ -177,7 +184,12 @@ describe("buildSearchDocument — contributor precedence (base fields win)", ()
     const feature = defineFeature("test", (r) => {
       const thing = r.entity(
         "thing",
-        createEntity({ table: "things", fields: { title: createTextField({ searchable: true }) } }),
+        createEntity({
+          table: "things",
+          fields: {
+            title: createTextField({ searchable: true, personal: false, reason: "test_fixture" }),
+          },
+        }),
       );
       r.searchPayloadExtension(thing, () => ({ overlap: "first" }));
       r.searchPayloadExtension(thing, () => ({ overlap: "second" }));

package/src/engine/__tests__/store-table.test.ts

@@ -65,7 +65,7 @@ describe("r.storeTable — declaration", () => {
   test("rejects an EntityTableMeta whose source is not 'unmanaged' (#1209)", () => {
     const managedEntity = createEntity({
       table: "rt_probe_managed",
-      fields: { name: createTextField() },
+      fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
     });
     const managedMeta = deriveEntityTableMeta("rt-probe-managed", managedEntity);
     expect(() =>
@@ -173,7 +173,10 @@ describe("createRegistry — storeTable aggregation", () => {
     // default would carry read_, which r.storeTable now rejects outright
     // (#1220), so the collision case needs a table name storeTable can
     // actually register.
-    const widget = createEntity({ table: "shop_widgets", fields: { name: createTextField() } });
+    const widget = createEntity({
+      table: "shop_widgets",
+      fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
+    });
     // resolveTableName mirrors the migrate-runner — pin the exact physical name.
     const physical = resolveTableName("widget", widget, "shop");
     const clashing = defineUnmanagedTable({
@@ -203,7 +206,7 @@ describe("createRegistry — store tables with PII-annotated fields (#820)", ()
   const piiEntity = createEntity({
     table: "rt_pii_probe",
     fields: {
-      userId: createTextField({ required: true }),
+      userId: createTextField({ required: true, personal: false, reason: "test_fixture" }),
       ip: createTextField({
         personal: { of: "userId" },
         find: "none",

package/src/engine/__tests__/validate-projection-allowlist.test.ts

@@ -52,7 +52,9 @@ describe("validateProjectionAllowlist", () => {
         "widget",
         createEntity({
           table: "widgets",
-          fields: { label: createTextField({ required: true }) },
+          fields: {
+            label: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+          },
         }),
       );
     });
@@ -97,7 +99,9 @@ describe("validateProjectionAllowlist", () => {
         "widget",
         createEntity({
           table: "widgets-delete",
-          fields: { label: createTextField({ required: true }) },
+          fields: {
+            label: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+          },
         }),
       );
     });
@@ -353,7 +357,9 @@ describe("validateProjectionAllowlist", () => {
         "thing",
         createEntity({
           table: "shared_table",
-          fields: { label: createTextField({ required: true }) },
+          fields: {
+            label: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+          },
         }),
       );
     });
@@ -362,7 +368,9 @@ describe("validateProjectionAllowlist", () => {
         "thing",
         createEntity({
           table: "shared_table",
-          fields: { label: createTextField({ required: true }) },
+          fields: {
+            label: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+          },
         }),
       );
     });

package/src/engine/__tests__/validation-hooks.test.ts

@@ -6,7 +6,13 @@ import { runValidation } from "../validation";
 describe("validation hooks", () => {
   test("r.hook registers validation hook", () => {
     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.hook("validation", "user:create", (data) => {
         const errors: ValidationError[] = [];
         if (!data["email"]) errors.push({ field: "email", error: "required" });

package/src/engine/boot-validator/__tests__/ownership.test.ts

@@ -32,8 +32,8 @@ function featureWith(entityAccess: AccessMaps, fieldAccess?: AccessMaps): Featur
       createEntity({
         table: "fw2626_guard_memos",
         fields: {
-          ownerId: createTextField({ required: true }),
-          title: createTextField({ access: fieldAccess }),
+          ownerId: createTextField({ required: true, personal: false, reason: "test_fixture" }),
+          title: createTextField({ access: fieldAccess, personal: false, reason: "test_fixture" }),
         },
         access: entityAccess,
       }),

package/src/engine/boot-validator/query-refs.ts

@@ -56,6 +56,17 @@ function checkDashboardQueryRefs(
 ): void {
   for (const panel of screen.panels) {
     if (panel.kind === "custom") continue;
+    if (panel.kind === "screen") {
+      if (panel.visibleWhen !== undefined) {
+        checkQueryRef(
+          queryHandlers,
+          panel.visibleWhen.query,
+          () =>
+            `[Feature ${featureName}] Screen "${screenId}" (dashboard) screen-panel "${panel.id}" visibleWhen`,
+        );
+      }
+      continue;
+    }
     if (panel.kind === "stat-group") {
       for (const stat of panel.stats) {
         checkQueryRef(

package/src/engine/boot-validator/screens.ts

@@ -23,6 +23,7 @@ import type {
   DashboardFilterDefinition,
   DashboardPanelDefinition,
   DashboardScreenDefinition,
+  DashboardScreenPanel,
   DashboardStatGroupPanel,
   EditFieldSpec,
   EditLayout,
@@ -1234,7 +1235,7 @@ export function validateScreens(
     }
 
     if (screen.type === "dashboard") {
-      validateDashboardScreen(feature.name, screenId, screen);
+      validateDashboardScreen(feature.name, screenId, screen, featureMap);
       continue;
     }
 
@@ -1807,6 +1808,7 @@ function validateDashboardScreen(
   featureName: string,
   screenId: string,
   screen: DashboardScreenDefinition,
+  featureMap: ReadonlyMap<string, FeatureDefinition>,
 ): void {
   if (screen.panels.length === 0) {
     throw new Error(
@@ -1830,6 +1832,8 @@ function validateDashboardScreen(
       validateDashboardStatGroupPanel(featureName, screenId, panel, addPanelId);
     } else if (panel.kind === "custom") {
       validateDashboardCustomPanel(featureName, screenId, panel);
+    } else if (panel.kind === "screen") {
+      validateDashboardScreenPanel(featureName, screenId, panel, featureMap);
     } else {
       validateDashboardQueryPanel(featureName, screenId, panel);
     }
@@ -1840,6 +1844,42 @@ function validateDashboardScreen(
   }
 }
 
+const EMBEDDABLE_SCREEN_TYPES: ReadonlySet<ScreenDefinition["type"]> = new Set([
+  "projectionList",
+  "actionForm",
+  "secretMint",
+  "configEdit",
+  "secretsEdit",
+]);
+
+function validateDashboardScreenPanel(
+  featureName: string,
+  screenId: string,
+  panel: DashboardScreenPanel,
+  featureMap: ReadonlyMap<string, FeatureDefinition>,
+): void {
+  const context = `[Feature ${featureName}] Screen "${screenId}" (dashboard) screen-panel "${panel.id}"`;
+  const targetQn = resolveScreenTargetQn(featureName, panel.screen);
+  const [targetFeatureName = "", , targetShortId = ""] = targetQn.split(":");
+  const target = featureMap.get(targetFeatureName)?.screens[targetShortId];
+  if (target === undefined) {
+    throw new Error(
+      `${context} screen "${panel.screen}" does not resolve to a registered screen (checked "${targetQn}"). ` +
+        `Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>".`,
+    );
+  }
+  if (!EMBEDDABLE_SCREEN_TYPES.has(target.type)) {
+    throw new Error(
+      `${context} embeds "${targetQn}" of type "${target.type}", which can't be embedded — allowed: ` +
+        `${[...EMBEDDABLE_SCREEN_TYPES].join(", ")}. Use a custom panel for app components.`,
+    );
+  }
+  const visibleWhen = panel.visibleWhen;
+  if (visibleWhen !== undefined && (visibleWhen.query === "" || visibleWhen.field === "")) {
+    throw new Error(`${context} visibleWhen needs a non-empty query and field.`);
+  }
+}
+
 function validateDashboardStatGroupPanel(
   featureName: string,
   screenId: string,
@@ -1882,7 +1922,10 @@ function validateDashboardCustomPanel(
 function validateDashboardQueryPanel(
   featureName: string,
   screenId: string,
-  panel: Exclude<DashboardPanelDefinition, DashboardStatGroupPanel | DashboardCustomPanel>,
+  panel: Exclude<
+    DashboardPanelDefinition,
+    DashboardStatGroupPanel | DashboardCustomPanel | DashboardScreenPanel
+  >,
 ): void {
   if (!panel.query || typeof panel.query !== "string") {
     throw new Error(

package/src/engine/build-config-feature-schema.ts

@@ -442,9 +442,9 @@ function deriveField(def: ConfigKeyDefinition): FieldDefinition {
     case "select":
       return def.options !== undefined && def.options.length > 0
         ? createSelectField({ options: def.options })
-        : createTextField();
+        : createTextField({ personal: false, reason: "system_metadata" });
     default:
-      return createTextField();
+      return createTextField({ personal: false, reason: "system_metadata" });
   }
 }
 

package/src/engine/index.ts

@@ -333,8 +333,10 @@ export type {
   DashboardFilterDefinition,
   DashboardListPanel,
   DashboardPanelDefinition,
+  DashboardPanelVisibility,
   DashboardProgressListPanel,
   DashboardScreenDefinition,
+  DashboardScreenPanel,
   DashboardStatGroupPanel,
   DashboardStatPanel,
   DateFieldDef,

package/src/engine/types/index.ts

@@ -270,8 +270,10 @@ export type {
   DashboardFilterDefinition,
   DashboardListPanel,
   DashboardPanelDefinition,
+  DashboardPanelVisibility,
   DashboardProgressListPanel,
   DashboardScreenDefinition,
+  DashboardScreenPanel,
   DashboardStatGroupPanel,
   DashboardStatPanel,
   EditExtensionSection,

package/src/es-ops/__tests__/runner.integration.test.ts

@@ -43,7 +43,7 @@ import { runPendingSeedMigrations } from "../runner";
 // is exercised against the production write-pipeline, not a stubbed return.
 const probeEntity = createEntity({
   table: "read_esops_probes",
-  fields: { label: createTextField({ required: true }) },
+  fields: { label: createTextField({ personal: false, reason: "test_fixture", required: true }) },
 });
 const probeTable = buildEntityTable("esops-probe", probeEntity);
 const probeExecutor = createEventStoreExecutor(probeTable, probeEntity, {

package/src/event-store/__tests__/upcaster.integration.test.ts

@@ -33,7 +33,7 @@ import { upcastStoredEvent } from "../upcaster";
 const orderEntity = createEntity({
   table: "read_upcast_orders",
   fields: {
-    customer: createTextField({ required: true }),
+    customer: createTextField({ personal: false, reason: "test_fixture", required: true }),
   },
 });
 const orderTable = buildEntityTable("upcast-order", orderEntity);

package/src/files/__tests__/file-field-pipeline.integration.test.ts

@@ -47,7 +47,7 @@ import { createLocalProvider } from "../local-provider";
 const documentEntity = createEntity({
   table: "pipeline_documents",
   fields: {
-    title: createTextField({ required: true }),
+    title: createTextField({ personal: false, reason: "test_fixture", required: true }),
     attachment: createFileField(),
     cover: createImageField(),
     photos: createImagesField(),

package/src/files/__tests__/files.integration.test.ts

@@ -57,7 +57,7 @@ const JWT_SECRET = "files-test-secret-at-least-32-characters!!";
 const testTenantEntity = createEntity({
   table: "test_tenants",
   fields: {
-    name: createTextField({ required: true }),
+    name: createTextField({ personal: false, reason: "test_fixture", required: true }),
     logo: createImageField({ maxSize: "2mb", accept: ["png", "jpg"] }),
   },
 });

package/src/files/file-ref-entity.ts

@@ -14,20 +14,20 @@ import { createBigIntField, createEntity, createTextField } from "../engine";
 // ohne `.default(now()).notNull()` macht inserted_at still nullable.
 //
 // PII-Annotations:
-//   - fileName → personal: "self" (Originalname enthält oft Personen-Bezug:
-//     "Marc-Lebenslauf.pdf", "Krankheitsattest-Mai.pdf"). Andere Felder
-//     (storageKey, mimeType, size, entityType, entityId, fieldName) treffen
-//     die PII-Heuristik nicht.
+//   - fileName → personal: "self" (original filename often carries a personal
+//     reference: "Marc-Lebenslauf.pdf", "Krankheitsattest-Mai.pdf"). The other
+//     fields (storageKey, mimeType, entityType, entityId, fieldName) are
+//     technical references or system metadata, not subject content.
 export const fileRefEntity = createEntity({
   table: "file_refs",
   softDelete: true,
   fields: {
-    storageKey: createTextField({ required: true }),
+    storageKey: createTextField({ required: true, personal: false, reason: "technical_reference" }),
     fileName: createTextField({ required: true, personal: "self", find: "none" }),
-    mimeType: createTextField({ required: true }),
+    mimeType: createTextField({ required: true, personal: false, reason: "system_metadata" }),
     size: createBigIntField({ required: true }),
-    entityType: createTextField(),
-    entityId: createTextField(),
-    fieldName: createTextField(),
+    entityType: createTextField({ personal: false, reason: "technical_reference" }),
+    entityId: createTextField({ personal: false, reason: "technical_reference" }),
+    fieldName: createTextField({ personal: false, reason: "technical_reference" }),
   },
 });

package/src/i18n/__tests__/i18n.test.ts

@@ -4,7 +4,13 @@ import { createI18n } from "../index";
 
 describe("createI18n", () => {
   const adminFeature = defineFeature("adminUsers", (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.translations({
       keys: {
         "nav.title": { de: "Benutzer", en: "Users" },

package/src/migrations/__tests__/kumiko-drift.integration.test.ts

@@ -198,7 +198,9 @@ describe("kumiko-drift end-to-end (generate → apply → gate)", () => {
   test("generate from entity metas → apply → gate ok (the local-verify proof)", async () => {
     const entity = createEntity({
       table: "kdrift_gen",
-      fields: { name: createTextField({ required: true }) },
+      fields: {
+        name: createTextField({ personal: false, reason: "test_fixture", required: true }),
+      },
     });
     const meta = deriveEntityTableMeta("kdriftGen", entity);
     const result = generateMigration({