import type { ExecutionOptions } from "../../ports/AnalysisProvider.js"; import { resolveEvidenceRequest, type EvidenceLookup, } from "../EvidenceInputResolver.js"; import { compareApplicationVersionsRequestSchema, compareJavaScriptExportShapesRequestSchema, compareSourceToBundleRequestSchema, traceApplicationFeatureRequestSchema, } from "../../contracts/javascript/applicationWorkflowInputContracts.js"; import type { EvidenceWorkflowExecution } from "../investigation/EvidenceWorkflowExecution.js"; import type { ArtifactResourceScope } from "../../resources/index.js"; import type { ResolvedSourceToBundleReference } from "./SourceToBundleReference.js"; import type { AnalysisError } from "../../domain/analysisErrorBase.js"; import { analysisInputErrorFromIssues } from "../../domain/inputIssueProjection.js"; import { compareJavaScriptApplicationVersions } from "../../domain/javascript/javascriptApplicationVersionComparison.js"; import { applicationVersionIdentitiesSchema, type ApplicationVersionComparisonResult, } from "../../domain/javascript/javascriptApplicationVersionComparisonSchemas.js"; import { compareJavaScriptExportShapes } from "../../domain/javascript/javascriptExportShapeComparison.js"; import { javaScriptExportShapeIdentitiesSchema, type JavaScriptExportShapeComparisonResult, } from "../../domain/javascript/javascriptExportShapeComparisonSchemas.js"; import { traceApplicationFeature } from "../../domain/javascript/javascriptFeatureTrace.js"; import { applicationTraceIdentitiesSchema, type ApplicationFeatureTraceResult, } from "../../domain/javascript/javascriptFeatureTraceSchemas.js"; import { err, ok, type Result } from "../../domain/result.js"; import { compareSourceToBundle } from "../../domain/javascript/sourceToBundleComparison.js"; import type { SourceToBundleComparisonResult } from "../../domain/javascript/sourceToBundleComparisonSchemas.js"; import { applicationGraphEvidenceInputError, applicationGraphSubjectTarget, parseApplicationGraphEvidence, parseNativeApplicationEvidence, type ApplicationGraphEvidenceSource, } from "./JavaScriptApplicationEvidenceGraph.js"; import { createApplicationFeatureTraceEvidence, createApplicationVersionComparisonEvidence, createJavaScriptExportShapeComparisonEvidence, createSourceToBundleComparisonEvidence, } from "./JavaScriptApplicationWorkflowEvidence.js"; /** Completed workflow facts and authenticated sources retained for adapter delivery. */ export interface ApplicationWorkflowExecution< Projection, > extends EvidenceWorkflowExecution { readonly result: Projection; } /** Authenticate the resolved graph pair at the owning domain boundary. */ const parseApplicationGraphPair = ( operation: string, input: { readonly left: unknown; readonly right: unknown }, ): Result< { readonly left: ApplicationGraphEvidenceSource; readonly right: ApplicationGraphEvidenceSource; }, AnalysisError > => { const left = parseApplicationGraphEvidence(input.left, ["left"]); if (!left.ok) return err(applicationGraphEvidenceInputError(operation, left.error)); const right = parseApplicationGraphEvidence(input.right, ["right"]); if (!right.ok) return err(applicationGraphEvidenceInputError(operation, right.error)); return ok({ left: left.value, right: right.value, }); }; /** Authenticate Evidence and derive one bounded cross-layer feature trace. */ export const traceApplicationFeatureEvidence = ( rawInput: unknown, lookup?: EvidenceLookup, options: Pick = {}, ): Result< ApplicationWorkflowExecution, AnalysisError > => { const operation = "trace_application_feature"; const request = resolveEvidenceRequest( operation, rawInput, traceApplicationFeatureRequestSchema, lookup, options, ); if (!request.ok) return request; const input = request.value.input; const sourceResult = parseApplicationGraphEvidence(input.application, [ "application", ]); if (!sourceResult.ok) return err( applicationGraphEvidenceInputError(operation, sourceResult.error), ); const nativeResult = parseNativeApplicationEvidence( input.native_observations, ["native_observations"], ); if (!nativeResult.ok) return err( applicationGraphEvidenceInputError(operation, nativeResult.error), ); const source = sourceResult.value; const nativeEvidence = nativeResult.value; const identities = applicationTraceIdentitiesSchema.safeParse({ native_observations: nativeEvidence, }); if (!identities.success) return err( analysisInputErrorFromIssues(operation, identities.error.issues, input), ); const result = traceApplicationFeature({ sourceEvidenceId: source.evidence.evidence_id, graph: source.graph, semanticGraph: source.semanticGraph, ...(input.semantic_page === undefined ? {} : { semanticPage: input.semantic_page }), nativeEvidence, seed: input.seed, direction: input.direction, }); const evidence = createApplicationFeatureTraceEvidence( applicationGraphSubjectTarget(source), { application_evidence_id: source.evidence.evidence_id, native_evidence_ids: nativeEvidence.map(({ evidence_id: id }) => id), seed: input.seed, direction: input.direction, ...(input.semantic_page === undefined ? {} : { semantic_page: input.semantic_page }), }, result, ); return ok({ evidence, result, sources: [source.evidence, ...nativeEvidence], }); }; /** Authenticate both graphs and derive a tiered cross-version change graph. */ export const compareApplicationVersionsEvidence = ( rawInput: unknown, lookup?: EvidenceLookup, options: Pick = {}, ): Result< ApplicationWorkflowExecution, AnalysisError > => { const operation = "compare_application_versions"; const request = resolveEvidenceRequest( operation, rawInput, compareApplicationVersionsRequestSchema, lookup, options, ); if (!request.ok) return request; const input = request.value.input; const pair = parseApplicationGraphPair(operation, input); if (!pair.ok) return pair; const { left, right } = pair.value; const leftNativeResult = parseNativeApplicationEvidence( input.left_native_observations, ["left_native_observations"], ); if (!leftNativeResult.ok) return err( applicationGraphEvidenceInputError(operation, leftNativeResult.error), ); const rightNativeResult = parseNativeApplicationEvidence( input.right_native_observations, ["right_native_observations"], ); if (!rightNativeResult.ok) return err( applicationGraphEvidenceInputError(operation, rightNativeResult.error), ); const leftNative = leftNativeResult.value; const rightNative = rightNativeResult.value; const identities = applicationVersionIdentitiesSchema.safeParse({ left: left.evidence, right: right.evidence, left_native_observations: leftNative, right_native_observations: rightNative, }); if (!identities.success) return err( analysisInputErrorFromIssues(operation, identities.error.issues, input), ); const result = compareJavaScriptApplicationVersions({ left: { evidenceId: left.evidence.evidence_id, rootArtifactSha256: left.rootArtifactSha256, graph: left.graph, }, right: { evidenceId: right.evidence.evidence_id, rootArtifactSha256: right.rootArtifactSha256, graph: right.graph, }, leftNativeEvidence: leftNative, rightNativeEvidence: rightNative, }); const evidence = createApplicationVersionComparisonEvidence( { left_evidence_id: left.evidence.evidence_id, right_evidence_id: right.evidence.evidence_id, left_native_evidence_ids: leftNative.map(({ evidence_id: id }) => id), right_native_evidence_ids: rightNative.map(({ evidence_id: id }) => id), }, result, ); return ok({ evidence, result, sources: [left.evidence, right.evidence, ...leftNative, ...rightNative], }); }; /** Select the application record and historical graph through their shared owners. */ export const executeSourceToBundleComparison = async ( rawInput: unknown, lookup: EvidenceLookup | undefined, resources: ArtifactResourceScope, options: Pick & { /** The reference file path as the caller spelled it. */ readonly requestedReferencePath?: string; } = {}, ): Promise< Result< ApplicationWorkflowExecution, AnalysisError > > => { const selected = resolveEvidenceRequest( "compare_source_to_bundle", rawInput, compareSourceToBundleRequestSchema, lookup, options, ); if (!selected.ok) return selected; const { resolveSourceToBundleReference } = await import("./SourceToBundleReference.js"); const reference = await resolveSourceToBundleReference( selected.value.input.reference, options.signal, resources, options.requestedReferencePath, ); return reference.ok ? compareSourceToBundleEvidence({ ...reference.value, application: selected.value.input.application, }) : reference; }; /** Compare an owner-parsed historical graph with an unadmitted application source. */ const compareSourceToBundleEvidence = ( input: ResolvedSourceToBundleReference & { readonly application: unknown }, ): Result< ApplicationWorkflowExecution, AnalysisError > => { const operation = "compare_source_to_bundle"; const applicationResult = parseApplicationGraphEvidence(input.application, [ "application", ]); if (!applicationResult.ok) return err( applicationGraphEvidenceInputError(operation, applicationResult.error), ); const application = applicationResult.value; const result = compareSourceToBundle({ reference: input.reference, application: { evidenceId: application.evidence.evidence_id, rootArtifactSha256: application.rootArtifactSha256, graph: application.graph, }, }); const evidence = createSourceToBundleComparisonEvidence( { reference_root_sha256: input.reference.root_sha256, application_evidence_id: application.evidence.evidence_id, ...(input.reference_source === undefined ? {} : { reference_source: input.reference_source }), }, result, ); return ok({ evidence, result, sources: [application.evidence] }); }; /** * Authenticate both graphs and compare one exact export return shape. * @public */ export const compareJavaScriptExportShapesEvidence = ( rawInput: unknown, lookup?: EvidenceLookup, options: Pick = {}, ): Result< ApplicationWorkflowExecution, AnalysisError > => { const operation = "compare_javascript_export_shapes"; const request = resolveEvidenceRequest( operation, rawInput, compareJavaScriptExportShapesRequestSchema, lookup, options, ); if (!request.ok) return request; const input = request.value.input; const pair = parseApplicationGraphPair(operation, input); if (!pair.ok) return pair; const { left, right } = pair.value; const identities = javaScriptExportShapeIdentitiesSchema.safeParse({ left: left.evidence, right: right.evidence, }); if (!identities.success) return err( analysisInputErrorFromIssues(operation, identities.error.issues, input), ); const result = compareJavaScriptExportShapes({ left: { evidenceId: left.evidence.evidence_id, graph: left.graph, modulePath: input.left_module_path, exportName: input.left_export_name, }, right: { evidenceId: right.evidence.evidence_id, graph: right.graph, modulePath: input.right_module_path, exportName: input.right_export_name, }, }); const evidence = createJavaScriptExportShapeComparisonEvidence( { left_evidence_id: left.evidence.evidence_id, right_evidence_id: right.evidence.evidence_id, left_module_path: input.left_module_path, left_export_name: input.left_export_name, right_module_path: input.right_module_path, right_export_name: input.right_export_name, }, result, ); return ok({ evidence, result, sources: [left.evidence, right.evidence] }); };