camstack 1.2.126 → 1.2.127

package/dist/{chunk-36TIDBRZ.js → chunk-5NJCDSOQ.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-Bd-Y4RUt.mjs
+// ../types/dist/sleep-uGNYCvYp.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -15582,6 +15582,32 @@ var CameraSwitchGroupSchema = external_exports.object({
   /** Unix ms when the group was composed server-side. */
   fetchedAt: external_exports.number()
 });
+var ArchivedDebugNoteSchema = external_exports.object({
+  /** Archive row id. Derived from `(sourceTrackId, note)`, so re-archiving the
+  *  same sentence about the same track lands on the row already there. */
+  id: external_exports.string(),
+  /** The operator's own words, verbatim. */
+  note: external_exports.string(),
+  /** The camera. Required — every question here is asked per-camera. */
+  deviceId: external_exports.number().int(),
+  /** The track the note was written on. PROVENANCE, not ownership: the track
+  *  is expected to be gone, and this row is not a reference to it. */
+  sourceTrackId: external_exports.string(),
+  /** Epoch ms the note was moved here, i.e. when the operator reviewed it. */
+  archivedAt: external_exports.number().int(),
+  /** The track's `firstSeen`, when the row still knew it; `null` otherwise. */
+  trackStartedAt: external_exports.number().int().nullable(),
+  /** The track's detector class (`person`, `car`, …); `null` when unknown. */
+  trackClass: external_exports.string().nullable(),
+  /** The track's display label at review time; `null` when it had none. */
+  trackLabel: external_exports.string().nullable()
+});
+var ArchivedDebugNoteQueryInputSchema = external_exports.object({
+  /** Restrict to a single camera; omit for every row. */
+  deviceId: external_exports.number().int().optional(),
+  /** Max rows returned, newest-first. */
+  limit: external_exports.number().int().min(1).max(1e3).optional()
+});
 var OpsLogDomainSchema = external_exports.enum(["recording", "events"]);
 var OpsLogOpSchema = external_exports.enum([
   "prune",
@@ -27431,6 +27457,31 @@ var pipelineAnalyticsCapability = {
       flags: TrackFlagsPatchSchema
     }), TrackFlagsSchema, { kind: "mutation" }),
     /**
+    * The archived debug notes, newest first — the corpus of what operators
+    * have asked to be checked, across tracks that no longer exist (D405).
+    *
+    * `setTrackFlags` writes it: a patch carrying `debug: false` still clears
+    * the note off the track row in the same statement (D353's invariant is
+    * untouched), but the note is APPENDED here first. That is the whole point
+    * — before D405, finishing a review destroyed every note written during it,
+    * and the ones that survived aged out with their tracks. This method is the
+    * only way to read what was kept.
+    *
+    * `auth: 'protected'`, matching `setTrackFlags` next door and for the same
+    * reason: the notes are written from the viewer, by an authenticated
+    * non-admin session, and a corpus only an admin can read is a corpus the
+    * person who wrote it cannot use. It carries operator prose about cameras
+    * and nothing else — no media, no paths, no identities beyond a track's
+    * own display label.
+    *
+    * Newest-first, capped by `limit` (default
+    * {@link ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT}), optionally one camera. The
+    * table itself is bounded by row count, not by age — see
+    * {@link MAX_ARCHIVED_DEBUG_NOTES} for why an age clock would be the wrong
+    * bound for exactly this data.
+    */
+    listArchivedDebugNotes: method(ArchivedDebugNoteQueryInputSchema, external_exports.array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
+    /**
     * Durable event-store footprint for the management UI: event rows
     * (motion + object + audio) counted per camera + total, plus the
     * event-owned media bytes on disk per camera + total. Stat/count-based,
@@ -43500,6 +43551,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineAnalytics.listArchivedDebugNotes": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "pipelineAnalytics.listEventKinds": {
     capName: "pipeline-analytics",
     capScope: "device",
@@ -47287,6 +47344,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "array",
     optional: true
   }],
+  "pipelineAnalytics.listArchivedDebugNotes": [{
+    name: "deviceId",
+    form: "single",
+    optional: true
+  }],
   "pipelineAnalytics.listEventKinds": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-36TIDBRZ.js";
+} from "./chunk-5NJCDSOQ.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-6KZS6MDM.js");
+  await import("./launcher-BSFU3OHE.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-6KZS6MDM.js");
+  await import("./launcher-BSFU3OHE.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-YU5RJAP7.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-7JKBAMMQ.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-YU5RJAP7.js → discover-7JKBAMMQ.js}

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

package/dist/{launcher-6KZS6MDM.js → launcher-BSFU3OHE.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-C_WvDOQ9.js
-var require_dist_C_WvDOQ9 = __commonJS({
-  "../system/dist/dist-C_WvDOQ9.js"(exports) {
+// ../system/dist/dist-C5xJy-uL.js
+var require_dist_C5xJy_uL = __commonJS({
+  "../system/dist/dist-C5xJy-uL.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -26065,6 +26065,32 @@ var require_dist_C_WvDOQ9 = __commonJS({
         for (const tab of tabs) for (const child of fieldsOf(tab)) walkField(child, out);
       }
     }
+    var ArchivedDebugNoteSchema = zod.z.object({
+      /** Archive row id. Derived from `(sourceTrackId, note)`, so re-archiving the
+      *  same sentence about the same track lands on the row already there. */
+      id: zod.z.string(),
+      /** The operator's own words, verbatim. */
+      note: zod.z.string(),
+      /** The camera. Required — every question here is asked per-camera. */
+      deviceId: zod.z.number().int(),
+      /** The track the note was written on. PROVENANCE, not ownership: the track
+      *  is expected to be gone, and this row is not a reference to it. */
+      sourceTrackId: zod.z.string(),
+      /** Epoch ms the note was moved here, i.e. when the operator reviewed it. */
+      archivedAt: zod.z.number().int(),
+      /** The track's `firstSeen`, when the row still knew it; `null` otherwise. */
+      trackStartedAt: zod.z.number().int().nullable(),
+      /** The track's detector class (`person`, `car`, …); `null` when unknown. */
+      trackClass: zod.z.string().nullable(),
+      /** The track's display label at review time; `null` when it had none. */
+      trackLabel: zod.z.string().nullable()
+    });
+    var ArchivedDebugNoteQueryInputSchema = zod.z.object({
+      /** Restrict to a single camera; omit for every row. */
+      deviceId: zod.z.number().int().optional(),
+      /** Max rows returned, newest-first. */
+      limit: zod.z.number().int().min(1).max(1e3).optional()
+    });
     var STREAM_QUALITY_LABELS = {
       high: "High",
       mid: "Mid",
@@ -38200,6 +38226,31 @@ var require_dist_C_WvDOQ9 = __commonJS({
           flags: TrackFlagsPatchSchema
         }), TrackFlagsSchema, { kind: "mutation" }),
         /**
+        * The archived debug notes, newest first — the corpus of what operators
+        * have asked to be checked, across tracks that no longer exist (D405).
+        *
+        * `setTrackFlags` writes it: a patch carrying `debug: false` still clears
+        * the note off the track row in the same statement (D353's invariant is
+        * untouched), but the note is APPENDED here first. That is the whole point
+        * — before D405, finishing a review destroyed every note written during it,
+        * and the ones that survived aged out with their tracks. This method is the
+        * only way to read what was kept.
+        *
+        * `auth: 'protected'`, matching `setTrackFlags` next door and for the same
+        * reason: the notes are written from the viewer, by an authenticated
+        * non-admin session, and a corpus only an admin can read is a corpus the
+        * person who wrote it cannot use. It carries operator prose about cameras
+        * and nothing else — no media, no paths, no identities beyond a track's
+        * own display label.
+        *
+        * Newest-first, capped by `limit` (default
+        * {@link ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT}), optionally one camera. The
+        * table itself is bounded by row count, not by age — see
+        * {@link MAX_ARCHIVED_DEBUG_NOTES} for why an age clock would be the wrong
+        * bound for exactly this data.
+        */
+        listArchivedDebugNotes: method(ArchivedDebugNoteQueryInputSchema, zod.z.array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
+        /**
         * Durable event-store footprint for the management UI: event rows
         * (motion + object + audio) counted per camera + total, plus the
         * event-owned media bytes on disk per camera + total. Stat/count-based,
@@ -54944,6 +54995,12 @@ var require_dist_C_WvDOQ9 = __commonJS({
         addonId: null,
         access: "view"
       },
+      "pipelineAnalytics.listArchivedDebugNotes": {
+        capName: "pipeline-analytics",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "pipelineAnalytics.listEventKinds": {
         capName: "pipeline-analytics",
         capScope: "device",
@@ -58731,6 +58788,11 @@ var require_dist_C_WvDOQ9 = __commonJS({
         form: "array",
         optional: true
       }],
+      "pipelineAnalytics.listArchivedDebugNotes": [{
+        name: "deviceId",
+        form: "single",
+        optional: true
+      }],
       "pipelineAnalytics.listEventKinds": [{
         name: "deviceId",
         form: "single",
@@ -61043,7 +61105,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -61862,7 +61924,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -61956,7 +62018,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_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -62853,11 +62915,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-BpasSgff.js
-var require_retired_settings_keys_BpasSgff = __commonJS({
-  "../system/dist/retired-settings-keys-BpasSgff.js"(exports) {
+// ../system/dist/retired-settings-keys-CONISA8J.js
+var require_retired_settings_keys_CONISA8J = __commonJS({
+  "../system/dist/retired-settings-keys-CONISA8J.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -65092,8 +65154,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
-    var require_retired_settings_keys = require_retired_settings_keys_BpasSgff();
+    var require_dist10 = require_dist_C5xJy_uL();
+    var require_retired_settings_keys = require_retired_settings_keys_CONISA8J();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -70718,7 +70780,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -70855,7 +70917,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -71051,7 +71113,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -78864,7 +78926,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -79429,7 +79491,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var node_fs_promises = __require("fs/promises");
     var node_child_process = __require("child_process");
     var node_util = __require("util");
@@ -82013,7 +82075,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -83129,8 +83191,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
-    var require_retired_settings_keys = require_retired_settings_keys_BpasSgff();
+    var require_dist10 = require_dist_C5xJy_uL();
+    var require_retired_settings_keys = require_retired_settings_keys_CONISA8J();
     var node_crypto = __require("crypto");
     var node_fs = __require("fs");
     var node_module = __require("module");
@@ -85634,7 +85696,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -89284,7 +89346,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -107345,7 +107407,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -109290,9 +109352,9 @@ var require_event_category_BVo6ta6 = __commonJS({
   }
 });
 
-// ../types/dist/sleep-BZtO-eFY.js
-var require_sleep_BZtO_eFY = __commonJS({
-  "../types/dist/sleep-BZtO-eFY.js"(exports) {
+// ../types/dist/sleep-IjLtwkO5.js
+var require_sleep_IjLtwkO5 = __commonJS({
+  "../types/dist/sleep-IjLtwkO5.js"(exports) {
     "use strict";
     var require_event_category = require_event_category_BVo6ta6();
     var zod = require_zod();
@@ -112024,6 +112086,7 @@ var require_sleep_BZtO_eFY = __commonJS({
           reconcileFromDisk: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "reconcileFromDisk", "mutation", input),
           deleteTracks: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deleteTracks", "mutation", input),
           setTrackFlags: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "setTrackFlags", "mutation", input),
+          listArchivedDebugNotes: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listArchivedDebugNotes", "query", input),
           getEventStoreFootprint: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventStoreFootprint", "query", input),
           getEventMediaFootprintByKind: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMediaFootprintByKind", "query", input),
           pruneEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEvents", "mutation", input),
@@ -113024,7 +113087,7 @@ var require_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_BVo6ta6();
-    var require_sleep = require_sleep_BZtO_eFY();
+    var require_sleep = require_sleep_IjLtwkO5();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -131955,7 +132018,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_C_WvDOQ9();
+    var require_dist10 = require_dist_C5xJy_uL();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -213072,7 +213135,7 @@ var require_dist4 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_event_category = require_event_category_BVo6ta6();
-    var require_sleep = require_sleep_BZtO_eFY();
+    var require_sleep = require_sleep_IjLtwkO5();
     var require_canonical_hash = require_canonical_hash_DNV8S5ET();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -213825,6 +213888,34 @@ var require_dist4 = __commonJS({
         for (const tab of tabs) for (const child of fieldsOf(tab)) walkField(child, out);
       }
     }
+    var MAX_ARCHIVED_DEBUG_NOTES = 5e3;
+    var ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT = 200;
+    var ArchivedDebugNoteSchema = zod.z.object({
+      /** Archive row id. Derived from `(sourceTrackId, note)`, so re-archiving the
+      *  same sentence about the same track lands on the row already there. */
+      id: zod.z.string(),
+      /** The operator's own words, verbatim. */
+      note: zod.z.string(),
+      /** The camera. Required — every question here is asked per-camera. */
+      deviceId: zod.z.number().int(),
+      /** The track the note was written on. PROVENANCE, not ownership: the track
+      *  is expected to be gone, and this row is not a reference to it. */
+      sourceTrackId: zod.z.string(),
+      /** Epoch ms the note was moved here, i.e. when the operator reviewed it. */
+      archivedAt: zod.z.number().int(),
+      /** The track's `firstSeen`, when the row still knew it; `null` otherwise. */
+      trackStartedAt: zod.z.number().int().nullable(),
+      /** The track's detector class (`person`, `car`, …); `null` when unknown. */
+      trackClass: zod.z.string().nullable(),
+      /** The track's display label at review time; `null` when it had none. */
+      trackLabel: zod.z.string().nullable()
+    });
+    var ArchivedDebugNoteQueryInputSchema = zod.z.object({
+      /** Restrict to a single camera; omit for every row. */
+      deviceId: zod.z.number().int().optional(),
+      /** Max rows returned, newest-first. */
+      limit: zod.z.number().int().min(1).max(1e3).optional()
+    });
     var STREAM_QUALITY_LABELS = {
       high: "High",
       mid: "Mid",
@@ -228380,6 +228471,31 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           flags: TrackFlagsPatchSchema
         }), TrackFlagsSchema, { kind: "mutation" }),
         /**
+        * The archived debug notes, newest first — the corpus of what operators
+        * have asked to be checked, across tracks that no longer exist (D405).
+        *
+        * `setTrackFlags` writes it: a patch carrying `debug: false` still clears
+        * the note off the track row in the same statement (D353's invariant is
+        * untouched), but the note is APPENDED here first. That is the whole point
+        * — before D405, finishing a review destroyed every note written during it,
+        * and the ones that survived aged out with their tracks. This method is the
+        * only way to read what was kept.
+        *
+        * `auth: 'protected'`, matching `setTrackFlags` next door and for the same
+        * reason: the notes are written from the viewer, by an authenticated
+        * non-admin session, and a corpus only an admin can read is a corpus the
+        * person who wrote it cannot use. It carries operator prose about cameras
+        * and nothing else — no media, no paths, no identities beyond a track's
+        * own display label.
+        *
+        * Newest-first, capped by `limit` (default
+        * {@link ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT}), optionally one camera. The
+        * table itself is bounded by row count, not by age — see
+        * {@link MAX_ARCHIVED_DEBUG_NOTES} for why an age clock would be the wrong
+        * bound for exactly this data.
+        */
+        listArchivedDebugNotes: require_sleep.method(ArchivedDebugNoteQueryInputSchema, zod.z.array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
+        /**
         * Durable event-store footprint for the management UI: event rows
         * (motion + object + audio) counted per camera + total, plus the
         * event-owned media bytes on disk per camera + total. Stat/count-based,
@@ -248811,6 +248927,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "pipelineAnalytics.listArchivedDebugNotes": {
+        capName: "pipeline-analytics",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "pipelineAnalytics.listEventKinds": {
         capName: "pipeline-analytics",
         capScope: "device",
@@ -252862,6 +252984,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "array",
         optional: true
       }],
+      "pipelineAnalytics.listArchivedDebugNotes": [{
+        name: "deviceId",
+        form: "single",
+        optional: true
+      }],
       "pipelineAnalytics.listEventKinds": [{
         name: "deviceId",
         form: "single",
@@ -257521,6 +257648,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.ALEXA_EGRESS_PROFILE = ALEXA_EGRESS_PROFILE;
     exports.ALL_CAPABILITY_DEFINITIONS = ALL_CAPABILITY_DEFINITIONS;
     exports.APPLE_SA_TO_MACRO = APPLE_SA_TO_MACRO;
+    exports.ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT = ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT;
     exports.AUDIO_ANALYSIS_CAP_NAME = AUDIO_ANALYSIS_CAP_NAME;
     exports.AUDIO_BACKEND_CHOICES = AUDIO_BACKEND_CHOICES;
     exports.AUDIO_MACRO_LABELS = AUDIO_MACRO_LABELS;
@@ -257558,6 +257686,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.ApiKeySummarySchema = ApiKeySummarySchema;
     exports.ArchiveEntrySchema = ArchiveEntrySchema;
     exports.ArchiveManifestSchema = ArchiveManifestSchema;
+    exports.ArchivedDebugNoteQueryInputSchema = ArchivedDebugNoteQueryInputSchema;
+    exports.ArchivedDebugNoteSchema = ArchivedDebugNoteSchema;
     exports.AttachmentMediaTypeSchema = AttachmentMediaTypeSchema;
     exports.AttachmentSchema = AttachmentSchema;
     exports.AudioAnalysisResultSchema = AudioAnalysisResultSchema;
@@ -257978,6 +258108,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.LoginMethodContributionSchema = LoginMethodContributionSchema;
     exports.LoginStageEnum = LoginStageEnum;
     exports.MACRO_LABELS = MACRO_LABELS;
+    exports.MAX_ARCHIVED_DEBUG_NOTES = MAX_ARCHIVED_DEBUG_NOTES;
     exports.MAX_CLIP_EVENT_IDS = MAX_CLIP_EVENT_IDS;
     exports.MAX_CLIP_LABELS = MAX_CLIP_LABELS;
     exports.MAX_CONDITION_DEPTH = MAX_CONDITION_DEPTH;

package/package.json

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