@stackmemoryai/stackmemory 0.2.9 → 0.3.0

package/dist/core/digest/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/digest/types.ts"],
+  "sourcesContent": ["/**\n * Types for Hybrid Digest Generation System\n * 80% deterministic extraction, 20% AI-generated review/insights\n */\n\nimport { Frame, Anchor, Event } from '../context/frame-manager.js';\n\n/**\n * Deterministic fields extracted directly from frame data (60%)\n */\nexport interface DeterministicDigest {\n  /** Files that were modified during this frame */\n  filesModified: FileModification[];\n  /** Tests that were run */\n  testsRun: TestResult[];\n  /** Errors encountered */\n  errorsEncountered: ErrorInfo[];\n  /** Number of tool calls made */\n  toolCallCount: number;\n  /** Tool calls by type */\n  toolCallsByType: Record<string, number>;\n  /** Frame duration in seconds */\n  durationSeconds: number;\n  /** Exit status */\n  exitStatus: 'success' | 'failure' | 'partial' | 'cancelled';\n  /** Anchors by type */\n  anchorCounts: Record<string, number>;\n  /** Key decisions made (extracted from DECISION anchors) */\n  decisions: string[];\n  /** Constraints established (extracted from CONSTRAINT anchors) */\n  constraints: string[];\n  /** Risks identified (extracted from RISK anchors) */\n  risks: string[];\n}\n\nexport interface FileModification {\n  path: string;\n  operation: 'create' | 'modify' | 'delete' | 'read';\n  linesChanged?: number;\n}\n\nexport interface TestResult {\n  name: string;\n  status: 'passed' | 'failed' | 'skipped';\n  duration?: number;\n}\n\nexport interface ErrorInfo {\n  type: string;\n  message: string;\n  resolved: boolean;\n  count: number;\n}\n\n/**\n * AI-generated review fields (20%)\n * Focused on high-value insights only\n */\nexport interface AIGeneratedDigest {\n  /** One-line summary of what was accomplished */\n  summary: string;\n  /** Key insight or learning (if any) */\n  insight?: string;\n  /** Potential issue or risk spotted */\n  flaggedIssue?: string;\n  /** Generated at timestamp */\n  generatedAt: number;\n  /** Model used for generation */\n  modelUsed?: string;\n  /** Tokens used */\n  tokensUsed?: number;\n}\n\n/**\n * Complete hybrid digest combining both approaches\n */\nexport interface HybridDigest {\n  /** Frame identifier */\n  frameId: string;\n  /** Frame name/goal */\n  frameName: string;\n  /** Frame type */\n  frameType: string;\n  /** Deterministic fields (always available) */\n  deterministic: DeterministicDigest;\n  /** AI-generated fields (may be pending) */\n  aiGenerated?: AIGeneratedDigest;\n  /** Processing status */\n  status: DigestStatus;\n  /** Human-readable text representation */\n  text: string;\n  /** Version for schema evolution */\n  version: number;\n  /** Created timestamp */\n  createdAt: number;\n  /** Last updated timestamp */\n  updatedAt: number;\n}\n\nexport type DigestStatus =\n  | 'deterministic_only' // Only deterministic fields populated\n  | 'ai_pending' // Queued for AI generation\n  | 'ai_processing' // Currently being processed by AI\n  | 'complete' // Both deterministic and AI fields populated\n  | 'ai_failed'; // AI generation failed, falling back to deterministic\n\n/**\n * Digest generation request for the queue\n */\nexport interface DigestGenerationRequest {\n  frameId: string;\n  frameName: string;\n  frameType: string;\n  priority: 'low' | 'normal' | 'high';\n  createdAt: number;\n  retryCount: number;\n  maxRetries: number;\n}\n\n/**\n * Configuration for the digest generator\n */\nexport interface DigestConfig {\n  /** Enable AI generation (can be disabled for deterministic-only mode) */\n  enableAIGeneration: boolean;\n  /** Maximum tokens for AI summary */\n  maxTokens: number;\n  /** Batch size for idle processing */\n  batchSize: number;\n  /** Idle threshold in ms before processing queue */\n  idleThresholdMs: number;\n  /** Maximum retries for failed AI generation */\n  maxRetries: number;\n  /** Retry delay in ms */\n  retryDelayMs: number;\n  /** LLM provider configuration */\n  llmConfig: {\n    provider: 'anthropic' | 'openai' | 'local' | 'none';\n    model: string;\n    temperature: number;\n  };\n}\n\nexport const DEFAULT_DIGEST_CONFIG: DigestConfig = {\n  enableAIGeneration: true,\n  maxTokens: 100, // Reduced for 20% AI contribution\n  batchSize: 10, // Process more at once since smaller\n  idleThresholdMs: 3000, // 3 seconds of idle time\n  maxRetries: 2,\n  retryDelayMs: 1000,\n  llmConfig: {\n    provider: 'anthropic',\n    model: 'claude-3-haiku-20240307',\n    temperature: 0.2, // Lower for more consistent output\n  },\n};\n\n/**\n * Input for digest generation\n */\nexport interface DigestInput {\n  frame: Frame;\n  anchors: Anchor[];\n  events: Event[];\n  parentDigest?: HybridDigest;\n}\n\n/**\n * LLM provider interface for AI digest generation\n */\nexport interface DigestLLMProvider {\n  generateSummary(\n    input: DigestInput,\n    deterministic: DeterministicDigest,\n    maxTokens: number\n  ): Promise<AIGeneratedDigest>;\n}\n\n/**\n * Digest queue statistics\n */\nexport interface DigestQueueStats {\n  pending: number;\n  processing: number;\n  completed: number;\n  failed: number;\n  avgProcessingTimeMs: number;\n}\n"],
+  "mappings": "AA+IO,MAAM,wBAAsC;AAAA,EACjD,oBAAoB;AAAA,EACpB,WAAW;AAAA;AAAA,EACX,WAAW;AAAA;AAAA,EACX,iBAAiB;AAAA;AAAA,EACjB,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,IACT,UAAU;AAAA,IACV,OAAO;AAAA,IACP,aAAa;AAAA;AAAA,EACf;AACF;",
+  "names": []
+}

