@principal-ai/principal-view-cli 0.1.29 → 0.1.31

package/dist/commands/narrative/render.js

@@ -0,0 +1,99 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { renderNarrative } from '@principal-ai/principal-view-core';
+import { loadNarrative, loadExecution, executionToEvents, resolvePath, } from './utils.js';
+export function createRenderCommand() {
+    const command = new Command('render');
+    command
+        .description('Render narrative template using execution data')
+        .argument('<narrative>', 'Path to .narrative.json file')
+        .argument('<execution>', 'Path to .otel.json execution file')
+        .option('--mode <mode>', 'Override rendering mode: span-tree, timeline, summary-only')
+        .option('--scenario <id>', 'Force specific scenario (skip auto-selection)')
+        .option('--json', 'Output structured result as JSON')
+        .option('--format <format>', 'Output format: text (default), markdown, json', 'text')
+        .option('--show-metadata', 'Include rendering metadata in output')
+        .action(async (narrativePath, executionPath, options) => {
+        try {
+            const narrative = await loadNarrative(resolvePath(narrativePath));
+            const executionData = await loadExecution(resolvePath(executionPath));
+            const events = executionToEvents(executionData);
+            // Override mode if specified
+            if (options.mode) {
+                const validModes = ['span-tree', 'timeline', 'summary-only'];
+                if (!validModes.includes(options.mode)) {
+                    throw new Error(`Invalid mode: ${options.mode}. Must be one of: ${validModes.join(', ')}`);
+                }
+                narrative.mode = options.mode;
+            }
+            // Render narrative
+            const result = renderNarrative(narrative, events);
+            // Get the selected scenario from the result
+            const selectedScenario = narrative.scenarios.find((s) => s.id === result.scenarioId);
+            // Force scenario if specified
+            if (options.scenario) {
+                const scenario = narrative.scenarios.find((s) => s.id === options.scenario);
+                if (!scenario) {
+                    throw new Error(`Scenario not found: ${options.scenario}`);
+                }
+                // Note: This would require a way to force scenario in renderNarrative API
+                // For now, we'll just validate the scenario exists
+            }
+            if (options.json) {
+                const output = {
+                    narrative: narrativePath,
+                    execution: executionPath,
+                    mode: narrative.mode,
+                    scenario: {
+                        id: selectedScenario?.id,
+                        priority: selectedScenario?.priority,
+                        matched: true,
+                    },
+                    text: result.text,
+                };
+                if (options.showMetadata) {
+                    output.metadata = result.metadata;
+                }
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                // Text output
+                if (!options.format || options.format === 'text') {
+                    console.log(chalk.gray(`Rendering: ${narrativePath}`));
+                    console.log(chalk.gray(`Execution: ${executionPath}`));
+                    console.log(chalk.gray(`Mode: ${narrative.mode}`));
+                    if (selectedScenario) {
+                        console.log(chalk.gray(`Scenario: ${selectedScenario.id} (priority: ${selectedScenario.priority})`));
+                    }
+                    console.log();
+                    console.log('━'.repeat(60));
+                    console.log();
+                    console.log(result.text);
+                    console.log();
+                    console.log('━'.repeat(60));
+                    if (options.showMetadata && result.metadata) {
+                        console.log();
+                        console.log(chalk.bold('Metadata:'));
+                        console.log(chalk.gray('  • Event Count:'), result.metadata.eventCount);
+                        console.log(chalk.gray('  • Span Count:'), result.metadata.spanCount);
+                        if (result.metadata.timeRange) {
+                            console.log(chalk.gray('  • Time Range:'), `${result.metadata.timeRange.start} → ${result.metadata.timeRange.end}`);
+                        }
+                    }
+                    console.log();
+                }
+                else if (options.format === 'markdown') {
+                    console.log(result.text);
+                }
+                else if (options.format === 'json') {
+                    console.log(JSON.stringify({ text: result.text }, null, 2));
+                }
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

package/dist/commands/narrative/test.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createTestCommand(): Command;
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/narrative/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/commands/narrative/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAuL3C"}

package/dist/commands/narrative/test.js

@@ -0,0 +1,150 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { selectScenario, matchesCondition, computeAggregates, hasEventMatching, } from '@principal-ai/principal-view-core';
+import { loadNarrative, loadExecution, executionToEvents, resolvePath, formatValue, } from './utils.js';
+export function createTestCommand() {
+    const command = new Command('test');
+    command
+        .description('Test scenario matching and show why scenarios match or don\'t match')
+        .argument('<narrative>', 'Path to .narrative.json file')
+        .argument('<execution>', 'Path to .otel.json execution file')
+        .option('--show-all', 'Show all scenarios (not just matches)')
+        .option('--show-aggregates', 'Display computed aggregates')
+        .option('--json', 'Output as JSON')
+        .action(async (narrativePath, executionPath, options) => {
+        try {
+            const narrative = await loadNarrative(resolvePath(narrativePath));
+            const executionData = await loadExecution(resolvePath(executionPath));
+            const events = executionToEvents(executionData);
+            // Compute aggregates
+            const aggregates = computeAggregates(events);
+            // Test each scenario
+            const scenarioResults = narrative.scenarios.map((scenario) => {
+                const condition = scenario.condition;
+                const matched = matchesCondition(condition, events, aggregates);
+                let reason;
+                const requiresResults = [];
+                const excludesResults = [];
+                // Check requires
+                if (condition.requires) {
+                    for (const pattern of condition.requires) {
+                        const hasMatch = hasEventMatching(events, pattern);
+                        const count = events.filter((e) => hasEventMatching([e], pattern)).length;
+                        requiresResults.push({ pattern, matched: hasMatch, count });
+                        if (!hasMatch && !reason) {
+                            reason = `Missing required event '${pattern}'`;
+                        }
+                    }
+                }
+                // Check excludes
+                if (condition.excludes) {
+                    for (const pattern of condition.excludes) {
+                        const hasMatch = hasEventMatching(events, pattern);
+                        const count = events.filter((e) => hasEventMatching([e], pattern)).length;
+                        excludesResults.push({ pattern, matched: hasMatch, count });
+                        if (hasMatch && !reason) {
+                            reason = `Found excluded event '${pattern}'`;
+                        }
+                    }
+                }
+                // Default scenario
+                if (condition.default) {
+                    reason = 'Default scenario (always matches)';
+                }
+                return {
+                    scenario,
+                    matched,
+                    reason,
+                    requiresResults,
+                    excludesResults,
+                };
+            });
+            // Select the winning scenario
+            const matchResult = selectScenario(narrative, events, aggregates);
+            const selectedScenario = matchResult.scenario;
+            if (options.json) {
+                const output = {
+                    narrative: narrativePath,
+                    execution: executionPath,
+                    scenarios: scenarioResults.map((r) => ({
+                        id: r.scenario.id,
+                        priority: r.scenario.priority,
+                        matched: r.matched,
+                        reason: r.reason,
+                        requires: r.requiresResults,
+                        excludes: r.excludesResults,
+                    })),
+                    selectedScenario: selectedScenario?.id,
+                    aggregates: options.showAggregates ? aggregates : undefined,
+                };
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                // Text output
+                console.log(chalk.bold(`\nTesting: ${narrativePath}`));
+                console.log(chalk.gray(`Execution: ${executionPath}\n`));
+                console.log(chalk.bold('Scenario Matching Results:'));
+                console.log('━'.repeat(60));
+                // Sort by priority (lower = higher priority)
+                const sorted = [...scenarioResults].sort((a, b) => a.scenario.priority - b.scenario.priority);
+                for (const result of sorted) {
+                    if (!options.showAll && !result.matched) {
+                        continue;
+                    }
+                    const icon = result.matched ? chalk.green('✓') : chalk.red('✗');
+                    const status = result.matched
+                        ? chalk.green('MATCHED')
+                        : chalk.gray('NOT MATCHED');
+                    console.log(`\n${icon} ${chalk.bold(result.scenario.id)} (priority: ${result.scenario.priority}) - ${status}`);
+                    // Show requires
+                    if (result.requiresResults.length > 0) {
+                        console.log(chalk.gray('  Requires:'));
+                        for (const req of result.requiresResults) {
+                            const reqIcon = req.matched ? chalk.green('✓') : chalk.red('✗');
+                            const countMsg = req.matched ? `Found ${req.count} event(s)` : 'No matching events';
+                            console.log(`    ${reqIcon} ${req.pattern} - ${countMsg}`);
+                        }
+                    }
+                    // Show excludes
+                    if (result.excludesResults.length > 0) {
+                        console.log(chalk.gray('  Excludes:'));
+                        for (const exc of result.excludesResults) {
+                            const excIcon = exc.matched ? chalk.red('✗') : chalk.green('✓');
+                            const countMsg = exc.matched ? `Found ${exc.count} event(s)` : 'No matching events';
+                            console.log(`    ${excIcon} ${exc.pattern} - ${countMsg}`);
+                        }
+                    }
+                    if (result.reason && !result.matched) {
+                        console.log(chalk.gray(`  Reason: ${result.reason}`));
+                    }
+                    if (result.scenario.condition.default) {
+                        console.log(chalk.gray('  Default scenario (always matches)'));
+                    }
+                }
+                console.log('\n' + '━'.repeat(60));
+                if (selectedScenario) {
+                    console.log(chalk.bold('\nSelected Scenario:'), chalk.cyan(`${selectedScenario.id} (priority: ${selectedScenario.priority})`));
+                }
+                else {
+                    console.log(chalk.yellow('\nNo scenario selected'));
+                }
+                if (options.showAggregates) {
+                    console.log(chalk.bold('\nComputed Aggregates:'));
+                    for (const [key, value] of Object.entries(aggregates)) {
+                        console.log(chalk.gray('  •'), `${key}: ${formatValue(value)}`);
+                    }
+                }
+                console.log();
+            }
+            // Exit with error if no scenario matched
+            if (!selectedScenario) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

package/dist/commands/narrative/utils.d.ts

@@ -0,0 +1,69 @@
+import type { NarrativeTemplate, OtelEvent } from '@principal-ai/principal-view-core';
+export interface ExecutionData {
+    metadata?: {
+        status?: string;
+        testName?: string;
+        sessionId?: string;
+        startTime?: number;
+        endTime?: number;
+    };
+    spans: Array<{
+        id: string;
+        name: string;
+        startTime?: number;
+        endTime?: number;
+        duration?: number;
+        status?: 'OK' | 'ERROR';
+        attributes?: Record<string, unknown>;
+        events: Array<{
+            time: number;
+            name: string;
+            attributes: Record<string, unknown>;
+        }>;
+    }>;
+}
+/**
+ * Load a narrative template from a file
+ */
+export declare function loadNarrative(filePath: string): Promise<NarrativeTemplate>;
+/**
+ * Load execution data from a .otel.json file
+ */
+export declare function loadExecution(filePath: string): Promise<ExecutionData>;
+/**
+ * Convert execution data to OtelEvent array format expected by narrative APIs
+ */
+export declare function executionToEvents(execution: ExecutionData): OtelEvent[];
+/**
+ * Resolve a file path relative to a base directory
+ */
+export declare function resolvePath(filePath: string, baseDir?: string): string;
+/**
+ * Format a timestamp as human-readable date/time
+ */
+export declare function formatTimestamp(timestamp: number): string;
+/**
+ * Format duration in milliseconds
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Group attributes by prefix (e.g., 'auth.method' -> 'auth')
+ */
+export declare function groupAttributesByPrefix(attributes: Record<string, unknown>): Record<string, Record<string, unknown>>;
+/**
+ * Filter attributes by pattern (supports glob-like patterns)
+ */
+export declare function filterAttributes(attributes: Record<string, unknown>, pattern: string): Record<string, unknown>;
+/**
+ * Count events by type/name
+ */
+export declare function countEventsByType(events: OtelEvent[]): Map<string, number>;
+/**
+ * Format attribute value for display
+ */
+export declare function formatValue(value: unknown): string;
+/**
+ * Capitalize first letter of a string
+ */
+export declare function capitalize(str: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commands/narrative/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/commands/narrative/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAUhF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAU5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,EAAE,CAmBvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAS1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAclD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/commands/narrative/utils.js

@@ -0,0 +1,158 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/**
+ * Load a narrative template from a file
+ */
+export async function loadNarrative(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Narrative file not found: ${filePath}`);
+        }
+        throw new Error(`Failed to parse narrative file: ${error.message}`);
+    }
+}
+/**
+ * Load execution data from a .otel.json file
+ */
+export async function loadExecution(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Execution file not found: ${filePath}`);
+        }
+        throw new Error(`Failed to parse execution file: ${error.message}`);
+    }
+}
+/**
+ * Convert execution data to OtelEvent array format expected by narrative APIs
+ */
+export function executionToEvents(execution) {
+    const events = [];
+    for (const span of execution.spans) {
+        for (const event of span.events) {
+            events.push({
+                name: event.name,
+                timestamp: event.time,
+                type: 'log',
+                attributes: {
+                    ...event.attributes,
+                    'span.id': span.id,
+                    'span.name': span.name,
+                },
+            });
+        }
+    }
+    return events;
+}
+/**
+ * Resolve a file path relative to a base directory
+ */
+export function resolvePath(filePath, baseDir) {
+    if (baseDir) {
+        return resolve(baseDir, filePath);
+    }
+    return resolve(filePath);
+}
+/**
+ * Format a timestamp as human-readable date/time
+ */
+export function formatTimestamp(timestamp) {
+    const date = new Date(timestamp);
+    return date.toLocaleString('en-US', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+}
+/**
+ * Format duration in milliseconds
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = (ms / 1000).toFixed(1);
+    return `${seconds}s`;
+}
+/**
+ * Group attributes by prefix (e.g., 'auth.method' -> 'auth')
+ */
+export function groupAttributesByPrefix(attributes) {
+    const grouped = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        const parts = key.split('.');
+        if (parts.length > 1) {
+            const prefix = parts[0];
+            if (!grouped[prefix]) {
+                grouped[prefix] = {};
+            }
+            grouped[prefix][key] = value;
+        }
+        else {
+            if (!grouped['Other']) {
+                grouped['Other'] = {};
+            }
+            grouped['Other'][key] = value;
+        }
+    }
+    return grouped;
+}
+/**
+ * Filter attributes by pattern (supports glob-like patterns)
+ */
+export function filterAttributes(attributes, pattern) {
+    const regex = new RegExp('^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
+    const filtered = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if (regex.test(key)) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Count events by type/name
+ */
+export function countEventsByType(events) {
+    const counts = new Map();
+    for (const event of events) {
+        const count = counts.get(event.name) || 0;
+        counts.set(event.name, count + 1);
+    }
+    return counts;
+}
+/**
+ * Format attribute value for display
+ */
+export function formatValue(value) {
+    if (typeof value === 'string') {
+        return `"${value}"`;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (value === null || value === undefined) {
+        return 'null';
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Capitalize first letter of a string
+ */
+export function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/dist/commands/narrative/validate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createValidateCommand(): Command;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/narrative/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/narrative/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,qBAAqB,IAAI,OAAO,CA6J/C"}

package/dist/commands/narrative/validate.js

@@ -0,0 +1,135 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { resolve, dirname } from 'node:path';
+import { NarrativeValidator } from '@principal-ai/principal-view-core';
+import { loadNarrative, resolvePath } from './utils.js';
+export function createValidateCommand() {
+    const command = new Command('validate');
+    command
+        .description('Validate narrative template syntax, schema, and references')
+        .argument('<file>', 'Path to .narrative.json file')
+        .option('--canvas <path>', 'Override canvas file path for validation')
+        .option('--json', 'Output violations as JSON')
+        .option('-q, --quiet', 'Only show errors, suppress warnings')
+        .option('-d, --dir <path>', 'Project directory (default: cwd)')
+        .action(async (file, options) => {
+        try {
+            const baseDir = options.dir || process.cwd();
+            const narrativePath = resolvePath(file, baseDir);
+            // Load narrative
+            const narrative = await loadNarrative(narrativePath);
+            // Resolve canvas path
+            let canvasPath;
+            if (options.canvas) {
+                canvasPath = resolvePath(options.canvas, baseDir);
+            }
+            else if (narrative.canvas) {
+                const narrativeDir = dirname(narrativePath);
+                canvasPath = resolve(narrativeDir, narrative.canvas);
+            }
+            // Create validator
+            const validator = new NarrativeValidator();
+            // Validate
+            const context = {
+                narrative,
+                narrativePath,
+                canvasPath,
+                basePath: baseDir,
+            };
+            const result = await validator.validate(context);
+            // Filter violations if quiet mode
+            const violations = options.quiet
+                ? result.violations.filter((v) => v.severity === 'error')
+                : result.violations;
+            const errors = violations.filter((v) => v.severity === 'error');
+            const warnings = violations.filter((v) => v.severity === 'warn');
+            // Output
+            if (options.json) {
+                const output = {
+                    file: file,
+                    valid: errors.length === 0,
+                    violations: violations.map((v) => ({
+                        severity: v.severity,
+                        ruleId: v.ruleId,
+                        file: v.file,
+                        path: v.path,
+                        message: v.message,
+                        impact: v.impact,
+                        suggestion: v.suggestion,
+                        fixable: v.fixable,
+                    })),
+                    summary: {
+                        errors: errors.length,
+                        warnings: warnings.length,
+                        scenarioCount: narrative.scenarios.length,
+                        hasDefault: narrative.scenarios.some((s) => s.condition.default),
+                    },
+                };
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                // Text output
+                console.log(chalk.bold(`\nValidating: ${file}\n`));
+                if (errors.length === 0 && warnings.length === 0) {
+                    console.log(chalk.green('✓'), 'Schema validation passed');
+                    console.log(chalk.green('✓'), `${narrative.scenarios.length} scenarios found`);
+                    const hasDefault = narrative.scenarios.some((s) => s.condition.default);
+                    console.log(chalk.green('✓'), hasDefault ? 'Default scenario present' : 'No default scenario');
+                    const priorities = narrative.scenarios.map((s) => s.priority);
+                    const allUnique = new Set(priorities).size === priorities.length;
+                    console.log(chalk.green('✓'), allUnique ? 'All priorities unique' : 'Duplicate priorities found');
+                    if (canvasPath) {
+                        console.log(chalk.green('✓'), `Canvas: ${narrative.canvas || canvasPath} ✓`);
+                    }
+                }
+                else {
+                    // Show violations
+                    for (const violation of violations) {
+                        const icon = violation.severity === 'error' ? chalk.red('✗') : chalk.yellow('⚠');
+                        const severity = violation.severity === 'error'
+                            ? chalk.red('Error')
+                            : chalk.yellow('Warning');
+                        console.log(`\n${icon} ${severity}: ${violation.message}`);
+                        if (violation.path) {
+                            console.log(chalk.gray(`  Location: ${violation.path}`));
+                        }
+                        if (violation.impact) {
+                            console.log(chalk.gray(`  Impact: ${violation.impact}`));
+                        }
+                        if (violation.suggestion) {
+                            console.log(chalk.cyan(`  Suggestion: ${violation.suggestion}`));
+                        }
+                    }
+                }
+                // Summary
+                console.log(chalk.bold('\nSummary:'));
+                if (errors.length > 0) {
+                    console.log(chalk.red(`  • ${errors.length} error(s)`));
+                }
+                else {
+                    console.log(chalk.green('  • 0 errors'));
+                }
+                if (warnings.length > 0) {
+                    console.log(chalk.yellow(`  • ${warnings.length} warning(s)`));
+                }
+                else if (!options.quiet) {
+                    console.log(chalk.green('  • 0 warnings'));
+                }
+                console.log(chalk.gray(`  • ${narrative.scenarios.length} scenario(s)`));
+                if (canvasPath) {
+                    console.log(chalk.gray(`  • Canvas: ${narrative.canvas || canvasPath}`));
+                }
+                console.log();
+            }
+            // Exit with error code if validation failed
+            if (errors.length > 0) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

package/dist/commands/validate-execution.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate execution files command
+ *
+ * Validates .spans.json, .execution.json, .otel.json, and .events.json files
+ * to ensure they conform to the expected ExecutionData structure.
+ */
+import { Command } from 'commander';
+/**
+ * Create the validate-execution command
+ */
+export declare function createValidateExecutionCommand(): Command;
+//# sourceMappingURL=validate-execution.d.ts.map

package/dist/commands/validate-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution.d.ts","sourceRoot":"","sources":["../../src/commands/validate-execution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqJpC;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CA8GxD"}