@stackmemoryai/stackmemory 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/dist/agents/core/agent-task-manager.js +5 -5
  2. package/dist/agents/core/agent-task-manager.js.map +2 -2
  3. package/dist/agents/verifiers/base-verifier.js +2 -2
  4. package/dist/agents/verifiers/base-verifier.js.map +2 -2
  5. package/dist/cli/claude-sm.js +0 -11
  6. package/dist/cli/claude-sm.js.map +2 -2
  7. package/dist/cli/codex-sm.js +0 -11
  8. package/dist/cli/codex-sm.js.map +2 -2
  9. package/dist/cli/commands/chromadb.js +64 -34
  10. package/dist/cli/commands/chromadb.js.map +2 -2
  11. package/dist/cli/commands/clear.js +9 -13
  12. package/dist/cli/commands/clear.js.map +2 -2
  13. package/dist/cli/commands/config.js +43 -33
  14. package/dist/cli/commands/config.js.map +2 -2
  15. package/dist/cli/commands/context.js.map +2 -2
  16. package/dist/cli/commands/dashboard.js +41 -13
  17. package/dist/cli/commands/dashboard.js.map +2 -2
  18. package/dist/cli/commands/gc.js +69 -20
  19. package/dist/cli/commands/gc.js.map +2 -2
  20. package/dist/cli/commands/handoff.js.map +2 -2
  21. package/dist/cli/commands/infinite-storage.js +60 -19
  22. package/dist/cli/commands/infinite-storage.js.map +2 -2
  23. package/dist/cli/commands/linear-create.js +36 -8
  24. package/dist/cli/commands/linear-create.js.map +2 -2
  25. package/dist/cli/commands/linear-list.js +33 -10
  26. package/dist/cli/commands/linear-list.js.map +2 -2
  27. package/dist/cli/commands/linear-migrate.js +17 -4
  28. package/dist/cli/commands/linear-migrate.js.map +2 -2
  29. package/dist/cli/commands/linear-test.js +14 -6
  30. package/dist/cli/commands/linear-test.js.map +2 -2
  31. package/dist/cli/commands/linear-unified.js +123 -35
  32. package/dist/cli/commands/linear-unified.js.map +2 -2
  33. package/dist/cli/commands/linear.js.map +2 -2
  34. package/dist/cli/commands/monitor.js.map +2 -2
  35. package/dist/cli/commands/onboard.js +35 -8
  36. package/dist/cli/commands/onboard.js.map +2 -2
  37. package/dist/cli/commands/quality.js +2 -7
  38. package/dist/cli/commands/quality.js.map +2 -2
  39. package/dist/cli/commands/session.js +23 -6
  40. package/dist/cli/commands/session.js.map +2 -2
  41. package/dist/cli/commands/skills.js +72 -27
  42. package/dist/cli/commands/skills.js.map +2 -2
  43. package/dist/cli/commands/storage.js +108 -38
  44. package/dist/cli/commands/storage.js.map +2 -2
  45. package/dist/cli/commands/tui.js.map +2 -2
  46. package/dist/cli/commands/webhook.js +57 -18
  47. package/dist/cli/commands/webhook.js.map +2 -2
  48. package/dist/cli/commands/workflow.js +8 -15
  49. package/dist/cli/commands/workflow.js.map +2 -2
  50. package/dist/cli/commands/worktree.js +34 -13
  51. package/dist/cli/commands/worktree.js.map +2 -2
  52. package/dist/cli/index.js +0 -11
  53. package/dist/cli/index.js.map +2 -2
  54. package/dist/core/config/types.js.map +1 -1
  55. package/dist/core/context/auto-context.js +10 -6
  56. package/dist/core/context/auto-context.js.map +2 -2
  57. package/dist/core/context/context-bridge.js.map +2 -2
  58. package/dist/core/context/frame-database.js +13 -3
  59. package/dist/core/context/frame-database.js.map +2 -2
  60. package/dist/core/context/frame-digest.js +7 -5
  61. package/dist/core/context/frame-digest.js.map +2 -2
  62. package/dist/core/context/frame-manager.js.map +2 -2
  63. package/dist/core/context/frame-stack.js +16 -5
  64. package/dist/core/context/frame-stack.js.map +2 -2
  65. package/dist/core/context/incremental-gc.js +10 -3
  66. package/dist/core/context/incremental-gc.js.map +2 -2
  67. package/dist/core/context/index.js.map +1 -1
  68. package/dist/core/context/permission-manager.js.map +2 -2
  69. package/dist/core/context/recursive-context-manager.js +582 -0
  70. package/dist/core/context/recursive-context-manager.js.map +7 -0
  71. package/dist/core/context/refactored-frame-manager.js +12 -3
  72. package/dist/core/context/refactored-frame-manager.js.map +2 -2
  73. package/dist/core/context/shared-context-layer.js +4 -2
  74. package/dist/core/context/shared-context-layer.js.map +2 -2
  75. package/dist/core/database/batch-operations.js +112 -86
  76. package/dist/core/database/batch-operations.js.map +2 -2
  77. package/dist/core/database/query-cache.js +19 -9
  78. package/dist/core/database/query-cache.js.map +2 -2
  79. package/dist/core/database/sqlite-adapter.js +1 -1
  80. package/dist/core/database/sqlite-adapter.js.map +2 -2
  81. package/dist/core/digest/enhanced-hybrid-digest.js +8 -2
  82. package/dist/core/digest/enhanced-hybrid-digest.js.map +2 -2
  83. package/dist/core/errors/recovery.js +9 -2
  84. package/dist/core/errors/recovery.js.map +2 -2
  85. package/dist/core/execution/parallel-executor.js +254 -0
  86. package/dist/core/execution/parallel-executor.js.map +7 -0
  87. package/dist/core/frame/workflow-templates-stub.js.map +1 -1
  88. package/dist/core/frame/workflow-templates.js +40 -1
  89. package/dist/core/frame/workflow-templates.js.map +2 -2
  90. package/dist/core/monitoring/logger.js +6 -1
  91. package/dist/core/monitoring/logger.js.map +2 -2
  92. package/dist/core/monitoring/metrics.js.map +2 -2
  93. package/dist/core/monitoring/progress-tracker.js.map +2 -2
  94. package/dist/core/performance/context-cache.js.map +2 -2
  95. package/dist/core/performance/lazy-context-loader.js +24 -20
  96. package/dist/core/performance/lazy-context-loader.js.map +2 -2
  97. package/dist/core/performance/optimized-frame-context.js +27 -12
  98. package/dist/core/performance/optimized-frame-context.js.map +2 -2
  99. package/dist/core/performance/performance-benchmark.js +10 -6
  100. package/dist/core/performance/performance-benchmark.js.map +2 -2
  101. package/dist/core/performance/performance-profiler.js +51 -14
  102. package/dist/core/performance/performance-profiler.js.map +2 -2
  103. package/dist/core/performance/streaming-jsonl-parser.js +5 -1
  104. package/dist/core/performance/streaming-jsonl-parser.js.map +2 -2
  105. package/dist/core/projects/project-manager.js +14 -20
  106. package/dist/core/projects/project-manager.js.map +2 -2
  107. package/dist/core/retrieval/context-retriever.js.map +1 -1
  108. package/dist/core/retrieval/llm-context-retrieval.js.map +2 -2
  109. package/dist/core/session/clear-survival-stub.js +5 -1
  110. package/dist/core/session/clear-survival-stub.js.map +2 -2
  111. package/dist/core/session/clear-survival.js +35 -0
  112. package/dist/core/session/clear-survival.js.map +2 -2
  113. package/dist/core/session/index.js.map +1 -1
  114. package/dist/core/session/session-manager.js.map +2 -2
  115. package/dist/core/storage/chromadb-adapter.js +6 -2
  116. package/dist/core/storage/chromadb-adapter.js.map +2 -2
  117. package/dist/core/storage/chromadb-simple.js +17 -5
  118. package/dist/core/storage/chromadb-simple.js.map +2 -2
  119. package/dist/core/storage/infinite-storage.js +109 -46
  120. package/dist/core/storage/infinite-storage.js.map +2 -2
  121. package/dist/core/storage/railway-optimized-storage.js +48 -22
  122. package/dist/core/storage/railway-optimized-storage.js.map +2 -2
  123. package/dist/core/storage/remote-storage.js +41 -23
  124. package/dist/core/storage/remote-storage.js.map +2 -2
  125. package/dist/core/trace/cli-trace-wrapper.js +9 -2
  126. package/dist/core/trace/cli-trace-wrapper.js.map +2 -2
  127. package/dist/core/trace/db-trace-wrapper.js +96 -68
  128. package/dist/core/trace/db-trace-wrapper.js.map +2 -2
  129. package/dist/core/trace/debug-trace.js +25 -8
  130. package/dist/core/trace/debug-trace.js.map +2 -2
  131. package/dist/core/trace/index.js +6 -2
  132. package/dist/core/trace/index.js.map +2 -2
  133. package/dist/core/trace/linear-api-wrapper.js +10 -5
  134. package/dist/core/trace/linear-api-wrapper.js.map +2 -2
  135. package/dist/core/trace/trace-demo.js +14 -10
  136. package/dist/core/trace/trace-demo.js.map +2 -2
  137. package/dist/core/trace/trace-detector.js +9 -2
  138. package/dist/core/trace/trace-detector.js.map +2 -2
  139. package/dist/core/trace/types.js.map +1 -1
  140. package/dist/core/utils/compression.js.map +1 -1
  141. package/dist/core/utils/update-checker.js.map +1 -1
  142. package/dist/core/worktree/worktree-manager.js +18 -7
  143. package/dist/core/worktree/worktree-manager.js.map +2 -2
  144. package/dist/features/analytics/core/analytics-service.js.map +2 -2
  145. package/dist/features/analytics/queries/metrics-queries.js +1 -1
  146. package/dist/features/analytics/queries/metrics-queries.js.map +2 -2
  147. package/dist/features/tasks/pebbles-task-store.js.map +1 -1
  148. package/dist/features/tui/components/analytics-panel.js +36 -15
  149. package/dist/features/tui/components/analytics-panel.js.map +2 -2
  150. package/dist/features/tui/components/pr-tracker.js +19 -7
  151. package/dist/features/tui/components/pr-tracker.js.map +2 -2
  152. package/dist/features/tui/components/session-monitor.js +22 -9
  153. package/dist/features/tui/components/session-monitor.js.map +2 -2
  154. package/dist/features/tui/components/subagent-fleet.js +20 -13
  155. package/dist/features/tui/components/subagent-fleet.js.map +2 -2
  156. package/dist/features/tui/components/task-board.js +26 -10
  157. package/dist/features/tui/components/task-board.js.map +2 -2
  158. package/dist/features/tui/index.js.map +2 -2
  159. package/dist/features/tui/services/data-service.js +6 -2
  160. package/dist/features/tui/services/data-service.js.map +2 -2
  161. package/dist/features/tui/services/linear-task-reader.js +3 -1
  162. package/dist/features/tui/services/linear-task-reader.js.map +2 -2
  163. package/dist/features/tui/services/websocket-client.js +3 -1
  164. package/dist/features/tui/services/websocket-client.js.map +2 -2
  165. package/dist/features/tui/terminal-compat.js +6 -2
  166. package/dist/features/tui/terminal-compat.js.map +2 -2
  167. package/dist/features/web/client/stores/task-store.js.map +2 -2
  168. package/dist/features/web/server/index.js +18 -10
  169. package/dist/features/web/server/index.js.map +2 -2
  170. package/dist/integrations/anthropic/client.js +259 -0
  171. package/dist/integrations/anthropic/client.js.map +7 -0
  172. package/dist/integrations/claude-code/subagent-client.js +404 -0
  173. package/dist/integrations/claude-code/subagent-client.js.map +7 -0
  174. package/dist/integrations/linear/sync-service.js +12 -13
  175. package/dist/integrations/linear/sync-service.js.map +2 -2
  176. package/dist/integrations/linear/sync.js +174 -12
  177. package/dist/integrations/linear/sync.js.map +2 -2
  178. package/dist/integrations/linear/unified-sync.js +1 -1
  179. package/dist/integrations/linear/unified-sync.js.map +1 -1
  180. package/dist/integrations/linear/webhook-server.js +15 -16
  181. package/dist/integrations/linear/webhook-server.js.map +2 -2
  182. package/dist/mcp/stackmemory-mcp-server.js +0 -11
  183. package/dist/mcp/stackmemory-mcp-server.js.map +2 -2
  184. package/dist/servers/production/auth-middleware.js.map +2 -2
  185. package/dist/servers/railway/index.js.map +2 -2
  186. package/dist/services/config-service.js +6 -7
  187. package/dist/services/config-service.js.map +2 -2
  188. package/dist/services/context-service.js +11 -12
  189. package/dist/services/context-service.js.map +2 -2
  190. package/dist/skills/claude-skills.js +101 -2
  191. package/dist/skills/claude-skills.js.map +2 -2
  192. package/dist/skills/dashboard-launcher.js.map +2 -2
  193. package/dist/skills/recursive-agent-orchestrator.js +559 -0
  194. package/dist/skills/recursive-agent-orchestrator.js.map +7 -0
  195. package/dist/skills/repo-ingestion-skill.js.map +2 -2
  196. package/dist/skills/security-secrets-scanner.js +265 -0
  197. package/dist/skills/security-secrets-scanner.js.map +7 -0
  198. package/dist/utils/env.js +46 -0
  199. package/dist/utils/env.js.map +7 -0
  200. package/dist/utils/logger.js +0 -11
  201. package/dist/utils/logger.js.map +2 -2
  202. package/package.json +1 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/core/errors/recovery.ts"],
