okengine 0.11.2 → 0.12.0

package/src/console/ui-next/ui-next-seed.test.ts

@@ -0,0 +1,511 @@
+/**
+ * Unit tests for the shared ui-next Console seed (Playwright + seeded Vite).
+ */
+
+import { describe, expect, test } from "bun:test";
+import {
+  applyUiNextSeedVaultEnv,
+  createUiNextOperationRuns,
+  createUiNextSeedRun,
+  createUiNextSeedRuns,
+  isConsoleSeeded,
+  seedUiNextStoreData,
+  UI_NEXT_SEED_DIGEST_RUN_ID,
+  UI_NEXT_SEED_DRAFTS_RUN_ID,
+  UI_NEXT_SEED_FAIL_RUN_ID,
+  UI_NEXT_SEED_FEATURED_COUNT,
+  UI_NEXT_SEED_INGEST_RUN_ID,
+  UI_NEXT_SEED_NOTIFY_RUN_ID,
+  UI_NEXT_SEED_OPERATION_COUNT,
+  UI_NEXT_SEED_PLAN_RUN_ID,
+  UI_NEXT_SEED_PUBLIC_APP_URL,
+  UI_NEXT_SEED_VAULT_CONFIG,
+  UI_NEXT_SEED_VAULT_LAYERS,
+  UI_NEXT_SEED_RUN_ID,
+  UI_NEXT_SEED_STORE_COUNTS,
+  UI_NEXT_SEED_TOTAL_COUNT,
+  UI_NEXT_SEEDED_MANIFEST,
+  uiNextSeededSummary,
+} from "./ui-next-seed.ts";
+import { KEEL_SURFACE_FLOWS } from "./ui-next-seed-manifest-surface.ts";
+
+describe("ui-next seed", () => {
+  test("manifest declares all eight elements", () => {
+    expect(UI_NEXT_SEEDED_MANIFEST.app).toBe("keel");
+    expect(UI_NEXT_SEEDED_MANIFEST.flows).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.signals).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.clocks).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.gates).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.vault).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.channels).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.ai).toBeDefined();
+
+    expect(UI_NEXT_SEEDED_MANIFEST.flows?.["my.plan"]?.effects?.asks).toContain("form-classify");
+    expect(UI_NEXT_SEEDED_MANIFEST.flows?.["drafts.expire"]?.trigger?.every).toBe("10m");
+    expect(UI_NEXT_SEEDED_MANIFEST.flows?.["tasks.onStatus"]?.trigger?.cdc).toEqual({
+      table: "tasks",
+      column: "status",
+    });
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["cache"]?.facet).toBe("kv");
+    expect(UI_NEXT_SEEDED_MANIFEST.clocks?.["expire-drafts"]?.every).toBe("10m");
+    expect(UI_NEXT_SEEDED_MANIFEST.vault?.["OPENAI_KEY"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.vault?.["GITHUB_TOKEN"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.vault?.["PUBLIC_APP_URL"]).toMatchObject({
+      sensitive: false,
+      description: "Public Keel origin",
+    });
+    expect(UI_NEXT_SEEDED_MANIFEST.vault?.["PUBLIC_API_URL"]).toMatchObject({
+      sensitive: false,
+      description: "Public API origin",
+    });
+    expect(Object.keys(UI_NEXT_SEEDED_MANIFEST.vault ?? {}).sort()).toEqual([
+      "GITHUB_TOKEN",
+      "KEEL_WORKSPACE",
+      "OPENAI_KEY",
+      "PUBLIC_API_URL",
+      "PUBLIC_APP_URL",
+      "PUBLIC_DOCS_URL",
+      "SLACK_BOT",
+      "SLACK_WEBHOOK",
+      "WEBHOOK_SECRET",
+    ]);
+    expect(UI_NEXT_SEEDED_MANIFEST.flows?.["tasks.list"]?.effects?.secrets).toContain(
+      "PUBLIC_APP_URL",
+    );
+    expect(UI_NEXT_SEEDED_MANIFEST.channels?.["mention-reply"]?.medium).toBe("email");
+    expect(UI_NEXT_SEEDED_MANIFEST.ai?.prompts?.["form-classify"]?.version).toBe(1);
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["task-created"]?.delivery).toBe("once");
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["task-completed"]?.delivery).toBe("broadcast");
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["task-assigned"]?.delivery).toBe("live");
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["comment-added"]?.delivery).toBe("once");
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["draft-expired"]?.delivery).toBe("once");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["keel"]?.facet).toBe("files");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["keel"]?.buckets).toEqual(["keel"]);
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["search"]?.facet).toBe("index");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["documents"]?.facet).toBe("index");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["comments"]?.facet).toBe("index");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["projects"]?.facet).toBe("index");
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["search"]?.indexes).toEqual(["tasks"]);
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["documents"]?.indexes).toEqual(["documents"]);
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["comments"]?.indexes).toEqual(["comments"]);
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["projects"]?.indexes).toEqual(["projects"]);
+    expect(
+      UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["tasks"]?.columns?.["creator_email"],
+    ).toMatchObject({ pii: true });
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["spaces"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["goals"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["forms"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["teams"]).toBeUndefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["cycles"]).toBeUndefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["issues"]).toBeUndefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["customer_requests"]).toBeUndefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["oke_identities"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["oke_sessions"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["oke_crons"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.stores?.["db"]?.tables?.["oke_vault_secrets"]).toBeDefined();
+  });
+
+  test("manifest covers full CRUD, custom routes, and every HTTP verb", () => {
+    const flows = UI_NEXT_SEEDED_MANIFEST.flows ?? {};
+    const ids = Object.keys(flows);
+    expect(ids.length).toBeGreaterThanOrEqual(80);
+
+    for (const id of [
+      "tasks.get",
+      "tasks.delete",
+      "tasks.archive",
+      "tasks.assign",
+      "tasks.complete",
+      "tasks.follow",
+      "tasks.duplicate",
+      "tasks.move",
+      "tasks.depend",
+      "comments.list",
+      "comments.update",
+      "comments.delete",
+      "comments.resolve",
+      "projects.list",
+      "projects.get",
+      "projects.update",
+      "projects.delete",
+      "documents.list",
+      "documents.delete",
+      "attachments.list",
+      "attachments.delete",
+      "spaces.list",
+      "tags.create",
+      "goals.list",
+      "members.invite",
+      "views.list",
+      "forms.create",
+      "inbox.list",
+      "my.tasks",
+      "search.query",
+      "drafts.save",
+      "webhooks.rotate",
+      "slack.ingest",
+      "main.health",
+    ]) {
+      expect(flows[id]).toBeDefined();
+    }
+
+    const methods = new Set(
+      ids
+        .map((id) => flows[id]?.trigger?.http?.method)
+        .filter((m): m is NonNullable<typeof m> => m != null),
+    );
+    for (const method of ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "QUERY"] as const) {
+      expect(methods.has(method)).toBe(true);
+    }
+
+    expect(flows["search.query"]?.trigger?.http).toEqual({ method: "QUERY", path: "/search" });
+    const listIn = flows["tasks.list"]?.in;
+    expect(listIn && typeof listIn === "object" ? listIn.properties : null).toMatchObject({
+      q: { type: "string" },
+      limit: { type: "integer", default: 25 },
+      offset: { type: "integer", default: 0 },
+      cursor: { type: "string" },
+      orderBy: { type: "string" },
+      order: { enum: ["asc", "desc"] },
+    });
+    expect(flows["comments.list"]?.in).toEqual(flows["tasks.list"]?.in);
+    expect(flows["drafts.save"]?.trigger?.http?.method).toBe("PUT");
+    expect(flows["main.health"]?.trigger?.http?.method).toBe("HEAD");
+    expect(flows["github.ingest"]?.trigger?.http?.method).toBe("POST");
+    expect(UI_NEXT_SEEDED_MANIFEST.signals?.["task-assigned"]?.delivery).toBe("live");
+    expect(UI_NEXT_SEEDED_MANIFEST.clocks?.["daily-digest"]?.cron).toBe("0 8 * * *");
+    expect(UI_NEXT_SEEDED_MANIFEST.vault?.["WEBHOOK_SECRET"]).toBeDefined();
+    expect(UI_NEXT_SEEDED_MANIFEST.gates?.["comment:write"]?.kind).toBe("policy");
+
+    const featured = [
+      "github.ingest",
+      "tasks.create",
+      "tasks.update",
+      "tasks.list",
+      "comments.create",
+      "projects.create",
+      "documents.upsert",
+      "attachments.upload",
+      "forms.submit",
+      "notify.onTask",
+      "notify.onComment",
+      "search.index",
+      "tasks.onStatus",
+      "drafts.expire",
+      "overdue.watch",
+    ];
+    for (const id of featured) {
+      expect(KEEL_SURFACE_FLOWS[id]).toBeUndefined();
+      expect(flows[id]).toBeDefined();
+    }
+  });
+
+  test("primary seed run keeps Playwright-stable id and rich ledger", () => {
+    const run = createUiNextSeedRun(1_700_000_000_000);
+    expect(run.id).toBe(UI_NEXT_SEED_RUN_ID);
+    expect(run.flow).toBe("tasks.create");
+    expect(run.unit).toBe("tasks");
+    expect(run.parentId).toBe(UI_NEXT_SEED_INGEST_RUN_ID);
+    expect(run.tenant).toBe("ws_keel");
+    expect(run.gates).toContain("task:write");
+    expect(run.effects.some((e) => e.kind === "emit" && e.resource === "task-created")).toBe(true);
+    expect(run.logs.length).toBeGreaterThan(0);
+    expect(run.input).toEqual({
+      title: "SSO login fails",
+      spaceKey: "ENG",
+      priority: 1,
+    });
+    expect(run.output).toEqual({ id: "tsk_eng_12", identifier: "ENG-12" });
+  });
+
+  test("featured runs cover chain + AI + clock elements", () => {
+    const runs = createUiNextSeedRuns(1_700_000_000_000);
+    expect(runs.length).toBe(UI_NEXT_SEED_TOTAL_COUNT);
+    expect(UI_NEXT_SEED_TOTAL_COUNT).toBe(
+      UI_NEXT_SEED_FEATURED_COUNT + UI_NEXT_SEED_OPERATION_COUNT,
+    );
+    expect(UI_NEXT_SEED_TOTAL_COUNT).toBeGreaterThanOrEqual(50);
+    expect(UI_NEXT_SEED_TOTAL_COUNT).toBeLessThanOrEqual(100);
+
+    const byId = new Map(runs.map((r) => [r.id, r]));
+    const create = byId.get(UI_NEXT_SEED_RUN_ID);
+    const notify = byId.get(UI_NEXT_SEED_NOTIFY_RUN_ID);
+    const ingest = byId.get(UI_NEXT_SEED_INGEST_RUN_ID);
+    const fail = byId.get(UI_NEXT_SEED_FAIL_RUN_ID);
+    const plan = byId.get(UI_NEXT_SEED_PLAN_RUN_ID);
+    const drafts = byId.get(UI_NEXT_SEED_DRAFTS_RUN_ID);
+    const digest = byId.get(UI_NEXT_SEED_DIGEST_RUN_ID);
+
+    expect(ingest?.flow).toBe("github.ingest");
+    expect(ingest?.effects.some((e) => e.kind === "call")).toBe(true);
+    expect(ingest?.effects.some((e) => e.kind === "secret")).toBe(true);
+    expect(create?.parentId).toBe(UI_NEXT_SEED_INGEST_RUN_ID);
+    expect(notify?.parentId).toBe(UI_NEXT_SEED_RUN_ID);
+    expect(notify?.trigger).toBe("signal");
+    expect(notify?.effects.some((e) => e.kind === "send")).toBe(true);
+    expect(fail?.error?.code).toBe("Forbidden");
+    expect(fail?.output).toBeUndefined();
+    expect(plan?.output).toMatchObject({ replyQueued: true, template: "mention-reply" });
+    expect(plan?.effects.some((e) => e.kind === "ask")).toBe(true);
+    expect(plan?.effects.some((e) => e.kind === "secret" && e.resource === "OPENAI_KEY")).toBe(
+      true,
+    );
+    expect(plan?.cost).toBeGreaterThan(0);
+    expect(drafts?.trigger).toBe("every");
+    expect(drafts?.effects.some((e) => e.resource === "kv:drafts")).toBe(true);
+    expect(drafts?.effects.some((e) => e.kind === "emit" && e.resource === "draft-expired")).toBe(
+      true,
+    );
+    expect(digest?.trigger).toBe("cron");
+    expect(digest?.effects.some((e) => e.kind === "send" && e.resource === "daily-digest")).toBe(
+      true,
+    );
+  });
+
+  test("operation traffic is deterministic and spans manifest flows", () => {
+    const a = createUiNextOperationRuns(1_700_000_000_000);
+    const b = createUiNextOperationRuns(1_700_000_000_000);
+    expect(a.length).toBe(UI_NEXT_SEED_OPERATION_COUNT);
+    expect(a.map((r) => r.id)).toEqual(b.map((r) => r.id));
+
+    const flows = new Set(a.map((r) => r.flow));
+    expect(flows.has("tasks.create")).toBe(true);
+    expect(flows.has("tasks.list")).toBe(true);
+    expect(flows.has("notify.onTask")).toBe(true);
+    expect(flows.has("github.ingest")).toBe(true);
+    expect(flows.has("my.plan") || flows.has("drafts.expire")).toBe(true);
+    expect(
+      [...flows].some((id) =>
+        ["tasks.get", "tasks.archive", "tasks.assign", "search.query", "drafts.save"].includes(id),
+      ),
+    ).toBe(true);
+
+    const failed = a.filter((r) => r.error?.code === "Forbidden" || r.error?.code === "Duplicate");
+    expect(failed.length).toBeGreaterThan(0);
+
+    const chained = a.filter((r) => r.parentId?.startsWith("pw-ops-create-"));
+    expect(chained.length).toBeGreaterThan(0);
+  });
+
+  test("seed vault config is non-sensitive and projects in the clear", async () => {
+    const { createManifestVaultRuntime, projectVaultList } = await import("../server/vault.ts");
+    const layers = UI_NEXT_SEED_VAULT_LAYERS;
+    const runtime = await createManifestVaultRuntime(UI_NEXT_SEEDED_MANIFEST, {
+      env: "dev",
+      driverId: "memory",
+      seed: layers.driver,
+      overlays: {
+        ...(layers.processEnv !== undefined ? { "process.env": layers.processEnv } : {}),
+        ...(layers.envLocal !== undefined ? { ".env.local": layers.envLocal } : {}),
+      },
+      ...(layers.devFallback !== undefined ? { devFallbacks: layers.devFallback } : {}),
+    });
+    const listed = await projectVaultList({
+      manifest: UI_NEXT_SEEDED_MANIFEST,
+      runtime,
+      env: "dev",
+    });
+    const byName = Object.fromEntries(listed.secrets.map((row) => [row.name, row]));
+    expect(byName["PUBLIC_APP_URL"]).toMatchObject({
+      kind: "config",
+      sensitive: false,
+      cleartext: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_APP_URL,
+      winner: "process.env",
+      readers: ["tasks.list"],
+    });
+    expect(byName["PUBLIC_API_URL"]).toMatchObject({
+      kind: "config",
+      cleartext: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_API_URL,
+      winner: "driver",
+      readers: ["main.health"],
+    });
+    expect(byName["PUBLIC_DOCS_URL"]).toMatchObject({
+      kind: "config",
+      cleartext: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_DOCS_URL,
+      winner: ".env.local",
+      readers: ["search.query"],
+    });
+    expect(byName["KEEL_WORKSPACE"]).toMatchObject({
+      kind: "config",
+      cleartext: UI_NEXT_SEED_VAULT_CONFIG.KEEL_WORKSPACE,
+      winner: "process.env",
+      readers: ["tasks.list"],
+    });
+    expect(byName["GITHUB_TOKEN"]).toMatchObject({ kind: "secret", winner: "driver" });
+    expect(byName["OPENAI_KEY"]).toMatchObject({ kind: "secret", winner: "driver" });
+    expect(byName["WEBHOOK_SECRET"]).toMatchObject({ kind: "secret", winner: "process.env" });
+    expect(byName["SLACK_WEBHOOK"]).toMatchObject({ kind: "secret", winner: ".env.local" });
+    expect(byName["SLACK_BOT"]).toMatchObject({ kind: "secret", winner: "dev-fallback" });
+    expect(listed.secrets).toHaveLength(9);
+  });
+
+  test("applyUiNextSeedVaultEnv pins PUBLIC_APP_URL without clobbering", () => {
+    const prev = process.env["PUBLIC_APP_URL"];
+    try {
+      delete process.env["PUBLIC_APP_URL"];
+      applyUiNextSeedVaultEnv();
+      expect(process.env["PUBLIC_APP_URL"]).toBe(UI_NEXT_SEED_PUBLIC_APP_URL);
+      process.env["PUBLIC_APP_URL"] = "https://app.example.com";
+      applyUiNextSeedVaultEnv();
+      expect(process.env["PUBLIC_APP_URL"]).toBe("https://app.example.com");
+    } finally {
+      if (prev === undefined) delete process.env["PUBLIC_APP_URL"];
+      else process.env["PUBLIC_APP_URL"] = prev;
+    }
+  });
+
+  test("seeded env flag and summary are explicit", () => {
+    const prev = process.env["OKE_CONSOLE_SEEDED"];
+    try {
+      delete process.env["OKE_CONSOLE_SEEDED"];
+      expect(isConsoleSeeded()).toBe(false);
+      process.env["OKE_CONSOLE_SEEDED"] = "1";
+      expect(isConsoleSeeded()).toBe(true);
+      expect(uiNextSeededSummary()).toContain(UI_NEXT_SEED_RUN_ID);
+      expect(uiNextSeededSummary()).toContain(String(UI_NEXT_SEED_TOTAL_COUNT));
+      expect(uiNextSeededSummary()).toContain("8 elements");
+      expect(uiNextSeededSummary()).toContain(`${UI_NEXT_SEED_STORE_COUNTS.sqlTasks} tasks`);
+    } finally {
+      if (prev === undefined) delete process.env["OKE_CONSOLE_SEEDED"];
+      else process.env["OKE_CONSOLE_SEEDED"] = prev;
+    }
+  });
+
+  test("seedUiNextStoreData fills all four facets with non-zero rows", async () => {
+    const { createManifestStoreRuntime, queryStore } = await import("../server/store.ts");
+    const runtime = await createManifestStoreRuntime(UI_NEXT_SEEDED_MANIFEST);
+    try {
+      await seedUiNextStoreData(runtime);
+
+      const tasks = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "tasks",
+        revealPii: true,
+        limit: 2000,
+      });
+      expect(tasks.rows?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.sqlTasks);
+      expect(UI_NEXT_SEED_STORE_COUNTS.sqlTasks).toBeGreaterThanOrEqual(500);
+      expect(typeof tasks.rows?.[0]?.identifier).toBe("string");
+      expect(String(tasks.rows?.[0]?.identifier).length).toBeGreaterThan(0);
+      const descriptions = tasks.rows?.map((r) => r.description) ?? [];
+      expect(descriptions.some((n) => typeof n === "string" && /[؀-ۿ]/.test(n))).toBe(true);
+
+      const spaces = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "spaces",
+        limit: 2000,
+      });
+      expect(spaces.rows?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.sqlSpaces);
+
+      const members = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "members",
+        revealPii: true,
+        limit: 2000,
+      });
+      expect(members.rows?.some((r) => String(r.email).endsWith("@keel.dev"))).toBe(true);
+
+      const identities = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "oke_identities",
+        revealPii: true,
+        limit: 2000,
+      });
+      expect(identities.rows?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.sqlIdentities);
+      expect(identities.rows?.length).toBeGreaterThan(0);
+      expect(identities.rows?.some((r) => r.email === "aria@keel.dev")).toBe(true);
+
+      const crons = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "oke_crons",
+        limit: 2000,
+      });
+      expect(crons.rows?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.sqlCrons);
+      expect(crons.rows?.some((r) => r.name === "expire-drafts")).toBe(true);
+
+      const comments = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "sql:db",
+        child: "comments",
+        revealPii: true,
+        limit: 2000,
+      });
+      expect(comments.rows?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.sqlComments);
+      const bodies = comments.rows?.map((r) => r.body) ?? [];
+      expect(bodies.some((n) => typeof n === "string" && /[؀-ۿ]/.test(n))).toBe(true);
+
+      const drafts = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "kv:cache",
+        child: "drafts",
+        limit: 2000,
+      });
+      const reminders = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "kv:cache",
+        child: "reminders",
+        limit: 2000,
+      });
+      expect((drafts.keys?.length ?? 0) + (reminders.keys?.length ?? 0)).toBe(
+        UI_NEXT_SEED_STORE_COUNTS.kvKeys,
+      );
+      expect(drafts.keys?.every((k) => k.key.startsWith("drafts:"))).toBe(true);
+      expect(reminders.keys?.every((k) => k.key.startsWith("reminders:"))).toBe(true);
+
+      const files = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "files:keel",
+        child: "keel",
+        limit: 2000,
+      });
+      expect(files.keys?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.filesAttachments);
+      const fileRoots = new Set(
+        (files.keys ?? []).map((row) => row.key.split("/")[0]).filter((name) => name !== ".oke"),
+      );
+      expect(fileRoots).toEqual(
+        new Set(["attachments", "documents", "avatars", "projects", "exports", "forms"]),
+      );
+
+      const index = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "index:search",
+        child: "tasks",
+        vector: [1, 0, 0],
+        topK: 80,
+      });
+      expect(index.hits?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.indexTasks);
+
+      const text = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "index:search",
+        child: "tasks",
+        q: "SSO login",
+        topK: 5,
+      });
+      expect(text.hits?.[0]?.id).toBe("tsk_eng_12");
+      expect(text.hits?.[0]?.meta).toMatchObject({ identifier: "ENG-12" });
+
+      const documents = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "index:documents",
+        child: "documents",
+        q: "Harbor API PRD",
+        topK: 5,
+      });
+      expect(documents.hits?.length).toBeGreaterThan(0);
+      expect(documents.hits?.[0]?.id).toBe("doc_prd_api");
+
+      const commentsIdx = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "index:comments",
+        child: "comments",
+        vector: [1, 0, 0],
+        topK: 500,
+      });
+      expect(commentsIdx.hits?.length).toBe(UI_NEXT_SEED_STORE_COUNTS.indexComments);
+
+      const projectsIdx = await queryStore(runtime, UI_NEXT_SEEDED_MANIFEST, {
+        ref: "index:projects",
+        child: "projects",
+        q: "Harbor API",
+        topK: 5,
+      });
+      expect(projectsIdx.hits?.[0]?.id).toBe("proj_api");
+    } finally {
+      await runtime.close();
+    }
+  });
+});

