@nwire/scan 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @nwire/scan
+
+> Walks `AppDefinition[]` and produces the `.nwire/` cache — the framework's static-reflection layer.
+
+## What it does
+
+Reads every action / event / actor / projection / query / workflow / module across all registered apps and emits a set of JSON files (`actions.json`, `events.json`, `actors.json`, `projections.json`, `queries.json`, `routes.json`, `modules.json`, `graph.json`, `manifest.json`). Studio reads these; the CLI reads these; codegen pipelines read these. Rebuilt from scratch on each invocation (a few ms for hundreds of definitions).
+
+## Install
+
+```bash
+pnpm add @nwire/scan
+```
+
+## Quick start
+
+```ts
+import { buildCache, writeCache } from "@nwire/scan";
+import { allApps } from "../apps/apps";
+
+const cache = buildCache(allApps);
+await writeCache(cache, ".nwire");
+//.nwire/manifest.json +.nwire/actions.json +... now on disk
+```
+
+Most users invoke this via the CLI: `nwire cache`.
+
+## API surface
+
+- `buildCache(apps)` — returns the cache object.
+- `writeCache(cache, dir)` — write the cache to disk.
+- Entry types: `ActionEntry`, `EventEntry`, `ActorEntry`, `ProjectionEntry`, `QueryEntry`, `RouteEntry`, `ModuleEntry`, etc.
+
+## When to use
+
+When building tooling that needs to introspect a Nwire app — Studio panels, codegen, generated docs, custom CLIs. Fits every level (tooling concern).
+
+## Used only within nwire-app
+
+This package is part of the Nwire stack — it only makes sense inside a Nwire application built with `@nwire/app` + `@nwire/forge`. If you're looking for a standalone primitive, see:
+
+- [`@nwire/handler`](../nwire-handler/README.md) — the operation primitive (transport-agnostic)
+- [`@nwire/hooks`](../nwire-hooks/README.md) — universal dispatch (chain + listeners)
+- [`@nwire/http`](../nwire-http/README.md) — typed HTTP without forge
+- [`@nwire/endpoint`](../nwire-endpoint/README.md) — graceful shutdown for any host
+
+## See also
+
+- [Architecture sketch §05 — Tooling](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/cli](../nwire-cli), [@nwire/studio](../nwire-studio)

package/dist/__tests__/scan.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @nwire/scan — cache builder walks AppDefinition[] manifests.
+ */
+export {};
+//# sourceMappingURL=scan.test.d.ts.map

package/dist/__tests__/scan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scan.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/scan.test.js

