@nwire/scan 0.12.0 → 0.13.0

package/dist/telemetry-runs.js

@@ -0,0 +1,87 @@
+/**
+ * Disk readers for past telemetry runs — the `.nwire/telemetry/*.jsonl` files
+ * the telemetry reporter writes per run.
+ *
+ * These live in `@nwire/scan` because both Studio (the standalone Vite
+ * middleware) and the `nwire` CLI's one-Vite dev host need to serve telemetry
+ * history off disk, and both already depend on `@nwire/scan`. Keeping the reader
+ * here avoids a UI-package → CLI import edge (the CLI must never depend on
+ * `@nwire/studio`) and avoids duplicating the parse/guard logic in two places.
+ *
+ * All functions are synchronous, side-effect-free beyond filesystem reads, and
+ * take an explicit project `cwd` so callers can target any root without touching
+ * process state.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * List `.nwire/telemetry/*.jsonl` files for a project, newest first.
+ *
+ * Entry ids are the bare filename minus the `.jsonl` extension. Run ids are
+ * ISO-timestamp-prefixed by the telemetry reporter, so lexical descending order
+ * is chronological descending order. Missing dir or unreadable entries degrade
+ * to an empty list rather than throwing.
+ */
+export function listTelemetryRuns(cwd) {
+    const dir = resolve(cwd, ".nwire", "telemetry");
+    if (!existsSync(dir))
+        return [];
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const runs = [];
+    for (const name of names) {
+        if (!name.endsWith(".jsonl"))
+            continue;
+        const file = resolve(dir, name);
+        try {
+            const st = statSync(file);
+            runs.push({ id: name.slice(0, -6), size: st.size, mtime: st.mtime.toISOString() });
+        }
+        catch {
+            // race: file vanished between readdir and stat — skip
+        }
+    }
+    // Lexical descending = newest first (id starts with ISO timestamp).
+    runs.sort((a, b) => b.id.localeCompare(a.id));
+    return runs;
+}
+/**
+ * Read `.nwire/telemetry/<runId>.jsonl` and return each line parsed as JSON.
+ *
+ * Security: `runId` must not contain path separators or `..` — the function
+ * returns an empty array for any id that fails this check. Blank lines and lines
+ * that are not valid JSON are silently skipped.
+ */
+export function readTelemetryRun(cwd, runId) {
+    // Guard: never let runId escape the telemetry dir.
+    if (runId.includes("/") || runId.includes("\\") || runId.includes(".."))
+        return [];
+    const file = resolve(cwd, ".nwire", "telemetry", `${runId}.jsonl`);
+    if (!existsSync(file))
+        return [];
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            // unparseable line — skip
+        }
+    }
+    return out;
+}

package/dist/topology.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Topology — re-exported from `@nwire/telemetry`.
+ *
+ * The live-runtime capture (`captureTopology`) and the `Topology` shape moved to
+ * `@nwire/telemetry` (a runtime lib) so a running app can self-emit its topology
+ * to `.nwire/topology.json` without the scanner. The scanner keeps this barrel
+ * so its instance-based manifest path and existing imports resolve unchanged;
+ * `buildManifest` folds the emitted file when no live instance is given.
+ */
+export { captureTopology, type Topology, type CapabilityInfo, type StageInfo, type PluginInfo, type BindingInfo, type HandlerInfo, type HookInfo, type ContributionInfo, type TriggerInfo, type AppInfo, type RouteInfo, } from "@nwire/telemetry";

package/dist/topology.js

@@ -0,0 +1,10 @@
+/**
+ * Topology — re-exported from `@nwire/telemetry`.
+ *
+ * The live-runtime capture (`captureTopology`) and the `Topology` shape moved to
+ * `@nwire/telemetry` (a runtime lib) so a running app can self-emit its topology
+ * to `.nwire/topology.json` without the scanner. The scanner keeps this barrel
+ * so its instance-based manifest path and existing imports resolve unchanged;
+ * `buildManifest` folds the emitted file when no live instance is given.
+ */
+export { captureTopology, } from "@nwire/telemetry";

package/dist/vite-plugin.d.ts

@@ -1,12 +1,20 @@
 /**
- * Vite plugin form — invoke buildCache + writeCache at dev/build startup.
+ * Vite/unplugin form — emit the build-time manifest.
  *
- * 0.10 stub: see scan.ts header. buildCache returns an empty cache until
- * the post-modules scanner lands.
+ * On build start and on dev-server start (re-emitted as `.ts` source changes),
+ * walks the project's source tree with the AST extractor and writes
+ * `.nwire/manifest.json`. No app boot — "scan the graph, not the runtime."
+ * Serves the live manifest at `/__nwire/manifest` in dev.
  */
 import type { Plugin } from "vite";
