@dailephd/my-frontend-observer 0.8.1

package/dist/viewerServer/evidence/referenceView.js

@@ -0,0 +1,169 @@
+import { join } from 'node:path';
+import { stat } from 'node:fs/promises';
+import { classifyManifest } from './classify.js';
+import { decodeArtifactHandle } from './handles.js';
+import { resolveContainedDir } from './pathSafety.js';
+import { discoverManifests } from './discovery.js';
+import { encodeArtifactHandle } from './handles.js';
+import { MAX_INDEX_RECORDS } from './limits.js';
+import { deriveReferenceRegionRelationships } from '../../domain/externalReferenceRegionRelationships.js';
+import { deriveReferenceRequirementAdequacy } from '../../domain/externalReferenceRequirements.js';
+import { evaluateReferenceCandidateCompatibility } from '../../domain/externalReferenceCompatibility.js';
+import { isValidReferenceRuntimeBindingDeclarations, evaluateReferenceRuntimeBindings } from '../../domain/externalReferenceRuntimeBinding.js';
+import { deriveCoordinateScale, evaluateReferenceCandidateFidelity } from '../../domain/externalReferenceFidelity.js';
+async function loadDirAndClassify(root, handle) {
+    const decoded = decodeArtifactHandle(handle);
+    if (!decoded.ok)
+        return { ok: false, reason: 'unknown-handle' };
+    const dir = resolveContainedDir(root, decoded.relativeDir);
+    if (dir === undefined)
+        return { ok: false, reason: 'unknown-handle' };
+    try {
+        const dirInfo = await stat(dir);
+        if (!dirInfo.isDirectory())
+            return { ok: false, reason: 'unknown-handle' };
+    }
+    catch {
+        return { ok: false, reason: 'unknown-handle' };
+    }
+    const classified = await classifyManifest(join(dir, 'manifest.json'));
+    return { ok: true, decoded, classified };
+}
+/**
+ * Batch 5's one additive server-side computation for a selected external
+ * reference on its own (no candidate yet): derives the reference's own
+ * region-relationship graph (`deriveReferenceRegionRelationships`) and
+ * requirement adequacy (`deriveReferenceRequirementAdequacy`) - both pure
+ * functions over the artifact's own already-persisted `regions`/
+ * `requirements`, never persisted themselves, never a second derivation
+ * engine. Mirrors observationView.ts's server-side-derivation pattern
+ * (Batch 3) rather than re-deriving in the browser.
+ */
+export async function getReferenceView(root, handle) {
+    const loaded = await loadDirAndClassify(root, handle);
+    if (!loaded.ok)
+        return loaded;
+    const { classified } = loaded;
+    if (classified.supportState !== 'supported')
+        return { ok: false, reason: 'not-currently-loadable' };
+    if (classified.family !== 'external-reference-imported' && classified.family !== 'external-reference-approved') {
+        return { ok: false, reason: 'not-a-reference' };
+    }
+    const artifact = classified.artifact;
+    const regions = artifact.regions ?? [];
+    const requirements = artifact.requirements ?? [];
+    let regionRelationships;
+    if (regions.length > 0) {
+        const derived = deriveReferenceRegionRelationships(artifact.referenceRequestId, regions);
+        regionRelationships = derived.ok ? derived.graph : undefined;
+    }
+    const requirementAdequacy = requirements.length > 0 || regions.length > 0 ? deriveReferenceRequirementAdequacy(regions, requirements) : undefined;
+    return { ok: true, regionRelationships, requirementAdequacy };
+}
+function candidateReferencesMatch(ref, candidate) {
+    return ref.observationId === candidate.observationId && ref.requestId === candidate.requestId && ref.producer.version === candidate.producer.version && ref.observationSchemaVersion === candidate.schemaVersion;
+}
+/**
+ * Shared handle-decode -> contained-dir-resolve -> re-classify resolution
+ * for a (reference, candidate) pair, reused by every Batch 5/6 route that
+ * needs both - never duplicated per route.
+ */
+async function resolveReferenceAndCandidate(root, referenceHandle, candidateHandle) {
+    const referenceLoaded = await loadDirAndClassify(root, referenceHandle);
+    if (!referenceLoaded.ok)
+        return { ok: false, reason: 'unknown-reference-handle' };
+    if (referenceLoaded.classified.supportState !== 'supported')
+        return { ok: false, reason: 'not-currently-loadable' };
+    if (referenceLoaded.classified.family !== 'external-reference-imported' && referenceLoaded.classified.family !== 'external-reference-approved') {
+        return { ok: false, reason: 'not-a-reference' };
+    }
+    const reference = referenceLoaded.classified.artifact;
+    const candidateLoaded = await loadDirAndClassify(root, candidateHandle);
+    if (!candidateLoaded.ok)
+        return { ok: false, reason: 'unknown-candidate-handle' };
+    if (candidateLoaded.classified.supportState !== 'supported')
+        return { ok: false, reason: 'not-currently-loadable' };
+    if (candidateLoaded.classified.family !== 'observation')
+        return { ok: false, reason: 'not-an-observation' };
+    const candidate = candidateLoaded.classified.artifact;
+    return { ok: true, reference, candidate };
+}
+/**
+ * Batch 5's reference/candidate computation: evaluates page/state-level
+ * compatibility through the existing canonical
+ * `evaluateReferenceCandidateCompatibility` (never a second, viewer-owned
+ * compatibility model), and separately lists every existing
+ * `FrontendContractEvaluationArtifact` whose own persisted `after` reference
+ * exactly identifies this candidate (frozen plan/task §29) - for the caller
+ * to offer as an explicit, never-auto-selected optional context. Batch 6
+ * additionally exposes `coordinateMapping` - the exact result of the
+ * existing canonical `deriveCoordinateScale(reference)` (exported from
+ * `externalReferenceFidelity.ts`, never a second scale/aspect-ratio
+ * implementation) - purely a function of the reference (independent of the
+ * candidate), used only to gate view-lock eligibility client-side. Neither
+ * `evaluateReferenceRuntimeBindings` nor `evaluateReferenceCandidateFidelity`
+ * is called anywhere in this function.
+ */
+export async function getReferenceCandidateView(root, referenceHandle, candidateHandle) {
+    const resolved = await resolveReferenceAndCandidate(root, referenceHandle, candidateHandle);
+    if (!resolved.ok)
+        return resolved;
+    const { reference, candidate } = resolved;
+    const compatibility = evaluateReferenceCandidateCompatibility(reference, candidate);
+    const coordinateMapping = deriveCoordinateScale(reference);
+    const discovery = await discoverManifests(root);
+    const evaluationHandles = [];
+    for (const manifest of discovery.manifests.slice(0, MAX_INDEX_RECORDS)) {
+        const classified = await classifyManifest(manifest.absolutePath);
+        if (classified.supportState !== 'supported' || classified.family !== 'contract-evaluation')
+            continue;
+        if (candidateReferencesMatch(classified.artifact.after, candidate)) {
+            evaluationHandles.push(encodeArtifactHandle('contract-evaluation', manifest.relativeDir));
+        }
+    }
+    return { ok: true, compatibility, evaluationHandles, coordinateMapping };
+}
+/**
+ * Batch 6: validates the session's explicit binding declarations against
+ * THIS specific reference (`isValidReferenceRuntimeBindingDeclarations` -
+ * region existence depends on the selected reference, so this can only
+ * happen here, never at CLI startup) and, if valid, calls the existing
+ * canonical `evaluateReferenceRuntimeBindings` exactly once - never a second
+ * binding engine, never a client-side re-verification via geometry/name.
+ */
+export async function getReferenceBindings(root, referenceHandle, candidateHandle, declarations) {
+    const resolved = await resolveReferenceAndCandidate(root, referenceHandle, candidateHandle);
+    if (!resolved.ok)
+        return resolved;
+    const { reference, candidate } = resolved;
+    const declarationsValidation = isValidReferenceRuntimeBindingDeclarations(declarations, reference);
+    if (!declarationsValidation.valid)
+        return { ok: false, reason: 'invalid-bindings', detail: declarationsValidation.reason };
+    const result = evaluateReferenceRuntimeBindings(reference, candidate, declarations);
+    if (!result.ok)
+        return { ok: false, reason: 'invalid-bindings', detail: result.reason };
+    return { ok: true, evaluation: result.evaluation };
+}
+/**
+ * Batch 6's one on-demand server-side computation for the explicit
+ * "Evaluate Fidelity" action: calls the existing canonical
+ * `evaluateReferenceCandidateFidelity` exactly once, using the exact same
+ * session binding declarations `getReferenceBindings` uses (so the two
+ * always structurally agree for the same inputs, being the same pure
+ * function applied to the same arguments - never two divergent binding
+ * results). Never persists the result; ephemeral per request.
+ */
+export async function getReferenceFidelity(root, referenceHandle, candidateHandle, declarations) {
+    const resolved = await resolveReferenceAndCandidate(root, referenceHandle, candidateHandle);
+    if (!resolved.ok)
+        return resolved;
+    const { reference, candidate } = resolved;
+    const declarationsValidation = isValidReferenceRuntimeBindingDeclarations(declarations, reference);
+    if (!declarationsValidation.valid)
+        return { ok: false, reason: 'invalid-bindings', detail: declarationsValidation.reason };
+    const result = evaluateReferenceCandidateFidelity(reference, candidate, declarations);
+    if (!result.ok)
+        return { ok: false, reason: 'invalid-bindings', detail: result.reason };
+    return { ok: true, evaluation: result.evaluation };
+}
+//# sourceMappingURL=referenceView.js.map