@@ -0,0 +1,103 @@
+/**
+ * @nwire/scan — cache builder walks AppDefinition[] manifests.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineEvent } from "@nwire/messages";
+import * as forge from "@nwire/forge";
+import { buildCache } from "../scan";
+const SubmittedEvent = defineEvent({
+    name: "sub.submitted",
+    description: "Avi turns in his answer.",
+    schema: z.object({ submissionId: z.string(), answer: z.string() }),
+    visibility: "public",
+    scope: "integration",
+    version: 1,
+});
+const InternalCheckEvent = defineEvent({
+    name: "sub.internal-check",
+    schema: z.object({ id: z.string() }),
+    visibility: "internal",
+});
+const submitAnswer = forge.defineAction({
+    name: "sub.submit-answer",
+    description: "Avi (9, beginner) finishes a Hebrew Letters exercise.",
+    schema: z.object({ submissionId: z.string(), answer: z.string() }),
+    policy: "self",
+    handler: async () => undefined,
+});
+const Submissions = forge.defineProjection("submissions-by-student", {
+    listens: [SubmittedEvent],
+    initial: () => ({ all: [] }),
+    on: { [SubmittedEvent.name]: (s) => s },
+});
+const subsByStudent = forge.defineQuery(Submissions, {
+    name: "sub.by-student",
+    description: "Avi's history.",
+    schema: z.object({ studentId: z.string() }),
+    execute: (state) => state.all,
+});
+const submissionsModule = forge.defineModule("submissions", {
+    actions: [submitAnswer],
+    events: [SubmittedEvent, InternalCheckEvent],
+    projections: [Submissions],
+    queries: [subsByStudent],
+});
+const masteryWorkflow = forge.defineWorkflow("mastery.observe-submission", ({ on }) => {
+    on(SubmittedEvent, async () => { });
+});
+const masteryModule = forge.defineModule("mastery", {
+    workflows: [masteryWorkflow],
+    needs: { events: [SubmittedEvent] },
+});
+const testApp = forge.defineApp("test-app", {
+    description: "Test fixture",
+    modules: [submissionsModule, masteryModule],
+});
+describe("buildCache", () => {
+    it("collects every action across modules with module+app provenance", () => {
+        const cache = buildCache([testApp]);
+        const submit = cache.actions.find((a) => a.name === "sub.submit-answer");
+        expect(submit).toBeDefined();
+        expect(submit?.module).toBe("submissions");
+        expect(submit?.app).toBe("test-app");
+        expect(submit?.description).toContain("Avi");
+        expect(submit?.policy).toBe("self");
+        expect(submit?.hasInlineHandler).toBe(true);
+        expect(submit?.schema).toMatchObject({ type: "object" });
+    });
+    it("collects events with visibility preserved", () => {
+        const cache = buildCache([testApp]);
+        expect(cache.events.find((e) => e.name === "sub.submitted")?.visibility).toBe("public");
+        expect(cache.events.find((e) => e.name === "sub.internal-check")?.visibility).toBe("internal");
+    });
+    it("collects projections with listens; queries with their projection", () => {
+        const cache = buildCache([testApp]);
+        const proj = cache.projections.find((p) => p.name === "submissions-by-student");
+        expect(proj?.listens).toEqual(["sub.submitted"]);
+        const q = cache.queries.find((q) => q.name === "sub.by-student");
+        expect(q?.projection).toBe("submissions-by-student");
+    });
+    it("builds an event graph linking producers to consumers", () => {
+        const cache = buildCache([testApp]);
+        const edge = cache.graph.events.find((e) => e.event === "sub.submitted");
+        expect(edge).toBeDefined();
+        expect(edge?.producer).toEqual({ app: "test-app", module: "submissions" });
+        // mastery has a workflow subscribing to SubmittedEvent AND declares it in needs.events
+        const masteryConsumers = edge?.consumers.filter((c) => c.module === "mastery");
+        expect(masteryConsumers?.some((c) => c.via === "workflow")).toBe(true);
+        // submissions' own projection also listens
+        const subProjConsumer = edge?.consumers.find((c) => c.module === "submissions" && c.via === "projection");
+        expect(subProjConsumer).toBeDefined();
+    });
+    it("module entries carry provides + needs + counts", () => {
+        const cache = buildCache([testApp]);
+        const mastery = cache.modules.find((m) => m.name === "mastery");
+        expect(mastery?.needs.events).toEqual(["sub.submitted"]);
+        expect(mastery?.counts.workflows).toBe(1);
+        const subs = cache.modules.find((m) => m.name === "submissions");
+        expect(subs?.provides.events).toEqual(["sub.submitted", "sub.internal-check"]);
+        expect(subs?.provides.actions).toEqual(["sub.submit-answer"]);
+    });
+});
+//# sourceMappingURL=scan.test.js.map

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

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

package/dist/scan.d.ts

@@ -0,0 +1,328 @@
+/**
+ * `@nwire/scan` — walks `AppDefinition[]` and produces the `.nwire/` cache.
+ *
+ * The framework's static-reflection layer: every action/event/actor/
+ * projection/query/route plus the cross-module event graph emitted as
+ * JSON. Studio reads it; the CLI reads it; codegen reads it. Rebuilt
+ * from scratch on each invocation (a few ms for hundreds of definitions).
+ *
+ * See: architecture-sketch.html §05 (Tooling).
+ */
+import { zodToJsonSchema } from "./zod-to-json";
+import type * as forge from "@nwire/forge";
+export interface ActionEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly schema: object;
+    readonly retry?: object;
+    readonly policy?: string | readonly string[];
+    readonly hasInlineHandler: boolean;
+    readonly emits: readonly string[];
+    /** True when the module's manifest marked this action `.public()`. */
+    readonly public: boolean;
+    /** Studio-aware metadata (all optional). */
+    readonly persona?: string;
+    readonly journeyStep?: string;
+    readonly capability?: string;
+    readonly slo?: {
+        readonly p95LatencyMs?: number;
+        readonly successRate?: number;
+    };
+    readonly tags?: readonly string[];
+}
+export interface ExternalCallEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly target: {
+        provider: string;
+        endpoint: string;
+        region?: string;
+    };
+    readonly request: object;
+    readonly response?: object;
+    readonly hasIdempotencyKey: boolean;
+    readonly slo?: {
+        p95LatencyMs?: number;
+        successRate?: number;
+    };
+    readonly retry?: {
+        max: number;
+        backoff?: string;
+    };
+    readonly tags?: readonly string[];
+}
+export interface InboundWebhookEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly source: string;
+    readonly path: string;
+    readonly hasSignatureVerifier: boolean;
+    readonly dedupe?: {
+        window: string;
+    };
+    readonly discriminator: string;
+    /** Map of discriminator value → action name. */
+    readonly routes: Readonly<Record<string, string>>;
+    readonly tags?: readonly string[];
+}
+export interface OutboxEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly publishes: readonly string[];
+    readonly flushIntervalMs: number;
+    readonly maxBatch: number;
+    readonly tags?: readonly string[];
+}
+export interface InboxEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly window: string;
+    readonly on: readonly string[];
+    readonly tags?: readonly string[];
+}
+export interface CronEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly schedule: string;
+    readonly dispatches: string;
+    readonly timezone?: string;
+    readonly tags?: readonly string[];
+}
+export interface WorkflowEntry {
+    /** The workflow name (`defineWorkflow("on-wash-complete", …)`). */
+    readonly name: string;
+    /** The bounded context (module) that owns this workflow. */
+    readonly module: string;
+    readonly app: string;
+    /** Free-form description from `options.description`. */
+    readonly description?: string;
+    /** Every event this workflow declares an `on(...)` for. */
+    readonly subscribesTo: readonly string[];
+    /** Every action this workflow declares it dispatches (via `opts.dispatches`). */
+    readonly dispatches: readonly string[];
+    /** True when the module's manifest marked this workflow `.public()`. */
+    readonly public: boolean;
+}
+export interface EventEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly visibility: "public" | "internal";
+    /**
+     * True when the module's manifest marked this event `.public()`. Distinct
+     * from `visibility` (which the event definition itself may declare for
+     * back-compat) — `public` reflects the canonical module-level decision.
+     */
+    readonly public: boolean;
+    readonly schema: object;
+    /** Studio-aware metadata. */
+    readonly outcome?: "success" | "failure" | "milestone" | "warning";
+    readonly businessWeight?: number;
+    readonly audience?: readonly string[];
+}
+export interface ActorEntry {
+    readonly name: string;
+    readonly module: string;
+    readonly app: string;
+    readonly key: string;
+    readonly initial: string;
+    readonly states: ReadonlyArray<{
+        readonly name: string;
+        readonly final?: boolean;
+        readonly on: ReadonlyArray<{
+            readonly eventName: string;
+            readonly target?: string;
+        }>;
+        readonly after: ReadonlyArray<{
+            readonly timerName: string;
+            readonly action: string;
+            readonly delay: string;
+        }>;
+    }>;
+    readonly methods: readonly string[];
+    readonly schema: object;
+    /** Studio-aware metadata. */
+    readonly stuckThresholds?: Readonly<Record<string, number>>;
+    readonly slas?: Readonly<Record<string, {
+        maxDurationMs: number;
+        escalateTo?: string;
+    }>>;
+}
+export interface ProjectionEntry {
+    readonly name: string;
+    readonly module: string;
+    readonly app: string;
+    readonly listens: readonly string[];
+    /** Studio-aware metadata. */
+    readonly description?: string;
+    readonly freshness?: {
+        p95MsBehindStream?: number;
+    };
+}
+export interface QueryEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly module: string;
+    readonly app: string;
+    readonly projection: string;
+    readonly schema: object;
+    /** True when the module's manifest marked this query `.public()`. */
+    readonly public: boolean;
+    /** Studio-aware metadata. */
+    readonly slo?: {
+        p95LatencyMs?: number;
+    };
+    readonly cacheable?: boolean;
+}
+export interface ModuleEntry {
+    readonly name: string;
+    readonly app: string;
+    readonly provides: {
+        readonly events: readonly string[];
+        readonly actions: readonly string[];
+    };
+    readonly needs: {
+        readonly events: readonly string[];
+        readonly externalEvents: readonly string[];
+        readonly actions: readonly string[];
+    };
+    readonly counts: {
+        readonly actions: number;
+        readonly actors: number;
+        readonly projections: number;
+        readonly queries: number;
+        readonly workflows: number;
+        readonly events: number;
+        readonly routes: number;
+    };
+    /** Studio-aware metadata. */
+    readonly description?: string;
+    readonly owners?: readonly string[];
+    readonly journey?: readonly {
+        id: string;
+        label: string;
+        description?: string;
+    }[];
+}
+export interface AppEntry {
+    readonly name: string;
+    readonly description?: string;
+    readonly modules: readonly string[];
+    /** Studio-aware metadata. */
+    readonly tenantModel?: "single" | "per-org" | "per-account" | "per-workspace";
+    readonly tenantKey?: string;
+}
+export interface RouteEntry {
+    readonly method: string;
+    readonly path: string;
+    readonly target: string;
+    readonly targetKind: "action" | "query" | "resolver";
+    readonly module: string;
+    readonly app: string;
+}
+/**
+ * Interface-layer operation. Each resolver is a typed, transport-agnostic
+ * surface — Studio's canonical "what does this app expose?" answer.
+ */
+export interface ResolverEntry {
+    readonly operation: string;
+    readonly version: number;
+    readonly status: "draft" | "active" | "deprecated" | "sunset";
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly app: string;
+    /** Transport bindings — verb/path table from httpInterface().wire() + friends. */
+    readonly bindings: ReadonlyArray<{
+        readonly transport: "rest" | "graphql" | "cli";
+        readonly method?: string;
+        readonly path?: string;
+    }>;
+    /** Zod schemas converted to JSON schema. */
+    readonly params?: object;
+    readonly query?: object;
+    readonly body?: object;
+    readonly returns: ReadonlyArray<{
+        readonly status: number;
+        readonly kind: "single" | "list" | "empty";
+    }>;
+    readonly errors: ReadonlyArray<{
+        readonly code: string;
+        readonly status: number;
+    }>;
+    readonly successor?: {
+        readonly operation: string;
+        readonly version: number;
+    };
+    readonly sunsetDate?: string;
+}
+/**
+ * Optional mount table for resolvers. The scanner can't reach into
+ * `@nwire/http`'s rest registry (transport-layer dep), so callers pass
+ * the mount tuples in. Passing nothing is fine — resolvers will be
+ * emitted without verb/path bindings.
+ */
+export interface ResolverMount {
+    readonly resolver: any;
+    readonly transport: "rest" | "graphql" | "cli";
+    readonly method?: string;
+    readonly path?: string;
+}
+export interface EventGraphEdge {
+    readonly event: string;
+    readonly producer: {
+        app: string;
+        module: string;
+    };
+    readonly consumers: ReadonlyArray<{
+        readonly app: string;
+        readonly module: string;
+        readonly via: "workflow" | "projection" | "actor" | "external";
+    }>;
+}
+export interface Cache {
+    readonly generatedAt: string;
+    readonly apps: readonly AppEntry[];
+    readonly modules: readonly ModuleEntry[];
+    readonly actions: readonly ActionEntry[];
+    readonly events: readonly EventEntry[];
+    readonly actors: readonly ActorEntry[];
+    readonly projections: readonly ProjectionEntry[];
+    readonly queries: readonly QueryEntry[];
+    readonly resolvers: readonly ResolverEntry[];
+    readonly routes: readonly RouteEntry[];
+    readonly workflows: readonly WorkflowEntry[];
+    readonly externalCalls: readonly ExternalCallEntry[];
+    readonly inboundWebhooks: readonly InboundWebhookEntry[];
+    readonly outboxes: readonly OutboxEntry[];
+    readonly inboxes: readonly InboxEntry[];
+    readonly crons: readonly CronEntry[];
+    readonly graph: {
+        readonly events: readonly EventGraphEdge[];
+    };
+}
+export interface BuildCacheOptions {
+    /**
+     * Resolver mount tuples — pass in from the runtime side (typically
+     * `rest.listMounts()` from `@nwire/http`) so resolvers carry their
+     * verb/path bindings in the cache.
+     */
+    readonly mounts?: readonly ResolverMount[];
+}
+export declare function buildCache(apps: readonly forge.AppDefinition[], options?: BuildCacheOptions): Cache;
+export declare function writeCache(cache: Cache, dir: string): Promise<void>;
+export { zodToJsonSchema };
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

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

