@astragenie/astramemory-local 0.7.2

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 (493) hide show
  1. package/CHANGELOG.md +341 -0
  2. package/README.md +419 -0
  3. package/dist/backup/retention.d.ts +15 -0
  4. package/dist/backup/retention.js +62 -0
  5. package/dist/backup/retention.js.map +1 -0
  6. package/dist/backup/snapshot.d.ts +21 -0
  7. package/dist/backup/snapshot.js +55 -0
  8. package/dist/backup/snapshot.js.map +1 -0
  9. package/dist/backup/verify.d.ts +23 -0
  10. package/dist/backup/verify.js +77 -0
  11. package/dist/backup/verify.js.map +1 -0
  12. package/dist/budget/tracker.d.ts +58 -0
  13. package/dist/budget/tracker.js +102 -0
  14. package/dist/budget/tracker.js.map +1 -0
  15. package/dist/capture/codex.d.ts +63 -0
  16. package/dist/capture/codex.js +0 -0
  17. package/dist/capture/codex.js.map +1 -0
  18. package/dist/cli/backup.d.ts +1 -0
  19. package/dist/cli/backup.js +112 -0
  20. package/dist/cli/backup.js.map +1 -0
  21. package/dist/cli/budget.d.ts +7 -0
  22. package/dist/cli/budget.js +44 -0
  23. package/dist/cli/budget.js.map +1 -0
  24. package/dist/cli/capture.d.ts +10 -0
  25. package/dist/cli/capture.js +113 -0
  26. package/dist/cli/capture.js.map +1 -0
  27. package/dist/cli/consolidate.d.ts +16 -0
  28. package/dist/cli/consolidate.js +146 -0
  29. package/dist/cli/consolidate.js.map +1 -0
  30. package/dist/cli/doctor.d.ts +1 -0
  31. package/dist/cli/doctor.js +54 -0
  32. package/dist/cli/doctor.js.map +1 -0
  33. package/dist/cli/entity-backfill.d.ts +10 -0
  34. package/dist/cli/entity-backfill.js +46 -0
  35. package/dist/cli/entity-backfill.js.map +1 -0
  36. package/dist/cli/hook-install.d.ts +45 -0
  37. package/dist/cli/hook-install.js +77 -0
  38. package/dist/cli/hook-install.js.map +1 -0
  39. package/dist/cli/index.d.ts +2 -0
  40. package/dist/cli/index.js +312 -0
  41. package/dist/cli/index.js.map +1 -0
  42. package/dist/cli/init.d.ts +16 -0
  43. package/dist/cli/init.js +431 -0
  44. package/dist/cli/init.js.map +1 -0
  45. package/dist/cli/mcp-stdio.d.ts +18 -0
  46. package/dist/cli/mcp-stdio.js +67 -0
  47. package/dist/cli/mcp-stdio.js.map +1 -0
  48. package/dist/cli/memory.d.ts +15 -0
  49. package/dist/cli/memory.js +52 -0
  50. package/dist/cli/memory.js.map +1 -0
  51. package/dist/cli/open-runtime-db.d.ts +15 -0
  52. package/dist/cli/open-runtime-db.js +37 -0
  53. package/dist/cli/open-runtime-db.js.map +1 -0
  54. package/dist/cli/pair.d.ts +29 -0
  55. package/dist/cli/pair.js +64 -0
  56. package/dist/cli/pair.js.map +1 -0
  57. package/dist/cli/providers.d.ts +10 -0
  58. package/dist/cli/providers.js +97 -0
  59. package/dist/cli/providers.js.map +1 -0
  60. package/dist/cli/queue-purge.d.ts +5 -0
  61. package/dist/cli/queue-purge.js +92 -0
  62. package/dist/cli/queue-purge.js.map +1 -0
  63. package/dist/cli/queue.d.ts +29 -0
  64. package/dist/cli/queue.js +73 -0
  65. package/dist/cli/queue.js.map +1 -0
  66. package/dist/cli/rebuild.d.ts +15 -0
  67. package/dist/cli/rebuild.js +70 -0
  68. package/dist/cli/rebuild.js.map +1 -0
  69. package/dist/cli/reembed-dim.d.ts +21 -0
  70. package/dist/cli/reembed-dim.js +199 -0
  71. package/dist/cli/reembed-dim.js.map +1 -0
  72. package/dist/cli/reinstall.d.ts +1 -0
  73. package/dist/cli/reinstall.js +205 -0
  74. package/dist/cli/reinstall.js.map +1 -0
  75. package/dist/cli/restore.d.ts +1 -0
  76. package/dist/cli/restore.js +167 -0
  77. package/dist/cli/restore.js.map +1 -0
  78. package/dist/cli/retag.d.ts +14 -0
  79. package/dist/cli/retag.js +62 -0
  80. package/dist/cli/retag.js.map +1 -0
  81. package/dist/cli/search.d.ts +66 -0
  82. package/dist/cli/search.js +174 -0
  83. package/dist/cli/search.js.map +1 -0
  84. package/dist/cli/serve.d.ts +9 -0
  85. package/dist/cli/serve.js +364 -0
  86. package/dist/cli/serve.js.map +1 -0
  87. package/dist/cli/service.d.ts +1 -0
  88. package/dist/cli/service.js +121 -0
  89. package/dist/cli/service.js.map +1 -0
  90. package/dist/cli/sync.d.ts +15 -0
  91. package/dist/cli/sync.js +61 -0
  92. package/dist/cli/sync.js.map +1 -0
  93. package/dist/cli/token.d.ts +24 -0
  94. package/dist/cli/token.js +77 -0
  95. package/dist/cli/token.js.map +1 -0
  96. package/dist/cli/wait-health.d.ts +4 -0
  97. package/dist/cli/wait-health.js +23 -0
  98. package/dist/cli/wait-health.js.map +1 -0
  99. package/dist/config/config.d.ts +127 -0
  100. package/dist/config/config.js +38 -0
  101. package/dist/config/config.js.map +1 -0
  102. package/dist/config/datadir.d.ts +30 -0
  103. package/dist/config/datadir.js +65 -0
  104. package/dist/config/datadir.js.map +1 -0
  105. package/dist/config/loader.d.ts +23 -0
  106. package/dist/config/loader.js +102 -0
  107. package/dist/config/loader.js.map +1 -0
  108. package/dist/config/migrate-dirs.d.ts +36 -0
  109. package/dist/config/migrate-dirs.js +132 -0
  110. package/dist/config/migrate-dirs.js.map +1 -0
  111. package/dist/config/persist-envs.d.ts +23 -0
  112. package/dist/config/persist-envs.js +119 -0
  113. package/dist/config/persist-envs.js.map +1 -0
  114. package/dist/config/resolve-runtime.d.ts +19 -0
  115. package/dist/config/resolve-runtime.js +53 -0
  116. package/dist/config/resolve-runtime.js.map +1 -0
  117. package/dist/config/secrets.d.ts +28 -0
  118. package/dist/config/secrets.js +38 -0
  119. package/dist/config/secrets.js.map +1 -0
  120. package/dist/config/sync-settings.d.ts +16 -0
  121. package/dist/config/sync-settings.js +34 -0
  122. package/dist/config/sync-settings.js.map +1 -0
  123. package/dist/config/writer.d.ts +19 -0
  124. package/dist/config/writer.js +121 -0
  125. package/dist/config/writer.js.map +1 -0
  126. package/dist/consolidate/consolidate.d.ts +80 -0
  127. package/dist/consolidate/consolidate.js +0 -0
  128. package/dist/consolidate/consolidate.js.map +1 -0
  129. package/dist/consolidate/proposals.d.ts +35 -0
  130. package/dist/consolidate/proposals.js +66 -0
  131. package/dist/consolidate/proposals.js.map +1 -0
  132. package/dist/contracts/atom-wire.d.ts +48 -0
  133. package/dist/contracts/atom-wire.js +55 -0
  134. package/dist/contracts/atom-wire.js.map +1 -0
  135. package/dist/contracts/embed.d.ts +41 -0
  136. package/dist/contracts/embed.js +20 -0
  137. package/dist/contracts/embed.js.map +1 -0
  138. package/dist/contracts/index.d.ts +5 -0
  139. package/dist/contracts/index.js +6 -0
  140. package/dist/contracts/index.js.map +1 -0
  141. package/dist/contracts/job.d.ts +113 -0
  142. package/dist/contracts/job.js +32 -0
  143. package/dist/contracts/job.js.map +1 -0
  144. package/dist/contracts/llm.d.ts +30 -0
  145. package/dist/contracts/llm.js +2 -0
  146. package/dist/contracts/llm.js.map +1 -0
  147. package/dist/contracts/memory.d.ts +47 -0
  148. package/dist/contracts/memory.js +5 -0
  149. package/dist/contracts/memory.js.map +1 -0
  150. package/dist/contracts/vector.d.ts +29 -0
  151. package/dist/contracts/vector.js +2 -0
  152. package/dist/contracts/vector.js.map +1 -0
  153. package/dist/distill/flatten-turns.d.ts +1 -0
  154. package/dist/distill/flatten-turns.js +50 -0
  155. package/dist/distill/flatten-turns.js.map +1 -0
  156. package/dist/distill/pipeline.d.ts +45 -0
  157. package/dist/distill/pipeline.js +113 -0
  158. package/dist/distill/pipeline.js.map +1 -0
  159. package/dist/distill/prompts/extract.d.ts +122 -0
  160. package/dist/distill/prompts/extract.js +67 -0
  161. package/dist/distill/prompts/extract.js.map +1 -0
  162. package/dist/distill/stages/01-cleanup.d.ts +9 -0
  163. package/dist/distill/stages/01-cleanup.js +67 -0
  164. package/dist/distill/stages/01-cleanup.js.map +1 -0
  165. package/dist/distill/stages/02-normalize.d.ts +9 -0
  166. package/dist/distill/stages/02-normalize.js +76 -0
  167. package/dist/distill/stages/02-normalize.js.map +1 -0
  168. package/dist/distill/stages/03-chunk.d.ts +22 -0
  169. package/dist/distill/stages/03-chunk.js +138 -0
  170. package/dist/distill/stages/03-chunk.js.map +1 -0
  171. package/dist/distill/stages/04-compact.d.ts +28 -0
  172. package/dist/distill/stages/04-compact.js +69 -0
  173. package/dist/distill/stages/04-compact.js.map +1 -0
  174. package/dist/distill/stages/05-extract.d.ts +35 -0
  175. package/dist/distill/stages/05-extract.js +101 -0
  176. package/dist/distill/stages/05-extract.js.map +1 -0
  177. package/dist/distill/stages/06-reduce.d.ts +16 -0
  178. package/dist/distill/stages/06-reduce.js +30 -0
  179. package/dist/distill/stages/06-reduce.js.map +1 -0
  180. package/dist/distill/stages/07-memory-normalize.d.ts +27 -0
  181. package/dist/distill/stages/07-memory-normalize.js +65 -0
  182. package/dist/distill/stages/07-memory-normalize.js.map +1 -0
  183. package/dist/distill/stages/08-embed-index.d.ts +31 -0
  184. package/dist/distill/stages/08-embed-index.js +82 -0
  185. package/dist/distill/stages/08-embed-index.js.map +1 -0
  186. package/dist/doctor/checks.d.ts +77 -0
  187. package/dist/doctor/checks.js +626 -0
  188. package/dist/doctor/checks.js.map +1 -0
  189. package/dist/doctor/hardening-checks.d.ts +9 -0
  190. package/dist/doctor/hardening-checks.js +182 -0
  191. package/dist/doctor/hardening-checks.js.map +1 -0
  192. package/dist/doctor/probes/embed-probe.d.ts +19 -0
  193. package/dist/doctor/probes/embed-probe.js +47 -0
  194. package/dist/doctor/probes/embed-probe.js.map +1 -0
  195. package/dist/doctor/probes/llm-chat-probe.d.ts +11 -0
  196. package/dist/doctor/probes/llm-chat-probe.js +41 -0
  197. package/dist/doctor/probes/llm-chat-probe.js.map +1 -0
  198. package/dist/doctor/probes/plugin-coexistence.d.ts +14 -0
  199. package/dist/doctor/probes/plugin-coexistence.js +60 -0
  200. package/dist/doctor/probes/plugin-coexistence.js.map +1 -0
  201. package/dist/doctor/runner.d.ts +17 -0
  202. package/dist/doctor/runner.js +53 -0
  203. package/dist/doctor/runner.js.map +1 -0
  204. package/dist/doctor/types.d.ts +12 -0
  205. package/dist/doctor/types.js +2 -0
  206. package/dist/doctor/types.js.map +1 -0
  207. package/dist/entity/backfill.d.ts +30 -0
  208. package/dist/entity/backfill.js +55 -0
  209. package/dist/entity/backfill.js.map +1 -0
  210. package/dist/entity/extract-entities.d.ts +27 -0
  211. package/dist/entity/extract-entities.js +86 -0
  212. package/dist/entity/extract-entities.js.map +1 -0
  213. package/dist/entity/normalize.d.ts +17 -0
  214. package/dist/entity/normalize.js +20 -0
  215. package/dist/entity/normalize.js.map +1 -0
  216. package/dist/eval/harness.d.ts +96 -0
  217. package/dist/eval/harness.js +119 -0
  218. package/dist/eval/harness.js.map +1 -0
  219. package/dist/eval/metrics.d.ts +23 -0
  220. package/dist/eval/metrics.js +44 -0
  221. package/dist/eval/metrics.js.map +1 -0
  222. package/dist/log/correlation.d.ts +24 -0
  223. package/dist/log/correlation.js +33 -0
  224. package/dist/log/correlation.js.map +1 -0
  225. package/dist/log/logger.d.ts +38 -0
  226. package/dist/log/logger.js +129 -0
  227. package/dist/log/logger.js.map +1 -0
  228. package/dist/log/scrub.d.ts +33 -0
  229. package/dist/log/scrub.js +91 -0
  230. package/dist/log/scrub.js.map +1 -0
  231. package/dist/mcp/server.d.ts +36 -0
  232. package/dist/mcp/server.js +553 -0
  233. package/dist/mcp/server.js.map +1 -0
  234. package/dist/memory-tool/adapter.d.ts +73 -0
  235. package/dist/memory-tool/adapter.js +269 -0
  236. package/dist/memory-tool/adapter.js.map +1 -0
  237. package/dist/pipeline/errors.d.ts +21 -0
  238. package/dist/pipeline/errors.js +34 -0
  239. package/dist/pipeline/errors.js.map +1 -0
  240. package/dist/pipeline/failure-classifier.d.ts +13 -0
  241. package/dist/pipeline/failure-classifier.js +72 -0
  242. package/dist/pipeline/failure-classifier.js.map +1 -0
  243. package/dist/pipeline/handler-ctx-ext.d.ts +23 -0
  244. package/dist/pipeline/handler-ctx-ext.js +19 -0
  245. package/dist/pipeline/handler-ctx-ext.js.map +1 -0
  246. package/dist/pipeline/handler.d.ts +20 -0
  247. package/dist/pipeline/handler.js +2 -0
  248. package/dist/pipeline/handler.js.map +1 -0
  249. package/dist/pipeline/handlers/cleanup.d.ts +14 -0
  250. package/dist/pipeline/handlers/cleanup.js +47 -0
  251. package/dist/pipeline/handlers/cleanup.js.map +1 -0
  252. package/dist/pipeline/handlers/consolidate.d.ts +8 -0
  253. package/dist/pipeline/handlers/consolidate.js +23 -0
  254. package/dist/pipeline/handlers/consolidate.js.map +1 -0
  255. package/dist/pipeline/handlers/distill-events.d.ts +15 -0
  256. package/dist/pipeline/handlers/distill-events.js +134 -0
  257. package/dist/pipeline/handlers/distill-events.js.map +1 -0
  258. package/dist/pipeline/handlers/distill.d.ts +17 -0
  259. package/dist/pipeline/handlers/distill.js +110 -0
  260. package/dist/pipeline/handlers/distill.js.map +1 -0
  261. package/dist/pipeline/handlers/reembed.d.ts +10 -0
  262. package/dist/pipeline/handlers/reembed.js +34 -0
  263. package/dist/pipeline/handlers/reembed.js.map +1 -0
  264. package/dist/pipeline/job-repo.d.ts +86 -0
  265. package/dist/pipeline/job-repo.js +168 -0
  266. package/dist/pipeline/job-repo.js.map +1 -0
  267. package/dist/pipeline/mock-providers.d.ts +49 -0
  268. package/dist/pipeline/mock-providers.js +175 -0
  269. package/dist/pipeline/mock-providers.js.map +1 -0
  270. package/dist/pipeline/registry.d.ts +15 -0
  271. package/dist/pipeline/registry.js +20 -0
  272. package/dist/pipeline/registry.js.map +1 -0
  273. package/dist/pipeline/worker.d.ts +41 -0
  274. package/dist/pipeline/worker.js +167 -0
  275. package/dist/pipeline/worker.js.map +1 -0
  276. package/dist/providers/embed/azure-openai.d.ts +25 -0
  277. package/dist/providers/embed/azure-openai.js +138 -0
  278. package/dist/providers/embed/azure-openai.js.map +1 -0
  279. package/dist/providers/embed/ollama.d.ts +17 -0
  280. package/dist/providers/embed/ollama.js +106 -0
  281. package/dist/providers/embed/ollama.js.map +1 -0
  282. package/dist/providers/index.d.ts +19 -0
  283. package/dist/providers/index.js +72 -0
  284. package/dist/providers/index.js.map +1 -0
  285. package/dist/providers/llm/azure-openai.d.ts +20 -0
  286. package/dist/providers/llm/azure-openai.js +135 -0
  287. package/dist/providers/llm/azure-openai.js.map +1 -0
  288. package/dist/providers/llm/ollama.d.ts +13 -0
  289. package/dist/providers/llm/ollama.js +113 -0
  290. package/dist/providers/llm/ollama.js.map +1 -0
  291. package/dist/providers/llm/pricing.d.ts +21 -0
  292. package/dist/providers/llm/pricing.js +22 -0
  293. package/dist/providers/llm/pricing.js.map +1 -0
  294. package/dist/recall/pack.d.ts +32 -0
  295. package/dist/recall/pack.js +90 -0
  296. package/dist/recall/pack.js.map +1 -0
  297. package/dist/recall/policy.d.ts +39 -0
  298. package/dist/recall/policy.js +96 -0
  299. package/dist/recall/policy.js.map +1 -0
  300. package/dist/redact/detectors.d.ts +20 -0
  301. package/dist/redact/detectors.js +85 -0
  302. package/dist/redact/detectors.js.map +1 -0
  303. package/dist/redact/entropy.d.ts +24 -0
  304. package/dist/redact/entropy.js +77 -0
  305. package/dist/redact/entropy.js.map +1 -0
  306. package/dist/redact/index.d.ts +47 -0
  307. package/dist/redact/index.js +165 -0
  308. package/dist/redact/index.js.map +1 -0
  309. package/dist/search/fuse.d.ts +108 -0
  310. package/dist/search/fuse.js +135 -0
  311. package/dist/search/fuse.js.map +1 -0
  312. package/dist/search/query.d.ts +28 -0
  313. package/dist/search/query.js +70 -0
  314. package/dist/search/query.js.map +1 -0
  315. package/dist/search/search.d.ts +164 -0
  316. package/dist/search/search.js +310 -0
  317. package/dist/search/search.js.map +1 -0
  318. package/dist/server/app.d.ts +17 -0
  319. package/dist/server/app.js +133 -0
  320. package/dist/server/app.js.map +1 -0
  321. package/dist/server/health-state.d.ts +29 -0
  322. package/dist/server/health-state.js +28 -0
  323. package/dist/server/health-state.js.map +1 -0
  324. package/dist/server/lib/network.d.ts +12 -0
  325. package/dist/server/lib/network.js +16 -0
  326. package/dist/server/lib/network.js.map +1 -0
  327. package/dist/server/lib/score-contract.d.ts +36 -0
  328. package/dist/server/lib/score-contract.js +54 -0
  329. package/dist/server/lib/score-contract.js.map +1 -0
  330. package/dist/server/lib/stable-stringify.d.ts +10 -0
  331. package/dist/server/lib/stable-stringify.js +27 -0
  332. package/dist/server/lib/stable-stringify.js.map +1 -0
  333. package/dist/server/lib/wire-meta.d.ts +7 -0
  334. package/dist/server/lib/wire-meta.js +29 -0
  335. package/dist/server/lib/wire-meta.js.map +1 -0
  336. package/dist/server/queries/dashboard.d.ts +142 -0
  337. package/dist/server/queries/dashboard.js +166 -0
  338. package/dist/server/queries/dashboard.js.map +1 -0
  339. package/dist/server/routes/consolidation.d.ts +14 -0
  340. package/dist/server/routes/consolidation.js +67 -0
  341. package/dist/server/routes/consolidation.js.map +1 -0
  342. package/dist/server/routes/dashboard-api-html.d.ts +15 -0
  343. package/dist/server/routes/dashboard-api-html.js +144 -0
  344. package/dist/server/routes/dashboard-api-html.js.map +1 -0
  345. package/dist/server/routes/dashboard-consolidation-html.d.ts +26 -0
  346. package/dist/server/routes/dashboard-consolidation-html.js +202 -0
  347. package/dist/server/routes/dashboard-consolidation-html.js.map +1 -0
  348. package/dist/server/routes/dashboard-html.d.ts +15 -0
  349. package/dist/server/routes/dashboard-html.js +365 -0
  350. package/dist/server/routes/dashboard-html.js.map +1 -0
  351. package/dist/server/routes/dashboard-jobs-html.d.ts +18 -0
  352. package/dist/server/routes/dashboard-jobs-html.js +186 -0
  353. package/dist/server/routes/dashboard-jobs-html.js.map +1 -0
  354. package/dist/server/routes/dashboard-search-html.d.ts +18 -0
  355. package/dist/server/routes/dashboard-search-html.js +189 -0
  356. package/dist/server/routes/dashboard-search-html.js.map +1 -0
  357. package/dist/server/routes/dashboard.d.ts +19 -0
  358. package/dist/server/routes/dashboard.js +68 -0
  359. package/dist/server/routes/dashboard.js.map +1 -0
  360. package/dist/server/routes/digest.d.ts +9 -0
  361. package/dist/server/routes/digest.js +37 -0
  362. package/dist/server/routes/digest.js.map +1 -0
  363. package/dist/server/routes/entities.d.ts +12 -0
  364. package/dist/server/routes/entities.js +46 -0
  365. package/dist/server/routes/entities.js.map +1 -0
  366. package/dist/server/routes/health.d.ts +14 -0
  367. package/dist/server/routes/health.js +100 -0
  368. package/dist/server/routes/health.js.map +1 -0
  369. package/dist/server/routes/ingest.d.ts +209 -0
  370. package/dist/server/routes/ingest.js +454 -0
  371. package/dist/server/routes/ingest.js.map +1 -0
  372. package/dist/server/routes/lifecycle.d.ts +21 -0
  373. package/dist/server/routes/lifecycle.js +132 -0
  374. package/dist/server/routes/lifecycle.js.map +1 -0
  375. package/dist/server/routes/mcp.d.ts +15 -0
  376. package/dist/server/routes/mcp.js +36 -0
  377. package/dist/server/routes/mcp.js.map +1 -0
  378. package/dist/server/routes/memory-tool.d.ts +14 -0
  379. package/dist/server/routes/memory-tool.js +28 -0
  380. package/dist/server/routes/memory-tool.js.map +1 -0
  381. package/dist/server/routes/memory.d.ts +7 -0
  382. package/dist/server/routes/memory.js +19 -0
  383. package/dist/server/routes/memory.js.map +1 -0
  384. package/dist/server/routes/recall.d.ts +15 -0
  385. package/dist/server/routes/recall.js +74 -0
  386. package/dist/server/routes/recall.js.map +1 -0
  387. package/dist/server/routes/search.d.ts +12 -0
  388. package/dist/server/routes/search.js +203 -0
  389. package/dist/server/routes/search.js.map +1 -0
  390. package/dist/server/routes/version.d.ts +2 -0
  391. package/dist/server/routes/version.js +11 -0
  392. package/dist/server/routes/version.js.map +1 -0
  393. package/dist/server/routes/why.d.ts +9 -0
  394. package/dist/server/routes/why.js +38 -0
  395. package/dist/server/routes/why.js.map +1 -0
  396. package/dist/service/index.d.ts +10 -0
  397. package/dist/service/index.js +25 -0
  398. package/dist/service/index.js.map +1 -0
  399. package/dist/service/install-flow.d.ts +18 -0
  400. package/dist/service/install-flow.js +47 -0
  401. package/dist/service/install-flow.js.map +1 -0
  402. package/dist/service/instance-lock.d.ts +26 -0
  403. package/dist/service/instance-lock.js +150 -0
  404. package/dist/service/instance-lock.js.map +1 -0
  405. package/dist/service/launchd.d.ts +11 -0
  406. package/dist/service/launchd.js +196 -0
  407. package/dist/service/launchd.js.map +1 -0
  408. package/dist/service/schtasks.d.ts +31 -0
  409. package/dist/service/schtasks.js +274 -0
  410. package/dist/service/schtasks.js.map +1 -0
  411. package/dist/service/shim.d.ts +21 -0
  412. package/dist/service/shim.js +80 -0
  413. package/dist/service/shim.js.map +1 -0
  414. package/dist/service/systemd.d.ts +11 -0
  415. package/dist/service/systemd.js +150 -0
  416. package/dist/service/systemd.js.map +1 -0
  417. package/dist/service/task-xml.d.ts +36 -0
  418. package/dist/service/task-xml.js +91 -0
  419. package/dist/service/task-xml.js.map +1 -0
  420. package/dist/service/types.d.ts +47 -0
  421. package/dist/service/types.js +2 -0
  422. package/dist/service/types.js.map +1 -0
  423. package/dist/storage/archival.d.ts +29 -0
  424. package/dist/storage/archival.js +47 -0
  425. package/dist/storage/archival.js.map +1 -0
  426. package/dist/storage/bearer-keystore.d.ts +34 -0
  427. package/dist/storage/bearer-keystore.js +75 -0
  428. package/dist/storage/bearer-keystore.js.map +1 -0
  429. package/dist/storage/db.d.ts +37 -0
  430. package/dist/storage/db.js +92 -0
  431. package/dist/storage/db.js.map +1 -0
  432. package/dist/storage/entities.d.ts +71 -0
  433. package/dist/storage/entities.js +141 -0
  434. package/dist/storage/entities.js.map +1 -0
  435. package/dist/storage/ingest-idempotency.d.ts +26 -0
  436. package/dist/storage/ingest-idempotency.js +29 -0
  437. package/dist/storage/ingest-idempotency.js.map +1 -0
  438. package/dist/storage/keystore.d.ts +64 -0
  439. package/dist/storage/keystore.js +194 -0
  440. package/dist/storage/keystore.js.map +1 -0
  441. package/dist/storage/memories.d.ts +51 -0
  442. package/dist/storage/memories.js +67 -0
  443. package/dist/storage/memories.js.map +1 -0
  444. package/dist/storage/memory-events.d.ts +145 -0
  445. package/dist/storage/memory-events.js +287 -0
  446. package/dist/storage/memory-events.js.map +1 -0
  447. package/dist/storage/migrate-encrypt.d.ts +16 -0
  448. package/dist/storage/migrate-encrypt.js +121 -0
  449. package/dist/storage/migrate-encrypt.js.map +1 -0
  450. package/dist/storage/migrate.d.ts +27 -0
  451. package/dist/storage/migrate.js +105 -0
  452. package/dist/storage/migrate.js.map +1 -0
  453. package/dist/storage/redaction-log.d.ts +18 -0
  454. package/dist/storage/redaction-log.js +27 -0
  455. package/dist/storage/redaction-log.js.map +1 -0
  456. package/dist/storage/usefulness.d.ts +115 -0
  457. package/dist/storage/usefulness.js +203 -0
  458. package/dist/storage/usefulness.js.map +1 -0
  459. package/dist/sync/conflict-resolve.d.ts +26 -0
  460. package/dist/sync/conflict-resolve.js +139 -0
  461. package/dist/sync/conflict-resolve.js.map +1 -0
  462. package/dist/sync/puller.d.ts +115 -0
  463. package/dist/sync/puller.js +173 -0
  464. package/dist/sync/puller.js.map +1 -0
  465. package/dist/sync/shipper.d.ts +112 -0
  466. package/dist/sync/shipper.js +189 -0
  467. package/dist/sync/shipper.js.map +1 -0
  468. package/dist/tag-hygiene/backfill.d.ts +50 -0
  469. package/dist/tag-hygiene/backfill.js +117 -0
  470. package/dist/tag-hygiene/backfill.js.map +1 -0
  471. package/dist/tag-hygiene/derive-repo.d.ts +9 -0
  472. package/dist/tag-hygiene/derive-repo.js +19 -0
  473. package/dist/tag-hygiene/derive-repo.js.map +1 -0
  474. package/dist/tag-hygiene/tier2-infer.d.ts +28 -0
  475. package/dist/tag-hygiene/tier2-infer.js +72 -0
  476. package/dist/tag-hygiene/tier2-infer.js.map +1 -0
  477. package/dist/vector/sqlite-vec.d.ts +16 -0
  478. package/dist/vector/sqlite-vec.js +49 -0
  479. package/dist/vector/sqlite-vec.js.map +1 -0
  480. package/migrations/001-init.sql +117 -0
  481. package/migrations/002-wire-v1.sql +16 -0
  482. package/migrations/003-expand-memory-types.sql +81 -0
  483. package/migrations/004-provenance.sql +4 -0
  484. package/migrations/005-security.sql +12 -0
  485. package/migrations/006-atom-v3.sql +28 -0
  486. package/migrations/007-memory-events.sql +30 -0
  487. package/migrations/008-consolidation.sql +31 -0
  488. package/migrations/009-tag-hygiene.sql +13 -0
  489. package/migrations/010-sync-pull.sql +53 -0
  490. package/migrations/011-embed-dim-migration.sql +28 -0
  491. package/migrations/012-entities.sql +36 -0
  492. package/migrations/013-archival.sql +50 -0
  493. package/package.json +50 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/server/routes/ingest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Memory lifecycle routes (Wave 2b, ADR-002 memory_events log):
