@nwire/cli 0.7.0 → 0.8.0

package/dist/__tests__/watch.test.js

@@ -0,0 +1,109 @@
+/**
+ * Unit tests for `nwire watch`.
+ *
+ * Same approach as trace.test.ts: command meta, hook-glob → regex
+ * translation, output line formatting, and an integration check of the
+ * wire-discovery helper hitting a stubbed loopback HTTP server.
+ */
+import { describe, it, expect, afterEach } from "vitest";
+import { createServer } from "node:http";
+import { watchCommand, hookGlobToRegex, formatHookStepLine } from "../commands/watch.js";
+import { findWireUrl } from "../lib/wire-discovery.js";
+let server;
+afterEach(async () => {
+    if (server) {
+        await new Promise((res) => server.close(() => res()));
+        server = undefined;
+    }
+    delete process.env.NWIRE_INSPECT_URL;
+});
+describe("nwire watch — command meta", () => {
+    it("registers a `watch` subcommand with a required hook positional", () => {
+        expect(watchCommand.meta).toBeDefined();
+        const meta = watchCommand.meta;
+        expect(meta.name).toBe("watch");
+        const args = watchCommand.args;
+        expect(args.hook.type).toBe("positional");
+        expect(args.hook.required).toBe(true);
+    });
+});
+describe("hookGlobToRegex", () => {
+    it("matches an exact hook name", () => {
+        const r = hookGlobToRegex("plugin.boot:identity");
+        expect(r.test("plugin.boot:identity")).toBe(true);
+        expect(r.test("plugin.boot:rbac")).toBe(false);
+    });
+    it("expands a trailing * to a wildcard", () => {
+        const r = hookGlobToRegex("plugin.boot:*");
+        expect(r.test("plugin.boot:identity")).toBe(true);
+        expect(r.test("plugin.boot:rbac")).toBe(true);
+        expect(r.test("action.dispatch:identity")).toBe(false);
+    });
+    it("escapes regex metacharacters", () => {
+        // `.` is escaped — `plugin.boot:identity` matches but `pluginXboot:identity` doesn't
+        const r = hookGlobToRegex("plugin.boot:identity");
+        expect(r.test("pluginXboot:identity")).toBe(false);
+    });
+    it("anchors the match (no partial matches)", () => {
+        const r = hookGlobToRegex("plugin.boot:identity");
+        expect(r.test("xx plugin.boot:identity yy")).toBe(false);
+    });
+});
+describe("formatHookStepLine", () => {
+    it("includes phase, stepKind, stepName, and duration", () => {
+        const line = formatHookStepLine({
+            kind: "hook.step",
+            hookName: "plugin.boot:identity",
+            phase: "end",
+            stepKind: "provide",
+            stepName: "User",
+            durationMs: 42,
+            occurredAt: "2026-05-29T10:00:00.000Z",
+        });
+        expect(line).toContain("end");
+        expect(line).toContain("provide");
+        expect(line).toContain("User");
+        expect(line).toContain("(42ms)");
+    });
+    it("renders error: <msg> when phase is error", () => {
+        const line = formatHookStepLine({
+            kind: "hook.step",
+            hookName: "plugin.boot:identity",
+            phase: "error",
+            stepKind: "provide",
+            stepName: "User",
+            error: { message: "boom" },
+        });
+        expect(line).toContain("error");
+        expect(line).toContain("boom");
+    });
+    it("accepts a string `error` field", () => {
+        const line = formatHookStepLine({
+            kind: "hook.step",
+            hookName: "h",
+            phase: "error",
+            stepName: "x",
+            error: "literal-string-error",
+        });
+        expect(line).toContain("literal-string-error");
+    });
+});
+describe("findWireUrl — discovery via stubbed wire", () => {
+    it("returns the URL of a stubbed wire that answers /_nwire/events/recent", async () => {
+        server = createServer((req, res) => {
+            if (req.url?.startsWith("/_nwire/events/recent")) {
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end("[]");
+                return;
+            }
+            res.writeHead(404);
+            res.end();
+        });
+        await new Promise((res) => server.listen(0, "127.0.0.1", res));
+        const port = server.address().port;
+        process.env.NWIRE_INSPECT_URL = `http://127.0.0.1:${port}`;
+        const url = await findWireUrl();
+        expect(url).toBe(`http://127.0.0.1:${port}`);
+    });
+});
+//# sourceMappingURL=watch.test.js.map

