daftari 3.6.0 → 3.7.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 (67) hide show
  1. package/dist/attest/bundle.d.ts +53 -0
  2. package/dist/attest/bundle.d.ts.map +1 -0
  3. package/dist/attest/bundle.js +141 -0
  4. package/dist/attest/bundle.js.map +1 -0
  5. package/dist/attest/index.d.ts +2 -0
  6. package/dist/attest/index.d.ts.map +1 -0
  7. package/dist/attest/index.js +139 -0
  8. package/dist/attest/index.js.map +1 -0
  9. package/dist/attest/sign.d.ts +16 -0
  10. package/dist/attest/sign.d.ts.map +1 -0
  11. package/dist/attest/sign.js +75 -0
  12. package/dist/attest/sign.js.map +1 -0
  13. package/dist/attest/verify.d.ts +21 -0
  14. package/dist/attest/verify.d.ts.map +1 -0
  15. package/dist/attest/verify.js +148 -0
  16. package/dist/attest/verify.js.map +1 -0
  17. package/dist/cli.d.ts.map +1 -1
  18. package/dist/cli.js +6 -0
  19. package/dist/cli.js.map +1 -1
  20. package/dist/curation/staged-actions.d.ts +2 -0
  21. package/dist/curation/staged-actions.d.ts.map +1 -1
  22. package/dist/curation/staged-actions.js +5 -0
  23. package/dist/curation/staged-actions.js.map +1 -1
  24. package/dist/distill/adapters/claude-session.d.ts +6 -0
  25. package/dist/distill/adapters/claude-session.d.ts.map +1 -0
  26. package/dist/distill/adapters/claude-session.js +71 -0
  27. package/dist/distill/adapters/claude-session.js.map +1 -0
  28. package/dist/distill/cli.d.ts.map +1 -1
  29. package/dist/distill/cli.js +113 -9
  30. package/dist/distill/cli.js.map +1 -1
  31. package/dist/distill/index.d.ts +1 -0
  32. package/dist/distill/index.d.ts.map +1 -1
  33. package/dist/distill/index.js +3 -0
  34. package/dist/distill/index.js.map +1 -1
  35. package/dist/distill/propose.d.ts +23 -5
  36. package/dist/distill/propose.d.ts.map +1 -1
  37. package/dist/distill/propose.js +58 -30
  38. package/dist/distill/propose.js.map +1 -1
  39. package/dist/serve/index.d.ts.map +1 -1
  40. package/dist/serve/index.js +13 -0
  41. package/dist/serve/index.js.map +1 -1
  42. package/dist/storage/index-db.d.ts +1 -0
  43. package/dist/storage/index-db.d.ts.map +1 -1
  44. package/dist/storage/index-db.js.map +1 -1
  45. package/dist/tools/positions.d.ts.map +1 -1
  46. package/dist/tools/positions.js +6 -0
  47. package/dist/tools/positions.js.map +1 -1
  48. package/dist/tools/receipt.d.ts +6 -0
  49. package/dist/tools/receipt.d.ts.map +1 -1
  50. package/dist/tools/receipt.js +47 -1
  51. package/dist/tools/receipt.js.map +1 -1
  52. package/dist/tools/staged-actions.d.ts.map +1 -1
  53. package/dist/tools/staged-actions.js +26 -2
  54. package/dist/tools/staged-actions.js.map +1 -1
  55. package/dist/tools/write.d.ts +1 -0
  56. package/dist/tools/write.d.ts.map +1 -1
  57. package/dist/tools/write.js +303 -225
  58. package/dist/tools/write.js.map +1 -1
  59. package/dist/utils/config.d.ts +8 -0
  60. package/dist/utils/config.d.ts.map +1 -1
  61. package/dist/utils/config.js +16 -1
  62. package/dist/utils/config.js.map +1 -1
  63. package/dist/utils/git.d.ts +18 -2
  64. package/dist/utils/git.d.ts.map +1 -1
  65. package/dist/utils/git.js +116 -13
  66. package/dist/utils/git.js.map +1 -1
  67. package/package.json +1 -1
