@principal-ai/subsystems-core 0.29.0

package/dist/workflow/edge-validation.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Edge Validation
+ *
+ * Validates derived edges from workflows against spans.canvas definitions.
+ * Ensures documented span relationships match observed workflow behavior.
+ *
+ * @see .principal-views/WORKFLOW-SPAN-INTEGRATION.md
+ */
+import type { ExtendedCanvas } from '../types/canvas';
+import type { DerivedEdge } from './edge-derivation';
+/**
+ * Span node info extracted from spans.canvas
+ */
+export interface SpanNodeInfo {
+    /** Node ID in the canvas */
+    nodeId: string;
+    /** Span pattern this node matches (e.g., "validate.*") */
+    spanPattern: string;
+    /** Human-readable name */
+    name?: string;
+}
+/**
+ * Canvas edge info extracted from spans.canvas
+ */
+export interface CanvasEdgeInfo {
+    /** Source node ID */
+    fromNodeId: string;
+    /** Target node ID */
+    toNodeId: string;
+    /** Source span pattern */
+    fromSpanPattern?: string;
+    /** Target span pattern */
+    toSpanPattern?: string;
+}
+/**
+ * Edge validation result
+ */
+export interface EdgeValidationResult {
+    /** Edges that are documented in spans.canvas and observed in workflows */
+    validEdges: ValidatedEdge[];
+    /** Edges observed in workflows but missing from spans.canvas */
+    missingEdges: MissingEdge[];
+    /** Edges documented in spans.canvas but not observed in any workflow */
+    unusedEdges: UnusedEdge[];
+    /** Spans referenced in workflows that don't match any spans.canvas node */
+    unmatchedSpans: UnmatchedSpan[];
+    /** Summary statistics */
+    summary: {
+        totalDerivedEdges: number;
+        totalCanvasEdges: number;
+        matchedEdges: number;
+        missingEdges: number;
+        unusedEdges: number;
+        unmatchedSpans: number;
+    };
+}
+/**
+ * An edge that passed validation
+ */
+export interface ValidatedEdge {
+    /** Source span name (exact) */
+    fromSpan: string;
+    /** Target span name (exact) */
+    toSpan: string;
+    /** Canvas edge it matched */
+    canvasEdge: CanvasEdgeInfo;
+    /** Workflows where this edge was observed */
+    sources: Array<{
+        workflowFile?: string;
+        scenarioId: string;
+    }>;
+}
+/**
+ * An edge observed in workflows but missing from spans.canvas
+ */
+export interface MissingEdge {
+    /** Source span name */
+    fromSpan: string;
+    /** Target span name */
+    toSpan: string;
+    /** Source span matched to this node (if any) */
+    fromNodeId?: string;
+    /** Target span matched to this node (if any) */
+    toNodeId?: string;
+    /** Workflows where this edge was observed */
+    sources: Array<{
+        workflowFile?: string;
+        scenarioId: string;
+    }>;
+    /** Reason this edge is missing */
+    reason: 'no-edge-in-canvas' | 'span-not-matched';
+}
+/**
+ * An edge documented in spans.canvas but not observed in workflows
+ */
+export interface UnusedEdge {
+    /** Canvas edge */
+    canvasEdge: CanvasEdgeInfo;
+    /** Canvas file where this edge is defined */
+    canvasFile?: string;
+}
+/**
+ * A span referenced in workflows that doesn't match any spans.canvas node
+ */
+export interface UnmatchedSpan {
+    /** Exact span name from workflow */
+    spanName: string;
+    /** Workflows that reference this span */
+    sources: Array<{
+        workflowFile?: string;
+        scenarioId: string;
+    }>;
+}
+/**
+ * Extract span nodes from a spans.canvas file
+ *
+ * @param canvas - Parsed spans.canvas content
+ * @returns Array of span node info
+ */
+export declare function extractSpanNodes(canvas: ExtendedCanvas): SpanNodeInfo[];
+/**
+ * Extract edges from a spans.canvas file
+ *
+ * @param canvas - Parsed spans.canvas content
+ * @param spanNodes - Map of nodeId to span info
+ * @returns Array of canvas edge info
+ */
+export declare function extractCanvasEdges(canvas: ExtendedCanvas, spanNodes: SpanNodeInfo[]): CanvasEdgeInfo[];
+/**
+ * Match an exact span name to a span pattern
+ *
+ * @param spanName - Exact span name (e.g., "validate.canvas")
+ * @param pattern - Span pattern (e.g., "validate.*")
+ * @returns true if the span matches the pattern
+ */
+export declare function matchSpanToPattern(spanName: string, pattern: string): boolean;
+/**
+ * Find the canvas node that matches a span name
+ *
+ * @param spanName - Exact span name
+ * @param spanNodes - Available span nodes
+ * @returns Matching node info or undefined
+ */
+export declare function findMatchingNode(spanName: string, spanNodes: SpanNodeInfo[]): SpanNodeInfo | undefined;
+/**
+ * Check if a derived edge has a corresponding canvas edge
+ *
+ * @param derivedEdge - Edge derived from workflow
+ * @param canvasEdges - Edges from spans.canvas
+ * @param spanNodes - Span nodes from spans.canvas
+ * @returns Matching canvas edge or undefined
+ */
+export declare function findMatchingCanvasEdge(derivedEdge: DerivedEdge, canvasEdges: CanvasEdgeInfo[], spanNodes: SpanNodeInfo[]): CanvasEdgeInfo | undefined;
+/**
+ * Validate derived edges against spans.canvas
+ *
+ * @param derivedEdges - Edges derived from workflows
+ * @param canvas - Parsed spans.canvas content
+ * @param canvasFile - Optional file path for tracking
+ * @returns Validation result
+ */
+export declare function validateEdges(derivedEdges: DerivedEdge[], canvas: ExtendedCanvas, canvasFile?: string): EdgeValidationResult;
+/**
+ * Format validation result as human-readable text
+ *
+ * @param result - Validation result
+ * @returns Formatted string
+ */
+export declare function formatValidationResult(result: EdgeValidationResult): string;
+//# sourceMappingURL=edge-validation.d.ts.map

