@dailephd/my-frontend-observer 0.9.0 → 0.10.0

package/dist/viewerServer/referenceVisualChangeAuthoring.d.ts

@@ -0,0 +1,28 @@
+import type { ReferenceRuntimeBindingDeclaration } from '../domain/externalReferenceRuntimeBinding.js';
+import type { ViewerAuthoringSession } from './authoringSecurity.js';
+export interface StartReferenceVisualChangeRequest {
+    annotationHandle: string;
+    itemIds: string[];
+    baselineObservationHandle: string;
+    bindings: ReferenceRuntimeBindingDeclaration[];
+}
+export declare function parseStartReferenceVisualChangeRequest(value: unknown): {
+    ok: true;
+    request: StartReferenceVisualChangeRequest;
+} | {
+    ok: false;
+    error: string;
+};
+export type StartReferenceVisualChangeResult = {
+    ok: true;
+    visualChangeRequestId: string;
+    visualChangeWorkflowId: string;
+    referenceId: string;
+    referenceRequestId: string;
+    bindingCount: number;
+} | {
+    ok: false;
+    reason: string;
+    error: string;
+};
+export declare function startReferenceVisualChangeFromViewer(root: string, session: ViewerAuthoringSession, referenceHandle: string, request: StartReferenceVisualChangeRequest): Promise<StartReferenceVisualChangeResult>;

package/dist/viewerServer/referenceVisualChangeAuthoring.js

