@principal-ai/principal-view-cli 0.6.3 → 0.8.0

package/dist/commands/formats.js

@@ -14,9 +14,9 @@ ${chalk.bold('1. Canvas Files')} ${chalk.yellow('.otel.canvas')}
    Define OTEL event schemas and telemetry structure for a feature.
    These are the single source of truth for what events should be emitted.
 
-${chalk.bold('2. Narrative Files')} ${chalk.yellow('.narrative.json')}
+${chalk.bold('2. Workflow Files')} ${chalk.yellow('.workflow.json')}
    Define scenarios and templates for rendering executions as human-readable
-   narratives based on the emitted events.
+   workflows based on the emitted events.
 
 ${chalk.bold('3. Execution Files')} ${chalk.yellow('.otel.json')}
    Captured OTEL spans from test runs or production code, exported for
@@ -24,7 +24,7 @@ ${chalk.bold('3. Execution Files')} ${chalk.yellow('.otel.json')}
 
 Run ${chalk.cyan('npx @principal-ai/principal-view-cli formats <section>')} for details on:
   ${chalk.yellow('canvas')}       .otel.canvas format and event schemas
-  ${chalk.yellow('narrative')}    .narrative.json format and scenario structure
+  ${chalk.yellow('workflow')}    .workflow.json format and scenario structure
   ${chalk.yellow('execution')}    .otel.json format for captured spans
   ${chalk.yellow('examples')}     Complete example files
 `,
@@ -108,28 +108,28 @@ ${chalk.cyan('5. Required vs Optional attributes:')}
 ${chalk.bold('Validation:')}
   ${chalk.cyan('npx @principal-ai/principal-view-cli validate')}
 `,
-    narrative: `
-${chalk.bold.cyan('Narrative Format (.narrative.json)')}
+    workflow: `
+${chalk.bold.cyan('Workflow Format (.workflow.json)')}
 ${chalk.dim('═'.repeat(70))}
 
-Narrative files define scenarios for rendering execution data as human-readable
+Workflow files define scenarios for rendering execution data as human-readable
 stories. They evaluate conditions against captured events to select the best
-matching narrative template.
+matching workflow template.
 
 ${chalk.bold('File Location:')}
