@camstack/types 1.2.168 → 1.2.170

package/dist/interfaces/debug-note-archive.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Debug-note archive — the durable corpus of what operators asked to be
+ * checked, and the ONE thing about a debug note that outlives its track.
+ *
+ * D353 bound `debugNote` to the `debug` flag: turning the flag off clears the
+ * note in the same statement, so a track can never present a question without
+ * the flag that explains it. That invariant is right and stays. Its side
+ * effect was not: the act of REVIEWING a debug set destroyed every note in it,
+ * and the notes that survived a sweep aged out with their tracks anyway. On
+ * 2026-09-08 the notes from one morning's review — 25 to 27 of them — were
+ * already unreadable by the afternoon, leaving 11.
+ *
+ * So the clear now ARCHIVES first (D405). A row here is:
+ *
+ *  - written ONLY by the hub, from `applyTrackFlags`, immediately before the
+ *    note is cleared off the track row;
+ *  - keyed by ITS OWN id, derived from `(sourceTrackId, note)` so reviewing
+ *    the same track twice cannot double the corpus;
+ *  - NOT a track row, NOT subject to track retention, and NOT a durability pin
+ *    on anything — the track it names is expected to be gone.
+ *
+ * `sourceTrackId` is deliberately not called `trackId`. The analytics
+ * retention model derives track OWNERSHIP from a declared `trackId` column
+ * (`collection-classification.ts`), and a row that the cascade would delete
+ * with its track is exactly the row this table exists to keep. The name says
+ * PROVENANCE — the same distinction the stationary registry draws for the same
+ * reason.
+ */
+import { z } from 'zod';
+/**
+ * How many archived notes the cluster keeps, across every camera.
+ *
+ * GLOBAL, not per-device, and a COUNT, not an age. Both halves are deliberate:
+ *
+ *  - A per-device bound multiplies by the fleet — 30 cameras at 500 each is
+ *    15 000 rows to protect a corpus that only ever gets read fleet-wide (the
+ *    thing being mined is "what keeps going wrong", not "what goes wrong on
+ *    617"). One global ceiling is one number to reason about.
+ *  - An AGE bound would delete the corpus for being old, which is the failure
+ *    being fixed: a note from six months ago is the most valuable row in the
+ *    table precisely because the pattern it describes has had time to repeat.
+ *
+ * The number is sized off the measured rate. The 2026-09-08 sweep produced
+ * 25–27 notes; call a heavy day 100. 5 000 rows is roughly fifty such days,
+ * and at the observed rate (a few sweeps a week) several years. The cost is
+ * bounded by construction: a note is capped at `MAX_TRACK_DEBUG_NOTE_LEN`
+ * (500 chars) and the metadata beside it is under 100 bytes, so the ceiling is
+ * ~3 MB of text and the realistic occupancy is well under 1 MB — against a
+ * `tracks` table measured at 4.6 MB for a single 501-row page.
+ */
+export declare const MAX_ARCHIVED_DEBUG_NOTES = 5000;
+/** Default page size for `listArchivedDebugNotes` when the caller omits one. */
+export declare const ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT = 200;
+/** One archived note — the operator's words plus enough context to find what
+ *  they were looking at, after the track itself is gone. */
+export declare const ArchivedDebugNoteSchema: z.ZodObject<{
+    id: z.ZodString;
+    note: z.ZodString;
+    deviceId: z.ZodNumber;
+    sourceTrackId: z.ZodString;
+    archivedAt: z.ZodNumber;
+    trackStartedAt: z.ZodNullable<z.ZodNumber>;
+    trackClass: z.ZodNullable<z.ZodString>;
+    trackLabel: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ArchivedDebugNote = z.infer<typeof ArchivedDebugNoteSchema>;
+/** Query input for `listArchivedDebugNotes` — newest first, one camera or all. */
+export declare const ArchivedDebugNoteQueryInputSchema: z.ZodObject<{
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ArchivedDebugNoteQueryInput = z.infer<typeof ArchivedDebugNoteQueryInputSchema>;

package/dist/interfaces/event-bus.d.ts

@@ -255,8 +255,15 @@ export interface PipelineAnalyticsPlateGalleryChangedPayload {
  * Emitted by `addon-post-analysis` when a package-drop is confirmed — a
  * newly-appeared stationary object of a package class that cleared the
  * class / zone / dwell / size gates inside a package zone. Telemetry (D8):
- * the durable record is the `package-events` store row; this drives
- * notifier rules + live UI. See
+ * the durable record is the `package-events` store row.
+ *
+ * It drives NOTHING today — swept 2026-09-08, this payload and its
+ * `…PackedUp` sibling have no subscriber anywhere in `packages/`, `server/`,
+ * `camstack/` or `scripts/`. The notification path is the persist hook
+ * (`pipeline-analytics/index.ts` → `notificationCenter.onPackageEventPersisted`),
+ * not this event. The previous sentence here claimed it drove notifier rules
+ * and the live UI, which read as verification of a wiring that does not
+ * exist. See
  * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
  */
 export interface PipelineAnalyticsPackageDeliveredPayload {
@@ -290,6 +297,14 @@ export interface PipelineAnalyticsPackagePickedUpPayload {
     /** The `package-events` delivery row this pick-up pairs to. */
     readonly deliveredEventId: string;
     readonly className: string;
+    /**
+     * The track of the PERSON who collected the parcel, when one was resolved
+     * (D404). It is also the pick-up row's media owner, which is what puts a
+     * frame of the collector — rather than of the empty doormat — on the
+     * notification. Absent means nobody qualified near the parcel's last
+     * sighting; the pick-up still fires, carrying the parcel's own owner.
+     */
+    readonly collectorTrackId?: string;
     readonly timestamp: number;
     readonly [key: string]: unknown;
 }

package/dist/{sleep-BZtO-eFY.js → sleep-IjLtwkO5.js}

@@ -3518,6 +3518,7 @@ function createDeviceProxy(api, binding, opts) {
 			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),

package/dist/{sleep-Bd-Y4RUt.mjs → sleep-uGNYCvYp.mjs}

@@ -3518,6 +3518,7 @@ function createDeviceProxy(api, binding, opts) {
 			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),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.168",
+  "version": "1.2.170",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",