my-frontend-observer 0.6.0 → 0.7.0

package/dist/domain/externalReferenceCompatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalReferenceCompatibility.js","sourceRoot":"","sources":["../../src/domain/externalReferenceCompatibility.ts"],"names":[],"mappings":"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"}

package/dist/domain/externalReferenceFidelity.d.ts

@@ -0,0 +1,141 @@
+/**
+ * v0.7 Prompt 6 structured reference-vs-candidate fidelity evaluation.
+ * Answers "for a compatible candidate with explicit valid bindings, does the
+ * candidate actually match the selected reference design requirements?" -
+ * the first point in this whole v0.7 stack where a reference's authored
+ * expectation is actually compared against live candidate evidence.
+ *
+ * Reuses, never duplicates:
+ * - `deriveReferenceRequirementAdequacy`/`deriveReferenceRequirementExpectation`
+ *   (v0.7 Prompt 3) for reference-side expected values/relationships and the
+ *   reference-adequacy gate.
+ * - `evaluateReferenceCandidateCompatibility` (v0.7 Prompt 4) as a hard gate
+ *   - viewport/theme/application-state/authenticated-state comparison is
+ *   never re-implemented here.
+ * - `evaluateReferenceRuntimeBindings` (v0.7 Prompt 5) as the sole source of
+ *   which runtime target (if any) represents each reference region for this
+ *   candidate - no automatic binding, no name/geometry matching.
+ * - `deriveLayoutRelationships` (v0.4) as the sole source of runtime
+ *   relationship evidence, scoped to the exact requested relationship
+ *   family (the same Prompt 3 bug-fix precedent - matching the first
+ *   record for a pair, regardless of family, was a real bug there and would
+ *   be here too).
+ *
+ * Coordinate systems are never conflated: Prompt 2 regions and Prompt 3
+ * tolerances are authored in reference-image pixels; `ObservationArtifact`
+ * target geometry is CSS pixels. This module establishes one explicit,
+ * deterministic, full-frame scale from `reference.applicability.viewport`
+ * (CSS pixels) to the reference image's own pixel dimensions, and converts
+ * candidate CSS measurements into reference-image-pixel space before
+ * comparing them against a Prompt 3 tolerance - it never assumes 1
+ * reference-image pixel equals 1 CSS pixel, never re-expresses a tolerance
+ * in a different unit, and never performs cropping/offset/rotation/
+ * perspective registration.
+ *
+ * No new persisted artifact family: `evaluateReferenceCandidateFidelity` is
+ * a pure, synchronous, on-demand function over already-persisted/in-memory
+ * evidence (an `ExternalReferenceArtifact`, an `ObservationArtifact`, and a
+ * binding-declaration collection). It mutates none of its inputs.
+ */
+import type { ExternalReferenceArtifact } from './externalReference.js';
+import type { ReferenceRequirementSubject, ReferenceRequirementTolerance, ReferenceRequirementAdequacy, AuthoredChangeScopeCategory, ExpectedDependentMode } from './externalReferenceRequirements.js';
+import type { ObservationArtifact } from './schema.js';
+import type { ComparabilityResult } from './comparison.js';
+import type { ReferenceRuntimeBindingDeclaration, ReferenceRuntimeBindingEvaluation } from './externalReferenceRuntimeBinding.js';
+import type { PairwiseRelationshipKind } from './relationships.js';
+/**
+ * Deliberately its own small vocabulary, not an import of v0.5's
+ * `CLAUSE_RESULT_STATUSES`: that vocabulary includes `'conflict'`, which has
+ * no equivalent here (each requirement is evaluated independently against
+ * its own single reference/candidate pair - there is no cross-requirement
+ * authoring conflict concept in Prompt 6). `pass`/`fail`/`unavailable` are
+ * reused as the same honest three-state shape v0.5 already established.
+ */
+export declare const REFERENCE_REQUIREMENT_FIDELITY_STATUSES: readonly ["pass", "fail", "unavailable"];
+export type ReferenceRequirementFidelityStatus = (typeof REFERENCE_REQUIREMENT_FIDELITY_STATUSES)[number];
+export declare const REFERENCE_REQUIREMENT_FIDELITY_REASON_CODES: readonly ["reference-evidence-unavailable", "reference-relationship-not-exhibited", "binding-unavailable", "candidate-evidence-unavailable", "coordinate-mapping-unavailable"];
+export type ReferenceRequirementFidelityReasonCode = (typeof REFERENCE_REQUIREMENT_FIDELITY_REASON_CODES)[number];
+/**
+ * One requirement's structured result. Numeric fields (`referenceValue`
+ * through `tolerance`) apply only to `region-property`/`region-measurement`
+ * subjects; relationship fields (`expectedRelationship`/`actualRelationship`)
+ * apply only to `region-relationship` subjects - never both populated on
+ * the same result, mirroring the subject's own discriminated shape.
+ * `reasonCode`/`detail` are present only when `status === 'unavailable'` - a
+ * `fail` is already fully explained by its numeric/relationship fields.
+ */
+export interface ReferenceRequirementFidelityResult {
+    requirementId: string;
+    category: AuthoredChangeScopeCategory;
+    expectedDependentMode?: ExpectedDependentMode;
+    subject: ReferenceRequirementSubject;
+    boundRuntimeTargets: string[];
+    status: ReferenceRequirementFidelityStatus;
+    reasonCode?: ReferenceRequirementFidelityReasonCode;
+    detail?: string;
+    referenceValue?: number;
+    candidateRawValue?: number;
+    candidateValue?: number;
+    delta?: number;
+    tolerance?: ReferenceRequirementTolerance;
+    expectedRelationship?: PairwiseRelationshipKind;
+    actualRelationship?: PairwiseRelationshipKind;
+}
+/**
+ * v0.7 Prompt 7 addition (additive; no prior structural validator existed
+ * for this Prompt 6 shape - fidelity evaluations previously only ever
+ * flowed in-memory from `evaluateReferenceCandidateFidelity`'s own return
+ * type, with no external/persisted input path to defend against). Reused by
+ * `boundedAgentContext.ts` as defense-in-depth when a caller-supplied
+ * `ReferenceRequirementFidelityResult` becomes part of a bounded fidelity
+ * projection. No change to `evaluateReferenceCandidateFidelity`'s own logic.
+ */
+export declare function isValidReferenceRequirementFidelityResult(value: unknown): value is ReferenceRequirementFidelityResult;
+export declare const REFERENCE_FIDELITY_STATES: readonly ["not-evaluated", "pass", "fail"];
+export type ReferenceFidelityState = (typeof REFERENCE_FIDELITY_STATES)[number];
+export declare const REFERENCE_FIDELITY_BLOCK_REASONS: readonly ["reference-inadequate", "incompatible"];
+export type ReferenceFidelityBlockReason = (typeof REFERENCE_FIDELITY_BLOCK_REASONS)[number];
+/**
+ * `state === 'not-evaluated'` exactly when an earlier gate (reference
+ * adequacy or reference/candidate compatibility) blocked ordinary
+ * evaluation - `requirementResults`/`bindings` are empty in that case, never
+ * a fabricated PASS/FAIL set. This is REFERENCE FIDELITY only - a
+ * downstream, separate concern from v0.5 baseline/per-change contract
+ * evaluation (see docs/CONTRACTS.md "v0.7 Prompt 6"): a `pass` here says
+ * nothing about, and never overrides, any v0.5 contract result.
+ */
+export interface ReferenceCandidateFidelityEvaluation {
+    referenceId: string;
+    referenceRequestId: string;
+    candidateObservationId: string;
+    candidateRequestId: string;
+    adequacy: ReferenceRequirementAdequacy;
+    compatibility?: ComparabilityResult;
+    bindings?: ReferenceRuntimeBindingEvaluation;
+    state: ReferenceFidelityState;
+    blockedBy?: ReferenceFidelityBlockReason;
+    requirementResults: ReferenceRequirementFidelityResult[];
+}
+export type EvaluateReferenceCandidateFidelityResult = {
+    ok: true;
+    evaluation: ReferenceCandidateFidelityEvaluation;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface EvaluateReferenceCandidateFidelityOptions {
+    geometryTolerancePx?: number;
+}
+/**
+ * Pure and synchronous. Evaluation order (frozen by this prompt's own
+ * design, never reordered): reference structural validation -> candidate
+ * structural validation -> binding-declaration structural validation ->
+ * Prompt 3 reference adequacy -> Prompt 4 compatibility -> Prompt 5 binding
+ * evaluation -> per-requirement candidate-evidence/coordinate-mapping
+ * checks -> per-requirement tolerance/relationship comparison -> overall
+ * result. An earlier blocking gate (adequacy `inadequate`, compatibility
+ * `incomparable`) always short-circuits to `state: 'not-evaluated'` with an
+ * empty `requirementResults` - no ordinary PASS/FAIL set is ever fabricated
+ * past a blocked gate.
+ */
+export declare function evaluateReferenceCandidateFidelity(reference: ExternalReferenceArtifact, candidate: ObservationArtifact, bindingDeclarations: readonly ReferenceRuntimeBindingDeclaration[], options?: EvaluateReferenceCandidateFidelityOptions): EvaluateReferenceCandidateFidelityResult;

package/dist/domain/externalReferenceFidelity.js

@@ -0,0 +1,413 @@
+import { isValidExternalReferenceArtifact, isImportedExternalReferenceArtifact } from './externalReference.js';
+import { deriveReferenceRequirementAdequacy, deriveReferenceRequirementExpectation, deriveReferenceRequirementMeasurement, isAuthoredChangeScopeCategory, isValidExpectedDependentMode, isValidReferenceRequirementSubjectShape, isValidReferenceRequirementTolerance, } from './externalReferenceRequirements.js';
+import { isValidObservationArtifact } from './schema.js';
+import { evidenceValue } from './evidence.js';
+import { evaluateReferenceCandidateCompatibility } from './externalReferenceCompatibility.js';
+import { evaluateReferenceRuntimeBindings } from './externalReferenceRuntimeBinding.js';
+import { deriveLayoutRelationships, HORIZONTAL_ORDER_RELATIONSHIPS, VERTICAL_ORDER_RELATIONSHIPS, AREA_OVERLAP_RELATIONSHIPS, RELATIVE_WIDTH_RELATIONSHIPS, GEOMETRIC_FIT_RELATIONSHIPS, VERTICAL_SEQUENCE_RELATIONSHIPS, PAIRWISE_RELATIONSHIP_KINDS, } from './relationships.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+// ---------------------------------------------------------------------------
+// Result vocabulary
+// ---------------------------------------------------------------------------
+/**
+ * Deliberately its own small vocabulary, not an import of v0.5's
+ * `CLAUSE_RESULT_STATUSES`: that vocabulary includes `'conflict'`, which has
+ * no equivalent here (each requirement is evaluated independently against
+ * its own single reference/candidate pair - there is no cross-requirement
+ * authoring conflict concept in Prompt 6). `pass`/`fail`/`unavailable` are
+ * reused as the same honest three-state shape v0.5 already established.
+ */
+export const REFERENCE_REQUIREMENT_FIDELITY_STATUSES = ['pass', 'fail', 'unavailable'];
+export const REFERENCE_REQUIREMENT_FIDELITY_REASON_CODES = [
+    'reference-evidence-unavailable',
+    'reference-relationship-not-exhibited',
+    'binding-unavailable',
+    'candidate-evidence-unavailable',
+    'coordinate-mapping-unavailable',
+];
+/**
+ * v0.7 Prompt 7 addition (additive; no prior structural validator existed
+ * for this Prompt 6 shape - fidelity evaluations previously only ever
+ * flowed in-memory from `evaluateReferenceCandidateFidelity`'s own return
+ * type, with no external/persisted input path to defend against). Reused by
+ * `boundedAgentContext.ts` as defense-in-depth when a caller-supplied
+ * `ReferenceRequirementFidelityResult` becomes part of a bounded fidelity
+ * projection. No change to `evaluateReferenceCandidateFidelity`'s own logic.
+ */
+export function isValidReferenceRequirementFidelityResult(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!isNonEmptyString(value.requirementId))
+        return false;
+    if (!isAuthoredChangeScopeCategory(value.category))
+        return false;
+    if (value.expectedDependentMode !== undefined && !isValidExpectedDependentMode(value.expectedDependentMode))
+        return false;
+    if (!isValidReferenceRequirementSubjectShape(value.subject))
+        return false;
+    if (!Array.isArray(value.boundRuntimeTargets) || !value.boundRuntimeTargets.every(isNonEmptyString))
+        return false;
+    if (typeof value.status !== 'string' || !REFERENCE_REQUIREMENT_FIDELITY_STATUSES.includes(value.status))
+        return false;
+    if (value.status === 'unavailable') {
+        if (typeof value.reasonCode !== 'string' || !REFERENCE_REQUIREMENT_FIDELITY_REASON_CODES.includes(value.reasonCode))
+            return false;
+        if (!isNonEmptyString(value.detail))
+            return false;
+    }
+    else if ('reasonCode' in value && value.reasonCode !== undefined) {
+        return false;
+    }
+    for (const key of ['referenceValue', 'candidateRawValue', 'candidateValue', 'delta']) {
+        if (value[key] !== undefined && typeof value[key] !== 'number')
+            return false;
+    }
+    if (value.tolerance !== undefined && !isValidReferenceRequirementTolerance(value.tolerance))
+        return false;
+    for (const key of ['expectedRelationship', 'actualRelationship']) {
+        if (value[key] !== undefined && (typeof value[key] !== 'string' || !PAIRWISE_RELATIONSHIP_KINDS.includes(value[key])))
+            return false;
+    }
+    return true;
+}
+export const REFERENCE_FIDELITY_STATES = ['not-evaluated', 'pass', 'fail'];
+export const REFERENCE_FIDELITY_BLOCK_REASONS = ['reference-inadequate', 'incompatible'];
+// ---------------------------------------------------------------------------
+// Coordinate mapping (reference-image pixels <-> CSS pixels)
+// ---------------------------------------------------------------------------
+/**
+ * A coordinate-mapping-validity check only - never a design tolerance.
+ * Independently owned, deliberately tiny: this exists solely to detect
+ * "the applicable viewport and the reference image cannot represent the
+ * same full-frame content" (e.g. a viewport declared with a materially
+ * different aspect ratio than the image), never to forgive an actual
+ * design mismatch.
+ */
+const ASPECT_RATIO_MAPPING_TOLERANCE = 0.01;
+function referenceImageDimensions(reference) {
+    if (isImportedExternalReferenceArtifact(reference))
+        return { width: reference.image.width, height: reference.image.height };
+    return { width: reference.sourceReference.image.width, height: reference.sourceReference.image.height };
+}
+/**
+ * Establishes the one explicit reference-image-pixel <-> CSS-pixel scale
+ * this module ever uses, from `reference.applicability.viewport` (the CSS-
+ * pixel runtime viewport the design represents) and the reference image's
+ * own pixel dimensions (never conflated - see externalReferenceApplicability.ts).
+ * No applicable viewport at all means no scale can be established (this
+ * module never infers one from image dimensions alone). A deliberately
+ * bounded full-frame mapping only: `scaleX`/`scaleY` must agree within
+ * `ASPECT_RATIO_MAPPING_TOLERANCE`, or the mapping is rejected outright -
+ * this module performs no cropping, offset, rotation, perspective, or other
+ * arbitrary affine registration.
+ */
+function deriveCoordinateScale(reference) {
+    const viewport = reference.applicability?.viewport;
+    if (!viewport) {
+        return { ok: false, reason: 'reference declares no applicable viewport; reference-image-pixel <-> CSS-pixel coordinate mapping cannot be established' };
+    }
+    const { width: imageWidth, height: imageHeight } = referenceImageDimensions(reference);
+    const scaleX = imageWidth / viewport.width;
+    const scaleY = imageHeight / viewport.height;
+    const largerScale = Math.max(scaleX, scaleY);
+    const relativeScaleDelta = largerScale === 0 ? 0 : Math.abs(scaleX - scaleY) / largerScale;
+    if (relativeScaleDelta > ASPECT_RATIO_MAPPING_TOLERANCE) {
+        return {
+            ok: false,
+            reason: `reference image (${imageWidth}x${imageHeight}) and applicable viewport (${viewport.width}x${viewport.height}) do not share a coherent full-frame aspect ratio (scaleX=${scaleX}, scaleY=${scaleY})`,
+        };
+    }
+    return { ok: true, scale: { scaleX, scaleY } };
+}
+/** Raw CSS-pixel geometry, reshaped into `ReferenceRegionGeometry`'s exact field set (adding centerX/centerY, computed identically to `deriveReferenceRegionGeometry`) so the same downstream property/measurement logic applies to both reference and candidate geometry uniformly. */
+function candidateRawGeometry(geometry) {
+    return {
+        x: geometry.x,
+        y: geometry.y,
+        width: geometry.width,
+        height: geometry.height,
+        right: geometry.right,
+        bottom: geometry.bottom,
+        centerX: geometry.x + geometry.width / 2,
+        centerY: geometry.y + geometry.height / 2,
+    };
+}
+/** Applies the coordinate scale per axis - horizontal fields (x/width/right/centerX) scale by `scaleX`, vertical fields (y/height/bottom/centerY) scale by `scaleY`. Never rounds; subpixel precision is preserved through to the final tolerance comparison. */
+function scaleGeometryToReferenceSpace(geometry, scale) {
+    return {
+        x: geometry.x * scale.scaleX,
+        y: geometry.y * scale.scaleY,
+        width: geometry.width * scale.scaleX,
+        height: geometry.height * scale.scaleY,
+        right: geometry.right * scale.scaleX,
+        bottom: geometry.bottom * scale.scaleY,
+        centerX: geometry.centerX * scale.scaleX,
+        centerY: geometry.centerY * scale.scaleY,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tolerance (reused exactly, never redefined)
+// ---------------------------------------------------------------------------
+/**
+ * `exact` is the zero-tolerance case of the same rule, so a single
+ * `abs(delta) <= allowed` comparison covers every Prompt 3 tolerance kind
+ * without a separate equality branch. Percent's denominator mirrors
+ * v0.5's own `toleranceToPx` convention exactly (`frontendContractEvaluation.ts`:
+ * "the absolute before-value, the standard 'may vary by up to N%' reading") -
+ * independently reimplemented here in reference-image-pixel units, never
+ * imported, since v0.5's CSS-pixel `ContractTolerance` is a different unit
+ * (see externalReferenceRequirements.ts's own tolerance doc comment).
+ */
+function referenceToleranceAmountPx(tolerance, referenceValue) {
+    switch (tolerance.kind) {
+        case 'exact':
+            return 0;
+        case 'absolute-reference-px':
+            return tolerance.amount;
+        case 'percent':
+            return (tolerance.amount / 100) * Math.abs(referenceValue);
+    }
+}
+// ---------------------------------------------------------------------------
+// Runtime-target lookup (mirrors externalReferenceRuntimeBinding.ts's own
+// case-insensitive resolution convention - duplicated per the established
+// per-module small-helper-ownership pattern, not cross-imported as a
+// private helper)
+// ---------------------------------------------------------------------------
+function resolveConfiguredTargetName(candidate, runtimeTarget) {
+    const lower = runtimeTarget.toLowerCase();
+    return candidate.requestConfig.targets.find((t) => t.name.toLowerCase() === lower)?.name;
+}
+/** Mirrors frontendContractEvaluation.ts's/externalReferenceRequirements.ts's own independently-owned `RELATIONSHIP_FAMILY_GROUPS` shape - the third such duplicate in this repository, per the same established "never share this constant cross-module" convention. */
+const RELATIONSHIP_FAMILY_GROUPS = [
+    HORIZONTAL_ORDER_RELATIONSHIPS,
+    VERTICAL_ORDER_RELATIONSHIPS,
+    AREA_OVERLAP_RELATIONSHIPS,
+    RELATIVE_WIDTH_RELATIONSHIPS,
+    GEOMETRIC_FIT_RELATIONSHIPS,
+    VERTICAL_SEQUENCE_RELATIONSHIPS,
+];
+// ---------------------------------------------------------------------------
+// Per-requirement evaluation
+// ---------------------------------------------------------------------------
+function baseFields(requirement) {
+    return {
+        requirementId: requirement.requirementId,
+        category: requirement.category,
+        subject: requirement.subject,
+        ...(requirement.expectedDependentMode !== undefined ? { expectedDependentMode: requirement.expectedDependentMode } : {}),
+    };
+}
+function unavailable(requirement, boundRuntimeTargets, reasonCode, detail) {
+    return { ...baseFields(requirement), boundRuntimeTargets, status: 'unavailable', reasonCode, detail };
+}
+function bindingFor(bindingsByRegion, regionId) {
+    return bindingsByRegion.get(regionId.toLowerCase());
+}
+function evaluateRegionPropertyRequirement(requirement, subject, reference, candidate, bindingsByRegion, scaleResult, options) {
+    const expectation = deriveReferenceRequirementExpectation(subject, reference.regions ?? [], options);
+    if (!expectation.available)
+        return unavailable(requirement, [], 'reference-evidence-unavailable', expectation.reason);
+    if (expectation.kind !== 'numeric')
+        return unavailable(requirement, [], 'reference-evidence-unavailable', 'a region-property subject unexpectedly produced non-numeric reference evidence');
+    const binding = bindingFor(bindingsByRegion, subject.region);
+    if (!binding || binding.status !== 'bound') {
+        return unavailable(requirement, [], 'binding-unavailable', binding ? binding.detail : `no runtime binding declared for reference region "${subject.region}"`);
+    }
+    const boundRuntimeTargets = [binding.runtimeTarget];
+    const configuredName = resolveConfiguredTargetName(candidate, binding.runtimeTarget);
+    const record = configuredName ? candidate.targetEvidence[configuredName] : undefined;
+    const visibility = record ? evidenceValue(record.visibility) : undefined;
+    if (!visibility || !visibility.visible) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'bound runtime target is not visible; geometry evidence is not usable for fidelity evaluation');
+    }
+    const geometry = record ? evidenceValue(record.geometry) : undefined;
+    if (!geometry) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'bound runtime target has no geometry evidence');
+    }
+    if (!scaleResult.ok) {
+        return unavailable(requirement, boundRuntimeTargets, 'coordinate-mapping-unavailable', scaleResult.reason);
+    }
+    const rawGeometry = candidateRawGeometry(geometry);
+    const scaledGeometry = scaleGeometryToReferenceSpace(rawGeometry, scaleResult.scale);
+    const candidateRawValue = rawGeometry[subject.property];
+    const candidateValue = scaledGeometry[subject.property];
+    const referenceValue = expectation.value;
+    const delta = candidateValue - referenceValue;
+    const tolerance = requirement.tolerance;
+    const allowed = referenceToleranceAmountPx(tolerance, referenceValue);
+    const status = Math.abs(delta) <= allowed ? 'pass' : 'fail';
+    return { ...baseFields(requirement), boundRuntimeTargets, status, referenceValue, candidateRawValue, candidateValue, delta, tolerance };
+}
+function evaluateRegionMeasurementRequirement(requirement, subject, reference, candidate, bindingsByRegion, scaleResult, options) {
+    const expectation = deriveReferenceRequirementExpectation(subject, reference.regions ?? [], options);
+    if (!expectation.available)
+        return unavailable(requirement, [], 'reference-evidence-unavailable', expectation.reason);
+    if (expectation.kind !== 'numeric')
+        return unavailable(requirement, [], 'reference-evidence-unavailable', 'a region-measurement subject unexpectedly produced non-numeric reference evidence');
+    const subjectBinding = bindingFor(bindingsByRegion, subject.subjectRegion);
+    const relatedBinding = bindingFor(bindingsByRegion, subject.relatedRegion);
+    if (!subjectBinding || subjectBinding.status !== 'bound') {
+        return unavailable(requirement, [], 'binding-unavailable', subjectBinding ? subjectBinding.detail : `no runtime binding declared for reference region "${subject.subjectRegion}"`);
+    }
+    if (!relatedBinding || relatedBinding.status !== 'bound') {
+        return unavailable(requirement, [subjectBinding.runtimeTarget], 'binding-unavailable', relatedBinding ? relatedBinding.detail : `no runtime binding declared for reference region "${subject.relatedRegion}"`);
+    }
+    const boundRuntimeTargets = [subjectBinding.runtimeTarget, relatedBinding.runtimeTarget];
+    const subjectConfiguredName = resolveConfiguredTargetName(candidate, subjectBinding.runtimeTarget);
+    const relatedConfiguredName = resolveConfiguredTargetName(candidate, relatedBinding.runtimeTarget);
+    const subjectRecord = subjectConfiguredName ? candidate.targetEvidence[subjectConfiguredName] : undefined;
+    const relatedRecord = relatedConfiguredName ? candidate.targetEvidence[relatedConfiguredName] : undefined;
+    const subjectVisibility = subjectRecord ? evidenceValue(subjectRecord.visibility) : undefined;
+    const relatedVisibility = relatedRecord ? evidenceValue(relatedRecord.visibility) : undefined;
+    if (!subjectVisibility?.visible || !relatedVisibility?.visible) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'one or both bound runtime targets are not visible; geometry evidence is not usable for fidelity evaluation');
+    }
+    const subjectGeometry = subjectRecord ? evidenceValue(subjectRecord.geometry) : undefined;
+    const relatedGeometry = relatedRecord ? evidenceValue(relatedRecord.geometry) : undefined;
+    if (!subjectGeometry || !relatedGeometry) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'one or both bound runtime targets have no geometry evidence');
+    }
+    if (!scaleResult.ok) {
+        return unavailable(requirement, boundRuntimeTargets, 'coordinate-mapping-unavailable', scaleResult.reason);
+    }
+    const subjectRaw = candidateRawGeometry(subjectGeometry);
+    const relatedRaw = candidateRawGeometry(relatedGeometry);
+    const subjectScaled = scaleGeometryToReferenceSpace(subjectRaw, scaleResult.scale);
+    const relatedScaled = scaleGeometryToReferenceSpace(relatedRaw, scaleResult.scale);
+    const candidateRawValue = deriveReferenceRequirementMeasurement(subject.measurement, subjectRaw, relatedRaw);
+    const candidateValue = deriveReferenceRequirementMeasurement(subject.measurement, subjectScaled, relatedScaled);
+    if (candidateValue === undefined) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', `"${subject.measurement}" is geometrically undefined for these two bound runtime targets (they overlap on the relevant axis)`);
+    }
+    const referenceValue = expectation.value;
+    const delta = candidateValue - referenceValue;
+    const tolerance = requirement.tolerance;
+    const allowed = referenceToleranceAmountPx(tolerance, referenceValue);
+    const status = Math.abs(delta) <= allowed ? 'pass' : 'fail';
+    return {
+        ...baseFields(requirement),
+        boundRuntimeTargets,
+        status,
+        referenceValue,
+        ...(candidateRawValue !== undefined ? { candidateRawValue } : {}),
+        candidateValue,
+        delta,
+        tolerance,
+    };
+}
+function evaluateRegionRelationshipRequirement(requirement, subject, reference, candidate, bindingsByRegion, options) {
+    const expectation = deriveReferenceRequirementExpectation(subject, reference.regions ?? [], options);
+    if (!expectation.available)
+        return unavailable(requirement, [], 'reference-evidence-unavailable', expectation.reason);
+    if (expectation.kind === 'relationship' && !expectation.matches) {
+        return unavailable(requirement, [], 'reference-relationship-not-exhibited', `the reference does not exhibit the required "${subject.relationship}" relationship between "${subject.subjectRegion}" and "${subject.relatedRegion}"`);
+    }
+    const subjectBinding = bindingFor(bindingsByRegion, subject.subjectRegion);
+    const relatedBinding = bindingFor(bindingsByRegion, subject.relatedRegion);
+    if (!subjectBinding || subjectBinding.status !== 'bound') {
+        return unavailable(requirement, [], 'binding-unavailable', subjectBinding ? subjectBinding.detail : `no runtime binding declared for reference region "${subject.subjectRegion}"`);
+    }
+    if (!relatedBinding || relatedBinding.status !== 'bound') {
+        return unavailable(requirement, [subjectBinding.runtimeTarget], 'binding-unavailable', relatedBinding ? relatedBinding.detail : `no runtime binding declared for reference region "${subject.relatedRegion}"`);
+    }
+    const boundRuntimeTargets = [subjectBinding.runtimeTarget, relatedBinding.runtimeTarget];
+    const relationshipsResult = deriveLayoutRelationships(candidate, options.geometryTolerancePx !== undefined ? { geometryTolerancePx: options.geometryTolerancePx } : {});
+    if (!relationshipsResult.ok) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', relationshipsResult.reason);
+    }
+    const subjectTargetName = resolveConfiguredTargetName(candidate, subjectBinding.runtimeTarget);
+    const relatedTargetName = resolveConfiguredTargetName(candidate, relatedBinding.runtimeTarget);
+    if (!subjectTargetName || !relatedTargetName) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'bound runtime target is not part of the candidate\'s configured target set');
+    }
+    const unresolved = new Set(relationshipsResult.graph.unresolvedTargets.map((u) => u.target));
+    if (unresolved.has(subjectTargetName) || unresolved.has(relatedTargetName)) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', 'one or both bound runtime targets have no usable geometry for relationship derivation');
+    }
+    const family = RELATIONSHIP_FAMILY_GROUPS.find((group) => group.includes(subject.relationship));
+    const direct = relationshipsResult.graph.pairwiseRelationships.find((r) => family.includes(r.kind) && r.subjectTarget === subjectTargetName && r.relatedTarget === relatedTargetName);
+    if (direct) {
+        const status = direct.kind === subject.relationship ? 'pass' : 'fail';
+        return { ...baseFields(requirement), boundRuntimeTargets, status, expectedRelationship: subject.relationship, actualRelationship: direct.kind };
+    }
+    const reversed = relationshipsResult.graph.pairwiseRelationships.find((r) => family.includes(r.kind) && r.subjectTarget === relatedTargetName && r.relatedTarget === subjectTargetName);
+    if (reversed) {
+        return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', `runtime relationship evidence for the bound targets was only derivable in the opposite order (found "${reversed.kind}") - this requirement's subjectRegion/relatedRegion order does not match the candidate's configured target order`);
+    }
+    return unavailable(requirement, boundRuntimeTargets, 'candidate-evidence-unavailable', `no "${subject.relationship}" runtime relationship evidence was derivable between the bound targets`);
+}
+function evaluateOneRequirement(requirement, reference, candidate, bindingsByRegion, scaleResult, options) {
+    const subject = requirement.subject;
+    if (subject.kind === 'region-property')
+        return evaluateRegionPropertyRequirement(requirement, subject, reference, candidate, bindingsByRegion, scaleResult, options);
+    if (subject.kind === 'region-measurement')
+        return evaluateRegionMeasurementRequirement(requirement, subject, reference, candidate, bindingsByRegion, scaleResult, options);
+    return evaluateRegionRelationshipRequirement(requirement, subject, reference, candidate, bindingsByRegion, options);
+}
+// ---------------------------------------------------------------------------
+// Top-level evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Pure and synchronous. Evaluation order (frozen by this prompt's own
+ * design, never reordered): reference structural validation -> candidate
+ * structural validation -> binding-declaration structural validation ->
+ * Prompt 3 reference adequacy -> Prompt 4 compatibility -> Prompt 5 binding
+ * evaluation -> per-requirement candidate-evidence/coordinate-mapping
+ * checks -> per-requirement tolerance/relationship comparison -> overall
+ * result. An earlier blocking gate (adequacy `inadequate`, compatibility
+ * `incomparable`) always short-circuits to `state: 'not-evaluated'` with an
+ * empty `requirementResults` - no ordinary PASS/FAIL set is ever fabricated
+ * past a blocked gate.
+ */
+export function evaluateReferenceCandidateFidelity(reference, candidate, bindingDeclarations, options = {}) {
+    const referenceValidation = isValidExternalReferenceArtifact(reference);
+    if (!referenceValidation.valid)
+        return { ok: false, reason: `reference is invalid: ${referenceValidation.reason}` };
+    const candidateValidation = isValidObservationArtifact(candidate);
+    if (!candidateValidation.valid)
+        return { ok: false, reason: `candidate is invalid: ${candidateValidation.reason}` };
+    const geometryOptions = options.geometryTolerancePx !== undefined ? { geometryTolerancePx: options.geometryTolerancePx } : {};
+    const adequacy = deriveReferenceRequirementAdequacy(reference.regions ?? [], reference.requirements ?? [], geometryOptions);
+    const provenance = {
+        referenceId: reference.referenceId,
+        referenceRequestId: reference.referenceRequestId,
+        candidateObservationId: candidate.observationId,
+        candidateRequestId: candidate.requestId,
+    };
+    if (adequacy.status === 'inadequate') {
+        return { ok: true, evaluation: { ...provenance, adequacy, state: 'not-evaluated', blockedBy: 'reference-inadequate', requirementResults: [] } };
+    }
+    const compatibilityResult = evaluateReferenceCandidateCompatibility(reference, candidate);
+    if (compatibilityResult.compatibility.state === 'incomparable') {
+        return {
+            ok: true,
+            evaluation: { ...provenance, adequacy, compatibility: compatibilityResult.compatibility, state: 'not-evaluated', blockedBy: 'incompatible', requirementResults: [] },
+        };
+    }
+    const bindingEvaluationResult = evaluateReferenceRuntimeBindings(reference, candidate, bindingDeclarations);
+    if (!bindingEvaluationResult.ok)
+        return { ok: false, reason: bindingEvaluationResult.reason };
+    const bindingEvaluation = bindingEvaluationResult.evaluation;
+    const bindingsByRegion = new Map(bindingEvaluation.bindings.map((b) => [b.referenceRegion.toLowerCase(), b]));
+    const scaleResult = deriveCoordinateScale(reference);
+    const requirementResults = (reference.requirements ?? []).map((requirement) => evaluateOneRequirement(requirement, reference, candidate, bindingsByRegion, scaleResult, geometryOptions));
+    const state = requirementResults.every((r) => r.status === 'pass') ? 'pass' : 'fail';
+    return {
+        ok: true,
+        evaluation: {
+            ...provenance,
+            adequacy,
+            compatibility: compatibilityResult.compatibility,
+            bindings: bindingEvaluation,
+            state,
+            requirementResults,
+        },
+    };
+}
+//# sourceMappingURL=externalReferenceFidelity.js.map

