@evolith/smart-cli 0.0.1-beta

package/dist/core/observability/observability.test.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const structured_logger_1 = require("./structured-logger");
+const timing_1 = require("./timing");
+const error_reporter_1 = require("./error-reporter");
+describe('StructuredLogger', () => {
+    let testLogger;
+    beforeEach(() => {
+        testLogger = new structured_logger_1.StructuredLogger({ level: structured_logger_1.LogLevel.DEBUG });
+    });
+    afterEach(() => {
+        testLogger.clearBuffer();
+    });
+    describe('log levels', () => {
+        it('should log debug messages', () => {
+            testLogger.debug('debug message');
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.DEBUG);
+            expect(buffer[0].message).toBe('debug message');
+        });
+        it('should log info messages', () => {
+            testLogger.info('info message');
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.INFO);
+        });
+        it('should log warn messages', () => {
+            testLogger.warn('warn message');
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.WARN);
+        });
+        it('should log error messages', () => {
+            testLogger.error('error message');
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.ERROR);
+        });
+        it('should log fatal messages', () => {
+            testLogger.fatal('fatal message');
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.FATAL);
+        });
+        it('should filter messages below configured level', () => {
+            const filteredLogger = new structured_logger_1.StructuredLogger({ level: structured_logger_1.LogLevel.ERROR });
+            filteredLogger.debug('debug message');
+            filteredLogger.info('info message');
+            filteredLogger.warn('warn message');
+            filteredLogger.error('error message');
+            const buffer = filteredLogger.getBuffer();
+            expect(buffer).toHaveLength(1);
+            expect(buffer[0].level).toBe(structured_logger_1.LogLevel.ERROR);
+        });
+    });
+    describe('context', () => {
+        it('should include context in log entry', () => {
+            testLogger.info('message with context', { key: 'value', number: 42 });
+            const buffer = testLogger.getBuffer();
+            expect(buffer[0].context).toEqual({ key: 'value', number: 42 });
+        });
+        it('should include operation in log entry', () => {
+            testLogger.startOperation('test-operation');
+            testLogger.info('inside operation');
+            const buffer = testLogger.getBuffer();
+            expect(buffer[1].operation).toBe('test-operation');
+        });
+    });
+    describe('startOperation/endOperation', () => {
+        it('should track operation stack', () => {
+            testLogger.startOperation('op1');
+            testLogger.startOperation('op2');
+            testLogger.endOperation('op2', 100);
+            testLogger.endOperation('op1', 200);
+            const buffer = testLogger.getBuffer();
+            expect(buffer).toHaveLength(4);
+        });
+    });
+    describe('getErrorCount', () => {
+        it('should count error and fatal messages', () => {
+            testLogger.error('error 1');
+            testLogger.error('error 2');
+            testLogger.fatal('fatal');
+            testLogger.info('info');
+            expect(testLogger.getErrorCount()).toBe(3);
+        });
+    });
+    describe('getWarningCount', () => {
+        it('should count warn messages', () => {
+            testLogger.warn('warn 1');
+            testLogger.warn('warn 2');
+            testLogger.error('error');
+            expect(testLogger.getWarningCount()).toBe(2);
+        });
+    });
+});
+describe('OperationTimer', () => {
+    it('should measure operation duration', async () => {
+        const timer = new timing_1.OperationTimer();
+        timer.start('test-operation');
+        await new Promise(resolve => setTimeout(resolve, 50));
+        const duration = timer.end();
+        expect(duration).toBeGreaterThanOrEqual(50);
+        expect(duration).toBeLessThan(200);
+    });
+    it('should get current duration without ending', () => {
+        const timer = new timing_1.OperationTimer();
+        timer.start('test-operation');
+        const currentDuration = timer.getDuration();
+        expect(currentDuration).toBeGreaterThanOrEqual(0);
+        timer.end();
+    });
+});
+describe('measureTime', () => {
+    it('should measure async operation duration', async () => {
+        const operation = async () => {
+            await new Promise(resolve => setTimeout(resolve, 30));
+            return 'result';
+        };
+        const { result, duration } = await (0, timing_1.measureTime)(operation, 'async-op');
+        expect(result).toBe('result');
+        expect(duration).toBeGreaterThanOrEqual(30);
+    });
+    it('should throw error if operation fails', async () => {
+        const failingOperation = async () => {
+            await new Promise(resolve => setTimeout(resolve, 10));
+            throw new Error('operation failed');
+        };
+        await expect((0, timing_1.measureTime)(failingOperation, 'failing-op')).rejects.toThrow('operation failed');
+    });
+});
+describe('measureTimeSync', () => {
+    it('should measure sync operation duration', () => {
+        const operation = () => {
+            return 'result';
+        };
+        const { result, duration } = (0, timing_1.measureTimeSync)(operation, 'sync-op');
+        expect(result).toBe('result');
+        expect(duration).toBeGreaterThanOrEqual(0);
+    });
+});
+describe('ErrorReporter', () => {
+    let reporter;
+    beforeEach(() => {
+        reporter = new error_reporter_1.ErrorReporter();
+    });
+    describe('report', () => {
+        it('should create error report for Error object', () => {
+            const error = new Error('test error');
+            const report = reporter.report(error, { operation: 'test-op' });
+            expect(report.id).toBeDefined();
+            expect(report.error.name).toBe('Error');
+            expect(report.error.message).toBe('test error');
+            expect(report.operation).toBe('test-op');
+            expect(report.context).toEqual({ operation: 'test-op' });
+        });
+        it('should create error report with any error object', () => {
+            const error = new Error('custom error message');
+            const report = reporter.report(error, { operation: 'test' });
+            expect(report.id).toBeDefined();
+            expect(report.error.message).toBe('custom error message');
+        });
+        it('should include duration if operation was started', () => {
+            reporter.startOperation('timed-op');
+            const error = new Error('test');
+            const report = reporter.report(error);
+            expect(report.durationMs).toBeDefined();
+            expect(report.durationMs).toBeGreaterThanOrEqual(0);
+        });
+    });
+    describe('getReports', () => {
+        it('should return all reports', () => {
+            reporter.report(new Error('error 1'));
+            reporter.report(new Error('error 2'));
+            const reports = reporter.getReports();
+            expect(reports).toHaveLength(2);
+        });
+        it('should return copy of reports array', () => {
+            reporter.report(new Error('error'));
+            const reports = reporter.getReports();
+            reports.push({});
+            expect(reporter.getReports()).toHaveLength(1);
+        });
+    });
+    describe('getLastReport', () => {
+        it('should return last report', () => {
+            reporter.report(new Error('first'));
+            reporter.report(new Error('second'));
+            const last = reporter.getLastReport();
+            expect(last?.error.message).toBe('second');
+        });
+        it('should return undefined if no reports', () => {
+            const last = reporter.getLastReport();
+            expect(last).toBeUndefined();
+        });
+    });
+    describe('clearReports', () => {
+        it('should clear all reports', () => {
+            reporter.report(new Error('error'));
+            reporter.clearReports();
+            expect(reporter.getReports()).toHaveLength(0);
+        });
+    });
+    describe('suggestions', () => {
+        it('should provide suggestion based on error message patterns', () => {
+            const error = new Error('npm not found in PATH');
+            const report = reporter.report(error);
+            expect(report.suggestion).toBeDefined();
+            expect(typeof report.suggestion).toBe('string');
+        });
+        it('should provide suggestion for ENOENT errors', () => {
+            const error = new Error('ENOENT: file not found');
+            const report = reporter.report(error);
+            expect(report.suggestion).toContain('not found');
+        });
+        it('should provide suggestion for EACCES errors', () => {
+            const error = new Error('EACCES: permission denied');
+            const report = reporter.report(error);
+            expect(report.suggestion).toContain('Permission');
+        });
+    });
+});
+//# sourceMappingURL=observability.test.js.map