package/dist/viewerServer/evidence/referenceView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceView.js","sourceRoot":"","sources":["../../../src/viewerServer/evidence/referenceView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAE1G,OAAO,EAAE,kCAAkC,EAAE,MAAM,+CAA+C,CAAC;AAEnG,OAAO,EAAE,uCAAuC,EAAE,MAAM,gDAAgD,CAAC;AAKzG,OAAO,EAAE,0CAA0C,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AAE/I,OAAO,EAAE,qBAAqB,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAStH,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAc;IAC5D,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,gBAAyB,EAAE,CAAC;IAElF,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,gBAAyB,EAAE,CAAC;IAExF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,gBAAyB,EAAE,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,gBAAyB,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;IACtE,OAAO,EAAE,EAAE,EAAE,IAAa,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9B,IAAI,UAAU,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACpG,IAAI,UAAU,CAAC,MAAM,KAAK,6BAA6B,IAAI,UAAU,CAAC,MAAM,KAAK,6BAA6B,EAAE,CAAC;QAC/G,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAqC,CAAC;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;IAEjD,IAAI,mBAAiE,CAAC;IACtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,kCAAkC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACzF,mBAAmB,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kCAAkC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAyC,EAAE,SAA8B;IACzG,OAAO,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,aAAa,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC,wBAAwB,KAAK,SAAS,CAAC,aAAa,CAAC;AACnN,CAAC;AAUD;;;;GAIG;AACH,KAAK,UAAU,4BAA4B,CAAC,IAAY,EAAE,eAAuB,EAAE,eAAuB;IACxG,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACxE,IAAI,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IAClF,IAAI,eAAe,CAAC,UAAU,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACpH,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,KAAK,6BAA6B,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,KAAK,6BAA6B,EAAE,CAAC;QAC/I,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC,QAAqC,CAAC;IAEnF,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACxE,IAAI,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IAClF,IAAI,eAAe,CAAC,UAAU,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACpH,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC5G,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC;IAEtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC;AAUD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAY,EAAE,eAAuB,EAAE,eAAuB;IAC5G,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAE1C,MAAM,aAAa,GAAG,uCAAuC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAE3D,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACvE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,UAAU,CAAC,YAAY,KAAK,WAAW,IAAI,UAAU,CAAC,MAAM,KAAK,qBAAqB;YAAE,SAAS;QACrG,IAAI,wBAAwB,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YACnE,iBAAiB,CAAC,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAC3E,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,eAAuB,EAAE,eAAuB,EAAE,YAAgC;IACzI,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAE1C,MAAM,sBAAsB,GAAG,0CAA0C,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACnG,IAAI,CAAC,sBAAsB,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,CAAC,MAAM,EAAE,CAAC;IAE3H,MAAM,MAAM,GAAG,gCAAgC,CAAC,SAAS,EAAE,SAAS,EAAE,YAA6D,CAAC,CAAC;IACrI,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAExF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACrD,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,eAAuB,EAAE,eAAuB,EAAE,YAAgC;IACzI,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAE1C,MAAM,sBAAsB,GAAG,0CAA0C,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACnG,IAAI,CAAC,sBAAsB,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,CAAC,MAAM,EAAE,CAAC;IAE3H,MAAM,MAAM,GAAG,kCAAkC,CAAC,SAAS,EAAE,SAAS,EAAE,YAA6D,CAAC,CAAC;IACvI,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAExF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/dist/viewerServer/httpServer.d.ts

