@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,519 @@
1
+ /**
2
+ * Full-text search across BRAIN memory using SQLite FTS5.
3
+ * Uses raw SQL via nativeDb because drizzle doesn't support FTS5 virtual tables.
4
+ *
5
+ * Falls back to LIKE queries if FTS5 is not available (some SQLite builds lack it).
6
+ *
7
+ * @task T5130
8
+ * @epic T5149
9
+ */
10
+ import { getBrainAccessor } from '../store/brain-accessor.js';
11
+ import { typedAll } from '../store/typed-query.js';
12
+ import { searchSimilar } from './brain-similarity.js';
13
+ /** Track whether FTS5 is available in the current SQLite build. */
14
+ let _fts5Available = null;
15
+ /** Track whether FTS tables have been created and indexed this session. */
16
+ let _fts5Initialized = false;
17
+ /**
18
+ * Check if FTS5 is available in the current SQLite build.
19
+ */
20
+ function checkFts5Available(nativeDb) {
21
+ if (_fts5Available !== null)
22
+ return _fts5Available;
23
+ try {
24
+ // Use run() to execute DDL statements
25
+ nativeDb.prepare('CREATE VIRTUAL TABLE IF NOT EXISTS _fts5_check USING fts5(test)').run();
26
+ nativeDb.prepare('DROP TABLE IF EXISTS _fts5_check').run();
27
+ _fts5Available = true;
28
+ }
29
+ catch {
30
+ _fts5Available = false;
31
+ }
32
+ return _fts5Available;
33
+ }
34
+ /**
35
+ * Execute a DDL statement using the native database.
36
+ * Wraps nativeDb.prepare().run() for consistent usage.
37
+ */
38
+ function execDDL(nativeDb, sql) {
39
+ nativeDb.prepare(sql).run();
40
+ }
41
+ /**
42
+ * Create FTS5 virtual tables and content-sync triggers if they don't exist.
43
+ *
44
+ * Uses content= to sync from main tables, so inserts to main tables
45
+ * auto-populate FTS. UPDATE/DELETE require triggers.
46
+ *
47
+ * @task T5130
48
+ */
49
+ export function ensureFts5Tables(nativeDb) {
50
+ if (!checkFts5Available(nativeDb)) {
51
+ return false;
52
+ }
53
+ // Decisions FTS
54
+ execDDL(nativeDb, `
55
+ CREATE VIRTUAL TABLE IF NOT EXISTS brain_decisions_fts
56
+ USING fts5(id, decision, rationale, content=brain_decisions, content_rowid=rowid)
57
+ `);
58
+ // Patterns FTS
59
+ execDDL(nativeDb, `
60
+ CREATE VIRTUAL TABLE IF NOT EXISTS brain_patterns_fts
61
+ USING fts5(id, pattern, context, content=brain_patterns, content_rowid=rowid)
62
+ `);
63
+ // Learnings FTS
64
+ execDDL(nativeDb, `
65
+ CREATE VIRTUAL TABLE IF NOT EXISTS brain_learnings_fts
66
+ USING fts5(id, insight, source, content=brain_learnings, content_rowid=rowid)
67
+ `);
68
+ // Content-sync triggers for decisions
69
+ execDDL(nativeDb, `
70
+ CREATE TRIGGER IF NOT EXISTS brain_decisions_ai AFTER INSERT ON brain_decisions BEGIN
71
+ INSERT INTO brain_decisions_fts(rowid, id, decision, rationale)
72
+ VALUES (new.rowid, new.id, new.decision, new.rationale);
73
+ END
74
+ `);
75
+ execDDL(nativeDb, `
76
+ CREATE TRIGGER IF NOT EXISTS brain_decisions_ad AFTER DELETE ON brain_decisions BEGIN
77
+ INSERT INTO brain_decisions_fts(brain_decisions_fts, rowid, id, decision, rationale)
78
+ VALUES('delete', old.rowid, old.id, old.decision, old.rationale);
79
+ END
80
+ `);
81
+ execDDL(nativeDb, `
82
+ CREATE TRIGGER IF NOT EXISTS brain_decisions_au AFTER UPDATE ON brain_decisions BEGIN
83
+ INSERT INTO brain_decisions_fts(brain_decisions_fts, rowid, id, decision, rationale)
84
+ VALUES('delete', old.rowid, old.id, old.decision, old.rationale);
85
+ INSERT INTO brain_decisions_fts(rowid, id, decision, rationale)
86
+ VALUES (new.rowid, new.id, new.decision, new.rationale);
87
+ END
88
+ `);
89
+ // Content-sync triggers for patterns
90
+ execDDL(nativeDb, `
91
+ CREATE TRIGGER IF NOT EXISTS brain_patterns_ai AFTER INSERT ON brain_patterns BEGIN
92
+ INSERT INTO brain_patterns_fts(rowid, id, pattern, context)
93
+ VALUES (new.rowid, new.id, new.pattern, new.context);
94
+ END
95
+ `);
96
+ execDDL(nativeDb, `
97
+ CREATE TRIGGER IF NOT EXISTS brain_patterns_ad AFTER DELETE ON brain_patterns BEGIN
98
+ INSERT INTO brain_patterns_fts(brain_patterns_fts, rowid, id, pattern, context)
99
+ VALUES('delete', old.rowid, old.id, old.pattern, old.context);
100
+ END
101
+ `);
102
+ execDDL(nativeDb, `
103
+ CREATE TRIGGER IF NOT EXISTS brain_patterns_au AFTER UPDATE ON brain_patterns BEGIN
104
+ INSERT INTO brain_patterns_fts(brain_patterns_fts, rowid, id, pattern, context)
105
+ VALUES('delete', old.rowid, old.id, old.pattern, old.context);
106
+ INSERT INTO brain_patterns_fts(rowid, id, pattern, context)
107
+ VALUES (new.rowid, new.id, new.pattern, new.context);
108
+ END
109
+ `);
110
+ // Content-sync triggers for learnings
111
+ execDDL(nativeDb, `
112
+ CREATE TRIGGER IF NOT EXISTS brain_learnings_ai AFTER INSERT ON brain_learnings BEGIN
113
+ INSERT INTO brain_learnings_fts(rowid, id, insight, source)
114
+ VALUES (new.rowid, new.id, new.insight, new.source);
115
+ END
116
+ `);
117
+ execDDL(nativeDb, `
118
+ CREATE TRIGGER IF NOT EXISTS brain_learnings_ad AFTER DELETE ON brain_learnings BEGIN
119
+ INSERT INTO brain_learnings_fts(brain_learnings_fts, rowid, id, insight, source)
120
+ VALUES('delete', old.rowid, old.id, old.insight, old.source);
121
+ END
122
+ `);
123
+ execDDL(nativeDb, `
124
+ CREATE TRIGGER IF NOT EXISTS brain_learnings_au AFTER UPDATE ON brain_learnings BEGIN
125
+ INSERT INTO brain_learnings_fts(brain_learnings_fts, rowid, id, insight, source)
126
+ VALUES('delete', old.rowid, old.id, old.insight, old.source);
127
+ INSERT INTO brain_learnings_fts(rowid, id, insight, source)
128
+ VALUES (new.rowid, new.id, new.insight, new.source);
129
+ END
130
+ `);
131
+ // Observations FTS
132
+ execDDL(nativeDb, `
133
+ CREATE VIRTUAL TABLE IF NOT EXISTS brain_observations_fts
134
+ USING fts5(id, title, narrative, content=brain_observations, content_rowid=rowid)
135
+ `);
136
+ // Content-sync triggers for observations
137
+ execDDL(nativeDb, `
138
+ CREATE TRIGGER IF NOT EXISTS brain_observations_ai AFTER INSERT ON brain_observations BEGIN
139
+ INSERT INTO brain_observations_fts(rowid, id, title, narrative)
140
+ VALUES (new.rowid, new.id, new.title, new.narrative);
141
+ END
142
+ `);
143
+ execDDL(nativeDb, `
144
+ CREATE TRIGGER IF NOT EXISTS brain_observations_ad AFTER DELETE ON brain_observations BEGIN
145
+ INSERT INTO brain_observations_fts(brain_observations_fts, rowid, id, title, narrative)
146
+ VALUES('delete', old.rowid, old.id, old.title, old.narrative);
147
+ END
148
+ `);
149
+ execDDL(nativeDb, `
150
+ CREATE TRIGGER IF NOT EXISTS brain_observations_au AFTER UPDATE ON brain_observations BEGIN
151
+ INSERT INTO brain_observations_fts(brain_observations_fts, rowid, id, title, narrative)
152
+ VALUES('delete', old.rowid, old.id, old.title, old.narrative);
153
+ INSERT INTO brain_observations_fts(rowid, id, title, narrative)
154
+ VALUES (new.rowid, new.id, new.title, new.narrative);
155
+ END
156
+ `);
157
+ return true;
158
+ }
159
+ /**
160
+ * Rebuild FTS5 indexes from the content tables.
161
+ * Useful after bulk inserts that bypass triggers.
162
+ *
163
+ * @task T5130
164
+ */
165
+ export function rebuildFts5Index(nativeDb) {
166
+ if (!checkFts5Available(nativeDb)) {
167
+ return;
168
+ }
169
+ nativeDb.prepare("INSERT INTO brain_decisions_fts(brain_decisions_fts) VALUES('rebuild')").run();
170
+ nativeDb.prepare("INSERT INTO brain_patterns_fts(brain_patterns_fts) VALUES('rebuild')").run();
171
+ nativeDb.prepare("INSERT INTO brain_learnings_fts(brain_learnings_fts) VALUES('rebuild')").run();
172
+ // Observations FTS rebuild — table may not exist yet in older DBs
173
+ try {
174
+ nativeDb
175
+ .prepare("INSERT INTO brain_observations_fts(brain_observations_fts) VALUES('rebuild')")
176
+ .run();
177
+ }
178
+ catch {
179
+ // brain_observations_fts not created yet — skip
180
+ }
181
+ }
182
+ /**
183
+ * Unified search across all BRAIN memory tables.
184
+ *
185
+ * Uses FTS5 MATCH for full-text search with BM25 ranking when available,
186
+ * falls back to LIKE queries otherwise.
187
+ *
188
+ * @task T5130
189
+ */
190
+ export async function searchBrain(projectRoot, query, options) {
191
+ if (!query || !query.trim()) {
192
+ return { decisions: [], patterns: [], learnings: [], observations: [] };
193
+ }
194
+ // Ensure brain.db is initialized
195
+ const { getBrainDb, getBrainNativeDb } = await import('../store/brain-sqlite.js');
196
+ await getBrainDb(projectRoot);
197
+ const nativeDb = getBrainNativeDb();
198
+ if (!nativeDb) {
199
+ return { decisions: [], patterns: [], learnings: [], observations: [] };
200
+ }
201
+ const limit = options?.limit ?? 10;
202
+ const tables = options?.tables ?? ['decisions', 'patterns', 'learnings', 'observations'];
203
+ const ftsAvailable = ensureFts5Tables(nativeDb);
204
+ if (ftsAvailable) {
205
+ // On first initialization, rebuild FTS indexes to sync any data
206
+ // that was inserted before the FTS triggers existed.
207
+ if (!_fts5Initialized) {
208
+ _fts5Initialized = true;
209
+ rebuildFts5Index(nativeDb);
210
+ }
211
+ return searchWithFts5(nativeDb, query, tables, limit);
212
+ }
213
+ return searchWithLike(nativeDb, query, tables, limit);
214
+ }
215
+ /**
216
+ * Search using FTS5 MATCH with BM25 ranking.
217
+ */
218
+ function searchWithFts5(nativeDb, query, tables, limit) {
219
+ const result = {
220
+ decisions: [],
221
+ patterns: [],
222
+ learnings: [],
223
+ observations: [],
224
+ };
225
+ // Escape FTS5 special characters for safety
226
+ const safeQuery = escapeFts5Query(query);
227
+ if (tables.includes('decisions')) {
228
+ try {
229
+ const rows = typedAll(nativeDb.prepare(`
230
+ SELECT d.*
231
+ FROM brain_decisions_fts fts
232
+ JOIN brain_decisions d ON d.rowid = fts.rowid
233
+ WHERE brain_decisions_fts MATCH ?
234
+ ORDER BY bm25(brain_decisions_fts)
235
+ LIMIT ?
236
+ `), safeQuery, limit);
237
+ result.decisions = rows;
238
+ }
239
+ catch {
240
+ // FTS query failed, fall back to LIKE for this table
241
+ result.decisions = likeSearchDecisions(nativeDb, query, limit);
242
+ }
243
+ }
244
+ if (tables.includes('patterns')) {
245
+ try {
246
+ const rows = typedAll(nativeDb.prepare(`
247
+ SELECT p.*
248
+ FROM brain_patterns_fts fts
249
+ JOIN brain_patterns p ON p.rowid = fts.rowid
250
+ WHERE brain_patterns_fts MATCH ?
251
+ ORDER BY bm25(brain_patterns_fts)
252
+ LIMIT ?
253
+ `), safeQuery, limit);
254
+ result.patterns = rows;
255
+ }
256
+ catch {
257
+ result.patterns = likeSearchPatterns(nativeDb, query, limit);
258
+ }
259
+ }
260
+ if (tables.includes('learnings')) {
261
+ try {
262
+ const rows = typedAll(nativeDb.prepare(`
263
+ SELECT l.*
264
+ FROM brain_learnings_fts fts
265
+ JOIN brain_learnings l ON l.rowid = fts.rowid
266
+ WHERE brain_learnings_fts MATCH ?
267
+ ORDER BY bm25(brain_learnings_fts)
268
+ LIMIT ?
269
+ `), safeQuery, limit);
270
+ result.learnings = rows;
271
+ }
272
+ catch {
273
+ result.learnings = likeSearchLearnings(nativeDb, query, limit);
274
+ }
275
+ }
276
+ if (tables.includes('observations')) {
277
+ try {
278
+ const rows = typedAll(nativeDb.prepare(`
279
+ SELECT o.*
280
+ FROM brain_observations_fts fts
281
+ JOIN brain_observations o ON o.rowid = fts.rowid
282
+ WHERE brain_observations_fts MATCH ?
283
+ ORDER BY bm25(brain_observations_fts)
284
+ LIMIT ?
285
+ `), safeQuery, limit);
286
+ result.observations = rows;
287
+ }
288
+ catch {
289
+ result.observations = likeSearchObservations(nativeDb, query, limit);
290
+ }
291
+ }
292
+ return result;
293
+ }
294
+ /**
295
+ * Search using LIKE queries as fallback when FTS5 is unavailable.
296
+ */
297
+ function searchWithLike(nativeDb, query, tables, limit) {
298
+ const result = {
299
+ decisions: [],
300
+ patterns: [],
301
+ learnings: [],
302
+ observations: [],
303
+ };
304
+ if (tables.includes('decisions')) {
305
+ result.decisions = likeSearchDecisions(nativeDb, query, limit);
306
+ }
307
+ if (tables.includes('patterns')) {
308
+ result.patterns = likeSearchPatterns(nativeDb, query, limit);
309
+ }
310
+ if (tables.includes('learnings')) {
311
+ result.learnings = likeSearchLearnings(nativeDb, query, limit);
312
+ }
313
+ if (tables.includes('observations')) {
314
+ result.observations = likeSearchObservations(nativeDb, query, limit);
315
+ }
316
+ return result;
317
+ }
318
+ function likeSearchDecisions(nativeDb, query, limit) {
319
+ const likePattern = `%${query}%`;
320
+ return typedAll(nativeDb.prepare(`
321
+ SELECT * FROM brain_decisions
322
+ WHERE decision LIKE ? OR rationale LIKE ?
323
+ ORDER BY created_at DESC
324
+ LIMIT ?
325
+ `), likePattern, likePattern, limit);
326
+ }
327
+ function likeSearchPatterns(nativeDb, query, limit) {
328
+ const likePattern = `%${query}%`;
329
+ return typedAll(nativeDb.prepare(`
330
+ SELECT * FROM brain_patterns
331
+ WHERE pattern LIKE ? OR context LIKE ?
332
+ ORDER BY frequency DESC
333
+ LIMIT ?
334
+ `), likePattern, likePattern, limit);
335
+ }
336
+ function likeSearchLearnings(nativeDb, query, limit) {
337
+ const likePattern = `%${query}%`;
338
+ return typedAll(nativeDb.prepare(`
339
+ SELECT * FROM brain_learnings
340
+ WHERE insight LIKE ? OR source LIKE ?
341
+ ORDER BY confidence DESC
342
+ LIMIT ?
343
+ `), likePattern, likePattern, limit);
344
+ }
345
+ function likeSearchObservations(nativeDb, query, limit) {
346
+ const likePattern = `%${query}%`;
347
+ return typedAll(nativeDb.prepare(`
348
+ SELECT * FROM brain_observations
349
+ WHERE title LIKE ? OR narrative LIKE ?
350
+ ORDER BY created_at DESC
351
+ LIMIT ?
352
+ `), likePattern, likePattern, limit);
353
+ }
354
+ /**
355
+ * Escape special FTS5 characters in query string.
356
+ * Wraps each token in quotes to prevent syntax errors from special chars.
357
+ */
358
+ function escapeFts5Query(query) {
359
+ // Split on whitespace, wrap each token in double quotes
360
+ const tokens = query.trim().split(/\s+/).filter(Boolean);
361
+ if (tokens.length === 0)
362
+ return '""';
363
+ return tokens.map((t) => `"${t.replace(/"/g, '""')}"`).join(' ');
364
+ }
365
+ /**
366
+ * Reset the cached FTS5 availability flag.
367
+ * Used in tests to force re-detection.
368
+ */
369
+ export function resetFts5Cache() {
370
+ _fts5Available = null;
371
+ _fts5Initialized = false;
372
+ }
373
+ /**
374
+ * Hybrid search across FTS5, vector similarity, and graph neighbors.
375
+ *
376
+ * 1. Runs FTS5 search via existing searchBrain.
377
+ * 2. Runs vector similarity via searchSimilar (if available).
378
+ * 3. Runs graph neighbor expansion via getNeighbors (if query matches a node).
379
+ * 4. Normalizes scores to 0-1 using min-max normalization.
380
+ * 5. Combines with configurable weights.
381
+ * 6. Deduplicates by ID, keeping highest combined score.
382
+ * 7. Returns top-N sorted by score descending.
383
+ *
384
+ * Graceful fallback: if vec unavailable, redistributes weight to FTS5.
385
+ *
386
+ * @param query - Search query text
387
+ * @param projectRoot - Project root directory
388
+ * @param options - Weight and limit configuration
389
+ * @returns Array of hybrid results ranked by combined score
390
+ */
391
+ export async function hybridSearch(query, projectRoot, options) {
392
+ if (!query || !query.trim())
393
+ return [];
394
+ const maxResults = options?.limit ?? 10;
395
+ let ftsWeight = options?.ftsWeight ?? 0.5;
396
+ let vecWeight = options?.vecWeight ?? 0.4;
397
+ const graphWeight = options?.graphWeight ?? 0.1;
398
+ // Score accumulators: id -> { score, sources, type, title, text }
399
+ const scoreMap = new Map();
400
+ const addScore = (id, normalizedScore, weight, source, type, title, text) => {
401
+ const existing = scoreMap.get(id);
402
+ if (existing) {
403
+ existing.score += normalizedScore * weight;
404
+ existing.sources.add(source);
405
+ }
406
+ else {
407
+ scoreMap.set(id, {
408
+ score: normalizedScore * weight,
409
+ type,
410
+ title,
411
+ text,
412
+ sources: new Set([source]),
413
+ });
414
+ }
415
+ };
416
+ // --- 1. FTS5 search ---
417
+ const ftsResults = await searchBrain(projectRoot, query, { limit: maxResults * 2 });
418
+ // Collect all FTS hits into a flat list with position-based scores
419
+ const ftsHits = [];
420
+ for (const d of ftsResults.decisions) {
421
+ ftsHits.push({
422
+ id: d.id,
423
+ type: 'decision',
424
+ title: d.decision,
425
+ text: `${d.decision} — ${d.rationale}`,
426
+ });
427
+ }
428
+ for (const p of ftsResults.patterns) {
429
+ ftsHits.push({
430
+ id: p.id,
431
+ type: 'pattern',
432
+ title: p.pattern,
433
+ text: `${p.pattern} — ${p.context}`,
434
+ });
435
+ }
436
+ for (const l of ftsResults.learnings) {
437
+ ftsHits.push({
438
+ id: l.id,
439
+ type: 'learning',
440
+ title: l.insight,
441
+ text: `${l.insight} (source: ${l.source})`,
442
+ });
443
+ }
444
+ for (const o of ftsResults.observations) {
445
+ ftsHits.push({ id: o.id, type: 'observation', title: o.title, text: o.narrative ?? o.title });
446
+ }
447
+ // Normalize FTS: position-based (first result = 1.0, last = near 0)
448
+ for (let i = 0; i < ftsHits.length; i++) {
449
+ const hit = ftsHits[i];
450
+ const normalizedScore = ftsHits.length > 1 ? 1.0 - i / (ftsHits.length - 1) : 1.0;
451
+ addScore(hit.id, normalizedScore, ftsWeight, 'fts', hit.type, hit.title, hit.text);
452
+ }
453
+ // --- 2. Vector similarity search ---
454
+ let vecResults = [];
455
+ try {
456
+ vecResults = await searchSimilar(query, projectRoot, maxResults * 2);
457
+ }
458
+ catch {
459
+ // Vector search unavailable
460
+ }
461
+ if (vecResults.length > 0) {
462
+ // Normalize vector: distance-based (smaller distance = higher score)
463
+ const maxDist = Math.max(...vecResults.map((r) => r.distance), 0.001);
464
+ for (const r of vecResults) {
465
+ const normalizedScore = 1.0 - r.distance / maxDist;
466
+ addScore(r.id, normalizedScore, vecWeight, 'vec', r.type, r.title, r.text);
467
+ }
468
+ }
469
+ else {
470
+ // Redistribute vec weight to FTS if vector unavailable
471
+ ftsWeight += vecWeight;
472
+ vecWeight = 0;
473
+ // Re-score FTS hits with updated weight
474
+ scoreMap.clear();
475
+ for (let i = 0; i < ftsHits.length; i++) {
476
+ const hit = ftsHits[i];
477
+ const normalizedScore = ftsHits.length > 1 ? 1.0 - i / (ftsHits.length - 1) : 1.0;
478
+ addScore(hit.id, normalizedScore, ftsWeight, 'fts', hit.type, hit.title, hit.text);
479
+ }
480
+ }
481
+ // --- 3. Graph neighbor expansion ---
482
+ try {
483
+ const accessor = await getBrainAccessor(projectRoot);
484
+ // Check if query matches a known graph node ID pattern
485
+ const possibleNodeIds = [
486
+ `concept:${query.toLowerCase().replace(/\s+/g, '-')}`,
487
+ `task:${query}`,
488
+ `doc:${query}`,
489
+ ];
490
+ for (const nodeId of possibleNodeIds) {
491
+ const node = await accessor.getPageNode(nodeId);
492
+ if (!node)
493
+ continue;
494
+ const neighbors = await accessor.getNeighbors(nodeId);
495
+ for (let i = 0; i < neighbors.length; i++) {
496
+ const neighbor = neighbors[i];
497
+ const normalizedScore = neighbors.length > 1 ? 1.0 - i / (neighbors.length - 1) : 1.0;
498
+ addScore(neighbor.id, normalizedScore, graphWeight, 'graph', neighbor.nodeType, neighbor.label, neighbor.label);
499
+ }
500
+ }
501
+ }
502
+ catch {
503
+ // Graph search unavailable — no redistribution needed (small weight)
504
+ }
505
+ // --- 4. Sort and return top-N ---
506
+ const sorted = [...scoreMap.entries()]
507
+ .map(([id, data]) => ({
508
+ id,
509
+ score: data.score,
510
+ type: data.type,
511
+ title: data.title,
512
+ text: data.text,
513
+ sources: [...data.sources],
514
+ }))
515
+ .sort((a, b) => b.score - a.score)
516
+ .slice(0, maxResults);
517
+ return sorted;
518
+ }
519
+ //# sourceMappingURL=brain-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brain-search.js","sourceRoot":"","sources":["../../src/memory/brain-search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,145 @@
1
+ /**
2
+ * BRAIN Vector Similarity Search
3
+ *
4
+ * Provides vector-based KNN search against brain_embeddings vec0 table.
5
+ * Falls back gracefully when no embedding provider is registered or
6
+ * sqlite-vec is unavailable.
7
+ *
8
+ * @task T5388
9
+ * @epic T5149
10
+ */
11
+ import { getBrainAccessor } from '../store/brain-accessor.js';
12
+ import { typedAll } from '../store/typed-query.js';
13
+ import { embedText, isEmbeddingAvailable } from './brain-embedding.js';
14
+ // ============================================================================
15
+ // ID prefix -> table type
16
+ // ============================================================================
17
+ function parseIdPrefix(id) {
18
+ if (id.startsWith('D-') || /^D\d/.test(id))
19
+ return 'decision';
20
+ if (id.startsWith('P-') || /^P\d/.test(id))
21
+ return 'pattern';
22
+ if (id.startsWith('L-') || /^L\d/.test(id))
23
+ return 'learning';
24
+ if (id.startsWith('O-') || id.startsWith('O') || id.startsWith('CM-'))
25
+ return 'observation';
26
+ return null;
27
+ }
28
+ // ============================================================================
29
+ // Implementation
30
+ // ============================================================================
31
+ /**
32
+ * Search for entries similar to a query string using vector similarity.
33
+ *
34
+ * 1. Embeds the query text via the registered embedding provider.
35
+ * 2. Runs KNN query against brain_embeddings vec0 table.
36
+ * 3. Joins with observation/decision/pattern/learning tables for full entries.
37
+ *
38
+ * Returns empty array when embedding is unavailable (graceful fallback).
39
+ *
40
+ * @param query - Text to find similar entries for
41
+ * @param projectRoot - Project root directory
42
+ * @param limit - Maximum results to return (default 10)
43
+ * @returns Array of similar entries ranked by distance (ascending)
44
+ */
45
+ export async function searchSimilar(query, projectRoot, limit) {
46
+ if (!query || !query.trim())
47
+ return [];
48
+ if (!isEmbeddingAvailable())
49
+ return [];
50
+ const maxResults = limit ?? 10;
51
+ // Embed the query text
52
+ const queryVector = await embedText(query);
53
+ if (!queryVector)
54
+ return [];
55
+ // Ensure brain.db is initialized
56
+ const { getBrainDb, getBrainNativeDb, isBrainVecLoaded } = await import('../store/brain-sqlite.js');
57
+ await getBrainDb(projectRoot);
58
+ const nativeDb = getBrainNativeDb();
59
+ if (!nativeDb)
60
+ return [];
61
+ // Require sqlite-vec for KNN queries
62
+ if (!isBrainVecLoaded())
63
+ return [];
64
+ // Run KNN query against vec0 table
65
+ let knnRows;
66
+ try {
67
+ const stmt = nativeDb.prepare('SELECT id, distance FROM brain_embeddings WHERE embedding MATCH ? ORDER BY distance LIMIT ?');
68
+ knnRows = typedAll(stmt, new Float32Array(queryVector.buffer, queryVector.byteOffset, queryVector.length), maxResults);
69
+ }
70
+ catch {
71
+ // vec0 query failed — table may not exist or extension not loaded
72
+ return [];
73
+ }
74
+ if (knnRows.length === 0)
75
+ return [];
76
+ // Resolve each ID to its full entry
77
+ const accessor = await getBrainAccessor(projectRoot);
78
+ const results = [];
79
+ for (const row of knnRows) {
80
+ const entryType = parseIdPrefix(row.id);
81
+ if (!entryType)
82
+ continue;
83
+ try {
84
+ switch (entryType) {
85
+ case 'observation': {
86
+ const entry = await accessor.getObservation(row.id);
87
+ if (entry) {
88
+ results.push({
89
+ id: row.id,
90
+ distance: row.distance,
91
+ type: 'observation',
92
+ title: entry.title,
93
+ text: entry.narrative ?? entry.title,
94
+ });
95
+ }
96
+ break;
97
+ }
98
+ case 'decision': {
99
+ const entry = await accessor.getDecision(row.id);
100
+ if (entry) {
101
+ results.push({
102
+ id: row.id,
103
+ distance: row.distance,
104
+ type: 'decision',
105
+ title: entry.decision,
106
+ text: `${entry.decision} — ${entry.rationale}`,
107
+ });
108
+ }
109
+ break;
110
+ }
111
+ case 'pattern': {
112
+ const entry = await accessor.getPattern(row.id);
113
+ if (entry) {
114
+ results.push({
115
+ id: row.id,
116
+ distance: row.distance,
117
+ type: 'pattern',
118
+ title: entry.pattern,
119
+ text: `${entry.pattern} — ${entry.context}`,
120
+ });
121
+ }
122
+ break;
123
+ }
124
+ case 'learning': {
125
+ const entry = await accessor.getLearning(row.id);
126
+ if (entry) {
127
+ results.push({
128
+ id: row.id,
129
+ distance: row.distance,
130
+ type: 'learning',
131
+ title: entry.insight,
132
+ text: `${entry.insight} (source: ${entry.source})`,
133
+ });
134
+ }
135
+ break;
136
+ }
137
+ }
138
+ }
139
+ catch {
140
+ // Skip entries that fail to resolve
141
+ }
142
+ }
143
+ return results;
144
+ }
145
+ //# sourceMappingURL=brain-similarity.js.map