@principal-ai/subsystems-core 0.29.0

package/README.md

@@ -0,0 +1,124 @@
+# @principal-ai/visual-validation-core
+
+Core logic library for the Visual Validation Framework - **framework-agnostic**.
+
+## Features
+
+- 📋 TypeScript type definitions for graph configurations and events
+- ⚙️ Event processing engine
+- ✅ Validation engine with rule checking
+- 📊 Graph state management
+- 🧪 Test instrumentation helpers
+
+**Zero UI dependencies** - can be used in Node.js, tests, or any JavaScript environment.
+
+## Installation
+
+```bash
+npm install @principal-ai/visual-validation-core
+# or
+bun add @principal-ai/visual-validation-core
+```
+
+## Usage
+
+### Define Configuration
+
+```typescript
+import type { GraphConfiguration } from '@principal-ai/visual-validation-core';
+
+const config: GraphConfiguration = {
+  metadata: {
+    name: 'Control Tower',
+    version: '1.0.0',
+  },
+  nodeTypes: {
+    user: {
+      shape: 'circle',
+      color: '#4CAF50',
+      dataSchema: {
+        userId: { type: 'string', required: true },
+      },
+      states: {
+        online: { color: '#4CAF50' },
+        offline: { color: '#9E9E9E' },
+      },
+    },
+    server: {
+      shape: 'hexagon',
+      color: '#9C27B0',
+      dataSchema: {
+        uptime: { type: 'number' },
+      },
+    },
+  },
+  edgeTypes: {
+    connection: {
+      style: 'solid',
+      directed: true,
+    },
+  },
+  allowedConnections: [{ from: 'user', to: 'server', via: 'connection' }],
+  validation: {
+    stateTransitions: {
+      user: [
+        { from: 'offline', to: ['online'] },
+        { from: 'online', to: ['offline'] },
+      ],
+    },
+  },
+};
+```
+
+### Process Events
+
+```typescript
+import { EventProcessor } from '@principal-ai/visual-validation-core';
+
+const processor = new EventProcessor(config);
+
+// Process events
+const result = processor.processEvent({
+  id: 'evt-1',
+  type: 'user_connected',
+  timestamp: Date.now(),
+  category: 'node',
+  operation: 'create',
+  payload: {
+    operation: 'create',
+    nodeId: 'user-1',
+    nodeType: 'user',
+    data: { userId: 'alice' },
+  },
+  expected: true,
+});
+
+console.log('Valid:', result.validation.valid);
+console.log('Violations:', result.validation.violations);
+```
+
+### Test Instrumentation
+
+```typescript
+import { GraphInstrumentationHelper } from '@principal-ai/visual-validation-core';
+
+describe('My system test', () => {
+  it('should handle user connections', () => {
+    const helper = new GraphInstrumentationHelper(config);
+
+    // Emit events from your test
+    helper.emitNodeCreated('server-1', 'server', { uptime: 0 });
+    helper.emitNodeCreated('user-alice', 'user', { userId: 'alice' });
+    helper.emitEdgeCreated('conn-1', 'connection', 'user-alice', 'server-1');
+    helper.emitStateChange('user-alice', 'online');
+  });
+});
+```
+
+## API
+
+See the main [README](../../README.md) for full documentation.
+
+## License
+
+MIT

