codehere 0.2.0 → 0.4.0

package/dist/infrastructure/validation/summary-aggregator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Infrastructure: Summary Aggregator
+ * Merges multiple TraceSummaries into a composite summary
+ * Used by MultiAgentOrchestrator to aggregate agent summaries
+ */
+import type { TraceSummary } from './trace-summary.js';
+export interface CompositeSummary {
+    runId: string;
+    operation: string;
+    agentName: string;
+    filesChanged: string[];
+    filesCreated: string[];
+    filesDeleted: string[];
+    reasoningSteps: TraceSummary['reasoningSteps'];
+    validationChecks: TraceSummary['validationChecks'];
+    metrics: TraceSummary['metrics'];
+    reviewNeeded: TraceSummary['reviewNeeded'];
+    outcome: TraceSummary['outcome'];
+    errors?: string[];
+    warnings?: string[];
+    agentSummaries: Array<{
+        agent: string;
+        runId: string;
+        summary: TraceSummary;
+    }>;
+    phaseOrder: string[];
+}
+/**
+ * Aggregate multiple agent summaries into a composite summary
+ */
+export declare class SummaryAggregator {
+    /**
+     * Merge multiple summaries into a composite summary
+     */
+    mergeSummaries(summaries: Array<{
+        agent: string;
+        summary: TraceSummary;
+        runId?: string;
+    }>, unifiedRunId: string, operation: string): CompositeSummary;
+}
+export declare const summaryAggregator: SummaryAggregator;
+//# sourceMappingURL=summary-aggregator.d.ts.map

package/dist/infrastructure/validation/summary-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-aggregator.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/summary-aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC/C,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACnD,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,KAAK,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,CAAC;KACvB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,cAAc,CACZ,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC1E,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,gBAAgB;CA8JpB;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/infrastructure/validation/summary-aggregator.js

