@anlyx/core 0.1.3 → 0.1.6-beta.0

package/dist/flow-spec/schema.js.map

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

package/dist/flow-spec/validate.d.ts

@@ -0,0 +1,17 @@
+import type { AnlyxFlowFile } from "./schema.js";
+export type FlowValidationIssue = {
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+    path: string;
+};
+export type FlowValidationResult = {
+    valid: boolean;
+    errors: FlowValidationIssue[];
+    warnings: FlowValidationIssue[];
+};
+export type FlowValidationOptions = {
+    cwd: string;
+};
+export declare function validateAnlyxFlowFile(file: AnlyxFlowFile, options: FlowValidationOptions): Promise<FlowValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/flow-spec/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/flow-spec/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,aAAa,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAwF/B"}

package/dist/flow-spec/validate.js

@@ -0,0 +1,231 @@
+export async function validateAnlyxFlowFile(file, options) {
+    const errors = [];
+    const warnings = [];
+    const sourceChecks = new Map();
+    const emittedSourceWarnings = new Set();
+    for (const [flowIndex, flow] of file.flows.entries()) {
+        const evidenceById = new Map(flow.evidence.map((evidence) => [evidence.id, evidence]));
+        const nodeIds = new Set();
+        flow.nodes.forEach((node, nodeIndex) => {
+            const path = `flows.${flowIndex}.nodes.${nodeIndex}.id`;
+            if (nodeIds.has(node.id)) {
+                errors.push({
+                    severity: "error",
+                    code: "duplicate_node_id",
+                    message: `Flow contains duplicate node id: ${node.id}.`,
+                    path
+                });
+            }
+            nodeIds.add(node.id);
+        });
+        flow.nodes.forEach((node, nodeIndex) => {
+            validateEvidenceIds({
+                evidenceIds: node.evidenceIds,
+                evidenceById,
+                errors,
+                pathPrefix: `flows.${flowIndex}.nodes.${nodeIndex}.evidenceIds`
+            });
+            validateMeasuredTiming({
+                timing: node.timing,
+                evidenceById,
+                errors,
+                pathPrefix: `flows.${flowIndex}.nodes.${nodeIndex}.timing`
+            });
+        });
+        flow.edges.forEach((edge, edgeIndex) => {
+            if (!nodeIds.has(edge.from)) {
+                errors.push({
+                    severity: "error",
+                    code: "edge_missing_from_node",
+                    message: `Flow edge references missing from node: ${edge.from}.`,
+                    path: `flows.${flowIndex}.edges.${edgeIndex}.from`
+                });
+            }
+            if (!nodeIds.has(edge.to)) {
+                errors.push({
+                    severity: "error",
+                    code: "edge_missing_to_node",
+                    message: `Flow edge references missing to node: ${edge.to}.`,
+                    path: `flows.${flowIndex}.edges.${edgeIndex}.to`
+                });
+            }
+            validateEvidenceIds({
+                evidenceIds: edge.evidenceIds,
+                evidenceById,
+                errors,
+                pathPrefix: `flows.${flowIndex}.edges.${edgeIndex}.evidenceIds`
+            });
+            validateMeasuredTiming({
+                timing: edge.timing,
+                evidenceById,
+                errors,
+                pathPrefix: `flows.${flowIndex}.edges.${edgeIndex}.timing`
+            });
+        });
+        await validateSourceEvidence({
+            evidence: flow.evidence,
+            flowIndex,
+            cwd: options.cwd,
+            sourceChecks,
+            emittedSourceWarnings,
+            warnings
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+function validateEvidenceIds(input) {
+    input.evidenceIds?.forEach((evidenceId, evidenceIndex) => {
+        if (!input.evidenceById.has(evidenceId)) {
+            input.errors.push({
+                severity: "error",
+                code: "missing_evidence",
+                message: `Reference points to missing evidence id: ${evidenceId}.`,
+                path: `${input.pathPrefix}.${evidenceIndex}`
+            });
+        }
+    });
+}
+function validateMeasuredTiming(input) {
+    if (input.timing?.kind !== "measured") {
+        return;
+    }
+    const evidence = input.evidenceById.get(input.timing.evidenceId);
+    if (!evidence) {
+        input.errors.push({
+            severity: "error",
+            code: "missing_timing_evidence",
+            message: `Measured timing references missing evidence id: ${input.timing.evidenceId}.`,
+            path: `${input.pathPrefix}.evidenceId`
+        });
+        return;
+    }
+    if (!isRuntimeOrTelemetryEvidence(evidence)) {
+        input.errors.push({
+            severity: "error",
+            code: "measured_timing_requires_runtime_evidence",
+            message: `Measured timing evidence must be runtime or telemetry evidence: ${input.timing.evidenceId}.`,
+            path: `${input.pathPrefix}.evidenceId`
+        });
+    }
+}
+function isRuntimeOrTelemetryEvidence(evidence) {
+    return evidence.kind.startsWith("runtime.") || evidence.kind.startsWith("telemetry.");
+}
+async function validateSourceEvidence(input) {
+    for (const [evidenceIndex, evidence] of input.evidence.entries()) {
+        if (evidence.kind !== "source" || !evidence.file) {
+            continue;
+        }
+        const absoluteFile = await resolveSourcePath(input.cwd, evidence.file);
+        const check = await getSourceFileCheck(absoluteFile, input.sourceChecks);
+        const pathPrefix = `flows.${input.flowIndex}.evidence.${evidenceIndex}`;
+        if (check.status === "missing") {
+            pushDedupedWarning(input.warnings, input.emittedSourceWarnings, {
+                severity: "warning",
+                code: "source_file_missing",
+                message: `Source evidence file is missing: ${evidence.file}.`,
+                path: `${pathPrefix}.file`
+            }, `source_file_missing:${evidence.file}`);
+            continue;
+        }
+        if (check.status === "unreadable") {
+            pushDedupedWarning(input.warnings, input.emittedSourceWarnings, {
+                severity: "warning",
+                code: "source_file_unreadable",
+                message: `Source evidence file could not be read: ${evidence.file}.`,
+                path: `${pathPrefix}.file`
+            }, `source_file_unreadable:${evidence.file}`);
+            continue;
+        }
+        const lineRangeIssue = getLineRangeIssue(evidence, check.lineCount);
+        if (lineRangeIssue) {
+            const lineStart = evidence.lineStart ?? "";
+            const lineEnd = evidence.lineEnd ?? "";
+            pushDedupedWarning(input.warnings, input.emittedSourceWarnings, {
+                severity: "warning",
+                code: "source_line_out_of_range",
+                message: `Source evidence line range is invalid or outside the file: ${evidence.file}.`,
+                path: `${pathPrefix}.${lineRangeIssue}`
+            }, `source_line_out_of_range:${evidence.file}:${lineStart}:${lineEnd}:${lineRangeIssue}`);
+        }
+    }
+}
+function getSourceFileCheck(absoluteFile, sourceChecks) {
+    const existingCheck = sourceChecks.get(absoluteFile);
+    if (existingCheck) {
+        return existingCheck;
+    }
+    const check = readSourceFile(absoluteFile).then((content) => ({
+        status: "ok",
+        lineCount: countLines(content)
+    }), (error) => isMissingSourceFileError(error)
+        ? {
+            status: "missing"
+        }
+        : {
+            status: "unreadable"
+        });
+    sourceChecks.set(absoluteFile, check);
+    return check;
+}
+async function readSourceFile(path) {
+    const { readFile } = await import("node:fs/promises");
+    return readFile(path, "utf8");
+}
+async function resolveSourcePath(cwd, file) {
+    const { resolve } = await import("node:path");
+    return resolve(cwd, file);
+}
+function countLines(content) {
+    if (content.length === 0) {
+        return 0;
+    }
+    const lines = content.split(/\r\n|\n|\r/);
+    if (lines.at(-1) === "") {
+        lines.pop();
+    }
+    return lines.length;
+}
+function isMissingSourceFileError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
+function getLineRangeIssue(evidence, lineCount) {
+    const { lineStart, lineEnd } = evidence;
+    if (lineStart === undefined && lineEnd === undefined) {
+        return null;
+    }
+    if (lineStart !== undefined && lineEnd === undefined) {
+        return lineStart > lineCount ? "lineStart" : null;
+    }
+    if (lineStart === undefined && lineEnd !== undefined) {
+        return lineEnd > lineCount ? "lineEnd" : null;
+    }
+    if (lineStart === undefined || lineEnd === undefined) {
+        return null;
+    }
+    if (lineStart > lineEnd) {
+        return "lineStart";
+    }
+    if (lineStart > lineCount) {
+        return "lineStart";
+    }
+    if (lineEnd > lineCount) {
+        return "lineEnd";
+    }
+    return null;
+}
+function pushDedupedWarning(warnings, emittedSourceWarnings, issue, dedupeKey) {
+    if (emittedSourceWarnings.has(dedupeKey)) {
+        return;
+    }
+    emittedSourceWarnings.add(dedupeKey);
+    warnings.push(issue);
+}
+//# sourceMappingURL=validate.js.map

package/dist/flow-spec/validate.js.map

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

package/dist/index.d.ts

@@ -1,9 +1,23 @@
 export type { AnlyxConfig, BackendConfig, CaptureConfig, DevConfig, FrontendConfig, ManualFrontendConfig, NextFrontendConfig, NormalizedAnlyxConfig, NormalizedBackendConfig, NormalizedCaptureConfig, NormalizedDevConfig, NormalizedFrontendConfig, NormalizedManualFrontendConfig, NormalizedNextFrontendConfig, NormalizedOpenApiBackendConfig, NormalizedServerConfig, NormalizedSpringBackendConfig, OpenApiBackendConfig, ServerConfig, SpringBackendConfig, ViewportConfig } from "./config.js";
 export type { FixtureExpectedData, FixtureValidationIssue, FixtureValidationResult } from "./fixture-validation.js";
 export type { AggregateReportDataInput, ReportAggregationIssue, ReportAggregationResult, ReportAggregationWarning } from "./report-aggregation.js";
-export type { AnalysisEvidence, ApiCall, CaptureResult, CaptureStatus, ConfidenceLevel, Endpoint, EndpointFlow, FlowEdge, FlowNode, HttpMethod, PageStoryboard, ScanResult, ScreenshotSegment, SubFlow, SupportLevel, Viewport } from "./schema.js";
+export type { AnalysisEvidence, ApiCall, BridgeEstimateTiming, BridgeFlowRequest, BridgeFlowResponse, BridgeFlowStatus, BridgeFlowTiming, BridgeMeasuredTiming, BridgeUnknownTiming, CaptureResult, CaptureStatus, ConfidenceLevel, Endpoint, EndpointFlow, FlowEdge, FlowNode, HttpMethod, MapEdge, MapEdgeType, MapGraph, MapNode, MapNodeType, PageStoryboard, ReportData, ScanResult, ScreenshotSegment, SubFlow, SupportLevel, Viewport } from "./schema.js";
+export type { ProjectInput, SplitProjectInput } from "./project-normalize.js";
+export type { ArchitectureEdge, ArchitectureGraph, ArchitectureNode, BusinessEffect, CapabilityEntry, DataChange, DataLifecycle, DataOperation, DataRef, DictionaryTerm, EvidenceStatus, FlowLayerKind, ImpactAffected, ImpactEdge, ImpactMap, ImpactTarget, LifecycleStage, LifecycleTransition, MeasurementSource, ProjectArea, ProjectActor, ProjectActorRole, ProjectCapability, ProjectCoverage, ProjectCoverageCounts, ProjectData, ProjectDictionary, ProjectEntity, ProjectEntityRef, ProjectEvidence, ProjectFeature, ProjectFlow, ProjectFlowLayer, ProjectGeneratedBy, ProjectImplementationItem, ProjectInfo, ProjectLanguage, ProjectMainArea, ProjectMeasurement, ProjectOverview, ProjectPage, ProjectRequest, ProjectSchemaVersion, RequestPurpose, RequestRole, SourceLocation, SuggestedReadingStep } from "./project-schema.js";
+export type { ProjectValidationReport } from "./project-validation-report.js";
+export type { NormalizeFlowFileToReportData, NormalizeFlowFileToScanResult } from "./flow-spec/normalize.js";
+export type { FlowValidationIssue, FlowValidationOptions, FlowValidationResult } from "./flow-spec/validate.js";
+export type { AnlyxFlowFile, Flow, FlowEdge as FlowSpecEdge, FlowEntry, FlowEvidence, FlowEvidenceKind, FlowGeneratedBy, FlowNode as FlowSpecNode, FlowNodeType, FlowProject, FlowRequest, FlowResponse, FlowSnapshot, FlowStatus, FlowSourceLocation, FlowTiming } from "./flow-spec/schema.js";
+export type { BackendObservedSpan, BackendSpanEvent, BrowserActionEvent, BrowserPageViewEvent, BrowserRequestEvent, FlowLayer, FlowLayerExecution, FlowLayerType, FlowRecord, FlowRecordMatchState, FlowRecordTrigger, LiveEvidenceLevel } from "./live-flow.js";
 export { ConfigValidationError, anlyxConfigSchema, backendConfigSchema, captureConfigSchema, devConfigSchema, defineConfig, frontendConfigSchema, manualFrontendConfigSchema, nextFrontendConfigSchema, normalizeConfig, openApiBackendConfigSchema, parseConfig, serverConfigSchema, springBackendConfigSchema, viewportConfigSchema } from "./config.js";
 export { validateFixtureExpectedData } from "./fixture-validation.js";
 export { aggregateReportData, matchApiCallToEndpoint } from "./report-aggregation.js";
-export { analysisEvidenceSchema, apiCallSchema, captureResultSchema, captureStatusSchema, confidenceLevelSchema, endpointFlowSchema, endpointSchema, flowEdgeSchema, flowNodeSchema, httpMethodSchema, pageStoryboardSchema, parseCaptureResult, parseEndpoint, parseEndpointFlow, parsePageStoryboard, parseScanResult, scanResultSchema, screenshotSegmentSchema, subFlowSchema, supportLevelSchema, viewportSchema } from "./schema.js";
+export { analysisEvidenceSchema, apiCallSchema, bridgeEstimateTimingSchema, bridgeFlowRequestSchema, bridgeFlowResponseSchema, bridgeFlowStatusSchema, bridgeFlowTimingSchema, bridgeMeasuredTimingSchema, bridgeUnknownTimingSchema, captureResultSchema, captureStatusSchema, confidenceLevelSchema, endpointFlowSchema, endpointSchema, flowEdgeSchema, flowNodeSchema, httpMethodSchema, pageStoryboardSchema, parseCaptureResult, parseEndpoint, parseEndpointFlow, parsePageStoryboard, parseReportData, parseScanResult, reportDataSchema, scanResultSchema, screenshotSegmentSchema, subFlowSchema, supportLevelSchema, viewportSchema } from "./schema.js";
+export { normalizeProjectInput } from "./project-normalize.js";
+export { architectureEdgeSchema, architectureGraphSchema, architectureNodeSchema, businessEffectSchema, capabilityEntrySchema, dataChangeSchema, dataLifecycleSchema, dataOperationSchema, dataRefSchema, dictionaryTermSchema, evidenceStatusSchema, flowLayerKindSchema, impactAffectedSchema, impactEdgeSchema, impactMapSchema, impactTargetSchema, lifecycleStageSchema, lifecycleTransitionSchema, measurementSourceSchema, parseProjectData, projectCoverageCountsSchema, projectCoverageSchema, projectActorRoleSchema, projectActorSchema, projectAreaSchema, projectCapabilitySchema, projectDataSchema, projectDictionarySchema, projectEntityRefSchema, projectEntitySchema, projectEvidenceSchema, projectFeatureSchema, projectFlowLayerSchema, projectFlowSchema, projectGeneratedBySchema, projectImplementationItemSchema, projectInfoSchema, projectLanguageSchema, projectMainAreaSchema, projectMeasurementSchema, projectOverviewSchema, projectPageSchema, projectRequestSchema, projectSchemaVersionSchema, requestPurposeSchema, requestRoleSchema, sourceLocationSchema, suggestedReadingStepSchema } from "./project-schema.js";
+export { parseProjectValidationReport, projectValidationReportSchema } from "./project-validation-report.js";
+export { normalizeFlowFileToReportData, normalizeFlowFileToScanResult } from "./flow-spec/normalize.js";
+export { validateAnlyxFlowFile } from "./flow-spec/validate.js";
+export { anlyxFlowFileSchema, flowEntrySchema, flowEdgeSchema as flowSpecEdgeSchema, flowEvidenceKindSchema, flowEvidenceSchema, flowGeneratedBySchema, flowNodeSchema as flowSpecNodeSchema, flowNodeTypeSchema, flowProjectSchema, flowRequestSchema, flowResponseSchema, flowSchema, flowSnapshotSchema, flowStatusSchema, flowSourceLocationSchema, flowTimingSchema, parseAnlyxFlowFile, parseFlow } from "./flow-spec/schema.js";
+export { buildFlowRecordFromBrowserEvent, mergeBackendSpansIntoFlowRecord, normalizeBrowserEventPath } from "./live-flow.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,QAAQ,EACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,0BAA0B,EAC1B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,12 @@
 export { ConfigValidationError, anlyxConfigSchema, backendConfigSchema, captureConfigSchema, devConfigSchema, defineConfig, frontendConfigSchema, manualFrontendConfigSchema, nextFrontendConfigSchema, normalizeConfig, openApiBackendConfigSchema, parseConfig, serverConfigSchema, springBackendConfigSchema, viewportConfigSchema } from "./config.js";
 export { validateFixtureExpectedData } from "./fixture-validation.js";
 export { aggregateReportData, matchApiCallToEndpoint } from "./report-aggregation.js";
-export { analysisEvidenceSchema, apiCallSchema, captureResultSchema, captureStatusSchema, confidenceLevelSchema, endpointFlowSchema, endpointSchema, flowEdgeSchema, flowNodeSchema, httpMethodSchema, pageStoryboardSchema, parseCaptureResult, parseEndpoint, parseEndpointFlow, parsePageStoryboard, parseScanResult, scanResultSchema, screenshotSegmentSchema, subFlowSchema, supportLevelSchema, viewportSchema } from "./schema.js";
+export { analysisEvidenceSchema, apiCallSchema, bridgeEstimateTimingSchema, bridgeFlowRequestSchema, bridgeFlowResponseSchema, bridgeFlowStatusSchema, bridgeFlowTimingSchema, bridgeMeasuredTimingSchema, bridgeUnknownTimingSchema, captureResultSchema, captureStatusSchema, confidenceLevelSchema, endpointFlowSchema, endpointSchema, flowEdgeSchema, flowNodeSchema, httpMethodSchema, pageStoryboardSchema, parseCaptureResult, parseEndpoint, parseEndpointFlow, parsePageStoryboard, parseReportData, parseScanResult, reportDataSchema, scanResultSchema, screenshotSegmentSchema, subFlowSchema, supportLevelSchema, viewportSchema } from "./schema.js";
+export { normalizeProjectInput } from "./project-normalize.js";
+export { architectureEdgeSchema, architectureGraphSchema, architectureNodeSchema, businessEffectSchema, capabilityEntrySchema, dataChangeSchema, dataLifecycleSchema, dataOperationSchema, dataRefSchema, dictionaryTermSchema, evidenceStatusSchema, flowLayerKindSchema, impactAffectedSchema, impactEdgeSchema, impactMapSchema, impactTargetSchema, lifecycleStageSchema, lifecycleTransitionSchema, measurementSourceSchema, parseProjectData, projectCoverageCountsSchema, projectCoverageSchema, projectActorRoleSchema, projectActorSchema, projectAreaSchema, projectCapabilitySchema, projectDataSchema, projectDictionarySchema, projectEntityRefSchema, projectEntitySchema, projectEvidenceSchema, projectFeatureSchema, projectFlowLayerSchema, projectFlowSchema, projectGeneratedBySchema, projectImplementationItemSchema, projectInfoSchema, projectLanguageSchema, projectMainAreaSchema, projectMeasurementSchema, projectOverviewSchema, projectPageSchema, projectRequestSchema, projectSchemaVersionSchema, requestPurposeSchema, requestRoleSchema, sourceLocationSchema, suggestedReadingStepSchema } from "./project-schema.js";
+export { parseProjectValidationReport, projectValidationReportSchema } from "./project-validation-report.js";
+export { normalizeFlowFileToReportData, normalizeFlowFileToScanResult } from "./flow-spec/normalize.js";
+export { validateAnlyxFlowFile } from "./flow-spec/validate.js";
+export { anlyxFlowFileSchema, flowEntrySchema, flowEdgeSchema as flowSpecEdgeSchema, flowEvidenceKindSchema, flowEvidenceSchema, flowGeneratedBySchema, flowNodeSchema as flowSpecNodeSchema, flowNodeTypeSchema, flowProjectSchema, flowRequestSchema, flowResponseSchema, flowSchema, flowSnapshotSchema, flowStatusSchema, flowSourceLocationSchema, flowTimingSchema, parseAnlyxFlowFile, parseFlow } from "./flow-spec/schema.js";
+export { buildFlowRecordFromBrowserEvent, mergeBackendSpansIntoFlowRecord, normalizeBrowserEventPath } from "./live-flow.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwDA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,0BAA0B,EAC1B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwKA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,0BAA0B,EAC1B,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,+BAA+B,EAC/B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,IAAI,kBAAkB,EACpC,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACV,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC"}

package/dist/live-flow.d.ts

@@ -0,0 +1,103 @@
+import type { ConfidenceLevel, Endpoint, EndpointFlow, HttpMethod, ScanResult } from "./schema.js";
+export type BrowserActionEvent = {
+    label: string;
+    selector?: string;
+    text?: string;
+    observedAt?: string;
+};
+export type BrowserRequestEvent = {
+    id: string;
+    type: "request";
+    method: HttpMethod | string;
+    url: string;
+    path?: string;
+    pageUrl?: string;
+    status?: number;
+    durationMs?: number;
+    observedAt: string;
+    action?: BrowserActionEvent;
+    contextId?: string;
+    priority?: FlowRecordPriority;
+    runtimeSource?: FlowRecordRuntimeSource;
+};
+export type BrowserPageViewEvent = {
+    id: string;
+    type: "page_view";
+    url: string;
+    path?: string;
+    title?: string;
+    observedAt: string;
+};
+export type LiveEvidenceLevel = "browser_observed" | "backend_observed" | "source_derived" | "inferred" | "not_proven";
+export type FlowLayerType = "action" | "api" | "controller" | "auth" | "decision" | "page" | "service" | "repository" | "database" | "dto" | "schema" | "externalApi" | "cache" | "utility" | "validator" | "mapper" | "unknown" | "result";
+export type FlowLayerExecution = "executed" | "observed" | "inferred" | "blocked" | "scanned" | "not_proven" | "unknown";
+export type FlowLayer = {
+    id: string;
+    type: FlowLayerType;
+    label: string;
+    execution: FlowLayerExecution;
+    evidenceLevel: LiveEvidenceLevel;
+    evidence: string[];
+    nodeId?: string;
+    filePath?: string;
+    lineNumber?: number;
+    confidence?: ConfidenceLevel;
+    startOffsetMs?: number;
+    durationMs?: number;
+    status?: number;
+};
+export type BackendObservedSpan = {
+    id: string;
+    parentId?: string;
+    type: Exclude<FlowLayerType, "action" | "result">;
+    label: string;
+    nodeId?: string;
+    filePath?: string;
+    lineNumber?: number;
+    startOffsetMs: number;
+    durationMs: number;
+    status?: number;
+    evidence?: string[];
+};
+export type BackendSpanEvent = {
+    type: "backend_spans";
+    requestId: string;
+    spans: BackendObservedSpan[];
+    observedAt?: string;
+};
+export type FlowRecordMatchState = "matched" | "unmatched" | "ambiguous";
+export type FlowRecordTrigger = "user_action" | "background";
+export type FlowRecordPriority = "primary" | "background";
+export type FlowRecordRuntimeSource = "browser" | "server" | "unknown";
+export type FlowRecord = {
+    id: string;
+    requestId: string;
+    method: string;
+    path: string;
+    trigger: FlowRecordTrigger;
+    priority: FlowRecordPriority;
+    runtimeSource: FlowRecordRuntimeSource;
+    contextId?: string;
+    pageUrl?: string;
+    occurrenceCount?: number;
+    status?: number;
+    duration?: number;
+    durationMs?: number;
+    matchState: FlowRecordMatchState;
+    confidence: ConfidenceLevel;
+    action?: BrowserActionEvent;
+    endpoint?: Endpoint;
+    endpointId?: string;
+    endpointPath?: string;
+    flow?: EndpointFlow;
+    flowId?: string;
+    layers: FlowLayer[];
+    backendSpans?: BackendObservedSpan[];
+    evidence: string[];
+    createdAt: string;
+    label: string;
+};
+export declare function normalizeBrowserEventPath(urlOrPath: string): string;
+export declare function buildFlowRecordFromBrowserEvent(event: BrowserRequestEvent, scanResult: ScanResult): FlowRecord;
+export declare function mergeBackendSpansIntoFlowRecord(record: FlowRecord, backendSpans: BackendObservedSpan[]): FlowRecord;
+//# sourceMappingURL=live-flow.d.ts.map

package/dist/live-flow.d.ts.map

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