@evolith/smart-cli 1.1.2 → 1.1.3

package/dist/infrastructure/observability/command-watcher.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBuilder = exports.commandWatcher = exports.CommandWatcher = void 0;
+const api_1 = require("@opentelemetry/api");
+const structured_logger_1 = require("./structured-logger");
+const command_executor_1 = require("../../infrastructure/cli/command-executor");
+const otel_tracing_1 = require("./otel-tracing");
+class CommandWatcher {
+    constructor() {
+        this.traces = [];
+        this.currentTrace = null;
+    }
+    async executeWithTrace(command, cwd, platformCheck) {
+        const trace = {
+            id: this.generateTraceId(),
+            command,
+            cwd,
+            startTime: new Date().toISOString(),
+        };
+        this.currentTrace = trace;
+        this.traces.push(trace);
+        const otelEnabled = (0, otel_tracing_1.isOtelEnabled)();
+        const span = otelEnabled
+            ? otel_tracing_1.cliTracer.startSpan(`cli.exec.${command.split(' ')[0]}`, {
+                attributes: {
+                    'cli.trace_id': trace.id,
+                    'cli.command': command,
+                    'cli.cwd': cwd ?? '',
+                },
+            })
+            : null;
+        structured_logger_1.logger.info(`Executing command: ${command}`, {
+            traceId: trace.id,
+            cwd,
+            platform: platformCheck?.name,
+        });
+        if (platformCheck) {
+            const check = await command_executor_1.commandExecutor.checkTool(platformCheck.name, platformCheck.command);
+            trace.platformCheck = {
+                name: check.name,
+                available: check.available,
+                version: check.version,
+            };
+            if (!check.available) {
+                structured_logger_1.logger.warn(`Platform ${check.name} not available`, {
+                    traceId: trace.id,
+                    installHint: check.installHint,
+                });
+            }
+        }
+        const startTime = performance.now();
+        try {
+            const result = await command_executor_1.commandExecutor.execute(command, cwd);
+            const durationMs = performance.now() - startTime;
+            trace.endTime = new Date().toISOString();
+            trace.durationMs = durationMs;
+            trace.exitCode = result.exitCode;
+            trace.success = result.success;
+            trace.stdout = result.stdout;
+            trace.stderr = result.stderr;
+            if (otelEnabled && span) {
+                span.setAttributes({
+                    'cli.duration_ms': durationMs,
+                    'cli.exit_code': result.exitCode,
+                    'cli.success': result.success,
+                });
+                span.setStatus({ code: api_1.SpanStatusCode.OK });
+                span.end();
+            }
+            if (result.success) {
+                structured_logger_1.logger.info(`Command succeeded: ${command}`, {
+                    traceId: trace.id,
+                    durationMs,
+                    exitCode: result.exitCode,
+                });
+            }
+            else {
+                structured_logger_1.logger.error(`Command failed: ${command}`, {
+                    traceId: trace.id,
+                    durationMs,
+                    exitCode: result.exitCode,
+                    stderr: result.stderr,
+                });
+            }
+            this.currentTrace = null;
+            return trace;
+        }
+        catch (error) {
+            const durationMs = performance.now() - startTime;
+            const err = error;
+            trace.endTime = new Date().toISOString();
+            trace.durationMs = durationMs;
+            trace.success = false;
+            trace.stderr = err.message;
+            if (otelEnabled && span) {
+                span.setAttributes({
+                    'cli.duration_ms': durationMs,
+                    'cli.exit_code': -1,
+                    'cli.success': false,
+                });
+                span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: err.message });
+                span.recordException(err);
+                span.end();
+            }
+            structured_logger_1.logger.error(`Command exception: ${command}`, {
+                traceId: trace.id,
+                durationMs,
+                error: err.message,
+                stack: err.stack,
+            });
+            this.currentTrace = null;
+            throw error;
+        }
+    }
+    generateTraceId() {
+        return `CMD-${Date.now().toString(36).toUpperCase()}-${Math.random().toString(36).substring(2, 6).toUpperCase()}`;
+    }
+    getTraces() {
+        return [...this.traces];
+    }
+    getLastTrace() {
+        return this.traces[this.traces.length - 1];
+    }
+    getFailedTraces() {
+        return this.traces.filter(t => t.success === false);
+    }
+    getSuccessfulTraces() {
+        return this.traces.filter(t => t.success === true);
+    }
+    clearTraces() {
+        this.traces = [];
+    }
+    printSummary() {
+        const total = this.traces.length;
+        const succeeded = this.getSuccessfulTraces().length;
+        const failed = this.getFailedTraces().length;
+        const totalDuration = this.traces.reduce((sum, t) => sum + (t.durationMs || 0), 0);
+        structured_logger_1.logger.info('Command Execution Summary', {
+            total,
+            succeeded,
+            failed,
+            totalDurationMs: totalDuration,
+            avgDurationMs: total > 0 ? Math.round(totalDuration / total) : 0,
+        });
+        if (failed > 0) {
+            structured_logger_1.logger.warn(`\nFailed commands (${failed}):`);
+            this.getFailedTraces().forEach(trace => {
+                console.log(`  - [${trace.id}] ${trace.command}`);
+                console.log(`    Exit code: ${trace.exitCode}`);
+                console.log(`    Duration: ${trace.durationMs}ms`);
+                if (trace.stderr) {
+                    console.log(`    Error: ${trace.stderr.substring(0, 100)}`);
+                }
+            });
+        }
+    }
+    async checkPlatformAndReport(name, versionCommand) {
+        const check = await command_executor_1.commandExecutor.checkTool(name, versionCommand);
+        structured_logger_1.logger.info(`Platform check: ${name}`, {
+            available: check.available,
+            version: check.version,
+            installHint: check.installHint,
+        });
+        return check.available;
+    }
+}
+exports.CommandWatcher = CommandWatcher;
+exports.commandWatcher = new CommandWatcher();
+class CommandBuilder {
+    constructor(command) {
+        this.parts = [];
+        this.traceEnabled = true;
+        if (command) {
+            this.parts = command.split(' ');
+        }
+    }
+    append(arg) {
+        this.parts.push(arg);
+        return this;
+    }
+    withCwd(cwd) {
+        this.cwd = cwd;
+        return this;
+    }
+    disableTrace() {
+        this.traceEnabled = false;
+        return this;
+    }
+    build() {
+        return this.parts.join(' ');
+    }
+    async execute() {
+        const command = this.build();
+        const watcher = new CommandWatcher();
+        return watcher.executeWithTrace(command, this.cwd);
+    }
+}
+exports.CommandBuilder = CommandBuilder;
+//# sourceMappingURL=command-watcher.js.map

