@nwire/cli 0.7.1 → 0.8.0

package/dist/commands/watch.js

@@ -0,0 +1,152 @@
+/**
+ * `nwire watch <hook> [--limit <N>]`
+ *
+ * Streams `/_nwire/telemetry/stream` from the running wire and filters
+ * for `hook.step` records whose `hookName` matches the requested glob.
+ * Globs use a simple `*` → `.*` translation, so:
+ *
+ *   • `plugin.boot:identity`  matches exactly that hook
+ *   • `plugin.boot:*`         matches every plugin.boot hook
+ *
+ * One line per step:
+ *
+ *   HH:MM:SS.mmm  <phase>  <stepKind>  <stepName>  (Xms)  [error: msg]
+ *
+ * Phase colour: start=dim, end=green, error=red.
+ */
+import { defineCommand } from "citty";
+import { palette } from "../lib/colors.js";
+import { findWireUrl } from "../lib/wire-discovery.js";
+import { SseParser } from "../lib/sse.js";
+// ─── Helpers (exported for testing) ────────────────────────────────
+/**
+ * Translate a `*`-glob into a `^…$` anchored RegExp. No other glob
+ * features (`?`, character classes) are supported — keeping the surface
+ * tight matches the rest of the framework's "one obvious way" stance.
+ */
+export function hookGlobToRegex(glob) {
+    const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`^${escaped.replace(/\*/g, ".*")}$`);
+}
+const PAD2 = (n) => n.toString().padStart(2, "0");
+const PAD3 = (n) => n.toString().padStart(3, "0");
+function formatTimestamp(at) {
+    const d = at === undefined ? new Date() : new Date(at);
+    if (Number.isNaN(d.getTime()))
+        return "??:??:??.???";
+    return `${PAD2(d.getHours())}:${PAD2(d.getMinutes())}:${PAD2(d.getSeconds())}.${PAD3(d.getMilliseconds())}`;
+}
+export function formatHookStepLine(step) {
+    const time = palette.dim(formatTimestamp(step.occurredAt));
+    const rawPhase = (step.phase ?? "").padEnd(5, " ");
+    const phase = step.phase === "end" ? palette.ok(rawPhase) :
+        step.phase === "error" ? palette.err(rawPhase) :
+            palette.dim(rawPhase);
+    const stepKind = (step.stepKind ?? "-").padEnd(10, " ");
+    const stepName = step.stepName ?? "-";
+    const dur = typeof step.durationMs === "number"
+        ? palette.dim(`(${step.durationMs}ms)`)
+        : "";
+    let errPart = "";
+    if (step.error) {
+        const msg = typeof step.error === "string" ? step.error : step.error.message ?? "error";
+        errPart = "  " + palette.err(`[error: ${msg}]`);
+    }
+    return `${time}  ${phase}  ${stepKind}  ${stepName}  ${dur}${errPart}`.trimEnd();
+}
+async function streamOnce(opts) {
+    const res = await fetch(`${opts.url}/_nwire/telemetry/stream`, {
+        headers: { accept: "text/event-stream" },
+        signal: opts.signal,
+    });
+    if (!res.ok || !res.body)
+        throw new Error(`stream returned ${res.status}`);
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    const parser = new SseParser();
+    let printed = 0;
+    while (!opts.signal.aborted) {
+        const { value, done } = await reader.read();
+        if (done)
+            return false;
+        const chunk = decoder.decode(value, { stream: true });
+        for (const payload of parser.feed(chunk)) {
+            const rec = payload;
+            if (rec.kind !== "hook.step")
+                continue;
+            const step = rec;
+            if (!opts.match.test(step.hookName))
+                continue;
+            opts.onLine(formatHookStepLine(step));
+            printed += 1;
+            if (opts.limit && printed >= opts.limit)
+                return true;
+        }
+    }
+    return false;
+}
+export const watchCommand = defineCommand({
+    meta: {
+        name: "watch",
+        description: "Tail hook-step telemetry for a hook (supports * wildcards)",
+    },
+    args: {
+        hook: {
+            type: "positional",
+            required: true,
+            description: "Hook name to watch (e.g. plugin.boot:identity, or plugin.boot:*)",
+        },
+        limit: {
+            type: "string",
+            description: "Stop after N matching steps",
+            required: false,
+        },
+    },
+    async run({ args }) {
+        const url = await findWireUrl();
+        if (!url) {
+            console.error(palette.err("nwire watch:") +
+                " no running wire found. Start one with `nwire dev`, or set NWIRE_INSPECT_URL.");
+            process.exit(1);
+        }
+        const hookArg = String(args.hook);
+        const match = hookGlobToRegex(hookArg);
+        const limit = typeof args.limit === "string" ? Number(args.limit) : undefined;
+        const ctrl = new AbortController();
+        const stop = () => ctrl.abort();
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+        console.log(palette.dim(`# watching ${hookArg} on ${url}/_nwire/telemetry/stream — Ctrl+C to exit`));
+        while (!ctrl.signal.aborted) {
+            try {
+                const limitReached = await streamOnce({
+                    url,
+                    match,
+                    limit,
+                    signal: ctrl.signal,
+                    onLine: (l) => console.log(l),
+                });
+                if (limitReached)
+                    process.exit(0);
+                // Stream ended cleanly (EOF) — reconnect.
+            }
+            catch (err) {
+                if (ctrl.signal.aborted)
+                    break;
+                const msg = err instanceof Error ? err.message : String(err);
+                console.log(palette.warn(`# disconnected (${msg}) — reconnecting in 1s…`));
+            }
+            await sleep(1_000, ctrl.signal);
+        }
+        process.exit(0);
+    },
+});
+function sleep(ms, signal) {
+    return new Promise((res) => {
+        if (signal.aborted)
+            return res();
+        const t = setTimeout(() => res(), ms);
+        signal.addEventListener("abort", () => { clearTimeout(t); res(); }, { once: true });
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoBvC,sEAAsE;AAEtE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1D,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAE1D,SAAS,eAAe,CAAC,EAA+B;IACtD,MAAM,CAAC,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,cAAc,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,KAAK,KAAK,CAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,MAAM,GAAG,GACP,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QACjC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC;IACT,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;QACxF,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,IAAI,KAAK,KAAK,KAAK,QAAQ,KAAK,QAAQ,KAAK,GAAG,GAAG,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;AACnF,CAAC;AAYD,KAAK,UAAU,UAAU,CAAC,IAAmB;IAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,0BAA0B,EAAE;QAC7D,OAAO,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE;QACxC,MAAM,EAAG,IAAI,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAI,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAI,IAAI,SAAS,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,OAAuB,CAAC;YACpC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,GAAmC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAC9C,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,CAAC;YACb,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,IAAI,EAAE;QACJ,IAAI,EAAS,OAAO;QACpB,WAAW,EAAE,4DAA4D;KAC1E;IACD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,IAAI,EAAS,YAAY;YACzB,QAAQ,EAAK,IAAI;YACjB,WAAW,EAAE,kEAAkE;SAChF;QACD,KAAK,EAAE;YACL,IAAI,EAAS,QAAQ;YACrB,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAK,KAAK;SACnB;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,GAAG,GAAG,MAAM,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CACX,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBACzB,+EAA+E,CAClF,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAK,eAAe,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,KAAK,GAAK,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,IAAI,GAAM,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAG,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAE5B,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,OAAO,GAAG,2CAA2C,CAAC,CACxF,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC;oBACpC,GAAG;oBACH,KAAK;oBACL,KAAK;oBACL,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;iBAC9B,CAAC,CAAC;gBACH,IAAI,YAAY;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClC,0CAA0C;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,MAAM;gBAC/B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,GAAG,yBAAyB,CAAC,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,KAAK,CAAC,EAAU,EAAE,MAAmB;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/dev-entry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `resolveDevEntry` — figure out how to boot the project's dev server.
+ *
+ * Nwire projects come in three shapes, and `nwire dev` needs to work on all
+ * of them out of the box (no `nwire.config.ts` required):
+ *
+ *   1. Multi-wire monorepo style — `apps/dev-all/run.ts` runs every app.
+ *   2. Single wire under `apps/` — `apps/<name>/{run,main}.ts`.
+ *   3. Single-app style — `app/{main,run,index}.ts` (the small-example shape
+ *      used by hello-world / todo-app / moderation-queue).
+ *   4. Fallback — `package.json` exposes a `scripts.dev` entry; we honor it.
+ *
+ * Returns a discriminated value the caller can spawn directly. The CLI prints
+ * a banner before handing off, so the kind + label flow through to the user.
+ */
+export type DevEntry = {
+    readonly kind: "vite-node";
+    /** Absolute path to the .ts entry file. */
+    readonly entry: string;
+    /** Project-relative path of `entry`, for the banner. */
+    readonly rel: string;
+    /** Subtitle shown in the banner: dev-all | <wire-name> | app. */
+    readonly label: string;
+} | {
+    readonly kind: "npm-script";
+    /** Script name in package.json (usually "dev"). */
+    readonly script: string;
+    /** Resolved command string from package.json (for the banner). */
+    readonly command: string;
+};
+/**
+ * Walks the resolution order described above. Returns the first hit, or
+ * undefined when no recognizable entry exists. The caller should error out
+ * with a clear message listing what was tried.
+ */
+export declare function resolveDevEntry(cwd: string): DevEntry | undefined;
+/** Same fallback list rendered for the "no dev entry found" error message. */
+export declare function devEntryCandidates(): readonly string[];
+//# sourceMappingURL=dev-entry.d.ts.map

package/dist/lib/dev-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-entry.d.ts","sourceRoot":"","sources":["../../src/lib/dev-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,MAAM,QAAQ,GAChB;IACE,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAI,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAI,YAAY,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAyDjE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAUtD"}

package/dist/lib/dev-entry.js

@@ -0,0 +1,102 @@
+/**
+ * `resolveDevEntry` — figure out how to boot the project's dev server.
+ *
+ * Nwire projects come in three shapes, and `nwire dev` needs to work on all
+ * of them out of the box (no `nwire.config.ts` required):
+ *
+ *   1. Multi-wire monorepo style — `apps/dev-all/run.ts` runs every app.
+ *   2. Single wire under `apps/` — `apps/<name>/{run,main}.ts`.
+ *   3. Single-app style — `app/{main,run,index}.ts` (the small-example shape
+ *      used by hello-world / todo-app / moderation-queue).
+ *   4. Fallback — `package.json` exposes a `scripts.dev` entry; we honor it.
+ *
+ * Returns a discriminated value the caller can spawn directly. The CLI prints
+ * a banner before handing off, so the kind + label flow through to the user.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { relative, resolve } from "node:path";
+/**
+ * Walks the resolution order described above. Returns the first hit, or
+ * undefined when no recognizable entry exists. The caller should error out
+ * with a clear message listing what was tried.
+ */
+export function resolveDevEntry(cwd) {
+    // 1. dev-all (multi-wire dev topology)
+    const devAll = resolve(cwd, "apps/dev-all/run.ts");
+    if (existsSync(devAll)) {
+        return { kind: "vite-node", entry: devAll, rel: relPath(cwd, devAll), label: "dev-all" };
+    }
+    // 2. Single wire under apps/ — accept run.ts OR main.ts.
+    const appsDir = resolve(cwd, "apps");
+    if (existsSync(appsDir)) {
+        // Cheap enumeration — projects rarely have more than a few entries here.
+        // We don't need detectProject (avoids the import cycle and keeps this
+        // helper focused).
+        try {
+            const wires = [];
+            for (const ent of readdirSync(appsDir, { withFileTypes: true })) {
+                if (!ent.isDirectory())
+                    continue;
+                const a = resolve(appsDir, ent.name, "run.ts");
+                const b = resolve(appsDir, ent.name, "main.ts");
+                if (existsSync(a) || existsSync(b))
+                    wires.push(ent.name);
+            }
+            if (wires.length === 1) {
+                const only = wires[0];
+                for (const f of ["run.ts", "main.ts"]) {
+                    const p = resolve(appsDir, only, f);
+                    if (existsSync(p)) {
+                        return { kind: "vite-node", entry: p, rel: relPath(cwd, p), label: only };
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore — fall through to app/ and scripts
+        }
+    }
+    // 3. Single-app folder — app/main.ts, app/run.ts, app/index.ts.
+    for (const f of ["app/main.ts", "app/run.ts", "app/index.ts"]) {
+        const p = resolve(cwd, f);
+        if (existsSync(p)) {
+            return { kind: "vite-node", entry: p, rel: relPath(cwd, p), label: "app" };
+        }
+    }
+    // 4. package.json scripts.dev fallback.
+    const pj = resolve(cwd, "package.json");
+    if (existsSync(pj)) {
+        try {
+            const raw = readFileSync(pj, "utf8");
+            const parsed = JSON.parse(raw);
+            const command = parsed.scripts?.dev;
+            if (command)
+                return { kind: "npm-script", script: "dev", command };
+        }
+        catch {
+            // ignore
+        }
+    }
+    return undefined;
+}
+/** Same fallback list rendered for the "no dev entry found" error message. */
+export function devEntryCandidates() {
+    return [
+        "apps/dev-all/run.ts",
+        "apps/<wire>/run.ts",
+        "apps/<wire>/main.ts",
+        "app/main.ts",
+        "app/run.ts",
+        "app/index.ts",
+        "package.json scripts.dev",
+    ];
+}
+function relPath(cwd, abs) {
+    // `path.relative` already handles the cross-platform `path.sep` story
+    // (Windows backslashes vs POSIX forward slashes) and the
+    // "abs is outside cwd" case (returns a `..` chain) — no manual
+    // `startsWith(cwd + "/")` math needed.
+    const rel = relative(cwd, abs);
+    return rel === "" ? abs : rel;
+}
+//# sourceMappingURL=dev-entry.js.map

package/dist/lib/dev-entry.js.map

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

package/dist/lib/exec.d.ts

@@ -2,6 +2,13 @@
  * 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.
+ *
+ * Windows note: `pnpm`, `vite`, `docker`, `tail`, and most other CLIs we
+ * shell out to ship as `.cmd` shims on Windows. `child_process.spawn`
+ * only resolves `.exe` extensions by default, so without `shell: true`
+ * every spawn call ENOENTs on Win. The `IS_WIN` constant + `shell` flag
+ * on every spawn site keeps POSIX behavior identical (no shell) while
+ * making Windows work transparently.
  */
 import { type ChildProcess } from "node:child_process";
 export interface ExecOptions {

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

@@ -1 +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"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOzE,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,CAQ7F;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,CA+ChD"}

package/dist/lib/exec.js

@@ -2,15 +2,25 @@
  * 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.
+ *
+ * Windows note: `pnpm`, `vite`, `docker`, `tail`, and most other CLIs we
+ * shell out to ship as `.cmd` shims on Windows. `child_process.spawn`
+ * only resolves `.exe` extensions by default, so without `shell: true`
+ * every spawn call ENOENTs on Win. The `IS_WIN` constant + `shell` flag
+ * on every spawn site keeps POSIX behavior identical (no shell) while
+ * making Windows work transparently.
  */
 import { spawn, spawnSync } from "node:child_process";
 import { palette } from "./colors.js";
+/** True on Windows. Drives the shell-fallback toggle on every spawn. */
+const IS_WIN = process.platform === "win32";
 /** 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,
+        shell: IS_WIN,
     });
     return result.status ?? 0;
 }
@@ -19,6 +29,7 @@ export function spawnInteractive(cmd, args, opts = {}) {
         stdio: "inherit",
         cwd: opts.cwd,
         env: opts.env ? { ...process.env, ...opts.env } : process.env,
+        shell: IS_WIN,
     });
     let shuttingDown = false;
     const forward = (signal) => {
@@ -32,7 +43,14 @@ export function spawnInteractive(cmd, args, opts = {}) {
         setTimeout(() => {
             if (child.exitCode === null && child.signalCode === null) {
                 try {
-                    child.kill("SIGKILL");
+                    // SIGKILL doesn't exist as a signal on Windows. Node maps it to
+                    // TerminateProcess but emits a deprecation-style ENOSYS in some
+                    // versions; passing no argument means "default terminate," which
+                    // on Win is the same TerminateProcess we want.
+                    if (IS_WIN)
+                        child.kill();
+                    else
+                        child.kill("SIGKILL");
                 }
                 catch {
                     // gone

package/dist/lib/exec.js.map

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

package/dist/lib/run-task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-task.d.ts","sourceRoot":"","sources":["../../src/lib/run-task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAkBD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkChF"}
+{"version":3,"file":"run-task.d.ts","sourceRoot":"","sources":["../../src/lib/run-task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAmBD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoChF"}

package/dist/lib/run-task.js

@@ -6,6 +6,8 @@
 import { spawn } from "node:child_process";
 import { Listr } from "listr2";
 import { palette } from "./colors.js";
+/** True on Windows — toggles `shell:true` on spawn so `.cmd` shims resolve. */
+const IS_WIN = process.platform === "win32";
 /**
  * Run a single command and resolve with its exit code. The command's
  * stdout/stderr are captured and discarded — listr2 owns the visual
@@ -17,6 +19,7 @@ export function runCommand(spec) {
         const child = spawn(spec.command, spec.args, {
             cwd: spec.cwd,
             stdio: ["ignore", "pipe", "pipe"],
+            shell: IS_WIN,
         });
         const stdoutChunks = [];
         const stderrChunks = [];
@@ -44,7 +47,9 @@ export async function runTaskList(tasks) {
                 aggregate = aggregate || result.code;
                 const detail = result.stderr || result.stdout || `exit ${result.code}`;
                 if (t.skipOnFail) {
-                    taskCtx.skip(detail.trim().split("\n")[0]);
+                    // CRLF-safe split — child stdout on Windows ends with \r\n,
+                    // which would leave a trailing \r on the printed hint.
+                    taskCtx.skip(detail.trim().split(/\r?\n/)[0]);
                     return;
                 }
                 throw new Error(detail.trim());

package/dist/lib/run-task.js.map

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

package/dist/lib/sse.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tiny SSE parser. The wire emits Server-Sent-Events frames of the form
+ *
+ *     data: {"messageId":"…",…}\n
+ *     \n
+ *
+ * — one JSON object per `data:` line, frames separated by a blank line.
+ * We also tolerate multi-line `data:` payloads (per the SSE spec joined
+ * with `\n`) and ignore comment frames (lines starting with `:`) so
+ * heartbeats don't pollute output.
+ *
+ * The parser is fed arbitrary chunks of UTF-8 text via `.feed(chunk)`
+ * and yields the parsed JSON payload for every complete frame. Partial
+ * frames are kept in an internal buffer until the trailing `\n\n` arrives.
+ */
+export declare class SseParser {
+    private buffer;
+    /**
+     * Feed a new chunk of decoded text. Yields one parsed JSON payload
+     * per complete frame. Partial frames stay buffered for the next call.
+     */
+    feed(chunk: string): unknown[];
+}
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/lib/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAM;IAEpB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;CAa/B"}

package/dist/lib/sse.js

@@ -0,0 +1,63 @@
+/**
+ * Tiny SSE parser. The wire emits Server-Sent-Events frames of the form
+ *
+ *     data: {"messageId":"…",…}\n
+ *     \n
+ *
+ * — one JSON object per `data:` line, frames separated by a blank line.
+ * We also tolerate multi-line `data:` payloads (per the SSE spec joined
+ * with `\n`) and ignore comment frames (lines starting with `:`) so
+ * heartbeats don't pollute output.
+ *
+ * The parser is fed arbitrary chunks of UTF-8 text via `.feed(chunk)`
+ * and yields the parsed JSON payload for every complete frame. Partial
+ * frames are kept in an internal buffer until the trailing `\n\n` arrives.
+ */
+export class SseParser {
+    buffer = "";
+    /**
+     * Feed a new chunk of decoded text. Yields one parsed JSON payload
+     * per complete frame. Partial frames stay buffered for the next call.
+     */
+    feed(chunk) {
+        this.buffer += chunk.replace(/\r\n/g, "\n");
+        const out = [];
+        let idx;
+        // Frames are terminated by a blank line (`\n\n`).
+        while ((idx = this.buffer.indexOf("\n\n")) !== -1) {
+            const frame = this.buffer.slice(0, idx);
+            this.buffer = this.buffer.slice(idx + 2);
+            const payload = parseFrame(frame);
+            if (payload !== undefined)
+                out.push(payload);
+        }
+        return out;
+    }
+}
+function parseFrame(frame) {
+    const lines = frame.split("\n");
+    const dataParts = [];
+    for (const raw of lines) {
+        if (raw.length === 0)
+            continue;
+        // SSE comment / heartbeat — drop silently.
+        if (raw.startsWith(":"))
+            continue;
+        if (raw.startsWith("data:")) {
+            // The spec strips one leading space after the colon if present.
+            const body = raw.slice(5).replace(/^ /, "");
+            dataParts.push(body);
+        }
+        // event:/id:/retry: lines are ignored — we only care about payloads.
+    }
+    if (dataParts.length === 0)
+        return undefined;
+    const joined = dataParts.join("\n");
+    try {
+        return JSON.parse(joined);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/lib/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/lib/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IACZ,MAAM,GAAG,EAAE,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAc,EAAE,CAAC;QAC1B,IAAI,GAAW,CAAC;QAChB,kDAAkD;QAClD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,OAAO,KAAK,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC/B,2CAA2C;QAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,gEAAgE;YAChE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,qEAAqE;IACvE,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/lib/wire-discovery.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Find the base URL of a running wire, or null if none is discoverable.
+ *
+ * Honours `NWIRE_INSPECT_URL` (trusted blindly — caller asked for it).
+ * Otherwise probes the canonical port list and returns the first wire
+ * whose `/_nwire/events/recent?limit=1` responds with a JSON array.
+ */
+export declare function findWireUrl(): Promise<string | null>;
+//# sourceMappingURL=wire-discovery.d.ts.map

package/dist/lib/wire-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-discovery.d.ts","sourceRoot":"","sources":["../../src/lib/wire-discovery.ts"],"names":[],"mappings":"AAsBA;;;;;;GAMG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1D"}

package/dist/lib/wire-discovery.js

@@ -0,0 +1,82 @@
+/**
+ * Wire discovery — find a running Nwire wire on localhost.
+ *
+ * Mirrors the pattern used by Studio (`packages/nwire-studio/vite.config.ts`)
+ * and the MCP inspect tools (`packages/nwire-mcp/src/inspect.ts`):
+ *
+ *   1. Honour the `NWIRE_INSPECT_URL` env var if set.
+ *   2. Otherwise probe a small fixed list of ports for a wire that
+ *      answers `GET /_nwire/events/recent?limit=1` with a JSON array.
+ *
+ * Both `nwire trace` and `nwire watch` consume this helper.
+ */
+import { createConnection } from "node:net";
+import { request as httpRequest } from "node:http";
+const DEFAULT_PROBE_PORTS = [
+    3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010,
+    3030, 3040, 3050, 4000, 8080,
+];
+const PROBE_TIMEOUT_MS = 200;
+/**
+ * Find the base URL of a running wire, or null if none is discoverable.
+ *
+ * Honours `NWIRE_INSPECT_URL` (trusted blindly — caller asked for it).
+ * Otherwise probes the canonical port list and returns the first wire
+ * whose `/_nwire/events/recent?limit=1` responds with a JSON array.
+ */
+export async function findWireUrl() {
+    const override = process.env.NWIRE_INSPECT_URL;
+    if (override && override.length > 0) {
+        return override.replace(/\/$/, "");
+    }
+    for (const port of DEFAULT_PROBE_PORTS) {
+        if (await isNwireWire(port, PROBE_TIMEOUT_MS)) {
+            return `http://127.0.0.1:${port}`;
+        }
+    }
+    return null;
+}
+/**
+ * Validate that a port answers `/_nwire/events/recent?limit=1` with a
+ * JSON array body. TCP-only checks were too permissive — unrelated
+ * services on the same port would slip through.
+ */
+function isNwireWire(port, timeoutMs) {
+    return new Promise((resolveProbe) => {
+        const sock = createConnection({ host: "127.0.0.1", port });
+        sock.setTimeout(timeoutMs, () => {
+            sock.destroy();
+            resolveProbe(false);
+        });
+        sock.once("error", () => resolveProbe(false));
+        sock.once("connect", () => {
+            sock.destroy();
+            const req = httpRequest({
+                host: "127.0.0.1",
+                port,
+                path: "/_nwire/events/recent?limit=1",
+                method: "GET",
+            }, (res) => {
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    return resolveProbe(false);
+                }
+                let buf = "";
+                res.setEncoding("utf8");
+                res.on("data", (c) => {
+                    buf += c;
+                    if (buf.length > 1024)
+                        res.destroy();
+                });
+                res.on("end", () => resolveProbe(buf.trimStart().startsWith("[")));
+            });
+            req.setTimeout(timeoutMs, () => {
+                req.destroy();
+                resolveProbe(false);
+            });
+            req.once("error", () => resolveProbe(false));
+            req.end();
+        });
+    });
+}
+//# sourceMappingURL=wire-discovery.js.map