@@ -0,0 +1,134 @@
+import path from 'node:path';
+import { evaluateReferenceRuntimeBindings, isValidReferenceRuntimeBindingDeclarations } from '../domain/externalReferenceRuntimeBinding.js';
+import { buildReferenceRequirement, deriveReferenceRequirementAdequacy } from '../domain/externalReferenceRequirements.js';
+import { createProjectVisualChangeWorkflow } from '../application/visualChangeProjectWorkflowService.js';
+import { readProjectConfig } from '../projectWorkflow/projectConfig.js';
+import { aliasCatalogPath, projectConfigPath, projectEvidenceRoot } from '../projectWorkflow/projectPaths.js';
+import { readAliasCatalog } from '../projectWorkflow/aliasCatalog.js';
+import { resolveContainedAcceptancePath } from '../projectWorkflow/checkAcceptance.js';
+import { readPersistentBaselineContract } from '../artifacts/frontendContractArtifactReader.js';
+import { getAnnotationView } from './evidence/annotationView.js';
+import { loadArtifactByHandle } from './evidence/index.js';
+import { decodeArtifactHandle } from './evidence/handles.js';
+import { resolveContainedDir } from './evidence/pathSafety.js';
+import { parseAuthoringItemIds, runSerializedAuthoringWrite } from './annotationAuthoring.js';
+export function parseStartReferenceVisualChangeRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return { ok: false, error: 'request body must be a JSON object' };
+    const record = value;
+    const allowed = ['annotationHandle', 'itemIds', 'baselineObservationHandle', 'bindings'];
+    const extra = Object.keys(record).filter((key) => !allowed.includes(key));
+    if (extra.length > 0 || Object.keys(record).length !== 4)
+        return { ok: false, error: `request body must contain only ${allowed.join(', ')}` };
+    if (typeof record.annotationHandle !== 'string' || record.annotationHandle.length === 0 || typeof record.baselineObservationHandle !== 'string' || record.baselineObservationHandle.length === 0)
+        return { ok: false, error: 'annotationHandle and baselineObservationHandle must be non-empty strings' };
+    const ids = parseAuthoringItemIds(record.itemIds);
+    if (!ids.ok)
+        return ids;
+    if (!Array.isArray(record.bindings))
+        return { ok: false, error: 'bindings must be an array' };
+    return { ok: true, request: { annotationHandle: record.annotationHandle, itemIds: ids.itemIds, baselineObservationHandle: record.baselineObservationHandle, bindings: record.bindings } };
+}
+const relative = (root, dir) => { const result = path.relative(root, dir).split(path.sep).join('/'); return result && !result.startsWith('../') && !path.posix.isAbsolute(result) ? result : undefined; };
+const requiredRegions = (reference) => new Set((reference.requirements ?? []).flatMap((requirement) => requirement.subject.kind === 'region-property' ? [requirement.subject.region] : [requirement.subject.subjectRegion, requirement.subject.relatedRegion]));
+function selectedIntent(annotation, ids) {
+    const byId = new Map(annotation.items.map((item) => [item.annotationItemId, item]));
+    const items = [];
+    for (const id of ids) {
+        const item = byId.get(id);
+        if (item === undefined || item.interpretation.state !== 'confirmed' || !['reference-region', 'reference-requirement'].includes(item.interpretation.intent.kind))
+            return { ok: false, error: `annotation item "${id}" is not confirmed executable reference intent` };
+        items.push(item);
+    }
+    return { ok: true, items };
+}
+export function startReferenceVisualChangeFromViewer(root, session, referenceHandle, request) {
+    return runSerializedAuthoringWrite(session, async () => {
+        const loaded = await loadArtifactByHandle(root, referenceHandle);
+        if (!loaded.ok)
+            return { ok: false, reason: 'unknown-handle', error: 'unknown reference handle' };
+        if (loaded.detail.family !== 'external-reference-approved')
+            return { ok: false, reason: 'reference-not-approved', error: 'only an approved reference can start a visual change' };
+        const reference = loaded.detail.artifact;
+        const annotationView = await getAnnotationView(root, request.annotationHandle);
+        if (!annotationView.ok || annotationView.annotation.source.kind !== 'external-reference' || annotationView.source.status !== 'available' || annotationView.source.family !== 'external-reference-approved' || annotationView.source.handle !== referenceHandle)
+            return { ok: false, reason: 'annotation-source-mismatch', error: 'annotation must belong to the exact approved reference' };
+        const selected = selectedIntent(annotationView.annotation, request.itemIds);
+        if (!selected.ok)
+            return { ok: false, reason: 'invalid-selection', error: selected.error };
+        for (const item of selected.items) {
+            const intent = item.interpretation.intent;
+            if (intent.kind === 'reference-region') {
+                const match = (reference.regions ?? []).find((region) => region.id.toLowerCase() === intent.region.id.toLowerCase());
+                if (match === undefined || JSON.stringify(match.rectangle) !== JSON.stringify(intent.region.rectangle))
+                    return { ok: false, reason: 'intent-not-represented', error: 'reference intent must first be materialized and explicitly approved' };
+            }
+            if (intent.kind === 'reference-requirement') {
+                const id = buildReferenceRequirement(intent.requirement).requirementId;
+                if (!(reference.requirements ?? []).some((requirement) => requirement.requirementId === id))
+                    return { ok: false, reason: 'intent-not-represented', error: 'reference intent must first be materialized and explicitly approved' };
+            }
+        }
+        const adequacy = deriveReferenceRequirementAdequacy(reference.regions ?? [], reference.requirements ?? []);
+        if (adequacy.status !== 'adequate')
+            return { ok: false, reason: 'reference-inadequate', error: 'approved reference requirement evidence must be adequate' };
+        const baselineLoaded = await loadArtifactByHandle(root, request.baselineObservationHandle);
+        if (!baselineLoaded.ok || baselineLoaded.detail.family !== 'observation')
+            return { ok: false, reason: 'baseline-invalid', error: 'baselineObservationHandle must identify a supported observation' };
+        const baseline = baselineLoaded.detail.artifact;
+        const baselineDecoded = decodeArtifactHandle(request.baselineObservationHandle);
+        const baselineRoot = baselineDecoded.ok ? resolveContainedDir(root, baselineDecoded.relativeDir) : undefined;
+        const baselinePath = baselineRoot === undefined ? undefined : relative(session.projectRoot, baselineRoot);
+        if (baselinePath === undefined)
+            return { ok: false, reason: 'baseline-invalid', error: 'baseline observation is outside the project' };
+        const catalog = await readAliasCatalog(aliasCatalogPath(session.projectRoot));
+        const evidenceRelative = baselineRoot === undefined ? '' : path.relative(projectEvidenceRoot(session.projectRoot), baselineRoot).split(path.sep).join('/');
+        if (!catalog.ok || !Object.values(catalog.catalog.observations).some((entry) => entry.observationId === baseline.observationId && entry.requestId === baseline.requestId && entry.relativeArtifactDir === evidenceRelative))
+            return { ok: false, reason: 'baseline-alias-missing', error: 'baseline observation has no exact current alias' };
+        const config = await readProjectConfig(projectConfigPath(session.projectRoot));
+        if (!config.ok)
+            return { ok: false, reason: 'project-config-invalid', error: 'project configuration is invalid' };
+        if (config.config.acceptance?.reference === undefined)
+            return { ok: false, reason: 'reference-not-configured', error: 'project reference acceptance must be configured' };
+        const validation = isValidReferenceRuntimeBindingDeclarations(request.bindings, reference);
+        if (!validation.valid)
+            return { ok: false, reason: 'bindings-invalid', error: validation.reason };
+        const evaluated = evaluateReferenceRuntimeBindings(reference, baseline, request.bindings);
+        if (!evaluated.ok)
+            return { ok: false, reason: 'bindings-invalid', error: evaluated.reason };
+        const evaluation = evaluated.evaluation;
+        if (evaluation.compatibility.state === 'incomparable')
+            return { ok: false, reason: 'incomparable', error: 'approved reference and baseline observation are incomparable' };
+        const byRegion = new Map(evaluation.bindings.map((binding) => [binding.referenceRegion.toLowerCase(), binding]));
+        for (const region of requiredRegions(reference)) {
+            const binding = byRegion.get(region.toLowerCase());
+            if (binding === undefined)
+                return { ok: false, reason: 'binding-coverage-incomplete', error: `required reference region "${region}" has no workflow binding` };
+            if (binding.status !== 'bound')
+                return { ok: false, reason: 'binding-not-bound', error: `required reference region "${region}" is ${binding.status}` };
+        }
+        const annotationDecoded = decodeArtifactHandle(request.annotationHandle);
+        const referenceDecoded = decodeArtifactHandle(referenceHandle);
+        const annotationRoot = annotationDecoded.ok ? resolveContainedDir(root, annotationDecoded.relativeDir) : undefined;
+        const referenceRoot = referenceDecoded.ok ? resolveContainedDir(root, referenceDecoded.relativeDir) : undefined;
+        const annotationPath = annotationRoot === undefined ? undefined : relative(session.projectRoot, annotationRoot);
+        const referencePath = referenceRoot === undefined ? undefined : relative(session.projectRoot, referenceRoot);
+        if (annotationPath === undefined || referencePath === undefined)
+            return { ok: false, reason: 'scope-invalid', error: 'workflow evidence is outside the project' };
+        let baselineContract;
+        if (config.config.acceptance.contract !== undefined) {
+            const configured = config.config.acceptance.contract.baselineArtifact;
+            const resolved = resolveContainedAcceptancePath(session.projectRoot, configured);
+            const read = resolved.ok ? await readPersistentBaselineContract(path.join(resolved.path, 'manifest.json')) : undefined;
+            if (read === undefined || !read.ok)
+                return { ok: false, reason: 'baseline-contract-invalid', error: 'configured baseline contract is invalid' };
+            baselineContract = { artifactId: read.contract.baselineId, baselineId: read.contract.baselineId, artifactPath: configured };
+        }
+        const scope = { entryMode: 'reference', annotationId: annotationView.annotation.annotationId, annotationArtifactPath: annotationPath, baselineObservation: { artifactId: baseline.observationId, observationId: baseline.observationId, requestId: baseline.requestId, artifactPath: baselinePath }, ...(baselineContract === undefined ? {} : { baselineContract }), approvedReference: { artifactId: reference.referenceId, referenceId: reference.referenceId, referenceRequestId: reference.referenceRequestId, artifactPath: referencePath }, bindings: request.bindings };
+        const workflow = await createProjectVisualChangeWorkflow({ projectRoot: session.projectRoot, scope });
+        if (!workflow.ok)
+            return { ok: false, reason: 'workflow-persistence-failed', error: 'reason' in workflow ? workflow.reason : workflow.diagnostics.map((item) => item.message).join('; ') };
+        return { ok: true, visualChangeRequestId: workflow.visualChangeRequestId, visualChangeWorkflowId: workflow.visualChangeWorkflowId, referenceId: reference.referenceId, referenceRequestId: reference.referenceRequestId, bindingCount: request.bindings.length };
+    });
+}
+//# sourceMappingURL=referenceVisualChangeAuthoring.js.map

