@principal-ai/principal-view-cli 0.3.8 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/commands/formats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAycpC,wBAAgB,oBAAoB,IAAI,OAAO,CA6B9C"}
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/commands/formats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+fpC,wBAAgB,oBAAoB,IAAI,OAAO,CA6B9C"}

package/dist/commands/formats.js

@@ -48,13 +48,18 @@ ${chalk.dim('│')}       ${chalk.yellow('"type"')}: "text",
 ${chalk.dim('│')}       ${chalk.yellow('"text"')}: "# Event Name", ${chalk.dim('// Markdown description')}     ${chalk.dim('│')}
 ${chalk.dim('│')}       ${chalk.yellow('"x"')}: 0, ${chalk.yellow('"y"')}: 0, ${chalk.yellow('"width"')}: 200, ${chalk.yellow('"height"')}: 100,                   ${chalk.dim('│')}
 ${chalk.dim('│')}       ${chalk.green('"pv"')}: {                                                        ${chalk.dim('│')}
-${chalk.dim('│')}         ${chalk.cyan('"otelEvent"')}: {          ${chalk.dim('// OTEL event definition')}    ${chalk.dim('│')}
-${chalk.dim('│')}           ${chalk.yellow('"name"')}: "feature.event.name",                          ${chalk.dim('│')}
-${chalk.dim('│')}           ${chalk.cyan('"attributes"')}: {       ${chalk.dim('// Required & optional attrs')} ${chalk.dim('│')}
-${chalk.dim('│')}             ${chalk.green('"required"')}: ["attr.name", ...],                     ${chalk.dim('│')}
-${chalk.dim('│')}             ${chalk.green('"optional"')}: ["attr.name", ...]                      ${chalk.dim('│')}
-${chalk.dim('│')}           }                                                            ${chalk.dim('│')}
-${chalk.dim('│')}         }                                                              ${chalk.dim('│')}
+${chalk.dim('│')}         ${chalk.cyan('"event"')}: "feature.event.name",  ${chalk.dim('// Event name')}          ${chalk.dim('│')}
+${chalk.dim('│')}         ${chalk.cyan('"sources"')}: ["src/file.ts"],     ${chalk.dim('// Source files')}        ${chalk.dim('│')}
+${chalk.dim('│')}         ${chalk.cyan('"otel"')}: {                       ${chalk.dim('// OTEL metadata')}       ${chalk.dim('│')}
+${chalk.dim('│')}           ${chalk.yellow('"kind"')}: "event",                                       ${chalk.dim('│')}
+${chalk.dim('│')}           ${chalk.yellow('"category"')}: "lifecycle"                               ${chalk.dim('│')}
+${chalk.dim('│')}         },                                                           ${chalk.dim('│')}
+${chalk.dim('│')}         ${chalk.cyan('"dataSchema"')}: {                 ${chalk.dim('// Attribute definitions')} ${chalk.dim('│')}
+${chalk.dim('│')}           ${chalk.yellow('"attr.name"')}: {                                         ${chalk.dim('│')}
+${chalk.dim('│')}             ${chalk.green('"type"')}: "string",                                    ${chalk.dim('│')}
+${chalk.dim('│')}             ${chalk.green('"required"')}: true                                     ${chalk.dim('│')}
+${chalk.dim('│')}           }                                                          ${chalk.dim('│')}
+${chalk.dim('│')}         }                                                            ${chalk.dim('│')}
 ${chalk.dim('│')}       }                                                                ${chalk.dim('│')}
 ${chalk.dim('│')}     }                                                                  ${chalk.dim('│')}
 ${chalk.dim('│')}   ],                                                                   ${chalk.dim('│')}
@@ -161,12 +166,26 @@ ${chalk.cyan('2. Standard scenario set:')}
    - ${chalk.yellow('Failure')} (priority 2): Feature encountered error
    - ${chalk.dim('Fallback')} (priority 999): Generic execution captured
 
