camstack 1.2.140 → 1.2.142

package/dist/cli.js

@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-TQKCEWPV.js");
+  await import("./launcher-7S4JDW34.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-TQKCEWPV.js");
+  await import("./launcher-7S4JDW34.js");
 }
 
 // src/commands/setup.ts
@@ -531,6 +531,7 @@ async function deployAddon(addonPath, opts) {
       targets.push({ label: "hub" });
     }
     const outcomes = [];
+    let propagating = false;
     for (const t of targets) {
       console.log(`[camstack] \u2192 Deploying ${path2.basename(tgzPath)} to ${t.label}...`);
       const result = await withNetworkRetry(
@@ -553,6 +554,7 @@ async function deployAddon(addonPath, opts) {
         console.error(`[camstack]   \u2717 ${t.label}: ${misrouted}`);
         outcomes.push({ target: t.label, ok: false, detail: misrouted });
       } else if (result.success) {
+        if (result.propagatingToAgentsInBackground === true) propagating = true;
         const { detail, warning } = describeDeployOutcome(result, t.nodeId !== void 0);
         console.log(`[camstack]   \u2713 ${t.label}: ${detail}`);
         if (warning) console.warn(`[camstack]   \u26A0 ${t.label}: ${warning}`);
@@ -569,6 +571,14 @@ async function deployAddon(addonPath, opts) {
       process.exit(1);
     }
     console.log(`[camstack] \u2713 Deployed to ${outcomes.length} target(s)`);
+    if (propagating) {
+      console.log(
+        "[camstack]   \u2026 agents are updated in the BACKGROUND and are NOT covered by the \u2713 above."
+      );
+      console.log(
+        "[camstack]     Confirm with: hub log line `propagation done` (per-agent success/error)."
+      );
+    }
     if (opts.verify !== false) {
       process.stdout.write("[camstack] Verifying hub health");
       const healthy = await verifyHubHealthy(opts.serverUrl, { attempts: 20, delayMs: 1500 });

package/dist/{launcher-TQKCEWPV.js → launcher-7S4JDW34.js}

@@ -84835,6 +84835,7 @@ var require_sqlite_settings_addon = __commonJS({
             autoPrimaryKey: false
           });
         }
+        this.restorePersistedDeclarations();
         if (await this.isEmpty({ collection: "system-settings" })) await this.seedDefaults();
       }
       requireDeclared(scoped) {
@@ -85646,6 +85647,74 @@ var require_sqlite_settings_addon = __commonJS({
           kvBlobColumn: isKvShape ? "data" : null
         };
       }
+      /**
+      * Where a declaration LIVES, so it outlives the process that made it.
+      *
+      * `declaredCollections` used to be only an in-memory Map, and the
+      * declarations are made once, by each addon, at that addon's own boot.
+      * On 2026-09-12 this backend died with SIGBUS (a second connection
+      * truncated the WAL under its mmap) and `CrashSupervisor` respawned it: the
+      * new instance knew only the canonical KV collections, every other addon
+      * stayed up and never re-declared, and the cluster failed every settings
+      * read for six hours — the operator could not log in.
+      *
+      * The tables are durable. What the backend knows ABOUT them has to be too,
+      * because nothing in the system re-declares and nothing listens for this
+      * process restarting.
+      */
+      static DECLARATIONS_TABLE = "_collection_declarations";
+      /** Create the meta table. Idempotent; called before anything reads it. */
+      ensureDeclarationsTable() {
+        this.getDb().exec(`CREATE TABLE IF NOT EXISTS "${SqliteSettingsBackend2.DECLARATIONS_TABLE}" (name TEXT PRIMARY KEY NOT NULL, decl TEXT NOT NULL)`);
+      }
+      /** Persist one declaration, replacing any earlier shape for the same table. */
+      persistDeclaration(table, decl) {
+        try {
+          this.ensureDeclarationsTable();
+          this.getDb().prepare(`INSERT INTO "${SqliteSettingsBackend2.DECLARATIONS_TABLE}" (name, decl) VALUES (?, ?) ON CONFLICT(name) DO UPDATE SET decl = excluded.decl`).run(table, JSON.stringify({
+            primaryKey: decl.primaryKey,
+            columns: [...decl.columns],
+            booleanColumns: [...decl.booleanColumns],
+            autoPrimaryKey: decl.autoPrimaryKey
+          }));
+        } catch (err) {
+          this.logger?.warn("settings: could not persist a collection declaration", { meta: {
+            table,
+            error: err instanceof Error ? err.message : String(err)
+          } });
+        }
+      }
+      /**
+      * Reload every persisted declaration. Called at init, BEFORE any addon has
+      * had the chance to re-declare — which on a respawn none of them will.
+      */
+      restorePersistedDeclarations() {
+        try {
+          this.ensureDeclarationsTable();
+          const rows = this.getDb().prepare(`SELECT name, decl FROM "${SqliteSettingsBackend2.DECLARATIONS_TABLE}"`).all();
+          let restored = 0;
+          for (const row of rows) {
+            if (this.getDb().prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?").get(row.name) === void 0) continue;
+            const parsed = JSON.parse(row.decl);
+            if (typeof parsed !== "object" || parsed === null) continue;
+            const d = parsed;
+            if (typeof d.primaryKey !== "string" || !Array.isArray(d.columns)) continue;
+            this.declaredCollections.set(row.name, {
+              primaryKey: d.primaryKey,
+              columns: new Set(d.columns.filter((c) => typeof c === "string")),
+              booleanColumns: new Set(Array.isArray(d.booleanColumns) ? d.booleanColumns.filter((c) => typeof c === "string") : []),
+              autoPrimaryKey: d.autoPrimaryKey === true
+            });
+            restored += 1;
+          }
+          if (restored > 0) this.logger?.info("settings: restored collection declarations from disk", { meta: {
+            restored,
+            total: rows.length
+          } });
+        } catch (err) {
+          this.logger?.warn("settings: could not restore collection declarations", { meta: { error: err instanceof Error ? err.message : String(err) } });
+        }
+      }
       async declareCollection(input) {
         const table = this.scopedName(input.namespace, input.collection);
         const columns = input.columns.some((c) => c.primaryKey === true) ? input.columns : [{
@@ -85672,14 +85741,14 @@ var require_sqlite_settings_addon = __commonJS({
         await this.ensureTable(table, schema);
         const pkCol = columns.find((c) => c.primaryKey === true);
         const primaryKey = pkCol ? pkCol.name : "id";
-        const columnNames = new Set(columns.filter((c) => c.name !== primaryKey).map((c) => c.name));
-        const booleanColumns = new Set(columns.filter((c) => c.type === "BOOLEAN").map((c) => c.name));
-        this.declaredCollections.set(table, {
+        const decl = {
           primaryKey,
-          columns: columnNames,
-          booleanColumns,
+          columns: new Set(columns.filter((c) => c.name !== primaryKey).map((c) => c.name)),
+          booleanColumns: new Set(columns.filter((c) => c.type === "BOOLEAN").map((c) => c.name)),
           autoPrimaryKey: pkCol?.type === "INTEGER"
-        });
+        };
+        this.declaredCollections.set(table, decl);
+        this.persistDeclaration(table, decl);
       }
       /** Serialise per-column values for SQL binding: objects → JSON, booleans → 0/1. */
       serializeColumnValue(v) {
@@ -121242,9 +121311,9 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-system-deps-DfpwaXkh.js
-var require_manifest_system_deps_DfpwaXkh = __commonJS({
-  "../system/dist/manifest-system-deps-DfpwaXkh.js"(exports) {
+// ../system/dist/manifest-system-deps-YYKKCKSF.js
+var require_manifest_system_deps_YYKKCKSF = __commonJS({
+  "../system/dist/manifest-system-deps-YYKKCKSF.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
     require_hub_cap_forward_DmHNjbB0();
@@ -121294,7 +121363,9 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
             childrenConnected: listed.length,
             childrenUndeclared: registry.undeclaredChildCount(),
             crossNodeDelivered: crossNode?.delivered ?? 0,
-            crossNodeSuppressed: crossNode?.suppressed ?? 0
+            crossNodeSuppressed: crossNode?.suppressed ?? 0,
+            categories: registry.categoryFanout(),
+            categoryOverflow: registry.categoryCensusOverflow()
           };
         } catch {
           return;
@@ -121304,8 +121375,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
     var EVENT_PLANE_TOP_N = 5;
     var EMPTY_EVENT_PLANE_BASELINE = {
       children: /* @__PURE__ */ new Map(),
+      categories: /* @__PURE__ */ new Map(),
       crossNodeDelivered: 0,
-      crossNodeSuppressed: 0
+      crossNodeSuppressed: 0,
+      categoryOverflow: 0
     };
     function diffEventPlane(baseline, current, topN = 5) {
       const deltas = [];
@@ -121323,6 +121396,23 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
           suppressed
         });
       }
+      const categoryDeltas = [];
+      let categoryBroadcasts = 0;
+      let orphanBroadcasts = 0;
+      for (const sample of current.categories) {
+        const before = baseline.categories.get(sample.category);
+        const broadcasts = Math.max(0, sample.broadcasts - (before?.broadcasts ?? 0));
+        if (broadcasts === 0) continue;
+        const wanted = Math.max(0, sample.wanted - (before?.wanted ?? 0));
+        categoryBroadcasts += broadcasts;
+        if (wanted === 0) orphanBroadcasts += broadcasts;
+        categoryDeltas.push({
+          category: sample.category,
+          broadcasts,
+          wanted
+        });
+      }
+      const byBroadcasts = categoryDeltas.toSorted((a, b) => b.broadcasts - a.broadcasts || a.category.localeCompare(b.category));
       return {
         udsMode: current.udsMode,
         crossNodeMode: current.crossNodeMode,
@@ -121332,7 +121422,12 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         fanoutSuppressed,
         crossNodeDelivered: Math.max(0, current.crossNodeDelivered - baseline.crossNodeDelivered),
         crossNodeSuppressed: Math.max(0, current.crossNodeSuppressed - baseline.crossNodeSuppressed),
-        top: deltas.toSorted((a, b) => b.sent - a.sent || a.childId.localeCompare(b.childId)).slice(0, topN)
+        top: deltas.toSorted((a, b) => b.sent - a.sent || a.childId.localeCompare(b.childId)).slice(0, topN),
+        categoryBroadcasts,
+        orphanBroadcasts,
+        topCategories: byBroadcasts.slice(0, topN),
+        topOrphans: byBroadcasts.filter((c) => c.wanted === 0).slice(0, topN),
+        categoryOverflow: Math.max(0, current.categoryOverflow - baseline.categoryOverflow)
       };
     }
     function createEventPlaneMeter(reader, topN = 5) {
@@ -121343,8 +121438,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         const window2 = diffEventPlane(baseline, current, topN);
         baseline = {
           children: new Map(current.children.map((s) => [s.childId, s])),
+          categories: new Map(current.categories.map((c) => [c.category, c])),
           crossNodeDelivered: current.crossNodeDelivered,
-          crossNodeSuppressed: current.crossNodeSuppressed
+          crossNodeSuppressed: current.crossNodeSuppressed,
+          categoryOverflow: current.categoryOverflow
         };
         return window2;
       } };
@@ -121352,7 +121449,9 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
     function formatEventPlane(window2) {
       if (window2 === void 0) return "";
       const top = window2.top.map((d) => `${d.childId}:${d.sent}/${d.suppressed}`).join(",");
-      return ` fanoutMode=uds:${window2.udsMode}/cross-node:${window2.crossNodeMode} children=${window2.childrenConnected} childrenUndeclared=${window2.childrenUndeclared} fanoutSent=${window2.fanoutSent} fanoutSuppressed=${window2.fanoutSuppressed} crossNodeDelivered=${window2.crossNodeDelivered} crossNodeSuppressed=${window2.crossNodeSuppressed}` + (top.length === 0 ? "" : ` fanoutTop=${top}`);
+      const cats = window2.topCategories.map((c) => `${c.category}:${c.broadcasts}/${c.wanted}`).join(",");
+      const orphans = window2.topOrphans.map((c) => `${c.category}:${c.broadcasts}`).join(",");
+      return ` fanoutMode=uds:${window2.udsMode}/cross-node:${window2.crossNodeMode} children=${window2.childrenConnected} childrenUndeclared=${window2.childrenUndeclared} fanoutSent=${window2.fanoutSent} fanoutSuppressed=${window2.fanoutSuppressed} crossNodeDelivered=${window2.crossNodeDelivered} crossNodeSuppressed=${window2.crossNodeSuppressed} fanoutEvents=${window2.categoryBroadcasts} fanoutOrphans=${window2.orphanBroadcasts} fanoutCatsDropped=${window2.categoryOverflow}` + (top.length === 0 ? "" : ` fanoutTop=${top}`) + (cats.length === 0 ? "" : ` fanoutCats=${cats}`) + (orphans.length === 0 ? "" : ` fanoutOrphanTop=${orphans}`);
     }
     var EMPTY_CAP_ACTION_READING = /* @__PURE__ */ new Map();
     var CAP_ACTION_UNLABELLED = "(unlabelled)";
@@ -126423,6 +126522,12 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
       fanoutMode = readFanoutMode();
       /** Per-child event fan-out counters (sent / suppressed). */
       childEventStats = /* @__PURE__ */ new Map();
+      /** D467: per-category production census (cumulative). See {@link CategoryFanoutSample}. */
+      categoryStats = /* @__PURE__ */ new Map();
+      /** Broadcasts whose category did not fit in {@link CATEGORY_CENSUS_MAX}. */
+      categoryOverflow = 0;
+      /** One INFO line the first time the census cap trips, never per event. */
+      categoryOverflowLogged = false;
       /** Last pattern-set string logged per child, to dedup the INFO line. */
       loggedPatternSet = /* @__PURE__ */ new Map();
       /**
@@ -126478,6 +126583,25 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
         };
       }
       /**
+      * D467: every category this node has broadcast, with its emit count and how
+      * many child subscriptions matched. Cumulative for the life of the process —
+      * the heartbeat differences it, the same discipline as the per-child
+      * counters. Largest `broadcasts` first.
+      */
+      categoryFanout() {
+        const out = [];
+        for (const [category, s] of this.categoryStats) out.push({
+          category,
+          broadcasts: s.broadcasts,
+          wanted: s.wanted
+        });
+        return out.toSorted((a, b) => b.broadcasts - a.broadcasts || a.category.localeCompare(b.category));
+      }
+      /** Broadcasts the census could not attribute because it was full (cumulative). */
+      categoryCensusOverflow() {
+        return this.categoryOverflow;
+      }
+      /**
       * This child's socket traffic — bytes and messages, both directions, split by
       * frame kind — or `null` when the child is gone or its channel keeps no
       * counters (an in-process or test transport).
@@ -126568,6 +126692,17 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
       */
       childWantsEvent(entry, category) {
         if (this.fanoutMode === "broadcast") return true;
+        return this.childSubscribesTo(entry, category);
+      }
+      /**
+      * The SUBSCRIPTION answer alone, with no fan-out-mode override.
+      *
+      * {@link childWantsEvent} answers "will this child be sent the event", which
+      * under `broadcast` is `true` for everything and therefore cannot say whether
+      * anyone actually asked. The D467 census needs the second question, so the
+      * two are separate functions and `broadcast` mode overrides only the first.
+      */
+      childSubscribesTo(entry, category) {
         if (entry.eventPatterns === null) return true;
         return entry.eventPatterns.some((p) => matchesPattern(p, category));
       }
@@ -126870,8 +127005,10 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
           event,
           sourceNodeId
         };
+        let subscribed = 0;
         for (const entry of this.children.values()) {
           if (entry.childId === exceptChildId) continue;
+          if (this.childSubscribesTo(entry, event.category)) subscribed += 1;
           const wants = this.childWantsEvent(entry, event.category);
           const stats = this.statsFor(entry.childId);
           if (!wants) stats.suppressed++;
@@ -126880,6 +127017,34 @@ var require_manifest_system_deps_DfpwaXkh = __commonJS({
             entry.channel.emit(msg);
           }
         }
+        this.recordCategoryBroadcast(event.category, subscribed);
+      }
+      /**
+      * Record one PRODUCED event against its category. Called once per broadcast,
+      * outside the per-child loop, because production is what the census measures.
+      */
+      recordCategoryBroadcast(category, subscribed) {
+        const existing = this.categoryStats.get(category);
+        if (existing !== void 0) {
+          existing.broadcasts += 1;
+          existing.wanted += subscribed;
+          return;
+        }
+        if (this.categoryStats.size >= 256) {
+          this.categoryOverflow += 1;
+          if (!this.categoryOverflowLogged) {
+            this.categoryOverflowLogged = true;
+            this.logger?.info("event category census full \u2014 further new categories are unattributed", {
+              max: 256,
+              firstDropped: category
+            });
+          }
+          return;
+        }
+        this.categoryStats.set(category, {
+          broadcasts: 1,
+          wanted: subscribed
+        });
       }
       /**
       * E2: Send a `set-log-level` control message to a specific child.
@@ -134414,7 +134579,7 @@ var require_dist3 = __commonJS({
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_event_loop_stall_monitor = require_event_loop_stall_monitor_CAsHdMwP();
     var require_tls$1 = require_tls_BFs4PzoW();
-    var require_manifest_system_deps = require_manifest_system_deps_DfpwaXkh();
+    var require_manifest_system_deps = require_manifest_system_deps_YYKKCKSF();
     var require_resource_monitor = require_resource_monitor_LVE1BoLs();
     var require_custom_action_registry = require_custom_action_registry_DvVMHLfJ();
     var zod = require_zod();
@@ -199117,8 +199282,9 @@ ${originalIndentation}`;
             const type2 = resolvePacketType(packet[5]);
             this.emit("data", type2, msg);
             const rest = packet.slice(length);
-            this.bufs = rest.length > 0 ? [rest] : [];
-            this.bufLen = rest.length;
+            const carried = rest.length > 0 && rest.length * 8 < rest.buffer.byteLength ? Buffer.from(rest) : rest;
+            this.bufs = carried.length > 0 ? [carried] : [];
+            this.bufLen = carried.length;
           }
           cb();
         }
@@ -357688,8 +357854,10 @@ var require_parser2 = __commonJS({
           const type = resolvePacketType(packet[5]);
           this.emit("data", type, msg);
           const rest = packet.slice(length);
-          this.bufs = rest.length > 0 ? [rest] : [];
-          this.bufLen = rest.length;
+          const pinsTooMuch = rest.length > 0 && rest.length * 8 < rest.buffer.byteLength;
+          const carried = pinsTooMuch ? Buffer.from(rest) : rest;
+          this.bufs = carried.length > 0 ? [carried] : [];
+          this.bufLen = carried.length;
         }
         cb();
       }
@@ -414053,7 +414221,7 @@ var require_agent_addon_delivery = __commonJS({
     exports.AGENT_RELOAD_TIMEOUT_MS = exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = void 0;
     exports.isAgentDeployResponse = isAgentDeployResponse;
     exports.deliverAddonToAgent = deliverAddonToAgent;
-    exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = 3e4;
+    exports.AGENT_DEPLOY_CONTROL_TIMEOUT_MS = 3e5;
     exports.AGENT_RELOAD_TIMEOUT_MS = 6e4;
     function isAgentDeployResponse(value) {
       if (value === null || typeof value !== "object")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.140",
+  "version": "1.2.142",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",