package/dist/viewerServer/referenceVisualChangeAuthoring.js.map

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

package/dist/viewerServer/runtimeVisualChangeAuthoring.d.ts

@@ -0,0 +1,33 @@
+import { promoteVisualAnnotationContract } from '../application/visualAnnotationContractPromotionService.js';
+import { createProjectVisualChangeWorkflow } from '../application/visualChangeProjectWorkflowService.js';
+import type { ViewerAuthoringSession } from './authoringSecurity.js';
+export interface StartRuntimeVisualChangeRequest {
+    itemIds: string[];
+}
+export type StartRuntimeVisualChangeFailureReason = 'unknown-annotation-handle' | 'not-an-annotation' | 'reference-annotation' | 'source-unavailable' | 'source-mismatch' | 'project-config-invalid' | 'contract-not-configured' | 'configured-baseline-invalid' | 'baseline-alias-missing' | 'invalid-selection' | 'contract-persistence-failed' | 'workflow-persistence-failed';
+export type StartRuntimeVisualChangeResult = {
+    ok: true;
+    contractId: string;
+    contractRequestId: string;
+    clauseCount: number;
+    visualChangeRequestId: string;
+    visualChangeWorkflowId: string;
+} | {
+    ok: false;
+    reason: StartRuntimeVisualChangeFailureReason;
+    error: string;
+    contractId?: string;
+    contractRequestId?: string;
+};
+export interface RuntimeVisualChangeDependencies {
+    promote: typeof promoteVisualAnnotationContract;
+    create: typeof createProjectVisualChangeWorkflow;
+}
+export declare function parseStartRuntimeVisualChangeRequest(value: unknown): {
+    ok: true;
+    request: StartRuntimeVisualChangeRequest;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function startRuntimeVisualChangeFromViewer(root: string, session: ViewerAuthoringSession, annotationHandle: string, request: StartRuntimeVisualChangeRequest, dependencies?: RuntimeVisualChangeDependencies): Promise<StartRuntimeVisualChangeResult>;

package/dist/viewerServer/runtimeVisualChangeAuthoring.js

@@ -0,0 +1,81 @@
+import path from 'node:path';
+import { readProjectConfig } from '../projectWorkflow/projectConfig.js';
+import { aliasCatalogPath, contractOutputLocation, projectConfigPath, projectEvidenceRoot } from '../projectWorkflow/projectPaths.js';
+import { readAliasCatalog } from '../projectWorkflow/aliasCatalog.js';
+import { resolveContainedAcceptancePath } from '../projectWorkflow/checkAcceptance.js';
+import { readPersistentBaselineContract } from '../artifacts/frontendContractArtifactReader.js';
+import { promoteVisualAnnotationContract } from '../application/visualAnnotationContractPromotionService.js';
+import { createProjectVisualChangeWorkflow } from '../application/visualChangeProjectWorkflowService.js';
+import { getAnnotationView } from './evidence/annotationView.js';
+import { loadArtifactByHandle } from './evidence/index.js';
+import { decodeArtifactHandle } from './evidence/handles.js';
+import { resolveContainedDir } from './evidence/pathSafety.js';
+import { parseAuthoringItemIds, runSerializedAuthoringWrite } from './annotationAuthoring.js';
+const DEFAULT_DEPENDENCIES = { promote: promoteVisualAnnotationContract, create: createProjectVisualChangeWorkflow };
+export function parseStartRuntimeVisualChangeRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return { ok: false, error: 'request body must be a JSON object' };
+    const record = value;
+    if (Object.keys(record).some((key) => key !== 'itemIds'))
+        return { ok: false, error: 'request body must contain only itemIds' };
+    const parsed = parseAuthoringItemIds(record.itemIds);
+    return parsed.ok ? { ok: true, request: { itemIds: parsed.itemIds } } : parsed;
+}
+function portableRelative(projectRoot, absoluteDir) {
+    const relative = path.relative(projectRoot, absoluteDir).split(path.sep).join('/');
+    return relative.length > 0 && !relative.startsWith('../') && !path.posix.isAbsolute(relative) ? relative : undefined;
+}
+export function startRuntimeVisualChangeFromViewer(root, session, annotationHandle, request, dependencies = DEFAULT_DEPENDENCIES) {
+    return runSerializedAuthoringWrite(session, () => performStart(root, session, annotationHandle, request, dependencies));
+}
+async function performStart(root, session, annotationHandle, request, dependencies) {
+    const view = await getAnnotationView(root, annotationHandle);
+    if (!view.ok)
+        return { ok: false, reason: view.reason === 'unknown-handle' ? 'unknown-annotation-handle' : 'not-an-annotation', error: view.reason === 'unknown-handle' ? 'unknown annotation handle' : 'the handle does not name a supported visual annotation' };
+    const { annotation, source } = view;
+    if (annotation.source.kind !== 'runtime-observation')
+        return { ok: false, reason: 'reference-annotation', error: 'actual-frontend visual changes require a runtime-observation annotation' };
+    if (source.status !== 'available' || source.family !== 'observation')
+        return { ok: false, reason: 'source-unavailable', error: 'the exact annotation source observation is unavailable' };
+    const loaded = await loadArtifactByHandle(root, source.handle);
+    if (!loaded.ok || loaded.detail.family !== 'observation')
+        return { ok: false, reason: 'source-unavailable', error: 'the exact annotation source observation is no longer loadable' };
+    const observation = loaded.detail.artifact;
+    const annotationDecoded = decodeArtifactHandle(annotationHandle);
+    const sourceDecoded = decodeArtifactHandle(source.handle);
+    const annotationDir = annotationDecoded.ok ? resolveContainedDir(root, annotationDecoded.relativeDir) : undefined;
+    const observationDir = sourceDecoded.ok ? resolveContainedDir(root, sourceDecoded.relativeDir) : undefined;
+    const annotationPath = annotationDir === undefined ? undefined : portableRelative(session.projectRoot, annotationDir);
+    const observationPath = observationDir === undefined ? undefined : portableRelative(session.projectRoot, observationDir);
+    if (annotationPath === undefined || observationPath === undefined || observationDir === undefined)
+        return { ok: false, reason: 'source-mismatch', error: 'annotation or source observation is outside the project' };
+    const config = await readProjectConfig(projectConfigPath(session.projectRoot));
+    if (!config.ok)
+        return { ok: false, reason: 'project-config-invalid', error: 'the project configuration is invalid' };
+    const acceptance = config.config.acceptance?.contract;
+    if (acceptance === undefined)
+        return { ok: false, reason: 'contract-not-configured', error: 'project contract acceptance must be configured' };
+    const baselineRoot = resolveContainedAcceptancePath(session.projectRoot, acceptance.baselineArtifact);
+    if (!baselineRoot.ok)
+        return { ok: false, reason: 'configured-baseline-invalid', error: 'the configured baseline contract path is missing or outside the project' };
+    const baseline = await readPersistentBaselineContract(path.join(baselineRoot.path, 'manifest.json'));
+    if (!baseline.ok)
+        return { ok: false, reason: 'configured-baseline-invalid', error: 'the configured baseline contract is missing or invalid' };
+    const catalog = await readAliasCatalog(aliasCatalogPath(session.projectRoot));
+    const expectedRelative = path.relative(projectEvidenceRoot(session.projectRoot), observationDir).split(path.sep).join('/');
+    const exactAlias = catalog.ok && Object.values(catalog.catalog.observations).some((record) => record.observationId === observation.observationId && record.requestId === observation.requestId && record.relativeArtifactDir === expectedRelative);
+    if (!exactAlias)
+        return { ok: false, reason: 'baseline-alias-missing', error: 'the source observation has no exact current project alias' };
+    const promoted = await dependencies.promote({ annotation, sourceObservation: observation, selectedItemIds: request.itemIds, activeBaselineIds: [baseline.contract.baselineId], outputLocation: contractOutputLocation(), cwd: session.projectRoot });
+    if (!promoted.ok)
+        return { ok: false, reason: promoted.code === 'persistence-failed' ? 'contract-persistence-failed' : promoted.code === 'invalid-selection' ? 'invalid-selection' : 'source-mismatch', error: promoted.reason };
+    const changePath = portableRelative(session.projectRoot, promoted.artifactRoot);
+    if (changePath === undefined)
+        return { ok: false, reason: 'workflow-persistence-failed', error: 'the change contract was persisted, but its project-relative location could not be established', contractId: promoted.contractId, contractRequestId: promoted.contractRequestId };
+    const scope = { entryMode: 'actual-frontend', annotationId: annotation.annotationId, annotationArtifactPath: annotationPath, baselineObservation: { artifactId: observation.observationId, observationId: observation.observationId, requestId: observation.requestId, artifactPath: observationPath }, baselineContract: { artifactId: baseline.contract.baselineId, baselineId: baseline.contract.baselineId, artifactPath: acceptance.baselineArtifact }, changeContract: { artifactId: promoted.contractId, contractId: promoted.contractId, contractRequestId: promoted.contractRequestId, artifactPath: changePath } };
+    const workflow = await dependencies.create({ projectRoot: session.projectRoot, scope });
+    if (!workflow.ok)
+        return { ok: false, reason: 'workflow-persistence-failed', error: 'the change contract was persisted, but the visual-change workflow was not created', contractId: promoted.contractId, contractRequestId: promoted.contractRequestId };
+    return { ok: true, contractId: promoted.contractId, contractRequestId: promoted.contractRequestId, clauseCount: promoted.clauseCount, visualChangeRequestId: workflow.visualChangeRequestId, visualChangeWorkflowId: workflow.visualChangeWorkflowId };
+}
+//# sourceMappingURL=runtimeVisualChangeAuthoring.js.map

