@cosmicdrift/kumiko-framework 0.367.0 → 0.369.0

package/agents/examples/event-sourcing.md

@@ -96,8 +96,8 @@ Six integration tests pin everything at once:
 //   - getAllProjectionProgress (projection lag for ops dashboards)
 
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
-import { insertOne, selectMany } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { DbTx } from "@cosmicdrift/kumiko-framework/db";
+import { insertOne, selectMany } from "@cosmicdrift/kumiko-framework/db";
 import {
   append,
   loadAggregate as loadAggregateRaw,
@@ -106,14 +106,14 @@ import {
   upcastStoredEvent,
 } from "@cosmicdrift/kumiko-framework/event-store";
 import { getAllProjectionProgress } from "@cosmicdrift/kumiko-framework/pipeline";
+import { createTestUser } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   resetEventStore,
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
   unsafePushTables,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import {
   approverDirectoryTable,
   invoiceDetailTable,
@@ -831,8 +831,8 @@ describe("role-restricted write handlers", () => {
 //
 //   - r.defineEvent with { version, migrations } — evolving event shapes +
 //     upcast older payloads on read (declarative + sync/async transforms)
-//   - ctx.appendEvent — write domain events onto the aggregate stream
-//   - ctx.appendEvent with headers — Marten free key/value metadata
+//   - emitEvent — write domain events onto the aggregate stream, payload typed by the EventDef
+//   - emitEvent with headers — Marten free key/value metadata
 //   - r.projection — single-stream read model (inline in the write TX)
 //   - r.multiStreamProjection — cross-aggregate async read model
 //   - ctx.loadAggregate with { asOf } — point-in-time aggregate state
@@ -845,26 +845,25 @@ describe("role-restricted write handlers", () => {
 //   - getAllProjectionProgress — projection lag for ops dashboards
 
 import {
-  createEntity,
-  createTextField,
-  defineFeature,
-  defineProjectionQueryHandler,
-  typedPayload,
-} from "@app/define";
-import {
+  buildEntityTable,
+  createEventStoreExecutor,
   fetchOne,
   incrementCounter,
   insertOne,
-  updateMany,
-} from "@cosmicdrift/kumiko-framework/bun-db";
-import {
-  buildEntityTable,
-  createEventStoreExecutor,
   integer,
   table,
   text,
+  updateMany,
   uuid,
 } from "@cosmicdrift/kumiko-framework/db";
+import {
+  createEntity,
+  createTextField,
+  defineFeature,
+  defineProjectionQueryHandler,
+  emitEvent,
+  typedPayload,
+} from "@cosmicdrift/kumiko-framework/engine";
 import { z } from "zod";
 
 // --- Reducer: shared by live + snapshot-aware query handlers ---
@@ -1112,10 +1111,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
       const headers: Record<string, string> = {};
       if (event.payload.geoRegion) headers["geoRegion"] = event.payload.geoRegion;
       if (event.payload.abTestBucket) headers["abTestBucket"] = event.payload.abTestBucket;
-      await ctx.appendEvent({
+      await emitEvent(ctx, approved, {
         aggregateId: event.payload.id,
         aggregateType: "showcase-invoice",
-        type: approved.name,
         payload: { amountCents: event.payload.amountCents, approvedBy: event.payload.approvedBy },
         ...(Object.keys(headers).length > 0 ? { headers } : {}),
       });
@@ -1132,10 +1130,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
         approverId: event.payload.approverId,
       });
       const approverDisplayName: string = row?.displayName ?? `unknown:${event.payload.approverId}`;
-      await ctx.appendEvent({
+      await emitEvent(ctx, acknowledged, {
         aggregateId: event.payload.id,
         aggregateType: "showcase-invoice",
-        type: acknowledged.name,
         payload: { approverId: event.payload.approverId, approverDisplayName },
       });
       return { isSuccess: true as const, data: { id: event.payload.id } };
@@ -1147,10 +1144,9 @@ export const invoiceFeature = defineFeature("showcase", (r) => {
     name: "invoice:pay",
     schema: z.object({ id: z.uuid(), amountCents: z.number().int() }),
     handler: async (event, ctx) => {
-      await ctx.appendEvent({
+      await emitEvent(ctx, paid, {
         aggregateId: event.payload.id,
         aggregateType: "showcase-invoice",
-        type: paid.name,
         payload: { amountCents: event.payload.amountCents },
       });
       return { isSuccess: true as const, data: { id: event.payload.id } };

package/agents/examples/feature-toggles.md

@@ -39,16 +39,16 @@ import {
   GlobalFeatureToggleRuntime,
   globalFeatureStateTable,
 } from "@cosmicdrift/kumiko-bundled-features/feature-toggles";
-import { selectMany } from "@cosmicdrift/kumiko-framework/bun-db";
+import { selectMany } from "@cosmicdrift/kumiko-framework/db";
 import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
+import { createTestUser } from "@cosmicdrift/kumiko-framework/seeding";
+import { createLateBoundHolder } from "@cosmicdrift/kumiko-testing/helpers";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
   unsafePushTables,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { createLateBoundHolder } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import {
   createProductAuditFeature,
   createProductFeature,

package/agents/examples/field-access.md

@@ -89,14 +89,13 @@ Covers all three roles reading and writing, including the expected
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 import type { EntityId, SaveContext } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser, TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
+import { expectErrorIncludes } from "@cosmicdrift/kumiko-testing/helpers";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  TestUsers,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { expectErrorIncludes } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { employeeEntity, employeeFeature } from "../feature";
 
 let stack: TestStack;

package/agents/examples/files-post-processing.md

@@ -47,27 +47,26 @@ bun test
 
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import { createConfigFeature } from "@cosmicdrift/kumiko-bundled-features/config";
-import { derivativesSharpFeature } from "@cosmicdrift/kumiko-bundled-features/derivatives-sharp";
+import { createDerivativesSharpFeature } from "@cosmicdrift/kumiko-bundled-features/derivatives-sharp";
 import { createFileDerivativesFeature } from "@cosmicdrift/kumiko-bundled-features/file-derivatives";
-import { fileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
-import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
-import { entityEventName } from "@cosmicdrift/kumiko-framework/db";
+import { createFileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
+
+import { asRawClient, entityEventName } from "@cosmicdrift/kumiko-framework/db";
 import {
   createFilesFeature,
   createInMemoryFileProvider,
   type InMemoryFileProvider,
 } from "@cosmicdrift/kumiko-framework/files";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
+import {
+  buildMultipartBody,
+  patchFileInstanceofForBunTest,
+} from "@cosmicdrift/kumiko-testing/helpers";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
-import {
-  buildMultipartBody,
-  patchFileInstanceofForBunTest,
-} from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import sharp from "sharp";
 import { coverOrder, filesPostProcessingFeature, photoEntity, publishedPhotoIds } from "../feature";
 
@@ -97,7 +96,7 @@ beforeAll(async () => {
   stack = await setupTestStack({
     features: [
       createConfigFeature(),
-      fileFoundationFeature,
+      createFileFoundationFeature(),
       createFilesFeature(),
       createFileDerivativesFeature({
         resolveApexTenant: (host) => {
@@ -106,7 +105,7 @@ beforeAll(async () => {
           return null;
         },
       }),
-      derivativesSharpFeature,
+      createDerivativesSharpFeature(),
       filesPostProcessingFeature,
     ],
     files: { storageProvider: provider },

package/agents/examples/golden-path.md

@@ -0,0 +1,208 @@
+<!-- Generated by `bun run gen:agent-docs` from samples/recipes/golden-path. Do not edit. -->
+
+# golden-path
+
+The smallest complete feature: entity, write handler, event, projection, screen and an integration test.
+
+## README
+
+# Golden path
+
+The smallest complete Kumiko feature: one entity, one write handler that emits
+an event, one projection, one screen, and an integration test that writes
+through HTTP and reads the result back. Every other recipe is a variation on
+this shape. The walkthrough is in [`docs/golden-path.md`](../../../docs/golden-path.md).
+
+## What it shows
+
+- **Entity** — `ticketEntity` declares `title` and `isClosed`. `r.crud` registers
+  `ticket:create`, `ticket:list` and `ticket:detail` for it; update and delete
+  are switched off with `verbs`.
+- **Write handler** — `ticket:close` checks that the ticket exists and emits the
+  `ticket-closed` event. It never touches the table.
+- **Event** — `r.defineEvent` declares `ticket-closed` with a Zod payload;
+  `emitEvent` appends it to the ticket's stream in the handler's transaction.
+- **Projection** — `ticket-status` folds `ticket-closed` into the ticket row
+  (`isClosed: true`), in the same transaction as the write.
+- **Screen** — `ticket-list` is a declarative `entityList`; the renderer builds
+  the UI from it.
+- **Test** — `setupTestStack` boots the real server and database;
+  `stack.http.writeOk` and `queryOk` go over HTTP. Each test runs in its own
+  tenant.
+
+## Files
+
+```
+src/feature.ts                          entity, event, handler, projection, screen
+src/__tests__/feature.integration.test.ts   write → read back, access, not found
+```
+
+## Source files
+
+### src/__tests__/feature.integration.test.ts
+
+```ts
+import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
+import { setupTestStack, type TestStack } from "@cosmicdrift/kumiko-testing/stack";
+import { helpdeskFeature } from "../feature";
+
+type TicketRow = { id: string; title: string; isClosed: boolean };
+
+let stack: TestStack;
+let nextTenant = 1;
+let admin = createTestUser({ roles: ["Admin"], tenantId: testTenantId(nextTenant) });
+let agent = createTestUser({ id: 2, roles: ["User"], tenantId: testTenantId(nextTenant) });
+
+beforeAll(async () => {
+  stack = await setupTestStack({ features: [helpdeskFeature], systemHooks: [] });
+});
+
+afterAll(async () => {
+  await stack.cleanup();
+});
+
+// A fresh tenant per test keeps rows from other tests out of every list.
+beforeEach(() => {
+  nextTenant += 1;
+  admin = createTestUser({ roles: ["Admin"], tenantId: testTenantId(nextTenant) });
+  agent = createTestUser({ id: 2, roles: ["User"], tenantId: testTenantId(nextTenant) });
+});
+
+async function openTicket(title: string): Promise<string> {
+  const created = await stack.http.writeOk<{ id: string }>(
+    "helpdesk:write:ticket:create",
+    { title },
+    agent,
+  );
+  return created.id;
+}
+
+async function readTicket(id: string): Promise<TicketRow> {
+  return stack.http.queryOk<TicketRow>("helpdesk:query:ticket:detail", { id }, agent);
+}
+
+describe("golden path: ticket", () => {
+  test("a new ticket starts open", async () => {
+    const id = await openTicket("Printer is on fire");
+
+    expect(await readTicket(id)).toMatchObject({ title: "Printer is on fire", isClosed: false });
+  });
+
+  test("closing a ticket emits an event that the projection folds into the read model", async () => {
+    const id = await openTicket("Login fails");
+
+    await stack.http.writeOk(
+      "helpdesk:write:ticket:close",
+      { id, resolution: "Password reset" },
+      admin,
+    );
+
+    expect(await readTicket(id)).toMatchObject({ title: "Login fails", isClosed: true });
+    const list = await stack.http.queryOk<{ rows: TicketRow[] }>(
+      "helpdesk:query:ticket:list",
+      { filter: { field: "isClosed", op: "eq", value: true } },
+      agent,
+    );
+    expect(list.rows.map((row) => row.id)).toEqual([id]);
+  });
+
+  test("only an Admin may close a ticket", async () => {
+    const id = await openTicket("Slow wifi");
+
+    const denied = await stack.http.writeErr(
+      "helpdesk:write:ticket:close",
+      { id, resolution: "Moved the router" },
+      agent,
+    );
+
+    expect(denied.code).toBe("access_denied");
+    expect((await readTicket(id)).isClosed).toBe(false);
+  });
+
+  test("closing an unknown ticket fails with not_found", async () => {
+    const missing = await stack.http.writeErr(
+      "helpdesk:write:ticket:close",
+      { id: "99999999-9999-4999-8999-999999999999", resolution: "n/a" },
+      admin,
+    );
+
+    expect(missing.code).toBe("not_found");
+  });
+});
+```
+
+### src/feature.ts
+
+```ts
+import {
+  createBooleanField,
+  createEntity,
+  createEntityExecutor,
+  createTextField,
+  defineFeature,
+  emitEvent,
+  setFields,
+} from "@cosmicdrift/kumiko-framework/engine";
+import { failNotFound } from "@cosmicdrift/kumiko-framework/errors";
+import { z } from "zod";
+
+export const ticketEntity = createEntity({
+  table: "read_golden_path_tickets",
+  fields: {
+    title: createTextField({ personal: false, reason: "is_business_data", required: true }),
+    isClosed: createBooleanField({ default: false }),
+  },
+});
+
+export const helpdeskFeature = defineFeature("helpdesk", (r) => {
+  const { table: ticketTable, executor: ticketExecutor } = createEntityExecutor(
+    "ticket",
+    ticketEntity,
+  );
+
+  r.crud("ticket", ticketEntity, {
+    write: { access: { roles: ["Admin", "User"] } },
+    read: { access: { roles: ["Admin", "User"] } },
+    verbs: { update: false, delete: false },
+  });
+
+  const ticketClosed = r.defineEvent("ticket-closed", z.object({ resolution: z.string().min(1) }), {
+    piiFields: "none",
+  });
+
+  r.writeHandler({
+    name: "ticket:close",
+    schema: z.object({ id: z.uuid(), resolution: z.string().min(1) }),
+    access: { roles: ["Admin"] },
+    handler: async (event, ctx) => {
+      const ticket = await ticketExecutor.detail({ id: event.payload.id }, event.user, ctx.db);
+      if (!ticket) {
+        return failNotFound("ticket", event.payload.id);
+      }
+      await emitEvent(ctx, ticketClosed, {
+        aggregateId: event.payload.id,
+        aggregateType: "ticket",
+        payload: { resolution: event.payload.resolution },
+      });
+      return { isSuccess: true as const, data: { id: event.payload.id } };
+    },
+  });
+
+  r.projection({
+    name: "ticket-status",
+    source: "ticket",
+    table: ticketTable,
+    apply: {
+      [ticketClosed.name]: setFields(ticketTable, { isClosed: true }),
+    },
+  });
+
+  r.screen({
+    id: "ticket-list",
+    type: "entityList",
+    entity: "ticket",
+    columns: ["title", "isClosed"],
+  });
+});
+```

package/agents/examples/idempotency.md

@@ -39,12 +39,12 @@ bun test
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import type { SaveContext } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { orderEntity, orderFeature } from "../feature";
 
 let stack: TestStack;

package/agents/examples/inbound-mail-triage.md

@@ -63,15 +63,15 @@ import {
 } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
 import { createConfigFeature } from "@cosmicdrift/kumiko-bundled-features/config";
 import {
+  createInboundMailFoundationFeature,
   InboundMailFoundationHandlers,
-  inboundMailFoundationFeature,
   inboundMessageEntity,
   mailAccountEntity,
   mailThreadEntity,
   seenMessageEntity,
   syncCursorEntity,
 } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
-import { inboundProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-inmemory";
+import { createInboundProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-inmemory";
 import { createTenantFeature, tenantEntity } from "@cosmicdrift/kumiko-bundled-features/tenant";
 import { createTenantLifecycleFeature } from "@cosmicdrift/kumiko-bundled-features/tenant-lifecycle";
 import { createRegistry } from "@cosmicdrift/kumiko-framework/engine";
@@ -81,15 +81,15 @@ import {
   createEventsTable,
 } from "@cosmicdrift/kumiko-framework/event-store";
 import { createEventConsumerStateTable } from "@cosmicdrift/kumiko-framework/pipeline";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
+import { waitFor } from "@cosmicdrift/kumiko-testing/helpers";
 import {
   createTestDb,
   createTestRedis,
   type TestDb,
   type TestRedis,
-  TestUsers,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { waitFor } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { createMailTriageFeature, triageInbox } from "../feature";
 
 const JWT = "inbound-mail-triage-secret-minimum-32-chars!";
@@ -147,8 +147,8 @@ describe("inbound-mail triage sample", () => {
       createTenantFeature(),
       createComplianceProfilesFeature(),
       createTenantLifecycleFeature(),
-      inboundMailFoundationFeature,
-      inboundProviderInMemoryFeature,
+      createInboundMailFoundationFeature(),
+      createInboundProviderInMemoryFeature(),
       createMailTriageFeature(),
     ]);
     const redisUrl = `redis://${testRedis.redis.options.host}:${testRedis.redis.options.port}/${testRedis.redis.options.db}`;

package/agents/examples/lane-routing.md

@@ -57,14 +57,14 @@ import {
   createEventsTable,
 } from "@cosmicdrift/kumiko-framework/event-store";
 import { createEventConsumerStateTable } from "@cosmicdrift/kumiko-framework/pipeline";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
+import { waitFor } from "@cosmicdrift/kumiko-testing/helpers";
 import {
   createTestDb,
   createTestRedis,
   type TestDb,
   type TestRedis,
-  TestUsers,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { waitFor } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { createLaneRoutingFeature, renderedReceipts, sentConfirmations } from "../feature";
 
 const JWT = "lane-routing-sample-secret-minimum-32-chars!";

package/agents/examples/ledger-banking.md

@@ -73,13 +73,12 @@ import {
   transactionEntity,
 } from "@cosmicdrift/kumiko-bundled-features/ledger";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { bankingFlow, type LedgerClient } from "../usage";
 
 // Each test runs in its own tenant, so rows from other tests never show up.

package/agents/examples/ledger-invoicing.md

@@ -82,13 +82,12 @@ import {
   transactionEntity,
 } from "@cosmicdrift/kumiko-bundled-features/ledger";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { invoicingFlow, type LedgerClient } from "../usage";
 
 // Each test runs in its own tenant, so rows from other tests never show up.

package/agents/examples/legal-pages.md

@@ -228,7 +228,7 @@ import {
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { LEGAL_ROUTES, legalPagesFeature, templateResolverFeature } from "../feature";
 
 let stack: TestStack;

package/agents/examples/lifecycle-hooks.md

@@ -64,13 +64,13 @@ bun kumiko test integration samples/lifecycle-hooks
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import type { SaveContext } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser } from "@cosmicdrift/kumiko-framework/seeding";
+import { expectErrorIncludes } from "@cosmicdrift/kumiko-testing/helpers";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { expectErrorIncludes } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { articleEntity, articlesFeature, hookLog } from "../feature";
 
 let stack: TestStack;

package/agents/examples/managed-config.md

@@ -169,7 +169,7 @@ import {
   createSecretsFeature,
   tenantSecretsTable,
 } from "@cosmicdrift/kumiko-bundled-features/secrets";
-import { selectMany } from "@cosmicdrift/kumiko-framework/bun-db";
+import { selectMany } from "@cosmicdrift/kumiko-framework/db";
 import {
   type ConfigCascade,
   createRegistry,
@@ -177,13 +177,12 @@ import {
 } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
 import { createEnvMasterKeyProvider } from "@cosmicdrift/kumiko-framework/secrets";
+import { TestUsers, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
 import {
   setupTestStack,
   type TestStack,
-  TestUsers,
-  testTenantId,
   unsafePushTables,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { integrationsFeature, paymentApiKeyHandle, smtpHostHandle } from "../feature";
 
 const TENANT_A = testTenantId(1);

package/agents/examples/managed-pages.md

@@ -180,13 +180,13 @@ import { BRANDING_QN, pageEntity } from "@cosmicdrift/kumiko-bundled-features/ma
 import { seedPage } from "@cosmicdrift/kumiko-bundled-features/managed-pages/seeding";
 import { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
   unsafeCreateEntityTable,
   unsafePushTables,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { configFeature, managedPagesCssFeature, managedPagesFeature } from "../feature";
 
 // Branding writes are tenant-scoped — the admin's tenantId must equal the

package/agents/examples/notes-history-basic.md

@@ -117,18 +117,17 @@ bun test src/__tests__/feature.integration.test.ts
 
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import {
+  createNotesHistoryFeature,
   noteEntryEntity,
   noteMentionEntity,
-  notesHistoryFeature,
 } from "@cosmicdrift/kumiko-bundled-features/notes-history";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { taskEntity, taskFeature } from "../feature";
 import { type NotesClient, notesFlow } from "../usage";
 
@@ -145,7 +144,7 @@ const notesClient: NotesClient = {
 let stack: TestStack;
 
 beforeAll(async () => {
-  stack = await setupTestStack({ features: [notesHistoryFeature, taskFeature] });
+  stack = await setupTestStack({ features: [createNotesHistoryFeature(), taskFeature] });
   await unsafeCreateEntityTable(stack.db, noteEntryEntity);
   await unsafeCreateEntityTable(stack.db, noteMentionEntity);
   await unsafeCreateEntityTable(stack.db, taskEntity);

package/agents/examples/ownership.md

@@ -40,15 +40,13 @@ bun test
 
 import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
+import { createTestUser, TestUsers, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
+import { expectErrorIncludes } from "@cosmicdrift/kumiko-testing/helpers";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  TestUsers,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
-import { expectErrorIncludes } from "@cosmicdrift/kumiko-framework/testing";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { contractEntity, contractsFeature, teamsFeature } from "../feature";
 
 let stack: TestStack;

package/agents/examples/pdf-audit-export.md

@@ -46,13 +46,12 @@ import {
   createFilesFeature,
   createInMemoryFileProvider,
 } from "@cosmicdrift/kumiko-framework/files";
+import { createTestUser, testTenantId } from "@cosmicdrift/kumiko-framework/seeding";
 import {
-  createTestUser,
   setupTestStack,
   type TestStack,
-  testTenantId,
   unsafeCreateEntityTable,
-} from "@cosmicdrift/kumiko-framework/stack";
+} from "@cosmicdrift/kumiko-testing/stack";
 import { extractText, getDocumentProxy } from "unpdf";
 import { inspectionEntity, pdfAuditExportFeature } from "../feature";