@principal-ai/principal-view-cli 0.5.0 → 0.6.0

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0sCpC,wBAAgB,qBAAqB,IAAI,OAAO,CAiI/C"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+uCpC,wBAAgB,qBAAqB,IAAI,OAAO,CAiI/C"}

package/dist/commands/validate.js

@@ -182,6 +182,7 @@ const ALLOWED_CANVAS_FIELDS = {
         'version',
         'name',
         'description',
+        'markdown',
         'nodeTypes',
         'edgeTypes',
         'pathConfig',
@@ -346,7 +347,7 @@ function findSimilarField(field, allowedFields) {
  * Check if a canvas has OTEL-related features
  * Returns true if the canvas contains any of:
  * 1. Nodes with pv.otel extension (kind, category)
- * 2. Event schema (pv.event with validation)
+ * 2. Event schema (pv.event or pv.eventRef with validation)
  * 3. Canvas scope/audit config (OTEL log routing)
  * 4. Resource matching for OTEL logs
  */
@@ -373,8 +374,8 @@ function hasOtelFeatures(canvas) {
                     if (nodePv.otel !== undefined) {
                         return true;
                     }
-                    // Check for event schema (pv.event)
-                    if (nodePv.event !== undefined) {
+                    // Check for event schema (pv.event or pv.eventRef)
+                    if (nodePv.event !== undefined || nodePv.eventRef !== undefined) {
                         return true;
                     }
                     // Check for resourceMatch (OTEL log routing)
@@ -634,19 +635,28 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
                 if (nodePv.otel && typeof nodePv.otel === 'object') {
                     checkUnknownFields(nodePv.otel, ALLOWED_CANVAS_FIELDS.nodePvOtel, `${nodePath}.pv.otel`, issues);
                 }
-                // For .otel.canvas files: require event field on nodes with pv extension (except groups)
+                // Check for conflict: node cannot have both event and eventRef
+                if (nodePv.event !== undefined && nodePv.eventRef !== undefined) {
+                    issues.push({
+                        type: 'error',
+                        message: `Node "${nodeLabel}" has both "pv.event" and "pv.eventRef" - only one is allowed`,
+                        path: `${nodePath}.pv`,
+                        suggestion: 'Use "event" for inline event definition, or "eventRef" to reference a library event schema. Remove one of them.',
+                    });
+                }
+                // For .otel.canvas files: require event or eventRef field on nodes with pv extension (except groups)
                 if (filePath.endsWith('.otel.canvas') && nodeType !== 'group') {
-                    if (nodePv.event === undefined) {
+                    if (nodePv.event === undefined && nodePv.eventRef === undefined) {
                         issues.push({
                             type: 'error',
-                            message: `Node "${nodeLabel}" in .otel.canvas file must have "pv.event" field`,
-                            path: `${nodePath}.pv.event`,
-                            suggestion: 'Add event name, e.g.: "event": "user.login" or "event": "order.created"',
+                            message: `Node "${nodeLabel}" in .otel.canvas file must have either "pv.event" or "pv.eventRef" field`,
+                            path: `${nodePath}.pv`,
+                            suggestion: 'Add inline event schema with "event": {...} or reference library event with "eventRef": "event.name"',
                         });
                     }
                 }
                 // Validate source file references for OTEL event nodes
-                const hasOtelFeatures = nodePv.otel !== undefined || nodePv.event !== undefined;
+                const hasOtelFeatures = nodePv.otel !== undefined || nodePv.event !== undefined || nodePv.eventRef !== undefined;
                 if (hasOtelFeatures) {
                     // OTEL nodes must have at least one source file reference
                     if (!Array.isArray(nodePv.sources) || nodePv.sources.length === 0) {
@@ -657,11 +667,11 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
                             suggestion: 'Add at least one source file reference, e.g.: "sources": ["src/services/MyService.ts"]',
                         });
                     }
-                    // For .otel.canvas files: nodes with event must have pv.otel for UI rendering
-                    if (filePath.endsWith('.otel.canvas') && nodePv.event !== undefined && nodePv.otel === undefined) {
+                    // For .otel.canvas files: nodes with event or eventRef must have pv.otel for UI rendering
+                    if (filePath.endsWith('.otel.canvas') && (nodePv.event !== undefined || nodePv.eventRef !== undefined) && nodePv.otel === undefined) {
                         issues.push({
                             type: 'error',
-                            message: `Node "${nodeLabel}" in .otel.canvas file has event but is missing "pv.otel" field required for UI badges`,
+                            message: `Node "${nodeLabel}" in .otel.canvas file has event schema but is missing "pv.otel" field required for UI badges`,
                             path: `${nodePath}.pv.otel`,
                             suggestion: 'Add OTEL metadata for UI rendering, e.g.: "otel": { "kind": "event", "category": "lifecycle", "isNew": true }',
                         });
@@ -921,6 +931,32 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
             suggestion: 'Either add OTEL features (pv.otel, pv.events, pv.scope, pv.audit, resourceMatch) or rename to .canvas',
         });
     }
+    // Validate markdown field for .otel.canvas files
+    if (isOtelCanvas) {
+        const pv = c.pv;
+        if (!pv || typeof pv.markdown !== 'string' || !pv.markdown) {
+            issues.push({
+                type: 'error',
+                message: 'OTEL canvas files must have a "pv.markdown" field pointing to documentation',
+                path: 'pv.markdown',
+                suggestion: 'Add: "markdown": ".principal-views/graph-name.md" (path relative to repository root)',
+            });
+        }
+        else {
+            // Validate that the markdown file exists (if repository path is provided)
+            if (repositoryPath) {
+                const markdownPath = resolve(repositoryPath, pv.markdown);
+                if (!existsSync(markdownPath)) {
+                    issues.push({
+                        type: 'error',
+                        message: `Referenced markdown file does not exist: ${pv.markdown}`,
+                        path: 'pv.markdown',
+                        suggestion: `Create the markdown file at: ${markdownPath}`,
+                    });
+                }
+            }
+        }
+    }
     return issues;
 }
 /**

package/dist/index.cjs

@@ -234405,6 +234405,7 @@ var ALLOWED_CANVAS_FIELDS = {
     "version",
     "name",
     "description",
+    "markdown",
     "nodeTypes",
     "edgeTypes",
     "pathConfig",
@@ -234571,7 +234572,7 @@ function hasOtelFeatures(canvas) {
           if (nodePv.otel !== void 0) {
             return true;
           }
-          if (nodePv.event !== void 0) {
+          if (nodePv.event !== void 0 || nodePv.eventRef !== void 0) {
             return true;
           }
           if (nodePv.resourceMatch !== void 0) {
@@ -234855,17 +234856,25 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
             issues
           );
         }
+        if (nodePv.event !== void 0 && nodePv.eventRef !== void 0) {
+          issues.push({
+            type: "error",
+            message: `Node "${nodeLabel}" has both "pv.event" and "pv.eventRef" - only one is allowed`,
+            path: `${nodePath2}.pv`,
+            suggestion: 'Use "event" for inline event definition, or "eventRef" to reference a library event schema. Remove one of them.'
+          });
+        }
         if (filePath.endsWith(".otel.canvas") && nodeType !== "group") {
-          if (nodePv.event === void 0) {
+          if (nodePv.event === void 0 && nodePv.eventRef === void 0) {
             issues.push({
               type: "error",
-              message: `Node "${nodeLabel}" in .otel.canvas file must have "pv.event" field`,
-              path: `${nodePath2}.pv.event`,
-              suggestion: 'Add event name, e.g.: "event": "user.login" or "event": "order.created"'
+              message: `Node "${nodeLabel}" in .otel.canvas file must have either "pv.event" or "pv.eventRef" field`,
+              path: `${nodePath2}.pv`,
+              suggestion: 'Add inline event schema with "event": {...} or reference library event with "eventRef": "event.name"'
             });
           }
         }
-        const hasOtelFeatures2 = nodePv.otel !== void 0 || nodePv.event !== void 0;
+        const hasOtelFeatures2 = nodePv.otel !== void 0 || nodePv.event !== void 0 || nodePv.eventRef !== void 0;
         if (hasOtelFeatures2) {
           if (!Array.isArray(nodePv.sources) || nodePv.sources.length === 0) {
             issues.push({
@@ -234875,10 +234884,10 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
               suggestion: 'Add at least one source file reference, e.g.: "sources": ["src/services/MyService.ts"]'
             });
           }
-          if (filePath.endsWith(".otel.canvas") && nodePv.event !== void 0 && nodePv.otel === void 0) {
+          if (filePath.endsWith(".otel.canvas") && (nodePv.event !== void 0 || nodePv.eventRef !== void 0) && nodePv.otel === void 0) {
             issues.push({
               type: "error",
-              message: `Node "${nodeLabel}" in .otel.canvas file has event but is missing "pv.otel" field required for UI badges`,
+              message: `Node "${nodeLabel}" in .otel.canvas file has event schema but is missing "pv.otel" field required for UI badges`,
               path: `${nodePath2}.pv.otel`,
               suggestion: 'Add OTEL metadata for UI rendering, e.g.: "otel": { "kind": "event", "category": "lifecycle", "isNew": true }'
             });
@@ -235126,6 +235135,29 @@ function validateCanvas(canvas, filePath, library, repositoryPath) {
       suggestion: "Either add OTEL features (pv.otel, pv.events, pv.scope, pv.audit, resourceMatch) or rename to .canvas"
     });
   }
+  if (isOtelCanvas) {
+    const pv = c.pv;
+    if (!pv || typeof pv.markdown !== "string" || !pv.markdown) {
+      issues.push({
+        type: "error",
+        message: 'OTEL canvas files must have a "pv.markdown" field pointing to documentation',
+        path: "pv.markdown",
+        suggestion: 'Add: "markdown": ".principal-views/graph-name.md" (path relative to repository root)'
+      });
+    } else {
+      if (repositoryPath) {
+        const markdownPath = (0, import_node_path5.resolve)(repositoryPath, pv.markdown);
+        if (!(0, import_node_fs4.existsSync)(markdownPath)) {
+          issues.push({
+            type: "error",
+            message: `Referenced markdown file does not exist: ${pv.markdown}`,
+            path: "pv.markdown",
+            suggestion: `Create the markdown file at: ${markdownPath}`
+          });
+        }
+      }
+    }
+  }
   return issues;
 }
 function validateFile(filePath, library, repositoryPath) {
@@ -237881,6 +237913,132 @@ function getConfigNameFromFilename(filename) {
   return filename.replace(/\.(yaml|yml)$/, "");
 }
 
+// node_modules/@principal-ai/principal-view-core/dist/ConfigurationLoader.js
+var ConfigurationLoader = class _ConfigurationLoader {
+  constructor(fsAdapter) {
+    this.fsAdapter = fsAdapter;
+  }
+  /**
+   * Check if the .principal-views/ configuration directory exists
+   *
+   * @param baseDir - Base directory to search from
+   * @returns True if .principal-views/ directory exists
+   */
+  hasConfigDirectory(baseDir) {
+    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
+    return this.fsAdapter.exists(configPath) && this.fsAdapter.isDirectory(configPath);
+  }
+  /**
+   * List all available configuration names in .principal-views/ folder
+   *
+   * @param baseDir - Base directory containing .principal-views/ folder
+   * @returns Array of configuration names (without extensions)
+   */
+  listConfigurations(baseDir) {
+    if (!this.hasConfigDirectory(baseDir)) {
+      return [];
+    }
+    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
+    const files = this.fsAdapter.readDir(configPath);
+    return files.filter(isYamlFile).map(getConfigNameFromFilename).sort();
+  }
+  /**
+   * Load a specific configuration by name
+   *
+   * @param name - Configuration name (without extension)
+   * @param baseDir - Base directory containing .principal-views/ folder
+   * @returns Configuration file or null if not found/invalid
+   */
+  loadByName(name, baseDir) {
+    if (!this.hasConfigDirectory(baseDir)) {
+      return null;
+    }
+    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
+    for (const ext of ["yaml", "yml"]) {
+      const filename = `${name}.${ext}`;
+      const fullPath = this.fsAdapter.join(configPath, filename);
+      if (this.fsAdapter.exists(fullPath)) {
+        try {
+          const content = this.fsAdapter.readFile(fullPath);
+          const parseResult = parseYaml(content, filename);
+          if (parseResult.success && parseResult.data) {
+            return {
+              name,
+              path: fullPath,
+              config: parseResult.data
+            };
+          }
+        } catch (error) {
+          return null;
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Load all configurations from .principal-views/ folder
+   *
+   * @param baseDir - Base directory containing .principal-views/ folder
+   * @returns Result containing all loaded configs and any errors
+   */
+  loadAll(baseDir) {
+    const result = {
+      configs: [],
+      errors: []
+    };
+    if (!this.hasConfigDirectory(baseDir)) {
+      result.errors.push({
+        file: ".principal-views",
+        error: "Configuration directory .principal-views/ not found"
+      });
+      return result;
+    }
+    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
+    const files = this.fsAdapter.readDir(configPath);
+    for (const filename of files) {
+      if (!isYamlFile(filename)) {
+        continue;
+      }
+      const fullPath = this.fsAdapter.join(configPath, filename);
+      const name = getConfigNameFromFilename(filename);
+      try {
+        const content = this.fsAdapter.readFile(fullPath);
+        const parseResult = parseYaml(content, filename);
+        if (parseResult.success && parseResult.data) {
+          result.configs.push({
+            name,
+            path: fullPath,
+            config: parseResult.data
+          });
+        } else if (parseResult.error) {
+          result.errors.push({
+            file: filename,
+            error: parseResult.error
+          });
+        }
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push({
+          file: filename,
+          error: `Failed to read file: ${errorMessage}`
+        });
+      }
+    }
+    result.configs.sort((a, b) => a.name.localeCompare(b.name));
+    return result;
+  }
+  /**
+   * Get the configuration directory path
+   *
+   * @param baseDir - Base directory
+   * @returns Full path to .principal-views/ directory
+   */
+  getConfigDirectoryPath(baseDir) {
+    return this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
+  }
+};
+ConfigurationLoader.CONFIG_DIR = ".principal-views";
+
 // node_modules/@principal-ai/principal-view-core/dist/narrative/template-parser.js
 var import_handlebars = __toESM(require_lib());
 import_handlebars.default.registerHelper("eq", (a, b) => a === b);
@@ -241868,7 +242026,12 @@ var CanvasDiscovery = class _CanvasDiscovery {
       if (options.includeContent && options.fileReader) {
         try {
           const content = await options.fileReader(path4);
-          canvas.content = JSON.parse(content);
+          const parsedContent = JSON.parse(content);
+          const canvasWithContent = canvas;
+          canvasWithContent.content = parsedContent;
+          if (parsedContent.pv?.markdown) {
+            canvas.markdownPath = parsedContent.pv.markdown;
+          }
         } catch (error) {
           errors.push({
             path: path4,
@@ -241894,7 +242057,7 @@ var CanvasDiscovery = class _CanvasDiscovery {
         continue;
       const packageInfo = this.findPackageForPath(path4, packageMap);
       const id = packageInfo ? `${packageInfo.packageData.name}/${metadata.basename}` : metadata.basename;
-      const execution = {
+      let execution = {
         id,
         name: this.toDisplayName(metadata.basename),
         path: path4,
@@ -241908,7 +242071,7 @@ var CanvasDiscovery = class _CanvasDiscovery {
       if (options.includeContent && options.fileReader) {
         try {
           const content = await options.fileReader(path4);
-          execution.content = JSON.parse(content);
+          execution = { ...execution, content: JSON.parse(content) };
         } catch (error) {
           errors.push({
             path: path4,
@@ -242149,7 +242312,11 @@ function convertOtlpToExecutionData(otlp) {
   };
 }
 function isOtlpFormat(data) {
-  return typeof data === "object" && data !== null && "resourceSpans" in data && Array.isArray(data.resourceSpans);
+  if (typeof data !== "object" || data === null) {
+    return false;
+  }
+  const potentialOtlp = data;
+  return "resourceSpans" in data && Array.isArray(potentialOtlp.resourceSpans);
 }
 var ExecutionValidator = class {
   /**
@@ -244417,7 +244584,7 @@ var TypeScriptGenerator = class {
   constructor() {
     this.language = "typescript";
   }
-  generate(canvas, options) {
+  generate(canvas, options, library) {
     const opts = {
       readonly: options?.style?.readonly ?? false,
       strictNullChecks: options?.style?.strictNullChecks ?? true,
@@ -244440,13 +244607,23 @@ var TypeScriptGenerator = class {
     }
     if (canvas.nodes) {
       for (const node of canvas.nodes) {
+        let eventSchema;
         if (node.pv?.event) {
-          lines.push(...this.generateNodeTypes(node.id, node.pv.event, opts));
+          eventSchema = node.pv.event;
+        } else if (node.pv?.eventRef) {
+          eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
+          if (!eventSchema) {
+            console.warn(`Node '${node.id}' references unknown library event '${node.pv.eventRef}'`);
+            continue;
+          }
+        }
+        if (eventSchema) {
+          lines.push(...this.generateNodeTypes(node.id, eventSchema, opts));
           lines.push("");
         }
       }
     }
-    lines.push(...this.generateEventNameUnion(canvas, opts));
+    lines.push(...this.generateEventNameUnion(canvas, opts, library));
     lines.push("");
     lines.push(...this.generateEmitterTypes(canvas, opts));
     if (opts.namespace) {
@@ -244508,13 +244685,18 @@ var TypeScriptGenerator = class {
     lines.push("  }");
     return lines;
   }
-  generateEventNameUnion(canvas, opts) {
+  generateEventNameUnion(canvas, opts, library) {
     const lines = [];
     const allEventNames = /* @__PURE__ */ new Set();
     if (canvas.nodes) {
       for (const node of canvas.nodes) {
         if (node.pv?.event?.name) {
           allEventNames.add(node.pv.event.name);
+        } else if (node.pv?.eventRef) {
+          const eventSchema = this.resolveLibraryEvent(node.pv.eventRef, library);
+          if (eventSchema) {
+            allEventNames.add(eventSchema.name);
+          }
         }
       }
     }
@@ -244599,6 +244781,23 @@ var TypeScriptGenerator = class {
     const kebab = name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
     return `${kebab}.types.ts`;
   }
+  /**
+   * Resolve an event schema from library by event name
+   */
+  resolveLibraryEvent(eventName, library) {
+    if (!library?.eventSchemas) {
+      return void 0;
+    }
+    const librarySchema = library.eventSchemas[eventName];
+    if (!librarySchema) {
+      return void 0;
+    }
+    return {
+      name: eventName,
+      description: librarySchema.description,
+      attributes: librarySchema.attributes
+    };
+  }
 };
 var generatorRegistry = {
   generators: /* @__PURE__ */ new Map([
@@ -244615,132 +244814,6 @@ var generatorRegistry = {
   }
 };
 
-// node_modules/@principal-ai/principal-view-core/dist/ConfigurationLoader.js
-var ConfigurationLoader = class _ConfigurationLoader {
-  constructor(fsAdapter) {
-    this.fsAdapter = fsAdapter;
-  }
-  /**
-   * Check if the .principal-views/ configuration directory exists
-   *
-   * @param baseDir - Base directory to search from
-   * @returns True if .principal-views/ directory exists
-   */
-  hasConfigDirectory(baseDir) {
-    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
-    return this.fsAdapter.exists(configPath) && this.fsAdapter.isDirectory(configPath);
-  }
-  /**
-   * List all available configuration names in .principal-views/ folder
-   *
-   * @param baseDir - Base directory containing .principal-views/ folder
-   * @returns Array of configuration names (without extensions)
-   */
-  listConfigurations(baseDir) {
-    if (!this.hasConfigDirectory(baseDir)) {
-      return [];
-    }
-    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
-    const files = this.fsAdapter.readDir(configPath);
-    return files.filter(isYamlFile).map(getConfigNameFromFilename).sort();
-  }
-  /**
-   * Load a specific configuration by name
-   *
-   * @param name - Configuration name (without extension)
-   * @param baseDir - Base directory containing .principal-views/ folder
-   * @returns Configuration file or null if not found/invalid
-   */
-  loadByName(name, baseDir) {
-    if (!this.hasConfigDirectory(baseDir)) {
-      return null;
-    }
-    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
-    for (const ext of ["yaml", "yml"]) {
-      const filename = `${name}.${ext}`;
-      const fullPath = this.fsAdapter.join(configPath, filename);
-      if (this.fsAdapter.exists(fullPath)) {
-        try {
-          const content = this.fsAdapter.readFile(fullPath);
-          const parseResult = parseYaml(content, filename);
-          if (parseResult.success && parseResult.data) {
-            return {
-              name,
-              path: fullPath,
-              config: parseResult.data
-            };
-          }
-        } catch (error) {
-          return null;
-        }
-      }
-    }
-    return null;
-  }
-  /**
-   * Load all configurations from .principal-views/ folder
-   *
-   * @param baseDir - Base directory containing .principal-views/ folder
-   * @returns Result containing all loaded configs and any errors
-   */
-  loadAll(baseDir) {
-    const result = {
-      configs: [],
-      errors: []
-    };
-    if (!this.hasConfigDirectory(baseDir)) {
-      result.errors.push({
-        file: ".principal-views",
-        error: "Configuration directory .principal-views/ not found"
-      });
-      return result;
-    }
-    const configPath = this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
-    const files = this.fsAdapter.readDir(configPath);
-    for (const filename of files) {
-      if (!isYamlFile(filename)) {
-        continue;
-      }
-      const fullPath = this.fsAdapter.join(configPath, filename);
-      const name = getConfigNameFromFilename(filename);
-      try {
-        const content = this.fsAdapter.readFile(fullPath);
-        const parseResult = parseYaml(content, filename);
-        if (parseResult.success && parseResult.data) {
-          result.configs.push({
-            name,
-            path: fullPath,
-            config: parseResult.data
-          });
-        } else if (parseResult.error) {
-          result.errors.push({
-            file: filename,
-            error: parseResult.error
-          });
-        }
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        result.errors.push({
-          file: filename,
-          error: `Failed to read file: ${errorMessage}`
-        });
-      }
-    }
-    result.configs.sort((a, b) => a.name.localeCompare(b.name));
-    return result;
-  }
-  /**
-   * Get the configuration directory path
-   *
-   * @param baseDir - Base directory
-   * @returns Full path to .principal-views/ directory
-   */
-  getConfigDirectoryPath(baseDir) {
-    return this.fsAdapter.join(baseDir, _ConfigurationLoader.CONFIG_DIR);
-  }
-};
-ConfigurationLoader.CONFIG_DIR = ".principal-views";
-
 // node_modules/@opentelemetry/api/build/esm/platform/node/globalThis.js
 var _globalThis = typeof globalThis === "object" ? globalThis : global;
 
@@ -247687,8 +247760,13 @@ var NarrativeValidator = class {
     }
     const canvasEvents = /* @__PURE__ */ new Set();
     for (const node of canvas.nodes) {
-      if (node.pv?.event && typeof node.pv.event === "string") {
-        canvasEvents.add(node.pv.event);
+      if (node.pv?.event) {
+        if (typeof node.pv.event === "object" && node.pv.event.name) {
+          canvasEvents.add(node.pv.event.name);
+        }
+      }
+      if (node.pv?.eventRef && typeof node.pv.eventRef === "string") {
+        canvasEvents.add(node.pv.eventRef);
       }
     }
     const narrativeEvents = /* @__PURE__ */ new Set();
@@ -247708,7 +247786,7 @@ var NarrativeValidator = class {
         }
       }
     }
-    for (const eventName of narrativeEvents) {
+    for (const eventName of Array.from(narrativeEvents)) {
       if (!canvasEvents.has(eventName)) {
         violations.push({
           ruleId: "narrative-event-sync",
@@ -247722,7 +247800,7 @@ var NarrativeValidator = class {
         });
       }
     }
-    for (const eventName of canvasEvents) {
+    for (const eventName of Array.from(canvasEvents)) {
       if (!narrativeEvents.has(eventName)) {
         violations.push({
           ruleId: "narrative-event-coverage",
@@ -247867,6 +247945,9 @@ var NarrativeValidator = class {
   checkConditionStructure(condition, file, scenarioIdx) {
     const violations = [];
     const validFields = ["requires", "excludes", "assertions", "default", "any"];
+    if (typeof condition !== "object" || condition === null) {
+      return violations;
+    }
     const conditionKeys = Object.keys(condition);
     for (const key of conditionKeys) {
       if (!validFields.includes(key)) {