package/dist/ConfigurationLoader.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Configuration loader for managing multiple graph configurations
+ *
+ * Supports loading configurations from the .principal-views/ folder using the adapter pattern
+ * for environment-agnostic file operations.
+ */
+import type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
+import type { PathBasedGraphConfiguration } from './types/path-based-config';
+/**
+ * Represents a single configuration file
+ */
+export interface ConfigurationFile {
+    /** Configuration name (filename without extension) */
+    name: string;
+    /** Full path to the configuration file */
+    path: string;
+    /** Parsed configuration data */
+    config: PathBasedGraphConfiguration;
+}
+/**
+ * Result of loading all configurations
+ */
+export interface ConfigurationLoadResult {
+    /** Successfully loaded configurations */
+    configs: ConfigurationFile[];
+    /** Errors encountered during loading */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Loader for managing multiple graph configurations from .principal-views/ folder
+ */
+export declare class ConfigurationLoader {
+    private fsAdapter;
+    private static readonly CONFIG_DIR;
+    constructor(fsAdapter: FileSystemAdapter);
+    /**
+     * Check if the .principal-views/ configuration directory exists
+     *
+     * @param baseDir - Base directory to search from
+     * @returns True if .principal-views/ directory exists
+     */
+    hasConfigDirectory(baseDir: string): Promise<boolean>;
+    /**
+     * List all available configuration names in .principal-views/ folder
+     *
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Array of configuration names (without extensions)
+     */
+    listConfigurations(baseDir: string): Promise<string[]>;
+    /**
+     * Load a specific configuration by name
+     *
+     * @param name - Configuration name (without extension)
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Configuration file or null if not found/invalid
+     */
+    loadByName(name: string, baseDir: string): Promise<ConfigurationFile | null>;
+    /**
+     * Load all configurations from .principal-views/ folder
+     *
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Result containing all loaded configs and any errors
+     */
+    loadAll(baseDir: string): Promise<ConfigurationLoadResult>;
+    /**
+     * Get the configuration directory path
+     *
+     * @param baseDir - Base directory
+     * @returns Full path to .principal-views/ directory
+     */
+    getConfigDirectoryPath(baseDir: string): string;
+}
+//# sourceMappingURL=ConfigurationLoader.d.ts.map

package/dist/ConfigurationLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationLoader.d.ts","sourceRoot":"","sources":["../src/ConfigurationLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,2BAA2B,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,SAAS;IAF7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAEpC,SAAS,EAAE,iBAAiB;IAEhD;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO3D;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW5D;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAkClF;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwDhE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGhD"}

package/dist/ConfigurationLoader.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Configuration loader for managing multiple graph configurations
+ *
+ * Supports loading configurations from the .principal-views/ folder using the adapter pattern
+ * for environment-agnostic file operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationLoader = void 0;
+const YamlParser_1 = require("./utils/YamlParser");
+/**
+ * Loader for managing multiple graph configurations from .principal-views/ folder
+ */
+class ConfigurationLoader {
+    constructor(fsAdapter) {
+        this.fsAdapter = fsAdapter;
+    }
+    /**
+     * Check if the .principal-views/ configuration directory exists
+     *
+     * @param baseDir - Base directory to search from
+     * @returns True if .principal-views/ directory exists
+     */
+    async hasConfigDirectory(baseDir) {
+        const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
+        const exists = await this.fsAdapter.exists(configPath);
+        if (!exists)
+            return false;
+        return await this.fsAdapter.isDirectory(configPath);
+    }
+    /**
+     * List all available configuration names in .principal-views/ folder
+     *
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Array of configuration names (without extensions)
+     */
+    async listConfigurations(baseDir) {
+        if (!(await this.hasConfigDirectory(baseDir))) {
+            return [];
+        }
+        const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
+        const files = await this.fsAdapter.readDir(configPath);
+        return files.filter(YamlParser_1.isYamlFile).map(YamlParser_1.getConfigNameFromFilename).sort();
+    }
+    /**
+     * Load a specific configuration by name
+     *
+     * @param name - Configuration name (without extension)
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Configuration file or null if not found/invalid
+     */
+    async loadByName(name, baseDir) {
+        if (!(await this.hasConfigDirectory(baseDir))) {
+            return null;
+        }
+        const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
+        // Try both .yaml and .yml extensions
+        for (const ext of ['yaml', 'yml']) {
+            const filename = `${name}.${ext}`;
+            const fullPath = this.fsAdapter.join(configPath, filename);
+            if (await this.fsAdapter.exists(fullPath)) {
+                try {
+                    const content = await this.fsAdapter.readFile(fullPath);
+                    const parseResult = (0, YamlParser_1.parseYaml)(content, filename);
+                    if (parseResult.success && parseResult.data) {
+                        return {
+                            name,
+                            path: fullPath,
+                            config: parseResult.data,
+                        };
+                    }
+                }
+                catch (error) {
+                    // File exists but couldn't be read or parsed
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Load all configurations from .principal-views/ folder
+     *
+     * @param baseDir - Base directory containing .principal-views/ folder
+     * @returns Result containing all loaded configs and any errors
+     */
+    async loadAll(baseDir) {
+        const result = {
+            configs: [],
+            errors: [],
+        };
+        if (!(await this.hasConfigDirectory(baseDir))) {
+            result.errors.push({
+                file: '.principal-views',
+                error: 'Configuration directory .principal-views/ not found',
+            });
+            return result;
+        }
+        const configPath = this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
+        const files = await this.fsAdapter.readDir(configPath);
+        for (const filename of files) {
+            if (!(0, YamlParser_1.isYamlFile)(filename)) {
+                continue; // Skip non-YAML files
+            }
+            const fullPath = this.fsAdapter.join(configPath, filename);
+            const name = (0, YamlParser_1.getConfigNameFromFilename)(filename);
+            try {
+                const content = await this.fsAdapter.readFile(fullPath);
+                const parseResult = (0, YamlParser_1.parseYaml)(content, filename);
+                if (parseResult.success && parseResult.data) {
+                    result.configs.push({
+                        name,
+                        path: fullPath,
+                        config: parseResult.data,
+                    });
+                }
+                else if (parseResult.error) {
+                    result.errors.push({
+                        file: filename,
+                        error: parseResult.error,
+                    });
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                result.errors.push({
+                    file: filename,
+                    error: `Failed to read file: ${errorMessage}`,
+                });
+            }
+        }
+        // Sort configs by name for consistent ordering
+        result.configs.sort((a, b) => a.name.localeCompare(b.name));
+        return result;
+    }
+    /**
+     * Get the configuration directory path
+     *
+     * @param baseDir - Base directory
+     * @returns Full path to .principal-views/ directory
+     */
+    getConfigDirectoryPath(baseDir) {
+        return this.fsAdapter.join(baseDir, ConfigurationLoader.CONFIG_DIR);
+    }
+}
+ConfigurationLoader.CONFIG_DIR = '.principal-views';
+exports.ConfigurationLoader = ConfigurationLoader;
+//# sourceMappingURL=ConfigurationLoader.js.map

package/dist/ConfigurationLoader.js.map

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

package/dist/ConfigurationValidator.d.ts

@@ -0,0 +1,31 @@
+import type { GraphConfiguration } from './types';
+export interface ConfigurationValidationError {
+    type: 'error' | 'warning';
+    message: string;
+    path: string;
+    suggestion?: string;
+}
+export interface ConfigurationValidationResult {
+    valid: boolean;
+    errors: ConfigurationValidationError[];
+    warnings: ConfigurationValidationError[];
+}
+/**
+ * Validates GraphConfiguration to catch issues early
+ * Use this before creating EventProcessor or rendering graphs
+ */
+export declare class ConfigurationValidator {
+    /**
+     * Validate a GraphConfiguration
+     */
+    static validate(config: GraphConfiguration): ConfigurationValidationResult;
+    /**
+     * Validate and throw if invalid
+     */
+    static validateOrThrow(config: GraphConfiguration): void;
+    /**
+     * Get a formatted report of validation results
+     */
+    static formatReport(result: ConfigurationValidationResult): string;
+}
+//# sourceMappingURL=ConfigurationValidator.d.ts.map

package/dist/ConfigurationValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationValidator.d.ts","sourceRoot":"","sources":["../src/ConfigurationValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,6BAA6B;IA6L1E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAuBxD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,6BAA6B,GAAG,MAAM;CA+BnE"}

package/dist/ConfigurationValidator.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationValidator = void 0;
+/**
+ * Validates GraphConfiguration to catch issues early
+ * Use this before creating EventProcessor or rendering graphs
+ */
+class ConfigurationValidator {
+    /**
+     * Validate a GraphConfiguration
+     */
+    static validate(config) {
+        const errors = [];
+        const warnings = [];
+        // Validate metadata
+        if (!config.metadata?.name) {
+            errors.push({
+                type: 'error',
+                message: 'Configuration must have a name',
+                path: 'metadata.name',
+            });
+        }
+        // Validate nodeTypes
+        if (!config.nodeTypes || Object.keys(config.nodeTypes).length === 0) {
+            errors.push({
+                type: 'error',
+                message: 'Configuration must define at least one node type',
+                path: 'nodeTypes',
+            });
+        }
+        else {
+            // Validate each node type
+            for (const [typeName, nodeType] of Object.entries(config.nodeTypes)) {
+                if (!nodeType.shape) {
+                    errors.push({
+                        type: 'error',
+                        message: `Node type '${typeName}' must have a shape`,
+                        path: `nodeTypes.${typeName}.shape`,
+                    });
+                }
+                if (!nodeType.dataSchema || Object.keys(nodeType.dataSchema).length === 0) {
+                    warnings.push({
+                        type: 'warning',
+                        message: `Node type '${typeName}' has no data schema defined`,
+                        path: `nodeTypes.${typeName}.dataSchema`,
+                        suggestion: 'Consider defining data schema for better type safety',
+                    });
+                }
+                // Validate states if defined
+                if (nodeType.states) {
+                    for (const [stateName, state] of Object.entries(nodeType.states)) {
+                        if (!state.label && !state.color && !state.icon) {
+                            warnings.push({
+                                type: 'warning',
+                                message: `State '${stateName}' of node type '${typeName}' has no visual properties`,
+                                path: `nodeTypes.${typeName}.states.${stateName}`,
+                                suggestion: 'Add at least one of: label, color, or icon',
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // Validate edgeTypes
+        if (!config.edgeTypes || Object.keys(config.edgeTypes).length === 0) {
+            errors.push({
+                type: 'error',
+                message: 'Configuration must define at least one edge type',
+                path: 'edgeTypes',
+            });
+        }
+        else {
+            // Validate each edge type
+            for (const [typeName, edgeType] of Object.entries(config.edgeTypes)) {
+                if (!edgeType.style) {
+                    errors.push({
+                        type: 'error',
+                        message: `Edge type '${typeName}' must have a style`,
+                        path: `edgeTypes.${typeName}.style`,
+                    });
+                }
+            }
+        }
+        // Validate allowedConnections
+        if (!config.allowedConnections || config.allowedConnections.length === 0) {
+            warnings.push({
+                type: 'warning',
+                message: 'No connection rules defined',
+                path: 'allowedConnections',
+                suggestion: 'Define connection rules to validate graph structure',
+            });
+        }
+        else {
+            const nodeTypeNames = Object.keys(config.nodeTypes);
+            const edgeTypeNames = Object.keys(config.edgeTypes);
+            config.allowedConnections.forEach((rule, index) => {
+                // Check if 'from' node type exists
+                if (!nodeTypeNames.includes(rule.from)) {
+                    errors.push({
+                        type: 'error',
+                        message: `Connection rule references undefined node type '${rule.from}'`,
+                        path: `allowedConnections[${index}].from`,
+                        suggestion: `Available node types: ${nodeTypeNames.join(', ')}`,
+                    });
+                }
+                // Check if 'to' node type exists
+                if (!nodeTypeNames.includes(rule.to)) {
+                    errors.push({
+                        type: 'error',
+                        message: `Connection rule references undefined node type '${rule.to}'`,
+                        path: `allowedConnections[${index}].to`,
+                        suggestion: `Available node types: ${nodeTypeNames.join(', ')}`,
+                    });
+                }
+                // Check if 'via' edge type exists
+                if (!edgeTypeNames.includes(rule.via)) {
+                    errors.push({
+                        type: 'error',
+                        message: `Connection rule references undefined edge type '${rule.via}'`,
+                        path: `allowedConnections[${index}].via`,
+                        suggestion: `Available edge types: ${edgeTypeNames.join(', ')}`,
+                    });
+                }
+            });
+        }
+        // Validate validation rules if present
+        if (config.validation) {
+            // Validate state transitions
+            if (config.validation.stateTransitions) {
+                const nodeTypeNames = Object.keys(config.nodeTypes);
+                for (const [nodeType, transitions] of Object.entries(config.validation.stateTransitions)) {
+                    if (!nodeTypeNames.includes(nodeType)) {
+                        errors.push({
+                            type: 'error',
+                            message: `State transition rule references undefined node type '${nodeType}'`,
+                            path: `validation.stateTransitions.${nodeType}`,
+                            suggestion: `Available node types: ${nodeTypeNames.join(', ')}`,
+                        });
+                    }
+                    else {
+                        // Check if states exist in node type definition
+                        const nodeTypeDef = config.nodeTypes[nodeType];
+                        const definedStates = nodeTypeDef.states ? Object.keys(nodeTypeDef.states) : [];
+                        transitions.forEach((transition, index) => {
+                            if (definedStates.length > 0 && !definedStates.includes(transition.from)) {
+                                warnings.push({
+                                    type: 'warning',
+                                    message: `State transition references undefined state '${transition.from}' for node type '${nodeType}'`,
+                                    path: `validation.stateTransitions.${nodeType}[${index}].from`,
+                                    suggestion: `Defined states: ${definedStates.join(', ')}`,
+                                });
+                            }
+                            transition.to.forEach((toState) => {
+                                if (definedStates.length > 0 && !definedStates.includes(toState)) {
+                                    warnings.push({
+                                        type: 'warning',
+                                        message: `State transition references undefined state '${toState}' for node type '${nodeType}'`,
+                                        path: `validation.stateTransitions.${nodeType}[${index}].to`,
+                                        suggestion: `Defined states: ${definedStates.join(', ')}`,
+                                    });
+                                }
+                            });
+                        });
+                    }
+                }
+            }
+            // Validate cardinality rules
+            if (config.validation.cardinality) {
+                const nodeTypeNames = Object.keys(config.nodeTypes);
+                for (const nodeType of Object.keys(config.validation.cardinality)) {
+                    if (!nodeTypeNames.includes(nodeType)) {
+                        errors.push({
+                            type: 'error',
+                            message: `Cardinality rule references undefined node type '${nodeType}'`,
+                            path: `validation.cardinality.${nodeType}`,
+                            suggestion: `Available node types: ${nodeTypeNames.join(', ')}`,
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate and throw if invalid
+     */
+    static validateOrThrow(config) {
+        const result = this.validate(config);
+        if (!result.valid) {
+            const errorMessages = result.errors.map((e) => `  - ${e.path}: ${e.message}${e.suggestion ? ` (${e.suggestion})` : ''}`);
+            throw new Error(`Invalid GraphConfiguration:\n${errorMessages.join('\n')}\n\n` +
+                `Found ${result.errors.length} error(s) and ${result.warnings.length} warning(s)`);
+        }
+        // Log warnings
+        if (result.warnings.length > 0) {
+            console.warn(`Configuration has ${result.warnings.length} warning(s):`);
+            result.warnings.forEach((w) => {
+                console.warn(`  - ${w.path}: ${w.message}${w.suggestion ? ` (${w.suggestion})` : ''}`);
+            });
+        }
+    }
+    /**
+     * Get a formatted report of validation results
+     */
+    static formatReport(result) {
+        const lines = [];
+        if (result.valid) {
+            lines.push('✅ Configuration is valid');
+        }
+        else {
+            lines.push(`❌ Configuration has ${result.errors.length} error(s)`);
+        }
+        if (result.errors.length > 0) {
+            lines.push('\nErrors:');
+            result.errors.forEach((e) => {
+                lines.push(`  ❌ ${e.path}: ${e.message}`);
+                if (e.suggestion) {
+                    lines.push(`     💡 ${e.suggestion}`);
+                }
+            });
+        }
+        if (result.warnings.length > 0) {
+            lines.push(`\n⚠️  ${result.warnings.length} warning(s):`);
+            result.warnings.forEach((w) => {
+                lines.push(`  ⚠️  ${w.path}: ${w.message}`);
+                if (w.suggestion) {
+                    lines.push(`     💡 ${w.suggestion}`);
+                }
+            });
+        }
+        return lines.join('\n');
+    }
+}
+exports.ConfigurationValidator = ConfigurationValidator;
+//# sourceMappingURL=ConfigurationValidator.js.map

package/dist/ConfigurationValidator.js.map

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