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

package/dist/commands/lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwTpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwQ3C"}
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsUpC,wBAAgB,iBAAiB,IAAI,OAAO,CA+P3C"}

package/dist/commands/lint.js

@@ -255,6 +255,19 @@ function formatJsonOutput(results) {
     };
 }
 // ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Count violations by rule ID
+ */
+function countByRule(violations) {
+    const counts = {};
+    for (const v of violations) {
+        counts[v.ruleId] = (counts[v.ruleId] || 0) + 1;
+    }
+    return counts;
+}
+// ============================================================================
 // Command Implementation
 // ============================================================================
 export function createLintCommand() {
@@ -364,14 +377,6 @@ export function createLintCommand() {
                     console.log(chalk.yellow(`Warning: Could not load library from ${libraryPath}`));
                 }
             }
-            // Helper function to count violations by rule
-            function countByRule(violations) {
-                const counts = {};
-                for (const v of violations) {
-                    counts[v.ruleId] = (counts[v.ruleId] || 0) + 1;
-                }
-                return counts;
-            }
             // Create validators
             const engine = createDefaultRulesEngine();
             const narrativeValidator = createNarrativeValidator();

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

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

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

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

package/dist/commands/narrative/eval.js

@@ -0,0 +1,76 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFile } from 'node:fs/promises';
+import { evaluateExpression } from '@principal-ai/principal-view-core';
+import { resolvePath, formatValue } from './utils.js';
+export function createEvalCommand() {
+    const command = new Command('eval');
+    command
+        .description('Evaluate template expression with context')
+        .argument('<expression>', 'Template expression to evaluate (e.g., {count > 5 ? \'many\' : \'few\'})')
+        .argument('[context]', 'Optional path to JSON context file')
+        .option('--context <json>', 'Inline JSON context as string')
+        .option('--json', 'Output result as JSON')
+        .action(async (expression, contextPath, options) => {
+        try {
+            let context = {};
+            // Load context from file or inline option
+            if (contextPath) {
+                const content = await readFile(resolvePath(contextPath), 'utf-8');
+                context = JSON.parse(content);
+            }
+            else if (options.context) {
+                context = JSON.parse(options.context);
+            }
+            // Remove curly braces if user included them
+            let cleanExpression = expression.trim();
+            if (cleanExpression.startsWith('{') && cleanExpression.endsWith('}')) {
+                cleanExpression = cleanExpression.slice(1, -1).trim();
+            }
+            // Evaluate expression
+            const result = evaluateExpression(cleanExpression, context);
+            if (options.json) {
+                const output = {
+                    expression: cleanExpression,
+                    context,
+                    result,
+                    type: typeof result,
+                };
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                console.log(chalk.bold('\nExpression:'), chalk.cyan(`{${cleanExpression}}`));
+                if (Object.keys(context).length > 0) {
+                    console.log(chalk.bold('\nContext:'));
+                    for (const [key, value] of Object.entries(context)) {
+                        console.log(chalk.gray('  •'), `${key} = ${formatValue(value)}`);
+                    }
+                }
+                else {
+                    console.log(chalk.yellow('\nNo context provided'));
+                }
+                console.log(chalk.bold('\nResult:'), formatValue(result));
+                console.log(chalk.gray('Type:'), typeof result);
+                console.log();
+            }
+        }
+        catch (error) {
+            const errorMessage = error.message;
+            if (options.json) {
+                const output = {
+                    error: true,
+                    message: errorMessage,
+                    expression: expression,
+                };
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                console.error(chalk.red('\nEvaluation Error:'), errorMessage);
+                console.error(chalk.gray('\nExpression:'), expression);
+                console.log();
+            }
+            process.exit(1);
+        }
+    });
+    return command;
+}

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

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

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

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

package/dist/commands/narrative/index.js

@@ -0,0 +1,19 @@
+import { Command } from 'commander';
+import { createValidateCommand } from './validate.js';
+import { createInspectCommand } from './inspect.js';
+import { createRenderCommand } from './render.js';
+import { createTestCommand } from './test.js';
+import { createEvalCommand } from './eval.js';
+import { createListCommand } from './list.js';
+export function createNarrativeCommand() {
+    const command = new Command('narrative');
+    command
+        .description('Validate, test, and debug narrative templates')
+        .addCommand(createValidateCommand())
+        .addCommand(createInspectCommand())
+        .addCommand(createRenderCommand())
+        .addCommand(createTestCommand())
+        .addCommand(createEvalCommand())
+        .addCommand(createListCommand());
+    return command;
+}

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

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

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

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