package/dist/viewerServer/runtimeVisualChangeAuthoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeVisualChangeAuthoring.js","sourceRoot":"","sources":["../../src/viewerServer/runtimeVisualChangeAuthoring.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACtI,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,MAAM,4DAA4D,CAAC;AAC7G,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAS9F,MAAM,oBAAoB,GAAoC,EAAE,OAAO,EAAE,+BAA+B,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;AAEtJ,MAAM,UAAU,oCAAoC,CAAC,KAAc;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IAC3I,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IAChI,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACjF,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB,EAAE,WAAmB;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAAY,EAAE,OAA+B,EAAE,gBAAwB,EAAE,OAAwC,EAAE,eAAgD,oBAAoB;IACxO,OAAO,2BAA2B,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAC1H,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAA+B,EAAE,gBAAwB,EAAE,OAAwC,EAAE,YAA6C;IAC1L,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,wDAAwD,EAAE,CAAC;IACnQ,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,yEAAyE,EAAE,CAAC;IAC7L,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;IAC1L,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;IACrL,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,QAA+B,CAAC;IAClE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5H,MAAM,aAAa,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClH,MAAM,cAAc,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,cAAc,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACtH,MAAM,eAAe,GAAG,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACzH,IAAI,cAAc,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;IACrN,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;IACtH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;IAC/I,MAAM,YAAY,GAAG,8BAA8B,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACtG,IAAI,CAAC,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,yEAAyE,EAAE,CAAC;IACpK,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IACrG,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;IAC/I,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3H,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,KAAK,WAAW,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS,IAAI,MAAM,CAAC,mBAAmB,KAAK,gBAAgB,CAAC,CAAC;IACnP,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,KAAK,EAAE,2DAA2D,EAAE,CAAC;IAC5I,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,EAAE,sBAAsB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrP,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACjO,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,+FAA+F,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAClR,MAAM,KAAK,GAA4B,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,mBAAmB,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,gBAAgB,EAAE,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC;IACtnB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,KAAK,EAAE,mFAAmF,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC1P,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC;AACzP,CAAC"}

