@stackmemoryai/stackmemory 0.2.9 → 0.3.0

package/dist/core/monitoring/error-handler.js

@@ -0,0 +1,278 @@
+import { logger } from "./logger.js";
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["AUTH_FAILED"] = "AUTH_FAILED";
+  ErrorCode2["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+  ErrorCode2["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+  ErrorCode2["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+  ErrorCode2["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+  ErrorCode2["DISK_FULL"] = "DISK_FULL";
+  ErrorCode2["NOT_GIT_REPO"] = "NOT_GIT_REPO";
+  ErrorCode2["GIT_COMMAND_FAILED"] = "GIT_COMMAND_FAILED";
+  ErrorCode2["INVALID_BRANCH"] = "INVALID_BRANCH";
+  ErrorCode2["DB_CONNECTION_FAILED"] = "DB_CONNECTION_FAILED";
+  ErrorCode2["DB_QUERY_FAILED"] = "DB_QUERY_FAILED";
+  ErrorCode2["DB_CORRUPTION"] = "DB_CORRUPTION";
+  ErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  ErrorCode2["API_ERROR"] = "API_ERROR";
+  ErrorCode2["TIMEOUT"] = "TIMEOUT";
+  ErrorCode2["INVALID_INPUT"] = "INVALID_INPUT";
+  ErrorCode2["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+  ErrorCode2["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  ErrorCode2["OPERATION_FAILED"] = "OPERATION_FAILED";
+  ErrorCode2["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+class StackMemoryError extends Error {
+  code;
+  context;
+  userMessage;
+  recoverable;
+  constructor(code, message, userMessage, context = {}, recoverable = false, cause) {
+    super(message);
+    this.name = "StackMemoryError";
+    this.code = code;
+    this.context = context;
+    this.userMessage = userMessage || this.getDefaultUserMessage(code);
+    this.recoverable = recoverable;
+    if (cause && Error.captureStackTrace) {
+      Error.captureStackTrace(this, StackMemoryError);
+    }
+    logger.error(message, cause, {
+      code,
+      context,
+      recoverable,
+      userMessage: this.userMessage
+    });
+  }
+  getDefaultUserMessage(code) {
+    switch (code) {
+      case "AUTH_FAILED" /* AUTH_FAILED */:
+        return "Authentication failed. Please check your credentials and try again.";
+      case "NOT_GIT_REPO" /* NOT_GIT_REPO */:
+        return "This command requires a git repository. Please run it from within a git repository.";
+      case "PERMISSION_DENIED" /* PERMISSION_DENIED */:
+        return "Permission denied. Please check file permissions or run with appropriate privileges.";
+      case "NETWORK_ERROR" /* NETWORK_ERROR */:
+        return "Network error. Please check your internet connection and try again.";
+      case "INVALID_INPUT" /* INVALID_INPUT */:
+        return "Invalid input provided. Please check your command and try again.";
+      case "DB_CONNECTION_FAILED" /* DB_CONNECTION_FAILED */:
+        return "Database connection failed. Please try again or contact support if the issue persists.";
+      case "GIT_COMMAND_FAILED" /* GIT_COMMAND_FAILED */:
+        return "Git operation failed. Please ensure your repository is in a valid state.";
+      default:
+        return "An unexpected error occurred. Please try again or contact support.";
+    }
+  }
+  static fromNodeError(nodeError, context = {}) {
+    const code = nodeError.code;
+    switch (code) {
+      case "ENOENT":
+        return new StackMemoryError(
+          "FILE_NOT_FOUND" /* FILE_NOT_FOUND */,
+          `File or directory not found: ${nodeError.path}`,
+          "The requested file or directory was not found.",
+          { ...context, path: nodeError.path },
+          false,
+          nodeError
+        );
+      case "EACCES":
+      case "EPERM":
+        return new StackMemoryError(
+          "PERMISSION_DENIED" /* PERMISSION_DENIED */,
+          `Permission denied: ${nodeError.path}`,
+          "Permission denied. Please check file permissions.",
+          { ...context, path: nodeError.path },
+          true,
+          nodeError
+        );
+      case "ENOSPC":
+        return new StackMemoryError(
+          "DISK_FULL" /* DISK_FULL */,
+          "No space left on device",
+          "Insufficient disk space. Please free up space and try again.",
+          context,
+          true,
+          nodeError
+        );
+      case "ETIMEDOUT":
+        return new StackMemoryError(
+          "TIMEOUT" /* TIMEOUT */,
+          "Operation timed out",
+          "The operation timed out. Please try again.",
+          context,
+          true,
+          nodeError
+        );
+      default:
+        return new StackMemoryError(
+          "UNKNOWN_ERROR" /* UNKNOWN_ERROR */,
+          nodeError.message,
+          "An unexpected system error occurred.",
+          { ...context, nodeErrorCode: code },
+          false,
+          nodeError
+        );
+    }
+  }
+}
+class ErrorHandler {
+  static retryMap = /* @__PURE__ */ new Map();
+  static MAX_RETRIES = 3;
+  static handle(error, operation) {
+    if (error instanceof StackMemoryError) {
+      console.error(`\u274C ${error.userMessage}`);
+      if (error.recoverable) {
+        console.error("\u{1F4A1} This error may be recoverable. Please try again.");
+      }
+      process.exit(1);
+    }
+    if (error instanceof Error) {
+      let stackMemoryError;
+      if ("code" in error && typeof error.code === "string") {
+        stackMemoryError = StackMemoryError.fromNodeError(
+          error,
+          { operation }
+        );
+      } else {
+        stackMemoryError = new StackMemoryError(
+          "OPERATION_FAILED" /* OPERATION_FAILED */,
+          `Operation '${operation}' failed: ${error.message}`,
+          `Operation failed: ${error.message}`,
+          { operation },
+          false,
+          error
+        );
+      }
+      console.error(`\u274C ${stackMemoryError.userMessage}`);
+      if (stackMemoryError.recoverable) {
+        console.error("\u{1F4A1} This error may be recoverable. Please try again.");
+      }
+      process.exit(1);
+    }
+    const unknownError = new StackMemoryError(
+      "UNKNOWN_ERROR" /* UNKNOWN_ERROR */,
+      `Unknown error in operation '${operation}': ${String(error)}`,
+      "An unexpected error occurred.",
+      { operation, errorType: typeof error },
+      false
+    );
+    console.error(`\u274C ${unknownError.userMessage}`);
+    process.exit(1);
+  }
+  static async safeExecute(operation, operationName, fallback) {
+    try {
+      return await operation();
+    } catch (error) {
+      if (fallback !== void 0) {
+        logger.warn(`Operation '${operationName}' failed, using fallback`, {
+          error: String(error)
+        });
+        return fallback;
+      }
+      ErrorHandler.handle(error, operationName);
+    }
+  }
+  static async withRetry(operation, operationName, maxRetries = ErrorHandler.MAX_RETRIES) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      try {
+        const result = await operation();
+        ErrorHandler.retryMap.delete(operationName);
+        return result;
+      } catch (error) {
+        lastError = error;
+        if (error instanceof StackMemoryError && !error.recoverable) {
+          ErrorHandler.handle(error, operationName);
+        }
+        if (attempt === maxRetries) {
+          break;
+        }
+        const delay = Math.min(1e3 * Math.pow(2, attempt - 1), 5e3);
+        logger.warn(
+          `Attempt ${attempt}/${maxRetries} failed for '${operationName}', retrying in ${delay}ms`,
+          {
+            error: String(error)
+          }
+        );
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+    ErrorHandler.handle(
+      lastError,
+      `${operationName} (after ${maxRetries} attempts)`
+    );
+  }
+  static createCircuitBreaker(operation, operationName, threshold = 5) {
+    let failures = 0;
+    let lastFailure = 0;
+    const resetTimeout = 3e4;
+    return async () => {
+      const now = Date.now();
+      if (now - lastFailure > resetTimeout) {
+        failures = 0;
+      }
+      if (failures >= threshold) {
+        throw new StackMemoryError(
+          "OPERATION_FAILED" /* OPERATION_FAILED */,
+          `Circuit breaker open for '${operationName}'`,
+          `Operation temporarily unavailable. Please try again later.`,
+          { operationName, failures, threshold },
+          true
+        );
+      }
+      try {
+        const result = await operation();
+        failures = 0;
+        return result;
+      } catch (error) {
+        failures++;
+        lastFailure = now;
+        throw error;
+      }
+    };
+  }
+}
+const validateInput = (value, name, validator) => {
+  if (!validator(value)) {
+    throw new StackMemoryError(
+      "INVALID_INPUT" /* INVALID_INPUT */,
+      `Invalid ${name}: ${String(value)}`,
+      `Please provide a valid ${name}.`,
+      { name, value },
+      true
+    );
+  }
+};
+const validateEmail = (email) => {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  if (!emailRegex.test(email) || email.length > 254) {
+    throw new StackMemoryError(
+      "INVALID_INPUT" /* INVALID_INPUT */,
+      `Invalid email format: ${email}`,
+      "Please provide a valid email address.",
+      { email },
+      true
+    );
+  }
+};
+const validatePath = (filePath) => {
+  if (!filePath || filePath.includes("..") || filePath.includes("\0")) {
+    throw new StackMemoryError(
+      "INVALID_INPUT" /* INVALID_INPUT */,
+      `Invalid path: ${filePath}`,
+      "Invalid file path provided.",
+      { path: filePath },
+      true
+    );
+  }
+};
+export {
+  ErrorCode,
+  ErrorHandler,
+  StackMemoryError,
+  validateEmail,
+  validateInput,
+  validatePath
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/core/monitoring/error-handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/monitoring/error-handler.ts"],
+  "sourcesContent": ["/**\n * Comprehensive error handling for StackMemory CLI\n */\n\nimport { logger } from './logger.js';\n\nexport enum ErrorCode {\n  // Authentication errors\n  AUTH_FAILED = 'AUTH_FAILED',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  INVALID_CREDENTIALS = 'INVALID_CREDENTIALS',\n\n  // File system errors\n  FILE_NOT_FOUND = 'FILE_NOT_FOUND',\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  DISK_FULL = 'DISK_FULL',\n\n  // Git operation errors\n  NOT_GIT_REPO = 'NOT_GIT_REPO',\n  GIT_COMMAND_FAILED = 'GIT_COMMAND_FAILED',\n  INVALID_BRANCH = 'INVALID_BRANCH',\n\n  // Database errors\n  DB_CONNECTION_FAILED = 'DB_CONNECTION_FAILED',\n  DB_QUERY_FAILED = 'DB_QUERY_FAILED',\n  DB_CORRUPTION = 'DB_CORRUPTION',\n\n  // Network errors\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  API_ERROR = 'API_ERROR',\n  TIMEOUT = 'TIMEOUT',\n\n  // Validation errors\n  INVALID_INPUT = 'INVALID_INPUT',\n  VALIDATION_FAILED = 'VALIDATION_FAILED',\n\n  // General errors\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n  OPERATION_FAILED = 'OPERATION_FAILED',\n  CONFIGURATION_ERROR = 'CONFIGURATION_ERROR',\n}\n\nexport class StackMemoryError extends Error {\n  public readonly code: ErrorCode;\n  public readonly context: Record<string, unknown>;\n  public readonly userMessage: string;\n  public readonly recoverable: boolean;\n\n  constructor(\n    code: ErrorCode,\n    message: string,\n    userMessage?: string,\n    context: Record<string, unknown> = {},\n    recoverable: boolean = false,\n    cause?: Error\n  ) {\n    super(message);\n    this.name = 'StackMemoryError';\n    this.code = code;\n    this.context = context;\n    this.userMessage = userMessage || this.getDefaultUserMessage(code);\n    this.recoverable = recoverable;\n\n    if (cause && Error.captureStackTrace) {\n      Error.captureStackTrace(this, StackMemoryError);\n    }\n\n    // Log the error\n    logger.error(message, cause, {\n      code,\n      context,\n      recoverable,\n      userMessage: this.userMessage,\n    });\n  }\n\n  private getDefaultUserMessage(code: ErrorCode): string {\n    switch (code) {\n      case ErrorCode.AUTH_FAILED:\n        return 'Authentication failed. Please check your credentials and try again.';\n      case ErrorCode.NOT_GIT_REPO:\n        return 'This command requires a git repository. Please run it from within a git repository.';\n      case ErrorCode.PERMISSION_DENIED:\n        return 'Permission denied. Please check file permissions or run with appropriate privileges.';\n      case ErrorCode.NETWORK_ERROR:\n        return 'Network error. Please check your internet connection and try again.';\n      case ErrorCode.INVALID_INPUT:\n        return 'Invalid input provided. Please check your command and try again.';\n      case ErrorCode.DB_CONNECTION_FAILED:\n        return 'Database connection failed. Please try again or contact support if the issue persists.';\n      case ErrorCode.GIT_COMMAND_FAILED:\n        return 'Git operation failed. Please ensure your repository is in a valid state.';\n      default:\n        return 'An unexpected error occurred. Please try again or contact support.';\n    }\n  }\n\n  static fromNodeError(\n    nodeError: NodeJS.ErrnoException,\n    context: Record<string, unknown> = {}\n  ): StackMemoryError {\n    const code = nodeError.code;\n\n    switch (code) {\n      case 'ENOENT':\n        return new StackMemoryError(\n          ErrorCode.FILE_NOT_FOUND,\n          `File or directory not found: ${nodeError.path}`,\n          'The requested file or directory was not found.',\n          { ...context, path: nodeError.path },\n          false,\n          nodeError\n        );\n\n      case 'EACCES':\n      case 'EPERM':\n        return new StackMemoryError(\n          ErrorCode.PERMISSION_DENIED,\n          `Permission denied: ${nodeError.path}`,\n          'Permission denied. Please check file permissions.',\n          { ...context, path: nodeError.path },\n          true,\n          nodeError\n        );\n\n      case 'ENOSPC':\n        return new StackMemoryError(\n          ErrorCode.DISK_FULL,\n          'No space left on device',\n          'Insufficient disk space. Please free up space and try again.',\n          context,\n          true,\n          nodeError\n        );\n\n      case 'ETIMEDOUT':\n        return new StackMemoryError(\n          ErrorCode.TIMEOUT,\n          'Operation timed out',\n          'The operation timed out. Please try again.',\n          context,\n          true,\n          nodeError\n        );\n\n      default:\n        return new StackMemoryError(\n          ErrorCode.UNKNOWN_ERROR,\n          nodeError.message,\n          'An unexpected system error occurred.',\n          { ...context, nodeErrorCode: code },\n          false,\n          nodeError\n        );\n    }\n  }\n}\n\nexport class ErrorHandler {\n  private static retryMap = new Map<string, number>();\n  private static readonly MAX_RETRIES = 3;\n\n  static handle(error: unknown, operation: string): never {\n    if (error instanceof StackMemoryError) {\n      // Already a well-formed StackMemory error\n      console.error(`\u274C ${error.userMessage}`);\n\n      if (error.recoverable) {\n        console.error('\uD83D\uDCA1 This error may be recoverable. Please try again.');\n      }\n\n      process.exit(1);\n    }\n\n    if (error instanceof Error) {\n      // Convert Node.js error to StackMemoryError\n      let stackMemoryError: StackMemoryError;\n\n      if ('code' in error && typeof error.code === 'string') {\n        stackMemoryError = StackMemoryError.fromNodeError(\n          error as NodeJS.ErrnoException,\n          { operation }\n        );\n      } else {\n        stackMemoryError = new StackMemoryError(\n          ErrorCode.OPERATION_FAILED,\n          `Operation '${operation}' failed: ${error.message}`,\n          `Operation failed: ${error.message}`,\n          { operation },\n          false,\n          error\n        );\n      }\n\n      console.error(`\u274C ${stackMemoryError.userMessage}`);\n      if (stackMemoryError.recoverable) {\n        console.error('\uD83D\uDCA1 This error may be recoverable. Please try again.');\n      }\n\n      process.exit(1);\n    }\n\n    // Unknown error type\n    const unknownError = new StackMemoryError(\n      ErrorCode.UNKNOWN_ERROR,\n      `Unknown error in operation '${operation}': ${String(error)}`,\n      'An unexpected error occurred.',\n      { operation, errorType: typeof error },\n      false\n    );\n\n    console.error(`\u274C ${unknownError.userMessage}`);\n    process.exit(1);\n  }\n\n  static async safeExecute<T>(\n    operation: () => Promise<T> | T,\n    operationName: string,\n    fallback?: T\n  ): Promise<T | undefined> {\n    try {\n      return await operation();\n    } catch (error) {\n      if (fallback !== undefined) {\n        logger.warn(`Operation '${operationName}' failed, using fallback`, {\n          error: String(error),\n        });\n        return fallback;\n      }\n\n      ErrorHandler.handle(error, operationName);\n    }\n  }\n\n  static async withRetry<T>(\n    operation: () => Promise<T> | T,\n    operationName: string,\n    maxRetries: number = ErrorHandler.MAX_RETRIES\n  ): Promise<T> {\n    let lastError: unknown;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      try {\n        const result = await operation();\n        // Clear retry count on success\n        ErrorHandler.retryMap.delete(operationName);\n        return result;\n      } catch (error) {\n        lastError = error;\n\n        if (error instanceof StackMemoryError && !error.recoverable) {\n          // Don't retry non-recoverable errors\n          ErrorHandler.handle(error, operationName);\n        }\n\n        if (attempt === maxRetries) {\n          break;\n        }\n\n        const delay = Math.min(1000 * Math.pow(2, attempt - 1), 5000); // Exponential backoff\n        logger.warn(\n          `Attempt ${attempt}/${maxRetries} failed for '${operationName}', retrying in ${delay}ms`,\n          {\n            error: String(error),\n          }\n        );\n\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n    }\n\n    ErrorHandler.handle(\n      lastError,\n      `${operationName} (after ${maxRetries} attempts)`\n    );\n  }\n\n  static createCircuitBreaker<T>(\n    operation: () => Promise<T> | T,\n    operationName: string,\n    threshold: number = 5\n  ) {\n    let failures = 0;\n    let lastFailure = 0;\n    const resetTimeout = 30000; // 30 seconds\n\n    return async (): Promise<T> => {\n      const now = Date.now();\n\n      // Reset circuit breaker after timeout\n      if (now - lastFailure > resetTimeout) {\n        failures = 0;\n      }\n\n      // Circuit is open (too many failures)\n      if (failures >= threshold) {\n        throw new StackMemoryError(\n          ErrorCode.OPERATION_FAILED,\n          `Circuit breaker open for '${operationName}'`,\n          `Operation temporarily unavailable. Please try again later.`,\n          { operationName, failures, threshold },\n          true\n        );\n      }\n\n      try {\n        const result = await operation();\n        failures = 0; // Reset on success\n        return result;\n      } catch (error) {\n        failures++;\n        lastFailure = now;\n        throw error;\n      }\n    };\n  }\n}\n\n// Utility functions for common error scenarios\nexport const validateInput = (\n  value: unknown,\n  name: string,\n  validator: (val: unknown) => boolean\n): asserts value is NonNullable<unknown> => {\n  if (!validator(value)) {\n    throw new StackMemoryError(\n      ErrorCode.INVALID_INPUT,\n      `Invalid ${name}: ${String(value)}`,\n      `Please provide a valid ${name}.`,\n      { name, value },\n      true\n    );\n  }\n};\n\nexport const validateEmail = (email: string): asserts email is string => {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  if (!emailRegex.test(email) || email.length > 254) {\n    throw new StackMemoryError(\n      ErrorCode.INVALID_INPUT,\n      `Invalid email format: ${email}`,\n      'Please provide a valid email address.',\n      { email },\n      true\n    );\n  }\n};\n\nexport const validatePath = (filePath: string): asserts filePath is string => {\n  if (!filePath || filePath.includes('..') || filePath.includes('\\0')) {\n    throw new StackMemoryError(\n      ErrorCode.INVALID_INPUT,\n      `Invalid path: ${filePath}`,\n      'Invalid file path provided.',\n      { path: filePath },\n      true\n    );\n  }\n};\n"],
+  "mappings": "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",
+  "names": ["ErrorCode"]
+}

package/dist/core/monitoring/logger.js

@@ -0,0 +1,115 @@
+import * as fs from "fs";
+import * as path from "path";
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["ERROR"] = 0] = "ERROR";
+  LogLevel2[LogLevel2["WARN"] = 1] = "WARN";
+  LogLevel2[LogLevel2["INFO"] = 2] = "INFO";
+  LogLevel2[LogLevel2["DEBUG"] = 3] = "DEBUG";
+  return LogLevel2;
+})(LogLevel || {});
+class Logger {
+  static instance;
+  logLevel = 2 /* INFO */;
+  logFile;
+  constructor() {
+    const envLevel = process.env.STACKMEMORY_LOG_LEVEL?.toUpperCase();
+    switch (envLevel) {
+      case "ERROR":
+        this.logLevel = 0 /* ERROR */;
+        break;
+      case "WARN":
+        this.logLevel = 1 /* WARN */;
+        break;
+      case "DEBUG":
+        this.logLevel = 3 /* DEBUG */;
+        break;
+      default:
+        this.logLevel = 2 /* INFO */;
+    }
+    if (this.logLevel === 3 /* DEBUG */ || process.env.STACKMEMORY_LOG_FILE) {
+      this.logFile = process.env.STACKMEMORY_LOG_FILE || path.join(process.env.HOME || ".", ".stackmemory", "logs", "cli.log");
+      this.ensureLogDirectory();
+    }
+  }
+  static getInstance() {
+    if (!Logger.instance) {
+      Logger.instance = new Logger();
+    }
+    return Logger.instance;
+  }
+  ensureLogDirectory() {
+    if (this.logFile) {
+      const logDir = path.dirname(this.logFile);
+      if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+      }
+    }
+  }
+  writeLog(entry) {
+    const logLine = JSON.stringify(entry) + "\n";
+    if (this.logFile) {
+      try {
+        fs.appendFileSync(this.logFile, logLine);
+      } catch {
+      }
+    }
+    if (entry.level <= this.logLevel) {
+      const levelNames = ["ERROR", "WARN", "INFO", "DEBUG"];
+      const levelName = levelNames[entry.level] || "UNKNOWN";
+      const consoleMessage = `[${entry.timestamp}] ${levelName}: ${entry.message}`;
+      if (entry.level === 0 /* ERROR */) {
+        console.error(consoleMessage);
+        if (entry.error) {
+          console.error(entry.error.stack);
+        }
+      } else if (entry.level === 1 /* WARN */) {
+        console.warn(consoleMessage);
+      } else {
+        console.log(consoleMessage);
+      }
+    }
+  }
+  error(message, errorOrContext, context) {
+    const isError = errorOrContext instanceof Error;
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 0 /* ERROR */,
+      message,
+      context: isError ? context : errorOrContext,
+      error: isError ? errorOrContext : void 0
+    });
+  }
+  warn(message, errorOrContext) {
+    const isError = errorOrContext instanceof Error;
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 1 /* WARN */,
+      message,
+      context: isError ? void 0 : errorOrContext,
+      error: isError ? errorOrContext : void 0
+    });
+  }
+  info(message, context) {
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 2 /* INFO */,
+      message,
+      context
+    });
+  }
+  debug(message, context) {
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 3 /* DEBUG */,
+      message,
+      context
+    });
+  }
+}
+const logger = Logger.getInstance();
+export {
+  LogLevel,
+  Logger,
+  logger
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/monitoring/logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/monitoring/logger.ts"],
+  "sourcesContent": ["/**\n * Structured logging utility for StackMemory CLI\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nexport enum LogLevel {\n  ERROR = 0,\n  WARN = 1,\n  INFO = 2,\n  DEBUG = 3,\n}\n\ninterface LogEntry {\n  timestamp: string;\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\nexport class Logger {\n  private static instance: Logger;\n  private logLevel: LogLevel = LogLevel.INFO;\n  private logFile?: string;\n\n  private constructor() {\n    // Set log level from environment\n    const envLevel = process.env.STACKMEMORY_LOG_LEVEL?.toUpperCase();\n    switch (envLevel) {\n      case 'ERROR':\n        this.logLevel = LogLevel.ERROR;\n        break;\n      case 'WARN':\n        this.logLevel = LogLevel.WARN;\n        break;\n      case 'DEBUG':\n        this.logLevel = LogLevel.DEBUG;\n        break;\n      default:\n        this.logLevel = LogLevel.INFO;\n    }\n\n    // Set up log file if in debug mode or if specified\n    if (this.logLevel === LogLevel.DEBUG || process.env.STACKMEMORY_LOG_FILE) {\n      this.logFile =\n        process.env.STACKMEMORY_LOG_FILE ||\n        path.join(process.env.HOME || '.', '.stackmemory', 'logs', 'cli.log');\n      this.ensureLogDirectory();\n    }\n  }\n\n  static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n    return Logger.instance;\n  }\n\n  private ensureLogDirectory(): void {\n    if (this.logFile) {\n      const logDir = path.dirname(this.logFile);\n      if (!fs.existsSync(logDir)) {\n        fs.mkdirSync(logDir, { recursive: true });\n      }\n    }\n  }\n\n  private writeLog(entry: LogEntry): void {\n    const logLine = JSON.stringify(entry) + '\\n';\n\n    // Always write to file if configured\n    if (this.logFile) {\n      try {\n        fs.appendFileSync(this.logFile, logLine);\n      } catch {\n        // Silent failure to prevent recursive logging\n      }\n    }\n\n    // Console output based on level\n    if (entry.level <= this.logLevel) {\n      const levelNames = ['ERROR', 'WARN', 'INFO', 'DEBUG'];\n      const levelName = levelNames[entry.level] || 'UNKNOWN';\n\n      const consoleMessage = `[${entry.timestamp}] ${levelName}: ${entry.message}`;\n\n      if (entry.level === LogLevel.ERROR) {\n        console.error(consoleMessage);\n        if (entry.error) {\n          console.error(entry.error.stack);\n        }\n      } else if (entry.level === LogLevel.WARN) {\n        console.warn(consoleMessage);\n      } else {\n        console.log(consoleMessage);\n      }\n    }\n  }\n\n  error(\n    message: string,\n    errorOrContext?: Error | Record<string, unknown>,\n    context?: Record<string, unknown>\n  ): void {\n    const isError = errorOrContext instanceof Error;\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.ERROR,\n      message,\n      context: isError ? context : (errorOrContext as Record<string, unknown>),\n      error: isError ? errorOrContext : undefined,\n    });\n  }\n\n  warn(\n    message: string,\n    errorOrContext?: Error | Record<string, unknown>\n  ): void {\n    const isError = errorOrContext instanceof Error;\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.WARN,\n      message,\n      context: isError\n        ? undefined\n        : (errorOrContext as Record<string, unknown>),\n      error: isError ? errorOrContext : undefined,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.INFO,\n      message,\n      context,\n    });\n  }\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.DEBUG,\n      message,\n      context,\n    });\n  }\n}\n\n// Export singleton instance\nexport const logger = Logger.getInstance();\n"],
+  "mappings": "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",
+  "names": ["LogLevel"]
+}

