okengine 0.19.0 → 0.19.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okengine",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "One law. Eight elements. One contract. The backend model stays small; operational surfaces are derived from it instead of maintained separately.",
   "license": "MIT",
   "repository": {

package/site/content/docs/ai/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "AI Resources",
   "icon": "Bot",
-  "pages": ["try-it", "index", "mcp", "skills", "llms-txt"]
+  "pages": ["index", "mcp", "skills", "llms-txt"]
 }

package/site/content/docs/ai/skills.mdx

@@ -46,7 +46,7 @@ Contracts teach the _vocabulary_; [MCP](/docs/ai/mcp) grants the _hands_. An age
 ## Learn more
 
 - [MCP](/docs/ai/mcp) — the runtime surface these contracts pair with
-- [The Model](/docs/understand/the-model) — the eight elements in human terms
+- [The Architecture](/docs/understand/the-architecture) — the eight elements in human terms
 - [llms.txt](/docs/ai/llms-txt) — `/llms.txt`, `/llms.json`, `/llms/agents`, per-page markdown
 
 ## Next

package/site/content/docs/client/index.mdx

@@ -184,8 +184,7 @@ dev so `createClient("")` stays same-origin behind the Vite proxy.
 
 - [Routing](/docs/elements/flow/routing) — folders are the URL; `$routes` without `.adopt()`
 - [HTTP](/docs/elements/flow/http) — verbs, `http.resource`, live SSE
-- [The Anatomy](/docs/understand/the-anatomy) — generated barrel → client → test loop
-- [The Model](/docs/understand/the-model) — same contract for Client, Console, MCP
+- [The Architecture](/docs/understand/the-architecture) — generated barrel → client → test loop; same contract for Client, Console, MCP
 - [Errors](/docs/reference/errors) — framework codes vs failure values
 
 ## Next

package/site/content/docs/elements/ai/agents.mdx

