@principal-ai/principal-view-cli 0.1.24 → 0.1.26

package/dist/index.cjs

@@ -13688,6 +13688,7 @@ var ALLOWED_CANVAS_FIELDS = {
     "name",
     "description",
     "otel",
+    "events",
     "shape",
     "icon",
     "fill",
@@ -13790,6 +13791,38 @@ function findSimilarField(field, allowedFields) {
   }
   return null;
 }
+function hasOtelFeatures(canvas) {
+  if (!canvas || typeof canvas !== "object") {
+    return false;
+  }
+  const c = canvas;
+  if (c.pv && typeof c.pv === "object") {
+    const pv = c.pv;
+    if (pv.scope !== void 0 || pv.audit !== void 0) {
+      return true;
+    }
+  }
+  if (Array.isArray(c.nodes)) {
+    for (const node of c.nodes) {
+      if (node && typeof node === "object") {
+        const n = node;
+        if (n.pv && typeof n.pv === "object") {
+          const nodePv = n.pv;
+          if (nodePv.otel !== void 0) {
+            return true;
+          }
+          if (nodePv.events !== void 0) {
+            return true;
+          }
+          if (nodePv.resourceMatch !== void 0) {
+            return true;
+          }
+        }
+      }
+    }
+  }
+  return false;
+}
 function validateCanvas(canvas, filePath, library) {
   const issues = [];
   if (!canvas || typeof canvas !== "object") {
@@ -14256,6 +14289,21 @@ function validateCanvas(canvas, filePath, library) {
       }
     });
   }
+  const hasOtel = hasOtelFeatures(canvas);
+  const isOtelCanvas = filePath.endsWith(".otel.canvas");
+  if (hasOtel && !isOtelCanvas) {
+    issues.push({
+      type: "error",
+      message: "Canvas contains OTEL features but does not use .otel.canvas naming convention",
+      suggestion: 'Rename file to use .otel.canvas extension (e.g., "graph-name.otel.canvas")'
+    });
+  } else if (!hasOtel && isOtelCanvas) {
+    issues.push({
+      type: "warning",
+      message: "Canvas uses .otel.canvas naming but does not contain any OTEL features",
+      suggestion: "Either add OTEL features (pv.otel, pv.events, pv.scope, pv.audit, resourceMatch) or rename to .canvas"
+    });
+  }
   return issues;
 }
 function validateFile(filePath, library) {
@@ -14304,7 +14352,7 @@ function createValidateCommand() {
         } else {
           console.log(source_default.yellow("No .canvas files found matching the specified patterns."));
           console.log(source_default.dim(`Patterns searched: ${patterns.join(", ")}`));
-          console.log(source_default.dim("\nTo create a new .principal-views folder, run: privu init"));
+          console.log(source_default.dim("\nTo create a new .principal-views folder, run: npx @principal-ai/principal-view-cli init"));
         }
         return;
       }