-export interface NwireCachePluginOptions {
-    readonly apps: readonly any[];
+export interface NwireManifestPluginOptions {
+    /** Source root to scan. Defaults to the resolved Vite `config.root`. */
+    readonly root?: string;
+    /** App-name stamp on every manifest entry. */
+    readonly app?: string;
+    /** Output directory for `manifest.json`. Default `.nwire`. */
     readonly outDir?: string;
 }
-export declare function nwireCachePlugin(options: NwireCachePluginOptions): Plugin;
+export declare function nwireManifestPlugin(options?: NwireManifestPluginOptions): Plugin;
+/** @deprecated Use {@link nwireManifestPlugin}. Kept so existing imports resolve. */
+export declare const nwireCachePlugin: typeof nwireManifestPlugin;

package/dist/vite-plugin.js

@@ -1,25 +1,40 @@
 /**
- * Vite plugin form — invoke buildCache + writeCache at dev/build startup.
+ * Vite/unplugin form — emit the build-time manifest.
  *
- * 0.10 stub: see scan.ts header. buildCache returns an empty cache until
- * the post-modules scanner lands.
+ * On build start and on dev-server start (re-emitted as `.ts` source changes),
+ * walks the project's source tree with the AST extractor and writes
+ * `.nwire/manifest.json`. No app boot — "scan the graph, not the runtime."
+ * Serves the live manifest at `/__nwire/manifest` in dev.
  */
-import { buildCache, writeCache } from "./scan.js";
-export function nwireCachePlugin(options) {
+import { buildManifest, writeManifest } from "./manifest.js";
+export function nwireManifestPlugin(options = {}) {
     const outDir = options.outDir ?? ".nwire";
+    let root = options.root ?? process.cwd();
     return {
-        name: "nwire:cache",
+        name: "nwire:manifest",
+        configResolved(config) {
+            if (!options.root && config.root)
+                root = config.root;
+        },
         async buildStart() {
-            const cache = buildCache(options.apps);
-            await writeCache(cache, outDir);
+            await writeManifest(buildManifest(root, options.app), outDir);
         },
         async configureServer(server) {
-            const cache = buildCache(options.apps);
-            await writeCache(cache, outDir);
-            server.middlewares.use("/__nwire/cache", (_req, res) => {
+            const emit = () => writeManifest(buildManifest(root, options.app), outDir);
+            await emit();
+            const onChange = (file) => {
+                if (file.endsWith(".ts") && !file.endsWith(".d.ts"))
+                    void emit();
+            };
+            server.watcher.on("add", onChange);
+            server.watcher.on("change", onChange);
+            server.watcher.on("unlink", onChange);
+            server.middlewares.use("/__nwire/manifest", (_req, res) => {
                 res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify(cache, null, 2));
+                res.end(JSON.stringify(buildManifest(root, options.app), null, 2));
             });
         },
     };
 }
+/** @deprecated Use {@link nwireManifestPlugin}. Kept so existing imports resolve. */
+export const nwireCachePlugin = nwireManifestPlugin;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nwire/scan",
-  "version": "0.12.0",
-  "description": "Nwire — system registry scanner. Walks AppDefinition[] manifests and writes the .nwire/ cache (actions, events, actors, projections, queries, modules, routes, event graph). Vite plugin + standalone function.",
+  "version": "0.13.0",
+  "description": "Nwire — system registry scanner. Walks AppDefinition[] manifests and writes the .nwire/ cache (actions, events, actors, projections, queries, routes, event graph). Vite plugin + standalone function.",
   "keywords": [
     "cache",
     "nwire",
@@ -32,17 +32,19 @@
     "access": "public"
   },
   "dependencies": {
+    "typescript": "^5.9.3",
     "zod": "^4.4.3",
-    "@nwire/forge": "0.12.0",
-    "@nwire/messages": "0.12.0",
-    "@nwire/hooks": "0.12.0"
+    "@nwire/forge": "0.13.0",
+    "@nwire/messages": "0.13.0",
+    "@nwire/telemetry": "0.13.0",
+    "@nwire/hooks": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",
     "typescript": "^5.9.3",
     "vite": "npm:rolldown-vite@latest",
     "vitest": "^4.0.18",
-    "@nwire/container": "0.12.0"
+    "@nwire/container": "0.13.0"
   },
   "scripts": {
     "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",