@@ -0,0 +1,156 @@
+/**
+ * Infrastructure: Summary Aggregator
+ * Merges multiple TraceSummaries into a composite summary
+ * Used by MultiAgentOrchestrator to aggregate agent summaries
+ */
+/**
+ * Aggregate multiple agent summaries into a composite summary
+ */
+export class SummaryAggregator {
+    /**
+     * Merge multiple summaries into a composite summary
+     */
+    mergeSummaries(summaries, unifiedRunId, operation) {
+        if (summaries.length === 0) {
+            // Return empty summary structure
+            return {
+                runId: unifiedRunId,
+                operation,
+                agentName: 'multi-agent-orchestrator',
+                filesChanged: [],
+                filesCreated: [],
+                filesDeleted: [],
+                reasoningSteps: [],
+                validationChecks: [],
+                metrics: {
+                    duration: 0,
+                    operationsCount: 0,
+                },
+                reviewNeeded: {
+                    required: false,
+                    reasons: [],
+                },
+                outcome: 'success',
+                agentSummaries: [],
+                phaseOrder: [],
+            };
+        }
+        // Aggregate files
+        const allFilesChanged = new Set();
+        const allFilesCreated = new Set();
+        const allFilesDeleted = new Set();
+        // Aggregate reasoning steps
+        const allReasoningSteps = [];
+        // Aggregate validation checks
+        const allValidationChecks = [];
+        // Aggregate metrics
+        let totalTokens = 0;
+        let totalDuration = 0;
+        let totalOperations = 0;
+        let totalFilesAnalyzed = 0;
+        // Aggregate errors and warnings
+        const allErrors = [];
+        const allWarnings = [];
+        // Track review needs
+        const reviewReasons = [];
+        let highestRiskLevel = 'low';
+        // Determine overall outcome
+        let hasFailures = false;
+        let hasPartialSuccess = false;
+        let needsReview = false;
+        const phaseOrder = [];
+        for (const { agent, summary, runId } of summaries) {
+            if (!summary)
+                continue;
+            phaseOrder.push(agent);
+            // Aggregate files
+            summary.filesChanged.forEach(f => allFilesChanged.add(f));
+            summary.filesCreated.forEach(f => allFilesCreated.add(f));
+            summary.filesDeleted.forEach(f => allFilesDeleted.add(f));
+            // Aggregate reasoning steps (limit to key steps per agent)
+            allReasoningSteps.push(...summary.reasoningSteps.slice(0, 3));
+            // Aggregate validation checks
+            allValidationChecks.push(...summary.validationChecks);
+            // Aggregate metrics
+            if (summary.metrics.tokensUsed) {
+                totalTokens += summary.metrics.tokensUsed;
+            }
+            totalDuration += summary.metrics.duration;
+            totalOperations += summary.metrics.operationsCount;
+            if (summary.metrics.filesAnalyzed) {
+                totalFilesAnalyzed += summary.metrics.filesAnalyzed;
+            }
+            // Aggregate errors and warnings
+            if (summary.errors) {
+                allErrors.push(...summary.errors);
+            }
+            if (summary.warnings) {
+                allWarnings.push(...summary.warnings);
+            }
+            // Track review needs
+            if (summary.reviewNeeded.required) {
+                needsReview = true;
+                reviewReasons.push(...summary.reviewNeeded.reasons.map(r => `${agent}: ${r}`));
+                // Determine highest risk level
+                const riskLevel = summary.reviewNeeded.riskLevel || 'medium';
+                const riskOrder = { low: 1, medium: 2, high: 3, critical: 4 };
+                if (riskOrder[riskLevel] > riskOrder[highestRiskLevel]) {
+                    highestRiskLevel = riskLevel;
+                }
+            }
+            // Track outcomes
+            if (summary.outcome === 'failure') {
+                hasFailures = true;
+            }
+            else if (summary.outcome === 'partial_success') {
+                hasPartialSuccess = true;
+            }
+        }
+        // Determine overall outcome
+        let overallOutcome = 'success';
+        if (hasFailures) {
+            overallOutcome = 'failure';
+        }
+        else if (hasPartialSuccess || needsReview) {
+            overallOutcome = needsReview ? 'needs_review' : 'partial_success';
+        }
+        // Deduplicate errors and warnings
+        const uniqueErrors = Array.from(new Set(allErrors));
+        const uniqueWarnings = Array.from(new Set(allWarnings));
+        return {
+            runId: unifiedRunId,
+            operation,
+            agentName: 'multi-agent-orchestrator',
+            filesChanged: Array.from(allFilesChanged),
+            filesCreated: Array.from(allFilesCreated),
+            filesDeleted: Array.from(allFilesDeleted),
+            reasoningSteps: allReasoningSteps.slice(0, 10), // Limit to top 10 steps
+            validationChecks: allValidationChecks,
+            metrics: {
+                tokensUsed: totalTokens > 0 ? totalTokens : undefined,
+                duration: totalDuration,
+                operationsCount: totalOperations,
+                filesAnalyzed: totalFilesAnalyzed > 0 ? totalFilesAnalyzed : undefined,
+            },
+            reviewNeeded: {
+                required: needsReview,
+                reasons: reviewReasons,
+                riskLevel: highestRiskLevel,
+            },
+            outcome: overallOutcome,
+            errors: uniqueErrors.length > 0 ? uniqueErrors : undefined,
+            warnings: uniqueWarnings.length > 0 ? uniqueWarnings : undefined,
+            agentSummaries: summaries
+                .filter(s => s.summary)
+                .map(s => ({
+                agent: s.agent,
+                runId: s.runId || s.summary.runId,
+                summary: s.summary,
+            })),
+            phaseOrder,
+        };
+    }
+}
+// Singleton instance
+export const summaryAggregator = new SummaryAggregator();
+//# sourceMappingURL=summary-aggregator.js.map

package/dist/infrastructure/validation/summary-aggregator.js.map

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

package/dist/infrastructure/validation/summary-extractor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Infrastructure: Summary Extractor
+ * Extracts summaries from different response types for review flow
+ * Priority: compositeSummary > validationSummary > routingDecision
+ */
+import type { TraceSummary } from './trace-summary.js';
+import type { CompositeSummary } from './summary-aggregator.js';
+export interface SummarySource {
+    summary: TraceSummary | CompositeSummary;
+    source: 'composite' | 'validation' | 'routing';
+}
+/**
+ * Extract summary from various response types
+ * Priority order: compositeSummary > validationSummary > routingDecision.summary
+ */
+export declare class SummaryExtractor {
+    /**
+     * Extract summary from orchestration response
+     */
+    extractFromOrchestration(result: {
+        compositeSummary?: CompositeSummary;
+        validation?: {
+            validationSummary?: TraceSummary;
+        } | any;
+        execution?: {
+            validationSummary?: TraceSummary;
+        } | any;
+        plan?: {
+            validationSummary?: TraceSummary;
+        } | any;
+        [key: string]: any;
+    }): SummarySource | null;
+    /**
+     * Extract summary from planning response
+     */
+    extractFromPlanning(result: {
+        validationSummary?: TraceSummary;
+    }): SummarySource | null;
+    /**
+     * Extract summary from routing response
+     */
+    extractFromRouting(result: {
+        routingDecision?: {
+            summary?: TraceSummary;
+            selectedAgent?: string;
+            confidence?: number;
+            selectionReason?: string;
+        };
+        result?: {
+            validationSummary?: TraceSummary;
+        };
+    }): SummarySource | null;
+    /**
+     * Convert CompositeSummary to TraceSummary format
+     */
+    private compositeToTraceSummary;
+}
+export declare const summaryExtractor: SummaryExtractor;
+//# sourceMappingURL=summary-extractor.d.ts.map

