@camstack/addon-terminal 0.1.88 → 0.1.89

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
@@ -18764,11 +18764,30 @@ var SensorEventSchema = object({
18764
18764
  value: record(string(), unknown()).nullable(),
18765
18765
  timestamp: number()
18766
18766
  });
18767
+ /**
18768
+ * One stored sighting on a track's trajectory.
18769
+ *
18770
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18771
+ * arrival order, and the two detector passes interleave, so a consumer must not
18772
+ * assume the two are the same on a row written by an older build.
18773
+ */
18767
18774
  var TrackPositionSchema = object({
18768
18775
  x: number(),
18769
18776
  y: number(),
18770
18777
  timestamp: number(),
18771
- bbox: BoundingBoxSchema
18778
+ bbox: BoundingBoxSchema,
18779
+ /**
18780
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18781
+ * pass on the analysis raster, `recovery` is the native-resolution
18782
+ * small-subject second pass (D377/D378). Both write into one array, and until
18783
+ * this field existed the only way to tell them apart was that full-frame boxes
18784
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18785
+ * Absent on rows written before D399.
18786
+ */
18787
+ source: _enum(["frame", "recovery"]).optional(),
18788
+ /** Detection score of this box, so a position can be weighed and not only
18789
+ * plotted. Absent on rows written before D399. */
18790
+ score: number().optional()
18772
18791
  });
18773
18792
  var TrackSnapshotSchema = object({
18774
18793
  timestamp: number(),
@@ -19168,14 +19187,25 @@ var TrackSchema = object({
19168
19187
  */
19169
19188
  hasRider: boolean().optional(),
19170
19189
  /**
19171
- * WHY this track ended without a NATIVE best-shot tile
19172
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19190
+ * WHY this track ended without a NATIVE best-shot FRAME
19191
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19192
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19173
19193
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19174
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19175
- * the late-keyFrame upgrade when a native tile lands after all. The
19176
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19194
+ * `derive-returned-null tile=standin`,
19195
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19196
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19197
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19177
19198
  * tile is a face/plate stand-in, a raster crop, or an icon.
19178
19199
  *
19200
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19201
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19202
+ * while its key frame missed carried no reason at all — three of the four
19203
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19204
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19205
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19206
+ * lastFrame copy source`), so its absence is now on this line whatever the
19207
+ * tile ended up being.
19208
+ *
19179
19209
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19180
19210
  * that predates the field, and every track whose tile landed native all
19181
19211
  * omit it. Render nothing when absent.
package/dist/addon.mjs CHANGED
@@ -18741,11 +18741,30 @@ var SensorEventSchema = object({
18741
18741
  value: record(string(), unknown()).nullable(),
18742
18742
  timestamp: number()
18743
18743
  });
18744
+ /**
18745
+ * One stored sighting on a track's trajectory.
18746
+ *
18747
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18748
+ * arrival order, and the two detector passes interleave, so a consumer must not
18749
+ * assume the two are the same on a row written by an older build.
18750
+ */
18744
18751
  var TrackPositionSchema = object({
18745
18752
  x: number(),
18746
18753
  y: number(),
18747
18754
  timestamp: number(),
18748
- bbox: BoundingBoxSchema
18755
+ bbox: BoundingBoxSchema,
18756
+ /**
18757
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18758
+ * pass on the analysis raster, `recovery` is the native-resolution
18759
+ * small-subject second pass (D377/D378). Both write into one array, and until
18760
+ * this field existed the only way to tell them apart was that full-frame boxes
18761
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18762
+ * Absent on rows written before D399.
18763
+ */
18764
+ source: _enum(["frame", "recovery"]).optional(),
18765
+ /** Detection score of this box, so a position can be weighed and not only
18766
+ * plotted. Absent on rows written before D399. */
18767
+ score: number().optional()
18749
18768
  });
18750
18769
  var TrackSnapshotSchema = object({
18751
18770
  timestamp: number(),
@@ -19145,14 +19164,25 @@ var TrackSchema = object({
19145
19164
  */
19146
19165
  hasRider: boolean().optional(),
19147
19166
  /**
19148
- * WHY this track ended without a NATIVE best-shot tile
19149
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19167
+ * WHY this track ended without a NATIVE best-shot FRAME
19168
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19169
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19150
19170
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19151
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19152
- * the late-keyFrame upgrade when a native tile lands after all. The
19153
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19171
+ * `derive-returned-null tile=standin`,
19172
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19173
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19174
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19154
19175
  * tile is a face/plate stand-in, a raster crop, or an icon.
19155
19176
  *
19177
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19178
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19179
+ * while its key frame missed carried no reason at all — three of the four
19180
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19181
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19182
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19183
+ * lastFrame copy source`), so its absence is now on this line whatever the
19184
+ * tile ended up being.
19185
+ *
19156
19186
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19157
19187
  * that predates the field, and every track whose tile landed native all
19158
19188
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-terminal",
3
- "version": "0.1.88",
3
+ "version": "0.1.89",
4
4
  "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
5
5
  "keywords": [
6
6
  "camstack",