daftari 1.31.0 → 2.0.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 (239) hide show
  1. package/CHANGELOG.md +179 -1
  2. package/README.md +89 -9
  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 +16 -0
  6. package/dist/access/rbac.js.map +1 -1
  7. package/dist/asof/index.d.ts.map +1 -1
  8. package/dist/asof/index.js +23 -2
  9. package/dist/asof/index.js.map +1 -1
  10. package/dist/asof/report.d.ts.map +1 -1
  11. package/dist/asof/report.js +24 -0
  12. package/dist/asof/report.js.map +1 -1
  13. package/dist/asof/snapshot.d.ts +7 -1
  14. package/dist/asof/snapshot.d.ts.map +1 -1
  15. package/dist/asof/snapshot.js +28 -1
  16. package/dist/asof/snapshot.js.map +1 -1
  17. package/dist/backfill/derive.d.ts.map +1 -1
  18. package/dist/backfill/derive.js +7 -0
  19. package/dist/backfill/derive.js.map +1 -1
  20. package/dist/canary/fixtures.d.ts +12 -0
  21. package/dist/canary/fixtures.d.ts.map +1 -0
  22. package/dist/canary/fixtures.js +132 -0
  23. package/dist/canary/fixtures.js.map +1 -0
  24. package/dist/canary/index.d.ts +16 -0
  25. package/dist/canary/index.d.ts.map +1 -0
  26. package/dist/canary/index.js +105 -0
  27. package/dist/canary/index.js.map +1 -0
  28. package/dist/canary/run.d.ts +39 -0
  29. package/dist/canary/run.d.ts.map +1 -0
  30. package/dist/canary/run.js +266 -0
  31. package/dist/canary/run.js.map +1 -0
  32. package/dist/canary/stats.d.ts +36 -0
  33. package/dist/canary/stats.d.ts.map +1 -0
  34. package/dist/canary/stats.js +143 -0
  35. package/dist/canary/stats.js.map +1 -0
  36. package/dist/canon/index.d.ts +15 -0
  37. package/dist/canon/index.d.ts.map +1 -0
  38. package/dist/canon/index.js +167 -0
  39. package/dist/canon/index.js.map +1 -0
  40. package/dist/canon/resolve.d.ts +12 -0
  41. package/dist/canon/resolve.d.ts.map +1 -0
  42. package/dist/canon/resolve.js +67 -0
  43. package/dist/canon/resolve.js.map +1 -0
  44. package/dist/canon/topic.d.ts +20 -0
  45. package/dist/canon/topic.d.ts.map +1 -0
  46. package/dist/canon/topic.js +81 -0
  47. package/dist/canon/topic.js.map +1 -0
  48. package/dist/canon/types.d.ts +37 -0
  49. package/dist/canon/types.d.ts.map +1 -0
  50. package/dist/canon/types.js +9 -0
  51. package/dist/canon/types.js.map +1 -0
  52. package/dist/cli.d.ts.map +1 -1
  53. package/dist/cli.js +12 -0
  54. package/dist/cli.js.map +1 -1
  55. package/dist/consolidate/index.d.ts.map +1 -1
  56. package/dist/consolidate/index.js +10 -12
  57. package/dist/consolidate/index.js.map +1 -1
  58. package/dist/curation/edges.d.ts.map +1 -1
  59. package/dist/curation/edges.js +36 -17
  60. package/dist/curation/edges.js.map +1 -1
  61. package/dist/curation/lint-voice.d.ts +3 -0
  62. package/dist/curation/lint-voice.d.ts.map +1 -0
  63. package/dist/curation/lint-voice.js +87 -0
  64. package/dist/curation/lint-voice.js.map +1 -0
  65. package/dist/curation/lint.d.ts +7 -1
  66. package/dist/curation/lint.d.ts.map +1 -1
  67. package/dist/curation/lint.js +62 -18
  68. package/dist/curation/lint.js.map +1 -1
  69. package/dist/curation/shadow.d.ts +1 -0
  70. package/dist/curation/shadow.d.ts.map +1 -1
  71. package/dist/curation/shadow.js +17 -11
  72. package/dist/curation/shadow.js.map +1 -1
  73. package/dist/curation/staged-actions.d.ts +1 -0
  74. package/dist/curation/staged-actions.d.ts.map +1 -1
  75. package/dist/curation/staged-actions.js +21 -24
  76. package/dist/curation/staged-actions.js.map +1 -1
  77. package/dist/curation/validity.d.ts +20 -0
  78. package/dist/curation/validity.d.ts.map +1 -0
  79. package/dist/curation/validity.js +191 -0
  80. package/dist/curation/validity.js.map +1 -0
  81. package/dist/eval/generate.d.ts.map +1 -1
  82. package/dist/eval/generate.js +16 -0
  83. package/dist/eval/generate.js.map +1 -1
  84. package/dist/eval/index.d.ts +1 -0
  85. package/dist/eval/index.d.ts.map +1 -1
  86. package/dist/eval/index.js +79 -28
  87. package/dist/eval/index.js.map +1 -1
  88. package/dist/eval/llm-openrouter.d.ts.map +1 -1
  89. package/dist/eval/llm-openrouter.js +158 -65
  90. package/dist/eval/llm-openrouter.js.map +1 -1
  91. package/dist/fence/detect.d.ts +10 -0
  92. package/dist/fence/detect.d.ts.map +1 -0
  93. package/dist/fence/detect.js +161 -0
  94. package/dist/fence/detect.js.map +1 -0
  95. package/dist/fence/index.d.ts +22 -0
  96. package/dist/fence/index.d.ts.map +1 -0
  97. package/dist/fence/index.js +117 -0
  98. package/dist/fence/index.js.map +1 -0
  99. package/dist/frontmatter/schema.d.ts.map +1 -1
  100. package/dist/frontmatter/schema.js +26 -0
  101. package/dist/frontmatter/schema.js.map +1 -1
  102. package/dist/frontmatter/types.d.ts +3 -1
  103. package/dist/frontmatter/types.d.ts.map +1 -1
  104. package/dist/frontmatter/types.js +2 -0
  105. package/dist/frontmatter/types.js.map +1 -1
  106. package/dist/holders/registry.d.ts +8 -0
  107. package/dist/holders/registry.d.ts.map +1 -0
  108. package/dist/holders/registry.js +18 -0
  109. package/dist/holders/registry.js.map +1 -0
  110. package/dist/holders/types.d.ts +10 -0
  111. package/dist/holders/types.d.ts.map +1 -0
  112. package/dist/holders/types.js +2 -0
  113. package/dist/holders/types.js.map +1 -0
  114. package/dist/index.d.ts.map +1 -1
  115. package/dist/index.js +10 -6
  116. package/dist/index.js.map +1 -1
  117. package/dist/interview/index.d.ts +7 -0
  118. package/dist/interview/index.d.ts.map +1 -0
  119. package/dist/interview/index.js +219 -0
  120. package/dist/interview/index.js.map +1 -0
  121. package/dist/interview/questions.d.ts +18 -0
  122. package/dist/interview/questions.d.ts.map +1 -0
  123. package/dist/interview/questions.js +201 -0
  124. package/dist/interview/questions.js.map +1 -0
  125. package/dist/interview/transcript.d.ts +23 -0
  126. package/dist/interview/transcript.d.ts.map +1 -0
  127. package/dist/interview/transcript.js +155 -0
  128. package/dist/interview/transcript.js.map +1 -0
  129. package/dist/okf/export.d.ts.map +1 -1
  130. package/dist/okf/export.js +4 -2
  131. package/dist/okf/export.js.map +1 -1
  132. package/dist/okf/import.d.ts.map +1 -1
  133. package/dist/okf/import.js +11 -3
  134. package/dist/okf/import.js.map +1 -1
  135. package/dist/okf/index.d.ts.map +1 -1
  136. package/dist/okf/index.js +13 -1
  137. package/dist/okf/index.js.map +1 -1
  138. package/dist/okf/map.d.ts +11 -0
  139. package/dist/okf/map.d.ts.map +1 -1
  140. package/dist/okf/map.js +191 -13
  141. package/dist/okf/map.js.map +1 -1
  142. package/dist/okf/types.d.ts +6 -2
  143. package/dist/okf/types.d.ts.map +1 -1
  144. package/dist/okf/types.js +39 -5
  145. package/dist/okf/types.js.map +1 -1
  146. package/dist/resources.d.ts +27 -0
  147. package/dist/resources.d.ts.map +1 -0
  148. package/dist/resources.js +169 -0
  149. package/dist/resources.js.map +1 -0
  150. package/dist/search/current-source.d.ts +1 -0
  151. package/dist/search/current-source.d.ts.map +1 -1
  152. package/dist/search/current-source.js +3 -1
  153. package/dist/search/current-source.js.map +1 -1
  154. package/dist/search/hybrid.d.ts +5 -0
  155. package/dist/search/hybrid.d.ts.map +1 -1
  156. package/dist/search/hybrid.js +25 -9
  157. package/dist/search/hybrid.js.map +1 -1
  158. package/dist/search/reindex.d.ts +3 -0
  159. package/dist/search/reindex.d.ts.map +1 -1
  160. package/dist/search/reindex.js +78 -23
  161. package/dist/search/reindex.js.map +1 -1
  162. package/dist/search/valid-at-source.d.ts +25 -0
  163. package/dist/search/valid-at-source.d.ts.map +1 -0
  164. package/dist/search/valid-at-source.js +131 -0
  165. package/dist/search/valid-at-source.js.map +1 -0
  166. package/dist/search/watcher.d.ts.map +1 -1
  167. package/dist/search/watcher.js +8 -17
  168. package/dist/search/watcher.js.map +1 -1
  169. package/dist/serve/index.d.ts.map +1 -1
  170. package/dist/serve/index.js +58 -89
  171. package/dist/serve/index.js.map +1 -1
  172. package/dist/server.d.ts +3 -1
  173. package/dist/server.d.ts.map +1 -1
  174. package/dist/server.js +159 -11
  175. package/dist/server.js.map +1 -1
  176. package/dist/sleep/cycle.d.ts.map +1 -1
  177. package/dist/sleep/cycle.js +20 -4
  178. package/dist/sleep/cycle.js.map +1 -1
  179. package/dist/storage/index-db.d.ts +7 -1
  180. package/dist/storage/index-db.d.ts.map +1 -1
  181. package/dist/storage/index-db.js +134 -8
  182. package/dist/storage/index-db.js.map +1 -1
  183. package/dist/tools/canon.d.ts +3 -0
  184. package/dist/tools/canon.d.ts.map +1 -0
  185. package/dist/tools/canon.js +177 -0
  186. package/dist/tools/canon.js.map +1 -0
  187. package/dist/tools/consumes.d.ts.map +1 -1
  188. package/dist/tools/consumes.js +47 -1
  189. package/dist/tools/consumes.js.map +1 -1
  190. package/dist/tools/curation.d.ts +2 -0
  191. package/dist/tools/curation.d.ts.map +1 -1
  192. package/dist/tools/curation.js +506 -3
  193. package/dist/tools/curation.js.map +1 -1
  194. package/dist/tools/edge-staleness.d.ts.map +1 -1
  195. package/dist/tools/edge-staleness.js +115 -0
  196. package/dist/tools/edge-staleness.js.map +1 -1
  197. package/dist/tools/edges.d.ts.map +1 -1
  198. package/dist/tools/edges.js +94 -0
  199. package/dist/tools/edges.js.map +1 -1
  200. package/dist/tools/read.d.ts +14 -0
  201. package/dist/tools/read.d.ts.map +1 -1
  202. package/dist/tools/read.js +452 -51
  203. package/dist/tools/read.js.map +1 -1
  204. package/dist/tools/receipt.d.ts +1 -1
  205. package/dist/tools/receipt.d.ts.map +1 -1
  206. package/dist/tools/receipt.js +147 -2
  207. package/dist/tools/receipt.js.map +1 -1
  208. package/dist/tools/search.d.ts.map +1 -1
  209. package/dist/tools/search.js +454 -3
  210. package/dist/tools/search.js.map +1 -1
  211. package/dist/tools/staged-actions.d.ts +7 -0
  212. package/dist/tools/staged-actions.d.ts.map +1 -1
  213. package/dist/tools/staged-actions.js +138 -36
  214. package/dist/tools/staged-actions.js.map +1 -1
  215. package/dist/tools/themes.d.ts.map +1 -1
  216. package/dist/tools/themes.js +120 -0
  217. package/dist/tools/themes.js.map +1 -1
  218. package/dist/tools/tier1.d.ts.map +1 -1
  219. package/dist/tools/tier1.js +56 -0
  220. package/dist/tools/tier1.js.map +1 -1
  221. package/dist/tools/tier2.d.ts.map +1 -1
  222. package/dist/tools/tier2.js +111 -1
  223. package/dist/tools/tier2.js.map +1 -1
  224. package/dist/tools/witness.d.ts.map +1 -1
  225. package/dist/tools/witness.js +93 -0
  226. package/dist/tools/witness.js.map +1 -1
  227. package/dist/tools/write.d.ts +1 -0
  228. package/dist/tools/write.d.ts.map +1 -1
  229. package/dist/tools/write.js +479 -216
  230. package/dist/tools/write.js.map +1 -1
  231. package/dist/utils/config.d.ts +2 -0
  232. package/dist/utils/config.d.ts.map +1 -1
  233. package/dist/utils/config.js +160 -86
  234. package/dist/utils/config.js.map +1 -1
  235. package/dist/utils/dates.d.ts +1 -0
  236. package/dist/utils/dates.d.ts.map +1 -1
  237. package/dist/utils/dates.js +5 -0
  238. package/dist/utils/dates.js.map +1 -1
  239. package/package.json +5 -2