package/dist/infrastructure/validation/summary-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-extractor.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/summary-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACzC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CAChD;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE;QAC/B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,UAAU,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,YAAY,CAAA;SAAE,GAAG,GAAG,CAAC;QACxD,SAAS,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,YAAY,CAAA;SAAE,GAAG,GAAG,CAAC;QACvD,IAAI,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,YAAY,CAAA;SAAE,GAAG,GAAG,CAAC;QAClD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GAAG,aAAa,GAAG,IAAI;IAsCxB;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAC1B,iBAAiB,CAAC,EAAE,YAAY,CAAC;KAClC,GAAG,aAAa,GAAG,IAAI;IAUxB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE;QACzB,eAAe,CAAC,EAAE;YAChB,OAAO,CAAC,EAAE,YAAY,CAAC;YACvB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,eAAe,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;QACF,MAAM,CAAC,EAAE;YACP,iBAAiB,CAAC,EAAE,YAAY,CAAC;SAClC,CAAC;KACH,GAAG,aAAa,GAAG,IAAI;IAoBxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAiBhC;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/infrastructure/validation/summary-extractor.js

@@ -0,0 +1,102 @@
+/**
+ * Infrastructure: Summary Extractor
+ * Extracts summaries from different response types for review flow
+ * Priority: compositeSummary > validationSummary > routingDecision
+ */
+/**
+ * Extract summary from various response types
+ * Priority order: compositeSummary > validationSummary > routingDecision.summary
+ */
+export class SummaryExtractor {
+    /**
+     * Extract summary from orchestration response
+     */
+    extractFromOrchestration(result) {
+        // Priority 1: Composite summary (aggregated from all agents)
+        if (result.compositeSummary) {
+            // Convert CompositeSummary to TraceSummary format for review handler
+            const traceSummary = this.compositeToTraceSummary(result.compositeSummary);
+            return {
+                summary: traceSummary,
+                source: 'composite',
+            };
+        }
+        // Priority 2: Validation summary
+        if (result.validation?.validationSummary) {
+            return {
+                summary: result.validation.validationSummary,
+                source: 'validation',
+            };
+        }
+        // Priority 3: Execution summary
+        if (result.execution?.validationSummary) {
+            return {
+                summary: result.execution.validationSummary,
+                source: 'validation',
+            };
+        }
+        // Priority 4: Planning summary
+        if (result.plan?.validationSummary) {
+            return {
+                summary: result.plan.validationSummary,
+                source: 'validation',
+            };
+        }
+        return null;
+    }
+    /**
+     * Extract summary from planning response
+     */
+    extractFromPlanning(result) {
+        if (result.validationSummary) {
+            return {
+                summary: result.validationSummary,
+                source: 'validation',
+            };
+        }
+        return null;
+    }
+    /**
+     * Extract summary from routing response
+     */
+    extractFromRouting(result) {
+        // Priority 1: Validation summary from executed agent
+        if (result.result?.validationSummary) {
+            return {
+                summary: result.result.validationSummary,
+                source: 'validation',
+            };
+        }
+        // Priority 2: Routing decision summary (if available)
+        if (result.routingDecision?.summary) {
+            return {
+                summary: result.routingDecision.summary,
+                source: 'routing',
+            };
+        }
+        return null;
+    }
+    /**
+     * Convert CompositeSummary to TraceSummary format
+     */
+    compositeToTraceSummary(composite) {
+        return {
+            runId: composite.runId,
+            operation: composite.operation,
+            agentName: composite.agentName,
+            filesChanged: composite.filesChanged,
+            filesCreated: composite.filesCreated,
+            filesDeleted: composite.filesDeleted,
+            reasoningSteps: composite.reasoningSteps,
+            validationChecks: composite.validationChecks,
+            metrics: composite.metrics,
+            reviewNeeded: composite.reviewNeeded,
+            outcome: composite.outcome,
+            errors: composite.errors,
+            warnings: composite.warnings,
+        };
+    }
+}
+// Singleton instance
+export const summaryExtractor = new SummaryExtractor();
+//# sourceMappingURL=summary-extractor.js.map