@@ -0,0 +1,27 @@
+import { type Server } from 'node:http';
+import type { ContextSessionState } from './context.js';
+import type { ViewerAliasMetadata } from './viewerService.js';
+/** Batch 1 viewer protocol identity: the shape of GET /api/status. Bumped independently of package/schema versions if the status contract itself changes. */
+export declare const VIEWER_PROTOCOL_VERSION = "1.0.0";
+export interface ViewerServerState {
+    /** The explicit, caller-supplied local evidence root this viewer session represents. Never interpreted as Observer evidence in Batch 1. */
+    root: string;
+    /** v0.8 Batch 6: explicit, session-only binding declarations loaded once at CLI startup from an optional `--bindings-file`. Not yet validated against any specific reference - see `referenceView.ts`. */
+    bindingDeclarations: readonly unknown[];
+    /** v0.8 Batch 7: explicit, session-only bounded-agent-context state loaded once at CLI startup from an optional `--context-file`. Defaults to `{status:'none'}` - see `context.ts`. */
+    context: ContextSessionState;
+    aliasMetadata?: ViewerAliasMetadata;
+}
+export interface CreateViewerServerOptions {
+    /** Absolute path to the built viewer static assets (index.html, JS/CSS bundles, manifest, icons). */
+    assetsRoot: string;
+    state: ViewerServerState;
+}
+/**
+ * Builds (but does not start listening on) the loopback-only viewer HTTP
+ * server. Read-only: serves only the built viewer application shell plus one
+ * minimal status endpoint. Never serves the evidence root as a generic
+ * static directory, never accepts write methods, and fails closed on any
+ * path that would resolve outside `assetsRoot`.
+ */
+export declare function createViewerServer(options: CreateViewerServerOptions): Server;

