@nanobpm/urban 0.77.1 → 0.77.2

package/dist/toolkit/derivers/api.js

@@ -17,6 +17,48 @@ export const API_BINDINGS_TS = "operations.ts";
  *  `tsc` (ADR 0059). The runtime dispatches through this map instead of per-op path imports. */
 export const API_CONTROLLER_TS = "controller.ts";
 export { DEFAULT_OPERATIONS_DIR };
+/** Order two import source specifiers the way Biome's `organizeImports` assist does, so the
+ *  controller emits its delegate imports in Biome's canonical order and the generated file passes
+ *  `biome check` without a post-generation import sort. Biome's collation is, per character:
+ *  digit-runs compared numerically (`item2` before `item10`), letters compared case-insensitively
+ *  as the primary key, and — when two characters are the same letter differing only in case — the
+ *  uppercase one sorts first as an immediate tiebreak (`getAgentInstructions` before
+ *  `getAgenticRegistry` before `getAgentSkill`). */
+function naturalCompare(a, b) {
+    const tokens = (s) => s.match(/\d+|\D/g) ?? [];
+    const isDigitRun = (t) => t.charCodeAt(0) >= 48 && t.charCodeAt(0) <= 57;
+    const ax = tokens(a);
+    const bx = tokens(b);
+    const n = Math.min(ax.length, bx.length);
+    for (let i = 0; i < n; i++) {
+        const ca = ax[i];
+        const cb = bx[i];
+        if (ca === undefined || cb === undefined)
+            break;
+        if (isDigitRun(ca) && isDigitRun(cb)) {
+            // Compare digit runs by numeric value *without* floating-point loss: strip leading zeros,
+            // then a longer run is the larger number, else compare the equal-length digits lexically.
+            // (`Number(ca) - Number(cb)` collapses 17+-digit runs to the same IEEE-754 value and yields
+            //  `NaN` beyond `Number.MAX_SAFE_INTEGER`, both of which break the total order `sort` needs.)
+            const na = ca.replace(/^0+/, "");
+            const nb = cb.replace(/^0+/, "");
+            if (na.length !== nb.length)
+                return na.length < nb.length ? -1 : 1;
+            if (na !== nb)
+                return na < nb ? -1 : 1;
+            if (ca !== cb)
+                return ca < cb ? -1 : 1; // equal value, differing leading zeros
+        }
+        else if (ca !== cb) {
+            const la = ca.toLowerCase();
+            const lb = cb.toLowerCase();
+            if (la !== lb)
+                return la < lb ? -1 : 1; // case-insensitive primary key
+            return ca < cb ? -1 : 1; // same letter, different case → uppercase (lower code point) first
+        }
+    }
+    return ax.length - bx.length;
+}
 /** A TS identifier form of an operationId (used for the per-op type names). */
 function typeStem(operationId) {
     const cleaned = operationId.replace(/[^A-Za-z0-9]+/g, " ").trim();
@@ -139,7 +181,7 @@ function objectToTs(schema, depth) {
 function paramsTs(op, where, ejected) {
     const ps = op.parameters.filter((p) => p.in === where);
     if (ps.length === 0)
-        return "{}";
+        return "Record<string, never>";
     const rawWire = where === "query" ? "string | string[]" : "string";
     const fields = ps.map((p) => {
         // Coerced to the schema type (number/boolean/array/enum/…); optionality is carried by the `?`
@@ -188,8 +230,7 @@ export function emitApiBindings(doc, surfaceEject = false) {
         "// The endpoint type map: each operationId maps to its typed request (coerced path/query params\n" +
         "// + JSON body) and response (a union of every documented JSON response body), derived from the\n" +
         "// spec. Do not edit — regenerated from\n" +
-        "// the spec; erased to plain JS at compile.\n" +
-        "// eslint-disable\n\n";
+        "// the spec; erased to plain JS at compile.\n\n";
     const componentDecls = Object.entries(components)
         .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
         .map(([name, schema]) => `export type ${typeStem(name)} = ${schemaToTs(schema)};`)
@@ -242,13 +283,19 @@ export function emitApiBindings(doc, surfaceEject = false) {
         return `  ${JSON.stringify(op.operationId)}: { request: ${stem}Request; response: ${stem}Response };`;
     })
         .join("\n");
+    // With generated `.ts` now linted in the scaffold, an empty operation set must NOT emit an empty
+    // `interface ApiOperations {}` (`suspicious/noEmptyInterface`); fall back to the same non-empty-safe
+    // `Record<never, never>` used elsewhere (its `keyof` is `never`, matching `ApiOperationId = never`).
+    const apiOperations = ops.length > 0
+        ? `export interface ApiOperations {\n${mapEntries}\n}\n`
+        : `export type ApiOperations = Record<never, never>;\n`;
     return (header +
         (componentDecls ? `${componentDecls}\n\n` : "") +
         (opDecls ? `${opDecls}\n\n` : "") +
         `/** Every declared operationId (ADR 0058): the delegate key set. */\n` +
         `export type ApiOperationId = ${idUnion};\n\n` +
         `/** Request/response contract per operationId. */\n` +
-        `export interface ApiOperations {\n${mapEntries}\n}\n`);
+        apiOperations);
 }
 /** Emit `operations.ts`: the typed `defineOperation` wrapper, keyed by operationId (mirrors the
  *  generated typed `defineWorker`). Written verbatim (it never changes with the spec) — it only
@@ -257,10 +304,9 @@ export function emitApiBindingsRuntime() {
     return ("// AUTO-GENERATED by @nanobpm/urban (ADR 0058): the typed `defineOperation`.\n" +
         "// Re-exports the operation SDK and overrides `defineOperation` with an operationId-keyed\n" +
         "// signature (the delegate's validated request + result typed from the spec). Erased to a\n" +
-        "// pass-through at runtime. Do not edit.\n" +
-        "// eslint-disable\n\n" +
-        `import { defineOperation as defineOperationRaw } from "@nanobpm/urban";\n` +
+        "// pass-through at runtime. Do not edit.\n\n" +
         `import type { OperationHandler } from "@nanobpm/urban";\n` +
+        `import { defineOperation as defineOperationRaw } from "@nanobpm/urban";\n` +
         `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n\n` +
         `type ReqFor<K extends ApiOperationId> = ApiOperations[K]["request"];\n` +
         `type ResFor<K extends ApiOperationId> = ApiOperations[K]["response"];\n\n` +
@@ -303,17 +349,22 @@ export function emitApiController(doc, operationsDir = DEFAULT_OPERATIONS_DIR) {
         "// registry. Statically imports every operation delegate and asserts the complete, correctly-\n" +
         "// typed set via `satisfies` — a missing, mismatched, or orphan delegate fails `tsc`. The\n" +
         "// runtime dispatches through this map, so endpoints cannot drift from the spec. Do not edit —\n" +
-        "// regenerated from the spec.\n" +
-        "// eslint-disable\n\n";
-    const typeImports = `import type { OperationHandler } from "@nanobpm/urban";\n` +
-        `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n`;
+        "// regenerated from the spec.\n\n";
+    // Emit imports in Biome's canonical `organizeImports` order so the generated file is lint-clean
+    // without a post-gen fixup: the bare package import first, then the delegate imports sorted by
+    // source specifier (Biome's natural, numeric-aware collation), then the relative `./api-io.d.ts`
+    // type import last. Alias bindings (`op<i>`) stay tied to the original index so the `operations`
+    // map below still resolves each operationId to its delegate regardless of import line order.
     const delegateImports = ops
-        .map((op, i) => `import op${i} from ${JSON.stringify(`../${dir}/${op.operationId}.ts`)};`)
+        .map((op, i) => ({ i, spec: `../${dir}/${op.operationId}.ts` }))
+        .sort((a, b) => naturalCompare(a.spec, b.spec))
+        .map(({ i, spec }) => `import op${i} from ${JSON.stringify(spec)};`)
         .join("\n");
     const mapEntries = ops.map((op, i) => `  ${JSON.stringify(op.operationId)}: op${i},`).join("\n");
     return (header +
-        typeImports +
+        `import type { OperationHandler } from "@nanobpm/urban";\n` +
         (delegateImports ? `${delegateImports}\n` : "") +
+        `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n` +
         `\n` +
         `type ReqFor<K extends ApiOperationId> = ApiOperations[K]["request"];\n` +
         `type ResFor<K extends ApiOperationId> = ApiOperations[K]["response"];\n\n` +

package/dist/toolkit/derivers/domain.js

@@ -83,10 +83,9 @@ function tableInterface(t) {
  */
 export function emitDomainDts(tables) {
     const header = "// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\n" +
-        "// Do not edit — regenerated from the live tables. Erased at `deno compile`.\n" +
-        "// eslint-disable\n";
+        "// Do not edit — regenerated from the live tables. Erased at `deno compile`.\n";
     if (tables.length === 0) {
-        return `${header}\nexport interface DomainTables {}\n`;
+        return `${header}\nexport type DomainTables = Record<never, never>;\n`;
     }
     const interfaces = tables.map(tableInterface).join("\n\n");
     const map = tables
@@ -113,15 +112,14 @@ export function emitDomainDtsForSources(sources, defaultSource) {
         return emitDomainDts(sources[0]?.tables ?? []);
     }
     const header = "// AUTO-GENERATED by nanobpmn from the datasource schemas (ADR 0029 §4.1/§6).\n" +
-        "// Do not edit — regenerated from the live tables. Erased at `deno compile`.\n" +
-        "// eslint-disable\n";
+        "// Do not edit — regenerated from the live tables. Erased at `deno compile`.\n";
     const interfaces = sources
         .flatMap((s) => s.tables.map((t) => tableInterfaceNamed(prefixedInterfaceName(s.source, t.name), t)))
         .join("\n\n");
     const sourceMap = sources
         .map((s) => {
         if (s.tables.length === 0)
-            return `  ${JSON.stringify(s.source)}: {};`;
+            return `  ${JSON.stringify(s.source)}: Record<never, never>;`;
         const tableMap = s.tables
             .map((t) => `    ${JSON.stringify(t.name)}: ${prefixedInterfaceName(s.source, t.name)};`)
             .join("\n");
@@ -181,7 +179,7 @@ export function emitDomainTypeRegistry(types) {
             return `    ${key}${opt}: ${fieldTsType(field, ids)};`;
         })
             .join("\n");
-        const body = fields.length > 0 ? `{\n${fields}\n  }` : "{}";
+        const body = fields.length > 0 ? `{\n${fields}\n  }` : "Record<never, never>";
         return `  ${JSON.stringify(id)}: ${body};`;
     })
         .join("\n");
@@ -233,8 +231,7 @@ export function emitDomainBindings(sources, defaultSource) {
     const header = "// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1/§6).\n" +
         "// The typed data-object layer: `openDomain()` → one `Table<T>` per table, so\n" +
         "// workers manipulate typed rows instead of hand-writing SQL. Do not edit —\n" +
-        "// regenerated from the live tables. Erased to plain JS at `deno compile`.\n" +
-        "// eslint-disable\n";
+        "// regenerated from the live tables. Erased to plain JS at `deno compile`.\n";
     const multi = sources.length > 1;
     const def = defaultSource && sources.some((s) => s.source === defaultSource)
         ? defaultSource
@@ -279,7 +276,7 @@ export function emitDomainBindings(sources, defaultSource) {
         (binds ? `${binds}\n` : "") +
         `    close: () => raw.close(),\n  };\n}`;
     return `${header}\n` +
-        `import { openDataSource, type DataSource, type Table } from "./data-sdk.ts";\n` +
+        `import { type DataSource, openDataSource, type Table } from "./data-sdk.ts";\n` +
         importTypes +
         `\n${domainIface}\n\n${openFn}\n\nexport type { Table };\n`;
 }
@@ -323,13 +320,14 @@ function emitKeyedDomainBindings(header, sources, def) {
         `export async function openDomain<K extends DomainSource = ${JSON.stringify(def)}>(\n` +
         `  source?: K,\n` +
         `): Promise<Domain<DomainSources[K]>> {\n` +
-        `  const key = (source ?? DEFAULT_SOURCE) as string;\n` +
+        `  const key = source ?? DEFAULT_SOURCE;\n` +
         `  const raw = await openDataSource(key);\n` +
         `  const db: Record<string, unknown> = { raw, close: () => raw.close() };\n` +
         `  for (const t of DOMAIN_TABLES[key] ?? []) db[t.name] = raw.table(t.name, t.pk);\n` +
+        `  // biome-ignore lint/plugin: the per-source table set is bound dynamically from DOMAIN_TABLES; the Domain<M> shape can't be expressed statically over the runtime loop.\n` +
         `  return db as Domain<DomainSources[K]>;\n}`;
     return `${header}\n` +
-        `import { openDataSource, type DataSource, type Table } from "./data-sdk.ts";\n` +
+        `import { type DataSource, openDataSource, type Table } from "./data-sdk.ts";\n` +
         `import type { DomainSources } from "./${DOMAIN_DTS}";\n\n` +
         `${runtimeMap}\n\n${types}\n\n${openFn}\n\nexport type { Table };\n`;
 }

package/dist/toolkit/derivers/messages.js

@@ -79,15 +79,14 @@ export function emitMessageBindings(messages, declaredTypeIds) {
         "// The bridge from a `bpmn:message`'s data envelope to the message type system:\n" +
         "// each named message maps to the TS type of its payload, so the typed\n" +
         "// `publishMessage` types a call by its message name. Do not edit — regenerated\n" +
-        "// from the model. Erased to plain JS at compile.\n" +
-        "// eslint-disable\n";
+        "// from the model. Erased to plain JS at compile.\n";
     const needsRegistry = payloads.length > 0;
     const importTypes = needsRegistry
         ? `import type { DomainTypes } from "./${DOMAIN_DTS}";\n`
         : "";
     const payloadsIface = payloads.length > 0
         ? `export interface MessagePayloads {\n${payloads.join("\n")}\n}\n`
-        : `export interface MessagePayloads {}\n`;
+        : `export type MessagePayloads = Record<never, never>;\n`;
     return `${header}\n` +
         importTypes +
         `\n/** Untyped fallback payload for a message that declares no envelope type. */\n` +
@@ -149,11 +148,10 @@ export function emitMessageBindingsRuntime() {
     return "// AUTO-GENERATED by nanobpmn (ADR 0040 slice 2): the typed `publishMessage`.\n" +
         "// Re-exports the worker SDK's `publishMessage` and overrides it with a\n" +
         "// messageName-keyed typed signature (variables typed from the message's declared\n" +
-        "// envelope). Erased to a pass-through at runtime. Do not edit.\n" +
-        "// eslint-disable\n\n" +
-        `import { publishMessage as publishMessageRaw } from "./worker-sdk.ts";\n` +
+        "// envelope). Erased to a pass-through at runtime. Do not edit.\n\n" +
+        `import type { MessageName, MessagePayloads, MessageVars } from "./${MESSAGE_BINDINGS_DTS}";\n` +
         `import type { PublishMessageOptions, PublishMessageResult } from "./worker-sdk.ts";\n` +
-        `import type { MessageName, MessagePayloads, MessageVars } from "./${MESSAGE_BINDINGS_DTS}";\n\n` +
+        `import { publishMessage as publishMessageRaw } from "./worker-sdk.ts";\n\n` +
         `export type { PublishMessageOptions, PublishMessageResult } from "./worker-sdk.ts";\n\n` +
         `type PayloadFor<K extends MessageName> = K extends keyof MessagePayloads ? MessagePayloads[K] : MessageVars;\n\n` +
         `/**\n` +
@@ -166,6 +164,7 @@ export function emitMessageBindingsRuntime() {
         `  name: K,\n` +
         `  opts?: PublishMessageOptions<PayloadFor<K> & object>,\n` +
         `): Promise<PublishMessageResult> {\n` +
+        `  // biome-ignore lint/plugin: generic-to-raw erasure at the message-SDK boundary; the wire stays untyped JSON (ADR 0040 slice 2).\n` +
         `  return publishMessageRaw(name, opts as unknown as PublishMessageOptions);\n` +
         `}\n`;
 }

package/dist/toolkit/derivers/meta.js

@@ -67,23 +67,25 @@ export function emitMeta(metas) {
     const header = "// AUTO-GENERATED by nanobpmn from the process model (ADR 0040 §5): the typed\n" +
         "// model-metadata accessor. Each `nano:meta` key/value the models declare becomes\n" +
         "// a checked `AppMeta` property, so `meta(key)` is typed and app-wide queryable\n" +
-        "// without a second store. Do not edit — regenerated from the model.\n" +
-        "// eslint-disable\n\n";
+        "// without a second store. Do not edit — regenerated from the model.\n\n";
     const iface = keys.length > 0
         ? `export interface AppMeta {\n${keys.map((k) => `  ${propKey(k)}: string;`).join("\n")}\n}\n`
-        : `export interface AppMeta {}\n`;
+        : `export type AppMeta = Record<never, never>;\n`;
+    // Dot-access satisfies Biome's `useLiteralKeys`, but `__proto__` must stay a computed key: dot
+    // access would trip `noProto` and (off a null-prototype dict) change semantics.
+    const assignTarget = (k) => isIdent(k) && k !== "__proto__" ? `m.${k}` : `m[${JSON.stringify(k)}]`;
     const constDecl = keys.length > 0
         ? `export const appMeta: AppMeta = (() => {\n` +
-            `  const m: Record<string, string> = Object.create(null);\n` +
-            keys.map((k) => `  m[${JSON.stringify(k)}] = ${JSON.stringify(folded[k])};`).join("\n") +
-            `\n  return m as AppMeta;\n})();\n`
-        : `export const appMeta: AppMeta = Object.create(null) as AppMeta;\n`;
+            `  const m: AppMeta = Object.create(null);\n` +
+            keys.map((k) => `  ${assignTarget(k)} = ${JSON.stringify(folded[k])};`).join("\n") +
+            `\n  return m;\n})();\n`
+        : `export const appMeta: AppMeta = Object.create(null);\n`;
     const accessor = `\n/** Read a model-level metadata value. A declared key is typed; a dynamic key\n` +
         ` * returns \`string | undefined\`. */\n` +
         `export function meta<K extends keyof AppMeta>(key: K): AppMeta[K];\n` +
         `export function meta(key: string): string | undefined;\n` +
         `export function meta(key: string): string | undefined {\n` +
-        `  return (appMeta as Record<string, string>)[key];\n` +
+        `  return Reflect.get(appMeta, key);\n` +
         `}\n`;
     return `${header}/** Every model-level metadata key the App's models declare (ADR 0040 §5). */\n` +
         iface + "\n" + constDecl + accessor;

package/dist/toolkit/derivers/worker-io.js

@@ -143,21 +143,20 @@ export function emitWorkerBindings(workers, declaredTypeIds) {
         "// The bridge from the process model to the worker type system: each declared\n" +
         "// worker's `taskType` maps to the TS type of its input payload (`job.variables`)\n" +
         "// and result, so the typed `defineWorker` types a handler by its job type. Do\n" +
-        "// not edit — regenerated from the manifest. Erased to plain JS at compile.\n" +
-        "// eslint-disable\n";
+        "// not edit — regenerated from the manifest. Erased to plain JS at compile.\n";
     const needsRegistry = inputs.length > 0 || outputs.length > 0;
     const importTypes = needsRegistry
         ? `import type { DomainTypes } from "./${DOMAIN_DTS}";\n`
         : "";
     const inputsIface = inputs.length > 0
         ? `export interface WorkerInputs {\n${inputs.join("\n")}\n}\n`
-        : `export interface WorkerInputs {}\n`;
+        : `export type WorkerInputs = Record<never, never>;\n`;
     const outputsIface = outputs.length > 0
         ? `export interface WorkerOutputs {\n${outputs.join("\n")}\n}\n`
-        : `export interface WorkerOutputs {}\n`;
+        : `export type WorkerOutputs = Record<never, never>;\n`;
     const headersIface = headers.length > 0
         ? `export interface WorkerHeaders {\n${headers.join("\n")}\n}\n`
-        : `export interface WorkerHeaders {}\n`;
+        : `export type WorkerHeaders = Record<never, never>;\n`;
     return `${header}\n` +
         importTypes +
         `\n/** Untyped fallback for a job whose worker declares no input/output type. */\n` +
@@ -315,11 +314,10 @@ export function emitWorkerBindingsRuntime() {
         "// Re-exports the worker SDK and overrides `defineWorker` with a taskType-keyed\n" +
         "// typed signature (job.variables, job.customHeaders + result typed from the\n" +
         "// worker's declared input/output/header contract). Erased to a pass-through at\n" +
-        "// runtime. Do not edit.\n" +
-        "// eslint-disable\n\n" +
-        `import { defineWorker as defineWorkerRaw } from "./worker-sdk.ts";\n` +
+        "// runtime. Do not edit.\n\n" +
+        `import type { WorkerHdrs, WorkerHeaders, WorkerInputs, WorkerOutputs, WorkerTaskType, WorkerVars } from "./${WORKER_BINDINGS_DTS}";\n` +
         `import type { WorkerOptions } from "./worker-sdk.ts";\n` +
-        `import type { WorkerInputs, WorkerOutputs, WorkerHeaders, WorkerTaskType, WorkerVars, WorkerHdrs } from "./${WORKER_BINDINGS_DTS}";\n\n` +
+        `import { defineWorker as defineWorkerRaw } from "./worker-sdk.ts";\n\n` +
         `export * from "./worker-sdk.ts";\n\n` +
         `type InFor<K extends WorkerTaskType> = K extends keyof WorkerInputs ? WorkerInputs[K] : WorkerVars;\n` +
         `type OutFor<K extends WorkerTaskType> = K extends keyof WorkerOutputs ? WorkerOutputs[K] : WorkerVars;\n` +
@@ -334,6 +332,7 @@ export function emitWorkerBindingsRuntime() {
         `export function defineWorker<K extends WorkerTaskType>(\n` +
         `  opts: { type: K } & WorkerOptions<InFor<K> & object, OutFor<K> & object, HdrFor<K> & object>,\n` +
         `): void {\n` +
+        `  // biome-ignore lint/plugin: generic-to-raw erasure at the worker-SDK boundary; the wire stays untyped JSON (ADR 0033 §3).\n` +
         `  defineWorkerRaw(opts as unknown as WorkerOptions);\n` +
         `}\n`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nanobpm/urban",
-	"version": "0.77.1",
+	"version": "0.77.2",
 	"description": "Urban: build and run code-first apps on Nano — runtime, derivation toolkit, and CLI in one. Author durable processes with @nanobpm/workflow (defineFlow), a typed datasource, forms, triggers and surfaces from a nano.app.json manifest, on Node or Deno.",
 	"license": "Apache-2.0",
 	"type": "module",
@@ -103,7 +103,7 @@
 		"@nanobpm/nano-sdk": "^1.2.5",
 		"@nanobpm/workflow": "^0.14.0",
 		"bpmn-auto-layout": "^2.0.0-alpha.2",
-		"create-urban-app": "^0.15.0",
+		"create-urban-app": "^0.15.1",
 		"yaml": "^2.9.0"
 	},
 	"devDependencies": {

package/src/toolkit/derivers/api.test.ts

@@ -108,6 +108,34 @@ test("emitApiController on an empty spec is a valid empty registry (never = {})"
   assert.match(out, /export const operations = \{\s*\} satisfies \{/);
 });
 
+test("emitApiBindings on an empty spec emits the Record<never, never> ApiOperations fallback (not an empty interface)", () => {
+  const empty: OpenApiDoc = { openapi: "3.0.0", paths: {} };
+  const out = emitApiBindings(empty);
+  assert.match(out, /export type ApiOperationId = never;/);
+  // A generated `.ts` file is now linted in the scaffold, where `interface ApiOperations {}` would
+  // trip `suspicious/noEmptyInterface`; the empty spec must degrade to the non-empty-safe alias.
+  assert.match(out, /export type ApiOperations = Record<never, never>;/);
+  assert.doesNotMatch(out, /interface ApiOperations/);
+});
+
+test("emitApiController orders imports by true numeric value for digit runs beyond IEEE-754 precision", () => {
+  // 16- vs 17-digit runs: `Number()` collapses these to the same float (and can yield NaN), so a
+  // float-subtraction sort would treat them as equal and leave order to chance. The 17-digit run is
+  // numerically larger and must sort last regardless.
+  const doc: OpenApiDoc = {
+    openapi: "3.0.0",
+    paths: {
+      "/b": { get: { operationId: "op10000000000000001", responses: { "200": {} } } },
+      "/a": { get: { operationId: "op9999999999999999", responses: { "200": {} } } },
+    },
+  };
+  const out = emitApiController(doc, "handlers");
+  const iShort = out.indexOf("op9999999999999999.ts");
+  const iLong = out.indexOf("op10000000000000001.ts");
+  assert.ok(iShort >= 0 && iLong >= 0, out);
+  assert.ok(iShort < iLong, `16-digit run must sort before the larger 17-digit run:\n${out}`);
+});
+
 test("emitApiController throws on a duplicate operationId (would silently overwrite a map key)", () => {
   const dupe: OpenApiDoc = {
     openapi: "3.0.0",

package/src/toolkit/derivers/api.ts

@@ -34,6 +34,44 @@ export const API_CONTROLLER_TS = "controller.ts";
 export { DEFAULT_OPERATIONS_DIR };
 
 
+/** Order two import source specifiers the way Biome's `organizeImports` assist does, so the
+ *  controller emits its delegate imports in Biome's canonical order and the generated file passes
+ *  `biome check` without a post-generation import sort. Biome's collation is, per character:
+ *  digit-runs compared numerically (`item2` before `item10`), letters compared case-insensitively
+ *  as the primary key, and — when two characters are the same letter differing only in case — the
+ *  uppercase one sorts first as an immediate tiebreak (`getAgentInstructions` before
+ *  `getAgenticRegistry` before `getAgentSkill`). */
+function naturalCompare(a: string, b: string): number {
+  const tokens = (s: string): string[] => s.match(/\d+|\D/g) ?? [];
+  const isDigitRun = (t: string): boolean => t.charCodeAt(0) >= 48 && t.charCodeAt(0) <= 57;
+  const ax = tokens(a);
+  const bx = tokens(b);
+  const n = Math.min(ax.length, bx.length);
+  for (let i = 0; i < n; i++) {
+    const ca = ax[i];
+    const cb = bx[i];
+    if (ca === undefined || cb === undefined) break;
+    if (isDigitRun(ca) && isDigitRun(cb)) {
+      // Compare digit runs by numeric value *without* floating-point loss: strip leading zeros,
+      // then a longer run is the larger number, else compare the equal-length digits lexically.
+      // (`Number(ca) - Number(cb)` collapses 17+-digit runs to the same IEEE-754 value and yields
+      //  `NaN` beyond `Number.MAX_SAFE_INTEGER`, both of which break the total order `sort` needs.)
+      const na = ca.replace(/^0+/, "");
+      const nb = cb.replace(/^0+/, "");
+      if (na.length !== nb.length) return na.length < nb.length ? -1 : 1;
+      if (na !== nb) return na < nb ? -1 : 1;
+      if (ca !== cb) return ca < cb ? -1 : 1; // equal value, differing leading zeros
+    } else if (ca !== cb) {
+      const la = ca.toLowerCase();
+      const lb = cb.toLowerCase();
+      if (la !== lb) return la < lb ? -1 : 1; // case-insensitive primary key
+      return ca < cb ? -1 : 1; // same letter, different case → uppercase (lower code point) first
+    }
+  }
+  return ax.length - bx.length;
+}
+
+
 /** A TS identifier form of an operationId (used for the per-op type names). */
 function typeStem(operationId: string): string {
   const cleaned = operationId.replace(/[^A-Za-z0-9]+/g, " ").trim();
@@ -156,7 +194,7 @@ function objectToTs(schema: OpenApiSchema, depth: number): string {
  *  not enforce presence for ejected ops, so a "required" query param may in fact be absent. */
 function paramsTs(op: OperationInfo, where: "path" | "query", ejected: boolean): string {
   const ps = op.parameters.filter((p) => p.in === where);
-  if (ps.length === 0) return "{}";
+  if (ps.length === 0) return "Record<string, never>";
   const rawWire = where === "query" ? "string | string[]" : "string";
   const fields = ps.map((p) => {
     // Coerced to the schema type (number/boolean/array/enum/…); optionality is carried by the `?`
@@ -211,8 +249,7 @@ export function emitApiBindings(doc: OpenApiDoc, surfaceEject = false): string {
     "// The endpoint type map: each operationId maps to its typed request (coerced path/query params\n" +
     "// + JSON body) and response (a union of every documented JSON response body), derived from the\n" +
     "// spec. Do not edit — regenerated from\n" +
-    "// the spec; erased to plain JS at compile.\n" +
-    "// eslint-disable\n\n";
+    "// the spec; erased to plain JS at compile.\n\n";
 
   const componentDecls = Object.entries(components)
     .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
@@ -272,6 +309,13 @@ export function emitApiBindings(doc: OpenApiDoc, surfaceEject = false): string {
     })
     .join("\n");
 
+  // With generated `.ts` now linted in the scaffold, an empty operation set must NOT emit an empty
+  // `interface ApiOperations {}` (`suspicious/noEmptyInterface`); fall back to the same non-empty-safe
+  // `Record<never, never>` used elsewhere (its `keyof` is `never`, matching `ApiOperationId = never`).
+  const apiOperations = ops.length > 0
+    ? `export interface ApiOperations {\n${mapEntries}\n}\n`
+    : `export type ApiOperations = Record<never, never>;\n`;
+
   return (
     header +
     (componentDecls ? `${componentDecls}\n\n` : "") +
@@ -279,7 +323,7 @@ export function emitApiBindings(doc: OpenApiDoc, surfaceEject = false): string {
     `/** Every declared operationId (ADR 0058): the delegate key set. */\n` +
     `export type ApiOperationId = ${idUnion};\n\n` +
     `/** Request/response contract per operationId. */\n` +
-    `export interface ApiOperations {\n${mapEntries}\n}\n`
+    apiOperations
   );
 }
 
@@ -291,10 +335,9 @@ export function emitApiBindingsRuntime(): string {
     "// AUTO-GENERATED by @nanobpm/urban (ADR 0058): the typed `defineOperation`.\n" +
     "// Re-exports the operation SDK and overrides `defineOperation` with an operationId-keyed\n" +
     "// signature (the delegate's validated request + result typed from the spec). Erased to a\n" +
-    "// pass-through at runtime. Do not edit.\n" +
-    "// eslint-disable\n\n" +
-    `import { defineOperation as defineOperationRaw } from "@nanobpm/urban";\n` +
+    "// pass-through at runtime. Do not edit.\n\n" +
     `import type { OperationHandler } from "@nanobpm/urban";\n` +
+    `import { defineOperation as defineOperationRaw } from "@nanobpm/urban";\n` +
     `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n\n` +
     `type ReqFor<K extends ApiOperationId> = ApiOperations[K]["request"];\n` +
     `type ResFor<K extends ApiOperationId> = ApiOperations[K]["response"];\n\n` +
@@ -342,23 +385,26 @@ export function emitApiController(doc: OpenApiDoc, operationsDir: string = DEFAU
     "// registry. Statically imports every operation delegate and asserts the complete, correctly-\n" +
     "// typed set via `satisfies` — a missing, mismatched, or orphan delegate fails `tsc`. The\n" +
     "// runtime dispatches through this map, so endpoints cannot drift from the spec. Do not edit —\n" +
-    "// regenerated from the spec.\n" +
-    "// eslint-disable\n\n";
-
-  const typeImports =
-    `import type { OperationHandler } from "@nanobpm/urban";\n` +
-    `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n`;
+    "// regenerated from the spec.\n\n";
 
+  // Emit imports in Biome's canonical `organizeImports` order so the generated file is lint-clean
+  // without a post-gen fixup: the bare package import first, then the delegate imports sorted by
+  // source specifier (Biome's natural, numeric-aware collation), then the relative `./api-io.d.ts`
+  // type import last. Alias bindings (`op<i>`) stay tied to the original index so the `operations`
+  // map below still resolves each operationId to its delegate regardless of import line order.
   const delegateImports = ops
-    .map((op, i) => `import op${i} from ${JSON.stringify(`../${dir}/${op.operationId}.ts`)};`)
+    .map((op, i) => ({ i, spec: `../${dir}/${op.operationId}.ts` }))
+    .sort((a, b) => naturalCompare(a.spec, b.spec))
+    .map(({ i, spec }) => `import op${i} from ${JSON.stringify(spec)};`)
     .join("\n");
 
   const mapEntries = ops.map((op, i) => `  ${JSON.stringify(op.operationId)}: op${i},`).join("\n");
 
   return (
     header +
-    typeImports +
+    `import type { OperationHandler } from "@nanobpm/urban";\n` +
     (delegateImports ? `${delegateImports}\n` : "") +
+    `import type { ApiOperationId, ApiOperations } from "./${API_BINDINGS_DTS}";\n` +
     `\n` +
     `type ReqFor<K extends ApiOperationId> = ApiOperations[K]["request"];\n` +
     `type ResFor<K extends ApiOperationId> = ApiOperations[K]["response"];\n\n` +

package/src/toolkit/derivers/bindings-parity.test.ts

@@ -7,7 +7,7 @@ import { emitMessageBindings, emitMessageBindingsRuntime } from "./messages.ts";
 // Byte-exact goldens for the emitters ported into the toolkit for the domaintypes op (host dry-out
 // nano-bpm#576). Captured verbatim from the console's own emitters via Deno; these lock the toolkit
 // output to the console byte-for-byte so the two can never drift while both exist.
-const GOLDENS: Record<string, string> = JSON.parse("{\"bindings\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1/§6).\\n// The typed data-object layer: `openDomain()` → one `Table<T>` per table, so\\n// workers manipulate typed rows instead of hand-writing SQL. Do not edit —\\n// regenerated from the live tables. Erased to plain JS at `deno compile`.\\n// eslint-disable\\n\\nimport { openDataSource, type DataSource, type Table } from \\\"./data-sdk.ts\\\";\\nimport type { Customers, Orders } from \\\"./domain-rows.d.ts\\\";\\n\\nexport interface Domain {\\n  /** The underlying datasource handle — the raw-SQL escape hatch. */\\n  readonly raw: DataSource;\\n  readonly orders: Table<Orders>;\\n  readonly customers: Table<Customers>;\\n  /** Close the underlying connection. */\\n  close(): void;\\n}\\n\\n/**\\n * Open the App's datasource as a typed domain: each table is\\n * a `Table<T>` gateway (`db.orders.insert(...)`, `db.orders.get(id)`), with the\\n * raw `DataSource` at `db.raw` for anything the gateway doesn't cover.\\n */\\nexport async function openDomain(source?: string): Promise<Domain> {\\n  const raw = await openDataSource(source);\\n  return {\\n    raw,\\n    orders: raw.table<Orders>(\\\"orders\\\", \\\"id\\\"),\\n    customers: raw.table<Customers>(\\\"customers\\\", \\\"id\\\"),\\n    close: () => raw.close(),\\n  };\\n}\\n\\nexport type { Table };\\n\",\"workerRuntime\":\"// AUTO-GENERATED by nanobpmn (ADR 0033 §3): the typed `defineWorker`.\\n// Re-exports the worker SDK and overrides `defineWorker` with a taskType-keyed\\n// typed signature (job.variables, job.customHeaders + result typed from the\\n// worker's declared input/output/header contract). Erased to a pass-through at\\n// runtime. Do not edit.\\n// eslint-disable\\n\\nimport { defineWorker as defineWorkerRaw } from \\\"./worker-sdk.ts\\\";\\nimport type { WorkerOptions } from \\\"./worker-sdk.ts\\\";\\nimport type { WorkerInputs, WorkerOutputs, WorkerHeaders, WorkerTaskType, WorkerVars, WorkerHdrs } from \\\"./worker-io.d.ts\\\";\\n\\nexport * from \\\"./worker-sdk.ts\\\";\\n\\ntype InFor<K extends WorkerTaskType> = K extends keyof WorkerInputs ? WorkerInputs[K] : WorkerVars;\\ntype OutFor<K extends WorkerTaskType> = K extends keyof WorkerOutputs ? WorkerOutputs[K] : WorkerVars;\\ntype HdrFor<K extends WorkerTaskType> = K extends keyof WorkerHeaders ? WorkerHeaders[K] : WorkerHdrs;\\n\\n/**\\n * Typed `defineWorker`: `type` is constrained to the model's declared job types\\n * (`WorkerTaskType`, ADR 0033 §3) so it autocompletes and rejects unknown jobs,\\n * and the handler's `job.variables`, `job.customHeaders` + result are typed from\\n * the worker's declared `inputType`/`outputType`/header keys. A declared job type\\n * with no declared type falls back to WorkerVars / WorkerHdrs.\\n */\\nexport function defineWorker<K extends WorkerTaskType>(\\n  opts: { type: K } & WorkerOptions<InFor<K> & object, OutFor<K> & object, HdrFor<K> & object>,\\n): void {\\n  defineWorkerRaw(opts as unknown as WorkerOptions);\\n}\\n\",\"messageRuntime\":\"// AUTO-GENERATED by nanobpmn (ADR 0040 slice 2): the typed `publishMessage`.\\n// Re-exports the worker SDK's `publishMessage` and overrides it with a\\n// messageName-keyed typed signature (variables typed from the message's declared\\n// envelope). Erased to a pass-through at runtime. Do not edit.\\n// eslint-disable\\n\\nimport { publishMessage as publishMessageRaw } from \\\"./worker-sdk.ts\\\";\\nimport type { PublishMessageOptions, PublishMessageResult } from \\\"./worker-sdk.ts\\\";\\nimport type { MessageName, MessagePayloads, MessageVars } from \\\"./message-io.d.ts\\\";\\n\\nexport type { PublishMessageOptions, PublishMessageResult } from \\\"./worker-sdk.ts\\\";\\n\\ntype PayloadFor<K extends MessageName> = K extends keyof MessagePayloads ? MessagePayloads[K] : MessageVars;\\n\\n/**\\n * Typed `publishMessage`: `name` is constrained to the model's declared message\\n * names (`MessageName`, ADR 0040 slice 2) so it autocompletes and rejects unknown\\n * messages, and `variables` are typed from the message's declared envelope. A\\n * declared message with no domain type falls back to MessageVars.\\n */\\nexport function publishMessage<K extends MessageName>(\\n  name: K,\\n  opts?: PublishMessageOptions<PayloadFor<K> & object>,\\n): Promise<PublishMessageResult> {\\n  return publishMessageRaw(name, opts as unknown as PublishMessageOptions);\\n}\\n\",\"workerBindingsWithHeaders\":\"// AUTO-GENERATED by nanobpmn from the App manifest (ADR 0033 §3).\\n// The bridge from the process model to the worker type system: each declared\\n// worker's `taskType` maps to the TS type of its input payload (`job.variables`)\\n// and result, so the typed `defineWorker` types a handler by its job type. Do\\n// not edit — regenerated from the manifest. Erased to plain JS at compile.\\n// eslint-disable\\n\\nimport type { DomainTypes } from \\\"./domain-rows.d.ts\\\";\\n\\n/** Untyped fallback for a job whose worker declares no input/output type. */\\nexport type WorkerVars = Record<string, unknown>;\\n\\n/** Untyped fallback for a job whose worker declares no custom headers. */\\nexport type WorkerHdrs = Record<string, unknown>;\\n\\n/** Every declared worker `taskType` (ADR 0033 §3): the model-derived set the\\n * typed `defineWorker` accepts, so `type` autocompletes and rejects unknown jobs. */\\nexport type WorkerTaskType = \\\"review\\\";\\n\\n/** Input payload (`job.variables`) per declared worker, keyed by `taskType`. */\\nexport interface WorkerInputs {\\n  \\\"review\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\\n/** Output payload (worker result) per declared worker, keyed by `taskType`. */\\nexport interface WorkerOutputs {\\n  \\\"review\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\\n/** Custom headers (`job.customHeaders`) per declared worker, keyed by `taskType`.\\n * Header values are strings on the wire, so each declared key maps to `string`;\\n * the extra index signature keeps undeclared headers accessible (non-breaking). */\\nexport interface WorkerHeaders {\\n  \\\"review\\\": { \\\"priority\\\": string; \\\"x-flag\\\": string; [key: string]: string };\\n}\\n\",\"messageBindings\":\"// AUTO-GENERATED by nanobpmn from the process model (ADR 0040 slice 2).\\n// The bridge from a `bpmn:message`'s data envelope to the message type system:\\n// each named message maps to the TS type of its payload, so the typed\\n// `publishMessage` types a call by its message name. Do not edit — regenerated\\n// from the model. Erased to plain JS at compile.\\n// eslint-disable\\n\\nimport type { DomainTypes } from \\\"./domain-rows.d.ts\\\";\\n\\n/** Untyped fallback payload for a message that declares no envelope type. */\\nexport type MessageVars = Record<string, unknown>;\\n\\n/** Every declared message `name` (ADR 0040 slice 2): the model-derived set the\\n * typed `publishMessage` accepts, so `name` autocompletes and rejects unknown messages. */\\nexport type MessageName = \\\"approved\\\";\\n\\n/** Payload (`variables`) per declared message, keyed by `name`. */\\nexport interface MessagePayloads {\\n  \\\"approved\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\"}\n");
+const GOLDENS: Record<string, string> = JSON.parse("{\"bindings\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1/§6).\\n// The typed data-object layer: `openDomain()` → one `Table<T>` per table, so\\n// workers manipulate typed rows instead of hand-writing SQL. Do not edit —\\n// regenerated from the live tables. Erased to plain JS at `deno compile`.\\n\\nimport { type DataSource, openDataSource, type Table } from \\\"./data-sdk.ts\\\";\\nimport type { Customers, Orders } from \\\"./domain-rows.d.ts\\\";\\n\\nexport interface Domain {\\n  /** The underlying datasource handle — the raw-SQL escape hatch. */\\n  readonly raw: DataSource;\\n  readonly orders: Table<Orders>;\\n  readonly customers: Table<Customers>;\\n  /** Close the underlying connection. */\\n  close(): void;\\n}\\n\\n/**\\n * Open the App's datasource as a typed domain: each table is\\n * a `Table<T>` gateway (`db.orders.insert(...)`, `db.orders.get(id)`), with the\\n * raw `DataSource` at `db.raw` for anything the gateway doesn't cover.\\n */\\nexport async function openDomain(source?: string): Promise<Domain> {\\n  const raw = await openDataSource(source);\\n  return {\\n    raw,\\n    orders: raw.table<Orders>(\\\"orders\\\", \\\"id\\\"),\\n    customers: raw.table<Customers>(\\\"customers\\\", \\\"id\\\"),\\n    close: () => raw.close(),\\n  };\\n}\\n\\nexport type { Table };\\n\",\"workerRuntime\":\"// AUTO-GENERATED by nanobpmn (ADR 0033 §3): the typed `defineWorker`.\\n// Re-exports the worker SDK and overrides `defineWorker` with a taskType-keyed\\n// typed signature (job.variables, job.customHeaders + result typed from the\\n// worker's declared input/output/header contract). Erased to a pass-through at\\n// runtime. Do not edit.\\n\\nimport type { WorkerHdrs, WorkerHeaders, WorkerInputs, WorkerOutputs, WorkerTaskType, WorkerVars } from \\\"./worker-io.d.ts\\\";\\nimport type { WorkerOptions } from \\\"./worker-sdk.ts\\\";\\nimport { defineWorker as defineWorkerRaw } from \\\"./worker-sdk.ts\\\";\\n\\nexport * from \\\"./worker-sdk.ts\\\";\\n\\ntype InFor<K extends WorkerTaskType> = K extends keyof WorkerInputs ? WorkerInputs[K] : WorkerVars;\\ntype OutFor<K extends WorkerTaskType> = K extends keyof WorkerOutputs ? WorkerOutputs[K] : WorkerVars;\\ntype HdrFor<K extends WorkerTaskType> = K extends keyof WorkerHeaders ? WorkerHeaders[K] : WorkerHdrs;\\n\\n/**\\n * Typed `defineWorker`: `type` is constrained to the model's declared job types\\n * (`WorkerTaskType`, ADR 0033 §3) so it autocompletes and rejects unknown jobs,\\n * and the handler's `job.variables`, `job.customHeaders` + result are typed from\\n * the worker's declared `inputType`/`outputType`/header keys. A declared job type\\n * with no declared type falls back to WorkerVars / WorkerHdrs.\\n */\\nexport function defineWorker<K extends WorkerTaskType>(\\n  opts: { type: K } & WorkerOptions<InFor<K> & object, OutFor<K> & object, HdrFor<K> & object>,\\n): void {\\n  // biome-ignore lint/plugin: generic-to-raw erasure at the worker-SDK boundary; the wire stays untyped JSON (ADR 0033 §3).\\n  defineWorkerRaw(opts as unknown as WorkerOptions);\\n}\\n\",\"messageRuntime\":\"// AUTO-GENERATED by nanobpmn (ADR 0040 slice 2): the typed `publishMessage`.\\n// Re-exports the worker SDK's `publishMessage` and overrides it with a\\n// messageName-keyed typed signature (variables typed from the message's declared\\n// envelope). Erased to a pass-through at runtime. Do not edit.\\n\\nimport type { MessageName, MessagePayloads, MessageVars } from \\\"./message-io.d.ts\\\";\\nimport type { PublishMessageOptions, PublishMessageResult } from \\\"./worker-sdk.ts\\\";\\nimport { publishMessage as publishMessageRaw } from \\\"./worker-sdk.ts\\\";\\n\\nexport type { PublishMessageOptions, PublishMessageResult } from \\\"./worker-sdk.ts\\\";\\n\\ntype PayloadFor<K extends MessageName> = K extends keyof MessagePayloads ? MessagePayloads[K] : MessageVars;\\n\\n/**\\n * Typed `publishMessage`: `name` is constrained to the model's declared message\\n * names (`MessageName`, ADR 0040 slice 2) so it autocompletes and rejects unknown\\n * messages, and `variables` are typed from the message's declared envelope. A\\n * declared message with no domain type falls back to MessageVars.\\n */\\nexport function publishMessage<K extends MessageName>(\\n  name: K,\\n  opts?: PublishMessageOptions<PayloadFor<K> & object>,\\n): Promise<PublishMessageResult> {\\n  // biome-ignore lint/plugin: generic-to-raw erasure at the message-SDK boundary; the wire stays untyped JSON (ADR 0040 slice 2).\\n  return publishMessageRaw(name, opts as unknown as PublishMessageOptions);\\n}\\n\",\"workerBindingsWithHeaders\":\"// AUTO-GENERATED by nanobpmn from the App manifest (ADR 0033 §3).\\n// The bridge from the process model to the worker type system: each declared\\n// worker's `taskType` maps to the TS type of its input payload (`job.variables`)\\n// and result, so the typed `defineWorker` types a handler by its job type. Do\\n// not edit — regenerated from the manifest. Erased to plain JS at compile.\\n\\nimport type { DomainTypes } from \\\"./domain-rows.d.ts\\\";\\n\\n/** Untyped fallback for a job whose worker declares no input/output type. */\\nexport type WorkerVars = Record<string, unknown>;\\n\\n/** Untyped fallback for a job whose worker declares no custom headers. */\\nexport type WorkerHdrs = Record<string, unknown>;\\n\\n/** Every declared worker `taskType` (ADR 0033 §3): the model-derived set the\\n * typed `defineWorker` accepts, so `type` autocompletes and rejects unknown jobs. */\\nexport type WorkerTaskType = \\\"review\\\";\\n\\n/** Input payload (`job.variables`) per declared worker, keyed by `taskType`. */\\nexport interface WorkerInputs {\\n  \\\"review\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\\n/** Output payload (worker result) per declared worker, keyed by `taskType`. */\\nexport interface WorkerOutputs {\\n  \\\"review\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\\n/** Custom headers (`job.customHeaders`) per declared worker, keyed by `taskType`.\\n * Header values are strings on the wire, so each declared key maps to `string`;\\n * the extra index signature keeps undeclared headers accessible (non-breaking). */\\nexport interface WorkerHeaders {\\n  \\\"review\\\": { \\\"priority\\\": string; \\\"x-flag\\\": string; [key: string]: string };\\n}\\n\",\"messageBindings\":\"// AUTO-GENERATED by nanobpmn from the process model (ADR 0040 slice 2).\\n// The bridge from a `bpmn:message`'s data envelope to the message type system:\\n// each named message maps to the TS type of its payload, so the typed\\n// `publishMessage` types a call by its message name. Do not edit — regenerated\\n// from the model. Erased to plain JS at compile.\\n\\nimport type { DomainTypes } from \\\"./domain-rows.d.ts\\\";\\n\\n/** Untyped fallback payload for a message that declares no envelope type. */\\nexport type MessageVars = Record<string, unknown>;\\n\\n/** Every declared message `name` (ADR 0040 slice 2): the model-derived set the\\n * typed `publishMessage` accepts, so `name` autocompletes and rejects unknown messages. */\\nexport type MessageName = \\\"approved\\\";\\n\\n/** Payload (`variables`) per declared message, keyed by `name`. */\\nexport interface MessagePayloads {\\n  \\\"approved\\\": DomainTypes[\\\"Order\\\"];\\n}\\n\"}");
 
 const sources: SourceSchema[] = [
   {

package/src/toolkit/derivers/domain.test.ts

@@ -17,7 +17,7 @@ import type { ToolkitManifest } from "./migrations.ts";
 
 // Goldens captured verbatim from the console's `emitDomainModel` (server domain_types.ts) via
 // Deno — this IS the per-emitter drift gate (ADR 0053): the toolkit must be byte-identical.
-const GOLDENS: Record<string, string> = JSON.parse("{\n  \"empty\": \"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n// eslint-disable\\n\\nexport interface DomainTables {}\\n\",\n  \"tablesOnly\": \"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n// eslint-disable\\n\\nexport interface Customers {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  email: string;\\n  /** TEXT */\\n  tier: string | null;\\n}\\n\\nexport interface OrderItems {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** INTEGER */\\n  qty: number;\\n  /** REAL */\\n  \\\"unit price\\\": number | null;\\n}\\n\\n/** Every table keyed by its wire name — index it for a row type. */\\nexport interface DomainTables {\\n  \\\"customers\\\": Customers;\\n  \\\"order_items\\\": OrderItems;\\n}\\n\",\n  \"typesOnly\": \"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n// eslint-disable\\n\\nexport interface DomainTables {}\\n\\n/** Declared (transient) domain types from the manifest `types` registry (ADR 0029 §4.2), keyed by id. */\\nexport interface DomainTypes {\\n  \\\"taxReturn\\\": {\\n    year: number;\\n    notes?: string;\\n    lines: DomainTypes[\\\"lineItem\\\"][];\\n  };\\n  \\\"lineItem\\\": {\\n    \\\"line no\\\": number;\\n    amount: number;\\n  };\\n}\\n\",\n  \"both\": \"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n// eslint-disable\\n\\nexport interface Greetings {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  who: string;\\n  /** TEXT */\\n  message: string;\\n  /** TEXT */\\n  createdAt: string | null;\\n}\\n\\n/** Every table keyed by its wire name — index it for a row type. */\\nexport interface DomainTables {\\n  \\\"greetings\\\": Greetings;\\n}\\n\\n/** Declared (transient) domain types from the manifest `types` registry (ADR 0029 §4.2), keyed by id. */\\nexport interface DomainTypes {\\n  \\\"greeting\\\": {\\n    who: string;\\n    message: string;\\n    createdAt?: string;\\n  };\\n}\\n\",\n  \"multi\": \"// AUTO-GENERATED by nanobpmn from the datasource schemas (ADR 0029 §4.1/§6).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n// eslint-disable\\n\\nexport interface AppCustomers {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  email: string;\\n}\\n\\nexport interface AnalyticsEvents {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  kind: string;\\n}\\n\\n/** Every datasource keyed by alias, then table by wire name. */\\nexport interface DomainSources {\\n  \\\"app\\\": {\\n    \\\"customers\\\": AppCustomers;\\n  };\\n  \\\"analytics\\\": {\\n    \\\"events\\\": AnalyticsEvents;\\n  };\\n}\\n\\n/** The default datasource's tables — index by wire name. */\\nexport type DomainTables = DomainSources[\\\"analytics\\\"];\\n\"\n}");
+const GOLDENS: Record<string, string> = JSON.parse("{\"empty\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n\\nexport type DomainTables = Record<never, never>;\\n\",\"tablesOnly\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n\\nexport interface Customers {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  email: string;\\n  /** TEXT */\\n  tier: string | null;\\n}\\n\\nexport interface OrderItems {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** INTEGER */\\n  qty: number;\\n  /** REAL */\\n  \\\"unit price\\\": number | null;\\n}\\n\\n/** Every table keyed by its wire name — index it for a row type. */\\nexport interface DomainTables {\\n  \\\"customers\\\": Customers;\\n  \\\"order_items\\\": OrderItems;\\n}\\n\",\"typesOnly\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n\\nexport type DomainTables = Record<never, never>;\\n\\n/** Declared (transient) domain types from the manifest `types` registry (ADR 0029 §4.2), keyed by id. */\\nexport interface DomainTypes {\\n  \\\"taxReturn\\\": {\\n    year: number;\\n    notes?: string;\\n    lines: DomainTypes[\\\"lineItem\\\"][];\\n  };\\n  \\\"lineItem\\\": {\\n    \\\"line no\\\": number;\\n    amount: number;\\n  };\\n}\\n\",\"both\":\"// AUTO-GENERATED by nanobpmn from the datasource schema (ADR 0029 §4.1).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n\\nexport interface Greetings {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  who: string;\\n  /** TEXT */\\n  message: string;\\n  /** TEXT */\\n  createdAt: string | null;\\n}\\n\\n/** Every table keyed by its wire name — index it for a row type. */\\nexport interface DomainTables {\\n  \\\"greetings\\\": Greetings;\\n}\\n\\n/** Declared (transient) domain types from the manifest `types` registry (ADR 0029 §4.2), keyed by id. */\\nexport interface DomainTypes {\\n  \\\"greeting\\\": {\\n    who: string;\\n    message: string;\\n    createdAt?: string;\\n  };\\n}\\n\",\"multi\":\"// AUTO-GENERATED by nanobpmn from the datasource schemas (ADR 0029 §4.1/§6).\\n// Do not edit — regenerated from the live tables. Erased at `deno compile`.\\n\\nexport interface AppCustomers {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  email: string;\\n}\\n\\nexport interface AnalyticsEvents {\\n  /** INTEGER (primary key) */\\n  id: number;\\n  /** TEXT */\\n  kind: string;\\n}\\n\\n/** Every datasource keyed by alias, then table by wire name. */\\nexport interface DomainSources {\\n  \\\"app\\\": {\\n    \\\"customers\\\": AppCustomers;\\n  };\\n  \\\"analytics\\\": {\\n    \\\"events\\\": AnalyticsEvents;\\n  };\\n}\\n\\n/** The default datasource's tables — index by wire name. */\\nexport type DomainTables = DomainSources[\\\"analytics\\\"];\\n\"}");
 
 const col = (name: string, type: string, notNull: boolean, primaryKey: boolean) =>
   ({ name, type, notNull, primaryKey });