@dailephd/my-frontend-observer 0.8.1

package/dist/domain/comparison.d.ts

@@ -0,0 +1,220 @@
+/**
+ * v0.4 Batch 1 comparison contract. Frozen here as pure
+ * types/constants/structural validators only - comparison is downstream of
+ * observation (real Chromium -> ObservationArtifact -> relationship
+ * derivation -> comparability analysis -> comparison -> ComparisonArtifact,
+ * see docs/ARCHITECTURE.md) and this batch implements neither relationship
+ * derivation, real comparison, nor persistence. Batch 2 owns relationship
+ * derivation; Batch 3 owns `compareObservations()` and comparison
+ * persistence; Batch 4 owns CLI exposure.
+ *
+ * Comparison and observation are different evidence products: this module
+ * never reuses `ARTIFACT_KIND`/`SCHEMA_VERSION` from `./schema.js`, and
+ * `isValidComparisonArtifact` never delegates to `isValidObservationArtifact`.
+ */
+import { PRODUCER_NAME, SCHEMA_VERSION as OBSERVATION_SCHEMA_VERSION } from './schema.js';
+import type { Diagnostic } from './diagnostics.js';
+import type { EvidenceReference, LayoutRelationshipGraph, PageLevelRelationshipKind, PairwiseRelationshipKind } from './relationships.js';
+export declare const COMPARISON_ARTIFACT_KIND: "my-frontend-observer/comparison";
+export declare const COMPARISON_SCHEMA_VERSION: "1.0.0";
+/**
+ * Geometry tolerance is owned by domain/relationships.ts (the relationship
+ * derivation engine needs it directly, and that module must not import this
+ * one back - relationships.ts is the lower-level module). Re-exported here
+ * unchanged so every pre-Batch-2 consumer of these names from
+ * domain/comparison.ts keeps working.
+ */
+export { GEOMETRY_TOLERANCE_DEFAULT_PX, GEOMETRY_TOLERANCE_MIN_PX, GEOMETRY_TOLERANCE_MAX_PX, isValidGeometryTolerancePx } from './relationships.js';
+export declare const DEPENDENCY_PROPERTIES: readonly ["x", "y", "width", "height"];
+export type DependencyProperty = (typeof DEPENDENCY_PROPERTIES)[number];
+export declare const DEPENDENCY_DIRECTIONS: readonly ["increase", "decrease", "change", "unchanged"];
+export type DependencyDirection = (typeof DEPENDENCY_DIRECTIONS)[number];
+/** The observer never generates a dependency declaration from co-change; every declaration must explicitly identify that it was supplied externally. */
+export declare const EXPECTED_DEPENDENCY_SOURCES: readonly ["explicit-config"];
+export type ExpectedDependencySource = (typeof EXPECTED_DEPENDENCY_SOURCES)[number];
+export interface DependencyTermDeclaration {
+    target: string;
+    property: DependencyProperty;
+    direction: DependencyDirection;
+}
+/** A bounded, explicitly-declared expected layout dependency (e.g. "navigation.width decreases -> workspace.width increases") - never inferred from co-change. */
+export interface ExpectedDependencyDeclaration {
+    cause: DependencyTermDeclaration;
+    effect: DependencyTermDeclaration;
+    source: ExpectedDependencySource;
+}
+export declare function isValidExpectedDependencyDeclaration(value: unknown): value is ExpectedDependencyDeclaration;
+/**
+ * Non-causal evaluation outcomes only - describes the relationship between a
+ * declared expectation and observed differences, never an implementation
+ * verdict (no PASS/FAIL/approved/regression/allowed/protected vocabulary).
+ */
+export declare const DEPENDENCY_EVIDENCE_OUTCOMES: readonly ["consistent", "not-observed", "contradictory-to-declaration", "unavailable"];
+export type DependencyEvidenceOutcome = (typeof DEPENDENCY_EVIDENCE_OUTCOMES)[number];
+export interface ExpectedDependencyEvidence {
+    declaration: ExpectedDependencyDeclaration;
+    outcome: DependencyEvidenceOutcome;
+    supportingEvidence: EvidenceReference[];
+}
+export declare function isValidExpectedDependencyEvidence(value: unknown): value is ExpectedDependencyEvidence;
+/** Deliberately excludes any v0.5+ contract/change-scope field (requestedChanges, protected, preserved, allowedChanges, passThreshold, failThreshold, baseline, approval). */
+export interface ComparisonConfig {
+    geometryTolerancePx: number;
+    expectedDependencies?: ExpectedDependencyDeclaration[];
+}
+export declare function isValidComparisonConfig(value: unknown): value is ComparisonConfig;
+export declare const COMPARABILITY_STATES: readonly ["comparable", "comparable-with-warnings", "incomparable"];
+export type ComparabilityState = (typeof COMPARABILITY_STATES)[number];
+/**
+ * Hard-incompatibility reason codes are `blocking` (force `incomparable`
+ * unless the repository can prove a dimension cannot be evaluated
+ * reliably); warning-only differences are `warning` (do not by themselves
+ * prevent useful page-level comparison); dimensions the observer does not
+ * yet model (theme/authenticated-state/application-state identity) are
+ * `unassessed` and never claimed identical without evidence.
+ */
+export declare const COMPARABILITY_REASON_CODES: readonly ["artifact-kind-mismatch", "schema-version-mismatch", "page-url-mismatch", "viewport-mismatch", "viewport-unassessed", "scroll-scenario-mismatch", "browser-engine-mismatch", "producer-version-mismatch", "browser-version-mismatch", "target-set-mismatch", "target-locator-mismatch", "theme-mismatch", "theme-unassessed", "authenticated-state-mismatch", "authenticated-state-unassessed", "application-state-mismatch", "application-state-unassessed"];
+export type ComparabilityReasonCode = (typeof COMPARABILITY_REASON_CODES)[number];
+export type ComparabilityReasonSeverity = 'blocking' | 'warning' | 'unassessed';
+/**
+ * v0.7 Prompt 4 additions: `viewport-unassessed` (a reference need not
+ * declare an applicable viewport - see externalReferenceApplicability.ts -
+ * whereas an ObservationArtifact's viewport is always present, so v0.4's own
+ * comparability never needed this variant before), `theme-mismatch`,
+ * `authenticated-state-mismatch`, `application-state-mismatch` (blocking -
+ * these three dimensions are now assessed, not merely unassessed, whenever
+ * explicit state is present on both sides being compared - see
+ * comparisonEngine.ts#assessOptionalComparabilityDimension). The
+ * corresponding `-unassessed` variants are unchanged and still apply
+ * whenever explicit state is missing from either side.
+ */
+export declare const COMPARABILITY_REASON_SEVERITY: Record<ComparabilityReasonCode, ComparabilityReasonSeverity>;
+export interface ComparabilityReason {
+    code: ComparabilityReasonCode;
+    severity: ComparabilityReasonSeverity;
+    message: string;
+    /**
+     * v0.7 Prompt 4 addition (additive, optional - existing v0.4
+     * before/after-observation reasons never set these; they already embed
+     * both values in `message`). Used by reference/candidate compatibility
+     * reasons (externalReferenceCompatibility.ts) to expose the two compared
+     * values structurally, not just as prose - e.g. `"one-dark"`/`"one-light"`
+     * for a theme mismatch, or `"480x620"` for a viewport dimension.
+     */
+    referenceValue?: string;
+    candidateValue?: string;
+}
+export interface ComparabilityResult {
+    state: ComparabilityState;
+    reasons: ComparabilityReason[];
+}
+/** `incomparable` requires at least one `blocking` reason; a `blocking` reason forces `incomparable` - the two invariants are enforced together. */
+export declare function isValidComparabilityResult(value: unknown): value is ComparabilityResult;
+export declare const TARGET_CONFIGURATION_CHANGE_KINDS: readonly ["added", "removed", "locator-changed"];
+export type TargetConfigurationChangeKind = (typeof TARGET_CONFIGURATION_CHANGE_KINDS)[number];
+export interface TargetConfigurationChange {
+    kind: TargetConfigurationChangeKind;
+    target: string;
+}
+export declare function isValidTargetConfigurationChange(value: unknown): value is TargetConfigurationChange;
+export declare const DIFFERENCE_KINDS: readonly ["appeared", "disappeared", "moved", "resized", "visibility-changed", "clipping-changed", "containment-changed", "horizontal-overflow-changed", "vertical-overflow-changed", "page-size-changed", "scroll-owner-changed", "relative-position-changed", "relationship-changed"];
+export type DifferenceKind = (typeof DIFFERENCE_KINDS)[number];
+export type ComparisonDifferenceSubject = {
+    type: 'target';
+    target: string;
+} | {
+    type: 'relationship';
+    kind: PairwiseRelationshipKind | PageLevelRelationshipKind;
+    subjectTarget?: string;
+    relatedTarget?: string;
+} | {
+    type: 'page';
+};
+/**
+ * Bounded structured difference record - never prose-only, never a
+ * severity/pass-fail score (there is no severity model yet). `before`/
+ * `after`/`delta` are intentionally untyped here: their shape depends on
+ * `kind` (e.g. numeric geometry for `moved`/`resized`, boolean for
+ * `visibility-changed`) and is validated at the point of construction by
+ * whichever batch actually produces these records.
+ */
+export interface ComparisonDifference {
+    kind: DifferenceKind;
+    subject: ComparisonDifferenceSubject;
+    before: unknown;
+    after: unknown;
+    delta?: unknown;
+    classification: string;
+    beforeObservationId: string;
+    afterObservationId: string;
+    evidence: EvidenceReference[];
+}
+export declare function isValidComparisonDifference(value: unknown): value is ComparisonDifference;
+/** One before/after transition of a single derived relationship - distinct from `ComparisonDifference` so the relationship graph's own vocabulary stays authoritative. `'unavailable'` covers a pair/page relationship that could not be evaluated on one side. */
+export interface RelationshipChangeRecord {
+    scope: 'pairwise' | 'page';
+    kind: PairwiseRelationshipKind | PageLevelRelationshipKind;
+    subjectTarget?: string;
+    relatedTarget?: string;
+    before: PairwiseRelationshipKind | PageLevelRelationshipKind | 'unavailable';
+    after: PairwiseRelationshipKind | PageLevelRelationshipKind | 'unavailable';
+    beforeObservationId: string;
+    afterObservationId: string;
+}
+/**
+ * Enough logical identity to trace a comparison back to its authoritative
+ * source observations without embedding the full ObservationArtifact,
+ * copying screenshot bytes, or persisting a filesystem path as semantic
+ * identity.
+ */
+export interface ComparisonSourceObservationReference {
+    observationId: string;
+    requestId: string;
+    producer: {
+        name: typeof PRODUCER_NAME;
+        version: string;
+    };
+    observationSchemaVersion: typeof OBSERVATION_SCHEMA_VERSION;
+    screenshot: {
+        path: string;
+    };
+}
+export declare function isValidComparisonSourceObservationReference(value: unknown): value is ComparisonSourceObservationReference;
+/** Comparison is ordered: `before`/`after` are distinct fields (never a swappable pair) so `compare(A, B) !== compare(B, A)` for both identity and difference direction. */
+export interface ComparisonArtifact {
+    artifactKind: typeof COMPARISON_ARTIFACT_KIND;
+    schemaVersion: typeof COMPARISON_SCHEMA_VERSION;
+    comparisonId: string;
+    comparisonRequestId: string;
+    producer: {
+        name: typeof PRODUCER_NAME;
+        version: string;
+    };
+    provenance: {
+        comparedAt: string;
+    };
+    before: ComparisonSourceObservationReference;
+    after: ComparisonSourceObservationReference;
+    config: ComparisonConfig;
+    comparability: ComparabilityResult;
+    configurationChanges: TargetConfigurationChange[];
+    relationshipsBefore: LayoutRelationshipGraph;
+    relationshipsAfter: LayoutRelationshipGraph;
+    differences: ComparisonDifference[];
+    relationshipChanges: RelationshipChangeRecord[];
+    expectedDependencyEvidence: ExpectedDependencyEvidence[];
+    diagnostics: Diagnostic[];
+    limits: {
+        truncated: boolean;
+        omittedFields: string[];
+        omittedTargetPairs: string[];
+    };
+}
+export type ComparisonSchemaValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
+/** Structural validator for the frozen ComparisonArtifact contract. Never delegates to `isValidObservationArtifact` - comparison and observation are different artifact kinds/schemas. */
+export declare function isValidComparisonArtifact(value: unknown): ComparisonSchemaValidationResult;