package/src/console/ui-next/ui-next-seed.ts

@@ -0,0 +1,122 @@
+/**
+ * Shared ui-next seed — same Manifest + WideEvents used by Playwright and
+ * `bun run dev:console:seed` so manual browser exploration matches CI.
+ *
+ * Lives beside the Vite kernel plugin (root `tsc` include).
+ *
+ * Seed story (keel): a featured github→create→notify chain, a full CRUD +
+ * custom-route HTTP surface, plus ~70 operational traces so Traces looks
+ * like a live Asana/ClickUp/Monday-shaped workspace (50–100 band).
+ */
+
+import type { VaultLayerSeed } from "../server/vault.ts";
+import type { RunsStore, WideEvent } from "../../runs/types.ts";
+import {
+  createUiNextSeedRuns,
+  UI_NEXT_SEED_OPERATION_COUNT,
+  UI_NEXT_SEED_RUN_ID,
+  UI_NEXT_SEED_TOTAL_COUNT,
+} from "./ui-next-seed-runs.ts";
+import { UI_NEXT_SEED_STORE_COUNTS } from "./ui-next-seed-store.ts";
+export { UI_NEXT_SEEDED_MANIFEST } from "./ui-next-seed-manifest.ts";
+export {
+  createUiNextOperationRuns,
+  createUiNextSeedRun,
+  createUiNextSeedRuns,
+  UI_NEXT_SEED_DIGEST_RUN_ID,
+  UI_NEXT_SEED_DRAFTS_RUN_ID,
+  UI_NEXT_SEED_FAIL_RUN_ID,
+  UI_NEXT_SEED_FEATURED_COUNT,
+  UI_NEXT_SEED_INGEST_RUN_ID,
+  UI_NEXT_SEED_LIST_RUN_ID,
+  UI_NEXT_SEED_NOTIFY_RUN_ID,
+  UI_NEXT_SEED_OPERATION_COUNT,
+  UI_NEXT_SEED_PLAN_RUN_ID,
+  UI_NEXT_SEED_RUN_ID,
+  UI_NEXT_SEED_TOTAL_COUNT,
+} from "./ui-next-seed-runs.ts";
+export { seedUiNextStoreData, UI_NEXT_SEED_STORE_COUNTS } from "./ui-next-seed-store.ts";
+
+/**
+ * Append the full ui-next seed WideEvent chain to a Console runs store.
+ *
+ * @param runs - Booted Console runs store
+ * @param now - Clock ms
+ */
+export async function appendUiNextSeedRun(
+  runs: Pick<RunsStore, "append">,
+  now: number = Date.now(),
+): Promise<readonly WideEvent[]> {
+  const seeds = createUiNextSeedRuns(now);
+  for (const seed of seeds) {
+    await runs.append(seed);
+  }
+  return seeds;
+}
+
+/**
+ * Cleartext values for seeded `vault.config`.
+ */
+export const UI_NEXT_SEED_VAULT_CONFIG = {
+  PUBLIC_APP_URL: "http://127.0.0.1:6530",
+  PUBLIC_API_URL: "http://127.0.0.1:6530/api",
+  PUBLIC_DOCS_URL: "http://127.0.0.1:3000/docs",
+  KEEL_WORKSPACE: "keel",
+} as const;
+
+/** Process.env-won public origin — alias of {@link UI_NEXT_SEED_VAULT_CONFIG}. */
+export const UI_NEXT_SEED_PUBLIC_APP_URL = UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_APP_URL;
+
+/**
+ * Per-layer seed — real keel contracts, one winner each. The `.env.local`
+ * overlay is in-memory — it does not write the project file.
+ */
+export const UI_NEXT_SEED_VAULT_LAYERS: VaultLayerSeed = {
+  driver: {
+    GITHUB_TOKEN: "ghp_seed_keel_github_sync",
+    OPENAI_KEY: "sk-seed-keel-planner",
+    PUBLIC_API_URL: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_API_URL,
+  },
+  processEnv: {
+    PUBLIC_APP_URL: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_APP_URL,
+    KEEL_WORKSPACE: UI_NEXT_SEED_VAULT_CONFIG.KEEL_WORKSPACE,
+    WEBHOOK_SECRET: "whsec_seed_keel_outbound",
+  },
+  envLocal: {
+    SLACK_WEBHOOK: "https://hooks.slack.test/keel/goal-digest",
+    PUBLIC_DOCS_URL: UI_NEXT_SEED_VAULT_CONFIG.PUBLIC_DOCS_URL,
+  },
+  devFallback: {
+    SLACK_BOT: "xoxb-seed-keel-intake",
+  },
+};
+
+/**
+ * Pin process.env-won config when unset. Does not overwrite an
+ * operator-supplied value.
+ */
+export function applyUiNextSeedVaultEnv(): void {
+  for (const [name, value] of Object.entries(UI_NEXT_SEED_VAULT_LAYERS.processEnv ?? {})) {
+    const current = process.env[name];
+    if (current === undefined || current === "") process.env[name] = value;
+  }
+}
+
+/**
+ * True when `OKE_CONSOLE_SEEDED=1` (seeded `dev:console:seed` mode).
+ */
+export function isConsoleSeeded(): boolean {
+  return process.env["OKE_CONSOLE_SEEDED"] === "1";
+}
+
+/**
+ * One-line description of what seeded mode preloads.
+ */
+export function uiNextSeededSummary(): string {
+  return (
+    `keel graph (all 8 elements) + ${UI_NEXT_SEED_TOTAL_COUNT} traces ` +
+    `(featured chain + AI planner + clocks + ${UI_NEXT_SEED_OPERATION_COUNT} ops) + ` +
+    `${UI_NEXT_SEED_STORE_COUNTS.sqlTasks} tasks — ` +
+    `click ${UI_NEXT_SEED_RUN_ID} to highlight the chain`
+  );
+}