@nwire/studio 0.10.0 → 0.11.0

package/README.md

@@ -31,22 +31,33 @@ supervisor, dispatch).
 
 ## Pages
 
-| Page      | Reads                                | Renders                                                                                                        |
-| --------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
-| Overview  | `manifest.json`                      | Per-app summary, counts, links.                                                                                |
-| Topology  | `graph.json` + manifest              | VueFlow graph of modules + cross-domain event edges.                                                           |
-| Modules   | `modules.json`                       | Per-domain card with badges (public/private, persona, journeyStep).                                            |
-| Actions   | `actions.json`                       | Action table with SLO + retry + emits.                                                                         |
-| Events    | `events.json`                        | Event catalog grouped by audience/outcome.                                                                     |
-| Resolvers | `resolvers.json` + `routes.json`     | Resolver bindings with their HTTP mount tuples.                                                                |
-| Workflows | `workflows.json`                     | Reactions + sagas with state diagrams.                                                                         |
-| Hooks     | `hooks.json` + live `.tap()`         | Every `hook()` in the registry with chain + listener counts, click-to-open chips, live step taps.              |
-| Plugins   | `plugins.json`                       | Plugins + modules-compiled-as-plugins (distinguished by `kind`).                                               |
-| Commands  | `commands.json`                      | Operator `defineCommand` entries with run buttons.                                                             |
-| Live      | `/__nwire/events/stream` (SSE)       | Tail every domain event as it fires.                                                                           |
-| Trace     | `/__nwire/telemetry/stream` (SSE)    | Causation tree for one `correlationId`; Play Trace replays telemetry across canvas with amber-glow per sticky. |
-| Dispatch  | `/__nwire/dispatch`                  | Form-driven action invocation against a live wire.                                                             |
-| Run       | `/__nwire/run/*` (kernel supervisor) | 3-column picker / processes / live stdout — boots wires from the browser.                                      |
+The nav is grouped into **Map** (the live system), **Run** (operate
+it), **Inspect** (browse the static surface). Screenshots are
+captured live against `examples/moderation-queue` — see
+[docs/concepts/studio](../../docs/concepts/studio.md) for the
+annotated tour.
+
+![Home](../../docs/public/studio/01-home.png)
+
+| Group   | Page        | Reads                             | Renders                                                                                                             |
+| ------- | ----------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+|         | Projects    | localStorage catalog              | Catalog of every workspace Studio has ever opened.                                                                  |
+|         | Home        | `manifest.json` + live telemetry  | Per-project dashboard — recent failures, boot summary, composition stats.                                           |
+| Map     | Topology    | manifest + `graph.events`         | VueFlow graph — apps as nodes with their plugins + sinks inline, cross-app event edges.                             |
+| Map     | Trace       | `/__nwire/telemetry/stream` (SSE) | Causation tree per `correlationId`; Play Trace replays telemetry across canvas with amber-glow per sticky.          |
+| Map     | Stream      | `/__nwire/events/stream` (SSE)    | Live event firehose.                                                                                                |
+| Run     | Try         | `/__nwire/dispatch`               | Form-from-Zod-schema action dispatch against the live wire.                                                         |
+| Run     | Processes   | `/__nwire/run/*` (supervisor)     | Start dev with custom port + env, stream stdout, recognise external `nwire dev` processes via `.nwire/processes/*`. |
+| Run     | Commands    | `/__nwire/run/commands`           | Operator `defineCommand` entries with run buttons.                                                                  |
+| Run     | Workflows   | `workflows`                       | Workflow defs with subscribed events and dispatched actions.                                                        |
+| Inspect | Apps        | `apps` + `plugins` + `sinks`      | Every App with its plugin stack, primitive counts, and outbound sinks.                                              |
+| Inspect | Actions     | `actions`                         | Searchable list + detail panel: schema, retry, persona, journey, SLO, source link.                                  |
+| Inspect | Events      | `events` + `graph.events`         | Catalog with the `.public()` gate badge + per-event producer/consumer flow.                                         |
+| Inspect | Projections | `projections`                     | CQRS read models; each fold with the events it listens to and the queries reading it.                               |
+| Inspect | Queries     | `queries`                         | Read endpoints — projection-backed or direct-handler.                                                               |
+| Inspect | Sinks       | `sinks`                           | Outbound delivery chain — every stage by position (early / middle / terminal).                                      |
+| Inspect | Plugins     | `plugins`                         | Installed plugins per app — bundle-mode forge, sub-plugins, custom.                                                 |
+| Inspect | Hooks       | `hooks`                           | Every materialised framework hook slot and its chain length.                                                        |
 
 ## Surface (programmatic)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/studio",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Nwire Studio — visual companion for the framework. Vue 3 + Vite + shadcn-vue + VueFlow. System topology, action runner, actor browser, projection viewer, DLQ inspector.",
   "keywords": [
     "devtools",
@@ -40,7 +40,7 @@
     "vite": "npm:rolldown-vite@latest",
     "vue": "^3.5.13",
     "vue-router": "^4.5.0",
-    "@nwire/supervisor": "0.10.0"
+    "@nwire/supervisor": "0.11.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",

package/src/App.vue

@@ -1,11 +1,14 @@
 <script setup lang="ts">
 import { onMounted, onBeforeUnmount, ref, watch, computed } from "vue";
-import { RouterLink, RouterView, useRoute } from "vue-router";
+import { RouterLink, RouterView, useRoute, useRouter } from "vue-router";
 import {
   upsertCurrent,
   loadCatalog,
   getActiveProjectCwd,
   setActiveProjectCwd,
+  setActiveSlug,
+  projectSlug,
+  cwdForSlug,
   type ProjectSnapshot,
 } from "@/lib/project-catalog";
 import {
@@ -24,14 +27,58 @@ import {
   Anchor,
   Puzzle,
   FolderOpen,
+  Map,
+  Wrench,
+  Eye,
+  Database,
+  Search,
+  Terminal,
 } from "lucide-vue-next";
 import { useCache } from "@/lib/cache";
 import { ErrorBoundary } from "@/components";
 import { Button } from "@/components/ui/button";
 
 const route = useRoute();
+const router = useRouter();
 const { cache, loading, error, missingFields, reload } = useCache();
 
+/**
+ * The active project slug — read from the URL when present, falls back
+ * to the launched project's slug. Drives every sidebar link so all
+ * navigation stays inside the project.
+ */
+const activeSlug = computed(() => {
+  const fromRoute = route.params.slug as string | undefined;
+  if (fromRoute) return fromRoute;
+  return project.value ? projectSlug(project.value) : null;
+});
+
+/** Build a project-scoped router path. */
+function pPath(suffix: string): string {
+  const slug = activeSlug.value;
+  if (!slug) return suffix;
+  const tail = suffix === "/" ? "" : suffix;
+  return `/projects/${slug}${tail}`;
+}
+
+/**
+ * When the URL slug changes (route navigation, manual paste, switch),
+ * resolve it to a cwd via the catalog and pin both legacy keys so the
+ * fetch shim + project-status middleware target the right project.
+ */
+watch(
+  () => route.params.slug,
+  (slug) => {
+    if (typeof slug !== "string" || !slug) return;
+    const cwd = cwdForSlug(slug);
+    if (cwd) {
+      setActiveProjectCwd(cwd);
+      setActiveSlug(slug);
+    }
+  },
+  { immediate: true },
+);
+
 // Project identity — multi-project (Shape A). The active project is
 // stored in localStorage; the server uses `?project=<cwd>` (injected via
 // the fetch shim in main.ts) to scope every endpoint. We need to register
@@ -42,18 +89,29 @@ const catalog = ref<Record<string, ProjectSnapshot>>({});
 
 async function bootProjects() {
   // Server-side registration happens in main.ts before mount (so the
-  // cache fetch has an accepted cwd). Here we just resolve the active
+  // cache fetch has an accepted cwd). Here we resolve the active
   // project's metadata + load the catalog into reactive state.
   catalog.value = loadCatalog();
+  // If the URL carries a /projects/:slug, that's the source of truth —
+  // resolve it against the catalog and pin the cwd before any fetch.
+  const slugFromRoute = route.params.slug as string | undefined;
+  if (slugFromRoute) {
+    const cwd = cwdForSlug(slugFromRoute);
+    if (cwd) {
+      setActiveProjectCwd(cwd);
+      setActiveSlug(slugFromRoute);
+    }
+  }
   const stored = getActiveProjectCwd();
   try {
     const res = await fetch("/__nwire/project");
     if (res.ok) {
       const body = (await res.json()) as { name: string; cwd: string };
       project.value = body;
-      // First-time mount with no active selection — pin it now so the
-      // catalog page + future requests have something to point at.
-      if (!stored) setActiveProjectCwd(body.cwd);
+      if (!stored) {
+        setActiveProjectCwd(body.cwd);
+        setActiveSlug(projectSlug(body));
+      }
     }
   } catch {
     // header just shows "Nwire Studio" if the fetch fails
@@ -66,11 +124,15 @@ const catalogList = computed<ProjectSnapshot[]>(() =>
 );
 
 function switchProject(cwd: string) {
+  const snap = catalog.value[cwd];
+  const slug = snap ? projectSlug(snap) : null;
   setActiveProjectCwd(cwd);
+  if (slug) setActiveSlug(slug);
   // Hard reload — every page's data depends on the active project, and
   // SSE streams are tied to the old one. A fresh page guarantees a clean
-  // pivot without untangling every page's reactive subscriptions.
-  window.location.reload();
+  // pivot without untangling every page's reactive subscriptions. Land
+  // on the new project's Home so the URL matches the pinned project.
+  window.location.assign(slug ? `/projects/${slug}` : "/projects");
 }
 
 // ─── Project switcher dropdown — click-driven + close-on-outside ────
@@ -110,6 +172,24 @@ onBeforeUnmount(() => {
 // the cache does, so we watch both.
 watch([project, cache], persistSnapshot);
 
+/**
+ * One-shot URL upgrade — if the user landed on a bare path like
+ * `/actions` we rewrite to `/projects/<slug>/actions` once the slug
+ * resolves. Lets old bookmarks and CI suites keep working while
+ * preserving the project-pinned canonical URL going forward.
+ */
+watch([project, () => route.path], ([_, currentPath]) => {
+  if (!project.value) return;
+  const slug = projectSlug(project.value);
+  if (currentPath.startsWith("/projects/")) return;
+  if (currentPath === "/projects") return;
+  // Don't fight a fresh navigation in flight.
+  const target = currentPath === "/" ? `/projects/${slug}` : `/projects/${slug}${currentPath}`;
+  if (target !== currentPath) {
+    void router.replace(target);
+  }
+});
+
 function persistSnapshot() {
   if (!project.value) return;
   const c = cache.value;
@@ -120,7 +200,7 @@ function persistSnapshot() {
     composition: c
       ? {
           apps: c.apps.length,
-          modules: c.modules.length,
+          plugins: c.plugins.length,
           actions: c.actions.length,
           events: c.events.length,
           resolvers: c.resolvers?.length ?? 0,
@@ -141,36 +221,53 @@ async function rebuildCache() {
   setTimeout(() => void reload(), 800);
 }
 
-// Studio nav — grouped by what a working dev actually does.
-// Daily work first (Trace + Try + Processes are the high-frequency tools);
-// Explorer for browsing the surface; Architecture for the big picture.
+// Studio nav — three top-level surfaces:
+//
+//   Map     — the live system in motion (architecture, trace, stream)
+//   Run     — operate the system (dispatch actions, drive processes, run CLI)
+//   Inspect — browse the static surface (every primitive that's wired up)
+//
+// Home + Projects sit above the groups: Home is the per-project dashboard;
+// Projects is the catalog of every workspace Studio has ever opened.
+const topItems = [
+  { to: "/projects", label: "Projects", icon: FolderOpen },
+  { to: "/", label: "Home", icon: Home },
+];
+
 const navGroups = [
   {
-    label: "Daily",
+    label: "Map",
+    icon: Map,
     items: [
-      { to: "/projects", label: "Projects", icon: FolderOpen }, // catalog of every project ever opened
-      { to: "/", label: "Home", icon: Home },
+      { to: "/topology", label: "Topology", icon: Network }, // app+module shape
       { to: "/trace", label: "Trace", icon: Workflow }, // causal tree, one correlationId
       { to: "/live", label: "Stream", icon: Waves }, // raw live event firehose
+    ],
+  },
+  {
+    label: "Run",
+    icon: Wrench,
+    items: [
       { to: "/dispatch", label: "Try", icon: Send }, // form-driven action dispatch
-      { to: "/run", label: "Processes", icon: Play }, // start/stop wires + logs
+      { to: "/run", label: "Processes", icon: Play }, // start/stop processes + logs
+      { to: "/commands", label: "Commands", icon: Terminal }, // please CLI surface
+      { to: "/workflows", label: "Workflows", icon: GitBranch }, // workflow defs + runs
     ],
   },
   {
-    label: "Explorer",
+    label: "Inspect",
+    icon: Eye,
     items: [
-      { to: "/modules", label: "Modules", icon: Boxes },
+      { to: "/apps", label: "Apps", icon: Boxes }, // bounded contexts — one per app
       { to: "/actions", label: "Actions", icon: Zap },
       { to: "/events", label: "Events", icon: Radio },
-      { to: "/workflows", label: "Workflows", icon: GitBranch },
+      { to: "/projections", label: "Projections", icon: Database },
+      { to: "/queries", label: "Queries", icon: Search },
+      { to: "/sinks", label: "Sinks", icon: Waves }, // outbound delivery chain
       { to: "/plugins", label: "Plugins", icon: Puzzle },
       { to: "/hooks", label: "Hooks", icon: Anchor },
     ],
   },
-  {
-    label: "Architecture",
-    items: [{ to: "/topology", label: "Topology", icon: Network }],
-  },
 ];
 </script>
 
@@ -232,19 +329,37 @@ const navGroups = [
         </div>
         <div class="text-[10px] text-zinc-600 mt-0.5">v0 · OSS</div>
       </div>
-      <nav class="flex-1 px-2 py-3 space-y-3 overflow-y-auto">
+      <nav class="flex-1 px-2 py-3 space-y-4 overflow-y-auto">
+        <div class="space-y-0.5">
+          <RouterLink
+            v-for="item in topItems"
+            :key="item.to"
+            :to="item.to === '/projects' ? '/projects' : pPath(item.to)"
+            class="flex items-center gap-2 px-2 py-1.5 rounded text-sm text-zinc-400 hover:bg-zinc-900 hover:text-zinc-100 transition-colors"
+            :class="{
+              'bg-zinc-900 text-zinc-100':
+                route.path === (item.to === '/projects' ? '/projects' : pPath(item.to)),
+            }"
+          >
+            <component :is="item.icon" class="w-4 h-4" />
+            {{ item.label }}
+          </RouterLink>
+        </div>
         <div v-for="group in navGroups" :key="group.label">
-          <div class="px-2 pb-1 text-[10px] font-semibold uppercase tracking-wider text-zinc-600">
+          <div
+            class="px-2 pb-1 text-[10px] font-semibold uppercase tracking-wider text-zinc-600 flex items-center gap-1.5"
+          >
+            <component :is="group.icon" class="w-3 h-3" />
             {{ group.label }}
           </div>
           <div class="space-y-0.5">
             <RouterLink
               v-for="item in group.items"
               :key="item.to"
-              :to="item.to"
+              :to="pPath(item.to)"
               class="flex items-center gap-2 px-2 py-1.5 rounded text-sm text-zinc-400 hover:bg-zinc-900 hover:text-zinc-100 transition-colors"
               :class="{
-                'bg-zinc-900 text-zinc-100': route.path === item.to,
+                'bg-zinc-900 text-zinc-100': route.path === pPath(item.to),
               }"
             >
               <component :is="item.icon" class="w-4 h-4" />
@@ -255,7 +370,7 @@ const navGroups = [
       </nav>
       <div class="border-t border-zinc-800 px-4 py-3 text-xs text-zinc-500 space-y-1">
         <div v-if="cache" class="flex items-center justify-between">
-          <span>{{ cache.apps.length }} apps · {{ cache.modules.length }} BCs</span>
+          <span>{{ cache.apps.length }} apps · {{ cache.plugins.length }} plugins</span>
           <button
             class="text-zinc-400 hover:text-zinc-100 transition-colors"
             title="Reload manifest"

package/src/components/SourceDrawer.vue

@@ -11,8 +11,8 @@
  * returns `{ content, language }`. Permission scope is the repo root
  * — the middleware refuses paths outside the cwd.
  */
-import { ref, watch } from "vue";
-import { X } from "lucide-vue-next";
+import { computed, ref, watch } from "vue";
+import { X, ExternalLink } from "lucide-vue-next";
 import MonacoViewer from "./MonacoViewer.vue";
 import SourcePill from "./SourcePill.vue";
 
@@ -22,6 +22,33 @@ const props = defineProps<{
 
 const emit = defineEmits<{ (e: "close"): void }>();
 
+const idePrefix = (): string => {
+  if (typeof localStorage === "undefined") return "vscode://file";
+  const ide = localStorage.getItem("nwire.ide") ?? "vscode";
+  switch (ide) {
+    case "cursor":
+      return "cursor://file";
+    case "zed":
+      return "zed://file";
+    case "idea":
+    case "webstorm":
+    case "jetbrains":
+      return `jetbrains://idea/navigate/reference?path=`;
+    default:
+      return "vscode://file";
+  }
+};
+
+const ideHref = computed(() => {
+  if (!props.source) return undefined;
+  const { file, line, column } = props.source;
+  const prefix = idePrefix();
+  if (prefix.includes("?path=")) {
+    return `${prefix}${encodeURIComponent(file)}:${line}`;
+  }
+  return `${prefix}${file}:${line}${column ? `:${column}` : ""}`;
+});
+
 const content = ref<string>("");
 const language = ref<string>("typescript");
 const loading = ref(false);
@@ -77,13 +104,23 @@ watch(
             <h2 class="text-sm font-medium text-zinc-200 truncate">Source</h2>
             <SourcePill :source="source" compact />
           </div>
-          <button
-            type="button"
-            class="text-zinc-500 hover:text-zinc-300 transition-colors"
-            @click="emit('close')"
-          >
-            <X class="h-4 w-4" />
-          </button>
+          <div class="flex items-center gap-2">
+            <a
+              v-if="ideHref"
+              :href="ideHref"
+              class="inline-flex items-center gap-1.5 rounded-md border border-zinc-800 bg-zinc-900/50 px-2 py-1 text-xs text-zinc-300 hover:text-orange-400 hover:border-orange-500/40 transition-colors"
+            >
+              <ExternalLink class="h-3 w-3" />
+              Open in IDE
+            </a>
+            <button
+              type="button"
+              class="text-zinc-500 hover:text-zinc-300 transition-colors"
+              @click="emit('close')"
+            >
+              <X class="h-4 w-4" />
+            </button>
+          </div>
         </header>
 
         <div class="flex-1 overflow-hidden p-3">

package/src/components/SourcePill.vue

@@ -1,19 +1,16 @@
 <script setup lang="ts">
 /**
- * `SourcePill` — chip that shows a `file:line` source location with a copy
- * button and an "open in IDE" button. Backed by the `source` field every
- * `.nwire/*.json` entry now carries (set at `defineX` call time by
- * `captureSourceLocation()`).
+ * `SourcePill` — chip that shows a `file:line` source location and emits
+ * `click` so the parent can open `SourceDrawer`. The IDE-open button
+ * lives inside the drawer; clicking the pill never bypasses the panel.
  *
- *   <SourcePill :source="action.source" />
+ *   <SourcePill :source="action.source" @click="sourcePreview = action.source" />
  *
- * The IDE-open URI scheme is picked from `localStorage["nwire.ide"]`
- * (default: `vscode`). Supported values: `vscode`, `cursor`, `zed`,
- * `idea`, `webstorm`. Users can change theirs from the Studio Overview
- * "Settings" pane (see `pages/Overview.vue`).
+ * The copy button is still inline for quick `file:line` capture without
+ * opening the drawer.
  */
 import { computed } from "vue";
-import { ExternalLink, Copy, Check } from "lucide-vue-next";
+import { Copy, Check } from "lucide-vue-next";
 import { useCopy } from "../composables/useCopy";
 
 const props = defineProps<{
@@ -22,43 +19,16 @@ const props = defineProps<{
   compact?: boolean;
 }>();
 
+defineEmits<{ (e: "click"): void }>();
+
 const { copy, copied } = useCopy();
 
 const fileSegment = computed(() => {
   if (!props.source) return "";
   const parts = props.source.file.split("/");
-  // Last 2 path segments give enough context without filling the chip.
   return parts.slice(-2).join("/");
 });
 
-const idePrefix = (): string => {
-  if (typeof localStorage === "undefined") return "vscode://file";
-  const ide = localStorage.getItem("nwire.ide") ?? "vscode";
-  switch (ide) {
-    case "cursor":
-      return "cursor://file";
-    case "zed":
-      return "zed://file";
-    case "idea":
-    case "webstorm":
-    case "jetbrains":
-      return `jetbrains://idea/navigate/reference?path=`;
-    default:
-      return "vscode://file";
-  }
-};
-
-const ideHref = computed(() => {
-  if (!props.source) return undefined;
-  const { file, line, column } = props.source;
-  const prefix = idePrefix();
-  // JetBrains uses a query-string scheme; everything else uses path:line:col.
-  if (prefix.includes("?path=")) {
-    return `${prefix}${encodeURIComponent(file)}:${line}`;
-  }
-  return `${prefix}${file}:${line}${column ? `:${column}` : ""}`;
-});
-
 const copyText = computed(() => {
   if (!props.source) return "";
   return `${props.source.file}:${props.source.line}${props.source.column ? `:${props.source.column}` : ""}`;
@@ -72,9 +42,12 @@ const onCopy = (e: Event) => {
 </script>
 
 <template>
-  <div
+  <button
     v-if="source"
-    class="inline-flex items-center gap-1.5 rounded-md border border-zinc-800 bg-zinc-900/50 px-2 py-1 text-xs font-mono text-zinc-400 hover:border-zinc-700 hover:text-zinc-300 transition-colors"
+    type="button"
+    class="inline-flex items-center gap-1.5 rounded-md border border-zinc-800 bg-zinc-900/50 px-2 py-1 text-xs font-mono text-zinc-400 hover:border-zinc-700 hover:text-zinc-100 hover:bg-zinc-900 transition-colors"
+    :title="`Open ${copyText} in Studio's source panel`"
+    @click="$emit('click')"
   >
     <span
       v-if="!compact"
@@ -82,22 +55,14 @@ const onCopy = (e: Event) => {
     >
       source
     </span>
-    <a
-      :href="ideHref"
-      :title="`Open ${copyText} in IDE`"
-      class="inline-flex items-center gap-1 hover:text-orange-400"
-    >
-      {{ fileSegment }}:{{ source.line }}
-      <ExternalLink class="h-3 w-3 opacity-60" />
-    </a>
-    <button
-      type="button"
+    <span>{{ fileSegment }}:{{ source.line }}</span>
+    <span
       :title="copied ? 'Copied!' : `Copy ${copyText}`"
       class="ml-1 inline-flex items-center text-zinc-500 hover:text-zinc-300"
       @click="onCopy"
     >
       <Check v-if="copied" class="h-3 w-3 text-emerald-400" />
       <Copy v-else class="h-3 w-3" />
-    </button>
-  </div>
+    </span>
+  </button>
 </template>

package/src/lib/__tests__/normalize-cache.test.ts

@@ -6,7 +6,6 @@ describe("normalizeCache", () => {
     const { cache, missingFields } = normalizeCache({});
     expect(cache).not.toBeNull();
     expect(cache?.apps).toEqual([]);
-    expect(cache?.modules).toEqual([]);
     expect(cache?.actions).toEqual([]);
     expect(cache?.events).toEqual([]);
     expect(cache?.actors).toEqual([]);
@@ -23,8 +22,7 @@ describe("normalizeCache", () => {
 
   it("preserves arrays that ARE present", () => {
     const input = {
-      apps: [{ name: "x", modules: [] }],
-      modules: [],
+      apps: [{ name: "x", plugins: [] }],
       actions: [],
       events: [],
       actors: [],
@@ -40,6 +38,8 @@ describe("normalizeCache", () => {
       crons: [],
       hooks: [],
       plugins: [],
+      sinks: [],
+      bindings: [],
       graph: { events: [] },
       generatedAt: "2026-05-17T00:00:00Z",
     };
@@ -52,13 +52,12 @@ describe("normalizeCache", () => {
   it("reports the exact list of missing array fields", () => {
     const { missingFields } = normalizeCache({
       apps: [],
-      modules: [],
       actions: [],
       events: [],
       actors: [],
       projections: [],
       queries: [],
-      // resolvers + workflows + graph missing
+      // resolvers + workflows + sinks + graph missing
       routes: [],
       externalCalls: [],
       inboundWebhooks: [],
@@ -68,10 +67,12 @@ describe("normalizeCache", () => {
       generatedAt: "2026-05-17T00:00:00Z",
     });
     expect([...missingFields].sort()).toEqual([
+      "bindings",
       "graph",
       "hooks",
       "plugins",
       "resolvers",
+      "sinks",
       "workflows",
     ]);
   });