package/dist/domain/comparison.js

@@ -0,0 +1,350 @@
+/**
+ * v0.4 Batch 1 comparison contract. Frozen here as pure
+ * types/constants/structural validators only - comparison is downstream of
+ * observation (real Chromium -> ObservationArtifact -> relationship
+ * derivation -> comparability analysis -> comparison -> ComparisonArtifact,
+ * see docs/ARCHITECTURE.md) and this batch implements neither relationship
+ * derivation, real comparison, nor persistence. Batch 2 owns relationship
+ * derivation; Batch 3 owns `compareObservations()` and comparison
+ * persistence; Batch 4 owns CLI exposure.
+ *
+ * Comparison and observation are different evidence products: this module
+ * never reuses `ARTIFACT_KIND`/`SCHEMA_VERSION` from `./schema.js`, and
+ * `isValidComparisonArtifact` never delegates to `isValidObservationArtifact`.
+ */
+import { PRODUCER_NAME, SCHEMA_VERSION as OBSERVATION_SCHEMA_VERSION } from './schema.js';
+import { DIAGNOSTIC_CODES, DIAGNOSTIC_SEVERITY } from './diagnostics.js';
+import { PAGE_LEVEL_RELATIONSHIP_KINDS, PAIRWISE_RELATIONSHIP_KINDS, isValidEvidenceReference, isValidLayoutRelationshipGraph, isValidGeometryTolerancePx, } from './relationships.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isEvidenceReferenceArray(value) {
+    return Array.isArray(value) && value.every((entry) => isValidEvidenceReference(entry));
+}
+export const COMPARISON_ARTIFACT_KIND = 'my-frontend-observer/comparison';
+export const COMPARISON_SCHEMA_VERSION = '1.0.0';
+/**
+ * Geometry tolerance is owned by domain/relationships.ts (the relationship
+ * derivation engine needs it directly, and that module must not import this
+ * one back - relationships.ts is the lower-level module). Re-exported here
+ * unchanged so every pre-Batch-2 consumer of these names from
+ * domain/comparison.ts keeps working.
+ */
+export { GEOMETRY_TOLERANCE_DEFAULT_PX, GEOMETRY_TOLERANCE_MIN_PX, GEOMETRY_TOLERANCE_MAX_PX, isValidGeometryTolerancePx } from './relationships.js';
+// --- Expected dependency declarations (explicit, non-causal) ---------------
+export const DEPENDENCY_PROPERTIES = ['x', 'y', 'width', 'height'];
+export const DEPENDENCY_DIRECTIONS = ['increase', 'decrease', 'change', 'unchanged'];
+/** The observer never generates a dependency declaration from co-change; every declaration must explicitly identify that it was supplied externally. */
+export const EXPECTED_DEPENDENCY_SOURCES = ['explicit-config'];
+const DEPENDENCY_TARGET_NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
+function isValidDependencyTermDeclaration(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.target !== 'string' || !DEPENDENCY_TARGET_NAME_RE.test(value.target))
+        return false;
+    if (typeof value.property !== 'string' || !DEPENDENCY_PROPERTIES.includes(value.property))
+        return false;
+    return typeof value.direction === 'string' && DEPENDENCY_DIRECTIONS.includes(value.direction);
+}
+export function isValidExpectedDependencyDeclaration(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!isValidDependencyTermDeclaration(value.cause) || !isValidDependencyTermDeclaration(value.effect))
+        return false;
+    return typeof value.source === 'string' && EXPECTED_DEPENDENCY_SOURCES.includes(value.source);
+}
+/**
+ * Non-causal evaluation outcomes only - describes the relationship between a
+ * declared expectation and observed differences, never an implementation
+ * verdict (no PASS/FAIL/approved/regression/allowed/protected vocabulary).
+ */
+export const DEPENDENCY_EVIDENCE_OUTCOMES = ['consistent', 'not-observed', 'contradictory-to-declaration', 'unavailable'];
+export function isValidExpectedDependencyEvidence(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!isValidExpectedDependencyDeclaration(value.declaration))
+        return false;
+    if (typeof value.outcome !== 'string' || !DEPENDENCY_EVIDENCE_OUTCOMES.includes(value.outcome))
+        return false;
+    return isEvidenceReferenceArray(value.supportingEvidence);
+}
+const COMPARISON_CONFIG_KEYS = ['geometryTolerancePx', 'expectedDependencies'];
+export function isValidComparisonConfig(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!Object.keys(value).every((key) => COMPARISON_CONFIG_KEYS.includes(key)))
+        return false;
+    if (!isValidGeometryTolerancePx(value.geometryTolerancePx))
+        return false;
+    if ('expectedDependencies' in value && value.expectedDependencies !== undefined) {
+        if (!Array.isArray(value.expectedDependencies) || !value.expectedDependencies.every((d) => isValidExpectedDependencyDeclaration(d))) {
+            return false;
+        }
+    }
+    return true;
+}
+// --- Comparability -----------------------------------------------------------
+export const COMPARABILITY_STATES = ['comparable', 'comparable-with-warnings', 'incomparable'];
+/**
+ * Hard-incompatibility reason codes are `blocking` (force `incomparable`
+ * unless the repository can prove a dimension cannot be evaluated
+ * reliably); warning-only differences are `warning` (do not by themselves
+ * prevent useful page-level comparison); dimensions the observer does not
+ * yet model (theme/authenticated-state/application-state identity) are
+ * `unassessed` and never claimed identical without evidence.
+ */
+export const COMPARABILITY_REASON_CODES = [
+    'artifact-kind-mismatch',
+    'schema-version-mismatch',
+    'page-url-mismatch',
+    'viewport-mismatch',
+    'viewport-unassessed',
+    'scroll-scenario-mismatch',
+    'browser-engine-mismatch',
+    'producer-version-mismatch',
+    'browser-version-mismatch',
+    'target-set-mismatch',
+    'target-locator-mismatch',
+    'theme-mismatch',
+    'theme-unassessed',
+    'authenticated-state-mismatch',
+    'authenticated-state-unassessed',
+    'application-state-mismatch',
+    'application-state-unassessed',
+];
+/**
+ * v0.7 Prompt 4 additions: `viewport-unassessed` (a reference need not
+ * declare an applicable viewport - see externalReferenceApplicability.ts -
+ * whereas an ObservationArtifact's viewport is always present, so v0.4's own
+ * comparability never needed this variant before), `theme-mismatch`,
+ * `authenticated-state-mismatch`, `application-state-mismatch` (blocking -
+ * these three dimensions are now assessed, not merely unassessed, whenever
+ * explicit state is present on both sides being compared - see
+ * comparisonEngine.ts#assessOptionalComparabilityDimension). The
+ * corresponding `-unassessed` variants are unchanged and still apply
+ * whenever explicit state is missing from either side.
+ */
+export const COMPARABILITY_REASON_SEVERITY = {
+    'artifact-kind-mismatch': 'blocking',
+    'schema-version-mismatch': 'blocking',
+    'page-url-mismatch': 'blocking',
+    'viewport-mismatch': 'blocking',
+    'viewport-unassessed': 'unassessed',
+    'scroll-scenario-mismatch': 'blocking',
+    'browser-engine-mismatch': 'blocking',
+    'producer-version-mismatch': 'warning',
+    'browser-version-mismatch': 'warning',
+    'target-set-mismatch': 'warning',
+    'target-locator-mismatch': 'warning',
+    'theme-mismatch': 'blocking',
+    'theme-unassessed': 'unassessed',
+    'authenticated-state-mismatch': 'blocking',
+    'authenticated-state-unassessed': 'unassessed',
+    'application-state-mismatch': 'blocking',
+    'application-state-unassessed': 'unassessed',
+};
+function isValidComparabilityReason(value) {
+    if (!isPlainObject(value))
+        return false;
+    const code = value.code;
+    if (typeof code !== 'string' || !COMPARABILITY_REASON_CODES.includes(code))
+        return false;
+    if (value.severity !== COMPARABILITY_REASON_SEVERITY[code])
+        return false;
+    if (typeof value.message !== 'string')
+        return false;
+    if ('referenceValue' in value && value.referenceValue !== undefined && typeof value.referenceValue !== 'string')
+        return false;
+    if ('candidateValue' in value && value.candidateValue !== undefined && typeof value.candidateValue !== 'string')
+        return false;
+    return true;
+}
+/** `incomparable` requires at least one `blocking` reason; a `blocking` reason forces `incomparable` - the two invariants are enforced together. */
+export function isValidComparabilityResult(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.state !== 'string' || !COMPARABILITY_STATES.includes(value.state))
+        return false;
+    if (!Array.isArray(value.reasons) || !value.reasons.every((r) => isValidComparabilityReason(r)))
+        return false;
+    const reasons = value.reasons;
+    const hasBlocking = reasons.some((r) => r.severity === 'blocking');
+    if (value.state === 'incomparable' && !hasBlocking)
+        return false;
+    if (value.state !== 'incomparable' && hasBlocking)
+        return false;
+    return true;
+}
+// --- Target-configuration change (never conflated with appeared/disappeared) --
+export const TARGET_CONFIGURATION_CHANGE_KINDS = ['added', 'removed', 'locator-changed'];
+export function isValidTargetConfigurationChange(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.kind !== 'string' || !TARGET_CONFIGURATION_CHANGE_KINDS.includes(value.kind))
+        return false;
+    return typeof value.target === 'string' && value.target.length > 0;
+}
+// --- Difference vocabulary ---------------------------------------------------
+export const DIFFERENCE_KINDS = [
+    'appeared',
+    'disappeared',
+    'moved',
+    'resized',
+    'visibility-changed',
+    'clipping-changed',
+    'containment-changed',
+    'horizontal-overflow-changed',
+    'vertical-overflow-changed',
+    'page-size-changed',
+    'scroll-owner-changed',
+    'relative-position-changed',
+    'relationship-changed',
+];
+function isValidComparisonDifferenceSubject(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.type === 'target')
+        return typeof value.target === 'string' && value.target.length > 0;
+    if (value.type === 'page')
+        return Object.keys(value).length === 1;
+    if (value.type === 'relationship') {
+        const allKinds = [...PAIRWISE_RELATIONSHIP_KINDS, ...PAGE_LEVEL_RELATIONSHIP_KINDS];
+        if (typeof value.kind !== 'string' || !allKinds.includes(value.kind))
+            return false;
+        if ('subjectTarget' in value && value.subjectTarget !== undefined && typeof value.subjectTarget !== 'string')
+            return false;
+        if ('relatedTarget' in value && value.relatedTarget !== undefined && typeof value.relatedTarget !== 'string')
+            return false;
+        return true;
+    }
+    return false;
+}
+export function isValidComparisonDifference(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.kind !== 'string' || !DIFFERENCE_KINDS.includes(value.kind))
+        return false;
+    if (!isValidComparisonDifferenceSubject(value.subject))
+        return false;
+    if (!('before' in value) || !('after' in value))
+        return false;
+    if (typeof value.classification !== 'string' || value.classification.length === 0)
+        return false;
+    if (typeof value.beforeObservationId !== 'string' || value.beforeObservationId.length === 0)
+        return false;
+    if (typeof value.afterObservationId !== 'string' || value.afterObservationId.length === 0)
+        return false;
+    return isEvidenceReferenceArray(value.evidence);
+}
+function isValidRelationshipChangeRecord(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.scope !== 'pairwise' && value.scope !== 'page')
+        return false;
+    const allKinds = [...PAIRWISE_RELATIONSHIP_KINDS, ...PAGE_LEVEL_RELATIONSHIP_KINDS];
+    const allValues = [...allKinds, 'unavailable'];
+    if (typeof value.kind !== 'string' || !allKinds.includes(value.kind))
+        return false;
+    if (value.scope === 'pairwise') {
+        if (typeof value.subjectTarget !== 'string' || value.subjectTarget.length === 0)
+            return false;
+        if (typeof value.relatedTarget !== 'string' || value.relatedTarget.length === 0)
+            return false;
+    }
+    else if ('subjectTarget' in value || 'relatedTarget' in value) {
+        return false;
+    }
+    if (typeof value.before !== 'string' || !allValues.includes(value.before))
+        return false;
+    if (typeof value.after !== 'string' || !allValues.includes(value.after))
+        return false;
+    if (typeof value.beforeObservationId !== 'string' || value.beforeObservationId.length === 0)
+        return false;
+    return typeof value.afterObservationId === 'string' && value.afterObservationId.length > 0;
+}
+export function isValidComparisonSourceObservationReference(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (typeof value.observationId !== 'string' || value.observationId.length === 0)
+        return false;
+    if (typeof value.requestId !== 'string' || value.requestId.length === 0)
+        return false;
+    if (!isPlainObject(value.producer) || value.producer.name !== PRODUCER_NAME || typeof value.producer.version !== 'string' || value.producer.version.length === 0) {
+        return false;
+    }
+    if (value.observationSchemaVersion !== OBSERVATION_SCHEMA_VERSION)
+        return false;
+    return isPlainObject(value.screenshot) && typeof value.screenshot.path === 'string' && value.screenshot.path.length > 0;
+}
+function isValidDiagnostic(value) {
+    if (!isPlainObject(value))
+        return false;
+    const code = value.code;
+    if (typeof code !== 'string' || !DIAGNOSTIC_CODES.includes(code))
+        return false;
+    if (value.severity !== DIAGNOSTIC_SEVERITY[code])
+        return false;
+    if (typeof value.message !== 'string')
+        return false;
+    if ('targetName' in value && value.targetName !== undefined && typeof value.targetName !== 'string')
+        return false;
+    return true;
+}
+/** Structural validator for the frozen ComparisonArtifact contract. Never delegates to `isValidObservationArtifact` - comparison and observation are different artifact kinds/schemas. */
+export function isValidComparisonArtifact(value) {
+    if (!isPlainObject(value))
+        return { valid: false, reason: 'artifact must be an object' };
+    if (value.artifactKind !== COMPARISON_ARTIFACT_KIND)
+        return { valid: false, reason: 'artifactKind mismatch' };
+    if (value.schemaVersion !== COMPARISON_SCHEMA_VERSION)
+        return { valid: false, reason: 'schemaVersion mismatch' };
+    if (typeof value.comparisonId !== 'string' || value.comparisonId.length === 0)
+        return { valid: false, reason: 'comparisonId must be a non-empty string' };
+    if (typeof value.comparisonRequestId !== 'string' || value.comparisonRequestId.length === 0) {
+        return { valid: false, reason: 'comparisonRequestId must be a non-empty string' };
+    }
+    if (!isPlainObject(value.producer) || value.producer.name !== PRODUCER_NAME || typeof value.producer.version !== 'string' || value.producer.version.length === 0) {
+        return { valid: false, reason: 'producer must be { name: "my-frontend-observer", version: string }' };
+    }
+    if (!isPlainObject(value.provenance) || typeof value.provenance.comparedAt !== 'string' || value.provenance.comparedAt.length === 0) {
+        return { valid: false, reason: 'provenance.comparedAt must be a non-empty string' };
+    }
+    if (!isValidComparisonSourceObservationReference(value.before))
+        return { valid: false, reason: 'before source observation reference is invalid' };
+    if (!isValidComparisonSourceObservationReference(value.after))
+        return { valid: false, reason: 'after source observation reference is invalid' };
+    if (!isValidComparisonConfig(value.config))
+        return { valid: false, reason: 'config is invalid' };
+    if (!isValidComparabilityResult(value.comparability))
+        return { valid: false, reason: 'comparability is invalid' };
+    if (!Array.isArray(value.configurationChanges) || !value.configurationChanges.every((c) => isValidTargetConfigurationChange(c))) {
+        return { valid: false, reason: 'configurationChanges must be an array of valid TargetConfigurationChange values' };
+    }
+    if (!isValidLayoutRelationshipGraph(value.relationshipsBefore))
+        return { valid: false, reason: 'relationshipsBefore is invalid' };
+    if (!isValidLayoutRelationshipGraph(value.relationshipsAfter))
+        return { valid: false, reason: 'relationshipsAfter is invalid' };
+    if (!Array.isArray(value.differences) || !value.differences.every((d) => isValidComparisonDifference(d))) {
+        return { valid: false, reason: 'differences must be an array of valid ComparisonDifference values' };
+    }
+    if (!Array.isArray(value.relationshipChanges) || !value.relationshipChanges.every((r) => isValidRelationshipChangeRecord(r))) {
+        return { valid: false, reason: 'relationshipChanges must be an array of valid RelationshipChangeRecord values' };
+    }
+    if (!Array.isArray(value.expectedDependencyEvidence) || !value.expectedDependencyEvidence.every((e) => isValidExpectedDependencyEvidence(e))) {
+        return { valid: false, reason: 'expectedDependencyEvidence must be an array of valid ExpectedDependencyEvidence values' };
+    }
+    if (!Array.isArray(value.diagnostics) || !value.diagnostics.every((d) => isValidDiagnostic(d))) {
+        return { valid: false, reason: 'diagnostics must be an array of valid Diagnostic values' };
+    }
+    const limits = value.limits;
+    if (!isPlainObject(limits) ||
+        typeof limits.truncated !== 'boolean' ||
+        !Array.isArray(limits.omittedFields) ||
+        !limits.omittedFields.every((f) => typeof f === 'string') ||
+        !Array.isArray(limits.omittedTargetPairs) ||
+        !limits.omittedTargetPairs.every((f) => typeof f === 'string')) {
+        return { valid: false, reason: 'limits must be { truncated: boolean; omittedFields: string[]; omittedTargetPairs: string[] }' };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=comparison.js.map

package/dist/domain/comparison.js.map

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