@cosmicdrift/kumiko-samples 0.388.0 → 0.389.0

package/packages/bundled-features/src/waitlist/handlers/submit.write.ts

@@ -1,8 +1,14 @@
-import { acquireNamespacedAdvisoryLock } from "@cosmicdrift/kumiko-framework/db";
+import {
+  acquireNamespacedAdvisoryLock,
+  createSystemDbView,
+  createTenantDb,
+  runInSavepointIfSupported,
+} from "@cosmicdrift/kumiko-framework/db";
 import {
   access,
   defineWriteHandler,
   type HandlerContext,
+  type TenantId,
   type WriteResult,
 } from "@cosmicdrift/kumiko-framework/engine";
 import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
@@ -25,7 +31,7 @@ import { WAITLIST_NOTIFICATION_TYPES, WAITLIST_STATUS } from "../web/constants.t
 // framework's other fixed advisory-lock keys.
 const SUBMIT_LOCK_NAMESPACE = 0x776c7374;
 const SUBMIT_LOCK_REASON =
-  "takes the per-email advisory lock so parallel submits cannot both pass the duplicate check; TenantDb has no lock API";
+  "takes the per-email advisory lock so parallel submits cannot both pass the duplicate check and wraps the admin-recipient resolver in a savepoint so a failing statement cannot abort the submit transaction; TenantDb has neither API";
 
 // Logged-in callers carry no anonymous role, so every signed-in role must be listed.
 const SUBMIT_ROLES = access.roles(
@@ -73,16 +79,24 @@ async function hasOpenEntryForEmail(email: string, ctx: HandlerContext): Promise
   return found.rows.length > 0;
 }
 
