daftari 3.7.0 → 3.9.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 (248) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +4 -0
  3. package/dist/access/rbac.d.ts +1 -0
  4. package/dist/access/rbac.d.ts.map +1 -1
  5. package/dist/access/rbac.js +8 -0
  6. package/dist/access/rbac.js.map +1 -1
  7. package/dist/board/board.d.ts +37 -0
  8. package/dist/board/board.d.ts.map +1 -0
  9. package/dist/board/board.js +233 -0
  10. package/dist/board/board.js.map +1 -0
  11. package/dist/board/board.test.d.ts +2 -0
  12. package/dist/board/board.test.d.ts.map +1 -0
  13. package/dist/board/board.test.js +753 -0
  14. package/dist/board/board.test.js.map +1 -0
  15. package/dist/board/dormancy.test.d.ts +2 -0
  16. package/dist/board/dormancy.test.d.ts.map +1 -0
  17. package/dist/board/dormancy.test.js +79 -0
  18. package/dist/board/dormancy.test.js.map +1 -0
  19. package/dist/board/identity.d.ts +5 -0
  20. package/dist/board/identity.d.ts.map +1 -0
  21. package/dist/board/identity.js +146 -0
  22. package/dist/board/identity.js.map +1 -0
  23. package/dist/board/identity.test.d.ts +2 -0
  24. package/dist/board/identity.test.d.ts.map +1 -0
  25. package/dist/board/identity.test.js +291 -0
  26. package/dist/board/identity.test.js.map +1 -0
  27. package/dist/board/ledger.d.ts +41 -0
  28. package/dist/board/ledger.d.ts.map +1 -0
  29. package/dist/board/ledger.js +197 -0
  30. package/dist/board/ledger.js.map +1 -0
  31. package/dist/board/ledger.test.d.ts +2 -0
  32. package/dist/board/ledger.test.d.ts.map +1 -0
  33. package/dist/board/ledger.test.js +873 -0
  34. package/dist/board/ledger.test.js.map +1 -0
  35. package/dist/board/principals.d.ts +4 -0
  36. package/dist/board/principals.d.ts.map +1 -0
  37. package/dist/board/principals.js +37 -0
  38. package/dist/board/principals.js.map +1 -0
  39. package/dist/board/principals.test.d.ts +2 -0
  40. package/dist/board/principals.test.d.ts.map +1 -0
  41. package/dist/board/principals.test.js +296 -0
  42. package/dist/board/principals.test.js.map +1 -0
  43. package/dist/board/reconcile.d.ts +12 -0
  44. package/dist/board/reconcile.d.ts.map +1 -0
  45. package/dist/board/reconcile.js +293 -0
  46. package/dist/board/reconcile.js.map +1 -0
  47. package/dist/board/reconcile.test.d.ts +2 -0
  48. package/dist/board/reconcile.test.d.ts.map +1 -0
  49. package/dist/board/reconcile.test.js +788 -0
  50. package/dist/board/reconcile.test.js.map +1 -0
  51. package/dist/board/sources/index.d.ts +24 -0
  52. package/dist/board/sources/index.d.ts.map +1 -0
  53. package/dist/board/sources/index.js +64 -0
  54. package/dist/board/sources/index.js.map +1 -0
  55. package/dist/board/sources/lint.d.ts +3 -0
  56. package/dist/board/sources/lint.d.ts.map +1 -0
  57. package/dist/board/sources/lint.js +218 -0
  58. package/dist/board/sources/lint.js.map +1 -0
  59. package/dist/board/sources/lint.test.d.ts +2 -0
  60. package/dist/board/sources/lint.test.d.ts.map +1 -0
  61. package/dist/board/sources/lint.test.js +616 -0
  62. package/dist/board/sources/lint.test.js.map +1 -0
  63. package/dist/board/sources/staged.d.ts +3 -0
  64. package/dist/board/sources/staged.d.ts.map +1 -0
  65. package/dist/board/sources/staged.js +116 -0
  66. package/dist/board/sources/staged.js.map +1 -0
  67. package/dist/board/sources/staged.test.d.ts +2 -0
  68. package/dist/board/sources/staged.test.d.ts.map +1 -0
  69. package/dist/board/sources/staged.test.js +418 -0
  70. package/dist/board/sources/staged.test.js.map +1 -0
  71. package/dist/board/sources/staleness.d.ts +43 -0
  72. package/dist/board/sources/staleness.d.ts.map +1 -0
  73. package/dist/board/sources/staleness.js +346 -0
  74. package/dist/board/sources/staleness.js.map +1 -0
  75. package/dist/board/sources/staleness.test.d.ts +2 -0
  76. package/dist/board/sources/staleness.test.d.ts.map +1 -0
  77. package/dist/board/sources/staleness.test.js +923 -0
  78. package/dist/board/sources/staleness.test.js.map +1 -0
  79. package/dist/board/sources/tension.d.ts +3 -0
  80. package/dist/board/sources/tension.d.ts.map +1 -0
  81. package/dist/board/sources/tension.js +152 -0
  82. package/dist/board/sources/tension.js.map +1 -0
  83. package/dist/board/sources/tension.test.d.ts +2 -0
  84. package/dist/board/sources/tension.test.d.ts.map +1 -0
  85. package/dist/board/sources/tension.test.js +440 -0
  86. package/dist/board/sources/tension.test.js.map +1 -0
  87. package/dist/board/sources/tier2.d.ts +17 -0
  88. package/dist/board/sources/tier2.d.ts.map +1 -0
  89. package/dist/board/sources/tier2.js +233 -0
  90. package/dist/board/sources/tier2.js.map +1 -0
  91. package/dist/board/sources/tier2.test.d.ts +2 -0
  92. package/dist/board/sources/tier2.test.d.ts.map +1 -0
  93. package/dist/board/sources/tier2.test.js +480 -0
  94. package/dist/board/sources/tier2.test.js.map +1 -0
  95. package/dist/board/types.d.ts +161 -0
  96. package/dist/board/types.d.ts.map +1 -0
  97. package/dist/board/types.js +37 -0
  98. package/dist/board/types.js.map +1 -0
  99. package/dist/canon/index.d.ts +3 -1
  100. package/dist/canon/index.d.ts.map +1 -1
  101. package/dist/canon/index.js +35 -8
  102. package/dist/canon/index.js.map +1 -1
  103. package/dist/canon/types.d.ts +3 -0
  104. package/dist/canon/types.d.ts.map +1 -1
  105. package/dist/cli.d.ts.map +1 -1
  106. package/dist/cli.js +9 -0
  107. package/dist/cli.js.map +1 -1
  108. package/dist/consolidate/birth.d.ts +1 -1
  109. package/dist/consolidate/birth.d.ts.map +1 -1
  110. package/dist/consolidate/birth.js +22 -0
  111. package/dist/consolidate/birth.js.map +1 -1
  112. package/dist/consolidate/edge-write.d.ts +11 -0
  113. package/dist/consolidate/edge-write.d.ts.map +1 -1
  114. package/dist/consolidate/edge-write.js +41 -0
  115. package/dist/consolidate/edge-write.js.map +1 -1
  116. package/dist/consolidate/index.js +5 -2
  117. package/dist/consolidate/index.js.map +1 -1
  118. package/dist/consolidate/revision.d.ts +4 -2
  119. package/dist/consolidate/revision.d.ts.map +1 -1
  120. package/dist/consolidate/revision.js +23 -0
  121. package/dist/consolidate/revision.js.map +1 -1
  122. package/dist/curation/edge-staleness.d.ts +4 -2
  123. package/dist/curation/edge-staleness.d.ts.map +1 -1
  124. package/dist/curation/edge-staleness.js +36 -3
  125. package/dist/curation/edge-staleness.js.map +1 -1
  126. package/dist/curation/edges.d.ts +7 -0
  127. package/dist/curation/edges.d.ts.map +1 -1
  128. package/dist/curation/edges.js +13 -7
  129. package/dist/curation/edges.js.map +1 -1
  130. package/dist/curation/tension-access.d.ts +1 -0
  131. package/dist/curation/tension-access.d.ts.map +1 -1
  132. package/dist/curation/tension-access.js +18 -1
  133. package/dist/curation/tension-access.js.map +1 -1
  134. package/dist/curation/tension.d.ts +3 -0
  135. package/dist/curation/tension.d.ts.map +1 -1
  136. package/dist/curation/tension.js +36 -0
  137. package/dist/curation/tension.js.map +1 -1
  138. package/dist/curation/vault-docs.d.ts +1 -0
  139. package/dist/curation/vault-docs.d.ts.map +1 -1
  140. package/dist/curation/vault-docs.js +1 -0
  141. package/dist/curation/vault-docs.js.map +1 -1
  142. package/dist/distill/cli.d.ts.map +1 -1
  143. package/dist/distill/cli.js +6 -0
  144. package/dist/distill/cli.js.map +1 -1
  145. package/dist/distill/cost.d.ts +6 -0
  146. package/dist/distill/cost.d.ts.map +1 -1
  147. package/dist/distill/cost.js +2 -3
  148. package/dist/distill/cost.js.map +1 -1
  149. package/dist/distill/extract.d.ts +52 -0
  150. package/dist/distill/extract.d.ts.map +1 -1
  151. package/dist/distill/extract.js +24 -2
  152. package/dist/distill/extract.js.map +1 -1
  153. package/dist/distill/propose.d.ts +44 -1
  154. package/dist/distill/propose.d.ts.map +1 -1
  155. package/dist/distill/propose.js +84 -2
  156. package/dist/distill/propose.js.map +1 -1
  157. package/dist/distill/reader-fingerprint.d.ts +69 -0
  158. package/dist/distill/reader-fingerprint.d.ts.map +1 -0
  159. package/dist/distill/reader-fingerprint.js +145 -0
  160. package/dist/distill/reader-fingerprint.js.map +1 -0
  161. package/dist/distill/receipt-store.d.ts +5 -0
  162. package/dist/distill/receipt-store.d.ts.map +1 -0
  163. package/dist/distill/receipt-store.js +24 -0
  164. package/dist/distill/receipt-store.js.map +1 -0
  165. package/dist/eval/llm-openrouter.d.ts.map +1 -1
  166. package/dist/eval/llm-openrouter.js +4 -0
  167. package/dist/eval/llm-openrouter.js.map +1 -1
  168. package/dist/eval/llm.d.ts +22 -0
  169. package/dist/eval/llm.d.ts.map +1 -1
  170. package/dist/eval/llm.js +94 -24
  171. package/dist/eval/llm.js.map +1 -1
  172. package/dist/federation/classification.d.ts.map +1 -1
  173. package/dist/federation/classification.js +3 -0
  174. package/dist/federation/classification.js.map +1 -1
  175. package/dist/index.d.ts.map +1 -1
  176. package/dist/index.js +31 -0
  177. package/dist/index.js.map +1 -1
  178. package/dist/search/coverage.d.ts +5 -1
  179. package/dist/search/coverage.d.ts.map +1 -1
  180. package/dist/search/coverage.js +47 -15
  181. package/dist/search/coverage.js.map +1 -1
  182. package/dist/search/hybrid.d.ts +7 -1
  183. package/dist/search/hybrid.d.ts.map +1 -1
  184. package/dist/search/hybrid.js +31 -8
  185. package/dist/search/hybrid.js.map +1 -1
  186. package/dist/search/retrieval-metrics.d.ts +5 -0
  187. package/dist/search/retrieval-metrics.d.ts.map +1 -0
  188. package/dist/search/retrieval-metrics.js +60 -0
  189. package/dist/search/retrieval-metrics.js.map +1 -0
  190. package/dist/search/suppression.d.ts +9 -0
  191. package/dist/search/suppression.d.ts.map +1 -0
  192. package/dist/search/suppression.js +107 -0
  193. package/dist/search/suppression.js.map +1 -0
  194. package/dist/serve/index.d.ts +11 -0
  195. package/dist/serve/index.d.ts.map +1 -1
  196. package/dist/serve/index.js +547 -8
  197. package/dist/serve/index.js.map +1 -1
  198. package/dist/serve/session.d.ts +9 -0
  199. package/dist/serve/session.d.ts.map +1 -0
  200. package/dist/serve/session.js +65 -0
  201. package/dist/serve/session.js.map +1 -0
  202. package/dist/server.d.ts.map +1 -1
  203. package/dist/server.js +4 -6
  204. package/dist/server.js.map +1 -1
  205. package/dist/tools/board.d.ts +32 -0
  206. package/dist/tools/board.d.ts.map +1 -0
  207. package/dist/tools/board.js +615 -0
  208. package/dist/tools/board.js.map +1 -0
  209. package/dist/tools/board.test.d.ts +2 -0
  210. package/dist/tools/board.test.d.ts.map +1 -0
  211. package/dist/tools/board.test.js +964 -0
  212. package/dist/tools/board.test.js.map +1 -0
  213. package/dist/tools/edge-staleness.d.ts.map +1 -1
  214. package/dist/tools/edge-staleness.js +18 -4
  215. package/dist/tools/edge-staleness.js.map +1 -1
  216. package/dist/tools/read.d.ts +2 -0
  217. package/dist/tools/read.d.ts.map +1 -1
  218. package/dist/tools/read.js +43 -13
  219. package/dist/tools/read.js.map +1 -1
  220. package/dist/tools/search.d.ts.map +1 -1
  221. package/dist/tools/search.js +79 -17
  222. package/dist/tools/search.js.map +1 -1
  223. package/dist/tools/write.d.ts.map +1 -1
  224. package/dist/tools/write.js +172 -2
  225. package/dist/tools/write.js.map +1 -1
  226. package/dist/utils/config.d.ts +24 -0
  227. package/dist/utils/config.d.ts.map +1 -1
  228. package/dist/utils/config.js +151 -1
  229. package/dist/utils/config.js.map +1 -1
  230. package/dist/version.d.ts +2 -0
  231. package/dist/version.d.ts.map +1 -0
  232. package/dist/version.js +8 -0
  233. package/dist/version.js.map +1 -0
  234. package/dist/view/board-page.d.ts +4 -0
  235. package/dist/view/board-page.d.ts.map +1 -0
  236. package/dist/view/board-page.js +339 -0
  237. package/dist/view/board-page.js.map +1 -0
  238. package/dist/view/board-page.test.d.ts +2 -0
  239. package/dist/view/board-page.test.d.ts.map +1 -0
  240. package/dist/view/board-page.test.js +548 -0
  241. package/dist/view/board-page.test.js.map +1 -0
  242. package/dist/view/pages.d.ts.map +1 -1
  243. package/dist/view/pages.js +13 -2
  244. package/dist/view/pages.js.map +1 -1
  245. package/dist/view/render.d.ts.map +1 -1
  246. package/dist/view/render.js +2 -1
  247. package/dist/view/render.js.map +1 -1
  248. package/package.json +2 -2