package/dist/infrastructure/validation/summary-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-extractor.js","sourceRoot":"","sources":["../../../src/infrastructure/validation/summary-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,wBAAwB,CAAC,MAMxB;QACC,6DAA6D;QAC7D,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,qEAAqE;YACrE,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC3E,OAAO;gBACL,OAAO,EAAE,YAAY;gBACrB,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,iBAAiB;gBAC5C,MAAM,EAAE,YAAY;aACrB,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,IAAI,MAAM,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,iBAAiB;gBAC3C,MAAM,EAAE,YAAY;aACrB,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB;gBACtC,MAAM,EAAE,YAAY;aACrB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,MAEnB;QACC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,iBAAiB;gBACjC,MAAM,EAAE,YAAY;aACrB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAUlB;QACC,qDAAqD;QACrD,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB;gBACxC,MAAM,EAAE,YAAY;aACrB,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,IAAI,MAAM,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,OAAO;gBACvC,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,SAA2B;QACzD,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;YAC5C,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,QAAQ,EAAE,SAAS,CAAC,QAAQ;SAC7B,CAAC;IACJ,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/infrastructure/validation/trace-summary.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Infrastructure: Trace Summary Formatter
+ * Structured summary of agent runs for validation and review
+ *
+ * Outputs:
+ * - Files changed
+ * - Reasoning steps occurred
+ * - Validation checks passed/failed
+ * - Tokens used
+ * - Where user review is needed
+ */
+import type { RunContext } from '../observability/execution-tracer.js';
+import type { AgentFeedback } from './agent-feedback.js';
+export interface TraceSummary {
+    runId: string;
+    operation: string;
+    agentName: string;
+    filesChanged: string[];
+    filesCreated: string[];
+    filesDeleted: string[];
+    reasoningSteps: Array<{
+        step: string;
+        timestamp: number;
+        type: 'thought' | 'action' | 'observation' | 'decision';
+        details?: string;
+    }>;
+    validationChecks: Array<{
+        check: string;
+        passed: boolean;
+        message?: string;
+        critical?: boolean;
+    }>;
+    metrics: {
+        tokensUsed?: number;
+        duration: number;
+        operationsCount: number;
+        filesAnalyzed?: number;
+    };
+    reviewNeeded: {
+        required: boolean;
+        reasons: string[];
+        riskLevel?: 'low' | 'medium' | 'high' | 'critical';
+    };
+    outcome: 'success' | 'failure' | 'partial_success' | 'needs_review';
+    errors?: string[];
+    warnings?: string[];
+}
+/**
+ * Format trace summary from execution trace and feedback
+ */
+export declare class TraceSummaryFormatter {
+    /**
+     * Create summary from run context and feedback
+     */
+    createSummary(run: RunContext, feedback?: AgentFeedback, agentName?: string): TraceSummary;
+    /**
+     * Format summary for console display
+     */
+    formatSummary(summary: TraceSummary): string;
+    private extractFilesChanged;
+    private extractFilesCreated;
+    private extractFilesDeleted;
+    private extractReasoningSteps;
+    private extractValidationChecks;
+    private calculateMetrics;
+    private determineReviewNeeds;
+    private determineOutcome;
+    private extractErrors;
+    private extractWarnings;
+}
+export declare const traceSummaryFormatter: TraceSummaryFormatter;
+//# sourceMappingURL=trace-summary.d.ts.map

package/dist/infrastructure/validation/trace-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-summary.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/trace-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IAGvB,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAGH,gBAAgB,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAGH,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAGF,YAAY,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;KACpD,CAAC;IAGF,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,cAAc,CAAC;IACpE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,UAAU,EACf,QAAQ,CAAC,EAAE,aAAa,EACxB,SAAS,GAAE,MAAwB,GAClC,YAAY;IA+Cf;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IA2I5C,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IAgC7B,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,oBAAoB;IAuD5B,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;CAexB;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}