@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/core/merge/unified-merge-resolver.js

@@ -0,0 +1,303 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { v4 as uuidv4 } from "uuid";
+import { ConflictDetector } from "./conflict-detector.js";
+import { StackDiffVisualizer } from "./stack-diff.js";
+import { ResolutionEngine } from "./resolution-engine.js";
+import { logger } from "../monitoring/logger.js";
+class UnifiedMergeResolver {
+  conflictDetector;
+  diffVisualizer;
+  resolutionEngine;
+  activeSessions = /* @__PURE__ */ new Map();
+  rollbackSnapshots = /* @__PURE__ */ new Map();
+  statistics = {
+    totalConflicts: 0,
+    resolvedConflicts: 0,
+    averageResolutionTime: 0,
+    successRate: 0,
+    rollbackCount: 0
+  };
+  constructor() {
+    this.conflictDetector = new ConflictDetector();
+    this.diffVisualizer = new StackDiffVisualizer();
+    this.resolutionEngine = new ResolutionEngine();
+    logger.debug("UnifiedMergeResolver initialized");
+  }
+  /**
+   * Start a new merge session with automatic conflict detection
+   */
+  async startMergeSession(stack1, stack2, options) {
+    const sessionId = `unified-merge-${Date.now()}-${uuidv4().substring(0, 8)}`;
+    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);
+    let rollbackPoint;
+    if (options?.preserveRollback !== false) {
+      rollbackPoint = this.createRollbackSnapshot(sessionId, stack1, stack2);
+    }
+    const session = {
+      sessionId,
+      stack1,
+      stack2,
+      conflicts,
+      status: "analyzing",
+      rollbackPoint,
+      startedAt: Date.now(),
+      metadata: {
+        totalFrames: stack1.frames.length + stack2.frames.length,
+        conflictCount: conflicts.length,
+        resolvedCount: 0
+      }
+    };
+    this.activeSessions.set(sessionId, session);
+    this.statistics.totalConflicts += conflicts.length;
+    logger.info(`Merge session started: ${sessionId}`, {
+      stack1Id: stack1.id,
+      stack2Id: stack2.id,
+      conflictCount: conflicts.length
+    });
+    if (options?.autoResolve && conflicts.length > 0 && options.context) {
+      const defaultStrategy = options.strategy || "ai_suggest";
+      await this.resolveConflicts(sessionId, defaultStrategy, options.context);
+    }
+    return sessionId;
+  }
+  /**
+   * Generate a preview of the merge result
+   */
+  async generatePreview(sessionId, strategy) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const preview = this.diffVisualizer.generateMergePreview(
+      session.stack1,
+      session.stack2,
+      strategy
+    );
+    session.preview = preview;
+    session.status = "preview";
+    session.metadata.strategyUsed = strategy;
+    this.activeSessions.set(sessionId, session);
+    logger.info(`Preview generated for session: ${sessionId}`, {
+      mergedFrameCount: preview.mergedFrames.length,
+      estimatedSuccess: preview.estimatedSuccess
+    });
+    return preview;
+  }
+  /**
+   * Resolve conflicts using the specified strategy
+   */
+  async resolveConflicts(sessionId, strategy, context) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    session.status = "resolving";
+    try {
+      const result = await this.resolutionEngine.resolveConflicts(
+        session.stack1,
+        session.stack2,
+        strategy,
+        context
+      );
+      session.resolution = result.resolution;
+      session.status = result.success ? "completed" : "failed";
+      session.completedAt = Date.now();
+      session.metadata.resolvedCount = session.conflicts.filter(
+        (c) => c.resolution !== void 0
+      ).length;
+      session.metadata.strategyUsed = strategy;
+      this.activeSessions.set(sessionId, session);
+      if (result.success) {
+        this.statistics.resolvedConflicts += session.metadata.resolvedCount;
+        this.updateSuccessRate();
+        this.updateAverageResolutionTime(session);
+      }
+      logger.info(`Conflicts resolved for session: ${sessionId}`, {
+        success: result.success,
+        strategy,
+        resolvedCount: session.metadata.resolvedCount
+      });
+      return result;
+    } catch (error) {
+      session.status = "failed";
+      this.activeSessions.set(sessionId, session);
+      logger.error(
+        `Failed to resolve conflicts for session: ${sessionId}`,
+        error
+      );
+      throw error;
+    }
+  }
+  /**
+   * Rollback a merge to its original state
+   */
+  async rollback(sessionId) {
+    const session = this.activeSessions.get(sessionId);
+    if (!session || !session.rollbackPoint) {
+      logger.warn(`Cannot rollback session: ${sessionId} - no rollback point`);
+      return false;
+    }
+    const snapshot = this.rollbackSnapshots.get(session.rollbackPoint);
+    if (!snapshot) {
+      logger.error(`Rollback snapshot not found: ${session.rollbackPoint}`);
+      return false;
+    }
+    session.stack1 = snapshot.stack1;
+    session.stack2 = snapshot.stack2;
+    session.status = "rolled_back";
+    session.resolution = void 0;
+    session.conflicts = this.conflictDetector.detectConflicts(
+      snapshot.stack1,
+      snapshot.stack2
+    );
+    session.metadata.resolvedCount = 0;
+    this.activeSessions.set(sessionId, session);
+    this.statistics.rollbackCount++;
+    logger.info(`Session rolled back: ${sessionId}`);
+    return true;
+  }
+  /**
+   * Get merge session details
+   */
+  getSession(sessionId) {
+    return this.activeSessions.get(sessionId);
+  }
+  /**
+   * List all active merge sessions
+   */
+  listActiveSessions() {
+    return Array.from(this.activeSessions.values()).filter(
+      (s) => s.status !== "completed" && s.status !== "rolled_back" && s.status !== "failed"
+    );
+  }
+  /**
+   * Get merge statistics
+   */
+  getStatistics() {
+    return { ...this.statistics };
+  }
+  /**
+   * Analyze parallel solutions across stacks
+   */
+  analyzeParallelSolutions(frames) {
+    const solutions = this.conflictDetector.analyzeParallelSolutions(frames);
+    const recommendations = [];
+    if (solutions.length > 1) {
+      const grouped = /* @__PURE__ */ new Map();
+      for (const sol of solutions) {
+        const key = sol.approach.toLowerCase();
+        if (!grouped.has(key)) {
+          grouped.set(key, []);
+        }
+        grouped.get(key).push(sol);
+      }
+      for (const [approach, group] of grouped) {
+        if (group.length > 1) {
+          const avgEffectiveness = group.reduce((sum, s) => sum + (s.effectiveness || 0), 0) / group.length;
+          recommendations.push(
+            `${group.length} parallel solutions using "${approach}" approach (avg effectiveness: ${(avgEffectiveness * 100).toFixed(1)}%)`
+          );
+        }
+      }
+      const best = solutions.reduce(
+        (a, b) => (a.effectiveness || 0) > (b.effectiveness || 0) ? a : b,
+        solutions[0]
+      );
+      if (best && best.effectiveness && best.effectiveness > 0.7) {
+        recommendations.push(
+          `Recommended: Use solution from frame "${best.frameId}" (${(best.effectiveness * 100).toFixed(1)}% effectiveness)`
+        );
+      }
+    }
+    return {
+      solutions: solutions.map((s) => ({
+        frameId: s.frameId,
+        approach: s.approach,
+        effectiveness: s.effectiveness || 0
+      })),
+      recommendations
+    };
+  }
+  /**
+   * Create a visual diff between two stacks
+   */
+  createVisualDiff(baseFrame, stack1, stack2) {
+    const diff = this.diffVisualizer.visualizeDivergence(
+      baseFrame,
+      stack1,
+      stack2
+    );
+    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);
+    return {
+      nodes: diff.nodes.map((n) => ({
+        id: n.id,
+        type: n.type,
+        depth: n.frame?.depth
+      })),
+      edges: diff.edges.map((e) => ({
+        source: e.source,
+        target: e.target,
+        type: e.type
+      })),
+      conflicts: conflicts.map((c) => ({
+        frameId1: c.frameId1,
+        frameId2: c.frameId2,
+        severity: c.severity
+      }))
+    };
+  }
+  /**
+   * Close a merge session and clean up resources
+   */
+  closeSession(sessionId) {
+    const session = this.activeSessions.get(sessionId);
+    if (session) {
+      if (session.rollbackPoint) {
+        this.rollbackSnapshots.delete(session.rollbackPoint);
+      }
+      this.activeSessions.delete(sessionId);
+      logger.debug(`Session closed: ${sessionId}`);
+    }
+  }
+  // Private helpers
+  createRollbackSnapshot(sessionId, stack1, stack2) {
+    const snapshotId = `rollback-${sessionId}`;
+    this.rollbackSnapshots.set(snapshotId, {
+      stack1: this.deepCloneStack(stack1),
+      stack2: this.deepCloneStack(stack2)
+    });
+    return snapshotId;
+  }
+  deepCloneStack(stack) {
+    return {
+      ...stack,
+      frames: stack.frames.map((f) => ({ ...f })),
+      events: stack.events.map((e) => ({ ...e }))
+    };
+  }
+  updateSuccessRate() {
+    if (this.statistics.totalConflicts > 0) {
+      this.statistics.successRate = this.statistics.resolvedConflicts / this.statistics.totalConflicts;
+    }
+  }
+  updateAverageResolutionTime(session) {
+    if (session.completedAt && session.startedAt) {
+      const duration = session.completedAt - session.startedAt;
+      const completedSessions = Array.from(this.activeSessions.values()).filter(
+        (s) => s.completedAt
+      ).length;
+      if (completedSessions === 1) {
+        this.statistics.averageResolutionTime = duration;
+      } else {
+        this.statistics.averageResolutionTime = (this.statistics.averageResolutionTime * (completedSessions - 1) + duration) / completedSessions;
+      }
+    }
+  }
+}
+export {
+  UnifiedMergeResolver
+};
+//# sourceMappingURL=unified-merge-resolver.js.map