package/dist/scan.js

@@ -0,0 +1,364 @@
+/**
+ * `@nwire/scan` — walks `AppDefinition[]` and produces the `.nwire/` cache.
+ *
+ * The framework's static-reflection layer: every action/event/actor/
+ * projection/query/route plus the cross-module event graph emitted as
+ * JSON. Studio reads it; the CLI reads it; codegen reads it. Rebuilt
+ * from scratch on each invocation (a few ms for hundreds of definitions).
+ *
+ * See: architecture-sketch.html §05 (Tooling).
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { zodToJsonSchema } from "./zod-to-json";
+export function buildCache(apps, options = {}) {
+    const out = {
+        apps: [],
+        modules: [],
+        actions: [],
+        events: [],
+        actors: [],
+        projections: [],
+        queries: [],
+        resolvers: [],
+        routes: [],
+        workflows: [],
+        externalCalls: [],
+        inboundWebhooks: [],
+        outboxes: [],
+        inboxes: [],
+        crons: [],
+    };
+    const mounts = options.mounts ?? [];
+    for (const app of apps) {
+        out.apps.push({
+            name: app.name,
+            description: app.description,
+            modules: app.modules.map((m) => m.name),
+            tenantModel: app.tenantModel,
+            tenantKey: app.tenantKey,
+        });
+        // Resolvers as a concept were removed — operations now ship as
+        // RouteBinding values wired on `httpInterface`. Scan reads them
+        // from the http builder's manifest at boot, not from the app.
+        //
+        // `mounts` stays as a parameter so callers can still pass route
+        // metadata explicitly; it's just no longer derived from
+        // `app.resolvers`.
+        void mounts;
+        void zodToJsonSchema;
+        for (const module of app.modules) {
+            const m = module.manifest;
+            const provides = {
+                events: (m.events ?? []).map((e) => e.name),
+                actions: (m.actions ?? []).map((a) => a.name),
+            };
+            const needs = {
+                events: (m.needs?.events ?? []).map((e) => e.name),
+                externalEvents: (m.needs?.externalEvents ?? []).map((e) => e.name),
+                actions: (m.needs?.actions ?? []).map((a) => a.name),
+            };
+            out.modules.push({
+                name: module.name,
+                app: app.name,
+                provides,
+                needs,
+                counts: {
+                    actions: (m.actions ?? []).length,
+                    actors: (m.actors ?? []).length,
+                    projections: (m.projections ?? []).length,
+                    queries: (m.queries ?? []).length,
+                    workflows: (m.workflows ?? []).length,
+                    events: (m.events ?? []).length,
+                    // routes are app-level (httpInterface().wire()); not module-owned.
+                    routes: 0,
+                },
+                description: m.description,
+                owners: m.owners,
+                journey: m.journey,
+            });
+            for (const action of m.actions ?? []) {
+                out.actions.push({
+                    name: action.name,
+                    description: action.description,
+                    module: module.name,
+                    app: app.name,
+                    schema: zodToJsonSchema(action.schema),
+                    retry: action.retry,
+                    policy: action.policy,
+                    hasInlineHandler: Boolean(action.handler),
+                    emits: (action.emits ?? []).map((e) => e.name),
+                    public: module.publicSurface.actions.has(action.name),
+                    persona: action.persona,
+                    journeyStep: action.journeyStep,
+                    capability: action.capability,
+                    slo: action.slo,
+                    tags: action.tags,
+                });
+            }
+            for (const event of m.events ?? []) {
+                out.events.push({
+                    name: event.name,
+                    description: event.description,
+                    module: module.name,
+                    app: app.name,
+                    visibility: event.visibility ?? "public",
+                    public: module.publicSurface.events.has(event.name),
+                    schema: zodToJsonSchema(event.schema),
+                    outcome: event.outcome,
+                    businessWeight: event.businessWeight,
+                    audience: event.audience,
+                });
+            }
+            for (const actor of m.actors ?? []) {
+                out.actors.push({
+                    name: actor.name,
+                    module: module.name,
+                    app: app.name,
+                    key: actor.key,
+                    initial: actor.initial,
+                    states: Object.entries(actor.states).map(([stateName, cfg]) => ({
+                        name: stateName,
+                        final: cfg.final,
+                        on: Object.entries(cfg.on ?? {}).map(([eventName, reaction]) => ({
+                            eventName,
+                            target: reaction.target,
+                        })),
+                        after: Object.entries(cfg.after ?? {}).map(([timerName, spec]) => ({
+                            timerName,
+                            action: typeof spec === "string" ? spec : spec.action,
+                            delay: typeof spec === "string" ? timerName : spec.delay,
+                        })),
+                    })),
+                    methods: Object.keys(actor.methods ?? {}),
+                    schema: zodToJsonSchema(actor.schema),
+                    stuckThresholds: actor.stuckThresholds,
+                    slas: actor.slas,
+                });
+            }
+            for (const projection of m.projections ?? []) {
+                out.projections.push({
+                    name: projection.name,
+                    module: module.name,
+                    app: app.name,
+                    listens: (projection.listens ?? []).map((e) => e.name),
+                    description: projection.description,
+                    freshness: projection.freshness,
+                });
+            }
+            for (const query of m.queries ?? []) {
+                out.queries.push({
+                    name: query.name,
+                    description: query.description,
+                    module: module.name,
+                    app: app.name,
+                    projection: query.projection.name,
+                    schema: zodToJsonSchema(query.schema),
+                    public: module.publicSurface.queries.has(query.name),
+                    slo: query.slo,
+                    cacheable: query.cacheable,
+                });
+            }
+            // Routes are no longer module-owned. The interface layer (httpInterface
+            // builders + .wire() bindings) lives in the app composition; route
+            // emission walks the running wire's introspection mount.
+            for (const call of m.externalCalls ?? []) {
+                out.externalCalls.push({
+                    name: call.name,
+                    description: call.description,
+                    module: module.name,
+                    app: app.name,
+                    target: call.target,
+                    request: zodToJsonSchema(call.request),
+                    response: call.response ? zodToJsonSchema(call.response) : undefined,
+                    hasIdempotencyKey: call.hasIdempotencyKey,
+                    slo: call.slo,
+                    retry: call.retry ? { max: call.retry.max, backoff: call.retry.backoff } : undefined,
+                    tags: call.tags,
+                });
+            }
+            for (const wh of m.inboundWebhooks ?? []) {
+                const routes = {};
+                for (const [discValue, action] of Object.entries(wh.routes)) {
+                    routes[discValue] = action.name;
+                }
+                out.inboundWebhooks.push({
+                    name: wh.name,
+                    description: wh.description,
+                    module: module.name,
+                    app: app.name,
+                    source: wh.source,
+                    path: wh.path,
+                    hasSignatureVerifier: !!wh.verifySignature,
+                    dedupe: wh.dedupe ? { window: wh.dedupe.window } : undefined,
+                    discriminator: wh.discriminator,
+                    routes,
+                    tags: wh.tags,
+                });
+            }
+            for (const ob of m.outboxes ?? []) {
+                out.outboxes.push({
+                    name: ob.name,
+                    description: ob.description,
+                    module: module.name,
+                    app: app.name,
+                    publishes: ob.publishes.map((e) => e.name),
+                    flushIntervalMs: ob.flushIntervalMs,
+                    maxBatch: ob.maxBatch,
+                    tags: ob.tags,
+                });
+            }
+            for (const ib of m.inboxes ?? []) {
+                out.inboxes.push({
+                    name: ib.name,
+                    description: ib.description,
+                    module: module.name,
+                    app: app.name,
+                    window: ib.window,
+                    on: ib.on.map((a) => a.name),
+                    tags: ib.tags,
+                });
+            }
+            for (const cron of m.crons ?? []) {
+                out.crons.push({
+                    name: cron.name,
+                    description: cron.description,
+                    module: module.name,
+                    app: app.name,
+                    schedule: cron.schedule,
+                    dispatches: cron.dispatches.name,
+                    timezone: cron.timezone,
+                    tags: cron.tags,
+                });
+            }
+        }
+    }
+    // Build event graph: producer (module that emits) → consumers (modules
+    // that listen via reaction or have it in needs).
+    const eventOwners = new Map();
+    for (const ev of out.events) {
+        eventOwners.set(ev.name, { app: ev.app, module: ev.module });
+    }
+    const edges = new Map();
+    const seed = (eventName) => {
+        const owner = eventOwners.get(eventName);
+        if (!owner)
+            return null;
+        let e = edges.get(eventName);
+        if (!e) {
+            e = { event: eventName, producer: owner, consumers: [] };
+            edges.set(eventName, e);
+        }
+        return e;
+    };
+    // Workflows = explicit cross-cutting subscribers. Studio reads one
+    // .nwire/workflows.json and renders every reaction-style handler on
+    // the same node type.
+    for (const app of apps) {
+        for (const module of app.modules) {
+            for (const workflow of module.manifest.workflows ?? []) {
+                out.workflows.push({
+                    name: workflow.name,
+                    module: module.name,
+                    app: app.name,
+                    description: workflow.description,
+                    subscribesTo: [...workflow.subscribedEvents],
+                    dispatches: [...workflow.dispatchedActions],
+                    public: module.publicSurface.workflows.has(workflow.name),
+                });
+                for (const eventName of workflow.subscribedEvents) {
+                    const edge = seed(eventName);
+                    if (!edge)
+                        continue;
+                    edge.consumers.push({
+                        app: app.name,
+                        module: module.name,
+                        via: "workflow",
+                    });
+                }
+            }
+            // Actor reactions = state-machine reactions
+            for (const actor of module.manifest.actors ?? []) {
+                for (const [stateName, cfg] of Object.entries(actor.states)) {
+                    for (const eventName of Object.keys(cfg.on ?? {})) {
+                        const edge = seed(eventName);
+                        if (!edge)
+                            continue;
+                        edge.consumers.push({
+                            app: app.name,
+                            module: module.name,
+                            via: "actor",
+                        });
+                    }
+                }
+            }
+            // Projection listens
+            for (const projection of module.manifest.projections ?? []) {
+                for (const ev of projection.listens ?? []) {
+                    const edge = seed(ev.name);
+                    if (!edge)
+                        continue;
+                    edge.consumers.push({
+                        app: app.name,
+                        module: module.name,
+                        via: "projection",
+                    });
+                }
+            }
+            // External event needs = cross-service consumers
+            for (const ev of module.manifest.needs?.externalEvents ?? []) {
+                const edge = seed(ev.name);
+                if (!edge)
+                    continue;
+                edge.consumers.push({
+                    app: app.name,
+                    module: module.name,
+                    via: "external",
+                });
+            }
+        }
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        apps: out.apps,
+        modules: out.modules,
+        actions: out.actions,
+        events: out.events,
+        actors: out.actors,
+        projections: out.projections,
+        queries: out.queries,
+        resolvers: out.resolvers,
+        routes: out.routes,
+        workflows: out.workflows,
+        externalCalls: out.externalCalls,
+        inboundWebhooks: out.inboundWebhooks,
+        outboxes: out.outboxes,
+        inboxes: out.inboxes,
+        crons: out.crons,
+        graph: { events: Array.from(edges.values()) },
+    };
+}
+export async function writeCache(cache, dir) {
+    await mkdir(dir, { recursive: true });
+    await Promise.all([
+        writeFile(resolve(dir, "manifest.json"), JSON.stringify(cache, null, 2)),
+        writeFile(resolve(dir, "actions.json"), JSON.stringify(cache.actions, null, 2)),
+        writeFile(resolve(dir, "events.json"), JSON.stringify(cache.events, null, 2)),
+        writeFile(resolve(dir, "actors.json"), JSON.stringify(cache.actors, null, 2)),
+        writeFile(resolve(dir, "projections.json"), JSON.stringify(cache.projections, null, 2)),
+        writeFile(resolve(dir, "queries.json"), JSON.stringify(cache.queries, null, 2)),
+        writeFile(resolve(dir, "modules.json"), JSON.stringify(cache.modules, null, 2)),
+        writeFile(resolve(dir, "apps.json"), JSON.stringify(cache.apps, null, 2)),
+        writeFile(resolve(dir, "resolvers.json"), JSON.stringify(cache.resolvers, null, 2)),
+        writeFile(resolve(dir, "routes.json"), JSON.stringify(cache.routes, null, 2)),
+        writeFile(resolve(dir, "workflows.json"), JSON.stringify(cache.workflows, null, 2)),
+        writeFile(resolve(dir, "external-calls.json"), JSON.stringify(cache.externalCalls, null, 2)),
+        writeFile(resolve(dir, "inbound-webhooks.json"), JSON.stringify(cache.inboundWebhooks, null, 2)),
+        writeFile(resolve(dir, "outboxes.json"), JSON.stringify(cache.outboxes, null, 2)),
+        writeFile(resolve(dir, "inboxes.json"), JSON.stringify(cache.inboxes, null, 2)),
+        writeFile(resolve(dir, "crons.json"), JSON.stringify(cache.crons, null, 2)),
+        writeFile(resolve(dir, "graph.json"), JSON.stringify(cache.graph, null, 2)),
+    ]);
+}
+export { zodToJsonSchema };
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/vite-plugin.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "vite";
+import type * as forge from "@nwire/forge";
+export interface NwireCachePluginOptions {
+    readonly apps: readonly forge.AppDefinition[];
+    /** Output directory. Default: '.nwire'. */
+    readonly outDir?: string;
+}
+export declare function nwireCachePlugin(options: NwireCachePluginOptions): Plugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,KAAK,CAAC,aAAa,EAAE,CAAC;IAC9C,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAiBzE"}

