@principal-ai/principal-view-cli 0.1.13

package/dist/commands/lint.js

@@ -0,0 +1,375 @@
+/**
+ * Lint command - Lint graph configuration files using the rules engine
+ */
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, relative, dirname, basename } from 'node:path';
+import chalk from 'chalk';
+import { globby } from 'globby';
+import yaml from 'js-yaml';
+import { createDefaultRulesEngine, validatePrivuConfig, mergeConfigs, getDefaultConfig, } from '@principal-ai/principal-view-core';
+// ============================================================================
+// Config File Loading
+// ============================================================================
+/**
+ * Config file names in resolution order
+ */
+const CONFIG_FILE_NAMES = [
+    '.principal-viewsrc.json',
+    '.principal-viewsrc.yaml',
+    '.principal-viewsrc.yml',
+    'privu.config.json',
+    'privu.config.yaml',
+    'privu.config.yml',
+];
+/**
+ * Find and load VGC config file
+ */
+function findConfig(startDir) {
+    let currentDir = resolve(startDir);
+    while (true) {
+        // Check for config files
+        for (const fileName of CONFIG_FILE_NAMES) {
+            const configPath = resolve(currentDir, fileName);
+            if (existsSync(configPath)) {
+                const config = loadConfigFile(configPath);
+                if (config) {
+                    return { config, path: configPath };
+                }
+            }
+        }
+        // Check package.json for "privu" key
+        const packageJsonPath = resolve(currentDir, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+                if (packageJson.privu && typeof packageJson.privu === 'object') {
+                    return { config: packageJson.privu, path: packageJsonPath };
+                }
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        // Check for root flag or filesystem root
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // Reached filesystem root
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Load a config file (JSON or YAML)
+ */
+function loadConfigFile(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf8');
+        const ext = filePath.toLowerCase();
+        if (ext.endsWith('.json')) {
+            return JSON.parse(content);
+        }
+        else {
+            return yaml.load(content);
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load a component library file
+ */
+function loadLibrary(libraryPath) {
+    if (!existsSync(libraryPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(libraryPath, 'utf8');
+        const ext = libraryPath.toLowerCase();
+        if (ext.endsWith('.json')) {
+            return JSON.parse(content);
+        }
+        else {
+            return yaml.load(content);
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load a graph configuration file (YAML or JSON)
+ */
+function loadGraphConfig(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const ext = filePath.toLowerCase();
+        let config;
+        if (ext.endsWith('.json')) {
+            config = JSON.parse(raw);
+        }
+        else {
+            config = yaml.load(raw);
+        }
+        return { config, raw };
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Output Formatting
+// ============================================================================
+/**
+ * Format violations for pretty console output
+ */
+function formatPrettyOutput(results, quiet) {
+    const lines = [];
+    let totalErrors = 0;
+    let totalWarnings = 0;
+    let totalFixable = 0;
+    for (const [filePath, result] of results) {
+        totalErrors += result.errorCount;
+        totalWarnings += result.warningCount;
+        totalFixable += result.fixableCount;
+        if (result.violations.length === 0) {
+            if (!quiet) {
+                lines.push(chalk.green(`✓ ${filePath}`));
+            }
+            continue;
+        }
+        lines.push('');
+        lines.push(chalk.cyan(filePath));
+        lines.push('');
+        for (const violation of result.violations) {
+            const severityColor = violation.severity === 'error' ? chalk.red : chalk.yellow;
+            const severityLabel = violation.severity === 'error' ? 'error' : 'warn ';
+            // Format: "  error  rule-id  message"
+            const ruleId = chalk.dim(violation.ruleId.padEnd(30));
+            lines.push(`  ${severityColor(severityLabel)}  ${ruleId}  ${violation.message}`);
+            if (violation.suggestion) {
+                lines.push(chalk.dim(`         ${''.padEnd(30)}  → ${violation.suggestion}`));
+            }
+        }
+    }
+    // Summary
+    lines.push('');
+    if (totalErrors === 0 && totalWarnings === 0) {
+        lines.push(chalk.green(`✓ All files passed linting`));
+    }
+    else {
+        const parts = [];
+        if (totalErrors > 0) {
+            parts.push(chalk.red(`${totalErrors} error${totalErrors === 1 ? '' : 's'}`));
+        }
+        if (totalWarnings > 0) {
+            parts.push(chalk.yellow(`${totalWarnings} warning${totalWarnings === 1 ? '' : 's'}`));
+        }
+        lines.push(`✖ ${parts.join(', ')}`);
+        if (totalFixable > 0) {
+            lines.push(chalk.dim(`  ${totalFixable} fixable with --fix (coming soon)`));
+        }
+    }
+    return {
+        output: lines.join('\n'),
+        hasErrors: totalErrors > 0,
+    };
+}
+/**
+ * Format violations for JSON output
+ */
+function formatJsonOutput(results) {
+    const files = [];
+    let totalErrors = 0;
+    let totalWarnings = 0;
+    let totalFixable = 0;
+    for (const [filePath, result] of results) {
+        totalErrors += result.errorCount;
+        totalWarnings += result.warningCount;
+        totalFixable += result.fixableCount;
+        files.push({
+            file: filePath,
+            errorCount: result.errorCount,
+            warningCount: result.warningCount,
+            fixableCount: result.fixableCount,
+            violations: result.violations,
+        });
+    }
+    return {
+        files,
+        summary: {
+            totalFiles: files.length,
+            totalErrors,
+            totalWarnings,
+            totalFixable,
+        },
+    };
+}
+// ============================================================================
+// Command Implementation
+// ============================================================================
+export function createLintCommand() {
+    const command = new Command('lint');
+    command
+        .description('Lint graph configuration files')
+        .argument('[files...]', 'Files or glob patterns to lint (defaults to .principal-views/**/*.yaml)')
+        .option('-c, --config <path>', 'Path to config file')
+        .option('--library <path>', 'Path to component library file')
+        .option('-q, --quiet', 'Only output errors')
+        .option('--json', 'Output results as JSON')
+        .option('--rule <rules...>', 'Only run specific rules')
+        .option('--ignore-rule <rules...>', 'Skip specific rules')
+        .action(async (files, options) => {
+        try {
+            const cwd = process.cwd();
+            // Load VGC config
+            let privuConfig = getDefaultConfig();
+            let configPath;
+            if (options.config) {
+                // Use specified config file
+                const loadedConfig = loadConfigFile(resolve(cwd, options.config));
+                if (!loadedConfig) {
+                    console.error(chalk.red(`Error: Could not load config file: ${options.config}`));
+                    process.exit(1);
+                }
+                // Validate config
+                const validation = validatePrivuConfig(loadedConfig);
+                if (!validation.valid) {
+                    console.error(chalk.red('Configuration Error:'), options.config);
+                    for (const error of validation.errors) {
+                        console.error(chalk.red(`  ${error.path}: ${error.message}`));
+                        if (error.suggestion) {
+                            console.error(chalk.dim(`    → ${error.suggestion}`));
+                        }
+                    }
+                    process.exit(1);
+                }
+                privuConfig = mergeConfigs(privuConfig, loadedConfig);
+                configPath = resolve(cwd, options.config);
+            }
+            else {
+                // Search for config file
+                const found = findConfig(cwd);
+                if (found) {
+                    const validation = validatePrivuConfig(found.config);
+                    if (!validation.valid) {
+                        console.error(chalk.red('Configuration Error:'), found.path);
+                        for (const error of validation.errors) {
+                            console.error(chalk.red(`  ${error.path}: ${error.message}`));
+                            if (error.suggestion) {
+                                console.error(chalk.dim(`    → ${error.suggestion}`));
+                            }
+                        }
+                        process.exit(1);
+                    }
+                    privuConfig = mergeConfigs(privuConfig, found.config);
+                    configPath = found.path;
+                }
+            }
+            // Determine files to lint
+            let patterns;
+            if (files.length > 0) {
+                patterns = files;
+            }
+            else if (privuConfig.include && privuConfig.include.length > 0) {
+                patterns = privuConfig.include;
+            }
+            else {
+                patterns = ['.principal-views/**/*.yaml', '.principal-views/**/*.yml', '.principal-views/**/*.json'];
+            }
+            // Find matching files
+            const matchedFiles = await globby(patterns, {
+                ignore: privuConfig.exclude || ['**/node_modules/**'],
+                expandDirectories: false,
+            });
+            // Filter out library files and config files
+            const configFiles = matchedFiles.filter((f) => {
+                const name = basename(f).toLowerCase();
+                return !name.startsWith('library.') && !name.startsWith('.principal-viewsrc') && !name.startsWith('privu.config');
+            });
+            if (configFiles.length === 0) {
+                if (options.json) {
+                    console.log(JSON.stringify({ files: [], summary: { totalFiles: 0, totalErrors: 0, totalWarnings: 0, totalFixable: 0 } }));
+                }
+                else {
+                    console.log(chalk.yellow('No configuration files found matching the specified patterns.'));
+                    console.log(chalk.dim(`Patterns searched: ${patterns.join(', ')}`));
+                }
+                return;
+            }
+            // Load library if specified
+            let library;
+            const libraryPath = options.library || privuConfig.library;
+            if (libraryPath) {
+                const resolvedLibraryPath = resolve(cwd, libraryPath);
+                library = loadLibrary(resolvedLibraryPath) ?? undefined;
+                if (!library && !options.quiet) {
+                    console.log(chalk.yellow(`Warning: Could not load library from ${libraryPath}`));
+                }
+            }
+            // Create rules engine
+            const engine = createDefaultRulesEngine();
+            // Lint each file
+            const results = new Map();
+            for (const filePath of configFiles) {
+                const absolutePath = resolve(cwd, filePath);
+                const relativePath = relative(cwd, absolutePath);
+                const loaded = loadGraphConfig(absolutePath);
+                if (!loaded) {
+                    // File couldn't be loaded - report as error
+                    results.set(relativePath, {
+                        violations: [{
+                                ruleId: 'parse-error',
+                                severity: 'error',
+                                file: relativePath,
+                                message: `Could not parse file: ${filePath}`,
+                                impact: 'File cannot be validated',
+                                fixable: false,
+                            }],
+                        errorCount: 1,
+                        warningCount: 0,
+                        fixableCount: 0,
+                        byCategory: { schema: 1, reference: 0, structure: 0, pattern: 0, library: 0 },
+                        byRule: { 'parse-error': 1 },
+                    });
+                    continue;
+                }
+                // Run linting
+                const result = await engine.lintWithConfig(loaded.config, privuConfig, {
+                    library,
+                    configPath: relativePath,
+                    rawContent: loaded.raw,
+                    enabledRules: options.rule,
+                    disabledRules: options.ignoreRule,
+                });
+                results.set(relativePath, result);
+            }
+            // Output results
+            if (options.json) {
+                console.log(JSON.stringify(formatJsonOutput(results), null, 2));
+            }
+            else {
+                const { output, hasErrors } = formatPrettyOutput(results, options.quiet);
+                console.log(output);
+                if (hasErrors) {
+                    process.exit(1);
+                }
+            }
+        }
+        catch (error) {
+            if (options.json) {
+                console.log(JSON.stringify({ error: error.message }));
+            }
+            else {
+                console.error(chalk.red('Error:'), error.message);
+            }
+            process.exit(1);
+        }
+    });
+    return command;
+}

package/dist/commands/list.d.ts

@@ -0,0 +1,6 @@
+/**
+ * List command - List all .canvas files in a project
+ */
+import { Command } from 'commander';
+export declare function createListCommand(): Command;
+//# sourceMappingURL=list.d.ts.map

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

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

package/dist/commands/list.js

@@ -0,0 +1,80 @@
+/**
+ * List command - List all .canvas files in a project
+ */
+import { Command } from 'commander';
+import { readFileSync, statSync } from 'node:fs';
+import { resolve, relative } from 'node:path';
+import chalk from 'chalk';
+import { globby } from 'globby';
+function getCanvasInfo(filePath) {
+    try {
+        const absolutePath = resolve(filePath);
+        const content = readFileSync(absolutePath, 'utf8');
+        const canvas = JSON.parse(content);
+        const stats = statSync(absolutePath);
+        return {
+            file: relative(process.cwd(), absolutePath),
+            name: canvas.pv?.name || 'Untitled',
+            version: canvas.pv?.version,
+            nodeCount: Array.isArray(canvas.nodes) ? canvas.nodes.length : 0,
+            edgeCount: Array.isArray(canvas.edges) ? canvas.edges.length : 0,
+            modified: stats.mtime,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function createListCommand() {
+    const command = new Command('list');
+    command
+        .alias('ls')
+        .description('List all .canvas files in the project')
+        .option('-a, --all', 'Search all directories (not just .principal-views)')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            const patterns = options.all
+                ? ['**/*.canvas', '!node_modules/**']
+                : ['.principal-views/*.canvas'];
+            const files = await globby(patterns, {
+                expandDirectories: false,
+            });
+            if (files.length === 0) {
+                if (options.json) {
+                    console.log(JSON.stringify({ files: [] }));
+                }
+                else {
+                    console.log(chalk.yellow('No .canvas files found.'));
+                    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'));
+                }
+                return;
+            }
+            const canvasInfos = files
+                .map(getCanvasInfo)
+                .filter((info) => info !== null)
+                .sort((a, b) => b.modified.getTime() - a.modified.getTime());
+            if (options.json) {
+                console.log(JSON.stringify({ files: canvasInfos }, null, 2));
+            }
+            else {
+                console.log(chalk.bold(`\nFound ${canvasInfos.length} canvas file(s):\n`));
+                for (const info of canvasInfos) {
+                    const version = info.version ? chalk.dim(` v${info.version}`) : '';
+                    console.log(`  ${chalk.cyan(info.file)}`);
+                    console.log(`    ${chalk.bold(info.name)}${version}`);
+                    console.log(chalk.dim(`    ${info.nodeCount} nodes, ${info.edgeCount} edges`));
+                    console.log('');
+                }
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), error.message);
+            process.exit(1);
+        }
+    });
+    return command;
+}

package/dist/commands/schema.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Schema command - Display documentation about the canvas format
+ */
+import { Command } from 'commander';
+export declare function createSchemaCommand(): Command;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2TpC,wBAAgB,mBAAmB,IAAI,OAAO,CA0B7C"}