@principal-ai/principal-view-cli 0.3.1 → 0.3.3

package/dist/commands/lint.js

@@ -1,506 +0,0 @@
-/**
- * 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, createNarrativeValidator, } from '@principal-ai/principal-view-core';
-// ============================================================================
-// Config File Loading
-// ============================================================================
-/**
- * Config file names in resolution order
- */
-const CONFIG_FILE_NAMES = ['.privurc.yaml', '.privurc.yml', '.privurc.json'];
-/**
- * Find and load privurc config file
- */
-function findConfig(startDir) {
-    let currentDir = resolve(startDir);
-    // eslint-disable-next-line no-constant-condition
-    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;
-    }
-}
-/**
- * Load a narrative template file
- */
-function loadNarrativeTemplate(filePath) {
-    if (!existsSync(filePath)) {
-        return null;
-    }
-    try {
-        const raw = readFileSync(filePath, 'utf8');
-        const narrative = JSON.parse(raw);
-        return { narrative, raw };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Load a canvas file for narrative validation
- */
-function loadCanvas(filePath) {
-    if (!existsSync(filePath)) {
-        return null;
-    }
-    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;
-    }
-}
-/**
- * Determine file type
- */
-function getFileType(filePath) {
-    const name = basename(filePath).toLowerCase();
-    if (name.endsWith('.narrative.json')) {
-        return 'narrative';
-    }
-    if (name.endsWith('.canvas') || name.endsWith('.otel.canvas')) {
-        return 'canvas';
-    }
-    return 'config';
-}
-// ============================================================================
-// 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,
-        },
-    };
-}
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Count violations by rule ID
- */
-function countByRule(violations) {
-    const counts = {};
-    for (const v of violations) {
-        counts[v.ruleId] = (counts[v.ruleId] || 0) + 1;
-    }
-    return counts;
-}
-// ============================================================================
-// 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 privurc config
-            let privuConfig = getDefaultConfig();
-            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);
-            }
-            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);
-                }
-            }
-            // 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, config files, and execution artifacts
-            // INCLUDE both canvas files and narrative templates for linting
-            const configFiles = matchedFiles.filter((f) => {
-                const name = basename(f).toLowerCase();
-                const isLibraryFile = name.startsWith('library.');
-                const isConfigFile = name.startsWith('.privurc');
-                const isExecutionArtifact = f.includes('__executions__/');
-                return !isLibraryFile && !isConfigFile && !isExecutionArtifact;
-            });
-            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 validators
-            const engine = createDefaultRulesEngine();
-            const narrativeValidator = createNarrativeValidator();
-            // Lint each file
-            const results = new Map();
-            for (const filePath of configFiles) {
-                const absolutePath = resolve(cwd, filePath);
-                const relativePath = relative(cwd, absolutePath);
-                const fileType = getFileType(absolutePath);
-                if (fileType === 'narrative') {
-                    // Validate narrative template
-                    const loaded = loadNarrativeTemplate(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 narrative 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;
-                    }
-                    // Load the referenced canvas if it exists
-                    const canvasPath = loaded.narrative.canvas
-                        ? resolve(dirname(absolutePath), loaded.narrative.canvas)
-                        : undefined;
-                    const canvas = canvasPath ? loadCanvas(canvasPath) : undefined;
-                    // Run narrative validation
-                    const narrativeResult = await narrativeValidator.validate({
-                        narrative: loaded.narrative,
-                        narrativePath: relativePath,
-                        canvas: canvas ?? undefined,
-                        canvasPath: canvasPath ? relative(cwd, canvasPath) : undefined,
-                        basePath: dirname(absolutePath),
-                        rawContent: loaded.raw,
-                    });
-                    // Convert narrative violations to graph violations format
-                    const violations = narrativeResult.violations.map((v) => ({
-                        ruleId: v.ruleId,
-                        severity: v.severity,
-                        file: v.file,
-                        line: v.line,
-                        path: v.path,
-                        message: v.message,
-                        impact: v.impact,
-                        suggestion: v.suggestion,
-                        fixable: v.fixable,
-                    }));
-                    results.set(relativePath, {
-                        violations,
-                        errorCount: narrativeResult.errorCount,
-                        warningCount: narrativeResult.warningCount,
-                        fixableCount: narrativeResult.fixableCount,
-                        byCategory: { schema: 0, reference: 0, structure: 0, pattern: 0, library: 0 }, // Could categorize narrative rules
-                        byRule: countByRule(violations),
-                    });
-                }
-                else {
-                    // Validate canvas/graph configuration
-                    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

@@ -1,6 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,80 +0,0 @@
-/**
- * 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: npx @principal-ai/principal-view-cli 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/narrative/eval.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createEvalCommand(): Command;
-//# sourceMappingURL=eval.d.ts.map

package/dist/commands/narrative/eval.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/commands/narrative/eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,iBAAiB,IAAI,OAAO,CA2E3C"}

package/dist/commands/narrative/eval.js

@@ -1,76 +0,0 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { readFile } from 'node:fs/promises';
-import { evaluateExpression } from '@principal-ai/principal-view-core';
-import { resolvePath, formatValue } from './utils.js';
-export function createEvalCommand() {
-    const command = new Command('eval');
-    command
-        .description('Evaluate template expression with context')
-        .argument('<expression>', 'Template expression to evaluate (e.g., {count > 5 ? \'many\' : \'few\'})')
-        .argument('[context]', 'Optional path to JSON context file')
-        .option('--context <json>', 'Inline JSON context as string')
-        .option('--json', 'Output result as JSON')
-        .action(async (expression, contextPath, options) => {
-        try {
-            let context = {};
-            // Load context from file or inline option
-            if (contextPath) {
-                const content = await readFile(resolvePath(contextPath), 'utf-8');
-                context = JSON.parse(content);
-            }
-            else if (options.context) {
-                context = JSON.parse(options.context);
-            }
-            // Remove curly braces if user included them
-            let cleanExpression = expression.trim();
-            if (cleanExpression.startsWith('{') && cleanExpression.endsWith('}')) {
-                cleanExpression = cleanExpression.slice(1, -1).trim();
-            }
-            // Evaluate expression
-            const result = evaluateExpression(cleanExpression, context);
-            if (options.json) {
-                const output = {
-                    expression: cleanExpression,
-                    context,
-                    result,
-                    type: typeof result,
-                };
-                console.log(JSON.stringify(output, null, 2));
-            }
-            else {
-                console.log(chalk.bold('\nExpression:'), chalk.cyan(`{${cleanExpression}}`));
-                if (Object.keys(context).length > 0) {
-                    console.log(chalk.bold('\nContext:'));
-                    for (const [key, value] of Object.entries(context)) {
-                        console.log(chalk.gray('  •'), `${key} = ${formatValue(value)}`);
-                    }
-                }
-                else {
-                    console.log(chalk.yellow('\nNo context provided'));
-                }
-                console.log(chalk.bold('\nResult:'), formatValue(result));
-                console.log(chalk.gray('Type:'), typeof result);
-                console.log();
-            }
-        }
-        catch (error) {
-            const errorMessage = error.message;
-            if (options.json) {
-                const output = {
-                    error: true,
-                    message: errorMessage,
-                    expression: expression,
-                };
-                console.log(JSON.stringify(output, null, 2));
-            }
-            else {
-                console.error(chalk.red('\nEvaluation Error:'), errorMessage);
-                console.error(chalk.gray('\nExpression:'), expression);
-                console.log();
-            }
-            process.exit(1);
-        }
-    });
-    return command;
-}

package/dist/commands/narrative/index.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createNarrativeCommand(): Command;
-//# sourceMappingURL=index.d.ts.map

package/dist/commands/narrative/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/narrative/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,sBAAsB,IAAI,OAAO,CAahD"}