@@ -0,0 +1,53 @@
1
+ import { type Result } from "../frontmatter/types.js";
2
+ import { type AttestKey } from "./sign.js";
3
+ export declare const ATTEST_FORMAT = "daftari.attestation/v1";
4
+ export interface AttestDocEntry {
5
+ path: string;
6
+ contentHash: string;
7
+ status: string;
8
+ confidence: string;
9
+ provenance: string;
10
+ contested: boolean;
11
+ ratified: boolean;
12
+ openTensions: number;
13
+ git: {
14
+ firstCommitDate: string;
15
+ lastCommit: string;
16
+ lastAuthor: string;
17
+ lastDate: string;
18
+ commitCount: number;
19
+ } | null;
20
+ }
21
+ export interface AttestManifest {
22
+ headCommit: string;
23
+ generatedAt: string;
24
+ daftariVersion: string;
25
+ signer: {
26
+ keyId: string;
27
+ publicKey: string;
28
+ algorithm: "ed25519";
29
+ } | null;
30
+ totals: {
31
+ docs: number;
32
+ contestedDocs: number;
33
+ openTensions: number;
34
+ };
35
+ docs: AttestDocEntry[];
36
+ }
37
+ export interface AttestEnvelope {
38
+ format: typeof ATTEST_FORMAT;
39
+ manifest: AttestManifest;
40
+ signature: {
41
+ algorithm: "ed25519";
42
+ keyId: string;
43
+ value: string;
44
+ };
45
+ }
46
+ export declare function manifestBytes(manifest: unknown): string;
47
+ export declare function outPathInsideVault(vaultRoot: string, outPath: string): boolean;
48
+ export declare function buildManifest(vaultRoot: string, opts: {
49
+ daftariVersion: string;
50
+ generatedAt?: string;
51
+ }): Promise<Result<AttestManifest, Error>>;
52
+ export declare function signManifest(manifest: AttestManifest, key: AttestKey): AttestEnvelope;
53
+ //# sourceMappingURL=bundle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/attest/bundle.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAG/D,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,WAAW,CAAC;AAEtD,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE;QACH,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,IAAI,EAAE,cAAc,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,aAAa,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAMD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAEvD;AAKD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9E;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CA+ExC;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,cAAc,CAcrF"}
@@ -0,0 +1,141 @@
1
+ // The attestation bundle (#298 layer 2): a per-doc manifest — content hash,
2
+ // git history, ratification/contested status, open-tension counts — derived
3
+ // ENTIRELY from markdown bytes, git, and the vault's own tension log, signed
4
+ // once with the operator's Ed25519 key, verifiable offline.
5
+ //
6
+ // Never a second source of truth: every field is re-derivable by anyone
7
+ // holding the vault and its history. Git-ignored derived logs (curation-log,
8
+ // edges, staged-actions, read-log …) are structurally excluded — a guard
9
+ // test pins that poisoning them cannot move a single manifest byte.
10
+ //
11
+ // Threat model, stated plainly: the signer IS the vault operator. The
12
+ // signature proves the bundle is byte-identical to what the keyholder
13
+ // produced and that the content hashes / sealed history are the keyholder's
14
+ // snapshot claims. Because git commits chain, one signature over headCommit
15
+ // transitively seals every ancestor — including the authenticated-principal
16
+ // author fields commitIdentity records — as tamper-evident. It does NOT
17
+ // prove per-principal authorship, freshness, or non-rollback.
18
+ //
19
+ // Operator-only surface (the Tension Court precedent): the manifest names
20
+ // EVERY doc path in the vault, so it is a whole-vault operator export —
21
+ // role-scoped bundles are rejected in v1 (the 2026-07-14 small-cell
22
+ // disclosure analysis; revisit that spec before ever building them).
23
+ //
24
+ // The dirty-tree gate exempts `.daftari/`: the tension log is advisory
25
+ // operator state that nothing auto-commits, and its annotations in the
26
+ // manifest are snapshot claims like everything else. Doc files must be
27
+ // clean, or the content hashes and the head seal would be different claims.
28
+ import { readFile } from "node:fs/promises";
29
+ import { isAbsolute, relative, resolve } from "node:path";
30
+ import { listTensions } from "../curation/tension.js";
31
+ import { loadDocuments } from "../curation/vault-docs.js";
32
+ import { err, ok } from "../frontmatter/types.js";
33
+ import { headFullSha, historyByPath, isGitRepo, statusPorcelain } from "../utils/git.js";
34
+ import { sha256Hex } from "../utils/hash.js";
35
+ import { signBytes } from "./sign.js";
36
+ export const ATTEST_FORMAT = "daftari.attestation/v1";
37
+ // The exact bytes the signature covers. JSON.stringify of the manifest as
38
+ // produced; verification re-stringifies the parsed manifest. Sound in JS
39
+ // because insertion order is preserved for non-integer-like keys and `docs`
40
+ // is an array — the canonical.test.ts round-trip pins the bet.
41
+ export function manifestBytes(manifest) {
42
+ return JSON.stringify(manifest);
43
+ }
44
+ // "Output artifact, never vault state", enforced structurally: an output
45
+ // path that resolves inside the vault root is refused, so a bundle can never
46
+ // be committed into the vault and minted into a second source of truth.
47
+ export function outPathInsideVault(vaultRoot, outPath) {
48
+ const rel = relative(resolve(vaultRoot), resolve(outPath));
49
+ return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
50
+ }
51
+ export async function buildManifest(vaultRoot, opts) {
52
+ if (!(await isGitRepo(vaultRoot))) {
53
+ return err(new Error("attest: the vault is not a git repository — nothing to seal"));
54
+ }
55
+ // Clean-tree gate: any dirty path OUTSIDE .daftari/ refuses, and names
56
+ // the offenders — a bundle over uncommitted docs is unverifiable against
57
+ // git by construction.
58
+ const status = await statusPorcelain(vaultRoot);
59
+ if (!status.ok)
60
+ return status;
61
+ // A porcelain rename line carries BOTH sides ("R old -> new"); the
62
+ // .daftari exemption applies only when EVERY involved path is under the
63
+ // control dir, or a rename out of it would smuggle a dirty doc past the
64
+ // gate. Quoted special-character paths are unquoted before the check.
65
+ const unquote = (p) => p.startsWith('"') && p.endsWith('"') ? p.slice(1, -1) : p;
66
+ const exempt = (p) => p.startsWith(".daftari/") || p === ".daftari";
67
+ const dirty = status.value
68
+ .flatMap((l) => l.slice(3).split(" -> ").map(unquote))
69
+ .filter((p) => !exempt(p));
70
+ if (dirty.length > 0) {
71
+ return err(new Error(`attest: working tree is dirty — commit first (offending paths: ${dirty.join(", ")})`));
72
+ }
73
+ const head = await headFullSha(vaultRoot);
74
+ if (!head.ok)
75
+ return head;
76
+ const docs = await loadDocuments(vaultRoot);
77
+ if (!docs.ok)
78
+ return docs;
79
+ const tensions = await listTensions(vaultRoot);
80
+ if (!tensions.ok)
81
+ return tensions;
82
+ const history = await historyByPath(vaultRoot);
83
+ if (!history.ok)
84
+ return history;
85
+ // Open tensions per doc path; totals count DISTINCT unresolved entries.
86
+ const openByPath = new Map();
87
+ let openTotal = 0;
88
+ for (const t of tensions.value) {
89
+ if (t.resolved)
90
+ continue;
91
+ openTotal += 1;
92
+ for (const p of new Set([t.sourceA, t.sourceB])) {
93
+ openByPath.set(p, (openByPath.get(p) ?? 0) + 1);
94
+ }
95
+ }
96
+ const entries = [];
97
+ for (const doc of docs.value) {
98
+ const raw = await readFile(resolve(vaultRoot, doc.path), "utf-8");
99
+ const fm = doc.frontmatter;
100
+ entries.push({
101
+ path: doc.path,
102
+ contentHash: sha256Hex(raw),
103
+ status: fm.status,
104
+ confidence: fm.confidence,
105
+ provenance: fm.provenance,
106
+ contested: fm.contested ?? false,
107
+ ratified: fm.org_position != null,
108
+ openTensions: openByPath.get(doc.path) ?? 0,
109
+ git: history.value.get(doc.path) ?? null,
110
+ });
111
+ }
112
+ entries.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
113
+ return ok({
114
+ headCommit: head.value,
115
+ generatedAt: opts.generatedAt ?? new Date().toISOString(),
116
+ daftariVersion: opts.daftariVersion,
117
+ signer: null, // filled by signManifest
118
+ totals: {
119
+ docs: entries.length,
120
+ contestedDocs: entries.filter((e) => e.contested).length,
121
+ openTensions: openTotal,
122
+ },
123
+ docs: entries,
124
+ });
125
+ }
126
+ export function signManifest(manifest, key) {
127
+ const signed = {
128
+ ...manifest,
129
+ signer: { keyId: key.keyId, publicKey: key.publicKeyPem, algorithm: "ed25519" },
130
+ };
131
+ return {
132
+ format: ATTEST_FORMAT,
133
+ manifest: signed,
134
+ signature: {
135
+ algorithm: "ed25519",
136
+ keyId: key.keyId,
137
+ value: signBytes(key, manifestBytes(signed)),
138
+ },
139
+ };
140
+ }
141
+ //# sourceMappingURL=bundle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/attest/bundle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function runAttest(argv: string[]): Promise<number>;
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attest/index.ts"],"names":[],"mappings":"AAuCA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+G/D"}
@@ -0,0 +1,139 @@
1
+ // `daftari attest` (#298) — operator-only CLI, the court/sync posture: no
2
+ // access context, never exposed over MCP (the bundle names every doc path —
3
+ // existence disclosure — and exercises operator key material).
4
+ //
5
+ // Exit codes (the verify contract): 0 verified/produced · 1 cryptographic or
6
+ // authenticity failure · 2 usage/malformed · 3 runtime · 4 signature-valid-
7
+ // but-content-drifted.
8
+ import { existsSync, readFileSync, writeFileSync } from "node:fs";
9
+ import { join, resolve } from "node:path";
10
+ import { parseFlag } from "../index.js";
11
+ import { SERVER_VERSION } from "../server.js";
12
+ import { dataHome } from "../utils/config.js";
13
+ import { buildManifest, outPathInsideVault, signManifest } from "./bundle.js";
14
+ import { generateAttestKeys, loadAttestKey } from "./sign.js";
15
+ import { verifyBundle } from "./verify.js";
16
+ const HELP = `daftari attest — signed vault attestation bundles (#298).
17
+
18
+ Usage:
19
+ daftari attest [--vault <path>] [--out <path>] [--key <path>]
20
+ daftari attest verify <bundle.json> [--vault <path>] [--pubkey <pem-file>] [--key <path>]
21
+ daftari attest keygen [--out <dir>]
22
+
23
+ The signing key is an Ed25519 private key (PKCS#8 PEM) at the path named by
24
+ DAFTARI_ATTEST_KEY (or --key). Keys never live in config.yaml — config is
25
+ committed vault state. The bundle is an OUTPUT artifact: writing it inside
26
+ the vault root is refused, so it can never become a second source of truth.
27
+
28
+ What a signature proves: the bundle is byte-identical to what the keyholder
29
+ produced, and the content hashes / sealed git history are the keyholder's
30
+ snapshot claims. It does NOT prove per-principal authorship or freshness —
31
+ the signer is the vault OPERATOR.
32
+ `;
33
+ function resolveKeyPath(argv) {
34
+ return parseFlag(argv, "key") ?? process.env.DAFTARI_ATTEST_KEY ?? null;
35
+ }
36
+ export async function runAttest(argv) {
37
+ if (argv.includes("--help") || argv.includes("-h")) {
38
+ process.stdout.write(HELP);
39
+ return 0;
40
+ }
41
+ if (argv[0] === "keygen") {
42
+ const outDir = parseFlag(argv, "out") ?? join(dataHome(), "daftari", "keys");
43
+ const made = generateAttestKeys(outDir);
44
+ if (!made.ok) {
45
+ process.stderr.write(`daftari attest: ${made.error.message}\n`);
46
+ return 2;
47
+ }
48
+ process.stdout.write(`wrote ${made.value.keyPath} (0600) and ${made.value.pubPath}\n` +
49
+ `export DAFTARI_ATTEST_KEY=${made.value.keyPath}\n`);
50
+ return 0;
51
+ }
52
+ if (argv[0] === "verify") {
53
+ const bundlePath = argv[1];
54
+ if (!bundlePath || bundlePath.startsWith("--")) {
55
+ process.stderr.write("daftari attest verify: a bundle path is required\n");
56
+ return 2;
57
+ }
58
+ let bundleRaw;
59
+ try {
60
+ bundleRaw = readFileSync(bundlePath, "utf-8");
61
+ }
62
+ catch (e) {
63
+ process.stderr.write(`daftari attest verify: cannot read ${bundlePath}: ${String(e)}\n`);
64
+ return 2;
65
+ }
66
+ let pubkeyPem;
67
+ const pubkeyPath = parseFlag(argv, "pubkey");
68
+ const keyPath = resolveKeyPath(argv);
69
+ if (pubkeyPath) {
70
+ try {
71
+ pubkeyPem = readFileSync(pubkeyPath, "utf-8");
72
+ }
73
+ catch (e) {
74
+ process.stderr.write(`daftari attest verify: cannot read --pubkey: ${String(e)}\n`);
75
+ return 2;
76
+ }
77
+ }
78
+ else if (keyPath && existsSync(keyPath)) {
79
+ // --key lets verify derive the expected public key from the private one.
80
+ const key = loadAttestKey(keyPath);
81
+ if (key.ok)
82
+ pubkeyPem = key.value.publicKeyPem;
83
+ }
84
+ const vaultFlag = parseFlag(argv, "vault");
85
+ const report = await verifyBundle(bundleRaw, {
86
+ ...(vaultFlag ? { vaultRoot: resolve(vaultFlag) } : {}),
87
+ ...(pubkeyPem !== undefined ? { pubkeyPem } : {}),
88
+ });
89
+ if (!report.ok) {
90
+ process.stderr.write(`daftari attest verify: ${report.error.message}\n`);
91
+ return 3;
92
+ }
93
+ const r = report.value;
94
+ process.stdout.write(`${r.state}: ${r.detail}\n`);
95
+ if (r.keyId)
96
+ process.stdout.write(`keyId: ${r.keyId}${r.identityPinned ? " (pinned)" : ""}\n`);
97
+ if (r.docs) {
98
+ process.stdout.write(`docs: ${r.docs.match.length} match` +
99
+ (r.docs.modified.length > 0 ? `, modified: ${r.docs.modified.join(", ")}` : "") +
100
+ (r.docs.missing.length > 0 ? `, missing: ${r.docs.missing.join(", ")}` : "") +
101
+ (r.docs.unlisted.length > 0 ? `, unlisted: ${r.docs.unlisted.join(", ")}` : "") +
102
+ `\n`);
103
+ if (r.headKnown === false)
104
+ process.stdout.write("head: unknown to this repository\n");
105
+ }
106
+ return r.exitCode;
107
+ }
108
+ // Default: produce a signed bundle.
109
+ const vaultRoot = resolve(parseFlag(argv, "vault") ?? process.cwd());
110
+ const keyPath = resolveKeyPath(argv);
111
+ if (!keyPath) {
112
+ process.stderr.write("daftari attest: no signing key — set DAFTARI_ATTEST_KEY or pass --key " +
113
+ "(generate one with `daftari attest keygen`)\n");
114
+ return 2;
115
+ }
116
+ const key = loadAttestKey(keyPath);
117
+ if (!key.ok) {
118
+ process.stderr.write(`daftari attest: ${key.error.message}\n`);
119
+ return 2;
120
+ }
121
+ const manifest = await buildManifest(vaultRoot, { daftariVersion: SERVER_VERSION });
122
+ if (!manifest.ok) {
123
+ process.stderr.write(`daftari attest: ${manifest.error.message}\n`);
124
+ return manifest.error.message.includes("dirty") ? 2 : 3;
125
+ }
126
+ const envelope = signManifest(manifest.value, key.value);
127
+ const head8 = manifest.value.headCommit.slice(0, 8);
128
+ const outPath = resolve(parseFlag(argv, "out") ?? `daftari-attestation-${head8}.json`);
129
+ if (outPathInsideVault(vaultRoot, outPath)) {
130
+ process.stderr.write(`daftari attest: refusing to write the bundle inside the vault root ` +
131
+ `(${outPath}) — an attestation is an output artifact, never vault state\n`);
132
+ return 2;
133
+ }
134
+ writeFileSync(outPath, `${JSON.stringify(envelope, null, 2)}\n`);
135
+ process.stdout.write(`attested ${manifest.value.totals.docs} docs at ${head8} → ${outPath} ` +
136
+ `(keyId ${key.value.keyId})\n`);
137
+ return 0;
138
+ }
139
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attest/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { type KeyObject } from "node:crypto";
2
+ import { type Result } from "../frontmatter/types.js";
3
+ export interface AttestKey {
4
+ privateKey: KeyObject;
5
+ publicKeyPem: string;
6
+ keyId: string;
7
+ }
8
+ export declare function keyIdOf(publicKeyPem: string): string;
9
+ export declare function generateAttestKeys(outDir: string): Result<{
10
+ keyPath: string;
11
+ pubPath: string;
12
+ }, Error>;
13
+ export declare function loadAttestKey(path: string): Result<AttestKey, Error>;
14
+ export declare function signBytes(key: AttestKey, bytes: Buffer | string): string;
15
+ export declare function verifyBytes(publicKeyPem: string, bytes: Buffer | string, signatureB64: string): boolean;
16
+ //# sourceMappingURL=sign.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../../src/attest/sign.ts"],"names":[],"mappings":"AAOA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,SAAS,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GACb,MAAM,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAoBrD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAyBpE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAYT"}
@@ -0,0 +1,75 @@
1
+ // Attestation signing primitives (#298): Ed25519 via node:crypto — no new
2
+ // dependency, the sibling of utils/hash.ts. Key material lives on disk at a
3
+ // path named by DAFTARI_ATTEST_KEY (or --key), NEVER in .daftari/config.yaml:
4
+ // config is committed vault state, and secrets never ride the vault (the
5
+ // server.auth.tokens env-var precedent). Unset env = signing off everywhere;
6
+ // set-but-unusable = loud failure at the entry point.
7
+ import { createHash, createPrivateKey, createPublicKey, sign as cryptoSign, verify as cryptoVerify, generateKeyPairSync, } from "node:crypto";
8
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
9
+ import { join } from "node:path";
10
+ import { err, ok } from "../frontmatter/types.js";
11
+ // 16 hex of sha256 over the public key's DER (SPKI) bytes — enough to name a
12
+ // key in logs and bundles, useless for reconstruction.
13
+ export function keyIdOf(publicKeyPem) {
14
+ const der = createPublicKey(publicKeyPem).export({ type: "spki", format: "der" });
15
+ return createHash("sha256").update(der).digest("hex").slice(0, 16);
16
+ }
17
+ export function generateAttestKeys(outDir) {
18
+ const keyPath = join(outDir, "attest.key");
19
+ const pubPath = join(outDir, "attest.pub");
20
+ if (existsSync(keyPath) || existsSync(pubPath)) {
21
+ return err(new Error(`attest keygen: refusing to overwrite existing key material in ${outDir}`));
22
+ }
23
+ try {
24
+ mkdirSync(outDir, { recursive: true });
25
+ const { privateKey, publicKey } = generateKeyPairSync("ed25519");
26
+ writeFileSync(keyPath, privateKey.export({ type: "pkcs8", format: "pem" }), {
27
+ mode: 0o600,
28
+ });
29
+ writeFileSync(pubPath, publicKey.export({ type: "spki", format: "pem" }));
30
+ return ok({ keyPath, pubPath });
31
+ }
32
+ catch (e) {
33
+ const reason = e instanceof Error ? e.message : String(e);
34
+ return err(new Error(`attest keygen failed: ${reason}`));
35
+ }
36
+ }
37
+ export function loadAttestKey(path) {
38
+ let pem;
39
+ try {
40
+ pem = readFileSync(path, "utf-8");
41
+ }
42
+ catch (e) {
43
+ const reason = e instanceof Error ? e.message : String(e);
44
+ return err(new Error(`cannot read attest key at ${path}: ${reason}`));
45
+ }
46
+ try {
47
+ const privateKey = createPrivateKey(pem);
48
+ if (privateKey.asymmetricKeyType !== "ed25519") {
49
+ return err(new Error(`attest key at ${path} is ${privateKey.asymmetricKeyType ?? "unknown"}, expected ed25519`));
50
+ }
51
+ const publicKeyPem = createPublicKey(privateKey)
52
+ .export({ type: "spki", format: "pem" })
53
+ .toString();
54
+ return ok({ privateKey, publicKeyPem, keyId: keyIdOf(publicKeyPem) });
55
+ }
56
+ catch (e) {
57
+ const reason = e instanceof Error ? e.message : String(e);
58
+ return err(new Error(`attest key at ${path} is not a usable private key: ${reason}`));
59
+ }
60
+ }
61
+ export function signBytes(key, bytes) {
62
+ const data = typeof bytes === "string" ? Buffer.from(bytes, "utf-8") : bytes;
63
+ // Ed25519 signs the message directly — algorithm argument is null.
64
+ return cryptoSign(null, data, key.privateKey).toString("base64");
65
+ }
66
+ export function verifyBytes(publicKeyPem, bytes, signatureB64) {
67
+ try {
68
+ const data = typeof bytes === "string" ? Buffer.from(bytes, "utf-8") : bytes;
69
+ return cryptoVerify(null, data, createPublicKey(publicKeyPem), Buffer.from(signatureB64, "base64"));
70
+ }
71
+ catch {
72
+ return false;
73
+ }
74
+ }
75
+ //# sourceMappingURL=sign.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sign.js","sourceRoot":"","sources":["../../src/attest/sign.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type Result } from "../frontmatter/types.js";
2
+ export type VerifyState = "verified" | "content-drift" | "signature-invalid" | "key-mismatch" | "malformed";
3
+ export interface VerifyReport {
4
+ state: VerifyState;
5
+ exitCode: 0 | 1 | 2 | 4;
6
+ detail: string;
7
+ keyId?: string;
8
+ identityPinned: boolean;
9
+ docs?: {
10
+ match: string[];
11
+ modified: string[];
12
+ missing: string[];
13
+ unlisted: string[];
14
+ };
15
+ headKnown?: boolean;
16
+ }
17
+ export declare function verifyBundle(bundleRaw: string, opts: {
18
+ vaultRoot?: string;
19
+ pubkeyPem?: string;
20
+ }): Promise<Result<VerifyReport, Error>>;
21
+ //# sourceMappingURL=verify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/attest/verify.ts"],"names":[],"mappings":"AAYA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAM1D,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,eAAe,GACf,mBAAmB,GACnB,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAYD,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CA+HtC"}
@@ -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