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

package/dist/commands/create.js

@@ -38,8 +38,8 @@ export function createCreateCommand() {
             console.log(chalk.bold('Next steps:'));
             console.log(`  1. Open ${chalk.cyan(`.principal-views/${options.name}.canvas`)} in your editor`);
             console.log(`  2. Add nodes and edges to define your architecture`);
-            console.log(`  3. Run ${chalk.cyan('privu validate')} to check your configuration`);
-            console.log(`  4. Run ${chalk.cyan('privu doctor')} to verify source mappings`);
+            console.log(`  3. Run ${chalk.cyan('npx @principal-ai/principal-view-cli validate')} to check your configuration`);
+            console.log(`  4. Run ${chalk.cyan('npx @principal-ai/principal-view-cli doctor')} to verify source mappings`);
         }
         catch (error) {
             console.error(chalk.red('Error:'), error.message);

package/dist/commands/doctor.js

@@ -149,7 +149,7 @@ export function createDoctorCommand() {
                 }
                 else {
                     console.log(chalk.yellow('No .principal-views directory found.'));
-                    console.log(chalk.dim('Run "privu init" to create a configuration.'));
+                    console.log(chalk.dim('Run "npx @principal-ai/principal-view-cli init" to create a configuration.'));
                 }
                 return;
             }

package/dist/commands/hooks.d.ts

@@ -2,7 +2,7 @@
  * Hooks command - Manage husky pre-commit hooks for Principal View
  *
  * This command installs/removes pre-commit hooks into a target project
- * that will run `privu doctor` and `privu validate` before each commit.
+ * that will run `npx @principal-ai/principal-view-cli doctor` and `npx @principal-ai/principal-view-cli validate` before each commit.
  */
 import { Command } from 'commander';
 export declare function createHooksCommand(): Command;

package/dist/commands/hooks.js

@@ -2,7 +2,7 @@
  * Hooks command - Manage husky pre-commit hooks for Principal View
  *
  * This command installs/removes pre-commit hooks into a target project
- * that will run `privu doctor` and `privu validate` before each commit.
+ * that will run `npx @principal-ai/principal-view-cli doctor` and `npx @principal-ai/principal-view-cli validate` before each commit.
  */
 import { Command } from 'commander';
 import { existsSync, readFileSync, writeFileSync, unlinkSync, chmodSync } from 'node:fs';
@@ -18,17 +18,17 @@ const 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 "❌ 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 "❌ 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
 }