package/CHANGELOG.md CHANGED
@@ -5,7 +5,184 @@ All notable changes to this project are documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
- ## [Unreleased]
8
+ ## [2.0.0] - 2026-07-30
9
+
10
+ ### Changed
11
+
12
+ - **MCP 2026-07-28.** The server speaks the final "stateless MCP" revision on
13
+ the v2 SDK line (`@modelcontextprotocol/server` 2.0). `daftari serve` is
14
+ stateless per the spec's Decision 1: the initialize handshake, the
15
+ `Mcp-Session-Id` header, and the session table are gone — identity is
16
+ resolved from the bearer on every request against the same config-declared
17
+ map, and 2025-era traffic is refused (no dual-stacking). stdio serves both
18
+ eras from one factory, so lagging clients use stdio; the RBAC,
19
+ existence-disclosure, and process-lock invariants carry over unchanged.
20
+ Design record:
21
+ `docs/superpowers/specs/2026-07-26-mcp-2026-07-28-readiness-design.md`.
22
+ - `vault_ratify` called without a `decision` now answers with a stateless
23
+ form-mode elicitation (`input_required`): approve/reject with reject
24
+ preselected, plus HMAC-signed opaque state carrying the action id, the
25
+ vault HEAD at proposal time, and the deciding user. A declined form applies
26
+ nothing and leaves the action pending; a direct call with the decision
27
+ inline keeps working. The server proposes, the human disposes — now on the
28
+ wire itself (Decision 5).
29
+ - The maintenance passes (`sleep`, `consolidate`, `audit`, `eval`) remain
30
+ CLI-only: the spec's Decision 4 kill condition fired — the final revision
31
+ moved Tasks to a standalone extension (removing `tasks/list`) and the
32
+ TypeScript SDK ships no tasks runtime yet.
33
+
34
+ ### Added
35
+
36
+ - **Ledger-keeper voice for `vault_lint`.** An optional `lint_voice` config key
37
+ (`plain` default, or `ledger_keeper`) re-renders the `content`-channel lint
38
+ summary in the dry margin-note register of a three-centuries-old ledger-keeper.
39
+ Presentation only: it is a deterministic, templated re-wording (no LLM) of the
40
+ same findings the plain summary reports, selecting and capping them identically,
41
+ and the structured output channel is byte-for-byte unchanged. Default-on
42
+ discoverability is gated on a real-user read (the spec's kill condition). Spec:
43
+ `docs/superpowers/specs/2026-07-30-ledger-keeper-voice-design.md`.
44
+
45
+ - **`vault_canon` — settled vs. contested belief over an emergent topic.**
46
+ Read-only. Given a seed document path and optional holder list, `vault_canon` walks
47
+ the depth-2 belief graph and classifies each claim as settled (no
48
+ contradiction recorded) or contested, attaching a `vault_receipt` as the
49
+ epistemic anchor. Honest-relational: `graph_completeness` is always
50
+ `"curated"`, `partial_visibility`, `unindexed`, and `ghost_holder_warning`
51
+ flags are surfaced when the graph is incomplete. Never auto-resolves.
52
+
53
+ - **Bi-temporal validity.** Two optional built-in frontmatter fields,
54
+ `valid_from` and `valid_until`, recording when a document's claim was true
55
+ *in the world* — as distinct from when the vault recorded it, which git
56
+ history and `created`/`updated` already cover. The window is **half-open**,
57
+ `[valid_from, valid_until)`, day-granular: `valid_until` is the first day the
58
+ claim no longer held, so a successor's `valid_from` is exactly its
59
+ predecessor's `valid_until` and a handoff shares no day. Both null means
60
+ valid-time-unknown, which is never read as "always true"; a contradictory
61
+ window (`valid_until <= valid_from`) reads as unknown everywhere and is
62
+ reported by lint, never evaluated.
63
+ Design record:
64
+ `docs/superpowers/specs/2026-07-26-bitemporal-validity-design.md`.
65
+ - `vault_read` returns a `validity` report alongside `decay`; `vault_status`
66
+ reports `validityCoverage` as a read-only adoption monitor.
67
+ - `vault_search` gains `valid_at` (annotate hits by their state at a date, and
68
+ foreground the chain member covering it) and `valid_only` (drop hits outside
69
+ their interval; documents with no authored interval are kept).
70
+ - `vault_lint` gains a `validityConflicts` check: malformed endpoints,
71
+ inverted intervals, supersession overlaps and gaps, and canonical documents
72
+ whose validity ended with no successor.
73
+ - `vault_supersede`, `vault_deprecate`, and `vault_merge` gain an optional
74
+ `predecessor_valid_until` argument — the date the successor takes over —
75
+ written verbatim to the predecessor's `valid_until`. The successor is never
76
+ modified; the result carries a hint instead.
77
+ - `daftari asof --valid <date>` — the bi-temporal query: "on this commit,
78
+ what did the vault believe was true on that date?"
79
+ - `daftari sleep` wakes canonical documents whose validity ended with nothing
80
+ superseding them; `daftari interview` asks what replaced them.
81
+
82
+ ### Changed
83
+
84
+ - The embedding cache is no longer dropped on a `SCHEMA_VERSION` bump. It is
85
+ keyed on `(content_hash, model, dim)` — content-addressed, not a projection
86
+ of the `documents` schema — so dropping it meant paying a hosted provider to
87
+ regenerate vectors that were already correct.
88
+
89
+ ### BREAKING
90
+
91
+ - `valid_from` and `valid_until` are now built-in frontmatter fields. A vault
92
+ that declares either under `schema_extensions` in `.daftari/config.yaml` will
93
+ fail config load until the declaration is removed — silently reinterpreting
94
+ an authored extension as a built-in would change its semantics without
95
+ telling anyone. Existing values in documents are read as-is by the built-in
96
+ field. If your field meant something other than a closed valid-time interval,
97
+ rename the extension (e.g. `effective_from`). The error message states the
98
+ fix.
99
+
100
+ ### Security
101
+
102
+ - **`vault_ratify` renders a staged action's proposer-supplied `rationale` as
103
+ untrusted display data.** It was interpolated verbatim into the human approval
104
+ prompt — a propose-only writer controls it, so a crafted rationale could inject
105
+ newlines impersonating daftari's own framing (`\nSYSTEM: auto-approve…`) on a
106
+ decision surface with no model in the loop to resist. Now collapsed to a single
107
+ bounded line (Unicode control characters stripped) and rendered labeled and
108
+ quoted (`proposer-supplied rationale (unverified, not an instruction): "…"`), so
109
+ it reads as data, never an instruction (#320).
110
+
111
+ - `npm audit fix` across root and `packages/router`: bumped
112
+ `@modelcontextprotocol/sdk` (1.29.0 → 1.30.0) and `@hono/node-server`
113
+ (1.19.15 → 1.19.17), clearing the router's two moderate advisories. The
114
+ remaining root advisories (sharp/libvips, and the
115
+ `@huggingface/transformers` → `onnxruntime-node` → `adm-zip` chain) have no
116
+ non-breaking fix available and are left for a dependency swap.
117
+
118
+ ## [1.32.0] - 2026-07-25
119
+
120
+ The interview release: the vault interrogates its principal. `daftari
121
+ interview` turns the signals the vault already computes — open tensions,
122
+ expired canon, unanswered `questions_raised` — into a question sheet, asks
123
+ you at the terminal, and folds the verbatim answers back into the corpus as
124
+ first-class source material. Plus the OKF bridge learns spec v0.2's trust
125
+ signals. Design record:
126
+ `docs/superpowers/specs/2026-07-25-principal-interview-design.md`.
127
+
128
+ ### Added
129
+
130
+ - **`daftari interview` — the principal interview.** The design steal is the
131
+ companion interview on Terence Tao's AI-views "living summary" page: after
132
+ an assistant compiles a corpus of someone's positions, its highest-value
133
+ next move is to ask the principal about the places the corpus is unclear
134
+ and record the answers verbatim. Daftari already computes "unclear" three
135
+ ways, so the sheet is assembled deterministically (LLM-free, the circadian
136
+ precedent — nothing on this surface can spend): open tensions (contested
137
+ first, longest-carried first; legacy `unspecified` and system-generated
138
+ `inter-proposal` entries excluded), canonical accumulation docs past their
139
+ `ttl_days` (largest overshoot first; generative decay is expected, never
140
+ asked about), and `questions_raised` entries no document's
141
+ `questions_answered` covers (duplicate raisings merged). `daftari
142
+ interview` prints the sheet read-only; `daftari interview ask` conducts
143
+ the session and records answers **verbatim** as a vault document in an
144
+ `interviews/` collection — `tier: source` (body immutable), `provenance:
145
+ direct`, `ttl_days: null` (testimony doesn't expire), `sources` tracing
146
+ each question back to its prompting signal, `questions_answered` carrying
147
+ the question texts so a later sheet never re-asks. The write round-trips
148
+ the parser before touching disk, is confined by the same vault-path gate
149
+ as every other write, and auto-commits honoring `auto_commit`/`git_dir`.
150
+ Recording testimony resolves nothing: the CLI ends by pointing at
151
+ `daftari court rule <id> --references <transcript>` and at re-verified
152
+ writes — a tension may never masquerade as a supersession. Operator-only
153
+ like the court (no access context, no MCP tool); the `--collection` flag
154
+ is allow-listed (one path segment, reserved names rejected) so the
155
+ transcript can neither respell its RBAC collection nor land where vault
156
+ scans can't see it.
157
+
158
+ ### Changed
159
+
160
+ - **OKF bridge upgraded to spec v0.2 — trust signals.** OKF v0.2 adds opt-in
161
+ trust metadata (raw credibility indicators, never computed scores); the
162
+ `daftari okf` bridge now speaks it in both directions. Export derives the
163
+ signals from native metadata: `updated`/`updated_by` become
164
+ `generated: {by, at}` (the spec's rename of v0.1 `timestamp`), the Daftari
165
+ lifecycle maps onto `status: draft|stable|deprecated`
166
+ (canonical → stable; deprecated/superseded/archived → deprecated),
167
+ `ttl_days` becomes an absolute `stale_after` date anchored at `updated`, and
168
+ `sources` become structured `{id, resource}` entries. `verified` is never
169
+ fabricated — Daftari records authorship, not independent confirmations, so
170
+ exported docs honestly carry the "unverified" trust tier. Import understands
171
+ the signals: `generated.at` dates the doc (falling back to `timestamp` per
172
+ spec), a human-reviewed doc (`human:*` in `verified`) lands with
173
+ `confidence: high` (positive signals only ever raise confidence — absence
174
+ keeps the `medium` default, since an unverified v0.2 doc is
175
+ indistinguishable from a v0.1 doc), `status: deprecated` imports as
176
+ `deprecated` instead of resurfacing as a fresh draft, and `stale_after`
177
+ converts to `ttl_days`. The new `Attested Computation` concept type is
178
+ surfaced in an import warning but never auto-elevated to a write-protected
179
+ tier — `tier: source` is enforcement whose only sanctioned grant path is
180
+ `vault_set_tier` (reason required, provenance-logged), and a foreign
181
+ bundle's self-declared `type` must not buy it; the operator reviews and
182
+ elevates deliberately. OKF
183
+ fields with no lossless Daftari slot (the trust record, the attestation
184
+ machinery, unknown producer fields) are preserved under `okf_*` keys, so
185
+ import stays non-destructive. v0.1 bundles import unchanged.
9
186
 
10
187
  ## [1.31.0] - 2026-07-22
11
188
 
@@ -1482,6 +1659,7 @@ vault to AI agents, exposing 13 tools over stdio.
1482
1659
  example documents, git history, search index); `daftari --vault` serves it.
1483
1660
  - 160 tests covering all 13 tools and their supporting modules.
1484
1661
 
1662
+ [1.32.0]: https://github.com/mavaali/daftari/releases/tag/v1.32.0
1485
1663
  [1.31.0]: https://github.com/mavaali/daftari/releases/tag/v1.31.0
1486
1664
  [1.5.1]: https://github.com/mavaali/daftari/releases/tag/v1.5.1
1487
1665
  [1.4.0]: https://github.com/mavaali/daftari/releases/tag/v1.4.0
package/README.md CHANGED
@@ -93,6 +93,14 @@ deterministic summary flags, the vault's git HEAD as an as-of anchor, and a
93
93
  recomputable hash over the whole receipt. Attach it to the answer so any
94
94
  consumer can see what the answer stands on.
95
95
 
96
+ **Believe:** `vault_canon` — compute settled vs. contested belief across
97
+ holders over an emergent topic (params: `seed`, `holders?`, `as_of?`,
98
+ `depth?`). Returns a per-claim settled/contested classification, integrity
99
+ flags (`graph_completeness: "curated"`, `partial_visibility`, `unindexed`,
100
+ `ghost_holder_warning`), and an attached `vault_receipt` as the epistemic
101
+ anchor. Recorded, not omniscient: settled means no contradiction is on record,
102
+ not that none exists. Never auto-resolves.
103
+
96
104
  **Witness:** `vault_witness` — per-principal track records from the vault's
97
105
  own ledgers, priced by the wager schedule: write volume, live claims with
98
106
  open exposure, contested claims with stake at risk, the settled book
@@ -204,6 +212,8 @@ provenance: synthesized
204
212
  sources:
205
213
  - aurora-product-page
206
214
  ttl_days: 120
215
+ valid_from: 2026-05-01
216
+ valid_until: null
207
217
  tags: [aurora, ingestion, competitive]
208
218
  questions_answered:
209
219
  - "How does Aurora frame the ingestion/transformation boundary?"
@@ -216,6 +226,27 @@ Documents can make their epistemic edges explicit: `questions_answered` is what
216
226
  later agents can take as settled, `questions_raised` is where to build next.
217
227
  `vault_lint` turns the open questions across the vault into a coverage map.
218
228
 
229
+ `valid_from` / `valid_until` are the second temporal axis. Everything else in
230
+ the file records **transaction time** — when the vault came to believe
231
+ something. These record **valid time**: when the claim was true in the world. A
232
+ document edited this morning can describe a price that stopped applying in
233
+ March, and only the second axis can tell you so.
234
+
235
+ The window is half-open — `[valid_from, valid_until)` — so `valid_until` is the
236
+ first day the claim no longer held, and a successor's `valid_from` is exactly
237
+ its predecessor's `valid_until`. Handoffs share no day and leave no gap. The
238
+ fields are optional and always authored: nothing derives them from git dates or
239
+ mtime, because that would manufacture a claim nobody made. Both null means
240
+ unknown, which is never read as "always true".
241
+
242
+ That makes supersession checkable rather than merely asserted:
243
+
244
+ ```bash
245
+ daftari asof 2026-04-01 --valid 2026-01-15
246
+ ```
247
+
248
+ "On April 1st, what did the vault believe was true on January 15th?"
249
+
219
250
  Full field reference in <docs/file-format.md>.
220
251
 
221
252
  ## Adopting an existing vault
@@ -271,16 +302,25 @@ daftari backfill --apply --scope specs
271
302
  ## Open Knowledge Format (OKF)
272
303
 
273
304
  [OKF](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing/)
274
- is Google Cloud's vendor-neutral spec (v0.1) for the LLM-wiki pattern: a
275
- directory of markdown files with YAML frontmatter that any producer can emit and
276
- any consumer can read without translation. A Daftari vault *is* that pattern, so
277
- `daftari okf` bridges the two directions.
305
+ is Google Cloud's vendor-neutral spec for the LLM-wiki pattern: a directory of
306
+ markdown files with YAML frontmatter that any producer can emit and any consumer
307
+ can read without translation. A Daftari vault *is* that pattern, so `daftari
308
+ okf` bridges the two directions.
309
+ [v0.2](https://cloud.google.com/blog/products/data-analytics/okf-v0-2-adds-trust-signals/)
310
+ adds opt-in **trust signals** — raw credibility indicators (provenance,
311
+ verification, lifecycle, freshness), never computed scores — and Daftari maps
312
+ them from/to its native metadata.
278
313
 
279
314
  **Export** renders the vault as a portable OKF bundle — every doc becomes an OKF
280
- concept doc (the core `type` / `title` / `description` / `resource` / `tags` /
281
- `timestamp` fields, plus a verbatim `daftari` sidecar for lossless round-trip),
282
- with generated `index.md` (progressive-disclosure listing) and `log.md`
283
- (chronological history). The source vault is never mutated.
315
+ concept doc (the core `type` / `title` / `description` / `resource` / `tags`
316
+ fields, plus a verbatim `daftari` sidecar for lossless round-trip), with
317
+ generated `index.md` (progressive-disclosure listing) and `log.md`
318
+ (chronological history). Trust signals derive from native metadata:
319
+ `updated`/`updated_by` become `generated`, the lifecycle maps to
320
+ `draft`/`stable`/`deprecated`, `ttl_days` becomes an absolute `stale_after`
321
+ date, and `sources` become structured entries. `verified` is never fabricated —
322
+ Daftari records authorship, not independent confirmations, so exported docs
323
+ honestly read as unverified. The source vault is never mutated.
284
324
 
285
325
  ```bash
286
326
  daftari okf export ./my-vault --out ./okf-bundle
@@ -290,7 +330,17 @@ daftari okf export ./my-vault --out ./okf-bundle --collection pricing
290
330
  **Import** adopts an OKF bundle into a vault. A bundle produced by `okf export`
291
331
  round-trips exactly via its sidecar; a foreign bundle is mapped conservatively
292
332
  (docs land as `draft` in the `accumulation` domain, the original OKF `type` is
293
- preserved in an `okf_type` field). Writes auto-commit and the index is rebuilt.
333
+ preserved in an `okf_type` field). Trust signals inform the mapping: a
334
+ human-reviewed doc (a `human:*` entry in `verified`) imports with `confidence:
335
+ high`, `status: deprecated` stays `deprecated` (retired knowledge must not
336
+ resurface as a fresh draft), and `stale_after` converts to `ttl_days`. An
337
+ `Attested Computation` is surfaced in an import warning but **not**
338
+ auto-write-protected: `tier: source` is enforcement, and its only sanctioned
339
+ grant path is `vault_set_tier` (reason required, provenance-logged) — a foreign
340
+ bundle's self-declared `type` doesn't buy it. Review the doc, then elevate
341
+ deliberately. OKF fields with no lossless Daftari slot (the trust record,
342
+ attestation machinery) are preserved under `okf_*` keys. Writes auto-commit and
343
+ the index is rebuilt.
294
344
 
295
345
  ```bash
296
346
  daftari okf import ./okf-bundle --into ./my-vault --dry-run
@@ -628,6 +678,36 @@ collection-pair > same-kind; no LLM): the court retrieves how this house has
628
678
  resolved similar disputes before, and whether a precedent applies stays the
629
679
  human's judgment. Memory grows case law.
630
680
 
681
+ ## The principal interview
682
+
683
+ The vault interrogates you. `daftari interview` assembles a question sheet
684
+ from what the vault already knows is unclear — open tensions (contested
685
+ first, longest-carried first), canonical accumulation docs past their TTL,
686
+ and `questions_raised` entries no document answers — deterministic and
687
+ LLM-free, like the circadian pass:
688
+
689
+ ```bash
690
+ # The sheet — read-only, priority-ordered
691
+ daftari interview --vault ./my-vault
692
+
693
+ # Sit for it. Answers are recorded VERBATIM; empty skips, 'q' ends.
694
+ daftari interview ask --vault ./my-vault
695
+ ```
696
+
697
+ Answered questions become a transcript document in an `interviews/`
698
+ collection — `tier: source` (your words, body immutable), `provenance:
699
+ direct`, no TTL (testimony doesn't expire) — committed like any other write,
700
+ with `sources` tracing each question back to the tension or document that
701
+ prompted it. The pattern is the companion interview on a living-summary
702
+ page: the compiler's highest-value move is not more compilation, it is
703
+ asking the principal about the unclear spots and folding the verbatim
704
+ answers back into the corpus.
705
+
706
+ Recording testimony resolves nothing. The transcript is *evidence*: the CLI
707
+ ends by pointing at `daftari court rule <id> --references <transcript>` for
708
+ tensions it touched, and at re-verified writes for stale docs. Operator-only,
709
+ like the court — no MCP tool, no access context.
710
+
631
711
  ## Belief archaeology
632
712
 
633
713
  Git is the version layer, so the vault can answer **"what did we believe on
@@ -14,6 +14,7 @@ export declare function canPromote(role: RoleConfig | null): boolean;
14
14
  export declare function canRatify(role: RoleConfig | null): boolean;
15
15
  export declare function isProposeOnly(role: RoleConfig | null): boolean;
16
16
  export declare function hasAnyRead(role: RoleConfig | null): boolean;
17
+ export declare function readableCollections(role: RoleConfig | null): string[] | undefined;
17
18
  export declare function filterByReadPermission<T extends {
18
19
  collection: string;
19
20
  }>(role: RoleConfig | null, items: T[]): T[];
@@ -1 +1 @@
1
- {"version":3,"file":"rbac.d.ts","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpE,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,QAAQ,MAAM,CAAC;AAI5B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAKD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,aAAa,CAEf;AAID,wBAAgB,WAAW,CAAC,IAAI,SAAU,GAAG,aAAa,CAEzD;AAOD,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7E;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE3D;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE1D;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE9D;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE3D;AAID,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EACrE,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,KAAK,EAAE,CAAC,EAAE,GACT,CAAC,EAAE,CAEL"}
1
+ {"version":3,"file":"rbac.d.ts","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpE,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,QAAQ,MAAM,CAAC;AAI5B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAKD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,aAAa,CAEf;AAID,wBAAgB,WAAW,CAAC,IAAI,SAAU,GAAG,aAAa,CAEzD;AAOD,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7E;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE3D;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE1D;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE9D;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE3D;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,SAAS,CAIjF;AAID,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EACrE,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,KAAK,EAAE,CAAC,EAAE,GACT,CAAC,EAAE,CAEL"}
@@ -54,6 +54,22 @@ export function isProposeOnly(role) {
54
54
  export function hasAnyRead(role) {
55
55
  return role !== null && role.read.length > 0;
56
56
  }
57
+ // The explicit list of collections a role may read, for pushing an ACL filter
58
+ // down into a query (the vector KNN — 2026-07-26 fusion spec, Decision 3).
59
+ //
60
+ // Three cases, and the distinction between the last two is load-bearing:
61
+ // - wildcard read → undefined, meaning "no filter needed" (reads everything)
62
+ // - a null role → [], meaning "reads nothing" — the deny-all guest
63
+ // - a scoped role → its declared collections
64
+ // A caller must not collapse [] into undefined: one is a guest who may see
65
+ // nothing, the other is an operator with no access context at all.
66
+ export function readableCollections(role) {
67
+ if (role === null)
68
+ return [];
69
+ if (role.read.includes(WILDCARD))
70
+ return undefined;
71
+ return [...role.read];
72
+ }
57
73
  // Keeps only the items in collections the role may read. Each item must carry
58
74
  // a `collection` field.
59
75
  export function filterByReadPermission(role, items) {
@@ -1 +1 @@
1
- {"version":3,"file":"rbac.js","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAI1E,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAU5B,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAC3B,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,IAAY,EACZ,QAAgB;IAEhB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,2EAA2E;AAC3E,0BAA0B;AAC1B,MAAM,UAAU,WAAW,CAAC,IAAI,GAAG,OAAO;IACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,UAAkB;IACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,UAAkB;IACjE,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,IAAuB,EAAE,UAAkB;IAClE,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC/C,OAAO,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,yBAAyB;AACzB,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,OAAO,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,MAAM,UAAU,sBAAsB,CACpC,IAAuB,EACvB,KAAU;IAEV,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC"}
1
+ {"version":3,"file":"rbac.js","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAI1E,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAU5B,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAC3B,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,IAAY,EACZ,QAAgB;IAEhB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,2EAA2E;AAC3E,0BAA0B;AAC1B,MAAM,UAAU,WAAW,CAAC,IAAI,GAAG,OAAO;IACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,UAAkB;IACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,UAAkB;IACjE,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,IAAuB,EAAE,UAAkB;IAClE,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC/C,OAAO,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,yBAAyB;AACzB,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,OAAO,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC;AACpC,CAAC;AAED,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,gDAAgD;AAChD,2EAA2E;AAC3E,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,MAAM,UAAU,sBAAsB,CACpC,IAAuB,EACvB,KAAU;IAEV,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asof/index.ts"],"names":[],"mappings":"AA2DA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqF7D"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asof/index.ts"],"names":[],"mappings":"AAmEA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkG7D"}
@@ -9,6 +9,7 @@
9
9
  import { writeFile } from "node:fs/promises";
10
10
  import { resolve } from "node:path";
11
11
  import { listTensions } from "../curation/tension.js";
12
+ import { normalizeIsoDate } from "../utils/dates.js";
12
13
  import { isGitRepo } from "../utils/git.js";
13
14
  import { resolveAsofCommit } from "./git-read.js";
14
15
  import { renderJson, renderMarkdown } from "./report.js";
@@ -37,6 +38,13 @@ Flags:
37
38
  vault_tension_blast), each downstream doc annotated
38
39
  with its status today. "This fact turned out wrong —
39
40
  who had inherited it, and where are they now?"
41
+ --valid <date> Add the second temporal axis: of the documents at
42
+ that commit, how many asserted a validity window
43
+ covering this date. "On <ref>, what did the vault
44
+ believe was true on <date>?" Valid time is authored
45
+ and never inferred, so any commit predating a vault's
46
+ adoption of valid_from/valid_until reports every
47
+ document as unwindowed.
40
48
  --output <md> Markdown report destination (default: stdout).
41
49
  --output-json <json> JSON report destination (default: not written).
42
50
 
@@ -79,7 +87,17 @@ export async function runAsof(argv) {
79
87
  process.stderr.write(`daftari asof: ${tensionsNow.error.message}\n`);
80
88
  return 3;
81
89
  }
82
- const snapshot = await beliefSnapshot(vaultRoot, commit.value, tensionsNow.value);
90
+ const rawValidAt = readStringArg(argv, "--valid");
91
+ let validAt;
92
+ if (rawValidAt !== undefined) {
93
+ const normalized = normalizeIsoDate(rawValidAt);
94
+ if (normalized === null) {
95
+ process.stderr.write(`daftari asof: --valid must be a YYYY-MM-DD date, got "${rawValidAt}"\n`);
96
+ return 2;
97
+ }
98
+ validAt = normalized;
99
+ }
100
+ const snapshot = await beliefSnapshot(vaultRoot, commit.value, tensionsNow.value, validAt);
83
101
  if (!snapshot.ok) {
84
102
  process.stderr.write(`daftari asof: ${snapshot.error.message}\n`);
85
103
  return 3;
@@ -135,7 +153,10 @@ export async function runAsof(argv) {
135
153
  // The positional <ref-or-date> is the first argv entry that is neither a
136
154
  // --flag nor the value of a value-taking flag (the `--flag value` form; the
137
155
  // `--flag=value` form never occupies its own entry).
138
- const VALUE_FLAGS = ["--vault", "--doc", "--blast", "--output", "--output-json"];
156
+ // Every flag that takes a separate value must be listed here, or findPositional
157
+ // mistakes that value for the positional ref — `--valid 2026-02-15 HEAD`
158
+ // would resolve the DATE as the ref and silently report the wrong commit.
159
+ const VALUE_FLAGS = ["--vault", "--doc", "--blast", "--output", "--output-json", "--valid"];
139
160
  function findPositional(argv) {
140
161
  for (let i = 0; i < argv.length; i++) {
141
162
  const a = argv[i];
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/asof/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/asof/index.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/asof/report.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI7E,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAeD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2GzD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD"}
1
+ {"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/asof/report.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI7E,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAeD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAyIzD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD"}
@@ -28,6 +28,30 @@ export function renderMarkdown(report) {
28
28
  lines.push(`- by status: ${countLine(snapshot.byStatus)}`);
29
29
  lines.push(`- by collection: ${countLine(snapshot.byCollection)}`);
30
30
  lines.push("");
31
+ // The second temporal axis, only when asked for. Rendered BEFORE drift
32
+ // because drift is transaction time and this is valid time — keeping them
33
+ // visually separate is the whole point of having two axes.
34
+ const va = snapshot.validity;
35
+ if (va) {
36
+ lines.push(`## Valid at ${va.date}`);
37
+ if (va.unwindowed === snapshot.docCount) {
38
+ // A bare "0 in-window" would read as "nothing was true then". It is not
39
+ // a finding about the world; it is the absence of a record.
40
+ lines.push(`- no document at this ref carries authored validity, so the vault ` +
41
+ `cannot say what held on ${va.date}. Valid time is authored, never ` +
42
+ `inferred, so this is permanent for this ref — not something a ` +
43
+ `later reindex fills in.`);
44
+ }
45
+ else {
46
+ lines.push(`- asserted valid then: **${va.inWindow}** · outside their window: ` +
47
+ `**${va.outOfWindow}** · no window asserted: **${va.unwindowed}**`);
48
+ if (va.unwindowed > 0) {
49
+ lines.push(`- the **${va.unwindowed}** unwindowed are not counted either way: ` +
50
+ "the vault was never told when their claims held.");
51
+ }
52
+ }
53
+ lines.push("");
54
+ }
31
55
  lines.push(`## Drift since (${short}..now)`);
32
56
  const d = snapshot.drift;
33
57
  lines.push(`- added: **${d.added.length}** · removed: **${d.removed.length}** · ` +
@@ -1 +1 @@
1
- {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/asof/report.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,oEAAoE;AACpE,0EAA0E;AAC1E,yEAAyE;AAIzE,MAAM,QAAQ,GAAG,EAAE,CAAC;AAUpB,SAAS,UAAU,CAAC,KAAe,EAAE,MAA6B;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,QAAQ,OAAO,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,MAA8B;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,6BAA6B,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,oBAAoB,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IACzB,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,CAAC,KAAK,CAAC,MAAM,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,OAAO;QACpE,yBAAyB,CAAC,CAAC,WAAW,CAAC,MAAM,0BAA0B,CAAC,CAAC,aAAa,IAAI,CAC7F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,QAAQ,eAAe,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,QAAQ,oBAAoB,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;IAC5E,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CACR,uCAAuC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM;YAC/D,KAAK,MAAM,CAAC,cAAc,CAAC,MAAM,eAAe;YAChD,YAAY,MAAM,CAAC,YAAY,cAAc,MAAM,CAAC,aAAa,IAAI;YACrE,aAAa,MAAM,CAAC,QAAQ,KAAK;YACjC,eAAe,MAAM,CAAC,iBAAiB,mCAAmC;YAC1E,KAAK,MAAM,CAAC,OAAO,cAAc,CACpC,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC5E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,eAAe,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;YACtF,CAAC;YACD,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,QAAQ,eAAe,CAAC,CAAC;YAC/E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;QACnF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5D,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,kCAAkC,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;YAClF,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/asof/report.ts"],"names":[],"mappings":"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"}
@@ -36,9 +36,15 @@ export interface AsofSnapshot {
36
36
  resolutionKind: string;
37
37
  }[];
38
38
  };
39
+ validity?: {
40
+ date: string;
41
+ inWindow: number;
42
+ outOfWindow: number;
43
+ unwindowed: number;
44
+ };
39
45
  }
40
46
  export declare function computeTransitions(then: LoadedDoc[], now: LoadedDoc[]): BeliefTransition[];
41
- export declare function beliefSnapshot(vaultRoot: string, commit: AsofCommit, tensionsNow: TensionEntry[]): Promise<Result<AsofSnapshot, Error>>;
47
+ export declare function beliefSnapshot(vaultRoot: string, commit: AsofCommit, tensionsNow: TensionEntry[], validAt?: string): Promise<Result<AsofSnapshot, Error>>;
42
48
  export interface ReplayEntry {
43
49
  path: string;
44
50
  dependency_type: BlastDependencyType;
@@ -1 +1 @@
1
- {"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/asof/snapshot.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/asof/snapshot.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,7 @@
7
7
  // literal comparison between the two. Nothing is synthesized.
8
8
  import { parseTensionLog } from "../curation/tension.js";
9
9
  import { buildReverseLinkMap, buildReverseSourceMap, computeBlast, } from "../curation/tension-blast.js";
10
+ import { computeValidity } from "../curation/validity.js";
10
11
  import { loadDocuments } from "../curation/vault-docs.js";
11
12
  import { parseDocument } from "../frontmatter/parser.js";
12
13
  import { err, ok } from "../frontmatter/types.js";
@@ -88,7 +89,7 @@ async function tensionsAt(vaultRoot, commit) {
88
89
  const raw = blob.value.get(TENSIONS_LOG);
89
90
  return raw === undefined ? [] : parseTensionLog(raw);
90
91
  }
91
- export async function beliefSnapshot(vaultRoot, commit, tensionsNow) {
92
+ export async function beliefSnapshot(vaultRoot, commit, tensionsNow, validAt) {
92
93
  const thenDocs = await loadDocumentsAt(vaultRoot, commit.hash);
93
94
  if (!thenDocs.ok)
94
95
  return thenDocs;
@@ -137,8 +138,34 @@ export async function beliefSnapshot(vaultRoot, commit, tensionsNow) {
137
138
  openedSince,
138
139
  resolvedSince,
139
140
  },
141
+ // A pure post-filter over the documents already loaded at the ref. Drift
142
+ // and the status rollup are deliberately untouched: drift is a
143
+ // transaction-time notion (what the vault RECORDED between then and now),
144
+ // and mixing the axes is the confusion this feature exists to remove.
145
+ ...(validAt !== undefined ? { validity: partitionByValidity(thenDocs.value, validAt) } : {}),
140
146
  });
141
147
  }
148
+ // Splits the docs at a ref into covering / not-covering / unknown at a date.
149
+ function partitionByValidity(docs, date) {
150
+ let inWindow = 0;
151
+ let outOfWindow = 0;
152
+ let unwindowed = 0;
153
+ for (const d of docs) {
154
+ const report = computeValidity({
155
+ valid_from: d.frontmatter.valid_from ?? null,
156
+ valid_until: d.frontmatter.valid_until ?? null,
157
+ }, date);
158
+ // Null (no interval authored) and "unknown" (malformed endpoint) both mean
159
+ // the vault cannot answer for this document. Neither is a "no".
160
+ if (report === null || report.state === "unknown")
161
+ unwindowed += 1;
162
+ else if (report.state === "in-window")
163
+ inWindow += 1;
164
+ else
165
+ outOfWindow += 1;
166
+ }
167
+ return { date, inWindow, outOfWindow, unwindowed };
168
+ }
142
169
  // "This fact turned out wrong — who had inherited it at the time, and where
143
170
  // are they now?" Blast is computed over the tree AS OF the commit (the same
144
171
  // source/link edge semantics as vault_tension_blast), then each downstream