@principal-ai/subsystems-core 0.29.0

package/dist/rules/config.js

@@ -0,0 +1,382 @@
+"use strict";
+/**
+ * Principal Views Configuration Loader and Validator
+ * Handles loading and validating privu config files
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatConfigErrors = exports.mergeConfigs = exports.getDefaultConfig = exports.validatePrivuConfig = exports.RULE_OPTIONS_SCHEMA = exports.VALID_RULE_IDS = exports.VALID_SEVERITIES = exports.DEFAULT_EXCLUDE_PATTERNS = exports.DEFAULT_INCLUDE_PATTERNS = exports.CONFIG_FILE_NAMES = void 0;
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Valid config file names in resolution order
+ */
+exports.CONFIG_FILE_NAMES = ['.privurc.yaml', '.privurc.yml', '.privurc.json'];
+/**
+ * Default include patterns
+ */
+exports.DEFAULT_INCLUDE_PATTERNS = [
+    '.principal-views/**/*.yaml',
+    '.principal-views/**/*.yml',
+    '.principal-views/**/*.json',
+];
+/**
+ * Default exclude patterns
+ */
+exports.DEFAULT_EXCLUDE_PATTERNS = ['**/node_modules/**', '**/*.test.*'];
+/**
+ * Valid severity values
+ */
+exports.VALID_SEVERITIES = [
+    'off',
+    'warn',
+    'error',
+    0,
+    1,
+    2,
+    false,
+];
+/**
+ * All valid rule IDs
+ */
+exports.VALID_RULE_IDS = [
+    // Schema rules
+    'no-unknown-fields',
+    'required-metadata',
+    'valid-node-types',
+    'valid-edge-types',
+    'valid-color-format',
+    // Reference rules
+    'connection-type-references',
+    'state-transition-references',
+    // Structure rules
+    'minimum-node-sources',
+    'orphaned-node-types',
+    'orphaned-edge-types',
+    'unreachable-states',
+    'dead-end-states',
+    // Pattern rules
+    'valid-action-patterns',
+];
+/**
+ * Rule-specific valid options
+ */
+exports.RULE_OPTIONS_SCHEMA = {
+    'minimum-node-sources': ['minimum', 'excludeNodeTypes'],
+    'dead-end-states': ['terminalStates'],
+    'valid-action-patterns': ['strictMode'],
+};
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validate a VGC configuration object
+ */
+function validatePrivuConfig(config) {
+    const errors = [];
+    if (typeof config !== 'object' || config === null) {
+        return {
+            valid: false,
+            errors: [{ path: '', message: 'Configuration must be an object' }],
+        };
+    }
+    const configObj = config;
+    // Validate known top-level fields
+    const validTopLevelFields = [
+        '$schema',
+        'extends',
+        'root',
+        'library',
+        'include',
+        'exclude',
+        'rules',
+    ];
+    for (const key of Object.keys(configObj)) {
+        if (!validTopLevelFields.includes(key)) {
+            const suggestion = findSimilarString(key, validTopLevelFields);
+            errors.push({
+                path: key,
+                message: `Unknown configuration field "${key}"`,
+                suggestion: suggestion ? `Did you mean "${suggestion}"?` : undefined,
+            });
+        }
+    }
+    // Validate $schema
+    if (configObj.$schema !== undefined && typeof configObj.$schema !== 'string') {
+        errors.push({
+            path: '$schema',
+            message: '$schema must be a string',
+        });
+    }
+    // Validate extends
+    if (configObj.extends !== undefined) {
+        if (typeof configObj.extends !== 'string' &&
+            !(Array.isArray(configObj.extends) && configObj.extends.every((e) => typeof e === 'string'))) {
+            errors.push({
+                path: 'extends',
+                message: 'extends must be a string or array of strings',
+            });
+        }
+    }
+    // Validate root
+    if (configObj.root !== undefined && typeof configObj.root !== 'boolean') {
+        errors.push({
+            path: 'root',
+            message: 'root must be a boolean',
+        });
+    }
+    // Validate library
+    if (configObj.library !== undefined && typeof configObj.library !== 'string') {
+        errors.push({
+            path: 'library',
+            message: 'library must be a string path',
+        });
+    }
+    // Validate include
+    if (configObj.include !== undefined) {
+        if (!Array.isArray(configObj.include) ||
+            !configObj.include.every((p) => typeof p === 'string')) {
+            errors.push({
+                path: 'include',
+                message: 'include must be an array of strings',
+            });
+        }
+    }
+    // Validate exclude
+    if (configObj.exclude !== undefined) {
+        if (!Array.isArray(configObj.exclude) ||
+            !configObj.exclude.every((p) => typeof p === 'string')) {
+            errors.push({
+                path: 'exclude',
+                message: 'exclude must be an array of strings',
+            });
+        }
+    }
+    // Validate rules
+    if (configObj.rules !== undefined) {
+        if (typeof configObj.rules !== 'object' || configObj.rules === null) {
+            errors.push({
+                path: 'rules',
+                message: 'rules must be an object',
+            });
+        }
+        else {
+            const rulesErrors = validateRulesConfig(configObj.rules);
+            errors.push(...rulesErrors);
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return {
+        valid: true,
+        errors: [],
+        config: configObj,
+    };
+}
+exports.validatePrivuConfig = validatePrivuConfig;
+/**
+ * Validate the rules section of a VGC config
+ */
+function validateRulesConfig(rules) {
+    const errors = [];
+    for (const [ruleId, ruleConfig] of Object.entries(rules)) {
+        const path = `rules.${ruleId}`;
+        // Check if rule ID is valid
+        if (!exports.VALID_RULE_IDS.includes(ruleId)) {
+            const suggestion = findSimilarString(ruleId, [...exports.VALID_RULE_IDS]);
+            errors.push({
+                path,
+                message: `Unknown rule ID "${ruleId}"`,
+                suggestion: suggestion ? `Did you mean "${suggestion}"?` : undefined,
+            });
+            continue;
+        }
+        // Handle false (disabled)
+        if (ruleConfig === false) {
+            continue;
+        }
+        // Handle severity shorthand
+        if (typeof ruleConfig === 'string' || typeof ruleConfig === 'number') {
+            if (!isValidSeverity(ruleConfig)) {
+                errors.push({
+                    path,
+                    message: `Invalid severity "${ruleConfig}" for rule "${ruleId}"`,
+                    suggestion: 'Allowed values: "off", "warn", "error", 0, 1, 2',
+                });
+            }
+            continue;
+        }
+        // Handle full config object
+        if (typeof ruleConfig !== 'object' || ruleConfig === null) {
+            errors.push({
+                path,
+                message: `Rule configuration must be a severity string, number, false, or config object`,
+            });
+            continue;
+        }
+        const ruleConfigObj = ruleConfig;
+        // Validate config object fields
+        const validRuleConfigFields = ['severity', 'options'];
+        for (const key of Object.keys(ruleConfigObj)) {
+            if (!validRuleConfigFields.includes(key)) {
+                errors.push({
+                    path: `${path}.${key}`,
+                    message: `Unknown rule config field "${key}"`,
+                    suggestion: `Allowed fields: ${validRuleConfigFields.join(', ')}`,
+                });
+            }
+        }
+        // Validate severity
+        if (ruleConfigObj.severity !== undefined) {
+            if (!isValidSeverity(ruleConfigObj.severity)) {
+                errors.push({
+                    path: `${path}.severity`,
+                    message: `Invalid severity "${ruleConfigObj.severity}"`,
+                    suggestion: 'Allowed values: "off", "warn", "error", 0, 1, 2',
+                });
+            }
+        }
+        // Validate options
+        if (ruleConfigObj.options !== undefined) {
+            if (typeof ruleConfigObj.options !== 'object' || ruleConfigObj.options === null) {
+                errors.push({
+                    path: `${path}.options`,
+                    message: 'options must be an object',
+                });
+            }
+            else {
+                // Validate rule-specific options
+                const validOptions = exports.RULE_OPTIONS_SCHEMA[ruleId];
+                if (validOptions) {
+                    const optionsObj = ruleConfigObj.options;
+                    for (const optionKey of Object.keys(optionsObj)) {
+                        if (!validOptions.includes(optionKey)) {
+                            const suggestion = findSimilarString(optionKey, validOptions);
+                            errors.push({
+                                path: `${path}.options.${optionKey}`,
+                                message: `Unknown option "${optionKey}" for rule "${ruleId}"`,
+                                suggestion: suggestion
+                                    ? `Did you mean "${suggestion}"?`
+                                    : `Allowed options: ${validOptions.join(', ')}`,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Check if a value is a valid severity
+ */
+function isValidSeverity(value) {
+    return exports.VALID_SEVERITIES.includes(value);
+}
+// ============================================================================
+// Default Config
+// ============================================================================
+/**
+ * Get the default VGC configuration
+ */
+function getDefaultConfig() {
+    return {
+        root: false,
+        include: exports.DEFAULT_INCLUDE_PATTERNS,
+        exclude: exports.DEFAULT_EXCLUDE_PATTERNS,
+        rules: {},
+    };
+}
+exports.getDefaultConfig = getDefaultConfig;
+/**
+ * Merge configs with proper precedence (later configs override earlier)
+ */
+function mergeConfigs(...configs) {
+    const result = getDefaultConfig();
+    for (const config of configs) {
+        if (!config)
+            continue;
+        if (config.root !== undefined)
+            result.root = config.root;
+        if (config.library !== undefined)
+            result.library = config.library;
+        if (config.include !== undefined)
+            result.include = config.include;
+        if (config.exclude !== undefined)
+            result.exclude = config.exclude;
+        // Merge rules
+        if (config.rules) {
+            result.rules = { ...result.rules, ...config.rules };
+        }
+    }
+    return result;
+}
+exports.mergeConfigs = mergeConfigs;
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Find a similar string from a list (for "did you mean" suggestions)
+ */
+function findSimilarString(input, candidates) {
+    const inputLower = input.toLowerCase();
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    for (const candidate of candidates) {
+        const candidateLower = candidate.toLowerCase();
+        // Exact substring match
+        if (inputLower.includes(candidateLower) || candidateLower.includes(inputLower)) {
+            return candidate;
+        }
+        // Calculate Levenshtein distance
+        const distance = levenshteinDistance(inputLower, candidateLower);
+        // Accept if distance is small relative to string length
+        if (distance <= 3 && distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Calculate Levenshtein edit distance between two strings
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    // Initialize matrix
+    for (let i = 0; i <= a.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= b.length; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill matrix
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return matrix[a.length][b.length];
+}
+/**
+ * Format config validation errors for display
+ */
+function formatConfigErrors(errors) {
+    const lines = [];
+    for (const error of errors) {
+        lines.push(`  error  ${error.path || '(root)'}: ${error.message}`);
+        if (error.suggestion) {
+            lines.push(`         → ${error.suggestion}`);
+        }
+    }
+    lines.push('');
+    lines.push(`  ✖ ${errors.length} configuration error${errors.length === 1 ? '' : 's'}`);
+    return lines.join('\n');
+}
+exports.formatConfigErrors = formatConfigErrors;
+//# sourceMappingURL=config.js.map

package/dist/rules/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/rules/config.ts"],"names":[],"mappings":"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"}

package/dist/rules/engine.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Graph Rules Engine
+ * Central orchestrator for configuration validation rules
+ */
+import type { GraphConfiguration } from '../types';
+import type { GraphRule, GraphLintResult, LintOptions, RuleCategory, PrivuConfig } from './types';
+/**
+ * Graph Rules Engine - validates GraphConfiguration against registered rules
+ */
+export declare class GraphRulesEngine {
+    private rules;
+    constructor();
+    /**
+     * Register a single rule
+     */
+    registerRule(rule: GraphRule): void;
+    /**
+     * Register multiple rules at once
+     */
+    registerRules(rules: GraphRule[]): void;
+    /**
+     * Unregister a rule by ID
+     */
+    unregisterRule(ruleId: string): boolean;
+    /**
+     * Get a rule by ID
+     */
+    getRule(ruleId: string): GraphRule | undefined;
+    /**
+     * Get all registered rules
+     */
+    getAllRules(): Map<string, GraphRule>;
+    /**
+     * Get rules by category
+     */
+    getRulesByCategory(category: RuleCategory): GraphRule[];
+    /**
+     * Lint a configuration against all enabled rules
+     */
+    lint(configuration: GraphConfiguration, options?: LintOptions): Promise<GraphLintResult>;
+    /**
+     * Lint a configuration with VGC config file settings applied
+     */
+    lintWithConfig(configuration: GraphConfiguration, privuConfig: PrivuConfig, options?: Omit<LintOptions, 'ruleOptions' | 'severityOverrides'>): Promise<GraphLintResult>;
+    /**
+     * Check if a rule should run based on options
+     */
+    private shouldRunRule;
+    /**
+     * Get the effective severity for a rule
+     */
+    private getEffectiveSeverity;
+    /**
+     * Build the context object for a rule
+     */
+    private buildRuleContext;
+    /**
+     * Build the final lint result from violations
+     */
+    private buildResult;
+    /**
+     * Parse VGC config rules into lint options
+     */
+    private parsePrivuConfigRules;
+}
+/**
+ * Create a new rules engine with optional initial rules
+ */
+export declare function createRulesEngine(rules?: GraphRule[]): GraphRulesEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/rules/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/rules/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EACV,SAAS,EAGT,eAAe,EACf,WAAW,EAGX,YAAY,EACZ,WAAW,EAGZ,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAqC;;IAMlD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAOnC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAMvC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAIrC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE;IAIvD;;OAEG;IACG,IAAI,CAAC,aAAa,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IA0I9F;;OAEG;IACG,cAAc,CAClB,aAAa,EAAE,kBAAkB,EACjC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,mBAAmB,CAAC,GAC/D,OAAO,CAAC,eAAe,CAAC;IA6C3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgDnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkD9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAMvE"}