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/dist/okf/map.js CHANGED
@@ -2,7 +2,7 @@
2
2
  // export/import modules own that. Keeping the field translation here makes it
3
3
  // unit-testable in isolation and keeps the two directions symmetric.
4
4
  import { normalizeIsoDate } from "../utils/dates.js";
5
- import { DAFTARI_SIDECAR_KEY, DEFAULT_IMPORT_COLLECTION, DEFAULT_OKF_TYPE } from "./types.js";
5
+ import { DAFTARI_SIDECAR_KEY, DEFAULT_IMPORT_COLLECTION, DEFAULT_OKF_TYPE, OKF_ATTESTED_COMPUTATION_TYPE, OKF_PRESERVED_PREFIX, } from "./types.js";
6
6
  // True when `s` looks like an absolute URI (has a scheme + "://"). Daftari
7
7
  // `sources` are often bare ids ("aurora-product-page"); only URI-shaped ones map
8
8
  // to OKF's `resource`, which is defined as a URI identifying the asset.
@@ -37,6 +37,48 @@ export function toIsoTimestamp(date) {
37
37
  const norm = normalizeIsoDate(date);
38
38
  return norm === null ? undefined : `${norm}T00:00:00Z`;
39
39
  }
40
+ // Daftari lifecycle → OKF v0.2 `status`. `canonical` is the vault's "current,
41
+ // trusted" state (OKF `stable`); everything retired — deprecated, superseded,
42
+ // archived — maps to `deprecated`, which OKF keeps for historical
43
+ // reproducibility without surfacing to new work.
44
+ export function statusToOkf(status) {
45
+ if (status === "draft")
46
+ return "draft";
47
+ if (status === "canonical")
48
+ return "stable";
49
+ return "deprecated";
50
+ }
51
+ // Daftari's relative `ttl_days` → OKF v0.2 absolute `stale_after` date
52
+ // (`updated` + TTL). OKF deliberately uses an absolute date so staleness checks
53
+ // are deterministic; anchoring at `updated` preserves the exact day the TTL
54
+ // would have expired. Undefined when there is no TTL (no freshness promise) or
55
+ // no valid `updated` to anchor it to.
56
+ export function staleAfterFromTtl(updated, ttlDays) {
57
+ if (ttlDays === null || !Number.isFinite(ttlDays))
58
+ return undefined;
59
+ const norm = normalizeIsoDate(updated);
60
+ if (norm === null)
61
+ return undefined;
62
+ const d = new Date(`${norm}T00:00:00Z`);
63
+ d.setUTCDate(d.getUTCDate() + Math.trunc(ttlDays));
64
+ return d.toISOString().slice(0, 10);
65
+ }
66
+ // One Daftari source string → an OKF v0.2 structured source entry. URI-shaped
67
+ // sources carry the URI in `resource` with an `id` slug derived from the last
68
+ // path segment (the citation handle); bare ids are already ids. Daftari has no
69
+ // per-source author/usage_count/last_modified to offer — OKF signals are
70
+ // opt-in, so those are simply absent.
71
+ export function toOkfSource(source) {
72
+ if (!isUri(source))
73
+ return { id: source };
74
+ const tail = source
75
+ .replace(/[?#].*$/, "")
76
+ .split("/")
77
+ .filter((p) => p !== "")
78
+ .pop() ?? source;
79
+ const id = slugify(tail.replace(/\.[a-z0-9]+$/i, "")) ?? slugify(source) ?? source;
80
+ return { id, resource: source };
81
+ }
40
82
  // Daftari document → OKF concept-doc frontmatter. `raw` is the document's
41
83
  // original frontmatter verbatim; it is stashed under the `daftari` key so an
42
84
  // `okf import` of this bundle can reconstruct the source exactly rather than
@@ -57,9 +99,26 @@ export function daftariToOkf(raw, fm, body) {
57
99
  out.resource = resource;
58
100
  if (fm.tags.length > 0)
59
101
  out.tags = fm.tags;
60
- const timestamp = toIsoTimestamp(fm.updated);
61
- if (timestamp !== undefined)
62
- out.timestamp = timestamp;
102
+ // v0.2 trust signals, derived from native Daftari metadata. `generated`
103
+ // replaces the v0.1 `timestamp` (the spec's deliberate rename): `updated_by`
104
+ // is who last produced the content, `updated` is when it last meaningfully
105
+ // changed. `verified` is deliberately NOT emitted — Daftari records
106
+ // authorship, not independent confirmations, and OKF's trust tiers make the
107
+ // absence meaningful (unverified) rather than fabricating a signal.
108
+ const generated = {};
109
+ if (fm.updated_by.trim() !== "")
110
+ generated.by = fm.updated_by;
111
+ const at = toIsoTimestamp(fm.updated);
112
+ if (at !== undefined)
113
+ generated.at = at;
114
+ if (Object.keys(generated).length > 0)
115
+ out.generated = generated;
116
+ out.status = statusToOkf(fm.status);
117
+ const staleAfter = staleAfterFromTtl(fm.updated, fm.ttl_days);
118
+ if (staleAfter !== undefined)
119
+ out.stale_after = staleAfter;
120
+ if (fm.sources.length > 0)
121
+ out.sources = fm.sources.map(toOkfSource);
63
122
  // Lossless round-trip channel. Never overwritten by the derived fields above
64
123
  // because it lives under its own key.
65
124
  out[DAFTARI_SIDECAR_KEY] = raw;
@@ -103,6 +162,98 @@ function asStringArray(value) {
103
162
  return [];
104
163
  return value.filter((v) => typeof v === "string");
105
164
  }
165
+ function asRecord(value) {
166
+ return value !== null && typeof value === "object" && !Array.isArray(value)
167
+ ? value
168
+ : null;
169
+ }
170
+ // True when the doc carries a usable `daftari` sidecar — the exact test
171
+ // okfToDaftari uses to take the verbatim round-trip path. Key presence alone is
172
+ // not enough: a non-object sidecar value is ignored and the doc is synthesized
173
+ // as foreign, so callers gating on "is this a round-trip?" must share this
174
+ // check rather than re-deriving it.
175
+ export function hasDaftariSidecar(okfRaw) {
176
+ const sidecar = okfRaw[DAFTARI_SIDECAR_KEY];
177
+ return sidecar !== null && typeof sidecar === "object" && !Array.isArray(sidecar);
178
+ }
179
+ // True when an OKF `type` names the v0.2 Attested Computation concept. Used by
180
+ // import to flag these docs for deliberate operator review (vault_set_tier) —
181
+ // never to grant write protection automatically: a foreign bundle's
182
+ // self-declared type is not an authorization.
183
+ export function isAttestedComputation(type) {
184
+ return (typeof type === "string" &&
185
+ type.trim().toLowerCase() === OKF_ATTESTED_COMPUTATION_TYPE.toLowerCase());
186
+ }
187
+ // The document date of an OKF doc: v0.2 `generated.at`, falling back to the
188
+ // v0.1 `timestamp` it renamed (the spec-mandated consumer fallback).
189
+ export function dateFromGenerated(okfRaw) {
190
+ const generated = asRecord(okfRaw.generated);
191
+ return dateFromTimestamp(generated?.at) ?? dateFromTimestamp(okfRaw.timestamp);
192
+ }
193
+ export function trustTier(verified) {
194
+ if (!Array.isArray(verified) || verified.length === 0)
195
+ return "unverified";
196
+ const humanReviewed = verified.some((entry) => {
197
+ const by = asRecord(entry)?.by;
198
+ return typeof by === "string" && by.startsWith("human:");
199
+ });
200
+ return humanReviewed ? "human-reviewed" : "machine-confirmed";
201
+ }
202
+ // OKF v0.2 absolute `stale_after` → Daftari's relative `ttl_days`, anchored at
203
+ // the doc's derived date so the freshness promise expires on the same calendar
204
+ // day. A stale_after at or before the anchor clamps to 0 — computeStaleness
205
+ // reads a non-positive TTL as "stale the moment it ages", which is exactly what
206
+ // an already-passed absolute date means. Null when either date is unusable.
207
+ export function ttlFromStaleAfter(staleAfter, anchorDate) {
208
+ const target = dateFromTimestamp(staleAfter);
209
+ const anchor = normalizeIsoDate(anchorDate);
210
+ if (target === undefined || anchor === null)
211
+ return null;
212
+ const days = Math.round((Date.parse(`${target}T00:00:00Z`) - Date.parse(`${anchor}T00:00:00Z`)) / 86_400_000);
213
+ return Math.max(0, days);
214
+ }
215
+ // Flatten OKF provenance into Daftari's `sources: string[]`: the top-level
216
+ // `resource` URI first, then each v0.2 structured source (its `resource` URI
217
+ // when present, else its `id`). Per-source signals like author/usage_count
218
+ // don't fit a bare string — the raw entries are preserved under
219
+ // `okf_sources` by okfToDaftari so nothing is lost.
220
+ export function sourcesFromOkf(okfRaw) {
221
+ const out = [];
222
+ const push = (v) => {
223
+ if (typeof v === "string" && v.trim() !== "" && !out.includes(v))
224
+ out.push(v);
225
+ };
226
+ push(okfRaw.resource);
227
+ if (Array.isArray(okfRaw.sources)) {
228
+ for (const entry of okfRaw.sources) {
229
+ if (typeof entry === "string") {
230
+ push(entry);
231
+ continue;
232
+ }
233
+ const rec = asRecord(entry);
234
+ if (rec !== null)
235
+ push(typeof rec.resource === "string" ? rec.resource : rec.id);
236
+ }
237
+ }
238
+ return out;
239
+ }
240
+ // OKF fields the synthesis below consumes into a native Daftari slot (or, for
241
+ // description, re-derives from the body on a future export). Everything else —
242
+ // the lossy-mapped trust record (`generated`, `verified`, `sources`), the
243
+ // Attested Computation machinery (runtime/parameters/executor/receipt/attester),
244
+ // and any producer-defined field — is preserved under the `okf_` prefix so the
245
+ // import stays non-destructive.
246
+ const OKF_CONSUMED_FIELDS = new Set([
247
+ "type",
248
+ "title",
249
+ "description",
250
+ "resource",
251
+ "tags",
252
+ "timestamp",
253
+ "status",
254
+ "stale_after",
255
+ DAFTARI_SIDECAR_KEY,
256
+ ]);
106
257
  // OKF concept-doc frontmatter → Daftari frontmatter (as a raw record ready for
107
258
  // serializeDocument). When the doc carries a `daftari` sidecar (it came from
108
259
  // `daftari okf export`), that verbatim frontmatter is used directly for an exact
@@ -110,31 +261,49 @@ function asStringArray(value) {
110
261
  // fields, conservatively: imported knowledge lands as a `draft` in the
111
262
  // `accumulation` domain, and the original OKF `type` is preserved in an
112
263
  // `okf_type` field so nothing is silently lost.
264
+ //
265
+ // v0.2 trust signals feed the synthesis:
266
+ // - `generated.at` dates the doc (falling back to the v0.1 `timestamp`).
267
+ // - `verified` sets confidence by trust tier: human-reviewed lands `high`.
268
+ // Positive signals only ever raise confidence — absence keeps the default
269
+ // `medium`, because an unverified v0.2 doc is indistinguishable from a
270
+ // v0.1 doc that never had the chance to carry the field.
271
+ // - `status: deprecated` imports as `deprecated` (retired knowledge must not
272
+ // resurface as a fresh draft); `draft`/`stable`/absent stay `draft` — this
273
+ // vault has not canonized foreign content, however stable its producer
274
+ // considers it.
275
+ // - `stale_after` converts to `ttl_days` anchored at the doc date.
276
+ // - An `Attested Computation` is NOT auto-elevated to a write-protected
277
+ // tier: `tier: source` is an enforcement mechanism whose only sanctioned
278
+ // grant path is vault_set_tier (reason required, provenance-logged), and a
279
+ // foreign bundle's self-declared `type` must not buy enforcement without
280
+ // that gate. Import surfaces the doc in a warning instead so an operator
281
+ // can review and elevate deliberately; the attestation machinery survives
282
+ // under `okf_*` keys either way.
113
283
  export function okfToDaftari(okfRaw, ctx) {
114
- const sidecar = okfRaw[DAFTARI_SIDECAR_KEY];
115
- if (sidecar !== null && typeof sidecar === "object" && !Array.isArray(sidecar)) {
116
- return { ...sidecar };
284
+ if (hasDaftariSidecar(okfRaw)) {
285
+ return { ...okfRaw[DAFTARI_SIDECAR_KEY] };
117
286
  }
118
287
  const title = typeof okfRaw.title === "string" && okfRaw.title.trim() !== ""
119
288
  ? okfRaw.title
120
289
  : titleFromPath(ctx.relPath);
121
290
  const okfType = typeof okfRaw.type === "string" ? okfRaw.type : "";
122
291
  const collection = collectionFromPath(ctx.relPath) ?? slugify(okfType) ?? DEFAULT_IMPORT_COLLECTION;
123
- const date = dateFromTimestamp(okfRaw.timestamp) ?? ctx.today;
124
- const sources = typeof okfRaw.resource === "string" && okfRaw.resource.trim() !== "" ? [okfRaw.resource] : [];
292
+ const date = dateFromGenerated(okfRaw) ?? ctx.today;
293
+ const okfStatus = typeof okfRaw.status === "string" ? okfRaw.status.trim().toLowerCase() : "";
125
294
  const out = {
126
295
  title,
127
296
  domain: "accumulation",
128
297
  collection,
129
- status: "draft",
130
- confidence: "medium",
298
+ status: okfStatus === "deprecated" ? "deprecated" : "draft",
299
+ confidence: trustTier(okfRaw.verified) === "human-reviewed" ? "high" : "medium",
131
300
  created: date,
132
301
  updated: date,
133
302
  updated_by: ctx.updatedBy,
134
303
  provenance: "direct",
135
- sources,
304
+ sources: sourcesFromOkf(okfRaw),
136
305
  superseded_by: null,
137
- ttl_days: null,
306
+ ttl_days: ttlFromStaleAfter(okfRaw.stale_after, date),
138
307
  tags: asStringArray(okfRaw.tags),
139
308
  describes: [],
140
309
  questions_answered: [],
@@ -144,6 +313,15 @@ export function okfToDaftari(okfRaw, ctx) {
144
313
  // unknown fields through untouched.
145
314
  if (okfType.trim() !== "")
146
315
  out.okf_type = okfType;
316
+ // Preserve everything the synthesis did not consume losslessly, prefixed so
317
+ // it can never collide with a Daftari built-in.
318
+ for (const [key, value] of Object.entries(okfRaw)) {
319
+ if (OKF_CONSUMED_FIELDS.has(key))
320
+ continue;
321
+ if (value === null || value === undefined)
322
+ continue;
323
+ out[`${OKF_PRESERVED_PREFIX}${key}`] = value;
324
+ }
147
325
  return out;
148
326
  }
149
327
  //# sourceMappingURL=map.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/okf/map.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/okf/map.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,13 @@
1
- export declare const OKF_VERSION = "0.1";
1
+ export declare const OKF_VERSION = "0.2";
2
2
  export declare const OKF_INDEX_FILE = "index.md";
3
3
  export declare const OKF_LOG_FILE = "log.md";
4
4
  export declare const OKF_RESERVED_FILES: readonly ["index.md", "log.md"];
5
5
  export declare const DAFTARI_SIDECAR_KEY = "daftari";
6
6
  export declare const DEFAULT_OKF_TYPE = "note";
7
7
  export declare const DEFAULT_IMPORT_COLLECTION = "imported";
8
- export declare const OKF_CORE_FIELDS: readonly ["type", "title", "description", "resource", "tags", "timestamp"];
8
+ export declare const OKF_CORE_FIELDS: readonly ["type", "title", "description", "resource", "tags", "generated", "verified", "status", "stale_after", "sources"];
9
+ export declare const OKF_STATUSES: readonly ["draft", "stable", "deprecated"];
10
+ export type OkfStatus = (typeof OKF_STATUSES)[number];
11
+ export declare const OKF_ATTESTED_COMPUTATION_TYPE = "Attested Computation";
12
+ export declare const OKF_PRESERVED_PREFIX = "okf_";
9
13
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/okf/types.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,WAAW,QAAQ,CAAC;AAIjC,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,kBAAkB,iCAA0C,CAAC;AAO1E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAM7C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAIvC,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAIpD,eAAO,MAAM,eAAe,4EAOlB,CAAC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/okf/types.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,WAAW,QAAQ,CAAC;AAIjC,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,kBAAkB,iCAA0C,CAAC;AAO1E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAM7C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAIvC,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAMpD,eAAO,MAAM,eAAe,4HAWlB,CAAC;AAGX,eAAO,MAAM,YAAY,4CAA6C,CAAC;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAOtD,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AAMpE,eAAO,MAAM,oBAAoB,SAAS,CAAC"}
package/dist/okf/types.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Open Knowledge Format (OKF) — shared constants and types.
2
2
  //
3
- // OKF is Google Cloud's vendor-neutral specification (v0.1) for the LLM-wiki
3
+ // OKF is Google Cloud's vendor-neutral specification (v0.2) for the LLM-wiki
4
4
  // pattern: a directory of markdown files with YAML frontmatter that any
5
5
  // producer can emit and any consumer can read without translation. Daftari's
6
6
  // vault *is* this pattern, so `daftari okf export|import` bridges the two.
@@ -8,14 +8,29 @@
8
8
  // Spec essentials that this module implements:
9
9
  // - A concept doc is any non-reserved `.md` file with a frontmatter block.
10
10
  // - The single required frontmatter field is `type` (a free-form kind string).
11
- // - Recommended fields: title, description, resource, tags, timestamp.
11
+ // - Recommended fields: title, description, resource, tags.
12
12
  // - Reserved filenames: index.md (progressive-disclosure listing) and log.md
13
13
  // (chronological change history, newest first).
14
14
  // - Consumers must tolerate unknown fields and unknown `type` values.
15
+ //
16
+ // v0.2 adds opt-in trust signals — raw credibility indicators, never computed
17
+ // scores, all optional so v0.1 bundles stay valid:
18
+ // - `generated: {by, at}` — who produced the content and when it last
19
+ // meaningfully changed. Renames v0.1 `timestamp` (consumers fall back).
20
+ // - `verified: [{by, at}]` — independent confirmations. The trust tier is
21
+ // derived: no key = unverified, machine actors only = machine-confirmed,
22
+ // any `human:<id>` entry = human-reviewed.
23
+ // - `status: draft | stable | deprecated` — lifecycle; absent means stable.
24
+ // - `stale_after: YYYY-MM-DD` — absolute date (not a TTL) for deterministic
25
+ // staleness checks.
26
+ // - `sources: [{id, resource, title, author, usage_count, last_modified}]`
27
+ // — structured provenance. Renames the v0.1 body `# Citations` list.
28
+ // - A new concept type, `Attested Computation`: a sanctioned computation
29
+ // agents may parameterize but never edit.
15
30
  // The OKF spec version this producer targets and this consumer understands.
16
31
  // Written into the exported bundle's root index.md frontmatter (the spec's
17
32
  // place for a bundle to declare its target version).
18
- export const OKF_VERSION = "0.1";
33
+ export const OKF_VERSION = "0.2";
19
34
  // Reserved filenames with defined structural meaning. They are NOT concept
20
35
  // docs: export generates them, import skips them.
21
36
  export const OKF_INDEX_FILE = "index.md";
@@ -36,13 +51,32 @@ export const DEFAULT_OKF_TYPE = "note";
36
51
  // directory and no usable `type` to derive one from.
37
52
  export const DEFAULT_IMPORT_COLLECTION = "imported";
38
53
  // The canonical OKF frontmatter fields, in the order export writes them. `type`
39
- // is the only required one; the rest are recommended and omitted when empty.
54
+ // is the only required one; the rest are recommended/optional and omitted when
55
+ // empty. `timestamp` is the v0.1 name for `generated.at` — export writes the
56
+ // v0.2 form, import still accepts the old one.
40
57
  export const OKF_CORE_FIELDS = [
41
58
  "type",
42
59
  "title",
43
60
  "description",
44
61
  "resource",
45
62
  "tags",
46
- "timestamp",
63
+ "generated",
64
+ "verified",
65
+ "status",
66
+ "stale_after",
67
+ "sources",
47
68
  ];
69
+ // The v0.2 lifecycle states. Absence means "stable" per spec.
70
+ export const OKF_STATUSES = ["draft", "stable", "deprecated"];
71
+ // The v0.2 concept type for a sanctioned computation. Agents may fill declared
72
+ // parameters at call time but must never edit the computation itself. Import
73
+ // flags these docs in a warning so an operator can grant `tier: source` via
74
+ // vault_set_tier — it never auto-elevates, because a foreign bundle's
75
+ // self-declared type is not an authorization for write-protection enforcement.
76
+ export const OKF_ATTESTED_COMPUTATION_TYPE = "Attested Computation";
77
+ // Prefix under which import preserves foreign OKF fields that have no lossless
78
+ // Daftari mapping (the trust record, attestation machinery, and any unknown
79
+ // producer-defined fields). Keeps the import non-destructive, mirroring what
80
+ // the `daftari` sidecar does in the export direction.
81
+ export const OKF_PRESERVED_PREFIX = "okf_";
48
82
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/okf/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,+CAA+C;AAC/C,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,+EAA+E;AAC/E,oDAAoD;AACpD,wEAAwE;AAExE,4EAA4E;AAC5E,2EAA2E;AAC3E,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,2EAA2E;AAC3E,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,YAAY,CAAU,CAAC;AAE1E,0EAA0E;AAC1E,gFAAgF;AAChF,6EAA6E;AAC7E,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,+EAA+E;AAC/E,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAEpD,gFAAgF;AAChF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,OAAO;IACP,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;CACH,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/okf/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,+CAA+C;AAC/C,6EAA6E;AAC7E,iFAAiF;AACjF,8DAA8D;AAC9D,+EAA+E;AAC/E,oDAAoD;AACpD,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,mDAAmD;AACnD,wEAAwE;AACxE,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,+CAA+C;AAC/C,8EAA8E;AAC9E,8EAA8E;AAC9E,wBAAwB;AACxB,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,8CAA8C;AAE9C,4EAA4E;AAC5E,2EAA2E;AAC3E,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,2EAA2E;AAC3E,kDAAkD;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,YAAY,CAAU,CAAC;AAE1E,0EAA0E;AAC1E,gFAAgF;AAChF,6EAA6E;AAC7E,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,+EAA+E;AAC/E,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAEpD,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,OAAO;IACP,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,QAAQ;IACR,aAAa;IACb,SAAS;CACD,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAGvE,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,sEAAsE;AACtE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,6BAA6B,GAAG,sBAAsB,CAAC;AAEpE,+EAA+E;AAC/E,4EAA4E;AAC5E,6EAA6E;AAC7E,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { type AccessContext } from "./access/rbac.js";
2
+ import { type Result } from "./frontmatter/types.js";
3
+ export declare const DOC_URI_PREFIX = "daftari://doc/";
4
+ export declare const COLLECTION_URI_PREFIX = "daftari://collection/";
5
+ export interface ResourceDescriptor {
6
+ uri: string;
7
+ name: string;
8
+ mimeType: string;
9
+ description?: string;
10
+ }
11
+ export interface ResourceTemplateDescriptor {
12
+ uriTemplate: string;
13
+ name: string;
14
+ mimeType: string;
15
+ description?: string;
16
+ }
17
+ export interface ResourceContents {
18
+ uri: string;
19
+ mimeType: string;
20
+ text: string;
21
+ }
22
+ export declare function resourceTemplates(): ResourceTemplateDescriptor[];
23
+ export declare function docUri(relPath: string): string;
24
+ export declare function collectionUri(name: string): string;
25
+ export declare function listResources(vaultRoot: string, access?: AccessContext): Promise<Result<ResourceDescriptor[], Error>>;
26
+ export declare function readResource(vaultRoot: string, uri: string, access?: AccessContext): Promise<Result<ResourceContents, Error>>;
27
+ //# sourceMappingURL=resources.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAI9D,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAK7D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,wBAAgB,iBAAiB,IAAI,0BAA0B,EAAE,CAiBhE;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAaD,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,KAAK,CAAC,CAAC,CA0B9C;AAID,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAQ1C"}
@@ -0,0 +1,169 @@
1
+ // MCP resources — the protocol-level statement that markdown with YAML
2
+ // frontmatter is the source of truth (spec 2026-07-26, Decision 2).
3
+ //
4
+ // A client that speaks resources can pin and re-read a document as a thing
5
+ // with an identity, instead of re-running a search and hoping the same text
6
+ // comes back. `resources/read` returns the file verbatim, frontmatter
7
+ // included — the metadata layer IS part of the document.
8
+ //
9
+ // The invariant that gates all of it: a resource listing is a doc list, and
10
+ // doc lists never name docs in unreadable collections (2026-07-14 spec —
11
+ // omission over redaction, no existence leak). An unreadable doc is ABSENT
12
+ // from listings, and reading one returns the identical error a nonexistent
13
+ // path returns. A distinguishable "forbidden" IS the existence leak.
14
+ //
15
+ // Tension and edge data deliberately do NOT become resources: they are
16
+ // derived, disclosure-coarsened views, and stable URIs would invite clients
17
+ // to treat them as documents. They stay behind their tools, where the
18
+ // coarsening already lives.
19
+ import { canRead } from "./access/rbac.js";
20
+ import { parseDocument } from "./frontmatter/parser.js";
21
+ import { err, ok } from "./frontmatter/types.js";
22
+ import { readFile, resolveVaultPath } from "./storage/local.js";
23
+ import { collectionOf, vaultIndex } from "./tools/read.js";
24
+ export const DOC_URI_PREFIX = "daftari://doc/";
25
+ export const COLLECTION_URI_PREFIX = "daftari://collection/";
26
+ const MARKDOWN_MIME = "text/markdown";
27
+ const JSON_MIME = "application/json";
28
+ // Templates are advertised unconditionally: a URI *shape* names no document,
29
+ // so publishing it discloses nothing about what the vault holds or what this
30
+ // role may see.
31
+ export function resourceTemplates() {
32
+ return [
33
+ {
34
+ uriTemplate: `${DOC_URI_PREFIX}{+path}`,
35
+ name: "Vault document",
36
+ mimeType: MARKDOWN_MIME,
37
+ description: "A vault document, verbatim, YAML frontmatter included. " +
38
+ "The path is the vault-relative path, e.g. daftari://doc/notes/pricing.md",
39
+ },
40
+ {
41
+ uriTemplate: `${COLLECTION_URI_PREFIX}{name}`,
42
+ name: "Collection listing",
43
+ mimeType: JSON_MIME,
44
+ description: "The documents in one collection the caller may read.",
45
+ },
46
+ ];
47
+ }
48
+ export function docUri(relPath) {
49
+ // Encode per segment: the separators stay structural, everything else is
50
+ // escaped so a path with spaces or '#' round-trips.
51
+ return DOC_URI_PREFIX + relPath.split("/").map(encodeURIComponent).join("/");
52
+ }
53
+ export function collectionUri(name) {
54
+ return COLLECTION_URI_PREFIX + encodeURIComponent(name);
55
+ }
56
+ // The one error both "no such document" and "you may not read it" return.
57
+ // Keeping them byte-identical is what makes omission-over-redaction hold on
58
+ // the read path.
59
+ function notFound(uri) {
60
+ return new Error(`resource not found: ${uri}`);
61
+ }
62
+ // Lists every document the role may read, plus one entry per readable
63
+ // collection. `vaultIndex` already applies the read filter, so this function
64
+ // inherits the same visibility rule the vault_index tool enforces — one
65
+ // predicate, not two that can drift apart.
66
+ export async function listResources(vaultRoot, access) {
67
+ const index = await vaultIndex(vaultRoot, {}, access);
68
+ if (!index.ok)
69
+ return index;
70
+ const resources = [];
71
+ const collections = new Set();
72
+ for (const entry of index.value.entries) {
73
+ resources.push({
74
+ uri: docUri(entry.path),
75
+ name: entry.title || entry.path,
76
+ mimeType: MARKDOWN_MIME,
77
+ description: entry.collection ? `${entry.collection} · ${entry.status}` : entry.status,
78
+ });
79
+ if (entry.collection)
80
+ collections.add(entry.collection);
81
+ }
82
+ for (const name of [...collections].sort()) {
83
+ resources.push({
84
+ uri: collectionUri(name),
85
+ name: `Collection: ${name}`,
86
+ mimeType: JSON_MIME,
87
+ });
88
+ }
89
+ return ok(resources);
90
+ }
91
+ // Reads one resource. Dispatches on the URI prefix; anything else is a
92
+ // not-found, same as an unreadable or nonexistent document.
93
+ export async function readResource(vaultRoot, uri, access) {
94
+ if (uri.startsWith(DOC_URI_PREFIX)) {
95
+ return readDocResource(vaultRoot, uri, access);
96
+ }
97
+ if (uri.startsWith(COLLECTION_URI_PREFIX)) {
98
+ return readCollectionResource(vaultRoot, uri, access);
99
+ }
100
+ return err(notFound(uri));
101
+ }
102
+ async function readDocResource(vaultRoot, uri, access) {
103
+ const raw = uri.slice(DOC_URI_PREFIX.length);
104
+ if (raw.length === 0)
105
+ return err(notFound(uri));
106
+ let relPath;
107
+ try {
108
+ relPath = raw.split("/").map(decodeURIComponent).join("/");
109
+ }
110
+ catch {
111
+ // Malformed percent-encoding — indistinguishable from a path that isn't
112
+ // there, and reported as such.
113
+ return err(notFound(uri));
114
+ }
115
+ // Path confinement first: every vault path resolves through the realpath'd
116
+ // canonicalization, and a resolved path that escapes the vault root is
117
+ // rejected. A symlinked file cannot read outside the vault, even when the
118
+ // vault itself sits under a symlinked parent.
119
+ const resolved = resolveVaultPath(vaultRoot, relPath);
120
+ if (!resolved.ok)
121
+ return err(notFound(uri));
122
+ const file = await readFile(resolved.value.absPath);
123
+ if (!file.ok)
124
+ return err(notFound(uri));
125
+ const parsed = parseDocument(file.value);
126
+ if (!parsed.ok)
127
+ return err(notFound(uri));
128
+ if (access) {
129
+ const collection = collectionOf(relPath, parsed.value.frontmatter);
130
+ if (!canRead(access.role, collection))
131
+ return err(notFound(uri));
132
+ }
133
+ // Verbatim: frontmatter included, bytes as they sit on disk. The file is
134
+ // the source of truth, so the resource is the file — not a re-serialization
135
+ // of what the parser understood.
136
+ return ok({ uri, mimeType: MARKDOWN_MIME, text: file.value });
137
+ }
138
+ async function readCollectionResource(vaultRoot, uri, access) {
139
+ const raw = uri.slice(COLLECTION_URI_PREFIX.length);
140
+ if (raw.length === 0)
141
+ return err(notFound(uri));
142
+ let name;
143
+ try {
144
+ name = decodeURIComponent(raw);
145
+ }
146
+ catch {
147
+ return err(notFound(uri));
148
+ }
149
+ if (access && !canRead(access.role, name))
150
+ return err(notFound(uri));
151
+ const index = await vaultIndex(vaultRoot, { collection: name }, access);
152
+ if (!index.ok)
153
+ return index;
154
+ // An empty readable collection and a collection that does not exist are the
155
+ // same answer on purpose — neither confirms nor denies anything the
156
+ // listing would not already have shown.
157
+ const docs = index.value.entries.map((e) => ({
158
+ uri: docUri(e.path),
159
+ path: e.path,
160
+ title: e.title,
161
+ status: e.status,
162
+ }));
163
+ return ok({
164
+ uri,
165
+ mimeType: JSON_MIME,
166
+ text: JSON.stringify({ collection: name, count: docs.length, documents: docs }, null, 2),
167
+ });
168
+ }
169
+ //# sourceMappingURL=resources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { type AccessContext } from "../access/rbac.js";
2
2
  import { type IndexDb } from "../storage/index-db.js";
3
+ export declare function previewSnippet(content: string): string;
3
4
  export type CurrentSource = {
4
5
  kind: "resolved";
5
6
  path: string;
@@ -1 +1 @@
1
- {"version":3,"file":"current-source.d.ts","sourceRoot":"","sources":["../../src/search/current-source.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAWnE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,aAAa,GAAG,IAAI,CA8BtB"}
1
+ {"version":3,"file":"current-source.d.ts","sourceRoot":"","sources":["../../src/search/current-source.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAQnE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,aAAa,GAAG,IAAI,CA8BtB"}