camstack 1.2.140 → 1.2.141

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-VU6P7QP5.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-VU6P7QP5.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-VU6P7QP5.js}

@@ -121242,9 +121242,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 +121294,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 +121306,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 +121327,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 +121353,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 +121369,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 +121380,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 +126453,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 +126514,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 +126623,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 +126936,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 +126948,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 +134510,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 +199213,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 +357785,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 +414152,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.141",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",