@stackmemoryai/stackmemory 0.2.8 → 0.3.0

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 (608) hide show
  1. package/dist/agents/core/agent-task-manager.js +512 -0
  2. package/dist/agents/core/agent-task-manager.js.map +7 -0
  3. package/dist/agents/verifiers/base-verifier.js +129 -0
  4. package/dist/agents/verifiers/base-verifier.js.map +7 -0
  5. package/dist/agents/verifiers/formatter-verifier.js +126 -0
  6. package/dist/agents/verifiers/formatter-verifier.js.map +7 -0
  7. package/dist/agents/verifiers/llm-judge.js +248 -0
  8. package/dist/agents/verifiers/llm-judge.js.map +7 -0
  9. package/dist/cli/__tests__/index.test.js +290 -0
  10. package/dist/cli/__tests__/index.test.js.map +7 -0
  11. package/dist/cli/auto-detect.js +317 -0
  12. package/dist/cli/auto-detect.js.map +7 -0
  13. package/dist/cli/browser-test.js +29 -0
  14. package/dist/cli/browser-test.js.map +7 -0
  15. package/dist/cli/claude-sm.js +369 -0
  16. package/dist/cli/claude-sm.js.map +7 -0
  17. package/dist/cli/codex-sm.js +283 -0
  18. package/dist/cli/codex-sm.js.map +7 -0
  19. package/dist/cli/commands/agent.js +286 -0
  20. package/dist/cli/commands/agent.js.map +7 -0
  21. package/dist/cli/commands/config.js +199 -0
  22. package/dist/cli/commands/config.js.map +7 -0
  23. package/dist/cli/commands/context.js +327 -0
  24. package/dist/cli/commands/context.js.map +7 -0
  25. package/dist/cli/commands/handoff.js +191 -0
  26. package/dist/cli/commands/handoff.js.map +7 -0
  27. package/dist/cli/commands/linear-test.js +115 -0
  28. package/dist/cli/commands/linear-test.js.map +7 -0
  29. package/dist/cli/commands/linear.js +378 -0
  30. package/dist/cli/commands/linear.js.map +7 -0
  31. package/dist/cli/commands/log.js +165 -0
  32. package/dist/cli/commands/log.js.map +7 -0
  33. package/dist/cli/commands/onboard.js +349 -0
  34. package/dist/cli/commands/onboard.js.map +7 -0
  35. package/dist/cli/commands/projects.js +195 -0
  36. package/dist/cli/commands/projects.js.map +7 -0
  37. package/dist/cli/commands/search.js +152 -0
  38. package/dist/cli/commands/search.js.map +7 -0
  39. package/dist/cli/commands/session.js +179 -0
  40. package/dist/cli/commands/session.js.map +7 -0
  41. package/dist/cli/commands/tasks.js +205 -0
  42. package/dist/cli/commands/tasks.js.map +7 -0
  43. package/dist/cli/commands/webhook.js +131 -0
  44. package/dist/cli/commands/webhook.js.map +7 -0
  45. package/dist/cli/commands/worktree.js +276 -0
  46. package/dist/cli/commands/worktree.js.map +7 -0
  47. package/dist/cli/index.js +953 -0
  48. package/dist/cli/index.js.map +7 -0
  49. package/dist/cli/utils/viewer.js +92 -0
  50. package/dist/cli/utils/viewer.js.map +7 -0
  51. package/dist/core/config/__tests__/config-manager.test.js +248 -0
  52. package/dist/core/config/__tests__/config-manager.test.js.map +7 -0
  53. package/dist/core/config/config-manager.js +368 -0
  54. package/dist/core/config/config-manager.js.map +7 -0
  55. package/dist/core/config/types.js +140 -0
  56. package/dist/core/config/types.js.map +7 -0
  57. package/dist/core/context/__tests__/frame-manager.test.js +879 -0
  58. package/dist/core/context/__tests__/frame-manager.test.js.map +7 -0
  59. package/dist/core/context/auto-context.js +72 -0
  60. package/dist/core/context/auto-context.js.map +7 -0
  61. package/dist/core/context/compaction-handler.js +326 -0
  62. package/dist/core/context/compaction-handler.js.map +7 -0
  63. package/dist/core/context/frame-database.js +376 -0
  64. package/dist/core/context/frame-database.js.map +7 -0
  65. package/dist/core/context/frame-digest.js +239 -0
  66. package/dist/core/context/frame-digest.js.map +7 -0
  67. package/dist/core/context/frame-manager.js +682 -0
  68. package/dist/core/context/frame-manager.js.map +7 -0
  69. package/dist/core/context/frame-stack.js +270 -0
  70. package/dist/core/context/frame-stack.js.map +7 -0
  71. package/dist/core/context/frame-types.js +1 -0
  72. package/dist/core/context/frame-types.js.map +7 -0
  73. package/dist/core/context/index.js +33 -0
  74. package/dist/core/context/index.js.map +7 -0
  75. package/dist/core/context/model-aware-compaction.js +619 -0
  76. package/dist/core/context/model-aware-compaction.js.map +7 -0
  77. package/dist/core/context/refactored-frame-manager.js +393 -0
  78. package/dist/core/context/refactored-frame-manager.js.map +7 -0
  79. package/dist/core/database/batch-operations.js +329 -0
  80. package/dist/core/database/batch-operations.js.map +7 -0
  81. package/dist/core/database/connection-pool.js +224 -0
  82. package/dist/core/database/connection-pool.js.map +7 -0
  83. package/dist/core/database/query-cache.js +284 -0
  84. package/dist/core/database/query-cache.js.map +7 -0
  85. package/dist/core/digest/__tests__/enhanced-hybrid-digest.test.js +379 -0
  86. package/dist/core/digest/__tests__/enhanced-hybrid-digest.test.js.map +7 -0
  87. package/dist/core/digest/__tests__/frame-digest-integration.test.js +230 -0
  88. package/dist/core/digest/__tests__/frame-digest-integration.test.js.map +7 -0
  89. package/dist/core/digest/enhanced-hybrid-digest.js +267 -0
  90. package/dist/core/digest/enhanced-hybrid-digest.js.map +7 -0
  91. package/dist/core/digest/frame-digest-integration.js +172 -0
  92. package/dist/core/digest/frame-digest-integration.js.map +7 -0
  93. package/dist/core/digest/hybrid-digest-generator.js +549 -0
  94. package/dist/core/digest/hybrid-digest-generator.js.map +7 -0
  95. package/dist/core/digest/index.js +5 -0
  96. package/dist/core/digest/index.js.map +7 -0
  97. package/dist/core/digest/types.js +21 -0
  98. package/dist/core/digest/types.js.map +7 -0
  99. package/dist/core/errors/__tests__/error-handling.test.js +270 -0
  100. package/dist/core/errors/__tests__/error-handling.test.js.map +7 -0
  101. package/dist/core/errors/index.js +239 -0
  102. package/dist/core/errors/index.js.map +7 -0
  103. package/dist/core/errors/recovery.js +258 -0
  104. package/dist/core/errors/recovery.js.map +7 -0
  105. package/dist/core/merge/__tests__/conflict-scenarios.test.js +414 -0
  106. package/dist/core/merge/__tests__/conflict-scenarios.test.js.map +7 -0
  107. package/dist/core/merge/conflict-detector.js +424 -0
  108. package/dist/core/merge/conflict-detector.js.map +7 -0
  109. package/dist/core/merge/index.js +5 -0
  110. package/dist/core/merge/index.js.map +7 -0
  111. package/dist/core/merge/resolution-engine.js +565 -0
  112. package/dist/core/merge/resolution-engine.js.map +7 -0
  113. package/dist/core/merge/stack-diff.js +528 -0
  114. package/dist/core/merge/stack-diff.js.map +7 -0
  115. package/dist/core/merge/types.js +1 -0
  116. package/dist/core/merge/types.js.map +7 -0
  117. package/dist/core/monitoring/error-handler.js +278 -0
  118. package/dist/core/monitoring/error-handler.js.map +7 -0
  119. package/dist/core/monitoring/logger.js +115 -0
  120. package/dist/core/monitoring/logger.js.map +7 -0
  121. package/dist/core/monitoring/metrics.js +157 -0
  122. package/dist/core/monitoring/metrics.js.map +7 -0
  123. package/dist/core/monitoring/progress-tracker.js +174 -0
  124. package/dist/core/monitoring/progress-tracker.js.map +7 -0
  125. package/dist/core/performance/context-cache.js +269 -0
  126. package/dist/core/performance/context-cache.js.map +7 -0
  127. package/dist/core/performance/index.js +7 -0
  128. package/dist/core/performance/index.js.map +7 -0
  129. package/dist/core/performance/lazy-context-loader.js +319 -0
  130. package/dist/core/performance/lazy-context-loader.js.map +7 -0
  131. package/dist/core/performance/monitor.js +217 -0
  132. package/dist/core/performance/monitor.js.map +7 -0
  133. package/dist/core/performance/optimized-frame-context.js +326 -0
  134. package/dist/core/performance/optimized-frame-context.js.map +7 -0
  135. package/dist/core/performance/performance-benchmark.js +269 -0
  136. package/dist/core/performance/performance-benchmark.js.map +7 -0
  137. package/dist/core/performance/performance-profiler.js +318 -0
  138. package/dist/core/performance/performance-profiler.js.map +7 -0
  139. package/dist/core/performance/streaming-jsonl-parser.js +187 -0
  140. package/dist/core/performance/streaming-jsonl-parser.js.map +7 -0
  141. package/dist/core/persistence/postgres-adapter.js +345 -0
  142. package/dist/core/persistence/postgres-adapter.js.map +7 -0
  143. package/dist/core/projects/project-manager.js +699 -0
  144. package/dist/core/projects/project-manager.js.map +7 -0
  145. package/dist/core/query/__tests__/query-parser.test.js +301 -0
  146. package/dist/core/query/__tests__/query-parser.test.js.map +7 -0
  147. package/dist/core/query/__tests__/query-templates.test.js +210 -0
  148. package/dist/core/query/__tests__/query-templates.test.js.map +7 -0
  149. package/dist/core/query/query-parser.js +366 -0
  150. package/dist/core/query/query-parser.js.map +7 -0
  151. package/dist/core/query/query-templates.js +317 -0
  152. package/dist/core/query/query-templates.js.map +7 -0
  153. package/dist/core/retrieval/index.js +4 -0
  154. package/dist/core/retrieval/index.js.map +7 -0
  155. package/dist/core/retrieval/llm-context-retrieval.js +577 -0
  156. package/dist/core/retrieval/llm-context-retrieval.js.map +7 -0
  157. package/dist/core/retrieval/summary-generator.js +585 -0
  158. package/dist/core/retrieval/summary-generator.js.map +7 -0
  159. package/dist/core/retrieval/types.js +17 -0
  160. package/dist/core/retrieval/types.js.map +7 -0
  161. package/dist/core/session/index.js +11 -0
  162. package/dist/core/session/index.js.map +7 -0
  163. package/dist/core/session/session-manager.js +297 -0
  164. package/dist/core/session/session-manager.js.map +7 -0
  165. package/dist/core/trace/cli-trace-wrapper.js +110 -0
  166. package/dist/core/trace/cli-trace-wrapper.js.map +7 -0
  167. package/dist/core/trace/db-trace-wrapper.js +215 -0
  168. package/dist/core/trace/db-trace-wrapper.js.map +7 -0
  169. package/dist/core/trace/debug-trace.js +385 -0
  170. package/dist/core/trace/debug-trace.js.map +7 -0
  171. package/dist/core/trace/index.js +158 -0
  172. package/dist/core/trace/index.js.map +7 -0
  173. package/dist/core/trace/linear-api-wrapper.js +169 -0
  174. package/dist/core/trace/linear-api-wrapper.js.map +7 -0
  175. package/dist/core/trace/trace-demo.js +135 -0
  176. package/dist/core/trace/trace-demo.js.map +7 -0
  177. package/dist/core/trace/trace-detector.demo.js +138 -0
  178. package/dist/core/trace/trace-detector.demo.js.map +7 -0
  179. package/dist/core/trace/trace-detector.js +386 -0
  180. package/dist/core/trace/trace-detector.js.map +7 -0
  181. package/dist/core/trace/trace-detector.test.js +401 -0
  182. package/dist/core/trace/trace-detector.test.js.map +7 -0
  183. package/dist/core/trace/trace-store.js +341 -0
  184. package/dist/core/trace/trace-store.js.map +7 -0
  185. package/dist/core/trace/types.js +73 -0
  186. package/dist/core/trace/types.js.map +7 -0
  187. package/dist/core/types.js +1 -0
  188. package/dist/core/types.js.map +7 -0
  189. package/dist/core/utils/update-checker.js +214 -0
  190. package/dist/core/utils/update-checker.js.map +7 -0
  191. package/dist/core/worktree/worktree-manager.js +450 -0
  192. package/dist/core/worktree/worktree-manager.js.map +7 -0
  193. package/dist/features/analytics/api/analytics-api.js +283 -0
  194. package/dist/features/analytics/api/analytics-api.js.map +7 -0
  195. package/dist/features/analytics/core/analytics-service.js +267 -0
  196. package/dist/features/analytics/core/analytics-service.js.map +7 -0
  197. package/dist/features/analytics/index.js +14 -0
  198. package/dist/features/analytics/index.js.map +7 -0
  199. package/dist/features/analytics/queries/metrics-queries.js +273 -0
  200. package/dist/features/analytics/queries/metrics-queries.js.map +7 -0
  201. package/dist/features/analytics/types/metrics.js +1 -0
  202. package/dist/features/analytics/types/metrics.js.map +7 -0
  203. package/dist/features/browser/browser-mcp.js +488 -0
  204. package/dist/features/browser/browser-mcp.js.map +7 -0
  205. package/dist/features/tasks/__tests__/pebbles-task-store.test.js +747 -0
  206. package/dist/features/tasks/__tests__/pebbles-task-store.test.js.map +7 -0
  207. package/dist/features/tasks/pebbles-task-store.js +647 -0
  208. package/dist/features/tasks/pebbles-task-store.js.map +7 -0
  209. package/dist/features/tasks/task-aware-context.js +406 -0
  210. package/dist/features/tasks/task-aware-context.js.map +7 -0
  211. package/dist/index.js +21 -0
  212. package/dist/index.js.map +7 -0
  213. package/dist/integrations/linear/__tests__/auth.test.js +558 -0
  214. package/dist/integrations/linear/__tests__/auth.test.js.map +7 -0
  215. package/dist/integrations/linear/__tests__/sync-service.test.js +760 -0
  216. package/dist/integrations/linear/__tests__/sync-service.test.js.map +7 -0
  217. package/dist/integrations/linear/auth.js +308 -0
  218. package/dist/integrations/linear/auth.js.map +7 -0
  219. package/dist/integrations/linear/auto-sync.js +244 -0
  220. package/dist/integrations/linear/auto-sync.js.map +7 -0
  221. package/dist/integrations/linear/client.js +448 -0
  222. package/dist/integrations/linear/client.js.map +7 -0
  223. package/dist/integrations/linear/config.js +115 -0
  224. package/dist/integrations/linear/config.js.map +7 -0
  225. package/dist/integrations/linear/sync-manager.js +233 -0
  226. package/dist/integrations/linear/sync-manager.js.map +7 -0
  227. package/dist/integrations/linear/sync-service.js +214 -0
  228. package/dist/integrations/linear/sync-service.js.map +7 -0
  229. package/dist/integrations/linear/sync.js +565 -0
  230. package/dist/integrations/linear/sync.js.map +7 -0
  231. package/dist/integrations/linear/types.js +1 -0
  232. package/dist/integrations/linear/types.js.map +7 -0
  233. package/dist/integrations/linear/webhook-server.js +204 -0
  234. package/dist/integrations/linear/webhook-server.js.map +7 -0
  235. package/dist/integrations/linear/webhook.js +269 -0
  236. package/dist/integrations/linear/webhook.js.map +7 -0
  237. package/dist/integrations/mcp/__tests__/server.test.js +798 -0
  238. package/dist/integrations/mcp/__tests__/server.test.js.map +7 -0
  239. package/dist/integrations/mcp/handlers/context-handlers.js +253 -0
  240. package/dist/integrations/mcp/handlers/context-handlers.js.map +7 -0
  241. package/dist/integrations/mcp/handlers/index.js +134 -0
  242. package/dist/integrations/mcp/handlers/index.js.map +7 -0
  243. package/dist/integrations/mcp/handlers/linear-handlers.js +243 -0
  244. package/dist/integrations/mcp/handlers/linear-handlers.js.map +7 -0
  245. package/dist/integrations/mcp/handlers/task-handlers.js +235 -0
  246. package/dist/integrations/mcp/handlers/task-handlers.js.map +7 -0
  247. package/dist/integrations/mcp/handlers/trace-handlers.js +304 -0
  248. package/dist/integrations/mcp/handlers/trace-handlers.js.map +7 -0
  249. package/dist/integrations/mcp/index.js +19 -0
  250. package/dist/integrations/mcp/index.js.map +7 -0
  251. package/dist/integrations/mcp/refactored-server.js +331 -0
  252. package/dist/integrations/mcp/refactored-server.js.map +7 -0
  253. package/dist/integrations/mcp/server.js +1621 -0
  254. package/dist/integrations/mcp/server.js.map +7 -0
  255. package/dist/integrations/mcp/tool-definitions.js +562 -0
  256. package/dist/integrations/mcp/tool-definitions.js.map +7 -0
  257. package/dist/integrations/mcp/trace-test.js +44 -0
  258. package/dist/integrations/mcp/trace-test.js.map +7 -0
  259. package/dist/integrations/pg-aiguide/embedding-provider.js +174 -0
  260. package/dist/integrations/pg-aiguide/embedding-provider.js.map +7 -0
  261. package/dist/integrations/pg-aiguide/semantic-search.js +183 -0
  262. package/dist/integrations/pg-aiguide/semantic-search.js.map +7 -0
  263. package/dist/integrations/pg-aiguide/timescale-analytics.js +220 -0
  264. package/dist/integrations/pg-aiguide/timescale-analytics.js.map +7 -0
  265. package/dist/mcp/stackmemory-mcp-server.js +550 -0
  266. package/dist/mcp/stackmemory-mcp-server.js.map +7 -0
  267. package/dist/middleware/exponential-rate-limiter.js +285 -0
  268. package/dist/middleware/exponential-rate-limiter.js.map +7 -0
  269. package/dist/models/user.model.js +351 -0
  270. package/dist/models/user.model.js.map +7 -0
  271. package/dist/scripts/benchmark-performance.d.ts +7 -0
  272. package/dist/scripts/benchmark-performance.d.ts.map +1 -0
  273. package/dist/scripts/benchmark-performance.js +44 -0
  274. package/dist/scripts/benchmark-performance.js.map +1 -0
  275. package/dist/scripts/cleanup-duplicate-tasks.d.ts +12 -0
  276. package/dist/scripts/cleanup-duplicate-tasks.d.ts.map +1 -0
  277. package/dist/scripts/cleanup-duplicate-tasks.js +215 -0
  278. package/dist/scripts/cleanup-duplicate-tasks.js.map +1 -0
  279. package/dist/servers/production/auth-middleware.js +513 -0
  280. package/dist/servers/production/auth-middleware.js.map +7 -0
  281. package/dist/servers/railway/index.js +390 -0
  282. package/dist/servers/railway/index.js.map +7 -0
  283. package/dist/services/config-service.js +62 -0
  284. package/dist/services/config-service.js.map +7 -0
  285. package/dist/services/context-service.js +191 -0
  286. package/dist/services/context-service.js.map +7 -0
  287. package/dist/src/agents/core/agent-task-manager.d.ts +154 -0
  288. package/dist/src/agents/core/agent-task-manager.d.ts.map +1 -0
  289. package/dist/src/agents/core/agent-task-manager.js +504 -0
  290. package/dist/src/agents/core/agent-task-manager.js.map +1 -0
  291. package/dist/src/agents/verifiers/base-verifier.d.ts +112 -0
  292. package/dist/src/agents/verifiers/base-verifier.d.ts.map +1 -0
  293. package/dist/src/agents/verifiers/base-verifier.js +130 -0
  294. package/dist/src/agents/verifiers/base-verifier.js.map +1 -0
  295. package/dist/src/agents/verifiers/formatter-verifier.d.ts +14 -0
  296. package/dist/src/agents/verifiers/formatter-verifier.d.ts.map +1 -0
  297. package/dist/src/agents/verifiers/formatter-verifier.js +107 -0
  298. package/dist/src/agents/verifiers/formatter-verifier.js.map +1 -0
  299. package/dist/src/agents/verifiers/llm-judge.d.ts +46 -0
  300. package/dist/src/agents/verifiers/llm-judge.d.ts.map +1 -0
  301. package/dist/src/agents/verifiers/llm-judge.js +248 -0
  302. package/dist/src/agents/verifiers/llm-judge.js.map +1 -0
  303. package/dist/src/cli/claude-sm.js +55 -0
  304. package/dist/src/cli/claude-sm.js.map +1 -1
  305. package/dist/src/cli/commands/agent.d.ts +9 -0
  306. package/dist/src/cli/commands/agent.d.ts.map +1 -0
  307. package/dist/src/cli/commands/agent.js +303 -0
  308. package/dist/src/cli/commands/agent.js.map +1 -0
  309. package/dist/src/cli/commands/handoff.d.ts +6 -0
  310. package/dist/src/cli/commands/handoff.d.ts.map +1 -0
  311. package/dist/src/cli/commands/handoff.js +212 -0
  312. package/dist/src/cli/commands/handoff.js.map +1 -0
  313. package/dist/src/cli/index.d.ts.map +1 -1
  314. package/dist/src/cli/index.js +4 -0
  315. package/dist/src/cli/index.js.map +1 -1
  316. package/dist/src/core/context/compaction-handler.d.ts.map +1 -1
  317. package/dist/src/core/context/compaction-handler.js +1 -1
  318. package/dist/src/core/context/compaction-handler.js.map +1 -1
  319. package/dist/src/core/context/frame-database.d.ts +59 -0
  320. package/dist/src/core/context/frame-database.d.ts.map +1 -0
  321. package/dist/src/core/context/frame-database.js +333 -0
  322. package/dist/src/core/context/frame-database.js.map +1 -0
  323. package/dist/src/core/context/frame-digest.d.ts +59 -0
  324. package/dist/src/core/context/frame-digest.d.ts.map +1 -0
  325. package/dist/src/core/context/frame-digest.js +264 -0
  326. package/dist/src/core/context/frame-digest.js.map +1 -0
  327. package/dist/src/core/context/frame-manager.d.ts +2 -0
  328. package/dist/src/core/context/frame-manager.d.ts.map +1 -1
  329. package/dist/src/core/context/frame-manager.js +7 -0
  330. package/dist/src/core/context/frame-manager.js.map +1 -1
  331. package/dist/src/core/context/frame-stack.d.ts +85 -0
  332. package/dist/src/core/context/frame-stack.d.ts.map +1 -0
  333. package/dist/src/core/context/frame-stack.js +287 -0
  334. package/dist/src/core/context/frame-stack.js.map +1 -0
  335. package/dist/src/core/context/frame-types.d.ts +67 -0
  336. package/dist/src/core/context/frame-types.d.ts.map +1 -0
  337. package/dist/src/core/context/frame-types.js +6 -0
  338. package/dist/src/core/context/frame-types.js.map +1 -0
  339. package/dist/src/core/context/index.d.ts +11 -0
  340. package/dist/src/core/context/index.d.ts.map +1 -0
  341. package/dist/src/core/context/index.js +14 -0
  342. package/dist/src/core/context/index.js.map +1 -0
  343. package/dist/src/core/context/refactored-frame-manager.d.ts +99 -0
  344. package/dist/src/core/context/refactored-frame-manager.d.ts.map +1 -0
  345. package/dist/src/core/context/refactored-frame-manager.js +340 -0
  346. package/dist/src/core/context/refactored-frame-manager.js.map +1 -0
  347. package/dist/src/core/database/batch-operations.d.ts +118 -0
  348. package/dist/src/core/database/batch-operations.d.ts.map +1 -0
  349. package/dist/src/core/database/batch-operations.js +339 -0
  350. package/dist/src/core/database/batch-operations.js.map +1 -0
  351. package/dist/src/core/database/connection-pool.d.ts +79 -0
  352. package/dist/src/core/database/connection-pool.d.ts.map +1 -0
  353. package/dist/src/core/database/connection-pool.js +236 -0
  354. package/dist/src/core/database/connection-pool.js.map +1 -0
  355. package/dist/src/core/database/query-cache.d.ts +135 -0
  356. package/dist/src/core/database/query-cache.d.ts.map +1 -0
  357. package/dist/src/core/database/query-cache.js +294 -0
  358. package/dist/src/core/database/query-cache.js.map +1 -0
  359. package/dist/src/core/digest/enhanced-hybrid-digest.d.ts +125 -0
  360. package/dist/src/core/digest/enhanced-hybrid-digest.d.ts.map +1 -0
  361. package/dist/src/core/digest/enhanced-hybrid-digest.js +282 -0
  362. package/dist/src/core/digest/enhanced-hybrid-digest.js.map +1 -0
  363. package/dist/src/core/digest/frame-digest-integration.d.ts +67 -0
  364. package/dist/src/core/digest/frame-digest-integration.d.ts.map +1 -0
  365. package/dist/src/core/digest/frame-digest-integration.js +198 -0
  366. package/dist/src/core/digest/frame-digest-integration.js.map +1 -0
  367. package/dist/src/core/digest/hybrid-digest-generator.d.ts +76 -0
  368. package/dist/src/core/digest/hybrid-digest-generator.d.ts.map +1 -0
  369. package/dist/src/core/digest/hybrid-digest-generator.js +629 -0
  370. package/dist/src/core/digest/hybrid-digest-generator.js.map +1 -0
  371. package/dist/src/core/digest/index.d.ts +9 -0
  372. package/dist/src/core/digest/index.d.ts.map +1 -0
  373. package/dist/src/core/digest/index.js +9 -0
  374. package/dist/src/core/digest/index.js.map +1 -0
  375. package/dist/src/core/digest/types.d.ts +154 -0
  376. package/dist/src/core/digest/types.d.ts.map +1 -0
  377. package/dist/src/core/digest/types.js +18 -0
  378. package/dist/src/core/digest/types.js.map +1 -0
  379. package/dist/src/core/errors/index.d.ts +13 -5
  380. package/dist/src/core/errors/index.d.ts.map +1 -1
  381. package/dist/src/core/errors/index.js +13 -5
  382. package/dist/src/core/errors/index.js.map +1 -1
  383. package/dist/src/core/merge/conflict-detector.d.ts +122 -0
  384. package/dist/src/core/merge/conflict-detector.d.ts.map +1 -0
  385. package/dist/src/core/merge/conflict-detector.js +468 -0
  386. package/dist/src/core/merge/conflict-detector.js.map +1 -0
  387. package/dist/src/core/merge/index.d.ts +9 -0
  388. package/dist/src/core/merge/index.d.ts.map +1 -0
  389. package/dist/src/core/merge/index.js +9 -0
  390. package/dist/src/core/merge/index.js.map +1 -0
  391. package/dist/src/core/merge/resolution-engine.d.ts +120 -0
  392. package/dist/src/core/merge/resolution-engine.d.ts.map +1 -0
  393. package/dist/src/core/merge/resolution-engine.js +573 -0
  394. package/dist/src/core/merge/resolution-engine.js.map +1 -0
  395. package/dist/src/core/merge/stack-diff.d.ts +97 -0
  396. package/dist/src/core/merge/stack-diff.d.ts.map +1 -0
  397. package/dist/src/core/merge/stack-diff.js +516 -0
  398. package/dist/src/core/merge/stack-diff.js.map +1 -0
  399. package/dist/src/core/merge/types.d.ts +110 -0
  400. package/dist/src/core/merge/types.d.ts.map +1 -0
  401. package/dist/src/core/merge/types.js +6 -0
  402. package/dist/src/core/merge/types.js.map +1 -0
  403. package/dist/src/core/monitoring/logger.d.ts +2 -2
  404. package/dist/src/core/monitoring/logger.d.ts.map +1 -1
  405. package/dist/src/core/monitoring/logger.js +10 -5
  406. package/dist/src/core/monitoring/logger.js.map +1 -1
  407. package/dist/src/core/monitoring/metrics.d.ts +3 -0
  408. package/dist/src/core/monitoring/metrics.d.ts.map +1 -1
  409. package/dist/src/core/monitoring/metrics.js +142 -3
  410. package/dist/src/core/monitoring/metrics.js.map +1 -1
  411. package/dist/src/core/performance/context-cache.d.ts +109 -0
  412. package/dist/src/core/performance/context-cache.d.ts.map +1 -0
  413. package/dist/src/core/performance/context-cache.js +280 -0
  414. package/dist/src/core/performance/context-cache.js.map +1 -0
  415. package/dist/src/core/performance/index.d.ts +3 -0
  416. package/dist/src/core/performance/index.d.ts.map +1 -0
  417. package/dist/src/core/performance/index.js +3 -0
  418. package/dist/src/core/performance/index.js.map +1 -0
  419. package/dist/src/core/performance/lazy-context-loader.d.ts +93 -0
  420. package/dist/src/core/performance/lazy-context-loader.d.ts.map +1 -0
  421. package/dist/src/core/performance/lazy-context-loader.js +332 -0
  422. package/dist/src/core/performance/lazy-context-loader.js.map +1 -0
  423. package/dist/src/core/performance/monitor.d.ts +48 -0
  424. package/dist/src/core/performance/monitor.d.ts.map +1 -0
  425. package/dist/src/core/performance/monitor.js +226 -0
  426. package/dist/src/core/performance/monitor.js.map +1 -0
  427. package/dist/src/core/performance/optimized-frame-context.d.ts +74 -0
  428. package/dist/src/core/performance/optimized-frame-context.d.ts.map +1 -0
  429. package/dist/src/core/performance/optimized-frame-context.js +330 -0
  430. package/dist/src/core/performance/optimized-frame-context.js.map +1 -0
  431. package/dist/src/core/performance/performance-benchmark.d.ts +50 -0
  432. package/dist/src/core/performance/performance-benchmark.d.ts.map +1 -0
  433. package/dist/src/core/performance/performance-benchmark.js +290 -0
  434. package/dist/src/core/performance/performance-benchmark.js.map +1 -0
  435. package/dist/src/core/performance/performance-profiler.d.ts +151 -0
  436. package/dist/src/core/performance/performance-profiler.d.ts.map +1 -0
  437. package/dist/src/core/performance/performance-profiler.js +346 -0
  438. package/dist/src/core/performance/performance-profiler.js.map +1 -0
  439. package/dist/src/core/performance/streaming-jsonl-parser.d.ts +41 -0
  440. package/dist/src/core/performance/streaming-jsonl-parser.d.ts.map +1 -0
  441. package/dist/src/core/performance/streaming-jsonl-parser.js +193 -0
  442. package/dist/src/core/performance/streaming-jsonl-parser.js.map +1 -0
  443. package/dist/src/core/persistence/postgres-adapter.d.ts +31 -0
  444. package/dist/src/core/persistence/postgres-adapter.d.ts.map +1 -0
  445. package/dist/src/core/persistence/postgres-adapter.js +330 -0
  446. package/dist/src/core/persistence/postgres-adapter.js.map +1 -0
  447. package/dist/src/core/query/query-parser.d.ts +5 -0
  448. package/dist/src/core/query/query-parser.d.ts.map +1 -1
  449. package/dist/src/core/query/query-parser.js +86 -18
  450. package/dist/src/core/query/query-parser.js.map +1 -1
  451. package/dist/src/core/query/query-templates.d.ts +44 -0
  452. package/dist/src/core/query/query-templates.d.ts.map +1 -0
  453. package/dist/src/core/query/query-templates.js +326 -0
  454. package/dist/src/core/query/query-templates.js.map +1 -0
  455. package/dist/src/core/retrieval/llm-context-retrieval.d.ts +5 -3
  456. package/dist/src/core/retrieval/llm-context-retrieval.d.ts.map +1 -1
  457. package/dist/src/core/retrieval/llm-context-retrieval.js +73 -21
  458. package/dist/src/core/retrieval/llm-context-retrieval.js.map +1 -1
  459. package/dist/src/core/trace/cli-trace-wrapper.d.ts +23 -0
  460. package/dist/src/core/trace/cli-trace-wrapper.d.ts.map +1 -0
  461. package/dist/src/core/trace/cli-trace-wrapper.js +141 -0
  462. package/dist/src/core/trace/cli-trace-wrapper.js.map +1 -0
  463. package/dist/src/core/trace/db-trace-wrapper.d.ts +36 -0
  464. package/dist/src/core/trace/db-trace-wrapper.d.ts.map +1 -0
  465. package/dist/src/core/trace/db-trace-wrapper.js +252 -0
  466. package/dist/src/core/trace/db-trace-wrapper.js.map +1 -0
  467. package/dist/src/core/trace/debug-trace.d.ts +84 -0
  468. package/dist/src/core/trace/debug-trace.d.ts.map +1 -0
  469. package/dist/src/core/trace/debug-trace.js +402 -0
  470. package/dist/src/core/trace/debug-trace.js.map +1 -0
  471. package/dist/src/core/trace/error-test.d.ts +6 -0
  472. package/dist/src/core/trace/error-test.d.ts.map +1 -0
  473. package/dist/src/core/trace/error-test.js +128 -0
  474. package/dist/src/core/trace/error-test.js.map +1 -0
  475. package/dist/src/core/trace/index.d.ts +25 -0
  476. package/dist/src/core/trace/index.d.ts.map +1 -0
  477. package/dist/src/core/trace/index.js +121 -0
  478. package/dist/src/core/trace/index.js.map +1 -0
  479. package/dist/src/core/trace/linear-api-wrapper.d.ts +17 -0
  480. package/dist/src/core/trace/linear-api-wrapper.d.ts.map +1 -0
  481. package/dist/src/core/trace/linear-api-wrapper.js +205 -0
  482. package/dist/src/core/trace/linear-api-wrapper.js.map +1 -0
  483. package/dist/src/core/trace/performance-test.d.ts +6 -0
  484. package/dist/src/core/trace/performance-test.d.ts.map +1 -0
  485. package/dist/src/core/trace/performance-test.js +111 -0
  486. package/dist/src/core/trace/performance-test.js.map +1 -0
  487. package/dist/src/core/trace/trace-demo.d.ts +8 -0
  488. package/dist/src/core/trace/trace-demo.d.ts.map +1 -0
  489. package/dist/src/core/trace/trace-demo.js +154 -0
  490. package/dist/src/core/trace/trace-demo.js.map +1 -0
  491. package/dist/src/core/trace/trace-detector.d.ts +2 -2
  492. package/dist/src/core/trace/trace-detector.d.ts.map +1 -1
  493. package/dist/src/core/trace/trace-detector.demo.js +6 -6
  494. package/dist/src/core/trace/trace-detector.demo.js.map +1 -1
  495. package/dist/src/core/trace/trace-detector.js +3 -3
  496. package/dist/src/core/trace/trace-detector.js.map +1 -1
  497. package/dist/src/core/types.d.ts +35 -0
  498. package/dist/src/core/types.d.ts.map +1 -0
  499. package/dist/src/core/types.js +2 -0
  500. package/dist/src/core/types.js.map +1 -0
  501. package/dist/src/features/tasks/pebbles-task-store.d.ts +9 -2
  502. package/dist/src/features/tasks/pebbles-task-store.d.ts.map +1 -1
  503. package/dist/src/features/tasks/pebbles-task-store.js +97 -18
  504. package/dist/src/features/tasks/pebbles-task-store.js.map +1 -1
  505. package/dist/src/integrations/linear/auth.d.ts.map +1 -1
  506. package/dist/src/integrations/linear/auth.js.map +1 -1
  507. package/dist/src/integrations/linear/client.d.ts +15 -1
  508. package/dist/src/integrations/linear/client.d.ts.map +1 -1
  509. package/dist/src/integrations/linear/client.js +85 -3
  510. package/dist/src/integrations/linear/client.js.map +1 -1
  511. package/dist/src/integrations/linear/sync-manager.d.ts +2 -0
  512. package/dist/src/integrations/linear/sync-manager.d.ts.map +1 -1
  513. package/dist/src/integrations/linear/sync-manager.js +16 -4
  514. package/dist/src/integrations/linear/sync-manager.js.map +1 -1
  515. package/dist/src/integrations/linear/sync-service.d.ts +23 -2
  516. package/dist/src/integrations/linear/sync-service.d.ts.map +1 -1
  517. package/dist/src/integrations/linear/sync-service.js +44 -25
  518. package/dist/src/integrations/linear/sync-service.js.map +1 -1
  519. package/dist/src/integrations/linear/sync.d.ts +6 -0
  520. package/dist/src/integrations/linear/sync.d.ts.map +1 -1
  521. package/dist/src/integrations/linear/sync.js +27 -2
  522. package/dist/src/integrations/linear/sync.js.map +1 -1
  523. package/dist/src/integrations/linear/types.d.ts +16 -1
  524. package/dist/src/integrations/linear/types.d.ts.map +1 -1
  525. package/dist/src/integrations/linear/webhook-server.d.ts.map +1 -1
  526. package/dist/src/integrations/linear/webhook-server.js +10 -8
  527. package/dist/src/integrations/linear/webhook-server.js.map +1 -1
  528. package/dist/src/integrations/linear/webhook.d.ts +13 -0
  529. package/dist/src/integrations/linear/webhook.d.ts.map +1 -1
  530. package/dist/src/integrations/linear/webhook.js +101 -14
  531. package/dist/src/integrations/linear/webhook.js.map +1 -1
  532. package/dist/src/integrations/mcp/handlers/context-handlers.d.ts +39 -0
  533. package/dist/src/integrations/mcp/handlers/context-handlers.d.ts.map +1 -0
  534. package/dist/src/integrations/mcp/handlers/context-handlers.js +266 -0
  535. package/dist/src/integrations/mcp/handlers/context-handlers.js.map +1 -0
  536. package/dist/src/integrations/mcp/handlers/index.d.ts +37 -0
  537. package/dist/src/integrations/mcp/handlers/index.d.ts.map +1 -0
  538. package/dist/src/integrations/mcp/handlers/index.js +134 -0
  539. package/dist/src/integrations/mcp/handlers/index.js.map +1 -0
  540. package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts +33 -0
  541. package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts.map +1 -0
  542. package/dist/src/integrations/mcp/handlers/linear-handlers.js +251 -0
  543. package/dist/src/integrations/mcp/handlers/linear-handlers.js.map +1 -0
  544. package/dist/src/integrations/mcp/handlers/task-handlers.d.ts +42 -0
  545. package/dist/src/integrations/mcp/handlers/task-handlers.d.ts.map +1 -0
  546. package/dist/src/integrations/mcp/handlers/task-handlers.js +238 -0
  547. package/dist/src/integrations/mcp/handlers/task-handlers.js.map +1 -0
  548. package/dist/src/integrations/mcp/handlers/trace-handlers.d.ts +41 -0
  549. package/dist/src/integrations/mcp/handlers/trace-handlers.d.ts.map +1 -0
  550. package/dist/src/integrations/mcp/handlers/trace-handlers.js +298 -0
  551. package/dist/src/integrations/mcp/handlers/trace-handlers.js.map +1 -0
  552. package/dist/src/integrations/mcp/index.d.ts +13 -0
  553. package/dist/src/integrations/mcp/index.d.ts.map +1 -0
  554. package/dist/src/integrations/mcp/index.js +17 -0
  555. package/dist/src/integrations/mcp/index.js.map +1 -0
  556. package/dist/src/integrations/mcp/refactored-server.d.ts +76 -0
  557. package/dist/src/integrations/mcp/refactored-server.d.ts.map +1 -0
  558. package/dist/src/integrations/mcp/refactored-server.js +351 -0
  559. package/dist/src/integrations/mcp/refactored-server.js.map +1 -0
  560. package/dist/src/integrations/mcp/server.js +2 -2
  561. package/dist/src/integrations/mcp/server.js.map +1 -1
  562. package/dist/src/integrations/mcp/tool-definitions.d.ts +44 -0
  563. package/dist/src/integrations/mcp/tool-definitions.d.ts.map +1 -0
  564. package/dist/src/integrations/mcp/tool-definitions.js +563 -0
  565. package/dist/src/integrations/mcp/tool-definitions.js.map +1 -0
  566. package/dist/src/integrations/pg-aiguide/embedding-provider.d.ts +48 -0
  567. package/dist/src/integrations/pg-aiguide/embedding-provider.d.ts.map +1 -0
  568. package/dist/src/integrations/pg-aiguide/embedding-provider.js +190 -0
  569. package/dist/src/integrations/pg-aiguide/embedding-provider.js.map +1 -0
  570. package/dist/src/integrations/pg-aiguide/semantic-search.d.ts +34 -0
  571. package/dist/src/integrations/pg-aiguide/semantic-search.d.ts.map +1 -0
  572. package/dist/src/integrations/pg-aiguide/semantic-search.js +176 -0
  573. package/dist/src/integrations/pg-aiguide/semantic-search.js.map +1 -0
  574. package/dist/src/integrations/pg-aiguide/timescale-analytics.d.ts +44 -0
  575. package/dist/src/integrations/pg-aiguide/timescale-analytics.d.ts.map +1 -0
  576. package/dist/src/integrations/pg-aiguide/timescale-analytics.js +215 -0
  577. package/dist/src/integrations/pg-aiguide/timescale-analytics.js.map +1 -0
  578. package/dist/src/mcp/stackmemory-mcp-server.d.ts +9 -0
  579. package/dist/src/mcp/stackmemory-mcp-server.d.ts.map +1 -0
  580. package/dist/src/mcp/stackmemory-mcp-server.js +519 -0
  581. package/dist/src/mcp/stackmemory-mcp-server.js.map +1 -0
  582. package/dist/src/middleware/exponential-rate-limiter.d.ts +78 -0
  583. package/dist/src/middleware/exponential-rate-limiter.d.ts.map +1 -0
  584. package/dist/src/middleware/exponential-rate-limiter.js +293 -0
  585. package/dist/src/middleware/exponential-rate-limiter.js.map +1 -0
  586. package/dist/src/models/user.model.d.ts +62 -0
  587. package/dist/src/models/user.model.d.ts.map +1 -0
  588. package/dist/src/models/user.model.js +311 -0
  589. package/dist/src/models/user.model.js.map +1 -0
  590. package/dist/src/servers/production/auth-middleware.d.ts +12 -2
  591. package/dist/src/servers/production/auth-middleware.d.ts.map +1 -1
  592. package/dist/src/servers/production/auth-middleware.js +240 -28
  593. package/dist/src/servers/production/auth-middleware.js.map +1 -1
  594. package/dist/src/servers/railway/index.js.map +1 -1
  595. package/dist/src/services/context-service.d.ts.map +1 -1
  596. package/dist/src/services/context-service.js +86 -1
  597. package/dist/src/services/context-service.js.map +1 -1
  598. package/dist/src/validation/schemas.d.ts +633 -0
  599. package/dist/src/validation/schemas.d.ts.map +1 -0
  600. package/dist/src/validation/schemas.js +347 -0
  601. package/dist/src/validation/schemas.js.map +1 -0
  602. package/dist/types/task.js +1 -0
  603. package/dist/types/task.js.map +7 -0
  604. package/dist/utils/logger.js +52 -0
  605. package/dist/utils/logger.js.map +7 -0
  606. package/dist/validation/schemas.js +218 -0
  607. package/dist/validation/schemas.js.map +7 -0
  608. package/package.json +12 -3