3
+ * POST /memory/:id/invalidate { reason? } -> 200 { ok: true } | 404 | 409
4
+ * POST /memory/:id/supersede { new_id } -> 200 { ok: true } | 404 | 409
5
+ * POST /memory/:id/promote { scope } -> 200 { ok: true } | 400 | 404
6
+ * POST /memory/:id/restore -> 200 { ok: true } | 404 | 409 (FEAT-416, un-archive)
7
+ * GET /memory/:id/history -> { id, history: MemoryEvent[] }
8
+ * POST /memory/:id/used -> 200 { ok: true } | 404
9
+ * DELETE /memory/:id -> 200 { ok: true } | 404 (erasure v1, ADR-006 W5)
10
+ *
11
+ * `history` also backs the Wave 2c MCP `memory_history` tool.
12
+ * `used` is the ADR-010 (2e) explicit recall-used signal — REST twin of the
13
+ * MCP `mark_memory_used` tool (src/mcp/server.ts).
14
+ * `restore` un-archives a memory previously archived by the W4.4 TTL policy
15
+ * (src/storage/archival.ts) or by a manual `archive` event — mirrors
16
+ * `invalidate`'s 404/409 semantics exactly (MemoryEventRepo.restore() already
17
+ * throws MemoryNotFoundError/MemoryConflictError for the same two cases).
18
+ */
19
+ import type { FastifyInstance } from 'fastify';
20
+ import type { DB } from '../../storage/db.js';
21
+ export declare function lifecycleRoutes(db: DB): (app: FastifyInstance) => Promise<void>;
@@ -0,0 +1,132 @@
1
+ /**
2
+ * Memory lifecycle routes (Wave 2b, ADR-002 memory_events log):
3
+ * POST /memory/:id/invalidate { reason? } -> 200 { ok: true } | 404 | 409
4
+ * POST /memory/:id/supersede { new_id } -> 200 { ok: true } | 404 | 409
5
+ * POST /memory/:id/promote { scope } -> 200 { ok: true } | 400 | 404
6
+ * POST /memory/:id/restore -> 200 { ok: true } | 404 | 409 (FEAT-416, un-archive)
7
+ * GET /memory/:id/history -> { id, history: MemoryEvent[] }
8
+ * POST /memory/:id/used -> 200 { ok: true } | 404
9
+ * DELETE /memory/:id -> 200 { ok: true } | 404 (erasure v1, ADR-006 W5)
10
+ *
11
+ * `history` also backs the Wave 2c MCP `memory_history` tool.
12
+ * `used` is the ADR-010 (2e) explicit recall-used signal — REST twin of the
13
+ * MCP `mark_memory_used` tool (src/mcp/server.ts).
14
+ * `restore` un-archives a memory previously archived by the W4.4 TTL policy
15
+ * (src/storage/archival.ts) or by a manual `archive` event — mirrors
16
+ * `invalidate`'s 404/409 semantics exactly (MemoryEventRepo.restore() already
17
+ * throws MemoryNotFoundError/MemoryConflictError for the same two cases).
18
+ */
19
+ import { z } from 'zod';
20
+ import { MemoryRepo } from '../../storage/memories.js';
21
+ import { MemoryEventRepo, MemoryNotFoundError, MemoryConflictError, InvalidScopeTransitionError, } from '../../storage/memory-events.js';
22
+ import { recordRecallUsed } from '../../storage/usefulness.js';
23
+ const InvalidateBodySchema = z.object({ reason: z.string().optional() });
24
+ const SupersedeBodySchema = z.object({ new_id: z.string().min(1) });
25
+ const PromoteBodySchema = z.object({ scope: z.enum(['personal', 'team', 'org']) });
26
+ export function lifecycleRoutes(db) {
27
+ return async (app) => {
28
+ const events = new MemoryEventRepo(db);
29
+ app.post('/memory/:id/invalidate', async (req, reply) => {
30
+ const { id } = req.params;
31
+ const parsed = InvalidateBodySchema.safeParse(req.body ?? {});
32
+ if (!parsed.success) {
33
+ return reply.code(400).send({ error: 'invalid', details: parsed.error.flatten() });
34
+ }
35
+ try {
36
+ events.invalidate(id, parsed.data.reason);
37
+ return { ok: true };
38
+ }
39
+ catch (err) {
40
+ if (err instanceof MemoryNotFoundError)
41
+ return reply.code(404).send({ error: 'not found', id });
42
+ if (err instanceof MemoryConflictError)
43
+ return reply.code(409).send({ error: err.message, id });
44
+ throw err;
45
+ }
46
+ });
47
+ // Erasure v1 (ADR-006 W5): hard-delete + tombstone event. The row and
48
+ // its FTS/vec entries are gone; the erase_request event (with content
49
+ // hash) is the tombstone that powers the replay filter and cloud sync.
50
+ app.delete('/memory/:id', async (req, reply) => {
51
+ const { id } = req.params;
52
+ const body = (req.body ?? {});
53
+ try {
54
+ events.erase(id, typeof body.reason === 'string' ? body.reason : undefined);
55
+ return { ok: true };
56
+ }
57
+ catch (err) {
58
+ if (err instanceof MemoryNotFoundError)
59
+ return reply.code(404).send({ error: 'not found', id });
60
+ throw err;
61
+ }
62
+ });
63
+ app.post('/memory/:id/supersede', async (req, reply) => {
64
+ const { id } = req.params;
65
+ const parsed = SupersedeBodySchema.safeParse(req.body);
66
+ if (!parsed.success) {
67
+ return reply.code(400).send({ error: 'invalid', details: parsed.error.flatten() });
68
+ }
69
+ try {
70
+ events.supersede(id, parsed.data.new_id);
71
+ return { ok: true };
72
+ }
73
+ catch (err) {
74
+ if (err instanceof MemoryNotFoundError)
75
+ return reply.code(404).send({ error: 'not found', id: err.atomId });
76
+ if (err instanceof MemoryConflictError)
77
+ return reply.code(409).send({ error: err.message });
78
+ throw err;
79
+ }
80
+ });
81
+ app.post('/memory/:id/promote', async (req, reply) => {
82
+ const { id } = req.params;
83
+ const parsed = PromoteBodySchema.safeParse(req.body);
84
+ if (!parsed.success) {
85
+ return reply.code(400).send({ error: 'invalid', details: parsed.error.flatten() });
86
+ }
87
+ try {
88
+ events.promoteScope(id, parsed.data.scope);
89
+ return { ok: true };
90
+ }
91
+ catch (err) {
92
+ if (err instanceof MemoryNotFoundError)
93
+ return reply.code(404).send({ error: 'not found', id });
94
+ if (err instanceof InvalidScopeTransitionError)
95
+ return reply.code(400).send({ error: err.message });
96
+ throw err;
97
+ }
98
+ });
99
+ app.post('/memory/:id/restore', async (req, reply) => {
100
+ const { id } = req.params;
101
+ try {
102
+ events.restore(id);
103
+ return { ok: true };
104
+ }
105
+ catch (err) {
106
+ if (err instanceof MemoryNotFoundError)
107
+ return reply.code(404).send({ error: 'not found', id });
108
+ if (err instanceof MemoryConflictError)
109
+ return reply.code(409).send({ error: err.message, id });
110
+ throw err;
111
+ }
112
+ });
113
+ app.get('/memory/:id/history', async (req, reply) => {
114
+ const { id } = req.params;
115
+ const memory = new MemoryRepo(db).get(id);
116
+ if (!memory)
117
+ return reply.code(404).send({ error: 'not found', id });
118
+ return { id, history: events.listForAtom(id) };
119
+ });
120
+ // ADR-010 (2e): explicit recall-used signal — the REST twin of the MCP
121
+ // mark_memory_used tool. v1 feeds doctor/dashboard/health only.
122
+ app.post('/memory/:id/used', async (req, reply) => {
123
+ const { id } = req.params;
124
+ const memory = new MemoryRepo(db).get(id);
125
+ if (!memory)
126
+ return reply.code(404).send({ error: 'not found', id });
127
+ recordRecallUsed(db, { atomId: id, surface: 'rest', signal: 'explicit' });
128
+ return { ok: true };
129
+ });
130
+ };
131
+ }
132
+ //# sourceMappingURL=lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/server/routes/lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Fastify route: POST /mcp
3
+ *
4
+ * Implements the MCP Streamable HTTP transport (JSON-RPC 2.0 over HTTP).
5
+ * Each request gets its own stateless transport instance — no session ID.
6
+ * Auth is enforced by the app-level preHandler (Bearer token) before this
7
+ * route handler runs, so we do not repeat auth logic here.
8
+ *
9
+ * Spec: https://modelcontextprotocol.io/specification/2024-11-05/basic/transports
10
+ */
11
+ import type { FastifyInstance } from 'fastify';
12
+ import type { DB } from '../../storage/db.js';
13
+ import type { EmbedProvider } from '../../contracts/index.js';
14
+ import { type Config } from '../../config/config.js';
15
+ export declare function mcpRoute(db: DB, embed: EmbedProvider, config?: Config): (app: FastifyInstance) => Promise<void>;
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Fastify route: POST /mcp
3
+ *
4
+ * Implements the MCP Streamable HTTP transport (JSON-RPC 2.0 over HTTP).
5
+ * Each request gets its own stateless transport instance — no session ID.
6
+ * Auth is enforced by the app-level preHandler (Bearer token) before this
7
+ * route handler runs, so we do not repeat auth logic here.
8
+ *
9
+ * Spec: https://modelcontextprotocol.io/specification/2024-11-05/basic/transports
10
+ */
11
+ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
12
+ import { defaultConfig } from '../../config/config.js';
13
+ import { buildMcpServer } from '../../mcp/server.js';
14
+ export function mcpRoute(db, embed, config = defaultConfig()) {
15
+ return async (app) => {
16
+ app.post('/mcp', async (req, reply) => {
17
+ // One McpServer + transport per request (stateless mode).
18
+ const mcpServer = buildMcpServer({ db, embed, config });
19
+ const transport = new StreamableHTTPServerTransport({
20
+ // Stateless: no session ID
21
+ sessionIdGenerator: undefined,
22
+ });
23
+ // Connect server to transport.
24
+ await mcpServer.connect(transport);
25
+ // Pass req.body (already parsed by Fastify's default JSON parser) as
26
+ // parsedBody so the SDK does not attempt to re-read the stream.
27
+ // The SDK writes the response directly to reply.raw and ends it.
28
+ await transport.handleRequest(req.raw, reply.raw, req.body);
29
+ // Prevent Fastify from attempting to send a second response.
30
+ reply.hijack();
31
+ // Cleanup transport resources.
32
+ await transport.close();
33
+ });
34
+ };
35
+ }
36
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/server/routes/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG,OAAO,EAAe,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,UAAU,QAAQ,CAAC,EAAM,EAAE,KAAoB,EAAE,SAAiB,aAAa,EAAE;IACrF,OAAO,KAAK,EAAE,GAAoB,EAAE,EAAE;QACpC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACpC,0DAA0D;YAC1D,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAExD,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,2BAA2B;gBAC3B,kBAAkB,EAAE,SAAS;aAC9B,CAAC,CAAC;YAEH,+BAA+B;YAC/B,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEnC,qEAAqE;YACrE,gEAAgE;YAChE,iEAAiE;YACjE,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAE5D,6DAA6D;YAC7D,KAAK,CAAC,MAAM,EAAE,CAAC;YAEf,+BAA+B;YAC/B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Memory-tool adapter REST surface (ADR-007 Wave 4a, migration-map 4a):
3
+ * POST /memory-tool { command, path, ... } -> { content: string } | { error: string }
4
+ *
5
+ * Bearer-authed via the app-level preHandler (src/server/app.ts) — no route-
6
+ * local auth here. Body is the raw Anthropic memory-tool command JSON; the
7
+ * response shape is exactly what a harness needs to relay back to the model
8
+ * as a tool_result. See docs/memory-tool-adapter.md for the command mapping
9
+ * and limitations, and src/memory-tool/adapter.ts for the mapping logic.
10
+ */
11
+ import type { FastifyInstance } from 'fastify';
12
+ import type { DB } from '../../storage/db.js';
13
+ import { type Config } from '../../config/config.js';
14
+ export declare function memoryToolRoute(db: DB, config?: Config): (app: FastifyInstance) => Promise<void>;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Memory-tool adapter REST surface (ADR-007 Wave 4a, migration-map 4a):
3
+ * POST /memory-tool { command, path, ... } -> { content: string } | { error: string }
4
+ *
5
+ * Bearer-authed via the app-level preHandler (src/server/app.ts) — no route-
6
+ * local auth here. Body is the raw Anthropic memory-tool command JSON; the
7
+ * response shape is exactly what a harness needs to relay back to the model
8
+ * as a tool_result. See docs/memory-tool-adapter.md for the command mapping
9
+ * and limitations, and src/memory-tool/adapter.ts for the mapping logic.
10
+ */
11
+ import { defaultConfig } from '../../config/config.js';
12
+ import { handleMemoryToolCommand } from '../../memory-tool/adapter.js';
13
+ export function memoryToolRoute(db, config = defaultConfig()) {
14
+ return async (app) => {
15
+ app.post('/memory-tool', async (req, reply) => {
16
+ const body = req.body;
17
+ if (!body || typeof body.command !== 'string') {
18
+ return reply.code(400).send({ error: 'invalid: command is required' });
19
+ }
20
+ // `path` defaults to '' rather than being required at the HTTP layer —
21
+ // the adapter maps a missing/invalid path to a clean { error } result
22
+ // (e.g. 'rename' never needs one), matching the "never throws" contract.
23
+ const cmd = { path: '', ...body, command: body.command };
24
+ return handleMemoryToolCommand(db, config, cmd);
25
+ });
26
+ };
27
+ }
28
+ //# sourceMappingURL=memory-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-tool.js","sourceRoot":"","sources":["../../../src/server/routes/memory-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAe,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAE/F,MAAM,UAAU,eAAe,CAAC,EAAM,EAAE,SAAiB,aAAa,EAAE;IACtE,OAAO,KAAK,EAAE,GAAoB,EAAE,EAAE;QACpC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2C,CAAC;YAC7D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,uEAAuE;YACvE,sEAAsE;YACtE,yEAAyE;YACzE,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAuB,CAAC;YACjG,OAAO,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Memory detail route:
3
+ * GET /memory/:id — returns full Memory record or 404
4
+ */
5
+ import type { FastifyInstance } from 'fastify';
6
+ import type { DB } from '../../storage/db.js';
7
+ export declare function memoryRoute(db: DB): (app: FastifyInstance) => Promise<void>;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Memory detail route:
3
+ * GET /memory/:id — returns full Memory record or 404
4
+ */
5
+ import { MemoryRepo } from '../../storage/memories.js';
6
+ export function memoryRoute(db) {
7
+ return async (app) => {
8
+ app.get('/memory/:id', async (req, reply) => {
9
+ const { id } = req.params;
10
+ const repo = new MemoryRepo(db);
11
+ const memory = repo.get(id);
12
+ if (!memory) {
13
+ return reply.code(404).send({ error: 'not found', id });
14
+ }
15
+ return memory;
16
+ });
17
+ };
18
+ }
19
+ //# sourceMappingURL=memory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/server/routes/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,EAAM;IAChC,OAAO,KAAK,EAAE,GAAoB,EAAE,EAAE;QACpC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,MAAwB,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Memory-pack endpoint (KF-B + Wave 4d injection policy):
3
+ * POST /recall/pack { repo, project?, branch?, budget_tokens?, prompt? }
4
+ * Returns { pack: <markdown>, memories: [...] }. Empty pack on zero matches (200).
5
+ *
6
+ * When `prompt` is supplied, the ADR-005 injection-policy v1 layer decides
7
+ * whether anything should be injected at all (task-type gating, confidence
8
+ * threshold, token-budget shrink) and the response gains
9
+ * `decision: { inject, reason, budget_tokens }`. Without `prompt` the legacy
10
+ * always-select behavior is preserved (existing hook clients unaffected).
11
+ */
12
+ import type { FastifyInstance } from 'fastify';
13
+ import type { DB } from '../../storage/db.js';
14
+ import type { Config } from '../../config/config.js';
15
+ export declare function recallRoute(db: DB, config?: Config): (app: FastifyInstance) => Promise<void>;
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Memory-pack endpoint (KF-B + Wave 4d injection policy):
3
+ * POST /recall/pack { repo, project?, branch?, budget_tokens?, prompt? }
4
+ * Returns { pack: <markdown>, memories: [...] }. Empty pack on zero matches (200).
5
+ *
6
+ * When `prompt` is supplied, the ADR-005 injection-policy v1 layer decides
7
+ * whether anything should be injected at all (task-type gating, confidence
8
+ * threshold, token-budget shrink) and the response gains
9
+ * `decision: { inject, reason, budget_tokens }`. Without `prompt` the legacy
10
+ * always-select behavior is preserved (existing hook clients unaffected).
11
+ */
12
+ import { z } from 'zod';
13
+ import { selectPack, renderPack } from '../../recall/pack.js';
14
+ import { decideInjection } from '../../recall/policy.js';
15
+ import { recordRecallServed } from '../../storage/usefulness.js';
16
+ import { defaultConfig } from '../../config/config.js';
17
+ import { clampScores } from '../lib/score-contract.js';
18
+ const PackRequestSchema = z.object({
19
+ repo: z.string().min(1),
20
+ project: z.string().nullish(),
21
+ branch: z.string().nullish(),
22
+ budget_tokens: z.number().int().positive().max(8000).optional(),
23
+ /** Wave 4d: the user prompt about to be sent — activates the injection policy. */
24
+ prompt: z.string().max(64_000).optional(),
25
+ });
26
+ export function recallRoute(db, config = defaultConfig()) {
27
+ return async (app) => {
28
+ app.post('/recall/pack', async (req, reply) => {
29
+ const parsed = PackRequestSchema.safeParse(req.body);
30
+ if (!parsed.success) {
31
+ return reply.code(400).send({ error: 'invalid body', details: parsed.error.issues });
32
+ }
33
+ // Wave 4d: prompt present → policy decides.
34
+ if (parsed.data.prompt !== undefined) {
35
+ const decision = decideInjection(db, config, {
36
+ repo: parsed.data.repo,
37
+ prompt: parsed.data.prompt,
38
+ budgetTokens: parsed.data.budget_tokens,
39
+ });
40
+ // SLICE-411: enforce the [0,1] wire score contract at serialization,
41
+ // independent of fuseScores() internal math.
42
+ return {
43
+ pack: decision.pack,
44
+ memories: clampScores(decision.memories, 'POST /recall/pack'),
45
+ decision: {
46
+ inject: decision.inject,
47
+ reason: decision.reason,
48
+ budget_tokens: decision.budget_tokens,
49
+ },
50
+ };
51
+ }
52
+ // Legacy path (no prompt): always select — existing hook clients unaffected.
53
+ const memories = selectPack(db, {
54
+ repo: parsed.data.repo,
55
+ project: parsed.data.project,
56
+ branch: parsed.data.branch,
57
+ budgetTokens: parsed.data.budget_tokens ?? config.recallPack.budgetTokens,
58
+ });
59
+ // ADR-010: recall-usefulness capture — measure only, does not feed ranking (v1).
60
+ // No free-text query here; hash the structural selector instead.
61
+ recordRecallServed(db, {
62
+ query: `${parsed.data.repo}|${parsed.data.project ?? ''}|${parsed.data.branch ?? ''}`,
63
+ atomIds: memories.map(m => m.id),
64
+ scores: memories.map(m => m.score),
65
+ surface: 'rest',
66
+ mode: 'pack',
67
+ });
68
+ // SLICE-411: enforce the [0,1] wire score contract at serialization,
69
+ // independent of fuseScores() internal math.
70
+ return { pack: renderPack(memories), memories: clampScores(memories, 'POST /recall/pack') };
71
+ });
72
+ };
73
+ }
74
+ //# sourceMappingURL=recall.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recall.js","sourceRoot":"","sources":["../../../src/server/routes/recall.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Search routes:
3
+ * GET /search?q=&type=&repo=&project=&agent=&since=&as_of=&entity=&limit=
4
+ * POST /recall { query, k, filters? } filters.as_of: ISO-8601 date-time,
5
+ * filters.entity: FEAT-402 AC-4
6
+ * POST /remember { text, type, metadata? }
7
+ */
8
+ import type { FastifyInstance } from 'fastify';
9
+ import type { DB } from '../../storage/db.js';
10
+ import type { EmbedProvider } from '../../contracts/index.js';
11
+ import { type Config } from '../../config/config.js';
12
+ export declare function searchRoute(db: DB, embed: EmbedProvider, config?: Config): (app: FastifyInstance) => Promise<void>;