@camstack/types 1.2.278 → 1.2.280

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

@@ -233,6 +233,9 @@ export interface PipelineAnalyticsTrackLifecyclePayload {
     };
     readonly embeddingId?: string;
     readonly embeddingModelId?: string;
+    /** D683: present on the `end` of a piece L2 fused into another track — the
+     *  subject continues under this id; consumers merge rather than count two. */
+    readonly fusedIntoTrackId?: string;
     readonly [key: string]: unknown;
 }
 /**

package/dist/notification/condition-taxonomy.d.ts

@@ -46,6 +46,18 @@ export interface TaxonomyPicker {
  * condition has no fixed vocabulary (→ free-text tag input).
  */
 export declare function pickerForCondition(conditionId: string, taxonomy: NcTaxonomy | undefined): TaxonomyPicker | null;
+/**
+ * The class picker a RULE's class scope uses: {@link pickerForCondition}'s
+ * `classes` vocabulary WITHOUT the audio group (R13, D690).
+ *
+ * A detection rule that picked a sound there became the legacy one-sample audio
+ * rule and broke itself; sounds are authored on a Sound rule
+ * (`conditions.audio`). The plain `classes` picker keeps the audio group for
+ * the surfaces where a sound IS a class — a snooze, a report, the simulator.
+ */
+export declare function pickerForRuleClasses(taxonomy: NcTaxonomy | undefined): TaxonomyPicker | null;
+/** An audio kind (`audio-*`) — the one prefix every sound class carries. */
+export declare function isAudioClassName(name: string): boolean;
 /** All option values across a picker's groups (for custom-value detection). */
 export declare function knownValues(picker: TaxonomyPicker): ReadonlySet<string>;
 /**

package/dist/types/appearance.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A model-free appearance descriptor of one detection box (D683 §8).
+ *
+ * Computed on the runner from the analysis raster the frame already leased
+ * (`pipeline-runner/appearance-descriptor.ts`), carried on `ObjectDetection`
+ * and mirrored onto the tracker's `SpatialDetection`. A vector about a box,
+ * never pixels (D9/D18). No learned weights, so no licence question (O6).
+ *
+ * Layout: the box shrunk 10 % per side, split into an upper and a lower half;
+ * per half a hue–saturation histogram (8 hue × 4 saturation), a value histogram
+ * (8) and a magnitude-weighted gradient-orientation histogram (8). Each block
+ * is L1-normalised and quantised to integers 0–255. About 300 bytes of JSON.
+ */
+export declare const APPEARANCE_DESCRIPTOR_VERSION = 1;
+export declare const APPEARANCE_BIN_COUNT = 96;
+export declare const APPEARANCE_BLOCKS: {
+    readonly upperHs: readonly [0, 32];
+    readonly upperV: readonly [32, 40];
+    readonly upperGrad: readonly [40, 48];
+    readonly lowerHs: readonly [48, 80];
+    readonly lowerV: readonly [80, 88];
+    readonly lowerGrad: readonly [88, 96];
+};
+export type AppearanceBlockName = keyof typeof APPEARANCE_BLOCKS;
+export interface AppearanceDescriptor {
+    readonly version: 1;
+    /** {@link APPEARANCE_BIN_COUNT} integers, laid out by {@link APPEARANCE_BLOCKS}. */
+    readonly bins: readonly number[];
+    /** The view carries no colour (IR / greyscale / near-black): hue–saturation says nothing. */
+    readonly gray: boolean;
+}
+/**
+ * Whether appearance may influence anything at all (D683 §3.2, fix round 1
+ * ruling 2026-09-30 on the Task 10 cost-bench STOP): OFF until the
+ * descriptor is calibrated on tapes that carry it (Task 23, review M9).
+ *
+ * This is the ONE authority both addons read — never two settings that
+ * could disagree (CLAUDE.md D62). The tracker's `TrackerV2Config.appearanceResolvesAmbiguity`
+ * default reads it (`addon-post-analysis/pipeline/tracker-v2/types.ts`); the
+ * runner's cost gate reads it too (`addon-pipeline/pipeline-runner/appearance-attach.ts`),
+ * short-circuiting BEFORE any crop, resample or descriptor is computed, so a
+ * disabled camera costs nothing extra per frame.
+ */
+export declare const APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT = false;

package/dist/types/detection.d.ts

@@ -1,6 +1,7 @@
 import type { FirstLevelMacroClass } from './labels.js';
 import type { AudioClassifyOutcome } from '../capabilities/schemas/detection-shared.js';
 import type { TrackState } from '../capabilities/pipeline-analytics.cap.js';
+import type { AppearanceDescriptor } from './appearance.js';
 import type { BoundingBox as EngineBoundingBox, FrameInput, Landmark } from './io.js';
 export interface SpatialDetection {
     readonly class: string;
@@ -24,6 +25,12 @@ export interface SpatialDetection {
      * produced it all the way to the confirmation gate (D379).
      */
     readonly birthEvidence?: BirthEvidence;
+    /**
+     * Mirrored from {@link ObjectDetection.appearance} when this detection enters
+     * the tracker (D683). Absent = no descriptor was computed (too small, no
+     * raster, a runner that predates it): never read as "different".
+     */
+    readonly appearance?: AppearanceDescriptor;
 }
 export interface CropInput {
     readonly frame: FrameInput;
@@ -422,6 +429,11 @@ export interface ObjectDetection extends DetectionBase {
         readonly x: number;
         readonly y: number;
     }[];
+    /**
+     * The box's model-free appearance descriptor, computed by the runner on the
+     * frame this detection was measured on (D683). First-level boxes only.
+     */
+    readonly appearance?: AppearanceDescriptor;
 }
 /** Audio detection — flat, time-localised within the window. */
 export interface AudioDetection extends DetectionBase {

package/package.json

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