@@ -164,7 +164,7 @@ function removeVVHook(repoPath) {
         const line = lines[i];
         // Check if this line is part of the PV block
         if (line &&
-            (line.includes('privu ') ||
+            (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) ||
@@ -222,12 +222,12 @@ export function createHooksCommand() {
             if (!isHuskyInstalled(repoPath)) {
                 if (options.check) {
                     console.log(chalk.red('❌ 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(chalk.red('❌ 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) {
@@ -237,7 +237,7 @@ export function createHooksCommand() {
                 else {
                     console.log(chalk.red('❌ 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);
                 }
             }
@@ -259,7 +259,7 @@ export function createHooksCommand() {
                     addVVHook(repoPath);
                     console.log(chalk.green('✅ Added Principal View checks to pre-commit hook'));
                     console.log('\nPre-commit hook will now:');
-                    console.log('  • Run privu doctor to check for stale configurations');
+                    console.log('  • Run npx @principal-ai/principal-view-cli doctor to check for stale configurations');
                     console.log('  • Validate all .canvas files');
                 }
             }

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+GpC,wBAAgB,iBAAiB,IAAI,OAAO,CA6L3C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+GpC,wBAAgB,iBAAiB,IAAI,OAAO,CA4L3C"}

package/dist/commands/init.js

@@ -180,8 +180,7 @@ edgeComponents: {}
                             if (existsSync(preCommitFile)) {
                                 // Check if our hook is already in the file
                                 const existingContent = readFileSync(preCommitFile, 'utf8');
-                                if (existingContent.includes('principal-view-cli lint') ||
-                                    existingContent.includes('privu lint')) {
+                                if (existingContent.includes('principal-view-cli lint')) {
                                     console.log(chalk.yellow(`Husky pre-commit hook already includes principal view linting`));
                                 }
                                 else {
@@ -252,16 +251,16 @@ edgeComponents: {}
             console.log(chalk.bold('Next steps:'));
             console.log(`  1. Define components in ${chalk.cyan('.principal-views/library.yaml')}`);
             console.log(`  2. Build your graph in ${chalk.cyan(`.principal-views/${options.name}.canvas`)}`);
-            console.log(`  3. Run ${chalk.cyan('privu lint')} to validate your configuration`);
+            console.log(`  3. Run ${chalk.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(chalk.bold('Commands:'));
-            console.log(`  • ${chalk.cyan('privu lint')} - Lint configuration files`);
-            console.log(`  • ${chalk.cyan('privu lint --json')} - Output lint results as JSON`);
-            console.log(`  • ${chalk.cyan('privu validate')} - Validate canvas files`);
-            console.log(`  • ${chalk.cyan('privu doctor')} - Check project setup`);
+            console.log(`  • ${chalk.cyan('npx @principal-ai/principal-view-cli lint')} - Lint configuration files`);
+            console.log(`  • ${chalk.cyan('npx @principal-ai/principal-view-cli lint --json')} - Output lint results as JSON`);
+            console.log(`  • ${chalk.cyan('npx @principal-ai/principal-view-cli validate')} - Validate canvas files`);
+            console.log(`  • ${chalk.cyan('npx @principal-ai/principal-view-cli doctor')} - Check project setup`);
         }
         catch (error) {
             console.error(chalk.red('Error:'), error.message);

package/dist/commands/list.js

@@ -49,7 +49,7 @@ export function createListCommand() {
                     if (!options.all) {
                         console.log(chalk.dim('Run with --all to search all directories'));
                     }
-                    console.log(chalk.dim('\nTo create a new canvas, run: privu init'));
+                    console.log(chalk.dim('\nTo create a new canvas, run: npx @principal-ai/principal-view-cli init'));
                 }
                 return;
             }

package/dist/commands/schema.js

@@ -24,7 +24,7 @@ ${chalk.dim('│')}   }                                             ${chalk.dim(
 ${chalk.dim('│')} }                                               ${chalk.dim('│')}
 ${chalk.dim('└─────────────────────────────────────────────────┘')}
 
-Run ${chalk.cyan('privu schema <section>')} for details on:
+Run ${chalk.cyan('npx @principal-ai/principal-view-cli schema <section>')} for details on:
   ${chalk.yellow('nodes')}      Node types and properties
   ${chalk.yellow('edges')}      Edge properties and types
   ${chalk.yellow('vv')}         Principal View extension fields
@@ -309,8 +309,8 @@ ${chalk.dim('─'.repeat(50))}
   }
 }
 
-${chalk.bold('Run validation:')} ${chalk.cyan('privu validate <file>')}
-${chalk.bold('Initialize project:')} ${chalk.cyan('privu init')}
+${chalk.bold('Run validation:')} ${chalk.cyan('npx @principal-ai/principal-view-cli validate <file>')}
+${chalk.bold('Initialize project:')} ${chalk.cyan('npx @principal-ai/principal-view-cli init')}
 `,
 };
 export function createSchemaCommand() {

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;AAgjCpC,wBAAgB,qBAAqB,IAAI,OAAO,CAsH/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;AA4nCpC,wBAAgB,qBAAqB,IAAI,OAAO,CAsH/C"}

package/dist/commands/validate.js

@@ -229,6 +229,7 @@ const ALLOWED_CANVAS_FIELDS = {
         'name',
         'description',
         'otel',
+        'events',
         'shape',
         'icon',
         'fill',
@@ -345,6 +346,51 @@ function findSimilarField(field, allowedFields) {
     }
     return null;
 }
+/**
+ * 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 schemas (pv.events with validation)
+ * 3. Canvas scope/audit config (OTEL log routing)
+ * 4. Resource matching for OTEL logs
+ */
+function hasOtelFeatures(canvas) {
+    if (!canvas || typeof canvas !== 'object') {
+        return false;
+    }
+    const c = canvas;
+    // Check for canvas-level scope or audit config
+    if (c.pv && typeof c.pv === 'object') {
+        const pv = c.pv;
+        if (pv.scope !== undefined || pv.audit !== undefined) {
+            return true;
+        }
+    }
+    // Check nodes for OTEL features
+    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;
+                    // Check for pv.otel extension
+                    if (nodePv.otel !== undefined) {
+                        return true;
+                    }
+                    // Check for event schemas (pv.events)
+                    if (nodePv.events !== undefined) {
+                        return true;
+                    }
+                    // Check for resourceMatch (OTEL log routing)
+                    if (nodePv.resourceMatch !== undefined) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    return false;
+}
 /**
  * Validate an ExtendedCanvas object with strict validation
  *
@@ -791,6 +837,23 @@ function validateCanvas(canvas, filePath, library) {
             }
         });
     }
+    // Validate OTEL canvas naming convention
+    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;
 }
 /**
@@ -848,7 +911,7 @@ export function createValidateCommand() {
                 else {
                     console.log(chalk.yellow('No .canvas files found matching the specified patterns.'));
                     console.log(chalk.dim(`Patterns searched: ${patterns.join(', ')}`));
-                    console.log(chalk.dim('\nTo create a new .principal-views folder, run: privu init'));
+                    console.log(chalk.dim('\nTo create a new .principal-views folder, run: npx @principal-ai/principal-view-cli init'));
                 }
                 return;
             }