@stackmemoryai/stackmemory 0.2.9 → 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.
- package/dist/agents/core/agent-task-manager.js +512 -0
- package/dist/agents/core/agent-task-manager.js.map +7 -0
- package/dist/agents/verifiers/base-verifier.js +129 -0
- package/dist/agents/verifiers/base-verifier.js.map +7 -0
- package/dist/agents/verifiers/formatter-verifier.js +126 -0
- package/dist/agents/verifiers/formatter-verifier.js.map +7 -0
- package/dist/agents/verifiers/llm-judge.js +248 -0
- package/dist/agents/verifiers/llm-judge.js.map +7 -0
- package/dist/cli/__tests__/index.test.js +290 -0
- package/dist/cli/__tests__/index.test.js.map +7 -0
- package/dist/cli/auto-detect.js +317 -0
- package/dist/cli/auto-detect.js.map +7 -0
- package/dist/cli/browser-test.js +29 -0
- package/dist/cli/browser-test.js.map +7 -0
- package/dist/cli/claude-sm.js +369 -0
- package/dist/cli/claude-sm.js.map +7 -0
- package/dist/cli/codex-sm.js +283 -0
- package/dist/cli/codex-sm.js.map +7 -0
- package/dist/cli/commands/agent.js +286 -0
- package/dist/cli/commands/agent.js.map +7 -0
- package/dist/cli/commands/config.js +199 -0
- package/dist/cli/commands/config.js.map +7 -0
- package/dist/cli/commands/context.js +327 -0
- package/dist/cli/commands/context.js.map +7 -0
- package/dist/cli/commands/handoff.js +191 -0
- package/dist/cli/commands/handoff.js.map +7 -0
- package/dist/cli/commands/linear-test.js +115 -0
- package/dist/cli/commands/linear-test.js.map +7 -0
- package/dist/cli/commands/linear.js +378 -0
- package/dist/cli/commands/linear.js.map +7 -0
- package/dist/cli/commands/log.js +165 -0
- package/dist/cli/commands/log.js.map +7 -0
- package/dist/cli/commands/onboard.js +349 -0
- package/dist/cli/commands/onboard.js.map +7 -0
- package/dist/cli/commands/projects.js +195 -0
- package/dist/cli/commands/projects.js.map +7 -0
- package/dist/cli/commands/search.js +152 -0
- package/dist/cli/commands/search.js.map +7 -0
- package/dist/cli/commands/session.js +179 -0
- package/dist/cli/commands/session.js.map +7 -0
- package/dist/cli/commands/tasks.js +205 -0
- package/dist/cli/commands/tasks.js.map +7 -0
- package/dist/cli/commands/webhook.js +131 -0
- package/dist/cli/commands/webhook.js.map +7 -0
- package/dist/cli/commands/worktree.js +276 -0
- package/dist/cli/commands/worktree.js.map +7 -0
- package/dist/cli/index.js +953 -0
- package/dist/cli/index.js.map +7 -0
- package/dist/cli/utils/viewer.js +92 -0
- package/dist/cli/utils/viewer.js.map +7 -0
- package/dist/core/config/__tests__/config-manager.test.js +248 -0
- package/dist/core/config/__tests__/config-manager.test.js.map +7 -0
- package/dist/core/config/config-manager.js +368 -0
- package/dist/core/config/config-manager.js.map +7 -0
- package/dist/core/config/types.js +140 -0
- package/dist/core/config/types.js.map +7 -0
- package/dist/core/context/__tests__/frame-manager.test.js +879 -0
- package/dist/core/context/__tests__/frame-manager.test.js.map +7 -0
- package/dist/core/context/auto-context.js +72 -0
- package/dist/core/context/auto-context.js.map +7 -0
- package/dist/core/context/compaction-handler.js +326 -0
- package/dist/core/context/compaction-handler.js.map +7 -0
- package/dist/core/context/frame-database.js +376 -0
- package/dist/core/context/frame-database.js.map +7 -0
- package/dist/core/context/frame-digest.js +239 -0
- package/dist/core/context/frame-digest.js.map +7 -0
- package/dist/core/context/frame-manager.js +682 -0
- package/dist/core/context/frame-manager.js.map +7 -0
- package/dist/core/context/frame-stack.js +270 -0
- package/dist/core/context/frame-stack.js.map +7 -0
- package/dist/core/context/frame-types.js +1 -0
- package/dist/core/context/frame-types.js.map +7 -0
- package/dist/core/context/index.js +33 -0
- package/dist/core/context/index.js.map +7 -0
- package/dist/core/context/model-aware-compaction.js +619 -0
- package/dist/core/context/model-aware-compaction.js.map +7 -0
- package/dist/core/context/refactored-frame-manager.js +393 -0
- package/dist/core/context/refactored-frame-manager.js.map +7 -0
- package/dist/core/database/batch-operations.js +329 -0
- package/dist/core/database/batch-operations.js.map +7 -0
- package/dist/core/database/connection-pool.js +224 -0
- package/dist/core/database/connection-pool.js.map +7 -0
- package/dist/core/database/query-cache.js +284 -0
- package/dist/core/database/query-cache.js.map +7 -0
- package/dist/core/digest/__tests__/enhanced-hybrid-digest.test.js +379 -0
- package/dist/core/digest/__tests__/enhanced-hybrid-digest.test.js.map +7 -0
- package/dist/core/digest/__tests__/frame-digest-integration.test.js +230 -0
- package/dist/core/digest/__tests__/frame-digest-integration.test.js.map +7 -0
- package/dist/core/digest/enhanced-hybrid-digest.js +267 -0
- package/dist/core/digest/enhanced-hybrid-digest.js.map +7 -0
- package/dist/core/digest/frame-digest-integration.js +172 -0
- package/dist/core/digest/frame-digest-integration.js.map +7 -0
- package/dist/core/digest/hybrid-digest-generator.js +549 -0
- package/dist/core/digest/hybrid-digest-generator.js.map +7 -0
- package/dist/core/digest/index.js +5 -0
- package/dist/core/digest/index.js.map +7 -0
- package/dist/core/digest/types.js +21 -0
- package/dist/core/digest/types.js.map +7 -0
- package/dist/core/errors/__tests__/error-handling.test.js +270 -0
- package/dist/core/errors/__tests__/error-handling.test.js.map +7 -0
- package/dist/core/errors/index.js +239 -0
- package/dist/core/errors/index.js.map +7 -0
- package/dist/core/errors/recovery.js +258 -0
- package/dist/core/errors/recovery.js.map +7 -0
- package/dist/core/merge/__tests__/conflict-scenarios.test.js +414 -0
- package/dist/core/merge/__tests__/conflict-scenarios.test.js.map +7 -0
- package/dist/core/merge/conflict-detector.js +424 -0
- package/dist/core/merge/conflict-detector.js.map +7 -0
- package/dist/core/merge/index.js +5 -0
- package/dist/core/merge/index.js.map +7 -0
- package/dist/core/merge/resolution-engine.js +565 -0
- package/dist/core/merge/resolution-engine.js.map +7 -0
- package/dist/core/merge/stack-diff.js +528 -0
- package/dist/core/merge/stack-diff.js.map +7 -0
- package/dist/core/merge/types.js +1 -0
- package/dist/core/merge/types.js.map +7 -0
- package/dist/core/monitoring/error-handler.js +278 -0
- package/dist/core/monitoring/error-handler.js.map +7 -0
- package/dist/core/monitoring/logger.js +115 -0
- package/dist/core/monitoring/logger.js.map +7 -0
- package/dist/core/monitoring/metrics.js +157 -0
- package/dist/core/monitoring/metrics.js.map +7 -0
- package/dist/core/monitoring/progress-tracker.js +174 -0
- package/dist/core/monitoring/progress-tracker.js.map +7 -0
- package/dist/core/performance/context-cache.js +269 -0
- package/dist/core/performance/context-cache.js.map +7 -0
- package/dist/core/performance/index.js +7 -0
- package/dist/core/performance/index.js.map +7 -0
- package/dist/core/performance/lazy-context-loader.js +319 -0
- package/dist/core/performance/lazy-context-loader.js.map +7 -0
- package/dist/core/performance/monitor.js +217 -0
- package/dist/core/performance/monitor.js.map +7 -0
- package/dist/core/performance/optimized-frame-context.js +326 -0
- package/dist/core/performance/optimized-frame-context.js.map +7 -0
- package/dist/core/performance/performance-benchmark.js +269 -0
- package/dist/core/performance/performance-benchmark.js.map +7 -0
- package/dist/core/performance/performance-profiler.js +318 -0
- package/dist/core/performance/performance-profiler.js.map +7 -0
- package/dist/core/performance/streaming-jsonl-parser.js +187 -0
- package/dist/core/performance/streaming-jsonl-parser.js.map +7 -0
- package/dist/core/persistence/postgres-adapter.js +345 -0
- package/dist/core/persistence/postgres-adapter.js.map +7 -0
- package/dist/core/projects/project-manager.js +699 -0
- package/dist/core/projects/project-manager.js.map +7 -0
- package/dist/core/query/__tests__/query-parser.test.js +301 -0
- package/dist/core/query/__tests__/query-parser.test.js.map +7 -0
- package/dist/core/query/__tests__/query-templates.test.js +210 -0
- package/dist/core/query/__tests__/query-templates.test.js.map +7 -0
- package/dist/core/query/query-parser.js +366 -0
- package/dist/core/query/query-parser.js.map +7 -0
- package/dist/core/query/query-templates.js +317 -0
- package/dist/core/query/query-templates.js.map +7 -0
- package/dist/core/retrieval/index.js +4 -0
- package/dist/core/retrieval/index.js.map +7 -0
- package/dist/core/retrieval/llm-context-retrieval.js +577 -0
- package/dist/core/retrieval/llm-context-retrieval.js.map +7 -0
- package/dist/core/retrieval/summary-generator.js +585 -0
- package/dist/core/retrieval/summary-generator.js.map +7 -0
- package/dist/core/retrieval/types.js +17 -0
- package/dist/core/retrieval/types.js.map +7 -0
- package/dist/core/session/index.js +11 -0
- package/dist/core/session/index.js.map +7 -0
- package/dist/core/session/session-manager.js +297 -0
- package/dist/core/session/session-manager.js.map +7 -0
- package/dist/core/trace/cli-trace-wrapper.js +110 -0
- package/dist/core/trace/cli-trace-wrapper.js.map +7 -0
- package/dist/core/trace/db-trace-wrapper.js +215 -0
- package/dist/core/trace/db-trace-wrapper.js.map +7 -0
- package/dist/core/trace/debug-trace.js +385 -0
- package/dist/core/trace/debug-trace.js.map +7 -0
- package/dist/core/trace/index.js +158 -0
- package/dist/core/trace/index.js.map +7 -0
- package/dist/core/trace/linear-api-wrapper.js +169 -0
- package/dist/core/trace/linear-api-wrapper.js.map +7 -0
- package/dist/core/trace/trace-demo.js +135 -0
- package/dist/core/trace/trace-demo.js.map +7 -0
- package/dist/core/trace/trace-detector.demo.js +138 -0
- package/dist/core/trace/trace-detector.demo.js.map +7 -0
- package/dist/core/trace/trace-detector.js +386 -0
- package/dist/core/trace/trace-detector.js.map +7 -0
- package/dist/core/trace/trace-detector.test.js +401 -0
- package/dist/core/trace/trace-detector.test.js.map +7 -0
- package/dist/core/trace/trace-store.js +341 -0
- package/dist/core/trace/trace-store.js.map +7 -0
- package/dist/core/trace/types.js +73 -0
- package/dist/core/trace/types.js.map +7 -0
- package/dist/core/types.js +1 -0
- package/dist/core/types.js.map +7 -0
- package/dist/core/utils/update-checker.js +214 -0
- package/dist/core/utils/update-checker.js.map +7 -0
- package/dist/core/worktree/worktree-manager.js +450 -0
- package/dist/core/worktree/worktree-manager.js.map +7 -0
- package/dist/features/analytics/api/analytics-api.js +283 -0
- package/dist/features/analytics/api/analytics-api.js.map +7 -0
- package/dist/features/analytics/core/analytics-service.js +267 -0
- package/dist/features/analytics/core/analytics-service.js.map +7 -0
- package/dist/features/analytics/index.js +14 -0
- package/dist/features/analytics/index.js.map +7 -0
- package/dist/features/analytics/queries/metrics-queries.js +273 -0
- package/dist/features/analytics/queries/metrics-queries.js.map +7 -0
- package/dist/features/analytics/types/metrics.js +1 -0
- package/dist/features/analytics/types/metrics.js.map +7 -0
- package/dist/features/browser/browser-mcp.js +488 -0
- package/dist/features/browser/browser-mcp.js.map +7 -0
- package/dist/features/tasks/__tests__/pebbles-task-store.test.js +747 -0
- package/dist/features/tasks/__tests__/pebbles-task-store.test.js.map +7 -0
- package/dist/features/tasks/pebbles-task-store.js +647 -0
- package/dist/features/tasks/pebbles-task-store.js.map +7 -0
- package/dist/features/tasks/task-aware-context.js +406 -0
- package/dist/features/tasks/task-aware-context.js.map +7 -0
- package/dist/index.js +21 -0
- package/dist/index.js.map +7 -0
- package/dist/integrations/linear/__tests__/auth.test.js +558 -0
- package/dist/integrations/linear/__tests__/auth.test.js.map +7 -0
- package/dist/integrations/linear/__tests__/sync-service.test.js +760 -0
- package/dist/integrations/linear/__tests__/sync-service.test.js.map +7 -0
- package/dist/integrations/linear/auth.js +308 -0
- package/dist/integrations/linear/auth.js.map +7 -0
- package/dist/integrations/linear/auto-sync.js +244 -0
- package/dist/integrations/linear/auto-sync.js.map +7 -0
- package/dist/integrations/linear/client.js +448 -0
- package/dist/integrations/linear/client.js.map +7 -0
- package/dist/integrations/linear/config.js +115 -0
- package/dist/integrations/linear/config.js.map +7 -0
- package/dist/integrations/linear/sync-manager.js +233 -0
- package/dist/integrations/linear/sync-manager.js.map +7 -0
- package/dist/integrations/linear/sync-service.js +214 -0
- package/dist/integrations/linear/sync-service.js.map +7 -0
- package/dist/integrations/linear/sync.js +565 -0
- package/dist/integrations/linear/sync.js.map +7 -0
- package/dist/integrations/linear/types.js +1 -0
- package/dist/integrations/linear/types.js.map +7 -0
- package/dist/integrations/linear/webhook-server.js +204 -0
- package/dist/integrations/linear/webhook-server.js.map +7 -0
- package/dist/integrations/linear/webhook.js +269 -0
- package/dist/integrations/linear/webhook.js.map +7 -0
- package/dist/integrations/mcp/__tests__/server.test.js +798 -0
- package/dist/integrations/mcp/__tests__/server.test.js.map +7 -0
- package/dist/integrations/mcp/handlers/context-handlers.js +253 -0
- package/dist/integrations/mcp/handlers/context-handlers.js.map +7 -0
- package/dist/integrations/mcp/handlers/index.js +134 -0
- package/dist/integrations/mcp/handlers/index.js.map +7 -0
- package/dist/integrations/mcp/handlers/linear-handlers.js +243 -0
- package/dist/integrations/mcp/handlers/linear-handlers.js.map +7 -0
- package/dist/integrations/mcp/handlers/task-handlers.js +235 -0
- package/dist/integrations/mcp/handlers/task-handlers.js.map +7 -0
- package/dist/integrations/mcp/handlers/trace-handlers.js +304 -0
- package/dist/integrations/mcp/handlers/trace-handlers.js.map +7 -0
- package/dist/integrations/mcp/index.js +19 -0
- package/dist/integrations/mcp/index.js.map +7 -0
- package/dist/integrations/mcp/refactored-server.js +331 -0
- package/dist/integrations/mcp/refactored-server.js.map +7 -0
- package/dist/integrations/mcp/server.js +1621 -0
- package/dist/integrations/mcp/server.js.map +7 -0
- package/dist/integrations/mcp/tool-definitions.js +562 -0
- package/dist/integrations/mcp/tool-definitions.js.map +7 -0
- package/dist/integrations/mcp/trace-test.js +44 -0
- package/dist/integrations/mcp/trace-test.js.map +7 -0
- package/dist/integrations/pg-aiguide/embedding-provider.js +174 -0
- package/dist/integrations/pg-aiguide/embedding-provider.js.map +7 -0
- package/dist/integrations/pg-aiguide/semantic-search.js +183 -0
- package/dist/integrations/pg-aiguide/semantic-search.js.map +7 -0
- package/dist/integrations/pg-aiguide/timescale-analytics.js +220 -0
- package/dist/integrations/pg-aiguide/timescale-analytics.js.map +7 -0
- package/dist/mcp/stackmemory-mcp-server.js +550 -0
- package/dist/mcp/stackmemory-mcp-server.js.map +7 -0
- package/dist/middleware/exponential-rate-limiter.js +285 -0
- package/dist/middleware/exponential-rate-limiter.js.map +7 -0
- package/dist/models/user.model.js +351 -0
- package/dist/models/user.model.js.map +7 -0
- package/dist/scripts/benchmark-performance.d.ts +7 -0
- package/dist/scripts/benchmark-performance.d.ts.map +1 -0
- package/dist/scripts/benchmark-performance.js +44 -0
- package/dist/scripts/benchmark-performance.js.map +1 -0
- package/dist/scripts/cleanup-duplicate-tasks.d.ts +12 -0
- package/dist/scripts/cleanup-duplicate-tasks.d.ts.map +1 -0
- package/dist/scripts/cleanup-duplicate-tasks.js +215 -0
- package/dist/scripts/cleanup-duplicate-tasks.js.map +1 -0
- package/dist/servers/production/auth-middleware.js +513 -0
- package/dist/servers/production/auth-middleware.js.map +7 -0
- package/dist/servers/railway/index.js +390 -0
- package/dist/servers/railway/index.js.map +7 -0
- package/dist/services/config-service.js +62 -0
- package/dist/services/config-service.js.map +7 -0
- package/dist/services/context-service.js +191 -0
- package/dist/services/context-service.js.map +7 -0
- package/dist/src/agents/core/agent-task-manager.d.ts +154 -0
- package/dist/src/agents/core/agent-task-manager.d.ts.map +1 -0
- package/dist/src/agents/core/agent-task-manager.js +504 -0
- package/dist/src/agents/core/agent-task-manager.js.map +1 -0
- package/dist/src/agents/verifiers/base-verifier.d.ts +112 -0
- package/dist/src/agents/verifiers/base-verifier.d.ts.map +1 -0
- package/dist/src/agents/verifiers/base-verifier.js +130 -0
- package/dist/src/agents/verifiers/base-verifier.js.map +1 -0
- package/dist/src/agents/verifiers/formatter-verifier.d.ts +14 -0
- package/dist/src/agents/verifiers/formatter-verifier.d.ts.map +1 -0
- package/dist/src/agents/verifiers/formatter-verifier.js +107 -0
- package/dist/src/agents/verifiers/formatter-verifier.js.map +1 -0
- package/dist/src/agents/verifiers/llm-judge.d.ts +46 -0
- package/dist/src/agents/verifiers/llm-judge.d.ts.map +1 -0
- package/dist/src/agents/verifiers/llm-judge.js +248 -0
- package/dist/src/agents/verifiers/llm-judge.js.map +1 -0
- package/dist/src/cli/claude-sm.js +55 -0
- package/dist/src/cli/claude-sm.js.map +1 -1
- package/dist/src/cli/commands/agent.d.ts +9 -0
- package/dist/src/cli/commands/agent.d.ts.map +1 -0
- package/dist/src/cli/commands/agent.js +303 -0
- package/dist/src/cli/commands/agent.js.map +1 -0
- package/dist/src/cli/commands/handoff.d.ts +6 -0
- package/dist/src/cli/commands/handoff.d.ts.map +1 -0
- package/dist/src/cli/commands/handoff.js +212 -0
- package/dist/src/cli/commands/handoff.js.map +1 -0
- package/dist/src/cli/index.d.ts.map +1 -1
- package/dist/src/cli/index.js +4 -0
- package/dist/src/cli/index.js.map +1 -1
- package/dist/src/core/context/frame-database.d.ts +59 -0
- package/dist/src/core/context/frame-database.d.ts.map +1 -0
- package/dist/src/core/context/frame-database.js +333 -0
- package/dist/src/core/context/frame-database.js.map +1 -0
- package/dist/src/core/context/frame-digest.d.ts +59 -0
- package/dist/src/core/context/frame-digest.d.ts.map +1 -0
- package/dist/src/core/context/frame-digest.js +264 -0
- package/dist/src/core/context/frame-digest.js.map +1 -0
- package/dist/src/core/context/frame-manager.d.ts +2 -0
- package/dist/src/core/context/frame-manager.d.ts.map +1 -1
- package/dist/src/core/context/frame-manager.js +7 -0
- package/dist/src/core/context/frame-manager.js.map +1 -1
- package/dist/src/core/context/frame-stack.d.ts +85 -0
- package/dist/src/core/context/frame-stack.d.ts.map +1 -0
- package/dist/src/core/context/frame-stack.js +287 -0
- package/dist/src/core/context/frame-stack.js.map +1 -0
- package/dist/src/core/context/frame-types.d.ts +67 -0
- package/dist/src/core/context/frame-types.d.ts.map +1 -0
- package/dist/src/core/context/frame-types.js +6 -0
- package/dist/src/core/context/frame-types.js.map +1 -0
- package/dist/src/core/context/index.d.ts +11 -0
- package/dist/src/core/context/index.d.ts.map +1 -0
- package/dist/src/core/context/index.js +14 -0
- package/dist/src/core/context/index.js.map +1 -0
- package/dist/src/core/context/refactored-frame-manager.d.ts +99 -0
- package/dist/src/core/context/refactored-frame-manager.d.ts.map +1 -0
- package/dist/src/core/context/refactored-frame-manager.js +340 -0
- package/dist/src/core/context/refactored-frame-manager.js.map +1 -0
- package/dist/src/core/database/batch-operations.d.ts +118 -0
- package/dist/src/core/database/batch-operations.d.ts.map +1 -0
- package/dist/src/core/database/batch-operations.js +339 -0
- package/dist/src/core/database/batch-operations.js.map +1 -0
- package/dist/src/core/database/connection-pool.d.ts +79 -0
- package/dist/src/core/database/connection-pool.d.ts.map +1 -0
- package/dist/src/core/database/connection-pool.js +236 -0
- package/dist/src/core/database/connection-pool.js.map +1 -0
- package/dist/src/core/database/query-cache.d.ts +135 -0
- package/dist/src/core/database/query-cache.d.ts.map +1 -0
- package/dist/src/core/database/query-cache.js +294 -0
- package/dist/src/core/database/query-cache.js.map +1 -0
- package/dist/src/core/digest/enhanced-hybrid-digest.d.ts +125 -0
- package/dist/src/core/digest/enhanced-hybrid-digest.d.ts.map +1 -0
- package/dist/src/core/digest/enhanced-hybrid-digest.js +282 -0
- package/dist/src/core/digest/enhanced-hybrid-digest.js.map +1 -0
- package/dist/src/core/digest/frame-digest-integration.d.ts +67 -0
- package/dist/src/core/digest/frame-digest-integration.d.ts.map +1 -0
- package/dist/src/core/digest/frame-digest-integration.js +198 -0
- package/dist/src/core/digest/frame-digest-integration.js.map +1 -0
- package/dist/src/core/digest/hybrid-digest-generator.d.ts +3 -3
- package/dist/src/core/digest/hybrid-digest-generator.d.ts.map +1 -1
- package/dist/src/core/digest/hybrid-digest-generator.js.map +1 -1
- package/dist/src/core/digest/index.d.ts +3 -1
- package/dist/src/core/digest/index.d.ts.map +1 -1
- package/dist/src/core/digest/index.js +3 -1
- package/dist/src/core/digest/index.js.map +1 -1
- package/dist/src/core/errors/index.d.ts +13 -5
- package/dist/src/core/errors/index.d.ts.map +1 -1
- package/dist/src/core/errors/index.js +13 -5
- package/dist/src/core/errors/index.js.map +1 -1
- package/dist/src/core/merge/conflict-detector.d.ts +122 -0
- package/dist/src/core/merge/conflict-detector.d.ts.map +1 -0
- package/dist/src/core/merge/conflict-detector.js +468 -0
- package/dist/src/core/merge/conflict-detector.js.map +1 -0
- package/dist/src/core/merge/index.d.ts +9 -0
- package/dist/src/core/merge/index.d.ts.map +1 -0
- package/dist/src/core/merge/index.js +9 -0
- package/dist/src/core/merge/index.js.map +1 -0
- package/dist/src/core/merge/resolution-engine.d.ts +120 -0
- package/dist/src/core/merge/resolution-engine.d.ts.map +1 -0
- package/dist/src/core/merge/resolution-engine.js +573 -0
- package/dist/src/core/merge/resolution-engine.js.map +1 -0
- package/dist/src/core/merge/stack-diff.d.ts +97 -0
- package/dist/src/core/merge/stack-diff.d.ts.map +1 -0
- package/dist/src/core/merge/stack-diff.js +516 -0
- package/dist/src/core/merge/stack-diff.js.map +1 -0
- package/dist/src/core/merge/types.d.ts +110 -0
- package/dist/src/core/merge/types.d.ts.map +1 -0
- package/dist/src/core/merge/types.js +6 -0
- package/dist/src/core/merge/types.js.map +1 -0
- package/dist/src/core/performance/context-cache.d.ts +109 -0
- package/dist/src/core/performance/context-cache.d.ts.map +1 -0
- package/dist/src/core/performance/context-cache.js +280 -0
- package/dist/src/core/performance/context-cache.js.map +1 -0
- package/dist/src/core/performance/index.d.ts +3 -0
- package/dist/src/core/performance/index.d.ts.map +1 -0
- package/dist/src/core/performance/index.js +3 -0
- package/dist/src/core/performance/index.js.map +1 -0
- package/dist/src/core/performance/lazy-context-loader.d.ts +93 -0
- package/dist/src/core/performance/lazy-context-loader.d.ts.map +1 -0
- package/dist/src/core/performance/lazy-context-loader.js +332 -0
- package/dist/src/core/performance/lazy-context-loader.js.map +1 -0
- package/dist/src/core/performance/monitor.d.ts +48 -0
- package/dist/src/core/performance/monitor.d.ts.map +1 -0
- package/dist/src/core/performance/monitor.js +226 -0
- package/dist/src/core/performance/monitor.js.map +1 -0
- package/dist/src/core/performance/optimized-frame-context.d.ts +74 -0
- package/dist/src/core/performance/optimized-frame-context.d.ts.map +1 -0
- package/dist/src/core/performance/optimized-frame-context.js +330 -0
- package/dist/src/core/performance/optimized-frame-context.js.map +1 -0
- package/dist/src/core/performance/performance-benchmark.d.ts +50 -0
- package/dist/src/core/performance/performance-benchmark.d.ts.map +1 -0
- package/dist/src/core/performance/performance-benchmark.js +290 -0
- package/dist/src/core/performance/performance-benchmark.js.map +1 -0
- package/dist/src/core/performance/performance-profiler.d.ts +151 -0
- package/dist/src/core/performance/performance-profiler.d.ts.map +1 -0
- package/dist/src/core/performance/performance-profiler.js +346 -0
- package/dist/src/core/performance/performance-profiler.js.map +1 -0
- package/dist/src/core/performance/streaming-jsonl-parser.d.ts +41 -0
- package/dist/src/core/performance/streaming-jsonl-parser.d.ts.map +1 -0
- package/dist/src/core/performance/streaming-jsonl-parser.js +193 -0
- package/dist/src/core/performance/streaming-jsonl-parser.js.map +1 -0
- package/dist/src/core/persistence/postgres-adapter.d.ts.map +1 -1
- package/dist/src/core/persistence/postgres-adapter.js +18 -4
- package/dist/src/core/persistence/postgres-adapter.js.map +1 -1
- package/dist/src/core/query/query-parser.d.ts +5 -0
- package/dist/src/core/query/query-parser.d.ts.map +1 -1
- package/dist/src/core/query/query-parser.js +86 -18
- package/dist/src/core/query/query-parser.js.map +1 -1
- package/dist/src/core/query/query-templates.d.ts +44 -0
- package/dist/src/core/query/query-templates.d.ts.map +1 -0
- package/dist/src/core/query/query-templates.js +326 -0
- package/dist/src/core/query/query-templates.js.map +1 -0
- package/dist/src/core/retrieval/llm-context-retrieval.d.ts +5 -3
- package/dist/src/core/retrieval/llm-context-retrieval.d.ts.map +1 -1
- package/dist/src/core/retrieval/llm-context-retrieval.js +73 -21
- package/dist/src/core/retrieval/llm-context-retrieval.js.map +1 -1
- package/dist/src/core/trace/cli-trace-wrapper.d.ts +23 -0
- package/dist/src/core/trace/cli-trace-wrapper.d.ts.map +1 -0
- package/dist/src/core/trace/cli-trace-wrapper.js +141 -0
- package/dist/src/core/trace/cli-trace-wrapper.js.map +1 -0
- package/dist/src/core/trace/db-trace-wrapper.d.ts +36 -0
- package/dist/src/core/trace/db-trace-wrapper.d.ts.map +1 -0
- package/dist/src/core/trace/db-trace-wrapper.js +252 -0
- package/dist/src/core/trace/db-trace-wrapper.js.map +1 -0
- package/dist/src/core/trace/debug-trace.d.ts +84 -0
- package/dist/src/core/trace/debug-trace.d.ts.map +1 -0
- package/dist/src/core/trace/debug-trace.js +402 -0
- package/dist/src/core/trace/debug-trace.js.map +1 -0
- package/dist/src/core/trace/error-test.d.ts +6 -0
- package/dist/src/core/trace/error-test.d.ts.map +1 -0
- package/dist/src/core/trace/error-test.js +128 -0
- package/dist/src/core/trace/error-test.js.map +1 -0
- package/dist/src/core/trace/index.d.ts +25 -0
- package/dist/src/core/trace/index.d.ts.map +1 -0
- package/dist/src/core/trace/index.js +121 -0
- package/dist/src/core/trace/index.js.map +1 -0
- package/dist/src/core/trace/linear-api-wrapper.d.ts +17 -0
- package/dist/src/core/trace/linear-api-wrapper.d.ts.map +1 -0
- package/dist/src/core/trace/linear-api-wrapper.js +205 -0
- package/dist/src/core/trace/linear-api-wrapper.js.map +1 -0
- package/dist/src/core/trace/performance-test.d.ts +6 -0
- package/dist/src/core/trace/performance-test.d.ts.map +1 -0
- package/dist/src/core/trace/performance-test.js +111 -0
- package/dist/src/core/trace/performance-test.js.map +1 -0
- package/dist/src/core/trace/trace-demo.d.ts +8 -0
- package/dist/src/core/trace/trace-demo.d.ts.map +1 -0
- package/dist/src/core/trace/trace-demo.js +154 -0
- package/dist/src/core/trace/trace-demo.js.map +1 -0
- package/dist/src/core/trace/trace-detector.d.ts +2 -2
- package/dist/src/core/trace/trace-detector.d.ts.map +1 -1
- package/dist/src/core/trace/trace-detector.demo.js +1 -1
- package/dist/src/core/trace/trace-detector.demo.js.map +1 -1
- package/dist/src/core/trace/trace-detector.js +3 -3
- package/dist/src/core/trace/trace-detector.js.map +1 -1
- package/dist/src/features/tasks/pebbles-task-store.d.ts +9 -2
- package/dist/src/features/tasks/pebbles-task-store.d.ts.map +1 -1
- package/dist/src/features/tasks/pebbles-task-store.js +97 -18
- package/dist/src/features/tasks/pebbles-task-store.js.map +1 -1
- package/dist/src/integrations/linear/auth.d.ts.map +1 -1
- package/dist/src/integrations/linear/auth.js.map +1 -1
- package/dist/src/integrations/linear/client.d.ts +15 -1
- package/dist/src/integrations/linear/client.d.ts.map +1 -1
- package/dist/src/integrations/linear/client.js +85 -3
- package/dist/src/integrations/linear/client.js.map +1 -1
- package/dist/src/integrations/linear/sync-manager.d.ts +2 -0
- package/dist/src/integrations/linear/sync-manager.d.ts.map +1 -1
- package/dist/src/integrations/linear/sync-manager.js +16 -4
- package/dist/src/integrations/linear/sync-manager.js.map +1 -1
- package/dist/src/integrations/linear/sync-service.d.ts +23 -2
- package/dist/src/integrations/linear/sync-service.d.ts.map +1 -1
- package/dist/src/integrations/linear/sync-service.js +44 -25
- package/dist/src/integrations/linear/sync-service.js.map +1 -1
- package/dist/src/integrations/linear/sync.d.ts +6 -0
- package/dist/src/integrations/linear/sync.d.ts.map +1 -1
- package/dist/src/integrations/linear/sync.js +27 -2
- package/dist/src/integrations/linear/sync.js.map +1 -1
- package/dist/src/integrations/linear/types.d.ts +16 -1
- package/dist/src/integrations/linear/types.d.ts.map +1 -1
- package/dist/src/integrations/linear/webhook-server.d.ts.map +1 -1
- package/dist/src/integrations/linear/webhook-server.js +10 -8
- package/dist/src/integrations/linear/webhook-server.js.map +1 -1
- package/dist/src/integrations/linear/webhook.d.ts +13 -0
- package/dist/src/integrations/linear/webhook.d.ts.map +1 -1
- package/dist/src/integrations/linear/webhook.js +101 -14
- package/dist/src/integrations/linear/webhook.js.map +1 -1
- package/dist/src/integrations/mcp/handlers/context-handlers.d.ts +39 -0
- package/dist/src/integrations/mcp/handlers/context-handlers.d.ts.map +1 -0
- package/dist/src/integrations/mcp/handlers/context-handlers.js +266 -0
- package/dist/src/integrations/mcp/handlers/context-handlers.js.map +1 -0
- package/dist/src/integrations/mcp/handlers/index.d.ts +37 -0
- package/dist/src/integrations/mcp/handlers/index.d.ts.map +1 -0
- package/dist/src/integrations/mcp/handlers/index.js +134 -0
- package/dist/src/integrations/mcp/handlers/index.js.map +1 -0
- package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts +33 -0
- package/dist/src/integrations/mcp/handlers/linear-handlers.d.ts.map +1 -0
- package/dist/src/integrations/mcp/handlers/linear-handlers.js +251 -0
- package/dist/src/integrations/mcp/handlers/linear-handlers.js.map +1 -0
- package/dist/src/integrations/mcp/handlers/task-handlers.d.ts +42 -0
- package/dist/src/integrations/mcp/handlers/task-handlers.d.ts.map +1 -0
- package/dist/src/integrations/mcp/handlers/task-handlers.js +238 -0
- package/dist/src/integrations/mcp/handlers/task-handlers.js.map +1 -0
- package/dist/src/integrations/mcp/handlers/trace-handlers.d.ts +41 -0
- package/dist/src/integrations/mcp/handlers/trace-handlers.d.ts.map +1 -0
- package/dist/src/integrations/mcp/handlers/trace-handlers.js +298 -0
- package/dist/src/integrations/mcp/handlers/trace-handlers.js.map +1 -0
- package/dist/src/integrations/mcp/index.d.ts +13 -0
- package/dist/src/integrations/mcp/index.d.ts.map +1 -0
- package/dist/src/integrations/mcp/index.js +17 -0
- package/dist/src/integrations/mcp/index.js.map +1 -0
- package/dist/src/integrations/mcp/refactored-server.d.ts +76 -0
- package/dist/src/integrations/mcp/refactored-server.d.ts.map +1 -0
- package/dist/src/integrations/mcp/refactored-server.js +351 -0
- package/dist/src/integrations/mcp/refactored-server.js.map +1 -0
- package/dist/src/integrations/mcp/tool-definitions.d.ts +44 -0
- package/dist/src/integrations/mcp/tool-definitions.d.ts.map +1 -0
- package/dist/src/integrations/mcp/tool-definitions.js +563 -0
- package/dist/src/integrations/mcp/tool-definitions.js.map +1 -0
- package/dist/src/integrations/pg-aiguide/semantic-search.d.ts.map +1 -1
- package/dist/src/integrations/pg-aiguide/semantic-search.js +43 -21
- package/dist/src/integrations/pg-aiguide/semantic-search.js.map +1 -1
- package/dist/src/mcp/stackmemory-mcp-server.d.ts +9 -0
- package/dist/src/mcp/stackmemory-mcp-server.d.ts.map +1 -0
- package/dist/src/mcp/stackmemory-mcp-server.js +519 -0
- package/dist/src/mcp/stackmemory-mcp-server.js.map +1 -0
- package/dist/src/middleware/exponential-rate-limiter.d.ts +78 -0
- package/dist/src/middleware/exponential-rate-limiter.d.ts.map +1 -0
- package/dist/src/middleware/exponential-rate-limiter.js +293 -0
- package/dist/src/middleware/exponential-rate-limiter.js.map +1 -0
- package/dist/src/models/user.model.d.ts +8 -1
- package/dist/src/models/user.model.d.ts.map +1 -1
- package/dist/src/models/user.model.js +62 -14
- package/dist/src/models/user.model.js.map +1 -1
- package/dist/src/servers/production/auth-middleware.d.ts +5 -2
- package/dist/src/servers/production/auth-middleware.d.ts.map +1 -1
- package/dist/src/servers/production/auth-middleware.js +71 -34
- package/dist/src/servers/production/auth-middleware.js.map +1 -1
- package/dist/src/services/context-service.d.ts.map +1 -1
- package/dist/src/services/context-service.js +86 -1
- package/dist/src/services/context-service.js.map +1 -1
- package/dist/src/validation/schemas.d.ts +633 -0
- package/dist/src/validation/schemas.d.ts.map +1 -0
- package/dist/src/validation/schemas.js +347 -0
- package/dist/src/validation/schemas.js.map +1 -0
- package/dist/types/task.js +1 -0
- package/dist/types/task.js.map +7 -0
- package/dist/utils/logger.js +52 -0
- package/dist/utils/logger.js.map +7 -0
- package/dist/validation/schemas.js +218 -0
- package/dist/validation/schemas.js.map +7 -0
- package/package.json +7 -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
|
+
}
|