@camstack/types 1.2.69 → 1.2.70

package/dist/capabilities/notification-rules.cap.d.ts

@@ -951,6 +951,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
         }>>;
         maxImagePx: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type NcRuleInput = z.infer<typeof NcRuleInputSchema>;
 /**
@@ -1056,6 +1057,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
         }>>;
         maxImagePx: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>>;
+    waitForEnhancement: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
     disabledTargetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     conditions: z.ZodOptional<z.ZodObject<{
@@ -1426,6 +1428,7 @@ export declare const NcRuleSchema: z.ZodObject<{
         }>>;
         maxImagePx: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
     id: z.ZodString;
     createdBy: z.ZodString;
     createdAt: z.ZodNumber;
@@ -2083,6 +2086,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
                 id: z.ZodString;
                 createdBy: z.ZodString;
                 createdAt: z.ZodNumber;
@@ -2323,6 +2327,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
                 id: z.ZodString;
                 createdBy: z.ZodString;
                 createdAt: z.ZodNumber;
@@ -2561,6 +2566,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             rule: z.ZodObject<{
@@ -2793,6 +2799,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
                 id: z.ZodString;
                 createdBy: z.ZodString;
                 createdAt: z.ZodNumber;
@@ -2898,6 +2905,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>>;
+                waitForEnhancement: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
                 disabledTargetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 enabled: z.ZodOptional<z.ZodBoolean>;
                 conditions: z.ZodOptional<z.ZodObject<{
@@ -3267,6 +3275,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
                 id: z.ZodString;
                 createdBy: z.ZodString;
                 createdAt: z.ZodNumber;
@@ -3553,6 +3562,7 @@ export declare const notificationRulesCapability: {
                     }>>;
                     maxImagePx: z.ZodDefault<z.ZodNumber>;
                 }, z.core.$strip>>;
+                waitForEnhancement: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>;
             lookbackMinutes: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -332,6 +332,7 @@ export declare const LabelAttributionSchema: z.ZodObject<{
     stepId: z.ZodString;
     modelId: z.ZodOptional<z.ZodString>;
     decidedAt: z.ZodNumber;
+    identityId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type LabelAttribution = z.infer<typeof LabelAttributionSchema>;
 /** Per-camera slice of a training-export estimate. */
@@ -437,6 +438,7 @@ declare const TrackSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     subLabel: z.ZodOptional<z.ZodString>;
     subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -444,6 +446,7 @@ declare const TrackSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     trackId: z.ZodString;
     deviceId: z.ZodNumber;
