daftari 3.7.0 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +4 -0
  3. package/dist/access/rbac.d.ts +1 -0
  4. package/dist/access/rbac.d.ts.map +1 -1
  5. package/dist/access/rbac.js +8 -0
  6. package/dist/access/rbac.js.map +1 -1
  7. package/dist/board/board.d.ts +37 -0
  8. package/dist/board/board.d.ts.map +1 -0
  9. package/dist/board/board.js +233 -0
  10. package/dist/board/board.js.map +1 -0
  11. package/dist/board/board.test.d.ts +2 -0
  12. package/dist/board/board.test.d.ts.map +1 -0
  13. package/dist/board/board.test.js +753 -0
  14. package/dist/board/board.test.js.map +1 -0
  15. package/dist/board/dormancy.test.d.ts +2 -0
  16. package/dist/board/dormancy.test.d.ts.map +1 -0
  17. package/dist/board/dormancy.test.js +79 -0
  18. package/dist/board/dormancy.test.js.map +1 -0
  19. package/dist/board/identity.d.ts +5 -0
  20. package/dist/board/identity.d.ts.map +1 -0
  21. package/dist/board/identity.js +146 -0
  22. package/dist/board/identity.js.map +1 -0
  23. package/dist/board/identity.test.d.ts +2 -0
  24. package/dist/board/identity.test.d.ts.map +1 -0
  25. package/dist/board/identity.test.js +291 -0
  26. package/dist/board/identity.test.js.map +1 -0
  27. package/dist/board/ledger.d.ts +41 -0
  28. package/dist/board/ledger.d.ts.map +1 -0
  29. package/dist/board/ledger.js +197 -0
  30. package/dist/board/ledger.js.map +1 -0
  31. package/dist/board/ledger.test.d.ts +2 -0
  32. package/dist/board/ledger.test.d.ts.map +1 -0
  33. package/dist/board/ledger.test.js +873 -0
  34. package/dist/board/ledger.test.js.map +1 -0
  35. package/dist/board/principals.d.ts +4 -0
  36. package/dist/board/principals.d.ts.map +1 -0
  37. package/dist/board/principals.js +37 -0
  38. package/dist/board/principals.js.map +1 -0
  39. package/dist/board/principals.test.d.ts +2 -0
  40. package/dist/board/principals.test.d.ts.map +1 -0
  41. package/dist/board/principals.test.js +296 -0
  42. package/dist/board/principals.test.js.map +1 -0
  43. package/dist/board/reconcile.d.ts +12 -0
  44. package/dist/board/reconcile.d.ts.map +1 -0
  45. package/dist/board/reconcile.js +293 -0
  46. package/dist/board/reconcile.js.map +1 -0
  47. package/dist/board/reconcile.test.d.ts +2 -0
  48. package/dist/board/reconcile.test.d.ts.map +1 -0
  49. package/dist/board/reconcile.test.js +788 -0
  50. package/dist/board/reconcile.test.js.map +1 -0
  51. package/dist/board/sources/index.d.ts +24 -0
  52. package/dist/board/sources/index.d.ts.map +1 -0
  53. package/dist/board/sources/index.js +64 -0
  54. package/dist/board/sources/index.js.map +1 -0
  55. package/dist/board/sources/lint.d.ts +3 -0
  56. package/dist/board/sources/lint.d.ts.map +1 -0
  57. package/dist/board/sources/lint.js +218 -0
  58. package/dist/board/sources/lint.js.map +1 -0
  59. package/dist/board/sources/lint.test.d.ts +2 -0
  60. package/dist/board/sources/lint.test.d.ts.map +1 -0
  61. package/dist/board/sources/lint.test.js +616 -0
  62. package/dist/board/sources/lint.test.js.map +1 -0
  63. package/dist/board/sources/staged.d.ts +3 -0
  64. package/dist/board/sources/staged.d.ts.map +1 -0
  65. package/dist/board/sources/staged.js +116 -0
  66. package/dist/board/sources/staged.js.map +1 -0
  67. package/dist/board/sources/staged.test.d.ts +2 -0
  68. package/dist/board/sources/staged.test.d.ts.map +1 -0
  69. package/dist/board/sources/staged.test.js +418 -0
  70. package/dist/board/sources/staged.test.js.map +1 -0
  71. package/dist/board/sources/staleness.d.ts +43 -0
  72. package/dist/board/sources/staleness.d.ts.map +1 -0
  73. package/dist/board/sources/staleness.js +346 -0
  74. package/dist/board/sources/staleness.js.map +1 -0
  75. package/dist/board/sources/staleness.test.d.ts +2 -0
  76. package/dist/board/sources/staleness.test.d.ts.map +1 -0
  77. package/dist/board/sources/staleness.test.js +923 -0
  78. package/dist/board/sources/staleness.test.js.map +1 -0
  79. package/dist/board/sources/tension.d.ts +3 -0
  80. package/dist/board/sources/tension.d.ts.map +1 -0
  81. package/dist/board/sources/tension.js +152 -0
  82. package/dist/board/sources/tension.js.map +1 -0
  83. package/dist/board/sources/tension.test.d.ts +2 -0
  84. package/dist/board/sources/tension.test.d.ts.map +1 -0
  85. package/dist/board/sources/tension.test.js +440 -0
  86. package/dist/board/sources/tension.test.js.map +1 -0
  87. package/dist/board/sources/tier2.d.ts +17 -0
  88. package/dist/board/sources/tier2.d.ts.map +1 -0
  89. package/dist/board/sources/tier2.js +233 -0
  90. package/dist/board/sources/tier2.js.map +1 -0
  91. package/dist/board/sources/tier2.test.d.ts +2 -0
  92. package/dist/board/sources/tier2.test.d.ts.map +1 -0
  93. package/dist/board/sources/tier2.test.js +480 -0
  94. package/dist/board/sources/tier2.test.js.map +1 -0
  95. package/dist/board/types.d.ts +161 -0
  96. package/dist/board/types.d.ts.map +1 -0
  97. package/dist/board/types.js +37 -0
  98. package/dist/board/types.js.map +1 -0
  99. package/dist/canon/index.d.ts +3 -1
  100. package/dist/canon/index.d.ts.map +1 -1
  101. package/dist/canon/index.js +35 -8
  102. package/dist/canon/index.js.map +1 -1
  103. package/dist/canon/types.d.ts +3 -0
  104. package/dist/canon/types.d.ts.map +1 -1
  105. package/dist/cli.d.ts.map +1 -1
  106. package/dist/cli.js +9 -0
  107. package/dist/cli.js.map +1 -1
  108. package/dist/consolidate/birth.d.ts +1 -1
  109. package/dist/consolidate/birth.d.ts.map +1 -1
  110. package/dist/consolidate/birth.js +22 -0
  111. package/dist/consolidate/birth.js.map +1 -1
  112. package/dist/consolidate/edge-write.d.ts +11 -0
  113. package/dist/consolidate/edge-write.d.ts.map +1 -1
  114. package/dist/consolidate/edge-write.js +41 -0
  115. package/dist/consolidate/edge-write.js.map +1 -1
  116. package/dist/consolidate/index.js +5 -2
  117. package/dist/consolidate/index.js.map +1 -1
  118. package/dist/consolidate/revision.d.ts +4 -2
  119. package/dist/consolidate/revision.d.ts.map +1 -1
  120. package/dist/consolidate/revision.js +23 -0
  121. package/dist/consolidate/revision.js.map +1 -1
  122. package/dist/curation/edge-staleness.d.ts +4 -2
  123. package/dist/curation/edge-staleness.d.ts.map +1 -1
  124. package/dist/curation/edge-staleness.js +36 -3
  125. package/dist/curation/edge-staleness.js.map +1 -1
  126. package/dist/curation/edges.d.ts +7 -0
  127. package/dist/curation/edges.d.ts.map +1 -1
  128. package/dist/curation/edges.js +13 -7
  129. package/dist/curation/edges.js.map +1 -1
  130. package/dist/curation/tension-access.d.ts +1 -0
  131. package/dist/curation/tension-access.d.ts.map +1 -1
  132. package/dist/curation/tension-access.js +18 -1
  133. package/dist/curation/tension-access.js.map +1 -1
  134. package/dist/curation/tension.d.ts +3 -0
  135. package/dist/curation/tension.d.ts.map +1 -1
  136. package/dist/curation/tension.js +36 -0
  137. package/dist/curation/tension.js.map +1 -1
  138. package/dist/curation/vault-docs.d.ts +1 -0
  139. package/dist/curation/vault-docs.d.ts.map +1 -1
  140. package/dist/curation/vault-docs.js +1 -0
  141. package/dist/curation/vault-docs.js.map +1 -1
  142. package/dist/distill/cli.d.ts.map +1 -1
  143. package/dist/distill/cli.js +6 -0
  144. package/dist/distill/cli.js.map +1 -1
  145. package/dist/distill/cost.d.ts +6 -0
  146. package/dist/distill/cost.d.ts.map +1 -1
  147. package/dist/distill/cost.js +2 -3
  148. package/dist/distill/cost.js.map +1 -1
  149. package/dist/distill/extract.d.ts +52 -0
  150. package/dist/distill/extract.d.ts.map +1 -1
  151. package/dist/distill/extract.js +24 -2
  152. package/dist/distill/extract.js.map +1 -1
  153. package/dist/distill/propose.d.ts +44 -1
  154. package/dist/distill/propose.d.ts.map +1 -1
  155. package/dist/distill/propose.js +84 -2
  156. package/dist/distill/propose.js.map +1 -1
  157. package/dist/distill/reader-fingerprint.d.ts +69 -0
  158. package/dist/distill/reader-fingerprint.d.ts.map +1 -0
  159. package/dist/distill/reader-fingerprint.js +145 -0
  160. package/dist/distill/reader-fingerprint.js.map +1 -0
  161. package/dist/distill/receipt-store.d.ts +5 -0
  162. package/dist/distill/receipt-store.d.ts.map +1 -0
  163. package/dist/distill/receipt-store.js +24 -0
  164. package/dist/distill/receipt-store.js.map +1 -0
  165. package/dist/eval/llm-openrouter.d.ts.map +1 -1
  166. package/dist/eval/llm-openrouter.js +4 -0
  167. package/dist/eval/llm-openrouter.js.map +1 -1
  168. package/dist/eval/llm.d.ts +22 -0
  169. package/dist/eval/llm.d.ts.map +1 -1
  170. package/dist/eval/llm.js +94 -24
  171. package/dist/eval/llm.js.map +1 -1
  172. package/dist/federation/classification.d.ts.map +1 -1
  173. package/dist/federation/classification.js +3 -0
  174. package/dist/federation/classification.js.map +1 -1
  175. package/dist/index.d.ts.map +1 -1
  176. package/dist/index.js +31 -0
  177. package/dist/index.js.map +1 -1
  178. package/dist/search/coverage.d.ts +5 -1
  179. package/dist/search/coverage.d.ts.map +1 -1
  180. package/dist/search/coverage.js +47 -15
  181. package/dist/search/coverage.js.map +1 -1
  182. package/dist/search/hybrid.d.ts +7 -1
  183. package/dist/search/hybrid.d.ts.map +1 -1
  184. package/dist/search/hybrid.js +31 -8
  185. package/dist/search/hybrid.js.map +1 -1
  186. package/dist/search/retrieval-metrics.d.ts +5 -0
  187. package/dist/search/retrieval-metrics.d.ts.map +1 -0
  188. package/dist/search/retrieval-metrics.js +60 -0
  189. package/dist/search/retrieval-metrics.js.map +1 -0
  190. package/dist/search/suppression.d.ts +9 -0
  191. package/dist/search/suppression.d.ts.map +1 -0
  192. package/dist/search/suppression.js +107 -0
  193. package/dist/search/suppression.js.map +1 -0
  194. package/dist/serve/index.d.ts +11 -0
  195. package/dist/serve/index.d.ts.map +1 -1
  196. package/dist/serve/index.js +547 -8
  197. package/dist/serve/index.js.map +1 -1
  198. package/dist/serve/session.d.ts +9 -0
  199. package/dist/serve/session.d.ts.map +1 -0
  200. package/dist/serve/session.js +65 -0
  201. package/dist/serve/session.js.map +1 -0
  202. package/dist/server.d.ts.map +1 -1
  203. package/dist/server.js +4 -6
  204. package/dist/server.js.map +1 -1
  205. package/dist/tools/board.d.ts +32 -0
  206. package/dist/tools/board.d.ts.map +1 -0
  207. package/dist/tools/board.js +615 -0
  208. package/dist/tools/board.js.map +1 -0
  209. package/dist/tools/board.test.d.ts +2 -0
  210. package/dist/tools/board.test.d.ts.map +1 -0
  211. package/dist/tools/board.test.js +964 -0
  212. package/dist/tools/board.test.js.map +1 -0
  213. package/dist/tools/edge-staleness.d.ts.map +1 -1
  214. package/dist/tools/edge-staleness.js +18 -4
  215. package/dist/tools/edge-staleness.js.map +1 -1
  216. package/dist/tools/read.d.ts +2 -0
  217. package/dist/tools/read.d.ts.map +1 -1
  218. package/dist/tools/read.js +43 -13
  219. package/dist/tools/read.js.map +1 -1
  220. package/dist/tools/search.d.ts.map +1 -1
  221. package/dist/tools/search.js +79 -17
  222. package/dist/tools/search.js.map +1 -1
  223. package/dist/tools/write.d.ts.map +1 -1
  224. package/dist/tools/write.js +172 -2
  225. package/dist/tools/write.js.map +1 -1
  226. package/dist/utils/config.d.ts +24 -0
  227. package/dist/utils/config.d.ts.map +1 -1
  228. package/dist/utils/config.js +151 -1
  229. package/dist/utils/config.js.map +1 -1
  230. package/dist/version.d.ts +2 -0
  231. package/dist/version.d.ts.map +1 -0
  232. package/dist/version.js +8 -0
  233. package/dist/version.js.map +1 -0
  234. package/dist/view/board-page.d.ts +4 -0
  235. package/dist/view/board-page.d.ts.map +1 -0
  236. package/dist/view/board-page.js +339 -0
  237. package/dist/view/board-page.js.map +1 -0
  238. package/dist/view/board-page.test.d.ts +2 -0
  239. package/dist/view/board-page.test.d.ts.map +1 -0
  240. package/dist/view/board-page.test.js +548 -0
  241. package/dist/view/board-page.test.js.map +1 -0
  242. package/dist/view/pages.d.ts.map +1 -1
  243. package/dist/view/pages.js +13 -2
  244. package/dist/view/pages.js.map +1 -1
  245. package/dist/view/render.d.ts.map +1 -1
  246. package/dist/view/render.js +2 -1
  247. package/dist/view/render.js.map +1 -1
  248. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -5,6 +5,46 @@ 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]
