openlore 2.0.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Standardized logging interface for openlore
+ *
+ * Provides semantic log levels with specific visual treatments:
+ * - DISCOVERY: Finding files, detecting patterns, scanning directories
+ * - ANALYSIS: Parsing AST, building graphs, scoring significance
+ * - INFERENCE: LLM generating content, making decisions
+ * - SUCCESS: Tasks complete successfully
+ * - WARNING: Non-fatal issues, skipped files, fallback behavior
+ * - ERROR: Fatal errors, missing requirements
+ */
+import { type Ora } from 'ora';
+export type LogLevel = 'discovery' | 'analysis' | 'inference' | 'success' | 'warning' | 'error' | 'debug';
+export interface LoggerOptions {
+    quiet: boolean;
+    verbose: boolean;
+    noColor: boolean;
+    timestamps: boolean;
+}
+/**
+ * Logger class providing semantic log levels and spinner support
+ */
+export declare class Logger {
+    private options;
+    private activeSpinner;
+    constructor(options?: Partial<LoggerOptions>);
+    /**
+     * Update logger options
+     */
+    configure(options: Partial<LoggerOptions>): void;
+    /**
+     * Get current options
+     */
+    getOptions(): LoggerOptions;
+    /**
+     * Format a message with optional timestamp
+     */
+    private formatMessage;
+    /**
+     * Core log method
+     */
+    private log;
+    /**
+     * DISCOVERY - Finding files, detecting patterns, scanning directories
+     * @example logger.discovery("Discovered 847 files across 23 directories")
+     */
+    discovery(message: string): void;
+    /**
+     * ANALYSIS - Parsing AST, building graphs, scoring significance
+     * @example logger.analysis("Analyzing dependency graph...")
+     */
+    analysis(message: string): void;
+    /**
+     * INFERENCE - LLM is generating content, making decisions
+     * @example logger.inference("Inferring system intent from core modules...")
+     */
+    inference(message: string): void;
+    /**
+     * SUCCESS - Tasks complete successfully
+     * @example logger.success("Generated openspec/specs/auth/spec.md")
+     */
+    success(message: string): void;
+    /**
+     * WARNING - Non-fatal issues, skipped files, fallback behavior
+     * @example logger.warning("Skipped 12 binary files")
+     */
+    warning(message: string): void;
+    /**
+     * ERROR - Fatal errors, missing requirements
+     * @example logger.error("No .git directory found. Is this a repository?")
+     */
+    error(message: string): void;
+    /**
+     * DEBUG - Verbose debug information (only shown with --verbose)
+     * @example logger.debug("Processing file: src/utils/helper.ts")
+     */
+    debug(message: string): void;
+    /**
+     * Start a spinner for long-running operations
+     * @returns Spinner control object with succeed/fail/stop methods
+     */
+    spinner(message: string): SpinnerController;
+    /**
+     * Register an external spinner so log calls pause/resume it correctly
+     */
+    setActiveSpinner(spinner: Ora | null): void;
+    /**
+     * Clear the active spinner reference
+     */
+    clearSpinner(): void;
+    /**
+     * Print a blank line (respects quiet mode)
+     */
+    blank(): void;
+    /**
+     * Print a section header
+     */
+    section(title: string): void;
+    /**
+     * Print a key-value pair for summaries
+     */
+    info(key: string, value: string | number): void;
+    /**
+     * Print a list item
+     */
+    listItem(item: string, indent?: number): void;
+}
+/**
+ * Controller for spinner operations
+ */
+export declare class SpinnerController {
+    private spinner;
+    private logger;
+    constructor(spinner: Ora | null, logger: Logger);
+    /**
+     * Update spinner text
+     */
+    update(message: string): void;
+    /**
+     * Mark spinner as succeeded
+     */
+    succeed(message?: string): void;
+    /**
+     * Mark spinner as failed
+     */
+    fail(message?: string): void;
+    /**
+     * Mark spinner as warning
+     */
+    warn(message?: string): void;
+    /**
+     * Stop spinner without status
+     */
+    stop(): void;
+    /**
+     * Stop spinner and show info
+     */
+    info(message?: string): void;
+}
+/**
+ * Singleton logger instance for use across the application
+ */
+export declare const logger: Logger;
+/**
+ * Configure the global logger instance
+ */
+export declare function configureLogger(options: Partial<LoggerOptions>): void;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1G,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAgDD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAoB;gBAE7B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;IAIhD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,IAAI,aAAa;IAI3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,GAAG;IA8BX;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA6B3C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAI3C;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY5B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU/C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;CAUjD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;IAK/C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS/B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAM7B;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAErE;AAED,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,342 @@
+/**
+ * Standardized logging interface for openlore
+ *
+ * Provides semantic log levels with specific visual treatments:
+ * - DISCOVERY: Finding files, detecting patterns, scanning directories
+ * - ANALYSIS: Parsing AST, building graphs, scoring significance
+ * - INFERENCE: LLM generating content, making decisions
+ * - SUCCESS: Tasks complete successfully
+ * - WARNING: Non-fatal issues, skipped files, fallback behavior
+ * - ERROR: Fatal errors, missing requirements
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+const defaultOptions = {
+    quiet: false,
+    verbose: false,
+    noColor: false,
+    timestamps: false,
+};
+/**
+ * Semantic prefixes for each log level.
+ * Emoji variants are used in interactive TTY sessions; plain ASCII in CI/pipes.
+ */
+const PREFIXES_EMOJI = {
+    discovery: '🔍',
+    analysis: '🔬',
+    inference: '🧠',
+    success: '✓',
+    warning: '⚠',
+    error: '✗',
+    debug: '→',
+};
+const PREFIXES_ASCII = {
+    discovery: '[scan]',
+    analysis: '[analyze]',
+    inference: '[infer]',
+    success: '[ok]',
+    warning: '[warn]',
+    error: '[error]',
+    debug: '[debug]',
+};
+const isTTY = process.stdout.isTTY === true;
+/**
+ * Color functions for each log level
+ */
+const COLORS = {
+    discovery: chalk.cyan,
+    analysis: chalk.yellow,
+    inference: chalk.magenta,
+    success: chalk.green,
+    warning: chalk.hex('#FFA500'), // Orange
+    error: chalk.red,
+    debug: chalk.gray,
+};
+/**
+ * Logger class providing semantic log levels and spinner support
+ */
+export class Logger {
+    options;
+    activeSpinner = null;
+    constructor(options = {}) {
+        this.options = { ...defaultOptions, ...options };
+    }
+    /**
+     * Update logger options
+     */
+    configure(options) {
+        this.options = { ...this.options, ...options };
+    }
+    /**
+     * Get current options
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * Format a message with optional timestamp
+     */
+    formatMessage(level, message) {
+        const prefix = isTTY && !this.options.noColor ? PREFIXES_EMOJI[level] : PREFIXES_ASCII[level];
+        const colorFn = this.options.noColor ? (s) => s : COLORS[level];
+        let formattedMessage = `${prefix} ${message}`;
+        if (this.options.timestamps) {
+            const timestamp = new Date().toISOString();
+            formattedMessage = `[${timestamp}] ${formattedMessage}`;
+        }
+        return colorFn(formattedMessage);
+    }
+    /**
+     * Core log method
+     */
+    log(level, message) {
+        // In quiet mode, only show errors
+        if (this.options.quiet && level !== 'error') {
+            return;
+        }
+        // Debug messages only show in verbose mode
+        if (level === 'debug' && !this.options.verbose) {
+            return;
+        }
+        // Pause spinner if active to prevent overlap
+        if (this.activeSpinner) {
+            this.activeSpinner.stop();
+        }
+        const formattedMessage = this.formatMessage(level, message);
+        if (level === 'error') {
+            console.error(formattedMessage);
+        }
+        else {
+            console.log(formattedMessage);
+        }
+        // Resume spinner if it was active
+        if (this.activeSpinner) {
+            this.activeSpinner.start();
+        }
+    }
+    /**
+     * DISCOVERY - Finding files, detecting patterns, scanning directories
+     * @example logger.discovery("Discovered 847 files across 23 directories")
+     */
+    discovery(message) {
+        this.log('discovery', message);
+    }
+    /**
+     * ANALYSIS - Parsing AST, building graphs, scoring significance
+     * @example logger.analysis("Analyzing dependency graph...")
+     */
+    analysis(message) {
+        this.log('analysis', message);
+    }
+    /**
+     * INFERENCE - LLM is generating content, making decisions
+     * @example logger.inference("Inferring system intent from core modules...")
+     */
+    inference(message) {
+        this.log('inference', message);
+    }
+    /**
+     * SUCCESS - Tasks complete successfully
+     * @example logger.success("Generated openspec/specs/auth/spec.md")
+     */
+    success(message) {
+        this.log('success', message);
+    }
+    /**
+     * WARNING - Non-fatal issues, skipped files, fallback behavior
+     * @example logger.warning("Skipped 12 binary files")
+     */
+    warning(message) {
+        this.log('warning', message);
+    }
+    /**
+     * ERROR - Fatal errors, missing requirements
+     * @example logger.error("No .git directory found. Is this a repository?")
+     */
+    error(message) {
+        this.log('error', message);
+    }
+    /**
+     * DEBUG - Verbose debug information (only shown with --verbose)
+     * @example logger.debug("Processing file: src/utils/helper.ts")
+     */
+    debug(message) {
+        this.log('debug', message);
+    }
+    /**
+     * Start a spinner for long-running operations
+     * @returns Spinner control object with succeed/fail/stop methods
+     */
+    spinner(message) {
+        // Don't show spinners in quiet mode or CI (timestamps mode)
+        if (this.options.quiet || this.options.timestamps) {
+            // Return a no-op controller
+            return new SpinnerController(null, this);
+        }
+        // Stop any existing spinner
+        if (this.activeSpinner) {
+            this.activeSpinner.stop();
+        }
+        const spinner = ora({
+            text: message,
+            color: 'cyan',
+            spinner: 'dots',
+        });
+        if (!this.options.noColor) {
+            spinner.start();
+        }
+        else {
+            // In no-color mode, just print the message
+            console.log(`... ${message}`);
+        }
+        this.activeSpinner = spinner;
+        return new SpinnerController(spinner, this);
+    }
+    /**
+     * Register an external spinner so log calls pause/resume it correctly
+     */
+    setActiveSpinner(spinner) {
+        this.activeSpinner = spinner;
+    }
+    /**
+     * Clear the active spinner reference
+     */
+    clearSpinner() {
+        this.activeSpinner = null;
+    }
+    /**
+     * Print a blank line (respects quiet mode)
+     */
+    blank() {
+        if (!this.options.quiet) {
+            console.log();
+        }
+    }
+    /**
+     * Print a section header
+     */
+    section(title) {
+        if (this.options.quiet)
+            return;
+        this.blank();
+        if (this.options.noColor) {
+            console.log(`=== ${title} ===`);
+        }
+        else {
+            console.log(chalk.bold.underline(title));
+        }
+        this.blank();
+    }
+    /**
+     * Print a key-value pair for summaries
+     */
+    info(key, value) {
+        if (this.options.quiet)
+            return;
+        if (this.options.noColor) {
+            console.log(`  ${key}: ${value}`);
+        }
+        else {
+            console.log(`  ${chalk.dim(key + ':')} ${value}`);
+        }
+    }
+    /**
+     * Print a list item
+     */
+    listItem(item, indent = 0) {
+        if (this.options.quiet)
+            return;
+        const prefix = '  '.repeat(indent) + '•';
+        if (this.options.noColor) {
+            console.log(`${prefix} ${item}`);
+        }
+        else {
+            console.log(`${chalk.dim(prefix)} ${item}`);
+        }
+    }
+}
+/**
+ * Controller for spinner operations
+ */
+export class SpinnerController {
+    spinner;
+    logger;
+    constructor(spinner, logger) {
+        this.spinner = spinner;
+        this.logger = logger;
+    }
+    /**
+     * Update spinner text
+     */
+    update(message) {
+        if (this.spinner) {
+            this.spinner.text = message;
+        }
+    }
+    /**
+     * Mark spinner as succeeded
+     */
+    succeed(message) {
+        if (this.spinner) {
+            this.spinner.succeed(message);
+        }
+        else if (message) {
+            this.logger.success(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Mark spinner as failed
+     */
+    fail(message) {
+        if (this.spinner) {
+            this.spinner.fail(message);
+        }
+        else if (message) {
+            this.logger.error(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Mark spinner as warning
+     */
+    warn(message) {
+        if (this.spinner) {
+            this.spinner.warn(message);
+        }
+        else if (message) {
+            this.logger.warning(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Stop spinner without status
+     */
+    stop() {
+        if (this.spinner) {
+            this.spinner.stop();
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Stop spinner and show info
+     */
+    info(message) {
+        if (this.spinner) {
+            this.spinner.info(message);
+        }
+        this.logger.clearSpinner();
+    }
+}
+/**
+ * Singleton logger instance for use across the application
+ */
+export const logger = new Logger();
+/**
+ * Configure the global logger instance
+ */
+export function configureLogger(options) {
+    logger.configure(options);
+}
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/misc.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Miscellaneous utilities
+ * Shared helpers that don't belong in other specific modules.
+ */
+/**
+ * Parse JSON from LLM output, handling markdown code fences.
+ * Strips ``` fences, extracts JSON array or object, returns fallback on failure.
+ */
+export declare function parseJSON<T>(text: string, fallback: T): T;
+//# sourceMappingURL=misc.d.ts.map

package/dist/utils/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CASzD"}

package/dist/utils/misc.js

@@ -0,0 +1,21 @@
+/**
+ * Miscellaneous utilities
+ * Shared helpers that don't belong in other specific modules.
+ */
+/**
+ * Parse JSON from LLM output, handling markdown code fences.
+ * Strips ``` fences, extracts JSON array or object, returns fallback on failure.
+ */
+export function parseJSON(text, fallback) {
+    const stripped = text.replace(/```(?:json)?\s*/g, '').replace(/```\s*/g, '');
+    const match = stripped.match(/(\[[\s\S]*\]|\{[\s\S]*\})/);
+    if (!match)
+        return fallback;
+    try {
+        return JSON.parse(match[0]);
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=misc.js.map

package/dist/utils/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,IAAY,EAAE,QAAW;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAM,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/utils/progress.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Progress indicators for openlore CLI
+ * Uses ora for spinners with meaningful status messages
+ */
+/**
+ * Render a tqdm-style progress bar: [=====>    ] 45% (9/20)
+ */
+export declare function renderBar(current: number, total: number, width?: number): string;
+export interface ProgressOptions {
+    /** Whether to show the spinner (false for non-TTY) */
+    enabled?: boolean;
+    /** Prefix for log messages */
+    prefix?: string;
+}
+export interface FileDiscoveryProgress {
+    found: number;
+    directories: number;
+    currentFile?: string;
+}
+export interface AnalysisProgress {
+    phase: 'imports' | 'scoring' | 'graph' | 'clustering';
+    current?: string;
+    processed?: number;
+    total?: number;
+}
+export interface GenerationProgress {
+    stage: number;
+    totalStages: number;
+    stageName: string;
+    tokensUsed?: number;
+}
+export interface WritingProgress {
+    current: number;
+    total: number;
+    currentFile?: string;
+}
+/**
+ * Progress manager for CLI operations
+ */
+export declare class ProgressIndicator {
+    private spinner;
+    private enabled;
+    private prefix;
+    private verbose;
+    private logs;
+    constructor(options?: ProgressOptions & {
+        verbose?: boolean;
+    });
+    /**
+     * Start a new spinner with a message
+     */
+    start(message: string): void;
+    /**
+     * Update the spinner text
+     */
+    update(message: string): void;
+    /**
+     * Mark the current task as successful
+     */
+    succeed(message?: string): void;
+    /**
+     * Mark the current task as failed
+     */
+    fail(message?: string): void;
+    /**
+     * Show a warning
+     */
+    warn(message: string): void;
+    /**
+     * Show an info message (pauses spinner)
+     */
+    info(message: string): void;
+    /**
+     * Stop the spinner without a status
+     */
+    stop(): void;
+    /**
+     * Update file discovery progress
+     */
+    updateFileDiscovery(progress: FileDiscoveryProgress): void;
+    /**
+     * Update analysis progress
+     */
+    updateAnalysis(progress: AnalysisProgress): void;
+    /**
+     * Update generation progress
+     */
+    updateGeneration(progress: GenerationProgress): void;
+    /**
+     * Update file writing progress
+     */
+    updateWriting(progress: WritingProgress): void;
+    /**
+     * Log a verbose message (only shown in verbose mode)
+     */
+    verboseLog(message: string): void;
+    /**
+     * Get all logs for saving
+     */
+    getLogs(): string[];
+    private formatMessage;
+    private log;
+}
+/**
+ * Create a progress indicator for CLI operations
+ */
+export declare function createProgress(options?: ProgressOptions & {
+    verbose?: boolean;
+}): ProgressIndicator;
+/**
+ * Show post-run suggestions for next steps
+ */
+export declare function showNextSteps(options: {
+    generated?: boolean;
+    verified?: boolean;
+    analyzed?: boolean;
+}): void;
+/**
+ * Show success message after generation
+ */
+export declare function showGenerationSuccess(options: {
+    specsCount: number;
+    outputPath: string;
+    tokensUsed?: number;
+}): void;
+/**
+ * Show success message after analysis
+ */
+export declare function showAnalysisSuccess(options: {
+    filesAnalyzed: number;
+    outputPath: string;
+    domains?: number;
+}): void;
+/**
+ * Show success message after verification
+ */
+export declare function showVerificationSuccess(options: {
+    score: number;
+    filesVerified: number;
+    passed: boolean;
+}): void;
+//# sourceMappingURL=progress.d.ts.map