package/dist/core/monitoring/metrics.js

@@ -0,0 +1,157 @@
+import { EventEmitter } from "events";
+import * as fs from "fs";
+import * as path from "path";
+import { logger } from "./logger.js";
+class MetricsCollector extends EventEmitter {
+  metrics = [];
+  metricsFile;
+  flushInterval = null;
+  aggregates = /* @__PURE__ */ new Map();
+  constructor() {
+    super();
+    if (process.env.STACKMEMORY_METRICS_ENABLED === "true") {
+      const metricsDir = path.join(
+        process.env.HOME || ".",
+        ".stackmemory",
+        "metrics"
+      );
+      if (!fs.existsSync(metricsDir)) {
+        fs.mkdirSync(metricsDir, { recursive: true });
+      }
+      this.metricsFile = path.join(
+        metricsDir,
+        `metrics-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.jsonl`
+      );
+      this.flushInterval = setInterval(() => this.flush(), 3e4);
+    }
+  }
+  async record(metric, value, tags) {
+    const entry = {
+      timestamp: /* @__PURE__ */ new Date(),
+      metric,
+      value,
+      type: "gauge",
+      tags
+    };
+    this.metrics.push(entry);
+    this.updateAggregates(metric, value);
+    this.emit("metric", entry);
+    if (this.metrics.length > 1e3) {
+      await this.flush();
+    }
+  }
+  async increment(metric, tags, value = 1) {
+    const entry = {
+      timestamp: /* @__PURE__ */ new Date(),
+      metric,
+      value,
+      type: "counter",
+      tags
+    };
+    this.metrics.push(entry);
+    this.updateAggregates(metric, value);
+    this.emit("metric", entry);
+  }
+  async timing(metric, duration, tags) {
+    const entry = {
+      timestamp: /* @__PURE__ */ new Date(),
+      metric,
+      value: duration,
+      type: "timing",
+      tags
+    };
+    this.metrics.push(entry);
+    this.updateAggregates(metric, duration);
+    this.emit("metric", entry);
+  }
+  updateAggregates(metric, value) {
+    const existing = this.aggregates.get(metric) || {
+      sum: 0,
+      count: 0,
+      min: Infinity,
+      max: -Infinity
+    };
+    this.aggregates.set(metric, {
+      sum: existing.sum + value,
+      count: existing.count + 1,
+      min: Math.min(existing.min, value),
+      max: Math.max(existing.max, value)
+    });
+  }
+  async flush() {
+    if (this.metrics.length === 0) return;
+    const toFlush = [...this.metrics];
+    this.metrics = [];
+    if (this.metricsFile) {
+      try {
+        const lines = toFlush.map((m) => JSON.stringify(m)).join("\n") + "\n";
+        await fs.promises.appendFile(this.metricsFile, lines);
+      } catch (error) {
+        logger.error(
+          "Failed to write metrics",
+          error instanceof Error ? error : new Error(String(error))
+        );
+      }
+    }
+    this.emit("flush", toFlush);
+  }
+  getStats(metric) {
+    if (metric) {
+      const stats = this.aggregates.get(metric);
+      if (!stats) return {};
+      return {
+        [metric]: {
+          ...stats,
+          avg: stats.count > 0 ? stats.sum / stats.count : 0
+        }
+      };
+    }
+    const result = {};
+    for (const [key, stats] of this.aggregates.entries()) {
+      result[key] = {
+        ...stats,
+        avg: stats.count > 0 ? stats.sum / stats.count : 0
+      };
+    }
+    return result;
+  }
+  reset() {
+    this.metrics = [];
+    this.aggregates.clear();
+  }
+  destroy() {
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+      this.flushInterval = null;
+    }
+    this.flush();
+  }
+}
+const collector = new MetricsCollector();
+process.on("beforeExit", () => collector.destroy());
+class Metrics {
+  static async record(metric, value, tags) {
+    await collector.record(metric, value, tags);
+  }
+  static async increment(metric, tags) {
+    await collector.increment(metric, tags);
+  }
+  static async timing(metric, duration, tags) {
+    await collector.timing(metric, duration, tags);
+  }
+  static getStats(metric) {
+    return collector.getStats(metric);
+  }
+  static reset() {
+    collector.reset();
+  }
+  static on(event, listener) {
+    collector.on(event, listener);
+  }
+}
+const metrics = Metrics;
+export {
+  Metrics,
+  metrics
+};
+//# sourceMappingURL=metrics.js.map

