@cleocode/core 2026.3.76 → 2026.4.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 (957) hide show
  1. package/dist/adapters/adapter-registry.js +64 -0
  2. package/dist/adapters/adapter-registry.js.map +1 -0
  3. package/dist/adapters/discovery.js +83 -0
  4. package/dist/adapters/discovery.js.map +1 -0
  5. package/dist/adapters/index.js +9 -0
  6. package/dist/adapters/index.js.map +1 -0
  7. package/dist/adapters/manager.js +260 -0
  8. package/dist/adapters/manager.js.map +1 -0
  9. package/dist/admin/export-tasks.js +171 -0
  10. package/dist/admin/export-tasks.js.map +1 -0
  11. package/dist/admin/export.js +103 -0
  12. package/dist/admin/export.js.map +1 -0
  13. package/dist/admin/help.js +106 -0
  14. package/dist/admin/help.js.map +1 -0
  15. package/dist/admin/import-tasks.js +182 -0
  16. package/dist/admin/import-tasks.js.map +1 -0
  17. package/dist/admin/import.js +129 -0
  18. package/dist/admin/import.js.map +1 -0
  19. package/dist/admin/index.js +13 -0
  20. package/dist/admin/index.js.map +1 -0
  21. package/dist/adrs/find.js +134 -0
  22. package/dist/adrs/find.js.map +1 -0
  23. package/dist/adrs/index.js +15 -0
  24. package/dist/adrs/index.js.map +1 -0
  25. package/dist/adrs/link-pipeline.js +160 -0
  26. package/dist/adrs/link-pipeline.js.map +1 -0
  27. package/dist/adrs/list.js +43 -0
  28. package/dist/adrs/list.js.map +1 -0
  29. package/dist/adrs/parse.js +51 -0
  30. package/dist/adrs/parse.js.map +1 -0
  31. package/dist/adrs/show.js +22 -0
  32. package/dist/adrs/show.js.map +1 -0
  33. package/dist/adrs/sync.js +188 -0
  34. package/dist/adrs/sync.js.map +1 -0
  35. package/dist/adrs/types.js +9 -0
  36. package/dist/adrs/types.js.map +1 -0
  37. package/dist/adrs/validate.js +57 -0
  38. package/dist/adrs/validate.js.map +1 -0
  39. package/dist/agents/agent-registry.js +288 -0
  40. package/dist/agents/agent-registry.js.map +1 -0
  41. package/dist/agents/agent-schema.d.ts.map +1 -1
  42. package/dist/agents/agent-schema.js +85 -0
  43. package/dist/agents/agent-schema.js.map +1 -0
  44. package/dist/agents/capacity.js +116 -0
  45. package/dist/agents/capacity.js.map +1 -0
  46. package/dist/agents/execution-learning.js +474 -0
  47. package/dist/agents/execution-learning.js.map +1 -0
  48. package/dist/agents/health-monitor.js +217 -0
  49. package/dist/agents/health-monitor.js.map +1 -0
  50. package/dist/agents/index.js +29 -0
  51. package/dist/agents/index.js.map +1 -0
  52. package/dist/agents/registry.js +314 -0
  53. package/dist/agents/registry.js.map +1 -0
  54. package/dist/agents/retry.js +215 -0
  55. package/dist/agents/retry.js.map +1 -0
  56. package/dist/audit-prune.js +94 -0
  57. package/dist/audit-prune.js.map +1 -0
  58. package/dist/audit.js +68 -0
  59. package/dist/audit.js.map +1 -0
  60. package/dist/backfill/index.js +229 -0
  61. package/dist/backfill/index.js.map +1 -0
  62. package/dist/bootstrap.js +367 -0
  63. package/dist/bootstrap.js.map +1 -0
  64. package/dist/caamp/adapter.js +434 -0
  65. package/dist/caamp/adapter.js.map +1 -0
  66. package/dist/caamp/capability-check.js +38 -0
  67. package/dist/caamp/capability-check.js.map +1 -0
  68. package/dist/caamp/index.js +23 -0
  69. package/dist/caamp/index.js.map +1 -0
  70. package/dist/caamp-init.js +16 -0
  71. package/dist/caamp-init.js.map +1 -0
  72. package/dist/cant/approval.js +185 -0
  73. package/dist/cant/approval.js.map +1 -0
  74. package/dist/cant/context-builder.js +117 -0
  75. package/dist/cant/context-builder.js.map +1 -0
  76. package/dist/cant/discretion.js +116 -0
  77. package/dist/cant/discretion.js.map +1 -0
  78. package/dist/cant/index.js +23 -0
  79. package/dist/cant/index.js.map +1 -0
  80. package/dist/cant/parallel-runner.js +173 -0
  81. package/dist/cant/parallel-runner.js.map +1 -0
  82. package/dist/cant/types.js +11 -0
  83. package/dist/cant/types.js.map +1 -0
  84. package/dist/cant/workflow-executor.js +440 -0
  85. package/dist/cant/workflow-executor.js.map +1 -0
  86. package/dist/cleo.js +322 -0
  87. package/dist/cleo.js.map +1 -0
  88. package/dist/code/index.d.ts +10 -0
  89. package/dist/code/index.d.ts.map +1 -0
  90. package/dist/code/outline.d.ts +51 -0
  91. package/dist/code/outline.d.ts.map +1 -0
  92. package/dist/code/parser.d.ts +30 -0
  93. package/dist/code/parser.d.ts.map +1 -0
  94. package/dist/code/search.d.ts +42 -0
  95. package/dist/code/search.d.ts.map +1 -0
  96. package/dist/code/unfold.d.ts +44 -0
  97. package/dist/code/unfold.d.ts.map +1 -0
  98. package/dist/codebase-map/analyzers/architecture.js +130 -0
  99. package/dist/codebase-map/analyzers/architecture.js.map +1 -0
  100. package/dist/codebase-map/analyzers/concerns.js +122 -0
  101. package/dist/codebase-map/analyzers/concerns.js.map +1 -0
  102. package/dist/codebase-map/analyzers/conventions.js +149 -0
  103. package/dist/codebase-map/analyzers/conventions.js.map +1 -0
  104. package/dist/codebase-map/analyzers/integrations.js +108 -0
  105. package/dist/codebase-map/analyzers/integrations.js.map +1 -0
  106. package/dist/codebase-map/analyzers/stack.js +117 -0
  107. package/dist/codebase-map/analyzers/stack.js.map +1 -0
  108. package/dist/codebase-map/analyzers/structure.js +137 -0
  109. package/dist/codebase-map/analyzers/structure.js.map +1 -0
  110. package/dist/codebase-map/analyzers/testing.js +118 -0
  111. package/dist/codebase-map/analyzers/testing.js.map +1 -0
  112. package/dist/codebase-map/index.js +57 -0
  113. package/dist/codebase-map/index.js.map +1 -0
  114. package/dist/codebase-map/store.js +122 -0
  115. package/dist/codebase-map/store.js.map +1 -0
  116. package/dist/codebase-map/summary.js +152 -0
  117. package/dist/codebase-map/summary.js.map +1 -0
  118. package/dist/compliance/index.js +288 -0
  119. package/dist/compliance/index.js.map +1 -0
  120. package/dist/compliance/protocol-enforcement.js +332 -0
  121. package/dist/compliance/protocol-enforcement.js.map +1 -0
  122. package/dist/compliance/protocol-rules.js +786 -0
  123. package/dist/compliance/protocol-rules.js.map +1 -0
  124. package/dist/compliance/protocol-types.js +80 -0
  125. package/dist/compliance/protocol-types.js.map +1 -0
  126. package/dist/compliance/store.js +53 -0
  127. package/dist/compliance/store.js.map +1 -0
  128. package/dist/conduit/conduit-client.d.ts +9 -0
  129. package/dist/conduit/conduit-client.d.ts.map +1 -1
  130. package/dist/conduit/conduit-client.js +94 -0
  131. package/dist/conduit/conduit-client.js.map +1 -0
  132. package/dist/conduit/factory.d.ts +3 -1
  133. package/dist/conduit/factory.d.ts.map +1 -1
  134. package/dist/conduit/factory.js +35 -0
  135. package/dist/conduit/factory.js.map +1 -0
  136. package/dist/conduit/http-transport.d.ts +17 -5
  137. package/dist/conduit/http-transport.d.ts.map +1 -1
  138. package/dist/conduit/http-transport.js +165 -0
  139. package/dist/conduit/http-transport.js.map +1 -0
  140. package/dist/conduit/index.d.ts +5 -2
  141. package/dist/conduit/index.d.ts.map +1 -1
  142. package/dist/conduit/index.js +12 -0
  143. package/dist/conduit/index.js.map +1 -0
  144. package/dist/conduit/local-transport.d.ts +91 -0
  145. package/dist/conduit/local-transport.d.ts.map +1 -0
  146. package/dist/conduit/sse-transport.d.ts +68 -0
  147. package/dist/conduit/sse-transport.d.ts.map +1 -0
  148. package/dist/config/build-config.js +29 -0
  149. package/dist/config/build-config.js.map +1 -0
  150. package/dist/config.js +401 -0
  151. package/dist/config.js.map +1 -0
  152. package/dist/constants.js +18 -0
  153. package/dist/constants.js.map +1 -0
  154. package/dist/context/index.js +137 -0
  155. package/dist/context/index.js.map +1 -0
  156. package/dist/crypto/credentials.js +144 -0
  157. package/dist/crypto/credentials.js.map +1 -0
  158. package/dist/engine-result.js +12 -0
  159. package/dist/engine-result.js.map +1 -0
  160. package/dist/error-catalog.js +404 -0
  161. package/dist/error-catalog.js.map +1 -0
  162. package/dist/error-registry.js +393 -0
  163. package/dist/error-registry.js.map +1 -0
  164. package/dist/errors.js +167 -0
  165. package/dist/errors.js.map +1 -0
  166. package/dist/hooks/handlers/agent-hooks.js +106 -0
  167. package/dist/hooks/handlers/agent-hooks.js.map +1 -0
  168. package/dist/hooks/handlers/context-hooks.js +111 -0
  169. package/dist/hooks/handlers/context-hooks.js.map +1 -0
  170. package/dist/hooks/handlers/error-hooks.js +52 -0
  171. package/dist/hooks/handlers/error-hooks.js.map +1 -0
  172. package/dist/hooks/handlers/file-hooks.js +104 -0
  173. package/dist/hooks/handlers/file-hooks.js.map +1 -0
  174. package/dist/hooks/handlers/handler-helpers.js +61 -0
  175. package/dist/hooks/handlers/handler-helpers.js.map +1 -0
  176. package/dist/hooks/handlers/index.js +28 -0
  177. package/dist/hooks/handlers/index.js.map +1 -0
  178. package/dist/hooks/handlers/mcp-hooks.js +147 -0
  179. package/dist/hooks/handlers/mcp-hooks.js.map +1 -0
  180. package/dist/hooks/handlers/memory-bridge-refresh.js +42 -0
  181. package/dist/hooks/handlers/memory-bridge-refresh.js.map +1 -0
  182. package/dist/hooks/handlers/session-hooks.js +104 -0
  183. package/dist/hooks/handlers/session-hooks.js.map +1 -0
  184. package/dist/hooks/handlers/task-hooks.js +65 -0
  185. package/dist/hooks/handlers/task-hooks.js.map +1 -0
  186. package/dist/hooks/handlers/work-capture-hooks.js +165 -0
  187. package/dist/hooks/handlers/work-capture-hooks.js.map +1 -0
  188. package/dist/hooks/index.js +13 -0
  189. package/dist/hooks/index.js.map +1 -0
  190. package/dist/hooks/payload-schemas.js +220 -0
  191. package/dist/hooks/payload-schemas.js.map +1 -0
  192. package/dist/hooks/provider-hooks.js +66 -0
  193. package/dist/hooks/provider-hooks.js.map +1 -0
  194. package/dist/hooks/registry.js +229 -0
  195. package/dist/hooks/registry.js.map +1 -0
  196. package/dist/hooks/types.js +66 -0
  197. package/dist/hooks/types.js.map +1 -0
  198. package/dist/hooks.js +136 -0
  199. package/dist/hooks.js.map +1 -0
  200. package/dist/index.d.ts +1 -0
  201. package/dist/index.d.ts.map +1 -1
  202. package/dist/index.js +4605 -3042
  203. package/dist/index.js.map +4 -4
  204. package/dist/init.js +723 -0
  205. package/dist/init.js.map +1 -0
  206. package/dist/inject/index.js +82 -0
  207. package/dist/inject/index.js.map +1 -0
  208. package/dist/injection.js +343 -0
  209. package/dist/injection.js.map +1 -0
  210. package/dist/intelligence/adaptive-validation.js +497 -0
  211. package/dist/intelligence/adaptive-validation.js.map +1 -0
  212. package/dist/intelligence/impact.js +675 -0
  213. package/dist/intelligence/impact.js.map +1 -0
  214. package/dist/intelligence/index.js +22 -0
  215. package/dist/intelligence/index.js.map +1 -0
  216. package/dist/intelligence/patterns.js +492 -0
  217. package/dist/intelligence/patterns.js.map +1 -0
  218. package/dist/intelligence/prediction.js +499 -0
  219. package/dist/intelligence/prediction.js.map +1 -0
  220. package/dist/intelligence/types.js +13 -0
  221. package/dist/intelligence/types.js.map +1 -0
  222. package/dist/internal.d.ts +5 -2
  223. package/dist/internal.d.ts.map +1 -1
  224. package/dist/internal.js +286 -0
  225. package/dist/internal.js.map +1 -0
  226. package/dist/issue/create.js +121 -0
  227. package/dist/issue/create.js.map +1 -0
  228. package/dist/issue/diagnostics.js +59 -0
  229. package/dist/issue/diagnostics.js.map +1 -0
  230. package/dist/issue/index.js +10 -0
  231. package/dist/issue/index.js.map +1 -0
  232. package/dist/issue/template-parser.js +267 -0
  233. package/dist/issue/template-parser.js.map +1 -0
  234. package/dist/json-schema-validator.js +76 -0
  235. package/dist/json-schema-validator.js.map +1 -0
  236. package/dist/lib/index.d.ts +1 -0
  237. package/dist/lib/index.d.ts.map +1 -1
  238. package/dist/lib/index.js +10 -0
  239. package/dist/lib/index.js.map +1 -0
  240. package/dist/lib/retry.js +152 -0
  241. package/dist/lib/retry.js.map +1 -0
  242. package/dist/lib/tree-sitter-languages.d.ts +29 -0
  243. package/dist/lib/tree-sitter-languages.d.ts.map +1 -0
  244. package/dist/lifecycle/chain-composition.js +152 -0
  245. package/dist/lifecycle/chain-composition.js.map +1 -0
  246. package/dist/lifecycle/chain-store.js +246 -0
  247. package/dist/lifecycle/chain-store.js.map +1 -0
  248. package/dist/lifecycle/consolidate-rcasd.js +352 -0
  249. package/dist/lifecycle/consolidate-rcasd.js.map +1 -0
  250. package/dist/lifecycle/default-chain.js +167 -0
  251. package/dist/lifecycle/default-chain.js.map +1 -0
  252. package/dist/lifecycle/evidence.js +180 -0
  253. package/dist/lifecycle/evidence.js.map +1 -0
  254. package/dist/lifecycle/frontmatter.js +363 -0
  255. package/dist/lifecycle/frontmatter.js.map +1 -0
  256. package/dist/lifecycle/index.js +753 -0
  257. package/dist/lifecycle/index.js.map +1 -0
  258. package/dist/lifecycle/pipeline.js +656 -0
  259. package/dist/lifecycle/pipeline.js.map +1 -0
  260. package/dist/lifecycle/rcasd-index.js +326 -0
  261. package/dist/lifecycle/rcasd-index.js.map +1 -0
  262. package/dist/lifecycle/rcasd-paths.js +220 -0
  263. package/dist/lifecycle/rcasd-paths.js.map +1 -0
  264. package/dist/lifecycle/resume.js +864 -0
  265. package/dist/lifecycle/resume.js.map +1 -0
  266. package/dist/lifecycle/stage-artifacts.js +94 -0
  267. package/dist/lifecycle/stage-artifacts.js.map +1 -0
  268. package/dist/lifecycle/stages.js +534 -0
  269. package/dist/lifecycle/stages.js.map +1 -0
  270. package/dist/lifecycle/state-machine.js +516 -0
  271. package/dist/lifecycle/state-machine.js.map +1 -0
  272. package/dist/lifecycle/tessera-engine.js +249 -0
  273. package/dist/lifecycle/tessera-engine.js.map +1 -0
  274. package/dist/logger.js +140 -0
  275. package/dist/logger.js.map +1 -0
  276. package/dist/mcp/index.js +146 -0
  277. package/dist/mcp/index.js.map +1 -0
  278. package/dist/memory/auto-extract.js +177 -0
  279. package/dist/memory/auto-extract.js.map +1 -0
  280. package/dist/memory/brain-embedding.js +66 -0
  281. package/dist/memory/brain-embedding.js.map +1 -0
  282. package/dist/memory/brain-lifecycle.js +298 -0
  283. package/dist/memory/brain-lifecycle.js.map +1 -0
  284. package/dist/memory/brain-links.d.ts.map +1 -1
  285. package/dist/memory/brain-links.js +148 -0
  286. package/dist/memory/brain-links.js.map +1 -0
  287. package/dist/memory/brain-maintenance.d.ts +13 -0
  288. package/dist/memory/brain-maintenance.d.ts.map +1 -1
  289. package/dist/memory/brain-maintenance.js +98 -0
  290. package/dist/memory/brain-maintenance.js.map +1 -0
  291. package/dist/memory/brain-migration.js +149 -0
  292. package/dist/memory/brain-migration.js.map +1 -0
  293. package/dist/memory/brain-reasoning.js +215 -0
  294. package/dist/memory/brain-reasoning.js.map +1 -0
  295. package/dist/memory/brain-retrieval.d.ts.map +1 -1
  296. package/dist/memory/brain-retrieval.js +526 -0
  297. package/dist/memory/brain-retrieval.js.map +1 -0
  298. package/dist/memory/brain-row-types.js +10 -0
  299. package/dist/memory/brain-row-types.js.map +1 -0
  300. package/dist/memory/brain-search.js +519 -0
  301. package/dist/memory/brain-search.js.map +1 -0
  302. package/dist/memory/brain-similarity.js +145 -0
  303. package/dist/memory/brain-similarity.js.map +1 -0
  304. package/dist/memory/claude-mem-migration.js +277 -0
  305. package/dist/memory/claude-mem-migration.js.map +1 -0
  306. package/dist/memory/decisions.d.ts.map +1 -1
  307. package/dist/memory/decisions.js +148 -0
  308. package/dist/memory/decisions.js.map +1 -0
  309. package/dist/memory/embedding-local.js +97 -0
  310. package/dist/memory/embedding-local.js.map +1 -0
  311. package/dist/memory/embedding-queue.js +271 -0
  312. package/dist/memory/embedding-queue.js.map +1 -0
  313. package/dist/memory/embedding-worker.js +58 -0
  314. package/dist/memory/embedding-worker.js.map +1 -0
  315. package/dist/memory/engine-compat.js +1030 -0
  316. package/dist/memory/engine-compat.js.map +1 -0
  317. package/dist/memory/index.js +773 -0
  318. package/dist/memory/index.js.map +1 -0
  319. package/dist/memory/learnings.js +121 -0
  320. package/dist/memory/learnings.js.map +1 -0
  321. package/dist/memory/memory-bridge.js +370 -0
  322. package/dist/memory/memory-bridge.js.map +1 -0
  323. package/dist/memory/patterns.js +122 -0
  324. package/dist/memory/patterns.js.map +1 -0
  325. package/dist/memory/pipeline-manifest-sqlite.js +975 -0
  326. package/dist/memory/pipeline-manifest-sqlite.js.map +1 -0
  327. package/dist/memory/session-memory.js +331 -0
  328. package/dist/memory/session-memory.js.map +1 -0
  329. package/dist/metrics/ab-test.js +260 -0
  330. package/dist/metrics/ab-test.js.map +1 -0
  331. package/dist/metrics/aggregation.js +363 -0
  332. package/dist/metrics/aggregation.js.map +1 -0
  333. package/dist/metrics/common.js +64 -0
  334. package/dist/metrics/common.js.map +1 -0
  335. package/dist/metrics/enums.js +78 -0
  336. package/dist/metrics/enums.js.map +1 -0
  337. package/dist/metrics/index.js +19 -0
  338. package/dist/metrics/index.js.map +1 -0
  339. package/dist/metrics/model-provider-registry.js +88 -0
  340. package/dist/metrics/model-provider-registry.js.map +1 -0
  341. package/dist/metrics/otel-integration.js +263 -0
  342. package/dist/metrics/otel-integration.js.map +1 -0
  343. package/dist/metrics/provider-detection.js +103 -0
  344. package/dist/metrics/provider-detection.js.map +1 -0
  345. package/dist/metrics/token-estimation.js +253 -0
  346. package/dist/metrics/token-estimation.js.map +1 -0
  347. package/dist/metrics/token-service.js +450 -0
  348. package/dist/metrics/token-service.js.map +1 -0
  349. package/dist/migration/agent-outputs.js +316 -0
  350. package/dist/migration/agent-outputs.js.map +1 -0
  351. package/dist/migration/checksum.js +92 -0
  352. package/dist/migration/checksum.js.map +1 -0
  353. package/dist/migration/index.js +282 -0
  354. package/dist/migration/index.js.map +1 -0
  355. package/dist/migration/logger.js +360 -0
  356. package/dist/migration/logger.js.map +1 -0
  357. package/dist/migration/preflight.js +9 -0
  358. package/dist/migration/preflight.js.map +1 -0
  359. package/dist/migration/state.js +421 -0
  360. package/dist/migration/state.js.map +1 -0
  361. package/dist/migration/validate.js +241 -0
  362. package/dist/migration/validate.js.map +1 -0
  363. package/dist/mvi-helpers.js +74 -0
  364. package/dist/mvi-helpers.js.map +1 -0
  365. package/dist/nexus/deps.js +375 -0
  366. package/dist/nexus/deps.js.map +1 -0
  367. package/dist/nexus/discover.js +288 -0
  368. package/dist/nexus/discover.js.map +1 -0
  369. package/dist/nexus/hash.js +10 -0
  370. package/dist/nexus/hash.js.map +1 -0
  371. package/dist/nexus/index.js +40 -0
  372. package/dist/nexus/index.js.map +1 -0
  373. package/dist/nexus/migrate-json-to-sqlite.js +115 -0
  374. package/dist/nexus/migrate-json-to-sqlite.js.map +1 -0
  375. package/dist/nexus/permissions.js +105 -0
  376. package/dist/nexus/permissions.js.map +1 -0
  377. package/dist/nexus/query.js +175 -0
  378. package/dist/nexus/query.js.map +1 -0
  379. package/dist/nexus/registry.js +584 -0
  380. package/dist/nexus/registry.js.map +1 -0
  381. package/dist/nexus/sharing/index.js +288 -0
  382. package/dist/nexus/sharing/index.js.map +1 -0
  383. package/dist/nexus/transfer-types.js +8 -0
  384. package/dist/nexus/transfer-types.js.map +1 -0
  385. package/dist/nexus/transfer.js +263 -0
  386. package/dist/nexus/transfer.js.map +1 -0
  387. package/dist/nexus/workspace.js +355 -0
  388. package/dist/nexus/workspace.js.map +1 -0
  389. package/dist/observability/index.js +103 -0
  390. package/dist/observability/index.js.map +1 -0
  391. package/dist/observability/log-filter.js +63 -0
  392. package/dist/observability/log-filter.js.map +1 -0
  393. package/dist/observability/log-parser.js +99 -0
  394. package/dist/observability/log-parser.js.map +1 -0
  395. package/dist/observability/log-reader.js +139 -0
  396. package/dist/observability/log-reader.js.map +1 -0
  397. package/dist/observability/types.js +19 -0
  398. package/dist/observability/types.js.map +1 -0
  399. package/dist/orchestration/analyze.js +107 -0
  400. package/dist/orchestration/analyze.js.map +1 -0
  401. package/dist/orchestration/bootstrap.js +132 -0
  402. package/dist/orchestration/bootstrap.js.map +1 -0
  403. package/dist/orchestration/context.js +56 -0
  404. package/dist/orchestration/context.js.map +1 -0
  405. package/dist/orchestration/critical-path.js +100 -0
  406. package/dist/orchestration/critical-path.js.map +1 -0
  407. package/dist/orchestration/hierarchy.d.ts +32 -0
  408. package/dist/orchestration/hierarchy.d.ts.map +1 -0
  409. package/dist/orchestration/index.d.ts +1 -0
  410. package/dist/orchestration/index.d.ts.map +1 -1
  411. package/dist/orchestration/index.js +286 -0
  412. package/dist/orchestration/index.js.map +1 -0
  413. package/dist/orchestration/parallel.js +89 -0
  414. package/dist/orchestration/parallel.js.map +1 -0
  415. package/dist/orchestration/protocol-validators.js +524 -0
  416. package/dist/orchestration/protocol-validators.js.map +1 -0
  417. package/dist/orchestration/skill-ops.js +98 -0
  418. package/dist/orchestration/skill-ops.js.map +1 -0
  419. package/dist/orchestration/status.js +107 -0
  420. package/dist/orchestration/status.js.map +1 -0
  421. package/dist/orchestration/unblock.js +103 -0
  422. package/dist/orchestration/unblock.js.map +1 -0
  423. package/dist/orchestration/validate-spawn.js +67 -0
  424. package/dist/orchestration/validate-spawn.js.map +1 -0
  425. package/dist/orchestration/waves.js +86 -0
  426. package/dist/orchestration/waves.js.map +1 -0
  427. package/dist/otel/index.js +163 -0
  428. package/dist/otel/index.js.map +1 -0
  429. package/dist/output.js +164 -0
  430. package/dist/output.js.map +1 -0
  431. package/dist/pagination.js +64 -0
  432. package/dist/pagination.js.map +1 -0
  433. package/dist/paths.js +337 -0
  434. package/dist/paths.js.map +1 -0
  435. package/dist/phases/deps.js +372 -0
  436. package/dist/phases/deps.js.map +1 -0
  437. package/dist/phases/index.js +349 -0
  438. package/dist/phases/index.js.map +1 -0
  439. package/dist/pipeline/index.js +10 -0
  440. package/dist/pipeline/index.js.map +1 -0
  441. package/dist/pipeline/phase.js +45 -0
  442. package/dist/pipeline/phase.js.map +1 -0
  443. package/dist/platform.js +211 -0
  444. package/dist/platform.js.map +1 -0
  445. package/dist/project-info.js +84 -0
  446. package/dist/project-info.js.map +1 -0
  447. package/dist/reconciliation/index.js +10 -0
  448. package/dist/reconciliation/index.js.map +1 -0
  449. package/dist/reconciliation/link-store.js +129 -0
  450. package/dist/reconciliation/link-store.js.map +1 -0
  451. package/dist/reconciliation/reconciliation-engine.js +298 -0
  452. package/dist/reconciliation/reconciliation-engine.js.map +1 -0
  453. package/dist/release/artifacts.js +427 -0
  454. package/dist/release/artifacts.js.map +1 -0
  455. package/dist/release/changelog-writer.js +151 -0
  456. package/dist/release/changelog-writer.js.map +1 -0
  457. package/dist/release/channel.js +144 -0
  458. package/dist/release/channel.js.map +1 -0
  459. package/dist/release/ci.js +166 -0
  460. package/dist/release/ci.js.map +1 -0
  461. package/dist/release/github-pr.js +225 -0
  462. package/dist/release/github-pr.js.map +1 -0
  463. package/dist/release/guards.js +116 -0
  464. package/dist/release/guards.js.map +1 -0
  465. package/dist/release/index.js +22 -0
  466. package/dist/release/index.js.map +1 -0
  467. package/dist/release/release-config.js +158 -0
  468. package/dist/release/release-config.js.map +1 -0
  469. package/dist/release/release-manifest.js +1019 -0
  470. package/dist/release/release-manifest.js.map +1 -0
  471. package/dist/release/version-bump.js +255 -0
  472. package/dist/release/version-bump.js.map +1 -0
  473. package/dist/remote/index.js +257 -0
  474. package/dist/remote/index.js.map +1 -0
  475. package/dist/repair.js +130 -0
  476. package/dist/repair.js.map +1 -0
  477. package/dist/research/index.js +2 -0
  478. package/dist/research/index.js.map +1 -0
  479. package/dist/roadmap/index.js +59 -0
  480. package/dist/roadmap/index.js.map +1 -0
  481. package/dist/routing/capability-matrix.js +1557 -0
  482. package/dist/routing/capability-matrix.js.map +1 -0
  483. package/dist/routing/index.js +9 -0
  484. package/dist/routing/index.js.map +1 -0
  485. package/dist/scaffold.js +1178 -0
  486. package/dist/scaffold.js.map +1 -0
  487. package/dist/schema-management.js +295 -0
  488. package/dist/schema-management.js.map +1 -0
  489. package/dist/security/index.js +9 -0
  490. package/dist/security/index.js.map +1 -0
  491. package/dist/security/input-sanitization.js +321 -0
  492. package/dist/security/input-sanitization.js.map +1 -0
  493. package/dist/sequence/index.js +295 -0
  494. package/dist/sequence/index.js.map +1 -0
  495. package/dist/sessions/assumptions.js +54 -0
  496. package/dist/sessions/assumptions.js.map +1 -0
  497. package/dist/sessions/briefing.js +377 -0
  498. package/dist/sessions/briefing.js.map +1 -0
  499. package/dist/sessions/context-alert.js +222 -0
  500. package/dist/sessions/context-alert.js.map +1 -0
  501. package/dist/sessions/context-inject.js +61 -0
  502. package/dist/sessions/context-inject.js.map +1 -0
  503. package/dist/sessions/context-monitor.js +98 -0
  504. package/dist/sessions/context-monitor.js.map +1 -0
  505. package/dist/sessions/decisions.js +65 -0
  506. package/dist/sessions/decisions.js.map +1 -0
  507. package/dist/sessions/find.js +65 -0
  508. package/dist/sessions/find.js.map +1 -0
  509. package/dist/sessions/handoff.js +328 -0
  510. package/dist/sessions/handoff.js.map +1 -0
  511. package/dist/sessions/hitl-warnings.js +254 -0
  512. package/dist/sessions/hitl-warnings.js.map +1 -0
  513. package/dist/sessions/index.js +321 -0
  514. package/dist/sessions/index.js.map +1 -0
  515. package/dist/sessions/session-archive.js +40 -0
  516. package/dist/sessions/session-archive.js.map +1 -0
  517. package/dist/sessions/session-cleanup.js +59 -0
  518. package/dist/sessions/session-cleanup.js.map +1 -0
  519. package/dist/sessions/session-drift.js +134 -0
  520. package/dist/sessions/session-drift.js.map +1 -0
  521. package/dist/sessions/session-enforcement.js +144 -0
  522. package/dist/sessions/session-enforcement.js.map +1 -0
  523. package/dist/sessions/session-grade.js +253 -0
  524. package/dist/sessions/session-grade.js.map +1 -0
  525. package/dist/sessions/session-history.js +42 -0
  526. package/dist/sessions/session-history.js.map +1 -0
  527. package/dist/sessions/session-id.js +81 -0
  528. package/dist/sessions/session-id.js.map +1 -0
  529. package/dist/sessions/session-memory-bridge.js +52 -0
  530. package/dist/sessions/session-memory-bridge.js.map +1 -0
  531. package/dist/sessions/session-show.js +24 -0
  532. package/dist/sessions/session-show.js.map +1 -0
  533. package/dist/sessions/session-stats.js +69 -0
  534. package/dist/sessions/session-stats.js.map +1 -0
  535. package/dist/sessions/session-suspend.js +39 -0
  536. package/dist/sessions/session-suspend.js.map +1 -0
  537. package/dist/sessions/session-switch.js +51 -0
  538. package/dist/sessions/session-switch.js.map +1 -0
  539. package/dist/sessions/session-view.js +76 -0
  540. package/dist/sessions/session-view.js.map +1 -0
  541. package/dist/sessions/snapshot.js +213 -0
  542. package/dist/sessions/snapshot.js.map +1 -0
  543. package/dist/sessions/statusline-setup.js +85 -0
  544. package/dist/sessions/statusline-setup.js.map +1 -0
  545. package/dist/sessions/types.js +8 -0
  546. package/dist/sessions/types.js.map +1 -0
  547. package/dist/signaldock/claude-code-transport.d.ts +34 -0
  548. package/dist/signaldock/claude-code-transport.d.ts.map +1 -0
  549. package/dist/signaldock/claude-code-transport.js +107 -0
  550. package/dist/signaldock/claude-code-transport.js.map +1 -0
  551. package/dist/signaldock/factory.d.ts +22 -0
  552. package/dist/signaldock/factory.d.ts.map +1 -0
  553. package/dist/signaldock/factory.js +25 -0
  554. package/dist/signaldock/factory.js.map +1 -0
  555. package/dist/signaldock/index.d.ts +13 -0
  556. package/dist/signaldock/index.d.ts.map +1 -0
  557. package/dist/signaldock/index.js +9 -0
  558. package/dist/signaldock/index.js.map +1 -0
  559. package/dist/signaldock/signaldock-transport.d.ts +45 -0
  560. package/dist/signaldock/signaldock-transport.d.ts.map +1 -0
  561. package/dist/signaldock/signaldock-transport.js +122 -0
  562. package/dist/signaldock/signaldock-transport.js.map +1 -0
  563. package/dist/signaldock/transport.d.ts +49 -0
  564. package/dist/signaldock/transport.d.ts.map +1 -0
  565. package/dist/signaldock/transport.js +11 -0
  566. package/dist/signaldock/transport.js.map +1 -0
  567. package/dist/signaldock/types.d.ts +88 -0
  568. package/dist/signaldock/types.d.ts.map +1 -0
  569. package/dist/signaldock/types.js +11 -0
  570. package/dist/signaldock/types.js.map +1 -0
  571. package/dist/skills/agents/config.js +94 -0
  572. package/dist/skills/agents/config.js.map +1 -0
  573. package/dist/skills/agents/install.js +116 -0
  574. package/dist/skills/agents/install.js.map +1 -0
  575. package/dist/skills/agents/registry.js +161 -0
  576. package/dist/skills/agents/registry.js.map +1 -0
  577. package/dist/skills/discovery.js +333 -0
  578. package/dist/skills/discovery.js.map +1 -0
  579. package/dist/skills/dispatch.js +347 -0
  580. package/dist/skills/dispatch.js.map +1 -0
  581. package/dist/skills/dynamic-skill-generator.js +100 -0
  582. package/dist/skills/dynamic-skill-generator.js.map +1 -0
  583. package/dist/skills/index.js +44 -0
  584. package/dist/skills/index.js.map +1 -0
  585. package/dist/skills/injection/subagent.js +195 -0
  586. package/dist/skills/injection/subagent.js.map +1 -0
  587. package/dist/skills/injection/token.js +260 -0
  588. package/dist/skills/injection/token.js.map +1 -0
  589. package/dist/skills/install.js +40 -0
  590. package/dist/skills/install.js.map +1 -0
  591. package/dist/skills/manifests/contribution.js +175 -0
  592. package/dist/skills/manifests/contribution.js.map +1 -0
  593. package/dist/skills/manifests/research.js +281 -0
  594. package/dist/skills/manifests/research.js.map +1 -0
  595. package/dist/skills/manifests/resolver.js +146 -0
  596. package/dist/skills/manifests/resolver.js.map +1 -0
  597. package/dist/skills/marketplace.js +90 -0
  598. package/dist/skills/marketplace.js.map +1 -0
  599. package/dist/skills/orchestrator/spawn.js +178 -0
  600. package/dist/skills/orchestrator/spawn.js.map +1 -0
  601. package/dist/skills/orchestrator/startup.js +451 -0
  602. package/dist/skills/orchestrator/startup.js.map +1 -0
  603. package/dist/skills/orchestrator/validator.js +301 -0
  604. package/dist/skills/orchestrator/validator.js.map +1 -0
  605. package/dist/skills/precedence-integration.js +73 -0
  606. package/dist/skills/precedence-integration.js.map +1 -0
  607. package/dist/skills/precedence-types.js +16 -0
  608. package/dist/skills/precedence-types.js.map +1 -0
  609. package/dist/skills/routing-table.js +63 -0
  610. package/dist/skills/routing-table.js.map +1 -0
  611. package/dist/skills/skill-paths.js +220 -0
  612. package/dist/skills/skill-paths.js.map +1 -0
  613. package/dist/skills/test-utility.js +55 -0
  614. package/dist/skills/test-utility.js.map +1 -0
  615. package/dist/skills/types.js +118 -0
  616. package/dist/skills/types.js.map +1 -0
  617. package/dist/skills/validation.js +183 -0
  618. package/dist/skills/validation.js.map +1 -0
  619. package/dist/skills/version.js +57 -0
  620. package/dist/skills/version.js.map +1 -0
  621. package/dist/snapshot/index.js +188 -0
  622. package/dist/snapshot/index.js.map +1 -0
  623. package/dist/spawn/adapter-registry.js +246 -0
  624. package/dist/spawn/adapter-registry.js.map +1 -0
  625. package/dist/spawn/index.js +10 -0
  626. package/dist/spawn/index.js.map +1 -0
  627. package/dist/stats/index.js +343 -0
  628. package/dist/stats/index.js.map +1 -0
  629. package/dist/stats/workflow-telemetry.js +400 -0
  630. package/dist/stats/workflow-telemetry.js.map +1 -0
  631. package/dist/sticky/archive.js +47 -0
  632. package/dist/sticky/archive.js.map +1 -0
  633. package/dist/sticky/convert.js +235 -0
  634. package/dist/sticky/convert.js.map +1 -0
  635. package/dist/sticky/create.js +48 -0
  636. package/dist/sticky/create.js.map +1 -0
  637. package/dist/sticky/id.js +35 -0
  638. package/dist/sticky/id.js.map +1 -0
  639. package/dist/sticky/index.js +16 -0
  640. package/dist/sticky/index.js.map +1 -0
  641. package/dist/sticky/list.js +44 -0
  642. package/dist/sticky/list.js.map +1 -0
  643. package/dist/sticky/purge.js +45 -0
  644. package/dist/sticky/purge.js.map +1 -0
  645. package/dist/sticky/show.js +42 -0
  646. package/dist/sticky/show.js.map +1 -0
  647. package/dist/sticky/types.js +10 -0
  648. package/dist/sticky/types.js.map +1 -0
  649. package/dist/store/agent-registry-accessor.d.ts +10 -433
  650. package/dist/store/agent-registry-accessor.d.ts.map +1 -1
  651. package/dist/store/agent-registry-accessor.js +169 -0
  652. package/dist/store/agent-registry-accessor.js.map +1 -0
  653. package/dist/store/atomic.js +167 -0
  654. package/dist/store/atomic.js.map +1 -0
  655. package/dist/store/backup.js +94 -0
  656. package/dist/store/backup.js.map +1 -0
  657. package/dist/store/brain-accessor.js +397 -0
  658. package/dist/store/brain-accessor.js.map +1 -0
  659. package/dist/store/brain-schema.js +215 -0
  660. package/dist/store/brain-schema.js.map +1 -0
  661. package/dist/store/brain-sqlite.js +222 -0
  662. package/dist/store/brain-sqlite.js.map +1 -0
  663. package/dist/store/cache.js +168 -0
  664. package/dist/store/cache.js.map +1 -0
  665. package/dist/store/chain-schema.js +51 -0
  666. package/dist/store/chain-schema.js.map +1 -0
  667. package/dist/store/converters.js +124 -0
  668. package/dist/store/converters.js.map +1 -0
  669. package/dist/store/cross-db-cleanup.d.ts +34 -0
  670. package/dist/store/cross-db-cleanup.d.ts.map +1 -1
  671. package/dist/store/cross-db-cleanup.js +169 -0
  672. package/dist/store/cross-db-cleanup.js.map +1 -0
  673. package/dist/store/data-accessor.js +26 -0
  674. package/dist/store/data-accessor.js.map +1 -0
  675. package/dist/store/data-safety-central.js +269 -0
  676. package/dist/store/data-safety-central.js.map +1 -0
  677. package/dist/store/data-safety.js +274 -0
  678. package/dist/store/data-safety.js.map +1 -0
  679. package/dist/store/db-helpers.js +224 -0
  680. package/dist/store/db-helpers.js.map +1 -0
  681. package/dist/store/export.js +155 -0
  682. package/dist/store/export.js.map +1 -0
  683. package/dist/store/file-utils.js +270 -0
  684. package/dist/store/file-utils.js.map +1 -0
  685. package/dist/store/git-checkpoint.js +365 -0
  686. package/dist/store/git-checkpoint.js.map +1 -0
  687. package/dist/store/import-logging.js +139 -0
  688. package/dist/store/import-logging.js.map +1 -0
  689. package/dist/store/import-remap.js +145 -0
  690. package/dist/store/import-remap.js.map +1 -0
  691. package/dist/store/import-sort.js +121 -0
  692. package/dist/store/import-sort.js.map +1 -0
  693. package/dist/store/index.js +28 -0
  694. package/dist/store/index.js.map +1 -0
  695. package/dist/store/json.js +208 -0
  696. package/dist/store/json.js.map +1 -0
  697. package/dist/store/lifecycle-store.js +249 -0
  698. package/dist/store/lifecycle-store.js.map +1 -0
  699. package/dist/store/lock.js +70 -0
  700. package/dist/store/lock.js.map +1 -0
  701. package/dist/store/migration-manager.js +151 -0
  702. package/dist/store/migration-manager.js.map +1 -0
  703. package/dist/store/migration-sqlite.js +676 -0
  704. package/dist/store/migration-sqlite.js.map +1 -0
  705. package/dist/store/nexus-schema.js +62 -0
  706. package/dist/store/nexus-schema.js.map +1 -0
  707. package/dist/store/nexus-sqlite.js +217 -0
  708. package/dist/store/nexus-sqlite.js.map +1 -0
  709. package/dist/store/nexus-validation-schemas.js +40 -0
  710. package/dist/store/nexus-validation-schemas.js.map +1 -0
  711. package/dist/store/parsers.js +37 -0
  712. package/dist/store/parsers.js.map +1 -0
  713. package/dist/store/project-detect.js +457 -0
  714. package/dist/store/project-detect.js.map +1 -0
  715. package/dist/store/provider.js +101 -0
  716. package/dist/store/provider.js.map +1 -0
  717. package/dist/store/safety-data-accessor.js +257 -0
  718. package/dist/store/safety-data-accessor.js.map +1 -0
  719. package/dist/store/schema.js +7 -0
  720. package/dist/store/schema.js.map +1 -0
  721. package/dist/store/session-store.js +219 -0
  722. package/dist/store/session-store.js.map +1 -0
  723. package/dist/store/signaldock-sqlite.d.ts.map +1 -1
  724. package/dist/store/signaldock-sqlite.js +178 -0
  725. package/dist/store/signaldock-sqlite.js.map +1 -0
  726. package/dist/store/sqlite-backup.js +105 -0
  727. package/dist/store/sqlite-backup.js.map +1 -0
  728. package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
  729. package/dist/store/sqlite-data-accessor.js +784 -0
  730. package/dist/store/sqlite-data-accessor.js.map +1 -0
  731. package/dist/store/sqlite.js +465 -0
  732. package/dist/store/sqlite.js.map +1 -0
  733. package/dist/store/status-registry.js +8 -0
  734. package/dist/store/status-registry.js.map +1 -0
  735. package/dist/store/task-store.d.ts.map +1 -1
  736. package/dist/store/task-store.js +350 -0
  737. package/dist/store/task-store.js.map +1 -0
  738. package/dist/store/tasks-schema.d.ts +0 -224
  739. package/dist/store/tasks-schema.d.ts.map +1 -1
  740. package/dist/store/tasks-schema.js +637 -0
  741. package/dist/store/tasks-schema.js.map +1 -0
  742. package/dist/store/typed-query.js +15 -0
  743. package/dist/store/typed-query.js.map +1 -0
  744. package/dist/store/validation-schemas.js +278 -0
  745. package/dist/store/validation-schemas.js.map +1 -0
  746. package/dist/system/archive-analytics.js +277 -0
  747. package/dist/system/archive-analytics.js.map +1 -0
  748. package/dist/system/archive-stats.js +64 -0
  749. package/dist/system/archive-stats.js.map +1 -0
  750. package/dist/system/audit.js +145 -0
  751. package/dist/system/audit.js.map +1 -0
  752. package/dist/system/backup.js +141 -0
  753. package/dist/system/backup.js.map +1 -0
  754. package/dist/system/cleanup.js +134 -0
  755. package/dist/system/cleanup.js.map +1 -0
  756. package/dist/system/health.d.ts +1 -1
  757. package/dist/system/health.d.ts.map +1 -1
  758. package/dist/system/health.js +1089 -0
  759. package/dist/system/health.js.map +1 -0
  760. package/dist/system/index.js +18 -0
  761. package/dist/system/index.js.map +1 -0
  762. package/dist/system/inject-generate.js +122 -0
  763. package/dist/system/inject-generate.js.map +1 -0
  764. package/dist/system/labels.js +38 -0
  765. package/dist/system/labels.js.map +1 -0
  766. package/dist/system/metrics.js +61 -0
  767. package/dist/system/metrics.js.map +1 -0
  768. package/dist/system/migrate.js +43 -0
  769. package/dist/system/migrate.js.map +1 -0
  770. package/dist/system/platform-paths.js +80 -0
  771. package/dist/system/platform-paths.js.map +1 -0
  772. package/dist/system/runtime.js +161 -0
  773. package/dist/system/runtime.js.map +1 -0
  774. package/dist/system/safestop.js +99 -0
  775. package/dist/system/safestop.js.map +1 -0
  776. package/dist/system/storage-preflight.js +123 -0
  777. package/dist/system/storage-preflight.js.map +1 -0
  778. package/dist/task-work/index.js +159 -0
  779. package/dist/task-work/index.js.map +1 -0
  780. package/dist/tasks/add.js +661 -0
  781. package/dist/tasks/add.js.map +1 -0
  782. package/dist/tasks/analyze.js +85 -0
  783. package/dist/tasks/analyze.js.map +1 -0
  784. package/dist/tasks/archive.js +90 -0
  785. package/dist/tasks/archive.js.map +1 -0
  786. package/dist/tasks/atomicity.js +83 -0
  787. package/dist/tasks/atomicity.js.map +1 -0
  788. package/dist/tasks/cancel-ops.js +83 -0
  789. package/dist/tasks/cancel-ops.js.map +1 -0
  790. package/dist/tasks/complete.js +211 -0
  791. package/dist/tasks/complete.js.map +1 -0
  792. package/dist/tasks/crossref-extract.js +73 -0
  793. package/dist/tasks/crossref-extract.js.map +1 -0
  794. package/dist/tasks/delete-preview.js +192 -0
  795. package/dist/tasks/delete-preview.js.map +1 -0
  796. package/dist/tasks/delete.js +120 -0
  797. package/dist/tasks/delete.js.map +1 -0
  798. package/dist/tasks/deletion-strategy.js +200 -0
  799. package/dist/tasks/deletion-strategy.js.map +1 -0
  800. package/dist/tasks/dependency-check.js +278 -0
  801. package/dist/tasks/dependency-check.js.map +1 -0
  802. package/dist/tasks/deps-ready.js +32 -0
  803. package/dist/tasks/deps-ready.js.map +1 -0
  804. package/dist/tasks/enforcement.js +86 -0
  805. package/dist/tasks/enforcement.js.map +1 -0
  806. package/dist/tasks/epic-enforcement.js +294 -0
  807. package/dist/tasks/epic-enforcement.js.map +1 -0
  808. package/dist/tasks/find.js +154 -0
  809. package/dist/tasks/find.js.map +1 -0
  810. package/dist/tasks/graph-cache.js +127 -0
  811. package/dist/tasks/graph-cache.js.map +1 -0
  812. package/dist/tasks/graph-ops.js +171 -0
  813. package/dist/tasks/graph-ops.js.map +1 -0
  814. package/dist/tasks/graph-rag.js +328 -0
  815. package/dist/tasks/graph-rag.js.map +1 -0
  816. package/dist/tasks/hierarchy-policy.js +149 -0
  817. package/dist/tasks/hierarchy-policy.js.map +1 -0
  818. package/dist/tasks/hierarchy.js +185 -0
  819. package/dist/tasks/hierarchy.js.map +1 -0
  820. package/dist/tasks/id-generator.js +65 -0
  821. package/dist/tasks/id-generator.js.map +1 -0
  822. package/dist/tasks/index.js +14 -0
  823. package/dist/tasks/index.js.map +1 -0
  824. package/dist/tasks/labels.js +52 -0
  825. package/dist/tasks/labels.js.map +1 -0
  826. package/dist/tasks/list.js +75 -0
  827. package/dist/tasks/list.js.map +1 -0
  828. package/dist/tasks/phase-tracking.js +133 -0
  829. package/dist/tasks/phase-tracking.js.map +1 -0
  830. package/dist/tasks/pipeline-stage.js +248 -0
  831. package/dist/tasks/pipeline-stage.js.map +1 -0
  832. package/dist/tasks/plan.js +268 -0
  833. package/dist/tasks/plan.js.map +1 -0
  834. package/dist/tasks/relates.js +89 -0
  835. package/dist/tasks/relates.js.map +1 -0
  836. package/dist/tasks/show.js +80 -0
  837. package/dist/tasks/show.js.map +1 -0
  838. package/dist/tasks/size-weighting.js +86 -0
  839. package/dist/tasks/size-weighting.js.map +1 -0
  840. package/dist/tasks/staleness.js +86 -0
  841. package/dist/tasks/staleness.js.map +1 -0
  842. package/dist/tasks/task-ops.js +1340 -0
  843. package/dist/tasks/task-ops.js.map +1 -0
  844. package/dist/tasks/update.js +271 -0
  845. package/dist/tasks/update.js.map +1 -0
  846. package/dist/templates/index.js +10 -0
  847. package/dist/templates/index.js.map +1 -0
  848. package/dist/templates/parser.js +254 -0
  849. package/dist/templates/parser.js.map +1 -0
  850. package/dist/ui/aliases.js +153 -0
  851. package/dist/ui/aliases.js.map +1 -0
  852. package/dist/ui/changelog.js +184 -0
  853. package/dist/ui/changelog.js.map +1 -0
  854. package/dist/ui/command-registry.js +168 -0
  855. package/dist/ui/command-registry.js.map +1 -0
  856. package/dist/ui/flags.js +94 -0
  857. package/dist/ui/flags.js.map +1 -0
  858. package/dist/ui/index.js +24 -0
  859. package/dist/ui/index.js.map +1 -0
  860. package/dist/upgrade.js +1159 -0
  861. package/dist/upgrade.js.map +1 -0
  862. package/dist/validation/chain-validation.js +146 -0
  863. package/dist/validation/chain-validation.js.map +1 -0
  864. package/dist/validation/compliance.js +155 -0
  865. package/dist/validation/compliance.js.map +1 -0
  866. package/dist/validation/docs-sync.js +212 -0
  867. package/dist/validation/docs-sync.js.map +1 -0
  868. package/dist/validation/doctor/checks.js +1069 -0
  869. package/dist/validation/doctor/checks.js.map +1 -0
  870. package/dist/validation/doctor/index.js +9 -0
  871. package/dist/validation/doctor/index.js.map +1 -0
  872. package/dist/validation/doctor/project-cache.js +160 -0
  873. package/dist/validation/doctor/project-cache.js.map +1 -0
  874. package/dist/validation/doctor/utils.js +155 -0
  875. package/dist/validation/doctor/utils.js.map +1 -0
  876. package/dist/validation/engine.js +902 -0
  877. package/dist/validation/engine.js.map +1 -0
  878. package/dist/validation/gap-check.js +175 -0
  879. package/dist/validation/gap-check.js.map +1 -0
  880. package/dist/validation/index.js +40 -0
  881. package/dist/validation/index.js.map +1 -0
  882. package/dist/validation/manifest.js +237 -0
  883. package/dist/validation/manifest.js.map +1 -0
  884. package/dist/validation/operation-gate-validators.js +724 -0
  885. package/dist/validation/operation-gate-validators.js.map +1 -0
  886. package/dist/validation/operation-verification-gates.js +532 -0
  887. package/dist/validation/operation-verification-gates.js.map +1 -0
  888. package/dist/validation/param-utils.js +139 -0
  889. package/dist/validation/param-utils.js.map +1 -0
  890. package/dist/validation/protocol-common.js +300 -0
  891. package/dist/validation/protocol-common.js.map +1 -0
  892. package/dist/validation/protocols/consensus.js +71 -0
  893. package/dist/validation/protocols/consensus.js.map +1 -0
  894. package/dist/validation/protocols/contribution.js +59 -0
  895. package/dist/validation/protocols/contribution.js.map +1 -0
  896. package/dist/validation/protocols/decomposition.js +59 -0
  897. package/dist/validation/protocols/decomposition.js.map +1 -0
  898. package/dist/validation/protocols/implementation.js +59 -0
  899. package/dist/validation/protocols/implementation.js.map +1 -0
  900. package/dist/validation/protocols/release-protocol.js +60 -0
  901. package/dist/validation/protocols/release-protocol.js.map +1 -0
  902. package/dist/validation/protocols/research.js +77 -0
  903. package/dist/validation/protocols/research.js.map +1 -0
  904. package/dist/validation/protocols/specification.js +84 -0
  905. package/dist/validation/protocols/specification.js.map +1 -0
  906. package/dist/validation/protocols/testing-protocol.js +70 -0
  907. package/dist/validation/protocols/testing-protocol.js.map +1 -0
  908. package/dist/validation/protocols/validation-protocol.js +70 -0
  909. package/dist/validation/protocols/validation-protocol.js.map +1 -0
  910. package/dist/validation/schema-integrity.js +170 -0
  911. package/dist/validation/schema-integrity.js.map +1 -0
  912. package/dist/validation/schema-validator.js +176 -0
  913. package/dist/validation/schema-validator.js.map +1 -0
  914. package/dist/validation/validate-ops.js +937 -0
  915. package/dist/validation/validate-ops.js.map +1 -0
  916. package/dist/validation/validation-rules.js +226 -0
  917. package/dist/validation/validation-rules.js.map +1 -0
  918. package/dist/validation/verification.js +321 -0
  919. package/dist/validation/verification.js.map +1 -0
  920. package/package.json +17 -7
  921. package/src/agents/agent-schema.ts +2 -5
  922. package/src/code/index.ts +10 -0
  923. package/src/code/outline.ts +214 -0
  924. package/src/code/parser.ts +299 -0
  925. package/src/code/search.ts +173 -0
  926. package/src/code/unfold.ts +204 -0
  927. package/src/conduit/__tests__/dual-api-e2e.test.ts +212 -0
  928. package/src/conduit/__tests__/local-credential-flow.test.ts +230 -0
  929. package/src/conduit/__tests__/local-transport.test.ts +320 -0
  930. package/src/conduit/__tests__/sse-transport.test.ts +344 -0
  931. package/src/conduit/conduit-client.ts +9 -0
  932. package/src/conduit/factory.ts +9 -5
  933. package/src/conduit/http-transport.ts +76 -15
  934. package/src/conduit/index.ts +5 -2
  935. package/src/conduit/local-transport.ts +309 -0
  936. package/src/conduit/sse-transport.ts +382 -0
  937. package/src/index.ts +1 -0
  938. package/src/internal.ts +6 -1
  939. package/src/lib/index.ts +8 -0
  940. package/src/lib/tree-sitter-languages.ts +88 -0
  941. package/src/memory/__tests__/brain-links.test.ts +14 -0
  942. package/src/memory/__tests__/brain-retrieval.test.ts +10 -0
  943. package/src/memory/__tests__/session-memory.test.ts +17 -0
  944. package/src/memory/brain-links.ts +17 -0
  945. package/src/memory/brain-maintenance.ts +33 -1
  946. package/src/memory/brain-retrieval.ts +18 -2
  947. package/src/memory/decisions.ts +18 -2
  948. package/src/orchestration/hierarchy.ts +202 -0
  949. package/src/orchestration/index.ts +1 -0
  950. package/src/store/agent-registry-accessor.ts +284 -108
  951. package/src/store/cross-db-cleanup.ts +175 -1
  952. package/src/store/signaldock-sqlite.ts +262 -60
  953. package/src/store/sqlite-data-accessor.ts +3 -0
  954. package/src/store/task-store.ts +8 -1
  955. package/src/store/tasks-schema.ts +3 -38
  956. package/src/system/__tests__/health.test.ts +2 -2
  957. package/src/system/health.ts +34 -15