package/dist/core/observability/observability.test.js.map

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

package/dist/core/observability/structured-logger.d.ts

@@ -0,0 +1,53 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    FATAL = 4
+}
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    levelName: string;
+    message: string;
+    context?: Record<string, unknown>;
+    operation?: string;
+    duration?: number;
+    error?: LogError;
+}
+export interface LogError {
+    name: string;
+    message: string;
+    stack?: string;
+    code?: string;
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    enableColors: boolean;
+    enableTimestamp: boolean;
+    enableContext: boolean;
+    output: 'console' | 'file' | 'both';
+    filePath?: string;
+}
+export declare class StructuredLogger {
+    private config;
+    private buffer;
+    private operationStack;
+    constructor(config?: Partial<LoggerConfig>);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    fatal(message: string, context?: Record<string, unknown>): void;
+    private log;
+    private emit;
+    startOperation(name: string): void;
+    endOperation(name: string, duration: number): void;
+    getBuffer(): LogEntry[];
+    clearBuffer(): void;
+    setLevel(level: LogLevel): void;
+    getLastError(): LogError | undefined;
+    getErrorCount(): number;
+    getWarningCount(): number;
+}
+export declare const logger: StructuredLogger;

package/dist/core/observability/structured-logger.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.StructuredLogger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 4] = "FATAL";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+const defaultConfig = {
+    level: LogLevel.INFO,
+    enableColors: true,
+    enableTimestamp: true,
+    enableContext: true,
+    output: 'console',
+};
+class StructuredLogger {
+    constructor(config = {}) {
+        this.buffer = [];
+        this.operationStack = [];
+        this.config = { ...defaultConfig, ...config };
+    }
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, message, context);
+    }
+    info(message, context) {
+        this.log(LogLevel.INFO, message, context);
+    }
+    warn(message, context) {
+        this.log(LogLevel.WARN, message, context);
+    }
+    error(message, context) {
+        this.log(LogLevel.ERROR, message, context);
+    }
+    fatal(message, context) {
+        this.log(LogLevel.FATAL, message, context);
+    }
+    log(level, message, context) {
+        if (level < this.config.level)
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            levelName: LogLevel[level],
+            message,
+            context,
+            operation: this.operationStack[this.operationStack.length - 1],
+        };
+        this.buffer.push(entry);
+        this.emit(entry);
+    }
+    emit(entry) {
+        const parts = [];
+        if (this.config.enableTimestamp) {
+            parts.push(`[${entry.timestamp}]`);
+        }
+        parts.push(`[${entry.levelName.padEnd(5)}]`);
+        if (entry.operation) {
+            parts.push(`{${entry.operation}}`);
+        }
+        parts.push(entry.message);
+        if (this.config.enableContext && entry.context) {
+            parts.push(JSON.stringify(entry.context));
+        }
+        if (entry.error) {
+            parts.push(`ERROR: ${entry.error.name}: ${entry.error.message}`);
+            if (entry.error.stack) {
+                parts.push(entry.error.stack);
+            }
+        }
+        const output = parts.join(' ');
+        switch (entry.level) {
+            case LogLevel.DEBUG:
+                console.debug(output);
+                break;
+            case LogLevel.INFO:
+                console.info(output);
+                break;
+            case LogLevel.WARN:
+                console.warn(output);
+                break;
+            case LogLevel.ERROR:
+            case LogLevel.FATAL:
+                console.error(output);
+                break;
+        }
+    }
+    startOperation(name) {
+        this.operationStack.push(name);
+        this.info(`Started: ${name}`, { operation: name, depth: this.operationStack.length });
+    }
+    endOperation(name, duration) {
+        const currentOp = this.operationStack.pop();
+        if (currentOp !== name) {
+            this.warn(`Operation mismatch: expected ${name}, got ${currentOp}`);
+        }
+        this.info(`Completed: ${name}`, { operation: name, durationMs: duration });
+    }
+    getBuffer() {
+        return [...this.buffer];
+    }
+    clearBuffer() {
+        this.buffer = [];
+    }
+    setLevel(level) {
+        this.config.level = level;
+    }
+    getLastError() {
+        const errorEntries = this.buffer.filter(e => e.level >= LogLevel.ERROR);
+        return errorEntries[errorEntries.length - 1]?.error;
+    }
+    getErrorCount() {
+        return this.buffer.filter(e => e.level >= LogLevel.ERROR).length;
+    }
+    getWarningCount() {
+        return this.buffer.filter(e => e.level === LogLevel.WARN).length;
+    }
+}
+exports.StructuredLogger = StructuredLogger;
+exports.logger = new StructuredLogger({ level: LogLevel.INFO });
+//# sourceMappingURL=structured-logger.js.map