package/dist/vite-plugin.js

@@ -0,0 +1,33 @@
+// Vite plugin form — invoke buildCache + writeCache at dev/build startup.
+//
+//   // vite.config.ts
+//   import { nwireCachePlugin } from '@nwire/scan/vite-plugin'
+//   import { allApps } from './apps/apps'
+//
+//   export default defineConfig({
+//     plugins: [nwireCachePlugin({ apps: allApps })]
+//   })
+//
+// Hooks into Vite's `buildStart` and `configureServer` so the cache is
+// fresh whenever Vite reloads. For the rare case where the cache is needed
+// without Vite running, use the CLI: `nwire cache`.
+import { buildCache, writeCache } from "./scan";
+export function nwireCachePlugin(options) {
+    const outDir = options.outDir ?? ".nwire";
+    return {
+        name: "nwire:cache",
+        async buildStart() {
+            const cache = buildCache(options.apps);
+            await writeCache(cache, outDir);
+        },
+        async configureServer(server) {
+            const cache = buildCache(options.apps);
+            await writeCache(cache, outDir);
+            server.middlewares.use("/__nwire/cache", (_req, res) => {
+                res.setHeader("Content-Type", "application/json");
+                res.end(JSON.stringify(cache, null, 2));
+            });
+        },
+    };
+}
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,sBAAsB;AACtB,+DAA+D;AAC/D,0CAA0C;AAC1C,EAAE;AACF,kCAAkC;AAClC,qDAAqD;AACrD,OAAO;AACP,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,oDAAoD;AAIpD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAQhD,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,CAAC,UAAU;YACd,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,MAAM;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAChC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBACrD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/zod-to-json.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Zod → JSON Schema for the cache.
+ *
+ * Zod 4 ships a first-class `z.toJSONSchema()` exporter — we delegate to it
+ * instead of maintaining our own walk. Studio reads these schemas to render
+ * form fields + show "expected shape" hints; the OpenAPI path uses
+ * `@asteasolutions/zod-to-openapi` separately.
+ *
+ * The output is a JSON Schema 2020-12 object. We strip the top-level
+ * `$schema` URL since callers don't need it embedded in every cache entry.
+ */
+import type { ZodTypeAny } from "@nwire/messages";
+export declare function zodToJsonSchema(schema: ZodTypeAny): object;
+//# sourceMappingURL=zod-to-json.d.ts.map