package/dist/viewerServer/visualChangeAuthoring.d.ts

@@ -0,0 +1,46 @@
+import type { VisualChangeScope } from '../domain/visualChangeWorkflow.js';
+import type { VisualChangeProjectWorkflowFailureCode } from '../application/visualChangeProjectWorkflowService.js';
+import type { ViewerAuthoringSession } from './authoringSecurity.js';
+export declare const VISUAL_CHANGE_FAILURE_STATUS: Record<VisualChangeProjectWorkflowFailureCode, number>;
+export type ResolveVisualChangeTargetResult = {
+    ok: true;
+    workflowManifestPath: string;
+} | {
+    ok: false;
+    status: 404 | 409;
+    error: string;
+};
+export declare function resolveVisualChangeTarget(root: string, handle: string): Promise<ResolveVisualChangeTargetResult>;
+export declare function parseCreateVisualChangeRequest(value: unknown): {
+    ok: true;
+    scope: VisualChangeScope;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseEmptyVisualChangeRequest(value: unknown): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export type VisualChangeViewerResult = {
+    ok: true;
+    status: 200 | 201;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    status: number;
+    body: {
+        ok: false;
+        code: VisualChangeProjectWorkflowFailureCode;
+        error: string;
+        check?: unknown;
+    };
+};
+export declare function createVisualChangeFromViewer(session: ViewerAuthoringSession, scope: VisualChangeScope): Promise<VisualChangeViewerResult>;
+export declare function mutateVisualChangeFromViewer(root: string, session: ViewerAuthoringSession, handle: string, operation: 'activate' | 'check' | 'restore'): Promise<VisualChangeViewerResult | {
+    ok: false;
+    status: 404 | 409;
+    error: string;
+}>;

package/dist/viewerServer/visualChangeAuthoring.js

@@ -0,0 +1,63 @@
+import path from 'node:path';
+import { getProducerInfo } from '../domain/schema.js';
+import { VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND, VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION, isValidVisualChangeWorkflowArtifact } from '../domain/visualChangeWorkflow.js';
+import { activateProjectVisualChangeWorkflow, createProjectVisualChangeWorkflow, restoreProjectVisualChangeWorkflowAcceptance, runProjectVisualChangeCheck } from '../application/visualChangeProjectWorkflowService.js';
+import { decodeArtifactHandle } from './evidence/handles.js';
+import { loadArtifactByHandle } from './evidence/index.js';
+import { resolveContainedDir } from './evidence/pathSafety.js';
+export const VISUAL_CHANGE_FAILURE_STATUS = {
+    'activation-not-configured': 409, 'activation-already-restored': 409, 'baseline-drift': 409, 'acceptance-drift': 409,
+    'check-scope-mismatch': 409, 'candidate-not-produced': 409, 'duplicate-attempt': 409, 'attempt-limit-reached': 409, 'project-config-invalid': 409,
+    'workflow-invalid': 422, 'workflow-reference-invalid': 422,
+    'project-config-write-failure': 500, 'workflow-persistence-failure': 500, 'partial-state-failure': 500,
+    'review-required': 409, 'workflow-accepted': 409, 'workflow-abandoned': 409,
+};
+export async function resolveVisualChangeTarget(root, handle) {
+    const loaded = await loadArtifactByHandle(root, handle);
+    if (!loaded.ok)
+        return loaded.reason === 'unknown-handle' ? { ok: false, status: 404, error: 'unknown viewer artifact handle' } : { ok: false, status: 409, error: 'workflow target is not currently supported' };
+    if (loaded.detail.family !== 'visual-change-workflow')
+        return { ok: false, status: 409, error: 'handle does not name a visual-change workflow' };
+    const decoded = decodeArtifactHandle(handle);
+    const directory = decoded.ok ? resolveContainedDir(root, decoded.relativeDir) : undefined;
+    return directory === undefined ? { ok: false, status: 404, error: 'unknown viewer artifact handle' } : { ok: true, workflowManifestPath: path.join(directory, 'manifest.json') };
+}
+export function parseCreateVisualChangeRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return { ok: false, error: 'request body must be a JSON object' };
+    const record = value;
+    const keys = Object.keys(record);
+    if (keys.length !== 1 || keys[0] !== 'scope')
+        return { ok: false, error: 'request body must contain exactly scope' };
+    const candidate = { artifactKind: VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND, schemaVersion: VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION, visualChangeRequestId: 'request', visualChangeWorkflowId: 'workflow', producer: getProducerInfo(), scope: record.scope, attempts: [], ...(record.scope?.entryMode === 'reference' ? { bindings: { path: 'bindings.json', sha256: '0'.repeat(64), declarationCount: Array.isArray(record.scope.bindings) ? record.scope.bindings.length : 0 } } : {}), provenance: { createdAt: 'validation' } };
+    const valid = isValidVisualChangeWorkflowArtifact(candidate);
+    return valid.valid ? { ok: true, scope: candidate.scope } : { ok: false, error: `scope is invalid: ${valid.reason}` };
+}
+export function parseEmptyVisualChangeRequest(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && Object.keys(value).length === 0 ? { ok: true } : { ok: false, error: 'request body must be an empty JSON object' };
+}
+function applicationFailure(result) { return { ok: false, status: VISUAL_CHANGE_FAILURE_STATUS[result.code], body: { ok: false, code: result.code, error: result.reason, ...(result.check === undefined ? {} : { check: result.check }) } }; }
+const success = (status, result, extra = {}) => ({ ok: true, status, body: { ok: true, visualChangeRequestId: result.visualChangeRequestId, visualChangeWorkflowId: result.visualChangeWorkflowId, ...extra } });
+export async function createVisualChangeFromViewer(session, scope) {
+    const result = await createProjectVisualChangeWorkflow({ projectRoot: session.projectRoot, scope });
+    if (result.ok)
+        return success(201, result);
+    return 'code' in result ? applicationFailure(result) : { ok: false, status: 500, body: { ok: false, code: 'workflow-persistence-failure', error: 'visual-change workflow could not be persisted' } };
+}
+export async function mutateVisualChangeFromViewer(root, session, handle, operation) {
+    const target = await resolveVisualChangeTarget(root, handle);
+    if (!target.ok)
+        return { ok: false, status: target.status, error: target.error };
+    const workflowManifestPath = path.relative(session.projectRoot, target.workflowManifestPath).split(path.sep).join('/');
+    if (operation === 'activate') {
+        const result = await activateProjectVisualChangeWorkflow({ projectRoot: session.projectRoot, workflowManifestPath });
+        return result.ok ? success(200, result) : applicationFailure(result);
+    }
+    if (operation === 'restore') {
+        const result = await restoreProjectVisualChangeWorkflowAcceptance({ projectRoot: session.projectRoot, workflowManifestPath });
+        return result.ok ? success(200, result) : applicationFailure(result);
+    }
+    const result = await runProjectVisualChangeCheck({ projectRoot: session.projectRoot, workflowManifestPath });
+    return result.ok ? success(200, result, { attempt: result.attempt, check: result.check }) : applicationFailure(result);
+}
+//# sourceMappingURL=visualChangeAuthoring.js.map

