@nwire/cli 0.7.0

package/dist/commands/run.js

@@ -0,0 +1,112 @@
+/**
+ * `nwire run <wire>` — boot one wire by name with stdio passthrough.
+ *
+ *   nwire run main              → apps/main/{run,main}.ts
+ *   nwire run main.please       → apps/main/run.please.ts
+ *
+ * Prints a branded banner so the user sees what's starting, then hands
+ * stdio straight through to the child (runApp's boot banner shows the
+ * actual port, docs URL, etc.). Same banner UX as `nwire dev`; only
+ * difference is `dev` adds `--watch` and reloads on change.
+ */
+import { defineCommand } from "citty";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { palette } from "../lib/colors.js";
+export const runCommand = defineCommand({
+    meta: {
+        name: "run",
+        description: "Run a wire by name (apps/<name>/{run,main}.ts or run.<variant>.ts)",
+    },
+    args: {
+        wire: {
+            type: "positional",
+            required: true,
+            description: "Wire name, e.g. `main` or `main.please`",
+        },
+    },
+    async run({ args, rawArgs }) {
+        const cwd = process.cwd();
+        const [appName, ...variantParts] = String(args.wire).split(".");
+        if (!appName) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire run:") + " wire name required");
+            process.exit(1);
+        }
+        const appDir = resolve(cwd, "apps", appName);
+        if (!existsSync(appDir)) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire run:") + ` no app folder at ${appDir}`);
+            process.exit(1);
+        }
+        const variant = variantParts.length > 0 ? `.${variantParts.join(".")}` : "";
+        const candidates = [resolve(appDir, `run${variant}.ts`), resolve(appDir, `main${variant}.ts`)];
+        const entry = candidates.find((p) => existsSync(p));
+        if (!entry) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire run:") +
+                ` no entry file in ${appDir} for wire "${args.wire}" (looked for ${candidates
+                    .map((p) => p.split("/").pop())
+                    .join(", ")})`);
+            process.exit(1);
+        }
+        const entryRel = entry.replace(cwd + "/", "");
+        const passthrough = rawArgs.slice(rawArgs.indexOf(String(args.wire)) + 1);
+        // ── Banner ──────────────────────────────────────────────────────
+        // eslint-disable-next-line no-console
+        console.log([
+            "",
+            `  ${palette.brand(palette.bold("Nwire run"))}  ${palette.dim(String(args.wire))}`,
+            `  ${palette.dim("entry  ")} ${entryRel}`,
+            `  ${palette.dim("Ctrl+C ")} stop`,
+            "",
+        ].join("\n"));
+        // ── Stdio passthrough ──────────────────────────────────────────
+        // The child writes directly to the user's terminal. runApp() emits
+        // its own banner (ports, docs, openapi paths) so the user gets
+        // immediate feedback once the wire is listening.
+        const child = spawn("pnpm", ["exec", "vite-node", entry, ...passthrough], {
+            stdio: "inherit",
+            cwd,
+        });
+        let stopping = false;
+        const stop = (signal) => {
+            if (stopping)
+                return;
+            stopping = true;
+            try {
+                child.kill(signal);
+            }
+            catch {
+                // gone
+            }
+            setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null) {
+                    try {
+                        child.kill("SIGKILL");
+                    }
+                    catch {
+                        // gone
+                    }
+                }
+            }, 4000).unref();
+        };
+        process.on("SIGINT", () => stop("SIGINT"));
+        process.on("SIGTERM", () => stop("SIGTERM"));
+        const exitCode = await new Promise((resolveExit) => {
+            child.on("exit", (code, signal) => {
+                if (stopping || signal === "SIGINT" || signal === "SIGTERM") {
+                    resolveExit(0);
+                }
+                else {
+                    resolveExit(code ?? 0);
+                }
+            });
+        });
+        // eslint-disable-next-line no-console
+        console.log(palette.dim("\nStopped."));
+        process.exit(exitCode);
+    },
+});
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/studio.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `nwire studio` — boots Nwire Studio (Vue 3 + Vite) pointed at the
+ * consumer's project. Bypasses pnpm-filter to avoid the
+ * ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL noise on Ctrl+C; spawns Studio's own
+ * vite binary directly with NWIRE_CWD set so the middleware reads the
+ * right `.nwire/` and `apps/topologies/`.
+ */
+export declare const studioCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=studio.d.ts.map