package/dist/core/observability/structured-logger.js.map

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

package/dist/core/observability/timing.d.ts

@@ -0,0 +1,23 @@
+export interface TimingResult {
+    duration: number;
+    success: boolean;
+    error?: Error;
+}
+export declare function Timed(operationName?: string): (target: unknown, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function TimedSync(operationName?: string): (target: unknown, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function measureTime<T>(operation: () => Promise<T>, operationName?: string): Promise<{
+    result: T;
+    duration: number;
+}>;
+export declare function measureTimeSync<T>(operation: () => T, operationName?: string): {
+    result: T;
+    duration: number;
+};
+export declare class OperationTimer {
+    private startTime;
+    private operationName;
+    start(operationName: string): void;
+    end(): number;
+    getDuration(): number;
+}
+export declare function profile<T extends (...args: unknown[]) => unknown>(fn: T, operationName?: string): T;

package/dist/core/observability/timing.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationTimer = void 0;
+exports.Timed = Timed;
+exports.TimedSync = TimedSync;
+exports.measureTime = measureTime;
+exports.measureTimeSync = measureTimeSync;
+exports.profile = profile;
+const structured_logger_1 = require("./structured-logger");
+function Timed(operationName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const opName = operationName || `${target.constructor.name}.${String(propertyKey)}`;
+            const startTime = performance.now();
+            structured_logger_1.logger.startOperation(opName);
+            try {
+                const result = await originalMethod.apply(this, args);
+                const duration = performance.now() - startTime;
+                structured_logger_1.logger.endOperation(opName, duration);
+                return result;
+            }
+            catch (error) {
+                const duration = performance.now() - startTime;
+                const err = error;
+                structured_logger_1.logger.error(`Operation failed: ${opName}`, {
+                    durationMs: duration,
+                    error: err.message,
+                    stack: err.stack,
+                });
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+function TimedSync(operationName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = function (...args) {
+            const opName = operationName || `${target.constructor.name}.${String(propertyKey)}`;
+            const startTime = performance.now();
+            structured_logger_1.logger.startOperation(opName);
+            try {
+                const result = originalMethod.apply(this, args);
+                const duration = performance.now() - startTime;
+                structured_logger_1.logger.endOperation(opName, duration);
+                return result;
+            }
+            catch (error) {
+                const duration = performance.now() - startTime;
+                const err = error;
+                structured_logger_1.logger.error(`Operation failed: ${opName}`, {
+                    durationMs: duration,
+                    error: err.message,
+                    stack: err.stack,
+                });
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+async function measureTime(operation, operationName) {
+    const name = operationName || 'anonymous-operation';
+    const startTime = performance.now();
+    structured_logger_1.logger.startOperation(name);
+    try {
+        const result = await operation();
+        const duration = performance.now() - startTime;
+        structured_logger_1.logger.endOperation(name, duration);
+        return { result, duration };
+    }
+    catch (error) {
+        const duration = performance.now() - startTime;
+        const err = error;
+        structured_logger_1.logger.error(`Operation failed: ${name}`, {
+            durationMs: duration,
+            error: err.message,
+        });
+        throw error;
+    }
+}
+function measureTimeSync(operation, operationName) {
+    const name = operationName || 'anonymous-operation';
+    const startTime = performance.now();
+    structured_logger_1.logger.startOperation(name);
+    try {
+        const result = operation();
+        const duration = performance.now() - startTime;
+        structured_logger_1.logger.endOperation(name, duration);
+        return { result, duration };
+    }
+    catch (error) {
+        const duration = performance.now() - startTime;
+        const err = error;
+        structured_logger_1.logger.error(`Operation failed: ${name}`, {
+            durationMs: duration,
+            error: err.message,
+        });
+        throw error;
+    }
+}
+class OperationTimer {
+    constructor() {
+        this.startTime = 0;
+        this.operationName = '';
+    }
+    start(operationName) {
+        this.operationName = operationName;
+        this.startTime = performance.now();
+        structured_logger_1.logger.startOperation(operationName);
+    }
+    end() {
+        const duration = performance.now() - this.startTime;
+        structured_logger_1.logger.endOperation(this.operationName, duration);
+        return duration;
+    }
+    getDuration() {
+        return performance.now() - this.startTime;
+    }
+}
+exports.OperationTimer = OperationTimer;
+function profile(fn, operationName) {
+    const name = operationName || fn.name;
+    return (async (...args) => {
+        const timer = new OperationTimer();
+        timer.start(name);
+        try {
+            const result = await fn(...args);
+            timer.end();
+            return result;
+        }
+        catch (error) {
+            timer.end();
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=timing.js.map

package/dist/core/observability/timing.js.map

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

package/dist/core/services/command-executor.service.d.ts

@@ -0,0 +1,3 @@
+export { CommandExecutor, commandExecutor, CommandResult } from '../../infrastructure/cli/command-executor';
+export { CommandWatcher, commandWatcher, CommandTrace, CommandBuilder } from '../../core/observability/command-watcher';
+export type { PlatformCheck } from '../../domain/interfaces';

package/dist/core/services/command-executor.service.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBuilder = exports.commandWatcher = exports.CommandWatcher = exports.CommandResult = exports.commandExecutor = exports.CommandExecutor = void 0;
+var command_executor_1 = require("../../infrastructure/cli/command-executor");
+Object.defineProperty(exports, "CommandExecutor", { enumerable: true, get: function () { return command_executor_1.CommandExecutor; } });
+Object.defineProperty(exports, "commandExecutor", { enumerable: true, get: function () { return command_executor_1.commandExecutor; } });
+Object.defineProperty(exports, "CommandResult", { enumerable: true, get: function () { return command_executor_1.CommandResult; } });
+var command_watcher_1 = require("../../core/observability/command-watcher");
+Object.defineProperty(exports, "CommandWatcher", { enumerable: true, get: function () { return command_watcher_1.CommandWatcher; } });
+Object.defineProperty(exports, "commandWatcher", { enumerable: true, get: function () { return command_watcher_1.commandWatcher; } });
+Object.defineProperty(exports, "CommandBuilder", { enumerable: true, get: function () { return command_watcher_1.CommandBuilder; } });
+//# sourceMappingURL=command-executor.service.js.map

package/dist/core/services/command-executor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.service.js","sourceRoot":"","sources":["../../../src/core/services/command-executor.service.ts"],"names":[],"mappings":";;;AAAA,8EAA4G;AAAnG,mHAAA,eAAe,OAAA;AAAE,mHAAA,eAAe,OAAA;AAAE,iHAAA,aAAa,OAAA;AACxD,4EAAwH;AAA/G,iHAAA,cAAc,OAAA;AAAE,iHAAA,cAAc,OAAA;AAAgB,iHAAA,cAAc,OAAA"}

package/dist/core/services/command-history.service.d.ts

@@ -0,0 +1,38 @@
+export interface HistoryEntry {
+    id: string;
+    timestamp: string;
+    command: string;
+    args: string[];
+    exitCode: number;
+    durationMs: number;
+    success: boolean;
+}
+export interface CommandHistory {
+    entries: HistoryEntry[];
+    lastUpdated: string;
+}
+export declare class CommandHistoryService {
+    private readonly historyFile;
+    private history;
+    private entryCounter;
+    constructor(repoPath?: string);
+    initialize(): Promise<void>;
+    record(command: string, args: string[], exitCode: number, durationMs: number): Promise<string>;
+    list(limit?: number, offset?: number): Promise<HistoryEntry[]>;
+    get(id: string): Promise<HistoryEntry | undefined>;
+    search(query: string): Promise<HistoryEntry[]>;
+    clear(): Promise<void>;
+    stats(): Promise<{
+        totalCommands: number;
+        successRate: string;
+        mostUsed: Array<{
+            command: string;
+            count: number;
+        }>;
+        recentCommands: number;
+    }>;
+    replay(id: string): Promise<{
+        command: string;
+        args: string[];
+    } | undefined>;
+}