daftari 3.6.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/attest/bundle.d.ts +53 -0
- package/dist/attest/bundle.d.ts.map +1 -0
- package/dist/attest/bundle.js +141 -0
- package/dist/attest/bundle.js.map +1 -0
- package/dist/attest/index.d.ts +2 -0
- package/dist/attest/index.d.ts.map +1 -0
- package/dist/attest/index.js +139 -0
- package/dist/attest/index.js.map +1 -0
- package/dist/attest/sign.d.ts +16 -0
- package/dist/attest/sign.d.ts.map +1 -0
- package/dist/attest/sign.js +75 -0
- package/dist/attest/sign.js.map +1 -0
- package/dist/attest/verify.d.ts +21 -0
- package/dist/attest/verify.d.ts.map +1 -0
- package/dist/attest/verify.js +148 -0
- package/dist/attest/verify.js.map +1 -0
- 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 +15 -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/staged-actions.d.ts +2 -0
- package/dist/curation/staged-actions.d.ts.map +1 -1
- package/dist/curation/staged-actions.js +5 -0
- package/dist/curation/staged-actions.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/adapters/claude-session.d.ts +6 -0
- package/dist/distill/adapters/claude-session.d.ts.map +1 -0
- package/dist/distill/adapters/claude-session.js +71 -0
- package/dist/distill/adapters/claude-session.js.map +1 -0
- package/dist/distill/cli.d.ts.map +1 -1
- package/dist/distill/cli.js +119 -9
- 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/index.d.ts +1 -0
- package/dist/distill/index.d.ts.map +1 -1
- package/dist/distill/index.js +3 -0
- package/dist/distill/index.js.map +1 -1
- package/dist/distill/propose.d.ts +67 -6
- package/dist/distill/propose.d.ts.map +1 -1
- package/dist/distill/propose.js +142 -32
- 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 +286 -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/storage/index-db.d.ts +1 -0
- package/dist/storage/index-db.d.ts.map +1 -1
- package/dist/storage/index-db.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/positions.d.ts.map +1 -1
- package/dist/tools/positions.js +6 -0
- package/dist/tools/positions.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/receipt.d.ts +6 -0
- package/dist/tools/receipt.d.ts.map +1 -1
- package/dist/tools/receipt.js +47 -1
- package/dist/tools/receipt.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/staged-actions.d.ts.map +1 -1
- package/dist/tools/staged-actions.js +26 -2
- package/dist/tools/staged-actions.js.map +1 -1
- package/dist/tools/write.d.ts +1 -0
- package/dist/tools/write.d.ts.map +1 -1
- package/dist/tools/write.js +475 -227
- package/dist/tools/write.js.map +1 -1
- package/dist/utils/config.d.ts +21 -0
- package/dist/utils/config.d.ts.map +1 -1
- package/dist/utils/config.js +104 -1
- package/dist/utils/config.js.map +1 -1
- package/dist/utils/git.d.ts +18 -2
- package/dist/utils/git.d.ts.map +1 -1
- package/dist/utils/git.js +116 -13
- package/dist/utils/git.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,148 @@
|
|
|
1
|
+
// Offline verification of an attestation bundle (#298). Read-only by
|
|
2
|
+
// construction: no writes, no locks, no process lock, no index. The exit-code
|
|
3
|
+
// split is the contract — scripts must distinguish FORGED from STALE:
|
|
4
|
+
// 0 verified · 1 cryptographic/authenticity failure · 2 usage/malformed ·
|
|
5
|
+
// 3 runtime (the Result error path) · 4 signature-valid-but-content-drifted.
|
|
6
|
+
// Partial verification is a first-class outcome: per-doc results are reported
|
|
7
|
+
// individually (match / modified / missing / unlisted), never summarized away.
|
|
8
|
+
import { createPublicKey } from "node:crypto";
|
|
9
|
+
import { readFile } from "node:fs/promises";
|
|
10
|
+
import { isAbsolute, relative, resolve } from "node:path";
|
|
11
|
+
import { loadDocuments } from "../curation/vault-docs.js";
|
|
12
|
+
import { ok } from "../frontmatter/types.js";
|
|
13
|
+
import { blobExists, isGitRepo } from "../utils/git.js";
|
|
14
|
+
import { sha256Hex } from "../utils/hash.js";
|
|
15
|
+
import { ATTEST_FORMAT, manifestBytes } from "./bundle.js";
|
|
16
|
+
import { keyIdOf, verifyBytes } from "./sign.js";
|
|
17
|
+
function samePublicKey(aPem, bPem) {
|
|
18
|
+
try {
|
|
19
|
+
const a = createPublicKey(aPem).export({ type: "spki", format: "der" });
|
|
20
|
+
const b = createPublicKey(bPem).export({ type: "spki", format: "der" });
|
|
21
|
+
return a.equals(b);
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return false;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
export async function verifyBundle(bundleRaw, opts) {
|
|
28
|
+
// 1. Envelope shape.
|
|
29
|
+
let envelope;
|
|
30
|
+
try {
|
|
31
|
+
envelope = JSON.parse(bundleRaw);
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return ok({
|
|
35
|
+
state: "malformed",
|
|
36
|
+
exitCode: 2,
|
|
37
|
+
detail: "bundle is not valid JSON",
|
|
38
|
+
identityPinned: false,
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
if (envelope?.format !== ATTEST_FORMAT ||
|
|
42
|
+
typeof envelope.manifest !== "object" ||
|
|
43
|
+
envelope.manifest === null ||
|
|
44
|
+
typeof envelope.signature?.value !== "string" ||
|
|
45
|
+
typeof envelope.manifest.signer?.publicKey !== "string") {
|
|
46
|
+
return ok({
|
|
47
|
+
state: "malformed",
|
|
48
|
+
exitCode: 2,
|
|
49
|
+
detail: `bundle is not a ${ATTEST_FORMAT} envelope`,
|
|
50
|
+
identityPinned: false,
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
// 2. Signature over the re-stringified manifest, with the embedded key.
|
|
54
|
+
const signerPem = envelope.manifest.signer.publicKey;
|
|
55
|
+
const keyId = keyIdOf(signerPem);
|
|
56
|
+
const bytes = manifestBytes(envelope.manifest);
|
|
57
|
+
// BOTH keyId fields must bind to the embedded key — a cosmetic
|
|
58
|
+
// signer.keyId that names a different key is a confusion vector.
|
|
59
|
+
if (keyId !== envelope.signature.keyId ||
|
|
60
|
+
keyId !== envelope.manifest.signer.keyId ||
|
|
61
|
+
!verifyBytes(signerPem, bytes, envelope.signature.value)) {
|
|
62
|
+
return ok({
|
|
63
|
+
state: "signature-invalid",
|
|
64
|
+
exitCode: 1,
|
|
65
|
+
detail: "signature does not verify over the manifest bytes",
|
|
66
|
+
keyId,
|
|
67
|
+
identityPinned: false,
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
// 3. Identity pinning.
|
|
71
|
+
const identityPinned = opts.pubkeyPem !== undefined;
|
|
72
|
+
if (opts.pubkeyPem !== undefined && !samePublicKey(signerPem, opts.pubkeyPem)) {
|
|
73
|
+
return ok({
|
|
74
|
+
state: "key-mismatch",
|
|
75
|
+
exitCode: 1,
|
|
76
|
+
detail: "signature is valid but the embedded key is not the pinned one — " +
|
|
77
|
+
"right bundle shape, wrong signer",
|
|
78
|
+
keyId,
|
|
79
|
+
identityPinned: true,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
// 4. Signature-only mode.
|
|
83
|
+
if (opts.vaultRoot === undefined) {
|
|
84
|
+
return ok({
|
|
85
|
+
state: "verified",
|
|
86
|
+
exitCode: 0,
|
|
87
|
+
detail: identityPinned
|
|
88
|
+
? "signature verified against the pinned key (no vault checked)"
|
|
89
|
+
: "identity unpinned: signature proves integrity, not signer (no vault checked)",
|
|
90
|
+
keyId,
|
|
91
|
+
identityPinned,
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
// 5. Per-doc content against the vault copy. Doc paths come from the
|
|
95
|
+
// (attacker-suppliable) bundle: an absolute or escaping path would turn
|
|
96
|
+
// the match/modified report into a one-bit file oracle OUTSIDE the vault,
|
|
97
|
+
// so any such path makes the whole bundle malformed — never read.
|
|
98
|
+
const vaultRoot = opts.vaultRoot;
|
|
99
|
+
for (const doc of envelope.manifest.docs) {
|
|
100
|
+
const abs = resolve(vaultRoot, doc.path);
|
|
101
|
+
const rel = relative(resolve(vaultRoot), abs);
|
|
102
|
+
if (isAbsolute(doc.path) || rel.startsWith("..") || isAbsolute(rel) || rel === "") {
|
|
103
|
+
return ok({
|
|
104
|
+
state: "malformed",
|
|
105
|
+
exitCode: 2,
|
|
106
|
+
detail: `manifest names a path outside the vault: ${doc.path}`,
|
|
107
|
+
keyId,
|
|
108
|
+
identityPinned,
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
const match = [];
|
|
113
|
+
const modified = [];
|
|
114
|
+
const missing = [];
|
|
115
|
+
for (const doc of envelope.manifest.docs) {
|
|
116
|
+
try {
|
|
117
|
+
const raw = await readFile(resolve(vaultRoot, doc.path), "utf-8");
|
|
118
|
+
if (sha256Hex(raw) === doc.contentHash)
|
|
119
|
+
match.push(doc.path);
|
|
120
|
+
else
|
|
121
|
+
modified.push(doc.path);
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
missing.push(doc.path);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
const listed = new Set(envelope.manifest.docs.map((d) => d.path));
|
|
128
|
+
const present = await loadDocuments(vaultRoot);
|
|
129
|
+
const unlisted = present.ok ? present.value.map((d) => d.path).filter((p) => !listed.has(p)) : [];
|
|
130
|
+
// 6. Head anchoring (informational).
|
|
131
|
+
let headKnown = false;
|
|
132
|
+
if (await isGitRepo(vaultRoot)) {
|
|
133
|
+
headKnown = await blobExists(vaultRoot, envelope.manifest.headCommit);
|
|
134
|
+
}
|
|
135
|
+
const drift = modified.length > 0 || missing.length > 0 || unlisted.length > 0 || !headKnown;
|
|
136
|
+
return ok({
|
|
137
|
+
state: drift ? "content-drift" : "verified",
|
|
138
|
+
exitCode: drift ? 4 : 0,
|
|
139
|
+
detail: drift
|
|
140
|
+
? "signature valid; the vault has moved since attestation (stale, not forged)"
|
|
141
|
+
: "signature valid and every listed doc matches the vault copy",
|
|
142
|
+
keyId,
|
|
143
|
+
identityPinned,
|
|
144
|
+
docs: { match, modified, missing, unlisted },
|
|
145
|
+
headKnown,
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
//# sourceMappingURL=verify.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/attest/verify.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 @@
|
|
|
1
|
+
{"version":3,"file":"board.test.d.ts","sourceRoot":"","sources":["../../src/board/board.test.ts"],"names":[],"mappings":""}
|