package/dist/core/monitoring/metrics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/monitoring/metrics.ts"],
+  "sourcesContent": ["import { EventEmitter } from 'events';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logger } from './logger.js';\n\ninterface MetricEntry {\n  timestamp: Date;\n  metric: string;\n  value: number;\n  type: 'counter' | 'gauge' | 'timing';\n  tags?: Record<string, string>;\n}\n\nclass MetricsCollector extends EventEmitter {\n  private metrics: MetricEntry[] = [];\n  private metricsFile?: string;\n  private flushInterval: NodeJS.Timeout | null = null;\n  private aggregates: Map<\n    string,\n    { sum: number; count: number; min: number; max: number }\n  > = new Map();\n\n  constructor() {\n    super();\n\n    // Set up metrics file if enabled\n    if (process.env.STACKMEMORY_METRICS_ENABLED === 'true') {\n      const metricsDir = path.join(\n        process.env.HOME || '.',\n        '.stackmemory',\n        'metrics'\n      );\n      if (!fs.existsSync(metricsDir)) {\n        fs.mkdirSync(metricsDir, { recursive: true });\n      }\n      this.metricsFile = path.join(\n        metricsDir,\n        `metrics-${new Date().toISOString().split('T')[0]}.jsonl`\n      );\n\n      // Flush metrics every 30 seconds\n      this.flushInterval = setInterval(() => this.flush(), 30000);\n    }\n  }\n\n  async record(\n    metric: string,\n    value: number,\n    tags?: Record<string, string>\n  ): Promise<void> {\n    const entry: MetricEntry = {\n      timestamp: new Date(),\n      metric,\n      value,\n      type: 'gauge',\n      tags,\n    };\n\n    this.metrics.push(entry);\n    this.updateAggregates(metric, value);\n    this.emit('metric', entry);\n\n    // Auto-flush if buffer is large\n    if (this.metrics.length > 1000) {\n      await this.flush();\n    }\n  }\n\n  async increment(\n    metric: string,\n    tags?: Record<string, string>,\n    value = 1\n  ): Promise<void> {\n    const entry: MetricEntry = {\n      timestamp: new Date(),\n      metric,\n      value,\n      type: 'counter',\n      tags,\n    };\n\n    this.metrics.push(entry);\n    this.updateAggregates(metric, value);\n    this.emit('metric', entry);\n  }\n\n  async timing(\n    metric: string,\n    duration: number,\n    tags?: Record<string, string>\n  ): Promise<void> {\n    const entry: MetricEntry = {\n      timestamp: new Date(),\n      metric,\n      value: duration,\n      type: 'timing',\n      tags,\n    };\n\n    this.metrics.push(entry);\n    this.updateAggregates(metric, duration);\n    this.emit('metric', entry);\n  }\n\n  private updateAggregates(metric: string, value: number): void {\n    const existing = this.aggregates.get(metric) || {\n      sum: 0,\n      count: 0,\n      min: Infinity,\n      max: -Infinity,\n    };\n\n    this.aggregates.set(metric, {\n      sum: existing.sum + value,\n      count: existing.count + 1,\n      min: Math.min(existing.min, value),\n      max: Math.max(existing.max, value),\n    });\n  }\n\n  async flush(): Promise<void> {\n    if (this.metrics.length === 0) return;\n\n    const toFlush = [...this.metrics];\n    this.metrics = [];\n\n    if (this.metricsFile) {\n      try {\n        const lines = toFlush.map((m) => JSON.stringify(m)).join('\\n') + '\\n';\n        await fs.promises.appendFile(this.metricsFile, lines);\n      } catch (error) {\n        logger.error(\n          'Failed to write metrics',\n          error instanceof Error ? error : new Error(String(error))\n        );\n      }\n    }\n\n    // Emit batch event for external processors\n    this.emit('flush', toFlush);\n  }\n\n  getStats(metric?: string): Record<string, any> {\n    if (metric) {\n      const stats = this.aggregates.get(metric);\n      if (!stats) return {};\n\n      return {\n        [metric]: {\n          ...stats,\n          avg: stats.count > 0 ? stats.sum / stats.count : 0,\n        },\n      };\n    }\n\n    const result: Record<string, any> = {};\n    for (const [key, stats] of this.aggregates.entries()) {\n      result[key] = {\n        ...stats,\n        avg: stats.count > 0 ? stats.sum / stats.count : 0,\n      };\n    }\n    return result;\n  }\n\n  reset(): void {\n    this.metrics = [];\n    this.aggregates.clear();\n  }\n\n  destroy(): void {\n    if (this.flushInterval) {\n      clearInterval(this.flushInterval);\n      this.flushInterval = null;\n    }\n    this.flush();\n  }\n}\n\n// Singleton instance\nconst collector = new MetricsCollector();\n\n// Cleanup on exit\nprocess.on('beforeExit', () => collector.destroy());\n\nexport class Metrics {\n  static async record(\n    metric: string,\n    value: number,\n    tags?: Record<string, string>\n  ): Promise<void> {\n    await collector.record(metric, value, tags);\n  }\n\n  static async increment(\n    metric: string,\n    tags?: Record<string, string>\n  ): Promise<void> {\n    await collector.increment(metric, tags);\n  }\n\n  static async timing(\n    metric: string,\n    duration: number,\n    tags?: Record<string, string>\n  ): Promise<void> {\n    await collector.timing(metric, duration, tags);\n  }\n\n  static getStats(metric?: string): Record<string, any> {\n    return collector.getStats(metric);\n  }\n\n  static reset(): void {\n    collector.reset();\n  }\n\n  static on(event: string, listener: (...args: any[]) => void): void {\n    collector.on(event, listener);\n  }\n}\n\nexport const metrics = Metrics;\n"],
+  "mappings": "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",
+  "names": []
+}