4
- "sourcesContent": ["/**\n * Error recovery utilities for StackMemory\n * Provides retry logic, circuit breakers, and fallback mechanisms\n */\n\nimport { logger } from '../monitoring/logger.js';\nimport {\n StackMemoryError,\n isRetryableError,\n getErrorMessage,\n ErrorContext,\n} from './index.js';\n\nexport interface RetryOptions {\n maxAttempts?: number;\n initialDelay?: number;\n maxDelay?: number;\n backoffFactor?: number;\n timeout?: number;\n onRetry?: (attempt: number, error: unknown) => void;\n}\n\nexport interface CircuitBreakerOptions {\n failureThreshold?: number;\n resetTimeout?: number;\n halfOpenRequests?: number;\n}\n\nexport enum CircuitState {\n CLOSED = 'closed',\n OPEN = 'open',\n HALF_OPEN = 'half_open',\n}\n\n/**\n * Exponential backoff with jitter\n */\nexport function calculateBackoff(\n attempt: number,\n initialDelay: number,\n maxDelay: number,\n factor: number\n): number {\n const exponentialDelay = Math.min(\n initialDelay * Math.pow(factor, attempt - 1),\n maxDelay\n );\n // Add jitter (0-25% of delay)\n const jitter = exponentialDelay * Math.random() * 0.25;\n return Math.floor(exponentialDelay + jitter);\n}\n\n/**\n * Retry with exponential backoff\n */\nexport async function retry<T>(\n fn: () => Promise<T>,\n options: RetryOptions = {}\n): Promise<T> {\n const {\n maxAttempts = 3,\n initialDelay = 1000,\n maxDelay = 30000,\n backoffFactor = 2,\n timeout,\n onRetry,\n } = options;\n\n let lastError: unknown;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n try {\n // Add timeout if specified\n if (timeout) {\n return await Promise.race([\n fn(),\n new Promise<T>((_, reject) =>\n setTimeout(\n () => reject(new Error(`Operation timed out after ${timeout}ms`)),\n timeout\n )\n ),\n ]);\n }\n return await fn();\n } catch (error: unknown) {\n lastError = error;\n\n // Don't retry if not retryable or last attempt\n if (!isRetryableError(error) || attempt === maxAttempts) {\n throw error;\n }\n\n const delay = calculateBackoff(attempt, initialDelay, maxDelay, backoffFactor);\n\n logger.warn(`Retry attempt ${attempt}/${maxAttempts} after ${delay}ms`, {\n error: getErrorMessage(error),\n attempt,\n delay,\n });\n\n if (onRetry) {\n onRetry(attempt, error);\n }\n\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n }\n\n throw lastError;\n}\n\n/**\n * Circuit breaker implementation\n */\nexport class CircuitBreaker<T> {\n private state: CircuitState = CircuitState.CLOSED;\n private failures = 0;\n private successCount = 0;\n private lastFailTime?: Date;\n private readonly options: Required<CircuitBreakerOptions>;\n\n constructor(\n private readonly name: string,\n options: CircuitBreakerOptions = {}\n ) {\n this.options = {\n failureThreshold: options.failureThreshold ?? 5,\n resetTimeout: options.resetTimeout ?? 60000,\n halfOpenRequests: options.halfOpenRequests ?? 3,\n };\n }\n\n async execute<R = T>(fn: () => Promise<R>): Promise<R> {\n // Check if circuit should transition from OPEN to HALF_OPEN\n if (this.state === CircuitState.OPEN) {\n const timeSinceLastFailure = this.lastFailTime\n ? Date.now() - this.lastFailTime.getTime()\n : 0;\n\n if (timeSinceLastFailure >= this.options.resetTimeout) {\n this.state = CircuitState.HALF_OPEN;\n this.successCount = 0;\n logger.info(`Circuit breaker ${this.name} entering half-open state`);\n } else {\n throw new Error(\n `Circuit breaker ${this.name} is OPEN. Retry after ${\n this.options.resetTimeout - timeSinceLastFailure\n }ms`\n );\n }\n }\n\n try {\n const result = await fn();\n\n // Handle success\n if (this.state === CircuitState.HALF_OPEN) {\n this.successCount++;\n if (this.successCount >= this.options.halfOpenRequests) {\n this.state = CircuitState.CLOSED;\n this.failures = 0;\n logger.info(`Circuit breaker ${this.name} is now CLOSED`);\n }\n } else {\n this.failures = 0;\n }\n\n return result;\n } catch (error: unknown) {\n this.handleFailure(error);\n throw error;\n }\n }\n\n private handleFailure(error: unknown): void {\n this.failures++;\n this.lastFailTime = new Date();\n\n if (this.state === CircuitState.HALF_OPEN) {\n this.state = CircuitState.OPEN;\n logger.error(\n `Circuit breaker ${this.name} reopened due to failure in half-open state`\n );\n } else if (\n this.state === CircuitState.CLOSED &&\n this.failures >= this.options.failureThreshold\n ) {\n this.state = CircuitState.OPEN;\n logger.error(\n `Circuit breaker ${this.name} opened after ${this.failures} failures`\n );\n }\n }\n\n getState(): CircuitState {\n return this.state;\n }\n\n reset(): void {\n this.state = CircuitState.CLOSED;\n this.failures = 0;\n this.successCount = 0;\n this.lastFailTime = undefined;\n logger.info(`Circuit breaker ${this.name} manually reset`);\n }\n}\n\n/**\n * Fallback with multiple strategies\n */\nexport async function withFallback<T>(\n primary: () => Promise<T>,\n fallbacks: Array<() => Promise<T>>,\n context?: ErrorContext\n): Promise<T> {\n const errors: unknown[] = [];\n\n // Try primary\n try {\n return await primary();\n } catch (error: unknown) {\n errors.push(error);\n logger.warn('Primary operation failed, trying fallbacks', {\n error: getErrorMessage(error),\n context,\n });\n }\n\n // Try fallbacks in order\n for (let i = 0; i < fallbacks.length; i++) {\n try {\n const result = await fallbacks[i]();\n logger.info(`Fallback ${i + 1} succeeded`, { context });\n return result;\n } catch (error: unknown) {\n errors.push(error);\n if (i < fallbacks.length - 1) {\n logger.warn(`Fallback ${i + 1} failed, trying next`, {\n error: getErrorMessage(error),\n context,\n });\n }\n }\n }\n\n // All attempts failed\n throw new Error(\n `All attempts failed. Errors: ${errors.map(getErrorMessage).join(', ')}`\n );\n}\n\n/**\n * Bulkhead pattern - limit concurrent operations\n */\nexport class Bulkhead {\n private running = 0;\n private queue: Array<() => void> = [];\n\n constructor(\n private readonly name: string,\n private readonly maxConcurrent: number\n ) {}\n\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n if (this.running >= this.maxConcurrent) {\n await new Promise<void>((resolve) => {\n this.queue.push(resolve);\n });\n }\n\n this.running++;\n\n try {\n return await fn();\n } finally {\n this.running--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n }\n\n getStats() {\n return {\n running: this.running,\n queued: this.queue.length,\n maxConcurrent: this.maxConcurrent,\n };\n }\n}\n\n/**\n * Timeout wrapper with proper cleanup\n */\nexport async function withTimeout<T>(\n fn: () => Promise<T>,\n timeoutMs: number,\n timeoutMessage?: string\n): Promise<T> {\n return Promise.race([\n fn(),\n new Promise<T>((_, reject) =>\n setTimeout(\n () =>\n reject(\n new Error(timeoutMessage ?? `Operation timed out after ${timeoutMs}ms`)\n ),\n timeoutMs\n )\n ),\n ]);\n}\n\n/**\n * Graceful degradation helper\n */\nexport async function gracefulDegrade<T, F>(\n fn: () => Promise<T>,\n defaultValue: F,\n logContext?: ErrorContext\n): Promise<T | F> {\n try {\n return await fn();\n } catch (error: unknown) {\n logger.warn('Operation failed, using default value', {\n error: getErrorMessage(error),\n ...logContext,\n });\n return defaultValue;\n }\n}\n\n/**\n * Create a resilient operation with multiple recovery strategies\n */\nexport function createResilientOperation<T>(\n name: string,\n options: {\n retry?: RetryOptions;\n circuitBreaker?: CircuitBreakerOptions;\n bulkhead?: number;\n timeout?: number;\n fallback?: () => Promise<T>;\n } = {}\n) {\n const circuitBreaker = options.circuitBreaker\n ? new CircuitBreaker<T>(name, options.circuitBreaker)\n : null;\n const bulkhead = options.bulkhead\n ? new Bulkhead(name, options.bulkhead)\n : null;\n\n return async (fn: () => Promise<T>): Promise<T> => {\n let currentFn = fn;\n\n // Wrap with bulkhead if configured\n if (bulkhead) {\n const wrapped = currentFn;\n currentFn = () => bulkhead.execute(wrapped);\n }\n\n // Wrap with timeout if configured\n if (options.timeout) {\n const wrapped = currentFn;\n currentFn = () => withTimeout(wrapped, options.timeout!);\n }\n\n // Wrap with retry if configured\n if (options.retry) {\n const wrapped = currentFn;\n currentFn = () => retry(wrapped, options.retry!);\n }\n\n // Wrap with circuit breaker if configured\n if (circuitBreaker) {\n const wrapped = currentFn;\n currentFn = () => circuitBreaker.execute(wrapped);\n }\n\n // Execute with fallback if configured\n if (options.fallback) {\n return withFallback(currentFn, [options.fallback]);\n }\n\n return currentFn();\n };\n}"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * Error recovery utilities for StackMemory\n * Provides retry logic, circuit breakers, and fallback mechanisms\n */\n\nimport { logger } from '../monitoring/logger.js';\nimport {\n StackMemoryError,\n isRetryableError,\n getErrorMessage,\n ErrorContext,\n} from './index.js';\n\nexport interface RetryOptions {\n maxAttempts?: number;\n initialDelay?: number;\n maxDelay?: number;\n backoffFactor?: number;\n timeout?: number;\n onRetry?: (attempt: number, error: unknown) => void;\n}\n\nexport interface CircuitBreakerOptions {\n failureThreshold?: number;\n resetTimeout?: number;\n halfOpenRequests?: number;\n}\n\nexport enum CircuitState {\n CLOSED = 'closed',\n OPEN = 'open',\n HALF_OPEN = 'half_open',\n}\n\n/**\n * Exponential backoff with jitter\n */\nexport function calculateBackoff(\n attempt: number,\n initialDelay: number,\n maxDelay: number,\n factor: number\n): number {\n const exponentialDelay = Math.min(\n initialDelay * Math.pow(factor, attempt - 1),\n maxDelay\n );\n // Add jitter (0-25% of delay)\n const jitter = exponentialDelay * Math.random() * 0.25;\n return Math.floor(exponentialDelay + jitter);\n}\n\n/**\n * Retry with exponential backoff\n */\nexport async function retry<T>(\n fn: () => Promise<T>,\n options: RetryOptions = {}\n): Promise<T> {\n const {\n maxAttempts = 3,\n initialDelay = 1000,\n maxDelay = 30000,\n backoffFactor = 2,\n timeout,\n onRetry,\n } = options;\n\n let lastError: unknown;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n try {\n // Add timeout if specified\n if (timeout) {\n return await Promise.race([\n fn(),\n new Promise<T>((_, reject) =>\n setTimeout(\n () => reject(new Error(`Operation timed out after ${timeout}ms`)),\n timeout\n )\n ),\n ]);\n }\n return await fn();\n } catch (error: unknown) {\n lastError = error;\n\n // Don't retry if not retryable or last attempt\n if (!isRetryableError(error) || attempt === maxAttempts) {\n throw error;\n }\n\n const delay = calculateBackoff(\n attempt,\n initialDelay,\n maxDelay,\n backoffFactor\n );\n\n logger.warn(`Retry attempt ${attempt}/${maxAttempts} after ${delay}ms`, {\n error: getErrorMessage(error),\n attempt,\n delay,\n });\n\n if (onRetry) {\n onRetry(attempt, error);\n }\n\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n }\n\n throw lastError;\n}\n\n/**\n * Circuit breaker implementation\n */\nexport class CircuitBreaker<T> {\n private state: CircuitState = CircuitState.CLOSED;\n private failures = 0;\n private successCount = 0;\n private lastFailTime?: Date;\n private readonly options: Required<CircuitBreakerOptions>;\n\n constructor(\n private readonly name: string,\n options: CircuitBreakerOptions = {}\n ) {\n this.options = {\n failureThreshold: options.failureThreshold ?? 5,\n resetTimeout: options.resetTimeout ?? 60000,\n halfOpenRequests: options.halfOpenRequests ?? 3,\n };\n }\n\n async execute<R = T>(fn: () => Promise<R>): Promise<R> {\n // Check if circuit should transition from OPEN to HALF_OPEN\n if (this.state === CircuitState.OPEN) {\n const timeSinceLastFailure = this.lastFailTime\n ? Date.now() - this.lastFailTime.getTime()\n : 0;\n\n if (timeSinceLastFailure >= this.options.resetTimeout) {\n this.state = CircuitState.HALF_OPEN;\n this.successCount = 0;\n logger.info(`Circuit breaker ${this.name} entering half-open state`);\n } else {\n throw new Error(\n `Circuit breaker ${this.name} is OPEN. Retry after ${\n this.options.resetTimeout - timeSinceLastFailure\n }ms`\n );\n }\n }\n\n try {\n const result = await fn();\n\n // Handle success\n if (this.state === CircuitState.HALF_OPEN) {\n this.successCount++;\n if (this.successCount >= this.options.halfOpenRequests) {\n this.state = CircuitState.CLOSED;\n this.failures = 0;\n logger.info(`Circuit breaker ${this.name} is now CLOSED`);\n }\n } else {\n this.failures = 0;\n }\n\n return result;\n } catch (error: unknown) {\n this.handleFailure(error);\n throw error;\n }\n }\n\n private handleFailure(error: unknown): void {\n this.failures++;\n this.lastFailTime = new Date();\n\n if (this.state === CircuitState.HALF_OPEN) {\n this.state = CircuitState.OPEN;\n logger.error(\n `Circuit breaker ${this.name} reopened due to failure in half-open state`\n );\n } else if (\n this.state === CircuitState.CLOSED &&\n this.failures >= this.options.failureThreshold\n ) {\n this.state = CircuitState.OPEN;\n logger.error(\n `Circuit breaker ${this.name} opened after ${this.failures} failures`\n );\n }\n }\n\n getState(): CircuitState {\n return this.state;\n }\n\n reset(): void {\n this.state = CircuitState.CLOSED;\n this.failures = 0;\n this.successCount = 0;\n this.lastFailTime = undefined;\n logger.info(`Circuit breaker ${this.name} manually reset`);\n }\n}\n\n/**\n * Fallback with multiple strategies\n */\nexport async function withFallback<T>(\n primary: () => Promise<T>,\n fallbacks: Array<() => Promise<T>>,\n context?: ErrorContext\n): Promise<T> {\n const errors: unknown[] = [];\n\n // Try primary\n try {\n return await primary();\n } catch (error: unknown) {\n errors.push(error);\n logger.warn('Primary operation failed, trying fallbacks', {\n error: getErrorMessage(error),\n context,\n });\n }\n\n // Try fallbacks in order\n for (let i = 0; i < fallbacks.length; i++) {\n try {\n const result = await fallbacks[i]();\n logger.info(`Fallback ${i + 1} succeeded`, { context });\n return result;\n } catch (error: unknown) {\n errors.push(error);\n if (i < fallbacks.length - 1) {\n logger.warn(`Fallback ${i + 1} failed, trying next`, {\n error: getErrorMessage(error),\n context,\n });\n }\n }\n }\n\n // All attempts failed\n throw new Error(\n `All attempts failed. Errors: ${errors.map(getErrorMessage).join(', ')}`\n );\n}\n\n/**\n * Bulkhead pattern - limit concurrent operations\n */\nexport class Bulkhead {\n private running = 0;\n private queue: Array<() => void> = [];\n\n constructor(\n private readonly name: string,\n private readonly maxConcurrent: number\n ) {}\n\n async execute<T>(fn: () => Promise<T>): Promise<T> {\n if (this.running >= this.maxConcurrent) {\n await new Promise<void>((resolve) => {\n this.queue.push(resolve);\n });\n }\n\n this.running++;\n\n try {\n return await fn();\n } finally {\n this.running--;\n const next = this.queue.shift();\n if (next) {\n next();\n }\n }\n }\n\n getStats() {\n return {\n running: this.running,\n queued: this.queue.length,\n maxConcurrent: this.maxConcurrent,\n };\n }\n}\n\n/**\n * Timeout wrapper with proper cleanup\n */\nexport async function withTimeout<T>(\n fn: () => Promise<T>,\n timeoutMs: number,\n timeoutMessage?: string\n): Promise<T> {\n return Promise.race([\n fn(),\n new Promise<T>((_, reject) =>\n setTimeout(\n () =>\n reject(\n new Error(\n timeoutMessage ?? `Operation timed out after ${timeoutMs}ms`\n )\n ),\n timeoutMs\n )\n ),\n ]);\n}\n\n/**\n * Graceful degradation helper\n */\nexport async function gracefulDegrade<T, F>(\n fn: () => Promise<T>,\n defaultValue: F,\n logContext?: ErrorContext\n): Promise<T | F> {\n try {\n return await fn();\n } catch (error: unknown) {\n logger.warn('Operation failed, using default value', {\n error: getErrorMessage(error),\n ...logContext,\n });\n return defaultValue;\n }\n}\n\n/**\n * Create a resilient operation with multiple recovery strategies\n */\nexport function createResilientOperation<T>(\n name: string,\n options: {\n retry?: RetryOptions;\n circuitBreaker?: CircuitBreakerOptions;\n bulkhead?: number;\n timeout?: number;\n fallback?: () => Promise<T>;\n } = {}\n) {\n const circuitBreaker = options.circuitBreaker\n ? new CircuitBreaker<T>(name, options.circuitBreaker)\n : null;\n const bulkhead = options.bulkhead\n ? new Bulkhead(name, options.bulkhead)\n : null;\n\n return async (fn: () => Promise<T>): Promise<T> => {\n let currentFn = fn;\n\n // Wrap with bulkhead if configured\n if (bulkhead) {\n const wrapped = currentFn;\n currentFn = () => bulkhead.execute(wrapped);\n }\n\n // Wrap with timeout if configured\n if (options.timeout) {\n const wrapped = currentFn;\n currentFn = () => withTimeout(wrapped, options.timeout!);\n }\n\n // Wrap with retry if configured\n if (options.retry) {\n const wrapped = currentFn;\n currentFn = () => retry(wrapped, options.retry!);\n }\n\n // Wrap with circuit breaker if configured\n if (circuitBreaker) {\n const wrapped = currentFn;\n currentFn = () => circuitBreaker.execute(wrapped);\n }\n\n // Execute with fallback if configured\n if (options.fallback) {\n return withFallback(currentFn, [options.fallback]);\n }\n\n return currentFn();\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": ["CircuitState"]
7
7
  }
@@ -0,0 +1,254 @@
1
+ import { EventEmitter } from "events";
2
+ import { logger } from "../monitoring/logger.js";
3
+ class ParallelExecutor extends EventEmitter {
4
+ maxConcurrency;
5
+ queueSize;
6
+ defaultTimeout;
7
+ defaultRetries;
8
+ rateLimitPerMinute;
9
+ activeCount = 0;
10
+ queue = [];
11
+ rateLimitTokens;
12
+ lastRateLimitReset;
13
+ // Metrics
14
+ totalExecuted = 0;
15
+ totalSucceeded = 0;
16
+ totalFailed = 0;
17
+ totalDuration = 0;
18
+ constructor(maxConcurrency = 5, options = {}) {
19
+ super();
20
+ this.maxConcurrency = maxConcurrency;
21
+ this.queueSize = options.queueSize || 100;
22
+ this.defaultTimeout = options.defaultTimeout || 3e5;
23
+ this.defaultRetries = options.defaultRetries || 3;
24
+ this.rateLimitPerMinute = options.rateLimitPerMinute || 60;
25
+ this.rateLimitTokens = this.rateLimitPerMinute;
26
+ this.lastRateLimitReset = Date.now();
27
+ logger.info("Parallel Executor initialized", {
28
+ maxConcurrency,
29
+ queueSize: this.queueSize,
30
+ rateLimitPerMinute: this.rateLimitPerMinute
31
+ });
32
+ }
33
+ /**
34
+ * Execute multiple tasks in parallel
35
+ */
36
+ async executeParallel(items, executor, options) {
37
+ const results = [];
38
+ const batchSize = options?.batchSize || this.maxConcurrency;
39
+ const delayBetweenBatches = options?.delayBetweenBatches || 0;
40
+ for (let i = 0; i < items.length; i += batchSize) {
41
+ const batch = items.slice(i, i + batchSize);
42
+ const batchPromises = batch.map(
43
+ (item, index) => this.executeWithTracking(
44
+ `parallel-${i + index}`,
45
+ () => executor(item, i + index)
46
+ )
47
+ );
48
+ const batchResults = await Promise.allSettled(batchPromises);
49
+ batchResults.forEach((result, index) => {
50
+ if (result.status === "fulfilled") {
51
+ results.push(result.value);
52
+ } else {
53
+ results.push({
54
+ taskId: `parallel-${i + index}`,
55
+ success: false,
56
+ error: result.reason,
57
+ duration: 0,
58
+ attempts: 1
59
+ });
60
+ }
61
+ });
62
+ if (delayBetweenBatches > 0 && i + batchSize < items.length) {
63
+ await this.delay(delayBetweenBatches);
64
+ }
65
+ logger.debug("Batch completed", {
66
+ batchNumber: Math.floor(i / batchSize) + 1,
67
+ totalBatches: Math.ceil(items.length / batchSize),
68
+ successRate: results.filter((r) => r.success).length / results.length
69
+ });
70
+ }
71
+ return results;
72
+ }
73
+ /**
74
+ * Execute a single task with tracking and retries
75
+ */
76
+ async executeWithTracking(taskId, executor, options) {
77
+ const timeout = options?.timeout || this.defaultTimeout;
78
+ const maxRetries = options?.retries || this.defaultRetries;
79
+ let attempts = 0;
80
+ let lastError;
81
+ const startTime = Date.now();
82
+ while (attempts < maxRetries) {
83
+ attempts++;
84
+ try {
85
+ await this.checkRateLimit();
86
+ await this.waitForSlot();
87
+ this.activeCount++;
88
+ this.emit("task-start", { taskId, attempt: attempts });
89
+ const result = await this.executeWithTimeout(executor, timeout);
90
+ this.totalSucceeded++;
91
+ this.emit("task-success", { taskId, attempts });
92
+ return {
93
+ taskId,
94
+ success: true,
95
+ result,
96
+ duration: Date.now() - startTime,
97
+ attempts
98
+ };
99
+ } catch (error) {
100
+ lastError = error;
101
+ logger.warn(`Task failed (attempt ${attempts}/${maxRetries})`, {
102
+ taskId,
103
+ error: lastError.message
104
+ });
105
+ this.emit("task-retry", { taskId, attempt: attempts, error: lastError });
106
+ if (attempts < maxRetries) {
107
+ await this.delay(Math.pow(2, attempts) * 1e3);
108
+ }
109
+ } finally {
110
+ this.activeCount--;
111
+ this.totalExecuted++;
112
+ this.totalDuration += Date.now() - startTime;
113
+ }
114
+ }
115
+ this.totalFailed++;
116
+ this.emit("task-failed", { taskId, attempts, error: lastError });
117
+ return {
118
+ taskId,
119
+ success: false,
120
+ error: lastError,
121
+ duration: Date.now() - startTime,
122
+ attempts
123
+ };
124
+ }
125
+ /**
126
+ * Execute task with timeout
127
+ */
128
+ async executeWithTimeout(executor, timeout) {
129
+ return Promise.race([
130
+ executor(),
131
+ new Promise(
132
+ (_, reject) => setTimeout(() => reject(new Error("Task timeout")), timeout)
133
+ )
134
+ ]);
135
+ }
136
+ /**
137
+ * Check and enforce rate limiting
138
+ */
139
+ async checkRateLimit() {
140
+ const now = Date.now();
141
+ const timeSinceReset = now - this.lastRateLimitReset;
142
+ if (timeSinceReset >= 6e4) {
143
+ this.rateLimitTokens = this.rateLimitPerMinute;
144
+ this.lastRateLimitReset = now;
145
+ }
146
+ if (this.rateLimitTokens <= 0) {
147
+ const waitTime = 6e4 - timeSinceReset;
148
+ logger.debug(`Rate limit reached, waiting ${waitTime}ms`);
149
+ await this.delay(waitTime);
150
+ this.rateLimitTokens = this.rateLimitPerMinute;
151
+ this.lastRateLimitReset = Date.now();
152
+ }
153
+ this.rateLimitTokens--;
154
+ }
155
+ /**
156
+ * Wait for an available execution slot
157
+ */
158
+ async waitForSlot() {
159
+ while (this.activeCount >= this.maxConcurrency) {
160
+ await this.delay(100);
161
+ }
162
+ }
163
+ /**
164
+ * Queue a task for execution
165
+ */
166
+ async queueTask(task) {
167
+ if (this.queue.length >= this.queueSize) {
168
+ throw new Error("Execution queue is full");
169
+ }
170
+ return new Promise((resolve) => {
171
+ this.queue.push({
172
+ ...task,
173
+ execute: async () => {
174
+ const result = await task.execute();
175
+ resolve({
176
+ taskId: task.id,
177
+ success: true,
178
+ result,
179
+ duration: 0,
180
+ attempts: 1
181
+ });
182
+ return result;
183
+ }
184
+ });
185
+ this.processQueue();
186
+ });
187
+ }
188
+ /**
189
+ * Process queued tasks
190
+ */
191
+ async processQueue() {
192
+ if (this.activeCount >= this.maxConcurrency || this.queue.length === 0) {
193
+ return;
194
+ }
195
+ this.queue.sort((a, b) => (b.priority || 0) - (a.priority || 0));
196
+ const task = this.queue.shift();
197
+ if (task) {
198
+ this.executeWithTracking(task.id, task.execute, {
199
+ timeout: task.timeout,
200
+ retries: task.retries
201
+ }).then(() => {
202
+ this.processQueue();
203
+ });
204
+ }
205
+ }
206
+ /**
207
+ * Utility delay function
208
+ */
209
+ delay(ms) {
210
+ return new Promise((resolve) => setTimeout(resolve, ms));
211
+ }
212
+ /**
213
+ * Get execution metrics
214
+ */
215
+ getMetrics() {
216
+ return {
217
+ activeCount: this.activeCount,
218
+ queueLength: this.queue.length,
219
+ totalExecuted: this.totalExecuted,
220
+ totalSucceeded: this.totalSucceeded,
221
+ totalFailed: this.totalFailed,
222
+ successRate: this.totalExecuted > 0 ? this.totalSucceeded / this.totalExecuted : 0,
223
+ averageDuration: this.totalExecuted > 0 ? this.totalDuration / this.totalExecuted : 0,
224
+ rateLimitTokens: this.rateLimitTokens
225
+ };
226
+ }
227
+ /**
228
+ * Reset all metrics
229
+ */
230
+ resetMetrics() {
231
+ this.totalExecuted = 0;
232
+ this.totalSucceeded = 0;
233
+ this.totalFailed = 0;
234
+ this.totalDuration = 0;
235
+ }
236
+ /**
237
+ * Gracefully shutdown executor
238
+ */
239
+ async shutdown() {
240
+ logger.info("Shutting down Parallel Executor", {
241
+ activeCount: this.activeCount,
242
+ queueLength: this.queue.length
243
+ });
244
+ this.queue = [];
245
+ while (this.activeCount > 0) {
246
+ await this.delay(100);
247
+ }
248
+ logger.info("Parallel Executor shutdown complete");
249
+ }
250
+ }
251
+ export {
252
+ ParallelExecutor
253
+ };
254
+ //# sourceMappingURL=parallel-executor.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/core/execution/parallel-executor.ts"],
4
+ "sourcesContent": ["/**\n * Parallel Execution Engine for RLM\n * \n * Manages concurrent execution of multiple Claude API calls\n * with rate limiting, resource pooling, and failure recovery\n */\n\nimport { EventEmitter } from 'events';\nimport { logger } from '../monitoring/logger.js';\n\nexport interface ExecutionTask<T> {\n id: string;\n execute: () => Promise<T>;\n priority?: number;\n timeout?: number;\n retries?: number;\n}\n\nexport interface ExecutionResult<T> {\n taskId: string;\n success: boolean;\n result?: T;\n error?: Error;\n duration: number;\n attempts: number;\n}\n\nexport interface ParallelExecutorOptions {\n maxConcurrency?: number;\n queueSize?: number;\n defaultTimeout?: number;\n defaultRetries?: number;\n rateLimitPerMinute?: number;\n}\n\n/**\n * Parallel Executor for managing concurrent operations\n */\nexport class ParallelExecutor extends EventEmitter {\n private maxConcurrency: number;\n private queueSize: number;\n private defaultTimeout: number;\n private defaultRetries: number;\n private rateLimitPerMinute: number;\n \n private activeCount: number = 0;\n private queue: ExecutionTask<any>[] = [];\n private rateLimitTokens: number;\n private lastRateLimitReset: number;\n \n // Metrics\n private totalExecuted: number = 0;\n private totalSucceeded: number = 0;\n private totalFailed: number = 0;\n private totalDuration: number = 0;\n\n constructor(maxConcurrency: number = 5, options: ParallelExecutorOptions = {}) {\n super();\n \n this.maxConcurrency = maxConcurrency;\n this.queueSize = options.queueSize || 100;\n this.defaultTimeout = options.defaultTimeout || 300000; // 5 minutes\n this.defaultRetries = options.defaultRetries || 3;\n this.rateLimitPerMinute = options.rateLimitPerMinute || 60;\n \n this.rateLimitTokens = this.rateLimitPerMinute;\n this.lastRateLimitReset = Date.now();\n \n logger.info('Parallel Executor initialized', {\n maxConcurrency,\n queueSize: this.queueSize,\n rateLimitPerMinute: this.rateLimitPerMinute,\n });\n }\n \n /**\n * Execute multiple tasks in parallel\n */\n async executeParallel<T>(\n items: T[],\n executor: (item: T, index: number) => Promise<void>,\n options?: {\n batchSize?: number;\n delayBetweenBatches?: number;\n }\n ): Promise<ExecutionResult<void>[]> {\n const results: ExecutionResult<void>[] = [];\n const batchSize = options?.batchSize || this.maxConcurrency;\n const delayBetweenBatches = options?.delayBetweenBatches || 0;\n \n // Process items in batches\n for (let i = 0; i < items.length; i += batchSize) {\n const batch = items.slice(i, i + batchSize);\n const batchPromises = batch.map((item, index) => \n this.executeWithTracking(\n `parallel-${i + index}`,\n () => executor(item, i + index)\n )\n );\n \n const batchResults = await Promise.allSettled(batchPromises);\n \n // Convert to ExecutionResult format\n batchResults.forEach((result, index) => {\n if (result.status === 'fulfilled') {\n results.push(result.value);\n } else {\n results.push({\n taskId: `parallel-${i + index}`,\n success: false,\n error: result.reason,\n duration: 0,\n attempts: 1,\n });\n }\n });\n \n // Delay between batches if specified\n if (delayBetweenBatches > 0 && i + batchSize < items.length) {\n await this.delay(delayBetweenBatches);\n }\n \n // Log batch progress\n logger.debug('Batch completed', {\n batchNumber: Math.floor(i / batchSize) + 1,\n totalBatches: Math.ceil(items.length / batchSize),\n successRate: results.filter(r => r.success).length / results.length,\n });\n }\n \n return results;\n }\n \n /**\n * Execute a single task with tracking and retries\n */\n async executeWithTracking<T>(\n taskId: string,\n executor: () => Promise<T>,\n options?: {\n timeout?: number;\n retries?: number;\n }\n ): Promise<ExecutionResult<T>> {\n const timeout = options?.timeout || this.defaultTimeout;\n const maxRetries = options?.retries || this.defaultRetries;\n \n let attempts = 0;\n let lastError: Error | undefined;\n const startTime = Date.now();\n \n while (attempts < maxRetries) {\n attempts++;\n \n try {\n // Check rate limit\n await this.checkRateLimit();\n \n // Wait for available slot\n await this.waitForSlot();\n \n this.activeCount++;\n this.emit('task-start', { taskId, attempt: attempts });\n \n // Execute with timeout\n const result = await this.executeWithTimeout(executor, timeout);\n \n // Success\n this.totalSucceeded++;\n this.emit('task-success', { taskId, attempts });\n \n return {\n taskId,\n success: true,\n result,\n duration: Date.now() - startTime,\n attempts,\n };\n \n } catch (error) {\n lastError = error as Error;\n \n logger.warn(`Task failed (attempt ${attempts}/${maxRetries})`, {\n taskId,\n error: lastError.message,\n });\n \n this.emit('task-retry', { taskId, attempt: attempts, error: lastError });\n \n // Exponential backoff for retries\n if (attempts < maxRetries) {\n await this.delay(Math.pow(2, attempts) * 1000);\n }\n \n } finally {\n this.activeCount--;\n this.totalExecuted++;\n this.totalDuration += Date.now() - startTime;\n }\n }\n \n // All retries exhausted\n this.totalFailed++;\n this.emit('task-failed', { taskId, attempts, error: lastError });\n \n return {\n taskId,\n success: false,\n error: lastError,\n duration: Date.now() - startTime,\n attempts,\n };\n }\n \n /**\n * Execute task with timeout\n */\n private async executeWithTimeout<T>(\n executor: () => Promise<T>,\n timeout: number\n ): Promise<T> {\n return Promise.race([\n executor(),\n new Promise<T>((_, reject) => \n setTimeout(() => reject(new Error('Task timeout')), timeout)\n ),\n ]);\n }\n \n /**\n * Check and enforce rate limiting\n */\n private async checkRateLimit(): Promise<void> {\n const now = Date.now();\n const timeSinceReset = now - this.lastRateLimitReset;\n \n // Reset tokens if a minute has passed\n if (timeSinceReset >= 60000) {\n this.rateLimitTokens = this.rateLimitPerMinute;\n this.lastRateLimitReset = now;\n }\n \n // Wait if no tokens available\n if (this.rateLimitTokens <= 0) {\n const waitTime = 60000 - timeSinceReset;\n logger.debug(`Rate limit reached, waiting ${waitTime}ms`);\n await this.delay(waitTime);\n \n // Reset after waiting\n this.rateLimitTokens = this.rateLimitPerMinute;\n this.lastRateLimitReset = Date.now();\n }\n \n this.rateLimitTokens--;\n }\n \n /**\n * Wait for an available execution slot\n */\n private async waitForSlot(): Promise<void> {\n while (this.activeCount >= this.maxConcurrency) {\n await this.delay(100); // Check every 100ms\n }\n }\n \n /**\n * Queue a task for execution\n */\n async queueTask<T>(task: ExecutionTask<T>): Promise<ExecutionResult<T>> {\n if (this.queue.length >= this.queueSize) {\n throw new Error('Execution queue is full');\n }\n \n return new Promise((resolve) => {\n this.queue.push({\n ...task,\n execute: async () => {\n const result = await task.execute();\n resolve({\n taskId: task.id,\n success: true,\n result,\n duration: 0,\n attempts: 1,\n });\n return result;\n },\n });\n \n this.processQueue();\n });\n }\n \n /**\n * Process queued tasks\n */\n private async processQueue(): Promise<void> {\n if (this.activeCount >= this.maxConcurrency || this.queue.length === 0) {\n return;\n }\n \n // Sort by priority (higher first)\n this.queue.sort((a, b) => (b.priority || 0) - (a.priority || 0));\n \n const task = this.queue.shift();\n if (task) {\n this.executeWithTracking(task.id, task.execute, {\n timeout: task.timeout,\n retries: task.retries,\n }).then(() => {\n this.processQueue(); // Process next task\n });\n }\n }\n \n /**\n * Utility delay function\n */\n private delay(ms: number): Promise<void> {\n return new Promise(resolve => setTimeout(resolve, ms));\n }\n \n /**\n * Get execution metrics\n */\n getMetrics() {\n return {\n activeCount: this.activeCount,\n queueLength: this.queue.length,\n totalExecuted: this.totalExecuted,\n totalSucceeded: this.totalSucceeded,\n totalFailed: this.totalFailed,\n successRate: this.totalExecuted > 0 ? this.totalSucceeded / this.totalExecuted : 0,\n averageDuration: this.totalExecuted > 0 ? this.totalDuration / this.totalExecuted : 0,\n rateLimitTokens: this.rateLimitTokens,\n };\n }\n \n /**\n * Reset all metrics\n */\n resetMetrics(): void {\n this.totalExecuted = 0;\n this.totalSucceeded = 0;\n this.totalFailed = 0;\n this.totalDuration = 0;\n }\n \n /**\n * Gracefully shutdown executor\n */\n async shutdown(): Promise<void> {\n logger.info('Shutting down Parallel Executor', {\n activeCount: this.activeCount,\n queueLength: this.queue.length,\n });\n \n // Clear queue\n this.queue = [];\n \n // Wait for active tasks to complete\n while (this.activeCount > 0) {\n await this.delay(100);\n }\n \n logger.info('Parallel Executor shutdown complete');\n }\n}"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/core/frame/workflow-templates-stub.ts"],
4
- "sourcesContent": ["/**\n * Stub workflow templates for testing\n */\n\nexport const workflowTemplates = {\n tdd: {\n name: 'Test-Driven Development',\n description: 'Write tests first, then implement',\n phases: [\n { name: 'write-failing-tests', description: 'Write tests that fail' },\n { name: 'implement-code', description: 'Make tests pass' },\n { name: 'refactor', description: 'Clean up code' }\n ]\n },\n feature: {\n name: 'Feature Development',\n description: 'Develop a new feature',\n phases: [\n { name: 'design', description: 'Design the feature' },\n { name: 'implement', description: 'Build the feature' },\n { name: 'test', description: 'Test the feature' }\n ]\n },\n bugfix: {\n name: 'Bug Fix',\n description: 'Fix a reported bug',\n phases: [\n { name: 'reproduce', description: 'Reproduce the bug' },\n { name: 'fix', description: 'Fix the bug' },\n { name: 'verify', description: 'Verify the fix' }\n ]\n },\n refactor: {\n name: 'Refactoring',\n description: 'Improve code structure',\n phases: [\n { name: 'analyze', description: 'Analyze current code' },\n { name: 'refactor', description: 'Refactor code' },\n { name: 'test', description: 'Ensure no regressions' }\n ]\n }\n};"],
4
+ "sourcesContent": ["/**\n * Stub workflow templates for testing\n */\n\nexport const workflowTemplates = {\n tdd: {\n name: 'Test-Driven Development',\n description: 'Write tests first, then implement',\n phases: [\n { name: 'write-failing-tests', description: 'Write tests that fail' },\n { name: 'implement-code', description: 'Make tests pass' },\n { name: 'refactor', description: 'Clean up code' },\n ],\n },\n feature: {\n name: 'Feature Development',\n description: 'Develop a new feature',\n phases: [\n { name: 'design', description: 'Design the feature' },\n { name: 'implement', description: 'Build the feature' },\n { name: 'test', description: 'Test the feature' },\n ],\n },\n bugfix: {\n name: 'Bug Fix',\n description: 'Fix a reported bug',\n phases: [\n { name: 'reproduce', description: 'Reproduce the bug' },\n { name: 'fix', description: 'Fix the bug' },\n { name: 'verify', description: 'Verify the fix' },\n ],\n },\n refactor: {\n name: 'Refactoring',\n description: 'Improve code structure',\n phases: [\n { name: 'analyze', description: 'Analyze current code' },\n { name: 'refactor', description: 'Refactor code' },\n { name: 'test', description: 'Ensure no regressions' },\n ],\n },\n};\n"],
5
5
  "mappings": "AAIO,MAAM,oBAAoB;AAAA,EAC/B,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,EAAE,MAAM,uBAAuB,aAAa,wBAAwB;AAAA,MACpE,EAAE,MAAM,kBAAkB,aAAa,kBAAkB;AAAA,MACzD,EAAE,MAAM,YAAY,aAAa,gBAAgB;AAAA,IACnD;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,MACpD,EAAE,MAAM,aAAa,aAAa,oBAAoB;AAAA,MACtD,EAAE,MAAM,QAAQ,aAAa,mBAAmB;AAAA,IAClD;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,EAAE,MAAM,aAAa,aAAa,oBAAoB;AAAA,MACtD,EAAE,MAAM,OAAO,aAAa,cAAc;AAAA,MAC1C,EAAE,MAAM,UAAU,aAAa,iBAAiB;AAAA,IAClD;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,EAAE,MAAM,WAAW,aAAa,uBAAuB;AAAA,MACvD,EAAE,MAAM,YAAY,aAAa,gBAAgB;AAAA,MACjD,EAAE,MAAM,QAAQ,aAAa,wBAAwB;AAAA,IACvD;AAAA,EACF;AACF;",
6
6
  "names": []
7
7
  }
@@ -270,7 +270,46 @@ class WorkflowTemplates {
270
270
  ];
271
271
  }