package/dist/core/merge/unified-merge-resolver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/merge/unified-merge-resolver.ts"],
+  "sourcesContent": ["/**\n * Unified Merge Resolver - STA-101\n * Bridges StackMergeResolver with advanced ConflictDetector and ResolutionEngine\n * Provides a unified interface for all merge conflict resolution scenarios\n */\n\nimport { v4 as uuidv4 } from 'uuid';\nimport type { Frame, Event } from '../context/frame-types.js';\nimport { ConflictDetector } from './conflict-detector.js';\nimport { StackDiffVisualizer, PreviewResult } from './stack-diff.js';\nimport { ResolutionEngine, ResolutionContext } from './resolution-engine.js';\nimport {\n  MergeConflict,\n  ConflictResolution,\n  ResolutionStrategy,\n  FrameStack,\n  MergeResult,\n  MergeStatistics,\n} from './types.js';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface UnifiedMergeSession {\n  sessionId: string;\n  stack1: FrameStack;\n  stack2: FrameStack;\n  conflicts: MergeConflict[];\n  resolution?: ConflictResolution;\n  status:\n    | 'analyzing'\n    | 'preview'\n    | 'resolving'\n    | 'completed'\n    | 'failed'\n    | 'rolled_back';\n  preview?: PreviewResult;\n  rollbackPoint?: string;\n  startedAt: number;\n  completedAt?: number;\n  metadata: {\n    totalFrames: number;\n    conflictCount: number;\n    resolvedCount: number;\n    strategyUsed?: ResolutionStrategy['type'];\n  };\n}\n\nexport interface MergeOptions {\n  strategy?: ResolutionStrategy['type'];\n  autoResolve?: boolean;\n  preserveRollback?: boolean;\n  notifyOnComplete?: boolean;\n  context?: ResolutionContext;\n}\n\nexport class UnifiedMergeResolver {\n  private conflictDetector: ConflictDetector;\n  private diffVisualizer: StackDiffVisualizer;\n  private resolutionEngine: ResolutionEngine;\n  private activeSessions: Map<string, UnifiedMergeSession> = new Map();\n  private rollbackSnapshots: Map<\n    string,\n    { stack1: FrameStack; stack2: FrameStack }\n  > = new Map();\n  private statistics: MergeStatistics = {\n    totalConflicts: 0,\n    resolvedConflicts: 0,\n    averageResolutionTime: 0,\n    successRate: 0,\n    rollbackCount: 0,\n  };\n\n  constructor() {\n    this.conflictDetector = new ConflictDetector();\n    this.diffVisualizer = new StackDiffVisualizer();\n    this.resolutionEngine = new ResolutionEngine();\n    logger.debug('UnifiedMergeResolver initialized');\n  }\n\n  /**\n   * Start a new merge session with automatic conflict detection\n   */\n  async startMergeSession(\n    stack1: FrameStack,\n    stack2: FrameStack,\n    options?: MergeOptions\n  ): Promise<string> {\n    const sessionId = `unified-merge-${Date.now()}-${uuidv4().substring(0, 8)}`;\n\n    // Detect conflicts\n    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);\n\n    // Create rollback snapshot if requested\n    let rollbackPoint: string | undefined;\n    if (options?.preserveRollback !== false) {\n      rollbackPoint = this.createRollbackSnapshot(sessionId, stack1, stack2);\n    }\n\n    const session: UnifiedMergeSession = {\n      sessionId,\n      stack1,\n      stack2,\n      conflicts,\n      status: 'analyzing',\n      rollbackPoint,\n      startedAt: Date.now(),\n      metadata: {\n        totalFrames: stack1.frames.length + stack2.frames.length,\n        conflictCount: conflicts.length,\n        resolvedCount: 0,\n      },\n    };\n\n    this.activeSessions.set(sessionId, session);\n    this.statistics.totalConflicts += conflicts.length;\n\n    logger.info(`Merge session started: ${sessionId}`, {\n      stack1Id: stack1.id,\n      stack2Id: stack2.id,\n      conflictCount: conflicts.length,\n    });\n\n    // Auto-resolve if requested and possible\n    if (options?.autoResolve && conflicts.length > 0 && options.context) {\n      const defaultStrategy = options.strategy || 'ai_suggest';\n      await this.resolveConflicts(sessionId, defaultStrategy, options.context);\n    }\n\n    return sessionId;\n  }\n\n  /**\n   * Generate a preview of the merge result\n   */\n  async generatePreview(\n    sessionId: string,\n    strategy: ResolutionStrategy['type']\n  ): Promise<PreviewResult> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    const preview = this.diffVisualizer.generateMergePreview(\n      session.stack1,\n      session.stack2,\n      strategy\n    );\n\n    session.preview = preview;\n    session.status = 'preview';\n    session.metadata.strategyUsed = strategy;\n\n    this.activeSessions.set(sessionId, session);\n\n    logger.info(`Preview generated for session: ${sessionId}`, {\n      mergedFrameCount: preview.mergedFrames.length,\n      estimatedSuccess: preview.estimatedSuccess,\n    });\n\n    return preview;\n  }\n\n  /**\n   * Resolve conflicts using the specified strategy\n   */\n  async resolveConflicts(\n    sessionId: string,\n    strategy: ResolutionStrategy['type'],\n    context: ResolutionContext\n  ): Promise<MergeResult> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    session.status = 'resolving';\n\n    try {\n      const result = await this.resolutionEngine.resolveConflicts(\n        session.stack1,\n        session.stack2,\n        strategy,\n        context\n      );\n\n      session.resolution = result.resolution;\n      session.status = result.success ? 'completed' : 'failed';\n      session.completedAt = Date.now();\n      session.metadata.resolvedCount = session.conflicts.filter(\n        (c) => c.resolution !== undefined\n      ).length;\n      session.metadata.strategyUsed = strategy;\n\n      this.activeSessions.set(sessionId, session);\n\n      // Update statistics\n      if (result.success) {\n        this.statistics.resolvedConflicts += session.metadata.resolvedCount;\n        this.updateSuccessRate();\n        this.updateAverageResolutionTime(session);\n      }\n\n      logger.info(`Conflicts resolved for session: ${sessionId}`, {\n        success: result.success,\n        strategy,\n        resolvedCount: session.metadata.resolvedCount,\n      });\n\n      return result;\n    } catch (error) {\n      session.status = 'failed';\n      this.activeSessions.set(sessionId, session);\n\n      logger.error(\n        `Failed to resolve conflicts for session: ${sessionId}`,\n        error\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Rollback a merge to its original state\n   */\n  async rollback(sessionId: string): Promise<boolean> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || !session.rollbackPoint) {\n      logger.warn(`Cannot rollback session: ${sessionId} - no rollback point`);\n      return false;\n    }\n\n    const snapshot = this.rollbackSnapshots.get(session.rollbackPoint);\n    if (!snapshot) {\n      logger.error(`Rollback snapshot not found: ${session.rollbackPoint}`);\n      return false;\n    }\n\n    // Restore original state\n    session.stack1 = snapshot.stack1;\n    session.stack2 = snapshot.stack2;\n    session.status = 'rolled_back';\n    session.resolution = undefined;\n    session.conflicts = this.conflictDetector.detectConflicts(\n      snapshot.stack1,\n      snapshot.stack2\n    );\n    session.metadata.resolvedCount = 0;\n\n    this.activeSessions.set(sessionId, session);\n    this.statistics.rollbackCount++;\n\n    logger.info(`Session rolled back: ${sessionId}`);\n    return true;\n  }\n\n  /**\n   * Get merge session details\n   */\n  getSession(sessionId: string): UnifiedMergeSession | undefined {\n    return this.activeSessions.get(sessionId);\n  }\n\n  /**\n   * List all active merge sessions\n   */\n  listActiveSessions(): UnifiedMergeSession[] {\n    return Array.from(this.activeSessions.values()).filter(\n      (s) =>\n        s.status !== 'completed' &&\n        s.status !== 'rolled_back' &&\n        s.status !== 'failed'\n    );\n  }\n\n  /**\n   * Get merge statistics\n   */\n  getStatistics(): MergeStatistics {\n    return { ...this.statistics };\n  }\n\n  /**\n   * Analyze parallel solutions across stacks\n   */\n  analyzeParallelSolutions(frames: Frame[]): {\n    solutions: Array<{\n      frameId: string;\n      approach: string;\n      effectiveness: number;\n    }>;\n    recommendations: string[];\n  } {\n    const solutions = this.conflictDetector.analyzeParallelSolutions(frames);\n\n    const recommendations: string[] = [];\n    if (solutions.length > 1) {\n      // Group by similar solutions\n      const grouped = new Map<string, typeof solutions>();\n      for (const sol of solutions) {\n        const key = sol.approach.toLowerCase();\n        if (!grouped.has(key)) {\n          grouped.set(key, []);\n        }\n        grouped.get(key)!.push(sol);\n      }\n\n      // Generate recommendations\n      for (const [approach, group] of grouped) {\n        if (group.length > 1) {\n          const avgEffectiveness =\n            group.reduce((sum, s) => sum + (s.effectiveness || 0), 0) /\n            group.length;\n          recommendations.push(\n            `${group.length} parallel solutions using \"${approach}\" approach (avg effectiveness: ${(avgEffectiveness * 100).toFixed(1)}%)`\n          );\n        }\n      }\n\n      // Find best solution\n      const best = solutions.reduce(\n        (a, b) => ((a.effectiveness || 0) > (b.effectiveness || 0) ? a : b),\n        solutions[0]\n      );\n      if (best && best.effectiveness && best.effectiveness > 0.7) {\n        recommendations.push(\n          `Recommended: Use solution from frame \"${best.frameId}\" (${(best.effectiveness * 100).toFixed(1)}% effectiveness)`\n        );\n      }\n    }\n\n    return {\n      solutions: solutions.map((s) => ({\n        frameId: s.frameId,\n        approach: s.approach,\n        effectiveness: s.effectiveness || 0,\n      })),\n      recommendations,\n    };\n  }\n\n  /**\n   * Create a visual diff between two stacks\n   */\n  createVisualDiff(\n    baseFrame: Frame,\n    stack1: FrameStack,\n    stack2: FrameStack\n  ): {\n    nodes: Array<{ id: string; type: string; depth?: number }>;\n    edges: Array<{ source: string; target: string; type: string }>;\n    conflicts: Array<{ frameId1: string; frameId2: string; severity: string }>;\n  } {\n    const diff = this.diffVisualizer.visualizeDivergence(\n      baseFrame,\n      stack1,\n      stack2\n    );\n    const conflicts = this.conflictDetector.detectConflicts(stack1, stack2);\n\n    return {\n      nodes: diff.nodes.map((n) => ({\n        id: n.id,\n        type: n.type,\n        depth: n.frame?.depth,\n      })),\n      edges: diff.edges.map((e) => ({\n        source: e.source,\n        target: e.target,\n        type: e.type,\n      })),\n      conflicts: conflicts.map((c) => ({\n        frameId1: c.frameId1,\n        frameId2: c.frameId2,\n        severity: c.severity,\n      })),\n    };\n  }\n\n  /**\n   * Close a merge session and clean up resources\n   */\n  closeSession(sessionId: string): void {\n    const session = this.activeSessions.get(sessionId);\n    if (session) {\n      // Clean up rollback snapshot\n      if (session.rollbackPoint) {\n        this.rollbackSnapshots.delete(session.rollbackPoint);\n      }\n      this.activeSessions.delete(sessionId);\n\n      logger.debug(`Session closed: ${sessionId}`);\n    }\n  }\n\n  // Private helpers\n\n  private createRollbackSnapshot(\n    sessionId: string,\n    stack1: FrameStack,\n    stack2: FrameStack\n  ): string {\n    const snapshotId = `rollback-${sessionId}`;\n\n    // Deep clone stacks\n    this.rollbackSnapshots.set(snapshotId, {\n      stack1: this.deepCloneStack(stack1),\n      stack2: this.deepCloneStack(stack2),\n    });\n\n    return snapshotId;\n  }\n\n  private deepCloneStack(stack: FrameStack): FrameStack {\n    return {\n      ...stack,\n      frames: stack.frames.map((f) => ({ ...f })),\n      events: stack.events.map((e) => ({ ...e })),\n    };\n  }\n\n  private updateSuccessRate(): void {\n    if (this.statistics.totalConflicts > 0) {\n      this.statistics.successRate =\n        this.statistics.resolvedConflicts / this.statistics.totalConflicts;\n    }\n  }\n\n  private updateAverageResolutionTime(session: UnifiedMergeSession): void {\n    if (session.completedAt && session.startedAt) {\n      const duration = session.completedAt - session.startedAt;\n      const completedSessions = Array.from(this.activeSessions.values()).filter(\n        (s) => s.completedAt\n      ).length;\n\n      if (completedSessions === 1) {\n        this.statistics.averageResolutionTime = duration;\n      } else {\n        // Running average\n        this.statistics.averageResolutionTime =\n          (this.statistics.averageResolutionTime * (completedSessions - 1) +\n            duration) /\n          completedSessions;\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/monitoring/logger.js

@@ -4,16 +4,63 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
 import * as fs from "fs";
 import * as path from "path";
-function getEnv(key, defaultValue) {
-  const value = process.env[key];
-  if (value === void 0) {
-    if (defaultValue !== void 0) return defaultValue;
-    throw new Error(`Environment variable ${key} is required`);
+const SENSITIVE_PATTERNS = [
+  /\b(api[_-]?key|apikey)\s*[:=]\s*['"]?[\w-]+['"]?/gi,
+  /\b(secret|password|token|credential|auth)\s*[:=]\s*['"]?[\w-]+['"]?/gi,
+  /\b(lin_api_[\w]+)/gi,
+  /\b(lin_oauth_[\w]+)/gi,
+  /\b(sk-[\w]+)/gi,
+  /\b(npm_[\w]+)/gi,
+  /\b(ghp_[\w]+)/gi,
+  /\b(ghs_[\w]+)/gi,
+  /Bearer\s+[\w.-]+/gi,
+  /Basic\s+[\w=]+/gi,
+  /postgres(ql)?:\/\/[^@\s]+:[^@\s]+@/gi
+];
+const SENSITIVE_FIELD_NAMES = [
+  "password",
+  "token",
+  "apikey",
+  "api_key",
+  "secret",
+  "credential",
+  "authorization",
+  "auth",
+  "accesstoken",
+  "access_token",
+  "refreshtoken",
+  "refresh_token"
+];
+function redactString(input) {
+  let result = input;
+  for (const pattern of SENSITIVE_PATTERNS) {
+    pattern.lastIndex = 0;
+    result = result.replace(pattern, "[REDACTED]");
   }
-  return value;
+  return result;
 }
-function getOptionalEnv(key) {
-  return process.env[key];
+function sanitizeForLogging(obj) {
+  if (obj === null || obj === void 0) {
+    return obj;
+  }
+  if (typeof obj === "string") {
+    return redactString(obj);
+  }
+  if (Array.isArray(obj)) {
+    return obj.map(sanitizeForLogging);
+  }
+  if (typeof obj === "object") {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+      if (SENSITIVE_FIELD_NAMES.some((sf) => key.toLowerCase().includes(sf))) {
+        sanitized[key] = "[REDACTED]";
+      } else {
+        sanitized[key] = sanitizeForLogging(value);
+      }
+    }
+    return sanitized;
+  }
+  return obj;
 }
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2[LogLevel2["ERROR"] = 0] = "ERROR";
@@ -75,7 +122,12 @@ class Logger {
     }
   }
   writeLog(entry) {
-    const logLine = JSON.stringify(entry) + "\n";
+    const sanitizedEntry = {
+      ...entry,
+      message: redactString(entry.message),
+      context: entry.context ? sanitizeForLogging(entry.context) : void 0
+    };
+    const logLine = JSON.stringify(sanitizedEntry) + "\n";
     if (this.logFile) {
       try {
         fs.appendFileSync(this.logFile, logLine);

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

@@ -1,7 +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// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new Error(`Environment variable ${key} is required`);\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\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  private fileLoggingDisabledNotified = false;\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 (\n      this.logLevel === LogLevel.DEBUG ||\n      process.env['STACKMEMORY_LOG_FILE']\n    ) {\n      this.logFile =\n        process.env['STACKMEMORY_LOG_FILE'] ||\n        path.join(\n          process.env['HOME'] || '.',\n          '.stackmemory',\n          'logs',\n          'cli.log'\n        );\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) return;\n    const logDir = path.dirname(this.logFile);\n    try {\n      if (!fs.existsSync(logDir)) {\n        fs.mkdirSync(logDir, { recursive: true });\n      }\n    } catch (err: unknown) {\n      // Disable file logging if we cannot create the directory (e.g., ENOSPC)\n      this.logFile = undefined;\n      if (!this.fileLoggingDisabledNotified) {\n        this.fileLoggingDisabledNotified = true;\n        // Emit a single warning to console so we don't spam output\n        const msg =\n          '[Logger] File logging disabled (failed to create log directory). Falling back to console only.';\n        // Use console directly to avoid recursion\n\n        console.warn(msg);\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 (err: unknown) {\n        // Disable file logging on error (e.g., ENOSPC) to avoid repeated failures\n        this.logFile = undefined;\n        if (!this.fileLoggingDisabledNotified) {\n          this.fileLoggingDisabledNotified = true;\n          const msg =\n            '[Logger] File logging disabled (write failed). Falling back to console only.';\n\n          console.warn(msg);\n        }\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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",
+  "sourcesContent": ["/**\n * Structured logging utility for StackMemory CLI\n * Includes automatic sensitive data redaction for security\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n/**\n * Sensitive data patterns that should be redacted from logs\n */\nconst SENSITIVE_PATTERNS = [\n  /\\b(api[_-]?key|apikey)\\s*[:=]\\s*['\"]?[\\w-]+['\"]?/gi,\n  /\\b(secret|password|token|credential|auth)\\s*[:=]\\s*['\"]?[\\w-]+['\"]?/gi,\n  /\\b(lin_api_[\\w]+)/gi,\n  /\\b(lin_oauth_[\\w]+)/gi,\n  /\\b(sk-[\\w]+)/gi,\n  /\\b(npm_[\\w]+)/gi,\n  /\\b(ghp_[\\w]+)/gi,\n  /\\b(ghs_[\\w]+)/gi,\n  /Bearer\\s+[\\w.-]+/gi,\n  /Basic\\s+[\\w=]+/gi,\n  /postgres(ql)?:\\/\\/[^@\\s]+:[^@\\s]+@/gi,\n];\n\nconst SENSITIVE_FIELD_NAMES = [\n  'password',\n  'token',\n  'apikey',\n  'api_key',\n  'secret',\n  'credential',\n  'authorization',\n  'auth',\n  'accesstoken',\n  'access_token',\n  'refreshtoken',\n  'refresh_token',\n];\n\n/**\n * Redact sensitive data from a string\n */\nfunction redactString(input: string): string {\n  let result = input;\n  for (const pattern of SENSITIVE_PATTERNS) {\n    pattern.lastIndex = 0;\n    result = result.replace(pattern, '[REDACTED]');\n  }\n  return result;\n}\n\n/**\n * Recursively sanitize an object for logging\n */\nfunction sanitizeForLogging(obj: unknown): unknown {\n  if (obj === null || obj === undefined) {\n    return obj;\n  }\n\n  if (typeof obj === 'string') {\n    return redactString(obj);\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(sanitizeForLogging);\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      if (SENSITIVE_FIELD_NAMES.some((sf) => key.toLowerCase().includes(sf))) {\n        sanitized[key] = '[REDACTED]';\n      } else {\n        sanitized[key] = sanitizeForLogging(value);\n      }\n    }\n    return sanitized;\n  }\n\n  return obj;\n}\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  private fileLoggingDisabledNotified = false;\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 (\n      this.logLevel === LogLevel.DEBUG ||\n      process.env['STACKMEMORY_LOG_FILE']\n    ) {\n      this.logFile =\n        process.env['STACKMEMORY_LOG_FILE'] ||\n        path.join(\n          process.env['HOME'] || '.',\n          '.stackmemory',\n          'logs',\n          'cli.log'\n        );\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) return;\n    const logDir = path.dirname(this.logFile);\n    try {\n      if (!fs.existsSync(logDir)) {\n        fs.mkdirSync(logDir, { recursive: true });\n      }\n    } catch (err: unknown) {\n      // Disable file logging if we cannot create the directory (e.g., ENOSPC)\n      this.logFile = undefined;\n      if (!this.fileLoggingDisabledNotified) {\n        this.fileLoggingDisabledNotified = true;\n        // Emit a single warning to console so we don't spam output\n        const msg =\n          '[Logger] File logging disabled (failed to create log directory). Falling back to console only.';\n        // Use console directly to avoid recursion\n\n        console.warn(msg);\n      }\n    }\n  }\n\n  private writeLog(entry: LogEntry): void {\n    // Sanitize context and message to prevent logging sensitive data\n    const sanitizedEntry: LogEntry = {\n      ...entry,\n      message: redactString(entry.message),\n      context: entry.context\n        ? (sanitizeForLogging(entry.context) as Record<string, unknown>)\n        : undefined,\n    };\n    const logLine = JSON.stringify(sanitizedEntry) + '\\n';\n\n    // Always write to file if configured\n    if (this.logFile) {\n      try {\n        fs.appendFileSync(this.logFile, logLine);\n      } catch (err: unknown) {\n        // Disable file logging on error (e.g., ENOSPC) to avoid repeated failures\n        this.logFile = undefined;\n        if (!this.fileLoggingDisabledNotified) {\n          this.fileLoggingDisabledNotified = true;\n          const msg =\n            '[Logger] File logging disabled (write failed). Falling back to console only.';\n\n          console.warn(msg);\n        }\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/security/index.js

@@ -0,0 +1,35 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import {
+  SENSITIVE_PATTERNS,
+  redactSensitiveData,
+  containsSensitiveData,
+  sanitizeForLogging,
+  sanitizeForSqlLike,
+  sanitizeIdentifier,
+  validateTableName,
+  sanitizeFilePath,
+  InputSchemas,
+  validateInput,
+  createAggregateSchema,
+  validateShellArg,
+  safeJsonParse
+} from "./input-sanitizer.js";
+export {
+  InputSchemas,
+  SENSITIVE_PATTERNS,
+  containsSensitiveData,
+  createAggregateSchema,
+  redactSensitiveData,
+  safeJsonParse,
+  sanitizeFilePath,
+  sanitizeForLogging,
+  sanitizeForSqlLike,
+  sanitizeIdentifier,
+  validateInput,
+  validateShellArg,
+  validateTableName
+};
+//# sourceMappingURL=index.js.map

package/dist/core/security/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/security/index.ts"],
+  "sourcesContent": ["/**\n * Security module exports\n * Provides centralized security utilities for the application\n */\n\nexport {\n  // Sensitive data handling\n  SENSITIVE_PATTERNS,\n  redactSensitiveData,\n  containsSensitiveData,\n  sanitizeForLogging,\n\n  // SQL safety\n  sanitizeForSqlLike,\n  sanitizeIdentifier,\n  validateTableName,\n\n  // File path safety\n  sanitizeFilePath,\n\n  // Input validation\n  InputSchemas,\n  validateInput,\n  createAggregateSchema,\n\n  // Shell command safety\n  validateShellArg,\n\n  // JSON safety\n  safeJsonParse,\n} from './input-sanitizer.js';\n"],
+  "mappings": ";;;;AAKA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EAGA;AAAA,OACK;",
+  "names": []
+}