package/dist/viewerServer/visualChangeAuthoring.js.map

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

package/dist/viewerServer/visualChangeHandoff.d.ts

@@ -0,0 +1,23 @@
+import type { VisualChangeAgentHandoff, VisualChangeExternalCoordination } from '../domain/visualChangeAgentHandoff.js';
+import { type PrepareVisualChangeAgentHandoffFailureCode } from '../application/visualChangeAgentHandoffService.js';
+import type { ContextSessionState } from './context.js';
+import type { ViewerAuthoringSession } from './authoringSecurity.js';
+export interface PrepareVisualChangeHandoffRequest {
+    coordination?: VisualChangeExternalCoordination;
+}
+export declare function parsePrepareVisualChangeHandoffRequest(value: unknown): {
+    ok: true;
+    request: PrepareVisualChangeHandoffRequest;
+} | {
+    ok: false;
+    error: string;
+};
+export type PrepareVisualChangeHandoffFromViewerResult = {
+    ok: true;
+    handoff: VisualChangeAgentHandoff;
+} | {
+    ok: false;
+    code: 'unknown-handle' | 'wrong-family' | PrepareVisualChangeAgentHandoffFailureCode;
+    error: string;
+};
+export declare function prepareVisualChangeHandoffFromViewer(root: string, session: ViewerAuthoringSession, context: ContextSessionState, handle: string, request: PrepareVisualChangeHandoffRequest): Promise<PrepareVisualChangeHandoffFromViewerResult>;