272
272
  }
273
+ const workflowTemplates = {
274
+ tdd: {
275
+ name: "Test-Driven Development",
276
+ description: "Write tests first, then implement",
277
+ phases: [
278
+ { name: "write-failing-tests", description: "Write tests that fail" },
279
+ { name: "implement-code", description: "Make tests pass" },
280
+ { name: "refactor", description: "Clean up code" }
281
+ ]
282
+ },
283
+ feature: {
284
+ name: "Feature Development",
285
+ description: "Develop a new feature",
286
+ phases: [
287
+ { name: "design", description: "Design the feature" },
288
+ { name: "implement", description: "Build the feature" },
289
+ { name: "test", description: "Test the feature" }
290
+ ]
291
+ },
292
+ bugfix: {
293
+ name: "Bug Fix",
294
+ description: "Fix a reported bug",
295
+ phases: [
296
+ { name: "reproduce", description: "Reproduce the bug" },
297
+ { name: "fix", description: "Fix the bug" },
298
+ { name: "verify", description: "Verify the fix" }
299
+ ]
300
+ },
301
+ refactor: {
302
+ name: "Refactoring",
303
+ description: "Improve code structure",
304
+ phases: [
305
+ { name: "analyze", description: "Analyze current code" },
306
+ { name: "refactor", description: "Refactor code" },
307
+ { name: "test", description: "Ensure no regressions" }
308
+ ]
309
+ }
310
+ };
273
311
  export {
274
- WorkflowTemplates
312
+ WorkflowTemplates,
313
+ workflowTemplates
275
314
  };