package/dist/core/errors/__tests__/error-handling.test.js

@@ -0,0 +1,270 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import {
+  StackMemoryError,
+  DatabaseError,
+  FrameError,
+  ValidationError,
+  ErrorCode,
+  isRetryableError,
+  getErrorMessage,
+  wrapError
+} from "../index.js";
+import {
+  retry,
+  CircuitBreaker,
+  withFallback,
+  calculateBackoff,
+  CircuitState,
+  withTimeout,
+  gracefulDegrade
+} from "../recovery.js";
+describe("Error Classes", () => {
+  describe("StackMemoryError", () => {
+    it("should create error with all properties", () => {
+      const error = new StackMemoryError({
+        code: ErrorCode.INTERNAL_ERROR,
+        message: "Test error",
+        context: { key: "value" },
+        isRetryable: true,
+        httpStatus: 500
+      });
+      expect(error.code).toBe(ErrorCode.INTERNAL_ERROR);
+      expect(error.message).toBe("Test error");
+      expect(error.context).toEqual({ key: "value" });
+      expect(error.isRetryable).toBe(true);
+      expect(error.httpStatus).toBe(500);
+      expect(error.timestamp).toBeInstanceOf(Date);
+    });
+    it("should serialize to JSON correctly", () => {
+      const error = new StackMemoryError({
+        code: ErrorCode.DB_CONNECTION_FAILED,
+        message: "Connection failed"
+      });
+      const json = error.toJSON();
+      expect(json.code).toBe(ErrorCode.DB_CONNECTION_FAILED);
+      expect(json.message).toBe("Connection failed");
+      expect(json.timestamp).toBeDefined();
+    });
+  });
+  describe("DatabaseError", () => {
+    it("should be retryable for connection failures", () => {
+      const error = new DatabaseError(
+        "Connection lost",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+      expect(error.isRetryable).toBe(true);
+    });
+    it("should not be retryable for query failures", () => {
+      const error = new DatabaseError(
+        "Invalid SQL",
+        ErrorCode.DB_QUERY_FAILED
+      );
+      expect(error.isRetryable).toBe(false);
+    });
+  });
+  describe("Error Helpers", () => {
+    it("should identify retryable errors", () => {
+      const retryable = new DatabaseError(
+        "Connection lost",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+      const nonRetryable = new ValidationError("Invalid input");
+      expect(isRetryableError(retryable)).toBe(true);
+      expect(isRetryableError(nonRetryable)).toBe(false);
+    });
+    it("should identify retryable network errors", () => {
+      const networkError = new Error("ECONNREFUSED");
+      const timeoutError = new Error("Request timeout");
+      expect(isRetryableError(networkError)).toBe(true);
+      expect(isRetryableError(timeoutError)).toBe(true);
+    });
+    it("should extract error messages safely", () => {
+      expect(getErrorMessage(new Error("Test"))).toBe("Test");
+      expect(getErrorMessage("String error")).toBe("String error");
+      expect(getErrorMessage({ message: "Object error" })).toBe("Object error");
+      expect(getErrorMessage(null)).toBe("An unknown error occurred");
+      expect(getErrorMessage(void 0)).toBe("An unknown error occurred");
+    });
+    it("should wrap errors correctly", () => {
+      const originalError = new Error("Original");
+      const wrapped = wrapError(
+        originalError,
+        "Wrapped message",
+        ErrorCode.INTERNAL_ERROR,
+        { extra: "context" }
+      );
+      expect(wrapped).toBeInstanceOf(StackMemoryError);
+      expect(wrapped.cause).toBe(originalError);
+      expect(wrapped.context).toEqual({ extra: "context" });
+    });
+    it("should not double-wrap StackMemoryErrors", () => {
+      const stackError = new FrameError("Frame error");
+      const wrapped = wrapError(stackError, "Default");
+      expect(wrapped).toBe(stackError);
+    });
+  });
+});
+describe("Recovery Utilities", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  describe("Retry Logic", () => {
+    it("should retry on failure", async () => {
+      let attempts = 0;
+      const fn = vi.fn(async () => {
+        attempts++;
+        if (attempts < 3) {
+          throw new DatabaseError("Connection lost", ErrorCode.DB_CONNECTION_FAILED);
+        }
+        return "success";
+      });
+      const result = await retry(fn, {
+        maxAttempts: 3,
+        initialDelay: 10
+      });
+      expect(result).toBe("success");
+      expect(fn).toHaveBeenCalledTimes(3);
+    });
+    it("should not retry non-retryable errors", async () => {
+      const fn = vi.fn(async () => {
+        throw new ValidationError("Invalid data");
+      });
+      await expect(
+        retry(fn, { maxAttempts: 3 })
+      ).rejects.toThrow("Invalid data");
+      expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it("should respect timeout", async () => {
+      const fn = vi.fn(async () => {
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        return "slow";
+      });
+      await expect(
+        retry(fn, { timeout: 50 })
+      ).rejects.toThrow("Operation timed out");
+    });
+    it("should calculate backoff correctly", () => {
+      const delay1 = calculateBackoff(1, 100, 1e4, 2);
+      const delay2 = calculateBackoff(2, 100, 1e4, 2);
+      const delay3 = calculateBackoff(3, 100, 1e4, 2);
+      expect(delay1).toBeGreaterThanOrEqual(100);
+      expect(delay1).toBeLessThanOrEqual(125);
+      expect(delay2).toBeGreaterThanOrEqual(200);
+      expect(delay2).toBeLessThanOrEqual(250);
+      expect(delay3).toBeGreaterThanOrEqual(400);
+      expect(delay3).toBeLessThanOrEqual(500);
+    });
+  });
+  describe("Circuit Breaker", () => {
+    it("should open after threshold failures", async () => {
+      const breaker = new CircuitBreaker("test", {
+        failureThreshold: 2,
+        resetTimeout: 100
+      });
+      const failingFn = vi.fn(async () => {
+        throw new Error("Failed");
+      });
+      await expect(breaker.execute(failingFn)).rejects.toThrow("Failed");
+      await expect(breaker.execute(failingFn)).rejects.toThrow("Failed");
+      expect(breaker.getState()).toBe(CircuitState.OPEN);
+      await expect(breaker.execute(failingFn)).rejects.toThrow(
+        "Circuit breaker test is OPEN"
+      );
+      expect(failingFn).toHaveBeenCalledTimes(2);
+    });
+    it("should transition to half-open after timeout", async () => {
+      const breaker = new CircuitBreaker("test", {
+        failureThreshold: 1,
+        resetTimeout: 50,
+        halfOpenRequests: 1
+      });
+      const fn = vi.fn(async () => {
+        throw new Error("Failed");
+      });
+      await expect(breaker.execute(fn)).rejects.toThrow();
+      expect(breaker.getState()).toBe(CircuitState.OPEN);
+      await new Promise((resolve) => setTimeout(resolve, 60));
+      const successFn = vi.fn(async () => "success");
+      const result = await breaker.execute(successFn);
+      expect(result).toBe("success");
+      expect(breaker.getState()).toBe(CircuitState.CLOSED);
+    });
+    it("should reset manually", () => {
+      const breaker = new CircuitBreaker("test", {
+        failureThreshold: 1
+      });
+      breaker.reset();
+      expect(breaker.getState()).toBe(CircuitState.CLOSED);
+    });
+  });
+  describe("Fallback Mechanism", () => {
+    it("should use fallback on primary failure", async () => {
+      const primary = vi.fn(async () => {
+        throw new Error("Primary failed");
+      });
+      const fallback1 = vi.fn(async () => "fallback result");
+      const result = await withFallback(primary, [fallback1]);
+      expect(result).toBe("fallback result");
+      expect(primary).toHaveBeenCalledTimes(1);
+      expect(fallback1).toHaveBeenCalledTimes(1);
+    });
+    it("should try multiple fallbacks", async () => {
+      const primary = vi.fn(async () => {
+        throw new Error("Primary failed");
+      });
+      const fallback1 = vi.fn(async () => {
+        throw new Error("Fallback1 failed");
+      });
+      const fallback2 = vi.fn(async () => "fallback2 result");
+      const result = await withFallback(primary, [fallback1, fallback2]);
+      expect(result).toBe("fallback2 result");
+      expect(fallback1).toHaveBeenCalledTimes(1);
+      expect(fallback2).toHaveBeenCalledTimes(1);
+    });
+    it("should throw if all attempts fail", async () => {
+      const primary = vi.fn(async () => {
+        throw new Error("Primary");
+      });
+      const fallback = vi.fn(async () => {
+        throw new Error("Fallback");
+      });
+      await expect(
+        withFallback(primary, [fallback])
+      ).rejects.toThrow("All attempts failed");
+    });
+  });
+  describe("Timeout Wrapper", () => {
+    it("should timeout long operations", async () => {
+      const slowFn = async () => {
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        return "slow";
+      };
+      await expect(
+        withTimeout(slowFn, 50, "Custom timeout")
+      ).rejects.toThrow("Custom timeout");
+    });
+    it("should complete fast operations", async () => {
+      const fastFn = async () => {
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return "fast";
+      };
+      const result = await withTimeout(fastFn, 100);
+      expect(result).toBe("fast");
+    });
+  });
+  describe("Graceful Degradation", () => {
+    it("should return default on failure", async () => {
+      const failingFn = vi.fn(async () => {
+        throw new Error("Failed");
+      });
+      const result = await gracefulDegrade(failingFn, "default");
+      expect(result).toBe("default");
+    });
+    it("should return result on success", async () => {
+      const successFn = vi.fn(async () => "success");
+      const result = await gracefulDegrade(successFn, "default");
+      expect(result).toBe("success");
+    });
+  });
+});
+//# sourceMappingURL=error-handling.test.js.map

package/dist/core/errors/__tests__/error-handling.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/errors/__tests__/error-handling.test.ts"],
+  "sourcesContent": ["/**\n * Tests for error handling system\n */\n\nimport { describe, it, expect, vi, beforeEach } from 'vitest';\nimport {\n  StackMemoryError,\n  DatabaseError,\n  FrameError,\n  TaskError,\n  ValidationError,\n  ErrorCode,\n  isRetryableError,\n  getErrorMessage,\n  wrapError,\n  isStackMemoryError,\n} from '../index.js';\nimport {\n  retry,\n  CircuitBreaker,\n  withFallback,\n  calculateBackoff,\n  CircuitState,\n  withTimeout,\n  gracefulDegrade,\n} from '../recovery.js';\n\ndescribe('Error Classes', () => {\n  describe('StackMemoryError', () => {\n    it('should create error with all properties', () => {\n      const error = new StackMemoryError({\n        code: ErrorCode.INTERNAL_ERROR,\n        message: 'Test error',\n        context: { key: 'value' },\n        isRetryable: true,\n        httpStatus: 500,\n      });\n\n      expect(error.code).toBe(ErrorCode.INTERNAL_ERROR);\n      expect(error.message).toBe('Test error');\n      expect(error.context).toEqual({ key: 'value' });\n      expect(error.isRetryable).toBe(true);\n      expect(error.httpStatus).toBe(500);\n      expect(error.timestamp).toBeInstanceOf(Date);\n    });\n\n    it('should serialize to JSON correctly', () => {\n      const error = new StackMemoryError({\n        code: ErrorCode.DB_CONNECTION_FAILED,\n        message: 'Connection failed',\n      });\n\n      const json = error.toJSON();\n      expect(json.code).toBe(ErrorCode.DB_CONNECTION_FAILED);\n      expect(json.message).toBe('Connection failed');\n      expect(json.timestamp).toBeDefined();\n    });\n  });\n\n  describe('DatabaseError', () => {\n    it('should be retryable for connection failures', () => {\n      const error = new DatabaseError(\n        'Connection lost',\n        ErrorCode.DB_CONNECTION_FAILED\n      );\n      expect(error.isRetryable).toBe(true);\n    });\n\n    it('should not be retryable for query failures', () => {\n      const error = new DatabaseError(\n        'Invalid SQL',\n        ErrorCode.DB_QUERY_FAILED\n      );\n      expect(error.isRetryable).toBe(false);\n    });\n  });\n\n  describe('Error Helpers', () => {\n    it('should identify retryable errors', () => {\n      const retryable = new DatabaseError(\n        'Connection lost',\n        ErrorCode.DB_CONNECTION_FAILED\n      );\n      const nonRetryable = new ValidationError('Invalid input');\n\n      expect(isRetryableError(retryable)).toBe(true);\n      expect(isRetryableError(nonRetryable)).toBe(false);\n    });\n\n    it('should identify retryable network errors', () => {\n      const networkError = new Error('ECONNREFUSED');\n      const timeoutError = new Error('Request timeout');\n      \n      expect(isRetryableError(networkError)).toBe(true);\n      expect(isRetryableError(timeoutError)).toBe(true);\n    });\n\n    it('should extract error messages safely', () => {\n      expect(getErrorMessage(new Error('Test'))).toBe('Test');\n      expect(getErrorMessage('String error')).toBe('String error');\n      expect(getErrorMessage({ message: 'Object error' })).toBe('Object error');\n      expect(getErrorMessage(null)).toBe('An unknown error occurred');\n      expect(getErrorMessage(undefined)).toBe('An unknown error occurred');\n    });\n\n    it('should wrap errors correctly', () => {\n      const originalError = new Error('Original');\n      const wrapped = wrapError(\n        originalError,\n        'Wrapped message',\n        ErrorCode.INTERNAL_ERROR,\n        { extra: 'context' }\n      );\n\n      expect(wrapped).toBeInstanceOf(StackMemoryError);\n      expect(wrapped.cause).toBe(originalError);\n      expect(wrapped.context).toEqual({ extra: 'context' });\n    });\n\n    it('should not double-wrap StackMemoryErrors', () => {\n      const stackError = new FrameError('Frame error');\n      const wrapped = wrapError(stackError, 'Default');\n      \n      expect(wrapped).toBe(stackError);\n    });\n  });\n});\n\ndescribe('Recovery Utilities', () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  describe('Retry Logic', () => {\n    it('should retry on failure', async () => {\n      let attempts = 0;\n      const fn = vi.fn(async () => {\n        attempts++;\n        if (attempts < 3) {\n          throw new DatabaseError('Connection lost', ErrorCode.DB_CONNECTION_FAILED);\n        }\n        return 'success';\n      });\n\n      const result = await retry(fn, {\n        maxAttempts: 3,\n        initialDelay: 10,\n      });\n\n      expect(result).toBe('success');\n      expect(fn).toHaveBeenCalledTimes(3);\n    });\n\n    it('should not retry non-retryable errors', async () => {\n      const fn = vi.fn(async () => {\n        throw new ValidationError('Invalid data');\n      });\n\n      await expect(\n        retry(fn, { maxAttempts: 3 })\n      ).rejects.toThrow('Invalid data');\n      \n      expect(fn).toHaveBeenCalledTimes(1);\n    });\n\n    it('should respect timeout', async () => {\n      const fn = vi.fn(async () => {\n        await new Promise(resolve => setTimeout(resolve, 1000));\n        return 'slow';\n      });\n\n      await expect(\n        retry(fn, { timeout: 50 })\n      ).rejects.toThrow('Operation timed out');\n    });\n\n    it('should calculate backoff correctly', () => {\n      const delay1 = calculateBackoff(1, 100, 10000, 2);\n      const delay2 = calculateBackoff(2, 100, 10000, 2);\n      const delay3 = calculateBackoff(3, 100, 10000, 2);\n\n      // Base delays without jitter\n      expect(delay1).toBeGreaterThanOrEqual(100);\n      expect(delay1).toBeLessThanOrEqual(125); // With max 25% jitter\n\n      expect(delay2).toBeGreaterThanOrEqual(200);\n      expect(delay2).toBeLessThanOrEqual(250);\n\n      expect(delay3).toBeGreaterThanOrEqual(400);\n      expect(delay3).toBeLessThanOrEqual(500);\n    });\n  });\n\n  describe('Circuit Breaker', () => {\n    it('should open after threshold failures', async () => {\n      const breaker = new CircuitBreaker('test', {\n        failureThreshold: 2,\n        resetTimeout: 100,\n      });\n\n      const failingFn = vi.fn(async () => {\n        throw new Error('Failed');\n      });\n\n      // First two failures\n      await expect(breaker.execute(failingFn)).rejects.toThrow('Failed');\n      await expect(breaker.execute(failingFn)).rejects.toThrow('Failed');\n\n      // Circuit should be open\n      expect(breaker.getState()).toBe(CircuitState.OPEN);\n\n      // Next call should fail immediately\n      await expect(breaker.execute(failingFn)).rejects.toThrow(\n        'Circuit breaker test is OPEN'\n      );\n      expect(failingFn).toHaveBeenCalledTimes(2); // Not called on open circuit\n    });\n\n    it('should transition to half-open after timeout', async () => {\n      const breaker = new CircuitBreaker('test', {\n        failureThreshold: 1,\n        resetTimeout: 50,\n        halfOpenRequests: 1,\n      });\n\n      const fn = vi.fn(async () => {\n        throw new Error('Failed');\n      });\n\n      // Open the circuit\n      await expect(breaker.execute(fn)).rejects.toThrow();\n      expect(breaker.getState()).toBe(CircuitState.OPEN);\n\n      // Wait for reset timeout\n      await new Promise(resolve => setTimeout(resolve, 60));\n\n      // Should allow one request in half-open\n      const successFn = vi.fn(async () => 'success');\n      const result = await breaker.execute(successFn);\n      \n      expect(result).toBe('success');\n      expect(breaker.getState()).toBe(CircuitState.CLOSED);\n    });\n\n    it('should reset manually', () => {\n      const breaker = new CircuitBreaker('test', {\n        failureThreshold: 1,\n      });\n\n      breaker.reset();\n      expect(breaker.getState()).toBe(CircuitState.CLOSED);\n    });\n  });\n\n  describe('Fallback Mechanism', () => {\n    it('should use fallback on primary failure', async () => {\n      const primary = vi.fn(async () => {\n        throw new Error('Primary failed');\n      });\n      const fallback1 = vi.fn(async () => 'fallback result');\n\n      const result = await withFallback(primary, [fallback1]);\n\n      expect(result).toBe('fallback result');\n      expect(primary).toHaveBeenCalledTimes(1);\n      expect(fallback1).toHaveBeenCalledTimes(1);\n    });\n\n    it('should try multiple fallbacks', async () => {\n      const primary = vi.fn(async () => {\n        throw new Error('Primary failed');\n      });\n      const fallback1 = vi.fn(async () => {\n        throw new Error('Fallback1 failed');\n      });\n      const fallback2 = vi.fn(async () => 'fallback2 result');\n\n      const result = await withFallback(primary, [fallback1, fallback2]);\n\n      expect(result).toBe('fallback2 result');\n      expect(fallback1).toHaveBeenCalledTimes(1);\n      expect(fallback2).toHaveBeenCalledTimes(1);\n    });\n\n    it('should throw if all attempts fail', async () => {\n      const primary = vi.fn(async () => {\n        throw new Error('Primary');\n      });\n      const fallback = vi.fn(async () => {\n        throw new Error('Fallback');\n      });\n\n      await expect(\n        withFallback(primary, [fallback])\n      ).rejects.toThrow('All attempts failed');\n    });\n  });\n\n  describe('Timeout Wrapper', () => {\n    it('should timeout long operations', async () => {\n      const slowFn = async () => {\n        await new Promise(resolve => setTimeout(resolve, 1000));\n        return 'slow';\n      };\n\n      await expect(\n        withTimeout(slowFn, 50, 'Custom timeout')\n      ).rejects.toThrow('Custom timeout');\n    });\n\n    it('should complete fast operations', async () => {\n      const fastFn = async () => {\n        await new Promise(resolve => setTimeout(resolve, 10));\n        return 'fast';\n      };\n\n      const result = await withTimeout(fastFn, 100);\n      expect(result).toBe('fast');\n    });\n  });\n\n  describe('Graceful Degradation', () => {\n    it('should return default on failure', async () => {\n      const failingFn = vi.fn(async () => {\n        throw new Error('Failed');\n      });\n\n      const result = await gracefulDegrade(failingFn, 'default');\n      expect(result).toBe('default');\n    });\n\n    it('should return result on success', async () => {\n      const successFn = vi.fn(async () => 'success');\n      \n      const result = await gracefulDegrade(successFn, 'default');\n      expect(result).toBe('success');\n    });\n  });\n});"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/errors/index.js

@@ -0,0 +1,239 @@
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["DB_CONNECTION_FAILED"] = "DB_001";
+  ErrorCode2["DB_QUERY_FAILED"] = "DB_002";
+  ErrorCode2["DB_TRANSACTION_FAILED"] = "DB_003";
+  ErrorCode2["DB_MIGRATION_FAILED"] = "DB_004";
+  ErrorCode2["DB_CONSTRAINT_VIOLATION"] = "DB_005";
+  ErrorCode2["DB_SCHEMA_ERROR"] = "DB_006";
+  ErrorCode2["DB_INSERT_FAILED"] = "DB_007";
+  ErrorCode2["DB_UPDATE_FAILED"] = "DB_008";
+  ErrorCode2["DB_DELETE_FAILED"] = "DB_009";
+  ErrorCode2["FRAME_NOT_FOUND"] = "FRAME_001";
+  ErrorCode2["FRAME_INVALID_STATE"] = "FRAME_002";
+  ErrorCode2["FRAME_PARENT_NOT_FOUND"] = "FRAME_003";
+  ErrorCode2["FRAME_CYCLE_DETECTED"] = "FRAME_004";
+  ErrorCode2["FRAME_ALREADY_CLOSED"] = "FRAME_005";
+  ErrorCode2["FRAME_INIT_FAILED"] = "FRAME_006";
+  ErrorCode2["FRAME_INVALID_INPUT"] = "FRAME_007";
+  ErrorCode2["FRAME_STACK_OVERFLOW"] = "FRAME_008";
+  ErrorCode2["TASK_NOT_FOUND"] = "TASK_001";
+  ErrorCode2["TASK_INVALID_STATE"] = "TASK_002";
+  ErrorCode2["TASK_DEPENDENCY_CONFLICT"] = "TASK_003";
+  ErrorCode2["TASK_CIRCULAR_DEPENDENCY"] = "TASK_004";
+  ErrorCode2["LINEAR_AUTH_FAILED"] = "LINEAR_001";
+  ErrorCode2["LINEAR_API_ERROR"] = "LINEAR_002";
+  ErrorCode2["LINEAR_SYNC_FAILED"] = "LINEAR_003";
+  ErrorCode2["LINEAR_WEBHOOK_FAILED"] = "LINEAR_004";
+  ErrorCode2["MCP_TOOL_NOT_FOUND"] = "MCP_001";
+  ErrorCode2["MCP_INVALID_PARAMS"] = "MCP_002";
+  ErrorCode2["MCP_EXECUTION_FAILED"] = "MCP_003";
+  ErrorCode2["MCP_RATE_LIMITED"] = "MCP_004";
+  ErrorCode2["PROJECT_NOT_FOUND"] = "PROJECT_001";
+  ErrorCode2["PROJECT_INVALID_PATH"] = "PROJECT_002";
+  ErrorCode2["PROJECT_GIT_ERROR"] = "PROJECT_003";
+  ErrorCode2["VALIDATION_FAILED"] = "VAL_001";
+  ErrorCode2["INVALID_INPUT"] = "VAL_002";
+  ErrorCode2["MISSING_REQUIRED_FIELD"] = "VAL_003";
+  ErrorCode2["TYPE_MISMATCH"] = "VAL_004";
+  ErrorCode2["INITIALIZATION_ERROR"] = "SYS_001";
+  ErrorCode2["NOT_FOUND"] = "SYS_002";
+  ErrorCode2["INTERNAL_ERROR"] = "SYS_003";
+  ErrorCode2["CONFIGURATION_ERROR"] = "SYS_004";
+  ErrorCode2["PERMISSION_DENIED"] = "SYS_005";
+  ErrorCode2["RESOURCE_EXHAUSTED"] = "SYS_006";
+  ErrorCode2["SERVICE_UNAVAILABLE"] = "SYS_007";
+  ErrorCode2["SYSTEM_INIT_FAILED"] = "SYS_008";
+  return ErrorCode2;
+})(ErrorCode || {});
+class StackMemoryError extends Error {
+  code;
+  context;
+  cause;
+  isRetryable;
+  httpStatus;
+  timestamp;
+  constructor(options) {
+    super(options.message);
+    this.name = this.constructor.name;
+    this.code = options.code;
+    this.context = options.context;
+    this.cause = options.cause;
+    this.isRetryable = options.isRetryable ?? false;
+    this.httpStatus = options.httpStatus ?? 500;
+    this.timestamp = /* @__PURE__ */ new Date();
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      context: this.context,
+      isRetryable: this.isRetryable,
+      httpStatus: this.httpStatus,
+      timestamp: this.timestamp.toISOString(),
+      stack: this.stack,
+      cause: this.cause?.message
+    };
+  }
+}
+class DatabaseError extends StackMemoryError {
+  constructor(message, code = "DB_002" /* DB_QUERY_FAILED */, context, cause) {
+    super({
+      code,
+      message,
+      context,
+      cause,
+      isRetryable: code === "DB_001" /* DB_CONNECTION_FAILED */,
+      httpStatus: 503
+    });
+  }
+}
+class FrameError extends StackMemoryError {
+  constructor(message, code = "FRAME_002" /* FRAME_INVALID_STATE */, context) {
+    super({
+      code,
+      message,
+      context,
+      isRetryable: false,
+      httpStatus: 400
+    });
+  }
+}
+class TaskError extends StackMemoryError {
+  constructor(message, code = "TASK_002" /* TASK_INVALID_STATE */, context) {
+    super({
+      code,
+      message,
+      context,
+      isRetryable: false,
+      httpStatus: 400
+    });
+  }
+}
+class IntegrationError extends StackMemoryError {
+  constructor(message, code = "LINEAR_002" /* LINEAR_API_ERROR */, context, cause) {
+    super({
+      code,
+      message,
+      context,
+      cause,
+      isRetryable: true,
+      httpStatus: 502
+    });
+  }
+}
+class MCPError extends StackMemoryError {
+  constructor(message, code = "MCP_003" /* MCP_EXECUTION_FAILED */, context) {
+    super({
+      code,
+      message,
+      context,
+      isRetryable: code === "MCP_004" /* MCP_RATE_LIMITED */,
+      httpStatus: code === "MCP_004" /* MCP_RATE_LIMITED */ ? 429 : 400
+    });
+  }
+}
+class ValidationError extends StackMemoryError {
+  constructor(message, code = "VAL_001" /* VALIDATION_FAILED */, context) {
+    super({
+      code,
+      message,
+      context,
+      isRetryable: false,
+      httpStatus: 400
+    });
+  }
+}
+class ProjectError extends StackMemoryError {
+  constructor(message, code = "PROJECT_001" /* PROJECT_NOT_FOUND */, context) {
+    super({
+      code,
+      message,
+      context,
+      isRetryable: false,
+      httpStatus: 404
+    });
+  }
+}
+class SystemError extends StackMemoryError {
+  constructor(message, code = "SYS_003" /* INTERNAL_ERROR */, context, cause) {
+    super({
+      code,
+      message,
+      context,
+      cause,
+      isRetryable: code === "SYS_007" /* SERVICE_UNAVAILABLE */,
+      httpStatus: 500
+    });
+  }
+}
+function isRetryableError(error) {
+  if (error instanceof StackMemoryError) {
+    return error.isRetryable;
+  }
+  if (error instanceof Error) {
+    const message = error.message.toLowerCase();
+    return message.includes("econnrefused") || message.includes("timeout") || message.includes("enotfound") || message.includes("socket hang up");
+  }
+  return false;
+}
+function getErrorMessage(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (error && typeof error === "object" && "message" in error) {
+    return String(error.message);
+  }
+  return "An unknown error occurred";
+}
+function wrapError(error, defaultMessage, code = "SYS_003" /* INTERNAL_ERROR */, context) {
+  if (error instanceof StackMemoryError) {
+    return error;
+  }
+  const cause = error instanceof Error ? error : void 0;
+  const message = error instanceof Error ? error.message : defaultMessage;
+  return new SystemError(message, code, context, cause);
+}
+function isStackMemoryError(error) {
+  return error instanceof StackMemoryError;
+}
+function createErrorHandler(defaultContext) {
+  return (error, additionalContext) => {
+    const context = { ...defaultContext, ...additionalContext };
+    if (error instanceof StackMemoryError) {
+      return new StackMemoryError({
+        code: error.code,
+        message: error.message,
+        context: { ...error.context, ...context },
+        cause: error.cause,
+        isRetryable: error.isRetryable,
+        httpStatus: error.httpStatus
+      });
+    }
+    return wrapError(error, getErrorMessage(error), "SYS_003" /* INTERNAL_ERROR */, context);
+  };
+}
+export {
+  DatabaseError,
+  ErrorCode,
+  FrameError,
+  IntegrationError,
+  MCPError,
+  ProjectError,
+  StackMemoryError,
+  SystemError,
+  TaskError,
+  ValidationError,
+  createErrorHandler,
+  getErrorMessage,
+  isRetryableError,
+  isStackMemoryError,
+  wrapError
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/errors/index.ts"],
+  "sourcesContent": ["/**\n * Custom error classes for StackMemory\n * Provides a hierarchy of error types for better error handling and debugging\n */\n\nexport enum ErrorCode {\n  // Database errors (1000-1999)\n  DB_CONNECTION_FAILED = 'DB_001',\n  DB_QUERY_FAILED = 'DB_002',\n  DB_TRANSACTION_FAILED = 'DB_003',\n  DB_MIGRATION_FAILED = 'DB_004',\n  DB_CONSTRAINT_VIOLATION = 'DB_005',\n  DB_SCHEMA_ERROR = 'DB_006',\n  DB_INSERT_FAILED = 'DB_007',\n  DB_UPDATE_FAILED = 'DB_008',\n  DB_DELETE_FAILED = 'DB_009',\n\n  // Frame errors (2000-2999)\n  FRAME_NOT_FOUND = 'FRAME_001',\n  FRAME_INVALID_STATE = 'FRAME_002',\n  FRAME_PARENT_NOT_FOUND = 'FRAME_003',\n  FRAME_CYCLE_DETECTED = 'FRAME_004',\n  FRAME_ALREADY_CLOSED = 'FRAME_005',\n  FRAME_INIT_FAILED = 'FRAME_006',\n  FRAME_INVALID_INPUT = 'FRAME_007',\n  FRAME_STACK_OVERFLOW = 'FRAME_008',\n\n  // Task errors (3000-3999)\n  TASK_NOT_FOUND = 'TASK_001',\n  TASK_INVALID_STATE = 'TASK_002',\n  TASK_DEPENDENCY_CONFLICT = 'TASK_003',\n  TASK_CIRCULAR_DEPENDENCY = 'TASK_004',\n\n  // Integration errors (4000-4999)\n  LINEAR_AUTH_FAILED = 'LINEAR_001',\n  LINEAR_API_ERROR = 'LINEAR_002',\n  LINEAR_SYNC_FAILED = 'LINEAR_003',\n  LINEAR_WEBHOOK_FAILED = 'LINEAR_004',\n\n  // MCP errors (5000-5999)\n  MCP_TOOL_NOT_FOUND = 'MCP_001',\n  MCP_INVALID_PARAMS = 'MCP_002',\n  MCP_EXECUTION_FAILED = 'MCP_003',\n  MCP_RATE_LIMITED = 'MCP_004',\n\n  // Project errors (6000-6999)\n  PROJECT_NOT_FOUND = 'PROJECT_001',\n  PROJECT_INVALID_PATH = 'PROJECT_002',\n  PROJECT_GIT_ERROR = 'PROJECT_003',\n\n  // Validation errors (7000-7999)\n  VALIDATION_FAILED = 'VAL_001',\n  INVALID_INPUT = 'VAL_002',\n  MISSING_REQUIRED_FIELD = 'VAL_003',\n  TYPE_MISMATCH = 'VAL_004',\n\n  // System errors (8000-8999)\n  INITIALIZATION_ERROR = 'SYS_001',\n  NOT_FOUND = 'SYS_002',\n  INTERNAL_ERROR = 'SYS_003',\n  CONFIGURATION_ERROR = 'SYS_004',\n  PERMISSION_DENIED = 'SYS_005',\n  RESOURCE_EXHAUSTED = 'SYS_006',\n  SERVICE_UNAVAILABLE = 'SYS_007',\n  SYSTEM_INIT_FAILED = 'SYS_008',\n}\n\nexport interface ErrorContext {\n  [key: string]: unknown;\n}\n\nexport interface StackMemoryErrorOptions {\n  code: ErrorCode;\n  message: string;\n  context?: ErrorContext;\n  cause?: Error;\n  isRetryable?: boolean;\n  httpStatus?: number;\n}\n\n/**\n * Base error class for all StackMemory errors\n */\nexport class StackMemoryError extends Error {\n  public readonly code: ErrorCode;\n  public readonly context?: ErrorContext;\n  public readonly cause?: Error;\n  public readonly isRetryable: boolean;\n  public readonly httpStatus: number;\n  public readonly timestamp: Date;\n\n  constructor(options: StackMemoryErrorOptions) {\n    super(options.message);\n    this.name = this.constructor.name;\n    this.code = options.code;\n    this.context = options.context;\n    this.cause = options.cause;\n    this.isRetryable = options.isRetryable ?? false;\n    this.httpStatus = options.httpStatus ?? 500;\n    this.timestamp = new Date();\n\n    // Maintains proper stack trace for where our error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      context: this.context,\n      isRetryable: this.isRetryable,\n      httpStatus: this.httpStatus,\n      timestamp: this.timestamp.toISOString(),\n      stack: this.stack,\n      cause: this.cause?.message,\n    };\n  }\n}\n\n/**\n * Database-related errors\n */\nexport class DatabaseError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.DB_QUERY_FAILED,\n    context?: ErrorContext,\n    cause?: Error\n  ) {\n    super({\n      code,\n      message,\n      context,\n      cause,\n      isRetryable: code === ErrorCode.DB_CONNECTION_FAILED,\n      httpStatus: 503,\n    });\n  }\n}\n\n/**\n * Frame-related errors\n */\nexport class FrameError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.FRAME_INVALID_STATE,\n    context?: ErrorContext\n  ) {\n    super({\n      code,\n      message,\n      context,\n      isRetryable: false,\n      httpStatus: 400,\n    });\n  }\n}\n\n/**\n * Task-related errors\n */\nexport class TaskError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.TASK_INVALID_STATE,\n    context?: ErrorContext\n  ) {\n    super({\n      code,\n      message,\n      context,\n      isRetryable: false,\n      httpStatus: 400,\n    });\n  }\n}\n\n/**\n * Integration errors (Linear, etc.)\n */\nexport class IntegrationError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.LINEAR_API_ERROR,\n    context?: ErrorContext,\n    cause?: Error\n  ) {\n    super({\n      code,\n      message,\n      context,\n      cause,\n      isRetryable: true,\n      httpStatus: 502,\n    });\n  }\n}\n\n/**\n * MCP-related errors\n */\nexport class MCPError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.MCP_EXECUTION_FAILED,\n    context?: ErrorContext\n  ) {\n    super({\n      code,\n      message,\n      context,\n      isRetryable: code === ErrorCode.MCP_RATE_LIMITED,\n      httpStatus: code === ErrorCode.MCP_RATE_LIMITED ? 429 : 400,\n    });\n  }\n}\n\n/**\n * Validation errors\n */\nexport class ValidationError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.VALIDATION_FAILED,\n    context?: ErrorContext\n  ) {\n    super({\n      code,\n      message,\n      context,\n      isRetryable: false,\n      httpStatus: 400,\n    });\n  }\n}\n\n/**\n * Project-related errors\n */\nexport class ProjectError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.PROJECT_NOT_FOUND,\n    context?: ErrorContext\n  ) {\n    super({\n      code,\n      message,\n      context,\n      isRetryable: false,\n      httpStatus: 404,\n    });\n  }\n}\n\n/**\n * System/Internal errors\n */\nexport class SystemError extends StackMemoryError {\n  constructor(\n    message: string,\n    code: ErrorCode = ErrorCode.INTERNAL_ERROR,\n    context?: ErrorContext,\n    cause?: Error\n  ) {\n    super({\n      code,\n      message,\n      context,\n      cause,\n      isRetryable: code === ErrorCode.SERVICE_UNAVAILABLE,\n      httpStatus: 500,\n    });\n  }\n}\n\n/**\n * Helper function to determine if an error is retryable\n */\nexport function isRetryableError(error: unknown): boolean {\n  if (error instanceof StackMemoryError) {\n    return error.isRetryable;\n  }\n  // Check for common retryable error patterns\n  if (error instanceof Error) {\n    const message = error.message.toLowerCase();\n    return (\n      message.includes('econnrefused') ||\n      message.includes('timeout') ||\n      message.includes('enotfound') ||\n      message.includes('socket hang up')\n    );\n  }\n  return false;\n}\n\n/**\n * Helper function to safely extract error message\n */\nexport function getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  if (typeof error === 'string') {\n    return error;\n  }\n  if (error && typeof error === 'object' && 'message' in error) {\n    return String(error.message);\n  }\n  return 'An unknown error occurred';\n}\n\n/**\n * Helper function to wrap unknown errors in StackMemoryError\n */\nexport function wrapError(\n  error: unknown,\n  defaultMessage: string,\n  code: ErrorCode = ErrorCode.INTERNAL_ERROR,\n  context?: ErrorContext\n): StackMemoryError {\n  if (error instanceof StackMemoryError) {\n    return error;\n  }\n\n  const cause = error instanceof Error ? error : undefined;\n  const message = error instanceof Error ? error.message : defaultMessage;\n\n  return new SystemError(message, code, context, cause);\n}\n\n/**\n * Type guard to check if error is a StackMemoryError\n */\nexport function isStackMemoryError(error: unknown): error is StackMemoryError {\n  return error instanceof StackMemoryError;\n}\n\n/**\n * Create context-aware error handler\n */\nexport function createErrorHandler(defaultContext: ErrorContext) {\n  return (error: unknown, additionalContext?: ErrorContext) => {\n    const context = { ...defaultContext, ...additionalContext };\n    \n    if (error instanceof StackMemoryError) {\n      // Create a new error with merged context since context is readonly\n      return new StackMemoryError({\n        code: error.code,\n        message: error.message,\n        context: { ...error.context, ...context },\n        cause: error.cause,\n        isRetryable: error.isRetryable,\n        httpStatus: error.httpStatus,\n      });\n    }\n\n    return wrapError(error, getErrorMessage(error), ErrorCode.INTERNAL_ERROR, context);\n  };\n}"],
+  "mappings": "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",
+  "names": ["ErrorCode"]
+}