9
+
10
+ ## [3.9.0] - 2026-08-19
11
+
12
+ ### Added
13
+
14
+ - **Board browser-login shim** (#458) — a signed, HttpOnly session cookie so an operator can reach the `/board` surface from a browser, which cannot send `Authorization: Bearer` on navigation. A new `server.auth.session` block names the env vars carrying the HMAC signing key and the login password, plus the identity a successful login receives (`maps_to`) and a configurable lifetime; the login form (`GET/POST /board/login`) mints the cookie (`HttpOnly; SameSite=Strict`, `Secure` when `transport_security: external`) and `/board/logout` clears it. The cookie is a third credential type composable with — and consulted only after — the existing bearer/OAuth paths: an invalid cookie is never a guest downgrade, a browser hitting `GET /board` unauthenticated is redirected to the login page while API clients still receive a `401`, and the signing key must be at least 32 bytes or the server refuses to start. State-changing board requests authenticated by cookie require a double-submit CSRF token (bearer-authenticated callers are exempt), and the board page now renders working accept/defer/dismiss/resolve controls plus a sign-out action.
15
+
16
+ ## [3.8.0] - 2026-08-19
17
+
18
+ ### Added
19
+
20
+ - **Vault Board** (#455) — a finding-centric curation surface that turns the detection surfaces (lint, staleness, edge-staleness, staged actions, tier-2 queue, tensions) into durable, dispositionable cards with stable identity across runs and an append-only disposition ledger (`.daftari/board-dispositions.jsonl`, operator-local, gitignored). Bounded agent authority is enforced by construction: a new `dispose` role capability gates human disposition (`vault_board_dispose` — accept/defer/dismiss/reassign), `vault_board_resolve` records a **system-authored** resolution only when the originating deterministic check no longer reproduces, and reopen-on-reappearance is emitted solely by reconciliation — no autonomous dismissal or prioritization. Findings and dispositions carry the vault's RBAC and no-existence-disclosure guarantees (both endpoints of an upstream edge must be readable; byte-identical errors for hidden vs absent, at both the tool and HTTP layers). Ships three MCP tools (`vault_board_list` / `vault_board_dispose` / `vault_board_resolve`) plus a `/board` + `/api/board` surface mounted in the `serve` path behind the existing bearer/JWT `authenticate()` and ops floor; the board page is server-rendered and XSS-escaped, with New / Accepted / Waiting / Resolved / Dismissed columns and per-collection/check/certainty/owner/age/document filters. Reconciliation is read-time — the board writes nothing when unused.
21
+ - **Version discovery** — `daftari --version` (and `-v`) prints the running version and exits. The version is also surfaced in-band: `vault_status` now returns a `serverVersion` field, so an agent already connected over MCP — which never sees the `initialize`-handshake `serverInfo` — can read the running version through a callable tool.
22
+ - **Distill receipts** (#423) — `buildReceipt` now carries the run's staging `runId` (the id stamped into artifact bodies) instead of a throwaway UUID, and each receipt is persisted to `.daftari/distill-receipts.jsonl` (operator-local, gitignored, never MCP-exposed) — so a run's provider/ZDR/cost facts join to the claims it produced.
23
+
24
+ ### Fixed
25
+
26
+ - **Consolidate voting dedup** (#423) — the edge replay-guard dedup key now includes the observing model, so two different models re-deriving the same edge in one sitting count as independent votes instead of colliding as a replay.
27
+
28
+ ## [3.7.0] - 2026-08-16
29
+
30
+ The multi-user hardening release (#399, #402–#411): single-user correctness is table stakes — this release is about what breaks when there are many users, and stopping it.
31
+
32
+ ### Added
33
+
34
+ - **`daftari attest`** (#409; closes #298) — signed vault attestation bundles: an operator-only CLI producing an Ed25519-signed manifest (per-doc content hashes, contested/ratified status, open-tension counts, per-path git history, anchored to the full HEAD sha) derived entirely from markdown + git, verifiable offline with `daftari attest verify` — whose exit codes distinguish *forged* (1) from *stale* (4) — plus `daftari attest keygen`. The key rides `DAFTARI_ATTEST_KEY`, never config. When the key is configured, `vault_receipt` results carry an operator signature over the exact payload bytes `receiptHash` already covers. Threat model stated in the module headers: the signer is the operator; per-principal commit signing is deferred with recorded kill conditions.
35
+ - **The witness prices positions** (#402) — each principal's track record gains a position wager book in the doc book's currency, settled by the current ratification: live positions stake by confidence, dissent burns (resolved through the self-supersession chain, so re-minting the same stance never launders a burn while a genuine flip stays free), `accepted` standing dissent is priced 0 absolutely, alignment at ratify time earns flat credit with no bandwagoning, and pos-000 prices nothing. Positional tensions leave the doc book, and the flat-curve warning becomes composite over live positions.
36
+ - **Positional-tension lifecycle at N principals** (#402) — `vault_consolidate` accepts `resolve_tensions: "dissent"`: one ratification batch-resolves every open positional tension it adjudicated (chain-following superseded dissent; moot pairs stay open), recorded with the new **system-only resolution kind `consolidated`** — callers and the court stay fenced to the original four kinds. Plus a bounded jittered retry on `__tensions__` lease contention for system-generated mints, and `positionIntegrity` reconciliation lint for silently-failed mints and moot open tensions.
37
+ - **Serve multi-tenant ops floor** (#402) — a pre-auth per-IP penalty box charged only by auth failures, per-principal token buckets on the verified identity (429 + Retry-After), a global in-flight ceiling that rejects rather than queues (503), and an operator-only auth audit log (`.daftari/auth-log.jsonl`) with per-process-salted token hints. Config under `server.limits` / `server.audit`; defaults always apply in serve mode; stdio unaffected.
38
+
39
+ ### Fixed
40
+
41
+ - **The assert/consolidate lost-update window** (#399, #402) — `vault_assert` and `vault_consolidate` wrote with no optimistic-concurrency token, so a writer whose lease window did not overlap the winner's silently erased another principal's position. `TargetDocument` now carries its load-time content hash, the position tools declare it, and a stale rejection reloads and recomputes once. Extended to `vault_promote`/`vault_deprecate`/`vault_set_confidence`/`vault_set_tier`/`vault_append` (#407), with a deterministic race-injection test seam and a mutation-verified end-to-end pin (#410).
42
+ - **Unserialized auto-commit** (#399, #405) — concurrent serve requests writing different files interleaved their `git add`/`git commit` sequences: one commit swallowed the other's staged file under the wrong author while the loser failed "nothing to commit". Commits are now serialized in-process, pathspec-scoped with literal pathspecs, bounded by a timeout (`GIT_TERMINAL_PROMPT=0` — a headless server never prompts), and a commit failure records provenance and reports accurately. Git author is the **authenticated principal** when an access context exists, with the claimed agent kept as a `Daftari-Agent` trailer (#399).
43
+ - **Stale ratify replays** (#406) — staged write proposals are anchored to the doc version they were computed from; ratifying after the doc moved fails loudly naming the proposal instead of clobbering interim positions.
44
+ - **Shadow mode leaked real tension mutations** (#404) — with `shadow_mode: true`, `vault_assert`/`vault_consolidate` no longer really mint or resolve tensions for doc writes that were shadowed no-ops.
45
+ - Federation mount-index test realpath flake on macOS (#403); suite-wide self-diagnosing vault teardown (retry loop + survivor listing) retiring a class of CI teardown races.
46
+ - **Edge staleness: new `unverifiable` class** (#416) — a dependent whose `compiled`/`declared`/`earned` upstream the caller can no longer verify (deleted, or evicted from a readable collection) previously reported a false `current`; it now reports `unverifiable` on `vault_read`, `vault_search`, and `vault_staleness`. RBAC-hidden upstreams are indistinguishable from deleted ones (no existence oracle); the reason string is always "source not in your readable vault". No persisted state — deletion is computed, never remembered.
47
+
8
48
  ## [3.6.0] - 2026-08-15
9
49
 
10
50
  ### Added
package/README.md CHANGED
@@ -921,6 +921,10 @@ npm test
921
921
  Design tenets: functions and types, no classes; tool handlers return
922
922
  `Result<T, Error>` rather than throwing; tests mirror the `src/` structure.
923
923
 
924
+ The build board: the chain currently under construction — the derived-content
925
+ critical path — is tracked with live progress in
926
+ [#428](https://github.com/mavaali/daftari/issues/428).
927
+
924
928
  ## Documentation
925
929
 
926
930
  - <docs/getting-started.md> — scaffold, write, search, lint, promote, deprecate
@@ -13,6 +13,7 @@ export declare function canWrite(role: RoleConfig | null, collection: string): b
13
13
  export declare function canPromote(role: RoleConfig | null): boolean;
14
14
  export declare function canRatify(role: RoleConfig | null): boolean;
15
15
  export declare function canErase(role: RoleConfig | null): boolean;
16
+ export declare function canDispose(role: RoleConfig | null): boolean;
16
17
  export declare function isProposeOnly(role: RoleConfig | null): boolean;
17
18
  export declare function hasAnyRead(role: RoleConfig | null): boolean;
18
19
  export declare function readableCollections(role: RoleConfig | null): string[] | undefined;
@@ -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;AAOD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAEzD;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"}
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;AAOD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAEzD;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAE3D;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"}
@@ -50,6 +50,14 @@ export function canRatify(role) {
50
50
  export function canErase(role) {
51
51
  return role?.erase ?? false;
52
52
  }
53
+ // True if the role may perform human disposition actions on board items (owner
54
+ // assignment, reassign). Provisioned true on human operator roles; omitted on
55
+ // agent roles. This is the config-declared signal that distinguishes a human
56
+ // operator from an agent — AccessContext carries no principal_type.
57
+ // (U10/R13/R16 capability gate; used by U11 reassign path.)
58
+ export function canDispose(role) {
59
+ return role !== null && role.dispose === true;
60
+ }
53
61
  // True if the role is propose-only (#235): its writes must land as staged
54
62
  // `write` proposals, never as direct mutations. vault_write and vault_assert
55
63
  // coerce into staged proposals; every other write tool denies. The write
@@ -1 +1 @@
1
- {"version":3,"file":"rbac.js","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"rbac.js","sourceRoot":"","sources":["../../src/access/rbac.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { AccessContext, BoardColumn, Confidence, Finding } from "./types.js";
2
+ export interface BoardFilters {
3
+ /** Keep findings whose collection (see module comment) equals this value. */
4
+ collection?: string;
5
+ /** Keep findings whose check equals this value. */
6
+ check?: string;
7
+ /** Keep findings whose certainty equals this value. */
8
+ certainty?: Confidence;
9
+ /** Keep findings whose owner equals this value. */
10
+ owner?: string;
11
+ /**
12
+ * Keep findings whose first_seen is at least this many days before `now`.
13
+ * age = Math.floor((now - first_seen) / 86_400_000) >= minAgeDays.
14
+ * 0 keeps everything.
15
+ */
16
+ minAgeDays?: number;
17
+ /**
18
+ * Keep findings that reference this vault-relative document path.
19
+ * See module comment for per-target-kind semantics.
20
+ */
21
+ document?: string;
22
+ }
23
+ export interface BoardResult {
24
+ /**
25
+ * Findings grouped by disposition column. Every Finding appears in exactly
26
+ * one column. The five columns are always present (possibly empty arrays).
27
+ */
28
+ columns: Record<BoardColumn, Finding[]>;
29
+ /**
30
+ * Flat list of all reconciled (and post-filter) findings. Equivalent to
31
+ * Object.values(columns).flat() — provided for programmatic access so
32
+ * callers need not re-aggregate from columns.
33
+ */
34
+ all: Finding[];
35
+ }
36
+ export declare function listBoard(vaultRoot: string, access: AccessContext, filters?: BoardFilters, now?: Date): Promise<BoardResult>;
37
+ //# sourceMappingURL=board.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/board/board.ts"],"names":[],"mappings":"AAkFA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAOjG,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC;;;;OAIG;IACH,GAAG,EAAE,OAAO,EAAE,CAAC;CAChB;AAgID,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,YAAY,EACtB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,CAwCtB"}
@@ -0,0 +1,233 @@
1
+ // board.ts — U9: Board engine.
2
+ //
3
+ // Assembles registry → RBAC → reconcile → columns behind one call.
4
+ //
5
+ // Public API
6
+ // ----------
7
+ //
8
+ // listBoard(vaultRoot, access, filters?, now?)
9
+ // → Promise<BoardResult>
10
+ //
11
+ // Return shape
12
+ // ------------
13
+ //
14
+ // { columns: Record<BoardColumn, Finding[]>, all: Finding[] }
15
+ //
16
+ // Rationale: `columns` is what the board UI (U13) renders directly; `all`
17
+ // is what the REST API (U12) exposes for programmatic consumers that want a
18
+ // flat list without re-aggregating. Both carry Finding[], so the caller
19
+ // always has the full typed shape — no conversion required on either path.
20
+ //
21
+ // Filter semantics (R26)
22
+ // ----------------------
23
+ //
24
+ // Filters are applied AFTER reconcile, to the reconciled findings.
25
+ // Emit is persisted BEFORE filter application — filters are a VIEW concern
26
+ // and do NOT affect what gets written to the ledger.
27
+ //
28
+ // collection
29
+ // - lint/staleness target: first path segment of target.path
30
+ // (e.g. "notes/foo.md" → "notes")
31
+ // - tension target: first path segment of sourceA (evidence.sourceA)
32
+ // Rationale: sourceA is the "primary" side of a tension; it is the
33
+ // document the triage owner is most likely curating. Documented here
34
+ // so U12/U13 can surface this choice.
35
+ // - staged target: first path segment of the finding's evidence.targetPath
36
+ // (the path the staged action targets)
37
+ // - tier2 target: first path segment of artifact
38
+ // Rationale: artifact is the dependent document, which is the entity
39
+ // that needs attention from the collection's curator.
40
+ //
41
+ // check
42
+ // - Equality match on finding.check.
43
+ //
44
+ // certainty
45
+ // - Equality match on finding.certainty (Confidence: "low"|"medium"|"high").
46
+ //
47
+ // owner
48
+ // - Equality match on finding.owner.
49
+ //
50
+ // minAgeDays
51
+ // - Keep findings whose first_seen is >= minAgeDays ago relative to `now`.
52
+ // age = Math.floor((now - first_seen) / 86_400_000) >= minAgeDays.
53
+ // A minAgeDays of 0 keeps everything (all findings are at least 0 days old).
54
+ //
55
+ // document
56
+ // - lint/staleness: target.path === document.
57
+ // - staged: evidence.targetPath === document.
58
+ // - tension: evidence.sourceA === document || evidence.sourceB === document.
59
+ // - tier2: target.artifact === document || target.unit === document.
60
+ //
61
+ // RBAC
62
+ // ----
63
+ // Each source adapter's list() applies RBAC internally. The engine does NOT
64
+ // re-filter; it simply concats all adapter results (R22). The adapters are
65
+ // the RBAC enforcement point (R17/R18).
66
+ //
67
+ // Zero-writes guarantee (R7)
68
+ // --------------------------
69
+ // If reconcile's emit is empty, appendEvent is never called. The ledger file
70
+ // is untouched. An unused board (no prior dispositions, no resolvable
71
+ // transitions) makes exactly zero filesystem writes.
72
+ //
73
+ // Reopen idempotency (R6)
74
+ // -----------------------
75
+ // Emit events are persisted ONCE, here. On the next listBoard call,
76
+ // loadLedger re-reads the persisted "reopened" event; reconcile sees
77
+ // latest="reopened" and does NOT re-emit. The test in board.test.ts
78
+ // verifies this end-to-end.
79
+ import { appendEvent, loadLedger } from "./ledger.js";
80
+ import { reconcile } from "./reconcile.js";
81
+ import { SOURCE_ADAPTERS } from "./sources/index.js";
82
+ // ---------------------------------------------------------------------------
83
+ // collectionOf — derive the "collection" for filter matching.
84
+ // ---------------------------------------------------------------------------
85
+ function collectionOf(finding) {
86
+ const t = finding.target;
87
+ switch (t.kind) {
88
+ case "lint":
89
+ case "staleness":
90
+ // First path segment of the vault-relative path.
91
+ return t.path.split("/")[0];
92
+ case "staged": {
93
+ // Staged actions carry the targetPath in evidence.
94
+ const tp = finding.evidence.targetPath;
95
+ if (typeof tp === "string")
96
+ return tp.split("/")[0];
97
+ return undefined;
98
+ }
99
+ case "tension": {
100
+ // First path segment of sourceA (the "primary" side).
101
+ // Documented in module comment.
102
+ const sa = finding.evidence.sourceA;
103
+ if (typeof sa === "string")
104
+ return sa.split("/")[0];
105
+ return undefined;
106
+ }
107
+ case "tier2":
108
+ // First path segment of artifact (the dependent document).
109
+ return t.artifact.split("/")[0];
110
+ default:
111
+ return undefined;
112
+ }
113
+ }
114
+ // ---------------------------------------------------------------------------
115
+ // documentOf — check whether a finding references a given document path.
116
+ // ---------------------------------------------------------------------------
117
+ function documentMatches(finding, document) {
118
+ const t = finding.target;
119
+ switch (t.kind) {
120
+ case "lint":
121
+ return t.path === document;
122
+ case "staleness":
123
+ return t.path === document;
124
+ case "staged": {
125
+ const tp = finding.evidence.targetPath;
126
+ return tp === document;
127
+ }
128
+ case "tension": {
129
+ const ev = finding.evidence;
130
+ return ev.sourceA === document || ev.sourceB === document;
131
+ }
132
+ case "tier2":
133
+ return t.artifact === document || t.unit === document;
134
+ default:
135
+ return false;
136
+ }
137
+ }
138
+ // ---------------------------------------------------------------------------
139
+ // applyFilters — filter reconciled findings.
140
+ //
141
+ // Called AFTER emit persistence, so filters are strictly a view concern.
142
+ // ---------------------------------------------------------------------------
143
+ function applyFilters(findings, filters, now) {
144
+ return findings.filter((f) => {
145
+ if (filters.collection !== undefined) {
146
+ if (collectionOf(f) !== filters.collection)
147
+ return false;
148
+ }
149
+ if (filters.check !== undefined) {
150
+ if (f.check !== filters.check)
151
+ return false;
152
+ }
153
+ if (filters.certainty !== undefined) {
154
+ if (f.certainty !== filters.certainty)
155
+ return false;
156
+ }
157
+ if (filters.owner !== undefined) {
158
+ if (f.owner !== filters.owner)
159
+ return false;
160
+ }
161
+ if (filters.minAgeDays !== undefined) {
162
+ const ageMs = now.getTime() - Date.parse(f.first_seen);
163
+ const ageDays = Math.floor(ageMs / 86_400_000);
164
+ if (ageDays < filters.minAgeDays)
165
+ return false;
166
+ }
167
+ if (filters.document !== undefined) {
168
+ if (!documentMatches(f, filters.document))
169
+ return false;
170
+ }
171
+ return true;
172
+ });
173
+ }
174
+ // ---------------------------------------------------------------------------
175
+ // groupByColumn — partition findings into their five disposition columns.
176
+ // ---------------------------------------------------------------------------
177
+ function groupByColumn(findings) {
178
+ const columns = {
179
+ new: [],
180
+ accepted: [],
181
+ waiting: [],
182
+ resolved: [],
183
+ dismissed: [],
184
+ };
185
+ for (const f of findings) {
186
+ columns[f.disposition].push(f);
187
+ }
188
+ return columns;
189
+ }
190
+ // ---------------------------------------------------------------------------
191
+ // listBoard — the public entry point.
192
+ //
193
+ // Steps:
194
+ // 1. now := now ?? new Date()
195
+ // 2. liveFindings := concat of every SOURCE_ADAPTERS[i].list(vaultRoot, access, now)
196
+ // 3. { byFinding } := loadLedger(vaultRoot)
197
+ // 4. { findings, emit } := reconcile(liveFindings, byFinding, now)
198
+ // 5. For each e in emit: appendEvent(vaultRoot, e)
199
+ // (If an append fails, throw an error naming the finding_id — no silent swallow)
200
+ // 6. Apply filters to findings (AFTER emit persistence — filters are view-only)
201
+ // 7. Return { columns, all }
202
+ // ---------------------------------------------------------------------------
203
+ export async function listBoard(vaultRoot, access, filters, now) {
204
+ const effectiveNow = now ?? new Date();
205
+ // Step 2 — collect from all source adapters (source-agnostic concat, R22).
206
+ // RBAC is applied inside each adapter; the engine does NOT re-filter.
207
+ const perAdapterResults = await Promise.all(SOURCE_ADAPTERS.map((adapter) => adapter.list(vaultRoot, access, effectiveNow)));
208
+ const liveFindings = [].concat(...perAdapterResults);
209
+ // Step 3 — load ledger.
210
+ const ledgerResult = await loadLedger(vaultRoot);
211
+ if (!ledgerResult.ok) {
212
+ throw new Error(`listBoard: cannot load ledger: ${ledgerResult.error.message}`);
213
+ }
214
+ const { byFinding } = ledgerResult.value;
215
+ // Step 4 — reconcile (pure).
216
+ const { findings, emit } = reconcile(liveFindings, byFinding, effectiveNow);
217
+ // Step 5 — persist system events (the ONE write path for system events).
218
+ // Zero emit → zero writes (R7).
219
+ for (const event of emit) {
220
+ const appendResult = await appendEvent(vaultRoot, event);
221
+ if (!appendResult.ok) {
222
+ throw new Error(`listBoard: cannot append system event for finding ${event.finding_id}: ${appendResult.error.message}`);
223
+ }
224
+ }
225
+ // Step 6 — apply filters (view concern, does NOT affect what was persisted).
226
+ const visibleFindings = filters !== undefined && Object.keys(filters).length > 0
227
+ ? applyFilters(findings, filters, effectiveNow)
228
+ : findings;
229
+ // Step 7 — group and return.
230
+ const columns = groupByColumn(visibleFindings);
231
+ return { columns, all: visibleFindings };
232
+ }
233
+ //# sourceMappingURL=board.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/board/board.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=board.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board.test.d.ts","sourceRoot":"","sources":["../../src/board/board.test.ts"],"names":[],"mappings":""}