@@ -0,0 +1,267 @@
1
+ /**
2
+ * GitHub Issue Template Parser.
3
+ *
4
+ * Parses .github/ISSUE_TEMPLATE/*.yml files into JSON config.
5
+ * Supports three resolution strategies:
6
+ * 1. Live parse from YAML templates (if in a repo with templates)
7
+ * 2. Cached config from .cleo/issue-templates.json
8
+ * 3. Hardcoded fallback defaults
9
+ *
10
+ * @task T4454
11
+ * @epic T4454
12
+ */
13
+ import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
14
+ import { basename, join } from 'node:path';
15
+ import { BUILD_CONFIG } from '../config/build-config.js';
16
+ import { getCleoDir, getProjectRoot } from '../paths.js';
17
+ import { getPackageRoot } from '../scaffold.js';
18
+ const TEMPLATE_DIR = '.github/ISSUE_TEMPLATE';
19
+ const PACKAGED_TEMPLATE_DIR = BUILD_CONFIG.templates.issueTemplatesDir;
20
+ const CACHE_FILE = 'issue-templates.json';
21
+ /** Known filename-to-subcommand mappings. */
22
+ const SUBCOMMAND_MAP = {
23
+ bug_report: 'bug',
24
+ feature_request: 'feature',
25
+ help_question: 'help',
26
+ };
27
+ /** Fallback default templates. */
28
+ const FALLBACK_TEMPLATES = [
29
+ {
30
+ name: 'Bug Report',
31
+ description: 'Report a bug',
32
+ title: '[Bug] ',
33
+ labels: ['bug'],
34
+ subcommand: 'bug',
35
+ fileName: 'bug_report.yml',
36
+ },
37
+ {
38
+ name: 'Feature Request',
39
+ description: 'Suggest an enhancement',
40
+ title: '[Feature] ',
41
+ labels: ['enhancement'],
42
+ subcommand: 'feature',
43
+ fileName: 'feature_request.yml',
44
+ },
45
+ {
46
+ name: 'Help Question',
47
+ description: 'Ask a question or get help',
48
+ title: '[Help] ',
49
+ labels: ['help', 'question'],
50
+ subcommand: 'help',
51
+ fileName: 'help_question.yml',
52
+ },
53
+ ];
54
+ /**
55
+ * Extract a YAML field value from template content.
56
+ * Handles simple top-level scalar fields only (not nested).
57
+ */
58
+ function extractYamlField(content, field) {
59
+ const regex = new RegExp(`^${field}:\\s*["']?(.+?)["']?\\s*$`, 'm');
60
+ const match = content.match(regex);
61
+ return match?.[1]?.trim() ?? '';
62
+ }
63
+ /**
64
+ * Extract YAML array values (labels).
65
+ * Handles both inline `[a, b]` and multi-line `- a\n- b` formats.
66
+ */
67
+ function extractYamlArray(content, field) {
68
+ // Try inline format: labels: [bug, enhancement]
69
+ const inlineRegex = new RegExp(`^${field}:\\s*\\[([^\\]]+)\\]`, 'm');
70
+ const inlineMatch = content.match(inlineRegex);
71
+ if (inlineMatch) {
72
+ return inlineMatch[1]
73
+ .split(',')
74
+ .map((s) => s.trim().replace(/^["']|["']$/g, ''))
75
+ .filter(Boolean);
76
+ }
77
+ // Try multi-line format
78
+ const lines = content.split('\n');
79
+ const items = [];
80
+ let inArray = false;
81
+ for (const line of lines) {
82
+ if (line.match(new RegExp(`^${field}:`))) {
83
+ inArray = true;
84
+ continue;
85
+ }
86
+ if (inArray) {
87
+ const itemMatch = line.match(/^\s+-\s+["']?(.+?)["']?\s*$/);
88
+ if (itemMatch) {
89
+ items.push(itemMatch[1].trim());
90
+ }
91
+ else if (line.match(/^\S/)) {
92
+ break; // New top-level key, done
93
+ }
94
+ }
95
+ }
96
+ return items;
97
+ }
98
+ /**
99
+ * Parse a single YAML template file.
100
+ */
101
+ function parseTemplateFile(filePath) {
102
+ if (!existsSync(filePath))
103
+ return null;
104
+ try {
105
+ const content = readFileSync(filePath, 'utf-8');
106
+ const fileName = basename(filePath);
107
+ const stem = fileName.replace(/\.ya?ml$/, '');
108
+ const name = extractYamlField(content, 'name');
109
+ const description = extractYamlField(content, 'description');
110
+ const title = extractYamlField(content, 'title');
111
+ const labels = extractYamlArray(content, 'labels');
112
+ const subcommand = SUBCOMMAND_MAP[stem] ?? stem;
113
+ if (!name)
114
+ return null;
115
+ return { name, description, title, labels, subcommand, fileName };
116
+ }
117
+ catch {
118
+ return null;
119
+ }
120
+ }
121
+ /**
122
+ * Parse all issue templates from available sources.
123
+ * Priority:
124
+ * 1. Packaged templates in the CLEO installation (for npm-installed users)
125
+ * 2. Project's .github/ISSUE_TEMPLATE/ (for contributors working on CLEO)
126
+ */
127
+ export function parseIssueTemplates(projectDir) {
128
+ // Strategy 1: Check packaged templates (for npm-installed users)
129
+ try {
130
+ const packageRoot = getPackageRoot();
131
+ const packagedTemplateDir = join(packageRoot, PACKAGED_TEMPLATE_DIR);
132
+ if (existsSync(packagedTemplateDir)) {
133
+ const templates = [];
134
+ for (const file of readdirSync(packagedTemplateDir)) {
135
+ if (!file.endsWith('.yml') && !file.endsWith('.yaml'))
136
+ continue;
137
+ const template = parseTemplateFile(join(packagedTemplateDir, file));
138
+ if (template)
139
+ templates.push(template);
140
+ }
141
+ if (templates.length > 0)
142
+ return templates;
143
+ }
144
+ }
145
+ catch {
146
+ // Fall through to next strategy
147
+ }
148
+ // Strategy 2: Check project's .github/ISSUE_TEMPLATE/ (for contributors)
149
+ const dir = projectDir ?? getProjectRoot();
150
+ const templateDir = join(dir, TEMPLATE_DIR);
151
+ if (!existsSync(templateDir))
152
+ return [];
153
+ const templates = [];
154
+ for (const file of readdirSync(templateDir)) {
155
+ if (!file.endsWith('.yml') && !file.endsWith('.yaml'))
156
+ continue;
157
+ const template = parseTemplateFile(join(templateDir, file));
158
+ if (template)
159
+ templates.push(template);
160
+ }
161
+ return templates;
162
+ }
163
+ /**
164
+ * Get template configuration - tries live parse, cache, then fallback.
165
+ */
166
+ export function getTemplateConfig(cwd) {
167
+ // Strategy 1: Live parse
168
+ const projectDir = cwd ?? getProjectRoot();
169
+ const liveTemplates = parseIssueTemplates(projectDir);
170
+ if (liveTemplates.length > 0)
171
+ return liveTemplates;
172
+ // Strategy 2: Cached config
173
+ const cachePath = join(getCleoDir(cwd), CACHE_FILE);
174
+ if (existsSync(cachePath)) {
175
+ try {
176
+ const cached = JSON.parse(readFileSync(cachePath, 'utf-8'));
177
+ if (cached.templates?.length > 0)
178
+ return cached.templates;
179
+ }
180
+ catch {
181
+ // Fall through to defaults
182
+ }
183
+ }
184
+ // Strategy 3: Fallback defaults
185
+ return FALLBACK_TEMPLATES;
186
+ }
187
+ /**
188
+ * Get the template for a specific subcommand (bug, feature, etc.).
189
+ */
190
+ export function getTemplateForSubcommand(subcommand, cwd) {
191
+ const templates = getTemplateConfig(cwd);
192
+ return templates.find((t) => t.subcommand === subcommand) ?? null;
193
+ }
194
+ /**
195
+ * Cache parsed templates to .cleo/issue-templates.json.
196
+ */
197
+ export function cacheTemplates(templates, cwd) {
198
+ const cachePath = join(getCleoDir(cwd), CACHE_FILE);
199
+ const cache = {
200
+ version: '1.0.0',
201
+ generatedAt: new Date().toISOString(),
202
+ templates,
203
+ };
204
+ writeFileSync(cachePath, JSON.stringify(cache, null, 2) + '\n', 'utf-8');
205
+ }
206
+ /**
207
+ * Validate that labels referenced in issue templates are consistent.
208
+ *
209
+ * Collects all labels used across templates and checks that each label
210
+ * appears in at least one template definition. Reports any labels that
211
+ * are referenced by only one template but not defined as a known label
212
+ * across the template set. This catches typos and orphaned labels
213
+ * without requiring GitHub API access.
214
+ */
215
+ export function validateLabelsExist(templates) {
216
+ if (templates.length === 0) {
217
+ return { valid: true, missingLabels: [] };
218
+ }
219
+ // Build a frequency map of all labels across templates
220
+ const labelFrequency = new Map();
221
+ for (const template of templates) {
222
+ for (const label of template.labels) {
223
+ labelFrequency.set(label, (labelFrequency.get(label) ?? 0) + 1);
224
+ }
225
+ }
226
+ // Cross-reference: each template's labels should be known across the template set.
227
+ // A label used by only one template AND not matching any known subcommand is suspicious.
228
+ const knownSubcommands = new Set(templates.map((t) => t.subcommand));
229
+ const knownNames = new Set(templates.map((t) => t.name.toLowerCase()));
230
+ const missingLabels = [];
231
+ for (const template of templates) {
232
+ for (const label of template.labels) {
233
+ // Check if the label is completely unknown: used once, and not matching
234
+ // any template subcommand or name (which would make it a valid unique label)
235
+ const freq = labelFrequency.get(label) ?? 0;
236
+ if (freq === 1 &&
237
+ !knownSubcommands.has(label) &&
238
+ !knownNames.has(label.toLowerCase()) &&
239
+ !WELL_KNOWN_LABELS.has(label)) {
240
+ missingLabels.push(label);
241
+ }
242
+ }
243
+ }
244
+ return {
245
+ valid: missingLabels.length === 0,
246
+ missingLabels,
247
+ };
248
+ }
249
+ /** Labels that are well-known in GitHub/issue trackers and always valid. */
250
+ const WELL_KNOWN_LABELS = new Set([
251
+ 'bug',
252
+ 'enhancement',
253
+ 'feature',
254
+ 'help',
255
+ 'question',
256
+ 'documentation',
257
+ 'good first issue',
258
+ 'duplicate',
259
+ 'invalid',
260
+ 'wontfix',
261
+ 'priority',
262
+ 'critical',
263
+ 'high',
264
+ 'medium',
265
+ 'low',
266
+ ]);
267
+ //# sourceMappingURL=template-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-parser.js","sourceRoot":"","sources":["../../src/issue/template-parser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * JSON Schema validation engine using ajv.
3
+ * @epic T4454
4
+ * @task T4458
5
+ */
6
+ import { ExitCode } from '@cleocode/contracts';
7
+ import { default as AjvImport } from 'ajv';
8
+ import { default as addFormatsImport } from 'ajv-formats';
9
+ import { CleoError } from './errors.js';
10
+ import { readJson } from './store/json.js';
11
+ // Handle ESM/CJS interop for Ajv and ajv-formats
12
+ const ajvMod = AjvImport;
13
+ const Ajv = (typeof ajvMod.default === 'function' ? ajvMod.default : AjvImport);
14
+ const fmtMod = addFormatsImport;
15
+ const addFormats = (typeof fmtMod.default === 'function' ? fmtMod.default : addFormatsImport);
16
+ /** Singleton ajv instance. */
17
+ let ajvInstance = null;
18
+ function getAjv() {
19
+ if (!ajvInstance) {
20
+ ajvInstance = new Ajv({
21
+ allErrors: true,
22
+ strict: false,
23
+ allowUnionTypes: true,
24
+ });
25
+ addFormats(ajvInstance);
26
+ }
27
+ return ajvInstance;
28
+ }
29
+ /** Compiled schema cache. */
30
+ const schemaCache = new Map();
31
+ /**
32
+ * Validate data against a JSON Schema object.
33
+ * Throws CleoError on validation failure.
34
+ */
35
+ export function validateAgainstSchema(data, schema, schemaId) {
36
+ const ajv = getAjv();
37
+ const cacheKey = schemaId ?? JSON.stringify(schema);
38
+ let validate = schemaCache.get(cacheKey);
39
+ if (!validate) {
40
+ validate = ajv.compile(schema);
41
+ schemaCache.set(cacheKey, validate);
42
+ }
43
+ if (!validate(data)) {
44
+ const errors = validate.errors
45
+ ?.map((e) => `${e.instancePath || '/'}: ${e.message}`)
46
+ .join('; ');
47
+ throw new CleoError(ExitCode.VALIDATION_ERROR, `Schema validation failed: ${errors ?? 'unknown error'}`);
48
+ }
49
+ }
50
+ /**
51
+ * Load a JSON Schema file and validate data against it.
52
+ */
53
+ export async function validateAgainstSchemaFile(data, schemaPath) {
54
+ const schema = await readJson(schemaPath);
55
+ if (!schema) {
56
+ throw new CleoError(ExitCode.NOT_FOUND, `Schema file not found: ${schemaPath}`);
57
+ }
58
+ validateAgainstSchema(data, schema, schemaPath);
59
+ }
60
+ /**
61
+ * Check if data is valid against a schema without throwing.
62
+ * Returns an array of error messages (empty if valid).
63
+ */
64
+ export function checkSchema(data, schema) {
65
+ try {
66
+ validateAgainstSchema(data, schema);
67
+ return [];
68
+ }
69
+ catch (err) {
70
+ if (err instanceof CleoError) {
71
+ return [err.message];
72
+ }
73
+ return [String(err)];
74
+ }
75
+ }
76
+ //# sourceMappingURL=json-schema-validator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-schema-validator.js","sourceRoot":"","sources":["../src/json-schema-validator.ts"],"names":[],"mappings":"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"}
@@ -7,4 +7,5 @@
7
7
  * @module lib
8
8
  */
9
9
  export { computeDelay, type RetryablePredicate, type RetryContext, type RetryOptions, withRetry, } from './retry.js';
10
+ export { detectLanguage, grammarPackage, SUPPORTED_EXTENSIONS, SUPPORTED_LANGUAGES, type TreeSitterLanguage, } from './tree-sitter-languages.js';
10
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,SAAS,GACV,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Shared utility primitives for @cleocode/core.
3
+ *
4
+ * These modules are dependency-free and safe to import from any layer
5
+ * without risking circular dependencies or DB coupling.
6
+ *
7
+ * @module lib
8
+ */
9
+ export { computeDelay, withRetry, } from './retry.js';
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EAIZ,SAAS,GACV,MAAM,YAAY,CAAC"}
@@ -0,0 +1,152 @@
1
+ /**
2
+ * General-purpose retry utility with exponential backoff.
3
+ *
4
+ * This module provides a shared, dependency-free retry primitive for use
5
+ * anywhere in the CLEO core. Unlike the agent-specific retry in
6
+ * `agents/retry.ts`, this utility has no database coupling and is safe to
7
+ * import from any layer.
8
+ *
9
+ * Default schedule (3 attempts, task T040 spec):
10
+ * - Attempt 1: immediate (0 ms delay before retry)
11
+ * - Attempt 2: 2 000 ms delay before retry
12
+ * - Attempt 3: 4 000 ms delay before retry
13
+ * - After attempt 3: throw last error
14
+ *
15
+ * @module lib/retry
16
+ */
17
+ // ============================================================================
18
+ // Public API
19
+ // ============================================================================
20
+ /**
21
+ * Execute an async function with automatic retry and exponential backoff.
22
+ *
23
+ * @remarks
24
+ * The function is called up to `maxAttempts` times. After the first failure,
25
+ * the utility waits `baseDelayMs` milliseconds, then retries. Each subsequent
26
+ * wait doubles: `baseDelayMs * 2^(attempt - 1)`, capped at `maxDelayMs`.
27
+ *
28
+ * If `retryableErrors` is supplied, only errors matching at least one entry
29
+ * are retried; other errors cause immediate re-throw.
30
+ *
31
+ * On final failure the original error is re-thrown. Use {@link RetryContext}
32
+ * fields (attached to the error) to inspect retry metadata.
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * // Basic usage — 3 attempts with 0 ms / 2 000 ms / 4 000 ms delays
37
+ * const data = await withRetry(() => fetchFromApi());
38
+ *
39
+ * // Custom retry window — only on network errors
40
+ * const result = await withRetry(
41
+ * () => db.query(sql),
42
+ * {
43
+ * maxAttempts: 5,
44
+ * baseDelayMs: 500,
45
+ * retryableErrors: [/SQLITE_BUSY/, /database is locked/i],
46
+ * },
47
+ * );
48
+ * ```
49
+ *
50
+ * @typeParam T - The resolved type of the async function
51
+ * @param fn - Async factory that is called on each attempt.
52
+ * @param options - Optional retry configuration.
53
+ * @returns Resolved value of `fn` on success.
54
+ * @throws The last error thrown by `fn`, augmented with {@link RetryContext}
55
+ * fields (`attempts`, `totalDelayMs`).
56
+ */
57
+ export async function withRetry(fn, options) {
58
+ const maxAttempts = options?.maxAttempts ?? 3;
59
+ const baseDelayMs = options?.baseDelayMs ?? 2_000;
60
+ const maxDelayMs = options?.maxDelayMs ?? 30_000;
61
+ const retryableErrors = options?.retryableErrors;
62
+ let lastError;
63
+ let totalDelayMs = 0;
64
+ for (let attempt = 1; attempt <= maxAttempts; attempt++) {
65
+ try {
66
+ return await fn();
67
+ }
68
+ catch (err) {
69
+ lastError = err;
70
+ const isLastAttempt = attempt === maxAttempts;
71
+ if (isLastAttempt)
72
+ break;
73
+ // If a filter list is provided, only retry matching errors.
74
+ if (retryableErrors !== undefined && !isRetryable(err, retryableErrors))
75
+ break;
76
+ const delay = computeDelay(attempt, baseDelayMs, maxDelayMs);
77
+ totalDelayMs += delay;
78
+ await sleep(delay);
79
+ }
80
+ }
81
+ // Augment last error with retry context before re-throwing.
82
+ const context = { attempts: maxAttempts, totalDelayMs };
83
+ augmentError(lastError, context);
84
+ throw lastError;
85
+ }
86
+ // ============================================================================
87
+ // Delay helpers (exported for unit testing)
88
+ // ============================================================================
89
+ /**
90
+ * Compute the wait time before the next attempt.
91
+ *
92
+ * @remarks
93
+ * Formula: `min(baseDelayMs * 2^(attempt - 1), maxDelayMs)`.
94
+ * On the first retry (`attempt === 1`) the delay is `baseDelayMs * 1 = baseDelayMs`.
95
+ *
96
+ * @example
97
+ * ```ts
98
+ * computeDelay(1, 2000, 30000); // 2000
99
+ * computeDelay(2, 2000, 30000); // 4000
100
+ * computeDelay(3, 2000, 30000); // 8000
101
+ * ```
102
+ *
103
+ * @param attempt - The 1-based attempt number that just failed.
104
+ * @param baseDelayMs - Base delay in milliseconds.
105
+ * @param maxDelayMs - Maximum allowed delay in milliseconds.
106
+ * @returns Delay in milliseconds before the next attempt.
107
+ */
108
+ export function computeDelay(attempt, baseDelayMs, maxDelayMs) {
109
+ const exponential = baseDelayMs * 2 ** (attempt - 1);
110
+ return Math.min(exponential, maxDelayMs);
111
+ }
112
+ // ============================================================================
113
+ // Internal helpers
114
+ // ============================================================================
115
+ /**
116
+ * Test whether an error matches at least one retryable predicate.
117
+ *
118
+ * @param err - The caught error.
119
+ * @param predicates - List of `RegExp` or predicate functions.
120
+ * @returns `true` if the error is retryable.
121
+ */
122
+ function isRetryable(err, predicates) {
123
+ const message = err instanceof Error ? err.message : String(err);
124
+ return predicates.some((predicate) => {
125
+ if (predicate instanceof RegExp)
126
+ return predicate.test(message);
127
+ return predicate(err);
128
+ });
129
+ }
130
+ /**
131
+ * Attach `RetryContext` fields to an error value in-place when possible.
132
+ * Falls back gracefully for non-Error thrown values.
133
+ *
134
+ * @param err - The value to augment.
135
+ * @param context - Retry metadata to attach.
136
+ */
137
+ function augmentError(err, context) {
138
+ if (err instanceof Error) {
139
+ const mutableErr = err;
140
+ mutableErr.attempts = context.attempts;
141
+ mutableErr.totalDelayMs = context.totalDelayMs;
142
+ }
143
+ }
144
+ /**
145
+ * Promisified `setTimeout` for testability.
146
+ *
147
+ * @param ms - Duration in milliseconds.
148
+ */
149
+ function sleep(ms) {
150
+ return new Promise((resolve) => setTimeout(resolve, ms));
151
+ }
152
+ //# sourceMappingURL=retry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/lib/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,OAAsB;IAC7E,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC;IACjD,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,CAAC;IAEjD,IAAI,SAAkB,CAAC;IACvB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAC;YAEhB,MAAM,aAAa,GAAG,OAAO,KAAK,WAAW,CAAC;YAC9C,IAAI,aAAa;gBAAE,MAAM;YAEzB,4DAA4D;YAC5D,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC;gBAAE,MAAM;YAE/E,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC7D,YAAY,IAAI,KAAK,CAAC;YACtB,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,OAAO,GAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;IACtE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB;IACnF,MAAM,WAAW,GAAG,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,GAAY,EAAE,UAA6C;IAC9E,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,IAAI,SAAS,YAAY,MAAM;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,GAAY,EAAE,OAAqB;IACvD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,GAAoC,CAAC;QACxD,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACvC,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Tree-sitter language detection and grammar resolution.
3
+ *
4
+ * Maps file extensions to tree-sitter grammar packages for use by
5
+ * the Smart Explore code analysis pipeline.
6
+ *
7
+ * @task T148
8
+ */
9
+ /** Supported tree-sitter language identifiers. */
10
+ export type TreeSitterLanguage = 'typescript' | 'tsx' | 'javascript' | 'python' | 'go' | 'rust' | 'java' | 'c' | 'cpp' | 'ruby';
11
+ /**
12
+ * Detect tree-sitter language from a file path.
13
+ *
14
+ * @param filePath - Path to a source file
15
+ * @returns The detected language, or undefined if unsupported
16
+ */
17
+ export declare function detectLanguage(filePath: string): TreeSitterLanguage | undefined;
18
+ /**
19
+ * Get the npm grammar package name for a language.
20
+ *
21
+ * @param language - A tree-sitter language identifier
22
+ * @returns The npm package name containing the grammar
23
+ */
24
+ export declare function grammarPackage(language: TreeSitterLanguage): string;
25
+ /** All supported file extensions. */
26
+ export declare const SUPPORTED_EXTENSIONS: string[];
27
+ /** All supported languages. */
28
+ export declare const SUPPORTED_LANGUAGES: TreeSitterLanguage[];
29
+ //# sourceMappingURL=tree-sitter-languages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree-sitter-languages.d.ts","sourceRoot":"","sources":["../../src/lib/tree-sitter-languages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,KAAK,GACL,YAAY,GACZ,QAAQ,GACR,IAAI,GACJ,MAAM,GACN,MAAM,GACN,GAAG,GACH,KAAK,GACL,MAAM,CAAC;AAyCX;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAI/E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAEnE;AAED,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,UAA6B,CAAC;AAE/D,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAA+C,CAAC"}