@@ -14528,7 +14576,7 @@ edgeComponents: {}
             if (isHuskyInstalled(gitRoot)) {
               if ((0, import_node_fs5.existsSync)(preCommitFile)) {
                 const existingContent = (0, import_node_fs5.readFileSync)(preCommitFile, "utf8");
-                if (existingContent.includes("principal-view-cli lint") || existingContent.includes("privu lint")) {
+                if (existingContent.includes("principal-view-cli lint")) {
                   console.log(
                     source_default.yellow(`Husky pre-commit hook already includes principal view linting`)
                   );
@@ -14605,16 +14653,16 @@ edgeComponents: {}
       console.log(
         `  2. Build your graph in ${source_default.cyan(`.principal-views/${options.name}.canvas`)}`
       );
-      console.log(`  3. Run ${source_default.cyan("privu lint")} to validate your configuration`);
+      console.log(`  3. Run ${source_default.cyan("npx @principal-ai/principal-view-cli lint")} to validate your configuration`);
       if (huskySetup) {
         console.log(`  4. Commits will now automatically lint .principal-views files`);
       }
       console.log("");
       console.log(source_default.bold("Commands:"));
-      console.log(`  \u2022 ${source_default.cyan("privu lint")} - Lint configuration files`);
-      console.log(`  \u2022 ${source_default.cyan("privu lint --json")} - Output lint results as JSON`);
-      console.log(`  \u2022 ${source_default.cyan("privu validate")} - Validate canvas files`);
-      console.log(`  \u2022 ${source_default.cyan("privu doctor")} - Check project setup`);
+      console.log(`  \u2022 ${source_default.cyan("npx @principal-ai/principal-view-cli lint")} - Lint configuration files`);
+      console.log(`  \u2022 ${source_default.cyan("npx @principal-ai/principal-view-cli lint --json")} - Output lint results as JSON`);
+      console.log(`  \u2022 ${source_default.cyan("npx @principal-ai/principal-view-cli validate")} - Validate canvas files`);
+      console.log(`  \u2022 ${source_default.cyan("npx @principal-ai/principal-view-cli doctor")} - Check project setup`);
     } catch (error) {
       console.error(source_default.red("Error:"), error.message);
       process.exit(1);
@@ -14660,7 +14708,7 @@ function createListCommand() {
           if (!options.all) {
             console.log(source_default.dim("Run with --all to search all directories"));
           }
-          console.log(source_default.dim("\nTo create a new canvas, run: privu init"));
+          console.log(source_default.dim("\nTo create a new canvas, run: npx @principal-ai/principal-view-cli init"));
         }
         return;
       }
@@ -14719,7 +14767,7 @@ ${source_default.dim("\u2502")}   }
 ${source_default.dim("\u2502")} }                                               ${source_default.dim("\u2502")}
 ${source_default.dim("\u2514\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\u2518")}
 
-Run ${source_default.cyan("privu schema <section>")} for details on:
+Run ${source_default.cyan("npx @principal-ai/principal-view-cli schema <section>")} for details on:
   ${source_default.yellow("nodes")}      Node types and properties
   ${source_default.yellow("edges")}      Edge properties and types
   ${source_default.yellow("vv")}         Principal View extension fields
@@ -15010,8 +15058,8 @@ ${source_default.dim("\u2500".repeat(50))}
   }
 }
 
-${source_default.bold("Run validation:")} ${source_default.cyan("privu validate <file>")}
-${source_default.bold("Initialize project:")} ${source_default.cyan("privu init")}
+${source_default.bold("Run validation:")} ${source_default.cyan("npx @principal-ai/principal-view-cli validate <file>")}
+${source_default.bold("Initialize project:")} ${source_default.cyan("npx @principal-ai/principal-view-cli init")}
 `
 };
 function createSchemaCommand() {
@@ -15152,7 +15200,7 @@ function createDoctorCommand() {
           );
         } else {
           console.log(source_default.yellow("No .principal-views directory found."));
-          console.log(source_default.dim('Run "privu init" to create a configuration.'));
+          console.log(source_default.dim('Run "npx @principal-ai/principal-view-cli init" to create a configuration.'));
         }
         return;
       }
@@ -15290,17 +15338,17 @@ var VV_HOOK_MARKER = "# Principal View checks";
 function getVVHookContent() {
   return `${VV_HOOK_MARKER}
 echo "Running Principal View doctor check..."