package/dist/viewerServer/visualChangeHandoff.js

@@ -0,0 +1,31 @@
+import path from 'node:path';
+import { getProducerInfo } from '../domain/schema.js';
+import { isValidVisualChangeExternalCoordination } from '../domain/visualChangeAgentHandoff.js';
+import { prepareVisualChangeAgentHandoff } from '../application/visualChangeAgentHandoffService.js';
+import { decodeArtifactHandle } from './evidence/handles.js';
+import { loadArtifactByHandle } from './evidence/index.js';
+export function parsePrepareVisualChangeHandoffRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return { ok: false, error: 'request body must be a JSON object' };
+    const record = value;
+    if (Object.keys(record).some((key) => key !== 'coordination'))
+        return { ok: false, error: 'request body may contain only coordination' };
+    if (record.coordination !== undefined && !isValidVisualChangeExternalCoordination(record.coordination))
+        return { ok: false, error: 'coordination must be a valid my-dev-kit-orchestrator run reference' };
+    return { ok: true, request: record.coordination === undefined ? {} : { coordination: record.coordination } };
+}
+export async function prepareVisualChangeHandoffFromViewer(root, session, context, handle, request) {
+    const loaded = await loadArtifactByHandle(root, handle);
+    if (!loaded.ok)
+        return { ok: false, code: 'unknown-handle', error: 'unknown workflow handle' };
+    if (loaded.detail.family !== 'visual-change-workflow')
+        return { ok: false, code: 'wrong-family', error: 'prepare-handoff is only available for visual-change workflows' };
+    const decoded = decodeArtifactHandle(handle);
+    if (!decoded.ok)
+        return { ok: false, code: 'unknown-handle', error: 'unknown workflow handle' };
+    const workflowManifestPath = path.relative(session.projectRoot, path.join(root, ...decoded.relativeDir.split('/'), 'manifest.json')).split(path.sep).join('/');
+    const producer = getProducerInfo();
+    const result = await prepareVisualChangeAgentHandoff({ projectRoot: session.projectRoot, workflowManifestPath, context, generatedAt: new Date().toISOString(), producerVersion: producer.version, ...request });
+    return result.ok ? result : { ok: false, code: result.code, error: result.reason };
+}
+//# sourceMappingURL=visualChangeHandoff.js.map

