@camstack/addon-post-analysis 1.2.663 → 1.2.665

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-Cz8LWYwU.js");
+const require_clip_model_registry = require("../clip-model-registry-nn_STiGt.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -12284,6 +12284,16 @@ var NcStateSummaryTestSchema = require_clip_model_registry.object({
 	}))
 });
 //#endregion
+//#region src/notification-center/template-defaults.ts
+function servedTemplateDefaults(texts) {
+	return [{
+		id: "appliance-cycle",
+		kind: "sensor",
+		title: texts.raw("appliance.finished.title") ?? "",
+		body: texts.raw("appliance.finished.body") ?? ""
+	}];
+}
+//#endregion
 //#region src/notification-center/clock-text.ts
 /**
 * `{{time}}` — hours and minutes in the NOTIFICATION language.
@@ -13682,7 +13692,10 @@ var ncActions = require_clip_model_registry.defineCustomActions({
 		catalog: require_clip_model_registry.array(require_clip_model_registry.NcConditionDescriptorSchema),
 		taxonomy: require_clip_model_registry.NcTaxonomySchema
 	})),
-	"nc.getTemplateCatalog": require_clip_model_registry.customAction(require_clip_model_registry.object({}), require_clip_model_registry.object({ vars: require_clip_model_registry.array(require_clip_model_registry.NcTemplateVarDescriptorSchema) })),
+	"nc.getTemplateCatalog": require_clip_model_registry.customAction(require_clip_model_registry.object({}), require_clip_model_registry.object({
+		vars: require_clip_model_registry.array(require_clip_model_registry.NcTemplateVarDescriptorSchema),
+		defaults: require_clip_model_registry.array(require_clip_model_registry.NcTemplateDefaultSchema)
+	})),
 	"nc.previewTemplate": require_clip_model_registry.customAction(require_clip_model_registry.NcTemplatePreviewInputSchema, require_clip_model_registry.NcTemplatePreviewSchema, { kind: "mutation" }),
 	"nc.createRule": require_clip_model_registry.customAction(require_clip_model_registry.object({ rule: require_clip_model_registry.NcRuleInputSchema }), require_clip_model_registry.object({ rule: require_clip_model_registry.NcRuleSchema }), {
 		kind: "mutation",
@@ -14462,7 +14475,10 @@ function makeNcActionHandlers(deps) {
 			catalog: [...require_clip_model_registry.NC_CONDITION_CATALOG],
 			taxonomy: require_clip_model_registry.NC_TAXONOMY
 		}),
-		"nc.getTemplateCatalog": async () => ({ vars: require_clip_model_registry.servedTemplateVars() }),
+		"nc.getTemplateCatalog": async () => ({
+			vars: require_clip_model_registry.servedTemplateVars(),
+			defaults: deps.previewTexts === void 0 ? [] : servedTemplateDefaults(deps.previewTexts)
+		}),
 		"nc.previewTemplate": async (input) => {
 			const texts = deps.previewTexts;
 			if (texts === void 0) throw new Error("nc.previewTemplate: text catalog not wired");
@@ -49951,7 +49967,7 @@ async function encodeRgbCropToJpeg(bytes, width, height) {
 * what lets the caller stop base64-ing purely to be understood.
 */
 async function decodeJpegToRgb(jpeg) {
-	const { data, info } = await (0, sharp.default)(typeof jpeg === "string" ? Buffer.from(jpeg, "base64") : jpeg).raw().toBuffer({ resolveWithObject: true });
+	const { data, info } = await (0, sharp.default)(typeof jpeg === "string" ? Buffer.from(jpeg, "base64") : jpeg).removeAlpha().toColourspace("srgb").raw().toBuffer({ resolveWithObject: true });
 	return {
 		bytes: data,
 		width: info.width,
@@ -53037,6 +53053,42 @@ function collectPackageZoneIds(rules) {
 	}
 	return ids;
 }
+/**
+* How much the package zone box grows on every side when asking whether motion
+* reached it. Mirrors the D144 dilation of the pipeline's burst trigger
+* (`PACKAGE_ZONE_DILATION` in addon-pipeline, not importable from here): about
+* one adult's width beside a doormat, the place a courier stands.
+*/
+var PACKAGE_ZONE_MOTION_DILATION = .5;
+/**
+* A motion region covering more than this fraction of the frame is a light
+* change or the weather, not a person: it never counts as a deliverer.
+*/
+var PACKAGE_ZONE_MOTION_MAX_REGION_FRAC = .8;
+/**
+* Did analyzer motion reach the dilated package zone with a person-sized
+* region? Unknown geometry answers false: this stamp only ever BACKS the open
+* of a candidate, so failing closed keeps the light-wedge guard intact.
+*/
+function delivererMotionNearPackageZone(input) {
+	const { zoneRect, frameWidth, frameHeight } = input;
+	if (zoneRect === null || frameWidth <= 0 || frameHeight <= 0) return false;
+	const dx = zoneRect.w * PACKAGE_ZONE_MOTION_DILATION;
+	const dy = zoneRect.h * PACKAGE_ZONE_MOTION_DILATION;
+	const left = Math.max(0, zoneRect.x - dx);
+	const top = Math.max(0, zoneRect.y - dy);
+	const right = Math.min(1, zoneRect.x + zoneRect.w + dx);
+	const bottom = Math.min(1, zoneRect.y + zoneRect.h + dy);
+	for (const region of input.regions) {
+		const x = region.bbox.x / frameWidth;
+		const y = region.bbox.y / frameHeight;
+		const w = region.bbox.w / frameWidth;
+		const h = region.bbox.h / frameHeight;
+		if (w * h > PACKAGE_ZONE_MOTION_MAX_REGION_FRAC) continue;
+		if (x < right && left < x + w && y < bottom && top < y + h) return true;
+	}
+	return false;
+}
 //#endregion
 //#region src/pipeline-analytics/pipeline/package/package-collector-mirror.ts
 /**
@@ -53982,6 +54034,15 @@ var PACKAGE_STILLNESS_TTL_MS = 5 * 6e4;
 */
 var PACKAGE_STILLNESS_ASSOC_IOU = .3;
 /**
+* Lowest score of a below-threshold box that may CONTINUE an open candidate
+* (D665: a box under the floor may continue, never open). Observed on a real
+* parcel after the day to IR flip: 0.35 to 0.50.
+*/
+var PACKAGE_STILLNESS_CONTINUATION_MIN_SCORE = .3;
+/** Above-floor sightings a candidate needs before a sub-floor box may count:
+*  one confident look plus a doormat-shaped reading is not a parcel. */
+var PACKAGE_CONTINUATION_MIN_REAL_HITS = 2;
+/**
 * Two absence reads closer than this are ONE look, not two. A settle burst
 * runs the package step 5 s apart and a poll 45 s apart, so a real second
 * look is always further away; two frames of one moment (a re-dispatch, a
@@ -54031,6 +54092,7 @@ var PackageStillnessTracker = class {
 		const next = [...this.byDevice.get(input.deviceId) ?? []];
 		const consumed = /* @__PURE__ */ new Set();
 		const promoted = [];
+		const continuedLog = [];
 		for (const s of input.sightings) {
 			const index = this.bestMatch(next, s, consumed);
 			if (index < 0) {
@@ -54043,17 +54105,33 @@ var PackageStillnessTracker = class {
 			if (prev === void 0) continue;
 			consumed.add(prev.id);
 			const updated = confirm(prev, input, s);
-			const minHits = input.minHits ?? this.config.minHits;
-			if (!(updated.promotedAt === null && updated.activityBackedAtOpen && updated.hits >= minHits && input.timestamp - updated.firstSeenAt >= input.minDwellMs)) {
-				next[index] = updated;
-				continue;
-			}
-			const parked = {
-				...updated,
-				promotedAt: input.timestamp
+			const parked = this.promoteWhenReady(updated, input);
+			next[index] = parked ?? updated;
+			if (parked !== null) promoted.push(toEntry(parked));
+		}
+		if (input.looked === true && input.continuationBoxes !== void 0) for (let i = 0; i < next.length; i += 1) {
+			const c = next[i];
+			if (c === void 0 || c.promotedAt !== null || consumed.has(c.id)) continue;
+			if (c.realHits < PACKAGE_CONTINUATION_MIN_REAL_HITS) continue;
+			const box = this.continuationFor(c, input.continuationBoxes);
+			if (box === null) continue;
+			consumed.add(c.id);
+			const continued = {
+				...c,
+				lastSeenAt: input.timestamp,
+				hits: c.hits + 1,
+				absenceReads: [],
+				lastLook: "present",
+				earlyUnbackedReported: false
 			};
-			next[index] = parked;
-			promoted.push(toEntry(parked));
+			continuedLog.push({
+				id: c.id,
+				hits: continued.hits,
+				score: box.score
+			});
+			const parked = this.promoteWhenReady(continued, input);
+			next[i] = parked ?? continued;
+			if (parked !== null) promoted.push(toEntry(parked));
 		}
 		const present = input.rawPackageBoxes !== void 0 ? withRawPresence(next, consumed, input.rawPackageBoxes, input.timestamp, this.config.assocIou) : next;
 		const looked = input.looked === true && input.rawPackageBoxes !== void 0 ? withLook(present, consumed, input, input.rawPackageBoxes, this.config.assocIou) : present;
@@ -54089,7 +54167,8 @@ var PackageStillnessTracker = class {
 				...input.lastActivityAt !== void 0 ? { lastActivityAt: input.lastActivityAt } : {}
 			}),
 			earlyDepartureIds: [...early],
-			earlyEvidenceUnbacked: unbacked
+			earlyEvidenceUnbacked: unbacked,
+			continued: continuedLog
 		};
 	}
 	/** Why complete early evidence may NOT conclude, or null when it may. */
@@ -54116,7 +54195,8 @@ var PackageStillnessTracker = class {
 				...input.lastActivityAt !== void 0 ? { lastActivityAt: input.lastActivityAt } : {}
 			}),
 			earlyDepartureIds: [],
