okengine 0.2.5 → 0.2.8

package/src/cli/ports.test.ts

@@ -13,20 +13,12 @@ describe("findFreePort", () => {
 
   test("increments until free", async () => {
     const busy = new Set([6530, 6531]);
-    const port = await findFreePort(
-      6530,
-      new Set(),
-      async (p) => busy.has(p),
-    );
+    const port = await findFreePort(6530, new Set(), async (p) => busy.has(p));
     expect(port).toBe(6532);
   });
 
   test("skips occupied set even when probe says free", async () => {
-    const port = await findFreePort(
-      6530,
-      new Set([6530, 6531]),
-      async () => false,
-    );
+    const port = await findFreePort(6530, new Set([6530, 6531]), async () => false);
     expect(port).toBe(6532);
   });
 
@@ -39,9 +31,8 @@ describe("resolveDevPorts", () => {
   test("keeps app · console · mcp distinct when preferred collide", async () => {
     // Everything busy except 6531, 6534, 6536 — force increments.
     const busy = new Set([6530, 6533, 6535]);
-    const ports = await resolveDevPorts(
-      { app: 6530, console: 6533, mcp: 6535 },
-      async (p) => busy.has(p),
+    const ports = await resolveDevPorts({ app: 6530, console: 6533, mcp: 6535 }, async (p) =>
+      busy.has(p),
     );
     expect(ports.app).toBe(6531);
     expect(ports.console).toBe(6534);

package/src/cli/ports.ts

@@ -48,9 +48,7 @@ export async function findFreePort(
     if (occupied.has(port)) continue;
     if (!(await probe(port))) return port;
   }
-  throw new Error(
-    `oke: no free port near ${preferred} after ${MAX_PORT_ATTEMPTS} attempts`,
-  );
+  throw new Error(`oke: no free port near ${preferred} after ${MAX_PORT_ATTEMPTS} attempts`);
 }
 
 /**

package/src/cli/privacy-erase.ts

@@ -24,9 +24,7 @@ export interface RunPrivacyEraseOptions {
  *
  * @param options - Subject + vault
  */
-export function runPrivacyErase(
-  options: RunPrivacyEraseOptions,
-): PrivacyEraseResult {
+export function runPrivacyErase(options: RunPrivacyEraseOptions): PrivacyEraseResult {
   const keys = options.subjectKeys ?? createMemorySubjectKeys();
   return privacyErase({
     subjectId: options.subjectId,

package/src/cli/registry.ts

@@ -6,7 +6,7 @@
 
 /** One CLI flag (long form is canonical; short is convenience only). */
 export interface CliFlag {
-  /** Canonical long form including leading dashes (e.g. `--stack`). */
+  /** Canonical long form including leading dashes (e.g. `--docker`). */
   readonly long: string;
   /** Optional short form including leading dash (e.g. `-s`). */
   readonly short?: string;
@@ -97,16 +97,31 @@ export const OKE_COMMANDS: readonly CliCommand[] = [
     leaf: true,
     flags: [
       {
-        long: "--stack",
-        short: "-s",
+        long: "--local",
+        short: "-l",
+        summary: "Session-only local mode (in-memory; no compose)",
+      },
+      {
+        long: "--docker",
+        short: "-d",
         takesValue: true,
         valueName: "roles",
-        summary: "Boot generated compose (optional role list)",
+        summary: "Session-only docker compose (optional role list)",
+      },
+      {
+        long: "--no-db-push",
+        summary: "Disable auto `oke db push` on schema change (local)",
       },
       ENTRY,
       HELP,
     ],
   },
+  {
+    name: "mode",
+    summary: "get/set default oke dev mode (local|docker)",
+    leaf: true,
+    flags: [HELP],
+  },
   {
     name: "start",
     summary: "production entry (Docker CMD)",
@@ -125,7 +140,7 @@ export const OKE_COMMANDS: readonly CliCommand[] = [
   },
   {
     name: "doctor",
-    summary: "secrets · ports · schema drift",
+    summary: "secrets · ports · stub/domain schema drift",
     leaf: true,
     flags: [
       MANIFEST,
@@ -185,6 +200,54 @@ export const OKE_COMMANDS: readonly CliCommand[] = [
       },
     ],
   },
+  {
+    name: "db",
+    summary: "domain schema — push · generate · migrate",
+    subcommands: [
+      {
+        name: "push",
+        summary: "Sync schema.ts to the live local DB (dev)",
+        flags: [
+          {
+            long: "--config",
+            short: "-c",
+            takesValue: true,
+            valueName: "path",
+            summary: "drizzle.config.ts path",
+          },
+          HELP,
+        ],
+      },
+      {
+        name: "generate",
+        summary: "Write versioned SQL under drizzle/",
+        flags: [
+          {
+            long: "--config",
+            short: "-c",
+            takesValue: true,
+            valueName: "path",
+            summary: "drizzle.config.ts path",
+          },
+          HELP,
+        ],
+      },
+      {
+        name: "migrate",
+        summary: "Apply generated migrations (explicit)",
+        flags: [
+          {
+            long: "--config",
+            short: "-c",
+            takesValue: true,
+            valueName: "path",
+            summary: "drizzle.config.ts path",
+          },
+          HELP,
+        ],
+      },
+    ],
+  },
   {
     name: "client",
     summary: "ambient types for a separate frontend repo",
@@ -358,18 +421,12 @@ export const OKE_COMMANDS: readonly CliCommand[] = [
  * @returns Help text (no trailing exit-code block)
  */
 export function formatOkeHelp(): string {
-  const lines = [
-    "oke — okengine CLI",
-    "",
-    "Commands:",
-  ];
+  const lines = ["oke — okengine CLI", "", "Commands:"];
   for (const cmd of OKE_COMMANDS) {
     const usage = formatCommandUsage(cmd);
     lines.push(`  ${pad(usage, 34)} ${cmd.summary}`);
     if (cmd.name === "doctor") {
-      lines.push(
-        `  ${pad("oke doctor --diff|-d", 34)} CI gate: undeclared contract breaks`,
-      );
+      lines.push(`  ${pad("oke doctor --diff|-d", 34)} CI gate: undeclared contract breaks`);
     }
   }
   lines.push("");
@@ -379,9 +436,7 @@ export function formatOkeHelp(): string {
 /**
  * Collect every top-level command name (for completion / tests).
  */
-export function commandNames(
-  commands: readonly CliCommand[] = OKE_COMMANDS,
-): readonly string[] {
+export function commandNames(commands: readonly CliCommand[] = OKE_COMMANDS): readonly string[] {
   return commands.map((c) => c.name);
 }
 
@@ -391,10 +446,7 @@ export function commandNames(
  * @param command - Top-level command
  * @param sub - Optional subcommand name
  */
-export function flagTokensFor(
-  command: CliCommand,
-  sub?: string,
-): readonly string[] {
+export function flagTokensFor(command: CliCommand, sub?: string): readonly string[] {
   const flags = sub
     ? (command.subcommands?.find((s) => s.name === sub)?.flags ?? [])
     : (command.flags ?? []);
@@ -420,9 +472,7 @@ function formatCommandUsage(cmd: CliCommand): string {
   if (cmd.subcommands && cmd.subcommands.length > 1) {
     const subs = cmd.subcommands.map((s) => s.name).join("|");
     // Prefer shared JSON flag hint when every list-like sub supports it.
-    const jsonHint = cmd.subcommands.some((s) =>
-      s.flags?.some((f) => f.long === "--json"),
-    )
+    const jsonHint = cmd.subcommands.some((s) => s.flags?.some((f) => f.long === "--json"))
       ? " [--json|-j]"
       : "";
     return `oke ${cmd.name} ${subs}${jsonHint}`;
@@ -439,8 +489,8 @@ function formatCommandUsage(cmd: CliCommand): string {
 function formatFlagHint(f: CliFlag): string {
   const name = f.short ? `${f.long}|${f.short}` : f.long;
   if (f.takesValue) {
-    // Optional value (e.g. --stack [roles]) when valueName is roles-like.
-    if (f.long === "--stack") return `[${name} [${f.valueName}]]`;
+    // Optional value (e.g. --docker [roles]) when valueName is roles-like.
+    if (f.long === "--docker") return `[${name} [${f.valueName}]]`;
     return `[${name} ${f.valueName}]`;
   }
   return `[${name}]`;

package/src/cli/schema.ts

@@ -32,9 +32,7 @@ export interface SchemaGenerateOptions {
  *
  * @param options - Manifest / check flag
  */
-export async function runSchemaGenerate(
-  options: SchemaGenerateOptions = {},
-): Promise<number> {
+export async function runSchemaGenerate(options: SchemaGenerateOptions = {}): Promise<number> {
   const write = options.write ?? ((t) => process.stdout.write(t));
   const cwd = options.cwd ?? process.cwd();
   let manifest = options.manifest;
@@ -92,10 +90,7 @@ export async function runSchemaGenerate(
  * @param cwd - Project root
  * @param manifest - Optional manifest
  */
-export async function schemaFingerprint(
-  cwd: string,
-  manifest?: Manifest,
-): Promise<string> {
+export async function schemaFingerprint(cwd: string, manifest?: Manifest): Promise<string> {
   const tables = new Set<string>([
     "oke_roles",
     "oke_role_grants",
@@ -123,9 +118,7 @@ export async function schemaFingerprint(
  *
  * @param cwd - Project root
  */
-export async function readSchemaFingerprint(
-  cwd: string,
-): Promise<string | null> {
+export async function readSchemaFingerprint(cwd: string): Promise<string | null> {
   const fpFile = Bun.file(resolve(cwd, SCHEMA_FINGERPRINT_FILE));
   if (await fpFile.exists()) {
     return (await fpFile.text()).trim();

package/src/cli/stack.ts

@@ -22,19 +22,14 @@ export interface StackCliOptions {
  *
  * @param options - Config / images
  */
-export async function runStackPreview(
-  options: StackCliOptions = {},
-): Promise<number> {
+export async function runStackPreview(options: StackCliOptions = {}): Promise<number> {
   const write = options.write ?? ((t) => process.stdout.write(t));
   const writeErr = options.writeErr ?? ((t) => process.stderr.write(t));
   const json = options.json ?? false;
   let images = options.images;
   if (!images) {
     try {
-      const loaded = await loadOkeConfig(
-        options.cwd ?? process.cwd(),
-        options.configPath,
-      );
+      const loaded = await loadOkeConfig(options.cwd ?? process.cwd(), options.configPath);
       images = resolveImages(loaded.config);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);

package/src/cli/start.ts

@@ -17,10 +17,7 @@ export interface StartOptions {
    * @param entry - Absolute entry path
    * @param env - Process env overlay
    */
-  readonly runEntry?: (
-    entry: string,
-    env: Record<string, string>,
-  ) => Promise<void>;
+  readonly runEntry?: (entry: string, env: Record<string, string>) => Promise<void>;
 }
 
 /**
@@ -29,10 +26,7 @@ export interface StartOptions {
  * @param cwd - Project root
  * @param explicit - Optional `--entry`
  */
-export async function resolveStartEntry(
-  cwd: string,
-  explicit?: string,
-): Promise<string> {
+export async function resolveStartEntry(cwd: string, explicit?: string): Promise<string> {
   if (explicit) return resolve(cwd, explicit);
   const pkgPath = resolve(cwd, "package.json");
   if (await Bun.file(pkgPath).exists()) {
@@ -47,9 +41,7 @@ export async function resolveStartEntry(
     const path = resolve(cwd, candidate);
     if (await Bun.file(path).exists()) return path;
   }
-  throw new Error(
-    "oke start: no entry found — set package.json okengine.entry or pass --entry",
-  );
+  throw new Error("oke start: no entry found — set package.json okengine.entry or pass --entry");
 }
 
 /**
@@ -63,10 +55,7 @@ export async function runStart(options: StartOptions = {}): Promise<number> {
   try {
     const entry = await resolveStartEntry(cwd, options.entry);
     const port = String(options.port ?? Number(Bun.env.PORT ?? APP_PORT));
-    const env = { ...process.env, NODE_ENV: "production", PORT: port } as Record<
-      string,
-      string
-    >;
+    const env = { ...process.env, NODE_ENV: "production", PORT: port } as Record<string, string>;
     write(`oke start: ${entry} (port ${port})\n`);
     if (options.runEntry) {
       await options.runEntry(entry, env);

package/src/cli/upgrade.ts

@@ -2,10 +2,7 @@
  * `oke upgrade` — run codemods for a breaking change, print the diff.
  */
 
-import {
-  runCodemods,
-  type CodemodChange,
-} from "../upgrade/codemods.ts";
+import { runCodemods, type CodemodChange } from "../upgrade/codemods.ts";
 
 /** One file rewrite produced by a codemod. */
 export type UpgradeChange = CodemodChange;

package/src/client/budget-entry.ts

@@ -4,12 +4,7 @@
  */
 
 import { createClient } from "./create.ts";
-import {
-  isErrorCode,
-  isFail,
-  isOk,
-  isTransportError,
-} from "./errors.ts";
+import { isErrorCode, isFail, isOk, isTransportError } from "./errors.ts";
 import { createTransport } from "./transport.ts";
 
 /**

package/src/client/create.test.ts

@@ -26,10 +26,7 @@ type BookingsApp = AppOf<{
 }>;
 
 /** Compile-time equality. */
-type Eq<A, B> =
-  (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2
-    ? true
-    : false;
+type Eq<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
 type Assert<T extends true> = T;
 
 describe("createClient — same-repo <App>", () => {
@@ -73,9 +70,7 @@ describe("createClient — same-repo <App>", () => {
     if (error?.code === "FlightFull") {
       // Runtime + type-level: seatsLeft is number, not unknown.
       expect(error.data.seatsLeft).toBe(2);
-      type _Narrow = Assert<
-        Eq<typeof error.data, { seatsLeft: number }>
-      >;
+      type _Narrow = Assert<Eq<typeof error.data, { seatsLeft: number }>>;
       const _keep: _Narrow = true;
       expect(_keep).toBe(true);
     } else {
@@ -135,11 +130,10 @@ describe("createClient — type helpers", () => {
     const ok: _Codes = true;
     expect(ok).toBe(true);
 
-    const sample: ClientResult<{ id: string }, { FlightFull: { seatsLeft: number } }> =
-      {
-        data: null,
-        error: { code: "FlightFull", data: { seatsLeft: 0 } },
-      };
+    const sample: ClientResult<{ id: string }, { FlightFull: { seatsLeft: number } }> = {
+      data: null,
+      error: { code: "FlightFull", data: { seatsLeft: 0 } },
+    };
     if (sample.error?.code === "FlightFull") {
       type _D = Assert<Eq<typeof sample.error.data, { seatsLeft: number }>>;
       const d: _D = true;

package/src/client/create.ts

@@ -13,12 +13,7 @@
  */
 
 import { createTransport, type Transport } from "./transport.ts";
-import type {
-  Client,
-  ClientOptions,
-  ClientRouteMap,
-  ResolveApp,
-} from "./types.ts";
+import type { Client, ClientOptions, ClientRouteMap, ResolveApp } from "./types.ts";
 
 /** App-shaped value that carries a runtime `$routes` table from typed adopt. */
 export interface AppWithRoutes {
@@ -98,8 +93,7 @@ export function flattenRoutes(
   $routes: ClientRouteMap | undefined,
 ): ClientOptions["routes"] | undefined {
   if (!$routes) return undefined;
-  const out: Record<string, { readonly method: string; readonly path: string }> =
-    {};
+  const out: Record<string, { readonly method: string; readonly path: string }> = {};
   for (const [unit, flows] of Object.entries($routes)) {
     if (!flows || typeof flows !== "object") continue;
     for (const [flow, contract] of Object.entries(flows)) {

package/src/client/errors.ts

@@ -30,10 +30,7 @@ export function isTransportError(
 export function isErrorCode<
   Err extends { readonly code: string; readonly data: unknown },
   C extends Err["code"],
->(
-  error: Err | null | undefined,
-  code: C,
-): error is Extract<Err, { readonly code: C }> {
+>(error: Err | null | undefined, code: C): error is Extract<Err, { readonly code: C }> {
   return error != null && error.code === code;
 }
 

package/src/client/index.ts

@@ -7,12 +7,7 @@
 
 export { createClient, flattenRoutes } from "./create.ts";
 export type { AppWithRoutes } from "./create.ts";
-export {
-  isErrorCode,
-  isFail,
-  isOk,
-  isTransportError,
-} from "./errors.ts";
+export { isErrorCode, isFail, isOk, isTransportError } from "./errors.ts";
 export { createTransport } from "./transport.ts";
 export type { Transport } from "./transport.ts";
 export type {

package/src/client/notes-contract.test.ts

@@ -20,10 +20,7 @@ beforeEach(() => {
 });
 
 /** Compile-time equality. */
-type Eq<A, B> =
-  (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2
-    ? true
-    : false;
+type Eq<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
 type Assert<T extends true> = T;
 
 const NoteId = z.object({ id: z.string() });
@@ -54,9 +51,7 @@ const get = on(
     out: Note,
     errors: { NotFound },
     do: ({ id }, fx) =>
-      id === "missing"
-        ? fx.fail("NotFound", {})
-        : { id, title: "First", body: "Hello" },
+      id === "missing" ? fx.fail("NotFound", {}) : { id, title: "First", body: "Hello" },
   }),
 );
 
@@ -121,9 +116,7 @@ describe("Notes — typeof app carries contracts", () => {
     {
       const { data, error } = await api.notes.get({ id: "n_1" });
       if (error?.code === "NotFound") {
-        type _Empty = Assert<
-          Eq<typeof error.data, Record<string, never>>
-        >;
+        type _Empty = Assert<Eq<typeof error.data, Record<string, never>>>;
         const keep: _Empty = true;
         expect(keep).toBe(true);
         throw new Error("unexpected NotFound");
@@ -244,9 +237,7 @@ describe("Notes — typeof app carries contracts", () => {
     type PartialClient = Client<typeof createOnly>;
 
     type FullHasGet = "get" extends keyof FullClient["notes"] ? true : false;
-    type PartialHasGet = "get" extends keyof PartialClient["notes"]
-      ? true
-      : false;
+    type PartialHasGet = "get" extends keyof PartialClient["notes"] ? true : false;
 
     type _Full = Assert<Eq<FullHasGet, true>>;
     type _Part = Assert<Eq<PartialHasGet, false>>;

package/src/client/transport.ts

@@ -24,12 +24,8 @@ export interface Transport {
  * @param base - Absolute origin (no trailing slash)
  * @param opts - Client options
  */
-export function createTransport(
-  base: string,
-  opts: ClientOptions = {},
-): Transport {
-  const fetchFn: ClientFetch =
-    opts.fetch ?? globalThis.fetch.bind(globalThis);
+export function createTransport(base: string, opts: ClientOptions = {}): Transport {
+  const fetchFn: ClientFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
   const retries = opts.retry?.retries ?? 0;
   const delay0 = opts.retry?.delay ?? 50;
   const backoff = opts.retry?.backoff ?? 2;
@@ -94,10 +90,7 @@ async function once(
     : rpcRequest(base, key, input);
 
   const headers = new Headers();
-  const extra =
-    typeof opts.headers === "function"
-      ? await opts.headers()
-      : opts.headers;
+  const extra = typeof opts.headers === "function" ? await opts.headers() : opts.headers;
   if (Array.isArray(extra)) {
     for (const [k, v] of extra) headers.set(k, v);
   } else if (extra) {
@@ -114,9 +107,7 @@ async function once(
 
   const ctrl = opts.timeout !== undefined ? new AbortController() : undefined;
   const timer =
-    ctrl && opts.timeout !== undefined
-      ? setTimeout(() => ctrl.abort(), opts.timeout)
-      : undefined;
+    ctrl && opts.timeout !== undefined ? setTimeout(() => ctrl.abort(), opts.timeout) : undefined;
 
   try {
     const res = await fetchFn(url, {
@@ -140,8 +131,7 @@ function rpcRequest(
   input: unknown,
 ): { url: string; method: string; body: string | undefined } {
   const url = `${base}/_oke/${key}`;
-  const body =
-    input === undefined ? undefined : JSON.stringify(input ?? {});
+  const body = input === undefined ? undefined : JSON.stringify(input ?? {});
   return { url, method: "POST", body };
 }
 
@@ -152,9 +142,7 @@ function restRequest(
   input: unknown,
 ): { url: string; method: string; body: string | undefined } {
   const params =
-    input !== null && typeof input === "object"
-      ? (input as Record<string, unknown>)
-      : {};
+    input !== null && typeof input === "object" ? (input as Record<string, unknown>) : {};
   let pathOut = path;
   const query: string[] = [];
   const rest: Record<string, unknown> = {};
@@ -173,15 +161,11 @@ function restRequest(
   if (upper === "GET" || upper === "HEAD") {
     for (const [k, v] of Object.entries(rest)) {
       if (v !== undefined) {
-        query.push(
-          `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`,
-        );
+        query.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
       }
     }
   } else if (Object.keys(rest).length > 0 || path === pathOut) {
-    body = JSON.stringify(
-      Object.keys(rest).length > 0 ? rest : (input ?? {}),
-    );
+    body = JSON.stringify(Object.keys(rest).length > 0 ? rest : (input ?? {}));
   }
 
   const qs = query.length ? `?${query.join("&")}` : "";
@@ -221,12 +205,7 @@ async function decode(res: Response): Promise<ClientResult> {
     };
   }
 
-  if (
-    json !== null &&
-    typeof json === "object" &&
-    "data" in json &&
-    "error" in json
-  ) {
+  if (json !== null && typeof json === "object" && "data" in json && "error" in json) {
     return json as ClientResult;
   }
 

package/src/client/types.ts

@@ -88,9 +88,7 @@ export type RoutesOf<App> = App extends { readonly $routes: infer R }
       ? R
       : {
           [U in keyof R]: {
-            [F in keyof R[U]]: R[U][F] extends FlowContract
-              ? R[U][F]
-              : FlowContract;
+            [F in keyof R[U]]: R[U][F] extends FlowContract ? R[U][F] : FlowContract;
           };
         }
   : App extends ClientRouteMap
@@ -102,9 +100,7 @@ export type RoutesOf<App> = App extends { readonly $routes: infer R }
  *
  * @typeParam E - Error code → data map
  */
-export type ClientError<
-  E extends Record<string, unknown> = Record<string, unknown>,
-> = {
+export type ClientError<E extends Record<string, unknown> = Record<string, unknown>> = {
   [K in keyof E & string]: {
     readonly code: K;
     readonly data: E[K];
@@ -138,10 +134,7 @@ export type ClientResult<
   | { readonly data: null; readonly error: ClientError<E> | TransportError };
 
 /** Minimal fetch signature (avoids DOM `HeadersInit` / `preconnect` coupling). */
-export type ClientFetch = (
-  input: string | URL | Request,
-  init?: RequestInit,
-) => Promise<Response>;
+export type ClientFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 
 /** Header bag accepted by the client. */
 export type ClientHeaders = Record<string, string> | [string, string][];
@@ -153,9 +146,7 @@ export interface ClientOptions {
   /** Override `globalThis.fetch`. */
   readonly fetch?: ClientFetch;
   /** Static headers, or a getter invoked per request. */
-  readonly headers?:
-    | ClientHeaders
-    | (() => ClientHeaders | Promise<ClientHeaders>);
+  readonly headers?: ClientHeaders | (() => ClientHeaders | Promise<ClientHeaders>);
   /** Abort the request after this many milliseconds. */
   readonly timeout?: number;
   /** Retry transient failures (network / 5xx). */
@@ -173,11 +164,7 @@ export interface ClientOptions {
    */
   readonly auth?: {
     /** Current access token (Bearer), or null. */
-    readonly getToken: () =>
-      | string
-      | null
-      | undefined
-      | Promise<string | null | undefined>;
+    readonly getToken: () => string | null | undefined | Promise<string | null | undefined>;
     /** Obtain a new access token after 401. */
     readonly refresh: () => Promise<string | null | undefined>;
   };
@@ -186,9 +173,7 @@ export interface ClientOptions {
    * When absent, the client uses `POST /_oke/{unit}/{flow}` unless
    * {@link ClientOptions.$routes} supplies HTTP method/path from adopt.
    */
-  readonly routes?: Readonly<
-    Record<string, { readonly method: string; readonly path: string }>
-  >;
+  readonly routes?: Readonly<Record<string, { readonly method: string; readonly path: string }>>;
   /**
    * Runtime route map from `app.$routes` (typed adopt). HTTP triggers become
    * REST; flows without method/path fall back to RPC.
@@ -203,11 +188,7 @@ export interface ClientOptions {
  * @typeParam O - Output
  * @typeParam E - Errors
  */
-export type ClientCall<
-  I,
-  O,
-  E extends Record<string, unknown>,
-> = [I] extends [void]
+export type ClientCall<I, O, E extends Record<string, unknown>> = [I] extends [void]
   ? () => Promise<ClientResult<O, E>>
   : Partial<I> extends I
     ? (input?: I) => Promise<ClientResult<O, E>>
@@ -223,9 +204,7 @@ type ContractIn<C> = "in" extends keyof C
   : void;
 
 /** Pull output from a contract shape. */
-type ContractOut<C> = "out" extends keyof C
-  ? NonNullable<C["out"]>
-  : unknown;
+type ContractOut<C> = "out" extends keyof C ? NonNullable<C["out"]> : unknown;
 
 /** Pull error map from a contract shape. */
 type ContractErrors<C> = "errors" extends keyof C