package/dist/commands/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/commands/studio.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,eAAO,MAAM,aAAa,qDAkCxB,CAAC"}

package/dist/commands/studio.js

@@ -0,0 +1,46 @@
+/**
+ * `nwire studio` — boots Nwire Studio (Vue 3 + Vite) pointed at the
+ * consumer's project. Bypasses pnpm-filter to avoid the
+ * ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL noise on Ctrl+C; spawns Studio's own
+ * vite binary directly with NWIRE_CWD set so the middleware reads the
+ * right `.nwire/` and `apps/topologies/`.
+ */
+import { defineCommand } from "citty";
+import { createRequire } from "node:module";
+import { resolve, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { palette } from "../lib/colors.js";
+import { spawnInteractive } from "../lib/exec.js";
+const localRequire = createRequire(import.meta.url);
+export const studioCommand = defineCommand({
+    meta: {
+        name: "studio",
+        description: "Boot Nwire Studio (Vue + Vite UI)",
+    },
+    async run({ rawArgs }) {
+        let studioDir;
+        try {
+            studioDir = dirname(localRequire.resolve("@nwire/studio/package.json"));
+        }
+        catch {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire studio:") +
+                " @nwire/studio not installed. `pnpm add -D @nwire/studio` first.");
+            process.exit(1);
+        }
+        const viteBin = resolve(studioDir, "node_modules", ".bin", "vite");
+        if (!existsSync(viteBin)) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire studio:") +
+                ` vite binary missing at ${viteBin} — run \`pnpm install\` in ${studioDir}`);
+            process.exit(1);
+        }
+        const { done } = spawnInteractive(viteBin, rawArgs, {
+            cwd: studioDir,
+            env: { NWIRE_CWD: process.cwd() },
+            stoppedMessage: "Studio stopped.",
+        });
+        process.exit(await done);
+    },
+});
+//# sourceMappingURL=studio.js.map