@@ -1,5 +1,30 @@
1
1
  import type { LlmClient } from "../eval/llm.js";
2
2
  import type { Chunk } from "./chunk.js";
3
+ /**
4
+ * Per-claim LLM extraction run metadata (6mf.6). Attached to every claim by
5
+ * the producing chunk's `completeJson` call, so a later bead (f3h) can stamp
6
+ * each emitted belief with the run that compiled it.
7
+ *
8
+ * Optional on ExtractedClaim and every field carries its own source's value —
9
+ * two claims from different chunks may carry different metadata (e.g. one chunk
10
+ * salvaged via retry at temp 0.2, another a clean first-try at 0). Additive and
11
+ * consumed by nothing in this bead: propose.ts only needs to be able to READ
12
+ * it; it does NOT yet write frontmatter from it.
13
+ */
14
+ export interface ClaimRunMeta {
15
+ /** Model the provider actually served (distinct from requestedModel). */
16
+ servedModel?: string;
17
+ /** Temperature actually sent for the producing call (0.2 iff salvaged via retry). */
18
+ effectiveTemperature?: number;
19
+ /** True iff the producing call went through completeJsonWithRetry's retry branch. */
20
+ viaRetry?: boolean;
21
+ /** The model this run requested (ExtractOpts.model). */
22
+ requestedModel: string;
23
+ /** Number of messages in the producing chunk's window. */
24
+ chunkWindow: number;
25
+ /** The per-call input character cap in effect for this run (ExtractOpts.inCallInputCap). */
26
+ inputCap: number;
27
+ }
3
28
  /** One extracted claim, keyed for idempotent upsert (U5). */