package/dist/domain/externalReferenceFidelity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalReferenceFidelity.js","sourceRoot":"","sources":["../../src/domain/externalReferenceFidelity.ts"],"names":[],"mappings":"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"}

package/dist/domain/externalReferenceIdentity.d.ts

@@ -0,0 +1,38 @@
+import type { ExternalReferenceImageFormat } from './externalReferenceImage.js';
+import type { ReferenceRegion } from './externalReferenceRegions.js';
+import type { ExternalReferenceRequirement } from './externalReferenceRequirements.js';
+import type { ExternalReferenceApplicability } from './externalReferenceApplicability.js';
+/**
+ * Pure function of {imageSha256, format, width, height, supersedesReferenceId,
+ * regions?} - the semantic content of the reference image, which prior
+ * reference (if any) it explicitly supersedes, and (v0.7 Prompt 2 addition)
+ * its explicitly authored reference regions when present. Never includes a
+ * filesystem path, output location, a captured timestamp, or a
+ * caller-supplied label: two imports of byte-identical image content and
+ * region content from different operational locations, with different
+ * labels, produce the same logical identity; changing the image content, its
+ * detected format/dimensions, the supersession target, or the region set
+ * (added/removed/renamed/moved/resized) changes it.
+ *
+ * `regions`/`requirements`/`applicability` are each omitted from the hashed
+ * view entirely when not supplied (rather than included as `null`, unlike
+ * `supersedes`) so that every pre-Prompt-2/3/4 call site - and every later
+ * call that legitimately omits one of them - keeps producing byte-identical
+ * identity to the earlier prompt, never a new hash purely because a
+ * parameter now exists. Region/requirement order is part of the semantic
+ * view (authored order is semantic, mirroring domain/identity.ts's `targets`
+ * treatment) - canonicalize sorts object keys but deliberately never
+ * reorders arrays. `requirements` entries already carry their own
+ * content-derived `requirementId` (see externalReferenceRequirementIdentity.ts),
+ * so changing a selected property, tolerance, or category changes both that
+ * requirement's own id and this artifact-level identity.
+ */
+export declare function buildExternalReferenceRequestIdentity(imageSha256: string, format: ExternalReferenceImageFormat, width: number, height: number, supersedesReferenceId?: string, regions?: readonly ReferenceRegion[], requirements?: readonly ExternalReferenceRequirement[], applicability?: ExternalReferenceApplicability): string;
+/**
+ * Fresh, opaque per-persisted-instance identity - never derived from a
+ * timestamp alone, never collides even when called twice with the same
+ * requestIdentity within the same millisecond. Used both for a fresh import
+ * and for a fresh approval of an already-imported reference (same
+ * referenceRequestId, a new referenceId each time something is persisted).
+ */
+export declare function buildExternalReferenceInstanceIdentity(requestIdentity: string): string;