-// The resolver usually reads config. It runs before the per-email advisory lock so a
-// slow resolver does not extend the lock. It still shares the handler transaction: a
-// thrown JS error is swallowed here, but a failed SQL statement inside it would abort
-// the transaction, so resolvers must not issue statements that can fail.
+// The resolver usually reads config. It runs before the per-email advisory lock so a slow
+// resolver does not extend the lock. Postgres aborts the whole transaction after a failed
+// statement, even one whose JS error is caught here, so the resolver gets a ctx whose
+// systemDb is bound to its own savepoint: a failing statement rolls back only that.
+// Statements through any other ctx handle (ctx.query, ctx.write) stay in the handler transaction.
 async function resolveAdminRecipient(
   opts: WaitlistOptions,
   ctx: HandlerContext,
+  systemDb: NonNullable<HandlerContext["systemDb"]>,
+  tenantId: TenantId,
 ): Promise<string | null> {
   try {
-    return (await opts.notifyRecipient?.(ctx)) || null;
+    return await runInSavepointIfSupported(systemDb.unsafeRaw(SUBMIT_LOCK_REASON), async (sp) => {
+      const savepointSystemDb = createSystemDbView(
+        createTenantDb({ db: sp, tenantId, mode: "system" }),
+      );
+      return (await opts.notifyRecipient?.({ ...ctx, systemDb: savepointSystemDb })) || null;
+    });
   } catch (err) {
     ctx.log?.warn("[waitlist:submit] admin notice recipient resolution failed", {
       error: err instanceof Error ? err.message : String(err),
@@ -130,7 +144,12 @@ export function createSubmitHandler(opts: WaitlistOptions) {
           message: "waitlist:submit requires ctx.systemDb — is r.systemScope() set?",
         });
       }
-      const adminRecipient = await resolveAdminRecipient(opts, ctx);
+      const adminRecipient = await resolveAdminRecipient(
+        opts,
+        ctx,
+        ctx.systemDb,
+        event.user.tenantId,
+      );
       await acquireNamespacedAdvisoryLock(
         ctx.systemDb.unsafeRaw(SUBMIT_LOCK_REASON),
         SUBMIT_LOCK_NAMESPACE,

package/packages/bundled-features/src/waitlist/import.ts

@@ -3,7 +3,7 @@ import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
 import { InternalError } from "@cosmicdrift/kumiko-framework/errors";
 import type { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 import { normalizeEmail, platformActor, waitlistExecutor } from "./lib.ts";
-import type { WaitlistStatus } from "./web/constants.ts";
+import { WAITLIST_FIELD_LIMITS, type WaitlistStatus } from "./web/constants.ts";
 
 export type WaitlistImportEntry = {
   /** Stable identity of the source row (e.g. `offlot:<uuid>`); the new entry id derives from it. */
@@ -43,18 +43,38 @@ export function isWaitlistImportId(id: string): boolean {
   return id[14] === "5";
 }
 
+// The live submit schema caps these fields; an imported value above the cap would be
+// stored but could never pass a later update through the same payload schema.
+export function waitlistImportEntryWithinLimits(entry: WaitlistImportEntry): boolean {
+  const limited: ReadonlyArray<readonly [string | undefined, number]> = [
+    [entry.name, WAITLIST_FIELD_LIMITS.name],
+    [entry.email, WAITLIST_FIELD_LIMITS.email],
+    [entry.locale, WAITLIST_FIELD_LIMITS.locale],
+    [entry.company, WAITLIST_FIELD_LIMITS.company],
+    [entry.portfolio, WAITLIST_FIELD_LIMITS.portfolio],
+    [entry.message, WAITLIST_FIELD_LIMITS.message],
+  ];
+  return limited.every(([value, max]) => value === undefined || value.length <= max);
+}
+
 function presentOnly(fields: Record<string, unknown>): Record<string, unknown> {
   return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
 }
 
-// Writes through the entity executor, so events, projection and subject encryption
-// behave exactly as for a live submit. No mail, no rate limit, no duplicate-by-email
+// Writes through the entity executor, so events and projection match a live submit; subject
+// encryption applies only when the caller configured a PII KMS (the CLI wires it from env
+// and aborts without one). No mail, no rate limit, no duplicate-by-email
 // check: the source row is the truth and the id makes the call idempotent.
 export async function importWaitlistEntry(
   db: TenantDb,
   entry: WaitlistImportEntry,
   options: { readonly dryRun?: boolean } = {},
 ): Promise<WaitlistImportOutcome> {
+  if (!waitlistImportEntryWithinLimits(entry)) {
+    throw new InternalError({
+      message: `waitlist import entry ${entry.sourceKey} exceeds a field length limit`,
+    });
+  }
   const id = waitlistImportId(entry.sourceKey);
   const existing = await waitlistExecutor.detail({ id }, platformActor(), db);
   if (existing) return "skipped";

package/packages/bundled-features/src/waitlist/legacy-migrate.ts

@@ -28,6 +28,7 @@ import {
   importWaitlistEntry,
   isWaitlistImportId,
   type WaitlistImportEntry,
+  waitlistImportEntryWithinLimits,
   waitlistImportId,
 } from "./import.ts";
 import { WAITLIST_STATUS, type WaitlistStatus } from "./web/constants.ts";
@@ -265,7 +266,7 @@ export async function migrateLegacyWaitlist(
       options.from === "offlot"
         ? await mapOfflotRow(row)
         : mapPublicstatusRow(row, options.defaultLocale);
-    if (!entry) {
+    if (!entry || !waitlistImportEntryWithinLimits(entry)) {
       unreadable += 1;
       continue;
     }

package/packages/bundled-features/src/waitlist/options.ts

@@ -22,7 +22,8 @@ export type WaitlistInviteOptions =
 export type WaitlistOptions = {
   /** Address for an admin notification mail on each new entry. Null, an empty
    *  string or an absent option sends none. Best effort, never fails the submit,
-   *  also when the resolver throws or rejects. */
+   *  also when the resolver throws or rejects. `ctx.systemDb` is bound to a savepoint, so a
+   *  failing statement through it is rolled back without aborting the submit transaction. */
   readonly notifyRecipient?: (ctx: HandlerContext) => string | null | Promise<string | null>;
   /** Language of the admin notice mail (en, de or es; anything else falls back to en).
    *  Not taken from the request: a submit comes from the entrant, not the operator. */

package/packages/bundled-features/src/workflow-runner/handlers/resume-run.write.ts

@@ -229,7 +229,7 @@ function readTriggerSource(startedPayload: unknown): TriggerSource | null {
 }
 
 async function loadReferencedEvent(ctx: HandlerContext, ref: TriggerEventRef) {
-  const events = await ctx.loadAggregate(ref.aggregateId);
+  const events = await ctx.loadAggregate(ref.aggregateId, { atVersion: ref.version });
   return events.find((e) => e.id === ref.eventId);
 }
 

package/samples/apps/styleguide/src/app/client.tsx

@@ -7,6 +7,7 @@ import { styleguideClient } from "../features/demo/web";
 import { examplesClient } from "../features/examples/web";
 import { galleryClient } from "../features/gallery/web";
 import { widgetsClient } from "../features/widgets/web";
+import { workboardClient } from "../features/workboard/web";
 import { AppShell } from "./shell";
 
 // createKumikoApp fetches the schema itself from the authenticated
@@ -24,5 +25,6 @@ createKumikoApp({
     widgetsClient,
     examplesClient,
     contentClient(),
+    workboardClient,
   ],
 });

package/samples/apps/styleguide/src/app/seed.ts

@@ -1,5 +1,5 @@
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { createTenantDb } from "@cosmicdrift/kumiko-framework/db";
+import { buildEntityTable, createTenantDb, fetchOne } from "@cosmicdrift/kumiko-framework/db";
 import { createEntityExecutor } from "@cosmicdrift/kumiko-framework/engine";
 import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
@@ -8,9 +8,6 @@ import { demoEntity } from "../features/demo/feature";
 // Gibt der List-View echte Rows mit Status-/Flag-Vielfalt. price (money)
 // bleibt leer — der Money-Input zeigt sich im Edit-Screen, im Seed lassen wir
 // ihn weg um nicht von der money-Payload-Form abzuhängen.
-// ponytail: kein Idempotenz-Check — die Screenshot-DB ist ephemer (frisch pro
-// Boot). Beim `bun run dev` gegen die persistente Dev-DB dupliziert ein
-// Neustart die Rows; das ist hier nur eine Demo, daher egal.
 const STATUSES = ["draft", "review", "published", "archived"] as const;
 
 // Fixed across boots (unlike the framework-minted ids for every other seed
@@ -19,7 +16,12 @@ const STATUSES = ["draft", "review", "published", "archived"] as const;
 // otherwise change every run.
 export const FIRST_STYLEGUIDE_ITEM_ID = "00000000-0000-4000-8000-0000000000f1";
 
+const demoItemTable = buildEntityTable("item", demoEntity);
+
 export const seedStyleguideItems: SeedFn = async (stack) => {
+  // The first row has a fixed id, so its presence means a persistent dev DB was seeded already.
+  if (await fetchOne(stack.db, demoItemTable, { id: FIRST_STYLEGUIDE_ITEM_ID })) return;
+
   // Bypass the write-handler HTTP path for the first row — its schema has
   // no `id` field (buildInsertSchema only exposes entity fields), so an
   // explicit id would be silently stripped before reaching the executor.

package/samples/apps/styleguide/src/app/server.ts

@@ -20,6 +20,8 @@ import { examplesFeature } from "../features/examples/feature";
 import { galleryFeature } from "../features/gallery/feature";
 import { aiTextDemoFeature } from "../features/widgets/ai-text-demo";
 import { widgetsFeature } from "../features/widgets/feature";
+import { workboardFeature } from "../features/workboard/feature";
+import { seedWorkboardTasks } from "../features/workboard/seed";
 import { seedStyleguideItems } from "./seed";
 
 const configResolver = createConfigResolver();
@@ -35,6 +37,7 @@ await runDevApp({
     contentFeature,
     aiTextDemoFeature,
     aiSettingsFeature,
+    workboardFeature,
   ],
   // Aktiviert die Upload-Routes (/api/files) + ctx.files für den Avatar-
   // Stresstest. In-Memory reicht für die Demo (nicht-persistent).
@@ -43,7 +46,7 @@ await runDevApp({
   clientEntry: "./src/app/client.tsx",
   htmlPath: "./public/index.html",
   watchDirs: ["./src", "../../../packages/*/src"],
-  seeds: [seedStyleguideItems, seedAiConnections],
+  seeds: [seedStyleguideItems, seedAiConnections, seedWorkboardTasks],
   extraContext: ({ registry }) => ({
     configResolver,
     _configAccessorFactory: createConfigAccessorFactory(registry, configResolver),

package/samples/apps/styleguide/src/features/widgets/feature.ts

@@ -28,13 +28,21 @@ const loanMonthMs = (monthIndex: number): number => Date.UTC(2020, monthIndex, 1
 // screenshots stay stable.
 const growth = (1 + LOAN_MONTHLY_RATE) ** LOAN_MONTHS;
 const annuityMinor = (LOAN_PRINCIPAL_MINOR * LOAN_MONTHLY_RATE * growth) / (growth - 1);
+// Month index -> extra repayment, which shortens the term below LOAN_MONTHS.
+const EXTRA_REPAYMENTS_MINOR: ReadonlyMap<number, number> = new Map([
+  [84, 3_000_000],
+  [150, 2_000_000],
+]);
 let balanceMinor: number = LOAN_PRINCIPAL_MINOR;
 let interestPaidMinor = 0;
+let payoffMonth: number | undefined;
 const LOAN_REMAINING_POINTS = [{ atMs: loanMonthMs(0), value: LOAN_PRINCIPAL_MINOR }];
 const LOAN_INTEREST_POINTS = [{ atMs: loanMonthMs(0), value: 0 }];
 for (let i = 1; i <= LOAN_MONTHS; i++) {
   const interest = balanceMinor * LOAN_MONTHLY_RATE;
-  balanceMinor = Math.max(0, balanceMinor - (annuityMinor - interest));
+  const extraRepayment = EXTRA_REPAYMENTS_MINOR.get(i) ?? 0;
+  balanceMinor = Math.max(0, balanceMinor - (annuityMinor - interest) - extraRepayment);
+  if (balanceMinor === 0) payoffMonth ??= i;
   interestPaidMinor += interest;
   LOAN_REMAINING_POINTS.push({ atMs: loanMonthMs(i), value: Math.round(balanceMinor) });
   LOAN_INTEREST_POINTS.push({ atMs: loanMonthMs(i), value: Math.round(interestPaidMinor) });
@@ -44,10 +52,13 @@ const LOAN_SERIES = [
   { key: "interest", label: "widgets:dashboard:loan-interest", points: LOAN_INTEREST_POINTS },
 ];
 const LOAN_MARKERS = [
-  { atMs: loanMonthMs(84), label: { i18nKey: "widgets:dashboard:marker-extra-1" }, kind: "extra" },
-  { atMs: loanMonthMs(150), label: { i18nKey: "widgets:dashboard:marker-extra-2" }, kind: "extra" },
+  ...[...EXTRA_REPAYMENTS_MINOR.keys()].map((monthIndex, i) => ({
+    atMs: loanMonthMs(monthIndex),
+    label: { i18nKey: `widgets:dashboard:marker-extra-${i + 1}` },
+    kind: "extra",
+  })),
   {
-    atMs: loanMonthMs(LOAN_MONTHS),
+    atMs: loanMonthMs(payoffMonth ?? LOAN_MONTHS),
     label: { i18nKey: "widgets:dashboard:marker-payoff" },
     kind: "payoff",
   },

package/samples/apps/styleguide/src/features/workboard/feature.ts

@@ -0,0 +1,185 @@
+import {
+  createDateField,
+  createEntity,
+  createNumberField,
+  createSelectField,
+  createTextField,
+  defineFeature,
+} from "@cosmicdrift/kumiko-framework/engine";
+
+import { WORKBOARD_I18N } from "./i18n";
+
+export const taskEntity = createEntity({
+  table: "read_workboard_tasks",
+  fields: {
+    title: createTextField({
+      personal: false,
+      reason: "is_business_data",
+      required: true,
+      searchable: true,
+      sortable: true,
+    }),
+    status: createSelectField({
+      options: ["open", "inProgress", "blocked", "done"] as const,
+      default: "open",
+      sortable: true,
+      filterable: true,
+    }),
+    priority: createSelectField({
+      options: ["low", "medium", "high"] as const,
+      default: "medium",
+      sortable: true,
+      filterable: true,
+    }),
+    dueDate: createDateField({ sortable: true }),
+    assignee: createTextField({ personal: false, reason: "is_business_data", sortable: true }),
+    estimateHours: createNumberField({ sortable: true, filterable: true }),
+  },
+});
+
+const open = {
+  access: {
+    openToAll: {
+      reason: "demo app: any signed-in user manages every task; there is no per-user ownership",
+    },
+  },
+} as const;
+
+// All of this round's list options on one screen: remembered state, one reset
+// button, the column picker (estimateHours starts hidden) and the density choice.
+export const workboardFeature = defineFeature("workboard", (r) => {
+  r.translations({ keys: WORKBOARD_I18N });
+  r.crud("task", taskEntity, { write: open, read: open });
+
+  r.screen({
+    id: "task-list",
+    type: "entityList",
+    entity: "task",
+    columns: [
+      "title",
+      "status",
+      "priority",
+      { field: "dueDate", hideOnNarrow: true },
+      { field: "assignee", hideOnNarrow: true },
+      { field: "estimateHours", hidden: true, hideOnNarrow: true },
+    ],
+    pagination: "pages",
+    pageSize: 25,
+    defaultSort: { field: "dueDate", dir: "asc" },
+    searchable: true,
+    facets: { status: { display: "chips" }, priority: {} },
+    table: {
+      rememberState: true,
+      resetAll: true,
+      columnPicker: true,
+      density: { default: "comfortable", userChoice: true },
+      export: { xlsx: true },
+    },
+    rowActions: [
+      { kind: "navigate", id: "edit", label: "Edit", screen: "task-edit", rowClick: true },
+    ],
+  });
+
+  // The same tasks as a spreadsheet-like board: fixed column widths, a pinned title,
+  // keyboard navigation between rows, row checkboxes with a bulk delete.
+  r.screen({
+    id: "task-board",
+    type: "entityList",
+    entity: "task",
+    columns: [
+      { field: "title", pinned: "left", width: 260, minWidth: 140 },
+      { field: "status", width: 180, minWidth: 100 },
+      { field: "priority", width: 180, minWidth: 100 },
+      { field: "dueDate", width: 180, minWidth: 100, hideOnNarrow: true },
+      { field: "assignee", width: 220, minWidth: 100, hideOnNarrow: true },
+      { field: "estimateHours", width: 180, minWidth: 100, hideOnNarrow: true },
+    ],
+    pagination: "pages",
+    pageSize: 25,
+    defaultSort: { field: "dueDate", dir: "asc" },
+    searchable: true,
+    table: {
+      rememberState: true,
+      columnPicker: true,
+      pinning: true,
+      resizing: true,
+      keyboardNavigation: true,
+      density: { default: "comfortable", userChoice: true },
+    },
+    rowActions: [
+      { kind: "navigate", id: "edit", label: "Edit", screen: "task-edit", rowClick: true },
+      {
+        kind: "writeHandler",
+        id: "delete",
+        label: "Delete",
+        handler: "workboard:write:task:delete",
+        style: "danger",
+        visible: { field: "status", ne: "done" },
+      },
+    ],
+    bulkActions: [{ id: "delete", rowAction: "delete" }],
+  });
+
+  // The same tasks grouped by status on the server: each header carries the
+  // group's count and estimate sum, a footer row the sum over all filtered tasks.
+  r.screen({
+    id: "task-estimates",
+    type: "entityList",
+    entity: "task",
+    columns: ["title", "status", "priority", "assignee", "estimateHours"],
+    pagination: "pages",
+    pageSize: 3,
+    defaultSort: { field: "title", dir: "asc" },
+    searchable: true,
+    facets: { estimateHours: { display: "range" } },
+    table: {
+      grouping: { field: "status", collapsedWhen: "done", userChoice: true, fields: ["priority"] },
+      totals: [{ field: "estimateHours", kind: "sum" }],
+    },
+    rowActions: [
+      { kind: "navigate", id: "edit", label: "Edit", screen: "task-edit", rowClick: true },
+    ],
+  });
+
+  r.screen({
+    id: "task-edit",
+    type: "entityEdit",
+    entity: "task",
+    dormant: true,
+    listScreenId: "task-list",
+    layout: {
+      sections: [
+        {
+          columns: 2,
+          fields: ["title", "assignee", "status", "priority", "dueDate", "estimateHours"],
+        },
+      ],
+    },
+  });
+
+  r.nav({ id: "workboard", label: "workboard:nav.workboard", icon: "list", order: 40 });
+  r.nav({
+    id: "task-list",
+    label: "workboard:nav.tasks",
+    parent: "workboard:nav:workboard",
+    screen: "workboard:screen:task-list",
+    icon: "table",
+    order: 10,
+  });
+  r.nav({
+    id: "task-board",
+    label: "workboard:nav.board",
+    parent: "workboard:nav:workboard",
+    screen: "workboard:screen:task-board",
+    icon: "table",
+    order: 20,
+  });
+  r.nav({
+    id: "task-estimates",
+    label: "workboard:nav.estimates",
+    parent: "workboard:nav:workboard",
+    screen: "workboard:screen:task-estimates",
+    icon: "table",
+    order: 30,
+  });
+});

package/samples/apps/styleguide/src/features/workboard/i18n.ts

@@ -0,0 +1,27 @@
+import type { LocalizedString } from "../shared-i18n";
+
+export const WORKBOARD_I18N: Readonly<Record<string, LocalizedString>> = {
+  "workboard:nav.workboard": { de: "Aufgaben", en: "Workboard" },
+  "workboard:nav.tasks": { de: "Alle Aufgaben", en: "All tasks" },
+  "workboard:nav.board": { de: "Aufgaben-Board", en: "Task board" },
+  "workboard:nav.estimates": { de: "Aufwand je Status", en: "Estimates by status" },
+  "screen:task-board.title": { de: "Aufgaben-Board", en: "Task board" },
+  "screen:task-estimates.title": { de: "Aufwand je Status", en: "Estimates by status" },
+  "screen:task-list.title": { de: "Aufgaben", en: "Tasks" },
+  "screen:task-edit.title": { de: "Aufgabe bearbeiten", en: "Edit task" },
+  "screen:task-edit.create.title": { de: "Aufgabe anlegen", en: "Create task" },
+  "screen:task-edit.edit.title": { de: "Aufgabe bearbeiten", en: "Edit task" },
+  "workboard:entity:task:field:title": { de: "Titel", en: "Title" },
+  "workboard:entity:task:field:status": { de: "Status", en: "Status" },
+  "workboard:entity:task:field:status:option:open": { de: "Offen", en: "Open" },
+  "workboard:entity:task:field:status:option:inProgress": { de: "In Arbeit", en: "In progress" },
+  "workboard:entity:task:field:status:option:blocked": { de: "Blockiert", en: "Blocked" },
+  "workboard:entity:task:field:status:option:done": { de: "Erledigt", en: "Done" },
+  "workboard:entity:task:field:priority": { de: "Priorität", en: "Priority" },
+  "workboard:entity:task:field:priority:option:low": { de: "Niedrig", en: "Low" },
+  "workboard:entity:task:field:priority:option:medium": { de: "Mittel", en: "Medium" },
+  "workboard:entity:task:field:priority:option:high": { de: "Hoch", en: "High" },
+  "workboard:entity:task:field:dueDate": { de: "Fällig am", en: "Due date" },
+  "workboard:entity:task:field:assignee": { de: "Zuständig", en: "Assignee" },
+  "workboard:entity:task:field:estimateHours": { de: "Aufwand (Std.)", en: "Estimate (h)" },
+};

package/samples/apps/styleguide/src/features/workboard/seed.ts

@@ -0,0 +1,121 @@
+import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
+
+type SeedTask = {
+  readonly title: string;
+  readonly status: "open" | "inProgress" | "blocked" | "done";
+  readonly priority: "low" | "medium" | "high";
+  readonly dueDate: string;
+  readonly assignee: string;
+  readonly estimateHours: number;
+};
+
+const TASKS: readonly SeedTask[] = [
+  {
+    title: "Quarterly VAT filing",
+    status: "inProgress",
+    priority: "high",
+    dueDate: "2026-11-10",
+    assignee: "Ines Vogel",
+    estimateHours: 6,
+  },
+  {
+    title: "Renew office lease",
+    status: "open",
+    priority: "medium",
+    dueDate: "2026-12-01",
+    assignee: "Tomas Berg",
+    estimateHours: 3,
+  },
+  {
+    title: "Onboard new support hire",
+    status: "open",
+    priority: "high",
+    dueDate: "2026-11-03",
+    assignee: "Ines Vogel",
+    estimateHours: 12,
+  },
+  {
+    title: "Migrate invoices to new numbering",
+    status: "blocked",
+    priority: "high",
+    dueDate: "2026-11-15",
+    assignee: "Mara Lindqvist",
+    estimateHours: 16,
+  },
+  {
+    title: "Update privacy policy",
+    status: "done",
+    priority: "medium",
+    dueDate: "2026-10-20",
+    assignee: "Tomas Berg",
+    estimateHours: 4,
+  },
+  {
+    title: "Order replacement laptops",
+    status: "inProgress",
+    priority: "low",
+    dueDate: "2026-11-25",
+    assignee: "Mara Lindqvist",
+    estimateHours: 2,
+  },
+  {
+    title: "Prepare annual audit documents",
+    status: "open",
+    priority: "high",
+    dueDate: "2027-01-15",
+    assignee: "Ines Vogel",
+    estimateHours: 24,
+  },
+  {
+    title: "Fix mobile checkout layout",
+    status: "inProgress",
+    priority: "medium",
+    dueDate: "2026-11-05",
+    assignee: "Jonas Keller",
+    estimateHours: 8,
+  },
+  {
+    title: "Review supplier contracts",
+    status: "blocked",
+    priority: "medium",
+    dueDate: "2026-11-30",
+    assignee: "Tomas Berg",
+    estimateHours: 10,
+  },
+  {
+    title: "Archive 2025 customer files",
+    status: "done",
+    priority: "low",
+    dueDate: "2026-10-31",
+    assignee: "Jonas Keller",
+    estimateHours: 5,
+  },
+  {
+    title: "Plan team offsite",
+    status: "open",
+    priority: "low",
+    dueDate: "2027-02-20",
+    assignee: "Mara Lindqvist",
+    estimateHours: 7,
+  },
+  {
+    title: "Set up weekly sales report",
+    status: "inProgress",
+    priority: "medium",
+    dueDate: "2026-11-12",
+    assignee: "Jonas Keller",
+    estimateHours: 9,
+  },
+];
+
+export const seedWorkboardTasks: SeedFn = async (stack) => {
+  for (const task of TASKS) {
+    const res = await stack.http.write("workboard:write:task:create", task, TestUsers.admin);
+    if (!res.ok) {
+      // biome-ignore lint/suspicious/noConsole: dev-seed surfaces failures in the runner log
+      console.error(`[seed] workboard task "${task.title}" failed:`, await res.text());
+      return;
+    }
+  }
+};

package/samples/apps/styleguide/src/features/workboard/web.ts

@@ -0,0 +1,13 @@
+import type {
+  ClientFeatureDefinition,
+  TranslationsByLocale,
+} from "@cosmicdrift/kumiko-renderer/web";
+import { toClientTranslations } from "../shared-i18n";
+import { WORKBOARD_I18N } from "./i18n";
+
+const translations: TranslationsByLocale = toClientTranslations(WORKBOARD_I18N);
+
+export const workboardClient: ClientFeatureDefinition = {
+  name: "workboard",
+  translations,
+};

package/samples/apps/ui-walkthrough/src/features/rental/i18n.ts

@@ -50,6 +50,7 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental.party.role.main": "Hauptmieter",
     "rental.party.role.co": "Mitmieterin",
     "rental.action.addParty": "Partei hinzufügen",
+    "rental.action.showTerminated": "Beendete Verträge",
 
     "rental.tab.parties": "Vertragsparteien",
     "rental.tab.positions": "Positionen",
@@ -214,6 +215,7 @@ export const rentalTranslations: TranslationsByLocale = {
     "rental.party.role.main": "Main tenant",
     "rental.party.role.co": "Co-tenant",
     "rental.action.addParty": "Add party",
+    "rental.action.showTerminated": "Terminated leases",
 
     "rental.tab.parties": "Parties",
     "rental.tab.positions": "Positions",

package/samples/apps/ui-walkthrough/src/features/rental/screens.ts

@@ -52,6 +52,15 @@ export const leaseListScreen: EntityListScreenDefinition = {
   pageSize: 25,
   createLabel: "rental.action.createLease",
   searchPlaceholder: "rental.search.placeholder",
+  toolbarActions: [
+    {
+      kind: "navigate",
+      id: "show-terminated",
+      label: "rental.action.showTerminated",
+      style: "primary",
+      screen: "lease-list-short",
+    },
+  ],
   rowActions: [openLeaseDetail],
   access: OPEN_ACCESS,
 };