4
29
  export interface ExtractedClaim {
5
30
  /** Stable within-source key: `<chunk anchor>:<statement slug>-<hash8>`. */
@@ -13,6 +38,13 @@ export interface ExtractedClaim {
13
38
  proposed_frontmatter: {
14
39
  title: string;
15
40
  };
41
+ /**
42
+ * Optional per-claim LLM extraction run metadata (6mf.6). Populated by
43
+ * extractClaims from the producing chunk's call; flows unchanged through the
44
+ * upsert join into proposeAllClaims' inputs so a later bead can stamp it.
45
+ * Optional so every existing constructor / mock stays valid.
46
+ */
47
+ run_meta?: ClaimRunMeta;
16
48
  }
17
49
  export interface ExtractOutcome {
18
50
  claims: ExtractedClaim[];
@@ -34,6 +66,26 @@ export interface ExtractOpts {
34
66
  /** Max characters of rendered transcript per call (bounds token spend). */
35
67
  inCallInputCap: number;
36
68
  }
69
+ export declare const EXTRACT_SYSTEM = "You extract discrete claims from a chat transcript window.\n\nA claim is a decision, commitment, factual statement, or stated preference that\nwould be worth remembering after the conversation ends. Each claim must be a\nsingle self-contained sentence, understandable without the transcript. Ground\nevery claim in what participants actually said \u2014 do not speculate, do not merge\nunrelated points, and return an empty list when the window contains nothing\nworth keeping (greetings, logistics chatter, media placeholders).\n\nParaphrase in your own words by default: a claim is a compiled belief, not a\ntranscript excerpt. Do not copy long verbatim spans from the window. If a short\nexact quote is genuinely necessary, keep it brief and enclose only the quoted\nwords in double quotes.";
70
+ export declare const EXTRACT_SCHEMA: {
71
+ readonly type: "object";
72
+ readonly properties: {
73
+ readonly claims: {
74
+ readonly type: "array";
75
+ readonly items: {
76
+ readonly type: "object";
77
+ readonly properties: {
78
+ readonly statement: {
79
+ readonly type: "string";
80
+ readonly description: "One self-contained claim sentence.";
81
+ };
82
+ };
83
+ readonly required: readonly ["statement"];
84
+ };
85
+ };
86
+ };
87
+ readonly required: readonly ["claims"];
88
+ };
37
89
  /**
38
90
  * Extract claims from `chunks` — one LLM call per chunk, stopping early when
39
91
  * `maxClaims` is reached or the call budget is exhausted. `llm` should be the
@@ -1 +1 @@
1
- {"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/distill/extract.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,oBAAoB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;CACxB;AAwFD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,KAAK,EAAE,EACf,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,cAAc,CAAC,CAqDzB"}
1
+ {"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/distill/extract.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,oBAAoB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;CACxB;AAOD,eAAO,MAAM,cAAc,8xBAYH,CAAC;AAOzB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;CAejB,CAAC;AAuDX;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,KAAK,EAAE,EACf,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,cAAc,CAAC,CAoEzB"}
@@ -14,7 +14,10 @@
14
14
  import { isBudgetExhaustedError } from "../consolidate/call-budget.js";
15
15
  import { sha256Hex } from "../utils/hash.js";
16
16
  // --- prompt ------------------------------------------------------------------
17
- const EXTRACT_SYSTEM = `You extract discrete claims from a chat transcript window.
17
+ // Exported so the reader-provenance fingerprint (src/distill/reader-fingerprint.ts)
18
+ // can hash the EFFECTIVE extraction prompt contract — a change to this system
19
+ // text revs reader_prompt_version. Do not inline this back to a bare const.
20
+ export const EXTRACT_SYSTEM = `You extract discrete claims from a chat transcript window.
18
21
 
19
22
  A claim is a decision, commitment, factual statement, or stated preference that
20
23
  would be worth remembering after the conversation ends. Each claim must be a
@@ -27,7 +30,12 @@ Paraphrase in your own words by default: a claim is a compiled belief, not a
27
30
  transcript excerpt. Do not copy long verbatim spans from the window. If a short
28
31
  exact quote is genuinely necessary, keep it brief and enclose only the quoted
29
32
  words in double quotes.`;
30
- const EXTRACT_SCHEMA = {
33
+ // Exported alongside EXTRACT_SYSTEM: this schema object is what llm.ts's
34
+ // completeJsonWithRetry injects verbatim into the system prompt
35
+ // (`Return JSON matching:\n${JSON.stringify(opts.schema, null, 2)}`), so it is
36
+ // part of the effective prompt contract the reader fingerprint hashes. A schema
37
+ // change here revs reader_prompt_version.
38
+ export const EXTRACT_SCHEMA = {
31
39
  type: "object",
32
40
  properties: {
33
41
  claims: {
@@ -134,6 +142,19 @@ export async function extractClaims(chunks, llm, opts) {
134
142
  });
135
143
  continue;
136
144
  }
145
+ // 6mf.6: capture the producing call's run metadata once per chunk and
146
+ // attach it to every claim this chunk produced. servedModel /
147
+ // effectiveTemperature / viaRetry come off the CompleteJsonResult (undefined
148
+ // on mocks that don't set them); requestedModel / chunkWindow / inputCap are
149
+ // the run's own knobs.
150
+ const runMeta = {
151
+ servedModel: res.value.servedModel,
152
+ effectiveTemperature: res.value.effectiveTemperature,
153
+ viaRetry: res.value.viaRetry,
154
+ requestedModel: opts.model,
155
+ chunkWindow: chunk.endIndex - chunk.startIndex + 1,
156
+ inputCap: opts.inCallInputCap,
157
+ };
137
158
  for (const statement of statements) {
138
159
  if (claims.length >= opts.maxClaims)
139
160
  break;
@@ -145,6 +166,7 @@ export async function extractClaims(chunks, llm, opts) {
145
166
  claim_key: key,
146
167
  statement,
147
168
  proposed_frontmatter: { title: titleOf(statement) },
169
+ run_meta: runMeta,
148
170
  });
149
171
  }
150
172
  }
@@ -1 +1 @@
1
- {"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/distill/extract.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/distill/extract.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  import type { AccessContext } from "../access/rbac.js";
2
2
  import { type StageOutcome } from "../curation/staged-actions.js";
3
- import type { ExtractedClaim } from "./extract.js";
3
+ import type { ClaimRunMeta, ExtractedClaim } from "./extract.js";
4
+ import { type LineageOp } from "./reader-fingerprint.js";
4
5
  /** Target collection for all distill proposals. */
5
6
  export declare const DISTILL_COLLECTION = "distill";
6
7
  /** The proposing agent identity, recorded on every proposal. */
@@ -88,6 +89,48 @@ export interface ProposeOutcome {
88
89
  error: string;
89
90
  }>;
90
91
  }
92
+ /**
93
+ * The reader_* frontmatter fields stamped from a claim's run_meta. Every field
94
+ * is a DECLARED-OPTIONAL schema extension (see docs/schema-extensions.md); the
95
+ * fields land typed in a vault whose config declares them, untyped-but-preserved
96
+ * otherwise, and never block a write (optional, advisory).
97
+ *
98
+ * null is never written for any field — a null on a declared extension DELETES
99
+ * it (serializeDocument treats null as absent). So a value that would be null is
100
+ * either given a sentinel (served_model → "unreported") or the field is OMITTED
101
+ * (temperature, which is a number and cannot carry a sentinel).
102
+ */
103
+ export interface ReaderFrontmatter {
104
+ reader_model: string;
105
+ reader_served_model: string;
106
+ reader_temperature?: number;
107
+ reader_via_retry: boolean;
108
+ reader_prompt_version: string;
109
+ reader_chunk_window: number;
110
+ reader_input_cap: number;
111
+ readers: string[];
112
+ /** Append-only lineage (6mf.4 R1). Raw-only; never enters typed Frontmatter. */
113
+ reader_lineage: string[];
114
+ }
115
+ /**
116
+ * Build the reader_* frontmatter fields from a claim's run_meta. The prompt
117
+ * version is READER_PROMPT_VERSION (the hash of the effective extraction prompt
118
+ * contract at this build). `readers` carries exactly ONE entry at ingest — the
119
+ * parentage SET a later merge bead unions. `reader_lineage` carries the first
120
+ * append-only provenance entry for this belief (6mf.4 R1).
121
+ *
122
+ * Locked field rules (see the bead spec):
123
+ * - reader_served_model uses the "unreported" sentinel when servedModel is
124
+ * undefined — NEVER null (null deletes the field).
125
+ * - reader_temperature is OMITTED when effectiveTemperature is undefined — a
126
+ * number field cannot hold a sentinel.
127
+ * - reader_via_retry defaults to false when viaRetry is undefined.
128
+ *
129
+ * @param runMeta The extraction run metadata.
130
+ * @param op The lineage op for this write. Defaults to `"ingest"` (new
131
+ * belief). Pass `"update"` for update-in-place re-distillations.
132
+ */
133
+ export declare function buildReaderFrontmatter(runMeta: ClaimRunMeta, op?: LineageOp): ReaderFrontmatter;
91
134
  /**
92
135
  * Emit each claim as a `write` staged-action proposal at draft/low/synthesized.
93
136
  * Routes through `stageActionWithConflictCheck` so inter-proposal conflicts
@@ -1 +1 @@
1
- {"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,+BAA+B,CAAC;AAGhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAMpC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,CAc5F;AAMD,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oFAAoF;IACpF,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AA0HD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,aAAa,CAAC,EAAE,eAAe,GAC9B,OAAO,CAAC,cAAc,CAAC,CA8EzB"}
1
+ {"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,+BAA+B,CAAC;AAGhG,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,yBAAyB,CAAC;AAMjC,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAMpC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,CAc5F;AAMD,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oFAAoF;IACpF,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AA+CD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,EAAE,GAAE,SAAoB,GACvB,iBAAiB,CAmBnB;AA6GD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,aAAa,CAAC,EAAE,eAAe,GAC9B,OAAO,CAAC,cAAc,CAAC,CA8FzB"}
@@ -22,6 +22,7 @@ import { stageActionWithConflictCheck } from "../curation/staged-actions.js";
22
22
  import { slugifyKey } from "../import/langgraph-store.js";
23
23
  import { vaultSearch } from "../tools/search.js";
24
24
  import { refuseRawDistillOutput } from "./output-fence.js";
25
+ import { encodeLineageEntry, encodeReader, READER_PROMPT_VERSION, } from "./reader-fingerprint.js";
25
26
  // ---------------------------------------------------------------------------
26
27
  // Public constants
27
28
  // ---------------------------------------------------------------------------
@@ -102,10 +103,74 @@ function derivePath(claim, sourceId) {
102
103
  const titleSlug = title.trim() ? slugifyKey(title) : slugifyKey(claim.claim_key);
103
104
  return join(DISTILL_COLLECTION, sourceGroup, `${titleSlug}--${hash8}.md`);
104
105
  }
106
+ /**
107
+ * Build the reader_* frontmatter fields from a claim's run_meta. The prompt
108
+ * version is READER_PROMPT_VERSION (the hash of the effective extraction prompt
109
+ * contract at this build). `readers` carries exactly ONE entry at ingest — the
110
+ * parentage SET a later merge bead unions. `reader_lineage` carries the first
111
+ * append-only provenance entry for this belief (6mf.4 R1).
112
+ *
113
+ * Locked field rules (see the bead spec):
114
+ * - reader_served_model uses the "unreported" sentinel when servedModel is
115
+ * undefined — NEVER null (null deletes the field).
116
+ * - reader_temperature is OMITTED when effectiveTemperature is undefined — a
117
+ * number field cannot hold a sentinel.
118
+ * - reader_via_retry defaults to false when viaRetry is undefined.
119
+ *
120
+ * @param runMeta The extraction run metadata.
121
+ * @param op The lineage op for this write. Defaults to `"ingest"` (new
122
+ * belief). Pass `"update"` for update-in-place re-distillations.
123
+ */
124
+ export function buildReaderFrontmatter(runMeta, op = "ingest") {
125
+ const readerStr = encodeReader(runMeta, READER_PROMPT_VERSION);
126
+ const ts = new Date().toISOString();
127
+ const fm = {
128
+ reader_model: runMeta.requestedModel,
129
+ reader_served_model: runMeta.servedModel ?? "unreported",
130
+ reader_via_retry: runMeta.viaRetry ?? false,
131
+ reader_prompt_version: READER_PROMPT_VERSION,
132
+ reader_chunk_window: runMeta.chunkWindow,
133
+ reader_input_cap: runMeta.inputCap,
134
+ readers: [readerStr],
135
+ reader_lineage: [encodeLineageEntry(ts, op, readerStr)],
136
+ };
137
+ // Omit reader_temperature entirely when unknown: a number can't hold a
138
+ // sentinel and null would delete a declared extension.
139
+ if (runMeta.effectiveTemperature !== undefined) {
140
+ fm.reader_temperature = runMeta.effectiveTemperature;
141
+ }
142
+ return fm;
143
+ }
105
144
  // ---------------------------------------------------------------------------
106
145
  // Note assembly (mirrors langgraph-store.ts deriveNotes)
107
146
  // ---------------------------------------------------------------------------
108
- function assembleBody(claim, frontmatter, ids) {
147
+ // Human-readable "Reader" subsection of the Provenance body, mirroring the
148
+ // reader_* frontmatter. Returns [] (no subsection) when the claim carries no
149
+ // run_meta, so a claim without reader provenance produces the original body.
150
+ function readerProvenanceLines(reader) {
151
+ if (reader === null)
152
+ return [];
153
+ return [
154
+ "",
155
+ "### Reader",
156
+ "",
157
+ `- **Model (requested):** \`${reader.reader_model}\``,
158
+ `- **Model (served):** \`${reader.reader_served_model}\``,
159
+ ...(reader.reader_temperature !== undefined
160
+ ? [`- **Effective temperature:** \`${reader.reader_temperature}\``]
161
+ : []),
162
+ `- **Via retry:** \`${reader.reader_via_retry}\``,
163
+ `- **Prompt version:** \`${reader.reader_prompt_version}\``,
164
+ `- **Chunk window:** \`${reader.reader_chunk_window}\``,
165
+ `- **Input cap:** \`${reader.reader_input_cap}\``,
166
+ `- **Readers:** \`${reader.readers.join(", ")}\``,
167
+ "",
168
+ "_This fingerprint identifies the run configuration; it does not guarantee " +
169
+ "bit-identical re-extraction (temperature 0 is not seeded; provider/quantization " +
170
+ "variance)._",
171
+ ];
172
+ }
173
+ function assembleBody(claim, frontmatter, ids, reader) {
109
174
  return [
110
175
  "---",
111
176
  dump(frontmatter).trimEnd(),
@@ -119,6 +184,7 @@ function assembleBody(claim, frontmatter, ids) {
119
184
  `- **Claim key:** \`${claim.claim_key}\``,
120
185
  `- **Run id:** \`${ids.runId}\``,
121
186
  `- **Source ref:** \`distill:${ids.sourceId}#${claim.claim_key}\``,
187
+ ...readerProvenanceLines(reader),
122
188
  "",
123
189
  ].join("\n");
124
190
  }
@@ -231,7 +297,23 @@ export async function proposeAllClaims(vaultRoot, claims, ids, pathOverrides, ov
231
297
  errors.push({ claim_key: claim.claim_key, error: fence.error.message });
232
298
  continue;
233
299
  }
234
- const body = assembleBody(claim, frontmatter, ids);
300
+ // f3h: the producing extraction call's run metadata reaches this point as
301
+ // `claim.run_meta` (ClaimRunMeta | undefined) — servedModel,
302
+ // effectiveTemperature, viaRetry, requestedModel, chunkWindow, inputCap. When
303
+ // present, stamp the reader fingerprint onto the belief's frontmatter as
304
+ // declared-optional schema_extensions (reader_*/readers/reader_lineage). When
305
+ // ABSENT (older paths, mocks that omit it), skip every reader field entirely —
306
+ // they are optional and must not crash or write empty/null placeholders.
307
+ //
308
+ // 6mf.4: the op is "update" iff this claim has a path override (meaning it is
309
+ // an update-in-place re-distillation of an existing landed belief), else "ingest".
310
+ // The land-time union (Task 2) merges the incoming lineage with the existing one.
311
+ const isUpdate = pathOverrides?.[claim.claim_key] !== undefined;
312
+ const lineageOp = isUpdate ? "update" : "ingest";
313
+ const reader = claim.run_meta ? buildReaderFrontmatter(claim.run_meta, lineageOp) : null;
314
+ if (reader)
315
+ Object.assign(frontmatter, reader);
316
+ const body = assembleBody(claim, frontmatter, ids, reader);
235
317
  // U8/R5 + R7: overlap-hint. Attach top-K likely-collision neighbor paths to
236
318
  // the rationale so the ratifier can see possible overlaps at a glance, and
237
319
  // stamp the top neighbor's fused search score as `corroboration`. No LLM or
@@ -1 +1 @@
1
- {"version":3,"file":"propose.js","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,4CAA4C;AAC5C,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,cAAc;AACd,2EAA2E;AAC3E,yEAAyE;AAEzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAqB,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AA+BpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,MAAsB;IACzE,OAAO,KAAK,EAAE,SAAiB,EAAwB,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,SAAS,EACT,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAC/C,MAAM,CACP,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC5D,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AA0CD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,2EAA2E;AAC3E,yEAAyE;AACzE,sEAAsE;AACtE,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,qEAAqE;IACrE,uDAAuD;IACvD,qEAAqE;IACrE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,0DAA0D;AAC1D,8EAA8E;AAC9E,0EAA0E;AAC1E,yEAAyE;AACzE,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,oEAAoE;AACpE,SAAS,UAAU,CAAC,KAAqB,EAAE,QAAgB;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC;IAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IACrD,sEAAsE;IACtE,wEAAwE;IACxE,uEAAuE;IACvE,kEAAkE;IAClE,oEAAoE;IACpE,wDAAwD;IACxD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,kBAAkB,EAAE,WAAW,EAAE,GAAG,SAAS,KAAK,KAAK,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,SAAS,YAAY,CACnB,KAAqB,EACrB,WAAoC,EACpC,GAAe;IAEf,OAAO;QACL,KAAK;QACL,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;QAC3B,KAAK;QACL,EAAE;QACF,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;QACtB,EAAE;QACF,eAAe;QACf,EAAE;QACF,6CAA6C;QAC7C,sBAAsB,KAAK,CAAC,SAAS,IAAI;QACzC,mBAAmB,GAAG,CAAC,KAAK,IAAI;QAChC,+BAA+B,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,IAAI;QAClE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,iBAAiB,CAC9B,SAAiB,EACjB,aAA+B;IAE/B,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACtE,IAAI,IAAiB,CAAC;IACtB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;QACjE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,8EAA8E;IAC9E,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;SACzB,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC;QAC7B,0EAA0E;QAC1E,wEAAwE;QACxE,6BAA6B;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1C,OAAO;QACL,SAAS,EAAE,GAAG,SAAS,0BAA0B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACvE,aAAa;KACd,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,MAAwB,EACxB,GAAe,EACf,aAAsC,EACtC,aAA+B;IAE/B,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAgD,EAAE,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEvF,uEAAuE;QACvE,mDAAmD;QACnD,MAAM,WAAW,GAA4B;YAC3C,KAAK,EAAE,KAAK,CAAC,oBAAoB,CAAC,KAAK;YACvC,sEAAsE;YACtE,yEAAyE;YACzE,wEAAwE;YACxE,yCAAyC;YACzC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1D,MAAM,EAAE,cAAc;YACtB,UAAU,EAAE,kBAAkB;YAC9B,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,aAAa;YACzB,4EAA4E;YAC5E,4EAA4E;YAC5E,uEAAuE;YACvE,2EAA2E;YAC3E,wBAAwB;YACxB,WAAW,EAAE,aAAa;YAC1B,mEAAmE;YACnE,qEAAqE;YACrE,OAAO,EAAE,CAAC,WAAW,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACvD,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,IAAI;SACf,CAAC;QAEF,4EAA4E;QAC5E,0EAA0E;QAC1E,mEAAmE;QACnE,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAEnD,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,qEAAqE;QACrE,0EAA0E;QAC1E,+EAA+E;QAC/E,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAE7F,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC,SAAS,EAAE;YAC3D,UAAU,EAAE,OAAO;YACnB,UAAU;YACV,UAAU,EAAE,aAAa;YACzB,SAAS;YACT,wEAAwE;YACxE,uEAAuE;YACvE,4CAA4C;YAC5C,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE;YAClD,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,MAAM,CAAC,KAAK;YACf,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC"}
1
+ {"version":3,"file":"propose.js","sourceRoot":"","sources":["../../src/distill/propose.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import type { ClaimRunMeta } from "./extract.js";
2
+ /** First 8 hex chars of sha256(text). The short, stable version token form. */
3
+ export declare function hash8(text: string): string;
4
+ /**
5
+ * The 8-hex-char version token of the effective extraction prompt contract.
6
+ * Computed once at module load — it is a pure function of two module constants,
7
+ * so it is a stable constant for a given build. Changing EXTRACT_SYSTEM or
8
+ * EXTRACT_SCHEMA changes this value.
9
+ */
10
+ export declare const READER_PROMPT_VERSION: string;
11
+ /**
12
+ * Encode one reader as a compact, stable, single-line string suitable as an
13
+ * element of the `readers` parentage SET. Shape:
14
+ *
15
+ * `${requestedModel}@${effTempOrNA}|prompt=${promptVersion}|retry=${viaRetry}`
16
+ *
17
+ * - requestedModel is always present on ClaimRunMeta.
18
+ * - effTempOrNA is the effective temperature, or "na" when undefined.
19
+ * - promptVersion is the caller-supplied version token (READER_PROMPT_VERSION at
20
+ * ingest) — passed in rather than read from the module constant so a future
21
+ * caller stamping historical content can encode against the version that
22
+ * actually produced it.
23
+ * - viaRetry defaults to false when undefined (mirrors reader_via_retry).
24
+ *
25
+ * One belief carries exactly ONE reader at ingest; the SET grows only when a
26
+ * merge unions parents. The encoding is intentionally free of characters that a
27
+ * later parser would need to escape (no commas, no newlines).
28
+ */
29
+ export declare function encodeReader(runMeta: ClaimRunMeta, promptVersion: string): string;
30
+ /** Discriminant for the operation that produced a lineage entry. */
31
+ export type LineageOp = "ingest" | "update" | "revision";
32
+ /** A parsed lineage entry. `reader` is the full `encodeReader` string (may contain pipes). */
33
+ export interface ParsedLineageEntry {
34
+ ts: string;
35
+ op: string;
36
+ reader: string;
37
+ }
38
+ /**
39
+ * Encode one lineage entry as `<ts>|<op>|<reader>`.
40
+ * `reader` is an already-encoded reader string (may itself contain pipes);
41
+ * the first two pipes are the field delimiters — all further pipes belong to reader.
42
+ */
43
+ export declare function encodeLineageEntry(ts: string, op: LineageOp, reader: string): string;
44
+ /**
45
+ * Parse a lineage entry produced by `encodeLineageEntry`.
46
+ * Splits on the FIRST two `|` only so the reader (which may contain pipes) is preserved.
47
+ * Returns null for malformed input (fewer than 2 separators or empty string).
48
+ */
49
+ export declare function parseLineageEntry(entry: string): ParsedLineageEntry | null;
50
+ /**
51
+ * Materialise the SET-projection of a lineage: the deduplicated list of reader
52
+ * strings, in first-seen order. Malformed entries are silently skipped.
53
+ */
54
+ export declare function readersFromLineage(lineage: string[]): string[];
55
+ /**
56
+ * Append-only union of two lineages.
57
+ * Starts from `existing` (order preserved, never re-sorted).
58
+ * For each entry in `incoming`, appends iff no existing entry shares the same `(op, reader)` pair
59
+ * (timestamp is ignored for dedup — a duplicate re-append is declined).
60
+ */
61
+ export declare function unionLineage(existing: string[], incoming: string[]): string[];
62
+ /**
63
+ * Encode a revision-panel reader fingerprint.
64
+ * Shape: `<model>@na|prompt=<hash8(SYSTEM_BASE+templates)>|retry=false`
65
+ * The prompt hash here is the READER_PROMPT_VERSION (extraction contract),
66
+ * re-used as the closest stable contract identifier for the revision panel.
67
+ */
68
+ export declare function encodeRevisionReader(model: string): string;
69
+ //# sourceMappingURL=reader-fingerprint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reader-fingerprint.d.ts","sourceRoot":"","sources":["../../src/distill/reader-fingerprint.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAoD,CAAC;AAQzF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKjF;AAMD,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAW1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAkB7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D"}
@@ -0,0 +1,145 @@
1
+ // src/distill/reader-fingerprint.ts
2
+ //
3
+ // Reader provenance fingerprint (f3h). A "reader" is the LLM run configuration
4
+ // that compiled a distilled belief: which model was requested/served, at what
5
+ // effective temperature, whether it went through the retry branch, and a short
6
+ // hash of the effective extraction prompt contract. propose.ts stamps these
7
+ // onto each belief's frontmatter (as declared-optional schema_extensions) at
8
+ // ingest; later merge/tension/canon beads UNION the `readers` set, so the
9
+ // encoder here is the single shared source of truth for that set's element
10
+ // format. Keep it stable — a change to encodeReader's shape re-keys every
11
+ // parentage entry those beads compare.
12
+ import { sha256Hex } from "../utils/hash.js";
13
+ import { EXTRACT_SCHEMA, EXTRACT_SYSTEM } from "./extract.js";
14
+ /** First 8 hex chars of sha256(text). The short, stable version token form. */
15
+ export function hash8(text) {
16
+ return sha256Hex(text).slice(0, 8);
17
+ }
18
+ // The effective extraction prompt contract, serialized exactly as llm.ts's
19
+ // completeJsonWithRetry injects the schema into the system prompt
20
+ // (`JSON.stringify(opts.schema, null, 2)`). We hash EXTRACT_SYSTEM concatenated
21
+ // with that serialization so ANY change to either the system text or the JSON
22
+ // schema revs the version. We deliberately do NOT fold in the retry-prompt
23
+ // suffix (the "Your previous reply was NOT valid JSON…" reprompt): reader_via_retry
24
+ // already captures whether a belief came off the retry path, so the fingerprint
25
+ // stays keyed to the base contract rather than splitting into two versions.
26
+ const EFFECTIVE_EXTRACTION_PROMPT_CONTRACT = `${EXTRACT_SYSTEM}${JSON.stringify(EXTRACT_SCHEMA, null, 2)}`;
27
+ /**
28
+ * The 8-hex-char version token of the effective extraction prompt contract.
29
+ * Computed once at module load — it is a pure function of two module constants,
30
+ * so it is a stable constant for a given build. Changing EXTRACT_SYSTEM or
31
+ * EXTRACT_SCHEMA changes this value.
32
+ */
33
+ export const READER_PROMPT_VERSION = hash8(EFFECTIVE_EXTRACTION_PROMPT_CONTRACT);
34
+ // Sentinel used when effectiveTemperature is undefined, only inside the compact
35
+ // `readers` set string (a single-line encoding that cannot carry `undefined`).
36
+ // The typed `reader_temperature` frontmatter field is OMITTED entirely in that
37
+ // case — a number field cannot hold a sentinel — so this "na" lives only here.
38
+ const TEMP_NA = "na";
39
+ /**
40
+ * Encode one reader as a compact, stable, single-line string suitable as an
41
+ * element of the `readers` parentage SET. Shape:
42
+ *
43
+ * `${requestedModel}@${effTempOrNA}|prompt=${promptVersion}|retry=${viaRetry}`
44
+ *
45
+ * - requestedModel is always present on ClaimRunMeta.
46
+ * - effTempOrNA is the effective temperature, or "na" when undefined.
47
+ * - promptVersion is the caller-supplied version token (READER_PROMPT_VERSION at
48
+ * ingest) — passed in rather than read from the module constant so a future
49
+ * caller stamping historical content can encode against the version that
50
+ * actually produced it.
51
+ * - viaRetry defaults to false when undefined (mirrors reader_via_retry).
52
+ *
53
+ * One belief carries exactly ONE reader at ingest; the SET grows only when a
54
+ * merge unions parents. The encoding is intentionally free of characters that a
55
+ * later parser would need to escape (no commas, no newlines).
56
+ */
57
+ export function encodeReader(runMeta, promptVersion) {
58
+ const effTemp = runMeta.effectiveTemperature === undefined ? TEMP_NA : String(runMeta.effectiveTemperature);
59
+ const retry = runMeta.viaRetry ?? false;
60
+ return `${runMeta.requestedModel}@${effTemp}|prompt=${promptVersion}|retry=${retry}`;
61
+ }
62
+ /**
63
+ * Encode one lineage entry as `<ts>|<op>|<reader>`.
64
+ * `reader` is an already-encoded reader string (may itself contain pipes);
65
+ * the first two pipes are the field delimiters — all further pipes belong to reader.
66
+ */
67
+ export function encodeLineageEntry(ts, op, reader) {
68
+ return `${ts}|${op}|${reader}`;
69
+ }
70
+ /**
71
+ * Parse a lineage entry produced by `encodeLineageEntry`.
72
+ * Splits on the FIRST two `|` only so the reader (which may contain pipes) is preserved.
73
+ * Returns null for malformed input (fewer than 2 separators or empty string).
74
+ */
75
+ export function parseLineageEntry(entry) {
76
+ if (!entry)
77
+ return null;
78
+ const first = entry.indexOf("|");
79
+ if (first === -1)
80
+ return null;
81
+ const second = entry.indexOf("|", first + 1);
82
+ if (second === -1)
83
+ return null;
84
+ const ts = entry.slice(0, first);
85
+ const op = entry.slice(first + 1, second);
86
+ const reader = entry.slice(second + 1);
87
+ if (!ts || !op || !reader)
88
+ return null;
89
+ return { ts, op, reader };
90
+ }
91
+ /**
92
+ * Materialise the SET-projection of a lineage: the deduplicated list of reader
93
+ * strings, in first-seen order. Malformed entries are silently skipped.
94
+ */
95
+ export function readersFromLineage(lineage) {
96
+ const seen = new Set();
97
+ const result = [];
98
+ for (const entry of lineage) {
99
+ const parsed = parseLineageEntry(entry);
100
+ if (!parsed)
101
+ continue;
102
+ if (!seen.has(parsed.reader)) {
103
+ seen.add(parsed.reader);
104
+ result.push(parsed.reader);
105
+ }
106
+ }
107
+ return result;
108
+ }
109
+ /**
110
+ * Append-only union of two lineages.
111
+ * Starts from `existing` (order preserved, never re-sorted).
112
+ * For each entry in `incoming`, appends iff no existing entry shares the same `(op, reader)` pair
113
+ * (timestamp is ignored for dedup — a duplicate re-append is declined).
114
+ */
115
+ export function unionLineage(existing, incoming) {
116
+ // Build a set of (op,reader) keys from existing
117
+ const existingKeys = new Set();
118
+ for (const entry of existing) {
119
+ const parsed = parseLineageEntry(entry);
120
+ if (parsed)
121
+ existingKeys.add(`${parsed.op}\x00${parsed.reader}`);
122
+ }
123
+ const result = [...existing];
124
+ for (const entry of incoming) {
125
+ const parsed = parseLineageEntry(entry);
126
+ if (!parsed)
127
+ continue;
128
+ const key = `${parsed.op}\x00${parsed.reader}`;
129
+ if (!existingKeys.has(key)) {
130
+ existingKeys.add(key);
131
+ result.push(entry);
132
+ }
133
+ }
134
+ return result;
135
+ }
136
+ /**
137
+ * Encode a revision-panel reader fingerprint.
138
+ * Shape: `<model>@na|prompt=<hash8(SYSTEM_BASE+templates)>|retry=false`
139
+ * The prompt hash here is the READER_PROMPT_VERSION (extraction contract),
140
+ * re-used as the closest stable contract identifier for the revision panel.
141
+ */
142
+ export function encodeRevisionReader(model) {
143
+ return `${model}@${TEMP_NA}|prompt=${READER_PROMPT_VERSION}|retry=false`;
144
+ }
145
+ //# sourceMappingURL=reader-fingerprint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reader-fingerprint.js","sourceRoot":"","sources":["../../src/distill/reader-fingerprint.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { type Result } from "../frontmatter/types.js";
2
+ import type { DistillReceipt } from "./cost.js";
3
+ export declare function distillReceiptsPath(vaultRoot: string): string;
4
+ export declare function appendDistillReceipt(vaultRoot: string, receipt: DistillReceipt): Promise<Result<void, Error>>;
5
+ //# sourceMappingURL=receipt-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"receipt-store.d.ts","sourceRoot":"","sources":["../../src/distill/receipt-store.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAS9B"}
@@ -0,0 +1,24 @@
1
+ // Operator-side persistence for distill receipts (#423). Append-only JSONL at
2
+ // .daftari/distill-receipts.jsonl, keyed by the artifact runId so a run's
3
+ // provider/ZDR/cost facts join to the claims it produced. Machine-local and
4
+ // gitignored — these are operator telemetry (R10), NEVER exposed through an MCP
5
+ // tool or CLI read path.
6
+ import { mkdirSync } from "node:fs";
7
+ import { appendFile } from "node:fs/promises";
8
+ import { join } from "node:path";
9
+ import { err, ok } from "../frontmatter/types.js";
10
+ export function distillReceiptsPath(vaultRoot) {
11
+ return join(vaultRoot, ".daftari", "distill-receipts.jsonl");
12
+ }
13
+ export async function appendDistillReceipt(vaultRoot, receipt) {
14
+ try {
15
+ mkdirSync(join(vaultRoot, ".daftari"), { recursive: true });
16
+ await appendFile(distillReceiptsPath(vaultRoot), `${JSON.stringify(receipt)}\n`);
17
+ return ok(undefined);
18
+ }
19
+ catch (e) {
20
+ const reason = e instanceof Error ? e.message : String(e);
21
+ return err(new Error(`cannot persist distill receipt: ${reason}`));
22
+ }
23
+ }
24
+ //# sourceMappingURL=receipt-store.js.map