package/dist/zod-to-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.d.ts","sourceRoot":"","sources":["../src/zod-to-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiB1D"}

package/dist/zod-to-json.js

@@ -0,0 +1,32 @@
+/**
+ * Zod → JSON Schema for the cache.
+ *
+ * Zod 4 ships a first-class `z.toJSONSchema()` exporter — we delegate to it
+ * instead of maintaining our own walk. Studio reads these schemas to render
+ * form fields + show "expected shape" hints; the OpenAPI path uses
+ * `@asteasolutions/zod-to-openapi` separately.
+ *
+ * The output is a JSON Schema 2020-12 object. We strip the top-level
+ * `$schema` URL since callers don't need it embedded in every cache entry.
+ */
+import { z } from "zod";
+export function zodToJsonSchema(schema) {
+    try {
+        const json = z.toJSONSchema(schema);
+        // The cache doesn't need the $schema dialect URL — it's the same on
+        // every entry. Strip it for a leaner manifest.
+        if (json && typeof json === "object") {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const { $schema, ...rest } = json;
+            return rest;
+        }
+        return json;
+    }
+    catch {
+        // toJSONSchema throws on a few edge cases (cyclic refs, transforms with
+        // no encoder). Surface "unknown" so Studio shows a placeholder instead
+        // of failing the whole cache build.
+        return { type: "unknown" };
+    }
+}
+//# sourceMappingURL=zod-to-json.js.map

package/dist/zod-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.js","sourceRoot":"","sources":["../src/zod-to-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAA4B,CAAC;QAC/D,oEAAoE;QACpE,+CAA+C;QAC/C,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,6DAA6D;YAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,uEAAuE;QACvE,oCAAoC;QACpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nwire/scan",
+  "version": "0.7.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.",
+  "keywords": [
+    "cache",
+    "nwire",
+    "registry",
+    "scan",
+    "vite-plugin"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/scan.js",
+  "types": "./dist/scan.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/scan.js",
+      "types": "./dist/scan.d.ts"
+    },
+    "./vite-plugin": {
+      "import": "./dist/vite-plugin.js",
+      "types": "./dist/vite-plugin.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@nwire/forge": "0.7.0",
+    "@nwire/messages": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.3",
+    "vite": "npm:rolldown-vite@latest",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}