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

package/dist/index.cjs

@@ -210597,7 +210597,7 @@ var ConfigurationLoader = class _ConfigurationLoader {
 };
 ConfigurationLoader.CONFIG_DIR = ".principal-views";
 
-// ../core/dist/narrative/template-parser.js
+// ../core/dist/workflow/template-parser.js
 var import_handlebars = __toESM(require_lib());
 import_handlebars.default.registerHelper("eq", (a, b) => a === b);
 import_handlebars.default.registerHelper("ne", (a, b) => a !== b);
@@ -210623,7 +210623,7 @@ function parseTemplate(template, context) {
   }
 }
 
-// ../core/dist/narrative/scenario-matcher.js
+// ../core/dist/workflow/scenario-matcher.js
 function selectScenario(template, events, attributes = {}) {
   const sorted = [...template.scenarios].sort((a, b) => a.priority - b.priority);
   const applicableScenarios = [];
@@ -210780,8 +210780,8 @@ function computeAggregates(events) {
   return aggregates;
 }
 
-// ../core/dist/narrative/template-renderer.js
-function renderNarrative(template, events) {
+// ../core/dist/workflow/template-renderer.js
+function renderWorkflow(template, events) {
   const aggregates = computeAggregates(events);
   const matchResult = selectScenario(template, events, aggregates);
   const context = {
@@ -214496,7 +214496,7 @@ var CanvasDiscovery = class _CanvasDiscovery {
    *
    * @param fileTree - FileTree from repository-abstraction
    * @param options - Discovery options (fileReader, includeContent)
-   * @returns Discovery result with canvases, executions, and errors
+   * @returns Discovery result with canvases, executions, storyboards, and errors
    */
   async discover(fileTree, options = {}) {
     const errors = [];
@@ -214504,9 +214504,11 @@ var CanvasDiscovery = class _CanvasDiscovery {
     const packageMap = this.buildPackageMap(packages);
     const canvases = await this.discoverCanvasFiles(fileTree, packageMap, options, errors);
     const executions = await this.discoverExecutionFiles(fileTree, packageMap, options, errors);
+    const storyboards = await this.discoverStoryboards(fileTree, packageMap, canvases, executions, options, errors);
     canvases.sort(this.compareByPackageThenName);
     executions.sort(this.compareByPackageThenName);
-    return { canvases, executions, errors };
+    storyboards.sort(this.compareByPackageThenName);
+    return { canvases, executions, storyboards, errors };
   }
   /**
    * Find canvas file for a given execution
@@ -214534,6 +214536,106 @@ var CanvasDiscovery = class _CanvasDiscovery {
   clearCache() {
     this.packageCache.clear();
   }
+  /**
+   * Discover storyboards (hierarchical organization of canvas + workflows + executions)
+   */
+  async discoverStoryboards(fileTree, packageMap, canvases, executions, options, errors) {
+    const storyboards = [];
+    const storyboardDirs = /* @__PURE__ */ new Map();
+    for (const file of fileTree.allFiles) {
+      const path4 = file.relativePath || file.path || "";
+      const parts = path4.split("/");
+      const pvIndex = parts.indexOf(_CanvasDiscovery.CANVAS_DIR);
+      if (pvIndex === -1 || parts.length < pvIndex + 3)
+        continue;
+      const storyboardName = parts[pvIndex + 1];
+      const storyboardPath = parts.slice(0, pvIndex + 2).join("/");
+      if (!storyboardDirs.has(storyboardPath)) {
+        storyboardDirs.set(storyboardPath, /* @__PURE__ */ new Set());
+      }
+      storyboardDirs.get(storyboardPath).add(storyboardName);
+    }
+    for (const [storyboardParentPath, storyboardNames] of storyboardDirs) {
+      for (const storyboardName of storyboardNames) {
+        const storyboardPath = `${storyboardParentPath}/${storyboardName}`;
+        if (storyboardName === _CanvasDiscovery.EXECUTIONS_DIR)
+          continue;
+        const storyboardCanvas = canvases.find((c) => {
+          const canvasDir = c.path.split("/").slice(0, -1).join("/");
+          return canvasDir === storyboardPath && c.basename === storyboardName;
+        });
+        if (!storyboardCanvas)
+          continue;
+        const workflows = await this.discoverWorkflowsInStoryboard(fileTree, storyboardPath, storyboardName, packageMap, executions, options, errors);
+        if (workflows.length === 0)
+          continue;
+        const packageInfo = this.findPackageForPath(storyboardPath, packageMap);
+        const id = packageInfo ? `${packageInfo.packageData.name}/${storyboardName}` : storyboardName;
+        const storyboard = {
+          id,
+          name: this.toDisplayName(storyboardName),
+          path: storyboardPath,
+          basename: storyboardName,
+          canvas: storyboardCanvas,
+          workflows,
+          packageName: packageInfo?.packageData.name,
+          packagePath: packageInfo?.packageData.path,
+          scope: packageInfo ? "package" : "root"
+        };
+        storyboards.push(storyboard);
+      }
+    }
+    return storyboards;
+  }
+  /**
+   * Discover workflows within a storyboard folder
+   */
+  async discoverWorkflowsInStoryboard(fileTree, storyboardPath, storyboardName, packageMap, executions, options, errors) {
+    const workflows = [];
+    for (const file of fileTree.allFiles) {
+      const path4 = file.relativePath || file.path || "";
+      if (!path4.startsWith(storyboardPath + "/"))
+        continue;
+      if (!path4.endsWith(_CanvasDiscovery.WORKFLOW_EXTENSION))
+        continue;
+      const filename = path4.split("/").pop();
+      if (!filename)
+        continue;
+      const basename3 = filename.replace(_CanvasDiscovery.WORKFLOW_EXTENSION, "");
+      const workflowDir = path4.split("/").slice(0, -1).join("/");
+      const packageInfo = this.findPackageForPath(path4, packageMap);
+      const id = packageInfo ? `${packageInfo.packageData.name}/${storyboardName}/${basename3}` : `${storyboardName}/${basename3}`;
+      const workflowExecutions = executions.filter((e) => {
+        const execDir = e.path.split("/").slice(0, -1).join("/");
+        return execDir === workflowDir;
+      });
+      let workflow = {
+        id,
+        name: this.toDisplayName(basename3),
+        path: path4,
+        basename: basename3,
+        storyboardId: packageInfo ? `${packageInfo.packageData.name}/${storyboardName}` : storyboardName,
+        packageName: packageInfo?.packageData.name,
+        packagePath: packageInfo?.packageData.path,
+        scope: packageInfo ? "package" : "root",
+        executions: workflowExecutions
+      };
+      if (options.includeContent && options.fileReader) {
+        try {
+          const content = await options.fileReader(path4);
+          const parsedContent = JSON.parse(content);
+          workflow = { ...workflow, content: parsedContent };
+        } catch (error) {
+          errors.push({
+            path: path4,
+            error: `Failed to parse workflow content: ${error.message}`
+          });
+        }
+      }
+      workflows.push(workflow);
+    }
+    return workflows;
+  }
   /**
    * Discover packages with caching by fileTree SHA
    */
@@ -214745,6 +214847,7 @@ var CanvasDiscovery = class _CanvasDiscovery {
 };
 CanvasDiscovery.CANVAS_DIR = ".principal-views";
 CanvasDiscovery.EXECUTIONS_DIR = "__executions__";
+CanvasDiscovery.WORKFLOW_EXTENSION = ".workflow.json";
 
 // ../core/dist/execution/ExecutionValidator.js
 function convertOtlpValue(value) {
@@ -216247,9 +216350,9 @@ ${source_default.bold("1. Canvas Files")} ${source_default.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.
 
-${source_default.bold("2. Narrative Files")} ${source_default.yellow(".narrative.json")}
+${source_default.bold("2. Workflow Files")} ${source_default.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.
 
 ${source_default.bold("3. Execution Files")} ${source_default.yellow(".otel.json")}
    Captured OTEL spans from test runs or production code, exported for
@@ -216257,7 +216360,7 @@ ${source_default.bold("3. Execution Files")} ${source_default.yellow(".otel.json
 
 Run ${source_default.cyan("npx @principal-ai/principal-view-cli formats <section>")} for details on:
   ${source_default.yellow("canvas")}       .otel.canvas format and event schemas
-  ${source_default.yellow("narrative")}    .narrative.json format and scenario structure
+  ${source_default.yellow("workflow")}    .workflow.json format and scenario structure
   ${source_default.yellow("execution")}    .otel.json format for captured spans
   ${source_default.yellow("examples")}     Complete example files
 `,
@@ -216341,28 +216444,28 @@ ${source_default.cyan("5. Required vs Optional attributes:")}
 ${source_default.bold("Validation:")}
   ${source_default.cyan("npx @principal-ai/principal-view-cli validate")}
 `,
-  narrative: `
-${source_default.bold.cyan("Narrative Format (.narrative.json)")}
+  workflow: `
+${source_default.bold.cyan("Workflow Format (.workflow.json)")}
 ${source_default.dim("\u2550".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.
 
 ${source_default.bold("File Location:")}
-  ${source_default.dim(".principal-views/")}${source_default.yellow("<feature-name>.narrative.json")}
+  ${source_default.dim(".principal-views/")}${source_default.yellow("<feature-name>.workflow.json")}
   ${source_default.dim("(co-located with corresponding .otel.canvas file)")}
 
 ${source_default.bold("Required Structure:")}
 ${source_default.dim("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510")}
 ${source_default.dim("\u2502")} {                                                                  ${source_default.dim("\u2502")}
-${source_default.dim("\u2502")}   ${source_default.green('"name"')}: "Feature Name",      ${source_default.dim('// NOT "Feature Name Narratives"')} ${source_default.dim("\u2502")}
-${source_default.dim("\u2502")}   ${source_default.green('"description"')}: "What the feature does",  ${source_default.dim('// Purpose, not "Narratives for..."')} ${source_default.dim("\u2502")}
+${source_default.dim("\u2502")}   ${source_default.green('"name"')}: "Feature Name",      ${source_default.dim('// NOT "Feature Name Workflows"')} ${source_default.dim("\u2502")}
+${source_default.dim("\u2502")}   ${source_default.green('"description"')}: "What the feature does",  ${source_default.dim('// Purpose, not "Workflows for..."')} ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}   ${source_default.green('"scenarios"')}: [                                                 ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}     {                                                              ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}       ${source_default.yellow('"priority"')}: 1,           ${source_default.dim("// Lower = higher priority")}   ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}       ${source_default.yellow('"condition"')}: "...",      ${source_default.dim("// JSONPath/logic expression")} ${source_default.dim("\u2502")}
-${source_default.dim("\u2502")}       ${source_default.yellow('"template"')}: {            ${source_default.dim("// Narrative template")}        ${source_default.dim("\u2502")}
+${source_default.dim("\u2502")}       ${source_default.yellow('"template"')}: {            ${source_default.dim("// Workflow template")}        ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}         ${source_default.cyan('"summary"')}: "Completed {{count}} items",  ${source_default.dim("// Handlebars template")} ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}         ${source_default.cyan('"events"')}: {                ${source_default.dim("// Per-event templates")}       ${source_default.dim("\u2502")}
 ${source_default.dim("\u2502")}           "event.name": "Event {{attribute}} occurred"           ${source_default.dim("\u2502")}
@@ -216375,14 +216478,14 @@ ${source_default.dim("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25
 
 ${source_default.bold("Naming Guidelines:")}
 
-  \u274C DON'T append "Narratives" to the name:
-     "name": "Package Processor Narratives"
+  \u274C DON'T append "Workflows" to the name:
+     "name": "Package Processor Workflows"
 
   \u2705 DO use the feature name directly:
      "name": "Package Processor"
 
   \u274C DON'T prefix description with boilerplate:
-     "description": "Human-readable narratives for package extraction..."
+     "description": "Human-readable workflows for package extraction..."
 
   \u2705 DO describe the feature's purpose:
      "description": "Package extraction and analysis from repository file trees"
@@ -216433,7 +216536,7 @@ ${source_default.cyan("5. Template style:")}
    - Include key metrics and IDs
 
 ${source_default.bold("Validation:")}
-  ${source_default.cyan("npx @principal-ai/principal-view-cli narrative validate")}
+  ${source_default.cyan("npx @principal-ai/principal-view-cli workflow validate")}
 `,
   execution: `
 ${source_default.bold.cyan("Execution Format (.otel.json)")}
@@ -216632,9 +216735,9 @@ ${source_default.yellow(".principal-views/data-validator.otel.canvas")}
   }
 }
 
-${source_default.bold("Example 2: Narrative Scenarios")}
+${source_default.bold("Example 2: Workflow Scenarios")}
 ${source_default.dim("\u2500".repeat(70))}
-${source_default.yellow(".principal-views/data-validator.narrative.json")}
+${source_default.yellow(".principal-views/data-validator.workflow.json")}
 
 {
   "name": "Data Validator",
@@ -216734,7 +216837,7 @@ ${source_default.yellow("__executions__/data-validator.otel.json")}
 
 ${source_default.bold("Next Steps:")}
   ${source_default.cyan("npx @principal-ai/principal-view-cli validate")}          Validate canvas
-  ${source_default.cyan("npx @principal-ai/principal-view-cli narrative validate")} Validate narratives
+  ${source_default.cyan("npx @principal-ai/principal-view-cli workflow validate")} Validate workflows
   ${source_default.cyan("npx @principal-ai/principal-view-cli validate-execution")}  Validate execution
 `
 };
@@ -216742,7 +216845,7 @@ function createFormatsCommand() {
   const command = new Command("formats");
   command.description("Display documentation about file formats").argument(
     "[section]",
-    "Section to display: overview, canvas, narrative, execution, examples"
+    "Section to display: overview, canvas, workflow, execution, examples"
   ).action((section) => {
     const validSections = Object.keys(FORMAT_SECTIONS);
     if (!section) {
@@ -220293,12 +220396,12 @@ function createDefaultRulesEngine() {
   return createRulesEngine(builtinRules);
 }
 
-// ../core/dist/narrative/validator.js
+// ../core/dist/workflow/validator.js
 var import_fs = require("fs");
 var import_path2 = require("path");
-var NarrativeValidator = class {
+var WorkflowValidator = class {
   /**
-   * Validate a narrative template
+   * Validate a workflow template
    */
   async validate(context) {
     const violations = [];
@@ -220319,122 +220422,122 @@ var NarrativeValidator = class {
    */
   checkSchema(context) {
     const violations = [];
-    const { narrative, narrativePath } = context;
-    if (!narrative.version) {
+    const { workflow, workflowPath } = context;
+    if (!workflow.version) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "version",
         message: 'Missing required field "version"',
         impact: "Cannot determine template version for compatibility",
         suggestion: 'Add a version field (e.g., "1.0.0")',
         fixable: false
       });
-    } else if (!this.isValidSemver(narrative.version)) {
+    } else if (!this.isValidSemver(workflow.version)) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "version",
-        message: `Invalid version format: "${narrative.version}"`,
+        message: `Invalid version format: "${workflow.version}"`,
         impact: "Version must follow semver format",
         suggestion: 'Use semver format like "1.0.0"',
         fixable: false
       });
     }
-    if (!narrative.canvas) {
+    if (!workflow.canvas) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "canvas",
         message: 'Missing required field "canvas"',
-        impact: "Cannot determine which canvas this narrative belongs to",
+        impact: "Cannot determine which canvas this workflow belongs to",
         suggestion: "Add a canvas field pointing to an .otel.canvas file",
         fixable: false
       });
     }
-    if (!narrative.name) {
+    if (!workflow.name) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "name",
         message: 'Missing required field "name"',
-        impact: "Cannot identify this narrative template",
+        impact: "Cannot identify this workflow template",
         suggestion: "Add a human-readable name",
         fixable: false
       });
     }
-    if (!narrative.description) {
+    if (!workflow.description) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "description",
         message: 'Missing required field "description"',
-        impact: "Cannot understand the purpose of this narrative",
-        suggestion: "Add a description explaining what this narrative shows",
+        impact: "Cannot understand the purpose of this workflow",
+        suggestion: "Add a description explaining what this workflow shows",
         fixable: false
       });
     }
     const validModes = ["span-tree", "timeline"];
-    if (!narrative.mode) {
+    if (!workflow.mode) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "mode",
         message: 'Missing required field "mode"',
-        impact: "Cannot determine how to structure the narrative",
+        impact: "Cannot determine how to structure the workflow",
         suggestion: `Set mode to one of: ${validModes.join(", ")}`,
         fixable: false
       });
-    } else if (!validModes.includes(narrative.mode)) {
+    } else if (!validModes.includes(workflow.mode)) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "mode",
-        message: `Invalid mode: "${narrative.mode}"`,
+        message: `Invalid mode: "${workflow.mode}"`,
         impact: "Mode must be one of the supported types",
         suggestion: `Use one of: ${validModes.join(", ")}`,
         fixable: false
       });
     }
     const validSelections = ["first-match", "manual"];
-    if (narrative.scenarioSelection && !validSelections.includes(narrative.scenarioSelection)) {
+    if (workflow.scenarioSelection && !validSelections.includes(workflow.scenarioSelection)) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "scenarioSelection",
-        message: `Invalid scenarioSelection: "${narrative.scenarioSelection}"`,
+        message: `Invalid scenarioSelection: "${workflow.scenarioSelection}"`,
         impact: "Scenario selection must be a valid type",
         suggestion: `Use one of: ${validSelections.join(", ")}`,
         fixable: false
       });
     }
-    if (!narrative.scenarios || !Array.isArray(narrative.scenarios)) {
+    if (!workflow.scenarios || !Array.isArray(workflow.scenarios)) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "scenarios",
         message: 'Missing or invalid "scenarios" field',
-        impact: "Cannot generate narratives without scenarios",
+        impact: "Cannot generate workflows without scenarios",
         suggestion: "Add a scenarios array with at least one scenario",
         fixable: false
       });
-    } else if (narrative.scenarios.length === 0) {
+    } else if (workflow.scenarios.length === 0) {
       violations.push({
-        ruleId: "narrative-schema-valid",
+        ruleId: "workflow-schema-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "scenarios",
         message: "Scenarios array is empty",
-        impact: "Cannot generate narratives without scenarios",
+        impact: "Cannot generate workflows without scenarios",
         suggestion: "Add at least one scenario definition",
         fixable: false
       });
@@ -220446,18 +220549,18 @@ var NarrativeValidator = class {
    */
   checkCanvasExists(context) {
     const violations = [];
-    const { narrative, narrativePath, basePath, canvasPath } = context;
-    if (!narrative.canvas) {
+    const { workflow, workflowPath, basePath, canvasPath } = context;
+    if (!workflow.canvas) {
       return violations;
     }
-    const resolvedPath = canvasPath || (0, import_path2.resolve)(basePath, narrative.canvas);
+    const resolvedPath = canvasPath || (0, import_path2.resolve)(basePath, workflow.canvas);
     if (!(0, import_fs.existsSync)(resolvedPath)) {
       violations.push({
-        ruleId: "narrative-canvas-exists",
+        ruleId: "workflow-canvas-exists",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "canvas",
-        message: `Referenced canvas file does not exist: ${narrative.canvas}`,
+        message: `Referenced canvas file does not exist: ${workflow.canvas}`,
         impact: "Cannot validate event references without the canvas",
         suggestion: "Ensure the canvas field points to a valid .otel.canvas file",
         fixable: false
@@ -220474,7 +220577,7 @@ var NarrativeValidator = class {
    */
   checkEventReferences(context) {
     const violations = [];
-    const { narrative, narrativePath, canvas } = context;
+    const { workflow, workflowPath, canvas } = context;
     if (!canvas || !canvas.nodes) {
       return violations;
     }
@@ -220485,10 +220588,10 @@ var NarrativeValidator = class {
           violations.push({
             ruleId: "canvas-event-format-deprecated",
             severity: "error",
-            file: narrative.canvas || "canvas",
+            file: workflow.canvas || "canvas",
             path: `nodes[${node.id}].pv.event`,
             message: `Canvas node "${node.id}" uses deprecated string format for event: "${node.pv.event}"`,
-            impact: "Event will not be recognized by narrative validator and narratives will fail to match",
+            impact: "Event will not be recognized by workflow validator and workflows will fail to match",
             suggestion: `Use "eventRef": "${node.pv.event}" to reference a library event, or use "event": { "name": "${node.pv.event}", "attributes": {} } for inline definition. If using eventRef, define the event schema in library.yaml under eventSchemas.`,
             fixable: false
           });
@@ -220500,47 +220603,47 @@ var NarrativeValidator = class {
         canvasEvents.add(node.pv.eventRef);
       }
     }
-    const narrativeEvents = /* @__PURE__ */ new Set();
-    for (const scenario of narrative.scenarios) {
+    const workflowEvents = /* @__PURE__ */ new Set();
+    for (const scenario of 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);
           }
         }
       }
     }
-    for (const eventName of Array.from(narrativeEvents)) {
+    for (const eventName of Array.from(workflowEvents)) {
       if (!canvasEvents.has(eventName)) {
         violations.push({
-          ruleId: "narrative-event-sync",
+          ruleId: "workflow-event-sync",
           severity: "error",
-          file: narrativePath,
+          file: workflowPath,
           path: "events",
-          message: `Narrative references event "${eventName}" which is not defined in canvas`,
+          message: `Workflow references event "${eventName}" which is not defined in canvas`,
           impact: "This event will never highlight a canvas node and may never match",
-          suggestion: `Add event "${eventName}" to a node in ${narrative.canvas} or remove it from the narrative`,
+          suggestion: `Add event "${eventName}" to a node in ${workflow.canvas} or remove it from the workflow`,
           fixable: false
         });
       }
     }
-    const eventsToCheckAgainst = context.allNarrativeEvents ?? narrativeEvents;
+    const eventsToCheckAgainst = context.allWorkflowEvents ?? workflowEvents;
     for (const eventName of Array.from(canvasEvents)) {
       if (!eventsToCheckAgainst.has(eventName)) {
         violations.push({
-          ruleId: "narrative-event-coverage",
+          ruleId: "workflow-event-coverage",
           severity: "warn",
-          file: narrativePath,
+          file: workflowPath,
           path: "events",
-          message: context.allNarrativeEvents ? `Canvas defines event "${eventName}" which is not used in any narrative for this canvas` : `Canvas defines event "${eventName}" which is not used in this narrative scenario`,
-          impact: "This canvas node may never be highlighted during narrative playback",
+          message: context.allWorkflowEvents ? `Canvas defines event "${eventName}" which is not used in any workflow for this canvas` : `Canvas defines event "${eventName}" which is not used in this workflow scenario`,
+          impact: "This canvas node may never be highlighted during workflow playback",
           suggestion: `Add event "${eventName}" to a scenario's template.events or condition.requires`,
           fixable: false
         });
@@ -220553,19 +220656,19 @@ var NarrativeValidator = class {
    */
   checkScenarios(context) {
     const violations = [];
-    const { narrative, narrativePath } = context;
-    if (!narrative.scenarios || narrative.scenarios.length === 0) {
+    const { workflow, workflowPath } = context;
+    if (!workflow.scenarios || workflow.scenarios.length === 0) {
       return violations;
     }
     const scenarioIds = /* @__PURE__ */ new Set();
     const priorities = /* @__PURE__ */ new Set();
     let hasDefault = false;
-    narrative.scenarios.forEach((scenario, idx) => {
+    workflow.scenarios.forEach((scenario, idx) => {
       if (!scenario.id) {
         violations.push({
-          ruleId: "narrative-scenario-valid",
+          ruleId: "workflow-scenario-valid",
           severity: "error",
-          file: narrativePath,
+          file: workflowPath,
           path: `scenarios[${idx}].id`,
           message: 'Scenario is missing required "id" field',
           impact: "Cannot identify this scenario",
@@ -220575,9 +220678,9 @@ var NarrativeValidator = class {
       } else {
         if (scenarioIds.has(scenario.id)) {
           violations.push({
-            ruleId: "narrative-scenario-valid",
+            ruleId: "workflow-scenario-valid",
             severity: "error",
-            file: narrativePath,
+            file: workflowPath,
             path: `scenarios[${idx}].id`,
             message: `Duplicate scenario ID: "${scenario.id}"`,
             impact: "Scenario IDs must be unique",
@@ -220589,9 +220692,9 @@ var NarrativeValidator = class {
       }
       if (scenario.priority === void 0 || scenario.priority === null) {
         violations.push({
-          ruleId: "narrative-scenario-valid",
+          ruleId: "workflow-scenario-valid",
           severity: "error",
-          file: narrativePath,
+          file: workflowPath,
           path: `scenarios[${idx}].priority`,
           message: 'Scenario is missing required "priority" field',
           impact: "Cannot determine scenario selection order",
@@ -220601,9 +220704,9 @@ var NarrativeValidator = class {
       } else {
         if (scenario.priority < 0) {
           violations.push({
-            ruleId: "narrative-scenario-valid",
+            ruleId: "workflow-scenario-valid",
             severity: "error",
-            file: narrativePath,
+            file: workflowPath,
             path: `scenarios[${idx}].priority`,
             message: "Priority must be a non-negative number",
             impact: "Invalid priority value",
@@ -220613,9 +220716,9 @@ var NarrativeValidator = class {
         }
         if (priorities.has(scenario.priority)) {
           violations.push({
-            ruleId: "narrative-scenario-valid",
+            ruleId: "workflow-scenario-valid",
             severity: "error",
-            file: narrativePath,
+            file: workflowPath,
             path: `scenarios[${idx}].priority`,
             message: `Duplicate priority: ${scenario.priority}`,
             impact: "Priorities must be unique to determine selection order",
@@ -220630,9 +220733,9 @@ var NarrativeValidator = class {
       }
       if (!scenario.condition) {
         violations.push({
-          ruleId: "narrative-scenario-valid",
+          ruleId: "workflow-scenario-valid",
           severity: "error",
-          file: narrativePath,
+          file: workflowPath,
           path: `scenarios[${idx}].condition`,
           message: 'Scenario is missing required "condition" field',
           impact: "Cannot determine when to use this scenario",
@@ -220640,31 +220743,31 @@ var NarrativeValidator = class {
           fixable: false
         });
       } else {
-        violations.push(...this.checkConditionStructure(scenario.condition, narrativePath, idx));
+        violations.push(...this.checkConditionStructure(scenario.condition, workflowPath, idx));
       }
       if (!scenario.template) {
         violations.push({
-          ruleId: "narrative-scenario-valid",
+          ruleId: "workflow-scenario-valid",
           severity: "error",
-          file: narrativePath,
+          file: workflowPath,
           path: `scenarios[${idx}].template`,
           message: 'Scenario is missing required "template" field',
-          impact: "Cannot render narrative without a template",
+          impact: "Cannot render workflow without a template",
           suggestion: "Add a template with introduction, events, or flow",
           fixable: false
         });
       } else {
-        violations.push(...this.checkTemplateStructure(scenario.template, narrativePath, idx));
+        violations.push(...this.checkTemplateStructure(scenario.template, workflowPath, idx));
       }
     });
     if (!hasDefault) {
       violations.push({
-        ruleId: "narrative-scenario-valid",
+        ruleId: "workflow-scenario-valid",
         severity: "error",
-        file: narrativePath,
+        file: workflowPath,
         path: "scenarios",
         message: "No default scenario defined",
-        impact: "Narrative rendering may fail if no scenario matches",
+        impact: "Workflow rendering may fail if no scenario matches",
         suggestion: 'Add a scenario with "condition.default: true" as a fallback',
         fixable: false
       });
@@ -220685,7 +220788,7 @@ var NarrativeValidator = class {
       if (!validFields.includes(key)) {
         if (key === "event") {
           violations.push({
-            ruleId: "narrative-condition-structure",
+            ruleId: "workflow-condition-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].condition.${key}`,
@@ -220696,7 +220799,7 @@ var NarrativeValidator = class {
           });
         } else if (key === "attributes") {
           violations.push({
-            ruleId: "narrative-condition-structure",
+            ruleId: "workflow-condition-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].condition.${key}`,
@@ -220707,7 +220810,7 @@ var NarrativeValidator = class {
           });
         } else {
           violations.push({
-            ruleId: "narrative-condition-structure",
+            ruleId: "workflow-condition-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].condition.${key}`,
@@ -220730,7 +220833,7 @@ var NarrativeValidator = class {
     const templateKeys = Object.keys(template);
     if (!template.events) {
       violations.push({
-        ruleId: "narrative-template-structure",
+        ruleId: "workflow-template-structure",
         severity: "error",
         file,
         path: `scenarios[${scenarioIdx}].template`,
@@ -220741,7 +220844,7 @@ var NarrativeValidator = class {
       });
     } else if (typeof template.events !== "object" || Array.isArray(template.events)) {
       violations.push({
-        ruleId: "narrative-template-structure",
+        ruleId: "workflow-template-structure",
         severity: "error",
         file,
         path: `scenarios[${scenarioIdx}].template.events`,
@@ -220752,7 +220855,7 @@ var NarrativeValidator = class {
       });
     } else if (Object.keys(template.events).length === 0) {
       violations.push({
-        ruleId: "narrative-template-structure",
+        ruleId: "workflow-template-structure",
         severity: "error",
         file,
         path: `scenarios[${scenarioIdx}].template.events`,
@@ -220766,7 +220869,7 @@ var NarrativeValidator = class {
       if (!validFields.includes(key)) {
         if (key === "steps") {
           violations.push({
-            ruleId: "narrative-template-structure",
+            ruleId: "workflow-template-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].template.${key}`,
@@ -220777,7 +220880,7 @@ var NarrativeValidator = class {
           });
         } else if (key === "details") {
           violations.push({
-            ruleId: "narrative-template-structure",
+            ruleId: "workflow-template-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].template.${key}`,
@@ -220788,7 +220891,7 @@ var NarrativeValidator = class {
           });
         } else {
           violations.push({
-            ruleId: "narrative-template-structure",
+            ruleId: "workflow-template-structure",
             severity: "error",
             file,
             path: `scenarios[${scenarioIdx}].template.${key}`,
@@ -220807,15 +220910,15 @@ var NarrativeValidator = class {
    */
   checkEventNameSyntax(context) {
     const violations = [];
-    const { narrative, narrativePath } = context;
-    narrative.scenarios.forEach((scenario, scenarioIdx) => {
+    const { workflow, workflowPath } = context;
+    workflow.scenarios.forEach((scenario, scenarioIdx) => {
       if (scenario.condition?.requires) {
         scenario.condition.requires.forEach((eventPattern, idx) => {
           if (eventPattern.includes("[") && eventPattern.includes("]")) {
             violations.push({
-              ruleId: "narrative-event-name-syntax",
+              ruleId: "workflow-event-name-syntax",
               severity: "error",
-              file: narrativePath,
+              file: workflowPath,
               path: `scenarios[${scenarioIdx}].condition.requires[${idx}]`,
               message: `Event name uses unsupported [attribute=value] syntax: "${eventPattern}"`,
               impact: "Attribute filter syntax is not supported - event will not match",
@@ -220829,9 +220932,9 @@ var NarrativeValidator = class {
         scenario.condition.excludes.forEach((eventPattern, idx) => {
           if (eventPattern.includes("[") && eventPattern.includes("]")) {
             violations.push({
-              ruleId: "narrative-event-name-syntax",
+              ruleId: "workflow-event-name-syntax",
               severity: "error",
-              file: narrativePath,
+              file: workflowPath,
               path: `scenarios[${scenarioIdx}].condition.excludes[${idx}]`,
               message: `Event name uses unsupported [attribute=value] syntax: "${eventPattern}"`,
               impact: "Attribute filter syntax is not supported - event will not match",
@@ -220845,9 +220948,9 @@ var NarrativeValidator = class {
         Object.keys(scenario.template.events).forEach((eventName) => {
           if (eventName.includes("[") && eventName.includes("]")) {
             violations.push({
-              ruleId: "narrative-event-name-syntax",
+              ruleId: "workflow-event-name-syntax",
               severity: "error",
-              file: narrativePath,
+              file: workflowPath,
               path: `scenarios[${scenarioIdx}].template.events["${eventName}"]`,
               message: `Event name uses unsupported [attribute=value] syntax: "${eventName}"`,
               impact: "Attribute filter syntax is not supported - template will never render",
@@ -220865,36 +220968,36 @@ var NarrativeValidator = class {
    */
   checkTemplateSyntax(context) {
     const violations = [];
-    const { narrative, narrativePath } = context;
-    narrative.scenarios.forEach((scenario, scenarioIdx) => {
+    const { workflow, workflowPath } = context;
+    workflow.scenarios.forEach((scenario, scenarioIdx) => {
       if (!scenario.template) {
         return;
       }
       const template = scenario.template;
       if (template.introduction) {
-        violations.push(...this.validateTemplateString(template.introduction, narrativePath, `scenarios[${scenarioIdx}].template.introduction`));
+        violations.push(...this.validateTemplateString(template.introduction, workflowPath, `scenarios[${scenarioIdx}].template.introduction`));
       }
       if (template.summary) {
-        violations.push(...this.validateTemplateString(template.summary, narrativePath, `scenarios[${scenarioIdx}].template.summary`));
+        violations.push(...this.validateTemplateString(template.summary, workflowPath, `scenarios[${scenarioIdx}].template.summary`));
       }
       if (template.events) {
         Object.entries(template.events).forEach(([eventName, templateStr]) => {
-          violations.push(...this.validateTemplateString(templateStr, narrativePath, `scenarios[${scenarioIdx}].template.events.${eventName}`));
+          violations.push(...this.validateTemplateString(templateStr, workflowPath, `scenarios[${scenarioIdx}].template.events.${eventName}`));
         });
       }
       if (template.logs) {
         Object.entries(template.logs).forEach(([severity, templateStr]) => {
           if (typeof templateStr === "string") {
-            violations.push(...this.validateTemplateString(templateStr, narrativePath, `scenarios[${scenarioIdx}].template.logs.${severity}`));
+            violations.push(...this.validateTemplateString(templateStr, workflowPath, `scenarios[${scenarioIdx}].template.logs.${severity}`));
           }
         });
       }
       if (template.flow && Array.isArray(template.flow)) {
         template.flow.forEach((item, flowIdx) => {
           if (typeof item === "string") {
-            violations.push(...this.validateTemplateString(item, narrativePath, `scenarios[${scenarioIdx}].template.flow[${flowIdx}]`));
+            violations.push(...this.validateTemplateString(item, workflowPath, `scenarios[${scenarioIdx}].template.flow[${flowIdx}]`));
           } else if (typeof item === "object" && item.template) {
-            violations.push(...this.validateTemplateString(item.template, narrativePath, `scenarios[${scenarioIdx}].template.flow[${flowIdx}].template`));
+            violations.push(...this.validateTemplateString(item.template, workflowPath, `scenarios[${scenarioIdx}].template.flow[${flowIdx}].template`));
           }
         });
       }
@@ -220928,7 +221031,7 @@ var NarrativeValidator = class {
           braceDepth--;
           if (braceDepth < 0) {
             violations.push({
-              ruleId: "narrative-template-syntax",
+              ruleId: "workflow-template-syntax",
               severity: "error",
               file,
               path: path4,
@@ -220944,7 +221047,7 @@ var NarrativeValidator = class {
     }
     if (braceDepth > 0) {
       violations.push({
-        ruleId: "narrative-template-syntax",
+        ruleId: "workflow-template-syntax",
         severity: "error",
         file,
         path: path4,
@@ -220961,7 +221064,7 @@ var NarrativeValidator = class {
       const colonCount = (expr.match(/:/g) || []).length;
       if (questionCount > colonCount) {
         violations.push({
-          ruleId: "narrative-template-syntax",
+          ruleId: "workflow-template-syntax",
           severity: "error",
           file,
           path: path4,
@@ -220984,12 +221087,12 @@ var NarrativeValidator = class {
    */
   checkAttributeReferences(context) {
     const violations = [];
-    const { narrative, narrativePath, executionData } = context;
+    const { workflow, workflowPath, executionData } = context;
     if (!executionData) {
       return violations;
     }
     const { aggregates, eventAttributes } = executionData;
-    for (const scenario of narrative.scenarios) {
+    for (const scenario of workflow.scenarios) {
       const scenarioPath = `scenarios[${scenario.id}]`;
       if (scenario.template.introduction) {
         const attrs = this.extractAttributeReferences(scenario.template.introduction);
@@ -220998,7 +221101,7 @@ var NarrativeValidator = class {
           aggregates,
           null,
           // introduction doesn't have specific event context
-          narrativePath,
+          workflowPath,
           `${scenarioPath}.template.introduction`
         ));
       }
@@ -221006,7 +221109,7 @@ var NarrativeValidator = class {
         for (const [eventName, eventTemplate] of Object.entries(scenario.template.events)) {
           const attrs = this.extractAttributeReferences(eventTemplate);
           const eventAttrs = eventAttributes.get(eventName);
-          violations.push(...this.validateAttributes(attrs, aggregates, eventAttrs || null, narrativePath, `${scenarioPath}.template.events.${eventName}`, eventName));
+          violations.push(...this.validateAttributes(attrs, aggregates, eventAttrs || null, workflowPath, `${scenarioPath}.template.events.${eventName}`, eventName));
         }
       }
       if (scenario.template.summary) {
@@ -221016,7 +221119,7 @@ var NarrativeValidator = class {
           aggregates,
           null,
           // summary uses global aggregates
-          narrativePath,
+          workflowPath,
           `${scenarioPath}.template.summary`
         ));
       }
@@ -221046,7 +221149,7 @@ var NarrativeValidator = class {
         ];
         const similar = this.findSimilarAttributes(attr, allKeys);
         violations.push({
-          ruleId: "narrative-attribute-undefined",
+          ruleId: "workflow-attribute-undefined",
           severity: "warn",
           file,
           path: path4,
@@ -221062,7 +221165,7 @@ var NarrativeValidator = class {
         const objectKeys = Object.keys(value);
         const suggestions = objectKeys.slice(0, 3).map((k) => `{{${attr}.${k}}}`);
         violations.push({
-          ruleId: "narrative-attribute-object",
+          ruleId: "workflow-attribute-object",
           severity: "warn",
           file,
           path: path4,
@@ -221111,19 +221214,19 @@ var NarrativeValidator = class {
    */
   checkFormattingOptions(context) {
     const violations = [];
-    const { narrative, narrativePath } = context;
-    if (!narrative.formatting) {
+    const { workflow, workflowPath } = context;
+    if (!workflow.formatting) {
       return violations;
     }
-    if (narrative.formatting.showAttributes) {
+    if (workflow.formatting.showAttributes) {
       const validValues = ["none", "matched", "all"];
-      if (!validValues.includes(narrative.formatting.showAttributes)) {
+      if (!validValues.includes(workflow.formatting.showAttributes)) {
         violations.push({
-          ruleId: "narrative-formatting-options",
+          ruleId: "workflow-formatting-options",
           severity: "warn",
-          file: narrativePath,
+          file: workflowPath,
           path: "formatting.showAttributes",
-          message: `Invalid showAttributes value: "${narrative.formatting.showAttributes}"`,
+          message: `Invalid showAttributes value: "${workflow.formatting.showAttributes}"`,
           impact: "May not display attributes correctly",
           suggestion: `Use one of: ${validValues.join(", ")}`,
           fixable: false
@@ -221273,8 +221376,8 @@ var NarrativeValidator = class {
     return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
   }
 };
-function createNarrativeValidator() {
-  return new NarrativeValidator();
+function createWorkflowValidator() {
+  return new WorkflowValidator();
 }
 
 // ../core/dist/execution/ExecutionLoader.js
@@ -221558,14 +221661,14 @@ function loadGraphConfig(filePath) {
     return null;
   }
 }
-function loadNarrativeTemplate(filePath) {
+function loadWorkflowTemplate(filePath) {
   if (!(0, import_node_fs11.existsSync)(filePath)) {
     return null;
   }
   try {
     const raw = (0, import_node_fs11.readFileSync)(filePath, "utf8");
-    const narrative = JSON.parse(raw);
-    return { narrative, raw };
+    const workflow = JSON.parse(raw);
+    return { workflow, raw };
   } catch {
     return null;
   }
@@ -221588,8 +221691,8 @@ function loadCanvas(filePath) {
 }
 function getFileType(filePath) {
   const name = (0, import_node_path12.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";
@@ -221772,38 +221875,38 @@ function createLintCommand() {
         }
       }
       const engine = createDefaultRulesEngine();
-      const narrativeValidator = createNarrativeValidator();
+      const workflowValidator = createWorkflowValidator();
       const results = /* @__PURE__ */ new Map();
-      const narrativesByCanvas = /* @__PURE__ */ new Map();
+      const workflowsByCanvas = /* @__PURE__ */ new Map();
       const canvasEventMap = /* @__PURE__ */ new Map();
       for (const filePath of configFiles) {
         const absolutePath = (0, import_node_path12.resolve)(cwd, filePath);
         const relativePath = (0, import_node_path12.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 ? (0, import_node_path12.resolve)((0, import_node_path12.dirname)(absolutePath), loaded.narrative.canvas) : void 0;
+          const canvasPath = loaded.workflow.canvas ? (0, import_node_path12.resolve)((0, import_node_path12.dirname)(absolutePath), loaded.workflow.canvas) : void 0;
           if (canvasPath) {
             const canvasKey = (0, import_node_path12.relative)(cwd, canvasPath);
-            if (!narrativesByCanvas.has(canvasKey)) {
-              narrativesByCanvas.set(canvasKey, []);
+            if (!workflowsByCanvas.has(canvasKey)) {
+              workflowsByCanvas.set(canvasKey, []);
               canvasEventMap.set(canvasKey, /* @__PURE__ */ new Set());
             }
-            narrativesByCanvas.get(canvasKey).push({ absolutePath, relativePath, loaded });
-            const narrativeEvents = canvasEventMap.get(canvasKey);
-            for (const scenario of loaded.narrative.scenarios) {
+            workflowsByCanvas.get(canvasKey).push({ absolutePath, relativePath, loaded });
+            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);
                   }
                 }
               }
@@ -221815,8 +221918,8 @@ function createLintCommand() {
         const absolutePath = (0, import_node_path12.resolve)(cwd, filePath);
         const relativePath = (0, import_node_path12.relative)(cwd, absolutePath);
         const fileType = getFileType(absolutePath);
-        if (fileType === "narrative") {
-          const loaded = loadNarrativeTemplate(absolutePath);
+        if (fileType === "workflow") {
+          const loaded = loadWorkflowTemplate(absolutePath);
           if (!loaded) {
             results.set(relativePath, {
               violations: [
@@ -221824,7 +221927,7 @@ 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
                 }
@@ -221837,20 +221940,20 @@ function createLintCommand() {
             });
             continue;
           }
-          const canvasPath = loaded.narrative.canvas ? (0, import_node_path12.resolve)((0, import_node_path12.dirname)(absolutePath), loaded.narrative.canvas) : void 0;
+          const canvasPath = loaded.workflow.canvas ? (0, import_node_path12.resolve)((0, import_node_path12.dirname)(absolutePath), loaded.workflow.canvas) : void 0;
           const canvas = canvasPath ? loadCanvas(canvasPath) : void 0;
           const canvasKey = canvasPath ? (0, import_node_path12.relative)(cwd, canvasPath) : void 0;
-          const allNarrativeEvents = canvasKey ? canvasEventMap.get(canvasKey) : void 0;
-          const narrativeResult = await narrativeValidator.validate({
-            narrative: loaded.narrative,
-            narrativePath: relativePath,
+          const allWorkflowEvents = canvasKey ? canvasEventMap.get(canvasKey) : void 0;
+          const workflowResult = await workflowValidator.validate({
+            workflow: loaded.workflow,
+            workflowPath: relativePath,
             canvas: canvas ?? void 0,
             canvasPath: canvasKey,
             basePath: (0, import_node_path12.dirname)(absolutePath),
             rawContent: loaded.raw,
-            allNarrativeEvents
+            allWorkflowEvents
           });
-          const violations = narrativeResult.violations.map((v) => ({
+          const violations = workflowResult.violations.map((v) => ({
             ruleId: v.ruleId,
             severity: v.severity,
             file: v.file,
@@ -221863,11 +221966,11 @@ function createLintCommand() {
           }));
           results.set(relativePath, {
             violations,
-            errorCount: narrativeResult.errorCount,
-            warningCount: narrativeResult.warningCount,
-            fixableCount: narrativeResult.fixableCount,
+            errorCount: workflowResult.errorCount,
+            warningCount: workflowResult.warningCount,
+            fixableCount: workflowResult.fixableCount,
             byCategory: { schema: 0, reference: 0, structure: 0, pattern: 0, library: 0 },
-            // Could categorize narrative rules
+            // Could categorize workflow rules
             byRule: countByRule(violations)
           });
         } else {
@@ -222059,22 +222162,22 @@ function createCoverageCommand() {
   return command;
 }
 
-// src/commands/narrative/validate.ts
+// src/commands/workflow/validate.ts
 var import_node_path15 = require("node:path");
 var import_node_fs12 = require("node:fs");
 
-// src/commands/narrative/utils.ts
+// src/commands/workflow/utils.ts
 var import_promises4 = require("node:fs/promises");
 var import_node_path14 = require("node:path");
-async function loadNarrative(filePath) {
+async function loadWorkflow(filePath) {
   try {
     const content = await (0, import_promises4.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(`Workflow file not found: ${filePath}`);
     }
-    throw new Error(`Failed to parse narrative file: ${error.message}`);
+    throw new Error(`Failed to parse workflow file: ${error.message}`);
   }
 }
 async function loadExecution(filePath) {
@@ -222191,21 +222294,21 @@ function capitalize(str3) {
   return str3.charAt(0).toUpperCase() + str3.slice(1);
 }
 
-// src/commands/narrative/validate.ts
+// src/commands/workflow/validate.ts
 function createValidateCommand2() {
   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)").action(async (file, options) => {
+  command.description("Validate workflow template syntax, schema, and references").argument("<file>", "Path to .workflow.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)").action(async (file, options) => {
     try {
       const baseDir = options.dir || process.cwd();
-      const narrativePath = resolvePath(file, baseDir);
-      const narrative = await loadNarrative(narrativePath);
+      const workflowPath = resolvePath(file, baseDir);
+      const workflow = await loadWorkflow(workflowPath);
       let canvasPath;
       let canvas;
       if (options.canvas) {
         canvasPath = resolvePath(options.canvas, baseDir);
-      } else if (narrative.canvas) {
-        const narrativeDir = (0, import_node_path15.dirname)(narrativePath);
-        canvasPath = (0, import_node_path15.resolve)(narrativeDir, narrative.canvas);
+      } else if (workflow.canvas) {
+        const workflowDir = (0, import_node_path15.dirname)(workflowPath);
+        canvasPath = (0, import_node_path15.resolve)(workflowDir, workflow.canvas);
       }
       if (canvasPath) {
         try {
@@ -222241,10 +222344,10 @@ function createValidateCommand2() {
           console.error(source_default.gray("  Attribute validation will be skipped"));
         }
       }
-      const validator = new NarrativeValidator();
+      const validator = new WorkflowValidator();
       const context = {
-        narrative,
-        narrativePath,
+        workflow,
+        workflowPath,
         canvasPath,
         canvas,
         basePath: baseDir,
@@ -222271,8 +222374,8 @@ function createValidateCommand2() {
           summary: {
             errors: errors.length,
             warnings: warnings.length,
-            scenarioCount: narrative.scenarios.length,
-            hasDefault: narrative.scenarios.some((s) => s.condition.default),
+            scenarioCount: workflow.scenarios.length,
+            hasDefault: workflow.scenarios.some((s) => s.condition.default),
             attributeValidation: executionData ? "enabled" : "skipped"
           }
         };
@@ -222285,14 +222388,14 @@ Validating: ${file}
           console.log(source_default.green("\u2713"), "Schema validation passed");
           console.log(
             source_default.green("\u2713"),
-            `${narrative.scenarios.length} scenarios found`
+            `${workflow.scenarios.length} scenarios found`
           );
-          const hasDefault = narrative.scenarios.some((s) => s.condition.default);
+          const hasDefault = workflow.scenarios.some((s) => s.condition.default);
           console.log(
             source_default.green("\u2713"),
             hasDefault ? "Default scenario present" : "No default scenario"
           );
-          const priorities = narrative.scenarios.map((s) => s.priority);
+          const priorities = workflow.scenarios.map((s) => s.priority);
           const allUnique = new Set(priorities).size === priorities.length;
           console.log(
             source_default.green("\u2713"),
@@ -222301,7 +222404,7 @@ Validating: ${file}
           if (canvasPath) {
             console.log(
               source_default.green("\u2713"),
-              `Canvas: ${narrative.canvas || canvasPath} \u2713`
+              `Canvas: ${workflow.canvas || canvasPath} \u2713`
             );
           }
         } else {
@@ -222333,10 +222436,10 @@ ${icon} ${severity}: ${violation.message}`);
           console.log(source_default.green("  \u2022 0 warnings"));
         }
         console.log(
-          source_default.gray(`  \u2022 ${narrative.scenarios.length} scenario(s)`)
+          source_default.gray(`  \u2022 ${workflow.scenarios.length} scenario(s)`)
         );
         if (canvasPath) {
-          console.log(source_default.gray(`  \u2022 Canvas: ${narrative.canvas || canvasPath}`));
+          console.log(source_default.gray(`  \u2022 Canvas: ${workflow.canvas || canvasPath}`));
         }
         if (executionData) {
           console.log(
@@ -222362,7 +222465,7 @@ ${icon} ${severity}: ${violation.message}`);
   return command;
 }
 
-// src/commands/narrative/inspect.ts
+// src/commands/workflow/inspect.ts
 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) => {
@@ -222462,12 +222565,12 @@ ${capitalize(prefix)}:`));
   return command;
 }
 
-// src/commands/narrative/render.ts
+// src/commands/workflow/render.ts
 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").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) => {
+  command.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 (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);
       if (options.mode) {
@@ -222477,21 +222580,21 @@ function createRenderCommand() {
             `Invalid mode: ${options.mode}. Must be one of: ${validModes.join(", ")}`
           );
         }
-        narrative.mode = options.mode;
+        workflow.mode = options.mode;
       }
-      const result = renderNarrative(narrative, events);
-      const selectedScenario = narrative.scenarios.find((s) => s.id === result.scenarioId);
+      const result = renderWorkflow(workflow, events);
+      const selectedScenario = workflow.scenarios.find((s) => s.id === result.scenarioId);
       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}`);
         }
       }
       if (options.json) {
         const output = {
-          narrative: narrativePath,
+          workflow: workflowPath,
           execution: executionPath,
-          mode: narrative.mode,
+          mode: workflow.mode,
           scenario: {
             id: selectedScenario?.id,
             priority: selectedScenario?.priority,
@@ -222505,9 +222608,9 @@ function createRenderCommand() {
         console.log(JSON.stringify(output, null, 2));
       } else {
         if (!options.format || options.format === "text") {
-          console.log(source_default.gray(`Rendering: ${narrativePath}`));
+          console.log(source_default.gray(`Rendering: ${workflowPath}`));
           console.log(source_default.gray(`Execution: ${executionPath}`));
-          console.log(source_default.gray(`Mode: ${narrative.mode}`));
+          console.log(source_default.gray(`Mode: ${workflow.mode}`));
           if (selectedScenario) {
             console.log(
               source_default.gray(
@@ -222554,16 +222657,16 @@ function createRenderCommand() {
   return command;
 }
 
-// src/commands/narrative/test.ts
+// src/commands/workflow/test.ts
 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) => {
+  command.description("Test scenario matching and show why scenarios match or don't match").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 (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);
       const aggregates = computeAggregates(events);
-      const scenarioResults = narrative.scenarios.map((scenario) => {
+      const scenarioResults = workflow.scenarios.map((scenario) => {
         const condition = scenario.condition;
         const matched = matchesCondition(condition, events, aggregates);
         let reason;
@@ -222604,11 +222707,11 @@ function createTestCommand() {
           excludesResults
         };
       });
-      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,
@@ -222624,7 +222727,7 @@ function createTestCommand() {
         console.log(JSON.stringify(output, null, 2));
       } else {
         console.log(source_default.bold(`
-Testing: ${narrativePath}`));
+Testing: ${workflowPath}`));
         console.log(source_default.gray(`Execution: ${executionPath}
 `));
         console.log(source_default.bold("Scenario Matching Results:"));
@@ -222693,27 +222796,27 @@ ${icon} ${source_default.bold(result.scenario.id)} (priority: ${result.scenario.
   return command;
 }
 
-// src/commands/narrative/list.ts
+// src/commands/workflow/list.ts
 var import_promises5 = require("node:fs/promises");
 var import_node_path16 = require("node:path");
 function createListCommand2() {
   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) => {
+  command.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").action(async (dir, options) => {
     try {
       const searchDir = dir || ".principal-views";
       const searchPath = (0, import_node_path16.resolve)(process.cwd(), searchDir);
-      const files = await globby("**/*.narrative.json", {
+      const files = await globby("**/*.workflow.json", {
         cwd: searchPath,
         ignore: ["node_modules/**", ".git/**", "__executions__/**"]
       });
-      const narratives = await Promise.all(
+      const workflows = await Promise.all(
         files.map(async (file) => {
           const fullPath = (0, import_node_path16.join)(searchPath, file);
-          const narrative = await loadNarrative(fullPath);
+          const workflow = await loadWorkflow(fullPath);
           let canvasExists;
-          if (options.showCanvas && narrative.canvas) {
-            const narrativeDir = (0, import_node_path16.dirname)(fullPath);
-            const canvasPath = (0, import_node_path16.resolve)(narrativeDir, narrative.canvas);
+          if (options.showCanvas && workflow.canvas) {
+            const workflowDir = (0, import_node_path16.dirname)(fullPath);
+            const canvasPath = (0, import_node_path16.resolve)(workflowDir, workflow.canvas);
             try {
               await (0, import_promises5.access)(canvasPath);
               canvasExists = true;
@@ -222721,23 +222824,23 @@ function createListCommand2() {
               canvasExists = false;
             }
           }
-          const defaultCount = narrative.scenarios.filter((s) => s.condition.default).length;
+          const defaultCount = workflow.scenarios.filter((s) => s.condition.default).length;
           return {
             file: (0, import_node_path16.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,
@@ -222749,36 +222852,36 @@ function createListCommand2() {
         };
         console.log(JSON.stringify(output, null, 2));
       } else {
-        console.log(source_default.bold("\nNarrative Templates:"));
+        console.log(source_default.bold("\nWorkflow Templates:"));
         console.log("\u2501".repeat(60));
-        if (narratives.length === 0) {
+        if (workflows.length === 0) {
           console.log(source_default.yellow(`
-No narrative templates found in ${searchDir}`));
+No workflow templates found in ${searchDir}`));
           console.log();
           return;
         }
-        for (const narrative of narratives) {
+        for (const workflow of workflows) {
           console.log(source_default.bold(`
-${narrative.file}`));
-          if (narrative.name) {
-            console.log(source_default.gray(`  Name: ${narrative.name}`));
+${workflow.file}`));
+          if (workflow.name) {
+            console.log(source_default.gray(`  Name: ${workflow.name}`));
           }
-          if (options.showCanvas && narrative.canvas) {
-            const status = narrative.canvasExists ? source_default.green("\u2713") : source_default.red("\u2717");
-            console.log(source_default.gray(`  Canvas: ${narrative.canvas} ${status}`));
-          } else if (narrative.canvas) {
-            console.log(source_default.gray(`  Canvas: ${narrative.canvas}`));
+          if (options.showCanvas && workflow.canvas) {
+            const status = workflow.canvasExists ? source_default.green("\u2713") : source_default.red("\u2717");
+            console.log(source_default.gray(`  Canvas: ${workflow.canvas} ${status}`));
+          } else if (workflow.canvas) {
+            console.log(source_default.gray(`  Canvas: ${workflow.canvas}`));
           }
           console.log(
             source_default.gray(
-              `  Scenarios: ${narrative.scenarioCount} (${narrative.defaultCount} default)`
+              `  Scenarios: ${workflow.scenarioCount} (${workflow.defaultCount} default)`
             )
           );
-          console.log(source_default.gray(`  Mode: ${narrative.mode}`));
+          console.log(source_default.gray(`  Mode: ${workflow.mode}`));
         }
         console.log(
           source_default.bold(`
-Found ${narratives.length} narrative template(s)`)
+Found ${workflows.length} workflow template(s)`)
         );
         console.log();
       }
@@ -222790,10 +222893,10 @@ Found ${narratives.length} narrative template(s)`)
   return command;
 }
 
-// src/commands/narrative/index.ts
-function createNarrativeCommand() {
-  const command = new Command("narrative");
-  command.description("Validate, test, and debug narrative templates").addCommand(createValidateCommand2()).addCommand(createInspectCommand()).addCommand(createRenderCommand()).addCommand(createTestCommand()).addCommand(createListCommand2());
+// src/commands/workflow/index.ts
+function createWorkflowCommand() {
+  const command = new Command("workflow");
+  command.description("Validate, test, and debug workflow templates").addCommand(createValidateCommand2()).addCommand(createInspectCommand()).addCommand(createRenderCommand()).addCommand(createTestCommand()).addCommand(createListCommand2());
   return command;
 }
 
@@ -222812,7 +222915,7 @@ program2.addCommand(createFormatsCommand());
 program2.addCommand(createDoctorCommand());
 program2.addCommand(createHooksCommand());
 program2.addCommand(createCoverageCommand());
-program2.addCommand(createNarrativeCommand());
+program2.addCommand(createWorkflowCommand());
 program2.parse(process.argv);
 if (!process.argv.slice(2).length) {
   program2.outputHelp();