package/dist/viewerServer/visualChangeHandoff.js.map

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

package/dist/viewerServer/visualChangeReview.d.ts

@@ -0,0 +1,30 @@
+import { type VisualChangeReviewDecision } from '../application/visualChangeReviewService.js';
+import type { ViewerAuthoringSession } from './authoringSecurity.js';
+export declare function parseVisualChangeReviewRequest(value: unknown): {
+    ok: true;
+    decision: VisualChangeReviewDecision;
+} | {
+    ok: false;
+    error: string;
+};
+export type GovernanceRequest = {
+    kind: 'baseline-approval' | 'external-reference-approval';
+    approvalHandle: string;
+};
+export declare function parseVisualChangeGovernanceRequest(value: unknown): {
+    ok: true;
+    request: GovernanceRequest;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function reviewVisualChangeFromViewer(root: string, session: ViewerAuthoringSession, handle: string, decision: VisualChangeReviewDecision): Promise<{
+    ok: false;
+    status: 404 | 409;
+    error: string;
+} | import("../application/visualChangeReviewService.js").VisualChangeReviewResult>;
+export declare function recordVisualChangeGovernanceFromViewer(root: string, session: ViewerAuthoringSession, handle: string, request: GovernanceRequest): Promise<{
+    ok: false;
+    status: 404 | 409;
+    error: string;
+} | import("../application/visualChangeReviewService.js").VisualChangeGovernanceResult>;

package/dist/viewerServer/visualChangeReview.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import { recordVisualChangeGovernance, reviewVisualChangeWorkflow } from '../application/visualChangeReviewService.js';
+import { decodeArtifactHandle } from './evidence/handles.js';
+import { loadArtifactByHandle } from './evidence/index.js';
+import { resolveContainedDir } from './evidence/pathSafety.js';
+import { resolveVisualChangeTarget } from './visualChangeAuthoring.js';
+export function parseVisualChangeReviewRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value) || Object.keys(value).length !== 1 || !('decision' in value) || !['correction-requested', 'accepted', 'abandoned'].includes(String(value.decision)))
+        return { ok: false, error: 'request body must contain exactly one valid decision' };
+    return { ok: true, decision: value.decision };
+}
+export function parseVisualChangeGovernanceRequest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value) || Object.keys(value).length !== 2)
+        return { ok: false, error: 'request body must contain exactly kind and approvalHandle' };
+    const record = value;
+    if (!['baseline-approval', 'external-reference-approval'].includes(String(record.kind)) || typeof record.approvalHandle !== 'string' || record.approvalHandle.length === 0)
+        return { ok: false, error: 'invalid governance request' };
+    return { ok: true, request: record };
+}
+export async function reviewVisualChangeFromViewer(root, session, handle, decision) {
+    const target = await resolveVisualChangeTarget(root, handle);
+    if (!target.ok)
+        return target;
+    const workflowManifestPath = path.relative(session.projectRoot, target.workflowManifestPath).split(path.sep).join('/');
+    return reviewVisualChangeWorkflow({ projectRoot: session.projectRoot, workflowManifestPath, decision });
+}
+export async function recordVisualChangeGovernanceFromViewer(root, session, handle, request) {
+    const target = await resolveVisualChangeTarget(root, handle);
+    if (!target.ok)
+        return target;
+    const approval = await loadArtifactByHandle(root, request.approvalHandle);
+    if (!approval.ok)
+        return { ok: false, status: approval.reason === 'unknown-handle' ? 404 : 409, error: 'approval handle is not supported' };
+    const expected = request.kind === 'baseline-approval' ? 'baseline-contract' : 'external-reference-approved';
+    if (approval.detail.family !== expected)
+        return { ok: false, status: 409, error: `approval handle must identify ${expected}` };
+    const decoded = decodeArtifactHandle(request.approvalHandle);
+    const directory = decoded.ok ? resolveContainedDir(root, decoded.relativeDir) : undefined;
+    if (directory === undefined)
+        return { ok: false, status: 404, error: 'unknown approval handle' };
+    const artifactPath = path.relative(session.projectRoot, directory).split(path.sep).join('/');
+    const workflowManifestPath = path.relative(session.projectRoot, target.workflowManifestPath).split(path.sep).join('/');
+    const governance = request.kind === 'baseline-approval' ? { kind: request.kind, artifact: approval.detail.artifact, artifactPath } : { kind: request.kind, artifact: approval.detail.artifact, artifactPath };
+    return recordVisualChangeGovernance({ projectRoot: session.projectRoot, workflowManifestPath, governance });
+}
+//# sourceMappingURL=visualChangeReview.js.map

package/dist/viewerServer/visualChangeReview.js.map

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