@probelabs/visor 0.1.0

package/dist/commands.d.ts

@@ -0,0 +1,10 @@
+export interface Command {
+    type: string;
+    args?: string[];
+}
+export interface CommandRegistry {
+    [command: string]: string[];
+}
+export declare function parseComment(body: string, supportedCommands?: string[]): Command | null;
+export declare function getHelpText(customCommands?: CommandRegistry): string;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAyBvF;AAED,wBAAgB,WAAW,CAAC,cAAc,CAAC,EAAE,eAAe,GAAG,MAAM,CA8BpE"}

package/dist/commands.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseComment = parseComment;
+exports.getHelpText = getHelpText;
+function parseComment(body, supportedCommands) {
+    const trimmed = body.trim();
+    if (!trimmed.startsWith('/')) {
+        return null;
+    }
+    const parts = trimmed.split(/\s+/);
+    const command = parts[0].substring(1).toLowerCase();
+    const args = parts.slice(1);
+    // Default built-in commands
+    const builtInCommands = ['help', 'status'];
+    const allCommands = supportedCommands
+        ? [...builtInCommands, ...supportedCommands]
+        : builtInCommands;
+    if (!allCommands.includes(command)) {
+        return null;
+    }
+    return {
+        type: command,
+        args: args.length > 0 ? args : undefined,
+    };
+}
+function getHelpText(customCommands) {
+    let commandList = '';
+    let hasCustomCommands = false;
+    // Add custom commands from config
+    if (customCommands && Object.keys(customCommands).length > 0) {
+        hasCustomCommands = true;
+        for (const [command, checkIds] of Object.entries(customCommands)) {
+            commandList += `- \`/${command}\` - Run checks: ${checkIds.join(', ')}\n`;
+        }
+    }
+    // Add built-in commands
+    commandList += `- \`/status\` - Show current PR status and metrics\n`;
+    commandList += `- \`/help\` - Show this help message\n`;
+    // Add note if no custom commands are configured
+    if (!hasCustomCommands) {
+        commandList =
+            `*No custom review commands configured. Configure checks with the \`command\` property in your .visor.yaml file.*\n\n` +
+                commandList;
+    }
+    return `## Available Commands
+
+${commandList}
+Commands are case-insensitive and can be used in PR comments.
+
+---
+*Powered by [Visor](https://probelabs.com/visor) from [Probelabs](https://probelabs.com)*`;
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":";;AASA,oCAyBC;AAED,kCA8BC;AAzDD,SAAgB,YAAY,CAAC,IAAY,EAAE,iBAA4B;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,iBAAiB;QACnC,CAAC,CAAC,CAAC,GAAG,eAAe,EAAE,GAAG,iBAAiB,CAAC;QAC5C,CAAC,CAAC,eAAe,CAAC;IAEpB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACzC,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAC,cAAgC;IAC1D,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,kCAAkC;IAClC,IAAI,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,iBAAiB,GAAG,IAAI,CAAC;QACzB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACjE,WAAW,IAAI,QAAQ,OAAO,oBAAoB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,WAAW,IAAI,sDAAsD,CAAC;IACtE,WAAW,IAAI,wCAAwC,CAAC;IAExD,gDAAgD;IAChD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,WAAW;YACT,sHAAsH;gBACtH,WAAW,CAAC;IAChB,CAAC;IAED,OAAO;;EAEP,WAAW;;;;0FAI6E,CAAC;AAC3F,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,63 @@
+import { VisorConfig, EnvironmentOverrides, MergedConfig, ConfigLoadOptions } from './types/config';
+import { CliOptions } from './types/cli';
+/**
+ * Configuration manager for Visor
+ */
+export declare class ConfigManager {
+    private validCheckTypes;
+    private validEventTriggers;
+    private validOutputFormats;
+    private validGroupByOptions;
+    /**
+     * Load configuration from a file
+     */
+    loadConfig(configPath: string, options?: ConfigLoadOptions): Promise<VisorConfig>;
+    /**
+     * Find and load configuration from default locations
+     */
+    findAndLoadConfig(): Promise<VisorConfig>;
+    /**
+     * Find the git repository root directory
+     */
+    private findGitRepositoryRoot;
+    /**
+     * Get default configuration
+     */
+    getDefaultConfig(): Promise<VisorConfig>;
+    /**
+     * Load bundled default configuration from the package
+     */
+    loadBundledDefaultConfig(): VisorConfig | null;
+    /**
+     * Find the root directory of the Visor package
+     */
+    private findPackageRoot;
+    /**
+     * Merge configuration with CLI options
+     */
+    mergeWithCliOptions(config: Partial<VisorConfig>, cliOptions: CliOptions): MergedConfig;
+    /**
+     * Load configuration with environment variable overrides
+     */
+    loadConfigWithEnvOverrides(): Promise<{
+        config?: VisorConfig;
+        environmentOverrides: EnvironmentOverrides;
+    }>;
+    /**
+     * Validate configuration against schema
+     */
+    private validateConfig;
+    /**
+     * Validate individual check configuration
+     */
+    private validateCheckConfig;
+    /**
+     * Validate output configuration
+     */
+    private validateOutputConfig;
+    /**
+     * Merge configuration with default values
+     */
+    private mergeWithDefaults;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EAOX,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,kBAAkB,CAA4D;IACtF,OAAO,CAAC,kBAAkB,CAAgE;IAC1F,OAAO,CAAC,mBAAmB,CAAkD;IAE7E;;OAEG;IACU,UAAU,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC;IA2CvB;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC;IAyBtD;;OAEG;YACW,qBAAqB;IAiBnC;;OAEG;IACU,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;IAcrD;;OAEG;IACI,wBAAwB,IAAI,WAAW,GAAG,IAAI;IAgCrD;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACI,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,YAAY;IAQ9F;;OAEG;IACU,0BAA0B,IAAI,OAAO,CAAC;QACjD,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,oBAAoB,EAAE,oBAAoB,CAAC;KAC5C,CAAC;IA2BF;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA4B1B"}

package/dist/config.js

@@ -0,0 +1,369 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = void 0;
+const yaml = __importStar(require("js-yaml"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const simple_git_1 = __importDefault(require("simple-git"));
+/**
+ * Configuration manager for Visor
+ */
+class ConfigManager {
+    validCheckTypes = ['ai'];
+    validEventTriggers = ['pr_opened', 'pr_updated', 'pr_closed'];
+    validOutputFormats = ['table', 'json', 'markdown', 'sarif'];
+    validGroupByOptions = ['check', 'file', 'severity'];
+    /**
+     * Load configuration from a file
+     */
+    async loadConfig(configPath, options = {}) {
+        const { validate = true, mergeDefaults = true } = options;
+        try {
+            if (!fs.existsSync(configPath)) {
+                throw new Error(`Configuration file not found: ${configPath}`);
+            }
+            const configContent = fs.readFileSync(configPath, 'utf8');
+            let parsedConfig;
+            try {
+                parsedConfig = yaml.load(configContent);
+            }
+            catch (yamlError) {
+                const errorMessage = yamlError instanceof Error ? yamlError.message : String(yamlError);
+                throw new Error(`Invalid YAML syntax in ${configPath}: ${errorMessage}`);
+            }
+            if (!parsedConfig || typeof parsedConfig !== 'object') {
+                throw new Error('Configuration file must contain a valid YAML object');
+            }
+            if (validate) {
+                this.validateConfig(parsedConfig);
+            }
+            let finalConfig = parsedConfig;
+            if (mergeDefaults) {
+                finalConfig = this.mergeWithDefaults(parsedConfig);
+            }
+            return finalConfig;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes('not found') || error.message.includes('Invalid YAML')) {
+                    throw error;
+                }
+                throw new Error(`Failed to read configuration file: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Find and load configuration from default locations
+     */
+    async findAndLoadConfig() {
+        // Try to find the git repository root first, fall back to current directory
+        const gitRoot = await this.findGitRepositoryRoot();
+        const searchDirs = [gitRoot, process.cwd()].filter(Boolean);
+        for (const baseDir of searchDirs) {
+            const possiblePaths = [path.join(baseDir, '.visor.yaml'), path.join(baseDir, '.visor.yml')];
+            for (const configPath of possiblePaths) {
+                if (fs.existsSync(configPath)) {
+                    return this.loadConfig(configPath);
+                }
+            }
+        }
+        // Try to load bundled default config
+        const bundledConfig = this.loadBundledDefaultConfig();
+        if (bundledConfig) {
+            return bundledConfig;
+        }
+        // Return minimal default config if no bundled config found
+        return this.getDefaultConfig();
+    }
+    /**
+     * Find the git repository root directory
+     */
+    async findGitRepositoryRoot() {
+        try {
+            const git = (0, simple_git_1.default)();
+            const isRepo = await git.checkIsRepo();
+            if (!isRepo) {
+                return null;
+            }
+            // Get the repository root directory
+            const rootDir = await git.revparse(['--show-toplevel']);
+            return rootDir.trim();
+        }
+        catch {
+            // Not in a git repository or git not available
+            return null;
+        }
+    }
+    /**
+     * Get default configuration
+     */
+    async getDefaultConfig() {
+        return {
+            version: '1.0',
+            checks: {},
+            output: {
+                pr_comment: {
+                    format: 'markdown',
+                    group_by: 'check',
+                    collapse: true,
+                },
+            },
+        };
+    }
+    /**
+     * Load bundled default configuration from the package
+     */
+    loadBundledDefaultConfig() {
+        try {
+            // Find the package root by looking for package.json
+            const packageRoot = this.findPackageRoot();
+            if (!packageRoot) {
+                return null;
+            }
+            const bundledConfigPath = path.join(packageRoot, 'defaults', '.visor.yaml');
+            if (fs.existsSync(bundledConfigPath)) {
+                const configContent = fs.readFileSync(bundledConfigPath, 'utf8');
+                const parsedConfig = yaml.load(configContent);
+                if (!parsedConfig || typeof parsedConfig !== 'object') {
+                    return null;
+                }
+                // Validate and merge with defaults
+                this.validateConfig(parsedConfig);
+                return this.mergeWithDefaults(parsedConfig);
+            }
+        }
+        catch (error) {
+            // Silently fail and return null - will fall back to minimal default
+            console.warn('Failed to load bundled default config:', error instanceof Error ? error.message : String(error));
+        }
+        return null;
+    }
+    /**
+     * Find the root directory of the Visor package
+     */
+    findPackageRoot() {
+        let currentDir = __dirname;
+        // Walk up the directory tree to find package.json
+        while (currentDir !== path.dirname(currentDir)) {
+            const packageJsonPath = path.join(currentDir, 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                try {
+                    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                    // Check if this is the Visor package
+                    if (packageJson.name === '@probelabs/visor') {
+                        return currentDir;
+                    }
+                }
+                catch {
+                    // Continue searching if package.json is invalid
+                }
+            }
+            currentDir = path.dirname(currentDir);
+        }
+        return null;
+    }
+    /**
+     * Merge configuration with CLI options
+     */
+    mergeWithCliOptions(config, cliOptions) {
+        return {
+            config,
+            cliChecks: cliOptions.checks || [],
+            cliOutput: cliOptions.output || 'table',
+        };
+    }
+    /**
+     * Load configuration with environment variable overrides
+     */
+    async loadConfigWithEnvOverrides() {
+        const environmentOverrides = {};
+        // Check for environment variable overrides
+        if (process.env.VISOR_CONFIG_PATH) {
+            environmentOverrides.configPath = process.env.VISOR_CONFIG_PATH;
+        }
+        if (process.env.VISOR_OUTPUT_FORMAT) {
+            environmentOverrides.outputFormat = process.env.VISOR_OUTPUT_FORMAT;
+        }
+        let config;
+        if (environmentOverrides.configPath) {
+            try {
+                config = await this.loadConfig(environmentOverrides.configPath);
+            }
+            catch {
+                // If environment config fails, fall back to default discovery
+                config = await this.findAndLoadConfig();
+            }
+        }
+        else {
+            config = await this.findAndLoadConfig();
+        }
+        return { config, environmentOverrides };
+    }
+    /**
+     * Validate configuration against schema
+     */
+    validateConfig(config) {
+        const errors = [];
+        // Validate required fields
+        if (!config.version) {
+            errors.push({
+                field: 'version',
+                message: 'Missing required field: version',
+            });
+        }
+        if (!config.checks) {
+            errors.push({
+                field: 'checks',
+                message: 'Missing required field: checks',
+            });
+        }
+        else {
+            // Validate each check configuration
+            for (const [checkName, checkConfig] of Object.entries(config.checks)) {
+                this.validateCheckConfig(checkName, checkConfig, errors);
+            }
+        }
+        // Validate output configuration if present
+        if (config.output) {
+            this.validateOutputConfig(config.output, errors);
+        }
+        if (errors.length > 0) {
+            throw new Error(errors[0].message);
+        }
+    }
+    /**
+     * Validate individual check configuration
+     */
+    validateCheckConfig(checkName, checkConfig, errors) {
+        if (!checkConfig.type) {
+            errors.push({
+                field: `checks.${checkName}.type`,
+                message: `Invalid check configuration for "${checkName}": missing type`,
+            });
+            return;
+        }
+        if (!this.validCheckTypes.includes(checkConfig.type)) {
+            errors.push({
+                field: `checks.${checkName}.type`,
+                message: `Invalid check type "${checkConfig.type}". Must be: ${this.validCheckTypes.join(', ')}`,
+                value: checkConfig.type,
+            });
+        }
+        if (!checkConfig.prompt) {
+            errors.push({
+                field: `checks.${checkName}.prompt`,
+                message: `Invalid check configuration for "${checkName}": missing prompt`,
+            });
+        }
+        if (!checkConfig.on || !Array.isArray(checkConfig.on)) {
+            errors.push({
+                field: `checks.${checkName}.on`,
+                message: `Invalid check configuration for "${checkName}": missing or invalid 'on' field`,
+            });
+        }
+        else {
+            // Validate event triggers
+            for (const event of checkConfig.on) {
+                if (!this.validEventTriggers.includes(event)) {
+                    errors.push({
+                        field: `checks.${checkName}.on`,
+                        message: `Invalid event "${event}". Must be one of: ${this.validEventTriggers.join(', ')}`,
+                        value: event,
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Validate output configuration
+     */
+    validateOutputConfig(outputConfig, errors) {
+        if (outputConfig.pr_comment) {
+            const prComment = outputConfig.pr_comment;
+            if (typeof prComment.format === 'string' &&
+                !this.validOutputFormats.includes(prComment.format)) {
+                errors.push({
+                    field: 'output.pr_comment.format',
+                    message: `Invalid output format "${prComment.format}". Must be one of: ${this.validOutputFormats.join(', ')}`,
+                    value: prComment.format,
+                });
+            }
+            if (typeof prComment.group_by === 'string' &&
+                !this.validGroupByOptions.includes(prComment.group_by)) {
+                errors.push({
+                    field: 'output.pr_comment.group_by',
+                    message: `Invalid group_by option "${prComment.group_by}". Must be one of: ${this.validGroupByOptions.join(', ')}`,
+                    value: prComment.group_by,
+                });
+            }
+        }
+    }
+    /**
+     * Merge configuration with default values
+     */
+    mergeWithDefaults(config) {
+        const defaultConfig = {
+            version: '1.0',
+            checks: {},
+            output: {
+                pr_comment: {
+                    format: 'markdown',
+                    group_by: 'check',
+                    collapse: true,
+                },
+            },
+        };
+        // Deep merge with defaults
+        const merged = { ...defaultConfig, ...config };
+        // Ensure output has default values
+        if (merged.output) {
+            merged.output.pr_comment = {
+                ...defaultConfig.output.pr_comment,
+                ...merged.output.pr_comment,
+            };
+        }
+        else {
+            merged.output = defaultConfig.output;
+        }
+        return merged;
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/dependency-resolver.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Dependency resolution and execution ordering for checks
+ */
+export interface CheckNode {
+    id: string;
+    dependencies: string[];
+    dependents: string[];
+    depth: number;
+}
+export interface ExecutionGroup {
+    /** Checks that can run in parallel */
+    parallel: string[];
+    /** Execution level/wave (0 = no dependencies, 1 = depends on level 0, etc.) */
+    level: number;
+}
+export interface DependencyGraph {
+    nodes: Map<string, CheckNode>;
+    executionOrder: ExecutionGroup[];
+    hasCycles: boolean;
+    cycleNodes?: string[];
+}
+export declare class DependencyResolver {
+    /**
+     * Build dependency graph from check dependencies
+     */
+    static buildDependencyGraph(checkDependencies: Record<string, string[]>): DependencyGraph;
+    /**
+     * Detect cycles in the dependency graph using DFS
+     */
+    private static detectCycles;
+    /**
+     * Perform topological sort to determine execution order
+     * Groups checks that can run in parallel at each level
+     */
+    private static topologicalSort;
+    /**
+     * Validate that all dependencies exist
+     */
+    static validateDependencies(checkIds: string[], dependencies: Record<string, string[]>): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Get execution statistics for debugging
+     */
+    static getExecutionStats(graph: DependencyGraph): {
+        totalChecks: number;
+        parallelLevels: number;
+        maxParallelism: number;
+        averageParallelism: number;
+        checksWithDependencies: number;
+    };
+}
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../src/dependency-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,eAAe;IA8CzF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA6C3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAsC9B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAuBvC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,CAAC;KAChC;CAiBF"}