@camstack/addon-matter-broker 0.2.82 → 0.2.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/addon.js CHANGED
@@ -18826,11 +18826,30 @@ var SensorEventSchema = object({
18826
18826
  value: record(string$2(), unknown()).nullable(),
18827
18827
  timestamp: number()
18828
18828
  });
18829
+ /**
18830
+ * One stored sighting on a track's trajectory.
18831
+ *
18832
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18833
+ * arrival order, and the two detector passes interleave, so a consumer must not
18834
+ * assume the two are the same on a row written by an older build.
18835
+ */
18829
18836
  var TrackPositionSchema = object({
18830
18837
  x: number(),
18831
18838
  y: number(),
18832
18839
  timestamp: number(),
18833
- bbox: BoundingBoxSchema
18840
+ bbox: BoundingBoxSchema,
18841
+ /**
18842
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18843
+ * pass on the analysis raster, `recovery` is the native-resolution
18844
+ * small-subject second pass (D377/D378). Both write into one array, and until
18845
+ * this field existed the only way to tell them apart was that full-frame boxes
18846
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18847
+ * Absent on rows written before D399.
18848
+ */
18849
+ source: _enum(["frame", "recovery"]).optional(),
18850
+ /** Detection score of this box, so a position can be weighed and not only
18851
+ * plotted. Absent on rows written before D399. */
18852
+ score: number().optional()
18834
18853
  });
18835
18854
  var TrackSnapshotSchema = object({
18836
18855
  timestamp: number(),
@@ -19230,14 +19249,25 @@ var TrackSchema = object({
19230
19249
  */
19231
19250
  hasRider: boolean().optional(),
19232
19251
  /**
19233
- * WHY this track ended without a NATIVE best-shot tile
19234
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19252
+ * WHY this track ended without a NATIVE best-shot FRAME
19253
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19254
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19235
19255
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19236
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19237
- * the late-keyFrame upgrade when a native tile lands after all. The
19238
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19256
+ * `derive-returned-null tile=standin`,
19257
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19258
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19259
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19239
19260
  * tile is a face/plate stand-in, a raster crop, or an icon.
19240
19261
  *
19262
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19263
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19264
+ * while its key frame missed carried no reason at all — three of the four
19265
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19266
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19267
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19268
+ * lastFrame copy source`), so its absence is now on this line whatever the
19269
+ * tile ended up being.
19270
+ *
19241
19271
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19242
19272
  * that predates the field, and every track whose tile landed native all
19243
19273
  * omit it. Render nothing when absent.
package/dist/addon.mjs CHANGED
@@ -18824,11 +18824,30 @@ var SensorEventSchema = object({
18824
18824
  value: record(string$2(), unknown()).nullable(),
18825
18825
  timestamp: number()
18826
18826
  });
18827
+ /**
18828
+ * One stored sighting on a track's trajectory.
18829
+ *
18830
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18831
+ * arrival order, and the two detector passes interleave, so a consumer must not
18832
+ * assume the two are the same on a row written by an older build.
18833
+ */
18827
18834
  var TrackPositionSchema = object({
18828
18835
  x: number(),
18829
18836
  y: number(),
18830
18837
  timestamp: number(),
18831
- bbox: BoundingBoxSchema
18838
+ bbox: BoundingBoxSchema,
18839
+ /**
18840
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18841
+ * pass on the analysis raster, `recovery` is the native-resolution
18842
+ * small-subject second pass (D377/D378). Both write into one array, and until
18843
+ * this field existed the only way to tell them apart was that full-frame boxes
18844
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18845
+ * Absent on rows written before D399.
18846
+ */
18847
+ source: _enum(["frame", "recovery"]).optional(),
18848
+ /** Detection score of this box, so a position can be weighed and not only
18849
+ * plotted. Absent on rows written before D399. */
18850
+ score: number().optional()
18832
18851
  });
18833
18852
  var TrackSnapshotSchema = object({
18834
18853
  timestamp: number(),
@@ -19228,14 +19247,25 @@ var TrackSchema = object({
19228
19247
  */
19229
19248
  hasRider: boolean().optional(),
19230
19249
  /**
19231
- * WHY this track ended without a NATIVE best-shot tile
19232
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19250
+ * WHY this track ended without a NATIVE best-shot FRAME
19251
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19252
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19233
19253
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19234
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19235
- * the late-keyFrame upgrade when a native tile lands after all. The
19236
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19254
+ * `derive-returned-null tile=standin`,
19255
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19256
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19257
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19237
19258
  * tile is a face/plate stand-in, a raster crop, or an icon.
19238
19259
  *
19260
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19261
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19262
+ * while its key frame missed carried no reason at all — three of the four
19263
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19264
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19265
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19266
+ * lastFrame copy source`), so its absence is now on this line whatever the
19267
+ * tile ended up being.
19268
+ *
19239
19269
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19240
19270
  * that predates the field, and every track whose tile landed native all
19241
19271
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-matter-broker",
3
- "version": "0.2.82",
3
+ "version": "0.2.83",
4
4
  "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
5
5
  "keywords": [
6
6
  "camstack",