-  ${chalk.dim('.principal-views/')}${chalk.yellow('<feature-name>.narrative.json')}
+  ${chalk.dim('.principal-views/')}${chalk.yellow('<feature-name>.workflow.json')}
   ${chalk.dim('(co-located with corresponding .otel.canvas file)')}
 
 ${chalk.bold('Required Structure:')}
 ${chalk.dim('┌────────────────────────────────────────────────────────────────────┐')}
 ${chalk.dim('│')} {                                                                  ${chalk.dim('│')}
-${chalk.dim('│')}   ${chalk.green('"name"')}: "Feature Name",      ${chalk.dim('// NOT "Feature Name Narratives"')} ${chalk.dim('│')}
-${chalk.dim('│')}   ${chalk.green('"description"')}: "What the feature does",  ${chalk.dim('// Purpose, not "Narratives for..."')} ${chalk.dim('│')}
+${chalk.dim('│')}   ${chalk.green('"name"')}: "Feature Name",      ${chalk.dim('// NOT "Feature Name Workflows"')} ${chalk.dim('│')}
+${chalk.dim('│')}   ${chalk.green('"description"')}: "What the feature does",  ${chalk.dim('// Purpose, not "Workflows for..."')} ${chalk.dim('│')}
 ${chalk.dim('│')}   ${chalk.green('"scenarios"')}: [                                                 ${chalk.dim('│')}
 ${chalk.dim('│')}     {                                                              ${chalk.dim('│')}
 ${chalk.dim('│')}       ${chalk.yellow('"priority"')}: 1,           ${chalk.dim('// Lower = higher priority')}   ${chalk.dim('│')}
 ${chalk.dim('│')}       ${chalk.yellow('"condition"')}: "...",      ${chalk.dim('// JSONPath/logic expression')} ${chalk.dim('│')}
-${chalk.dim('│')}       ${chalk.yellow('"template"')}: {            ${chalk.dim('// Narrative template')}        ${chalk.dim('│')}
+${chalk.dim('│')}       ${chalk.yellow('"template"')}: {            ${chalk.dim('// Workflow template')}        ${chalk.dim('│')}
 ${chalk.dim('│')}         ${chalk.cyan('"summary"')}: "Completed {{count}} items",  ${chalk.dim('// Handlebars template')} ${chalk.dim('│')}
 ${chalk.dim('│')}         ${chalk.cyan('"events"')}: {                ${chalk.dim('// Per-event templates')}       ${chalk.dim('│')}
 ${chalk.dim('│')}           "event.name": "Event {{attribute}} occurred"           ${chalk.dim('│')}
@@ -142,14 +142,14 @@ ${chalk.dim('└─────────────────────
 
 ${chalk.bold('Naming Guidelines:')}
 
-  ❌ DON'T append "Narratives" to the name:
-     "name": "Package Processor Narratives"
+  ❌ DON'T append "Workflows" to the name:
+     "name": "Package Processor Workflows"
 
   ✅ DO use the feature name directly:
      "name": "Package Processor"
 
   ❌ DON'T prefix description with boilerplate:
-     "description": "Human-readable narratives for package extraction..."
+     "description": "Human-readable workflows for package extraction..."
 
   ✅ DO describe the feature's purpose:
      "description": "Package extraction and analysis from repository file trees"
@@ -200,7 +200,7 @@ ${chalk.cyan('5. Template style:')}
    - Include key metrics and IDs
 
 ${chalk.bold('Validation:')}
-  ${chalk.cyan('npx @principal-ai/principal-view-cli narrative validate')}
+  ${chalk.cyan('npx @principal-ai/principal-view-cli workflow validate')}
 `,
     execution: `
 ${chalk.bold.cyan('Execution Format (.otel.json)')}
@@ -399,9 +399,9 @@ ${chalk.yellow('.principal-views/data-validator.otel.canvas')}
   }
 }
 
-${chalk.bold('Example 2: Narrative Scenarios')}
+${chalk.bold('Example 2: Workflow Scenarios')}
 ${chalk.dim('─'.repeat(70))}
-${chalk.yellow('.principal-views/data-validator.narrative.json')}
+${chalk.yellow('.principal-views/data-validator.workflow.json')}
 
 {
   "name": "Data Validator",
@@ -501,7 +501,7 @@ ${chalk.yellow('__executions__/data-validator.otel.json')}
 
 ${chalk.bold('Next Steps:')}
   ${chalk.cyan('npx @principal-ai/principal-view-cli validate')}          Validate canvas
-  ${chalk.cyan('npx @principal-ai/principal-view-cli narrative validate')} Validate narratives
+  ${chalk.cyan('npx @principal-ai/principal-view-cli workflow validate')} Validate workflows
   ${chalk.cyan('npx @principal-ai/principal-view-cli validate-execution')}  Validate execution
 `,
 };
@@ -509,7 +509,7 @@ export function createFormatsCommand() {
     const command = new Command('formats');
     command
         .description('Display documentation about file formats')
-        .argument('[section]', 'Section to display: overview, canvas, narrative, execution, examples')
+        .argument('[section]', 'Section to display: overview, canvas, workflow, execution, examples')
         .action((section) => {
         const validSections = Object.keys(FORMAT_SECTIONS);
         if (!section) {

package/dist/commands/lint.js

@@ -8,7 +8,7 @@ import chalk from 'chalk';
 import { globby } from 'globby';
 import yaml from 'js-yaml';
 // Node.js-specific imports (rules engine, config management, validators)
-import { createDefaultRulesEngine, validatePrivuConfig, mergeConfigs, getDefaultConfig, createNarrativeValidator, } from '@principal-ai/principal-view-core/node';
+import { createDefaultRulesEngine, validatePrivuConfig, mergeConfigs, getDefaultConfig, createWorkflowValidator, } from '@principal-ai/principal-view-core/node';
 // ============================================================================
 // Config File Loading
 // ============================================================================
@@ -118,23 +118,23 @@ function loadGraphConfig(filePath) {
     }
 }
 /**
- * Load a narrative template file
+ * Load a workflow template file
  */
-function loadNarrativeTemplate(filePath) {
+function loadWorkflowTemplate(filePath) {
     if (!existsSync(filePath)) {
         return null;
     }
     try {
         const raw = readFileSync(filePath, 'utf8');
-        const narrative = JSON.parse(raw);
-        return { narrative, raw };
+        const workflow = JSON.parse(raw);
+        return { workflow, raw };
     }
     catch {
         return null;
     }
 }
 /**
- * Load a canvas file for narrative validation
+ * Load a canvas file for workflow validation
  */
 function loadCanvas(filePath) {
     if (!existsSync(filePath)) {
@@ -159,8 +159,8 @@ function loadCanvas(filePath) {
  */
 function getFileType(filePath) {
     const name = basename(filePath).toLowerCase();
-    if (name.endsWith('.narrative.json')) {
-        return 'narrative';
+    if (name.endsWith('.workflow.json')) {
+        return 'workflow';
     }
     if (name.endsWith('.canvas') || name.endsWith('.otel.canvas')) {
         return 'canvas';
@@ -347,7 +347,7 @@ export function createLintCommand() {
                 expandDirectories: false,
             });
             // Filter out library files, config files, and execution artifacts
-            // INCLUDE both canvas files and narrative templates for linting
+            // INCLUDE both canvas files and workflow templates for linting
             const configFiles = matchedFiles.filter((f) => {
                 const name = basename(f).toLowerCase();
                 const isLibraryFile = name.startsWith('library.');
@@ -380,45 +380,45 @@ export function createLintCommand() {
             }
             // Create validators
             const engine = createDefaultRulesEngine();
-            const narrativeValidator = createNarrativeValidator();
+            const workflowValidator = createWorkflowValidator();
             // Lint each file
             const results = new Map();
-            // PHASE 1: Group narratives by canvas and collect all events used
-            const narrativesByCanvas = new Map();
+            // PHASE 1: Group workflows by canvas and collect all events used
+            const workflowsByCanvas = new Map();
             const canvasEventMap = new Map();
             for (const filePath of configFiles) {
                 const absolutePath = resolve(cwd, filePath);
                 const relativePath = relative(cwd, absolutePath);
                 const fileType = getFileType(absolutePath);
-                if (fileType === 'narrative') {
-                    const loaded = loadNarrativeTemplate(absolutePath);
+                if (fileType === 'workflow') {
+                    const loaded = loadWorkflowTemplate(absolutePath);
                     if (!loaded)
                         continue;
-                    const canvasPath = loaded.narrative.canvas
-                        ? resolve(dirname(absolutePath), loaded.narrative.canvas)
+                    const canvasPath = loaded.workflow.canvas
+                        ? resolve(dirname(absolutePath), loaded.workflow.canvas)
                         : undefined;
                     if (canvasPath) {
                         const canvasKey = relative(cwd, canvasPath);
-                        // Group narrative by canvas
-                        if (!narrativesByCanvas.has(canvasKey)) {
-                            narrativesByCanvas.set(canvasKey, []);
+                        // Group workflow by canvas
+                        if (!workflowsByCanvas.has(canvasKey)) {
+                            workflowsByCanvas.set(canvasKey, []);
                             canvasEventMap.set(canvasKey, new Set());
                         }
-                        narrativesByCanvas.get(canvasKey).push({ absolutePath, relativePath, loaded });
-                        // Collect events from this narrative
-                        const narrativeEvents = canvasEventMap.get(canvasKey);
-                        for (const scenario of loaded.narrative.scenarios) {
+                        workflowsByCanvas.get(canvasKey).push({ absolutePath, relativePath, loaded });
+                        // Collect events from this workflow
+                        const workflowEvents = canvasEventMap.get(canvasKey);
+                        for (const scenario of loaded.workflow.scenarios) {
                             if (scenario.condition?.requires) {
                                 for (const eventPattern of scenario.condition.requires) {
                                     if (!eventPattern.includes('*')) {
-                                        narrativeEvents.add(eventPattern);
+                                        workflowEvents.add(eventPattern);
                                     }
                                 }
                             }
                             if (scenario.template?.events) {
                                 for (const eventName of Object.keys(scenario.template.events)) {
                                     if (!eventName.includes('*')) {
-                                        narrativeEvents.add(eventName);
+                                        workflowEvents.add(eventName);
                                     }
                                 }
                             }
@@ -431,9 +431,9 @@ export function createLintCommand() {
                 const absolutePath = resolve(cwd, filePath);
                 const relativePath = relative(cwd, absolutePath);
                 const fileType = getFileType(absolutePath);
-                if (fileType === 'narrative') {
-                    // Validate narrative template
-                    const loaded = loadNarrativeTemplate(absolutePath);
+                if (fileType === 'workflow') {
+                    // Validate workflow template
+                    const loaded = loadWorkflowTemplate(absolutePath);
                     if (!loaded) {
                         // File couldn't be loaded - report as error
                         results.set(relativePath, {
@@ -442,7 +442,7 @@ export function createLintCommand() {
                                     ruleId: 'parse-error',
                                     severity: 'error',
                                     file: relativePath,
-                                    message: `Could not parse narrative file: ${filePath}`,
+                                    message: `Could not parse workflow file: ${filePath}`,
                                     impact: 'File cannot be validated',
                                     fixable: false,
                                 },
@@ -456,25 +456,25 @@ export function createLintCommand() {
                         continue;
                     }
                     // Load the referenced canvas if it exists
-                    const canvasPath = loaded.narrative.canvas
-                        ? resolve(dirname(absolutePath), loaded.narrative.canvas)
+                    const canvasPath = loaded.workflow.canvas
+                        ? resolve(dirname(absolutePath), loaded.workflow.canvas)
                         : undefined;
                     const canvas = canvasPath ? loadCanvas(canvasPath) : undefined;
-                    // Get all events used across narratives for this canvas
+                    // Get all events used across workflows for this canvas
                     const canvasKey = canvasPath ? relative(cwd, canvasPath) : undefined;
-                    const allNarrativeEvents = canvasKey ? canvasEventMap.get(canvasKey) : undefined;
-                    // Run narrative validation with canvas-wide event knowledge
-                    const narrativeResult = await narrativeValidator.validate({
-                        narrative: loaded.narrative,
-                        narrativePath: relativePath,
+                    const allWorkflowEvents = canvasKey ? canvasEventMap.get(canvasKey) : undefined;
+                    // Run workflow validation with canvas-wide event knowledge
+                    const workflowResult = await workflowValidator.validate({
+                        workflow: loaded.workflow,
+                        workflowPath: relativePath,
                         canvas: canvas ?? undefined,
                         canvasPath: canvasKey,
                         basePath: dirname(absolutePath),
                         rawContent: loaded.raw,
-                        allNarrativeEvents,
+                        allWorkflowEvents,
                     });
-                    // Convert narrative violations to graph violations format
-                    const violations = narrativeResult.violations.map((v) => ({
+                    // Convert workflow violations to graph violations format
+                    const violations = workflowResult.violations.map((v) => ({
                         ruleId: v.ruleId,
                         severity: v.severity,
                         file: v.file,
@@ -487,10 +487,10 @@ export function createLintCommand() {
                     }));
                     results.set(relativePath, {
                         violations,
-                        errorCount: narrativeResult.errorCount,
-                        warningCount: narrativeResult.warningCount,
-                        fixableCount: narrativeResult.fixableCount,
-                        byCategory: { schema: 0, reference: 0, structure: 0, pattern: 0, library: 0 }, // Could categorize narrative rules
+                        errorCount: workflowResult.errorCount,
+                        warningCount: workflowResult.warningCount,
+                        fixableCount: workflowResult.fixableCount,
+                        byCategory: { schema: 0, reference: 0, structure: 0, pattern: 0, library: 0 }, // Could categorize workflow rules
                         byRule: countByRule(violations),
                     });
                 }

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

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

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

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

package/dist/commands/{narrative → workflow}/index.js

@@ -4,10 +4,10 @@ import { createInspectCommand } from './inspect.js';
 import { createRenderCommand } from './render.js';
 import { createTestCommand } from './test.js';
 import { createListCommand } from './list.js';
-export function createNarrativeCommand() {
-    const command = new Command('narrative');
+export function createWorkflowCommand() {
+    const command = new Command('workflow');
     command
-        .description('Validate, test, and debug narrative templates')
+        .description('Validate, test, and debug workflow templates')
         .addCommand(createValidateCommand())
         .addCommand(createInspectCommand())
         .addCommand(createRenderCommand())

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

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

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

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

package/dist/commands/{narrative → workflow}/list.js

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

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

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

package/dist/commands/{narrative → workflow}/render.js

@@ -1,21 +1,21 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { renderNarrative } from '@principal-ai/principal-view-core';
-import { loadNarrative, loadExecution, executionToEvents, resolvePath, } from './utils.js';
+import { renderWorkflow } from '@principal-ai/principal-view-core';
+import { loadWorkflow, 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')
+        .description('Render workflow template using execution data')
+        .argument('<workflow>', 'Path to .workflow.json file')
         .argument('<execution>', 'Path to .otel.json execution file')
         .option('--mode <mode>', 'Override rendering mode: span-tree, timeline')
         .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) => {
+        .action(async (workflowPath, executionPath, options) => {
         try {
-            const narrative = await loadNarrative(resolvePath(narrativePath));
+            const workflow = await loadWorkflow(resolvePath(workflowPath));
             const executionData = await loadExecution(resolvePath(executionPath));
             const events = executionToEvents(executionData);
             // Override mode if specified
@@ -24,26 +24,26 @@ export function createRenderCommand() {
                 if (!validModes.includes(options.mode)) {
                     throw new Error(`Invalid mode: ${options.mode}. Must be one of: ${validModes.join(', ')}`);
                 }
-                narrative.mode = options.mode;
+                workflow.mode = options.mode;
             }
-            // Render narrative
-            const result = renderNarrative(narrative, events);
+            // Render workflow
+            const result = renderWorkflow(workflow, events);
             // Get the selected scenario from the result
-            const selectedScenario = narrative.scenarios.find((s) => s.id === result.scenarioId);
+            const selectedScenario = workflow.scenarios.find((s) => s.id === result.scenarioId);
             // Force scenario if specified
             if (options.scenario) {
-                const scenario = narrative.scenarios.find((s) => s.id === options.scenario);
+                const scenario = workflow.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
+                // Note: This would require a way to force scenario in renderWorkflow API
                 // For now, we'll just validate the scenario exists
             }
             if (options.json) {
                 const output = {
-                    narrative: narrativePath,
+                    workflow: workflowPath,
                     execution: executionPath,
-                    mode: narrative.mode,
+                    mode: workflow.mode,
                     scenario: {
                         id: selectedScenario?.id,
                         priority: selectedScenario?.priority,
@@ -59,9 +59,9 @@ export function createRenderCommand() {
             else {
                 // Text output
                 if (!options.format || options.format === 'text') {
-                    console.log(chalk.gray(`Rendering: ${narrativePath}`));
+                    console.log(chalk.gray(`Rendering: ${workflowPath}`));
                     console.log(chalk.gray(`Execution: ${executionPath}`));
-                    console.log(chalk.gray(`Mode: ${narrative.mode}`));
+                    console.log(chalk.gray(`Mode: ${workflow.mode}`));
                     if (selectedScenario) {
                         console.log(chalk.gray(`Scenario: ${selectedScenario.id} (priority: ${selectedScenario.priority})`));
                     }

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

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

package/dist/commands/{narrative → workflow}/test.js

@@ -1,25 +1,25 @@
 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';
+import { loadWorkflow, 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('<workflow>', 'Path to .workflow.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) => {
+        .action(async (workflowPath, executionPath, options) => {
         try {
-            const narrative = await loadNarrative(resolvePath(narrativePath));
+            const workflow = await loadWorkflow(resolvePath(workflowPath));
             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 scenarioResults = workflow.scenarios.map((scenario) => {
                 const condition = scenario.condition;
                 const matched = matchesCondition(condition, events, aggregates);
                 let reason;
@@ -60,11 +60,11 @@ export function createTestCommand() {
                 };
             });
             // Select the winning scenario
-            const matchResult = selectScenario(narrative, events, aggregates);
+            const matchResult = selectScenario(workflow, events, aggregates);
             const selectedScenario = matchResult.scenario;
             if (options.json) {
                 const output = {
-                    narrative: narrativePath,
+                    workflow: workflowPath,
                     execution: executionPath,
                     scenarios: scenarioResults.map((r) => ({
                         id: r.scenario.id,
@@ -81,7 +81,7 @@ export function createTestCommand() {
             }
             else {
                 // Text output
-                console.log(chalk.bold(`\nTesting: ${narrativePath}`));
+                console.log(chalk.bold(`\nTesting: ${workflowPath}`));
                 console.log(chalk.gray(`Execution: ${executionPath}\n`));
                 console.log(chalk.bold('Scenario Matching Results:'));
                 console.log('━'.repeat(60));

package/dist/commands/{narrative → workflow}/utils.d.ts

@@ -1,9 +1,9 @@
-import type { NarrativeTemplate, OtelEvent } from '@principal-ai/principal-view-core';
+import type { WorkflowTemplate, OtelEvent } from '@principal-ai/principal-view-core';
 import { type ExecutionData } from '@principal-ai/principal-view-core';
 /**
- * Load a narrative template from a file
+ * Load a workflow template from a file
  */
-export declare function loadNarrative(filePath: string): Promise<NarrativeTemplate>;
+export declare function loadWorkflow(filePath: string): Promise<WorkflowTemplate>;
 /**
  * Load execution data from a .otel.json file
  *
@@ -11,7 +11,7 @@ export declare function loadNarrative(filePath: string): Promise<NarrativeTempla
  */
 export declare function loadExecution(filePath: string): Promise<ExecutionData>;
 /**
- * Convert execution data to OtelEvent array format expected by narrative APIs
+ * Convert execution data to OtelEvent array format expected by workflow APIs
  */
 export declare function executionToEvents(execution: ExecutionData): OtelEvent[];
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAE3F;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU9E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAc5E;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"}