package/dist/__tests__/watch.test.js.map

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

package/dist/cache-runner.js

@@ -1,21 +1,39 @@
 // Cache runner — invoked by `nwire cache`. Imports the consumer's apps
 // registry (resolved via nwire.config.ts or fallback paths), builds the
 // cache, writes .nwire/.
+//
+// User code follows the bundler-style extensionless-import convention
+// (e.g. `import { x } from './foo'` resolving `./foo.ts`), so we load
+// it through jiti rather than Node's strict ESM loader — jiti gives us
+// TS-on-the-fly + the same resolution semantics the dev server uses.
 import { resolve } from "node:path";
+import { createJiti } from "jiti";
 import { buildCache, writeCache } from "@nwire/scan";
 import { loadConfig, resolveAppsEntry } from "./load-config.js";
 async function main() {
     const cwd = process.cwd();
     const config = await loadConfig(cwd);
     const appsPath = resolveAppsEntry(cwd, config);
+    const jiti = createJiti(cwd, {
+        fsCache: false,
+        moduleCache: false,
+        interopDefault: true,
+    });
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const mod = await import(/* @vite-ignore */ appsPath);
+    const mod = await jiti.import(appsPath);
     // Resolve apps registry in this order:
-    //   1. named export `allApps: AppDefinition[]`
-    //   2. named export `apps: AppDefinition[]`
-    //   3. default export — either AppDefinition[] or a single AppDefinition
-    //   4. named export `app: AppDefinition`
-    //   5. any single exported AppDefinition the module declares
+    //   1. named export `allApps: App[]`
+    //   2. named export `apps: App[]`
+    //   3. default export — either App[] or a single App
+    //   4. named export `app: App`
+    //   5. any single exported App the module declares
+    //
+    // "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.
     let apps = [];
     if (Array.isArray(mod.allApps))
         apps = mod.allApps;
@@ -23,24 +41,24 @@ async function main() {
         apps = mod.apps;
     else if (Array.isArray(mod.default))
         apps = mod.default;
-    else if (isAppDef(mod.default))
+    else if (isAppLike(mod.default))
         apps = [mod.default];
-    else if (isAppDef(mod.app))
+    else if (isAppLike(mod.app))
         apps = [mod.app];
     else {
-        // Sweep all named exports for AppDefinitions.
-        apps = Object.values(mod).filter(isAppDef);
+        apps = Object.values(mod).filter(isAppLike);
     }
     if (apps.length === 0) {
         console.error(`nwire cache: no apps found in ${appsPath}.\n` +
-            `Expected: exported \`apps\`, \`allApps\`, or default-exported AppDefinition.\n` +
+            `Expected: exported \`app\`, \`apps\`, or \`allApps\` — either an AppDefinition (\`defineApp\`) or a runnable App (\`createApp\`).\n` +
             `Optional: nwire.config.ts with { appsEntry: "..." } to point at a custom location.`);
         process.exit(1);
     }
+    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(apps);
+    const cache = buildCache(normalized);
     const outDir = resolve(cwd, config.cacheDir ?? ".nwire");
     await writeCache(cache, outDir);
     // eslint-disable-next-line no-console
@@ -48,8 +66,38 @@ async function main() {
         `${cache.actions.length} actions, ${cache.events.length} events, ` +
         `${cache.resolvers.length} resolvers to ${outDir}/`);
 }
-function isAppDef(x) {
-    return (typeof x === "object" && x !== null && x.$kind === "app-definition");
+function isAppLike(x) {
+    if (typeof x !== "object" || x === null)
+        return false;
+    const a = x;
+    return a.$kind === "app-definition" || a.$nwireApp === true;
+}
+/**
+ * Normalize either flavor of "app" into the AppDefinition shape the
+ * scanner reads. `createApp` returns an `App` with `appName` + the
+ * bootable runtime; `defineApp` returns `AppDefinition` with `name` +
+ * static metadata. Both expose `modules`, which is all we need.
+ */
+function toAppDefinitionShape(x) {
+    const a = x;
+    return {
+        name: a.name ?? a.appName ?? "app",
+        description: a.description,
+        modules: a.modules ?? [],
+        plugins: a.plugins ?? [],
+        // Forward operator commands defensively. Apps registered via
+        // `defineApp` won't carry this; consumers who attach a
+        // `commands: defineCommand[]` to their AppDefinition flow it through to
+        // the scan emitter so `.nwire/commands.json` reflects ops surface.
+        commands: a.commands ?? [],
+        tenantModel: a.tenantModel,
+        tenantKey: a.tenantKey,
+        // Forward the container so the scanner can walk `container.list()` and
+        // emit `.nwire/di.json`. `defineApp` shape may carry it on `.runtime`;
+        // `createApp` exposes it directly.
+        container: a.container ?? a.runtime?.container,
+        runtime: a.runtime,
+    };
 }
 main().catch((err) => {
     console.error(err);

package/dist/cache-runner.js.map

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

package/dist/cli.js

@@ -13,6 +13,7 @@
  *      `kernel.router.register("<name>", handler)` in kernel-instance.ts
  */
 import { defineCommand, runMain } from "citty";
+import { benchCommand } from "./commands/bench.js";
 import { buildCommand } from "./commands/build.js";
 import { cacheCommand } from "./commands/cache.js";
 import { checkCommand } from "./commands/check.js";
@@ -26,9 +27,12 @@ import { logsCommand } from "./commands/logs.js";
 import { lsCommand } from "./commands/ls.js";
 import { pleaseCommand } from "./commands/please.js";
 import { psCommand } from "./commands/ps.js";
+import { replayCommand } from "./commands/replay.js";
 import { runCommand } from "./commands/run.js";
 import { studioCommand } from "./commands/studio.js";
 import { testCommand } from "./commands/test.js";
+import { traceCommand } from "./commands/trace.js";
+import { watchCommand } from "./commands/watch.js";
 const main = defineCommand({
     meta: {
         name: "nwire",
@@ -36,6 +40,7 @@ const main = defineCommand({
         description: "Nwire — event-driven framework. Dev, build, please, ps, logs, studio, …",
     },
     subCommands: {
+        bench: benchCommand,
         build: buildCommand,
         cache: cacheCommand,
         check: checkCommand,
@@ -48,9 +53,12 @@ const main = defineCommand({
         ls: lsCommand,
         please: pleaseCommand,
         ps: psCommand,
+        replay: replayCommand,
         run: runCommand,
         studio: studioCommand,
         test: testCommand,
+        trace: traceCommand,
+        watch: watchCommand,
     },
 });
 // Citty's parent-`run` fires alongside subcommand handlers, which would

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,yEAAyE;KACvF;IACD,WAAW,EAAE;QACX,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,aAAa;QACrB,EAAE,EAAE,SAAS;QACb,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;KAClB;CACF,CAAC,CAAC;AAEH,wEAAwE;AACxE,uEAAuE;AACvE,wEAAwE;AACxE,gCAAgC;AAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC1B,KAAK,eAAe,CAAC,GAAI,CAAC,EAAW,CAAC,CAAC;AACzC,CAAC;KAAM,CAAC;IACN,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,yEAAyE;KACvF;IACD,WAAW,EAAE;QACX,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,aAAa;QACrB,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;KACpB;CACF,CAAC,CAAC;AAEH,wEAAwE;AACxE,uEAAuE;AACvE,wEAAwE;AACxE,gCAAgC;AAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC1B,KAAK,eAAe,CAAC,GAAI,CAAC,EAAW,CAAC,CAAC;AACzC,CAAC;KAAM,CAAC;IACN,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/commands/bench.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `nwire bench` — primitive-level load probe wrapped around k6.
+ *
+ * k6 is a Go binary; we don't bundle it. The command shells out to
+ * whatever `k6` is on PATH and forwards the JSON summary to stdout (or
+ * to `--out`). Five scenarios ship with the repo:
+ *
+ *   - action         POST /api/<action> in a tight loop
+ *   - roundtrip      action → projection visible (tail latency)
+ *   - read           GET against a projection-backed query
+ *   - workflow       event → workflow → cascaded action
+ *   - mixed          60/30/10 read/write/admin blend
+ *
+ * Defaults aim at "honest laptop bench" — 100 VUs, 30s ramp, 2m steady.
+ * Override with `--vus` + `--duration` if you want a quick smoke or a
+ * full soak.
+ *
+ * Discoverability hints:
+ *   - The scripts live at `scripts/k6/<scenario>.js` in the repo. When
+ *     running inside the framework repo we resolve them directly. When
+ *     a consumer runs `nwire bench` in their own project, we still ship
+ *     the scenarios via the published package (resolved from
+ *     `@nwire/cli/scripts/k6/`); the resolver checks both locations.
+ *   - The wire under load isn't booted by this command. The contract
+ *     is: you run your wire in one shell, `nwire bench` in another.
+ *
+ * Examples:
+ *   nwire bench --scenario action --vus 50 --duration 30s
+ *   nwire bench --scenario mixed --base-url http://localhost:3030
+ *   nwire bench --scenario all --out ./bench-results/
+ */
+declare const SCENARIOS: {
+    readonly action: "action-dispatch.js";
+    readonly roundtrip: "event-publish-roundtrip.js";
+    readonly read: "projection-read.js";
+    readonly workflow: "workflow-fire.js";
+    readonly mixed: "mixed-workload.js";
+};
+type ScenarioKey = keyof typeof SCENARIOS;
+/**
+ * The scenario scripts live at `scripts/k6/<file>` in the framework
+ * repo. We resolve by walking up from the supplied roots, in order,
+ * until we find the first `scripts/k6/<file>` that exists.
+ *
+ * Resolution order in production:
+ *   1. CWD upward      — user's project may override
+ *   2. this file's dir — installed in node_modules of a consumer
+ *
+ * Exported so tests can pin the roots to a fixture directory.
+ */
+export declare function resolveScenarioPath(scenario: ScenarioKey, cwd: string, roots?: ReadonlyArray<string>): string | null;
+/** Result of probing `k6 --version`. Exported for testing. */
+export interface K6Probe {
+    readonly installed: boolean;
+    readonly version?: string;
+}
+export declare function probeK6(): K6Probe;
+export interface BenchArgs {
+    readonly scenario: ScenarioKey | "all";
+    readonly vus: number;
+    readonly duration: string;
+    readonly ramp: string;
+    readonly baseUrl: string;
+    readonly out?: string;
+}
+export declare function buildK6Args(opts: {
+    readonly script: string;
+    readonly args: BenchArgs;
+    readonly summaryOut?: string;
+}): string[];
+export declare const benchCommand: import("citty").CommandDef<{
+    scenario: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    vus: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    duration: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    ramp: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    "base-url": {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    out: {
+        type: "string";
+        description: string;
+    };
+}>;
+export {};
+//# sourceMappingURL=bench.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bench.d.ts","sourceRoot":"","sources":["../../src/commands/bench.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,QAAA,MAAM,SAAS;;;;;;CAML,CAAC;AAEX,KAAK,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAI1C;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,MAAM,GAAG,IAAI,CAef;AAcD,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,OAAO,IAAI,OAAO,CAOjC;AAID,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,KAAK,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,MAAM,EAAE,CAWX;AAID,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyGvB,CAAC"}

package/dist/commands/bench.js

@@ -0,0 +1,203 @@
+/**
+ * `nwire bench` — primitive-level load probe wrapped around k6.
+ *
+ * k6 is a Go binary; we don't bundle it. The command shells out to
+ * whatever `k6` is on PATH and forwards the JSON summary to stdout (or
+ * to `--out`). Five scenarios ship with the repo:
+ *
+ *   - action         POST /api/<action> in a tight loop
+ *   - roundtrip      action → projection visible (tail latency)
+ *   - read           GET against a projection-backed query
+ *   - workflow       event → workflow → cascaded action
+ *   - mixed          60/30/10 read/write/admin blend
+ *
+ * Defaults aim at "honest laptop bench" — 100 VUs, 30s ramp, 2m steady.
+ * Override with `--vus` + `--duration` if you want a quick smoke or a
+ * full soak.
+ *
+ * Discoverability hints:
+ *   - The scripts live at `scripts/k6/<scenario>.js` in the repo. When
+ *     running inside the framework repo we resolve them directly. When
+ *     a consumer runs `nwire bench` in their own project, we still ship
+ *     the scenarios via the published package (resolved from
+ *     `@nwire/cli/scripts/k6/`); the resolver checks both locations.
+ *   - The wire under load isn't booted by this command. The contract
+ *     is: you run your wire in one shell, `nwire bench` in another.
+ *
+ * Examples:
+ *   nwire bench --scenario action --vus 50 --duration 30s
+ *   nwire bench --scenario mixed --base-url http://localhost:3030
+ *   nwire bench --scenario all --out ./bench-results/
+ */
+import { defineCommand } from "citty";
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { palette } from "../lib/colors.js";
+const SCENARIOS = {
+    action: "action-dispatch.js",
+    roundtrip: "event-publish-roundtrip.js",
+    read: "projection-read.js",
+    workflow: "workflow-fire.js",
+    mixed: "mixed-workload.js",
+};
+// ─── path resolution ───────────────────────────────────────────────
+/**
+ * The scenario scripts live at `scripts/k6/<file>` in the framework
+ * repo. We resolve by walking up from the supplied roots, in order,
+ * until we find the first `scripts/k6/<file>` that exists.
+ *
+ * Resolution order in production:
+ *   1. CWD upward      — user's project may override
+ *   2. this file's dir — installed in node_modules of a consumer
+ *
+ * Exported so tests can pin the roots to a fixture directory.
+ */
+export function resolveScenarioPath(scenario, cwd, roots) {
+    const file = SCENARIOS[scenario];
+    const effective = roots ?? defaultRoots(cwd);
+    for (const root of effective) {
+        let dir = root;
+        for (let i = 0; i < 8; i++) {
+            const candidate = join(dir, "scripts", "k6", file);
+            if (existsSync(candidate))
+                return candidate;
+            const next = dirname(dir);
+            if (next === dir)
+                break;
+            dir = next;
+        }
+    }
+    return null;
+}
+function defaultRoots(cwd) {
+    let here;
+    try {
+        here = dirname(fileURLToPath(import.meta.url));
+    }
+    catch {
+        here = cwd;
+    }
+    return [cwd, here];
+}
+export function probeK6() {
+    const r = spawnSync("k6", ["version"], { encoding: "utf8" });
+    if (r.status === 0 && r.stdout) {
+        const first = r.stdout.split("\n")[0]?.trim();
+        return { installed: true, version: first };
+    }
+    return { installed: false };
+}
+export function buildK6Args(opts) {
+    const env = [
+        "-e", `VUS=${opts.args.vus}`,
+        "-e", `DURATION=${opts.args.duration}`,
+        "-e", `RAMP=${opts.args.ramp}`,
+        "-e", `BASE_URL=${opts.args.baseUrl}`,
+    ];
+    const out = opts.summaryOut
+        ? ["--summary-export", opts.summaryOut]
+        : [];
+    return ["run", ...env, ...out, opts.script];
+}
+// ─── command ───────────────────────────────────────────────────────
+export const benchCommand = defineCommand({
+    meta: {
+        name: "bench",
+        description: "Run a k6 load probe against a Nwire wire (action / roundtrip / read / workflow / mixed)",
+    },
+    args: {
+        scenario: {
+            type: "string",
+            description: "action | roundtrip | read | workflow | mixed | all",
+            default: "action",
+        },
+        vus: {
+            type: "string",
+            description: "Peak virtual users",
+            default: "100",
+        },
+        duration: {
+            type: "string",
+            description: "Sustained-load duration (k6 timespan, e.g. 30s, 2m)",
+            default: "2m",
+        },
+        ramp: {
+            type: "string",
+            description: "Ramp-up duration before steady state",
+            default: "30s",
+        },
+        "base-url": {
+            type: "string",
+            description: "URL of the wire under load",
+            default: "http://localhost:3030",
+        },
+        out: {
+            type: "string",
+            description: "Directory for per-scenario summary JSON (default: stdout only)",
+        },
+    },
+    async run({ args }) {
+        const probe = probeK6();
+        if (!probe.installed) {
+            console.error(palette.err("nwire bench: k6 is not installed."));
+            console.error(palette.hint("Install with `brew install k6` (macOS) or see https://k6.io/docs/get-started/installation/"));
+            process.exit(1);
+        }
+        const scenario = String(args.scenario);
+        const valid = ["all", ...Object.keys(SCENARIOS)];
+        if (!valid.includes(scenario)) {
+            console.error(palette.err(`nwire bench: unknown scenario "${scenario}".`));
+            console.error(palette.hint(`Valid: ${valid.join(", ")}`));
+            process.exit(1);
+        }
+        const benchArgs = {
+            scenario,
+            vus: Number(args.vus),
+            duration: String(args.duration),
+            ramp: String(args.ramp),
+            baseUrl: String(args["base-url"]),
+            out: typeof args.out === "string" ? args.out : undefined,
+        };
+        if (Number.isNaN(benchArgs.vus) || benchArgs.vus < 1) {
+            console.error(palette.err("nwire bench: --vus must be a positive integer."));
+            process.exit(1);
+        }
+        if (benchArgs.out)
+            mkdirSync(resolve(process.cwd(), benchArgs.out), { recursive: true });
+        const scenarios = scenario === "all" ? Object.keys(SCENARIOS) : [scenario];
+        console.log("");
+        console.log(`  ${palette.brand("nwire bench")}  ${palette.dim(`(k6 ${probe.version ?? ""})`)}`);
+        console.log(palette.dim(`  scenarios: ${scenarios.join(", ")}`));
+        console.log(palette.dim(`  vus=${benchArgs.vus}  ramp=${benchArgs.ramp}  duration=${benchArgs.duration}  base=${benchArgs.baseUrl}`));
+        console.log("");
+        let failures = 0;
+        for (const s of scenarios) {
+            const script = resolveScenarioPath(s, process.cwd());
+            if (!script) {
+                console.error(palette.err(`nwire bench: cannot locate scripts/k6/${SCENARIOS[s]}`));
+                console.error(palette.hint("Run from inside a Nwire repo, or copy scripts/k6/ into your project."));
+                failures++;
+                continue;
+            }
+            const summaryOut = benchArgs.out
+                ? resolve(process.cwd(), benchArgs.out, `${s}.json`)
+                : undefined;
+            const k6Args = buildK6Args({ script, args: benchArgs, summaryOut });
+            console.log(palette.dim(`  → k6 ${k6Args.join(" ")}`));
+            const result = spawnSync("k6", k6Args, { stdio: "inherit" });
+            if (result.status !== 0) {
+                console.error(palette.warn(`  scenario "${s}" exited with status ${result.status ?? "?"} (likely SLO threshold miss)`));
+                failures++;
+            }
+        }
+        if (failures > 0) {
+            console.log("");
+            console.log(palette.warn(`  ${failures} scenario(s) flagged an issue — see k6 output above.`));
+            process.exit(1);
+        }
+        process.exit(0);
+    },
+});
+//# sourceMappingURL=bench.js.map

package/dist/commands/bench.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,eAAO,MAAM,UAAU,qDAuJrB,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,eAAO,MAAM,UAAU,qDAkKrB,CAAC"}