my-frontend-observer 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0 - 2026-08-11
+
+Runtime Observation Foundation. First public release.
+
+- Local-first browser runtime evidence producer: a real `observe` CLI command
+  that launches Chromium under a loopback-only network safety policy.
+- Explicit CSS-selector observation targets (`--target id=selector`,
+  repeatable).
+- Viewport screenshot capture (`screenshot.png`).
+- Bounded page evidence and bounded target evidence, with honest
+  unavailable/not-applicable/partial states when evidence cannot be
+  determined rather than guessing.
+- Loopback/network safety enforcement (`http`/`https`, `localhost`/`127.x.x.x`/
+  `::1` only).
+- Versioned, portable observation artifact: `manifest.json` + `screenshot.png`
+  written atomically per observation, artifact schema `1.0.0`.
+- Validated as a packed npm tarball with a clean-consumer install-and-observe
+  smoke on Windows, Linux, and macOS.

package/README.md

@@ -0,0 +1,69 @@
+# my-frontend-observer
+
+`my-frontend-observer` is the local-first rendered browser/runtime evidence
+producer in the my-dev-kit ecosystem. Its durable product purpose is defined
+in [docs/PROJECT_DESCRIPTION.md](docs/PROJECT_DESCRIPTION.md).
+
+## Current status
+
+`v0.1.0`, Runtime Observation Foundation, is the current published release:
+`my-frontend-observer observe` launches a real, sandboxed Chromium browser,
+enforces a loopback-only safety policy, captures a viewport screenshot plus
+bounded page/target evidence, and persists it as one portable
+`manifest.json` + `screenshot.png` artifact.
+
+Install:
+
+```powershell
+npm install my-frontend-observer
+npx playwright install chromium
+```
+
+Setup for working from a source checkout instead:
+
+```powershell
+npm install
+npx playwright install chromium
+npm run build
+```
+
+Example use, against your own locally running frontend:
+
+```powershell
+my-frontend-observer observe `
+  --url http://localhost:3000/ `
+  --viewport 1280x720 `
+  --target header=header `
+  --target main-content=main `
+  --output observations
+```
+
+(From a source checkout, use `node dist/cli.js observe ...` instead.)
+
+This prints a concise result (`Observation:`/`State:`/`Artifact:`/`Targets:`/
+`Diagnostics:`) and exits `0` on a successfully persisted observation. See
+[docs/COMMANDS.md](docs/COMMANDS.md) for the full flag reference.
+
+Validation:
+
+```powershell
+npm run typecheck
+npm run lint
+npm test
+npm run test:browser
+npm run build
+npm run check:docs
+```
+
+Planning authorities:
+
+- [Project Description](docs/PROJECT_DESCRIPTION.md): complete durable product
+  intent and responsibility boundaries.
+- [Project Milestones](docs/PROJECT_MILESTONES.md): complete ordered capability
+  design and cross-milestone rules.
+- [ROADMAP](docs/ROADMAP.md): version-level requirements; v0.1 is released,
+  v0.2 is next.
+- [Current State](docs/CURRENT_STATE.md): retained scaffold and release state.
+
+No sibling ecosystem repository is a runtime dependency of the retained
+foundation.

package/dist/application/browserCaptureService.d.ts

@@ -0,0 +1,11 @@
+import type { NormalizedObservationRequest } from '../request/request.js';
+import type { BrowserCaptureResult } from '../browser/types.js';
+export type { BrowserCaptureResult, BrowserProvenance } from '../browser/types.js';
+/**
+ * Minimum application-facing seam over the browser adapter: takes an
+ * already-validated request and returns the observer-owned browser-boundary
+ * result. Coordinates nothing beyond that single invocation - no page/target
+ * evidence, no artifact writing, no CLI reporting. Later batches extend this
+ * seam rather than calling the browser adapter directly.
+ */
+export declare function runBrowserCapture(request: NormalizedObservationRequest): Promise<BrowserCaptureResult>;

package/dist/application/browserCaptureService.js

