okengine 0.19.3 → 0.19.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okengine",
-  "version": "0.19.3",
+  "version": "0.19.5",
   "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/elements/channel/index.mdx

@@ -57,7 +57,7 @@ import { noteCreated } from "./signals";
 
 export const onCreated = on(
   noteCreated,
-  flow({
+  flow("notes.onCreated", {
     do: async (payload, fx) => {
       await fx.send(noteCreatedMail, {
         to: "you@localhost",

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

@@ -5,7 +5,7 @@ icon: "Clock"
 source: "docs/spec/unified-theory.md"
 ---
 
-Clock is how your backend **knows what time it is and when to run again**. A monthly invoice job, a 30s health ping, and a three-day trial reminder share one vocabulary: declare a named schedule, bind it with `on(clockDecl, flow)`, and read time only through `fx.clock`.
+Clock is how your backend **knows what time it is and when to run again**. A monthly invoice job, a 30s health ping, and a three-day trial reminder share one vocabulary: declare a named schedule, bind it with `on(clockDecl, flow("name", { do }))`, and read time only through `fx.clock`.
 
 For developers scheduling work on okengine — one handle shape; drivers swap by environment.
 
@@ -58,9 +58,8 @@ export const digest = on(
 ### See it tick
 
 With `oke dev`, the scheduler reconciles `notes.digest` into the Store and leader-elects
-before each fire. `do` receives no payload — read time with `fx.clock.now()` (epoch-ms for
-math). Map to ISO on the wire when the Flow returns a human-facing instant
-(`new Date(fx.clock.now()).toISOString()`).
+before each fire. `do` receives no payload — read time with `fx.clock.now()` (epoch-ms).
+Map to ISO on the wire with `new Date(fx.clock.now()).toISOString()`.
 
 Under `drivers.clock.test = "frozen"`, advance time in tests instead of waiting a day.
 
@@ -69,35 +68,39 @@ Under `drivers.clock.test = "frozen"`, advance time in tests instead of waiting
 </Steps>
 
 <Callout title="Jobs are Flows">
-  `on(clockDecl, flow)` is the same species as Signal consumers and HTTP handlers. There is no
-  separate job runner — see [Consumers · Clock Jobs](/docs/elements/flow/consumers#clock-jobs).
+  Write the schedule inline or export it — [Inline or named export](#inline-or-named-export).
+  Every consumer still uses `flow("name", { do })`. See
+  [Consumers · Clock Jobs](/docs/elements/flow/consumers#clock-jobs).
 </Callout>
 
 ## Inline or named export
 
-| Style                                         | When                                                              |
-| --------------------------------------------- | ----------------------------------------------------------------- |
-| `on(clock.every("name", "1h"), flow({ do }))` | Self-contained — nothing else needs the Clock handle              |
-| `export const x = clock.every("name", "1h")`  | Another file (or a second `on()`) must reuse the same declaration |
+| Style                                                     | When                              |
+| --------------------------------------------------------- | --------------------------------- |
+| `on(clock.every("name", "1h"), flow("ops.ping", { do }))` | One Flow owns this schedule       |
+| `export const x = clock.every("name", "1h")`              | Several Flows share this schedule |
 
-Both styles stamp the same Manifest `flow.trigger`. The choice is where the
-declaration lives, not two runtimes.
+<Callout title="Why Clock can be inline">
+  `fx.clock` is now / sleep / offsets — not an emit. Signal stays an exported const so producers can
+  `fx.emit(handle, payload)`. Export a Clock const only to share one schedule across named Flows.
+</Callout>
 
-What the Flow is called is a separate choice — [Flow name](#flow-name).
+Both styles pass a real `flow("name", { do })`. Nameless `flow({ do })` fails
+**OKE1072** — the trigger's name is never the Flow's name.
 
 <Tabs items={["Inline", "Named"]}>
 
 <Tab value="Inline">
 
-One file — declare and bind together. The scheduler fires it; no other file
-imports the handle:
+One file — declare and bind together. The scheduler fires it; no other Flow
+binds this cadence:
 
 ```typescript title="src/flows/health/ping.ts"
 import { on, flow, clock } from "okengine";
 
 export const pingExternal = on(
   clock.every("health.pingExternal", "30s"),
-  flow({
+  flow("health.pingExternal", {
     plane: "operator",
     do: async (_, fx) => {
       await fx.call(pingUpstream);
@@ -110,79 +113,21 @@ export const pingExternal = on(
 
 <Tab value="Named">
 
-Export the handle when another file (or a second `on()`) must reuse the same
-declaration:
+Export the handle when a second `on()` must reuse the same schedule. Each Flow
+keeps its own explicit name — **OKE1070** if they collide:
 
-```typescript title="src/clocks/digest.ts"
+```typescript title="src/clocks/metrics.ts"
 import { clock } from "okengine";
 
-export const digestClock = clock.every("notes.digest", "1d");
+export const tickClock = clock.every("metrics.tick", "1h");
 ```
 
-```typescript title="src/flows/notes/digest.ts"
+```typescript title="src/flows/ops/metrics.ts"
 import { on, flow } from "okengine";
-import { digestClock } from "@/clocks/digest";
-
-export const digest = on(
-  digestClock,
-  flow("notes.digest", {
-    plane: "operator",
-    do: async (_, fx) => {
-      await fx.call(buildDigest, { at: fx.clock.now() });
-    },
-  }),
-);
-```
-
-</Tab>
-
-</Tabs>
-
-## Flow name
-
-| Style                     | When                                                             |
-| ------------------------- | ---------------------------------------------------------------- |
-| `flow({ do })`            | No unit folder — Flow name is the Clock name (`metrics.cleanup`) |
-| `flow("ops.sweep")`       | Manifest / `fx.call` name must differ from the Clock             |
-| Tree `export const sweep` | `src/flows/ops/sweep.ts` stamps `ops.sweep` — overwrites inherit |
-
-Explicit `flow("…")` and the file tree overwrite inherit. HTTP does not inherit a
-name from the path — nameless HTTP stays for the tree or fails **OKE1045**. Two
-Flows that land on the same name fail **OKE1070** (`Flow "{flow}" is defined twice.`).
-
-<Tabs items={["Inherit", "Explicit", "Tree"]}>
-
-<Tab value="Inherit">
-
-A file directly in `src/flows/` (no unit folder) has nothing to stamp. The Flow
-is named `metrics.cleanup` — same as the Clock:
-
-```typescript title="src/flows/cleanup.ts"
-import { on, flow, clock } from "okengine";
-
-export const cleanupMetrics = on(
-  clock.every("metrics.cleanup", "1h"),
-  flow({
-    plane: "operator",
-    do: async (_, fx) => {
-      await fx.call(sweepMetrics);
-    },
-  }),
-);
-```
-
-</Tab>
-
-<Tab value="Explicit">
-
-The Clock stays `metrics.cleanup`. The Flow is `ops.sweep` — that is the
-Manifest / `fx.call` name:
-
-```typescript title="src/flows/sweep.ts"
-import { on, flow, clock } from "okengine";
+import { tickClock } from "@/clocks/metrics";
 
 export const sweep = on(
-  clock.every("metrics.cleanup", "1h"),
+  tickClock,
   flow("ops.sweep", {
     plane: "operator",
     do: async (_, fx) => {
@@ -190,24 +135,13 @@ export const sweep = on(
     },
   }),
 );
-```
-
-</Tab>
-
-<Tab value="Tree">
-
-Unit folder + `export const` stamps `unit.export`. The Flow is `ops.sweep`, not
-the Clock name `cleanup`:
 
-```typescript title="src/flows/ops/sweep.ts"
-import { on, flow, clock } from "okengine";
-
-export const sweep = on(
-  clock.every("cleanup", "10m"),
-  flow({
+export const report = on(
+  tickClock,
+  flow("ops.report", {
     plane: "operator",
     do: async (_, fx) => {
-      await fx.call(sweepMetrics);
+      await fx.call(reportMetrics);
     },
   }),
 );
@@ -227,12 +161,17 @@ Same `clock` + `fx.clock` from a calendar cron to an interval, a durable pause,
 
 Five-field cron plus helpers. Prefer an app-wide zone so schedules stay short:
 
-```typescript title="src/flows/reports/daily.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/reports.ts"
+import { clock } from "okengine";
 
 export const dailyReportClock = clock.daily("reports.daily", {
   at: "06:00",
 });
+```
+
+```typescript title="src/flows/reports/daily.ts"
+import { on, flow } from "okengine";
+import { dailyReportClock } from "@/clocks/reports";
 
 export const runDailyReport = on(
   dailyReportClock,
@@ -255,10 +194,15 @@ see [Schedules](/docs/elements/clock/schedules).
 
 Human durations — integer + unit, no weeks: `"200ms"` · `"30s"` · `"5m"` · `"1h"` · `"7d"`:
 
-```typescript title="src/flows/health/ping.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/health.ts"
+import { clock } from "okengine";
 
 export const pingClock = clock.every("health.pingExternal", "30s");
+```
+
+```typescript title="src/flows/health/ping.ts"
+import { on, flow } from "okengine";
+import { pingClock } from "@/clocks/health";
 
 export const pingExternal = on(
   pingClock,
@@ -414,9 +358,14 @@ export default defineConfig({
 </Accordion>
 
 <Accordion title="OKE1070 — flow name defined twice">
-  Cause: `Flow "{flow}" is defined twice.` Two nameless consumers inherited the same Clock name, or
-  two explicit `flow("…")` calls collide. Give at least one a distinct `flow("…")` or tree export —
-  [Flow name](#flow-name).
+  Cause: `Flow "{flow}" is defined twice.` Two `flow("…")` strings collide. Give at least one a
+  distinct name. Clock allows several consumers on one schedule — each needs its own name.
+</Accordion>
+
+<Accordion title="OKE1072 — Clock flow unnamed">
+  Cause: `A clock flow on "{trigger}" has no name.`
+  Fix: pass an explicit name — `on(clockDecl, flow("notes.digest", { do }))`.
+  Inline `clock.every` still needs `flow("…")` — [Inline or named export](#inline-or-named-export).
 </Accordion>
 
 </Accordions>
@@ -428,8 +377,7 @@ export default defineConfig({
 - [Consumers · Clock Jobs](/docs/elements/flow/consumers#clock-jobs) — bind with `on(clockDecl, flow)`
 - [Workflows](/docs/elements/flow/workflows) — `durable: true` + `fx.step` around sleeps
 - [fx](/docs/reference/fx) — full `fx.clock` table
-- [Routing](/docs/elements/flow/routing#names) — tree `unit.export` vs inherit
-- [Errors](/docs/reference/errors) — `ScheduleNotOverridableError` · `ClockResourceNotFoundError` · OKE1070
+- [Errors](/docs/reference/errors) — `ScheduleNotOverridableError` · `ClockResourceNotFoundError` · OKE1070 · OKE1072
 
 ## Next
 

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

@@ -25,10 +25,15 @@ For developers running daily digests, health pings, and per-tenant billing loops
 <Step>
 ### Declare a schedule and bind a Flow
 
-```typescript title="src/flows/reports/daily.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/reports.ts"
+import { clock } from "okengine";
 
 export const dailyReportClock = clock.daily("reports.daily", { at: "06:00" });
+```
+
+```typescript title="src/flows/reports/daily.ts"
+import { on, flow } from "okengine";
+import { dailyReportClock } from "@/clocks/reports";
 
 export const runDailyReport = on(
   dailyReportClock,
@@ -112,10 +117,15 @@ chosen programmatically: `clock("x", { cron: "0 6 * * *" })`, Bun nicknames
 
 Fixed duration loops — `"200ms"` · `"30s"` · `"5m"` · `"1h"` · `"7d"`:
 
-```typescript title="src/flows/health/ping.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/health.ts"
+import { clock } from "okengine";
 
 export const pingClock = clock.every("health.pingExternal", "30s");
+```
+
+```typescript title="src/flows/health/ping.ts"
+import { on, flow } from "okengine";
+import { pingClock } from "@/clocks/health";
 
 export const pingExternal = on(
   pingClock,
@@ -146,9 +156,14 @@ Unknown duration strings parse as `0` ms and never become due. A `"d"` is exactl
 template name is never ticked:
 
 ```typescript title="src/clocks/invoices.ts"
-import { on, flow, clock } from "okengine";
+import { clock } from "okengine";
 
 export const invoicesClock = clock.perTenant("invoices", { every: "1h" });
+```
+
+```typescript title="src/flows/billing/invoices.ts"
+import { on, flow } from "okengine";
+import { invoicesClock } from "@/clocks/invoices";
 
 export const runInvoices = on(
   invoicesClock,
@@ -275,16 +290,22 @@ do not consult the zone for tick spacing; the zone still lands on the Store row.
 
 ## Binding & Input
 
-Bind the returned handle with `on(clockDecl, flow)`. The scheduler invokes `do` with **no
-payload** — destructure `_` and read time through `fx.clock`:
+Bind with `on(clockDecl, flow("name", { do }))`. One Flow can write `clock.every`
+inside `on()` — [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export).
+`do` has no payload; read time through `fx.clock`:
+
+```typescript title="src/clocks/metrics.ts"
+import { clock } from "okengine";
+
+export const cleanupClock = clock.every("metrics.cleanup", "1h");
+```
 
 ```typescript title="src/flows/metrics/cleanup.ts"
-import { on, flow, clock } from "okengine";
+import { on, flow } from "okengine";
 import { lt } from "drizzle-orm";
+import { cleanupClock } from "@/clocks/metrics";
 import { db, metricLogs } from "@/schema";
 
-export const cleanupClock = clock.every("metrics.cleanup", "1h");
-
 export const cleanup = on(
   cleanupClock,
   flow("metrics.cleanup", {
@@ -470,6 +491,12 @@ forms; on overlap days crontab fires **once** (first occurrence).
   that is not in the reconciled Store — check spelling against your `clock()` declarations.
 </Accordion>
 
+<Accordion title="OKE1072 — Clock flow unnamed">
+  Cause: `A clock flow on "{trigger}" has no name.`
+  Fix: pass an explicit name — `on(clockDecl, flow("reports.runDaily", { do }))`.
+  Inline `clock.every` still needs `flow("…")` — [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export).
+</Accordion>
+
 <Accordion title="DST gap / overlap warning on the row">
   Informational. Pick a UTC cron, a non-ambiguous local hour, or accept the warning. The job still
   schedules.
@@ -485,10 +512,11 @@ forms; on overlap days crontab fires **once** (first occurrence).
 ## Learn more
 
 - [Clock overview](/docs/elements/clock) — `fx.clock` helpers and drivers
+- [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export) — one Flow vs shared schedule
 - [Durable Sleep](/docs/elements/clock/sleep) — `fx.clock.sleep(label, duration)`
 - [Consumers · Clock Jobs](/docs/elements/flow/consumers#clock-jobs) — bind with `on(clockDecl, flow)`
 - [fx](/docs/reference/fx) — `fx.clock.now` / `ago` / `fromNow` / `duration`
-- [Errors](/docs/reference/errors) — `ScheduleNotOverridableError` · `ClockResourceNotFoundError`
+- [Errors](/docs/reference/errors) — `ScheduleNotOverridableError` · `ClockResourceNotFoundError` · OKE1072
 
 ## Next
 

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

@@ -96,15 +96,21 @@ export const processEmail = on(
 
 <Tab value="Clock">
 
-Name the schedule, then bind it. Omit `timezone` for `"UTC"`:
+Name the schedule, then bind it. One Flow can write `clock.every` inside `on()` —
+[Clock · Inline or named export](/docs/elements/clock#inline-or-named-export).
+
+```typescript title="src/clocks/metrics.ts"
+import { clock } from "okengine";
+
+export const cleanupClock = clock.every("metrics.cleanup", "1h");
+```
 
 ```typescript title="src/flows/metrics/cleanup.ts"
-import { on, flow, clock } from "okengine";
+import { on, flow } from "okengine";
 import { lt } from "drizzle-orm";
+import { cleanupClock } from "@/clocks/metrics";
 import { db, metricLogs } from "@/schema";
 
-export const cleanupClock = clock.every("metrics.cleanup", "1h");
-
 export const cleanupMetrics = on(
   cleanupClock,
   flow("metrics.cleanup", {
@@ -180,19 +186,19 @@ Omit `key` for competing consumers with no ordering.
 
 ## Trigger Reference
 
-| Trigger    | Signature                                           | Purpose                                     | `do` input                             |
-| ---------- | --------------------------------------------------- | ------------------------------------------- | -------------------------------------- |
-| Signal     | `on(signalHandle, flow)` or inline `signal.once(…)` | Queue (`once`) or fan-out (`broadcast`)     | Payload (`schema`)                     |
-| Clock      | `on(clockDecl, flow)` or inline `clock.every(…)`    | Interval or cron tick                       | none (`_`)                             |
-| CDC any    | `on(db.table(t).changed(), flow)`                   | Every insert / update / delete              | `{ before, after, table, action, id }` |
-| CDC column | `on(db.table(t).changed("col"), flow)`              | Same writes; column stamped on the Manifest | `{ before, after, table, action, id }` |
+| Trigger    | Signature                                                        | Purpose                                     | `do` input                             |
+| ---------- | ---------------------------------------------------------------- | ------------------------------------------- | -------------------------------------- |
+| Signal     | `on(handle, flow("name", { do }))`                               | Queue (`once`) or fan-out (`broadcast`)     | Payload (`schema`)                     |
+| Clock      | `on(clockDecl, flow("name", { do }))` or inline `clock.every(…)` | Interval or cron tick                       | none (`_`)                             |
+| CDC any    | `on(db.table(t).changed(), flow)`                                | Every insert / update / delete              | `{ before, after, table, action, id }` |
+| CDC column | `on(db.table(t).changed("col"), flow)`                           | Same writes; column stamped on the Manifest | `{ before, after, table, action, id }` |
 
 `signal.live` is an HTTP SSE tape — bind it with [`http.live`](/docs/elements/flow/http#live-streams),
 not as a worker. A Flow with no trigger is [call-only](/docs/elements/flow).
 
-One-file inline vs exported handle: [Signal](/docs/elements/signal#inline-or-named-export) ·
-[Clock](/docs/elements/clock#inline-or-named-export). Flow name (inherit / explicit / tree):
-[Signal](/docs/elements/signal#flow-name) · [Clock](/docs/elements/clock#flow-name). Collision is **OKE1070**.
+Signal is always an exported const (`fx.emit` needs the handle). Clock may write
+`clock.every(…)` inside `on()` — [Clock · Inline or named
+export](/docs/elements/clock#inline-or-named-export). **OKE1072** if nameless.
 
 ## Signal Consumers
 
@@ -336,10 +342,9 @@ Broadcast does not use the `once` lease / DLQ path. Live uses the retained tape,
 </Accordion>
 
 <Accordion title="Schema at emit">
-  Invalid payloads fail at `fx.emit` with **OKE1250** (`"{resource}": {detail}`) before any
-  consumer runs. Fix the payload or the Signal's `schema`. This is an **emit** contract — not
-  an HTTP invoke contract on `flow()`. Workers inherit the typed payload from the Signal
-  declaration; they do not declare `in` on `flow({ do })`.
+  Invalid payloads fail at `fx.emit` with **OKE1250** (`"{resource}": {detail}`) before any consumer
+  runs. This is an **emit** contract — workers inherit the payload from the Signal; they do not
+  declare `in` on `flow()`.
 </Accordion>
 
 </Accordions>
@@ -347,11 +352,9 @@ Broadcast does not use the `once` lease / DLQ path. Live uses the retained tape,
 ## Clock Jobs
 
 <Callout title="Detailed section">
-  Prefer `clock.every` / `clock.daily` / `clock.cron` (and the other named helpers) for fixed
-  schedules — they compile to the same decl as the bare callable. The lower-level bare `clock(name,
-  options)` form still works when you need a raw expression or a schedule chosen programmatically;
-  missing both `cron` and `every` throws `clock("name"): require cron or every`. Bind the returned
-  handle with `on(clockDecl, flow)`.
+  Prefer named helpers (`clock.every` / `daily` / `cron`). Bind with
+  `on(clockDecl, flow("name", { do }))`, or write `clock.every` inside `on()` —
+  [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export).
 </Callout>
 
 Named clocks reconcile into the Store at boot. The scheduler leader-elects so N instances do not
@@ -363,10 +366,15 @@ double-fire. `do` receives no payload — read time through `fx.clock`.
 
 Human durations: `"200ms"` · `"30s"` · `"5m"` · `"1h"` · `"7d"` (integer + unit, no weeks):
 
-```typescript title="src/flows/health/ping.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/health.ts"
+import { clock } from "okengine";
 
 export const pingClock = clock.every("health.pingExternal", "30s");
+```
+
+```typescript title="src/flows/health/ping.ts"
+import { on, flow } from "okengine";
+import { pingClock } from "@/clocks/health";
 
 export const pingExternal = on(
   pingClock,
@@ -385,13 +393,18 @@ export const pingExternal = on(
 
 Five-field cron (`m h dom mon dow`) plus an IANA `timezone` (default `"UTC"`):
 
-```typescript title="src/flows/reports/daily.ts"
-import { on, flow, clock } from "okengine";
+```typescript title="src/clocks/reports.ts"
+import { clock } from "okengine";
 
 export const dailyReportClock = clock.daily("reports.daily", {
   at: "06:00",
   timezone: "Asia/Riyadh",
 });
+```
+
+```typescript title="src/flows/reports/daily.ts"
+import { on, flow } from "okengine";
+import { dailyReportClock } from "@/clocks/reports";
 
 export const runDailyReport = on(
   dailyReportClock,
@@ -415,9 +428,14 @@ trigger when both are present.
 is never ticked:
 
 ```typescript title="src/clocks/invoices.ts"
-import { on, flow, clock } from "okengine";
+import { clock } from "okengine";
 
 export const invoicesClock = clock.perTenant("invoices", { every: "1h" });
+```
+
+```typescript title="src/flows/billing/invoices.ts"
+import { on, flow } from "okengine";
+import { invoicesClock } from "@/clocks/invoices";
 
 export const runInvoices = on(
   invoicesClock,
@@ -674,9 +692,13 @@ Clock drivers: **postgres** in `dev`/`prod`, **frozen** in `test`. Signal driver
 </Accordion>
 
 <Accordion title="OKE1070 — flow name defined twice">
-  Cause: `Flow "{flow}" is defined twice.` Two nameless `flow({ do })` bindings inherited the same
-  Signal or Clock name, or two explicit `flow("…")` calls share a name. Give at least one an
-  explicit `flow("…")` or a distinct tree export.
+  Cause: `Flow "{flow}" is defined twice.` Two `flow("…")` strings share a name. Give at least one a
+  distinct name.
+</Accordion>
+
+<Accordion title="OKE1072 — Signal or Clock flow unnamed">
+  Cause: `A {kind} flow on "{trigger}" has no name.`
+  Fix: pass an explicit name — `on(handle, flow("unit.export", { do }))`.
 </Accordion>
 
 <Accordion title="OKE1071 — once signal bound to more than one Flow">
@@ -733,10 +755,11 @@ Clock drivers: **postgres** in `dev`/`prod`, **frozen** in `test`. Signal driver
 - [Signal](/docs/elements/signal) — `once` / `broadcast` / `live` physics
 - [Signal · Once](/docs/elements/signal/once) — leases, retries, partition keys
 - [Clock](/docs/elements/clock) — schedules, `fx.clock.sleep`
+- [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export) — one Flow vs shared schedule
 - [Store · SQL](/docs/elements/store/sql) — tables CDC watches
 - [HTTP · Live Streams](/docs/elements/flow/http#live-streams) — `signal.live` SSE
 - [fx](/docs/reference/fx) — `fx.emit`, `fx.deadLetters`, `fx.clock`
-- [Errors](/docs/reference/errors) — OKE1070 · OKE1071 · OKE1240 · OKE1250
+- [Errors](/docs/reference/errors) — OKE1070 · OKE1071 · OKE1072 · OKE1240 · OKE1250
 - [Workflows](/docs/elements/flow/workflows) — `durable: true` + `fx.step` on a consumer
 
 ## Next

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

@@ -344,9 +344,9 @@ A bare `404` with body `Not Found` means **no route matched** — not `fx.fail("
 </Accordion>
 
 <Accordion title="Name stamping">
-  Prefer nameless `flow({ do })` on tree files — the file stamps `unit.export`.
-  Signal / Clock inherit the trigger name only outside a unit folder
-  ([Signal · Flow name](/docs/elements/signal#flow-name)). Nameless HTTP after adopt fails **OKE1045**.
+  Prefer nameless `flow({ do })` on HTTP tree files — `src/flows/notes/[id]/get.ts` +
+  `export const get` stamps `notes.get`. Signal / Clock workers pass `flow("name", { do })`
+  (**OKE1072**; Clock inline is [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export)).
 </Accordion>
 
 </Accordions>
@@ -570,12 +570,9 @@ Default is `true` once `gate.auth.tenant` is on.
 </Accordion>
 
 <Accordion title="OKE1020 — no declared effects">
-  Cause: `Flow "{flow}" has no declared effects and no Manifest to derive them from.` Boot with `oke
-  build` / `oke dev` so extract can infer. Framework / plugin Flows outside the app tree get an
-  empty least-privilege stamp automatically when a Manifest is present — do not hand-write `effects:{" "}
-  {}`. Real `fx` usage still needs inference (app source) or an explicit non-empty `effects` block
-  when extract cannot see the body. If extract failed (`Manifest extract failed`), install
-  `oxc-parser` and retry.
+  Cause: `Flow "{flow}" has no declared effects and no Manifest to derive them from.` Extract
+  failures append `Manifest extract failed — …`. Boot with `oke dev` / `oke build`; install
+  `oxc-parser` if extract cannot load. On Windows use `bun run dev` / `bunx oke dev`.
 </Accordion>
 
 </Accordions>

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

@@ -455,18 +455,9 @@ prefix). Wrong-unit prefixes fail generate.
 Non-HTTP files still join the unit. A signal consumer in `notes/on-created.ts`
 is `api.notes.onCreated` over RPC (`POST /_oke/notes/onCreated`), not HTTP.
 
-Nameless Signal / Clock consumers take the trigger name only when the tree does
-not stamp `unit.export`:
-
-| Style                           | Flow name               |
-| ------------------------------- | ----------------------- |
-| `flow({ do })` (no unit folder) | the Signal / Clock name |
-| `flow("orders.fulfill")`        | the string you passed   |
-| `src/flows/notes/on-created.ts` | `notes.onCreated`       |
-
-Worked examples: [Signal · Flow name](/docs/elements/signal#flow-name) ·
-[Clock · Flow name](/docs/elements/clock#flow-name). Collision fails **OKE1070**.
-HTTP has no trigger name of this kind — nameless HTTP stays for the tree or **OKE1045**.
+Signal / Clock consumers pass an explicit `flow("…")` name (**OKE1072** if nameless
+outside `src/flows/<unit>/`; **OKE1070** on collision). Clock may write `clock.every(…)`
+inside `on()` — [Clock · Inline or named export](/docs/elements/clock#inline-or-named-export).
 
 ## Runtime Matching
 
@@ -524,8 +515,13 @@ plus a handwritten `http.get("/notes")`.
 </Accordion>
 
 <Accordion title="OKE1070 — flow name defined twice">
-  Cause: `Flow "{flow}" is defined twice.` Two nameless Signal/Clock consumers inherited the same
-  name, or two explicit `flow("…")` calls collide. Give at least one a distinct name or tree export.
+  Cause: `Flow "{flow}" is defined twice.` Two explicit `flow("…")` calls collide, or two tree
+  exports stamp the same `unit.export`. Give at least one a distinct name or tree export.
+</Accordion>
+
+<Accordion title="OKE1072 — Signal or Clock flow unnamed">
+  Cause: `A {kind} flow on "{trigger}" has no name.`
+  Fix: pass an explicit name — `on(handle, flow("unit.export", { do }))`.
 </Accordion>
 
 <Accordion title="422 — path param missing from in">
@@ -550,7 +546,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 · OKE1070
+- [Errors](/docs/reference/errors) — OKE1040 · OKE1030 · OKE1041 · OKE1045 · OKE1070 · OKE1072
 - [The Architecture](/docs/understand/the-architecture) — derived routes, no hand-written table
 - [Gate](/docs/elements/gate) — `.gate(...)` / `.public()` on the same trigger
 

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

@@ -466,6 +466,11 @@ dead-letter queue for exhausted retries in the queue sense — see
   Cause: `"{resource}": {detail}`. Align the payload with `schema` — no subscriber started.
 </Accordion>
 
+<Accordion title="OKE1072 — Signal flow unnamed">
+  Cause: `A signal flow on "{trigger}" has no name.`
+  Fix: pass an explicit name — `on(handle, flow("cache.purgeLocal", { do }))`.
+</Accordion>
+
 <Accordion title="Expecting retries / DLQ like a queue">
   Use `signal.once`. Broadcast fan-out is not the lease + DLQ path documented under
   [Once](/docs/elements/signal/once).
@@ -492,7 +497,7 @@ dead-letter queue for exhausted retries in the queue sense — see
 - [Consumers](/docs/elements/flow/consumers) — binding `on(signal)`
 - [HTTP · Live Streams](/docs/elements/flow/http#live-streams) — when the consumer is a browser
 - [fx](/docs/reference/fx) — `fx.emit`
-- [Errors](/docs/reference/errors) — OKE1240 · OKE1250
+- [Errors](/docs/reference/errors) — OKE1072 · OKE1240 · OKE1250
 
 ## Next