@camstack/addon-pipeline 1.2.312 → 1.2.314

package/dist/motion-wasm/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BLf0YjAa.js");
+const require_dist = require("../dist-Jvi2SOxI.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
 let node_fs = require("node:fs");
 let node_path = require("node:path");

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,4 @@
-import { Ot as motionDetectionCapability, pn as BaseAddon, st as evaluateZoneRules, un as DeviceType, xn as hydrateSchema } from "../dist-B3_sbBDM.mjs";
+import { Sn as hydrateSchema, ct as evaluateZoneRules, dn as DeviceType, kt as motionDetectionCapability, mn as BaseAddon } from "../dist-E1Z_K22_.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{node-DJFKTJ0B.mjs → node-DHe-9_tm.mjs}

@@ -1,4 +1,4 @@
-import { an as buildFfmpegArgs, cn as isSoftwareDecode, dn as errMsg, in as Fmp4BoxSplitter } from "./dist-B3_sbBDM.mjs";
+import { an as Fmp4BoxSplitter, fn as errMsg, ln as isSoftwareDecode, on as buildFfmpegArgs } from "./dist-E1Z_K22_.mjs";
 import { randomUUID } from "node:crypto";
 import { realpathSync } from "node:fs";
 import path from "node:path";

package/dist/{node-Vwf2PuIT.js → node-EjcZQh8D.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-BLf0YjAa.js");
+const require_dist = require("./dist-Jvi2SOxI.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs, 1);

package/dist/pipeline-runner/index.js

@@ -3,9 +3,9 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BLf0YjAa.js");
-const require_node = require("../node-Vwf2PuIT.js");
-const require_default_detection_model = require("../default-detection-model-BZMS04Wn.js");
+const require_dist = require("../dist-Jvi2SOxI.js");
+const require_node = require("../node-EjcZQh8D.js");
+const require_default_detection_model = require("../default-detection-model-BvxtQEcb.js");
 const require_worker_protocol = require("../worker-protocol-C-G8qmye.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_lazy_sharp = require("../lazy-sharp-BuwKlQLR.js");
@@ -3412,6 +3412,39 @@ function iou(a, b) {
 	return union <= 0 ? 0 : intersection / union;
 }
 //#endregion
+//#region src/pipeline-runner/appearance-descriptor.ts
+/**
+* The model-free appearance descriptor of one box (D683 §8.1).
+*
+* Input: a small RGB view of the box (`APPEARANCE_VIEW`, resolved from the
+* frame lease the runner already holds, D379). Output: 96 integers — per
+* upper/lower half, a hue×saturation histogram (8×4), a value histogram (8)
+* and a magnitude-weighted gradient-orientation histogram (8) — each block
+* L1-normalised and quantised to 0–255. `gray` when the mean of saturation ×
+* value is under 0.08: IR, greyscale, and near-black noise (whose HSV
+* saturation is high but meaningless). No learned weights (O6).
+*/
+var APPEARANCE_VIEW = {
+	width: 16,
+	height: 32
+};
+/**
+* Which boxes get a descriptor. `'all'` unless the local cost gate (Task 10
+* Step 9) failed.
+*
+* `'all'` failed the local gate (`appearance-cost-bench.ts`, sharp-fallback
+* path, synthetic clip -- no live D681 tape was fetched in this session, see
+* the Task 10 commit message and report): frame p95 3.375 ms against a
+* 1.0 ms budget. `'candidates'` is cheaper but ALSO exceeded budget on the
+* same synthetic input (1.622 ms). Per the brief this is a STOP -- the
+* descriptor must not ship over budget on unconfirmed numbers. `'candidates'`
+* is kept here as the documented, safer fallback pending Task 24's hub
+* measurement over the REAL native-lease path (the one this bench does not
+* exercise); that number decides, and may move this back to `'all'` or
+* confirm `'candidates'`.
+*/
+var APPEARANCE_SCOPE = "candidates";
+//#endregion
 //#region src/pipeline-runner/capacity/capacity-runner.ts
 /**
 * Run ONE ramp step: `cameras` independent open-loop pacers for
@@ -8294,6 +8327,9 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	/** Per-camera cost of the carried evidence, drained by its report line. */
 	birthEvidenceCost = /* @__PURE__ */ new Map();
 	birthEvidenceReportedAt = /* @__PURE__ */ new Map();
+	/** Per-camera descriptor cost since the last report (D683). */
+	appearanceCost = /* @__PURE__ */ new Map();
+	appearanceReportedAt = /* @__PURE__ */ new Map();
 	/**
 	* Node-level RAM store of retained rgb detection frames, keyed by the
 	* `FrameHandle` that rides the inference-result event (shm-ring removal
@@ -8619,8 +8655,9 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		this.runner.onResult(async (deviceId, frame, result, _streamType, handle, source, occasion) => {
 			this.retention?.noteInferenceResult(deviceId, handle, result);
 			this.cutSubjectTiles(deviceId, result, handle);
-			const carried = await this.attachBirthEvidence(deviceId, frame, result);
-			this.emitInferenceResult(deviceId, frame, carried, handle, source, occasion);
+			const { result: carried, novel } = await this.attachBirthEvidence(deviceId, frame, result);
+			const described = await this.attachAppearance(deviceId, frame, carried, novel);
+			this.emitInferenceResult(deviceId, frame, described, handle, source, occasion);
 			const detectionCount = result.detections?.length ?? 0;
 			this.runner?.noteDetectionResult(deviceId, detectionCount);
 			if (detectionCount > 0 && this.occupancyBurstInFlight.has(deviceId)) this.occupancyBurstFound.add(deviceId);
@@ -9802,10 +9839,17 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 	* dropped the evidence would be indistinguishable from a camera with no
 	* births at all, which is the shape of failure this whole change exists to
 	* remove.
+	*
+	* Also returns `novel`: the set of `plan[].index` this pass planned as
+	* birth candidates — reused by `attachAppearance` so the 'candidates'
+	* appearance scope (D683) does not recompute the same novelty question.
 	*/
 	async attachBirthEvidence(deviceId, frame, result) {
 		const detections = result.detections;
-		if (detections.length === 0) return result;
+		if (detections.length === 0) return {
+			result,
+			novel: /* @__PURE__ */ new Set()
+		};
 		const plan = planBirthEvidence(deviceId, detections.map((d) => ({
 			bbox: d.bbox,
 			score: d.score,
@@ -9814,7 +9858,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			width: result.width,
 			height: result.height
 		}, this.birthNovelty, Date.now());
-		if (plan.length === 0) return result;
+		if (plan.length === 0) return {
+			result,
+			novel: /* @__PURE__ */ new Set()
+		};
+		const novel = new Set(plan.map((entry) => entry.index));
 		const cost = this.birthEvidenceCost.get(deviceId) ?? {
 			cut: 0,
 			failed: 0,
@@ -9827,7 +9875,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		if (!(frame.frameRef !== void 0 || frame.format === "rgb" && frame.data.byteLength >= result.width * result.height * 3)) {
 			cost.skippedNoPixels += plan.length;
 			this.reportBirthEvidenceCost(deviceId);
-			return result;
+			return {
+				result,
+				novel
+			};
 		}
 		for (const entry of plan) {
 			const startedAt = Date.now();
@@ -9846,16 +9897,22 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			});
 		}
 		this.reportBirthEvidenceCost(deviceId);
-		if (byIndex.size === 0) return result;
+		if (byIndex.size === 0) return {
+			result,
+			novel
+		};
 		return {
-			...result,
-			detections: detections.map((d, i) => {
-				const evidence = byIndex.get(i);
-				return evidence === void 0 ? d : {
-					...d,
-					birthEvidence: evidence
-				};
-			})
+			result: {
+				...result,
+				detections: detections.map((d, i) => {
+					const evidence = byIndex.get(i);
+					return evidence === void 0 ? d : {
+						...d,
+						birthEvidence: evidence
+					};
+				})
+			},
+			novel
 		};
 	}
 	/**
@@ -9961,6 +10018,117 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		cost.bytes = 0;
 		cost.encodeMs = 0;
 	}
+	/**
+	* The v2 tracker's appearance descriptor (D683 §8.1), cut from the same
+	* raster the birth evidence uses (lease first, inline RGB second). A frame
+	* with no raster attaches nothing and is counted as `skippedNoPixels`.
+	*
+	* OFF by default (fix round 1, coordinator ruling 2026-09-30): appearance
+	* is unproven cost until Task 23 calibrates it, so a disabled camera must
+	* add NOTHING to the frame path — no crop, no resample, no descriptor.
+	* `APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT` is the SAME authority the v2
+	* tracker's own default reads (`@camstack/types`, never a second flag that
+	* could disagree with it — CLAUDE.md D62). Checked here, before any
+	* per-camera bookkeeping, AND inside {@link attachAppearanceIfEnabled} —
+	* one symbol, checked defensively in two frames, not two settings.
+	*/
+	async attachAppearance(deviceId, frame, result, novel) {
+		return result;
+	}
+	foldAppearanceCost(into, add) {
+		into.attached += add.attached;
+		into.tooSmall += add.tooSmall;
+		into.failed += add.failed;
+		into.skippedScope += add.skippedScope;
+		into.ms += add.ms;
+	}
+	/** A 16×32 RGB view of `crop`: the lease when there is one, else the inline buffer. */
+	async readAppearanceView(frame, result, crop) {
+		if (frame.frameRef !== void 0) {
+			const lease = require_default_detection_model.localFrameRegistry.acquire(frame.frameRef);
+			if (lease) {
+				let reason = "error";
+				try {
+					const view = await lease.resolve({
+						crop,
+						content: {
+							width: APPEARANCE_VIEW.width,
+							height: APPEARANCE_VIEW.height
+						},
+						fit: "stretch",
+						format: "rgb"
+					});
+					if (view.kind !== "view") {
+						reason = "drop";
+						return null;
+					}
+					if (view.data.byteLength !== APPEARANCE_VIEW.width * APPEARANCE_VIEW.height * 3) {
+						reason = "error";
+						return null;
+					}
+					reason = "success";
+					return {
+						data: new Uint8Array(view.data),
+						width: APPEARANCE_VIEW.width,
+						height: APPEARANCE_VIEW.height
+					};
+				} catch {
+					return null;
+				} finally {
+					lease.release(reason);
+				}
+			}
+		}
+		if (frame.format !== "rgb" || frame.data.byteLength < result.width * result.height * 3) return null;
+		try {
+			const data = await (await require_lazy_sharp.getSharp())(frame.data, { raw: {
+				width: result.width,
+				height: result.height,
+				channels: 3
+			} }).extract(crop).resize(APPEARANCE_VIEW.width, APPEARANCE_VIEW.height, { fit: "fill" }).raw().toBuffer();
+			return {
+				data: new Uint8Array(data),
+				width: APPEARANCE_VIEW.width,
+				height: APPEARANCE_VIEW.height
+			};
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* State, per camera, what attaching the descriptor cost over the window —
+	* and drain it (D683, mirrors {@link reportBirthEvidenceCost}). The cost
+	* gate (Step 9) is measured offline; this line is what proves the shipped
+	* runner matches the bench.
+	*/
+	reportAppearanceCost(deviceId) {
+		const cost = this.appearanceCost.get(deviceId);
+		if (!cost) return;
+		const now = Date.now();
+		const lastAt = this.appearanceReportedAt.get(deviceId) ?? 0;
+		if (lastAt !== 0 && now - lastAt < BIRTH_EVIDENCE_REPORT_INTERVAL_MS) return;
+		const windowMs = lastAt === 0 ? BIRTH_EVIDENCE_REPORT_INTERVAL_MS : now - lastAt;
+		this.appearanceReportedAt.set(deviceId, now);
+		this.ctx.logger.info("appearance descriptors attached", {
+			tags: { deviceId },
+			meta: {
+				attached: cost.attached,
+				tooSmall: cost.tooSmall,
+				failed: cost.failed,
+				skippedNoPixels: cost.skippedNoPixels,
+				skippedScope: cost.skippedScope,
+				meanMs: cost.attached > 0 ? Number((cost.ms / cost.attached).toFixed(2)) : 0,
+				scope: APPEARANCE_SCOPE,
+				windowMs
+			}
+		});
+		cost.attached = 0;
+		cost.tooSmall = 0;
+		cost.failed = 0;
+		cost.skippedNoPixels = 0;
+		cost.skippedScope = 0;
+		cost.ms = 0;
+	}
 	async resolveNativeCropPixels(input) {
 		const b = input.bbox;
 		const isFullFrame = b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999;
@@ -10636,6 +10804,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 		this.birthNovelty.clearDevice(deviceId);
 		this.birthEvidenceCost.delete(deviceId);
 		this.birthEvidenceReportedAt.delete(deviceId);
+		this.appearanceCost.delete(deviceId);
+		this.appearanceReportedAt.delete(deviceId);
 		this.runner?.unregisterCamera(deviceId);
 		this.ctx?.logger.info("detachCamera", {
 			tags: { deviceId },

package/dist/pipeline-runner/index.mjs

@@ -1,6 +1,6 @@
-import { An as _enum, Bn as string, C as FailureCounters, D as NativeLeaseAdmissionSchema, E as MOTION_CLOSE_AFTER_MS, Fn as literal, Ft as pipelineRunnerCapability, Hn as EventCategory, In as number, Ln as object, Mn as boolean, Mt as pickDetailCropConvention, Nt as pickNativeLeaseOverride, O as NativeLeaseSettingsSchema, Pn as lazy, Tn as nodePin, _ as DEFAULT_NATIVE_LEASE_SETTINGS, _n as createEvent, dn as errMsg, dt as failureContributionCapability, h as DEFAULT_DETAIL_CROP_CONVENTION, i as BackgroundRunRegistry, jn as array, pn as BaseAddon, tt as deriveDetailCropRect, vn as customAction, yn as defineCustomActions, yt as loadContributionCapability } from "../dist-B3_sbBDM.mjs";
-import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-DJFKTJ0B.mjs";
-import { c as macroGateVerdict, d as resolveFrameViewGeometry, g as getStepDefinition, l as rootObjectGate, o as placeDetailStep, r as CustomModelCatalog, s as stepsForElectedPool, u as localFrameRegistry, v as RETIRED_MODEL_IDS } from "../default-detection-model-ClQ1gcZ9.mjs";
+import { D as MOTION_CLOSE_AFTER_MS, En as nodePin, Fn as lazy, In as literal, It as pipelineRunnerCapability, Ln as number, Mn as array, Nn as boolean, Nt as pickDetailCropConvention, O as NativeLeaseAdmissionSchema, Pt as pickNativeLeaseOverride, Rn as object, Un as EventCategory, Vn as string, a as BackgroundRunRegistry, bn as defineCustomActions, bt as loadContributionCapability, fn as errMsg, ft as failureContributionCapability, g as DEFAULT_DETAIL_CROP_CONVENTION, jn as _enum, k as NativeLeaseSettingsSchema, mn as BaseAddon, nt as deriveDetailCropRect, v as DEFAULT_NATIVE_LEASE_SETTINGS, vn as createEvent, w as FailureCounters, yn as customAction } from "../dist-E1Z_K22_.mjs";
+import { i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-DHe-9_tm.mjs";
+import { c as macroGateVerdict, d as resolveFrameViewGeometry, g as getStepDefinition, l as rootObjectGate, o as placeDetailStep, r as CustomModelCatalog, s as stepsForElectedPool, u as localFrameRegistry, v as RETIRED_MODEL_IDS } from "../default-detection-model-Es1-dvFU.mjs";
 import { t as isWorkerReply } from "../worker-protocol-D_NzPcnh.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
@@ -3404,6 +3404,39 @@ function iou(a, b) {
 	return union <= 0 ? 0 : intersection / union;
 }
 //#endregion
+//#region src/pipeline-runner/appearance-descriptor.ts
+/**
+* The model-free appearance descriptor of one box (D683 §8.1).
+*
+* Input: a small RGB view of the box (`APPEARANCE_VIEW`, resolved from the
+* frame lease the runner already holds, D379). Output: 96 integers — per
+* upper/lower half, a hue×saturation histogram (8×4), a value histogram (8)
+* and a magnitude-weighted gradient-orientation histogram (8) — each block
+* L1-normalised and quantised to 0–255. `gray` when the mean of saturation ×
+* value is under 0.08: IR, greyscale, and near-black noise (whose HSV
+* saturation is high but meaningless). No learned weights (O6).
+*/
+var APPEARANCE_VIEW = {
+	width: 16,
+	height: 32
+};
+/**
+* Which boxes get a descriptor. `'all'` unless the local cost gate (Task 10
+* Step 9) failed.
+*
+* `'all'` failed the local gate (`appearance-cost-bench.ts`, sharp-fallback
+* path, synthetic clip -- no live D681 tape was fetched in this session, see
+* the Task 10 commit message and report): frame p95 3.375 ms against a
+* 1.0 ms budget. `'candidates'` is cheaper but ALSO exceeded budget on the
+* same synthetic input (1.622 ms). Per the brief this is a STOP -- the
+* descriptor must not ship over budget on unconfirmed numbers. `'candidates'`
+* is kept here as the documented, safer fallback pending Task 24's hub
+* measurement over the REAL native-lease path (the one this bench does not
+* exercise); that number decides, and may move this back to `'all'` or
+* confirm `'candidates'`.
+*/
+var APPEARANCE_SCOPE = "candidates";
+//#endregion
 //#region src/pipeline-runner/capacity/capacity-runner.ts
 /**
 * Run ONE ramp step: `cameras` independent open-loop pacers for
@@ -8286,6 +8319,9 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	/** Per-camera cost of the carried evidence, drained by its report line. */
 	birthEvidenceCost = /* @__PURE__ */ new Map();
 	birthEvidenceReportedAt = /* @__PURE__ */ new Map();
+	/** Per-camera descriptor cost since the last report (D683). */
+	appearanceCost = /* @__PURE__ */ new Map();
+	appearanceReportedAt = /* @__PURE__ */ new Map();
 	/**
 	* Node-level RAM store of retained rgb detection frames, keyed by the
 	* `FrameHandle` that rides the inference-result event (shm-ring removal
@@ -8611,8 +8647,9 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.runner.onResult(async (deviceId, frame, result, _streamType, handle, source, occasion) => {
 			this.retention?.noteInferenceResult(deviceId, handle, result);
 			this.cutSubjectTiles(deviceId, result, handle);
-			const carried = await this.attachBirthEvidence(deviceId, frame, result);
-			this.emitInferenceResult(deviceId, frame, carried, handle, source, occasion);
+			const { result: carried, novel } = await this.attachBirthEvidence(deviceId, frame, result);
+			const described = await this.attachAppearance(deviceId, frame, carried, novel);
+			this.emitInferenceResult(deviceId, frame, described, handle, source, occasion);
 			const detectionCount = result.detections?.length ?? 0;
 			this.runner?.noteDetectionResult(deviceId, detectionCount);
 			if (detectionCount > 0 && this.occupancyBurstInFlight.has(deviceId)) this.occupancyBurstFound.add(deviceId);
@@ -9794,10 +9831,17 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 	* dropped the evidence would be indistinguishable from a camera with no
 	* births at all, which is the shape of failure this whole change exists to
 	* remove.
+	*
+	* Also returns `novel`: the set of `plan[].index` this pass planned as
+	* birth candidates — reused by `attachAppearance` so the 'candidates'
+	* appearance scope (D683) does not recompute the same novelty question.
 	*/
 	async attachBirthEvidence(deviceId, frame, result) {
 		const detections = result.detections;
-		if (detections.length === 0) return result;
+		if (detections.length === 0) return {
+			result,
+			novel: /* @__PURE__ */ new Set()
+		};
 		const plan = planBirthEvidence(deviceId, detections.map((d) => ({
 			bbox: d.bbox,
 			score: d.score,
@@ -9806,7 +9850,11 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			width: result.width,
 			height: result.height
 		}, this.birthNovelty, Date.now());
-		if (plan.length === 0) return result;
+		if (plan.length === 0) return {
+			result,
+			novel: /* @__PURE__ */ new Set()
+		};
+		const novel = new Set(plan.map((entry) => entry.index));
 		const cost = this.birthEvidenceCost.get(deviceId) ?? {
 			cut: 0,
 			failed: 0,
@@ -9819,7 +9867,10 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		if (!(frame.frameRef !== void 0 || frame.format === "rgb" && frame.data.byteLength >= result.width * result.height * 3)) {
 			cost.skippedNoPixels += plan.length;
 			this.reportBirthEvidenceCost(deviceId);
-			return result;
+			return {
+				result,
+				novel
+			};
 		}
 		for (const entry of plan) {
 			const startedAt = Date.now();
@@ -9838,16 +9889,22 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			});
 		}
 		this.reportBirthEvidenceCost(deviceId);
-		if (byIndex.size === 0) return result;
+		if (byIndex.size === 0) return {
+			result,
+			novel
+		};
 		return {
-			...result,
-			detections: detections.map((d, i) => {
-				const evidence = byIndex.get(i);
-				return evidence === void 0 ? d : {
-					...d,
-					birthEvidence: evidence
-				};
-			})
+			result: {
+				...result,
+				detections: detections.map((d, i) => {
+					const evidence = byIndex.get(i);
+					return evidence === void 0 ? d : {
+						...d,
+						birthEvidence: evidence
+					};
+				})
+			},
+			novel
 		};
 	}
 	/**
@@ -9953,6 +10010,117 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		cost.bytes = 0;
 		cost.encodeMs = 0;
 	}
+	/**
+	* The v2 tracker's appearance descriptor (D683 §8.1), cut from the same
+	* raster the birth evidence uses (lease first, inline RGB second). A frame
+	* with no raster attaches nothing and is counted as `skippedNoPixels`.
+	*
+	* OFF by default (fix round 1, coordinator ruling 2026-09-30): appearance
+	* is unproven cost until Task 23 calibrates it, so a disabled camera must
+	* add NOTHING to the frame path — no crop, no resample, no descriptor.
+	* `APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT` is the SAME authority the v2
+	* tracker's own default reads (`@camstack/types`, never a second flag that
+	* could disagree with it — CLAUDE.md D62). Checked here, before any
+	* per-camera bookkeeping, AND inside {@link attachAppearanceIfEnabled} —
+	* one symbol, checked defensively in two frames, not two settings.
+	*/
+	async attachAppearance(deviceId, frame, result, novel) {
+		return result;
+	}
+	foldAppearanceCost(into, add) {
+		into.attached += add.attached;
+		into.tooSmall += add.tooSmall;
+		into.failed += add.failed;
+		into.skippedScope += add.skippedScope;
+		into.ms += add.ms;
+	}
+	/** A 16×32 RGB view of `crop`: the lease when there is one, else the inline buffer. */
+	async readAppearanceView(frame, result, crop) {
+		if (frame.frameRef !== void 0) {
+			const lease = localFrameRegistry.acquire(frame.frameRef);
+			if (lease) {
+				let reason = "error";
+				try {
+					const view = await lease.resolve({
+						crop,
+						content: {
+							width: APPEARANCE_VIEW.width,
+							height: APPEARANCE_VIEW.height
+						},
+						fit: "stretch",
+						format: "rgb"
+					});
+					if (view.kind !== "view") {
+						reason = "drop";
+						return null;
+					}
+					if (view.data.byteLength !== APPEARANCE_VIEW.width * APPEARANCE_VIEW.height * 3) {
+						reason = "error";
+						return null;
+					}
+					reason = "success";
+					return {
+						data: new Uint8Array(view.data),
+						width: APPEARANCE_VIEW.width,
+						height: APPEARANCE_VIEW.height
+					};
+				} catch {
+					return null;
+				} finally {
+					lease.release(reason);
+				}
+			}
+		}
+		if (frame.format !== "rgb" || frame.data.byteLength < result.width * result.height * 3) return null;
+		try {
+			const data = await (await getSharp())(frame.data, { raw: {
+				width: result.width,
+				height: result.height,
+				channels: 3
+			} }).extract(crop).resize(APPEARANCE_VIEW.width, APPEARANCE_VIEW.height, { fit: "fill" }).raw().toBuffer();
+			return {
+				data: new Uint8Array(data),
+				width: APPEARANCE_VIEW.width,
+				height: APPEARANCE_VIEW.height
+			};
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* State, per camera, what attaching the descriptor cost over the window —
+	* and drain it (D683, mirrors {@link reportBirthEvidenceCost}). The cost
+	* gate (Step 9) is measured offline; this line is what proves the shipped
+	* runner matches the bench.
+	*/
+	reportAppearanceCost(deviceId) {
+		const cost = this.appearanceCost.get(deviceId);
+		if (!cost) return;
+		const now = Date.now();
+		const lastAt = this.appearanceReportedAt.get(deviceId) ?? 0;
+		if (lastAt !== 0 && now - lastAt < BIRTH_EVIDENCE_REPORT_INTERVAL_MS) return;
+		const windowMs = lastAt === 0 ? BIRTH_EVIDENCE_REPORT_INTERVAL_MS : now - lastAt;
+		this.appearanceReportedAt.set(deviceId, now);
+		this.ctx.logger.info("appearance descriptors attached", {
+			tags: { deviceId },
+			meta: {
+				attached: cost.attached,
+				tooSmall: cost.tooSmall,
+				failed: cost.failed,
+				skippedNoPixels: cost.skippedNoPixels,
+				skippedScope: cost.skippedScope,
+				meanMs: cost.attached > 0 ? Number((cost.ms / cost.attached).toFixed(2)) : 0,
+				scope: APPEARANCE_SCOPE,
+				windowMs
+			}
+		});
+		cost.attached = 0;
+		cost.tooSmall = 0;
+		cost.failed = 0;
+		cost.skippedNoPixels = 0;
+		cost.skippedScope = 0;
+		cost.ms = 0;
+	}
 	async resolveNativeCropPixels(input) {
 		const b = input.bbox;
 		const isFullFrame = b.x <= .001 && b.y <= .001 && b.w >= .999 && b.h >= .999;
@@ -10628,6 +10796,8 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 		this.birthNovelty.clearDevice(deviceId);
 		this.birthEvidenceCost.delete(deviceId);
 		this.birthEvidenceReportedAt.delete(deviceId);
+		this.appearanceCost.delete(deviceId);
+		this.appearanceReportedAt.delete(deviceId);
 		this.runner?.unregisterCamera(deviceId);
 		this.ctx?.logger.info("detachCamera", {
 			tags: { deviceId },

package/dist/{process-memory-DGTVVYlX.js → process-memory-BUtnSPYK.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-BLf0YjAa.js");
+const require_dist = require("./dist-Jvi2SOxI.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/{process-memory-BvwauBlX.mjs → process-memory-IQcwHauP.mjs}

@@ -1,4 +1,4 @@
-import { At as parseProcStatus } from "./dist-B3_sbBDM.mjs";
+import { jt as parseProcStatus } from "./dist-E1Z_K22_.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 //#region src/shared/node-topology-platform.ts

package/dist/recorder/index.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-BLf0YjAa.js");
-const require_node = require("../node-Vwf2PuIT.js");
+const require_dist = require("../dist-Jvi2SOxI.js");
+const require_node = require("../node-EjcZQh8D.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_restream_intent = require("../restream-intent-7uDNqMKs.js");
 const require_retire_root_keys = require("../retire-root-keys-Csb8z2f3.js");

package/dist/recorder/index.mjs

@@ -1,5 +1,5 @@
-import { An as _enum, B as VISIT_MERGE_GAP_MS, Bn as string, Bt as recordingSignalCapability, Ct as mayReadLocation, Dt as modeMayWrite, Et as migrateLegacyDeviceSignalConfig, F as RECORDING_SOURCE_CAMSTACK_ADDON, Hn as EventCategory, Ht as resolveCreateExportSubject, I as RecordingConfigSchema, In as number, J as clipExportFailure, K as batteryCapability, Kt as resolveRecordingProfiles, L as RecordingSignalStatusSchema, Ln as object, Lt as recordingArchiveCapability, Mn as boolean, N as RECORDING_EXPORT_MAX_READ_BYTES, On as selectAssignedProfileSlots, P as RECORDING_SOURCE_CAMSTACK, Qt as stripRetiredBandPreBufferSec, Rn as preprocess, Rt as recordingCapability, S as ExportRecordSchema, Tn as nodePin, Tt as memoizePinnedFfmpeg, Wt as resolveLocationMode, Xt as storageOccupancyCapability, Y as clipExportFailureOf, Yt as storageEvictableCapability, a as BatteryStatusSchema, b as EVENT_PAD_MS, ct as evictionPolicyForMode, dn as errMsg$1, en as videoclipsCapability, et as deriveBatteryPresence, g as DEFAULT_EVENTS_BAND_BUFFER_SEC, jn as array, k as OpsLogEntrySchema, kn as sleep$1, ln as DeviceFeature, lt as evictionPolicyOfLocation, nt as deriveRecordingMode, o as CLIP_BROKER_PACED_RATES, on as evaluateSensorEdge, pn as BaseAddon, pt as gbToBytes, un as DeviceType, ut as exportSubjectOf, vn as customAction, vt as isFirstLevelMacroClass, wt as mayWriteToLocation, xn as hydrateSchema, y as EVENT_OWNER_TYPES, yn as defineCustomActions, yt as loadContributionCapability, z as VIDEOCLIPS_MAX_OFFER_BYTES, zn as record, zt as recordingExportCapability } from "../dist-B3_sbBDM.mjs";
-import { a as physicalRootOf, i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-DJFKTJ0B.mjs";
+import { $t as stripRetiredBandPreBufferSec, A as OpsLogEntrySchema, An as sleep$1, B as VIDEOCLIPS_MAX_OFFER_BYTES, Bn as record, Bt as recordingExportCapability, C as ExportRecordSchema, Dt as migrateLegacyDeviceSignalConfig, En as nodePin, Et as memoizePinnedFfmpeg, F as RECORDING_SOURCE_CAMSTACK, Gt as resolveLocationMode, I as RECORDING_SOURCE_CAMSTACK_ADDON, L as RecordingConfigSchema, Ln as number, Mn as array, Nn as boolean, Ot as modeMayWrite, P as RECORDING_EXPORT_MAX_READ_BYTES, R as RecordingSignalStatusSchema, Rn as object, Rt as recordingArchiveCapability, Sn as hydrateSchema, Tt as mayWriteToLocation, Un as EventCategory, Ut as resolveCreateExportSubject, V as VISIT_MERGE_GAP_MS, Vn as string, Vt as recordingSignalCapability, X as clipExportFailureOf, Xt as storageEvictableCapability, Y as clipExportFailure, Zt as storageOccupancyCapability, _ as DEFAULT_EVENTS_BAND_BUFFER_SEC, b as EVENT_OWNER_TYPES, bn as defineCustomActions, bt as loadContributionCapability, dn as DeviceType, dt as exportSubjectOf, fn as errMsg$1, jn as _enum, kn as selectAssignedProfileSlots, lt as evictionPolicyForMode, mn as BaseAddon, mt as gbToBytes, o as BatteryStatusSchema, q as batteryCapability, qt as resolveRecordingProfiles, rt as deriveRecordingMode, s as CLIP_BROKER_PACED_RATES, sn as evaluateSensorEdge, tn as videoclipsCapability, tt as deriveBatteryPresence, un as DeviceFeature, ut as evictionPolicyOfLocation, wt as mayReadLocation, x as EVENT_PAD_MS, yn as customAction, yt as isFirstLevelMacroClass, zn as preprocess, zt as recordingCapability } from "../dist-E1Z_K22_.mjs";
+import { a as physicalRootOf, i as NO_COST_CLAIM, t as ChildCostRegistry } from "../node-DHe-9_tm.mjs";
 import { t as resolveHubHostname } from "../hub-hostname-cCknRYKj.mjs";
 import { d as PREBUFFER_MAX_MS, l as withRecordingIntent, r as RECORDING_PRE_ROLL_REQUEST_MS } from "../restream-intent-DyGmLAU9.mjs";
 import { n as RowMapStore, t as retireRootKeys } from "../retire-root-keys-DZvlso2l.mjs";

package/dist/{segment-demux-js-C0oz7IVm.mjs → segment-demux-js-CR58wpzs.mjs}

@@ -1,5 +1,5 @@
 import { r as __toESM, t as __commonJSMin } from "./chunk-DnnnRqeS.mjs";
-import { dn as errMsg } from "./dist-B3_sbBDM.mjs";
+import { fn as errMsg } from "./dist-E1Z_K22_.mjs";
 import { spawn } from "node:child_process";
 //#region src/stream-broker/recorded/avcc-annexb.ts
 /**

package/dist/{segment-demux-js-BUAAuSVF.js → segment-demux-js-Il0EkSOb.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_dist = require("./dist-BLf0YjAa.js");
+const require_dist = require("./dist-Jvi2SOxI.js");
 let node_child_process = require("node:child_process");
 //#region src/stream-broker/recorded/avcc-annexb.ts
 /**

package/dist/stream-broker/_stub.js

@@ -1,7 +1,7 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-BhO-szf8.mjs";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-DddXyc17.mjs";
 import { a as p, i as m, n as h, o as g, r as _, t as v } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare__react__loadShare__.js-C9j-2lBe.mjs";
 import { n as y, r as b, t as x } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-XO0-Pyu6.mjs";
-import { t as S } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-C6EaWavG.mjs";
+import { t as S } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-D0BR9vFO.mjs";
 import { n as C, t as w } from "./_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_tanstack_mf_1_react_mf_2_query__loadShare__.js-BO7TIbJV.mjs";
 //#region ../../node_modules/lucide-react/dist/esm/shared/src/utils/mergeClasses.js
 var T = (...e) => e.filter((e, t, n) => !!e && e.trim() !== "" && n.indexOf(e) === t).join(" ").trim(), E = (e) => e.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(), D = (e) => e.replace(/^([A-Z])|[\s-_]+(\w)/g, (e, t, n) => n ? n.toUpperCase() : t.toLowerCase()), O = (e) => {