package/dist/commands/studio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.js","sourceRoot":"","sources":["../../src/commands/studio.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mCAAmC;KACjD;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE;QACnB,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;gBAC1B,kEAAkE,CACrE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;gBAC1B,2BAA2B,OAAO,8BAA8B,SAAS,EAAE,CAC9E,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE;YAClD,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;YACjC,cAAc,EAAE,iBAAiB;SAClC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/test.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `nwire test [layer?]` — unified vitest runner.
+ *
+ * Auto-discovers test layers from the canonical `__tests__/<layer>/`
+ * convention (units, integration, e2e, bdd) and runs each as a separate
+ * vitest invocation wrapped in a listr2 task. With no arg, runs every
+ * detected layer in sequence. With `nwire test units` (etc.) runs just
+ * that one.
+ *
+ * Layer detection: walks the project for any `**\/__tests__/<layer>/`
+ * directories that contain test files, picks them up. Layers with no
+ * tests are silently skipped.
+ */
+export declare const testCommand: import("citty").CommandDef<{
+    layer: {
+        type: "positional";
+        required: false;
+        description: string;
+    };
+    watch: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmEH,eAAO,MAAM,WAAW;;;;;;;;;;;EAyEtB,CAAC"}

package/dist/commands/test.js

@@ -0,0 +1,143 @@
+/**
+ * `nwire test [layer?]` — unified vitest runner.
+ *
+ * Auto-discovers test layers from the canonical `__tests__/<layer>/`
+ * convention (units, integration, e2e, bdd) and runs each as a separate
+ * vitest invocation wrapped in a listr2 task. With no arg, runs every
+ * detected layer in sequence. With `nwire test units` (etc.) runs just
+ * that one.
+ *
+ * Layer detection: walks the project for any `**\/__tests__/<layer>/`
+ * directories that contain test files, picks them up. Layers with no
+ * tests are silently skipped.
+ */
+import { defineCommand } from "citty";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { resolve, join, relative } from "node:path";
+import { palette } from "../lib/colors.js";
+import { runTaskList } from "../lib/run-task.js";
+const LAYERS = ["units", "integration", "e2e", "bdd"];
+/** Walk `cwd` looking for `__tests__/<layer>/` dirs that contain test files. */
+function findLayerDirs(cwd, layer, prune) {
+    const hits = [];
+    function walk(dir) {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (prune.has(entry))
+                continue;
+            const full = join(dir, entry);
+            let stat;
+            try {
+                stat = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (!stat.isDirectory())
+                continue;
+            if (entry === "__tests__") {
+                const layerPath = join(full, layer);
+                if (existsSync(layerPath) && statSync(layerPath).isDirectory()) {
+                    hits.push(layerPath);
+                }
+                continue; // never recurse INTO __tests__
+            }
+            walk(full);
+        }
+    }
+    walk(cwd);
+    return hits;
+}
+/** True if `dir` (or any subdir) contains a `*.test.ts` or `.spec.ts` file. */
+function containsTests(dir) {
+    try {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            const full = join(dir, entry);
+            const stat = statSync(full);
+            if (stat.isDirectory()) {
+                if (containsTests(full))
+                    return true;
+            }
+            else if (/\.(test|spec)\.ts$/.test(entry)) {
+                return true;
+            }
+        }
+    }
+    catch {
+        // ignore unreadable dirs
+    }
+    return false;
+}
+const PRUNE = new Set(["node_modules", "dist", ".nwire", ".turbo", "coverage"]);
+export const testCommand = defineCommand({
+    meta: {
+        name: "test",
+        description: "Run vitest layers (units, integration, e2e, bdd)",
+    },
+    args: {
+        layer: {
+            type: "positional",
+            required: false,
+            description: "Run only one layer (units | integration | e2e | bdd); omit for all",
+        },
+        watch: {
+            type: "boolean",
+            description: "Run in watch mode (one layer only)",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const cwd = process.cwd();
+        const requested = args.layer ? [String(args.layer)] : LAYERS;
+        if (args.layer && !LAYERS.includes(args.layer)) {
+            // eslint-disable-next-line no-console
+            console.error(palette.err("nwire test:") + ` unknown layer "${args.layer}". One of: ${LAYERS.join(", ")}`);
+            process.exit(1);
+        }
+        const tasks = [];
+        for (const layer of requested) {
+            const dirs = findLayerDirs(cwd, layer, PRUNE).filter(containsTests);
+            if (dirs.length === 0)
+                continue;
+            const relPaths = dirs.map((d) => relative(cwd, d));
+            const vitestArgs = args.watch ? ["watch", ...relPaths] : ["run", ...relPaths];
+            tasks.push({
+                title: `${layer}  ${palette.dim(`(${dirs.length} dir${dirs.length === 1 ? "" : "s"})`)}`,
+                command: "pnpm",
+                args: ["exec", "vitest", ...vitestArgs],
+                cwd,
+            });
+        }
+        if (tasks.length === 0) {
+            // eslint-disable-next-line no-console
+            console.log(palette.dim(args.layer
+                ? `nwire test: no tests found for layer "${args.layer}".`
+                : "nwire test: no tests found. Add tests under `**/__tests__/{units,integration,e2e,bdd}/`."));
+            process.exit(0);
+        }
+        // Watch mode forwards to vitest as a single passthrough (listr can't
+        // host a long-lived watcher). Pick the first task and exec it.
+        if (args.watch) {
+            const t = tasks[0];
+            // eslint-disable-next-line no-console
+            console.log(palette.dim(`watching ${t.title}…`));
+            const { spawnSync } = await import("node:child_process");
+            const result = spawnSync(t.command, t.args, {
+                stdio: "inherit",
+                cwd: t.cwd,
+            });
+            process.exit(result.status ?? 0);
+        }
+        // Resolve absolute path for the runner (so cwd doesn't matter).
+        resolve(cwd);
+        process.exit(await runTaskList(tasks));
+    },
+});
+//# sourceMappingURL=test.js.map

package/dist/commands/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@nwire/cli` public surface — anything importable. The `nwire` binary
+ * lives at `bin/nwire` (resolves to `dist/cli.js`); this entry is for
+ * consumers writing `nwire.config.ts` files.
+ *
+ *   // nwire.config.ts
+ *   import { defineConfig } from "@nwire/cli"
+ *   export default defineConfig({ appsEntry: "./src/app.ts" })
+ */
+export { defineConfig, type NwireConfig } from "./load-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * `@nwire/cli` public surface — anything importable. The `nwire` binary
+ * lives at `bin/nwire` (resolves to `dist/cli.js`); this entry is for
+ * consumers writing `nwire.config.ts` files.
+ *
+ *   // nwire.config.ts
+ *   import { defineConfig } from "@nwire/cli"
+ *   export default defineConfig({ appsEntry: "./src/app.ts" })
+ */
+export { defineConfig } from "./load-config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC"}

package/dist/kernel-instance.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The CLI's lazy kernel singleton. Commands register their handlers here
+ * once at import time; `runCommand` dispatches through the kernel so
+ * Studio and MCP eventually share the same routing.
+ */
+import { type Kernel } from "@nwire/kernel";
+export declare function kernel(): Kernel;
+//# sourceMappingURL=kernel-instance.d.ts.map

package/dist/kernel-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-instance.d.ts","sourceRoot":"","sources":["../src/kernel-instance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAI1D,wBAAgB,MAAM,IAAI,MAAM,CAG/B"}

package/dist/kernel-instance.js

@@ -0,0 +1,13 @@
+/**
+ * The CLI's lazy kernel singleton. Commands register their handlers here
+ * once at import time; `runCommand` dispatches through the kernel so
+ * Studio and MCP eventually share the same routing.
+ */
+import { createKernel } from "@nwire/kernel";
+let instance;
+export function kernel() {
+    if (!instance)
+        instance = createKernel();
+    return instance;
+}
+//# sourceMappingURL=kernel-instance.js.map

package/dist/kernel-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-instance.js","sourceRoot":"","sources":["../src/kernel-instance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAe,MAAM,eAAe,CAAC;AAE1D,IAAI,QAA4B,CAAC;AAEjC,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,QAAQ;QAAE,QAAQ,GAAG,YAAY,EAAE,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/colors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Centralized color palette. One file so every command speaks the same
+ * visual language — keep adding to the named palette, never let raw ANSI
+ * codes or random chalk imports leak into command files.
+ */
+export declare const c: import("picocolors/types").Colors & {
+    createColors: (enabled?: boolean) => import("picocolors/types").Colors;
+};
+export declare const palette: {
+    brand: import("picocolors/types").Formatter;
+    accent: import("picocolors/types").Formatter;
+    ok: import("picocolors/types").Formatter;
+    warn: import("picocolors/types").Formatter;
+    err: import("picocolors/types").Formatter;
+    dim: import("picocolors/types").Formatter;
+    bold: import("picocolors/types").Formatter;
+    hint: import("picocolors/types").Formatter;
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/lib/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/lib/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,CAAC;0BANG,CAAC;CAMC,CAAC;AAEpB,eAAO,MAAM,OAAO;;;;;;;;;CASnB,CAAC"}

package/dist/lib/colors.js

@@ -0,0 +1,18 @@
+/**
+ * Centralized color palette. One file so every command speaks the same
+ * visual language — keep adding to the named palette, never let raw ANSI
+ * codes or random chalk imports leak into command files.
+ */
+import pc from "picocolors";
+export const c = pc;
+export const palette = {
+    brand: pc.cyan,
+    accent: pc.magenta,
+    ok: pc.green,
+    warn: pc.yellow,
+    err: pc.red,
+    dim: pc.dim,
+    bold: pc.bold,
+    hint: pc.gray,
+};
+//# sourceMappingURL=colors.js.map

package/dist/lib/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/lib/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;AAEpB,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,EAAE,EAAE,CAAC,IAAI;IACd,MAAM,EAAE,EAAE,CAAC,OAAO;IAClB,EAAE,EAAE,EAAE,CAAC,KAAK;IACZ,IAAI,EAAE,EAAE,CAAC,MAAM;IACf,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;CACd,CAAC"}

package/dist/lib/exec.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared process helpers. Commands invoke external tools (vite-node,
+ * vite, oxlint, oxfmt, vitest) through here so signal handling, stdio,
+ * and exit semantics are uniform everywhere.
+ */
+import { type ChildProcess } from "node:child_process";
+export interface ExecOptions {
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /** When true, suppress stdout/stderr inheritance (capture instead). */
+    readonly quiet?: boolean;
+}
+/** Synchronous run; returns the exit code (null → 0). For one-shot ops. */
+export declare function execSync(cmd: string, args: readonly string[], opts?: ExecOptions): number;
+/**
+ * Long-lived spawn that forwards SIGINT/SIGTERM to the child and escalates
+ * to SIGKILL if the child doesn't exit within `gracePeriodMs`. Resolves
+ * with the exit code when the child finally exits.
+ */
+export interface SpawnInteractiveOptions extends ExecOptions {
+    /** Logged once when the child exits via Ctrl+C — defaults to "Stopped." */
+    readonly stoppedMessage?: string;
+    /** Milliseconds before SIGKILL escalation. Default 4000. */
+    readonly gracePeriodMs?: number;
+}
+export declare function spawnInteractive(cmd: string, args: readonly string[], opts?: SpawnInteractiveOptions): {
+    child: ChildProcess;
+    done: Promise<number>;
+};
+//# sourceMappingURL=exec.d.ts.map

package/dist/lib/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIzE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,MAAM,CAO7F;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,GAAE,uBAA4B,GACjC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAyChD"}

package/dist/lib/exec.js

@@ -0,0 +1,58 @@
+/**
+ * Shared process helpers. Commands invoke external tools (vite-node,
+ * vite, oxlint, oxfmt, vitest) through here so signal handling, stdio,
+ * and exit semantics are uniform everywhere.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { palette } from "./colors.js";
+/** Synchronous run; returns the exit code (null → 0). For one-shot ops. */
+export function execSync(cmd, args, opts = {}) {
+    const result = spawnSync(cmd, args, {
+        stdio: opts.quiet ? "pipe" : "inherit",
+        cwd: opts.cwd,
+        env: opts.env ? { ...process.env, ...opts.env } : process.env,
+    });
+    return result.status ?? 0;
+}
+export function spawnInteractive(cmd, args, opts = {}) {
+    const child = spawn(cmd, args, {
+        stdio: "inherit",
+        cwd: opts.cwd,
+        env: opts.env ? { ...process.env, ...opts.env } : process.env,
+    });
+    let shuttingDown = false;
+    const forward = (signal) => {
+        shuttingDown = true;
+        try {
+            child.kill(signal);
+        }
+        catch {
+            // already gone
+        }
+        setTimeout(() => {
+            if (child.exitCode === null && child.signalCode === null) {
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch {
+                    // gone
+                }
+            }
+        }, opts.gracePeriodMs ?? 4000).unref();
+    };
+    process.on("SIGINT", () => forward("SIGINT"));
+    process.on("SIGTERM", () => forward("SIGTERM"));
+    const done = new Promise((resolve) => {
+        child.on("exit", (code, signal) => {
+            if (shuttingDown || signal === "SIGINT" || signal === "SIGTERM") {
+                // eslint-disable-next-line no-console
+                console.log(`\n${palette.dim(opts.stoppedMessage ?? "Stopped.")}`);
+                resolve(0);
+                return;
+            }
+            resolve(code ?? 0);
+        });
+    });
+    return { child, done };
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AASnC,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAuB,EAAE,OAAoB,EAAE;IACnF,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;QAClC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACtC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG;KAC9D,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;AAC5B,CAAC;AAcD,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,IAAuB,EACvB,OAAgC,EAAE;IAElC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;QAC7B,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG;KAC9D,CAAC,CAAC;IAEH,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,OAAO,GAAG,CAAC,MAAsB,EAAE,EAAE;QACzC,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QACD,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBACzD,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACzC,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC3C,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,YAAY,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChE,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;gBACnE,OAAO,CAAC,CAAC,CAAC,CAAC;gBACX,OAAO;YACT,CAAC;YACD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/lib/process-state.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-process state files under `.nwire/processes/`.
+ *
+ * Long-running CLI commands (`dev`, `run` once it shells through kernel)
+ * write one JSON record per child process they manage. `nwire ps` reads
+ * every record back to render a live table; `nwire logs <id>` reads the
+ * companion `.log` file. State files are NOT crash-safe — they're a
+ * developer convenience, not a queue.
+ */
+export type ProcessStatus = "starting" | "running" | "stopping" | "exited" | "crashed";
+export interface ProcessRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly pid: number;
+    readonly status: ProcessStatus;
+    readonly port?: number;
+    readonly startedAt: string;
+    readonly cwd: string;
+    readonly command: string;
+    readonly logPath: string;
+    readonly lastUpdated: string;
+}
+export declare function recordPath(cwd: string, id: string): string;
+export declare function logPath(cwd: string, id: string): string;
+export declare function ensureDir(cwd: string): void;
+export declare function writeRecord(cwd: string, record: ProcessRecord): void;
+export declare function readRecord(cwd: string, id: string): ProcessRecord | undefined;
+export declare function listRecords(cwd: string): ProcessRecord[];
+export declare function removeRecord(cwd: string, id: string): void;
+//# sourceMappingURL=process-state.d.ts.map

package/dist/lib/process-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-state.d.ts","sourceRoot":"","sources":["../../src/lib/process-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAGpE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAO7E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBxD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAM1D"}