@@ -54,9 +54,12 @@ import { supportAgent } from "@/core/ai";
 import { member } from "@/core/gate";
 
 export const assist = on(
-  http.post().gate(member),
+  http
+    .post({
+      in: z.object({ query: z.string().min(1) }),
+    })
+    .gate(member),
   flow({
-    in: z.object({ query: z.string().min(1) }),
     do: async ({ query }, fx) => {
       return await fx.run(supportAgent, {
         message: `Help the member: ${query}`,

package/site/content/docs/elements/ai/index.mdx

@@ -60,9 +60,10 @@ import { z } from "zod";
 import { triage } from "@/core/ai";
 
 export const classify = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ message: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ message }, fx) => {
       return await fx.ask(triage, { message });
     },
@@ -336,6 +337,6 @@ Compose does not pin inference — BYO URL + keys, or [OpenRouter](/docs/recipes
   <Card
     title="The Model"
     description="Eight elements overview."
-    href="/docs/understand/the-model"
+    href="/docs/understand/the-architecture"
   />
 </Cards>

package/site/content/docs/elements/ai/prompts.mdx

@@ -56,9 +56,10 @@ import { z } from "zod";
 import { classifyTicket } from "@/core/ai";
 
 export const classify = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ message: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ message }, fx) => {
       return await fx.ask(classifyTicket, { message });
     },

package/site/content/docs/elements/channel/email.mdx

@@ -66,9 +66,12 @@ import { z } from "zod";
 import { passwordReset } from "@/core/channel";
 
 export const reset = on(
-  http.post().public(),
+  http
+    .post({
+      in: z.object({ email: z.string().email() }),
+    })
+    .public(),
   flow({
-    in: z.object({ email: z.string().email() }),
     do: async ({ email }, fx) => {
       await fx.send(passwordReset, {
         to: email,

package/site/content/docs/elements/channel/index.mdx

@@ -339,6 +339,6 @@ Env knobs: [Environment variables](/docs/reference/environment-variables). Local
   <Card
     title="The Model"
     description="Eight elements overview."
-    href="/docs/understand/the-model"
+    href="/docs/understand/the-architecture"
   />
 </Cards>

package/site/content/docs/elements/clock/index.mdx

@@ -140,10 +140,11 @@ import { on, flow, http } from "okengine";
 import { z } from "zod";
 
 export const start = on(
-  http.post(),
+  http.post({
+    in: z.object({ email: z.string().email() }),
+  }),
   flow({
     durable: true,
-    in: z.object({ email: z.string().email() }),
     do: async ({ email }, fx) => {
       await fx.step("mark-trial", async () => {
         await fx.call(startTrial, { email });

package/site/content/docs/elements/clock/sleep.mdx

@@ -30,10 +30,11 @@ import { on, flow, http } from "okengine";
 import { z } from "zod";
 
 export const start = on(
-  http.post(),
+  http.post({
+    in: z.object({ email: z.string().email() }),
+  }),
   flow({
     durable: true,
-    in: z.object({ email: z.string().email() }),
     do: async ({ email }, fx) => {
       await fx.step("mark-trial", async () => {
         await fx.call(startTrial, { email });
@@ -101,10 +102,11 @@ import { on, flow, http } from "okengine";
 import { z } from "zod";
 
 export const create = on(
-  http.post(),
+  http.post({
+    in: z.object({ email: z.string().email() }),
+  }),
   flow({
     durable: true,
-    in: z.object({ email: z.string().email() }),
     do: async ({ email }, fx) => {
       await fx.step("create", async () => {
         await fx.call(createWorkspace, { email });
@@ -256,11 +258,12 @@ import { on, flow, http } from "okengine";
 import { z } from "zod";
 
 export const create = on(
-  http.post(),
-  flow({
-    durable: true,
+  http.post({
     in: z.object({ email: z.string().email() }),
     out: z.object({ trialId: z.string() }),
+  }),
+  flow({
+    durable: true,
     do: async ({ email }, fx) => {
       const trialId = await fx.step("create", async () => {
         return await fx.call(createTrial, { email });

package/site/content/docs/elements/flow/index.mdx

@@ -582,7 +582,7 @@ Default is `true` once `gate.auth.tenant` is on.
 
 ## Learn more
 
-- [The Anatomy](/docs/understand/the-anatomy) — `on`, trigger, `flow`, `do`, `fx`
+- [The Architecture](/docs/understand/the-architecture) — `on`, trigger, `flow`, `do`, `fx`
 - [HTTP](/docs/elements/flow/http) — verbs, envelopes, resources, live SSE
 - [Routing](/docs/elements/flow/routing) — file-tree stamps, barrels, OKE1030 · OKE1040–1045
 - [Consumers](/docs/elements/flow/consumers) — Signal / Clock / CDC
@@ -611,8 +611,8 @@ Default is `true` once `gate.auth.tenant` is on.
     href="/docs/elements/flow/workflows"
   />
   <Card
-    title="The Anatomy"
+    title="The Architecture"
     description="Five pieces behind on(trigger, flow)."
-    href="/docs/understand/the-anatomy"
+    href="/docs/understand/the-architecture"
   />
 </Cards>

package/site/content/docs/elements/flow/routing.mdx

@@ -535,7 +535,7 @@ plus a handwritten `http.get("/notes")`.
 - [HTTP](/docs/elements/flow/http) — verbs, envelopes, `http.resource`, live SSE
 - [Client](/docs/client/calling) — `api.notes.get`, REST vs RPC, `$routes`
 - [Errors](/docs/reference/errors) — OKE1040 · OKE1030 · OKE1041 · OKE1045
-- [The Model](/docs/understand/the-model) — derived routes, no hand-written table
+- [The Architecture](/docs/understand/the-architecture) — derived routes, no hand-written table
 - [Gate](/docs/elements/gate) — `.gate(...)` / `.public()` on the same trigger
 
 ## Next

package/site/content/docs/elements/gate/tenancy.mdx

@@ -267,9 +267,12 @@ import { z } from "zod";
 import { member } from "@/core/gate";
 
 export const switchTenant = on(
-  http.post().gate(member),
+  http
+    .post({
+      in: z.object({ tenantId: z.string() }),
+    })
+    .gate(member),
   flow({
-    in: z.object({ tenantId: z.string() }),
     do: async ({ tenantId }, fx) => fx.auth.switchTenant(tenantId),
   }),
 );

package/site/content/docs/elements/signal/broadcast.mdx

@@ -65,9 +65,10 @@ import { z } from "zod";
 import { cacheInvalidated } from "@/signals/cache";
 
 export const update = on(
-  http.patch(),
-  flow({
+  http.patch({
     in: z.object({ sku: z.string(), title: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ sku, title }, fx) => {
       // … persist the change …
       await fx.emit(cacheInvalidated, { key: `sku:${sku}` });
@@ -284,9 +285,10 @@ import { z } from "zod";
 import { catalogChanged } from "@/signals/catalog";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ sku: z.string(), title: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ sku, title }, fx) => {
       // … write …
       await fx.emit(catalogChanged, { sku });

package/site/content/docs/elements/signal/index.mdx

@@ -347,6 +347,6 @@ export default defineConfig({
   <Card
     title="The Model"
     description="Eight elements overview."
-    href="/docs/understand/the-model"
+    href="/docs/understand/the-architecture"
   />
 </Cards>

package/site/content/docs/elements/signal/live.mdx

@@ -342,9 +342,10 @@ import { z } from "zod";
 import { orderStatus } from "@/signals/orders";
 
 export const ship = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ id: z.string() }),
+  }),
+  flow({
     do: async ({ id }, fx) => {
       await fx.emit(orderStatus, { orderId: id, status: "shipped" });
       return { id, status: "shipped" };

package/site/content/docs/elements/signal/once.mdx

@@ -311,9 +311,10 @@ import { z } from "zod";
 import { orderPlaced } from "@/signals/orders";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ userId: z.string(), amount: z.number() }),
+  }),
+  flow({
     do: async ({ userId, amount }, fx) => {
       const orderId = fx.id();
       await fx.emit(orderPlaced, { orderId, amount, userId }, { key: userId });

package/site/content/docs/elements/store/files.mdx

@@ -38,13 +38,14 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({
       name: z.string().min(1),
       bytes: z.string(), // base64 for the demo
     }),
     out: z.object({ key: z.string() }),
+  }),
+  flow({
     do: async ({ name, bytes }, fx) => {
       const key = `uploads/${fx.id()}-${name}`;
       const data = Uint8Array.from(atob(bytes), (c) => c.charCodeAt(0));
@@ -123,9 +124,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const cleanup = on(
-  http.delete(),
-  flow({
+  http.delete({
     in: z.object({ prefix: z.string().default("avatars/") }),
+  }),
+  flow({
     do: async ({ prefix }, fx) => {
       const keys = await fx.store(uploads).list(prefix);
       let removed = 0;
@@ -154,9 +156,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ bytes: z.string() }),
+  }),
+  flow({
     do: async ({ bytes }, fx) => {
       const key = `photos/${fx.id()}.jpg`;
       const data = Uint8Array.from(atob(bytes), (c) => c.charCodeAt(0));
@@ -195,9 +198,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const card = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ sourceKey: z.string() }),
+  }),
+  flow({
     do: async ({ sourceKey }, fx) => {
       const outKey = sourceKey.replace(/\.[^.]+$/, ".card.webp");
       await fx
@@ -282,13 +286,14 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({
       id: z.string(),
       name: z.string().min(1),
       bytes: z.string(),
     }),
+  }),
+  flow({
     do: async ({ id, name, bytes }, fx) => {
       const key = `notes/${id}/${name}`;
       const data = Uint8Array.from(atob(bytes), (c) => c.charCodeAt(0));
@@ -311,10 +316,11 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const get = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ id: z.string(), name: z.string() }),
     errors: { NotFound: z.object({ key: z.string() }) },
+  }),
+  flow({
     do: async ({ id, name }, fx) => {
       const key = `notes/${id}/${name}`;
       const bytes = await fx.store(uploads).get(key);
@@ -337,9 +343,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const remove = on(
-  http.delete(),
-  flow({
+  http.delete({
     in: z.object({ id: z.string(), name: z.string() }),
+  }),
+  flow({
     do: async ({ id, name }, fx) => {
       const key = `notes/${id}/${name}`;
       const removed = await fx.store(uploads).delete(key);
@@ -362,9 +369,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const attachments = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ id: z.string() }),
+  }),
+  flow({
     do: async ({ id }, fx) => {
       const keys = await fx.store(uploads).list(`notes/${id}/`);
       return { keys };

package/site/content/docs/elements/store/index.mdx

@@ -47,9 +47,10 @@ import { z } from "zod";
 import { db, notes } from "@/schema";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ title: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ title }, fx) => {
       const id = fx.id();
       await fx.store(db).insert(notes).values({ id, title });
@@ -106,10 +107,11 @@ import { eq } from "drizzle-orm";
 import { db, notes } from "@/schema";
 
 export const get = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ id: z.string() }),
     errors: { NotFound: z.object({ id: z.string() }) },
+  }),
+  flow({
     do: async ({ id }, fx) => {
       const [note] = await fx.store(db).select().from(notes).where(eq(notes.id, id));
       if (!note) return fx.fail("NotFound", { id });
@@ -128,11 +130,11 @@ Prefer [`store.resource`](/docs/elements/store/sql#resources) when you want five
 Pass the **declaration** into `fx.store` — there is no `fx.store.kv` namespace. TTL is a duration string:
 
 ```typescript title="src/flows/sessions/put.ts"
-import { flow } from "okengine";
+import { call } from "okengine";
 import { z } from "zod";
 import { sessions } from "@/core";
 
-export const putSession = flow("sessions.put", {
+export const putSession = call("sessions.put", {
   in: z.object({ token: z.string(), userId: z.string() }),
   do: async ({ token, userId }, fx) => {
     await fx.store(sessions).set(`session:${token}`, userId, "1h");
@@ -159,9 +161,10 @@ import { z } from "zod";
 import { uploads } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ bytes: z.string() }),
+  }),
+  flow({
     do: async ({ bytes }, fx) => {
       const key = `avatars/${fx.id()}.png`;
       const data = Uint8Array.from(atob(bytes), (c) => c.charCodeAt(0));

package/site/content/docs/elements/store/kv.mdx

@@ -39,9 +39,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ token: z.string(), userId: z.string() }),
+  }),
+  flow({
     do: async ({ token, userId }, fx) => {
       await fx.store(sessions).set(`session:${token}`, userId, "1h");
       const cached = await fx.store(sessions).get(`session:${token}`);
@@ -97,9 +98,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const get = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ userId: z.string() }),
+  }),
+  flow({
     do: async ({ userId }, fx) => {
       const prefs = await fx.store(sessions).get(`user:${userId}:prefs`);
       return { prefs: prefs ?? null };
@@ -122,9 +124,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ userId: z.string() }),
+  }),
+  flow({
     do: async ({ userId }, fx) => {
       const code = "482193";
       await fx.store(sessions).set(`otp:${userId}`, code, "5m");
@@ -251,10 +254,11 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const get = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ token: z.string() }),
     errors: { NotFound: z.object({ token: z.string() }) },
+  }),
+  flow({
     do: async ({ token }, fx) => {
       const userId = await fx.store(sessions).get(`session:${token}`);
       if (userId === undefined || userId === null) {
@@ -278,9 +282,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const create = on(
-  http.post(),
-  flow({
+  http.post({
     in: z.object({ token: z.string(), userId: z.string() }),
+  }),
+  flow({
     do: async ({ token, userId }, fx) => {
       await fx.store(sessions).set(`session:${token}`, userId, "1h");
       return { ok: true as const };
@@ -304,9 +309,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const remove = on(
-  http.delete(),
-  flow({
+  http.delete({
     in: z.object({ token: z.string() }),
+  }),
+  flow({
     do: async ({ token }, fx) => {
       const removed = await fx.store(sessions).delete(`session:${token}`);
       return { removed };
@@ -358,9 +364,10 @@ import { z } from "zod";
 import { sessions } from "@/core";
 
 export const ttl = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ userId: z.string() }),
+  }),
+  flow({
     do: async ({ userId }, fx) => {
       const ttlMs = await fx.store(sessions).ttlMs(`otp:${userId}`);
       return { ttlMs };
@@ -409,13 +416,14 @@ import { z } from "zod";
 import { drafts } from "@/core";
 
 export const save = on(
-  http.put("/drafts/:id"),
-  flow({
+  http.put("/drafts/:id", {
     in: z.object({
       id: z.string().min(1),
       title: z.string().min(1),
       body: z.string().optional(),
     }),
+  }),
+  flow({
     do: async ({ id, title, body }, fx) => {
       await fx.store(drafts).set(id, { title, body: body ?? "" }, "7d");
       return { id };

package/site/content/docs/elements/store/search.mdx

@@ -42,9 +42,10 @@ import { z } from "zod";
 import { articles, db } from "@/schema";
 
 export const search = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ q: z.string() }),
+  }),
+  flow({
     do: async ({ q }, fx) => {
       const result = await fx.store(db).search(articles, {
         query: q,
@@ -399,9 +400,10 @@ import { z } from "zod";
 import { articles, db } from "@/schema";
 
 export const search = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({ q: z.string().min(1) }),
+  }),
+  flow({
     do: async ({ q }, fx) => {
       const result = await fx.store(db).search(articles, {
         query: q,
@@ -430,12 +432,13 @@ import { z } from "zod";
 import { articles, db } from "@/schema";
 
 export const search = on(
-  http.get(),
-  flow({
+  http.get({
     in: z.object({
       q: z.string().min(1),
       status: z.string().optional(),
     }),
+  }),
+  flow({
     do: async ({ q, status }, fx) => {
       const result = await fx.store(db).search(articles, {
         query: q,
@@ -539,7 +542,7 @@ intentional. Do not poll `fx.embed` from the writer to “close” it.
 | ------------------------------------- | ---------------------------------------------------------- |
 | Generated `tsvector` + GIN            | BM25 candidate retrieval (`plainto_tsquery('english', …)`) |
 | `real[]` embedding column             | Stored vector per `.embed()` field                         |
-| `bigint` LSH column + B-tree          | Bucket lookup (Hamming-1 neighbors included)               |
+| `bigint` LSH column + B-tree          | Stored SimHash pack (query ranks by Hamming, not equality) |
 | Corpus stats / DF / hyperplane tables | IDF, average length, stable LSH planes                     |
 
 Hyperplanes insert once (`ON CONFLICT DO NOTHING`) and are **never** regenerated.
@@ -619,8 +622,9 @@ await fx.store(db).search(articles, {
   BM25F uses Robertson–Zaragoza saturation: **k1 = 1.2**, **b = 0.75**. Field
   `weight` multiplies term frequency *before* that saturation.
 
-LSH uses **64** hyperplanes (fits a `bigint` bit pack). Query-time lookup includes
-the exact bucket and Hamming-1 neighbors.
+LSH uses **64** hyperplanes packed into a `bigint`. Query-time retrieval ranks
+rows by Hamming distance (`bit_count` of XOR) and keeps the oversampled nearest
+(`max(limit × 5, 50)`, cap 500), then cosine-reranks in process.
 
 </Accordion>
 
@@ -800,13 +804,13 @@ Headline numbers from the live-Postgres G17 gate (`OKE_TEST_POSTGRES=1`, Bun 1.4
 
 | Corpus size | BM25 (text) p50 | LSH/hybrid p50 | LSH precision@10 vs exact cosine | Guidance                                                                                 |
 | ----------- | --------------- | -------------- | -------------------------------- | ---------------------------------------------------------------------------------------- |
-| ≤10k        | ~1–4 ms         | ~1–6 ms        | ≈0 on this gate                  | Built-in hybrid is fine for ranking UX; do not market LSH recall                         |
-| ~100k       | ~40 ms          | ~50–60 ms      | ≈0                               | Expect tens of ms; re-`EXPLAIN` after `ANALYZE`                                          |
-| ~1M         | ~0.6–1.2 s      | ~0.6–1.2 s     | ≈0                               | Prefer external `store.index` (pgvector / Meilisearch) for semantic recall at this scale |
+| ≤10k        | ~1–5 ms         | ~1–9 ms        | 0.10–0.17 vector                 | Built-in hybrid is fine for ranking UX; LSH is not HNSW                                  |
+| ~100k       | ~21 ms          | ~31–34 ms      | 0.017 vector                     | Expect tens of ms; re-`EXPLAIN` after `ANALYZE`                                          |
+| ~1M         | ~0.3 s          | ~0.4 s         | 0.017 vector / 0 hybrid          | Prefer external `store.index` (pgvector / Meilisearch) for semantic recall at this scale |
 
-**Honest LSH note:** random-hyperplane LSH (K=64, Hamming-1, ≤50 candidates) did **not** match exact brute-force cosine top-10 on the G17 corpus (precision@10 mostly **0**). Same class of honesty as earlier LSH-vs-HNSW design notes — use LSH as a cheap candidate hint inside RRF, not as a recall guarantee. BM25-only needs no AI and remains the smallest path.
+**Honest LSH note:** after the Hamming-rank fix (2026-09-11), vector precision@10 vs exact cosine is 0.17 at 1k, 0.10 at 10k, ~0.02 at 100k–1M on the G17 hash-bag corpus — a smooth drop, not the v0.19.0 zero collapse. Still **not** HNSW. Prefer BM25-only or `store.index` when semantic recall matters.
 
-**Query plan:** at N=100k, `EXPLAIN (ANALYZE, BUFFERS)` showed a **Seq Scan** with a tsvector/LSH Filter — not BitmapOr — despite GIN + B-tree indexes. Capture your own plan on production data before assuming an index path.
+**Query plan:** at N=100k, `EXPLAIN (ANALYZE, BUFFERS)` is a UNION of GIN **Bitmap Index Scan** and a **Parallel Seq Scan** + top-N heapsort on Hamming distance (~15 ms). Hamming-rank cannot use the LSH B-tree. Capture your own plan on production data.
 
 **Backfill:** `oke db search-backfill` is interrupt-safe to re-run (G17 killed at 2k/50k embeds, resumed to completion in ~29 s on that table).