daftari 3.7.0 → 3.8.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.
- package/CHANGELOG.md +34 -0
- package/README.md +4 -0
- package/dist/access/rbac.d.ts +1 -0
- package/dist/access/rbac.d.ts.map +1 -1
- package/dist/access/rbac.js +8 -0
- package/dist/access/rbac.js.map +1 -1
- package/dist/board/board.d.ts +37 -0
- package/dist/board/board.d.ts.map +1 -0
- package/dist/board/board.js +233 -0
- package/dist/board/board.js.map +1 -0
- package/dist/board/board.test.d.ts +2 -0
- package/dist/board/board.test.d.ts.map +1 -0
- package/dist/board/board.test.js +753 -0
- package/dist/board/board.test.js.map +1 -0
- package/dist/board/dormancy.test.d.ts +2 -0
- package/dist/board/dormancy.test.d.ts.map +1 -0
- package/dist/board/dormancy.test.js +79 -0
- package/dist/board/dormancy.test.js.map +1 -0
- package/dist/board/identity.d.ts +5 -0
- package/dist/board/identity.d.ts.map +1 -0
- package/dist/board/identity.js +146 -0
- package/dist/board/identity.js.map +1 -0
- package/dist/board/identity.test.d.ts +2 -0
- package/dist/board/identity.test.d.ts.map +1 -0
- package/dist/board/identity.test.js +291 -0
- package/dist/board/identity.test.js.map +1 -0
- package/dist/board/ledger.d.ts +41 -0
- package/dist/board/ledger.d.ts.map +1 -0
- package/dist/board/ledger.js +197 -0
- package/dist/board/ledger.js.map +1 -0
- package/dist/board/ledger.test.d.ts +2 -0
- package/dist/board/ledger.test.d.ts.map +1 -0
- package/dist/board/ledger.test.js +873 -0
- package/dist/board/ledger.test.js.map +1 -0
- package/dist/board/principals.d.ts +4 -0
- package/dist/board/principals.d.ts.map +1 -0
- package/dist/board/principals.js +37 -0
- package/dist/board/principals.js.map +1 -0
- package/dist/board/principals.test.d.ts +2 -0
- package/dist/board/principals.test.d.ts.map +1 -0
- package/dist/board/principals.test.js +296 -0
- package/dist/board/principals.test.js.map +1 -0
- package/dist/board/reconcile.d.ts +12 -0
- package/dist/board/reconcile.d.ts.map +1 -0
- package/dist/board/reconcile.js +293 -0
- package/dist/board/reconcile.js.map +1 -0
- package/dist/board/reconcile.test.d.ts +2 -0
- package/dist/board/reconcile.test.d.ts.map +1 -0
- package/dist/board/reconcile.test.js +788 -0
- package/dist/board/reconcile.test.js.map +1 -0
- package/dist/board/sources/index.d.ts +24 -0
- package/dist/board/sources/index.d.ts.map +1 -0
- package/dist/board/sources/index.js +64 -0
- package/dist/board/sources/index.js.map +1 -0
- package/dist/board/sources/lint.d.ts +3 -0
- package/dist/board/sources/lint.d.ts.map +1 -0
- package/dist/board/sources/lint.js +218 -0
- package/dist/board/sources/lint.js.map +1 -0
- package/dist/board/sources/lint.test.d.ts +2 -0
- package/dist/board/sources/lint.test.d.ts.map +1 -0
- package/dist/board/sources/lint.test.js +616 -0
- package/dist/board/sources/lint.test.js.map +1 -0
- package/dist/board/sources/staged.d.ts +3 -0
- package/dist/board/sources/staged.d.ts.map +1 -0
- package/dist/board/sources/staged.js +116 -0
- package/dist/board/sources/staged.js.map +1 -0
- package/dist/board/sources/staged.test.d.ts +2 -0
- package/dist/board/sources/staged.test.d.ts.map +1 -0
- package/dist/board/sources/staged.test.js +418 -0
- package/dist/board/sources/staged.test.js.map +1 -0
- package/dist/board/sources/staleness.d.ts +43 -0
- package/dist/board/sources/staleness.d.ts.map +1 -0
- package/dist/board/sources/staleness.js +346 -0
- package/dist/board/sources/staleness.js.map +1 -0
- package/dist/board/sources/staleness.test.d.ts +2 -0
- package/dist/board/sources/staleness.test.d.ts.map +1 -0
- package/dist/board/sources/staleness.test.js +923 -0
- package/dist/board/sources/staleness.test.js.map +1 -0
- package/dist/board/sources/tension.d.ts +3 -0
- package/dist/board/sources/tension.d.ts.map +1 -0
- package/dist/board/sources/tension.js +152 -0
- package/dist/board/sources/tension.js.map +1 -0
- package/dist/board/sources/tension.test.d.ts +2 -0
- package/dist/board/sources/tension.test.d.ts.map +1 -0
- package/dist/board/sources/tension.test.js +440 -0
- package/dist/board/sources/tension.test.js.map +1 -0
- package/dist/board/sources/tier2.d.ts +17 -0
- package/dist/board/sources/tier2.d.ts.map +1 -0
- package/dist/board/sources/tier2.js +233 -0
- package/dist/board/sources/tier2.js.map +1 -0
- package/dist/board/sources/tier2.test.d.ts +2 -0
- package/dist/board/sources/tier2.test.d.ts.map +1 -0
- package/dist/board/sources/tier2.test.js +480 -0
- package/dist/board/sources/tier2.test.js.map +1 -0
- package/dist/board/types.d.ts +161 -0
- package/dist/board/types.d.ts.map +1 -0
- package/dist/board/types.js +37 -0
- package/dist/board/types.js.map +1 -0
- package/dist/canon/index.d.ts +3 -1
- package/dist/canon/index.d.ts.map +1 -1
- package/dist/canon/index.js +35 -8
- package/dist/canon/index.js.map +1 -1
- package/dist/canon/types.d.ts +3 -0
- package/dist/canon/types.d.ts.map +1 -1
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +9 -0
- package/dist/cli.js.map +1 -1
- package/dist/consolidate/birth.d.ts +1 -1
- package/dist/consolidate/birth.d.ts.map +1 -1
- package/dist/consolidate/birth.js +22 -0
- package/dist/consolidate/birth.js.map +1 -1
- package/dist/consolidate/edge-write.d.ts +11 -0
- package/dist/consolidate/edge-write.d.ts.map +1 -1
- package/dist/consolidate/edge-write.js +41 -0
- package/dist/consolidate/edge-write.js.map +1 -1
- package/dist/consolidate/index.js +5 -2
- package/dist/consolidate/index.js.map +1 -1
- package/dist/consolidate/revision.d.ts +4 -2
- package/dist/consolidate/revision.d.ts.map +1 -1
- package/dist/consolidate/revision.js +23 -0
- package/dist/consolidate/revision.js.map +1 -1
- package/dist/curation/edge-staleness.d.ts +4 -2
- package/dist/curation/edge-staleness.d.ts.map +1 -1
- package/dist/curation/edge-staleness.js +36 -3
- package/dist/curation/edge-staleness.js.map +1 -1
- package/dist/curation/edges.d.ts +7 -0
- package/dist/curation/edges.d.ts.map +1 -1
- package/dist/curation/edges.js +13 -7
- package/dist/curation/edges.js.map +1 -1
- package/dist/curation/tension-access.d.ts +1 -0
- package/dist/curation/tension-access.d.ts.map +1 -1
- package/dist/curation/tension-access.js +18 -1
- package/dist/curation/tension-access.js.map +1 -1
- package/dist/curation/tension.d.ts +3 -0
- package/dist/curation/tension.d.ts.map +1 -1
- package/dist/curation/tension.js +36 -0
- package/dist/curation/tension.js.map +1 -1
- package/dist/curation/vault-docs.d.ts +1 -0
- package/dist/curation/vault-docs.d.ts.map +1 -1
- package/dist/curation/vault-docs.js +1 -0
- package/dist/curation/vault-docs.js.map +1 -1
- package/dist/distill/cli.d.ts.map +1 -1
- package/dist/distill/cli.js +6 -0
- package/dist/distill/cli.js.map +1 -1
- package/dist/distill/cost.d.ts +6 -0
- package/dist/distill/cost.d.ts.map +1 -1
- package/dist/distill/cost.js +2 -3
- package/dist/distill/cost.js.map +1 -1
- package/dist/distill/extract.d.ts +52 -0
- package/dist/distill/extract.d.ts.map +1 -1
- package/dist/distill/extract.js +24 -2
- package/dist/distill/extract.js.map +1 -1
- package/dist/distill/propose.d.ts +44 -1
- package/dist/distill/propose.d.ts.map +1 -1
- package/dist/distill/propose.js +84 -2
- package/dist/distill/propose.js.map +1 -1
- package/dist/distill/reader-fingerprint.d.ts +69 -0
- package/dist/distill/reader-fingerprint.d.ts.map +1 -0
- package/dist/distill/reader-fingerprint.js +145 -0
- package/dist/distill/reader-fingerprint.js.map +1 -0
- package/dist/distill/receipt-store.d.ts +5 -0
- package/dist/distill/receipt-store.d.ts.map +1 -0
- package/dist/distill/receipt-store.js +24 -0
- package/dist/distill/receipt-store.js.map +1 -0
- package/dist/eval/llm-openrouter.d.ts.map +1 -1
- package/dist/eval/llm-openrouter.js +4 -0
- package/dist/eval/llm-openrouter.js.map +1 -1
- package/dist/eval/llm.d.ts +22 -0
- package/dist/eval/llm.d.ts.map +1 -1
- package/dist/eval/llm.js +94 -24
- package/dist/eval/llm.js.map +1 -1
- package/dist/federation/classification.d.ts.map +1 -1
- package/dist/federation/classification.js +3 -0
- package/dist/federation/classification.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +31 -0
- package/dist/index.js.map +1 -1
- package/dist/search/coverage.d.ts +5 -1
- package/dist/search/coverage.d.ts.map +1 -1
- package/dist/search/coverage.js +47 -15
- package/dist/search/coverage.js.map +1 -1
- package/dist/search/hybrid.d.ts +7 -1
- package/dist/search/hybrid.d.ts.map +1 -1
- package/dist/search/hybrid.js +31 -8
- package/dist/search/hybrid.js.map +1 -1
- package/dist/search/retrieval-metrics.d.ts +5 -0
- package/dist/search/retrieval-metrics.d.ts.map +1 -0
- package/dist/search/retrieval-metrics.js +60 -0
- package/dist/search/retrieval-metrics.js.map +1 -0
- package/dist/search/suppression.d.ts +9 -0
- package/dist/search/suppression.d.ts.map +1 -0
- package/dist/search/suppression.js +107 -0
- package/dist/search/suppression.js.map +1 -0
- package/dist/serve/index.d.ts.map +1 -1
- package/dist/serve/index.js +273 -4
- package/dist/serve/index.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +4 -6
- package/dist/server.js.map +1 -1
- package/dist/tools/board.d.ts +32 -0
- package/dist/tools/board.d.ts.map +1 -0
- package/dist/tools/board.js +615 -0
- package/dist/tools/board.js.map +1 -0
- package/dist/tools/board.test.d.ts +2 -0
- package/dist/tools/board.test.d.ts.map +1 -0
- package/dist/tools/board.test.js +964 -0
- package/dist/tools/board.test.js.map +1 -0
- package/dist/tools/edge-staleness.d.ts.map +1 -1
- package/dist/tools/edge-staleness.js +18 -4
- package/dist/tools/edge-staleness.js.map +1 -1
- package/dist/tools/read.d.ts +2 -0
- package/dist/tools/read.d.ts.map +1 -1
- package/dist/tools/read.js +43 -13
- package/dist/tools/read.js.map +1 -1
- package/dist/tools/search.d.ts.map +1 -1
- package/dist/tools/search.js +79 -17
- package/dist/tools/search.js.map +1 -1
- package/dist/tools/write.d.ts.map +1 -1
- package/dist/tools/write.js +172 -2
- package/dist/tools/write.js.map +1 -1
- package/dist/utils/config.d.ts +13 -0
- package/dist/utils/config.d.ts.map +1 -1
- package/dist/utils/config.js +88 -0
- package/dist/utils/config.js.map +1 -1
- package/dist/version.d.ts +2 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +8 -0
- package/dist/version.js.map +1 -0
- package/dist/view/board-page.d.ts +4 -0
- package/dist/view/board-page.d.ts.map +1 -0
- package/dist/view/board-page.js +278 -0
- package/dist/view/board-page.js.map +1 -0
- package/dist/view/board-page.test.d.ts +2 -0
- package/dist/view/board-page.test.d.ts.map +1 -0
- package/dist/view/board-page.test.js +548 -0
- package/dist/view/board-page.test.js.map +1 -0
- package/dist/view/pages.d.ts.map +1 -1
- package/dist/view/pages.js +13 -2
- package/dist/view/pages.js.map +1 -1
- package/dist/view/render.d.ts.map +1 -1
- package/dist/view/render.js +2 -1
- package/dist/view/render.js.map +1 -1
- 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 @@
|
|
|
1
|
+
{"version":3,"file":"reconcile.test.d.ts","sourceRoot":"","sources":["../../src/board/reconcile.test.ts"],"names":[],"mappings":""}
|