@grafema/cli 0.2.3-beta → 0.2.5-beta

package/dist/utils/progressRenderer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ProgressRenderer({ isInteractive: true });
+ * orchestrator.run({
+ *   onProgress: (info) => renderer.update(info),
+ * });
+ * console.log(renderer.finish(elapsed));
+ * ```
+ */
+import type { ProgressInfo } from '@grafema/core';
+/**
+ * Options for creating a ProgressRenderer instance.
+ */
+export interface ProgressRendererOptions {
+    /** Whether output is to a TTY (enables spinner and line overwriting) */
+    isInteractive?: boolean;
+    /** Minimum milliseconds between display updates (default: 100) */
+    throttle?: number;
+    /** Custom write function for output (default: process.stdout.write) */
+    write?: (text: string) => void;
+}
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ */
+export declare class ProgressRenderer {
+    private phases;
+    private currentPhaseIndex;
+    private currentPhase;
+    private currentPlugin;
+    private message;
+    private totalFiles;
+    private processedFiles;
+    private servicesAnalyzed;
+    private spinnerIndex;
+    private isInteractive;
+    private startTime;
+    private lastDisplayTime;
+    private displayThrottle;
+    private write;
+    private spinnerFrames;
+    private activePlugins;
+    private nodeCount;
+    private edgeCount;
+    constructor(options?: ProgressRendererOptions);
+    /**
+     * Process a progress event from Orchestrator.
+     * Updates internal state and displays formatted output if throttle allows.
+     */
+    update(info: ProgressInfo): void;
+    /**
+     * Update graph statistics (called separately from progress events).
+     * This allows real-time node/edge count updates.
+     */
+    setStats(nodeCount: number, edgeCount: number): void;
+    /**
+     * Format and display current state to console.
+     */
+    private display;
+    private formatOutput;
+    /**
+     * Format elapsed time as human-readable string.
+     */
+    private formatElapsed;
+    private formatInteractive;
+    private formatNonInteractive;
+    /**
+     * Format node/edge counts if available.
+     */
+    private formatStats;
+    /**
+     * Format large numbers with K/M suffix.
+     */
+    private formatNumber;
+    /**
+     * Get formatted phase label with number, e.g., "[3/5] Analysis..."
+     */
+    private getPhaseLabel;
+    /**
+     * Format progress details based on current phase.
+     */
+    private formatPhaseProgress;
+    /**
+     * Format plugin list, truncating if more than 3 plugins.
+     */
+    private formatPluginList;
+    /**
+     * Get final summary message after analysis complete.
+     * @param durationSeconds - Total duration of analysis
+     * @returns Formatted completion message
+     */
+    finish(durationSeconds: number): string;
+    /**
+     * Expose internal state for testing.
+     * @internal
+     */
+    getState(): {
+        phaseIndex: number;
+        phase: string;
+        processedFiles: number;
+        totalFiles: number;
+        servicesAnalyzed: number;
+        spinnerIndex: number;
+        activePlugins: string[];
+        nodeCount: number;
+        edgeCount: number;
+    };
+}
+//# sourceMappingURL=progressRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressRenderer.d.ts","sourceRoot":"","sources":["../../src/utils/progressRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA+E;IAC7F,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,aAAa,CAAsD;IAC3E,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;gBAElB,OAAO,CAAC,EAAE,uBAAuB;IAO7C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA+ChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;IACH,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;IAIvC;;;OAGG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB;CAaF"}

package/dist/utils/progressRenderer.js

@@ -0,0 +1,245 @@
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ProgressRenderer({ isInteractive: true });
+ * orchestrator.run({
+ *   onProgress: (info) => renderer.update(info),
+ * });
+ * console.log(renderer.finish(elapsed));
+ * ```
+ */
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ */
+export class ProgressRenderer {
+    phases = ['discovery', 'indexing', 'analysis', 'enrichment', 'validation'];
+    currentPhaseIndex = -1;
+    currentPhase = '';
+    currentPlugin = '';
+    message = '';
+    totalFiles = 0;
+    processedFiles = 0;
+    servicesAnalyzed = 0;
+    spinnerIndex = 0;
+    isInteractive;
+    startTime;
+    lastDisplayTime = 0;
+    displayThrottle;
+    write;
+    spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    activePlugins = [];
+    nodeCount = 0;
+    edgeCount = 0;
+    constructor(options) {
+        this.isInteractive = options?.isInteractive ?? process.stdout.isTTY ?? false;
+        this.displayThrottle = options?.throttle ?? 100;
+        this.startTime = Date.now();
+        this.write = options?.write ?? ((text) => process.stdout.write(text));
+    }
+    /**
+     * Process a progress event from Orchestrator.
+     * Updates internal state and displays formatted output if throttle allows.
+     */
+    update(info) {
+        // Update phase tracking
+        if (info.phase && info.phase !== this.currentPhase) {
+            this.currentPhase = info.phase;
+            const idx = this.phases.indexOf(info.phase);
+            if (idx !== -1) {
+                this.currentPhaseIndex = idx;
+            }
+            // Reset phase-specific state
+            this.activePlugins = [];
+        }
+        // Update state from progress info
+        if (info.currentPlugin !== undefined) {
+            this.currentPlugin = info.currentPlugin;
+            // Track active plugins for enrichment/validation display
+            if ((this.currentPhase === 'enrichment' || this.currentPhase === 'validation') &&
+                info.currentPlugin && !this.activePlugins.includes(info.currentPlugin)) {
+                this.activePlugins.push(info.currentPlugin);
+            }
+        }
+        if (info.message !== undefined) {
+            this.message = info.message;
+        }
+        if (info.totalFiles !== undefined) {
+            this.totalFiles = info.totalFiles;
+        }
+        if (info.processedFiles !== undefined) {
+            this.processedFiles = info.processedFiles;
+        }
+        if (info.servicesAnalyzed !== undefined) {
+            this.servicesAnalyzed = info.servicesAnalyzed;
+        }
+        // Update spinner
+        this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
+        // Check throttling
+        const now = Date.now();
+        if (now - this.lastDisplayTime < this.displayThrottle) {
+            return;
+        }
+        this.lastDisplayTime = now;
+        this.display();
+    }
+    /**
+     * Update graph statistics (called separately from progress events).
+     * This allows real-time node/edge count updates.
+     */
+    setStats(nodeCount, edgeCount) {
+        this.nodeCount = nodeCount;
+        this.edgeCount = edgeCount;
+    }
+    /**
+     * Format and display current state to console.
+     */
+    display() {
+        const output = this.formatOutput();
+        if (this.isInteractive) {
+            // TTY mode: overwrite previous line, pad with spaces to clear old content
+            const padded = output.padEnd(80, ' ');
+            this.write(`\r${padded}`);
+        }
+        else {
+            // Non-TTY mode: append newline
+            this.write(`${output}\n`);
+        }
+    }
+    formatOutput() {
+        if (this.isInteractive) {
+            return this.formatInteractive();
+        }
+        else {
+            return this.formatNonInteractive();
+        }
+    }
+    /**
+     * Format elapsed time as human-readable string.
+     */
+    formatElapsed() {
+        const elapsed = (Date.now() - this.startTime) / 1000;
+        if (elapsed < 60) {
+            return `${elapsed.toFixed(1)}s`;
+        }
+        const minutes = Math.floor(elapsed / 60);
+        const seconds = Math.floor(elapsed % 60);
+        return `${minutes}m${seconds}s`;
+    }
+    formatInteractive() {
+        const spinner = this.spinnerFrames[this.spinnerIndex];
+        const elapsed = this.formatElapsed();
+        const phaseLabel = this.getPhaseLabel();
+        const progress = this.formatPhaseProgress();
+        const stats = this.formatStats();
+        // Format: ⠋ [3/5] Analysis... 150/4047 modules | 12.5s | 1.2M nodes
+        return `${spinner} ${phaseLabel}${progress} | ${elapsed}${stats}`;
+    }
+    formatNonInteractive() {
+        const elapsed = this.formatElapsed();
+        return `[${this.currentPhase}] ${this.message || this.formatPhaseProgress()} (${elapsed})`;
+    }
+    /**
+     * Format node/edge counts if available.
+     */
+    formatStats() {
+        if (this.nodeCount === 0 && this.edgeCount === 0) {
+            return '';
+        }
+        const nodes = this.formatNumber(this.nodeCount);
+        const edges = this.formatNumber(this.edgeCount);
+        return ` | ${nodes} nodes, ${edges} edges`;
+    }
+    /**
+     * Format large numbers with K/M suffix.
+     */
+    formatNumber(n) {
+        if (n >= 1_000_000) {
+            return `${(n / 1_000_000).toFixed(1)}M`;
+        }
+        if (n >= 1_000) {
+            return `${(n / 1_000).toFixed(1)}K`;
+        }
+        return String(n);
+    }
+    /**
+     * Get formatted phase label with number, e.g., "[3/5] Analysis..."
+     */
+    getPhaseLabel() {
+        const phaseNum = this.currentPhaseIndex + 1;
+        const totalPhases = this.phases.length;
+        const phaseName = this.currentPhase.charAt(0).toUpperCase() + this.currentPhase.slice(1);
+        return `[${phaseNum}/${totalPhases}] ${phaseName}...`;
+    }
+    /**
+     * Format progress details based on current phase.
+     */
+    formatPhaseProgress() {
+        switch (this.currentPhase) {
+            case 'discovery':
+                if (this.servicesAnalyzed > 0) {
+                    return ` ${this.servicesAnalyzed} services found`;
+                }
+                return '';
+            case 'indexing':
+            case 'analysis':
+                if (this.totalFiles > 0) {
+                    return ` ${this.processedFiles}/${this.totalFiles} modules`;
+                }
+                return '';
+            case 'enrichment':
+            case 'validation':
+                if (this.activePlugins.length > 0) {
+                    return ` (${this.formatPluginList(this.activePlugins)})`;
+                }
+                return '';
+            default:
+                return '';
+        }
+    }
+    /**
+     * Format plugin list, truncating if more than 3 plugins.
+     */
+    formatPluginList(plugins) {
+        if (plugins.length <= 3) {
+            return plugins.join(', ');
+        }
+        // Truncate to 3 plugins + "..."
+        return plugins.slice(0, 3).join(', ') + ', ...';
+    }
+    /**
+     * Get final summary message after analysis complete.
+     * @param durationSeconds - Total duration of analysis
+     * @returns Formatted completion message
+     */
+    finish(durationSeconds) {
+        return `Analysis complete in ${durationSeconds.toFixed(2)}s`;
+    }
+    /**
+     * Expose internal state for testing.
+     * @internal
+     */
+    getState() {
+        return {
+            phaseIndex: this.currentPhaseIndex,
+            phase: this.currentPhase,
+            processedFiles: this.processedFiles,
+            totalFiles: this.totalFiles,
+            servicesAnalyzed: this.servicesAnalyzed,
+            spinnerIndex: this.spinnerIndex,
+            activePlugins: [...this.activePlugins],
+            nodeCount: this.nodeCount,
+            edgeCount: this.edgeCount,
+        };
+    }
+}
+//# sourceMappingURL=progressRenderer.js.map

