@nwire/cli 0.9.1 → 0.10.0

package/dist/cache-runner.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=cache-runner.d.ts.map

package/dist/cache-runner.js

@@ -31,10 +31,21 @@ async function main() {
     // "App" means either:
     //   - `AppDefinition` (legacy `defineApp(name, { modules })`)
     //   - bootable `App` (modern `createApp({ modules })`)
-    // Both expose `modules: ModuleDefinition[]` which is all the scanner
-    // needs — we normalize them into the AppDefinition shape buildCache
-    // expects.
+    // Resolve the app(s). 0.10 createApp returns an App marked with
+    // `$nwireApp: true`. Recognized export names:
+    //   - allApps: App[] | apps: App[]
+    //   - default: App | App[]
+    //   - app: App
+    //   - buildApp(): App | Promise<App>          ← 0.10 factory pattern
+    //   - bootstrap(): { app: App, ... }          ← test-bootstrap pattern
+    //   - bootstrap(opts): { app: App, ... }
+    //
+    // Factory results that boot the App themselves (bootstrap functions
+    // that call .start() and run an endpoint) are also accepted — we
+    // pull the App handle off the return value and skip the start/stop
+    // dance.
     let apps = [];
+    let appsAlreadyBooted = false;
     if (Array.isArray(mod.allApps))
         apps = mod.allApps;
     else if (Array.isArray(mod.apps))
@@ -45,26 +56,100 @@ async function main() {
         apps = [mod.default];
     else if (isAppLike(mod.app))
         apps = [mod.app];
-    else {
+    else if (typeof mod.buildApp === "function") {
+        const built = await mod.buildApp();
+        const candidate = isAppLike(built) ? built : findAppInResult(built);
+        if (isAppLike(candidate))
+            apps = [candidate];
+    }
+    else if (typeof mod.bootstrap === "function") {
+        // Bootstrap usually starts the App and runs an endpoint. We try
+        // common signatures: `bootstrap({port,test})`, `bootstrap(port?)`.
+        // Returned shape is anything from { app, running } to { nest, nwireApp }
+        // to a bare App — we duck-find the first $nwireApp value in the result.
+        //
+        // 10s watchdog: some bootstrap functions never resolve (e.g. they
+        // wait on Nest's signal-driven lifecycle). The scanner falls back to
+        // "no apps found" rather than hanging the build pipeline.
+        const callWithTimeout = async (fn) => {
+            return await Promise.race([
+                fn(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error("bootstrap watchdog (10s)")), 10_000)),
+            ]);
+        };
+        let result;
+        try {
+            result = await callWithTimeout(() => mod.bootstrap({ port: 0, test: true }));
+        }
+        catch {
+            try {
+                result = await callWithTimeout(() => mod.bootstrap(0));
+            }
+            catch {
+                /* unscannable — leave apps empty */
+            }
+        }
+        const candidate = isAppLike(result) ? result : findAppInResult(result);
+        if (isAppLike(candidate)) {
+            apps = [candidate];
+            appsAlreadyBooted = true;
+            // Tear down the endpoint the bootstrap opened — we only need the
+            // App's runtime state for the scan.
+            const r = result;
+            if (typeof r?.running?.shutdown === "function") {
+                try {
+                    await r.running.shutdown("scan");
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+    }
+    if (apps.length === 0) {
         apps = Object.values(mod).filter(isAppLike);
     }
     if (apps.length === 0) {
         console.error(`nwire cache: no apps found in ${appsPath}.\n` +
-            `Expected: exported \`app\`, \`apps\`, or \`allApps\` — either an AppDefinition (\`defineApp\`) or a runnable App (\`createApp\`).\n` +
+            `Expected one of: exported \`app\`, \`apps\`, \`allApps\`, or a \`buildApp()\` factory returning an App from createApp.\n` +
             `Optional: nwire.config.ts with { appsEntry: "..." } to point at a custom location.`);
         process.exit(1);
     }
+    // The forge plugin registers handlers/actors/projections/queries on the
+    // dispatcher during the AppBooting hook — so the dispatcher is only
+    // populated AFTER `app.start()`. Boot each app for the scan (unless the
+    // bootstrap factory already did), then stop it.
+    if (!appsAlreadyBooted) {
+        for (const a of apps) {
+            const app = a;
+            if (app.$nwireApp && typeof app.start === "function") {
+                await app.start();
+            }
+        }
+    }
     const normalized = apps.map(toAppDefinitionShape);
-    // Route bindings are declared at the app layer via `httpInterface().wire()`
-    // and surface in Studio through the running wire's `/_nwire/*` introspection
-    // mount, not through the cache. The scan is module-domain-only.
     const cache = buildCache(normalized);
+    for (const a of apps) {
+        const app = a;
+        if (app.$nwireApp && typeof app.stop === "function") {
+            try {
+                await app.stop();
+            }
+            catch {
+                /* ignore — the bootstrap may have already torn things down */
+            }
+        }
+    }
     const outDir = resolve(cwd, config.cacheDir ?? ".nwire");
     await writeCache(cache, outDir);
     // eslint-disable-next-line no-console
     console.log(`nwire cache: wrote ${cache.apps.length} apps, ${cache.modules.length} modules, ` +
         `${cache.actions.length} actions, ${cache.events.length} events, ` +
         `${cache.resolvers.length} resolvers to ${outDir}/`);
+    // Some bootstrap functions leave foreign-framework servers (Nest,
+    // Fastify) listening even after we tear down the Nwire side. Force
+    // process exit so the scan doesn't hang the CI pipeline.
+    process.exit(0);
 }
 function isAppLike(x) {
     if (typeof x !== "object" || x === null)
@@ -72,6 +157,20 @@ function isAppLike(x) {
     const a = x;
     return a.$kind === "app-definition" || a.$nwireApp === true;
 }
+/**
+ * Bootstrap/factory functions return wrapper objects in many shapes —
+ * `{ app, running }`, `{ nest, nwireApp }`, `{ app, close }`, etc.
+ * Find the first property whose value is App-like.
+ */
+function findAppInResult(result) {
+    if (typeof result !== "object" || result === null)
+        return undefined;
+    for (const value of Object.values(result)) {
+        if (isAppLike(value))
+            return value;
+    }
+    return undefined;
+}
 /**
  * Normalize either flavor of "app" into the AppDefinition shape the
  * scanner reads. `createApp` returns an `App` with `appName` + the
@@ -103,4 +202,3 @@ main().catch((err) => {
     console.error(err);
     process.exit(1);
 });
-//# sourceMappingURL=cache-runner.js.map

package/dist/cli.d.ts

@@ -2,15 +2,12 @@
 /**
  * `nwire` — the umbrella CLI. Built on citty: one root command, one
  * subcommand per file under `commands/`. The CLI is intentionally thin —
- * every command delegates to either the kernel (long-lived processes,
- * future cross-surface dispatch) or a small set of execution helpers
- * (`viteNode`, `spawnInteractive`).
+ * every command delegates to a small set of execution helpers
+ * (`viteNode`, `spawnInteractive`) and, where needed, an in-tree
+ * RunnerSupervisor for long-lived processes.
  *
  * Adding a new command:
  *   1. write packages/nwire-cli/src/commands/<name>.ts using `defineCommand`
  *   2. import + register it below
- *   3. (later) when it should be reachable from Studio/MCP, also
- *      `kernel.router.register("<name>", handler)` in kernel-instance.ts
  */
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -2,15 +2,13 @@
 /**
  * `nwire` — the umbrella CLI. Built on citty: one root command, one
  * subcommand per file under `commands/`. The CLI is intentionally thin —
- * every command delegates to either the kernel (long-lived processes,
- * future cross-surface dispatch) or a small set of execution helpers
- * (`viteNode`, `spawnInteractive`).
+ * every command delegates to a small set of execution helpers
+ * (`viteNode`, `spawnInteractive`) and, where needed, an in-tree
+ * RunnerSupervisor for long-lived processes.
  *
  * Adding a new command:
  *   1. write packages/nwire-cli/src/commands/<name>.ts using `defineCommand`
  *   2. import + register it below
- *   3. (later) when it should be reachable from Studio/MCP, also
- *      `kernel.router.register("<name>", handler)` in kernel-instance.ts
  */
 import { defineCommand, runMain } from "citty";
 import { benchCommand } from "./commands/bench.js";
@@ -34,10 +32,11 @@ import { studioCommand } from "./commands/studio.js";
 import { testCommand } from "./commands/test.js";
 import { traceCommand } from "./commands/trace.js";
 import { watchCommand } from "./commands/watch.js";
+import { cliVersion } from "./lib/version.js";
 const main = defineCommand({
     meta: {
         name: "nwire",
-        version: "0.8.17",
+        version: cliVersion(),
         description: "Nwire — event-driven framework. Dev, build, please, ps, logs, studio, …",
     },
     subCommands: {
@@ -74,4 +73,3 @@ if (userArgs.length === 0) {
 else {
     void runMain(main);
 }
-//# sourceMappingURL=cli.js.map

package/dist/commands/bench.d.ts

@@ -100,4 +100,3 @@ export declare const benchCommand: import("citty").CommandDef<{
     };
 }>;
 export {};
-//# sourceMappingURL=bench.d.ts.map

package/dist/commands/bench.js

@@ -202,4 +202,3 @@ export const benchCommand = defineCommand({
         process.exit(0);
     },
 });
-//# sourceMappingURL=bench.js.map

package/dist/commands/build.d.ts

@@ -10,4 +10,3 @@ export declare const buildCommand: import("citty").CommandDef<{
         description: string;
     };
 }>;
-//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.js

@@ -5,18 +5,9 @@
  */
 import { defineCommand } from "citty";
 import { resolve } from "node:path";
-import { existsSync } from "node:fs";
 import { palette } from "../lib/colors.js";
-import { detectProject } from "../lib/project.js";
+import { detectLayout, resolveWire } from "../lib/layout.js";
 import { runTaskList } from "../lib/run-task.js";
-function resolveEntry(cwd, wireName) {
-    const appDir = resolve(cwd, "apps", wireName);
-    for (const candidate of [resolve(appDir, "run.ts"), resolve(appDir, "main.ts")]) {
-        if (existsSync(candidate))
-            return candidate;
-    }
-    return undefined;
-}
 export const buildCommand = defineCommand({
     meta: {
         name: "build",
@@ -31,16 +22,22 @@ export const buildCommand = defineCommand({
     },
     async run({ args }) {
         const cwd = process.cwd();
-        const project = detectProject(cwd);
-        const wires = args.wire ? [String(args.wire)] : [...project.wires];
-        if (wires.length === 0) {
+        const layout = detectLayout(cwd);
+        if (layout.wires.length === 0) {
             // eslint-disable-next-line no-console
-            console.error(palette.err("nwire build:") + " no wires detected (expected apps/<name>/{run,main}.ts)");
+            console.error(palette.err("nwire build:") +
+                " no wires detected. Expected one of: " +
+                "app/{run,main}.ts (single-wire), apps/<name>/{run,main}.ts (multi-wire), " +
+                "src/{main,index}.ts (flat), or a nwire.config.ts.");
             process.exit(1);
         }
-        const tasks = wires.flatMap((wire) => {
-            const entry = resolveEntry(cwd, wire);
+        const requested = args.wire ? [String(args.wire)] : layout.wires.map((w) => w.name);
+        const tasks = requested.flatMap((wire) => {
+            const entry = resolveWire(layout, wire);
             if (!entry) {
+                // eslint-disable-next-line no-console
+                console.error(palette.err(`nwire build: unknown wire "${wire}". `) +
+                    `Known wires: ${layout.wires.map((w) => w.name).join(", ") || "(none)"}.`);
                 return [
                     {
                         title: `${wire} — entry missing`,
@@ -71,4 +68,3 @@ export const buildCommand = defineCommand({
         process.exit(await runTaskList(tasks));
     },
 });
-//# sourceMappingURL=build.js.map

package/dist/commands/cache.d.ts

@@ -1,6 +1,6 @@
 /**
- * `nwire cache` — rebuilds `.nwire/` (manifest + per-kind JSON files) by
- * invoking the bundled cache-runner script under vite-node.
+ * `nwire cache` — rebuild `.nwire/` (manifest + per-kind JSON files).
+ * Equivalent to `ensureScanFresh({ force: true })`: skips the
+ * fingerprint cheap-path and always re-runs the cache builder.
  */
 export declare const cacheCommand: import("citty").CommandDef<import("citty").ArgsDef>;
-//# sourceMappingURL=cache.d.ts.map

package/dist/commands/cache.js

@@ -1,27 +1,17 @@
 /**
- * `nwire cache` — rebuilds `.nwire/` (manifest + per-kind JSON files) by
- * invoking the bundled cache-runner script under vite-node.
+ * `nwire cache` — rebuild `.nwire/` (manifest + per-kind JSON files).
+ * Equivalent to `ensureScanFresh({ force: true })`: skips the
+ * fingerprint cheap-path and always re-runs the cache builder.
  */
 import { defineCommand } from "citty";
-import { resolve, dirname } from "node:path";
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { palette } from "../lib/colors.js";
-import { viteNode } from "../lib/vite-node.js";
-const here = dirname(fileURLToPath(import.meta.url));
+import { ensureScanFresh } from "../lib/ensure-scan.js";
 export const cacheCommand = defineCommand({
     meta: {
         name: "cache",
         description: "Rebuild .nwire/ cache (manifest + per-kind JSON)",
     },
-    async run({ rawArgs }) {
-        const builderPath = resolve(here, "..", "cache-runner.js");
-        if (!existsSync(builderPath)) {
-            // eslint-disable-next-line no-console
-            console.error(palette.err("nwire cache:") + ` cache runner missing at ${builderPath}`);
-            process.exit(1);
-        }
-        process.exit(viteNode(builderPath, rawArgs));
+    async run() {
+        const { rebuilt } = ensureScanFresh(process.cwd(), { force: true });
+        process.exit(rebuilt ? 0 : 1);
     },
 });
-//# sourceMappingURL=cache.js.map

package/dist/commands/check.d.ts

@@ -1,6 +1,13 @@
 /**
- * `nwire check` — composed quality gate. Runs format-check, lint, and
- * typecheck in sequence. Use before pushing or in CI.
+ * `nwire check` — composed quality gate. Reads the consumer's
+ * package.json scripts and runs whatever they've defined.
+ *
+ *   1. `scripts.check` — single entrypoint wins.
+ *   2. `scripts.format:check`, `scripts.lint`, `scripts.typecheck` —
+ *      whichever subset is defined, in that order.
+ *   3. Fallback to any installed formatter / linter / type checker:
+ *      `oxfmt --check`, `biome check`, `prettier --check`; `oxlint`,
+ *      `eslint`; `tsc --noEmit`. Only spawns binaries that exist in
+ *      `node_modules/.bin`.
  */
 export declare const checkCommand: import("citty").CommandDef<import("citty").ArgsDef>;
-//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.js

@@ -1,21 +1,45 @@
 /**
- * `nwire check` — composed quality gate. Runs format-check, lint, and
- * typecheck in sequence. Use before pushing or in CI.
+ * `nwire check` — composed quality gate. Reads the consumer's
+ * package.json scripts and runs whatever they've defined.
+ *
+ *   1. `scripts.check` — single entrypoint wins.
+ *   2. `scripts.format:check`, `scripts.lint`, `scripts.typecheck` —
+ *      whichever subset is defined, in that order.
+ *   3. Fallback to any installed formatter / linter / type checker:
+ *      `oxfmt --check`, `biome check`, `prettier --check`; `oxlint`,
+ *      `eslint`; `tsc --noEmit`. Only spawns binaries that exist in
+ *      `node_modules/.bin`.
  */
 import { defineCommand } from "citty";
-import { runTaskList } from "../lib/run-task.js";
+import { palette } from "../lib/colors.js";
+import { runScriptStrategy } from "../lib/script-runner.js";
 export const checkCommand = defineCommand({
     meta: {
         name: "check",
-        description: "Run format-check + lint + typecheck",
+        description: "Run format-check + lint + typecheck (consumer-defined or sensible defaults)",
     },
     async run() {
-        const code = await runTaskList([
-            { title: "format (oxfmt --check)", command: "pnpm", args: ["exec", "oxfmt", "--check"] },
-            { title: "lint (oxlint)", command: "pnpm", args: ["exec", "oxlint"] },
-            { title: "typecheck (tsc)", command: "pnpm", args: ["exec", "tsc", "--noEmit"] },
-        ]);
+        const cwd = process.cwd();
+        const { code, ran } = await runScriptStrategy(cwd, {
+            operationName: "check",
+            consumerScript: "check",
+            consumerSubScripts: ["format:check", "lint", "typecheck"],
+            fallback: [
+                { title: "format (oxfmt --check)", bin: "oxfmt", args: ["--check"] },
+                { title: "format (biome check)", bin: "biome", args: ["check"] },
+                { title: "format (prettier --check)", bin: "prettier", args: ["--check", "."] },
+                { title: "lint (oxlint)", bin: "oxlint" },
+                { title: "lint (eslint)", bin: "eslint", args: ["."] },
+                { title: "typecheck (tsc --noEmit)", bin: "tsc", args: ["--noEmit"] },
+            ],
+        });
+        if (!ran) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire check:") +
+                " no `check`, `format:check`, `lint`, or `typecheck` script in package.json " +
+                "and none of oxfmt/oxlint/biome/prettier/eslint/tsc are installed locally.");
+            process.exit(1);
+        }
         process.exit(code);
     },
 });
-//# sourceMappingURL=check.js.map

package/dist/commands/dev.d.ts

@@ -8,4 +8,3 @@
  * sees the dev session from any other shell.
  */
 export declare const devCommand: import("citty").CommandDef<import("citty").ArgsDef>;
-//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.js

@@ -173,4 +173,3 @@ export const devCommand = defineCommand({
         process.exit(exitCode);
     },
 });
-//# sourceMappingURL=dev.js.map

package/dist/commands/doctor.d.ts

@@ -6,7 +6,7 @@
  * failures (warnings still allow boot), 1 otherwise.
  *
  * Born from the Phase F dev-loop bugs: lightship port collisions, missing
- * `api.inspect(app)`, stale `.nwire/` cache, wrong probe paths. Each
+ * httpKoa inspect mount, stale `.nwire/` cache, wrong probe paths. Each
  * check here exists because Alex hit the bug live; the doctor exists so
  * the next team member doesn't.
  *
@@ -56,4 +56,3 @@ export declare const doctorCommand: import("citty").CommandDef<{
         description: string;
     };
 }>;
-//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.js

@@ -6,7 +6,7 @@
  * failures (warnings still allow boot), 1 otherwise.
  *
  * Born from the Phase F dev-loop bugs: lightship port collisions, missing
- * `api.inspect(app)`, stale `.nwire/` cache, wrong probe paths. Each
+ * httpKoa inspect mount, stale `.nwire/` cache, wrong probe paths. Each
  * check here exists because Alex hit the bug live; the doctor exists so
  * the next team member doesn't.
  *
@@ -79,7 +79,7 @@ const workspaceCheck = {
             return {
                 status: "warn",
                 message: "no apps/, src/, or nwire.config.ts",
-                hint: "if this is a L1/L2 starter that's fine; for L4 add apps/<name>/main.ts",
+                hint: "single-folder starters use app/main.ts; multi-bounded-context layouts use apps/<name>/main.ts",
             };
         }
         return { status: "pass", message: `apps:${hasApps} src:${hasSrc} config:${hasConfig}` };
@@ -164,11 +164,11 @@ const composeCollisionCheck = {
 };
 const inspectMountCheck = {
     name: "inspect-mount",
-    description: "Every L4 example calls `api.inspect(app)`",
+    description: "Every entry boots `httpKoa({ inspect: true })` for Studio",
     run: (ctx) => {
-        // Scan apps/*/main.ts (or apps/*/<name>/main.ts) for createApp + missing .inspect().
-        // Best-effort grep — produces warnings not failures, since not every app
-        // wants the introspection surface in production wires.
+        // Scan apps/*/main.ts (or apps/*/<name>/main.ts) for httpKoa missing
+        // inspect. Best-effort grep — produces warnings not failures, since
+        // production wires usually want inspect gated by auth middleware.
         const appsDir = join(ctx.cwd, "apps");
         if (!existsSync(appsDir))
             return { status: "info", message: "no apps/ folder" };
@@ -177,17 +177,17 @@ const inspectMountCheck = {
             if (!entry.endsWith("main.ts") && !entry.endsWith("main.js"))
                 continue;
             const text = readFileSync(entry, "utf8");
-            const looksLikeL4 = /createApp|app\.start\(\)/.test(text);
-            const hasInspect = /\.inspect\(/.test(text);
-            if (looksLikeL4 && !hasInspect) {
+            const usesKoa = /\bhttpKoa\s*\(/.test(text);
+            const hasInspect = /inspect\s*:\s*(true|\{)/.test(text);
+            if (usesKoa && !hasInspect) {
                 offenders.push(relative(ctx.cwd, entry));
             }
         }
         if (offenders.length === 0)
-            return { status: "pass", message: "all L4 mains mount inspect" };
+            return { status: "pass", message: "all entries mount inspect" };
         return {
             status: "warn",
-            message: `${offenders.length} app${offenders.length === 1 ? "" : "s"} missing api.inspect(app)`,
+            message: `${offenders.length} entr${offenders.length === 1 ? "y" : "ies"} missing httpKoa({inspect:true})`,
             hint: `Studio's Live/Trace pages will 404 against:\n      - ${offenders.join("\n      - ")}`,
         };
     },
@@ -251,9 +251,9 @@ const templatesCheck = {
         // This check exists so users running `nwire doctor` see what they can
         // scaffold without leaving the terminal.
         const available = [
-            "L1 — minimal (httpInterface + endpoint; folder-organized routes/)",
-            "L2 — service (resources/errors/middleware/store/routes folders; in-memory CRUD)",
-            "L4 — enterprise (modules/<bc>/{events,actions,workflows,projections,routes})",
+            "minimal — createApp + httpKoa; one folder, no DI",
+            "service — container plugin, structured errors, route middleware, in-memory store",
+            "enterprise — forge: actions + events + actors + workflow + projection",
         ];
         return {
             status: "info",
@@ -420,4 +420,3 @@ export const doctorCommand = defineCommand({
         process.exit(hasFail ? 1 : 0);
     },
 });
-//# sourceMappingURL=doctor.js.map

package/dist/commands/fmt.d.ts

@@ -1,7 +1,12 @@
 /**
- * `nwire fmt` — passthrough to `oxfmt` wrapped in a listr2 task so the
- * output shape matches `lint`, `check`, and `build`. Honors any
- * oxfmt config in the consumer's project.
+ * `nwire fmt` — run the consumer's formatter. Picks the first
+ * available source in order:
+ *
+ *   1. `scripts.format` (and `scripts.format:check` for `--check`)
+ *   2. Any installed formatter — `oxfmt`, then `biome format --write`,
+ *      then `prettier --write`.
+ *
+ * Extra positional args / flags pass through.
  */
 export declare const fmtCommand: import("citty").CommandDef<{
     check: {
@@ -10,4 +15,3 @@ export declare const fmtCommand: import("citty").CommandDef<{
         default: false;
     };
 }>;
-//# sourceMappingURL=fmt.d.ts.map

package/dist/commands/fmt.js

@@ -1,14 +1,20 @@
 /**
- * `nwire fmt` — passthrough to `oxfmt` wrapped in a listr2 task so the
- * output shape matches `lint`, `check`, and `build`. Honors any
- * oxfmt config in the consumer's project.
+ * `nwire fmt` — run the consumer's formatter. Picks the first
+ * available source in order:
+ *
+ *   1. `scripts.format` (and `scripts.format:check` for `--check`)
+ *   2. Any installed formatter — `oxfmt`, then `biome format --write`,
+ *      then `prettier --write`.
+ *
+ * Extra positional args / flags pass through.
  */
 import { defineCommand } from "citty";
-import { runTaskList } from "../lib/run-task.js";
+import { palette } from "../lib/colors.js";
+import { runScriptStrategy } from "../lib/script-runner.js";
 export const fmtCommand = defineCommand({
     meta: {
         name: "fmt",
-        description: "Format the project with oxfmt",
+        description: "Format the project (consumer-defined or installed formatter)",
     },
     args: {
         check: {
@@ -18,16 +24,33 @@ export const fmtCommand = defineCommand({
         },
     },
     async run({ args, rawArgs }) {
+        const cwd = process.cwd();
         const passthrough = rawArgs.filter((a) => a !== "--check" && a !== "-c");
-        const oxfmtArgs = args.check ? ["--check", ...passthrough] : passthrough;
-        const code = await runTaskList([
+        const writeFallback = [
+            { title: "oxfmt", bin: "oxfmt", args: passthrough },
+            { title: "biome format --write", bin: "biome", args: ["format", "--write", ...passthrough] },
+            { title: "prettier --write", bin: "prettier", args: ["--write", ".", ...passthrough] },
+        ];
+        const checkFallback = [
+            { title: "oxfmt --check", bin: "oxfmt", args: ["--check", ...passthrough] },
+            { title: "biome check", bin: "biome", args: ["check", ...passthrough] },
             {
-                title: args.check ? "oxfmt --check" : "oxfmt",
-                command: "pnpm",
-                args: ["exec", "oxfmt", ...oxfmtArgs],
+                title: "prettier --check",
+                bin: "prettier",
+                args: ["--check", ".", ...passthrough],
             },
-        ]);
+        ];
+        const { code, ran } = await runScriptStrategy(cwd, {
+            operationName: "fmt",
+            consumerScript: args.check ? "format:check" : "format",
+            fallback: args.check ? checkFallback : writeFallback,
+        });
+        if (!ran) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire fmt:") +
+                " no `format` script and no installed formatter (oxfmt, biome, or prettier).");
+            process.exit(1);
+        }
         process.exit(code);
     },
 });
-//# sourceMappingURL=fmt.js.map

package/dist/commands/greeting.d.ts

@@ -3,4 +3,3 @@
  * ink so the panel is a single declarative tree we can grow over time.
  */
 export declare const greetingCommand: import("citty").CommandDef<import("citty").ArgsDef>;
-//# sourceMappingURL=greeting.d.ts.map

package/dist/commands/greeting.js

@@ -22,4 +22,3 @@ export const greetingCommand = defineCommand({
         await waitUntilExit().catch(() => { });
     },
 });
-//# sourceMappingURL=greeting.js.map

package/dist/commands/infra.d.ts

@@ -11,4 +11,3 @@
  *   nwire infra logs <svc> # tail one service's logs
  */
 export declare const infraCommand: import("citty").CommandDef<import("citty").ArgsDef>;
-//# sourceMappingURL=infra.d.ts.map

package/dist/commands/infra.js

@@ -150,4 +150,3 @@ export const infraCommand = defineCommand({
         }
     },
 });
-//# sourceMappingURL=infra.js.map