@co-engram/core 0.1.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 (531) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +167 -0
  3. package/dist/config/defaults.d.ts +45 -0
  4. package/dist/config/defaults.d.ts.map +1 -0
  5. package/dist/config/defaults.js +70 -0
  6. package/dist/config/defaults.js.map +1 -0
  7. package/dist/config/index.d.ts +84 -0
  8. package/dist/config/index.d.ts.map +1 -0
  9. package/dist/config/index.js +230 -0
  10. package/dist/config/index.js.map +1 -0
  11. package/dist/config/types.d.ts +145 -0
  12. package/dist/config/types.d.ts.map +1 -0
  13. package/dist/config/types.js +14 -0
  14. package/dist/config/types.js.map +1 -0
  15. package/dist/contradiction/arbiter.d.ts +51 -0
  16. package/dist/contradiction/arbiter.d.ts.map +1 -0
  17. package/dist/contradiction/arbiter.js +112 -0
  18. package/dist/contradiction/arbiter.js.map +1 -0
  19. package/dist/contradiction/auto-degrade.d.ts +53 -0
  20. package/dist/contradiction/auto-degrade.d.ts.map +1 -0
  21. package/dist/contradiction/auto-degrade.js +79 -0
  22. package/dist/contradiction/auto-degrade.js.map +1 -0
  23. package/dist/contradiction/detector.d.ts +33 -0
  24. package/dist/contradiction/detector.d.ts.map +1 -0
  25. package/dist/contradiction/detector.js +76 -0
  26. package/dist/contradiction/detector.js.map +1 -0
  27. package/dist/contradiction/index.d.ts +11 -0
  28. package/dist/contradiction/index.d.ts.map +1 -0
  29. package/dist/contradiction/index.js +11 -0
  30. package/dist/contradiction/index.js.map +1 -0
  31. package/dist/contradiction/resolver.d.ts +45 -0
  32. package/dist/contradiction/resolver.d.ts.map +1 -0
  33. package/dist/contradiction/resolver.js +196 -0
  34. package/dist/contradiction/resolver.js.map +1 -0
  35. package/dist/contradiction/types.d.ts +73 -0
  36. package/dist/contradiction/types.d.ts.map +1 -0
  37. package/dist/contradiction/types.js +7 -0
  38. package/dist/contradiction/types.js.map +1 -0
  39. package/dist/dedup/dedupe.d.ts +49 -0
  40. package/dist/dedup/dedupe.d.ts.map +1 -0
  41. package/dist/dedup/dedupe.js +111 -0
  42. package/dist/dedup/dedupe.js.map +1 -0
  43. package/dist/dedup/hash.d.ts +27 -0
  44. package/dist/dedup/hash.d.ts.map +1 -0
  45. package/dist/dedup/hash.js +43 -0
  46. package/dist/dedup/hash.js.map +1 -0
  47. package/dist/dedup/index.d.ts +12 -0
  48. package/dist/dedup/index.d.ts.map +1 -0
  49. package/dist/dedup/index.js +12 -0
  50. package/dist/dedup/index.js.map +1 -0
  51. package/dist/dedup/llm-triage.d.ts +48 -0
  52. package/dist/dedup/llm-triage.d.ts.map +1 -0
  53. package/dist/dedup/llm-triage.js +100 -0
  54. package/dist/dedup/llm-triage.js.map +1 -0
  55. package/dist/dedup/merge.d.ts +41 -0
  56. package/dist/dedup/merge.d.ts.map +1 -0
  57. package/dist/dedup/merge.js +55 -0
  58. package/dist/dedup/merge.js.map +1 -0
  59. package/dist/dedup/similar.d.ts +45 -0
  60. package/dist/dedup/similar.d.ts.map +1 -0
  61. package/dist/dedup/similar.js +103 -0
  62. package/dist/dedup/similar.js.map +1 -0
  63. package/dist/dedup/types.d.ts +72 -0
  64. package/dist/dedup/types.d.ts.map +1 -0
  65. package/dist/dedup/types.js +18 -0
  66. package/dist/dedup/types.js.map +1 -0
  67. package/dist/disclosure/adaptive.d.ts +86 -0
  68. package/dist/disclosure/adaptive.d.ts.map +1 -0
  69. package/dist/disclosure/adaptive.js +196 -0
  70. package/dist/disclosure/adaptive.js.map +1 -0
  71. package/dist/disclosure/budget.d.ts +51 -0
  72. package/dist/disclosure/budget.d.ts.map +1 -0
  73. package/dist/disclosure/budget.js +91 -0
  74. package/dist/disclosure/budget.js.map +1 -0
  75. package/dist/disclosure/index.d.ts +11 -0
  76. package/dist/disclosure/index.d.ts.map +1 -0
  77. package/dist/disclosure/index.js +11 -0
  78. package/dist/disclosure/index.js.map +1 -0
  79. package/dist/disclosure/tier-loader.d.ts +58 -0
  80. package/dist/disclosure/tier-loader.d.ts.map +1 -0
  81. package/dist/disclosure/tier-loader.js +205 -0
  82. package/dist/disclosure/tier-loader.js.map +1 -0
  83. package/dist/dreaming/decay.d.ts +46 -0
  84. package/dist/dreaming/decay.d.ts.map +1 -0
  85. package/dist/dreaming/decay.js +69 -0
  86. package/dist/dreaming/decay.js.map +1 -0
  87. package/dist/dreaming/deep.d.ts +48 -0
  88. package/dist/dreaming/deep.d.ts.map +1 -0
  89. package/dist/dreaming/deep.js +41 -0
  90. package/dist/dreaming/deep.js.map +1 -0
  91. package/dist/dreaming/index.d.ts +12 -0
  92. package/dist/dreaming/index.d.ts.map +1 -0
  93. package/dist/dreaming/index.js +12 -0
  94. package/dist/dreaming/index.js.map +1 -0
  95. package/dist/dreaming/light.d.ts +54 -0
  96. package/dist/dreaming/light.d.ts.map +1 -0
  97. package/dist/dreaming/light.js +114 -0
  98. package/dist/dreaming/light.js.map +1 -0
  99. package/dist/dreaming/rem.d.ts +128 -0
  100. package/dist/dreaming/rem.d.ts.map +1 -0
  101. package/dist/dreaming/rem.js +228 -0
  102. package/dist/dreaming/rem.js.map +1 -0
  103. package/dist/dreaming/scheduler.d.ts +75 -0
  104. package/dist/dreaming/scheduler.d.ts.map +1 -0
  105. package/dist/dreaming/scheduler.js +138 -0
  106. package/dist/dreaming/scheduler.js.map +1 -0
  107. package/dist/dreaming/trash.d.ts +174 -0
  108. package/dist/dreaming/trash.d.ts.map +1 -0
  109. package/dist/dreaming/trash.js +466 -0
  110. package/dist/dreaming/trash.js.map +1 -0
  111. package/dist/evolution/category.d.ts +127 -0
  112. package/dist/evolution/category.d.ts.map +1 -0
  113. package/dist/evolution/category.js +271 -0
  114. package/dist/evolution/category.js.map +1 -0
  115. package/dist/evolution/index.d.ts +8 -0
  116. package/dist/evolution/index.d.ts.map +1 -0
  117. package/dist/evolution/index.js +8 -0
  118. package/dist/evolution/index.js.map +1 -0
  119. package/dist/evolution/triggered.d.ts +107 -0
  120. package/dist/evolution/triggered.d.ts.map +1 -0
  121. package/dist/evolution/triggered.js +278 -0
  122. package/dist/evolution/triggered.js.map +1 -0
  123. package/dist/generative/cross-pollinate.d.ts +144 -0
  124. package/dist/generative/cross-pollinate.d.ts.map +1 -0
  125. package/dist/generative/cross-pollinate.js +390 -0
  126. package/dist/generative/cross-pollinate.js.map +1 -0
  127. package/dist/generative/gap-detector.d.ts +80 -0
  128. package/dist/generative/gap-detector.d.ts.map +1 -0
  129. package/dist/generative/gap-detector.js +250 -0
  130. package/dist/generative/gap-detector.js.map +1 -0
  131. package/dist/generative/hypothesis.d.ts +161 -0
  132. package/dist/generative/hypothesis.d.ts.map +1 -0
  133. package/dist/generative/hypothesis.js +356 -0
  134. package/dist/generative/hypothesis.js.map +1 -0
  135. package/dist/generative/index.d.ts +9 -0
  136. package/dist/generative/index.d.ts.map +1 -0
  137. package/dist/generative/index.js +9 -0
  138. package/dist/generative/index.js.map +1 -0
  139. package/dist/graph/clustering.d.ts +117 -0
  140. package/dist/graph/clustering.d.ts.map +1 -0
  141. package/dist/graph/clustering.js +196 -0
  142. package/dist/graph/clustering.js.map +1 -0
  143. package/dist/graph/index.d.ts +13 -0
  144. package/dist/graph/index.d.ts.map +1 -0
  145. package/dist/graph/index.js +13 -0
  146. package/dist/graph/index.js.map +1 -0
  147. package/dist/graph/layout.d.ts +46 -0
  148. package/dist/graph/layout.d.ts.map +1 -0
  149. package/dist/graph/layout.js +269 -0
  150. package/dist/graph/layout.js.map +1 -0
  151. package/dist/graph/presets.d.ts +134 -0
  152. package/dist/graph/presets.d.ts.map +1 -0
  153. package/dist/graph/presets.js +190 -0
  154. package/dist/graph/presets.js.map +1 -0
  155. package/dist/graph/registry.d.ts +42 -0
  156. package/dist/graph/registry.d.ts.map +1 -0
  157. package/dist/graph/registry.js +158 -0
  158. package/dist/graph/registry.js.map +1 -0
  159. package/dist/graph/snapshot.d.ts +113 -0
  160. package/dist/graph/snapshot.d.ts.map +1 -0
  161. package/dist/graph/snapshot.js +194 -0
  162. package/dist/graph/snapshot.js.map +1 -0
  163. package/dist/graph/traverse.d.ts +84 -0
  164. package/dist/graph/traverse.d.ts.map +1 -0
  165. package/dist/graph/traverse.js +190 -0
  166. package/dist/graph/traverse.js.map +1 -0
  167. package/dist/graph/view-config.d.ts +99 -0
  168. package/dist/graph/view-config.d.ts.map +1 -0
  169. package/dist/graph/view-config.js +208 -0
  170. package/dist/graph/view-config.js.map +1 -0
  171. package/dist/host/detect-git-author.d.ts +26 -0
  172. package/dist/host/detect-git-author.d.ts.map +1 -0
  173. package/dist/host/detect-git-author.js +53 -0
  174. package/dist/host/detect-git-author.js.map +1 -0
  175. package/dist/host/index.d.ts +7 -0
  176. package/dist/host/index.d.ts.map +1 -0
  177. package/dist/host/index.js +7 -0
  178. package/dist/host/index.js.map +1 -0
  179. package/dist/i18n/en.d.ts +8 -0
  180. package/dist/i18n/en.d.ts.map +1 -0
  181. package/dist/i18n/en.js +211 -0
  182. package/dist/i18n/en.js.map +1 -0
  183. package/dist/i18n/field-names.d.ts +95 -0
  184. package/dist/i18n/field-names.d.ts.map +1 -0
  185. package/dist/i18n/field-names.js +329 -0
  186. package/dist/i18n/field-names.js.map +1 -0
  187. package/dist/i18n/index.d.ts +92 -0
  188. package/dist/i18n/index.d.ts.map +1 -0
  189. package/dist/i18n/index.js +135 -0
  190. package/dist/i18n/index.js.map +1 -0
  191. package/dist/i18n/types.d.ts +92 -0
  192. package/dist/i18n/types.d.ts.map +1 -0
  193. package/dist/i18n/types.js +7 -0
  194. package/dist/i18n/types.js.map +1 -0
  195. package/dist/i18n/zh.d.ts +197 -0
  196. package/dist/i18n/zh.d.ts.map +1 -0
  197. package/dist/i18n/zh.js +216 -0
  198. package/dist/i18n/zh.js.map +1 -0
  199. package/dist/importance/index.d.ts +7 -0
  200. package/dist/importance/index.d.ts.map +1 -0
  201. package/dist/importance/index.js +7 -0
  202. package/dist/importance/index.js.map +1 -0
  203. package/dist/importance/vector.d.ts +113 -0
  204. package/dist/importance/vector.d.ts.map +1 -0
  205. package/dist/importance/vector.js +202 -0
  206. package/dist/importance/vector.js.map +1 -0
  207. package/dist/index/digest-builder.d.ts +59 -0
  208. package/dist/index/digest-builder.d.ts.map +1 -0
  209. package/dist/index/digest-builder.js +195 -0
  210. package/dist/index/digest-builder.js.map +1 -0
  211. package/dist/index/graph-builder.d.ts +32 -0
  212. package/dist/index/graph-builder.d.ts.map +1 -0
  213. package/dist/index/graph-builder.js +104 -0
  214. package/dist/index/graph-builder.js.map +1 -0
  215. package/dist/index/incremental.d.ts +31 -0
  216. package/dist/index/incremental.d.ts.map +1 -0
  217. package/dist/index/incremental.js +47 -0
  218. package/dist/index/incremental.js.map +1 -0
  219. package/dist/index/index.d.ts +11 -0
  220. package/dist/index/index.d.ts.map +1 -0
  221. package/dist/index/index.js +11 -0
  222. package/dist/index/index.js.map +1 -0
  223. package/dist/index/orchestrator.d.ts +60 -0
  224. package/dist/index/orchestrator.d.ts.map +1 -0
  225. package/dist/index/orchestrator.js +99 -0
  226. package/dist/index/orchestrator.js.map +1 -0
  227. package/dist/index/types.d.ts +116 -0
  228. package/dist/index/types.d.ts.map +1 -0
  229. package/dist/index/types.js +10 -0
  230. package/dist/index/types.js.map +1 -0
  231. package/dist/index.d.ts +37 -0
  232. package/dist/index.d.ts.map +1 -0
  233. package/dist/index.js +37 -0
  234. package/dist/index.js.map +1 -0
  235. package/dist/learning/index.d.ts +7 -0
  236. package/dist/learning/index.d.ts.map +1 -0
  237. package/dist/learning/index.js +7 -0
  238. package/dist/learning/index.js.map +1 -0
  239. package/dist/learning/loop.d.ts +79 -0
  240. package/dist/learning/loop.d.ts.map +1 -0
  241. package/dist/learning/loop.js +116 -0
  242. package/dist/learning/loop.js.map +1 -0
  243. package/dist/lifecycle/freshness.d.ts +35 -0
  244. package/dist/lifecycle/freshness.d.ts.map +1 -0
  245. package/dist/lifecycle/freshness.js +60 -0
  246. package/dist/lifecycle/freshness.js.map +1 -0
  247. package/dist/lifecycle/index.d.ts +7 -0
  248. package/dist/lifecycle/index.d.ts.map +1 -0
  249. package/dist/lifecycle/index.js +7 -0
  250. package/dist/lifecycle/index.js.map +1 -0
  251. package/dist/lineage/index.d.ts +10 -0
  252. package/dist/lineage/index.d.ts.map +1 -0
  253. package/dist/lineage/index.js +10 -0
  254. package/dist/lineage/index.js.map +1 -0
  255. package/dist/lineage/trace.d.ts +142 -0
  256. package/dist/lineage/trace.d.ts.map +1 -0
  257. package/dist/lineage/trace.js +316 -0
  258. package/dist/lineage/trace.js.map +1 -0
  259. package/dist/maintenance/engine.d.ts +78 -0
  260. package/dist/maintenance/engine.d.ts.map +1 -0
  261. package/dist/maintenance/engine.js +291 -0
  262. package/dist/maintenance/engine.js.map +1 -0
  263. package/dist/maintenance/index.d.ts +8 -0
  264. package/dist/maintenance/index.d.ts.map +1 -0
  265. package/dist/maintenance/index.js +8 -0
  266. package/dist/maintenance/index.js.map +1 -0
  267. package/dist/maintenance/types.d.ts +111 -0
  268. package/dist/maintenance/types.d.ts.map +1 -0
  269. package/dist/maintenance/types.js +24 -0
  270. package/dist/maintenance/types.js.map +1 -0
  271. package/dist/observability/audit-log.d.ts +77 -0
  272. package/dist/observability/audit-log.d.ts.map +1 -0
  273. package/dist/observability/audit-log.js +101 -0
  274. package/dist/observability/audit-log.js.map +1 -0
  275. package/dist/observability/effectiveness-tracker.d.ts +162 -0
  276. package/dist/observability/effectiveness-tracker.d.ts.map +1 -0
  277. package/dist/observability/effectiveness-tracker.js +251 -0
  278. package/dist/observability/effectiveness-tracker.js.map +1 -0
  279. package/dist/observability/index.d.ts +16 -0
  280. package/dist/observability/index.d.ts.map +1 -0
  281. package/dist/observability/index.js +16 -0
  282. package/dist/observability/index.js.map +1 -0
  283. package/dist/observability/necessity-evaluator.d.ts +116 -0
  284. package/dist/observability/necessity-evaluator.d.ts.map +1 -0
  285. package/dist/observability/necessity-evaluator.js +487 -0
  286. package/dist/observability/necessity-evaluator.js.map +1 -0
  287. package/dist/observability/proposal-engine.d.ts +224 -0
  288. package/dist/observability/proposal-engine.d.ts.map +1 -0
  289. package/dist/observability/proposal-engine.js +651 -0
  290. package/dist/observability/proposal-engine.js.map +1 -0
  291. package/dist/perspectives/index.d.ts +7 -0
  292. package/dist/perspectives/index.d.ts.map +1 -0
  293. package/dist/perspectives/index.js +7 -0
  294. package/dist/perspectives/index.js.map +1 -0
  295. package/dist/perspectives/multi-view.d.ts +81 -0
  296. package/dist/perspectives/multi-view.d.ts.map +1 -0
  297. package/dist/perspectives/multi-view.js +221 -0
  298. package/dist/perspectives/multi-view.js.map +1 -0
  299. package/dist/prompt-builder/builder.d.ts +47 -0
  300. package/dist/prompt-builder/builder.d.ts.map +1 -0
  301. package/dist/prompt-builder/builder.js +136 -0
  302. package/dist/prompt-builder/builder.js.map +1 -0
  303. package/dist/prompt-builder/index.d.ts +8 -0
  304. package/dist/prompt-builder/index.d.ts.map +1 -0
  305. package/dist/prompt-builder/index.js +8 -0
  306. package/dist/prompt-builder/index.js.map +1 -0
  307. package/dist/prompt-builder/types.d.ts +42 -0
  308. package/dist/prompt-builder/types.d.ts.map +1 -0
  309. package/dist/prompt-builder/types.js +10 -0
  310. package/dist/prompt-builder/types.js.map +1 -0
  311. package/dist/prompt-signals/cache.d.ts +36 -0
  312. package/dist/prompt-signals/cache.d.ts.map +1 -0
  313. package/dist/prompt-signals/cache.js +70 -0
  314. package/dist/prompt-signals/cache.js.map +1 -0
  315. package/dist/prompt-signals/index.d.ts +12 -0
  316. package/dist/prompt-signals/index.d.ts.map +1 -0
  317. package/dist/prompt-signals/index.js +11 -0
  318. package/dist/prompt-signals/index.js.map +1 -0
  319. package/dist/prompt-signals/stats.d.ts +45 -0
  320. package/dist/prompt-signals/stats.d.ts.map +1 -0
  321. package/dist/prompt-signals/stats.js +119 -0
  322. package/dist/prompt-signals/stats.js.map +1 -0
  323. package/dist/prompt-signals/types.d.ts +53 -0
  324. package/dist/prompt-signals/types.d.ts.map +1 -0
  325. package/dist/prompt-signals/types.js +34 -0
  326. package/dist/prompt-signals/types.js.map +1 -0
  327. package/dist/provenance/index.d.ts +7 -0
  328. package/dist/provenance/index.d.ts.map +1 -0
  329. package/dist/provenance/index.js +7 -0
  330. package/dist/provenance/index.js.map +1 -0
  331. package/dist/provenance/reliability.d.ts +133 -0
  332. package/dist/provenance/reliability.d.ts.map +1 -0
  333. package/dist/provenance/reliability.js +213 -0
  334. package/dist/provenance/reliability.js.map +1 -0
  335. package/dist/reinforcement/config.d.ts +34 -0
  336. package/dist/reinforcement/config.d.ts.map +1 -0
  337. package/dist/reinforcement/config.js +43 -0
  338. package/dist/reinforcement/config.js.map +1 -0
  339. package/dist/reinforcement/index.d.ts +12 -0
  340. package/dist/reinforcement/index.d.ts.map +1 -0
  341. package/dist/reinforcement/index.js +12 -0
  342. package/dist/reinforcement/index.js.map +1 -0
  343. package/dist/reinforcement/ltd.d.ts +59 -0
  344. package/dist/reinforcement/ltd.d.ts.map +1 -0
  345. package/dist/reinforcement/ltd.js +90 -0
  346. package/dist/reinforcement/ltd.js.map +1 -0
  347. package/dist/reinforcement/ltp.d.ts +63 -0
  348. package/dist/reinforcement/ltp.d.ts.map +1 -0
  349. package/dist/reinforcement/ltp.js +99 -0
  350. package/dist/reinforcement/ltp.js.map +1 -0
  351. package/dist/reinforcement/related.d.ts +39 -0
  352. package/dist/reinforcement/related.d.ts.map +1 -0
  353. package/dist/reinforcement/related.js +92 -0
  354. package/dist/reinforcement/related.js.map +1 -0
  355. package/dist/retrieval/filter.d.ts +18 -0
  356. package/dist/retrieval/filter.d.ts.map +1 -0
  357. package/dist/retrieval/filter.js +68 -0
  358. package/dist/retrieval/filter.js.map +1 -0
  359. package/dist/retrieval/fts.d.ts +44 -0
  360. package/dist/retrieval/fts.d.ts.map +1 -0
  361. package/dist/retrieval/fts.js +120 -0
  362. package/dist/retrieval/fts.js.map +1 -0
  363. package/dist/retrieval/index.d.ts +10 -0
  364. package/dist/retrieval/index.d.ts.map +1 -0
  365. package/dist/retrieval/index.js +10 -0
  366. package/dist/retrieval/index.js.map +1 -0
  367. package/dist/retrieval/orchestrator.d.ts +78 -0
  368. package/dist/retrieval/orchestrator.d.ts.map +1 -0
  369. package/dist/retrieval/orchestrator.js +156 -0
  370. package/dist/retrieval/orchestrator.js.map +1 -0
  371. package/dist/retrieval/scoring.d.ts +105 -0
  372. package/dist/retrieval/scoring.d.ts.map +1 -0
  373. package/dist/retrieval/scoring.js +165 -0
  374. package/dist/retrieval/scoring.js.map +1 -0
  375. package/dist/signals/extract.d.ts +98 -0
  376. package/dist/signals/extract.d.ts.map +1 -0
  377. package/dist/signals/extract.js +388 -0
  378. package/dist/signals/extract.js.map +1 -0
  379. package/dist/signals/file-sink.d.ts +81 -0
  380. package/dist/signals/file-sink.d.ts.map +1 -0
  381. package/dist/signals/file-sink.js +227 -0
  382. package/dist/signals/file-sink.js.map +1 -0
  383. package/dist/signals/index.d.ts +12 -0
  384. package/dist/signals/index.d.ts.map +1 -0
  385. package/dist/signals/index.js +12 -0
  386. package/dist/signals/index.js.map +1 -0
  387. package/dist/signals/rpe.d.ts +60 -0
  388. package/dist/signals/rpe.d.ts.map +1 -0
  389. package/dist/signals/rpe.js +68 -0
  390. package/dist/signals/rpe.js.map +1 -0
  391. package/dist/signals/types.d.ts +80 -0
  392. package/dist/signals/types.d.ts.map +1 -0
  393. package/dist/signals/types.js +14 -0
  394. package/dist/signals/types.js.map +1 -0
  395. package/dist/storage/engram-index.d.ts +73 -0
  396. package/dist/storage/engram-index.d.ts.map +1 -0
  397. package/dist/storage/engram-index.js +215 -0
  398. package/dist/storage/engram-index.js.map +1 -0
  399. package/dist/storage/engram-store.d.ts +147 -0
  400. package/dist/storage/engram-store.d.ts.map +1 -0
  401. package/dist/storage/engram-store.js +221 -0
  402. package/dist/storage/engram-store.js.map +1 -0
  403. package/dist/storage/git-stage.d.ts +56 -0
  404. package/dist/storage/git-stage.d.ts.map +1 -0
  405. package/dist/storage/git-stage.js +147 -0
  406. package/dist/storage/git-stage.js.map +1 -0
  407. package/dist/storage/git.d.ts +57 -0
  408. package/dist/storage/git.d.ts.map +1 -0
  409. package/dist/storage/git.js +156 -0
  410. package/dist/storage/git.js.map +1 -0
  411. package/dist/storage/hash.d.ts +23 -0
  412. package/dist/storage/hash.d.ts.map +1 -0
  413. package/dist/storage/hash.js +31 -0
  414. package/dist/storage/hash.js.map +1 -0
  415. package/dist/storage/index.d.ts +14 -0
  416. package/dist/storage/index.d.ts.map +1 -0
  417. package/dist/storage/index.js +14 -0
  418. package/dist/storage/index.js.map +1 -0
  419. package/dist/storage/path.d.ts +51 -0
  420. package/dist/storage/path.d.ts.map +1 -0
  421. package/dist/storage/path.js +72 -0
  422. package/dist/storage/path.js.map +1 -0
  423. package/dist/storage/repository.d.ts +342 -0
  424. package/dist/storage/repository.d.ts.map +1 -0
  425. package/dist/storage/repository.js +1221 -0
  426. package/dist/storage/repository.js.map +1 -0
  427. package/dist/storage/synapse-store.d.ts +113 -0
  428. package/dist/storage/synapse-store.d.ts.map +1 -0
  429. package/dist/storage/synapse-store.js +279 -0
  430. package/dist/storage/synapse-store.js.map +1 -0
  431. package/dist/tools/doctor-tools.d.ts +53 -0
  432. package/dist/tools/doctor-tools.d.ts.map +1 -0
  433. package/dist/tools/doctor-tools.js +97 -0
  434. package/dist/tools/doctor-tools.js.map +1 -0
  435. package/dist/tools/engram-tools.d.ts +166 -0
  436. package/dist/tools/engram-tools.d.ts.map +1 -0
  437. package/dist/tools/engram-tools.js +834 -0
  438. package/dist/tools/engram-tools.js.map +1 -0
  439. package/dist/tools/index.d.ts +16 -0
  440. package/dist/tools/index.d.ts.map +1 -0
  441. package/dist/tools/index.js +16 -0
  442. package/dist/tools/index.js.map +1 -0
  443. package/dist/tools/llm-descriptions.d.ts +61 -0
  444. package/dist/tools/llm-descriptions.d.ts.map +1 -0
  445. package/dist/tools/llm-descriptions.js +556 -0
  446. package/dist/tools/llm-descriptions.js.map +1 -0
  447. package/dist/tools/proposal-tools.d.ts +40 -0
  448. package/dist/tools/proposal-tools.d.ts.map +1 -0
  449. package/dist/tools/proposal-tools.js +99 -0
  450. package/dist/tools/proposal-tools.js.map +1 -0
  451. package/dist/tools/registry.d.ts +30 -0
  452. package/dist/tools/registry.d.ts.map +1 -0
  453. package/dist/tools/registry.js +43 -0
  454. package/dist/tools/registry.js.map +1 -0
  455. package/dist/tools/schemas.d.ts +715 -0
  456. package/dist/tools/schemas.d.ts.map +1 -0
  457. package/dist/tools/schemas.js +383 -0
  458. package/dist/tools/schemas.js.map +1 -0
  459. package/dist/tools/skill-tools.d.ts +26 -0
  460. package/dist/tools/skill-tools.d.ts.map +1 -0
  461. package/dist/tools/skill-tools.js +84 -0
  462. package/dist/tools/skill-tools.js.map +1 -0
  463. package/dist/tools/synapse-tools.d.ts +28 -0
  464. package/dist/tools/synapse-tools.d.ts.map +1 -0
  465. package/dist/tools/synapse-tools.js +177 -0
  466. package/dist/tools/synapse-tools.js.map +1 -0
  467. package/dist/tools/tool.d.ts +84 -0
  468. package/dist/tools/tool.d.ts.map +1 -0
  469. package/dist/tools/tool.js +22 -0
  470. package/dist/tools/tool.js.map +1 -0
  471. package/dist/tools/wrapped.d.ts +28 -0
  472. package/dist/tools/wrapped.d.ts.map +1 -0
  473. package/dist/tools/wrapped.js +172 -0
  474. package/dist/tools/wrapped.js.map +1 -0
  475. package/dist/types/disclosure.d.ts +70 -0
  476. package/dist/types/disclosure.d.ts.map +1 -0
  477. package/dist/types/disclosure.js +9 -0
  478. package/dist/types/disclosure.js.map +1 -0
  479. package/dist/types/engram.d.ts +203 -0
  480. package/dist/types/engram.d.ts.map +1 -0
  481. package/dist/types/engram.js +7 -0
  482. package/dist/types/engram.js.map +1 -0
  483. package/dist/types/index.d.ts +15 -0
  484. package/dist/types/index.d.ts.map +1 -0
  485. package/dist/types/index.js +15 -0
  486. package/dist/types/index.js.map +1 -0
  487. package/dist/types/intention.d.ts +91 -0
  488. package/dist/types/intention.d.ts.map +1 -0
  489. package/dist/types/intention.js +9 -0
  490. package/dist/types/intention.js.map +1 -0
  491. package/dist/types/repository-types.d.ts +113 -0
  492. package/dist/types/repository-types.d.ts.map +1 -0
  493. package/dist/types/repository-types.js +18 -0
  494. package/dist/types/repository-types.js.map +1 -0
  495. package/dist/types/scene.d.ts +52 -0
  496. package/dist/types/scene.d.ts.map +1 -0
  497. package/dist/types/scene.js +12 -0
  498. package/dist/types/scene.js.map +1 -0
  499. package/dist/types/skill.d.ts +107 -0
  500. package/dist/types/skill.d.ts.map +1 -0
  501. package/dist/types/skill.js +10 -0
  502. package/dist/types/skill.js.map +1 -0
  503. package/dist/types/slugify.d.ts +34 -0
  504. package/dist/types/slugify.d.ts.map +1 -0
  505. package/dist/types/slugify.js +55 -0
  506. package/dist/types/slugify.js.map +1 -0
  507. package/dist/types/synapse-id.d.ts +22 -0
  508. package/dist/types/synapse-id.d.ts.map +1 -0
  509. package/dist/types/synapse-id.js +34 -0
  510. package/dist/types/synapse-id.js.map +1 -0
  511. package/dist/types/synapse.d.ts +99 -0
  512. package/dist/types/synapse.d.ts.map +1 -0
  513. package/dist/types/synapse.js +9 -0
  514. package/dist/types/synapse.js.map +1 -0
  515. package/dist/verification/index.d.ts +11 -0
  516. package/dist/verification/index.d.ts.map +1 -0
  517. package/dist/verification/index.js +11 -0
  518. package/dist/verification/index.js.map +1 -0
  519. package/dist/verification/metacognition.d.ts +102 -0
  520. package/dist/verification/metacognition.d.ts.map +1 -0
  521. package/dist/verification/metacognition.js +284 -0
  522. package/dist/verification/metacognition.js.map +1 -0
  523. package/dist/verification/state-machine.d.ts +77 -0
  524. package/dist/verification/state-machine.d.ts.map +1 -0
  525. package/dist/verification/state-machine.js +126 -0
  526. package/dist/verification/state-machine.js.map +1 -0
  527. package/dist/verification/upgrade.d.ts +133 -0
  528. package/dist/verification/upgrade.d.ts.map +1 -0
  529. package/dist/verification/upgrade.js +364 -0
  530. package/dist/verification/upgrade.js.map +1 -0
  531. package/package.json +70 -0