package/dist/utils/progressRenderer.js.map

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

package/dist/utils/spinner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Simple terminal spinner for slow operations.
+ *
+ * Features:
+ * - TTY detection: silent in non-TTY environments (CI, pipes)
+ * - Delayed display: spinner only appears after 100ms to avoid flicker
+ * - Elapsed time: shows seconds for long operations
+ *
+ * Usage:
+ *   const spinner = new Spinner('Querying graph...');
+ *   spinner.start();
+ *   await slowOperation();
+ *   spinner.stop();
+ *
+ * IMPORTANT: Always call stop() BEFORE any console.log output.
+ */
+export declare class Spinner {
+    private message;
+    private frames;
+    private interval;
+    private displayTimer;
+    private frameIndex;
+    private startTime;
+    private displayDelay;
+    private isSpinning;
+    constructor(message: string, displayDelay?: number);
+    /**
+     * Start the spinner. Spinner appears only after displayDelay ms.
+     * In non-TTY environments (CI, pipes), this is a no-op.
+     */
+    start(): void;
+    private render;
+    /**
+     * Stop the spinner and clear the line.
+     * Safe to call multiple times or if spinner never started.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=spinner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,MAAM,EAAE,YAAY,SAAM;IAK/C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAqBb,OAAO,CAAC,MAAM;IAYd;;;OAGG;IACH,IAAI,IAAI,IAAI;CAqBb"}

package/dist/utils/spinner.js

@@ -0,0 +1,84 @@
+/**
+ * Simple terminal spinner for slow operations.
+ *
+ * Features:
+ * - TTY detection: silent in non-TTY environments (CI, pipes)
+ * - Delayed display: spinner only appears after 100ms to avoid flicker
+ * - Elapsed time: shows seconds for long operations
+ *
+ * Usage:
+ *   const spinner = new Spinner('Querying graph...');
+ *   spinner.start();
+ *   await slowOperation();
+ *   spinner.stop();
+ *
+ * IMPORTANT: Always call stop() BEFORE any console.log output.
+ */
+export class Spinner {
+    message;
+    frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    interval = null;
+    displayTimer = null;
+    frameIndex = 0;
+    startTime = 0;
+    displayDelay;
+    isSpinning = false;
+    constructor(message, displayDelay = 100) {
+        this.message = message;
+        this.displayDelay = displayDelay;
+    }
+    /**
+     * Start the spinner. Spinner appears only after displayDelay ms.
+     * In non-TTY environments (CI, pipes), this is a no-op.
+     */
+    start() {
+        // TTY check - ora pattern
+        if (!process.stdout.isTTY) {
+            return;
+        }
+        this.startTime = Date.now();
+        // Defer display to avoid flicker on fast queries
+        this.displayTimer = setTimeout(() => {
+            this.isSpinning = true;
+            this.render();
+            // Animate frames at 80ms interval
+            this.interval = setInterval(() => {
+                this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+                this.render();
+            }, 80);
+        }, this.displayDelay);
+    }
+    render() {
+        if (!this.isSpinning)
+            return;
+        const frame = this.frames[this.frameIndex];
+        const elapsed = Math.floor((Date.now() - this.startTime) / 1000);
+        const timeStr = elapsed > 0 ? ` (${elapsed}s)` : '';
+        process.stdout.clearLine(0);
+        process.stdout.cursorTo(0);
+        process.stdout.write(`${frame} ${this.message}${timeStr}`);
+    }
+    /**
+     * Stop the spinner and clear the line.
+     * Safe to call multiple times or if spinner never started.
+     */
+    stop() {
+        // Clear deferred display timer
+        if (this.displayTimer) {
+            clearTimeout(this.displayTimer);
+            this.displayTimer = null;
+        }
+        // Stop animation
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        // Clear line if we were displaying
+        if (this.isSpinning && process.stdout.isTTY) {
+            process.stdout.clearLine(0);
+            process.stdout.cursorTo(0);
+        }
+        this.isSpinning = false;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafema/cli",
-  "version": "0.2.3-beta",
+  "version": "0.2.5-beta",
   "description": "CLI for Grafema code analysis toolkit",
   "type": "module",
   "main": "./dist/cli.js",
@@ -28,7 +28,7 @@
   "author": "Vadim Reshetnikov",
   "repository": {
     "type": "git",
-    "url": "https://github.com/grafema/grafema.git",
+    "url": "https://github.com/Disentinel/grafema.git",
     "directory": "packages/cli"
   },
   "dependencies": {
@@ -37,8 +37,9 @@
     "ink-text-input": "^6.0.0",
     "react": "^19.2.3",
     "yaml": "^2.8.2",
-    "@grafema/core": "0.2.3-beta",
-    "@grafema/types": "0.2.1-beta"
+    "@grafema/api": "0.2.5-beta",
+    "@grafema/core": "0.2.5-beta",
+    "@grafema/types": "0.2.5-beta"
   },
   "devDependencies": {
     "@types/node": "^25.0.8",