camstack 1.2.90 → 1.2.92

package/dist/{chunk-BLJRLA7I.js → chunk-KFUPFPP3.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-B195W080.mjs
+// ../types/dist/sleep-CbBk_3GJ.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -20596,7 +20596,7 @@ var ConfigEntrySchema2 = external_exports.object({
   value: external_exports.unknown(),
   description: external_exports.string().optional()
 });
-var LinkedDevicesModeSchema = external_exports.enum(["auto", "manual"]);
+var LinkedDevicesModeSchema = external_exports.enum(["manual"]);
 var LinkedDeviceSchema = external_exports.object({
   deviceId: external_exports.number(),
   name: external_exports.string(),
@@ -26134,6 +26134,21 @@ var TrackFlagFields = {
   markForTrain: external_exports.boolean().optional(),
   /** Operator marked this track for diagnostic attention. */
   debug: external_exports.boolean().optional(),
+  /**
+  * What the operator wants CHECKED on this track, in their own words.
+  *
+  * The flag alone says "look at this" and nothing about what for; a debug set
+  * reviewed hours later is a list of tracks with no question attached. Bound
+  * to `debug` on the WRITE side — the body clears it when `debug` goes off,
+  * and refuses it on a track whose debug is off — so a note can never outlive
+  * the attention it belongs to.
+  *
+  * `''` is a real value ("marked, nothing to add"); the ABSENT key means
+  * "leave whatever is stored alone", which is what lets a surface turn debug
+  * on without a note (a cancelled prompt) and what lets it edit the note
+  * without touching the flag.
+  */
+  debugNote: external_exports.string().max(500).optional(),
   /** Operator favourited this track. Pins it against pruning. */
   favourited: external_exports.boolean().optional()
 };
@@ -26143,6 +26158,12 @@ var TrackFlagsSchema = external_exports.object({
   trackId: external_exports.string(),
   markForTrain: external_exports.boolean(),
   debug: external_exports.boolean(),
+  /** The note as it STANDS after the write — never absent here (a track with no
+  *  note reports `''`), for the same reason the booleans are required: a
+  *  surface that has just written must be able to render the note it now owns
+  *  without a re-fetch, and an absent key would read as "unchanged" on a
+  *  screen that has no previous value to keep. */
+  debugNote: external_exports.string(),
   favourited: external_exports.boolean(),
   /** The lifecycle state the boolean was derived from. Required here (unlike on
   *  a track row) because this shape is only ever produced by the write body,
@@ -27197,11 +27218,20 @@ var pipelineAnalyticsCapability = {
     * staging is a deliberate action of the retrain page, which is also the only
     * thing that produces `trained` in the first place.
     *
-    * Returns the RESOLVED state of both flags (absent → `false`) plus the
-    * `retrainStatus` they were derived from, so a caller can drive its toggle
-    * — and render a `trained` badge — without a re-fetch. Rejects an unknown
-    * track, a new staging mark on a device already holding its full budget, and
-    * any `markForTrain` write against a trained track.
+    * `debugNote` is the operator's sentence about WHAT to check on this track,
+    * and it is bound to `debug`: writing `debug: false` clears it in the same
+    * statement, and a note sent for a track whose debug is off (and is not
+    * being turned on) is DROPPED with a warning rather than stored where
+    * nothing will ever read it. An omitted `debugNote` leaves the stored one
+    * alone — which is what lets a surface turn debug on when the operator
+    * declined to type anything, without that refusal costing them the flag.
+    *
+    * Returns the RESOLVED state of all three flags (absent → `false`) plus the
+    * note (absent → `''`) and the `retrainStatus` they were derived from, so a
+    * caller can drive its toggle — and render a `trained` badge — without a
+    * re-fetch. Rejects an unknown track, a new staging mark on a device already
+    * holding its full budget, and any `markForTrain` write against a trained
+    * track.
     */
     setTrackFlags: method(external_exports.object({
       /** Log/audit scope only — the trackId is globally unique on its own. */

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-BLJRLA7I.js";
+} from "./chunk-KFUPFPP3.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-7KH64TCV.js");
+  await import("./launcher-7Z35E2WM.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-7KH64TCV.js");
+  await import("./launcher-7Z35E2WM.js");
 }
 
 // src/commands/setup.ts
@@ -1130,7 +1130,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-FHE2CTRJ.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-5KWSHFNI.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-FHE2CTRJ.js → discover-5KWSHFNI.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-BLJRLA7I.js";
+} from "./chunk-KFUPFPP3.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-7KH64TCV.js → launcher-7Z35E2WM.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-DE3OH-FG.js
-var require_dist_DE3OH_FG = __commonJS({
-  "../system/dist/dist-DE3OH-FG.js"(exports) {
+// ../system/dist/dist-DNwhsXWi.js
+var require_dist_DNwhsXWi = __commonJS({
+  "../system/dist/dist-DNwhsXWi.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -31309,7 +31309,7 @@ var require_dist_DE3OH_FG = __commonJS({
       value: zod.z.unknown(),
       description: zod.z.string().optional()
     });
-    var LinkedDevicesModeSchema = zod.z.enum(["auto", "manual"]);
+    var LinkedDevicesModeSchema = zod.z.enum(["manual"]);
     var LinkedDeviceSchema = zod.z.object({
       deviceId: zod.z.number(),
       name: zod.z.string(),
@@ -36840,6 +36840,21 @@ var require_dist_DE3OH_FG = __commonJS({
       markForTrain: zod.z.boolean().optional(),
       /** Operator marked this track for diagnostic attention. */
       debug: zod.z.boolean().optional(),
+      /**
+      * What the operator wants CHECKED on this track, in their own words.
+      *
+      * The flag alone says "look at this" and nothing about what for; a debug set
+      * reviewed hours later is a list of tracks with no question attached. Bound
+      * to `debug` on the WRITE side — the body clears it when `debug` goes off,
+      * and refuses it on a track whose debug is off — so a note can never outlive
+      * the attention it belongs to.
+      *
+      * `''` is a real value ("marked, nothing to add"); the ABSENT key means
+      * "leave whatever is stored alone", which is what lets a surface turn debug
+      * on without a note (a cancelled prompt) and what lets it edit the note
+      * without touching the flag.
+      */
+      debugNote: zod.z.string().max(500).optional(),
       /** Operator favourited this track. Pins it against pruning. */
       favourited: zod.z.boolean().optional()
     };
@@ -36849,6 +36864,12 @@ var require_dist_DE3OH_FG = __commonJS({
       trackId: zod.z.string(),
       markForTrain: zod.z.boolean(),
       debug: zod.z.boolean(),
+      /** The note as it STANDS after the write — never absent here (a track with no
+      *  note reports `''`), for the same reason the booleans are required: a
+      *  surface that has just written must be able to render the note it now owns
+      *  without a re-fetch, and an absent key would read as "unchanged" on a
+      *  screen that has no previous value to keep. */
+      debugNote: zod.z.string(),
       favourited: zod.z.boolean(),
       /** The lifecycle state the boolean was derived from. Required here (unlike on
       *  a track row) because this shape is only ever produced by the write body,
@@ -37902,11 +37923,20 @@ var require_dist_DE3OH_FG = __commonJS({
         * staging is a deliberate action of the retrain page, which is also the only
         * thing that produces `trained` in the first place.
         *
-        * Returns the RESOLVED state of both flags (absent → `false`) plus the
-        * `retrainStatus` they were derived from, so a caller can drive its toggle
-        * — and render a `trained` badge — without a re-fetch. Rejects an unknown
-        * track, a new staging mark on a device already holding its full budget, and
-        * any `markForTrain` write against a trained track.
+        * `debugNote` is the operator's sentence about WHAT to check on this track,
+        * and it is bound to `debug`: writing `debug: false` clears it in the same
+        * statement, and a note sent for a track whose debug is off (and is not
+        * being turned on) is DROPPED with a warning rather than stored where
+        * nothing will ever read it. An omitted `debugNote` leaves the stored one
+        * alone — which is what lets a surface turn debug on when the operator
+        * declined to type anything, without that refusal costing them the flag.
+        *
+        * Returns the RESOLVED state of all three flags (absent → `false`) plus the
+        * note (absent → `''`) and the `retrainStatus` they were derived from, so a
+        * caller can drive its toggle — and render a `trained` badge — without a
+        * re-fetch. Rejects an unknown track, a new staging mark on a device already
+        * holding its full budget, and any `markForTrain` write against a trained
+        * track.
         */
         setTrackFlags: method(zod.z.object({
           /** Log/audit scope only — the trackId is globally unique on its own. */
@@ -60079,7 +60109,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -60898,7 +60928,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -60992,7 +61022,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -61889,11 +61919,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-BgUS9Rr3.js
-var require_retired_settings_keys_BgUS9Rr3 = __commonJS({
-  "../system/dist/retired-settings-keys-BgUS9Rr3.js"(exports) {
+// ../system/dist/retired-settings-keys-CUXClAIQ.js
+var require_retired_settings_keys_CUXClAIQ = __commonJS({
+  "../system/dist/retired-settings-keys-CUXClAIQ.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -64107,8 +64137,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
-    var require_retired_settings_keys = require_retired_settings_keys_BgUS9Rr3();
+    var require_dist10 = require_dist_DNwhsXWi();
+    var require_retired_settings_keys = require_retired_settings_keys_CUXClAIQ();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -65729,7 +65759,7 @@ var require_device_manager_addon = __commonJS({
     var LINKED_IDS_CONFIG_KEY = "_linkedDeviceIds";
     var LINKED_TRACKED_IDS_CONFIG_KEY = "_linkedDeviceTrackedIds";
     function parseLinkedDevicesConfig(blob) {
-      const mode = blob["_linkedDevicesMode"] === "manual" ? "manual" : "auto";
+      const mode = "manual";
       const rawIds = blob[LINKED_IDS_CONFIG_KEY];
       const manualIds = [];
       if (Array.isArray(rawIds)) for (const v of rawIds) {
@@ -65761,7 +65791,7 @@ var require_device_manager_addon = __commonJS({
       if (primary !== null) expandContainer(primary.id, byId, byParent, nextVisited, out);
     }
     function resolveLinkedDeviceIds(params) {
-      const { selfId, selfLocation, config, candidates } = params;
+      const { selfId, config, candidates } = params;
       const byId = new Map(candidates.map((c) => [c.id, c]));
       const byParent = /* @__PURE__ */ new Map();
       for (const c of candidates) {
@@ -65773,99 +65803,52 @@ var require_device_manager_addon = __commonJS({
       const ids = /* @__PURE__ */ new Set();
       const expand = (id) => expandContainer(id, byId, byParent, /* @__PURE__ */ new Set(), ids);
       for (const c of candidates) if (c.parentDeviceId === selfId) expand(c.id);
-      if (config.mode === "auto") {
-        if (selfLocation !== null && selfLocation.length > 0) for (const c of candidates) {
-          if (c.type === require_dist10.DeviceType.Container) continue;
-          if (c.location !== selfLocation) continue;
-          const parent = c.parentDeviceId !== null ? byId.get(c.parentDeviceId) : void 0;
-          if (parent !== void 0 && parent.type === require_dist10.DeviceType.Container) {
-            expand(parent.id);
-            continue;
-          }
-          ids.add(c.id);
-        }
-      } else for (const id of config.manualIds) if (byId.has(id)) expand(id);
+      for (const id of config.manualIds) if (byId.has(id)) expand(id);
       ids.delete(selfId);
       return [...ids];
     }
-    function resolveTrackedEventDeviceIds(config, linkedIds) {
-      const raw = config[LINKED_TRACKED_IDS_CONFIG_KEY];
-      if (!Array.isArray(raw)) return [];
-      const picked = /* @__PURE__ */ new Set();
-      for (const v of raw) {
-        const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
-        if (Number.isInteger(n)) picked.add(n);
-      }
-      return linkedIds.filter((id) => picked.has(id));
-    }
-    var LINK_CANDIDATE_PROJECTION = { projection: "slim" };
-    function findLocationInvisibleContainers(params) {
-      const { selfId, selfLocation, resolvedIds, candidates } = params;
+    function legacyAutoLinkIds(params) {
+      const { selfId, selfLocation, candidates } = params;
       if (selfLocation === null || selfLocation.length === 0) return [];
+      const byId = new Map(candidates.map((c) => [c.id, c]));
       const byParent = /* @__PURE__ */ new Map();
       for (const c of candidates) {
         if (c.parentDeviceId === null) continue;
-        const bucket = byParent.get(c.parentDeviceId);
-        if (bucket) bucket.push(c);
+        const siblings = byParent.get(c.parentDeviceId);
+        if (siblings) siblings.push(c);
         else byParent.set(c.parentDeviceId, [c]);
       }
-      const out = [];
+      const ids = /* @__PURE__ */ new Set();
+      const expand = (id) => expandContainer(id, byId, byParent, /* @__PURE__ */ new Set(), ids);
       for (const c of candidates) {
-        if (c.type !== require_dist10.DeviceType.Container) continue;
-        if (c.id === selfId) continue;
+        if (c.type === require_dist10.DeviceType.Container) continue;
         if (c.location !== selfLocation) continue;
-        let anyResolved = false;
-        let anyNullLocation = false;
-        let descendantCount = 0;
-        const visited = /* @__PURE__ */ new Set([c.id]);
-        let frontier = [c.id];
-        while (frontier.length > 0) {
-          const next = [];
-          for (const parentId of frontier) for (const child of byParent.get(parentId) ?? []) {
-            if (visited.has(child.id)) continue;
-            visited.add(child.id);
-            descendantCount += 1;
-            if (resolvedIds.has(child.id)) anyResolved = true;
-            if (child.location === null) anyNullLocation = true;
-            next.push(child.id);
-          }
-          frontier = next;
-        }
-        if (descendantCount > 0 && !anyResolved && anyNullLocation) out.push(c.id);
+        if (c.parentDeviceId === selfId) continue;
+        const parent = c.parentDeviceId !== null ? byId.get(c.parentDeviceId) : void 0;
+        if (parent !== void 0 && parent.type === require_dist10.DeviceType.Container) {
+          expand(parent.id);
+          continue;
+        }
+        ids.add(c.id);
       }
-      return out;
+      ids.delete(selfId);
+      return [...ids];
     }
-    var INVISIBLE_CONTAINER_WARN_CAP = 4096;
-    var warnedInvisibleContainers = /* @__PURE__ */ new Set();
-    function warnLocationInvisibleContainers(pctx, cameraId, byId, all, resolved) {
-      if (resolved.mode !== "auto") return;
-      const selfLocation = byId.get(cameraId)?.location ?? null;
-      if (selfLocation === null || selfLocation.length === 0) return;
-      const invisible = findLocationInvisibleContainers({
-        selfId: cameraId,
-        selfLocation,
-        resolvedIds: new Set(resolved.devices.map((d) => d.deviceId)),
-        candidates: all
-      });
-      for (const containerId of invisible) {
-        const key = `${cameraId}:${containerId}`;
-        if (warnedInvisibleContainers.has(key)) continue;
-        if (warnedInvisibleContainers.size >= INVISIBLE_CONTAINER_WARN_CAP) return;
-        warnedInvisibleContainers.add(key);
-        pctx.host.ctx.logger.warn("getLinkedDevices: container matches the camera location but is invisible to auto-link \u2014 its children carry no location; re-save the container location to realign", {
-          tags: { deviceId: containerId },
-          meta: {
-            cameraId,
-            location: selfLocation
-          }
-        });
+    function resolveTrackedEventDeviceIds(config, linkedIds) {
+      const raw = config[LINKED_TRACKED_IDS_CONFIG_KEY];
+      if (!Array.isArray(raw)) return [];
+      const picked = /* @__PURE__ */ new Set();
+      for (const v of raw) {
+        const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+        if (Number.isInteger(n)) picked.add(n);
       }
+      return linkedIds.filter((id) => picked.has(id));
     }
+    var LINK_CANDIDATE_PROJECTION = { projection: "slim" };
     function resolveFor(deviceId, all, byId, blob) {
       const config = parseLinkedDevicesConfig(blob);
       const ids = resolveLinkedDeviceIds({
         selfId: deviceId,
-        selfLocation: byId.get(deviceId)?.location ?? null,
         config,
         candidates: all
       });
@@ -65890,10 +65873,7 @@ var require_device_manager_addon = __commonJS({
     async function getLinkedDevices(pctx, input) {
       const { deviceId } = input;
       const [all, blob] = await Promise.all([listAll(pctx, LINK_CANDIDATE_PROJECTION), pctx.settings.readDeviceStore(deviceId)]);
-      const byId = new Map(all.map((d) => [d.id, d]));
-      const resolved = resolveFor(deviceId, all, byId, blob);
-      warnLocationInvisibleContainers(pctx, deviceId, byId, all, resolved);
-      return resolved;
+      return resolveFor(deviceId, all, new Map(all.map((d) => [d.id, d])), blob);
     }
     async function getLinkedDevicesBatch(pctx, input) {
       const deviceIds = [...new Set(input.deviceIds)];
@@ -65907,11 +65887,9 @@ var require_device_manager_addon = __commonJS({
       })))]);
       const byId = new Map(all.map((d) => [d.id, d]));
       return deviceIds.map((deviceId, index) => {
-        const resolved = resolveFor(deviceId, all, byId, blobs[index] ?? {});
-        warnLocationInvisibleContainers(pctx, deviceId, byId, all, resolved);
         return {
           deviceId,
-          ...resolved
+          ...resolveFor(deviceId, all, byId, blobs[index] ?? {})
         };
       });
     }
@@ -65920,13 +65898,9 @@ var require_device_manager_addon = __commonJS({
       if (!persisted || persisted.meta.type !== require_dist10.DeviceType.Camera) return null;
       const [all, blob] = await Promise.all([listAll(pctx, LINK_CANDIDATE_PROJECTION), pctx.settings.readDeviceStore(deviceId)]);
       const config = parseLinkedDevicesConfig(blob);
-      const options = all.filter((d) => d.id !== deviceId && d.type !== require_dist10.DeviceType.Container).map((d) => ({
-        value: String(d.id),
-        label: d.location !== null ? `${d.name} (${d.location})` : d.name
-      }));
+      const self2 = all.find((d) => d.id === deviceId);
       const linkedIds = resolveLinkedDeviceIds({
         selfId: deviceId,
-        selfLocation: all.find((d) => d.id === deviceId)?.location ?? null,
         config,
         candidates: all
       });
@@ -65943,49 +65917,31 @@ var require_device_manager_addon = __commonJS({
       return { sections: [{
         id: "linked-devices",
         title: "Linked devices",
-        description: "Companion devices associated with this camera. Device-tree children are always linked; auto mode also links every device sharing the camera location, manual mode links the picked list instead.",
+        description: "Companion devices associated with this camera. Device-tree children are always linked; everything else is the list you pick below. Devices in the same location are suggested first, never linked on their own (D356).",
         order: 70,
-        fields: [
-          {
-            type: "select",
-            key: LINKED_MODE_CONFIG_KEY,
-            label: "Link mode",
-            description: "Auto: children + same-location devices. Manual: children + the list below.",
-            options: [{
-              value: "auto",
-              label: "Auto (location-based)"
-            }, {
-              value: "manual",
-              label: "Manual"
-            }],
-            value: config.mode
-          },
-          {
-            type: "multiselect",
-            key: LINKED_IDS_CONFIG_KEY,
-            label: "Manually linked devices",
-            description: "Used in manual mode (children stay linked regardless).",
-            showWhen: {
-              field: LINKED_MODE_CONFIG_KEY,
-              equals: "manual"
-            },
-            options,
-            value: config.manualIds.map(String)
+        fields: [{
+          type: "device-multiselect",
+          key: LINKED_IDS_CONFIG_KEY,
+          label: "Linked devices",
+          description: "Pick the companions of this camera. Same-location devices are suggested; device-tree children stay linked regardless.",
+          deviceFilter: {
+            excludeDeviceId: deviceId,
+            excludeTypes: [require_dist10.DeviceType.Container]
           },
-          {
-            type: "multiselect",
-            key: LINKED_TRACKED_IDS_CONFIG_KEY,
-            label: "Devices that produce tracked events",
-            description: "Linked devices whose state changes materialize a synthetic tracked event on this camera. Default: none (opt-in).",
-            options: trackedOptions,
-            value: trackedValue
-          }
-        ]
+          suggestLocation: self2?.location ?? null,
+          value: config.manualIds.map(String)
+        }, {
+          type: "multiselect",
+          key: LINKED_TRACKED_IDS_CONFIG_KEY,
+          label: "Devices that produce tracked events",
+          description: "Linked devices whose state changes materialize a synthetic tracked event on this camera. Default: none (opt-in).",
+          options: trackedOptions,
+          value: trackedValue
+        }]
       }] };
     }
     async function applyLinkedDevicesPatch(pctx, deviceId, patch) {
       const next = { ...await pctx.settings.readDeviceStore(deviceId) };
-      if ("_linkedDevicesMode" in patch) next[LINKED_MODE_CONFIG_KEY] = patch["_linkedDevicesMode"] === "manual" ? "manual" : "auto";
       if ("_linkedDeviceIds" in patch) next[LINKED_IDS_CONFIG_KEY] = [...parseLinkedDevicesConfig({ [LINKED_IDS_CONFIG_KEY]: patch[LINKED_IDS_CONFIG_KEY] }).manualIds];
       if ("_linkedDeviceTrackedIds" in patch) {
         const raw = patch[LINKED_TRACKED_IDS_CONFIG_KEY];
@@ -66949,7 +66905,7 @@ var require_device_manager_addon = __commonJS({
         });
       }
       const residual = planNullLocationFills((!repaired && bootRows !== void 0 ? bootRows : await pctx.metaStore.rows.listAll()).map((r) => r.meta));
-      for (const [ancestorId, fills] of groupByAncestor(residual)) logger.warn("location cascade misaligned \u2014 location-less descendants under a located ancestor never match location auto-link; re-save the ancestor location to realign", {
+      for (const [ancestorId, fills] of groupByAncestor(residual)) logger.warn("location cascade misaligned \u2014 location-less descendants under a located ancestor never reach the same-location suggestions of the picker; re-save the ancestor location to realign", {
         tags: { deviceId: ancestorId },
         meta: {
           location: fills[0]?.location,
@@ -67846,6 +67802,64 @@ var require_device_manager_addon = __commonJS({
         }
       });
     }
+    var LINKED_MANUAL_BACKFILL_MARKER_KEY = "_linkedDevicesManualBackfillVersion";
+    function planManualBackfill(params) {
+      const { selfId, selfLocation, blob, candidates } = params;
+      const current = parseLinkedDevicesConfig(blob).manualIds;
+      if (blob["_linkedDevicesMode"] === "manual") return {
+        write: false,
+        manualIds: current
+      };
+      const merged = [...current];
+      for (const id of legacyAutoLinkIds({
+        selfId,
+        selfLocation,
+        candidates
+      })) if (!merged.includes(id)) merged.push(id);
+      return {
+        write: true,
+        manualIds: merged
+      };
+    }
+    async function runLinkedDevicesManualBackfillAtBoot(pctx) {
+      const logger = pctx.host.ctx.logger;
+      const addonStore = await pctx.settings.readAddonStore();
+      const markerRaw = addonStore[LINKED_MANUAL_BACKFILL_MARKER_KEY];
+      if ((typeof markerRaw === "number" ? markerRaw : 0) >= 1) return;
+      const all = await listAll(pctx, LINK_CANDIDATE_PROJECTION);
+      let written = 0;
+      let linked = 0;
+      for (const cam of all) {
+        if (cam.type !== require_dist10.DeviceType.Camera) continue;
+        const blob = await pctx.settings.readDeviceStore(cam.id);
+        const plan = planManualBackfill({
+          selfId: cam.id,
+          selfLocation: cam.location ?? null,
+          blob,
+          candidates: all
+        });
+        if (!plan.write) continue;
+        await pctx.settings.writeDeviceStore(cam.id, {
+          ...blob,
+          [LINKED_MODE_CONFIG_KEY]: "manual",
+          [LINKED_IDS_CONFIG_KEY]: [...plan.manualIds]
+        });
+        written += 1;
+        linked += plan.manualIds.length;
+        logger.info("linked devices: auto links materialised into the manual list (D356)", {
+          tags: { deviceId: cam.id },
+          meta: { manualIds: plan.manualIds }
+        });
+      }
+      await pctx.settings.writeAddonStore({
+        ...addonStore,
+        [LINKED_MANUAL_BACKFILL_MARKER_KEY]: 1
+      });
+      logger.info("linked devices: manual backfill complete (D356)", { meta: {
+        camerasWritten: written,
+        linksMaterialised: linked
+      } });
+    }
     function decodeAddonStore(raw) {
       const nextDeviceId = raw["nextDeviceId"];
       const locations = raw["locations"];
@@ -69399,6 +69413,11 @@ var require_device_manager_addon = __commonJS({
         } catch (err) {
           this.ctx.logger.warn("location backfill failed \u2014 fleet boots without it", { meta: { error: require_dist10.errMsg(err) } });
         }
+        try {
+          await runLinkedDevicesManualBackfillAtBoot(pctx);
+        } catch (err) {
+          this.ctx.logger.warn("linked-devices manual backfill failed \u2014 auto links are NOT materialised", { meta: { error: require_dist10.errMsg(err) } });
+        }
         const provider = {
           resolveDeviceOwnerSync: (deviceId) => resolveDeviceOwnerSync(pctx, deviceId),
           resolveNativeCapOwnerSync: (capName, deviceId) => resolveNativeCapOwnerSync(pctx, capName, deviceId),
@@ -69634,7 +69653,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -69771,7 +69790,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -69961,7 +69980,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -77774,7 +77793,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -78339,7 +78358,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -80923,7 +80942,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -82039,8 +82058,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
-    var require_retired_settings_keys = require_retired_settings_keys_BgUS9Rr3();
+    var require_dist10 = require_dist_DNwhsXWi();
+    var require_retired_settings_keys = require_retired_settings_keys_CUXClAIQ();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -84530,7 +84549,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -87481,7 +87500,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -105542,7 +105561,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -107485,9 +107504,9 @@ var require_event_category_BaEgqJNv = __commonJS({
   }
 });
 
-// ../types/dist/sleep-jdpPltQH.js
-var require_sleep_jdpPltQH = __commonJS({
-  "../types/dist/sleep-jdpPltQH.js"(exports) {
+// ../types/dist/sleep-BtIF8lWc.js
+var require_sleep_BtIF8lWc = __commonJS({
+  "../types/dist/sleep-BtIF8lWc.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_BaEgqJNv();
     var zod = require_zod();
@@ -109478,6 +109497,7 @@ var require_sleep_jdpPltQH = __commonJS({
       DeviceRole2["GenericNotifier"] = "generic-notifier";
       return DeviceRole2;
     })({});
+    var DEVICE_CHILDREN_BATCH_MAX = 256;
     var StaticDirOutputSchema = zod.z.object({ staticDir: zod.z.string() });
     var VersionOutputSchema = zod.z.object({ version: zod.z.string() });
     var viewerUiCapability = {
@@ -110732,6 +110752,12 @@ var require_sleep_jdpPltQH = __commonJS({
         return DEFAULT_RUNTIME_STATE_DURABILITY;
       }
     });
+    Object.defineProperty(exports, "DEVICE_CHILDREN_BATCH_MAX", {
+      enumerable: true,
+      get: function() {
+        return DEVICE_CHILDREN_BATCH_MAX;
+      }
+    });
     Object.defineProperty(exports, "DEVICE_SCOPED_CAPS", {
       enumerable: true,
       get: function() {
@@ -111161,7 +111187,7 @@ var require_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_BaEgqJNv();
-    var require_sleep = require_sleep_jdpPltQH();
+    var require_sleep = require_sleep_BtIF8lWc();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -111479,6 +111505,7 @@ var require_addon = __commonJS({
     exports.CAP_INPUT_DEFAULTS = CAP_INPUT_DEFAULTS;
     exports.COLLECTION_ARRAY_METHODS = COLLECTION_ARRAY_METHODS;
     exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
+    exports.DEVICE_CHILDREN_BATCH_MAX = require_sleep.DEVICE_CHILDREN_BATCH_MAX;
     exports.DEVICE_SCOPED_CAPS = require_sleep.DEVICE_SCOPED_CAPS;
     exports.DeviceType = require_sleep.DeviceType;
     exports.DisposerChain = require_sleep.DisposerChain;
@@ -118044,12 +118071,11 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../system/dist/manifest-system-deps-DMWd5Ygf.js
-var require_manifest_system_deps_DMWd5Ygf = __commonJS({
-  "../system/dist/manifest-system-deps-DMWd5Ygf.js"(exports) {
+// ../system/dist/manifest-system-deps-KBuTXH-y.js
+var require_manifest_system_deps_KBuTXH_y = __commonJS({
+  "../system/dist/manifest-system-deps-KBuTXH-y.js"(exports) {
     "use strict";
     var require_chunk = require_chunk_Cek0wNdY();
-    require_dist_DE3OH_FG();
     require_hub_cap_forward_DmHNjbB0();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
@@ -119547,7 +119573,7 @@ var require_manifest_system_deps_DMWd5Ygf = __commonJS({
       return lowered.includes("not_found") || lowered.includes("no procedure") || lowered.includes("unknown method") || lowered.includes("no such method") || lowered.includes("not available");
     }
     function createChildrenBatchLoader(opts) {
-      const maxBatch = Math.max(1, opts.maxBatch ?? 256);
+      const maxBatch = Math.max(1, opts.maxBatch ?? _camstack_types_addon.DEVICE_CHILDREN_BATCH_MAX);
       let pending = [];
       let flushScheduled = false;
       let flushing = false;
@@ -130116,7 +130142,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DE3OH_FG();
+    var require_dist10 = require_dist_DNwhsXWi();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -130143,7 +130169,7 @@ var require_dist3 = __commonJS({
     var require_builtins_winston_logging_index = require_winston_logging();
     var require_file_data_plane = require_file_data_plane_DO8KbxCe();
     var require_tls$1 = require_tls_BxQlomxd();
-    var require_manifest_system_deps = require_manifest_system_deps_DMWd5Ygf();
+    var require_manifest_system_deps = require_manifest_system_deps_KBuTXH_y();
     var require_resource_monitor = require_resource_monitor_CdnzxBLP();
     var require_custom_action_registry = require_custom_action_registry_jY0NOZK8();
     var zod = require_zod();
@@ -211233,7 +211259,7 @@ var require_dist4 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_BaEgqJNv();
-    var require_sleep = require_sleep_jdpPltQH();
+    var require_sleep = require_sleep_BtIF8lWc();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -218693,7 +218719,6 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         })
       }
     };
-    var DEVICE_CHILDREN_BATCH_MAX = 256;
     var ChildLayoutEntrySchema = zod.z.object({
       childKey: zod.z.string(),
       section: zod.z.string(),
@@ -218774,7 +218799,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       value: zod.z.unknown(),
       description: zod.z.string().optional()
     });
-    var LinkedDevicesModeSchema = zod.z.enum(["auto", "manual"]);
+    var LinkedDevicesModeSchema = zod.z.enum(["manual"]);
     var LinkedDeviceSchema = zod.z.object({
       deviceId: zod.z.number(),
       name: zod.z.string(),
@@ -225111,12 +225136,28 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "staging",
       "trained"
     ]);
+    var MAX_TRACK_DEBUG_NOTE_LEN = 500;
     var TrackFlagFields = {
       /** Operator marked this track as training material — i.e. `retrainStatus` is
       *  `'staging'`. */
       markForTrain: zod.z.boolean().optional(),
       /** Operator marked this track for diagnostic attention. */
       debug: zod.z.boolean().optional(),
+      /**
+      * What the operator wants CHECKED on this track, in their own words.
+      *
+      * The flag alone says "look at this" and nothing about what for; a debug set
+      * reviewed hours later is a list of tracks with no question attached. Bound
+      * to `debug` on the WRITE side — the body clears it when `debug` goes off,
+      * and refuses it on a track whose debug is off — so a note can never outlive
+      * the attention it belongs to.
+      *
+      * `''` is a real value ("marked, nothing to add"); the ABSENT key means
+      * "leave whatever is stored alone", which is what lets a surface turn debug
+      * on without a note (a cancelled prompt) and what lets it edit the note
+      * without touching the flag.
+      */
+      debugNote: zod.z.string().max(500).optional(),
       /** Operator favourited this track. Pins it against pruning. */
       favourited: zod.z.boolean().optional()
     };
@@ -225126,6 +225167,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       trackId: zod.z.string(),
       markForTrain: zod.z.boolean(),
       debug: zod.z.boolean(),
+      /** The note as it STANDS after the write — never absent here (a track with no
+      *  note reports `''`), for the same reason the booleans are required: a
+      *  surface that has just written must be able to render the note it now owns
+      *  without a re-fetch, and an absent key would read as "unchanged" on a
+      *  screen that has no previous value to keep. */
+      debugNote: zod.z.string(),
       favourited: zod.z.boolean(),
       /** The lifecycle state the boolean was derived from. Required here (unlike on
       *  a track row) because this shape is only ever produced by the write body,
@@ -226181,11 +226228,20 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         * staging is a deliberate action of the retrain page, which is also the only
         * thing that produces `trained` in the first place.
         *
-        * Returns the RESOLVED state of both flags (absent → `false`) plus the
-        * `retrainStatus` they were derived from, so a caller can drive its toggle
-        * — and render a `trained` badge — without a re-fetch. Rejects an unknown
-        * track, a new staging mark on a device already holding its full budget, and
-        * any `markForTrain` write against a trained track.
+        * `debugNote` is the operator's sentence about WHAT to check on this track,
+        * and it is bound to `debug`: writing `debug: false` clears it in the same
+        * statement, and a note sent for a track whose debug is off (and is not
+        * being turned on) is DROPPED with a warning rather than stored where
+        * nothing will ever read it. An omitted `debugNote` leaves the stored one
+        * alone — which is what lets a surface turn debug on when the operator
+        * declined to type anything, without that refusal costing them the flag.
+        *
+        * Returns the RESOLVED state of all three flags (absent → `false`) plus the
+        * note (absent → `''`) and the `retrainStatus` they were derived from, so a
+        * caller can drive its toggle — and render a `trained` badge — without a
+        * re-fetch. Rejects an unknown track, a new staging mark on a device already
+        * holding its full budget, and any `markForTrain` write against a trained
+        * track.
         */
         setTrackFlags: require_sleep.method(zod.z.object({
           /** Log/audit scope only — the trackId is globally unique on its own. */
@@ -254719,7 +254775,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.DETECTION_PIPELINE_CAP_NAME = DETECTION_PIPELINE_CAP_NAME;
     exports.DEVICE_BACKEND_TO_FORMAT = DEVICE_BACKEND_TO_FORMAT;
     exports.DEVICE_CAP_NAMES = DEVICE_CAP_NAMES;
-    exports.DEVICE_CHILDREN_BATCH_MAX = DEVICE_CHILDREN_BATCH_MAX;
+    exports.DEVICE_CHILDREN_BATCH_MAX = require_sleep.DEVICE_CHILDREN_BATCH_MAX;
     exports.DEVICE_PROFILES = DEVICE_PROFILES;
     exports.DEVICE_RESTORE_RETRY_CONCURRENCY = DEVICE_RESTORE_RETRY_CONCURRENCY;
     exports.DEVICE_RESTORE_RETRY_DELAYS_MS = DEVICE_RESTORE_RETRY_DELAYS_MS;
@@ -254955,6 +255011,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.MAX_KEYS = MAX_KEYS;
     exports.MAX_REASONS_PER_KEY = MAX_REASONS_PER_KEY;
     exports.MAX_SENSOR_TRIGGER_DEVICES = MAX_SENSOR_TRIGGER_DEVICES;
+    exports.MAX_TRACK_DEBUG_NOTE_LEN = MAX_TRACK_DEBUG_NOTE_LEN;
     exports.METHOD_ACCESS_MAP = METHOD_ACCESS_MAP;
     exports.METHOD_DEVICE_SELECTORS = METHOD_DEVICE_SELECTORS;
     exports.MODEL_FORMATS = MODEL_FORMATS;
@@ -424490,9 +424547,9 @@ var require_agent_registry_service = __commonJS({
         }
         return nodes.delete(nodeId) === true;
       }
-      /** Typed view of the broker's node catalog — one documented boundary cast. */
+      /** Typed view of the broker's node catalog — reached through the ONE cast. */
       nodeCatalogRegistry() {
-        return this.moleculer.broker.registry;
+        return this.broker.registry;
       }
       /** Typed view of the Moleculer broker — single documented cast. */
       get broker() {

package/package.json

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