276
315
  //# sourceMappingURL=workflow-templates.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/core/frame/workflow-templates.ts"],
4
- "sourcesContent": ["/**\n * Workflow Templates for StackMemory\n * Inspired by Continuous-Claude's structured approach\n *\n * Each workflow auto-creates child frames for phases\n * and enforces completion gates between transitions\n */\n\nimport { Frame } from '../types';\nimport { FrameManager } from './frame-manager';\n\nexport interface WorkflowPhase {\n name: string;\n requiredOutputs?: string[];\n validationRules?: ((frame: Frame) => boolean)[];\n autoTransition?: boolean;\n}\n\nexport interface WorkflowTemplate {\n name: string;\n description: string;\n phases: WorkflowPhase[];\n metadata?: Record<string, any>;\n}\n\nexport class WorkflowTemplates {\n private frameManager: FrameManager;\n\n constructor(frameManager: FrameManager) {\n this.frameManager = frameManager;\n }\n\n /**\n * TDD Workflow: Red \u2192 Green \u2192 Refactor\n */\n static TDD: WorkflowTemplate = {\n name: 'tdd',\n description: 'Test-Driven Development workflow',\n phases: [\n {\n name: 'write-failing-tests',\n requiredOutputs: ['test_file', 'test_count'],\n validationRules: [(frame) => frame.metadata?.tests_failing === true],\n },\n {\n name: 'implement-minimal',\n requiredOutputs: ['implementation_file'],\n validationRules: [(frame) => frame.metadata?.tests_passing === true],\n },\n {\n name: 'refactor',\n requiredOutputs: ['refactored_files'],\n validationRules: [\n (frame) => frame.metadata?.tests_passing === true,\n (frame) => frame.metadata?.complexity_reduced === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Feature Development Workflow\n */\n static FEATURE: WorkflowTemplate = {\n name: 'feature',\n description: 'Feature development workflow',\n phases: [\n {\n name: 'research',\n requiredOutputs: ['requirements', 'constraints', 'dependencies'],\n validationRules: [\n (frame) => frame.metadata?.research_complete === true,\n ],\n },\n {\n name: 'design',\n requiredOutputs: ['architecture_decision', 'api_design'],\n validationRules: [(frame) => frame.metadata?.design_reviewed === true],\n },\n {\n name: 'implement',\n requiredOutputs: ['implementation_files', 'tests'],\n validationRules: [\n (frame) => frame.metadata?.tests_passing === true,\n (frame) => frame.metadata?.lint_passing === true,\n ],\n },\n {\n name: 'validate',\n requiredOutputs: ['test_results', 'performance_metrics'],\n validationRules: [\n (frame) => frame.metadata?.validation_complete === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Bug Fix Workflow\n */\n static BUGFIX: WorkflowTemplate = {\n name: 'bugfix',\n description: 'Bug fixing workflow',\n phases: [\n {\n name: 'reproduce',\n requiredOutputs: ['reproduction_steps', 'failing_test'],\n validationRules: [(frame) => frame.metadata?.bug_reproduced === true],\n },\n {\n name: 'diagnose',\n requiredOutputs: ['root_cause', 'affected_code'],\n validationRules: [(frame) => frame.metadata?.cause_identified === true],\n },\n {\n name: 'fix',\n requiredOutputs: ['fix_commits', 'updated_tests'],\n validationRules: [(frame) => frame.metadata?.fix_applied === true],\n },\n {\n name: 'verify',\n requiredOutputs: ['verification_results', 'regression_tests'],\n validationRules: [\n (frame) => frame.metadata?.bug_fixed === true,\n (frame) => frame.metadata?.no_regressions === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Refactoring Workflow\n */\n static REFACTOR: WorkflowTemplate = {\n name: 'refactor',\n description: 'Code refactoring workflow',\n phases: [\n {\n name: 'analyze',\n requiredOutputs: [\n 'code_metrics',\n 'smell_detection',\n 'complexity_report',\n ],\n validationRules: [\n (frame) => frame.metadata?.analysis_complete === true,\n ],\n },\n {\n name: 'plan',\n requiredOutputs: ['refactor_plan', 'risk_assessment'],\n validationRules: [(frame) => frame.metadata?.plan_approved === true],\n },\n {\n name: 'refactor',\n requiredOutputs: ['refactored_code', 'preserved_tests'],\n validationRules: [(frame) => frame.metadata?.tests_passing === true],\n },\n {\n name: 'validate',\n requiredOutputs: ['before_after_metrics', 'performance_comparison'],\n validationRules: [\n (frame) => frame.metadata?.metrics_improved === true,\n (frame) => frame.metadata?.behavior_preserved === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Start a workflow, creating the parent frame and first phase frame\n */\n async startWorkflow(\n template: WorkflowTemplate,\n parentFrameId?: string\n ): Promise<Frame> {\n // Create parent workflow frame\n const workflowFrame = await this.frameManager.push(\n {\n type: 'workflow',\n description: `${template.name} workflow`,\n metadata: {\n workflow: template.name,\n current_phase: 0,\n phases: template.phases.map((p) => p.name),\n started_at: new Date().toISOString(),\n },\n },\n parentFrameId\n );\n\n // Auto-create first phase frame\n await this.startPhase(workflowFrame.id, 0);\n\n return workflowFrame;\n }\n\n /**\n * Transition to next phase if current phase is complete\n */\n async transitionPhase(frameId: string): Promise<boolean> {\n const frame = await this.frameManager.getFrame(frameId);\n if (!frame || frame.type !== 'workflow') return false;\n\n const currentPhase = frame.metadata?.current_phase || 0;\n const template = this.getTemplate(frame.metadata?.workflow);\n if (!template) return false;\n\n // Validate current phase completion\n const phaseFrame = await this.getCurrentPhaseFrame(frameId);\n if (!phaseFrame) return false;\n\n const phase = template.phases[currentPhase];\n const isComplete = await this.validatePhase(phaseFrame, phase);\n\n if (!isComplete) {\n console.log(`Phase ${phase.name} validation failed`);\n return false;\n }\n\n // Close current phase frame\n await this.frameManager.close(phaseFrame.id, {\n completed: true,\n phase: phase.name,\n });\n\n // Check if workflow is complete\n if (currentPhase >= template.phases.length - 1) {\n await this.frameManager.close(frameId, {\n workflow_complete: true,\n completed_at: new Date().toISOString(),\n });\n return true;\n }\n\n // Start next phase\n await this.frameManager.updateMetadata(frameId, {\n current_phase: currentPhase + 1,\n });\n await this.startPhase(frameId, currentPhase + 1);\n\n return true;\n }\n\n /**\n * Start a specific phase within a workflow\n */\n private async startPhase(\n workflowFrameId: string,\n phaseIndex: number\n ): Promise<Frame> {\n const frame = await this.frameManager.getFrame(workflowFrameId);\n const template = this.getTemplate(frame?.metadata?.workflow);\n if (!template || phaseIndex >= template.phases.length) {\n throw new Error('Invalid phase index');\n }\n\n const phase = template.phases[phaseIndex];\n return await this.frameManager.push(\n {\n type: 'phase',\n description: `Phase: ${phase.name}`,\n metadata: {\n phase_name: phase.name,\n phase_index: phaseIndex,\n required_outputs: phase.requiredOutputs,\n started_at: new Date().toISOString(),\n },\n },\n workflowFrameId\n );\n }\n\n /**\n * Validate a phase frame against its requirements\n */\n private async validatePhase(\n frame: Frame,\n phase: WorkflowPhase\n ): Promise<boolean> {\n // Check required outputs\n if (phase.requiredOutputs) {\n for (const output of phase.requiredOutputs) {\n if (!frame.metadata?.[output]) {\n return false;\n }\n }\n }\n\n // Run validation rules\n if (phase.validationRules) {\n for (const rule of phase.validationRules) {\n if (!rule(frame)) {\n return false;\n }\n }\n }\n\n return true;\n }\n\n /**\n * Get current phase frame for a workflow\n */\n private async getCurrentPhaseFrame(\n workflowFrameId: string\n ): Promise<Frame | null> {\n const children = await this.frameManager.getChildren(workflowFrameId);\n return (\n children.find((f) => f.type === 'phase' && f.status === 'open') || null\n );\n }\n\n /**\n * Get template by name\n */\n private getTemplate(name?: string): WorkflowTemplate | null {\n if (!name) return null;\n\n const templates: Record<string, WorkflowTemplate> = {\n tdd: WorkflowTemplates.TDD,\n feature: WorkflowTemplates.FEATURE,\n bugfix: WorkflowTemplates.BUGFIX,\n refactor: WorkflowTemplates.REFACTOR,\n };\n\n return templates[name] || null;\n }\n\n /**\n * List available workflow templates\n */\n static listTemplates(): WorkflowTemplate[] {\n return [\n WorkflowTemplates.TDD,\n WorkflowTemplates.FEATURE,\n WorkflowTemplates.BUGFIX,\n WorkflowTemplates.REFACTOR,\n ];\n }\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * Workflow Templates for StackMemory\n * Inspired by Continuous-Claude's structured approach\n *\n * Each workflow auto-creates child frames for phases\n * and enforces completion gates between transitions\n */\n\nimport { Frame } from '../types';\nimport { FrameManager } from './frame-manager';\n\nexport interface WorkflowPhase {\n name: string;\n requiredOutputs?: string[];\n validationRules?: ((frame: Frame) => boolean)[];\n autoTransition?: boolean;\n}\n\nexport interface WorkflowTemplate {\n name: string;\n description: string;\n phases: WorkflowPhase[];\n metadata?: Record<string, any>;\n}\n\nexport class WorkflowTemplates {\n private frameManager: FrameManager;\n\n constructor(frameManager: FrameManager) {\n this.frameManager = frameManager;\n }\n\n /**\n * TDD Workflow: Red \u2192 Green \u2192 Refactor\n */\n static TDD: WorkflowTemplate = {\n name: 'tdd',\n description: 'Test-Driven Development workflow',\n phases: [\n {\n name: 'write-failing-tests',\n requiredOutputs: ['test_file', 'test_count'],\n validationRules: [(frame) => frame.metadata?.tests_failing === true],\n },\n {\n name: 'implement-minimal',\n requiredOutputs: ['implementation_file'],\n validationRules: [(frame) => frame.metadata?.tests_passing === true],\n },\n {\n name: 'refactor',\n requiredOutputs: ['refactored_files'],\n validationRules: [\n (frame) => frame.metadata?.tests_passing === true,\n (frame) => frame.metadata?.complexity_reduced === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Feature Development Workflow\n */\n static FEATURE: WorkflowTemplate = {\n name: 'feature',\n description: 'Feature development workflow',\n phases: [\n {\n name: 'research',\n requiredOutputs: ['requirements', 'constraints', 'dependencies'],\n validationRules: [\n (frame) => frame.metadata?.research_complete === true,\n ],\n },\n {\n name: 'design',\n requiredOutputs: ['architecture_decision', 'api_design'],\n validationRules: [(frame) => frame.metadata?.design_reviewed === true],\n },\n {\n name: 'implement',\n requiredOutputs: ['implementation_files', 'tests'],\n validationRules: [\n (frame) => frame.metadata?.tests_passing === true,\n (frame) => frame.metadata?.lint_passing === true,\n ],\n },\n {\n name: 'validate',\n requiredOutputs: ['test_results', 'performance_metrics'],\n validationRules: [\n (frame) => frame.metadata?.validation_complete === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Bug Fix Workflow\n */\n static BUGFIX: WorkflowTemplate = {\n name: 'bugfix',\n description: 'Bug fixing workflow',\n phases: [\n {\n name: 'reproduce',\n requiredOutputs: ['reproduction_steps', 'failing_test'],\n validationRules: [(frame) => frame.metadata?.bug_reproduced === true],\n },\n {\n name: 'diagnose',\n requiredOutputs: ['root_cause', 'affected_code'],\n validationRules: [(frame) => frame.metadata?.cause_identified === true],\n },\n {\n name: 'fix',\n requiredOutputs: ['fix_commits', 'updated_tests'],\n validationRules: [(frame) => frame.metadata?.fix_applied === true],\n },\n {\n name: 'verify',\n requiredOutputs: ['verification_results', 'regression_tests'],\n validationRules: [\n (frame) => frame.metadata?.bug_fixed === true,\n (frame) => frame.metadata?.no_regressions === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Refactoring Workflow\n */\n static REFACTOR: WorkflowTemplate = {\n name: 'refactor',\n description: 'Code refactoring workflow',\n phases: [\n {\n name: 'analyze',\n requiredOutputs: [\n 'code_metrics',\n 'smell_detection',\n 'complexity_report',\n ],\n validationRules: [\n (frame) => frame.metadata?.analysis_complete === true,\n ],\n },\n {\n name: 'plan',\n requiredOutputs: ['refactor_plan', 'risk_assessment'],\n validationRules: [(frame) => frame.metadata?.plan_approved === true],\n },\n {\n name: 'refactor',\n requiredOutputs: ['refactored_code', 'preserved_tests'],\n validationRules: [(frame) => frame.metadata?.tests_passing === true],\n },\n {\n name: 'validate',\n requiredOutputs: ['before_after_metrics', 'performance_comparison'],\n validationRules: [\n (frame) => frame.metadata?.metrics_improved === true,\n (frame) => frame.metadata?.behavior_preserved === true,\n ],\n autoTransition: true,\n },\n ],\n };\n\n /**\n * Start a workflow, creating the parent frame and first phase frame\n */\n async startWorkflow(\n template: WorkflowTemplate,\n parentFrameId?: string\n ): Promise<Frame> {\n // Create parent workflow frame\n const workflowFrame = await this.frameManager.push(\n {\n type: 'workflow',\n description: `${template.name} workflow`,\n metadata: {\n workflow: template.name,\n current_phase: 0,\n phases: template.phases.map((p) => p.name),\n started_at: new Date().toISOString(),\n },\n },\n parentFrameId\n );\n\n // Auto-create first phase frame\n await this.startPhase(workflowFrame.id, 0);\n\n return workflowFrame;\n }\n\n /**\n * Transition to next phase if current phase is complete\n */\n async transitionPhase(frameId: string): Promise<boolean> {\n const frame = await this.frameManager.getFrame(frameId);\n if (!frame || frame.type !== 'workflow') return false;\n\n const currentPhase = frame.metadata?.current_phase || 0;\n const template = this.getTemplate(frame.metadata?.workflow);\n if (!template) return false;\n\n // Validate current phase completion\n const phaseFrame = await this.getCurrentPhaseFrame(frameId);\n if (!phaseFrame) return false;\n\n const phase = template.phases[currentPhase];\n const isComplete = await this.validatePhase(phaseFrame, phase);\n\n if (!isComplete) {\n console.log(`Phase ${phase.name} validation failed`);\n return false;\n }\n\n // Close current phase frame\n await this.frameManager.close(phaseFrame.id, {\n completed: true,\n phase: phase.name,\n });\n\n // Check if workflow is complete\n if (currentPhase >= template.phases.length - 1) {\n await this.frameManager.close(frameId, {\n workflow_complete: true,\n completed_at: new Date().toISOString(),\n });\n return true;\n }\n\n // Start next phase\n await this.frameManager.updateMetadata(frameId, {\n current_phase: currentPhase + 1,\n });\n await this.startPhase(frameId, currentPhase + 1);\n\n return true;\n }\n\n /**\n * Start a specific phase within a workflow\n */\n private async startPhase(\n workflowFrameId: string,\n phaseIndex: number\n ): Promise<Frame> {\n const frame = await this.frameManager.getFrame(workflowFrameId);\n const template = this.getTemplate(frame?.metadata?.workflow);\n if (!template || phaseIndex >= template.phases.length) {\n throw new Error('Invalid phase index');\n }\n\n const phase = template.phases[phaseIndex];\n return await this.frameManager.push(\n {\n type: 'phase',\n description: `Phase: ${phase.name}`,\n metadata: {\n phase_name: phase.name,\n phase_index: phaseIndex,\n required_outputs: phase.requiredOutputs,\n started_at: new Date().toISOString(),\n },\n },\n workflowFrameId\n );\n }\n\n /**\n * Validate a phase frame against its requirements\n */\n private async validatePhase(\n frame: Frame,\n phase: WorkflowPhase\n ): Promise<boolean> {\n // Check required outputs\n if (phase.requiredOutputs) {\n for (const output of phase.requiredOutputs) {\n if (!frame.metadata?.[output]) {\n return false;\n }\n }\n }\n\n // Run validation rules\n if (phase.validationRules) {\n for (const rule of phase.validationRules) {\n if (!rule(frame)) {\n return false;\n }\n }\n }\n\n return true;\n }\n\n /**\n * Get current phase frame for a workflow\n */\n private async getCurrentPhaseFrame(\n workflowFrameId: string\n ): Promise<Frame | null> {\n const children = await this.frameManager.getChildren(workflowFrameId);\n return (\n children.find((f) => f.type === 'phase' && f.status === 'open') || null\n );\n }\n\n /**\n * Get template by name\n */\n private getTemplate(name?: string): WorkflowTemplate | null {\n if (!name) return null;\n\n const templates: Record<string, WorkflowTemplate> = {\n tdd: WorkflowTemplates.TDD,\n feature: WorkflowTemplates.FEATURE,\n bugfix: WorkflowTemplates.BUGFIX,\n refactor: WorkflowTemplates.REFACTOR,\n };\n\n return templates[name] || null;\n }\n\n /**\n * List available workflow templates\n */\n static listTemplates(): WorkflowTemplate[] {\n return [\n WorkflowTemplates.TDD,\n WorkflowTemplates.FEATURE,\n WorkflowTemplates.BUGFIX,\n WorkflowTemplates.REFACTOR,\n ];\n }\n}\n\n/**\n * Export workflow templates object for CLI commands\n */\nexport const workflowTemplates = {\n tdd: {\n name: 'Test-Driven Development',\n description: 'Write tests first, then implement',\n phases: [\n { name: 'write-failing-tests', description: 'Write tests that fail' },\n { name: 'implement-code', description: 'Make tests pass' },\n { name: 'refactor', description: 'Clean up code' },\n ],\n },\n feature: {\n name: 'Feature Development',\n description: 'Develop a new feature',\n phases: [\n { name: 'design', description: 'Design the feature' },\n { name: 'implement', description: 'Build the feature' },\n { name: 'test', description: 'Test the feature' },\n ],\n },\n bugfix: {\n name: 'Bug Fix',\n description: 'Fix a reported bug',\n phases: [\n { name: 'reproduce', description: 'Reproduce the bug' },\n { name: 'fix', description: 'Fix the bug' },\n { name: 'verify', description: 'Verify the fix' },\n ],\n },\n refactor: {\n name: 'Refactoring',\n description: 'Improve code structure',\n phases: [\n { name: 'analyze', description: 'Analyze current code' },\n { name: 'refactor', description: 'Refactor code' },\n { name: 'test', description: 'Ensure no regressions' },\n ],\n },\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -39,7 +39,12 @@ class Logger {
39
39
  this.logLevel = 2 /* INFO */;
40
40
  }
41
41
  if (this.logLevel === 3 /* DEBUG */ || process.env["STACKMEMORY_LOG_FILE"]) {
42
- this.logFile = process.env["STACKMEMORY_LOG_FILE"] || path.join(process.env["HOME"] || ".", ".stackmemory", "logs", "cli.log");
42
+ this.logFile = process.env["STACKMEMORY_LOG_FILE"] || path.join(
43
+ process.env["HOME"] || ".",
44
+ ".stackmemory",
45
+ "logs",
46
+ "cli.log"
47
+ );
43
48
  this.ensureLogDirectory();
44
49
  }
45
50
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/core/monitoring/logger.ts"],
4
- "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\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 (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) 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 // eslint-disable-next-line no-console\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 // eslint-disable-next-line no-console\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"],
5
- "mappings": "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",
4
+ "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"],
5
+ "mappings": "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",
6
6
  "names": ["LogLevel"]
7
7
  }