-${chalk.cyan('3. Template interpolation:')}
-   Use {{path.to.value}} to reference event attributes
-   Examples:
-   - {{record.count}}
-   - {{error.message}}
-   - {{result.invalidCount}}
+${chalk.cyan('3. Template syntax (Handlebars):')}
+   Templates use Handlebars syntax for dynamic content:
+
+   ${chalk.bold('Variables:')}
+   - {{variable}}           Simple variable
+   - {{result.count}}       Nested property
+   - {{error.message}}      Deeply nested
+
+   ${chalk.bold('Conditionals:')}
+   - {{#if condition}}...{{/if}}                    If block
+   - {{#if condition}}...{{else}}...{{/if}}         If-else
+   - {{#if (eq status "ok")}}✅{{else}}❌{{/if}}    Comparison
+
+   ${chalk.bold('Loops:')}
+   - {{#each items}}{{this}}{{/each}}               Iterate array
+   - {{#each items}}{{@index}}: {{this}}{{/each}}   With index
+
+   ${chalk.bold('Comparison helpers:')}
+   - eq, ne, lt, gt, lte, gte, and, or, not
+   - Example: {{#if (gt count 10)}}Many{{/if}}
 
 ${chalk.cyan('4. Template style:')}
    - Clear, concise summary line
@@ -292,11 +311,20 @@ ${chalk.yellow('.principal-views/data-validator.otel.canvas')}
       "text": "# validation.started\\n\\nEmitted when validation begins",
       "x": 0, "y": 0, "width": 200, "height": 100,
       "pv": {
-        "otelEvent": {
-          "name": "validation.started",
-          "attributes": {
-            "required": ["input.recordCount"],
-            "optional": ["input.source"]
+        "event": "validation.started",
+        "sources": ["src/validator.ts"],
+        "otel": {
+          "kind": "event",
+          "category": "lifecycle"
+        },
+        "dataSchema": {
+          "input.recordCount": {
+            "type": "number",
+            "required": true
+          },
+          "input.source": {
+            "type": "string",
+            "required": false
           }
         }
       }
@@ -307,11 +335,24 @@ ${chalk.yellow('.principal-views/data-validator.otel.canvas')}
       "text": "# validation.complete\\n\\nEmitted when validation succeeds",
       "x": 250, "y": 0, "width": 200, "height": 100,
       "pv": {
-        "otelEvent": {
-          "name": "validation.complete",
-          "attributes": {
-            "required": ["result.validCount", "result.invalidCount"],
-            "optional": ["duration.ms"]
+        "event": "validation.complete",
+        "sources": ["src/validator.ts"],
+        "otel": {
+          "kind": "event",
+          "category": "lifecycle"
+        },
+        "dataSchema": {
+          "result.validCount": {
+            "type": "number",
+            "required": true
+          },
+          "result.invalidCount": {
+            "type": "number",
+            "required": true
+          },
+          "duration.ms": {
+            "type": "number",
+            "required": false
           }
         }
       }
@@ -322,11 +363,24 @@ ${chalk.yellow('.principal-views/data-validator.otel.canvas')}
       "text": "# validation.error\\n\\nEmitted when validation fails",
       "x": 500, "y": 0, "width": 200, "height": 100,
       "pv": {
-        "otelEvent": {
-          "name": "validation.error",
-          "attributes": {
-            "required": ["error.type", "error.message"],
-            "optional": ["error.stage"]
+        "event": "validation.error",
+        "sources": ["src/validator.ts"],
+        "otel": {
+          "kind": "event",
+          "category": "error"
+        },
+        "dataSchema": {
+          "error.type": {
+            "type": "string",
+            "required": true
+          },
+          "error.message": {
+            "type": "string",
+            "required": true
+          },
+          "error.stage": {
+            "type": "string",
+            "required": false
           }
         }
       }

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

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

package/dist/commands/narrative/validate.js

@@ -2,14 +2,15 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import { resolve, dirname } from 'node:path';
 import { readFileSync } from 'node:fs';
-import { NarrativeValidator } from '@principal-ai/principal-view-core';
-import { loadNarrative, resolvePath } from './utils.js';
+import { NarrativeValidator, computeAggregates } from '@principal-ai/principal-view-core';
+import { loadNarrative, resolvePath, loadExecution, executionToEvents } 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('--execution <path>', 'Execution file (.otel.json) for validating attribute references')
         .option('--json', 'Output violations as JSON')
         .option('-q, --quiet', 'Only show errors, suppress warnings')
         .option('-d, --dir <path>', 'Project directory (default: cwd)')
@@ -40,6 +41,33 @@ export function createValidateCommand() {
                     canvas = undefined;
                 }
             }
+            // Load execution data if provided
+            let executionData;
+            if (options.execution) {
+                try {
+                    const executionPath = resolvePath(options.execution, baseDir);
+                    const execution = await loadExecution(executionPath);
+                    const events = executionToEvents(execution);
+                    const aggregates = computeAggregates(events);
+                    // Build event-specific attribute map
+                    const eventAttributes = new Map();
+                    for (const event of events) {
+                        if (!eventAttributes.has(event.name)) {
+                            eventAttributes.set(event.name, {});
+                        }
+                        const attrs = eventAttributes.get(event.name);
+                        // Merge attributes from this event occurrence
+                        if (event.attributes) {
+                            Object.assign(attrs, event.attributes);
+                        }
+                    }
+                    executionData = { aggregates, eventAttributes };
+                }
+                catch (error) {
+                    console.error(chalk.yellow('Warning:'), `Failed to load execution file: ${error.message}`);
+                    console.error(chalk.gray('  Attribute validation will be skipped'));
+                }
+            }
             // Create validator
             const validator = new NarrativeValidator();
             // Validate
@@ -49,6 +77,7 @@ export function createValidateCommand() {
                 canvasPath,
                 canvas,
                 basePath: baseDir,
+                executionData,
             };
             const result = await validator.validate(context);
             // Filter violations if quiet mode
@@ -77,6 +106,7 @@ export function createValidateCommand() {
                         warnings: warnings.length,
                         scenarioCount: narrative.scenarios.length,
                         hasDefault: narrative.scenarios.some((s) => s.condition.default),
+                        attributeValidation: executionData ? 'enabled' : 'skipped',
                     },
                 };
                 console.log(JSON.stringify(output, null, 2));
@@ -133,6 +163,12 @@ export function createValidateCommand() {
                 if (canvasPath) {
                     console.log(chalk.gray(`  • Canvas: ${narrative.canvas || canvasPath}`));
                 }
+                if (executionData) {
+                    console.log(chalk.gray('  • Attribute validation:'), chalk.green('enabled'));
+                }
+                else {
+                    console.log(chalk.gray('  • Attribute validation:'), chalk.gray('skipped (use --execution to enable)'));
+                }
                 console.log();
             }
             // Exit with error code if validation failed