@@ -557,6 +560,7 @@ declare const ObjectEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     subLabel: z.ZodOptional<z.ZodString>;
     subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -564,6 +568,7 @@ declare const ObjectEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     kind: z.ZodLiteral<"object">;
     source: z.ZodOptional<z.ZodEnum<{
@@ -1082,6 +1087,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
             stepId: z.ZodString;
             modelId: z.ZodOptional<z.ZodString>;
             decidedAt: z.ZodNumber;
+            identityId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         subLabel: z.ZodOptional<z.ZodString>;
         subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1089,6 +1095,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
             stepId: z.ZodString;
             modelId: z.ZodOptional<z.ZodString>;
             decidedAt: z.ZodNumber;
+            identityId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         trackId: z.ZodString;
         deviceId: z.ZodNumber;
@@ -1114,6 +1121,7 @@ declare const KeyEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     subLabel: z.ZodOptional<z.ZodString>;
     subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1121,6 +1129,7 @@ declare const KeyEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     id: z.ZodString;
     trackId: z.ZodString;
@@ -1183,6 +1192,7 @@ export declare const ScoredObjectEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     subLabel: z.ZodOptional<z.ZodString>;
     subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1190,6 +1200,7 @@ export declare const ScoredObjectEventSchema: z.ZodObject<{
         stepId: z.ZodString;
         modelId: z.ZodOptional<z.ZodString>;
         decidedAt: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     kind: z.ZodLiteral<"object">;
     source: z.ZodOptional<z.ZodEnum<{
@@ -1327,6 +1338,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1334,6 +1346,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
@@ -1419,6 +1432,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1426,6 +1440,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
@@ -1533,6 +1548,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1540,6 +1556,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
@@ -1643,6 +1660,7 @@ export declare const pipelineAnalyticsCapability: {
                     stepId: z.ZodString;
                     modelId: z.ZodOptional<z.ZodString>;
                     decidedAt: z.ZodNumber;
+                    identityId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
                 subLabel: z.ZodOptional<z.ZodString>;
                 subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1650,6 +1668,7 @@ export declare const pipelineAnalyticsCapability: {
                     stepId: z.ZodString;
                     modelId: z.ZodOptional<z.ZodString>;
                     decidedAt: z.ZodNumber;
+                    identityId: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
                 trackId: z.ZodString;
                 deviceId: z.ZodNumber;
@@ -1735,6 +1754,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1742,6 +1762,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             kind: z.ZodLiteral<"object">;
             source: z.ZodOptional<z.ZodEnum<{
@@ -1939,6 +1960,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -1946,6 +1968,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             id: z.ZodString;
             trackId: z.ZodString;
@@ -2868,6 +2891,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             subLabel: z.ZodOptional<z.ZodString>;
             subLabelScore: z.ZodOptional<z.ZodNumber>;
@@ -2875,6 +2899,7 @@ export declare const pipelineAnalyticsCapability: {
                 stepId: z.ZodString;
                 modelId: z.ZodOptional<z.ZodString>;
                 decidedAt: z.ZodNumber;
+                identityId: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             kind: z.ZodLiteral<"object">;
             source: z.ZodOptional<z.ZodEnum<{

package/dist/index.js

@@ -12068,7 +12068,16 @@ var NcScheduleSchema = zod.z.object({
 });
 /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
 var NcPlateMatcherSchema = zod.z.object({
-	values: zod.z.array(zod.z.string().min(1)).min(1),
+	/**
+	* Plate texts (or gallery vehicle names) to match. EMPTY = **any plate the
+	* pipeline could read** — the plate half of "no selection = no narrowing",
+	* and the switch that says this rule is about vehicles that were IDENTIFIED
+	* rather than merely seen. A subject carrying no plate still fails.
+	*
+	* The `.min(1)` this used to carry made that state unauthorable; nothing has
+	* ever persisted an empty list, so widening it cannot change an existing rule.
+	*/
+	values: zod.z.array(zod.z.string().min(1)),
 	/** Max Levenshtein distance after normalization (uppercase alphanumeric). */
 	maxDistance: zod.z.number().int().min(0).max(3).default(1)
 });
@@ -12330,18 +12339,47 @@ var NcConditionsSchema = zod.z.object({
 	*/
 	labelEquals: zod.z.array(zod.z.string().min(1)).optional(),
 	/**
-	* Identity matcher. P1 boundary: matched against the record's collapsed
-	* `label` (the identity display name propagated by the face pipeline) —
-	* identity-ID matching rides in P2 when identity ids reach the record.
+	* KNOWN FACES — the rule's identity scope, and the switch that says the rule
+	* is about recognised people at all.
+	*
+	* Three states, and the empty one is the point:
+	*
+	* | value | meaning |
+	* | --- | --- |
+	* | absent | the rule does not care who it is; an unrecognised person matches |
+	* | `[]` | **only known faces** — any identity in the gallery, nobody in particular |
+	* | a list | only these identities |
+	*
+	* `[]` is the repo-wide "no selection = no narrowing" reading (an absent
+	* `devices` list is every device), applied one level down: the operator has
+	* turned the face scope ON and narrowed it to nothing, which is every known
+	* face. No second field states the same thing — a switch that can disagree
+	* with the list under it is worse than no switch (D62).
+	*
+	* MEMBERS ARE FACE-GALLERY `Identity.id`s (uuid), not display names. A name is
+	* renameable, and a rule authored on "Gianluca" went silently dark the moment
+	* the operator fixed the spelling. The id reaches the record on
+	* `LabelAttribution.identityId`; the name is what the editor shows and what
+	* `{{label}}` renders.
+	*
+	* Rules written before this carry NAMES, and are resolved to ids lazily at
+	* load (`NcRuleStore.load`) against the live gallery — a name nothing answers
+	* for is left as it stands and reported, never dropped. The engine also
+	* accepts a display-name hit as a compatibility leg, so a rule whose
+	* migration could not resolve keeps matching exactly what it matched before.
 	*/
 	identities: zod.z.array(zod.z.string().min(1)).optional(),
-	/** Fuzzy plate matcher against the record's `label` (plate text). */
+	/**
+	* KNOWN PLATES / VEHICLES — the plate mirror of {@link identities}, including
+	* the empty-list reading: `values: []` is "any plate the OCR could read",
+	* a non-empty list is those plates (fuzzily). See {@link NcPlateMatcherSchema}.
+	*/
 	plates: NcPlateMatcherSchema.optional(),
 	/**
-	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics.
-	* Same P1 boundary: matched against the record's collapsed `label` (the
-	* identity display name). A record with NO label passes (nothing to
-	* exclude), unlike the include variant which fails on an absent label.
+	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics, and
+	* the same id members and the same lazy name→id migration. A record with NO
+	* identity passes (nothing to exclude), unlike the include variant which
+	* fails on an unrecognised subject. An EMPTY list excludes nobody.
 	*/
 	identitiesExclude: zod.z.array(zod.z.string().min(1)).optional(),
 	/**
@@ -12734,7 +12772,37 @@ var NcRuleInputSchema = zod.z.object({
 	* a rule that predates the gate must keep delivering byte-for-byte as it
 	* did, and absent is the only way to say that without a migration.
 	*/
-	confirm: NcConfirmSchema.optional()
+	confirm: NcConfirmSchema.optional(),
+	/**
+	* WAIT for face/plate recognition before saying anything.
+	*
+	* A notification's TEXT is frozen at enqueue and its media is re-resolved at
+	* send; the identity is neither. A face is confirmed after `confirmFrames`
+	* agreeing observations — p50 **11.4 s** after the track was first seen,
+	* measured on this hub — and an `immediate` rule enqueues on the first object
+	* event, seconds before that. So "Gianluca è arrivato" is unsayable on the
+	* immediate path, and no amount of media re-resolution fixes a sentence.
+	*
+	* Only two honest answers exist, and this flag picks between them. It has
+	* effect ONLY on a rule that declares a recognition scope
+	* ({@link NcConditions.identities} or {@link NcConditions.plates}) — on any
+	* other rule there is nothing to wait for and the flag is inert.
+	*
+	* | value | what happens |
+	* | --- | --- |
+	* | `true` | the rule stops firing on the object event and fires at TRACK CLOSE instead, once, with the name — later, and complete |
+	* | absent / `false` | it fires at once WITHOUT the name, and if recognition lands before the track closes a SECOND, "…is Gianluca" notification follows (one per track, per rule, per target) |
+	*
+	* `.optional()` and deliberately NOT `.default()`: a Zod default does not run
+	* on the addon cap path, and absent has to keep meaning exactly what every
+	* rule authored before this field meant.
+	*
+	* The cost of `true` is stated here because the editor states it too: a rule
+	* that waits also inherits track-close SEMANTICS — its `zones` condition
+	* tests every zone the track visited and a `crossing` condition can no longer
+	* be satisfied, because a closed track carries no crossing.
+	*/
+	waitForEnhancement: zod.z.boolean().optional()
 });
 /**
 * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -13078,32 +13146,32 @@ var NC_CONDITION_CATALOG = [
 	{
 		id: "identities",
 		group: "label",
-		label: "Identities",
+		label: "Known faces",
 		valueType: "stringList",
 		operator: "in",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "P1: matched against the identity display name on the record label."
+		description: "Only recognised people. Selecting NOBODY means every identity in the face gallery; selecting some narrows to those. Matched on the gallery id, so renaming a person does not break the rule. On immediate delivery the name is not known yet when the notification is enqueued — see the rule’s \"wait for recognition\" switch."
 	},
 	{
 		id: "plates",
 		group: "label",
-		label: "License plates",
+		label: "Known plates",
 		valueType: "plateMatcher",
 		operator: "fuzzyIn",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "Levenshtein-tolerant match against the plate text."
+		description: "Only vehicles whose plate was read. Selecting NO plate means any readable plate; listed plates are matched Levenshtein-tolerantly, because OCR noise makes an exact match useless."
 	},
 	{
 		id: "identitiesExclude",
 		group: "label",
-		label: "Excluded identities",
+		label: "Excluded faces",
 		valueType: "stringList",
 		operator: "notIn",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "Veto by identity display name (mirror of Identities; absent label passes)."
+		description: "Veto by identity (mirror of Known faces, same gallery ids). A subject nobody recognised passes — there is nothing to exclude."
 	},
 	{
 		id: "minLabelConfidence",
@@ -14334,7 +14402,21 @@ var LabelTierSchema = zod.z.union([zod.z.literal(1), zod.z.literal(2)]);
 var LabelAttributionSchema = zod.z.object({
 	stepId: zod.z.string(),
 	modelId: zod.z.string().optional(),
-	decidedAt: zod.z.number()
+	decidedAt: zod.z.number(),
+	/**
+	* The GALLERY id behind a recognised tier-2 label — a face-gallery
+	* `Identity.id` or a plate-gallery `Vehicle.id` (both `randomUUID`).
+	*
+	* The text alone is a DISPLAY NAME, and a display name is renameable: a
+	* notification rule authored on "Gianluca" stopped matching the moment the
+	* operator fixed the spelling in the gallery, and nothing said so. The id is
+	* the thing that does not move, so it is what a rule matches on
+	* (`NcConditions.identities`) and the text is what a human is shown.
+	*
+	* Absent when the label names no gallery row — a plate the OCR read but no
+	* vehicle claims, a sub-class, a species, any tier-1 value.
+	*/
+	identityId: zod.z.string().optional()
 });
 /**
 * The TIERED label model (roadmap 4g), spread into `TrackSchema` and

package/dist/index.mjs

@@ -12067,7 +12067,16 @@ var NcScheduleSchema = z.object({
 });
 /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
 var NcPlateMatcherSchema = z.object({
-	values: z.array(z.string().min(1)).min(1),
+	/**
+	* Plate texts (or gallery vehicle names) to match. EMPTY = **any plate the
+	* pipeline could read** — the plate half of "no selection = no narrowing",
+	* and the switch that says this rule is about vehicles that were IDENTIFIED
+	* rather than merely seen. A subject carrying no plate still fails.
+	*
+	* The `.min(1)` this used to carry made that state unauthorable; nothing has
+	* ever persisted an empty list, so widening it cannot change an existing rule.
+	*/
+	values: z.array(z.string().min(1)),
 	/** Max Levenshtein distance after normalization (uppercase alphanumeric). */
 	maxDistance: z.number().int().min(0).max(3).default(1)
 });
@@ -12329,18 +12338,47 @@ var NcConditionsSchema = z.object({
 	*/
 	labelEquals: z.array(z.string().min(1)).optional(),
 	/**
-	* Identity matcher. P1 boundary: matched against the record's collapsed
-	* `label` (the identity display name propagated by the face pipeline) —
-	* identity-ID matching rides in P2 when identity ids reach the record.
+	* KNOWN FACES — the rule's identity scope, and the switch that says the rule
+	* is about recognised people at all.
+	*
+	* Three states, and the empty one is the point:
+	*
+	* | value | meaning |
+	* | --- | --- |
+	* | absent | the rule does not care who it is; an unrecognised person matches |
+	* | `[]` | **only known faces** — any identity in the gallery, nobody in particular |
+	* | a list | only these identities |
+	*
+	* `[]` is the repo-wide "no selection = no narrowing" reading (an absent
+	* `devices` list is every device), applied one level down: the operator has
+	* turned the face scope ON and narrowed it to nothing, which is every known
+	* face. No second field states the same thing — a switch that can disagree
+	* with the list under it is worse than no switch (D62).
+	*
+	* MEMBERS ARE FACE-GALLERY `Identity.id`s (uuid), not display names. A name is
+	* renameable, and a rule authored on "Gianluca" went silently dark the moment
+	* the operator fixed the spelling. The id reaches the record on
+	* `LabelAttribution.identityId`; the name is what the editor shows and what
+	* `{{label}}` renders.
+	*
+	* Rules written before this carry NAMES, and are resolved to ids lazily at
+	* load (`NcRuleStore.load`) against the live gallery — a name nothing answers
+	* for is left as it stands and reported, never dropped. The engine also
+	* accepts a display-name hit as a compatibility leg, so a rule whose
+	* migration could not resolve keeps matching exactly what it matched before.
 	*/
 	identities: z.array(z.string().min(1)).optional(),
-	/** Fuzzy plate matcher against the record's `label` (plate text). */
+	/**
+	* KNOWN PLATES / VEHICLES — the plate mirror of {@link identities}, including
+	* the empty-list reading: `values: []` is "any plate the OCR could read",
+	* a non-empty list is those plates (fuzzily). See {@link NcPlateMatcherSchema}.
+	*/
 	plates: NcPlateMatcherSchema.optional(),
 	/**
-	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics.
-	* Same P1 boundary: matched against the record's collapsed `label` (the
-	* identity display name). A record with NO label passes (nothing to
-	* exclude), unlike the include variant which fails on an absent label.
+	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics, and
+	* the same id members and the same lazy name→id migration. A record with NO
+	* identity passes (nothing to exclude), unlike the include variant which
+	* fails on an unrecognised subject. An EMPTY list excludes nobody.
 	*/
 	identitiesExclude: z.array(z.string().min(1)).optional(),
 	/**
@@ -12733,7 +12771,37 @@ var NcRuleInputSchema = z.object({
 	* a rule that predates the gate must keep delivering byte-for-byte as it
 	* did, and absent is the only way to say that without a migration.
 	*/
-	confirm: NcConfirmSchema.optional()
+	confirm: NcConfirmSchema.optional(),
+	/**
+	* WAIT for face/plate recognition before saying anything.
+	*
+	* A notification's TEXT is frozen at enqueue and its media is re-resolved at
+	* send; the identity is neither. A face is confirmed after `confirmFrames`
+	* agreeing observations — p50 **11.4 s** after the track was first seen,
+	* measured on this hub — and an `immediate` rule enqueues on the first object
+	* event, seconds before that. So "Gianluca è arrivato" is unsayable on the
+	* immediate path, and no amount of media re-resolution fixes a sentence.
+	*
+	* Only two honest answers exist, and this flag picks between them. It has
+	* effect ONLY on a rule that declares a recognition scope
+	* ({@link NcConditions.identities} or {@link NcConditions.plates}) — on any
+	* other rule there is nothing to wait for and the flag is inert.
+	*
+	* | value | what happens |
+	* | --- | --- |
+	* | `true` | the rule stops firing on the object event and fires at TRACK CLOSE instead, once, with the name — later, and complete |
+	* | absent / `false` | it fires at once WITHOUT the name, and if recognition lands before the track closes a SECOND, "…is Gianluca" notification follows (one per track, per rule, per target) |
+	*
+	* `.optional()` and deliberately NOT `.default()`: a Zod default does not run
+	* on the addon cap path, and absent has to keep meaning exactly what every
+	* rule authored before this field meant.
+	*
+	* The cost of `true` is stated here because the editor states it too: a rule
+	* that waits also inherits track-close SEMANTICS — its `zones` condition
+	* tests every zone the track visited and a `crossing` condition can no longer
+	* be satisfied, because a closed track carries no crossing.
+	*/
+	waitForEnhancement: z.boolean().optional()
 });
 /**
 * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -13077,32 +13145,32 @@ var NC_CONDITION_CATALOG = [
 	{
 		id: "identities",
 		group: "label",
-		label: "Identities",
+		label: "Known faces",
 		valueType: "stringList",
 		operator: "in",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "P1: matched against the identity display name on the record label."
+		description: "Only recognised people. Selecting NOBODY means every identity in the face gallery; selecting some narrows to those. Matched on the gallery id, so renaming a person does not break the rule. On immediate delivery the name is not known yet when the notification is enqueued — see the rule’s \"wait for recognition\" switch."
 	},
 	{
 		id: "plates",
 		group: "label",
-		label: "License plates",
+		label: "Known plates",
 		valueType: "plateMatcher",
 		operator: "fuzzyIn",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "Levenshtein-tolerant match against the plate text."
+		description: "Only vehicles whose plate was read. Selecting NO plate means any readable plate; listed plates are matched Levenshtein-tolerantly, because OCR noise makes an exact match useless."
 	},
 	{
 		id: "identitiesExclude",
 		group: "label",
-		label: "Excluded identities",
+		label: "Excluded faces",
 		valueType: "stringList",
 		operator: "notIn",
 		appliesTo: ["immediate", "track-end"],
 		phase: "P1",
-		description: "Veto by identity display name (mirror of Identities; absent label passes)."
+		description: "Veto by identity (mirror of Known faces, same gallery ids). A subject nobody recognised passes — there is nothing to exclude."
 	},
 	{
 		id: "minLabelConfidence",
@@ -14333,7 +14401,21 @@ var LabelTierSchema = z.union([z.literal(1), z.literal(2)]);
 var LabelAttributionSchema = z.object({
 	stepId: z.string(),
 	modelId: z.string().optional(),
-	decidedAt: z.number()
+	decidedAt: z.number(),
+	/**
+	* The GALLERY id behind a recognised tier-2 label — a face-gallery
+	* `Identity.id` or a plate-gallery `Vehicle.id` (both `randomUUID`).
+	*
+	* The text alone is a DISPLAY NAME, and a display name is renameable: a
+	* notification rule authored on "Gianluca" stopped matching the moment the
+	* operator fixed the spelling in the gallery, and nothing said so. The id is
+	* the thing that does not move, so it is what a rule matches on
+	* (`NcConditions.identities`) and the text is what a human is shown.
+	*
+	* Absent when the label names no gallery row — a plate the OCR read but no
+	* vehicle claims, a sub-class, a species, any tier-1 value.
+	*/
+	identityId: z.string().optional()
 });
 /**
 * The TIERED label model (roadmap 4g), spread into `TrackSchema` and

package/package.json

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