-			earlyEvidenceUnbacked: []
+			earlyEvidenceUnbacked: [],
+			continued: []
 		};
 	}
 	/** The devices holding a candidate — what a sweep has to visit. */
@@ -54180,6 +54260,43 @@ var PackageStillnessTracker = class {
 	/** Best same-class candidate over the association floor, ignoring any already
 	*  consumed by an earlier sighting in THIS frame (two boxes never collapse
 	*  into one parcel). */
+	continuationFor(c, boxes) {
+		let best = null;
+		let bestIou = this.config.assocIou;
+		for (const b of boxes) {
+			if (b.score < PACKAGE_STILLNESS_CONTINUATION_MIN_SCORE) continue;
+			const overlap = iou$2(c.bbox, b.bbox);
+			if (overlap >= bestIou) {
+				bestIou = overlap;
+				best = b;
+			}
+		}
+		return best;
+	}
+	promoteWhenReady(candidate, input) {
+		const updated = this.backedLate(candidate, input);
+		const minHits = input.minHits ?? this.config.minHits;
+		return updated.promotedAt === null && updated.activityBackedAtOpen && updated.hits >= minHits && input.timestamp - updated.firstSeenAt >= input.minDwellMs ? {
+			...updated,
+			promotedAt: input.timestamp
+		} : null;
+	}
+	/**
+	* Zone motion learned AFTER the open still backs the candidate when its stamp
+	* lies in the window around the FIRST sighting (the same slack a pick-up
+	* gets): the backing stays anchored at the open, a later passer-by never
+	* validates scenery (D1003).
+	*/
+	backedLate(c, input) {
+		if (c.activityBackedAtOpen || c.promotedAt !== null) return c;
+		const at = input.lastDelivererMotionAt;
+		const windowMs = input.activityWindowMs ?? 0;
+		if (at === void 0 || windowMs <= 0) return c;
+		return at >= c.firstSeenAt - windowMs && at <= c.firstSeenAt + this.config.roundGapMs ? {
+			...c,
+			activityBackedAtOpen: true
+		} : c;
+	}
 	bestMatch(candidates, s, consumed) {
 		let bestIndex = -1;
 		let bestIou = this.config.assocIou;
@@ -54196,7 +54313,7 @@ var PackageStillnessTracker = class {
 	}
 	openCandidate(input, s) {
 		const windowMs = input.activityWindowMs ?? 0;
-		const activityBackedAtOpen = windowMs <= 0 || input.lastActivityAt !== void 0 && input.timestamp - input.lastActivityAt <= windowMs;
+		const activityBackedAtOpen = windowMs <= 0 || input.lastActivityAt !== void 0 && input.timestamp - input.lastActivityAt <= windowMs || input.lastDelivererMotionAt !== void 0 && input.timestamp - input.lastDelivererMotionAt <= windowMs;
 		return {
 			id: this.newId(),
 			deviceId: input.deviceId,
@@ -54207,6 +54324,7 @@ var PackageStillnessTracker = class {
 			firstSeenAt: input.timestamp,
 			lastSeenAt: input.timestamp,
 			hits: 1,
+			realHits: 1,
 			promotedAt: null,
 			absenceReads: [],
 			lastLook: null,
@@ -54229,6 +54347,7 @@ function confirm(prev, input, s) {
 		frameHeight: input.frameHeight,
 		lastSeenAt: input.timestamp,
 		hits: prev.hits + 1,
+		realHits: prev.realHits + 1,
 		absenceReads: [],
 		lastLook: "present",
 		earlyUnbackedReported: false,
@@ -54765,6 +54884,9 @@ var FrameState = class {
 	* which would let the streetlight wedge vouch for its own delivery.
 	*/
 	lastNonPackageActivityAt = /* @__PURE__ */ new Map();
+	/** Last analyzer motion near a package drop-off zone, per device (D1003).
+	*  Backs the OPEN of a candidate only; never a pick-up witness. */
+	lastPackageZoneMotionAt = /* @__PURE__ */ new Map();
 	/**
 	* WHO was in the drop-off zone, and when (D404). The pick-up is CONCLUDED
 	* minutes after the fact, so the collector must be remembered while it is
@@ -58124,6 +58246,7 @@ function nextPackageLookDropEpisodes(previous, drops) {
 //#region src/pipeline-analytics/pipeline/package/package-look-evidence.ts
 function packageLookEvidence(input) {
 	const raw = [];
+	const continuation = [];
 	for (const d of input.frame.detections) {
 		if (d.kind !== "first-level" || !input.packageClasses.has(d.macroClass)) continue;
 		raw.push({
@@ -58136,11 +58259,16 @@ function packageLookEvidence(input) {
 	for (const d of input.frame.discarded ?? []) {
 		if (!input.packageClasses.has(d.macroClass)) continue;
 		const [x1, y1, x2, y2] = d.bbox;
-		raw.push({
+		const box = {
 			x: x1,
 			y: y1,
 			w: x2 - x1,
 			h: y2 - y1
+		};
+		raw.push(box);
+		if (d.reason === "below-threshold") continuation.push({
+			bbox: box,
+			score: d.score
 		});
 	}
 	return {
@@ -58152,6 +58280,7 @@ function packageLookEvidence(input) {
 			h: t.bbox.h
 		})),
 		rawPackageBoxes: raw,
+		continuationBoxes: continuation,
 		earlyPickup: input.earlyPickupEnabled
 	};
 }
@@ -58339,6 +58468,13 @@ function clamp01(value) {
 }
 //#endregion
 //#region src/pipeline-analytics/pipeline/package/package-scene-diff.ts
+/**
+* Zone-crop scene difference for a packages rule (D931).
+*
+* A uniform brightness shift is removed by subtracting the median luma delta,
+* so a shadow that lifts the whole crop leaves no blob. What remains is a
+* connected region. The package model is not consulted here.
+*/
 /** Residual, after the median shift, that counts as a changed pixel. */
 var PACKAGE_SCENE_DIFF_LUMA_THRESHOLD = 28;
 /** A changed region this large, relative to the zone, is the zone itself. */
@@ -58353,12 +58489,26 @@ var PACKAGE_SCENE_DIFF_SETTLE_MS = 3e3;
 var PACKAGE_SCENE_DIFF_LOOK_GAP_MS = 2e3;
 /** Confidence stamped on a scene-diff sighting the model did not box. */
 var PACKAGE_SCENE_DIFF_CONFIDENCE = .5;
+/** True when the crop was shot in infrared (no colour). */
+function isIrCrop(crop) {
+	return crop.chromaSpread < IR_CHROMA_THRESHOLD;
+}
 function diffZoneLuma(input) {
 	const { before, after } = input;
 	if (before.width !== after.width || before.height !== after.height || before.luma.length !== after.luma.length) return {
 		blobs: [],
 		rejections: [{ reason: "crop-mismatch" }]
 	};
+	if (isIrCrop(before) !== isIrCrop(after)) return {
+		blobs: [],
+		rejections: [{
+			reason: "lighting-mode-changed",
+			chroma: {
+				before: before.chromaSpread,
+				after: after.chromaSpread
+			}
+		}]
+	};
 	const median = medianDelta(before.luma, after.luma);
 	const mask = residualMask(before.luma, after.luma, median);
 	const zonePx = before.width * before.height;
@@ -58573,6 +58723,7 @@ function okCrop(rgb, width, height, jpeg) {
 		width,
 		height,
 		luma: lumaFromRgb(rgb, width, height),
+		chromaSpread: chromaSpreadFromRgb(rgb, width, height),
 		jpeg: new Uint8Array(jpeg)
 	};
 }
@@ -58589,6 +58740,46 @@ function lumaFromRgb(bytes, width, height) {
 	}
 	return luma;
 }
+/** The grid `IR_CHROMA_THRESHOLD` was calibrated on (`chromaSpread`, scene-crop.ts). */
+var CHROMA_GRID = 32;
+/**
+* Mean of max(r,g,b) - min(r,g,b), 0..255, measured on a 32x32 box-averaged
+* copy of the crop: the same measure and grid as `chromaSpread` in
+* `scene-crop.ts` (which needs sharp), so `IR_CHROMA_THRESHOLD` means the same
+* thing. Averaging first matters: sensor noise and JPEG chroma speckle on an IR
+* frame cancel out, where per-pixel they read as colour.
+*/
+function chromaSpreadFromRgb(bytes, width, height) {
+	if (width <= 0 || height <= 0 || bytes.length < width * height * 3) return 0;
+	const gw = Math.min(CHROMA_GRID, width);
+	const gh = Math.min(CHROMA_GRID, height);
+	const sum = new Float64Array(gw * gh * 3);
+	const count = new Float64Array(gw * gh);
+	for (let y = 0; y < height; y++) {
+		const cy = Math.min(gh - 1, Math.floor(y * gh / height));
+		for (let x = 0; x < width; x++) {
+			const cx = Math.min(gw - 1, Math.floor(x * gw / width));
+			const cell = cy * gw + cx;
+			const o = (y * width + x) * 3;
+			sum[cell * 3] = (sum[cell * 3] ?? 0) + (bytes[o] ?? 0);
+			sum[cell * 3 + 1] = (sum[cell * 3 + 1] ?? 0) + (bytes[o + 1] ?? 0);
+			sum[cell * 3 + 2] = (sum[cell * 3 + 2] ?? 0) + (bytes[o + 2] ?? 0);
+			count[cell] = (count[cell] ?? 0) + 1;
+		}
+	}
+	let total = 0;
+	let cells = 0;
+	for (let cell = 0; cell < gw * gh; cell++) {
+		const n = count[cell] ?? 0;
+		if (n === 0) continue;
+		const r = (sum[cell * 3] ?? 0) / n;
+		const g = (sum[cell * 3 + 1] ?? 0) / n;
+		const b = (sum[cell * 3 + 2] ?? 0) / n;
+		total += Math.max(r, g, b) - Math.min(r, g, b);
+		cells += 1;
+	}
+	return cells === 0 ? 0 : total / cells;
+}
 //#endregion
 //#region src/pipeline-analytics/pipeline/package/package-scene-step.ts
 /**
@@ -58688,6 +58879,14 @@ function compareAfterLeave(prev, input) {
 		minAreaFrac: input.minAreaFrac,
 		occluders: input.occluders
 	});
+	if (diff.rejections.some((r) => r.reason === "lighting-mode-changed")) return {
+		state: {
+			...rememberClear(prev, input).state,
+			lastDiffAt: input.timestamp
+		},
+		sightings: [],
+		rejections: diff.rejections
+	};
 	const blocked = diff.rejections.some((r) => r.reason === "overlaps-person" || r.reason === "overlaps-vehicle");
 	if (diff.blobs.length === 0) {
 		if (blocked) return {
@@ -58731,6 +58930,20 @@ function confirmPending(prev, input) {
 		sightings: [],
 		rejections: []
 	};
+	if (isIrCrop(prev.after) !== isIrCrop(input.crop)) return {
+		state: {
+			...rememberClear(prev, input).state,
+			lastDiffAt: input.timestamp
+		},
+		sightings: [],
+		rejections: [{
+			reason: "lighting-mode-changed",
+			chroma: {
+				before: prev.after.chromaSpread,
+				after: input.crop.chromaSpread
+			}
+		}]
+	};
 	const sightings = [];
 	const rejections = [];
 	const still = [];
@@ -58777,7 +58990,7 @@ function judgeBlob(prev, input, blob) {
 		bbox: blob.bbox
 	} };
 	const stable = meanAbsInBox(after, crop, blob.bbox) <= PACKAGE_SCENE_DIFF_STABLE_MEAN;
-	const present = meanAbsInBox(before, crop, blob.bbox) >= PACKAGE_SCENE_DIFF_LUMA_THRESHOLD;
+	const present = isIrCrop(before) !== isIrCrop(crop) || meanAbsInBox(before, crop, blob.bbox) >= PACKAGE_SCENE_DIFF_LUMA_THRESHOLD;
 	if (!stable || !present) return { rejection: {
 		reason: "unstable",
 		bbox: blob.bbox,
@@ -58945,7 +59158,8 @@ var PackageSceneCoordinator = class {
 		const crop = {
 			width: fetched.width,
 			height: fetched.height,
-			luma: fetched.luma
+			luma: fetched.luma,
+			chromaSpread: fetched.chromaSpread
 		};
 		const stepped = stepPackageScene({
 			deviceId,
@@ -59011,6 +59225,10 @@ var PackageSceneCoordinator = class {
 				tags: { deviceId },
 				meta: {
 					reason: rejection.reason,
+					...rejection.chroma !== void 0 ? {
+						chromaBefore: Number(rejection.chroma.before.toFixed(2)),
+						chromaAfter: Number(rejection.chroma.after.toFixed(2))
+					} : {},
 					...rejection.areaFrac !== void 0 ? { areaFrac: Number(rejection.areaFrac.toFixed(5)) } : {}
 				}
 			});
@@ -59119,14 +59337,8 @@ function planPackageSceneFrame(deviceId, input) {
 		frameWidth: input.frameWidth,
 		frameHeight: input.frameHeight
 	});
-	const sceneRect = sceneZones.size === 0 ? null : packageZoneCropRect({
-		zones: input.zones,
-		packageZoneIds: sceneZones,
-		frameWidth: input.frameWidth,
-		frameHeight: input.frameHeight
-	});
 	return {
-		sightings: sceneRect === null ? input.sightings : withoutSceneCenters(input, sceneRect),
+		sightings: input.sightings,
 		note: {
 			deviceId,
 			timestamp: input.timestamp,
@@ -59169,15 +59381,6 @@ function occludersOf(tracked) {
 	}
 	return out;
 }
-function withoutSceneCenters(input, rect) {
-	if (input.frameWidth <= 0 || input.frameHeight <= 0) return input.sightings;
-	return input.sightings.filter((sighting) => !centerInside(sighting.bbox, rect, input));
-}
-function centerInside(bbox, rect, input) {
-	const cx = (bbox.x + bbox.w / 2) / input.frameWidth;
-	const cy = (bbox.y + bbox.h / 2) / input.frameHeight;
-	return cx >= rect.x && cx < rect.x + rect.w && cy >= rect.y && cy < rect.y + rect.h;
-}
 //#endregion
 //#region src/pipeline-analytics/pipeline/package/package-llm-confirm.ts
 /**
@@ -59338,56 +59541,143 @@ function sweepOne(deps, deviceId) {
 }
 //#endregion
 //#region src/pipeline-analytics/pipeline/package/package-still-capture.ts
-/** A held look frame older than this is not the parcel's picture any more. */
-var PACKAGE_LOOK_FRAME_MAX_AGE_MS = 15e3;
+/**
+* The runner's native lease on a look frame (holdFrames 8) is released about
+* 100 ms after inference, so a handle older than this answers `native-miss` or
+* `preview-only` — promotion runs seconds to minutes after the look (D60).
+*/
+var PACKAGE_NATIVE_HANDLE_MAX_AGE_MS = 1e3;
+/** Total time a promotion may spend landing its still before it ships without (D60). */
+var PACKAGE_STILL_BOUND_MS = 6e3;
+/** One live-source attempt never takes longer than this (a sleeping camera). */
+var PACKAGE_STILL_ATTEMPT_TIMEOUT_MS = 3e3;
+/** Pause between two live attempts. */
+var PACKAGE_STILL_RETRY_PAUSE_MS = 750;
+var PACKAGE_STILL_LIVE_ATTEMPTS = 3;
+var realPause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function jpegOf(reply) {
 	if (reply.tier === "ram-fullframe") return "preview-only";
 	if (reply.jpegBytes !== void 0 && reply.jpegBytes.byteLength > 0) return reply.jpegBytes;
 	if (reply.bytes !== void 0 && reply.bytes.length === reply.width * reply.height * 3) return encodeRgbCropToJpeg(reply.bytes, reply.width, reply.height);
 	return "empty-frame";
 }
+/** One live read, cut off after `limitMs` so a hung camera cannot hold the delivery. */
+async function readLive(source, limitMs) {
+	let timer;
+	const timeout = new Promise((resolve) => {
+		timer = setTimeout(() => resolve(null), limitMs);
+	});
+	try {
+		return await Promise.race([source(), timeout]);
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+	}
+}
+/** Retry the live source under {@link PACKAGE_STILL_BOUND_MS} until a frame lands (D60). */
+async function liveStill(input, source) {
+	const now = input.now ?? Date.now;
+	const pause = input.pause ?? realPause;
+	const deadline = now() + PACKAGE_STILL_BOUND_MS;
+	let reason = "live-unavailable";
+	let attempts = 0;
+	while (attempts < PACKAGE_STILL_LIVE_ATTEMPTS) {
+		const remaining = deadline - now();
+		if (remaining <= 0) return {
+			jpeg: null,
+			reason: "bound-exhausted",
+			attempts
+		};
+		attempts += 1;
+		try {
+			const jpeg = await readLive(source, Math.min(PACKAGE_STILL_ATTEMPT_TIMEOUT_MS, remaining));
+			if (jpeg !== null && jpeg.byteLength > 0) return {
+				jpeg,
+				reason,
+				attempts
+			};
+			reason = jpeg === null ? "live-unavailable" : "empty-frame";
+		} catch {
+			reason = "live-unavailable";
+		}
+		if (attempts < PACKAGE_STILL_LIVE_ATTEMPTS) await pause(PACKAGE_STILL_RETRY_PAUSE_MS);
+	}
+	return {
+		jpeg: null,
+		reason,
+		attempts
+	};
+}
 /**
 * The entry carrying its still's `keyFrameMediaId`, or the entry unchanged when
 * it already had one or none could be stored (said, with the reason).
+*
+* Ladder: the native handle while its lease can still be alive, then a frame
+* that exists now (retried under a bound). Every landed still is logged next to
+* every miss (D400).
 */
 async function withParcelStill(input) {
 	const { entry, logger } = input;
 	if (entry.keyFrameMediaId !== void 0) return entry;
-	const miss = (reason, detail) => {
+	const tags = { deviceId: entry.deviceId };
+	const miss = (reason, extra = {}) => {
 		logger.warn("package still NOT stored — the delivery ships without a picture of the parcel", {
-			tags: { deviceId: entry.deviceId },
+			tags,
 			meta: {
 				entryId: entry.id,
 				reason,
-				...detail !== void 0 ? { error: detail } : {}
+				...extra
 			}
 		});
 		return entry;
 	};
-	if (input.handle === null) return miss("no-frame-handle");
 	if (input.writer === null) return miss("no-media-store");
+	const now = input.now ?? Date.now;
+	let jpeg = null;
+	let source = "native";
+	let stamp = input.timestamp;
+	let nativeMiss = "no-frame-handle";
+	let liveReason = null;
+	let attempts = 0;
 	try {
-		const reply = await input.query({
-			handle: input.handle,
-			bbox: {
-				x: 0,
-				y: 0,
-				w: entry.frameWidth,
-				h: entry.frameHeight
-			},
-			acceptJpegBytes: true,
-			encodeJpeg: true,
-			pin: require_clip_model_registry.nodePin(input.handle.nodeId)
+		if (input.handle !== null) {
+			const reply = await input.query({
+				handle: input.handle,
+				bbox: {
+					x: 0,
+					y: 0,
+					w: entry.frameWidth,
+					h: entry.frameHeight
+				},
+				acceptJpegBytes: true,
+				encodeJpeg: true,
+				pin: require_clip_model_registry.nodePin(input.handle.nodeId)
+			});
+			if (reply === null) nativeMiss = "native-miss";
+			else {
+				const out = await jpegOf(reply);
+				if (typeof out === "string") nativeMiss = out;
+				else jpeg = out;
+			}
+		}
+		if (jpeg === null && input.live !== null) {
+			const live = await liveStill(input, input.live);
+			attempts = live.attempts;
+			if (live.jpeg !== null) {
+				jpeg = live.jpeg;
+				source = "live";
+				stamp = now();
+			} else liveReason = live.reason;
+		}
+		if (jpeg === null) return miss(liveReason ?? nativeMiss, {
+			...input.handle !== null ? { nativeMiss } : {},
+			...liveReason !== null ? { liveAttempts: attempts } : {}
 		});
-		if (reply === null) return miss("native-miss");
-		const jpeg = await jpegOf(reply);
-		if (typeof jpeg === "string") return miss(jpeg);
 		const keyFrameMediaId = await input.writer.putReplacing({
 			deviceId: entry.deviceId,
 			ownerKind: "track",
 			ownerId: entry.id,
 			kind: "keyFrame",
-			timestamp: input.timestamp,
+			timestamp: stamp,
 			data: Buffer.from(jpeg),
 			subjectBox: {
 				x: entry.bbox.x,
@@ -59398,12 +59688,20 @@ async function withParcelStill(input) {
 				frameHeight: entry.frameHeight
 			}
 		});
+		logger.info("package still stored", {
+			tags,
+			meta: {
+				entryId: entry.id,
+				mediaId: keyFrameMediaId,
+				source
+			}
+		});
 		return {
 			...entry,
 			keyFrameMediaId
 		};
 	} catch (err) {
-		return miss("write-failed", require_clip_model_registry.errMsg(err));
+		return miss("write-failed", { error: require_clip_model_registry.errMsg(err) });
 	}
 }
 /**
@@ -71062,6 +71360,7 @@ Object.freeze({
 	"addon-pages-source": ["listPages"],
 	"addon-routes": ["getRoutes"],
 	"addon-widgets-source": ["listWidgets"],
+	"board-key-source": ["listSources"],
 	"broker": ["list", "listProviders"],
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
@@ -72590,7 +72889,7 @@ function buildGlobalSettingsSchema(cap) {
 					type: "slider",
 					key: "packageDropActivityWindowSec",
 					label: "Deliverer window",
-					description: "A delivery only counts if a person or vehicle was in the configured package drop-off zone within this many seconds before the package appeared — and a pick-up only with somebody in that zone when it vanished. Motion elsewhere on the camera does not count. 0 disables the requirement.",
+					description: "A delivery only counts if a person or vehicle was in the configured package drop-off zone within this many seconds before the package appeared — and a pick-up only with somebody in that zone when it vanished. Person-sized motion beside the drop-off zone also counts when nobody was tracked. Motion elsewhere on the camera does not count. 0 disables the requirement.",
 					min: 0,
 					max: 1800,
 					step: 30,
@@ -87110,6 +87409,13 @@ var NC_STILL_WAIT_MAX_AGE_MS = 3e4;
 function canStillGainMedia(entry) {
 	return entry.recordKind === "object-event";
 }
+/** The variables that carry a finished cycle's run summary. */
+var CYCLE_SUMMARY_VARS = [
+	"duration",
+	"energy",
+	"afterDuration",
+	"usedEnergy"
+];
 var NcDispatcher = class {
 	deps;
 	targetCache = null;
@@ -88013,6 +88319,7 @@ var NcDispatcher = class {
 	}
 	/** Rules already warned about a deprecated variable in this process — once each. */
 	deprecatedVarWarned = /* @__PURE__ */ new Set();
+	cycleSummaryWarned = /* @__PURE__ */ new Set();
 	/**
 	* A rule template written by an older client may still say `{{camera}}`. It
 	* renders (the alias), and the rule is named once so the operator can edit it.
@@ -88032,6 +88339,27 @@ var NcDispatcher = class {
 		});
 	}
 	/**
+	* A FINISHED-cycle row whose own template places none of the four cycle
+	* variables delivers no run summary (D391: accepted, produced less). Said
+	* once per rule; the operator's text is never touched.
+	*/
+	warnCycleSummaryDropped(entry) {
+		const deviceId = entry.payload.subject.applianceCycle?.deviceId;
+		const template = entry.payload.template;
+		if (deviceId === void 0 || template === void 0) return;
+		if (this.cycleSummaryWarned.has(entry.ruleId)) return;
+		const used = new Set([...templatePlaceholders(template.title ?? ""), ...templatePlaceholders(template.body ?? "")]);
+		if (CYCLE_SUMMARY_VARS.some((name) => used.has(name))) return;
+		this.cycleSummaryWarned.add(entry.ruleId);
+		this.deps.logger.warn("appliance cycle finished but the rule template places no run summary — the message carries no duration or energy", {
+			tags: {
+				deviceId,
+				ruleId: entry.ruleId
+			},
+			meta: { placeholders: [...CYCLE_SUMMARY_VARS] }
+		});
+	}
+	/**
 	* The facts of a finished appliance cycle; unknown on every other row and on
 	* any failure (a part that cannot be read is omitted, never a blocked send).
 	*/
@@ -88076,6 +88404,7 @@ var NcDispatcher = class {
 		const cycleFacts = await this.applianceCycleFacts(entry);
 		const vars = buildTemplateVars(this.texts, entry, deviceName, zoneLabels, void 0, cycleFacts);
 		this.warnDeprecatedVars(entry);
+		this.warnCycleSummaryDropped(entry);
 		const systemCount = systemEvent?.textCount !== void 0 ? { count: systemEvent.textCount } : {};
 		const title = renderRowTitle(this.texts, entry, vars);
 		const authoredBody = entry.payload.template?.body;
@@ -102058,7 +102387,10 @@ function buildProvider(host) {
 			catalog: [...require_clip_model_registry.NC_CONDITION_CATALOG],
 			taxonomy: require_clip_model_registry.NC_TAXONOMY
 		}),
-		getTemplateCatalog: async () => ({ vars: require_clip_model_registry.servedTemplateVars() }),
+		getTemplateCatalog: async () => ({
+			vars: require_clip_model_registry.servedTemplateVars(),
+			defaults: servedTemplateDefaults(host.texts)
+		}),
 		previewTemplate: async (input) => previewTemplate(host.texts, input),
 		getHistory: async ({ filter }) => {
 			const entries = await host.outbox.queryHistory({
@@ -124995,6 +125327,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			this.packageDropDetector?.forgetDevice(data.deviceId);
 			this.packageScene?.forget(data.deviceId);
 			this.frameState.lastNonPackageActivityAt.delete(data.deviceId);
+			this.frameState.lastPackageZoneMotionAt.delete(data.deviceId);
 			this.frameState.packageCollectors.forgetDevice(data.deviceId);
 			this.frameState.packageOversizeLogAt.delete(data.deviceId);
 			this.frameState.packageLookFrames.delete(data.deviceId);
@@ -125019,6 +125352,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.packageDropDetector?.forgetDevice(deviceId);
 		this.packageScene?.forget(deviceId);
 		this.frameState.lastNonPackageActivityAt.delete(deviceId);
+		this.frameState.lastPackageZoneMotionAt.delete(deviceId);
 		this.frameState.packageCollectors.forgetDevice(deviceId);
 		this.frameState.packageOversizeLogAt.delete(deviceId);
 		this.frameState.packageLookFrames.delete(deviceId);
@@ -127591,6 +127925,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			detected,
 			atMs: timestamp
 		});
+		if (detected) await this.stampPackageZoneMotion(deviceId, payload, timestamp);
 		if (detected) this.eventStore?.noteMotionSample(deviceId, payload.regionCount, timestamp);
 		await this.motionEpisodes?.observe(deviceId, "analyzer", detected, timestamp, {
 			regionCount: payload.regionCount,
@@ -127609,6 +127944,28 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		});
 	}
 	/**
+	* Stamp analyzer motion that reached a package drop-off zone (D1003): the
+	* courier who never became an L1 track still backs the OPEN of a candidate.
+	* Onboard motion carries no regions or dimensions and never stamps.
+	*/
+	async stampPackageZoneMotion(deviceId, payload, timestamp) {
+		const proxy = await this.ensureProxy(deviceId);
+		const packageZoneIds = collectPackageZoneIds(proxy?.state.zoneRules.value?.package ?? []);
+		if (packageZoneIds.size === 0) return;
+		const zoneRect = packageZoneCropRect({
+			zones: proxy?.state.zones.value?.zones ?? [],
+			packageZoneIds,
+			frameWidth: payload.frameWidth,
+			frameHeight: payload.frameHeight
+		});
+		if (delivererMotionNearPackageZone({
+			regions: payload.regions,
+			frameWidth: payload.frameWidth,
+			frameHeight: payload.frameHeight,
+			zoneRect
+		})) this.frameState.lastPackageZoneMotionAt.set(deviceId, timestamp);
+	}
+	/**
 	* Persist firmware-driven (onboard / device-activity) motion events into
 	* the SAME episode tracker as {@link handleMotionAnalysis}, keyed per
 	* `(deviceId, source)` so the two paths can never share — or fight over —
@@ -127941,6 +128298,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			encodeJpeg: request.encodeJpeg
 		}, request.pin);
 	}
+	zoneMotionStamp(deviceId) {
+		const at = this.frameState.lastPackageZoneMotionAt.get(deviceId);
+		return at === void 0 ? {} : { lastDelivererMotionAt: at };
+	}
 	deliverPackageSceneSightings(delivery) {
 		const settings = this.packageDropSettingsFromCache(delivery.deviceId);
 		const lastActivityAt = this.frameState.lastNonPackageActivityAt.get(delivery.deviceId);
@@ -127954,6 +128315,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			minDwellMs: settings.packageDropDwellSec * 1e3,
 			activityWindowMs: settings.packageDropActivityWindowSec * 1e3,
 			...lastActivityAt !== void 0 ? { lastActivityAt } : {},
+			...this.zoneMotionStamp(delivery.deviceId),
 			looked: false
 		});
 		this.bridgePackageStillness({
@@ -128139,6 +128501,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			minDwellMs: input.settings.packageDropDwellSec * 1e3,
 			activityWindowMs: input.settings.packageDropActivityWindowSec * 1e3,
 			...lastActivityAt !== void 0 ? { lastActivityAt } : {},
+			...this.zoneMotionStamp(input.deviceId),
 			...lookEvidence
 		});
 		this.bridgePackageStillness({
@@ -128244,11 +128607,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			const lookFrame = this.frameState.packageLookFrames.get(input.deviceId);
 			promoteWithStill({
 				entry,
-				handle: lookFrame !== void 0 && input.timestamp - lookFrame.at <= PACKAGE_LOOK_FRAME_MAX_AGE_MS ? lookFrame.handle : null,
+				handle: lookFrame !== void 0 && input.timestamp - lookFrame.at <= PACKAGE_NATIVE_HANDLE_MAX_AGE_MS ? lookFrame.handle : null,
 				timestamp: lookFrame?.at ?? input.timestamp,
 				query: (request) => this.queryPackageSceneCrop(request),
 				writer: this.mediaStore,
 				logger: this.ctx.logger,
+				live: async () => {
+					const snap = await this.ctx.api.snapshot.getSnapshot.query({ deviceId: input.deviceId });
+					return snap === null ? null : Uint8Array.from(Buffer.from(snap.base64, "base64"));
+				},
 				detector: this.packageDropDetector
 			}).catch((err) => {
 				this.ctx.logger.warn("package promotion failed", {
@@ -128330,6 +128697,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				});
 			}).catch(() => void 0);
 		}
+		for (const c of outcome.continued) this.ctx.logger.info("package candidate continued by a sub-floor box", {
+			tags,
+			meta: {
+				entryId: c.id,
+				hits: c.hits,
+				score: c.score,
+				via: input.via
+			}
+		});
 		for (const u of outcome.earlyEvidenceUnbacked) this.ctx.logger.info("early pick-up evidence complete — nobody around, left to the TTL", {
 			tags,
 			meta: {
@@ -128357,6 +128733,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 					observedDwellMs,
 					requiredDwellMs,
 					activityBackedAtOpen: ex.activityBackedAtOpen,
+					lastZoneMotionAt: this.frameState.lastPackageZoneMotionAt.get(input.deviceId) ?? null,
 					reasons
 				}
 			});