package/dist/infrastructure/observability/command-watcher.js.map

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

package/dist/infrastructure/observability/error-reporter.d.ts

@@ -0,0 +1,47 @@
+export interface ErrorReport {
+    id: string;
+    timestamp: string;
+    error: {
+        name: string;
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+    context: Record<string, unknown>;
+    operation?: string;
+    durationMs?: number;
+    suggestion?: string;
+}
+export interface ErrorContext {
+    operation?: string;
+    command?: string;
+    phase?: string;
+    tool?: string;
+    file?: string;
+    config?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare class ErrorReporter {
+    private reports;
+    private operationStartTime;
+    startOperation(operationName: string): void;
+    report(error: unknown, context?: ErrorContext): ErrorReport;
+    private createReport;
+    private emitReport;
+    private getSuggestionForCode;
+    private getSuggestionForError;
+    private generateId;
+    getReports(): ErrorReport[];
+    getLastReport(): ErrorReport | undefined;
+    clearReports(): void;
+    printSummary(): void;
+}
+export declare const errorReporter: ErrorReporter;
+export declare function withErrorReporting<T extends (...args: unknown[]) => Promise<unknown>>(operation: T, operationName?: string): T;
+export declare class OperationContext {
+    private static currentContext;
+    static set(key: string, value: unknown): void;
+    static get(key: string): unknown;
+    static clear(): void;
+    static getAll(): Record<string, unknown>;
+}

package/dist/infrastructure/observability/error-reporter.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationContext = exports.errorReporter = exports.ErrorReporter = void 0;
+exports.withErrorReporting = withErrorReporting;
+const structured_logger_1 = require("./structured-logger");
+const errors_1 = require("@evolith/core-domain/domain/errors");
+class ErrorReporter {
+    constructor() {
+        this.reports = [];
+        this.operationStartTime = 0;
+    }
+    startOperation(operationName) {
+        this.operationStartTime = performance.now();
+        structured_logger_1.logger.startOperation(operationName);
+    }
+    report(error, context) {
+        const report = this.createReport(error, context);
+        this.reports.push(report);
+        this.emitReport(report);
+        return report;
+    }
+    createReport(error, context) {
+        const now = new Date();
+        const durationMs = this.operationStartTime
+            ? performance.now() - this.operationStartTime
+            : undefined;
+        let errorInfo;
+        let suggestion;
+        if ((0, errors_1.isEvolithError)(error)) {
+            errorInfo = {
+                name: error.name,
+                message: error.message,
+                code: error.code,
+                stack: error.stack,
+            };
+            suggestion = this.getSuggestionForCode(error.code);
+        }
+        else if (error instanceof Error) {
+            errorInfo = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+            suggestion = this.getSuggestionForError(error);
+        }
+        else {
+            errorInfo = {
+                name: 'Unknown',
+                message: String(error),
+            };
+        }
+        return {
+            id: this.generateId(),
+            timestamp: now.toISOString(),
+            error: errorInfo,
+            context: context || {},
+            operation: context?.operation,
+            durationMs,
+            suggestion,
+        };
+    }
+    emitReport(report) {
+        structured_logger_1.logger.error(report.error.message, {
+            errorId: report.id,
+            errorCode: report.error.code,
+            operation: report.operation,
+            durationMs: report.durationMs,
+            context: report.context,
+        });
+        if (report.suggestion) {
+            structured_logger_1.logger.info(`Suggestion: ${report.suggestion}`);
+        }
+    }
+    getSuggestionForCode(code) {
+        const suggestions = {
+            PLATFORM_NOT_FOUND: 'Install the required platform or check if it is in your PATH',
+            PHASE_TRANSITION_ERROR: 'Check that you are transitioning to the correct next phase',
+            CATALOG_LOAD_ERROR: 'Check that catalog files exist in the config directory',
+            TOOL_VALIDATION_ERROR: 'Verify the tool is supported by Evolith',
+            COMMAND_EXECUTION_ERROR: 'Check command syntax and that the tool is installed',
+            VALIDATION_ERROR: 'Review validation errors and fix the input',
+        };
+        return suggestions[code] || 'Check the error message for details';
+    }
+    getSuggestionForError(error) {
+        if (error.message.includes('ENOENT')) {
+            return 'File or directory not found. Check the path and ensure it exists.';
+        }
+        if (error.message.includes('EACCES')) {
+            return 'Permission denied. Check file/directory permissions.';
+        }
+        if (error.message.includes('ENOEXEC')) {
+            return 'Executable not found. Install the required tool.';
+        }
+        return 'An unexpected error occurred. Check logs for details.';
+    }
+    generateId() {
+        return `ERR-${Date.now().toString(36).toUpperCase()}-${Math.random().toString(36).substring(2, 7).toUpperCase()}`;
+    }
+    getReports() {
+        return [...this.reports];
+    }
+    getLastReport() {
+        return this.reports[this.reports.length - 1];
+    }
+    clearReports() {
+        this.reports = [];
+    }
+    printSummary() {
+        if (this.reports.length === 0) {
+            structured_logger_1.logger.info('No errors reported.');
+            return;
+        }
+        structured_logger_1.logger.info(`Error Summary: ${this.reports.length} error(s)`);
+        this.reports.forEach((report, index) => {
+            structured_logger_1.logger.error(`\n[${index + 1}] ${report.error.name}: ${report.error.message}`);
+            if (report.error.code) {
+                structured_logger_1.logger.error(`    Code: ${report.error.code}`);
+            }
+            if (report.operation) {
+                structured_logger_1.logger.error(`    Operation: ${report.operation}`);
+            }
+            if (report.suggestion) {
+                structured_logger_1.logger.error(`    Suggestion: ${report.suggestion}`);
+            }
+        });
+    }
+}
+exports.ErrorReporter = ErrorReporter;
+exports.errorReporter = new ErrorReporter();
+function withErrorReporting(operation, operationName) {
+    const name = operationName || operation.name;
+    return (async (...args) => {
+        const reporter = new ErrorReporter();
+        reporter.startOperation(name);
+        try {
+            const result = await reporter.report(await operation(...args), { operation: name });
+            return result;
+        }
+        catch (error) {
+            reporter.report(error, { operation: name });
+            reporter.printSummary();
+            throw error;
+        }
+    });
+}
+class OperationContext {
+    static set(key, value) {
+        this.currentContext[key] = value;
+    }
+    static get(key) {
+        return this.currentContext[key];
+    }
+    static clear() {
+        this.currentContext = {};
+    }
+    static getAll() {
+        return { ...this.currentContext };
+    }
+}
+exports.OperationContext = OperationContext;
+OperationContext.currentContext = {};
+//# sourceMappingURL=error-reporter.js.map

package/dist/infrastructure/observability/error-reporter.js.map

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

package/dist/infrastructure/observability/index.d.ts

@@ -0,0 +1,11 @@
+export { StructuredLogger, logger, LogLevel } from './structured-logger';
+export type { LogEntry, LogError, LoggerConfig } from './structured-logger';
+export { Timed, TimedSync, measureTime, measureTimeSync, OperationTimer, profile, } from './timing';
+export type { TimingResult } from './timing';
+export { ErrorReporter, errorReporter, withErrorReporting, OperationContext, } from './error-reporter';
+export type { ErrorReport, ErrorContext } from './error-reporter';
+export { CommandWatcher, commandWatcher, CommandBuilder } from './command-watcher';
+export type { CommandTrace } from './command-watcher';
+export { ToolUsageTelemetry } from './tool-usage-telemetry.service';
+export type { ToolUsageEvent, ToolUsageStats, TelemetryReport } from './tool-usage-telemetry.service';
+export { initCliOtel, shutdownCliOtel, isOtelEnabled, cliTracer } from './otel-tracing';

package/dist/infrastructure/observability/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliTracer = exports.isOtelEnabled = exports.shutdownCliOtel = exports.initCliOtel = exports.ToolUsageTelemetry = exports.CommandBuilder = exports.commandWatcher = exports.CommandWatcher = exports.OperationContext = exports.withErrorReporting = exports.errorReporter = exports.ErrorReporter = exports.profile = exports.OperationTimer = exports.measureTimeSync = exports.measureTime = exports.TimedSync = exports.Timed = exports.LogLevel = exports.logger = exports.StructuredLogger = void 0;
+var structured_logger_1 = require("./structured-logger");
+Object.defineProperty(exports, "StructuredLogger", { enumerable: true, get: function () { return structured_logger_1.StructuredLogger; } });
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return structured_logger_1.logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return structured_logger_1.LogLevel; } });
+var timing_1 = require("./timing");
+Object.defineProperty(exports, "Timed", { enumerable: true, get: function () { return timing_1.Timed; } });
+Object.defineProperty(exports, "TimedSync", { enumerable: true, get: function () { return timing_1.TimedSync; } });
+Object.defineProperty(exports, "measureTime", { enumerable: true, get: function () { return timing_1.measureTime; } });
+Object.defineProperty(exports, "measureTimeSync", { enumerable: true, get: function () { return timing_1.measureTimeSync; } });
+Object.defineProperty(exports, "OperationTimer", { enumerable: true, get: function () { return timing_1.OperationTimer; } });
+Object.defineProperty(exports, "profile", { enumerable: true, get: function () { return timing_1.profile; } });
+var error_reporter_1 = require("./error-reporter");
+Object.defineProperty(exports, "ErrorReporter", { enumerable: true, get: function () { return error_reporter_1.ErrorReporter; } });
+Object.defineProperty(exports, "errorReporter", { enumerable: true, get: function () { return error_reporter_1.errorReporter; } });
+Object.defineProperty(exports, "withErrorReporting", { enumerable: true, get: function () { return error_reporter_1.withErrorReporting; } });
+Object.defineProperty(exports, "OperationContext", { enumerable: true, get: function () { return error_reporter_1.OperationContext; } });
+var command_watcher_1 = require("./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; } });
+var tool_usage_telemetry_service_1 = require("./tool-usage-telemetry.service");
+Object.defineProperty(exports, "ToolUsageTelemetry", { enumerable: true, get: function () { return tool_usage_telemetry_service_1.ToolUsageTelemetry; } });
+var otel_tracing_1 = require("./otel-tracing");
+Object.defineProperty(exports, "initCliOtel", { enumerable: true, get: function () { return otel_tracing_1.initCliOtel; } });
+Object.defineProperty(exports, "shutdownCliOtel", { enumerable: true, get: function () { return otel_tracing_1.shutdownCliOtel; } });
+Object.defineProperty(exports, "isOtelEnabled", { enumerable: true, get: function () { return otel_tracing_1.isOtelEnabled; } });
+Object.defineProperty(exports, "cliTracer", { enumerable: true, get: function () { return otel_tracing_1.cliTracer; } });
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/observability/index.ts"],"names":[],"mappings":";;;AAAA,yDAAyE;AAAhE,qHAAA,gBAAgB,OAAA;AAAE,2GAAA,MAAM,OAAA;AAAE,6GAAA,QAAQ,OAAA;AAE3C,mCAOkB;AANhB,+FAAA,KAAK,OAAA;AACL,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AACX,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,iGAAA,OAAO,OAAA;AAGT,mDAK0B;AAJxB,+GAAA,aAAa,OAAA;AACb,+GAAA,aAAa,OAAA;AACb,oHAAA,kBAAkB,OAAA;AAClB,kHAAA,gBAAgB,OAAA;AAGlB,qDAAmF;AAA1E,iHAAA,cAAc,OAAA;AAAE,iHAAA,cAAc,OAAA;AAAE,iHAAA,cAAc,OAAA;AAEvD,+EAAoE;AAA3D,kIAAA,kBAAkB,OAAA;AAE3B,+CAAwF;AAA/E,2GAAA,WAAW,OAAA;AAAE,+GAAA,eAAe,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,yGAAA,SAAS,OAAA"}

package/dist/infrastructure/observability/otel-tracing.d.ts

@@ -0,0 +1,4 @@
+export declare function initCliOtel(): void;
+export declare function shutdownCliOtel(): Promise<void>;
+export declare function isOtelEnabled(): boolean;
+export declare const cliTracer: import("@opentelemetry/api").Tracer;

package/dist/infrastructure/observability/otel-tracing.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliTracer = void 0;
+exports.initCliOtel = initCliOtel;
+exports.shutdownCliOtel = shutdownCliOtel;
+exports.isOtelEnabled = isOtelEnabled;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const api_1 = require("@opentelemetry/api");
+const g = globalThis;
+function initCliOtel() {
+    if (g.__otelInitialized)
+        return;
+    if (process.env.OTEL_ENABLED !== 'true')
+        return;
+    const sdk = new sdk_node_1.NodeSDK({
+        traceExporter: new exporter_trace_otlp_http_1.OTLPTraceExporter(),
+        serviceName: 'evolith-cli',
+    });
+    sdk.start();
+    g.__otelSdk = sdk;
+    g.__otelInitialized = true;
+}
+async function shutdownCliOtel() {
+    if (g.__otelSdk) {
+        await g.__otelSdk.shutdown();
+        g.__otelSdk = undefined;
+    }
+}
+function isOtelEnabled() {
+    return g.__otelInitialized ?? false;
+}
+exports.cliTracer = api_1.trace.getTracer('evolith-cli');
+//# sourceMappingURL=otel-tracing.js.map

package/dist/infrastructure/observability/otel-tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-tracing.js","sourceRoot":"","sources":["../../../src/infrastructure/observability/otel-tracing.ts"],"names":[],"mappings":";;;AAMA,kCAYC;AAED,0CAKC;AAED,sCAEC;AA7BD,sDAAkD;AAClD,sFAA4E;AAC5E,4CAA2C;AAE3C,MAAM,CAAC,GAAG,UAAkE,CAAC;AAE7E,SAAgB,WAAW;IACzB,IAAI,CAAC,CAAC,iBAAiB;QAAE,OAAO;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM;QAAE,OAAO;IAEhD,MAAM,GAAG,GAAG,IAAI,kBAAO,CAAC;QACtB,aAAa,EAAE,IAAI,4CAAiB,EAAE;QACtC,WAAW,EAAE,aAAa;KAC3B,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC;IAClB,CAAC,CAAC,iBAAiB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAEM,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,CAAC,CAAC,iBAAiB,IAAI,KAAK,CAAC;AACtC,CAAC;AAEY,QAAA,SAAS,GAAG,WAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC"}

package/dist/infrastructure/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;