@dailephd/my-frontend-observer 0.8.1

package/dist/artifacts/frontendContractArtifactReader.d.ts

@@ -0,0 +1,24 @@
+import type { PersistentBaselineContract, PerChangeContract } from '../domain/frontendContracts.js';
+export type ReadPersistentBaselineContractResult = {
+    ok: true;
+    contract: PersistentBaselineContract;
+} | {
+    ok: false;
+    reason: string;
+};
+export type ReadPerChangeContractResult = {
+    ok: true;
+    contract: PerChangeContract;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Narrow canonical reader counterpart to `frontendContractArtifactWriter.ts#writePersistentBaselineContract`:
+ * reads one `manifest.json`, parses it, and validates it through the same
+ * `isValidPersistentBaselineContract` structural gate the writer uses - never
+ * a second validator, never a schema upgrade, never a guessed missing field.
+ */
+export declare function readPersistentBaselineContract(manifestPath: string): Promise<ReadPersistentBaselineContractResult>;
+/** Narrow canonical reader counterpart to `frontendContractArtifactWriter.ts#writePerChangeContract`. */
+export declare function readPerChangeContract(manifestPath: string): Promise<ReadPerChangeContractResult>;

package/dist/artifacts/frontendContractArtifactReader.js

@@ -0,0 +1,47 @@
+import { readFile } from 'node:fs/promises';
+import { isValidPersistentBaselineContract, isValidPerChangeContract } from '../domain/frontendContracts.js';
+async function readJson(manifestPath) {
+    let raw;
+    try {
+        raw = await readFile(manifestPath, 'utf8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `failed to read artifact manifest at "${manifestPath}": ${message}` };
+    }
+    try {
+        return { ok: true, value: JSON.parse(raw) };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `artifact manifest at "${manifestPath}" is not valid JSON: ${message}` };
+    }
+}
+/**
+ * Narrow canonical reader counterpart to `frontendContractArtifactWriter.ts#writePersistentBaselineContract`:
+ * reads one `manifest.json`, parses it, and validates it through the same
+ * `isValidPersistentBaselineContract` structural gate the writer uses - never
+ * a second validator, never a schema upgrade, never a guessed missing field.
+ */
+export async function readPersistentBaselineContract(manifestPath) {
+    const parsed = await readJson(manifestPath);
+    if (!parsed.ok)
+        return parsed;
+    const validation = isValidPersistentBaselineContract(parsed.value);
+    if (!validation.valid) {
+        return { ok: false, reason: `baseline contract manifest at "${manifestPath}" failed structural validation: ${validation.reason}` };
+    }
+    return { ok: true, contract: parsed.value };
+}
+/** Narrow canonical reader counterpart to `frontendContractArtifactWriter.ts#writePerChangeContract`. */
+export async function readPerChangeContract(manifestPath) {
+    const parsed = await readJson(manifestPath);
+    if (!parsed.ok)
+        return parsed;
+    const validation = isValidPerChangeContract(parsed.value);
+    if (!validation.valid) {
+        return { ok: false, reason: `per-change contract manifest at "${manifestPath}" failed structural validation: ${validation.reason}` };
+    }
+    return { ok: true, contract: parsed.value };
+}
+//# sourceMappingURL=frontendContractArtifactReader.js.map

package/dist/artifacts/frontendContractArtifactReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontendContractArtifactReader.js","sourceRoot":"","sources":["../../src/artifacts/frontendContractArtifactReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAK7G,KAAK,UAAU,QAAQ,CAAC,YAAoB;IAC1C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,YAAY,MAAM,OAAO,EAAE,EAAE,CAAC;IACpG,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,YAAY,wBAAwB,OAAO,EAAE,EAAE,CAAC;IACvG,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,YAAoB;IACvE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,iCAAiC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kCAAkC,YAAY,mCAAmC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;IACrI,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAmC,EAAE,CAAC;AAC5E,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,YAAoB;IAC9D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,YAAY,mCAAmC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;IACvI,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,KAA0B,EAAE,CAAC;AACnE,CAAC"}

package/dist/artifacts/frontendContractArtifactWriter.d.ts

@@ -0,0 +1,34 @@
+import type { PersistentBaselineContract, PerChangeContract } from '../domain/frontendContracts.js';
+import type { Diagnostic } from '../domain/diagnostics.js';
+export declare const FRONTEND_CONTRACT_MANIFEST_FILENAME = "manifest.json";
+/**
+ * Mirrors `PersistedComparisonResult`'s shape/semantics - a frontend contract
+ * directory has no screenshot file either, and this writer never touches
+ * `artifacts/artifactWriter.ts` or `artifacts/comparisonArtifactWriter.ts`.
+ */
+export type PersistedFrontendContractResult = {
+    ok: true;
+    artifactRoot: string;
+    manifestPath: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+export interface WriteFrontendContractArtifactOptions {
+    /** Base directory that `outputLocation` is resolved against. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Persists one already-valid `PersistentBaselineContract` as
+ * `<outputLocation>/<baselineId>/manifest.json`. Never mutates or removes any
+ * other baseline artifact - `supersedesBaselineId` (if present) is written
+ * exactly as supplied; this writer never inspects, rewrites, or deletes the
+ * baseline it refers to.
+ */
+export declare function writePersistentBaselineContract(contract: PersistentBaselineContract, outputLocation: string, options?: WriteFrontendContractArtifactOptions): Promise<PersistedFrontendContractResult>;
+/**
+ * Persists one already-valid `PerChangeContract` as
+ * `<outputLocation>/<contractId>/manifest.json`, symmetric with baseline
+ * persistence above (both share `CONTRACT_ARTIFACT_KIND`/`CONTRACT_SCHEMA_VERSION`).
+ */
+export declare function writePerChangeContract(contract: PerChangeContract, outputLocation: string, options?: WriteFrontendContractArtifactOptions): Promise<PersistedFrontendContractResult>;

package/dist/artifacts/frontendContractArtifactWriter.js

@@ -0,0 +1,70 @@
+import { mkdir, writeFile, rename, rm, access } from 'node:fs/promises';
+import path from 'node:path';
+import { isValidPersistentBaselineContract, isValidPerChangeContract } from '../domain/frontendContracts.js';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+export const FRONTEND_CONTRACT_MANIFEST_FILENAME = 'manifest.json';
+function writeFailure(message, details) {
+    const diagnostic = {
+        code: 'artifact-write-failure',
+        severity: DIAGNOSTIC_SEVERITY['artifact-write-failure'],
+        message,
+        ...(details === undefined ? {} : { details }),
+    };
+    return { ok: false, diagnostics: [diagnostic] };
+}
+async function pathExists(candidate) {
+    return access(candidate).then(() => true, () => false);
+}
+/**
+ * Shared atomic-write body for both contract classes, following the same
+ * discipline as `writeObservationArtifact`/`writeComparisonArtifact`: sibling
+ * temporary directory, single `manifest.json`, then one atomic rename. An
+ * existing directory at the final identity is a genuine collision (never a
+ * destructive overwrite of prior baseline/contract history) and is rejected.
+ */
+async function writeContractArtifact(value, id, kindLabel, outputLocation, options) {
+    const cwd = options.cwd ?? process.cwd();
+    const outputRoot = path.resolve(cwd, outputLocation);
+    const finalRoot = path.join(outputRoot, id);
+    const tempRoot = path.join(outputRoot, `.tmp-${id}`);
+    if (await pathExists(finalRoot)) {
+        return writeFailure(`a ${kindLabel} artifact already exists at "${id}"; refusing to overwrite it`, { artifactRoot: finalRoot });
+    }
+    try {
+        await rm(tempRoot, { recursive: true, force: true });
+        await mkdir(tempRoot, { recursive: true });
+        await writeFile(path.join(tempRoot, FRONTEND_CONTRACT_MANIFEST_FILENAME), JSON.stringify(value, null, 2), 'utf8');
+        await rename(tempRoot, finalRoot);
+        return { ok: true, artifactRoot: finalRoot, manifestPath: path.join(finalRoot, FRONTEND_CONTRACT_MANIFEST_FILENAME) };
+    }
+    catch (err) {
+        await rm(tempRoot, { recursive: true, force: true }).catch(() => undefined);
+        const message = err instanceof Error ? err.message : String(err);
+        return writeFailure(`failed to persist ${kindLabel} artifact: ${message}`);
+    }
+}
+/**
+ * Persists one already-valid `PersistentBaselineContract` as
+ * `<outputLocation>/<baselineId>/manifest.json`. Never mutates or removes any
+ * other baseline artifact - `supersedesBaselineId` (if present) is written
+ * exactly as supplied; this writer never inspects, rewrites, or deletes the
+ * baseline it refers to.
+ */
+export async function writePersistentBaselineContract(contract, outputLocation, options = {}) {
+    const validation = isValidPersistentBaselineContract(contract);
+    if (!validation.valid)
+        return writeFailure(`refusing to persist an invalid PersistentBaselineContract: ${validation.reason}`);
+    return writeContractArtifact(contract, contract.baselineId, 'baseline contract', outputLocation, options);
+}
+/**
+ * Persists one already-valid `PerChangeContract` as
+ * `<outputLocation>/<contractId>/manifest.json`, symmetric with baseline
+ * persistence above (both share `CONTRACT_ARTIFACT_KIND`/`CONTRACT_SCHEMA_VERSION`).
+ */
+export async function writePerChangeContract(contract, outputLocation, options = {}) {
+    const validation = isValidPerChangeContract(contract);
+    if (!validation.valid)
+        return writeFailure(`refusing to persist an invalid PerChangeContract: ${validation.reason}`);
+    return writeContractArtifact(contract, contract.contractId, 'per-change contract', outputLocation, options);
+}
+//# sourceMappingURL=frontendContractArtifactWriter.js.map

package/dist/artifacts/frontendContractArtifactWriter.js.map

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

package/dist/artifacts/frontendContractEvaluationArtifactReader.d.ts

@@ -0,0 +1,17 @@
+import type { FrontendContractEvaluationArtifact } from '../domain/frontendContractEvaluationArtifact.js';
+export type ReadFrontendContractEvaluationArtifactResult = {
+    ok: true;
+    artifact: FrontendContractEvaluationArtifact;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Narrow canonical reader counterpart to
+ * `frontendContractEvaluationArtifactWriter.ts#writeFrontendContractEvaluationArtifact`:
+ * reads one `manifest.json`, parses it, and validates it through the same
+ * `isValidFrontendContractEvaluationArtifact` structural gate the writer
+ * uses. Read-only: never mutates the file, never recomputes or reinterprets
+ * the evaluation, never repairs a malformed artifact.
+ */
+export declare function readFrontendContractEvaluationArtifact(manifestPath: string): Promise<ReadFrontendContractEvaluationArtifactResult>;

package/dist/artifacts/frontendContractEvaluationArtifactReader.js

@@ -0,0 +1,34 @@
+import { readFile } from 'node:fs/promises';
+import { isValidFrontendContractEvaluationArtifact } from '../domain/frontendContractEvaluationArtifact.js';
+/**
+ * Narrow canonical reader counterpart to
+ * `frontendContractEvaluationArtifactWriter.ts#writeFrontendContractEvaluationArtifact`:
+ * reads one `manifest.json`, parses it, and validates it through the same
+ * `isValidFrontendContractEvaluationArtifact` structural gate the writer
+ * uses. Read-only: never mutates the file, never recomputes or reinterprets
+ * the evaluation, never repairs a malformed artifact.
+ */
+export async function readFrontendContractEvaluationArtifact(manifestPath) {
+    let raw;
+    try {
+        raw = await readFile(manifestPath, 'utf8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `failed to read evaluation artifact manifest at "${manifestPath}": ${message}` };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, reason: `evaluation artifact manifest at "${manifestPath}" is not valid JSON: ${message}` };
+    }
+    const validation = isValidFrontendContractEvaluationArtifact(parsed);
+    if (!validation.valid) {
+        return { ok: false, reason: `evaluation artifact manifest at "${manifestPath}" failed structural validation: ${validation.reason}` };
+    }
+    return { ok: true, artifact: parsed };
+}
+//# sourceMappingURL=frontendContractEvaluationArtifactReader.js.map

package/dist/artifacts/frontendContractEvaluationArtifactReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontendContractEvaluationArtifactReader.js","sourceRoot":"","sources":["../../src/artifacts/frontendContractEvaluationArtifactReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,yCAAyC,EAAE,MAAM,iDAAiD,CAAC;AAI5G;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAAC,YAAoB;IAC/E,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mDAAmD,YAAY,MAAM,OAAO,EAAE,EAAE,CAAC;IAC/G,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,YAAY,wBAAwB,OAAO,EAAE,EAAE,CAAC;IAClH,CAAC;IAED,MAAM,UAAU,GAAG,yCAAyC,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,YAAY,mCAAmC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;IACvI,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAA4C,EAAE,CAAC;AAC9E,CAAC"}

package/dist/artifacts/frontendContractEvaluationArtifactWriter.d.ts

@@ -0,0 +1,32 @@
+import type { FrontendContractEvaluationArtifact } from '../domain/frontendContractEvaluationArtifact.js';
+import type { Diagnostic } from '../domain/diagnostics.js';
+export declare const EVALUATION_MANIFEST_FILENAME = "manifest.json";
+export type PersistedFrontendContractEvaluationResult = {
+    ok: true;
+    artifactRoot: string;
+    manifestPath: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+export interface WriteFrontendContractEvaluationArtifactOptions {
+    /** Base directory that `outputLocation` is resolved against. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Persists one already-built, already-valid `FrontendContractEvaluationArtifact`
+ * as `<outputLocation>/<evaluationId>/manifest.json` only - no screenshot is
+ * copied (the artifact's `before`/`after` fields already point back to the
+ * source observations). Same atomic-write discipline as
+ * `artifactWriter.ts#writeObservationArtifact`/`comparisonArtifactWriter.ts#writeComparisonArtifact`
+ * without sharing their implementation: sibling temporary directory, then one
+ * atomic rename. `evaluationId` is fresh per execution (see
+ * `frontendContractIdentity.ts#buildFrontendContractInstanceIdentity`), so an
+ * existing directory at the final path is a genuine collision and is
+ * rejected rather than overwritten - a legitimate PASS or FAIL evaluation
+ * result is never silently replaced. A `FAIL` verdict is a legitimate,
+ * persistable evaluation result, not a write failure; only an unpersistable
+ * artifact (invalid shape, or a real filesystem error) is reported as
+ * `ok: false`.
+ */
+export declare function writeFrontendContractEvaluationArtifact(artifact: FrontendContractEvaluationArtifact, outputLocation: string, options?: WriteFrontendContractEvaluationArtifactOptions): Promise<PersistedFrontendContractEvaluationResult>;

package/dist/artifacts/frontendContractEvaluationArtifactWriter.js

@@ -0,0 +1,58 @@
+import { mkdir, writeFile, rename, rm, access } from 'node:fs/promises';
+import path from 'node:path';
+import { isValidFrontendContractEvaluationArtifact } from '../domain/frontendContractEvaluationArtifact.js';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+export const EVALUATION_MANIFEST_FILENAME = 'manifest.json';
+function writeFailure(message, details) {
+    const diagnostic = {
+        code: 'artifact-write-failure',
+        severity: DIAGNOSTIC_SEVERITY['artifact-write-failure'],
+        message,
+        ...(details === undefined ? {} : { details }),
+    };
+    return { ok: false, diagnostics: [diagnostic] };
+}
+async function pathExists(candidate) {
+    return access(candidate).then(() => true, () => false);
+}
+/**
+ * Persists one already-built, already-valid `FrontendContractEvaluationArtifact`
+ * as `<outputLocation>/<evaluationId>/manifest.json` only - no screenshot is
+ * copied (the artifact's `before`/`after` fields already point back to the
+ * source observations). Same atomic-write discipline as
+ * `artifactWriter.ts#writeObservationArtifact`/`comparisonArtifactWriter.ts#writeComparisonArtifact`
+ * without sharing their implementation: sibling temporary directory, then one
+ * atomic rename. `evaluationId` is fresh per execution (see
+ * `frontendContractIdentity.ts#buildFrontendContractInstanceIdentity`), so an
+ * existing directory at the final path is a genuine collision and is
+ * rejected rather than overwritten - a legitimate PASS or FAIL evaluation
+ * result is never silently replaced. A `FAIL` verdict is a legitimate,
+ * persistable evaluation result, not a write failure; only an unpersistable
+ * artifact (invalid shape, or a real filesystem error) is reported as
+ * `ok: false`.
+ */
+export async function writeFrontendContractEvaluationArtifact(artifact, outputLocation, options = {}) {
+    const validation = isValidFrontendContractEvaluationArtifact(artifact);
+    if (!validation.valid)
+        return writeFailure(`refusing to persist an invalid FrontendContractEvaluationArtifact: ${validation.reason}`);
+    const cwd = options.cwd ?? process.cwd();
+    const outputRoot = path.resolve(cwd, outputLocation);
+    const finalRoot = path.join(outputRoot, artifact.evaluationId);
+    const tempRoot = path.join(outputRoot, `.tmp-${artifact.evaluationId}`);
+    if (await pathExists(finalRoot)) {
+        return writeFailure(`an evaluation artifact already exists at "${artifact.evaluationId}"; refusing to overwrite it`, { artifactRoot: finalRoot });
+    }
+    try {
+        await rm(tempRoot, { recursive: true, force: true });
+        await mkdir(tempRoot, { recursive: true });
+        await writeFile(path.join(tempRoot, EVALUATION_MANIFEST_FILENAME), JSON.stringify(artifact, null, 2), 'utf8');
+        await rename(tempRoot, finalRoot);
+        return { ok: true, artifactRoot: finalRoot, manifestPath: path.join(finalRoot, EVALUATION_MANIFEST_FILENAME) };
+    }
+    catch (err) {
+        await rm(tempRoot, { recursive: true, force: true }).catch(() => undefined);
+        const message = err instanceof Error ? err.message : String(err);
+        return writeFailure(`failed to persist evaluation artifact: ${message}`);
+    }
+}
+//# sourceMappingURL=frontendContractEvaluationArtifactWriter.js.map

package/dist/artifacts/frontendContractEvaluationArtifactWriter.js.map

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

package/dist/artifacts/types.d.ts

@@ -0,0 +1,17 @@
+import type { Diagnostic } from '../domain/diagnostics.js';
+/**
+ * Observer-owned result of persisting one ObservationArtifact. `artifactRoot`
+ * and the file paths are absolute filesystem paths for the *caller's* local
+ * use only (e.g. to print or open the result); they are never written back
+ * into the persisted manifest itself, which stores only portable relative
+ * references.
+ */
+export type PersistedObservationResult = {
+    ok: true;
+    artifactRoot: string;
+    manifestPath: string;
+    screenshotPath: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};

package/dist/artifacts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":""}

package/dist/browser/chromiumAdapter.d.ts

@@ -0,0 +1,21 @@
+import type { NormalizedObservationRequest } from '../request/request.js';
+import type { BrowserCaptureResult } from './types.js';
+export type { BrowserCaptureResult, BrowserProvenance } from './types.js';
+export interface CaptureViewportInternalResult {
+    result: BrowserCaptureResult;
+    /** True if the launched browser process is still connected after cleanup ran. Always false unless cleanup failed. */
+    browserConnected: boolean;
+}
+/**
+ * Owns the entire launch -> context -> page -> navigate -> ready -> screenshot
+ * -> close lifecycle for one capture. Guarantees `browser.close()` runs on
+ * every exit path (success, safety rejection, navigation/readiness failure,
+ * or an unexpected internal error), so callers never manage cleanup
+ * themselves. Exported (not re-exported from src/index.ts or the application
+ * seam) only so integration tests can assert `browserConnected` becomes
+ * false after every call - the Browser handle itself never leaves this
+ * module.
+ */
+export declare function captureViewportInternal(request: NormalizedObservationRequest): Promise<CaptureViewportInternalResult>;
+/** Observer-facing entrypoint: no Playwright object is reachable from its signature or return value. */
+export declare function captureViewport(request: NormalizedObservationRequest): Promise<BrowserCaptureResult>;

package/dist/browser/chromiumAdapter.js

@@ -0,0 +1,204 @@
+import { chromium } from 'playwright';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+import { classifyUrl, classifyRedirect, classifySubresource, classifyPopup, classifyDownload } from '../safety/policy.js';
+import { capturePageEvidence, captureTargetEvidence, resolveConfiguredTargets, findResolvedTarget } from './evidenceCapture.js';
+import { captureScrollRuntimeSnapshot, performWindowScrollBy, performTargetScrollBy, waitTwoAnimationFrames } from './scrollCapture.js';
+import { deriveScrollScenarioTransition, deriveScrollOwner } from '../domain/scrollEvidence.js';
+function diagnostic(code, message) {
+    return { code, severity: DIAGNOSTIC_SEVERITY[code], message };
+}
+function classifyNavigationError(error, readinessTimeoutMs) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (/timeout/i.test(message)) {
+        return diagnostic('readiness-timeout', `readiness condition not reached within ${readinessTimeoutMs}ms: ${message}`);
+    }
+    return diagnostic('navigation-failure', `navigation failed: ${message}`);
+}
+/**
+ * Owns the entire launch -> context -> page -> navigate -> ready -> screenshot
+ * -> close lifecycle for one capture. Guarantees `browser.close()` runs on
+ * every exit path (success, safety rejection, navigation/readiness failure,
+ * or an unexpected internal error), so callers never manage cleanup
+ * themselves. Exported (not re-exported from src/index.ts or the application
+ * seam) only so integration tests can assert `browserConnected` becomes
+ * false after every call - the Browser handle itself never leaves this
+ * module.
+ */
+export async function captureViewportInternal(request) {
+    const initialDecision = classifyUrl(request.targetUrl);
+    if (!initialDecision.allowed) {
+        return { result: { ok: false, diagnostics: [initialDecision.diagnostic] }, browserConnected: false };
+    }
+    let browser;
+    let result;
+    try {
+        browser = await chromium.launch({ headless: true });
+        const context = await browser.newContext({
+            viewport: { width: request.viewport.width, height: request.viewport.height },
+        });
+        const page = await context.newPage();
+        const diagnostics = [];
+        page.on('popup', () => diagnostics.push(classifyPopup()));
+        page.on('download', () => diagnostics.push(classifyDownload()));
+        let lastAllowedMainFrameUrl = request.targetUrl;
+        let rejection;
+        await page.route('**/*', async (route) => {
+            const req = route.request();
+            const url = req.url();
+            const isMainFrameNavigation = req.isNavigationRequest() && req.frame() === page.mainFrame();
+            if (!isMainFrameNavigation) {
+                const decision = classifySubresource(url);
+                if (!decision.allowed) {
+                    rejection = rejection ?? decision.diagnostic;
+                    await route.abort('blockedbyclient').catch(() => undefined);
+                    return;
+                }
+                await route.continue().catch(() => undefined);
+                return;
+            }
+            // Chromium follows navigation redirects internally without re-emitting a
+            // routable request per hop, so each main-frame hop is fetched manually
+            // (maxRedirects: 0) and inspected here before any further hop is
+            // allowed to proceed - this is what lets a prohibited redirect target
+            // be blocked before it is ever contacted.
+            const decision = url === lastAllowedMainFrameUrl ? { allowed: true } : classifyRedirect(lastAllowedMainFrameUrl, url);
+            if (!decision.allowed) {
+                rejection = rejection ?? decision.diagnostic;
+                await route.fulfill({ status: 204, body: '' }).catch(() => undefined);
+                return;
+            }
+            lastAllowedMainFrameUrl = url;
+            let response;
+            try {
+                response = await route.fetch({ maxRedirects: 0 });
+            }
+            catch {
+                await route.abort('failed').catch(() => undefined);
+                return;
+            }
+            const status = response.status();
+            if (status >= 300 && status < 400) {
+                const location = response.headers()['location'];
+                const resolvedUrl = location ? new URL(location, url).toString() : undefined;
+                const redirectDecision = resolvedUrl ? classifyRedirect(lastAllowedMainFrameUrl, resolvedUrl) : { allowed: true };
+                if (!redirectDecision.allowed) {
+                    rejection = rejection ?? redirectDecision.diagnostic;
+                    await route.fulfill({ status: 204, body: '' }).catch(() => undefined);
+                    return;
+                }
+            }
+            await route.fulfill({ response }).catch(() => undefined);
+        });
+        let navigationError;
+        try {
+            await page.goto(request.targetUrl, {
+                waitUntil: request.readiness.condition,
+                timeout: request.readiness.timeoutMs,
+            });
+        }
+        catch (err) {
+            navigationError = err;
+        }
+        if (rejection) {
+            result = { ok: false, diagnostics: [rejection, ...diagnostics] };
+        }
+        else if (navigationError) {
+            result = { ok: false, diagnostics: [...diagnostics, classifyNavigationError(navigationError, request.readiness.timeoutMs)] };
+        }
+        else {
+            // v0.3 Batch 2/3: for a scenario request, resolve configured targets
+            // exactly once (reusing the same canonical resolveConfiguredTargets
+            // algorithm captureTargetEvidence uses below), capture the initial
+            // runtime snapshot, perform the one immediate scroll action (window or
+            // the uniquely-resolved action target - same two-animation-frame
+            // stabilization either way), and capture the final runtime snapshot -
+            // all before the screenshot and ordinary page/target evidence below,
+            // so every one of those downstream captures describes only the final
+            // post-action state. No second navigation, page, or observation ever
+            // happens.
+            let scrollScenarioEvidence;
+            if (request.scrollScenario) {
+                const action = request.scrollScenario.action;
+                const resolvedForScenario = await resolveConfiguredTargets(page, request.targets);
+                try {
+                    const initial = await captureScrollRuntimeSnapshot(page, resolvedForScenario, request.viewport);
+                    if (action.kind === 'window-scroll-by') {
+                        await performWindowScrollBy(page, action.deltaX, action.deltaY);
+                    }
+                    else {
+                        const actionTarget = findResolvedTarget(resolvedForScenario, action.target);
+                        if (actionTarget?.status === 'matched' && actionTarget.handle) {
+                            await performTargetScrollBy(actionTarget.handle, action.deltaX, action.deltaY);
+                        }
+                        // else: the configured action target could not be uniquely
+                        // resolved at runtime (not-found/ambiguous/unavailable) - no
+                        // scroll is performed and no movement is fabricated. The
+                        // existing target-missing/target-ambiguous/target-hidden/
+                        // browser-evidence-unavailable diagnostic for this same target
+                        // name still surfaces below from the ordinary
+                        // captureTargetEvidence pass, so the unresolved action target
+                        // remains honestly explained rather than silently ignored.
+                    }
+                    await waitTwoAnimationFrames(page);
+                    const final = await captureScrollRuntimeSnapshot(page, resolvedForScenario, request.viewport);
+                    const transition = deriveScrollScenarioTransition(initial, final);
+                    const scrollOwner = deriveScrollOwner(transition);
+                    scrollScenarioEvidence = { initial, final, transition, scrollOwner };
+                }
+                finally {
+                    await Promise.all(resolvedForScenario.filter((info) => info.handle).map((info) => info.handle.dispose()));
+                }
+            }
+            // Captured from the same live page, after the same readiness point (and,
+            // for a scenario request, after the scroll action above), as required by
+            // Batch 3/v0.3 Batch 2: no second browser/page is ever opened.
+            const screenshotBuffer = await page.screenshot({ type: 'png' });
+            const provenance = { engine: 'chromium', version: browser.version() };
+            let pageEvidence;
+            try {
+                pageEvidence = await capturePageEvidence(page, request.targetUrl, request.viewport);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                diagnostics.push(diagnostic('browser-evidence-unavailable', `page evidence collection failed: ${message}`));
+                pageEvidence = {};
+            }
+            let targetEvidence;
+            try {
+                const captured = await captureTargetEvidence(page, request.targets);
+                targetEvidence = captured.targetEvidence;
+                diagnostics.push(...captured.diagnostics);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                diagnostics.push(diagnostic('browser-evidence-unavailable', `target evidence collection failed: ${message}`));
+                targetEvidence = {};
+            }
+            result = {
+                ok: true,
+                provenance,
+                screenshot: new Uint8Array(screenshotBuffer),
+                pageEvidence,
+                targetEvidence,
+                diagnostics,
+                ...(scrollScenarioEvidence ? { scrollScenarioEvidence } : {}),
+            };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        result = { ok: false, diagnostics: [diagnostic('browser-runtime-failure', `unexpected browser failure: ${message}`)] };
+    }
+    finally {
+        if (browser) {
+            await browser.close().catch(() => undefined);
+        }
+    }
+    return { result, browserConnected: browser ? browser.isConnected() : false };
+}
+/** Observer-facing entrypoint: no Playwright object is reachable from its signature or return value. */
+export async function captureViewport(request) {
+    const { result } = await captureViewportInternal(request);
+    return result;
+}
+//# sourceMappingURL=chromiumAdapter.js.map

package/dist/browser/chromiumAdapter.js.map

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