package/dist/commands/narrative/inspect.js

@@ -0,0 +1,109 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { computeAggregates } from '@principal-ai/principal-view-core';
+import { loadExecution, executionToEvents, resolvePath, formatTimestamp, formatDuration, groupAttributesByPrefix, filterAttributes, countEventsByType, formatValue, capitalize, } from './utils.js';
+export function createInspectCommand() {
+    const command = new Command('inspect');
+    command
+        .description('Inspect execution file and show available attributes for templates')
+        .argument('<execution>', 'Path to .otel.json execution file')
+        .option('--events', 'Show all events')
+        .option('--aggregates', 'Show computed aggregates (default)', true)
+        .option('--json', 'Output as JSON')
+        .option('--filter <pattern>', 'Filter attributes by pattern (e.g., auth.*)')
+        .action(async (execution, options) => {
+        try {
+            const executionPath = resolvePath(execution);
+            // Load execution
+            const executionData = await loadExecution(executionPath);
+            const events = executionToEvents(executionData);
+            // Compute aggregates
+            const aggregates = computeAggregates(events);
+            // Apply filter if provided
+            const filteredAggregates = options.filter
+                ? filterAttributes(aggregates, options.filter)
+                : aggregates;
+            // Count events by type
+            const eventCounts = countEventsByType(events);
+            // Calculate time range
+            const timestamps = events.map((e) => typeof e.timestamp === 'string' ? parseInt(e.timestamp, 10) : e.timestamp);
+            const minTime = Math.min(...timestamps);
+            const maxTime = Math.max(...timestamps);
+            const duration = maxTime - minTime;
+            if (options.json) {
+                const output = {
+                    file: execution,
+                    summary: {
+                        eventCount: events.length,
+                        spanCount: executionData.spans.length,
+                        timeRange: {
+                            start: minTime,
+                            end: maxTime,
+                            duration: duration,
+                        },
+                        status: executionData.metadata?.status || 'UNKNOWN',
+                    },
+                    eventTypes: Array.from(eventCounts.entries()).map(([name, count]) => ({
+                        name,
+                        count,
+                    })),
+                    attributes: filteredAggregates,
+                };
+                if (options.events) {
+                    output.events = events.map((e) => ({
+                        name: e.name,
+                        timestamp: e.timestamp,
+                        attributes: e.attributes,
+                    }));
+                }
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                // Text output
+                console.log(chalk.bold(`\nInspecting: ${execution}\n`));
+                // Execution Summary
+                console.log(chalk.bold('Execution Summary:'));
+                console.log('━'.repeat(60));
+                console.log(chalk.gray('  • Total Events:'), events.length);
+                console.log(chalk.gray('  • Total Spans:'), executionData.spans.length);
+                console.log(chalk.gray('  • Time Range:'), `${formatTimestamp(minTime)} → ${formatTimestamp(maxTime)} (${formatDuration(duration)})`);
+                const status = executionData.metadata?.status || 'UNKNOWN';
+                const statusColor = status === 'OK' ? chalk.green : chalk.red;
+                console.log(chalk.gray('  • Status:'), statusColor(status));
+                // Event Types
+                console.log(chalk.bold('\nEvent Types:'));
+                console.log('━'.repeat(60));
+                for (const [name, count] of eventCounts) {
+                    console.log(chalk.gray('  •'), `${name} (${count})`);
+                }
+                // Available Attributes
+                console.log(chalk.bold('\nAvailable Attributes (for templates):'));
+                console.log('━'.repeat(60));
+                const grouped = groupAttributesByPrefix(filteredAggregates);
+                for (const [prefix, attrs] of Object.entries(grouped)) {
+                    console.log(chalk.bold(`\n${capitalize(prefix)}:`));
+                    for (const [key, value] of Object.entries(attrs)) {
+                        console.log(chalk.gray('  •'), `${key}: ${formatValue(value)}`);
+                    }
+                }
+                // Show events if requested
+                if (options.events) {
+                    console.log(chalk.bold('\nEvents:'));
+                    console.log('━'.repeat(60));
+                    for (const event of events) {
+                        console.log(chalk.cyan(`\n[${formatTimestamp(typeof event.timestamp === 'string' ? parseInt(event.timestamp, 10) : event.timestamp)}]`), chalk.bold(event.name));
+                        for (const [key, value] of Object.entries(event.attributes || {})) {
+                            console.log(chalk.gray('  •'), `${key}: ${formatValue(value)}`);
+                        }
+                    }
+                }
+                console.log();
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

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

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

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

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

package/dist/commands/narrative/list.js

@@ -0,0 +1,101 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { access } from 'node:fs/promises';
+import { resolve, dirname, join } from 'node:path';
+import { globby } from 'globby';
+import { loadNarrative } from './utils.js';
+export function createListCommand() {
+    const command = new Command('list');
+    command
+        .description('List all narrative files in project')
+        .argument('[dir]', 'Directory to search (default: .principal-views/)')
+        .option('--json', 'Output as JSON')
+        .option('--show-canvas', 'Show linked canvas files')
+        .action(async (dir, options) => {
+        try {
+            const searchDir = dir || '.principal-views';
+            const searchPath = resolve(process.cwd(), searchDir);
+            // Find all .narrative.json files
+            const files = await globby('**/*.narrative.json', {
+                cwd: searchPath,
+                ignore: ['node_modules/**', '.git/**', '__executions__/**'],
+            });
+            // Load each narrative and check canvas existence
+            const narratives = await Promise.all(files.map(async (file) => {
+                const fullPath = join(searchPath, file);
+                const narrative = await loadNarrative(fullPath);
+                let canvasExists;
+                if (options.showCanvas && narrative.canvas) {
+                    const narrativeDir = dirname(fullPath);
+                    const canvasPath = resolve(narrativeDir, narrative.canvas);
+                    try {
+                        await access(canvasPath);
+                        canvasExists = true;
+                    }
+                    catch {
+                        canvasExists = false;
+                    }
+                }
+                const defaultCount = narrative.scenarios.filter((s) => s.condition.default).length;
+                return {
+                    file: join(searchDir, file),
+                    canvas: narrative.canvas,
+                    canvasExists,
+                    scenarioCount: narrative.scenarios.length,
+                    defaultCount,
+                    mode: narrative.mode,
+                    name: narrative.name,
+                };
+            }));
+            if (options.json) {
+                const output = {
+                    searchDir,
+                    count: narratives.length,
+                    narratives: narratives.map((n) => ({
+                        file: n.file,
+                        name: n.name,
+                        canvas: n.canvas,
+                        canvasExists: n.canvasExists,
+                        scenarios: n.scenarioCount,
+                        defaultScenarios: n.defaultCount,
+                        mode: n.mode,
+                    })),
+                };
+                console.log(JSON.stringify(output, null, 2));
+            }
+            else {
+                console.log(chalk.bold('\nNarrative Templates:'));
+                console.log('━'.repeat(60));
+                if (narratives.length === 0) {
+                    console.log(chalk.yellow(`\nNo narrative templates found in ${searchDir}`));
+                    console.log();
+                    return;
+                }
+                for (const narrative of narratives) {
+                    console.log(chalk.bold(`\n${narrative.file}`));
+                    if (narrative.name) {
+                        console.log(chalk.gray(`  Name: ${narrative.name}`));
+                    }
+                    if (options.showCanvas && narrative.canvas) {
+                        const status = narrative.canvasExists
+                            ? chalk.green('✓')
+                            : chalk.red('✗');
+                        console.log(chalk.gray(`  Canvas: ${narrative.canvas} ${status}`));
+                    }
+                    else if (narrative.canvas) {
+                        console.log(chalk.gray(`  Canvas: ${narrative.canvas}`));
+                    }
+                    console.log(chalk.gray(`  Scenarios: ${narrative.scenarioCount} (${narrative.defaultCount} default)`));
+                    console.log(chalk.gray(`  Mode: ${narrative.mode}`));
+                }
+                console.log(chalk.bold(`\nFound ${narratives.length} narrative template(s)`));
+                console.log();
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

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

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

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

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

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;
+}