@@ -0,0 +1,12 @@
+import { captureViewport } from '../browser/chromiumAdapter.js';
+/**
+ * Minimum application-facing seam over the browser adapter: takes an
+ * already-validated request and returns the observer-owned browser-boundary
+ * result. Coordinates nothing beyond that single invocation - no page/target
+ * evidence, no artifact writing, no CLI reporting. Later batches extend this
+ * seam rather than calling the browser adapter directly.
+ */
+export async function runBrowserCapture(request) {
+    return captureViewport(request);
+}
+//# sourceMappingURL=browserCaptureService.js.map

package/dist/application/browserCaptureService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserCaptureService.js","sourceRoot":"","sources":["../../src/application/browserCaptureService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKhE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqC;IAC3E,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/application/observationPersistence.d.ts

@@ -0,0 +1,59 @@
+import type { NormalizedObservationRequest } from '../request/request.js';
+import type { BrowserCaptureResult } from '../browser/types.js';
+import type { ObservationArtifact } from '../domain/schema.js';
+import type { CompletionState } from '../domain/completion.js';
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { PersistedObservationResult } from '../artifacts/types.js';
+import type { WriteObservationArtifactOptions } from '../artifacts/artifactWriter.js';
+export type { PersistedObservationResult } from '../artifacts/types.js';
+/**
+ * Assembles the frozen ObservationArtifact shape from one already-successful
+ * Batch 2/3 browser capture. Pure - no filesystem access, no Playwright
+ * dependency - so it is testable independently of both Chromium and disk
+ * I/O. `requestId`/`observationId` reuse the existing Batch 1 identity
+ * functions verbatim; `completion` reuses the existing Batch 1
+ * post-capture completion rule over the capture's own diagnostics.
+ */
+export declare function buildObservationArtifact(capture: Extract<BrowserCaptureResult, {
+    ok: true;
+}>, request: NormalizedObservationRequest): ObservationArtifact;
+/**
+ * Minimum application-facing persistence seam for Batch 5: combines an
+ * existing successful browser capture with the artifact writer. Not wired to
+ * the CLI in this batch.
+ */
+export declare function persistBrowserCapture(capture: Extract<BrowserCaptureResult, {
+    ok: true;
+}>, request: NormalizedObservationRequest, options?: WriteObservationArtifactOptions): Promise<PersistedObservationResult>;
+/**
+ * Observer-owned summary of one full observation attempt, with just enough
+ * information for a presentation layer (the Batch 5 CLI) to report a result
+ * without ever seeing a Playwright object, a raw Node filesystem exception,
+ * or persistence implementation detail.
+ */
+export type ApplicationObservationResult = {
+    ok: true;
+    observationId: string;
+    requestId: string;
+    completion: CompletionState;
+    artifactRoot: string;
+    manifestPath: string;
+    screenshotPath: string;
+    targetCount: number;
+    diagnostics: Diagnostic[];
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+/**
+ * The one canonical application-level observation use case: takes an
+ * already-normalized request, runs the existing browser capture exactly
+ * once, and - only for a successful capture - persists it exactly once
+ * through the existing artifact writer. Reuses `runBrowserCapture`,
+ * `buildObservationArtifact`, and `writeObservationArtifact` verbatim; it
+ * does not go through `persistBrowserCapture` because that helper re-derives
+ * a fresh `ObservationArtifact` (and therefore a fresh, different
+ * `observationId`) internally, which would desync the identity a caller
+ * inspects here from the identity actually written to disk.
+ */
+export declare function observe(request: NormalizedObservationRequest, options?: WriteObservationArtifactOptions): Promise<ApplicationObservationResult>;

package/dist/application/observationPersistence.js

@@ -0,0 +1,78 @@
+import { runBrowserCapture } from './browserCaptureService.js';
+import { ARTIFACT_KIND, SCHEMA_VERSION, getProducerInfo } from '../domain/schema.js';
+import { buildRequestIdentity, buildObservationIdentity } from '../domain/identity.js';
+import { deriveCompletion } from '../domain/completion.js';
+import { writeObservationArtifact, SCREENSHOT_FILENAME } from '../artifacts/artifactWriter.js';
+/**
+ * Assembles the frozen ObservationArtifact shape from one already-successful
+ * Batch 2/3 browser capture. Pure - no filesystem access, no Playwright
+ * dependency - so it is testable independently of both Chromium and disk
+ * I/O. `requestId`/`observationId` reuse the existing Batch 1 identity
+ * functions verbatim; `completion` reuses the existing Batch 1
+ * post-capture completion rule over the capture's own diagnostics.
+ */
+export function buildObservationArtifact(capture, request) {
+    const requestId = buildRequestIdentity(request);
+    const observationId = buildObservationIdentity(requestId);
+    const completion = deriveCompletion(capture.diagnostics, 'post-capture');
+    return {
+        artifactKind: ARTIFACT_KIND,
+        schemaVersion: SCHEMA_VERSION,
+        observationId,
+        requestId,
+        producer: getProducerInfo(),
+        browser: { state: 'available', source: 'browser', value: capture.provenance },
+        requestConfig: request,
+        provenance: { capturedAt: new Date().toISOString(), observationMethod: 'chromium-navigate-and-capture' },
+        pageEvidence: capture.pageEvidence,
+        targetEvidence: capture.targetEvidence,
+        screenshot: { state: 'available', source: 'browser', value: { path: SCREENSHOT_FILENAME } },
+        completion,
+        diagnostics: capture.diagnostics,
+        limits: { truncated: false, omittedFields: [], omittedTargets: [] },
+        artifactReferences: [{ path: SCREENSHOT_FILENAME, kind: 'screenshot' }],
+    };
+}
+/**
+ * Minimum application-facing persistence seam for Batch 5: combines an
+ * existing successful browser capture with the artifact writer. Not wired to
+ * the CLI in this batch.
+ */
+export async function persistBrowserCapture(capture, request, options = {}) {
+    const artifact = buildObservationArtifact(capture, request);
+    return writeObservationArtifact(artifact, capture.screenshot, options);
+}
+/**
+ * The one canonical application-level observation use case: takes an
+ * already-normalized request, runs the existing browser capture exactly
+ * once, and - only for a successful capture - persists it exactly once
+ * through the existing artifact writer. Reuses `runBrowserCapture`,
+ * `buildObservationArtifact`, and `writeObservationArtifact` verbatim; it
+ * does not go through `persistBrowserCapture` because that helper re-derives
+ * a fresh `ObservationArtifact` (and therefore a fresh, different
+ * `observationId`) internally, which would desync the identity a caller
+ * inspects here from the identity actually written to disk.
+ */
+export async function observe(request, options = {}) {
+    const capture = await runBrowserCapture(request);
+    if (!capture.ok) {
+        return { ok: false, diagnostics: capture.diagnostics };
+    }
+    const artifact = buildObservationArtifact(capture, request);
+    const persisted = await writeObservationArtifact(artifact, capture.screenshot, options);
+    if (!persisted.ok) {
+        return { ok: false, diagnostics: persisted.diagnostics };
+    }
+    return {
+        ok: true,
+        observationId: artifact.observationId,
+        requestId: artifact.requestId,
+        completion: artifact.completion,
+        artifactRoot: persisted.artifactRoot,
+        manifestPath: persisted.manifestPath,
+        screenshotPath: persisted.screenshotPath,
+        targetCount: Object.keys(artifact.targetEvidence).length,
+        diagnostics: artifact.diagnostics,
+    };
+}
+//# sourceMappingURL=observationPersistence.js.map

package/dist/application/observationPersistence.js.map

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

package/dist/artifacts/artifactWriter.d.ts

@@ -0,0 +1,25 @@
+import type { ObservationArtifact } from '../domain/schema.js';
+import type { PersistedObservationResult } from './types.js';
+export declare const MANIFEST_FILENAME = "manifest.json";
+export declare const SCREENSHOT_FILENAME = "screenshot.png";
+export interface WriteObservationArtifactOptions {
+    /** Base directory that `artifact.requestConfig.outputLocation` is resolved against. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Persists one already-assembled, already-validated ObservationArtifact plus
+ * its screenshot bytes as one portable artifact directory:
+ * `<outputLocation>/<observationId>/{manifest.json,screenshot.png}`.
+ *
+ * `observationId` is guaranteed fresh per capture (see
+ * domain/identity.ts#buildObservationIdentity's "never collides" contract),
+ * so each write targets its own unique subdirectory - no destructive
+ * overwrite decision is needed for the normal case; an existing directory at
+ * that path is treated as a genuine collision and rejected rather than
+ * overwritten. Writing happens in a sibling temporary directory first,
+ * `screenshot.png` before `manifest.json` (manifest-last), and the whole
+ * temporary directory is only exposed under its real name via one atomic
+ * rename - a consumer can never observe a partially-written artifact under
+ * its final name.
+ */
+export declare function writeObservationArtifact(artifact: ObservationArtifact, screenshotBytes: Uint8Array, options?: WriteObservationArtifactOptions): Promise<PersistedObservationResult>;

package/dist/artifacts/artifactWriter.js

@@ -0,0 +1,68 @@
+import { mkdir, writeFile, rename, rm, access } from 'node:fs/promises';
+import path from 'node:path';
+import { isValidObservationArtifact } from '../domain/schema.js';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+export const MANIFEST_FILENAME = 'manifest.json';
+export const SCREENSHOT_FILENAME = 'screenshot.png';
+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-assembled, already-validated ObservationArtifact plus
+ * its screenshot bytes as one portable artifact directory:
+ * `<outputLocation>/<observationId>/{manifest.json,screenshot.png}`.
+ *
+ * `observationId` is guaranteed fresh per capture (see
+ * domain/identity.ts#buildObservationIdentity's "never collides" contract),
+ * so each write targets its own unique subdirectory - no destructive
+ * overwrite decision is needed for the normal case; an existing directory at
+ * that path is treated as a genuine collision and rejected rather than
+ * overwritten. Writing happens in a sibling temporary directory first,
+ * `screenshot.png` before `manifest.json` (manifest-last), and the whole
+ * temporary directory is only exposed under its real name via one atomic
+ * rename - a consumer can never observe a partially-written artifact under
+ * its final name.
+ */
+export async function writeObservationArtifact(artifact, screenshotBytes, options = {}) {
+    const validation = isValidObservationArtifact(artifact);
+    if (!validation.valid) {
+        return writeFailure(`refusing to persist an invalid ObservationArtifact: ${validation.reason}`);
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const outputRoot = path.resolve(cwd, artifact.requestConfig.outputLocation);
+    const finalRoot = path.join(outputRoot, artifact.observationId);
+    const tempRoot = path.join(outputRoot, `.tmp-${artifact.observationId}`);
+    if (await pathExists(finalRoot)) {
+        return writeFailure(`an observation artifact already exists at "${artifact.observationId}"; refusing to overwrite it`, {
+            artifactRoot: finalRoot,
+        });
+    }
+    try {
+        await rm(tempRoot, { recursive: true, force: true });
+        await mkdir(tempRoot, { recursive: true });
+        await writeFile(path.join(tempRoot, SCREENSHOT_FILENAME), screenshotBytes);
+        await writeFile(path.join(tempRoot, MANIFEST_FILENAME), JSON.stringify(artifact, null, 2), 'utf8');
+        await rename(tempRoot, finalRoot);
+        return {
+            ok: true,
+            artifactRoot: finalRoot,
+            manifestPath: path.join(finalRoot, MANIFEST_FILENAME),
+            screenshotPath: path.join(finalRoot, SCREENSHOT_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 observation artifact: ${message}`);
+    }
+}
+//# sourceMappingURL=artifactWriter.js.map

package/dist/artifacts/artifactWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactWriter.js","sourceRoot":"","sources":["../../src/artifacts/artifactWriter.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,150 @@
+import { chromium } from 'playwright';
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+import { classifyUrl, classifyRedirect, classifySubresource, classifyPopup, classifyDownload } from '../safety/policy.js';
+import { capturePageEvidence, captureTargetEvidence } from './evidenceCapture.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 {
+            // Captured from the same live page, after the same readiness point, as
+            // required by Batch 3: 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 };
+        }
+    }
+    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":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1H,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlF,SAAS,UAAU,CAAC,IAAoB,EAAE,OAAe;IACvD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc,EAAE,kBAA0B;IACzE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,mBAAmB,EAAE,0CAA0C,kBAAkB,OAAO,OAAO,EAAE,CAAC,CAAC;IACvH,CAAC;IACD,OAAO,UAAU,CAAC,oBAAoB,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC;AAQD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAqC;IACjF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACvG,CAAC;IAED,IAAI,OAA4B,CAAC;IACjC,IAAI,MAA4B,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;SAC7E,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAErC,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAEhE,IAAI,uBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC;QAChD,IAAI,SAAiC,CAAC;QAEtC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,qBAAqB,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAE5F,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACtB,SAAS,GAAG,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC;oBAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC5D,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,yEAAyE;YACzE,uEAAuE;YACvE,iEAAiE;YACjE,sEAAsE;YACtE,0CAA0C;YAC1C,MAAM,QAAQ,GAAG,GAAG,KAAK,uBAAuB,CAAC,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YACjI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,SAAS,GAAG,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC;gBAC7C,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YACD,uBAAuB,GAAG,GAAG,CAAC;YAE9B,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;gBAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC7E,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAAY,CAAC;gBAC7H,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;oBAC9B,SAAS,GAAG,SAAS,IAAI,gBAAgB,CAAC,UAAU,CAAC;oBACrD,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBACtE,OAAO;gBACT,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,IAAI,eAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;gBACjC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;gBACtC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,GAAG,GAAG,CAAC;QACxB,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC;QACnE,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YAC3B,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,uBAAuB,CAAC,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC/H,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,8DAA8D;YAC9D,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,MAAM,UAAU,GAAsB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAEzF,IAAI,YAAoD,CAAC;YACzD,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,8BAA8B,EAAE,oCAAoC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC5G,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;YAED,IAAI,cAAoD,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;gBACzC,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,8BAA8B,EAAE,sCAAsC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC9G,cAAc,GAAG,EAAE,CAAC;YACtB,CAAC;YAED,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;QAC7H,CAAC;IACH,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,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,yBAAyB,EAAE,+BAA+B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;IACzH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AAC/E,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAqC;IACzE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/browser/evidenceCapture.d.ts

@@ -0,0 +1,19 @@
+import type { Page } from 'playwright';
+import type { EvidenceField } from '../domain/evidence.js';
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { NamedTarget, Viewport } from '../request/request.js';
+import type { TargetEvidenceRecord } from '../domain/schema.js';
+/**
+ * Captures the v0.1 minimum page evidence (docs/PROJECT_MILESTONES.md
+ * "Minimum page evidence") from the already-navigated, already-ready page.
+ * `documentWidth`/`documentHeight` are the one explicitly *derived* pair -
+ * max(scroll, client) in each axis - everything else is a direct browser
+ * read, per the Batch 1 evidence-source model.
+ */
+export declare function capturePageEvidence(page: Page, requestedUrl: string, viewport: Viewport): Promise<Record<string, EvidenceField<unknown>>>;
+export interface TargetEvidenceCaptureResult {
+    targetEvidence: Record<string, TargetEvidenceRecord>;
+    diagnostics: Diagnostic[];
+}
+/** Observes every explicitly configured Batch 1 target from the same live page, honoring the 0/1/many cardinality contract. */
+export declare function captureTargetEvidence(page: Page, targets: readonly NamedTarget[]): Promise<TargetEvidenceCaptureResult>;