package/dist/workflow/edge-validation.d.ts.map

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

package/dist/workflow/edge-validation.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * Edge Validation
+ *
+ * Validates derived edges from workflows against spans.canvas definitions.
+ * Ensures documented span relationships match observed workflow behavior.
+ *
+ * @see .principal-views/WORKFLOW-SPAN-INTEGRATION.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatValidationResult = exports.validateEdges = exports.findMatchingCanvasEdge = exports.findMatchingNode = exports.matchSpanToPattern = exports.extractCanvasEdges = exports.extractSpanNodes = void 0;
+const canvas_1 = require("../types/canvas");
+const minimatch_1 = require("minimatch");
+/**
+ * Extract span nodes from a spans.canvas file
+ *
+ * @param canvas - Parsed spans.canvas content
+ * @returns Array of span node info
+ */
+function extractSpanNodes(canvas) {
+    if (!canvas.nodes) {
+        return [];
+    }
+    const spanNodes = [];
+    for (const node of canvas.nodes) {
+        // Check OTEL span convention nodes (top-level otel.spanPattern)
+        if ((0, canvas_1.isOtelSpanConventionNode)(node) && node.otel?.spanPattern) {
+            spanNodes.push({
+                nodeId: node.id,
+                spanPattern: node.otel.spanPattern,
+                name: node.label,
+            });
+        }
+        // Check standard nodes (pv.otel.spanPattern)
+        else if ((0, canvas_1.isStandardCanvasNode)(node) && node.pv?.otel?.spanPattern) {
+            spanNodes.push({
+                nodeId: node.id,
+                spanPattern: node.pv.otel.spanPattern,
+                name: node.pv.name,
+            });
+        }
+    }
+    return spanNodes;
+}
+exports.extractSpanNodes = extractSpanNodes;
+/**
+ * Extract edges from a spans.canvas file
+ *
+ * @param canvas - Parsed spans.canvas content
+ * @param spanNodes - Map of nodeId to span info
+ * @returns Array of canvas edge info
+ */
+function extractCanvasEdges(canvas, spanNodes) {
+    if (!canvas.edges) {
+        return [];
+    }
+    const nodeMap = new Map(spanNodes.map((n) => [n.nodeId, n]));
+    const edges = [];
+    for (const edge of canvas.edges) {
+        const fromNode = nodeMap.get(edge.fromNode);
+        const toNode = nodeMap.get(edge.toNode);
+        edges.push({
+            fromNodeId: edge.fromNode,
+            toNodeId: edge.toNode,
+            fromSpanPattern: fromNode?.spanPattern,
+            toSpanPattern: toNode?.spanPattern,
+        });
+    }
+    return edges;
+}
+exports.extractCanvasEdges = extractCanvasEdges;
+/**
+ * Match an exact span name to a span pattern
+ *
+ * @param spanName - Exact span name (e.g., "validate.canvas")
+ * @param pattern - Span pattern (e.g., "validate.*")
+ * @returns true if the span matches the pattern
+ */
+function matchSpanToPattern(spanName, pattern) {
+    // Exact match
+    if (spanName === pattern) {
+        return true;
+    }
+    // Use minimatch for glob pattern matching
+    return (0, minimatch_1.minimatch)(spanName, pattern);
+}
+exports.matchSpanToPattern = matchSpanToPattern;
+/**
+ * Find the canvas node that matches a span name
+ *
+ * @param spanName - Exact span name
+ * @param spanNodes - Available span nodes
+ * @returns Matching node info or undefined
+ */
+function findMatchingNode(spanName, spanNodes) {
+    // First try exact match
+    for (const node of spanNodes) {
+        if (node.spanPattern === spanName) {
+            return node;
+        }
+    }
+    // Then try pattern match
+    for (const node of spanNodes) {
+        if (matchSpanToPattern(spanName, node.spanPattern)) {
+            return node;
+        }
+    }
+    return undefined;
+}
+exports.findMatchingNode = findMatchingNode;
+/**
+ * Check if a derived edge has a corresponding canvas edge
+ *
+ * @param derivedEdge - Edge derived from workflow
+ * @param canvasEdges - Edges from spans.canvas
+ * @param spanNodes - Span nodes from spans.canvas
+ * @returns Matching canvas edge or undefined
+ */
+function findMatchingCanvasEdge(derivedEdge, canvasEdges, spanNodes) {
+    const fromNode = findMatchingNode(derivedEdge.fromSpan, spanNodes);
+    const toNode = findMatchingNode(derivedEdge.toSpan, spanNodes);
+    if (!fromNode || !toNode) {
+        return undefined;
+    }
+    // Find canvas edge connecting these nodes
+    return canvasEdges.find((edge) => edge.fromNodeId === fromNode.nodeId && edge.toNodeId === toNode.nodeId);
+}
+exports.findMatchingCanvasEdge = findMatchingCanvasEdge;
+/**
+ * Validate derived edges against spans.canvas
+ *
+ * @param derivedEdges - Edges derived from workflows
+ * @param canvas - Parsed spans.canvas content
+ * @param canvasFile - Optional file path for tracking
+ * @returns Validation result
+ */
+function validateEdges(derivedEdges, canvas, canvasFile) {
+    const spanNodes = extractSpanNodes(canvas);
+    const canvasEdges = extractCanvasEdges(canvas, spanNodes);
+    const validEdges = [];
+    const missingEdges = [];
+    const unmatchedSpans = [];
+    const matchedCanvasEdges = new Set();
+    // Track all unique spans
+    const allSpans = new Set();
+    for (const edge of derivedEdges) {
+        allSpans.add(edge.fromSpan);
+        allSpans.add(edge.toSpan);
+    }
+    // Check each span for matching node
+    for (const spanName of allSpans) {
+        const matchingNode = findMatchingNode(spanName, spanNodes);
+        if (!matchingNode) {
+            // Find sources for this span
+            const sources = [];
+            for (const edge of derivedEdges) {
+                if (edge.fromSpan === spanName || edge.toSpan === spanName) {
+                    sources.push({
+                        workflowFile: edge.workflowFile,
+                        scenarioId: edge.scenarioId,
+                    });
+                }
+            }
+            unmatchedSpans.push({
+                spanName,
+                sources: deduplicateSources(sources),
+            });
+        }
+    }
+    // Validate each derived edge
+    for (const derivedEdge of derivedEdges) {
+        const fromNode = findMatchingNode(derivedEdge.fromSpan, spanNodes);
+        const toNode = findMatchingNode(derivedEdge.toSpan, spanNodes);
+        if (!fromNode || !toNode) {
+            // Skip if either span doesn't match - already reported as unmatched span
+            continue;
+        }
+        const matchingCanvasEdge = findMatchingCanvasEdge(derivedEdge, canvasEdges, spanNodes);
+        if (matchingCanvasEdge) {
+            // Valid edge - documented and observed
+            const edgeKey = `${matchingCanvasEdge.fromNodeId}->${matchingCanvasEdge.toNodeId}`;
+            matchedCanvasEdges.add(edgeKey);
+            // Check if we already have this edge in validEdges
+            const existingValid = validEdges.find((v) => v.fromSpan === derivedEdge.fromSpan && v.toSpan === derivedEdge.toSpan);
+            if (existingValid) {
+                existingValid.sources.push({
+                    workflowFile: derivedEdge.workflowFile,
+                    scenarioId: derivedEdge.scenarioId,
+                });
+            }
+            else {
+                validEdges.push({
+                    fromSpan: derivedEdge.fromSpan,
+                    toSpan: derivedEdge.toSpan,
+                    canvasEdge: matchingCanvasEdge,
+                    sources: [
+                        {
+                            workflowFile: derivedEdge.workflowFile,
+                            scenarioId: derivedEdge.scenarioId,
+                        },
+                    ],
+                });
+            }
+        }
+        else {
+            // Missing edge - observed but not documented
+            const existingMissing = missingEdges.find((m) => m.fromSpan === derivedEdge.fromSpan && m.toSpan === derivedEdge.toSpan);
+            if (existingMissing) {
+                existingMissing.sources.push({
+                    workflowFile: derivedEdge.workflowFile,
+                    scenarioId: derivedEdge.scenarioId,
+                });
+            }
+            else {
+                missingEdges.push({
+                    fromSpan: derivedEdge.fromSpan,
+                    toSpan: derivedEdge.toSpan,
+                    fromNodeId: fromNode.nodeId,
+                    toNodeId: toNode.nodeId,
+                    sources: [
+                        {
+                            workflowFile: derivedEdge.workflowFile,
+                            scenarioId: derivedEdge.scenarioId,
+                        },
+                    ],
+                    reason: 'no-edge-in-canvas',
+                });
+            }
+        }
+    }
+    // Find unused canvas edges
+    const unusedEdges = [];
+    for (const canvasEdge of canvasEdges) {
+        const edgeKey = `${canvasEdge.fromNodeId}->${canvasEdge.toNodeId}`;
+        if (!matchedCanvasEdges.has(edgeKey)) {
+            unusedEdges.push({
+                canvasEdge,
+                canvasFile,
+            });
+        }
+    }
+    return {
+        validEdges,
+        missingEdges,
+        unusedEdges,
+        unmatchedSpans,
+        summary: {
+            totalDerivedEdges: derivedEdges.length,
+            totalCanvasEdges: canvasEdges.length,
+            matchedEdges: validEdges.length,
+            missingEdges: missingEdges.length,
+            unusedEdges: unusedEdges.length,
+            unmatchedSpans: unmatchedSpans.length,
+        },
+    };
+}
+exports.validateEdges = validateEdges;
+/**
+ * Deduplicate sources array
+ */
+function deduplicateSources(sources) {
+    const seen = new Set();
+    return sources.filter((s) => {
+        const key = `${s.workflowFile || ''}:${s.scenarioId}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Format validation result as human-readable text
+ *
+ * @param result - Validation result
+ * @returns Formatted string
+ */
+function formatValidationResult(result) {
+    const lines = [];
+    lines.push('Edge Validation Results');
+    lines.push('=======================');
+    lines.push('');
+    // Summary
+    lines.push(`Summary:`);
+    lines.push(`  Derived edges from workflows: ${result.summary.totalDerivedEdges}`);
+    lines.push(`  Edges in spans.canvas: ${result.summary.totalCanvasEdges}`);
+    lines.push(`  Matched: ${result.summary.matchedEdges}`);
+    lines.push(`  Missing from canvas: ${result.summary.missingEdges}`);
+    lines.push(`  Unused in canvas: ${result.summary.unusedEdges}`);
+    lines.push(`  Unmatched spans: ${result.summary.unmatchedSpans}`);
+    lines.push('');
+    // Valid edges
+    if (result.validEdges.length > 0) {
+        lines.push('Valid Edges (documented and observed):');
+        for (const edge of result.validEdges) {
+            lines.push(`  ✓ ${edge.fromSpan} → ${edge.toSpan}`);
+        }
+        lines.push('');
+    }
+    // Missing edges
+    if (result.missingEdges.length > 0) {
+        lines.push('Missing Edges (observed but not documented):');
+        for (const edge of result.missingEdges) {
+            lines.push(`  ✗ ${edge.fromSpan} → ${edge.toSpan}`);
+            if (edge.fromNodeId && edge.toNodeId) {
+                lines.push(`    Suggested: Add edge from "${edge.fromNodeId}" to "${edge.toNodeId}"`);
+            }
+        }
+        lines.push('');
+    }
+    // Unused edges
+    if (result.unusedEdges.length > 0) {
+        lines.push('Unused Edges (documented but not observed):');
+        for (const edge of result.unusedEdges) {
+            const from = edge.canvasEdge.fromSpanPattern || edge.canvasEdge.fromNodeId;
+            const to = edge.canvasEdge.toSpanPattern || edge.canvasEdge.toNodeId;
+            lines.push(`  ⚠ ${from} → ${to}`);
+        }
+        lines.push('');
+    }
+    // Unmatched spans
+    if (result.unmatchedSpans.length > 0) {
+        lines.push('Unmatched Spans (no matching node in spans.canvas):');
+        for (const span of result.unmatchedSpans) {
+            lines.push(`  ✗ ${span.spanName}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+exports.formatValidationResult = formatValidationResult;
+//# sourceMappingURL=edge-validation.js.map

package/dist/workflow/edge-validation.js.map

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

package/dist/workflow/example.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Example: Using the Workflow Template System
+ *
+ * This example demonstrates how to use the workflow renderer
+ * to transform OTEL events into human-readable workflows.
+ */
+declare function exampleSuccess(): void;
+declare function exampleWithViolations(): void;
+declare function exampleSpanTree(): void;
+export { exampleSuccess, exampleWithViolations, exampleSpanTree };
+//# sourceMappingURL=example.d.ts.map

package/dist/workflow/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/workflow/example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,iBAAS,cAAc,SAqEtB;AAGD,iBAAS,qBAAqB,SA8I7B;AAGD,iBAAS,eAAe,SA2FvB;AAUD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC"}