@nwire/cli 0.10.1 → 0.11.0

package/dist/cache-runner.js

@@ -31,12 +31,12 @@ async function main() {
     // "App" means either:
     //   - `AppDefinition` (legacy `defineApp(name, { modules })`)
     //   - bootable `App` (modern `createApp({ modules })`)
-    // Resolve the app(s). 0.10 createApp returns an App marked with
-    // `$nwireApp: true`. Recognized export names:
+    // `createApp` returns an App marked with `$nwireApp: true`.
+    // Recognized export names:
     //   - allApps: App[] | apps: App[]
     //   - default: App | App[]
     //   - app: App
-    //   - buildApp(): App | Promise<App>          ← 0.10 factory pattern
+    //   - buildApp(): App | Promise<App>          ← factory pattern
     //   - bootstrap(): { app: App, ... }          ← test-bootstrap pattern
     //   - bootstrap(opts): { app: App, ... }
     //
@@ -143,8 +143,9 @@ async function main() {
     const outDir = resolve(cwd, config.cacheDir ?? ".nwire");
     await writeCache(cache, outDir);
     // eslint-disable-next-line no-console
-    console.log(`nwire cache: wrote ${cache.apps.length} apps, ${cache.modules.length} modules, ` +
+    console.log(`nwire cache: wrote ${cache.apps.length} apps, ${cache.plugins.length} plugins, ` +
         `${cache.actions.length} actions, ${cache.events.length} events, ` +
+        `${cache.hooks.length} hooks, ${cache.sinks.length} sinks, ` +
         `${cache.resolvers.length} resolvers to ${outDir}/`);
     // Some bootstrap functions leave foreign-framework servers (Nest,
     // Fastify) listening even after we tear down the Nwire side. Force
@@ -179,21 +180,22 @@ function findAppInResult(result) {
  */
 function toAppDefinitionShape(x) {
     const a = x;
+    const name = a.appName ?? a.name ?? "app";
     return {
-        name: a.name ?? a.appName ?? "app",
+        // Forward both fields — the scanner reads `appName`; legacy
+        // consumers may still read `name`.
+        name,
+        appName: name,
         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.
+        // Forward operator commands defensively. Consumers who attach a
+        // `commands: defineCommand[]` to their app 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.
+        // Forward the container so the scanner can walk `container.list()`,
+        // resolve the forge dispatcher, and emit DI bindings.
         container: a.container ?? a.runtime?.container,
         runtime: a.runtime,
     };

package/dist/commands/cache.d.ts

@@ -1,6 +1,23 @@
 /**
- * `nwire cache` — rebuild `.nwire/` (manifest + per-kind JSON files).
- * Equivalent to `ensureScanFresh({ force: true })`: skips the
- * fingerprint cheap-path and always re-runs the cache builder.
+ * `nwire cache` — refresh `.nwire/` cache.
+ *
+ *   nwire cache              # rebuild unconditionally (force)
+ *   nwire cache --if-stale   # only rebuild when the source fingerprint moved
+ *
+ * `--if-stale` is the cheap path Studio's middleware uses on every
+ * manifest request: when nothing changed, the fingerprint check skips
+ * the rebuild in a few ms; when it did, the cache catches up before
+ * Studio renders a single page.
  */
-export declare const cacheCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+export declare const cacheCommand: import("citty").CommandDef<{
+    "if-stale": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    quiet: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;

package/dist/commands/cache.js

@@ -1,7 +1,13 @@
 /**
- * `nwire cache` — rebuild `.nwire/` (manifest + per-kind JSON files).
- * Equivalent to `ensureScanFresh({ force: true })`: skips the
- * fingerprint cheap-path and always re-runs the cache builder.
+ * `nwire cache` — refresh `.nwire/` cache.
+ *
+ *   nwire cache              # rebuild unconditionally (force)
+ *   nwire cache --if-stale   # only rebuild when the source fingerprint moved
+ *
+ * `--if-stale` is the cheap path Studio's middleware uses on every
+ * manifest request: when nothing changed, the fingerprint check skips
+ * the rebuild in a few ms; when it did, the cache catches up before
+ * Studio renders a single page.
  */
 import { defineCommand } from "citty";
 import { ensureScanFresh } from "../lib/ensure-scan.js";
@@ -10,8 +16,24 @@ export const cacheCommand = defineCommand({
         name: "cache",
         description: "Rebuild .nwire/ cache (manifest + per-kind JSON)",
     },
-    async run() {
-        const { rebuilt } = ensureScanFresh(process.cwd(), { force: true });
-        process.exit(rebuilt ? 0 : 1);
+    args: {
+        "if-stale": {
+            type: "boolean",
+            description: "Only rebuild when the source fingerprint moved.",
+            default: false,
+        },
+        quiet: {
+            type: "boolean",
+            description: "Suppress 'scanning project…' progress output.",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const force = !args["if-stale"];
+        const result = ensureScanFresh(process.cwd(), { force, quiet: args.quiet });
+        // exit 0 when the cache is current — whether we just rebuilt it or
+        // the cheap-path skipped. exit 1 only when we tried to rebuild and
+        // the builder failed.
+        process.exit(result.rebuilt || !force ? 0 : 1);
     },
 });

package/dist/commands/studio.js

@@ -31,8 +31,7 @@ export const studioCommand = defineCommand({
             }
         };
         studioDir =
-            tryResolveFrom(resolve(process.cwd(), "package.json")) ??
-                tryResolveFrom(import.meta.url);
+            tryResolveFrom(resolve(process.cwd(), "package.json")) ?? tryResolveFrom(import.meta.url);
         if (!studioDir) {
             // eslint-disable-next-line no-console
             console.error(palette.err("nwire studio:") +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/cli",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Nwire CLI — branded TUI. Dev, run, please, build, test, fmt, lint, check, ps, logs, cache, ls, studio. One surface for the whole framework.",
   "keywords": [
     "cli",
@@ -36,9 +36,9 @@
     "listr2": "^9.0.4",
     "picocolors": "^1.1.1",
     "react": "^18.3.1",
-    "@nwire/mcp": "0.10.1",
-    "@nwire/scan": "0.10.1",
-    "@nwire/hooks": "0.10.1"
+    "@nwire/hooks": "0.11.0",
+    "@nwire/scan": "0.11.0",
+    "@nwire/mcp": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",