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
@@ -0,0 +1,293 @@
1
+ // reconcile.ts — U4: Reconciliation engine.
2
+ //
3
+ // PURE function: no filesystem access, no Date.now() calls, no side effects.
4
+ // Takes live findings + a ledger snapshot + a clock injection (`now`) and
5
+ // returns:
6
+ // findings — reconciled board cards (stamped with disposition, history,
7
+ // first_seen/last_seen). One card per distinct identity_key.
8
+ // emit — NEW system-authored LedgerEvents the CALLER must append to
9
+ // the ledger. reconcile never writes; the caller persists emit.
10
+ //
11
+ // Follows the pure-engine + async-loader split from tension-triage.ts:
12
+ // all vault I/O lives in the board engine (U9); this module is pure logic.
13
+ //
14
+ // CASE C design decision (resolved-but-absent findings)
15
+ // -------------------------------------------------------
16
+ // When an accepted finding disappears from the live set, we emit a system
17
+ // "resolved" event and include a "skeleton" Finding in `findings` with
18
+ // column "resolved". The skeleton is reconstructed from the ledger's last
19
+ // known event data (finding_id, against_fingerprint, history). Fields that
20
+ // are only known to the source adapter (target, evidence, suggested_action,
21
+ // verify_predicate, certainty, source, check, owner) are filled with safe
22
+ // placeholder values so the type is satisfied and the board can render a
23
+ // Resolved column entry. U9 (the board engine) may enrich these skeletons
24
+ // from a persisted findings cache if one exists; for now the skeleton is the
25
+ // minimal representation. This is documented here so U9 knows to expect it.
26
+ //
27
+ // Dismissed-and-absent and deferred-and-absent findings are DROPPED from the
28
+ // output (not shown). Rationale: a dismissed finding that no longer reproduces
29
+ // has been vindicated — it needs no board presence. A deferred-and-absent
30
+ // finding is similarly gone; the defer was speculative. If U9 or a later unit
31
+ // needs to surface these, the ledger is the authoritative source.
32
+ import { IDENTITY_SCHEME_VERSION } from "./identity.js";
33
+ import { currentDisposition, eventTimestamps } from "./ledger.js";
34
+ // ---------------------------------------------------------------------------
35
+ // priorHumanDisposition
36
+ //
37
+ // Walks an event list (in append order) to find the latest HUMAN-authored
38
+ // disposition BEFORE the most recent "resolved" (or "reopened") event.
39
+ // Returns the BoardColumn that corresponds to that prior state, or "new"
40
+ // if no prior human event exists.
41
+ //
42
+ // Used for the reopen case: when a resolved finding reappears, the column
43
+ // reverts to whatever the human last decided before the resolution.
44
+ // ---------------------------------------------------------------------------
45
+ function priorHumanDisposition(events) {
46
+ // Scan in reverse to find the latest "resolved" or "reopened" marker,
47
+ // then keep scanning to find the human event before it.
48
+ let passedMarker = false;
49
+ for (let i = events.length - 1; i >= 0; i--) {
50
+ const evt = events[i];
51
+ if (evt === undefined)
52
+ throw new Error("priorHumanDisposition: index out of bounds");
53
+ if (!passedMarker) {
54
+ if (evt.event === "resolved" || evt.event === "reopened") {
55
+ passedMarker = true;
56
+ }
57
+ continue;
58
+ }
59
+ // We are now looking at events before the marker.
60
+ switch (evt.event) {
61
+ case "accept":
62
+ return "accepted";
63
+ case "defer":
64
+ return "waiting";
65
+ case "dismiss":
66
+ return "dismissed";
67
+ // "new", "reopened", "resolved", "reassign" don't map to a stable human column.
68
+ }
69
+ }
70
+ return "new";
71
+ }
72
+ // ---------------------------------------------------------------------------
73
+ // columnForLiveWithLedger
74
+ //
75
+ // Derives the BoardColumn for a live finding that HAS ledger events.
76
+ // Returns { column, shouldEmitReopen } — the caller handles emit assembly.
77
+ // ---------------------------------------------------------------------------
78
+ function columnForLiveWithLedger(finding, events, now) {
79
+ const disp = currentDisposition(events, now);
80
+ switch (disp.event) {
81
+ case "accept":
82
+ return { column: "accepted", shouldEmitReopen: false };
83
+ case "defer": {
84
+ // An elapsed defer expiry re-surfaces the finding for re-triage.
85
+ if (disp.expired) {
86
+ return { column: "new", shouldEmitReopen: false };
87
+ }
88
+ return { column: "waiting", shouldEmitReopen: false };
89
+ }
90
+ case "dismiss": {
91
+ // Three-way check (R9, R10):
92
+ // 1. Fingerprint drifted → re-triage (new), history preserved.
93
+ // 2. Expiry elapsed → re-triage (new).
94
+ // 3. Otherwise → dismissed.
95
+ const fingerprintDrifted = disp.against_fingerprint !== finding.fingerprint;
96
+ if (fingerprintDrifted || disp.expired) {
97
+ return { column: "new", shouldEmitReopen: false };
98
+ }
99
+ return { column: "dismissed", shouldEmitReopen: false };
100
+ }
101
+ case "resolved":
102
+ // Finding reproduced after being resolved → emit reopened (R8).
103
+ return { column: priorHumanDisposition(events), shouldEmitReopen: true };
104
+ case "reopened":
105
+ // Already reopened (second run after first run persisted the event).
106
+ // Don't re-emit. Column is the disposition before the reopened marker.
107
+ return { column: priorHumanDisposition(events), shouldEmitReopen: false };
108
+ default:
109
+ // "new" system event or reassign as latest — treat as new for column.
110
+ return { column: "new", shouldEmitReopen: false };
111
+ }
112
+ }
113
+ // ---------------------------------------------------------------------------
114
+ // buildSystemEvent — factory for system-authored LedgerEvents.
115
+ // ---------------------------------------------------------------------------
116
+ function buildSystemEvent(finding_id, event, against_fingerprint, now, descriptor) {
117
+ return {
118
+ finding_id,
119
+ event,
120
+ by: "system",
121
+ principal_type: "system",
122
+ at: now.toISOString(),
123
+ against_fingerprint,
124
+ identity_scheme_version: IDENTITY_SCHEME_VERSION,
125
+ ...(descriptor !== undefined ? { descriptor } : {}),
126
+ };
127
+ }
128
+ // ---------------------------------------------------------------------------
129
+ // latestDescriptor — walks events BACKWARD to find the latest descriptor.
130
+ //
131
+ // Returns the descriptor from the most recent event that carries one, or
132
+ // undefined if no event in the list has a descriptor. This is needed because
133
+ // U11 stamps descriptors on human disposition events; system events
134
+ // (new/resolved/reopened) may or may not carry one (they forward from the
135
+ // latest human-stamped event). Walk backward so we find the newest first.
136
+ // ---------------------------------------------------------------------------
137
+ function latestDescriptor(events) {
138
+ for (let i = events.length - 1; i >= 0; i--) {
139
+ const evt = events[i];
140
+ if (evt === undefined)
141
+ throw new Error("latestDescriptor: index out of bounds");
142
+ if (evt.descriptor !== undefined) {
143
+ return evt.descriptor;
144
+ }
145
+ }
146
+ return undefined;
147
+ }
148
+ // ---------------------------------------------------------------------------
149
+ // skeletonFinding — minimal Finding for a resolved-but-absent finding.
150
+ //
151
+ // See CASE C design decision at the top of this file. When a descriptor is
152
+ // present on any ledger event, the real source/check/target/label are used.
153
+ // If NO event carries a descriptor (older/edge data), a sentinel source
154
+ // "staleness" is used (not "lint") so callers can detect the placeholder
155
+ // rather than assuming a misleading check category. U9 may enrich these
156
+ // skeletons from a persisted findings cache.
157
+ // ---------------------------------------------------------------------------
158
+ function skeletonFinding(identity_key, events) {
159
+ const ts = eventTimestamps(events);
160
+ const lastEvent = events[events.length - 1];
161
+ if (lastEvent === undefined)
162
+ throw new Error("skeletonFinding: events array must not be empty");
163
+ // Walk backward to find the latest owner from any reassign event, or fall
164
+ // back to the last event's owner field.
165
+ let owner;
166
+ for (let i = events.length - 1; i >= 0; i--) {
167
+ const evt = events[i];
168
+ if (evt === undefined)
169
+ throw new Error("skeletonFinding: index out of bounds");
170
+ if (evt.owner !== undefined) {
171
+ owner = evt.owner;
172
+ break;
173
+ }
174
+ }
175
+ const desc = latestDescriptor(events);
176
+ if (desc !== undefined) {
177
+ return {
178
+ identity_key,
179
+ source: desc.source,
180
+ check: desc.check,
181
+ target: desc.target,
182
+ fingerprint: lastEvent.against_fingerprint,
183
+ certainty: "medium", // not stored in descriptor; placeholder is acceptable
184
+ evidence: {},
185
+ suggested_action: "",
186
+ verify_predicate: "",
187
+ owner: owner ?? "",
188
+ first_seen: ts.first_seen,
189
+ last_seen: ts.last_seen,
190
+ disposition: "resolved",
191
+ history: events,
192
+ };
193
+ }
194
+ // No descriptor on any event (older/edge data). Use explicit sentinel values
195
+ // so callers can distinguish "no descriptor available" from a real finding.
196
+ // "staleness" is used as the sentinel source (NOT "lint") so it is visually
197
+ // distinguishable and does not mislead renderers into treating the skeleton
198
+ // as a lint finding. U9 may override these from a persisted findings cache.
199
+ return {
200
+ identity_key,
201
+ source: "staleness", // sentinel — real source not recoverable; no descriptor on ledger
202
+ check: "unknown", // placeholder — real check not recoverable without descriptor
203
+ target: { kind: "staleness", path: identity_key }, // placeholder
204
+ fingerprint: lastEvent.against_fingerprint,
205
+ certainty: "medium", // placeholder
206
+ evidence: {},
207
+ suggested_action: "",
208
+ verify_predicate: "",
209
+ owner: owner ?? "",
210
+ first_seen: ts.first_seen,
211
+ last_seen: ts.last_seen,
212
+ disposition: "resolved",
213
+ history: events,
214
+ };
215
+ }
216
+ // ---------------------------------------------------------------------------
217
+ // reconcile — the pure engine.
218
+ // ---------------------------------------------------------------------------
219
+ export function reconcile(liveFindings, ledgerByIdentity, now) {
220
+ const findings = [];
221
+ const emit = [];
222
+ // Index live findings by identity_key for O(1) lookup in CASE C.
223
+ const liveByKey = new Map(liveFindings.map((f) => [f.identity_key, f]));
224
+ // --- CASE A + CASE B: iterate over live findings ---
225
+ for (const finding of liveFindings) {
226
+ const events = ledgerByIdentity.get(finding.identity_key);
227
+ if (!events || events.length === 0) {
228
+ // CASE A — no ledger history at all → column "new".
229
+ findings.push({
230
+ ...finding,
231
+ disposition: "new",
232
+ history: [],
233
+ });
234
+ continue;
235
+ }
236
+ // CASE B — live + ledger events.
237
+ const ts = eventTimestamps(events);
238
+ const { column, shouldEmitReopen } = columnForLiveWithLedger(finding, events, now);
239
+ if (shouldEmitReopen) {
240
+ // Carry the descriptor forward so the reopened card keeps its display identity.
241
+ const desc = latestDescriptor(events);
242
+ emit.push(buildSystemEvent(finding.identity_key, "reopened", finding.fingerprint, now, desc));
243
+ }
244
+ findings.push({
245
+ ...finding,
246
+ disposition: column,
247
+ history: events,
248
+ first_seen: ts.first_seen,
249
+ last_seen: ts.last_seen,
250
+ });
251
+ }
252
+ // --- CASE C: iterate over ledger keys NOT present in the live set ---
253
+ for (const [identity_key, events] of ledgerByIdentity) {
254
+ if (liveByKey.has(identity_key)) {
255
+ // Already handled in CASE A/B above.
256
+ continue;
257
+ }
258
+ // Finding is absent from the live set.
259
+ const disp = currentDisposition(events, now);
260
+ if (disp.event === "accept") {
261
+ // Accepted finding no longer reproduces → emit resolved (CASE C, authorized-fix path).
262
+ // Carry the descriptor forward so the resolved card can render its display identity.
263
+ const desc = latestDescriptor(events);
264
+ emit.push(buildSystemEvent(identity_key, "resolved", disp.against_fingerprint, now, desc));
265
+ // Include a skeleton resolved finding so the board can show a Resolved column.
266
+ findings.push(skeletonFinding(identity_key, events));
267
+ continue;
268
+ }
269
+ if (disp.event === "resolved") {
270
+ // Already resolved and still absent → idempotent, no re-emit (R6).
271
+ // Still include it in findings so the Resolved column remains visible.
272
+ findings.push(skeletonFinding(identity_key, events));
273
+ continue;
274
+ }
275
+ // For "reopened" latest event + absent: the finding reproduced then disappeared.
276
+ // Treat like accepted (the human intent was to fix it) → emit resolved.
277
+ // Fix 2: the continue below makes control flow explicit so future insertions after this
278
+ // block cannot accidentally reach the silent-drop path. Suppressed because biome flags
279
+ // it as useless (it is semantically a no-op today, but guards against future edits).
280
+ if (disp.event === "reopened") {
281
+ // Carry the descriptor forward so the resolved card keeps its display identity.
282
+ const desc = latestDescriptor(events);
283
+ emit.push(buildSystemEvent(identity_key, "resolved", disp.against_fingerprint, now, desc));
284
+ findings.push(skeletonFinding(identity_key, events));
285
+ // biome-ignore lint/complexity/noUselessContinue: explicit guard against future fall-through
286
+ continue;
287
+ }
288
+ // dismiss / defer / new / reassign — absent from live set → drop silently.
289
+ // See CASE C design decision at the top of this file.
290
+ }
291
+ return { findings, emit };
292
+ }
293
+ //# sourceMappingURL=reconcile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../src/board/reconcile.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=reconcile.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reconcile.test.d.ts","sourceRoot":"","sources":["../../src/board/reconcile.test.ts"],"names":[],"mappings":""}