package/dist/viewerServer/httpServer.js

@@ -0,0 +1,381 @@
+import { createServer } from 'node:http';
+import { createReadStream } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import { extname, join, normalize, resolve, sep } from 'node:path';
+import { getProducerInfo } from '../domain/schema.js';
+import { buildEvidenceIndexMetadata, loadArtifactByHandle } from './evidence/index.js';
+import { resolveMedia } from './evidence/mediaResolver.js';
+import { getObservationRelationships } from './evidence/observationView.js';
+import { getComparisonView } from './evidence/comparisonView.js';
+import { getEvaluationView } from './evidence/evaluationView.js';
+import { getReferenceView, getReferenceCandidateView, getReferenceBindings, getReferenceFidelity } from './evidence/referenceView.js';
+import { resolveContextSources } from './evidence/contextSourceView.js';
+/** Batch 1 viewer protocol identity: the shape of GET /api/status. Bumped independently of package/schema versions if the status contract itself changes. */
+export const VIEWER_PROTOCOL_VERSION = '1.0.0';
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.webmanifest': 'application/manifest+json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+};
+function mimeTypeFor(path) {
+    return MIME_TYPES[extname(path).toLowerCase()] ?? 'application/octet-stream';
+}
+/**
+ * Resolves a requested URL pathname against the built viewer asset root,
+ * refusing to leave that root under any circumstance (encoded traversal,
+ * `..` segments, absolute-looking segments). Returns `undefined` when the
+ * request cannot possibly map to a safe on-disk path - callers must treat
+ * that as "not found", never attempt a fallback read.
+ */
+function resolveAssetPath(assetsRoot, pathname) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(pathname);
+    }
+    catch {
+        return undefined;
+    }
+    const normalized = normalize(decoded).replace(/^([/\\])+/, '');
+    const candidate = resolve(assetsRoot, normalized);
+    const rootWithSep = assetsRoot.endsWith(sep) ? assetsRoot : assetsRoot + sep;
+    if (candidate !== assetsRoot && !candidate.startsWith(rootWithSep)) {
+        return undefined;
+    }
+    return candidate;
+}
+/**
+ * Builds (but does not start listening on) the loopback-only viewer HTTP
+ * server. Read-only: serves only the built viewer application shell plus one
+ * minimal status endpoint. Never serves the evidence root as a generic
+ * static directory, never accepts write methods, and fails closed on any
+ * path that would resolve outside `assetsRoot`.
+ */
+export function createViewerServer(options) {
+    const { assetsRoot, state } = options;
+    return createServer((req, res) => {
+        void handleRequest(req, res, assetsRoot, state);
+    });
+}
+async function handleRequest(req, res, assetsRoot, state) {
+    const method = req.method ?? 'GET';
+    if (method !== 'GET' && method !== 'HEAD') {
+        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8', allow: 'GET, HEAD' });
+        res.end('method not allowed');
+        return;
+    }
+    let pathname;
+    try {
+        pathname = new URL(req.url ?? '/', 'http://viewer.local').pathname;
+    }
+    catch {
+        res.writeHead(400, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('bad request');
+        return;
+    }
+    if (pathname === '/api/status') {
+        const body = JSON.stringify({
+            ok: true,
+            viewerProtocolVersion: VIEWER_PROTOCOL_VERSION,
+            producer: getProducerInfo(),
+            root: state.root,
+        });
+        res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+        res.end(method === 'HEAD' ? undefined : body);
+        return;
+    }
+    if (pathname === '/api/index') {
+        const result = await buildEvidenceIndexMetadata(state.root, state.aliasMetadata?.observationAliasesByRelativeDir ?? {});
+        const body = JSON.stringify({ ok: true, records: result.records, truncated: result.truncated });
+        res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+        res.end(method === 'HEAD' ? undefined : body);
+        return;
+    }
+    const artifactMatch = /^\/api\/artifacts\/([^/]+)$/.exec(pathname);
+    if (artifactMatch) {
+        const handle = decodeURIComponentSafe(artifactMatch[1]);
+        if (handle === undefined) {
+            writeJsonError(res, method, 400, 'malformed artifact handle');
+            return;
+        }
+        const result = await loadArtifactByHandle(state.root, handle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-handle' ? 404 : 409;
+            const body = result.reason === 'unknown-handle' ? { ok: false, error: 'unknown viewer artifact handle' } : { ok: false, error: 'artifact is not currently loadable', metadata: result.metadata };
+            writeJsonBody(res, method, status, body);
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, handle: result.detail.handle, family: result.detail.family, artifact: result.detail.artifact });
+        return;
+    }
+    const mediaMatch = /^\/api\/media\/([^/]+)\/([^/]+)$/.exec(pathname);
+    if (mediaMatch) {
+        const handle = decodeURIComponentSafe(mediaMatch[1]);
+        const role = decodeURIComponentSafe(mediaMatch[2]);
+        if (handle === undefined || role === undefined) {
+            writeJsonError(res, method, 400, 'malformed media request');
+            return;
+        }
+        const resolution = await resolveMedia(state.root, handle, role);
+        if (!resolution.ok) {
+            writeJsonError(res, method, 404, resolution.reason);
+            return;
+        }
+        await streamFile(resolution.absolutePath, resolution.mimeType, res, method);
+        return;
+    }
+    const relationshipsMatch = /^\/api\/observations\/([^/]+)\/relationships$/.exec(pathname);
+    if (relationshipsMatch) {
+        const handle = decodeURIComponentSafe(relationshipsMatch[1]);
+        if (handle === undefined) {
+            writeJsonError(res, method, 400, 'malformed observation handle');
+            return;
+        }
+        const result = await getObservationRelationships(state.root, handle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-handle' ? 404 : 409;
+            const error = result.reason === 'unknown-handle'
+                ? 'unknown viewer artifact handle'
+                : result.reason === 'not-an-observation'
+                    ? 'relationships are only defined for observation evidence'
+                    : result.reason === 'not-currently-loadable'
+                        ? 'observation is not currently loadable'
+                        : `relationship derivation failed: ${result.detail}`;
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, graph: result.graph });
+        return;
+    }
+    const comparisonViewMatch = /^\/api\/comparisons\/([^/]+)\/view$/.exec(pathname);
+    if (comparisonViewMatch) {
+        const handle = decodeURIComponentSafe(comparisonViewMatch[1]);
+        if (handle === undefined) {
+            writeJsonError(res, method, 400, 'malformed comparison handle');
+            return;
+        }
+        const result = await getComparisonView(state.root, handle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-handle' ? 404 : 409;
+            const error = result.reason === 'unknown-handle' ? 'unknown viewer artifact handle' : result.reason === 'not-a-comparison' ? 'view is only defined for comparison evidence' : 'comparison is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, before: result.before, after: result.after });
+        return;
+    }
+    const evaluationViewMatch = /^\/api\/evaluations\/([^/]+)\/view$/.exec(pathname);
+    if (evaluationViewMatch) {
+        const handle = decodeURIComponentSafe(evaluationViewMatch[1]);
+        if (handle === undefined) {
+            writeJsonError(res, method, 400, 'malformed evaluation handle');
+            return;
+        }
+        const result = await getEvaluationView(state.root, handle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-handle' ? 404 : 409;
+            const error = result.reason === 'unknown-handle' ? 'unknown viewer artifact handle' : result.reason === 'not-an-evaluation' ? 'view is only defined for contract-evaluation evidence' : 'evaluation is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, comparison: result.comparison, baseline: result.baseline, change: result.change, before: result.before, after: result.after });
+        return;
+    }
+    const referenceViewMatch = /^\/api\/references\/([^/]+)\/view$/.exec(pathname);
+    if (referenceViewMatch) {
+        const handle = decodeURIComponentSafe(referenceViewMatch[1]);
+        if (handle === undefined) {
+            writeJsonError(res, method, 400, 'malformed reference handle');
+            return;
+        }
+        const result = await getReferenceView(state.root, handle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-handle' ? 404 : 409;
+            const error = result.reason === 'unknown-handle' ? 'unknown viewer artifact handle' : result.reason === 'not-a-reference' ? 'view is only defined for external-reference evidence' : 'reference is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, regionRelationships: result.regionRelationships ?? null, requirementAdequacy: result.requirementAdequacy ?? null });
+        return;
+    }
+    const referenceCandidateViewMatch = /^\/api\/references\/([^/]+)\/candidate\/([^/]+)\/view$/.exec(pathname);
+    if (referenceCandidateViewMatch) {
+        const referenceHandle = decodeURIComponentSafe(referenceCandidateViewMatch[1]);
+        const candidateHandle = decodeURIComponentSafe(referenceCandidateViewMatch[2]);
+        if (referenceHandle === undefined || candidateHandle === undefined) {
+            writeJsonError(res, method, 400, 'malformed reference/candidate request');
+            return;
+        }
+        const result = await getReferenceCandidateView(state.root, referenceHandle, candidateHandle);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-reference-handle' || result.reason === 'unknown-candidate-handle' ? 404 : 409;
+            const error = result.reason === 'unknown-reference-handle'
+                ? 'unknown viewer reference handle'
+                : result.reason === 'unknown-candidate-handle'
+                    ? 'unknown viewer candidate handle'
+                    : result.reason === 'not-a-reference'
+                        ? 'the first handle is not external-reference evidence'
+                        : result.reason === 'not-an-observation'
+                            ? 'the second handle is not observation evidence'
+                            : 'reference or candidate is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, compatibility: result.compatibility, evaluationHandles: result.evaluationHandles, coordinateMapping: result.coordinateMapping });
+        return;
+    }
+    const referenceBindingsMatch = /^\/api\/references\/([^/]+)\/candidate\/([^/]+)\/bindings$/.exec(pathname);
+    if (referenceBindingsMatch) {
+        const referenceHandle = decodeURIComponentSafe(referenceBindingsMatch[1]);
+        const candidateHandle = decodeURIComponentSafe(referenceBindingsMatch[2]);
+        if (referenceHandle === undefined || candidateHandle === undefined) {
+            writeJsonError(res, method, 400, 'malformed reference/candidate binding request');
+            return;
+        }
+        const result = await getReferenceBindings(state.root, referenceHandle, candidateHandle, state.bindingDeclarations);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-reference-handle' || result.reason === 'unknown-candidate-handle' ? 404 : result.reason === 'invalid-bindings' ? 422 : 409;
+            const error = result.reason === 'unknown-reference-handle'
+                ? 'unknown viewer reference handle'
+                : result.reason === 'unknown-candidate-handle'
+                    ? 'unknown viewer candidate handle'
+                    : result.reason === 'not-a-reference'
+                        ? 'the first handle is not external-reference evidence'
+                        : result.reason === 'not-an-observation'
+                            ? 'the second handle is not observation evidence'
+                            : result.reason === 'invalid-bindings'
+                                ? `the session's binding declarations are invalid for this reference: ${result.detail}`
+                                : 'reference or candidate is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, evaluation: result.evaluation });
+        return;
+    }
+    const referenceFidelityMatch = /^\/api\/references\/([^/]+)\/candidate\/([^/]+)\/fidelity$/.exec(pathname);
+    if (referenceFidelityMatch) {
+        const referenceHandle = decodeURIComponentSafe(referenceFidelityMatch[1]);
+        const candidateHandle = decodeURIComponentSafe(referenceFidelityMatch[2]);
+        if (referenceHandle === undefined || candidateHandle === undefined) {
+            writeJsonError(res, method, 400, 'malformed reference/candidate fidelity request');
+            return;
+        }
+        const result = await getReferenceFidelity(state.root, referenceHandle, candidateHandle, state.bindingDeclarations);
+        if (!result.ok) {
+            const status = result.reason === 'unknown-reference-handle' || result.reason === 'unknown-candidate-handle' ? 404 : result.reason === 'invalid-bindings' ? 422 : 409;
+            const error = result.reason === 'unknown-reference-handle'
+                ? 'unknown viewer reference handle'
+                : result.reason === 'unknown-candidate-handle'
+                    ? 'unknown viewer candidate handle'
+                    : result.reason === 'not-a-reference'
+                        ? 'the first handle is not external-reference evidence'
+                        : result.reason === 'not-an-observation'
+                            ? 'the second handle is not observation evidence'
+                            : result.reason === 'invalid-bindings'
+                                ? `the session's binding declarations are invalid for this reference: ${result.detail}`
+                                : 'reference or candidate is not currently loadable';
+            writeJsonBody(res, method, status, { ok: false, error });
+            return;
+        }
+        writeJsonBody(res, method, 200, { ok: true, evaluation: result.evaluation });
+        return;
+    }
+    if (pathname === '/api/context') {
+        if (state.context.status === 'none') {
+            writeJsonBody(res, method, 200, { ok: true, status: 'none' });
+            return;
+        }
+        if (state.context.status === 'unsupported-version') {
+            writeJsonBody(res, method, 200, { ok: true, status: 'unsupported-version', foundSchemaVersion: state.context.foundSchemaVersion });
+            return;
+        }
+        const sourceResolution = await resolveContextSources(state.root, state.context.artifact.sources);
+        writeJsonBody(res, method, 200, { ok: true, status: 'valid', artifact: state.context.artifact, sourceResolution });
+        return;
+    }
+    if (pathname.startsWith('/api/')) {
+        writeJsonError(res, method, 404, 'unknown viewer API route');
+        return;
+    }
+    const isAssetLikePath = extname(pathname) !== '';
+    const candidatePath = resolveAssetPath(assetsRoot, pathname === '/' ? '/index.html' : pathname);
+    if (candidatePath !== undefined) {
+        const served = await tryServeFile(candidatePath, res, method);
+        if (served)
+            return;
+        if (isAssetLikePath) {
+            res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+            res.end('not found');
+            return;
+        }
+    }
+    // SPA fallback for unknown, non-asset viewer routes (e.g. future client-side navigation): serve the shell itself rather than a bare 404.
+    const indexPath = join(assetsRoot, 'index.html');
+    const servedIndex = await tryServeFile(indexPath, res, method);
+    if (!servedIndex) {
+        res.writeHead(503, { 'content-type': 'text/plain; charset=utf-8' });
+        res.end('viewer assets are not built - run the package build before starting the viewer');
+    }
+}
+function decodeURIComponentSafe(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJsonBody(res, method, status, body) {
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+    res.end(method === 'HEAD' ? undefined : JSON.stringify(body));
+}
+function writeJsonError(res, method, status, error) {
+    writeJsonBody(res, method, status, { ok: false, error });
+}
+/** Streams one already-resolved, already-contained media file. Never used for arbitrary paths - callers must have gone through mediaResolver.ts's handle/role validation first. */
+async function streamFile(absolutePath, mimeType, res, method) {
+    let size;
+    try {
+        size = (await stat(absolutePath)).size;
+    }
+    catch {
+        writeJsonError(res, method, 404, 'media file not found on disk');
+        return;
+    }
+    res.writeHead(200, { 'content-type': mimeType, 'content-length': size, 'cache-control': 'no-store' });
+    if (method === 'HEAD') {
+        res.end();
+        return;
+    }
+    await new Promise((resolvePromise, reject) => {
+        const stream = createReadStream(absolutePath);
+        stream.on('error', reject);
+        stream.on('end', resolvePromise);
+        stream.pipe(res);
+    });
+}
+async function tryServeFile(path, res, method) {
+    try {
+        const info = await stat(path);
+        if (!info.isFile())
+            return false;
+        const body = await readFile(path);
+        res.writeHead(200, {
+            'content-type': mimeTypeFor(path),
+            'content-length': body.byteLength,
+            'cache-control': path.endsWith('index.html') ? 'no-cache' : 'public, max-age=31536000, immutable',
+        });
+        res.end(method === 'HEAD' ? undefined : body);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=httpServer.js.map

package/dist/viewerServer/httpServer.js.map

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

package/dist/viewerServer/openBrowser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Best-effort convenience only: opens the platform default browser at `url`
+ * using OS-native commands (no dependency). Failure here must never affect
+ * viewer server startup success - callers treat a rejected promise as
+ * non-fatal and continue with the server already running.
+ */
+export declare function openInDefaultBrowser(url: string): Promise<void>;