-npx privu doctor --errors-only || {
+npx @principal-ai/principal-view-cli doctor --errors-only || {
   echo "\u274C Principal View doctor check failed (errors found)"
-  echo "   Run 'privu doctor' to see details"
+  echo "   Run 'npx @principal-ai/principal-view-cli doctor' to see details"
   exit 1
 }
 
 echo "Running Principal View canvas validation..."
-npx privu validate --quiet 2>/dev/null || {
+npx @principal-ai/principal-view-cli validate --quiet 2>/dev/null || {
   if [ $? -ne 0 ]; then
     echo "\u274C Canvas validation failed"
-    echo "   Run 'privu validate' to see details"
+    echo "   Run 'npx @principal-ai/principal-view-cli validate' to see details"
     exit 1
   fi
 }
@@ -15401,7 +15449,7 @@ function removeVVHook(repoPath) {
   let i = startIndex + 1;
   while (i < lines.length && inVVBlock) {
     const line = lines[i];
-    if (line && (line.includes("privu ") || line.includes("Principal View") || line.includes('echo "Running Visual') || line.includes("exit 1") && i > startIndex && i < startIndex + 15 || line === "}" && i > startIndex && i < startIndex + 15 || line.trim() === "" && i === startIndex + 1)) {
+    if (line && (line.includes("@principal-ai/principal-view-cli ") || line.includes("Principal View") || line.includes('echo "Running Visual') || line.includes("exit 1") && i > startIndex && i < startIndex + 15 || line === "}" && i > startIndex && i < startIndex + 15 || line.trim() === "" && i === startIndex + 1)) {
       endIndex = i;
       i++;
     } else if (line && line.trim() === "" && i < startIndex + 15) {
@@ -15436,11 +15484,11 @@ function createHooksCommand() {
       if (!isHuskyInstalled2(repoPath)) {
         if (options.check) {
           console.log(source_default.red("\u274C Husky is not installed"));
-          console.log('   Run "privu hooks --init" to install husky');
+          console.log('   Run "npx @principal-ai/principal-view-cli hooks --init" to install husky');
           process.exit(1);
         } else if (options.add) {
           console.log(source_default.red("\u274C Husky is not installed"));
-          console.log('   Run "privu hooks --init" first to install husky');
+          console.log('   Run "npx @principal-ai/principal-view-cli hooks --init" first to install husky');
           process.exit(1);
         } else if (options.remove) {
           console.log("\u2139\uFE0F  Husky is not installed");
@@ -15448,7 +15496,7 @@ function createHooksCommand() {
         } else {
           console.log(source_default.red("\u274C Husky is not installed in this repository"));
           console.log("\nTo install husky and set up Principal View hooks:");
-          console.log("  privu hooks --init --add");
+          console.log("  npx @principal-ai/principal-view-cli hooks --init --add");
           process.exit(1);
         }
       }
@@ -15467,7 +15515,7 @@ function createHooksCommand() {
           addVVHook(repoPath);
           console.log(source_default.green("\u2705 Added Principal View checks to pre-commit hook"));
           console.log("\nPre-commit hook will now:");
-          console.log("  \u2022 Run privu doctor to check for stale configurations");
+          console.log("  \u2022 Run npx @principal-ai/principal-view-cli doctor to check for stale configurations");
           console.log("  \u2022 Validate all .canvas files");
         }
       } else if (options.remove) {
@@ -15533,8 +15581,8 @@ function createCreateCommand() {
         `  1. Open ${source_default.cyan(`.principal-views/${options.name}.canvas`)} in your editor`
       );
       console.log(`  2. Add nodes and edges to define your architecture`);
-      console.log(`  3. Run ${source_default.cyan("privu validate")} to check your configuration`);
-      console.log(`  4. Run ${source_default.cyan("privu doctor")} to verify source mappings`);
+      console.log(`  3. Run ${source_default.cyan("npx @principal-ai/principal-view-cli validate")} to check your configuration`);
+      console.log(`  4. Run ${source_default.cyan("npx @principal-ai/principal-view-cli doctor")} to verify source mappings`);
     } catch (error) {
       console.error(source_default.red("Error:"), error.message);
       process.exit(1);
@@ -15547,6 +15595,212 @@ function createCreateCommand() {
 var import_node_fs10 = require("node:fs");
 var import_node_path11 = require("node:path");
 
+// ../core/dist/codegen/type-generator.js
+var TypeScriptGenerator = class {
+  constructor() {
+    this.language = "typescript";
+  }
+  generate(canvas, options) {
+    const opts = {
+      readonly: options?.style?.readonly ?? false,
+      strictNullChecks: options?.style?.strictNullChecks ?? true,
+      includeDocComments: options?.style?.includeDocComments ?? true,
+      namespace: options?.namespace
+    };
+    const lines = [];
+    lines.push("/**");
+    lines.push(` * Generated types from canvas: ${canvas.pv?.name || "Untitled"}`);
+    lines.push(" *");
+    lines.push(" * DO NOT EDIT MANUALLY - This file is auto-generated");
+    lines.push(" * Generated by @principal-ai/principal-view-core");
+    lines.push(" *");
+    lines.push(` * Canvas: ${canvas.pv?.description || "No description"}`);
+    lines.push(` * Version: ${canvas.pv?.version || "1.0.0"}`);
+    lines.push(" */");
+    lines.push("");
+    if (opts.namespace) {
+      lines.push(`export namespace ${opts.namespace} {`);
+    }
+    if (canvas.nodes) {
+      for (const node of canvas.nodes) {
+        if (node.pv?.events) {
+          lines.push(...this.generateNodeTypes(node.id, node.pv.events, opts));
+          lines.push("");
+        }
+      }
+    }
+    lines.push(...this.generateEventNameUnion(canvas, opts));
+    lines.push("");
+    lines.push(...this.generateEmitterTypes(canvas, opts));
+    if (opts.namespace) {
+      lines.push("}");
+    }
+    const code = lines.join("\n");
+    const filename = this.generateFilename(canvas);
+    return {
+      code,
+      extension: "ts",
+      filename
+    };
+  }
+  generateNodeTypes(nodeId, events, opts) {
+    const lines = [];
+    const typeName = this.nodeIdToTypeName(nodeId);
+    if (opts.includeDocComments) {
+      lines.push(`/**`);
+      lines.push(` * Event types for node: ${nodeId}`);
+      lines.push(` */`);
+    }
+    lines.push(`export namespace ${typeName} {`);
+    for (const [eventName, eventSchema] of Object.entries(events)) {
+      lines.push(...this.generateEventInterface(eventName, eventSchema, opts));
+      lines.push("");
+    }
+    const eventNames = Object.keys(events);
+    const interfaceNames = eventNames.map((name) => this.eventNameToTypeName(name));
+    lines.push("  /**");
+    lines.push(`   * Union of all event types for ${nodeId}`);
+    lines.push("   */");
+    lines.push(`  export type Event = ${interfaceNames.join(" | ")};`);
+    lines.push("");
+    lines.push("  /**");
+    lines.push(`   * Literal union of event names for ${nodeId}`);
+    lines.push("   */");
+    lines.push(`  export type EventName = ${eventNames.map((n) => `'${n}'`).join(" | ")};`);
+    lines.push("}");
+    return lines;
+  }
+  generateEventInterface(eventName, schema2, opts) {
+    const lines = [];
+    const interfaceName = this.eventNameToTypeName(eventName);
+    const readonly = opts.readonly ? "readonly " : "";
+    if (opts.includeDocComments) {
+      lines.push("  /**");
+      lines.push(`   * ${schema2.description}`);
+      lines.push("   */");
+    }
+    lines.push(`  export interface ${interfaceName} {`);
+    lines.push(`    ${readonly}name: '${eventName}';`);
+    lines.push(`    ${readonly}attributes: {`);
+    for (const [fieldName, fieldSchema] of Object.entries(schema2.attributes)) {
+      const optional = !fieldSchema.required && opts.strictNullChecks ? "?" : "";
+      const type2 = this.fieldTypeToTsType(fieldSchema);
+      if (opts.includeDocComments && fieldSchema.description) {
+        lines.push(`      /** ${fieldSchema.description} */`);
+      }
+      lines.push(`      ${readonly}'${fieldName}'${optional}: ${type2};`);
+    }
+    lines.push("    };");
+    lines.push("  }");
+    return lines;
+  }
+  generateEventNameUnion(canvas, opts) {
+    const lines = [];
+    const allEventNames = /* @__PURE__ */ new Set();
+    if (canvas.nodes) {
+      for (const node of canvas.nodes) {
+        if (node.pv?.events) {
+          Object.keys(node.pv.events).forEach((name) => allEventNames.add(name));
+        }
+      }
+    }
+    if (allEventNames.size === 0) {
+      return lines;
+    }
+    if (opts.includeDocComments) {
+      lines.push("/**");
+      lines.push(" * Union of all event names in the canvas");
+      lines.push(" */");
+    }
+    lines.push(`export type AllEventNames = ${Array.from(allEventNames).map((n) => `'${n}'`).join(" | ")};`);
+    return lines;
+  }
+  generateEmitterTypes(canvas, opts) {
+    const lines = [];
+    if (opts.includeDocComments) {
+      lines.push("/**");
+      lines.push(" * Type-safe event emitter for a specific node");
+      lines.push(" *");
+      lines.push(" * @example");
+      lines.push(" * ```typescript");
+      lines.push(" * const emit: NodeEmitter<GraphConverter.EventName, GraphConverter.Event> = ...");
+      lines.push(" * emit('conversion.started', {");
+      lines.push(" *   name: 'conversion.started',");
+      lines.push(" *   attributes: { ... }");
+      lines.push(" * });");
+      lines.push(" * ```");
+      lines.push(" */");
+    }
+    lines.push("export type NodeEmitter<");
+    lines.push("  TEventName extends string,");
+    lines.push("  TEvent extends { name: TEventName; attributes: Record<string, any> }");
+    lines.push("> = (event: TEvent) => void;");
+    lines.push("");
+    if (opts.includeDocComments) {
+      lines.push("/**");
+      lines.push(" * Type-safe event emitter by event name");
+      lines.push(" *");
+      lines.push(" * @example");
+      lines.push(" * ```typescript");
+      lines.push(" * const emit: NodeEmitterByName<GraphConverter.Event> = ...");
+      lines.push(" * emit('conversion.started', {");
+      lines.push(" *   'config.nodeTypes': 2,");
+      lines.push(" *   'config.edgeTypes': 1");
+      lines.push(" * });");
+      lines.push(" * ```");
+      lines.push(" */");
+    }
+    lines.push("export type NodeEmitterByName<");
+    lines.push("  TEvent extends { name: string; attributes: Record<string, any> }");
+    lines.push("> = <TName extends TEvent['name']>(");
+    lines.push("  eventName: TName,");
+    lines.push("  attributes: Extract<TEvent, { name: TName }>['attributes']");
+    lines.push(") => void;");
+    return lines;
+  }
+  nodeIdToTypeName(nodeId) {
+    return nodeId.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+  }
+  eventNameToTypeName(eventName) {
+    return eventName.split(".").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+  }
+  fieldTypeToTsType(fieldSchema) {
+    switch (fieldSchema.type) {
+      case "string":
+        return "string";
+      case "number":
+        return "number";
+      case "boolean":
+        return "boolean";
+      case "array":
+        return "any[]";
+      case "object":
+        return "Record<string, any>";
+      default:
+        return "any";
+    }
+  }
+  generateFilename(canvas) {
+    const name = canvas.pv?.name || "canvas";
+    const kebab = name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+    return `${kebab}.types.ts`;
+  }
+};
+var generatorRegistry = {
+  generators: /* @__PURE__ */ new Map([
+    ["typescript", new TypeScriptGenerator()]
+  ]),
+  register(generator) {
+    this.generators.set(generator.language, generator);
+  },
+  get(language) {
+    return this.generators.get(language);
+  },
+  list() {
+    return Array.from(this.generators.keys());
+  }
+};
+
 // ../core/dist/utils/YamlParser.js
 function parseYaml(content, filename) {
   try {