@@ -0,0 +1,196 @@
1
+ /**
2
+ * Adaptive Disclosure:按预算自动选择 tier
3
+ *
4
+ * 实现 spec 3.2 的 adaptiveDisclosure 伪代码:
5
+ *
6
+ * candidates = semanticSearch(query)
7
+ * loaded = { c.id: c.toCatalogEntry() for c in candidates } // 阶段 1
8
+ * for c in sortByScore(candidates): // 阶段 2
9
+ * if budget.remaining > c.digestSize:
10
+ * upgrade(c, 'digest')
11
+ * for c in topK(candidates, k=adaptive): // 阶段 3
12
+ * if budget.remaining > c.contentSize:
13
+ * upgrade(c, 'content')
14
+ * // 阶段 4:meta/synapse 由 agent 显式请求
15
+ *
16
+ * 关键特性:
17
+ * - 每个 engram 独立决定 tier(不是全量分层)
18
+ * - budget 不可用时(remaining ≤ 0)停止升级
19
+ * - 相同输入产生相同输出(prompt cache 友好)
20
+ *
21
+ * @module @co-engram/core/disclosure
22
+ */
23
+ import { consume, hasBudget } from "./budget.js";
24
+ import { estimateViewSize, loadView, viewIdOf } from "./tier-loader.js";
25
+ const EMPTY_BREAKDOWN = {
26
+ catalog: 0,
27
+ digest: 0,
28
+ content: 0,
29
+ meta: 0,
30
+ synapses: 0,
31
+ };
32
+ /**
33
+ * 执行自适应披露
34
+ *
35
+ * 算法(严格按 spec 顺序):
36
+ * 1. 所有候选加载为 catalog
37
+ * 2. 按 score 倒序,逐个升级到 digest(若预算够)
38
+ * 3. Top-K(默认 min(5, len))升级到 content(若预算够)
39
+ * 4. meta/synapse 留给 agent 显式请求
40
+ *
41
+ * 顺序稳定性:同 score 的 candidates 保持原数组顺序(稳定排序)。
42
+ */
43
+ export function adaptiveDisclosure(input) {
44
+ const { repository, candidates, digestLines, budget, topK, maxDigestUpgrades, } = input;
45
+ const breakdown = { ...EMPTY_BREAKDOWN };
46
+ // 候选索引,便于阶段 2/3 复用
47
+ const workingBudget = { ...budget };
48
+ const views = new Map();
49
+ let tokensUsed = 0;
50
+ // ---- 阶段 1:全部 catalog ----
51
+ for (const c of candidates) {
52
+ const line = digestLines[c.id];
53
+ const size = estimateViewSize("catalog", line ?? {});
54
+ if (!hasBudget(workingBudget, size)) {
55
+ // 预算不足以容纳 catalog:直接跳过(不入结果)
56
+ continue;
57
+ }
58
+ const view = safeLoad(repository, c.id, "catalog");
59
+ if (!view)
60
+ continue;
61
+ views.set(c.id, view);
62
+ workingBudget.remaining -= size;
63
+ tokensUsed += size;
64
+ breakdown.catalog += 1;
65
+ }
66
+ let reachedStage = 1;
67
+ if (views.size === 0) {
68
+ return finalize(views, candidates, tokensUsed, workingBudget.remaining, breakdown, reachedStage);
69
+ }
70
+ // ---- 阶段 2:digest 升级 ----
71
+ const sortedByScore = stableSortByScoreDesc(candidates);
72
+ const digestCap = maxDigestUpgrades !== undefined
73
+ ? Math.max(0, maxDigestUpgrades)
74
+ : Number.POSITIVE_INFINITY;
75
+ let digestUpgraded = 0;
76
+ for (const c of sortedByScore) {
77
+ if (digestUpgraded >= digestCap)
78
+ break;
79
+ const line = digestLines[c.id];
80
+ const size = estimateViewSize("digest", line ?? {});
81
+ if (!hasBudget(workingBudget, size))
82
+ break;
83
+ const view = safeLoad(repository, c.id, "digest");
84
+ if (!view)
85
+ continue;
86
+ // catalog → digest:补差额(digest 大小 - catalog 大小)
87
+ const catalogSize = estimateViewSize("catalog", line ?? {});
88
+ workingBudget.remaining -= size - catalogSize;
89
+ tokensUsed += size - catalogSize;
90
+ views.set(c.id, view);
91
+ breakdown.catalog -= 1;
92
+ breakdown.digest += 1;
93
+ digestUpgraded += 1;
94
+ }
95
+ if (breakdown.digest > 0) {
96
+ reachedStage = 2;
97
+ }
98
+ // ---- 阶段 3:top-K content 升级 ----
99
+ const k = Math.min(topK ?? DEFAULT_TOP_K, sortedByScore.length);
100
+ for (let i = 0; i < k; i++) {
101
+ const c = sortedByScore[i];
102
+ if (!c)
103
+ break;
104
+ const line = digestLines[c.id];
105
+ const size = estimateViewSize("content", line ?? {});
106
+ if (!hasBudget(workingBudget, size))
107
+ break;
108
+ const view = safeLoad(repository, c.id, "content");
109
+ if (!view)
110
+ continue;
111
+ // digest → content:补差额
112
+ const digestSize = estimateViewSize("digest", line ?? {});
113
+ workingBudget.remaining -= size - digestSize;
114
+ tokensUsed += size - digestSize;
115
+ views.set(c.id, view);
116
+ breakdown.digest -= 1;
117
+ breakdown.content += 1;
118
+ }
119
+ if (breakdown.content > 0) {
120
+ reachedStage = 3;
121
+ }
122
+ return finalize(views, candidates, tokensUsed, workingBudget.remaining, breakdown, reachedStage);
123
+ }
124
+ const DEFAULT_TOP_K = 5;
125
+ function safeLoad(repo, id, tier) {
126
+ try {
127
+ return loadView(repo, id, tier);
128
+ }
129
+ catch {
130
+ return null;
131
+ }
132
+ }
133
+ function stableSortByScoreDesc(candidates) {
134
+ return [...candidates]
135
+ .map((c, idx) => ({ c, idx }))
136
+ .sort((a, b) => {
137
+ if (a.c.score !== b.c.score)
138
+ return b.c.score - a.c.score;
139
+ return a.idx - b.idx; // 稳定排序
140
+ })
141
+ .map((x) => x.c);
142
+ }
143
+ function finalize(views, candidates, tokensUsed, budgetRemaining, breakdown, reachedStage) {
144
+ const loaded = [];
145
+ for (const c of candidates) {
146
+ const view = views.get(c.id);
147
+ if (view) {
148
+ loaded.push({ id: c.id, score: c.score, view });
149
+ }
150
+ }
151
+ return {
152
+ loaded,
153
+ tokensUsed,
154
+ budgetRemaining,
155
+ tierBreakdown: breakdown,
156
+ reachedStage,
157
+ };
158
+ }
159
+ /**
160
+ * 在自适应结果之上,按 agent 请求升级单个 engram 到指定 tier
161
+ *
162
+ * 用于阶段 4(meta / synapse)的按需请求。
163
+ */
164
+ export function upgradeSingle(repository, current, target, budget) {
165
+ const size = estimateViewSize(target, viewPreview(current));
166
+ if (!hasBudget(budget, size)) {
167
+ return { view: current, budget, tierChanged: false };
168
+ }
169
+ const id = viewIdOf(current);
170
+ if (!id) {
171
+ return { view: current, budget, tierChanged: false };
172
+ }
173
+ try {
174
+ const view = loadView(repository, id, target);
175
+ return { view, budget: consume(budget, size), tierChanged: true };
176
+ }
177
+ catch {
178
+ return { view: current, budget, tierChanged: false };
179
+ }
180
+ }
181
+ function viewPreview(view) {
182
+ switch (view.tier) {
183
+ case "digest":
184
+ return { contentSize: view.digest.contentSize };
185
+ case "content":
186
+ return { contentSize: view.content.length };
187
+ case "synapses":
188
+ return {
189
+ outgoingCount: view.bundle.outgoing.length,
190
+ incomingCount: view.bundle.incoming.length,
191
+ };
192
+ default:
193
+ return {};
194
+ }
195
+ }
196
+ //# sourceMappingURL=adaptive.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adaptive.js","sourceRoot":"","sources":["../../src/disclosure/adaptive.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Context Window 预算管理
3
+ *
4
+ * 用于 adaptiveDisclosure 的预算跟踪:每个 tier 升级都要消耗 token,
5
+ * 一旦超出预算就停留在当前层。
6
+ *
7
+ * P1 简化策略:
8
+ * - 中文按 1 char ≈ 1 token 估算
9
+ * - 英文/数字按 ~4 char ≈ 1 token 估算
10
+ * - 结构化字段(id/title/tags)额外计入 ~10 token 的 wrapper 开销
11
+ *
12
+ * 后续可换成准确的 tokenizer(如 tiktoken / @anthropic-ai/tokenizer)。
13
+ *
14
+ * @module @co-engram/core/disclosure
15
+ */
16
+ /**
17
+ * 估算字符串消耗的 token 数(向上取整)
18
+ *
19
+ * - 中文字符:1 char ≈ 1 token
20
+ * - 其他字符(含空格标点):4 char ≈ 1 token
21
+ */
22
+ export declare function estimateTokens(text: string): number;
23
+ /**
24
+ * 创建预算
25
+ *
26
+ * @param totalTokens - 总预算(如 4096 / 32768 / 128000)
27
+ * @param reserved - 已被其他内容占用(系统提示词、历史对话)
28
+ */
29
+ export declare function createBudget(totalTokens: number, reserved?: number): ContextBudget;
30
+ /**
31
+ * 消耗一定 token,返回新预算(不修改原对象)
32
+ *
33
+ * remaining 不会变负,最低为 0
34
+ */
35
+ export declare function consume(budget: ContextBudget, tokens: number): ContextBudget;
36
+ /**
37
+ * 判断预算是否够用
38
+ */
39
+ export declare function hasBudget(budget: ContextBudget, tokens: number): boolean;
40
+ /**
41
+ * 预算耗尽
42
+ */
43
+ export declare function isExhausted(budget: ContextBudget): boolean;
44
+ /**
45
+ * 预算使用率 [0,1]
46
+ */
47
+ export declare function utilization(budget: ContextBudget): number;
48
+ /** 重新导出类型,避免调用方跨包 import */
49
+ export type { ContextBudget } from "../types/disclosure.js";
50
+ import type { ContextBudget } from "../types/disclosure.js";
51
+ //# sourceMappingURL=budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/disclosure/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,aAAa,CAY7E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAM5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAIzD;AAED,4BAA4B;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,91 @@
1
+ /**
2
+ * Context Window 预算管理
3
+ *
4
+ * 用于 adaptiveDisclosure 的预算跟踪:每个 tier 升级都要消耗 token,
5
+ * 一旦超出预算就停留在当前层。
6
+ *
7
+ * P1 简化策略:
8
+ * - 中文按 1 char ≈ 1 token 估算
9
+ * - 英文/数字按 ~4 char ≈ 1 token 估算
10
+ * - 结构化字段(id/title/tags)额外计入 ~10 token 的 wrapper 开销
11
+ *
12
+ * 后续可换成准确的 tokenizer(如 tiktoken / @anthropic-ai/tokenizer)。
13
+ *
14
+ * @module @co-engram/core/disclosure
15
+ */
16
+ /** CJK 字符检测(包含常见汉字扩展区) */
17
+ const CJK_REGEX = /[㐀-鿿豈-﫿\u{20000}-\u{2a6df}\u{2a700}-\u{2ebef}]/u;
18
+ /**
19
+ * 估算字符串消耗的 token 数(向上取整)
20
+ *
21
+ * - 中文字符:1 char ≈ 1 token
22
+ * - 其他字符(含空格标点):4 char ≈ 1 token
23
+ */
24
+ export function estimateTokens(text) {
25
+ if (!text)
26
+ return 0;
27
+ let cjk = 0;
28
+ let other = 0;
29
+ for (const ch of text) {
30
+ if (CJK_REGEX.test(ch)) {
31
+ cjk += 1;
32
+ }
33
+ else {
34
+ other += 1;
35
+ }
36
+ }
37
+ return Math.ceil(cjk + other / 4);
38
+ }
39
+ /**
40
+ * 创建预算
41
+ *
42
+ * @param totalTokens - 总预算(如 4096 / 32768 / 128000)
43
+ * @param reserved - 已被其他内容占用(系统提示词、历史对话)
44
+ */
45
+ export function createBudget(totalTokens, reserved = 0) {
46
+ if (totalTokens < 0) {
47
+ throw new Error(`totalTokens must be >= 0, got ${totalTokens}`);
48
+ }
49
+ if (reserved < 0 || reserved > totalTokens) {
50
+ throw new Error(`reserved must be in [0, totalTokens], got ${reserved}`);
51
+ }
52
+ return {
53
+ totalTokens,
54
+ reserved,
55
+ remaining: totalTokens - reserved,
56
+ };
57
+ }
58
+ /**
59
+ * 消耗一定 token,返回新预算(不修改原对象)
60
+ *
61
+ * remaining 不会变负,最低为 0
62
+ */
63
+ export function consume(budget, tokens) {
64
+ if (tokens < 0) {
65
+ throw new Error(`tokens to consume must be >= 0, got ${tokens}`);
66
+ }
67
+ const remaining = Math.max(0, budget.remaining - tokens);
68
+ return { ...budget, remaining };
69
+ }
70
+ /**
71
+ * 判断预算是否够用
72
+ */
73
+ export function hasBudget(budget, tokens) {
74
+ return budget.remaining >= tokens;
75
+ }
76
+ /**
77
+ * 预算耗尽
78
+ */
79
+ export function isExhausted(budget) {
80
+ return budget.remaining <= 0;
81
+ }
82
+ /**
83
+ * 预算使用率 [0,1]
84
+ */
85
+ export function utilization(budget) {
86
+ if (budget.totalTokens <= 0)
87
+ return 0;
88
+ const used = budget.totalTokens - budget.remaining;
89
+ return used / budget.totalTokens;
90
+ }
91
+ //# sourceMappingURL=budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/disclosure/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0BAA0B;AAC1B,MAAM,SAAS,GAAG,iDAAiD,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,QAAQ,GAAG,CAAC;IAC5D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO;QACL,WAAW;QACX,QAAQ;QACR,SAAS,EAAE,WAAW,GAAG,QAAQ;KAClC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,MAAc;IAC3D,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;IACzD,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,MAAc;IAC7D,OAAO,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,OAAO,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC;IACnD,OAAO,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;AACnC,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Disclosure 模块 barrel
3
+ *
4
+ * adaptiveDisclosure + tier-loader + budget
5
+ *
6
+ * @module @co-engram/core/disclosure
7
+ */
8
+ export * from "./budget.js";
9
+ export * from "./tier-loader.js";
10
+ export * from "./adaptive.js";
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Disclosure 模块 barrel
3
+ *
4
+ * adaptiveDisclosure + tier-loader + budget
5
+ *
6
+ * @module @co-engram/core/disclosure
7
+ */
8
+ export * from "./budget.js";
9
+ export * from "./tier-loader.js";
10
+ export * from "./adaptive.js";
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Tier Loader:按需加载 EngramView
3
+ *
4
+ * 把 engram-tools 里的 readEngramView 逻辑提取出来,
5
+ * 给 disclosure 模块复用,并加 token 估算。
6
+ *
7
+ * 升级路径:Catalog → Digest → Content → Meta → Synapse
8
+ * - Catalog:仅 id/title/kind/domainTags(~50 token)
9
+ * - Digest:+ summary/importance/freshness(~120 token)
10
+ * - Content:+ 完整 Markdown(变长)
11
+ * - Meta:+ 全部 meta 字段(除 content)
12
+ * - Synapse:+ outgoing/incoming/neighborDigests
13
+ *
14
+ * @module @co-engram/core/disclosure
15
+ */
16
+ import type { EngramId } from "../types/engram.js";
17
+ import type { DisclosureTier, EngramView } from "../types/disclosure.js";
18
+ import type { EngramRepository } from "../storage/repository.js";
19
+ /**
20
+ * 视图大小估算(单位:token)
21
+ *
22
+ * 用于 budget 检查;与实际序列化后的 token 数会有误差,
23
+ * 但数量级一致。
24
+ */
25
+ export declare function estimateViewSize(tier: DisclosureTier, preview: {
26
+ contentSize?: number;
27
+ outgoingCount?: number;
28
+ incomingCount?: number;
29
+ }): number;
30
+ /**
31
+ * 按 tier 加载 EngramView
32
+ *
33
+ * 与 engram-tools.readEngramView 行为一致,
34
+ * 但单独导出便于 disclosure 模块和未来 agent 复用。
35
+ */
36
+ export declare function loadView(repo: EngramRepository, id: EngramId, tier: DisclosureTier): EngramView;
37
+ /**
38
+ * 比较两个 tier 的"粒度等级"
39
+ *
40
+ * 返回:负数表示 a < b,0 表示相等,正数表示 a > b
41
+ */
42
+ export declare function compareTier(a: DisclosureTier, b: DisclosureTier): number;
43
+ /**
44
+ * 从 EngramView 提取 engram id
45
+ */
46
+ export declare function viewIdOf(view: EngramView): EngramId;
47
+ /**
48
+ * 升级视图到更高 tier
49
+ *
50
+ * 若 target 粒度低于或等于 current,直接返回 current(不降级)。
51
+ */
52
+ export declare function upgradeView(repo: EngramRepository, current: EngramView, target: DisclosureTier): {
53
+ view: EngramView;
54
+ tierChanged: boolean;
55
+ };
56
+ /** 估算已加载视图的 token 数(实际序列化后) */
57
+ export declare function estimateLoadedTokens(view: EngramView): number;
58
+ //# sourceMappingURL=tier-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tier-loader.d.ts","sourceRoot":"","sources":["../../src/disclosure/tier-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAIV,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,MAAM,CAuBR;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,cAAc,GACnB,UAAU,CA+CZ;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,cAAc,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAS5C;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAgC7D"}
@@ -0,0 +1,205 @@
1
+ /**
2
+ * Tier Loader:按需加载 EngramView
3
+ *
4
+ * 把 engram-tools 里的 readEngramView 逻辑提取出来,
5
+ * 给 disclosure 模块复用,并加 token 估算。
6
+ *
7
+ * 升级路径:Catalog → Digest → Content → Meta → Synapse
8
+ * - Catalog:仅 id/title/kind/domainTags(~50 token)
9
+ * - Digest:+ summary/importance/freshness(~120 token)
10
+ * - Content:+ 完整 Markdown(变长)
11
+ * - Meta:+ 全部 meta 字段(除 content)
12
+ * - Synapse:+ outgoing/incoming/neighborDigests
13
+ *
14
+ * @module @co-engram/core/disclosure
15
+ */
16
+ import { estimateTokens } from "./budget.js";
17
+ /**
18
+ * 视图大小估算(单位:token)
19
+ *
20
+ * 用于 budget 检查;与实际序列化后的 token 数会有误差,
21
+ * 但数量级一致。
22
+ */
23
+ export function estimateViewSize(tier, preview) {
24
+ const contentTokens = preview.contentSize
25
+ ? Math.ceil(preview.contentSize / 2)
26
+ : 0;
27
+ const edgeTokens = (preview.outgoingCount ?? 0) + (preview.incomingCount ?? 0);
28
+ switch (tier) {
29
+ case "catalog":
30
+ // id + title + kind + domainTags ~ 30-60 token
31
+ return 50;
32
+ case "digest":
33
+ // + summary + importance + freshness
34
+ return 120;
35
+ case "content":
36
+ // digest + 完整正文
37
+ return 120 + contentTokens;
38
+ case "meta":
39
+ // digest + 所有 meta 字段
40
+ return 300;
41
+ case "synapses":
42
+ // digest + edges + neighbor digests
43
+ return 120 + edgeTokens * 20;
44
+ }
45
+ }
46
+ /**
47
+ * 按 tier 加载 EngramView
48
+ *
49
+ * 与 engram-tools.readEngramView 行为一致,
50
+ * 但单独导出便于 disclosure 模块和未来 agent 复用。
51
+ */
52
+ export function loadView(repo, id, tier) {
53
+ switch (tier) {
54
+ case "catalog": {
55
+ const entry = repo.readCatalogEntry(id);
56
+ if (!entry)
57
+ throw new Error(`Engram not found: ${id}`);
58
+ return { tier: "catalog", entry };
59
+ }
60
+ case "digest": {
61
+ const digest = repo.readDigest(id);
62
+ if (!digest)
63
+ throw new Error(`Engram not found: ${id}`);
64
+ return { tier: "digest", digest };
65
+ }
66
+ case "content": {
67
+ const engram = repo.readEngram(id);
68
+ return {
69
+ tier: "content",
70
+ entry: toCatalogEntry(engram),
71
+ content: engram.content,
72
+ };
73
+ }
74
+ case "meta": {
75
+ const engram = repo.readEngram(id);
76
+ return {
77
+ tier: "meta",
78
+ entry: toCatalogEntry(engram),
79
+ meta: stripContentFromMeta(engram),
80
+ };
81
+ }
82
+ case "synapses": {
83
+ const entry = repo.readCatalogEntry(id);
84
+ if (!entry)
85
+ throw new Error(`Engram not found: ${id}`);
86
+ const outgoingFile = repo.readSynapses(id);
87
+ const incoming = collectIncoming(repo, id);
88
+ const neighborDigests = collectNeighborDigests(repo, outgoingFile.outgoing, incoming);
89
+ const bundle = {
90
+ engramId: id,
91
+ outgoing: outgoingFile.outgoing,
92
+ incoming,
93
+ neighborDigests,
94
+ };
95
+ return { tier: "synapses", bundle };
96
+ }
97
+ }
98
+ }
99
+ /** tier 排序:catalog < digest < content/meta < synapses */
100
+ const TIER_ORDER = [
101
+ "catalog",
102
+ "digest",
103
+ "content",
104
+ "meta",
105
+ "synapses",
106
+ ];
107
+ /**
108
+ * 比较两个 tier 的"粒度等级"
109
+ *
110
+ * 返回:负数表示 a < b,0 表示相等,正数表示 a > b
111
+ */
112
+ export function compareTier(a, b) {
113
+ return TIER_ORDER.indexOf(a) - TIER_ORDER.indexOf(b);
114
+ }
115
+ /**
116
+ * 从 EngramView 提取 engram id
117
+ */
118
+ export function viewIdOf(view) {
119
+ switch (view.tier) {
120
+ case "catalog":
121
+ return view.entry.id;
122
+ case "digest":
123
+ return view.digest.id;
124
+ case "content":
125
+ case "meta":
126
+ return view.entry.id;
127
+ case "synapses":
128
+ return view.bundle.engramId;
129
+ }
130
+ }
131
+ /**
132
+ * 升级视图到更高 tier
133
+ *
134
+ * 若 target 粒度低于或等于 current,直接返回 current(不降级)。
135
+ */
136
+ export function upgradeView(repo, current, target) {
137
+ const currentId = viewIdOf(current);
138
+ if (compareTier(target, current.tier) <= 0) {
139
+ return { view: current, tierChanged: false };
140
+ }
141
+ return {
142
+ view: loadView(repo, currentId, target),
143
+ tierChanged: true,
144
+ };
145
+ }
146
+ /** 估算已加载视图的 token 数(实际序列化后) */
147
+ export function estimateLoadedTokens(view) {
148
+ switch (view.tier) {
149
+ case "catalog":
150
+ return (estimateTokens(view.entry.id) + estimateTokens(view.entry.title) + 10);
151
+ case "digest":
152
+ return (estimateTokens(view.digest.id) +
153
+ estimateTokens(view.digest.title) +
154
+ estimateTokens(view.digest.summary) +
155
+ 20);
156
+ case "content":
157
+ return (estimateTokens(view.entry.id) +
158
+ estimateTokens(view.entry.title) +
159
+ estimateTokens(view.content) +
160
+ 20);
161
+ case "meta":
162
+ return estimateTokens(JSON.stringify(view.meta));
163
+ case "synapses": {
164
+ const neighborTokens = view.bundle.neighborDigests.reduce((sum, d) => sum + estimateTokens(d.title) + estimateTokens(d.summary), 0);
165
+ const edgeTokens = (view.bundle.outgoing.length + view.bundle.incoming.length) * 15;
166
+ return neighborTokens + edgeTokens + 30;
167
+ }
168
+ }
169
+ }
170
+ // ============================================================
171
+ // 内部辅助(与 engram-tools.ts 保持一致,未来可合并)
172
+ // ============================================================
173
+ function toCatalogEntry(engram) {
174
+ return {
175
+ id: engram.id,
176
+ title: engram.title,
177
+ kind: engram.kind,
178
+ domainTags: engram.domainTags,
179
+ };
180
+ }
181
+ function stripContentFromMeta(engram) {
182
+ const { content: _content, ...rest } = engram;
183
+ return rest;
184
+ }
185
+ function collectIncoming(repo, id) {
186
+ const all = repo.collectAllSynapses();
187
+ return all
188
+ .filter(({ synapse }) => synapse.to === id)
189
+ .map(({ synapse }) => synapse);
190
+ }
191
+ function collectNeighborDigests(repo, outgoing, incoming) {
192
+ const neighborIds = new Set();
193
+ for (const s of outgoing)
194
+ neighborIds.add(s.to);
195
+ for (const s of incoming)
196
+ neighborIds.add(s.from);
197
+ const digests = [];
198
+ for (const nid of neighborIds) {
199
+ const d = repo.readDigest(nid);
200
+ if (d)
201
+ digests.push(d);
202
+ }
203
+ return digests;
204
+ }
205
+ //# sourceMappingURL=tier-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tier-loader.js","sourceRoot":"","sources":["../../src/disclosure/tier-loader.ts"],"names":[],"mappings":"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"}