@@ -0,0 +1,258 @@
1
+ import { logger } from "../monitoring/logger.js";
2
+ import {
3
+ isRetryableError,
4
+ getErrorMessage
5
+ } from "./index.js";
6
+ var CircuitState = /* @__PURE__ */ ((CircuitState2) => {
7
+ CircuitState2["CLOSED"] = "closed";
8
+ CircuitState2["OPEN"] = "open";
9
+ CircuitState2["HALF_OPEN"] = "half_open";
10
+ return CircuitState2;
11
+ })(CircuitState || {});
12
+ function calculateBackoff(attempt, initialDelay, maxDelay, factor) {
13
+ const exponentialDelay = Math.min(
14
+ initialDelay * Math.pow(factor, attempt - 1),
15
+ maxDelay
16
+ );
17
+ const jitter = exponentialDelay * Math.random() * 0.25;
18
+ return Math.floor(exponentialDelay + jitter);
19
+ }
20
+ async function retry(fn, options = {}) {
21
+ const {
22
+ maxAttempts = 3,
23
+ initialDelay = 1e3,
24
+ maxDelay = 3e4,
25
+ backoffFactor = 2,
26
+ timeout,
27
+ onRetry
28
+ } = options;
29
+ let lastError;
30
+ for (let attempt = 1; attempt <= maxAttempts; attempt++) {
31
+ try {
32
+ if (timeout) {
33
+ return await Promise.race([
34
+ fn(),
35
+ new Promise(
36
+ (_, reject) => setTimeout(
37
+ () => reject(new Error(`Operation timed out after ${timeout}ms`)),
38
+ timeout
39
+ )
40
+ )
41
+ ]);
42
+ }
43
+ return await fn();
44
+ } catch (error) {
45
+ lastError = error;
46
+ if (!isRetryableError(error) || attempt === maxAttempts) {
47
+ throw error;
48
+ }
49
+ const delay = calculateBackoff(attempt, initialDelay, maxDelay, backoffFactor);
50
+ logger.warn(`Retry attempt ${attempt}/${maxAttempts} after ${delay}ms`, {
51
+ error: getErrorMessage(error),
52
+ attempt,
53
+ delay
54
+ });
55
+ if (onRetry) {
56
+ onRetry(attempt, error);
57
+ }
58
+ await new Promise((resolve) => setTimeout(resolve, delay));
59
+ }
60
+ }
61
+ throw lastError;
62
+ }
63
+ class CircuitBreaker {
64
+ constructor(name, options = {}) {
65
+ this.name = name;
66
+ this.options = {
67
+ failureThreshold: options.failureThreshold ?? 5,
68
+ resetTimeout: options.resetTimeout ?? 6e4,
69
+ halfOpenRequests: options.halfOpenRequests ?? 3
70
+ };
71
+ }
72
+ state = "closed" /* CLOSED */;
73
+ failures = 0;
74
+ successCount = 0;
75
+ lastFailTime;
76
+ options;
77
+ async execute(fn) {
78
+ if (this.state === "open" /* OPEN */) {
79
+ const timeSinceLastFailure = this.lastFailTime ? Date.now() - this.lastFailTime.getTime() : 0;
80
+ if (timeSinceLastFailure >= this.options.resetTimeout) {
81
+ this.state = "half_open" /* HALF_OPEN */;
82
+ this.successCount = 0;
83
+ logger.info(`Circuit breaker ${this.name} entering half-open state`);
84
+ } else {
85
+ throw new Error(
86
+ `Circuit breaker ${this.name} is OPEN. Retry after ${this.options.resetTimeout - timeSinceLastFailure}ms`
87
+ );
88
+ }
89
+ }
90
+ try {
91
+ const result = await fn();
92
+ if (this.state === "half_open" /* HALF_OPEN */) {
93
+ this.successCount++;
94
+ if (this.successCount >= this.options.halfOpenRequests) {
95
+ this.state = "closed" /* CLOSED */;
96
+ this.failures = 0;
97
+ logger.info(`Circuit breaker ${this.name} is now CLOSED`);
98
+ }
99
+ } else {
100
+ this.failures = 0;
101
+ }
102
+ return result;
103
+ } catch (error) {
104
+ this.handleFailure(error);
105
+ throw error;
106
+ }
107
+ }
108
+ handleFailure(error) {
109
+ this.failures++;
110
+ this.lastFailTime = /* @__PURE__ */ new Date();
111
+ if (this.state === "half_open" /* HALF_OPEN */) {
112
+ this.state = "open" /* OPEN */;
113
+ logger.error(
114
+ `Circuit breaker ${this.name} reopened due to failure in half-open state`
115
+ );
116
+ } else if (this.state === "closed" /* CLOSED */ && this.failures >= this.options.failureThreshold) {
117
+ this.state = "open" /* OPEN */;
118
+ logger.error(
119
+ `Circuit breaker ${this.name} opened after ${this.failures} failures`
120
+ );
121
+ }
122
+ }
123
+ getState() {
124
+ return this.state;
125
+ }
126
+ reset() {
127
+ this.state = "closed" /* CLOSED */;
128
+ this.failures = 0;
129
+ this.successCount = 0;
130
+ this.lastFailTime = void 0;
131
+ logger.info(`Circuit breaker ${this.name} manually reset`);
132
+ }
133
+ }
134
+ async function withFallback(primary, fallbacks, context) {
135
+ const errors = [];
136
+ try {
137
+ return await primary();
138
+ } catch (error) {
139
+ errors.push(error);
140
+ logger.warn("Primary operation failed, trying fallbacks", {
141
+ error: getErrorMessage(error),
142
+ context
143
+ });
144
+ }
145
+ for (let i = 0; i < fallbacks.length; i++) {
146
+ try {
147
+ const result = await fallbacks[i]();
148
+ logger.info(`Fallback ${i + 1} succeeded`, { context });
149
+ return result;
150
+ } catch (error) {
151
+ errors.push(error);
152
+ if (i < fallbacks.length - 1) {
153
+ logger.warn(`Fallback ${i + 1} failed, trying next`, {
154
+ error: getErrorMessage(error),
155
+ context
156
+ });
157
+ }
158
+ }
159
+ }
160
+ throw new Error(
161
+ `All attempts failed. Errors: ${errors.map(getErrorMessage).join(", ")}`
162
+ );
163
+ }
164
+ class Bulkhead {
165
+ constructor(name, maxConcurrent) {
166
+ this.name = name;
167
+ this.maxConcurrent = maxConcurrent;
168
+ }
169
+ running = 0;
170
+ queue = [];
171
+ async execute(fn) {
172
+ if (this.running >= this.maxConcurrent) {
173
+ await new Promise((resolve) => {
174
+ this.queue.push(resolve);
175
+ });
176
+ }
177
+ this.running++;
178
+ try {
179
+ return await fn();
180
+ } finally {
181
+ this.running--;
182
+ const next = this.queue.shift();
183
+ if (next) {
184
+ next();
185
+ }
186
+ }
187
+ }
188
+ getStats() {
189
+ return {
190
+ running: this.running,
191
+ queued: this.queue.length,
192
+ maxConcurrent: this.maxConcurrent
193
+ };
194
+ }
195
+ }
196
+ async function withTimeout(fn, timeoutMs, timeoutMessage) {
197
+ return Promise.race([
198
+ fn(),
199
+ new Promise(
200
+ (_, reject) => setTimeout(
201
+ () => reject(
202
+ new Error(timeoutMessage ?? `Operation timed out after ${timeoutMs}ms`)
203
+ ),
204
+ timeoutMs
205
+ )
206
+ )
207
+ ]);
208
+ }
209
+ async function gracefulDegrade(fn, defaultValue, logContext) {
210
+ try {
211
+ return await fn();
212
+ } catch (error) {
213
+ logger.warn("Operation failed, using default value", {
214
+ error: getErrorMessage(error),
215
+ ...logContext
216
+ });
217
+ return defaultValue;
218
+ }
219
+ }
220
+ function createResilientOperation(name, options = {}) {
221
+ const circuitBreaker = options.circuitBreaker ? new CircuitBreaker(name, options.circuitBreaker) : null;
222
+ const bulkhead = options.bulkhead ? new Bulkhead(name, options.bulkhead) : null;
223
+ return async (fn) => {
224
+ let currentFn = fn;
225
+ if (bulkhead) {
226
+ const wrapped = currentFn;
227
+ currentFn = () => bulkhead.execute(wrapped);
228
+ }
229
+ if (options.timeout) {
230
+ const wrapped = currentFn;
231
+ currentFn = () => withTimeout(wrapped, options.timeout);
232
+ }
233
+ if (options.retry) {
234
+ const wrapped = currentFn;
235
+ currentFn = () => retry(wrapped, options.retry);
236
+ }
237
+ if (circuitBreaker) {
238
+ const wrapped = currentFn;
239
+ currentFn = () => circuitBreaker.execute(wrapped);
240
+ }
241
+ if (options.fallback) {
242
+ return withFallback(currentFn, [options.fallback]);
243
+ }
244
+ return currentFn();
245
+ };
246
+ }
247
+ export {
248
+ Bulkhead,
249
+ CircuitBreaker,
250
+ CircuitState,
251
+ calculateBackoff,
252
+ createResilientOperation,
253
+ gracefulDegrade,
254
+ retry,
255
+ withFallback,
256
+ withTimeout
257
+ };
258
+ //# sourceMappingURL=recovery.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 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) {\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) {\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) {\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) {\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) {\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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",
6
+ "names": ["CircuitState"]
7
+ }