@dailephd/my-frontend-observer 0.9.1 → 0.10.1

package/dist/application/visualChangeProjectWorkflowService.js

@@ -0,0 +1,376 @@
+import { randomBytes } from 'node:crypto';
+import { readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { readObservationArtifact } from '../artifacts/artifactReader.js';
+import { readExternalReferenceArtifact } from '../artifacts/externalReferenceArtifactReader.js';
+import { readPerChangeContract, readPersistentBaselineContract } from '../artifacts/frontendContractArtifactReader.js';
+import { readVisualAnnotationArtifact } from '../artifacts/visualAnnotationArtifactReader.js';
+import { readVisualChangeWorkflowArtifact } from '../artifacts/visualChangeWorkflowArtifactReader.js';
+import { MAX_VISUAL_CHANGE_ATTEMPTS } from '../domain/visualChangeWorkflow.js';
+import { deriveVisualChangeCycleState } from '../domain/visualChangeCycle.js';
+import { buildReferenceCorrectionAttemptIdentity, buildReferenceCorrectionReviewIdentity } from '../domain/referenceCorrectionIdentity.js';
+import { buildVisualChangeAttemptIdentity } from '../domain/visualChangeWorkflowIdentity.js';
+import { readAliasCatalog } from '../projectWorkflow/aliasCatalog.js';
+import { resolveContainedAcceptancePath } from '../projectWorkflow/checkAcceptance.js';
+import { validateProjectConfig } from '../projectWorkflow/projectConfig.js';
+import { aliasCatalogPath, projectConfigPath, visualChangeOutputLocation } from '../projectWorkflow/projectPaths.js';
+import { checkProject } from './projectCheckService.js';
+import { persistVisualChangeWorkflow } from './visualChangeWorkflowPersistenceService.js';
+const nativeAtomicWrite = async (file, text) => {
+    const temporary = `${file}.tmp-${process.pid}-${randomBytes(6).toString('hex')}`;
+    try {
+        await writeFile(temporary, text, 'utf8');
+        await rename(temporary, file);
+    }
+    catch (error) {
+        await rm(temporary, { force: true }).catch(() => undefined);
+        throw error;
+    }
+};
+const defaults = { persist: persistVisualChangeWorkflow, check: checkProject, atomicWrite: nativeAtomicWrite, now: () => new Date().toISOString() };
+const dependencies = (overrides) => ({ ...defaults, ...overrides });
+function selection(config) {
+    return {
+        ...(config.acceptance?.contract?.changeArtifact === undefined ? {} : { changeContractArtifact: config.acceptance.contract.changeArtifact }),
+        ...(config.acceptance?.reference?.approvedArtifact === undefined ? {} : { approvedReferenceArtifact: config.acceptance.reference.approvedArtifact }),
+        ...(config.acceptance?.reference?.bindingsFile === undefined ? {} : { bindingsFile: config.acceptance.reference.bindingsFile }),
+    };
+}
+function sameSelection(left, right) {
+    return left.changeContractArtifact === right.changeContractArtifact && left.approvedReferenceArtifact === right.approvedReferenceArtifact && left.bindingsFile === right.bindingsFile;
+}
+function failure(code, reason, check) {
+    return { ok: false, code, reason, ...(check === undefined ? {} : { check }) };
+}
+function projectRelative(projectRoot, absolute) {
+    const relative = path.relative(projectRoot, absolute).split(path.sep).join('/');
+    return relative.length > 0 && !relative.startsWith('../') && !path.posix.isAbsolute(relative) ? relative : undefined;
+}
+function resolveProjectPath(projectRoot, portable) {
+    const resolved = resolveContainedAcceptancePath(projectRoot, portable);
+    return resolved.ok ? resolved.path : undefined;
+}
+async function readConfigState(projectRoot) {
+    try {
+        const rawText = await readFile(projectConfigPath(projectRoot), 'utf8');
+        const raw = JSON.parse(rawText);
+        const validated = validateProjectConfig(raw);
+        if (!validated.ok || typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            return failure('project-config-invalid', validated.ok ? 'project configuration root is invalid' : validated.reason);
+        return { ok: true, rawText, raw: raw, config: validated.config };
+    }
+    catch (error) {
+        return failure('project-config-invalid', `project configuration could not be read: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function manifestAt(projectRoot, artifactPath) {
+    const root = resolveProjectPath(projectRoot, artifactPath);
+    return root === undefined ? undefined : path.join(root, 'manifest.json');
+}
+async function verifyScope(projectRoot, scope) {
+    const baselineManifest = manifestAt(projectRoot, scope.baselineObservation.artifactPath);
+    if (baselineManifest === undefined)
+        return failure('workflow-reference-invalid', 'baseline observation path is unsafe or outside the project');
+    const baseline = await readObservationArtifact(baselineManifest);
+    if (!baseline.ok || baseline.artifact.observationId !== scope.baselineObservation.observationId || baseline.artifact.requestId !== scope.baselineObservation.requestId || scope.baselineObservation.artifactId !== scope.baselineObservation.observationId)
+        return failure('workflow-reference-invalid', 'frozen baseline observation identity/path does not match canonical evidence');
+    const annotationManifest = manifestAt(projectRoot, scope.annotationArtifactPath);
+    if (annotationManifest === undefined)
+        return failure('workflow-reference-invalid', 'annotation path is unsafe or outside the project');
+    const annotation = await readVisualAnnotationArtifact(annotationManifest);
+    if (!annotation.ok || annotation.artifact.annotationId !== scope.annotationId)
+        return failure('workflow-reference-invalid', 'annotation identity/path does not match canonical evidence');
+    if (scope.baselineContract !== undefined) {
+        const manifest = manifestAt(projectRoot, scope.baselineContract.artifactPath);
+        const contract = manifest === undefined ? undefined : await readPersistentBaselineContract(manifest);
+        if (contract === undefined || !contract.ok || contract.contract.baselineId !== scope.baselineContract.baselineId)
+            return failure('workflow-reference-invalid', 'baseline contract identity/path does not match canonical evidence');
+    }
+    if (scope.entryMode === 'actual-frontend') {
+        const manifest = manifestAt(projectRoot, scope.changeContract.artifactPath);
+        const contract = manifest === undefined ? undefined : await readPerChangeContract(manifest);
+        if (contract === undefined || !contract.ok || contract.contract.contractId !== scope.changeContract.contractId || contract.contract.contractRequestId !== scope.changeContract.contractRequestId)
+            return failure('workflow-reference-invalid', 'change contract identity/path does not match canonical evidence');
+    }
+    else {
+        const manifest = manifestAt(projectRoot, scope.approvedReference.artifactPath);
+        const reference = manifest === undefined ? undefined : await readExternalReferenceArtifact(manifest);
+        if (reference === undefined || !reference.ok || reference.artifact.referenceId !== scope.approvedReference.referenceId || reference.artifact.referenceRequestId !== scope.approvedReference.referenceRequestId)
+            return failure('workflow-reference-invalid', 'external reference identity/path does not match canonical evidence');
+    }
+    return undefined;
+}
+export async function createProjectVisualChangeWorkflow(input) {
+    const projectRoot = path.resolve(input.projectRoot);
+    const config = await readConfigState(projectRoot);
+    if (!config.ok)
+        return config;
+    const invalid = verifyScope(projectRoot, input.scope);
+    const scopeFailure = await invalid;
+    if (scopeFailure !== undefined)
+        return scopeFailure;
+    const persisted = await dependencies(input.dependencies).persist({ scope: input.scope, outputLocation: visualChangeOutputLocation(), cwd: projectRoot, ...(input.createdAt === undefined ? {} : { createdAt: input.createdAt }) });
+    return persisted.ok ? persisted : failure('workflow-persistence-failure', 'visual-change workflow could not be persisted');
+}
+async function loadWorkflow(projectRoot, workflowManifestPath) {
+    const resolved = resolveProjectPath(projectRoot, workflowManifestPath);
+    if (resolved === undefined)
+        return failure('workflow-invalid', 'workflow manifest path is unsafe or outside the project');
+    const read = await readVisualChangeWorkflowArtifact(resolved);
+    return read.ok ? { ok: true, artifact: read.artifact, manifestPath: resolved } : failure('workflow-invalid', read.reason);
+}
+function updatedConfig(raw, scope, workflowManifestPath, restore) {
+    const acceptance = { ...raw.acceptance };
+    if (scope.entryMode === 'actual-frontend') {
+        const contract = { ...acceptance.contract };
+        contract.changeArtifact = restore === undefined ? scope.changeContract.artifactPath : restore.changeContractArtifact;
+        acceptance.contract = contract;
+    }
+    else {
+        const reference = { ...acceptance.reference };
+        if (restore === undefined) {
+            reference.approvedArtifact = scope.approvedReference.artifactPath;
+            reference.bindingsFile = `${path.posix.dirname(workflowManifestPath)}/bindings.json`;
+        }
+        else {
+            reference.approvedArtifact = restore.approvedReferenceArtifact;
+            if (restore.bindingsFile === undefined)
+                delete reference.bindingsFile;
+            else
+                reference.bindingsFile = restore.bindingsFile;
+        }
+        acceptance.reference = reference;
+    }
+    return { ...raw, acceptance };
+}
+async function verifiedContractIds(projectRoot, config) {
+    if (config.acceptance?.contract === undefined)
+        return { ok: true };
+    const baselineManifest = manifestAt(projectRoot, config.acceptance.contract.baselineArtifact);
+    const changeManifest = manifestAt(projectRoot, config.acceptance.contract.changeArtifact);
+    const baseline = baselineManifest === undefined ? undefined : await readPersistentBaselineContract(baselineManifest);
+    const change = changeManifest === undefined ? undefined : await readPerChangeContract(changeManifest);
+    if (baseline === undefined || change === undefined || !baseline.ok || !change.ok)
+        return failure('acceptance-drift', 'active contract acceptance is invalid');
+    return { ok: true, baselineId: baseline.contract.baselineId, changeId: change.contract.contractId };
+}
+async function persistRevision(projectRoot, source, options, deps) {
+    return deps.persist({ scope: source.scope, attempts: source.attempts, ...(source.activation === undefined ? {} : { activation: source.activation }), ...(source.governanceResults === undefined ? {} : { governanceResults: source.governanceResults }), ...options, supersedesVisualChangeWorkflowId: source.visualChangeWorkflowId, outputLocation: visualChangeOutputLocation(), cwd: projectRoot });
+}
+export async function persistProjectVisualChangeWorkflowRevision(projectRoot, source, options) {
+    return persistRevision(path.resolve(projectRoot), source, options, defaults);
+}
+export async function activateProjectVisualChangeWorkflow(input) {
+    const projectRoot = path.resolve(input.projectRoot);
+    const deps = dependencies(input.dependencies);
+    const state = await readConfigState(projectRoot);
+    if (!state.ok)
+        return state;
+    const loaded = await loadWorkflow(projectRoot, input.workflowManifestPath);
+    if (!loaded.ok)
+        return loaded;
+    const source = loaded.artifact;
+    if (source.activation !== undefined)
+        return failure('acceptance-drift', 'workflow already has an activation record');
+    const scopeFailure = await verifyScope(projectRoot, source.scope);
+    if (scopeFailure !== undefined)
+        return scopeFailure;
+    const acceptance = state.config.acceptance;
+    if (source.scope.entryMode === 'actual-frontend') {
+        if (acceptance?.contract === undefined)
+            return failure('activation-not-configured', 'project contract acceptance is not configured');
+        if (source.scope.baselineContract === undefined || acceptance.contract.baselineArtifact !== source.scope.baselineContract.artifactPath)
+            return failure('acceptance-drift', 'configured baseline contract does not match frozen workflow scope');
+    }
+    else {
+        if (acceptance?.reference === undefined)
+            return failure('activation-not-configured', 'project reference acceptance is not configured');
+        const referenceManifest = manifestAt(projectRoot, source.scope.approvedReference.artifactPath);
+        const reference = referenceManifest === undefined ? undefined : await readExternalReferenceArtifact(referenceManifest);
+        if (reference === undefined || !reference.ok || reference.artifact.lifecycle.state !== 'approved')
+            return failure('workflow-reference-invalid', 'workflow reference is not approved');
+        if (acceptance.contract === undefined ? source.scope.baselineContract !== undefined : source.scope.baselineContract === undefined || acceptance.contract.baselineArtifact !== source.scope.baselineContract.artifactPath)
+            return failure('acceptance-drift', 'project contract acceptance does not match frozen reference workflow scope');
+    }
+    const before = selection(state.config);
+    const workflowRelative = projectRelative(projectRoot, loaded.manifestPath);
+    if (workflowRelative === undefined)
+        return failure('workflow-invalid', 'workflow path is outside the project');
+    const nextRaw = updatedConfig(state.raw, source.scope, workflowRelative);
+    const validated = validateProjectConfig(nextRaw);
+    if (!validated.ok)
+        return failure('project-config-invalid', validated.reason);
+    const nextText = `${JSON.stringify(nextRaw, null, 2)}\n`;
+    const after = selection(validated.config);
+    try {
+        await deps.atomicWrite(projectConfigPath(projectRoot), nextText);
+    }
+    catch (error) {
+        return failure('project-config-write-failure', `project configuration could not be written: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const persisted = await persistRevision(projectRoot, source, { activation: { before, after, activatedAt: deps.now() } }, deps);
+    if (persisted.ok)
+        return persisted;
+    try {
+        await deps.atomicWrite(projectConfigPath(projectRoot), state.rawText);
+    }
+    catch (error) {
+        return failure('partial-state-failure', `workflow persistence failed and project acceptance may require manual repair because rollback failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return failure('workflow-persistence-failure', 'workflow activation revision could not be persisted; original project configuration was restored');
+}
+export async function restoreProjectVisualChangeWorkflowAcceptance(input) {
+    const projectRoot = path.resolve(input.projectRoot);
+    const deps = dependencies(input.dependencies);
+    const state = await readConfigState(projectRoot);
+    if (!state.ok)
+        return state;
+    const loaded = await loadWorkflow(projectRoot, input.workflowManifestPath);
+    if (!loaded.ok)
+        return loaded;
+    const source = loaded.artifact;
+    if (source.activation === undefined)
+        return failure('activation-not-configured', 'workflow has no activation record');
+    if (source.activation.restoredAt !== undefined)
+        return failure('activation-already-restored', 'workflow activation has already been restored');
+    if (!sameSelection(selection(state.config), source.activation.after))
+        return failure('acceptance-drift', 'current project acceptance differs from the activated selection');
+    const nextRaw = updatedConfig(state.raw, source.scope, input.workflowManifestPath, source.activation.before);
+    const validated = validateProjectConfig(nextRaw);
+    if (!validated.ok)
+        return failure('project-config-invalid', validated.reason);
+    const nextText = `${JSON.stringify(nextRaw, null, 2)}\n`;
+    try {
+        await deps.atomicWrite(projectConfigPath(projectRoot), nextText);
+    }
+    catch (error) {
+        return failure('project-config-write-failure', `project configuration could not be restored: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const persisted = await persistRevision(projectRoot, source, { activation: { ...source.activation, restoredAt: deps.now() } }, deps);
+    if (persisted.ok)
+        return persisted;
+    try {
+        await deps.atomicWrite(projectConfigPath(projectRoot), state.rawText);
+    }
+    catch (error) {
+        return failure('partial-state-failure', `restore revision persistence failed and project acceptance may require manual repair because compensation failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return failure('workflow-persistence-failure', 'restore revision could not be persisted; activated project configuration was reinstated');
+}
+async function exactBaselineAlias(projectRoot, config, workflow) {
+    const catalog = await readAliasCatalog(aliasCatalogPath(projectRoot));
+    if (!catalog.ok)
+        return undefined;
+    const frozen = workflow.scope.baselineObservation;
+    const exact = ([, value]) => value.observationId === frozen.observationId && value.requestId === frozen.requestId && `.frontend-observer/evidence/${value.relativeArtifactDir}` === frozen.artifactPath;
+    const preferred = catalog.catalog.observations[config.defaultBaseline];
+    if (preferred !== undefined && exact([config.defaultBaseline, preferred]))
+        return config.defaultBaseline;
+    return Object.entries(catalog.catalog.observations).filter(exact).map(([alias]) => alias).sort()[0];
+}
+export function projectVisualChangeCheckSnapshot(result, verified) {
+    const blockerTruncated = result.blockers.length > 50;
+    return {
+        status: result.status, baselineObservationId: result.baseline.observationId, candidateObservationId: result.candidate.observationId,
+        ...(result.comparison.comparisonId === undefined || result.comparison.artifactPath === undefined ? {} : { comparison: { artifactId: result.comparison.comparisonId, artifactPath: result.comparison.artifactPath } }),
+        ...(result.contract.evaluationId === undefined || result.contract.artifactPath === undefined ? {} : { contractEvaluation: { artifactId: result.contract.evaluationId, artifactPath: result.contract.artifactPath } }),
+        ...(verified.activeBaselineContractId === undefined ? {} : { activeBaselineContractId: verified.activeBaselineContractId }), ...(verified.activeChangeContractId === undefined ? {} : { activeChangeContractId: verified.activeChangeContractId }),
+        ...(result.reference.referenceId === undefined ? {} : { externalReferenceId: result.reference.referenceId }), ...(result.reference.fidelityState === undefined ? {} : { referenceFidelityState: result.reference.fidelityState }),
+        failedClauseIds: result.contract.failedClauses.map((item) => item.clauseId), unavailableClauseIds: result.contract.unavailableClauses.map((item) => item.clauseId),
+        failedReferenceRequirementIds: result.reference.failedRequirements.map((item) => item.requirementId), unavailableReferenceRequirementIds: result.reference.unavailableRequirements.map((item) => item.requirementId),
+        unexpectedChangeCount: result.contract.unexpectedChanges.length, blockerCodes: result.blockers.slice(0, 50).map((item) => item.code), blockerReasons: result.blockers.slice(0, 50).map((item) => item.message),
+        truncated: result.limits.truncated || result.contract.truncated || result.reference.truncated || blockerTruncated,
+    };
+}
+export async function readProjectVisualChangeCycle(projectRootInput, workflowManifestPath) { const loaded = await loadWorkflow(path.resolve(projectRootInput), workflowManifestPath); return loaded.ok ? { ok: true, workflow: loaded.artifact, cycle: deriveVisualChangeCycleState(loaded.artifact) } : loaded; }
+/** One readiness owner for canonical check recording and on-demand handoff preparation. */
+export async function prepareActiveVisualChangeWorkflow(projectRootInput, workflowManifestPath) {
+    const projectRoot = path.resolve(projectRootInput);
+    const state = await readConfigState(projectRoot);
+    if (!state.ok)
+        return state;
+    const loaded = await loadWorkflow(projectRoot, workflowManifestPath);
+    if (!loaded.ok)
+        return loaded;
+    const workflow = loaded.artifact;
+    if (workflow.activation === undefined)
+        return failure('activation-not-configured', 'workflow has not been activated');
+    if (workflow.activation.restoredAt !== undefined)
+        return failure('activation-already-restored', 'workflow activation has been restored');
+    if (!sameSelection(selection(state.config), workflow.activation.after))
+        return failure('acceptance-drift', 'current project acceptance differs from the activated workflow');
+    const scopeFailure = await verifyScope(projectRoot, workflow.scope);
+    if (scopeFailure !== undefined)
+        return failure('acceptance-drift', scopeFailure.reason);
+    const alias = await exactBaselineAlias(projectRoot, state.config, workflow);
+    if (alias === undefined)
+        return failure('baseline-drift', 'no catalog alias resolves to the exact frozen baseline observation');
+    const ids = await verifiedContractIds(projectRoot, state.config);
+    if (!ids.ok)
+        return ids;
+    if (workflow.scope.baselineContract !== undefined && ids.baselineId !== workflow.scope.baselineContract.baselineId)
+        return failure('acceptance-drift', 'active baseline contract identity differs from frozen workflow scope');
+    if (workflow.scope.entryMode === 'actual-frontend' && ids.changeId !== workflow.scope.changeContract.contractId)
+        return failure('acceptance-drift', 'active change contract identity differs from frozen workflow scope');
+    if (workflow.scope.entryMode === 'reference') {
+        const active = state.config.acceptance?.reference;
+        const expectedBindings = workflow.activation.after.bindingsFile;
+        if (active?.approvedArtifact !== workflow.scope.approvedReference.artifactPath || active.bindingsFile !== expectedBindings)
+            return failure('acceptance-drift', 'active reference or bindings path differs from frozen workflow scope');
+        const reread = await readVisualChangeWorkflowArtifact(loaded.manifestPath);
+        if (!reread.ok)
+            return failure('acceptance-drift', 'workflow-owned bindings no longer match frozen declarations');
+    }
+    return { ok: true, context: { projectRoot, workflow: { ...workflow, activation: workflow.activation }, workflowManifestPath: loaded.manifestPath, config: state.config, baselineAlias: alias, verifiedContractIds: ids } };
+}
+export async function runProjectVisualChangeCheck(input) {
+    const deps = dependencies(input.dependencies);
+    const preflight = await readProjectVisualChangeCycle(input.projectRoot, input.workflowManifestPath);
+    if (!preflight.ok)
+        return preflight;
+    if (preflight.cycle === 'review-required')
+        return failure('review-required', 'the latest attempt requires explicit human review before another check');
+    if (preflight.cycle === 'accepted')
+        return failure('workflow-accepted', 'accepted workflow is terminal');
+    if (preflight.cycle === 'abandoned')
+        return failure('workflow-abandoned', 'abandoned workflow is terminal');
+    const readiness = await prepareActiveVisualChangeWorkflow(input.projectRoot, input.workflowManifestPath);
+    if (!readiness.ok)
+        return readiness;
+    const { projectRoot, workflow, baselineAlias: alias, verifiedContractIds: ids } = readiness.context;
+    const result = await deps.check(projectRoot, alias);
+    if (result.baseline === undefined || result.candidate === undefined)
+        return failure('candidate-not-produced', 'canonical check did not produce both baseline and candidate observations; no attempt was recorded', result);
+    if (result.baseline.observationId !== workflow.scope.baselineObservation.observationId || result.baseline.requestId !== workflow.scope.baselineObservation.requestId)
+        return failure('check-scope-mismatch', 'canonical check baseline identity differs from frozen workflow scope', result);
+    if (workflow.scope.entryMode === 'reference' && result.reference.referenceId !== undefined && result.reference.referenceId !== workflow.scope.approvedReference.referenceId)
+        return failure('check-scope-mismatch', 'canonical reference result identity differs from frozen workflow scope', result);
+    const candidatePath = resolveProjectPath(projectRoot, result.candidate.artifactPath);
+    if (candidatePath === undefined)
+        return failure('check-scope-mismatch', 'canonical candidate path is unsafe or outside the project', result);
+    const attemptId = buildVisualChangeAttemptIdentity(workflow.visualChangeRequestId, result.candidate.observationId);
+    if (workflow.attempts.some((attempt) => attempt.visualChangeAttemptId === attemptId))
+        return failure('duplicate-attempt', 'this candidate observation is already recorded in workflow history', result);
+    if (workflow.attempts.length >= MAX_VISUAL_CHANGE_ATTEMPTS)
+        return failure('attempt-limit-reached', `workflow already contains ${MAX_VISUAL_CHANGE_ATTEMPTS} attempts`, result);
+    let referenceCorrectionAttemptId;
+    if (workflow.scope.entryMode === 'reference' && workflow.scope.baselineContract !== undefined && readiness.context.config.acceptance?.contract !== undefined) {
+        const baselineManifest = manifestAt(projectRoot, workflow.scope.baselineContract.artifactPath);
+        const changeManifest = manifestAt(projectRoot, readiness.context.config.acceptance.contract.changeArtifact);
+        const baseline = baselineManifest === undefined ? undefined : await readPersistentBaselineContract(baselineManifest);
+        const change = changeManifest === undefined ? undefined : await readPerChangeContract(changeManifest);
+        if (baseline?.ok && change?.ok && baseline.contract.sourceObservation.observationId === workflow.scope.baselineObservation.observationId) {
+            const reviewId = buildReferenceCorrectionReviewIdentity(workflow.scope.approvedReference.referenceRequestId, workflow.scope.baselineObservation.observationId, baseline.contract.baselineId, baseline.contract.clauses, change.contract.contractId, change.contract.clauses, workflow.scope.bindings);
+            referenceCorrectionAttemptId = buildReferenceCorrectionAttemptIdentity(reviewId, result.candidate.observationId);
+        }
+    }
+    const attempt = {
+        visualChangeAttemptId: attemptId, ...(workflow.attempts.length === 0 ? {} : { priorVisualChangeAttemptId: workflow.attempts[workflow.attempts.length - 1].visualChangeAttemptId }),
+        candidateObservation: { artifactId: result.candidate.observationId, observationId: result.candidate.observationId, requestId: result.candidate.requestId, artifactPath: result.candidate.artifactPath },
+        check: projectVisualChangeCheckSnapshot(result, { ...(ids.baselineId === undefined ? {} : { activeBaselineContractId: ids.baselineId }), ...(ids.changeId === undefined ? {} : { activeChangeContractId: ids.changeId }) }),
+        ...(input.coordination === undefined ? {} : { coordination: input.coordination }), ...(referenceCorrectionAttemptId === undefined ? {} : { referenceCorrectionAttemptId }), review: { state: 'pending' }, recordedAt: deps.now(),
+    };
+    const persisted = await deps.persist({ scope: workflow.scope, attempts: [...workflow.attempts, attempt], activation: workflow.activation, ...(workflow.governanceResults === undefined ? {} : { governanceResults: workflow.governanceResults }), supersedesVisualChangeWorkflowId: workflow.visualChangeWorkflowId, outputLocation: visualChangeOutputLocation(), cwd: projectRoot });
+    return persisted.ok ? { ...persisted, check: result, attempt } : failure('workflow-persistence-failure', 'canonical check evidence exists, but visual-change attempt history was not updated', result);
+}
+//# sourceMappingURL=visualChangeProjectWorkflowService.js.map

package/dist/application/visualChangeProjectWorkflowService.js.map

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

package/dist/application/visualChangeReviewService.d.ts

@@ -0,0 +1,50 @@
+import type { ExternalReferenceArtifact } from '../domain/externalReference.js';
+import type { PersistentBaselineContract } from '../domain/frontendContracts.js';
+import type { VisualChangeReviewState } from '../domain/visualChangeWorkflow.js';
+export type VisualChangeReviewDecision = Exclude<VisualChangeReviewState, 'pending'>;
+export type VisualChangeReviewFailureCode = 'workflow-invalid' | 'no-attempts' | 'invalid-transition' | 'acceptance-requires-pass' | 'workflow-inactive' | 'workflow-restored' | 'acceptance-drift' | 'baseline-drift' | 'governance-requires-accepted' | 'governance-mismatch' | 'governance-already-recorded' | 'persistence-failure';
+export type VisualChangeReviewResult = {
+    ok: true;
+    visualChangeRequestId: string;
+    visualChangeWorkflowId: string;
+    visualChangeAttemptId: string;
+    review: {
+        state: VisualChangeReviewDecision;
+        decidedAt: string;
+    };
+} | {
+    ok: false;
+    code: VisualChangeReviewFailureCode;
+    reason: string;
+};
+export type VisualChangeGovernanceInput = {
+    kind: 'baseline-approval';
+    artifact: PersistentBaselineContract;
+    artifactPath: string;
+} | {
+    kind: 'external-reference-approval';
+    artifact: ExternalReferenceArtifact;
+    artifactPath: string;
+};
+export type VisualChangeGovernanceResult = {
+    ok: true;
+    visualChangeRequestId: string;
+    visualChangeWorkflowId: string;
+    kind: VisualChangeGovernanceInput['kind'];
+    artifactId: string;
+} | {
+    ok: false;
+    code: VisualChangeReviewFailureCode;
+    reason: string;
+};
+export declare function reviewVisualChangeWorkflow(input: {
+    projectRoot: string;
+    workflowManifestPath: string;
+    decision: VisualChangeReviewDecision;
+    now?: () => string;
+}): Promise<VisualChangeReviewResult>;
+export declare function recordVisualChangeGovernance(input: {
+    projectRoot: string;
+    workflowManifestPath: string;
+    governance: VisualChangeGovernanceInput;
+}): Promise<VisualChangeGovernanceResult>;

package/dist/application/visualChangeReviewService.js

@@ -0,0 +1,69 @@
+import path from 'node:path';
+import { readVisualChangeWorkflowArtifact } from '../artifacts/visualChangeWorkflowArtifactReader.js';
+import { prepareActiveVisualChangeWorkflow, persistProjectVisualChangeWorkflowRevision } from './visualChangeProjectWorkflowService.js';
+const fail = (code, reason) => ({ ok: false, code, reason });
+async function load(projectRoot, manifestPath) {
+    const root = path.resolve(projectRoot);
+    const absolute = path.resolve(root, manifestPath);
+    const relative = path.relative(root, absolute);
+    if (relative.startsWith('..') || path.isAbsolute(relative))
+        return fail('workflow-invalid', 'workflow path is outside the project');
+    const read = await readVisualChangeWorkflowArtifact(absolute);
+    return read.ok ? { ok: true, workflow: read.artifact } : fail('workflow-invalid', read.reason);
+}
+function readinessCode(code) { return code === 'activation-not-configured' ? 'workflow-inactive' : code === 'activation-already-restored' ? 'workflow-restored' : code === 'baseline-drift' ? 'baseline-drift' : 'acceptance-drift'; }
+export async function reviewVisualChangeWorkflow(input) {
+    const loaded = await load(input.projectRoot, input.workflowManifestPath);
+    if (!loaded.ok)
+        return loaded;
+    const source = loaded.workflow;
+    const latest = source.attempts.at(-1);
+    if (latest === undefined)
+        return fail('no-attempts', 'workflow has no attempt to review');
+    const current = latest.review.state;
+    const allowed = current === 'pending' ? ['correction-requested', 'accepted', 'abandoned'].includes(input.decision) : current === 'correction-requested' && input.decision === 'abandoned';
+    if (!allowed)
+        return fail('invalid-transition', `review transition ${current} -> ${input.decision} is not allowed`);
+    if (input.decision === 'accepted' && latest.check.status !== 'PASS')
+        return fail('acceptance-requires-pass', 'only the latest canonical PASS attempt may be accepted');
+    if (input.decision !== 'abandoned') {
+        const ready = await prepareActiveVisualChangeWorkflow(input.projectRoot, input.workflowManifestPath);
+        if (!ready.ok)
+            return fail(readinessCode(ready.code), ready.reason);
+    }
+    const decidedAt = (input.now ?? (() => new Date().toISOString()))();
+    const review = { state: input.decision, decidedAt };
+    const attempts = source.attempts.map((attempt, index) => index === source.attempts.length - 1 ? { ...attempt, review } : attempt);
+    const persisted = await persistProjectVisualChangeWorkflowRevision(input.projectRoot, source, { attempts });
+    return persisted.ok ? { ok: true, visualChangeRequestId: persisted.visualChangeRequestId, visualChangeWorkflowId: persisted.visualChangeWorkflowId, visualChangeAttemptId: latest.visualChangeAttemptId, review } : fail('persistence-failure', 'review revision could not be persisted');
+}
+export async function recordVisualChangeGovernance(input) {
+    const loaded = await load(input.projectRoot, input.workflowManifestPath);
+    if (!loaded.ok)
+        return loaded;
+    const source = loaded.workflow;
+    const latest = source.attempts.at(-1);
+    if (latest?.review.state !== 'accepted')
+        return fail('governance-requires-accepted', 'governance results may be recorded only after human acceptance');
+    const existing = source.governanceResults ?? {};
+    if (input.governance.kind === 'baseline-approval') {
+        if (existing.baselineApproval !== undefined)
+            return fail('governance-already-recorded', 'baseline approval is already recorded');
+        const origin = input.governance.artifact.sourceObservation;
+        if (origin.observationId !== latest.candidateObservation.observationId || origin.requestId !== latest.candidateObservation.requestId)
+            return fail('governance-mismatch', 'baseline approval does not belong to the accepted candidate');
+        const artifactId = input.governance.artifact.baselineId;
+        const persisted = await persistProjectVisualChangeWorkflowRevision(input.projectRoot, source, { governanceResults: { ...existing, baselineApproval: { artifactId, artifactPath: input.governance.artifactPath } } });
+        return persisted.ok ? { ok: true, visualChangeRequestId: persisted.visualChangeRequestId, visualChangeWorkflowId: persisted.visualChangeWorkflowId, kind: input.governance.kind, artifactId } : fail('persistence-failure', 'governance revision could not be persisted');
+    }
+    if (source.scope.entryMode !== 'reference')
+        return fail('governance-mismatch', 'external-reference governance requires a reference workflow');
+    if (existing.externalReferenceApproval !== undefined)
+        return fail('governance-already-recorded', 'external-reference approval is already recorded');
+    if (input.governance.artifact.lifecycle.state !== 'approved' || input.governance.artifact.supersedesReferenceId !== source.scope.approvedReference.referenceId)
+        return fail('governance-mismatch', 'approved reference does not explicitly supersede the frozen reference');
+    const artifactId = input.governance.artifact.referenceId;
+    const persisted = await persistProjectVisualChangeWorkflowRevision(input.projectRoot, source, { governanceResults: { ...existing, externalReferenceApproval: { artifactId, artifactPath: input.governance.artifactPath } } });
+    return persisted.ok ? { ok: true, visualChangeRequestId: persisted.visualChangeRequestId, visualChangeWorkflowId: persisted.visualChangeWorkflowId, kind: input.governance.kind, artifactId } : fail('persistence-failure', 'governance revision could not be persisted');
+}
+//# sourceMappingURL=visualChangeReviewService.js.map

package/dist/application/visualChangeReviewService.js.map

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

package/dist/application/visualChangeWorkflowPersistenceService.d.ts

@@ -0,0 +1,26 @@
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { VisualChangeActivationRecord, VisualChangeAttemptRecord, VisualChangeGovernanceResults, VisualChangeScope } from '../domain/visualChangeWorkflow.js';
+import { type WriteVisualChangeWorkflowArtifactOptions } from '../artifacts/visualChangeWorkflowArtifactWriter.js';
+export interface PersistVisualChangeWorkflowOptions {
+    scope: VisualChangeScope;
+    attempts?: VisualChangeAttemptRecord[];
+    supersedesVisualChangeWorkflowId?: string;
+    activation?: VisualChangeActivationRecord;
+    governanceResults?: VisualChangeGovernanceResults;
+    outputLocation: string;
+    cwd?: string;
+    writerOptions?: Pick<WriteVisualChangeWorkflowArtifactOptions, 'beforeRename'>;
+    createdAt?: string;
+}
+export type ApplicationPersistVisualChangeWorkflowResult = {
+    ok: true;
+    visualChangeRequestId: string;
+    visualChangeWorkflowId: string;
+    artifactRoot: string;
+    manifestPath: string;
+    bindingsPath?: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+export declare function persistVisualChangeWorkflow(options: PersistVisualChangeWorkflowOptions): Promise<ApplicationPersistVisualChangeWorkflowResult>;

package/dist/application/visualChangeWorkflowPersistenceService.js

@@ -0,0 +1,15 @@
+import { getProducerInfo } from '../domain/schema.js';
+import { VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND, VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION } from '../domain/visualChangeWorkflow.js';
+import { buildVisualChangeRequestIdentity, buildVisualChangeWorkflowInstanceIdentity } from '../domain/visualChangeWorkflowIdentity.js';
+import { computeVisualChangeBindingsSha256, serializeVisualChangeBindings, writeVisualChangeWorkflowArtifact } from '../artifacts/visualChangeWorkflowArtifactWriter.js';
+export async function persistVisualChangeWorkflow(options) {
+    const visualChangeRequestId = buildVisualChangeRequestIdentity(options.scope);
+    const visualChangeWorkflowId = buildVisualChangeWorkflowInstanceIdentity(visualChangeRequestId);
+    const bindingContent = options.scope.entryMode === 'reference' ? serializeVisualChangeBindings(options.scope.bindings) : undefined;
+    const artifact = { artifactKind: VISUAL_CHANGE_WORKFLOW_ARTIFACT_KIND, schemaVersion: VISUAL_CHANGE_WORKFLOW_SCHEMA_VERSION, visualChangeRequestId, visualChangeWorkflowId, ...(options.supersedesVisualChangeWorkflowId === undefined ? {} : { supersedesVisualChangeWorkflowId: options.supersedesVisualChangeWorkflowId }), producer: getProducerInfo(), scope: options.scope, attempts: options.attempts ?? [], ...(bindingContent === undefined ? {} : { bindings: { path: 'bindings.json', sha256: computeVisualChangeBindingsSha256(bindingContent), declarationCount: options.scope.entryMode === 'reference' ? options.scope.bindings.length : 0 } }), ...(options.activation === undefined ? {} : { activation: options.activation }), ...(options.governanceResults === undefined ? {} : { governanceResults: options.governanceResults }), provenance: { createdAt: options.createdAt ?? new Date().toISOString() } };
+    const persisted = await writeVisualChangeWorkflowArtifact(artifact, options.outputLocation, { ...(options.cwd === undefined ? {} : { cwd: options.cwd }), ...options.writerOptions });
+    if (!persisted.ok)
+        return persisted;
+    return { ok: true, visualChangeRequestId, visualChangeWorkflowId, artifactRoot: persisted.artifactRoot, manifestPath: persisted.manifestPath, ...(persisted.bindingsPath === undefined ? {} : { bindingsPath: persisted.bindingsPath }) };
+}
+//# sourceMappingURL=visualChangeWorkflowPersistenceService.js.map

package/dist/application/visualChangeWorkflowPersistenceService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualChangeWorkflowPersistenceService.js","sourceRoot":"","sources":["../../src/application/visualChangeWorkflowPersistenceService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,oCAAoC,EAAE,qCAAqC,EAAE,MAAM,mCAAmC,CAAC;AAChI,OAAO,EAAE,gCAAgC,EAAE,yCAAyC,EAAE,MAAM,2CAA2C,CAAC;AACxI,OAAO,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,iCAAiC,EAAiD,MAAM,oDAAoD,CAAC;AAGxN,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAA2C;IAC3F,MAAM,qBAAqB,GAAG,gCAAgC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAAC,MAAM,sBAAsB,GAAG,yCAAyC,CAAC,qBAAqB,CAAC,CAAC;IAC/K,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnI,MAAM,QAAQ,GAAiC,EAAE,YAAY,EAAE,oCAAoC,EAAE,aAAa,EAAE,qCAAqC,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,gCAAgC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gCAAgC,EAAE,OAAO,CAAC,gCAAgC,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iCAAiC,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;IACh6B,MAAM,SAAS,GAAG,MAAM,iCAAiC,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACtL,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;AAC5O,CAAC"}