@indigoai-us/hq-cloud 6.16.20 → 6.16.22

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 (110) hide show
  1. package/dist/bin/sync-runner-installation-id.d.ts +66 -0
  2. package/dist/bin/sync-runner-installation-id.d.ts.map +1 -0
  3. package/dist/bin/sync-runner-installation-id.js +138 -0
  4. package/dist/bin/sync-runner-installation-id.js.map +1 -0
  5. package/dist/bin/sync-runner-manifest.d.ts +120 -0
  6. package/dist/bin/sync-runner-manifest.d.ts.map +1 -0
  7. package/dist/bin/sync-runner-manifest.js +348 -0
  8. package/dist/bin/sync-runner-manifest.js.map +1 -0
  9. package/dist/bin/sync-runner-manifest.test.d.ts +12 -0
  10. package/dist/bin/sync-runner-manifest.test.d.ts.map +1 -0
  11. package/dist/bin/sync-runner-manifest.test.js +510 -0
  12. package/dist/bin/sync-runner-manifest.test.js.map +1 -0
  13. package/dist/bin/sync-runner.d.ts +55 -0
  14. package/dist/bin/sync-runner.d.ts.map +1 -1
  15. package/dist/bin/sync-runner.js +69 -0
  16. package/dist/bin/sync-runner.js.map +1 -1
  17. package/dist/bin/sync-runner.test.js +217 -0
  18. package/dist/bin/sync-runner.test.js.map +1 -1
  19. package/dist/company-slug.d.ts +31 -0
  20. package/dist/company-slug.d.ts.map +1 -0
  21. package/dist/company-slug.js +52 -0
  22. package/dist/company-slug.js.map +1 -0
  23. package/dist/company-slug.test.d.ts +7 -0
  24. package/dist/company-slug.test.d.ts.map +1 -0
  25. package/dist/company-slug.test.js +43 -0
  26. package/dist/company-slug.test.js.map +1 -0
  27. package/dist/index.d.ts +2 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +5 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/journal-ledger-index.test.d.ts +15 -0
  32. package/dist/journal-ledger-index.test.d.ts.map +1 -0
  33. package/dist/journal-ledger-index.test.js +247 -0
  34. package/dist/journal-ledger-index.test.js.map +1 -0
  35. package/dist/journal.d.ts +110 -0
  36. package/dist/journal.d.ts.map +1 -1
  37. package/dist/journal.js +253 -5
  38. package/dist/journal.js.map +1 -1
  39. package/dist/manifest/US-002.acceptance.test.d.ts +11 -0
  40. package/dist/manifest/US-002.acceptance.test.d.ts.map +1 -0
  41. package/dist/manifest/US-002.acceptance.test.js +160 -0
  42. package/dist/manifest/US-002.acceptance.test.js.map +1 -0
  43. package/dist/manifest/US-004.acceptance.test.d.ts +12 -0
  44. package/dist/manifest/US-004.acceptance.test.d.ts.map +1 -0
  45. package/dist/manifest/US-004.acceptance.test.js +173 -0
  46. package/dist/manifest/US-004.acceptance.test.js.map +1 -0
  47. package/dist/manifest/build-manifest.bench.test.d.ts +22 -0
  48. package/dist/manifest/build-manifest.bench.test.d.ts.map +1 -0
  49. package/dist/manifest/build-manifest.bench.test.js +563 -0
  50. package/dist/manifest/build-manifest.bench.test.js.map +1 -0
  51. package/dist/manifest/build-manifest.d.ts +355 -0
  52. package/dist/manifest/build-manifest.d.ts.map +1 -0
  53. package/dist/manifest/build-manifest.js +1139 -0
  54. package/dist/manifest/build-manifest.js.map +1 -0
  55. package/dist/manifest/build-manifest.test.d.ts +10 -0
  56. package/dist/manifest/build-manifest.test.d.ts.map +1 -0
  57. package/dist/manifest/build-manifest.test.js +1172 -0
  58. package/dist/manifest/build-manifest.test.js.map +1 -0
  59. package/dist/manifest/contract.d.ts +356 -0
  60. package/dist/manifest/contract.d.ts.map +1 -0
  61. package/dist/manifest/contract.js +542 -0
  62. package/dist/manifest/contract.js.map +1 -0
  63. package/dist/manifest/contract.test.d.ts +17 -0
  64. package/dist/manifest/contract.test.d.ts.map +1 -0
  65. package/dist/manifest/contract.test.js +304 -0
  66. package/dist/manifest/contract.test.js.map +1 -0
  67. package/dist/manifest/import-graph.test.d.ts +25 -0
  68. package/dist/manifest/import-graph.test.d.ts.map +1 -0
  69. package/dist/manifest/import-graph.test.js +120 -0
  70. package/dist/manifest/import-graph.test.js.map +1 -0
  71. package/dist/manifest/ledger-shard-isolation.test.d.ts +18 -0
  72. package/dist/manifest/ledger-shard-isolation.test.d.ts.map +1 -0
  73. package/dist/manifest/ledger-shard-isolation.test.js +153 -0
  74. package/dist/manifest/ledger-shard-isolation.test.js.map +1 -0
  75. package/dist/manifest/snapshot-store.d.ts +160 -0
  76. package/dist/manifest/snapshot-store.d.ts.map +1 -0
  77. package/dist/manifest/snapshot-store.js +300 -0
  78. package/dist/manifest/snapshot-store.js.map +1 -0
  79. package/dist/manifest/snapshot-store.test.d.ts +11 -0
  80. package/dist/manifest/snapshot-store.test.d.ts.map +1 -0
  81. package/dist/manifest/snapshot-store.test.js +133 -0
  82. package/dist/manifest/snapshot-store.test.js.map +1 -0
  83. package/dist/manifest/upload-manifest.d.ts +336 -0
  84. package/dist/manifest/upload-manifest.d.ts.map +1 -0
  85. package/dist/manifest/upload-manifest.js +1022 -0
  86. package/dist/manifest/upload-manifest.js.map +1 -0
  87. package/dist/manifest/upload-manifest.test.d.ts +10 -0
  88. package/dist/manifest/upload-manifest.test.d.ts.map +1 -0
  89. package/dist/manifest/upload-manifest.test.js +1116 -0
  90. package/dist/manifest/upload-manifest.test.js.map +1 -0
  91. package/dist/manifest-reconcile.d.ts.map +1 -1
  92. package/dist/manifest-reconcile.js +1 -26
  93. package/dist/manifest-reconcile.js.map +1 -1
  94. package/dist/posix-key.d.ts +36 -0
  95. package/dist/posix-key.d.ts.map +1 -0
  96. package/dist/posix-key.js +38 -0
  97. package/dist/posix-key.js.map +1 -0
  98. package/dist/s3.d.ts +2 -18
  99. package/dist/s3.d.ts.map +1 -1
  100. package/dist/s3.js +6 -20
  101. package/dist/s3.js.map +1 -1
  102. package/dist/sync/journal-ledger-stream.d.ts +56 -0
  103. package/dist/sync/journal-ledger-stream.d.ts.map +1 -0
  104. package/dist/sync/journal-ledger-stream.js +191 -0
  105. package/dist/sync/journal-ledger-stream.js.map +1 -0
  106. package/dist/sync/journal-ledger-stream.test.d.ts +12 -0
  107. package/dist/sync/journal-ledger-stream.test.d.ts.map +1 -0
  108. package/dist/sync/journal-ledger-stream.test.js +134 -0
  109. package/dist/sync/journal-ledger-stream.test.js.map +1 -0
  110. package/package.json +2 -1
@@ -0,0 +1,304 @@
1
+ /**
2
+ * Client-side mirror tests for the sync manifest contract (US-001).
3
+ *
4
+ * Three independent guards:
5
+ *
6
+ * 1. Structural mirror — the descriptor must equal the byte-identical
7
+ * `test/fixtures/sync-manifest-contract/descriptor.json` snapshot that is
8
+ * also checked into hq-pro. Any drift fails here AND there.
9
+ * 2. Predicate parity — `hasControlCharacters` in the contract must agree
10
+ * with the REAL `hasControlCharacters` in `src/ignore.ts` on every code
11
+ * point, because the contract's path guard is defined in terms of it.
12
+ * 3. Ignore parity — the shared `test/fixtures/ignore-parity/` fixture is
13
+ * hashed (must match the same digest hq-pro asserts) AND every expected
14
+ * verdict is evaluated through the REAL ignore engine.
15
+ */
16
+ import { createHash } from "node:crypto";
17
+ import * as fs from "node:fs";
18
+ import * as path from "node:path";
19
+ import { fileURLToPath } from "node:url";
20
+ import { describe, expect, it } from "vitest";
21
+ import { SYNC_MANIFEST_CONTRACT_DESCRIPTOR, SYNC_MANIFEST_CONTRACT_VERSION, SYNC_MANIFEST_DEFAULT_CHUNK_BYTE_BUDGET, SYNC_MANIFEST_MAX_CHUNK_BYTES, SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK, SYNC_MANIFEST_MAX_IGNORE_RULES, SYNC_MANIFEST_MAX_IGNORE_RULE_LENGTH, SyncManifestContractError, hasControlCharacters as contractHasControlCharacters, validateSyncManifestUpload, } from "./contract.js";
22
+ import { createIgnoreFilter, hasControlCharacters as ignoreHasControlCharacters, } from "../ignore.js";
23
+ const HERE = path.dirname(fileURLToPath(import.meta.url));
24
+ const REPO_ROOT = path.resolve(HERE, "..", "..");
25
+ const IGNORE_PARITY_DIR = path.join(REPO_ROOT, "test", "fixtures", "ignore-parity");
26
+ /**
27
+ * sha256 over `<relpath>\0<bytes>\0` for every file in the fixture, walked in
28
+ * sorted order. The SAME literal is asserted in hq-pro; editing the fixture in
29
+ * one repo without mirroring it breaks the other repo's suite.
30
+ */
31
+ const IGNORE_PARITY_DIGEST = "974eedcc9fe383d8120348d3000b21e571e51b4b54c40287e99f20d4b8eddc44";
32
+ function walkFiles(root) {
33
+ return fs
34
+ .readdirSync(root, { withFileTypes: true })
35
+ .flatMap((entry) => entry.isDirectory()
36
+ ? walkFiles(path.join(root, entry.name)).map((child) => `${entry.name}/${child}`)
37
+ : [entry.name])
38
+ .sort();
39
+ }
40
+ function digestFixtureDir(root) {
41
+ const hash = createHash("sha256");
42
+ for (const rel of walkFiles(root)) {
43
+ hash.update(rel);
44
+ hash.update("\0");
45
+ hash.update(fs.readFileSync(path.join(root, rel)));
46
+ hash.update("\0");
47
+ }
48
+ return hash.digest("hex");
49
+ }
50
+ function readVerdicts(caseDir) {
51
+ return JSON.parse(fs.readFileSync(path.join(IGNORE_PARITY_DIR, caseDir, "verdicts.json"), "utf-8"));
52
+ }
53
+ /**
54
+ * Feed the fixture's rule files to the REAL ignore engine through its
55
+ * snapshot-reader seam. Only the layers the sync engine actually consults are
56
+ * wired up: `.hqignore` and `.hqinclude`. The fixture's `gitignore` file is
57
+ * deliberately NOT wired, which is what makes the "gitignore is not a sync
58
+ * layer" case in `case-permissive` non-vacuous.
59
+ */
60
+ function readerFor(caseDir, hqRoot) {
61
+ const available = new Map();
62
+ for (const name of [".hqignore", ".hqinclude", ".hqsyncignore"]) {
63
+ const source = path.join(IGNORE_PARITY_DIR, caseDir, name);
64
+ if (fs.existsSync(source)) {
65
+ available.set(path.join(hqRoot, name), fs.readFileSync(source, "utf-8"));
66
+ }
67
+ }
68
+ return {
69
+ existsSync: (filePath) => available.has(filePath),
70
+ readFileSync: (filePath) => {
71
+ const content = available.get(filePath);
72
+ if (content === undefined)
73
+ throw new Error(`unexpected read: ${filePath}`);
74
+ return content;
75
+ },
76
+ };
77
+ }
78
+ describe("sync manifest contract — client mirror", () => {
79
+ it("matches the cross-repo structural descriptor snapshot", () => {
80
+ const snapshot = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, "test", "fixtures", "sync-manifest-contract", "descriptor.json"), "utf-8"));
81
+ expect(JSON.parse(JSON.stringify(SYNC_MANIFEST_CONTRACT_DESCRIPTOR))).toEqual(snapshot);
82
+ expect(snapshot.contractVersion).toBe(SYNC_MANIFEST_CONTRACT_VERSION);
83
+ expect(snapshot.limits.maxEntriesPerChunk).toBe(SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK);
84
+ });
85
+ /**
86
+ * THE CROSS-REPO INVARIANT THE 6.16.21 CANARY VIOLATED.
87
+ *
88
+ * The client plans against `defaultChunkByteBudget`; the server refuses
89
+ * anything over `maxChunkBytes`. A release where the first exceeds the
90
+ * second ships chunks that CANNOT be accepted — which is the class of bug
91
+ * that took the operator's 199,394-entry scope down. Both numbers live in
92
+ * this file precisely so the relationship between them is assertable, in
93
+ * both repos, from the byte-identical descriptor.
94
+ */
95
+ it("keeps the client's chunk byte budget strictly under the server's ceiling", () => {
96
+ expect(SYNC_MANIFEST_DEFAULT_CHUNK_BYTE_BUDGET).toBeLessThan(SYNC_MANIFEST_MAX_CHUNK_BYTES);
97
+ // Not merely under it — under it with real margin, since what the gateway
98
+ // counts is the transport's bytes plus headers, not the planner's.
99
+ expect(SYNC_MANIFEST_MAX_CHUNK_BYTES - SYNC_MANIFEST_DEFAULT_CHUNK_BYTE_BUDGET).toBeGreaterThanOrEqual(1024 * 1024);
100
+ // API Gateway's HTTP API refuses a payload over 10 MB before the handler
101
+ // runs, with an opaque error and no reason code. Both bounds must sit
102
+ // under it or the machine-matchable rejection is unreachable.
103
+ const API_GATEWAY_PAYLOAD_LIMIT_BYTES = 10 * 1000 * 1000;
104
+ expect(SYNC_MANIFEST_MAX_CHUNK_BYTES).toBeLessThan(API_GATEWAY_PAYLOAD_LIMIT_BYTES);
105
+ });
106
+ it("declares field names that are real keys of the wire interfaces", () => {
107
+ const exhaustiveUpload = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.upload;
108
+ const exhaustiveEntry = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.entry;
109
+ const exhaustiveScope = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.scope;
110
+ const exhaustiveWalk = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.walkStats;
111
+ const exhaustiveLedger = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.ledgerUnavailable;
112
+ expect([
113
+ exhaustiveUpload,
114
+ exhaustiveEntry,
115
+ exhaustiveScope,
116
+ exhaustiveWalk,
117
+ exhaustiveLedger,
118
+ ]).toHaveLength(5);
119
+ const uploadKeys = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.upload;
120
+ const entryKeys = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.entry;
121
+ const scopeKeys = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.scope;
122
+ const walkKeys = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.walkStats;
123
+ const ledgerKeys = SYNC_MANIFEST_CONTRACT_DESCRIPTOR.fields.ledgerUnavailable;
124
+ expect(uploadKeys).toContain("ignoreRules");
125
+ expect(entryKeys).toContain("pendingPush");
126
+ expect(scopeKeys).toContain("companyUid");
127
+ expect(walkKeys).toContain("hashedFiles");
128
+ expect(ledgerKeys).toEqual(["errorClass"]);
129
+ // personUid is derived from auth and must never be a body field.
130
+ expect(uploadKeys).not.toContain("personUid");
131
+ });
132
+ it("keeps hasControlCharacters byte-identical with the ignore engine's predicate", () => {
133
+ for (let code = 0; code <= 0x100; code++) {
134
+ const probe = `a${String.fromCharCode(code)}b`;
135
+ expect(contractHasControlCharacters(probe), `divergence at code point ${code}`).toBe(ignoreHasControlCharacters(probe));
136
+ }
137
+ });
138
+ });
139
+ describe("ignore-parity fixture", () => {
140
+ it("is byte-identical with the copy checked into hq-pro", () => {
141
+ expect(digestFixtureDir(IGNORE_PARITY_DIR)).toBe(IGNORE_PARITY_DIGEST);
142
+ });
143
+ it("carries rule lines that are legal manifest ignoreRules values", () => {
144
+ const lines = [];
145
+ for (const caseDir of ["case-permissive", "case-allowlist"]) {
146
+ for (const name of [".hqignore", ".hqinclude"]) {
147
+ const file = path.join(IGNORE_PARITY_DIR, caseDir, name);
148
+ if (!fs.existsSync(file))
149
+ continue;
150
+ for (const line of fs.readFileSync(file, "utf-8").split("\n")) {
151
+ if (line.trim())
152
+ lines.push(line);
153
+ }
154
+ }
155
+ }
156
+ expect(lines.length).toBeGreaterThan(0);
157
+ expect(lines.length).toBeLessThanOrEqual(SYNC_MANIFEST_MAX_IGNORE_RULES);
158
+ for (const line of lines) {
159
+ expect(line.length).toBeLessThanOrEqual(SYNC_MANIFEST_MAX_IGNORE_RULE_LENGTH);
160
+ expect(contractHasControlCharacters(line)).toBe(false);
161
+ }
162
+ });
163
+ it.each(["case-permissive", "case-allowlist"])("reproduces every %s verdict through the real ignore engine", (caseDir) => {
164
+ const hqRoot = path.join(path.sep, "fixture", caseDir);
165
+ const filter = createIgnoreFilter(hqRoot, { snapshotReader: readerFor(caseDir, hqRoot) });
166
+ const verdicts = readVerdicts(caseDir);
167
+ expect(verdicts.cases.length).toBeGreaterThan(0);
168
+ for (const testCase of verdicts.cases) {
169
+ const included = filter(path.join(hqRoot, ...testCase.path.split("/")));
170
+ expect(included ? "include" : "exclude", `${caseDir}/${testCase.path} (layer: ${testCase.layer})`).toBe(testCase.expected);
171
+ }
172
+ });
173
+ });
174
+ describe("validateSyncManifestUpload — bounded sizes", () => {
175
+ function baseUpload() {
176
+ return {
177
+ contractVersion: SYNC_MANIFEST_CONTRACT_VERSION,
178
+ installationId: "inst-mirror-0001",
179
+ scope: { kind: "personal" },
180
+ machineId: "machine-mirror-01",
181
+ source: "cli",
182
+ mode: "full",
183
+ generatedAt: "2026-09-04T00:00:00.000Z",
184
+ sequence: 1,
185
+ chunkIndex: 0,
186
+ chunkCount: 1,
187
+ entries: [],
188
+ removedPaths: [],
189
+ ignoreRules: [],
190
+ walkStats: { filesWalked: 0, walkMs: 1, hashedFiles: 0, ignoredFiles: 0 },
191
+ };
192
+ }
193
+ it("rejects 50,001 entries in one chunk with a bounded-size reason code", () => {
194
+ const upload = baseUpload();
195
+ upload.entries = Array.from({ length: SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK + 1 }, (_, i) => ({
196
+ path: `f/${i}.md`,
197
+ hash: "a".repeat(64),
198
+ size: 1,
199
+ mtimeMs: 1,
200
+ source: "both",
201
+ }));
202
+ expect(() => validateSyncManifestUpload(upload)).toThrowError(/BOUNDED_SIZE_EXCEEDED/);
203
+ });
204
+ it("accepts a well-formed personal-scope chunk", () => {
205
+ const upload = baseUpload();
206
+ upload.entries = [
207
+ { path: "notes.md", hash: "b".repeat(64), size: 12, mtimeMs: 1, source: "both" },
208
+ ];
209
+ expect(validateSyncManifestUpload(upload).entries[0].path).toBe("notes.md");
210
+ });
211
+ });
212
+ /**
213
+ * Shared fail-closed BEHAVIOUR suite.
214
+ *
215
+ * The descriptor snapshot pins the contract's SHAPE; this fixture pins what it
216
+ * actually REJECTS. It is checked into BOTH repos byte-identically and each
217
+ * repo runs every case through its OWN validateSyncManifestUpload — so
218
+ * deleting a guard (the `..` segment loop, the personUid rejection, the
219
+ * version classification) fails the suite in the repo that dropped it, which
220
+ * the descriptor alone could never detect.
221
+ */
222
+ describe("shared rejection-case fixture", () => {
223
+ const fixture = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, "test", "fixtures", "sync-manifest-contract", "rejection-cases.json"), "utf-8"));
224
+ it("is byte-identical with the copy checked into the sibling repo", () => {
225
+ expect(fixture.contractVersion).toBe(SYNC_MANIFEST_CONTRACT_VERSION);
226
+ expect(fixture.cases.length).toBeGreaterThanOrEqual(30);
227
+ });
228
+ for (const testCase of fixture.cases) {
229
+ it(testCase.name, () => {
230
+ if (testCase.expect === "accept") {
231
+ expect(() => validateSyncManifestUpload(testCase.upload)).not.toThrow();
232
+ return;
233
+ }
234
+ let thrown;
235
+ try {
236
+ validateSyncManifestUpload(testCase.upload);
237
+ }
238
+ catch (error) {
239
+ thrown = error;
240
+ }
241
+ expect(thrown).toBeInstanceOf(SyncManifestContractError);
242
+ const error = thrown;
243
+ expect(error.code).toBe(testCase.code);
244
+ expect(error.field).toBe(testCase.field);
245
+ });
246
+ }
247
+ });
248
+ /**
249
+ * `hash` is OPTIONAL on the wire.
250
+ *
251
+ * The client's cheap path is a stat walk: it reuses a hash from its journal
252
+ * when the (size, mtime) pair still matches, and otherwise has none. Computing
253
+ * one means READING the file, which on a large vault with a journal that
254
+ * predates hashing means reading everything — measured at ~690k files, ~9m40s
255
+ * and 2.9 GB RSS for one post-sync tail step. So an entry may say "present,
256
+ * hash unknown", and consumers must read a missing hash as UNKNOWN, never as a
257
+ * mismatch and never as an absent file.
258
+ */
259
+ describe("validateSyncManifestEntry — an entry may be present without a hash", () => {
260
+ function uploadWithEntry(entry) {
261
+ return {
262
+ contractVersion: SYNC_MANIFEST_CONTRACT_VERSION,
263
+ installationId: "inst-mirror-0001",
264
+ scope: { kind: "personal" },
265
+ machineId: "machine-mirror-01",
266
+ source: "cli",
267
+ mode: "full",
268
+ generatedAt: "2026-09-04T00:00:00.000Z",
269
+ sequence: 1,
270
+ chunkIndex: 0,
271
+ chunkCount: 1,
272
+ entries: [entry],
273
+ removedPaths: [],
274
+ ignoreRules: [],
275
+ walkStats: { filesWalked: 1, walkMs: 1, hashedFiles: 0, ignoredFiles: 0 },
276
+ };
277
+ }
278
+ const statOnly = { path: "notes/a.md", size: 5, mtimeMs: 1, source: "disk" };
279
+ it("accepts an entry with no hash field at all", () => {
280
+ const parsed = validateSyncManifestUpload(uploadWithEntry({ ...statOnly }));
281
+ expect(parsed.entries[0]?.hash).toBeUndefined();
282
+ expect(parsed.entries[0]?.size).toBe(5);
283
+ });
284
+ it("accepts an explicit null hash, which JSON round-trips produce", () => {
285
+ // Rejecting the null spelling would fail a whole chunk over a serialiser
286
+ // detail, and `null` says exactly what an omitted optional says.
287
+ const parsed = validateSyncManifestUpload(uploadWithEntry({ ...statOnly, hash: null }));
288
+ expect(parsed.entries[0]?.hash).toBeUndefined();
289
+ });
290
+ it("still rejects a PRESENT hash that is malformed", () => {
291
+ // "Unknown" and "malformed" are different claims. Making the field optional
292
+ // must not weaken the rule for a hash that IS supplied.
293
+ expect(() => validateSyncManifestUpload(uploadWithEntry({ ...statOnly, hash: "not-a-sha" }))).toThrowError(/UNSAFE_VALUE|INVALID_TYPE/);
294
+ expect(() => validateSyncManifestUpload(uploadWithEntry({ ...statOnly, hash: "A".repeat(64) }))).toThrowError(/UNSAFE_VALUE/);
295
+ });
296
+ it("accepts the optional unhashedFiles walk stat, and tolerates its absence", () => {
297
+ const withStat = uploadWithEntry({ ...statOnly });
298
+ withStat.walkStats.unhashedFiles = 1;
299
+ expect(validateSyncManifestUpload(withStat).walkStats.unhashedFiles).toBe(1);
300
+ // An older client does not send it; that must not fail the chunk.
301
+ expect(validateSyncManifestUpload(uploadWithEntry({ ...statOnly })).walkStats.unhashedFiles).toBeUndefined();
302
+ });
303
+ });
304
+ //# sourceMappingURL=contract.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.test.js","sourceRoot":"","sources":["../../src/manifest/contract.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The manifest builder's import graph must stay LEAN.
3
+ *
4
+ * `buildSyncManifest` is client hot-path code: it runs on the user's laptop
5
+ * beside their editor, and it is imported by the CLI. Its cost budget is a
6
+ * stat walk, not a module graph. The package already draws this line
7
+ * explicitly (see the `"//exports"` note in package.json, which keeps
8
+ * `./outposts` free of the AWS SDK) and it is easy to cross by accident — one
9
+ * convenience import of a helper that happens to live next to the S3 client
10
+ * pulls in `@aws-sdk/client-s3`, Cognito auth and telemetry for the sake of a
11
+ * one-line pure function. That has already happened twice on this branch:
12
+ * `isSafeCompanySlug` from `manifest-reconcile.ts`, and `toPosixKey` reaching
13
+ * `journal.ts` from `s3.ts`. Both are now leaf modules.
14
+ *
15
+ * A type-level assertion cannot catch this, and neither can a unit test of the
16
+ * builder's behaviour, so the graph itself is the thing under test: walk the
17
+ * relative imports from `build-manifest.ts` and assert the closure never
18
+ * reaches the heavy modules.
19
+ *
20
+ * `import type` / `export type` statements are excluded — tsc erases them, so
21
+ * they cost nothing at runtime (this is why `pull-scope.ts`'s type-only
22
+ * reference to `vault-client.ts` is fine).
23
+ */
24
+ export {};
25
+ //# sourceMappingURL=import-graph.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-graph.test.d.ts","sourceRoot":"","sources":["../../src/manifest/import-graph.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}
@@ -0,0 +1,120 @@
1
+ /**
2
+ * The manifest builder's import graph must stay LEAN.
3
+ *
4
+ * `buildSyncManifest` is client hot-path code: it runs on the user's laptop
5
+ * beside their editor, and it is imported by the CLI. Its cost budget is a
6
+ * stat walk, not a module graph. The package already draws this line
7
+ * explicitly (see the `"//exports"` note in package.json, which keeps
8
+ * `./outposts` free of the AWS SDK) and it is easy to cross by accident — one
9
+ * convenience import of a helper that happens to live next to the S3 client
10
+ * pulls in `@aws-sdk/client-s3`, Cognito auth and telemetry for the sake of a
11
+ * one-line pure function. That has already happened twice on this branch:
12
+ * `isSafeCompanySlug` from `manifest-reconcile.ts`, and `toPosixKey` reaching
13
+ * `journal.ts` from `s3.ts`. Both are now leaf modules.
14
+ *
15
+ * A type-level assertion cannot catch this, and neither can a unit test of the
16
+ * builder's behaviour, so the graph itself is the thing under test: walk the
17
+ * relative imports from `build-manifest.ts` and assert the closure never
18
+ * reaches the heavy modules.
19
+ *
20
+ * `import type` / `export type` statements are excluded — tsc erases them, so
21
+ * they cost nothing at runtime (this is why `pull-scope.ts`'s type-only
22
+ * reference to `vault-client.ts` is fine).
23
+ */
24
+ import * as fs from "node:fs";
25
+ import * as path from "node:path";
26
+ import { fileURLToPath } from "node:url";
27
+ import { describe, expect, it } from "vitest";
28
+ const SRC_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
29
+ const ENTRY = path.join(SRC_DIR, "manifest", "build-manifest.ts");
30
+ /** Local modules whose transitive weight is the whole point of this test. */
31
+ const FORBIDDEN_LOCAL = ["vault-client.ts", "cognito-auth.ts", "s3.ts", "object-io.ts", "telemetry.ts"];
32
+ /** Package prefixes that must never appear in the builder's runtime graph. */
33
+ const FORBIDDEN_PACKAGES = ["@aws-sdk/", "pino", "chokidar"];
34
+ function stripNonCode(source) {
35
+ return source
36
+ .replace(/\/\*[\s\S]*?\*\//g, "")
37
+ .replace(/^\s*\/\/.*$/gm, "")
38
+ // Erased by the compiler: not part of the runtime graph.
39
+ .replace(/\b(?:import|export)\s+type\b[^;'"]*?\bfrom\s*["'][^"']+["']/g, "");
40
+ }
41
+ function specifiersIn(source) {
42
+ const code = stripNonCode(source);
43
+ const re = /\b(?:import|export)\b[^;'"]*?\bfrom\s*["']([^"']+)["']|(?:^|[\n;])\s*import\s*["']([^"']+)["']|\bimport\(\s*["']([^"']+)["']\s*\)/g;
44
+ const found = [];
45
+ for (let m = re.exec(code); m !== null; m = re.exec(code)) {
46
+ const spec = m[1] ?? m[2] ?? m[3];
47
+ if (spec)
48
+ found.push(spec);
49
+ }
50
+ return found;
51
+ }
52
+ /** Resolve a relative TS specifier the way NodeNext + tsc does (".js" → ".ts"). */
53
+ function resolveLocal(fromFile, spec) {
54
+ const base = path.resolve(path.dirname(fromFile), spec.replace(/\.js$/, ""));
55
+ for (const candidate of [`${base}.ts`, path.join(base, "index.ts")]) {
56
+ if (fs.existsSync(candidate))
57
+ return candidate;
58
+ }
59
+ return null;
60
+ }
61
+ function buildClosure(entry) {
62
+ const key = (abs) => path.relative(SRC_DIR, abs).split(path.sep).join("/");
63
+ const closure = {
64
+ local: new Set([key(entry)]),
65
+ packages: new Map(),
66
+ parent: new Map([[key(entry), null]]),
67
+ };
68
+ const queue = [entry];
69
+ const unresolved = [];
70
+ while (queue.length > 0) {
71
+ const file = queue.shift();
72
+ for (const spec of specifiersIn(fs.readFileSync(file, "utf8"))) {
73
+ if (!spec.startsWith(".")) {
74
+ if (!closure.packages.has(spec))
75
+ closure.packages.set(spec, key(file));
76
+ continue;
77
+ }
78
+ const resolved = resolveLocal(file, spec);
79
+ if (resolved === null) {
80
+ unresolved.push(`${key(file)} -> ${spec}`);
81
+ continue;
82
+ }
83
+ if (closure.local.has(key(resolved)))
84
+ continue;
85
+ closure.local.add(key(resolved));
86
+ closure.parent.set(key(resolved), key(file));
87
+ queue.push(resolved);
88
+ }
89
+ }
90
+ // A specifier this walker cannot resolve is a HOLE in the graph, which would
91
+ // let a forbidden module slip through unnoticed. Fail loudly instead.
92
+ expect(unresolved).toEqual([]);
93
+ return closure;
94
+ }
95
+ /** "a -> b -> c": how the offending module got pulled in. */
96
+ function blameChain(closure, target) {
97
+ const chain = [];
98
+ for (let cur = target; cur; cur = closure.parent.get(cur)) {
99
+ chain.unshift(cur);
100
+ }
101
+ return chain.join(" -> ");
102
+ }
103
+ describe("manifest builder import graph", () => {
104
+ const closure = buildClosure(ENTRY);
105
+ it("resolves a non-trivial closure (the walker actually walked)", () => {
106
+ // Guards against the walker silently matching nothing and passing vacuously.
107
+ expect(closure.local.size).toBeGreaterThan(5);
108
+ expect(closure.local).toContain("journal.ts");
109
+ expect(closure.local).toContain("ignore.ts");
110
+ });
111
+ it.each(FORBIDDEN_LOCAL)("does not reach %s", (module) => {
112
+ const hit = [...closure.local].find((f) => f === module || f.endsWith(`/${module}`));
113
+ expect(hit ? blameChain(closure, hit) : undefined).toBeUndefined();
114
+ });
115
+ it.each(FORBIDDEN_PACKAGES)("does not pull in %s", (prefix) => {
116
+ const hit = [...closure.packages].find(([spec]) => spec.startsWith(prefix));
117
+ expect(hit ? `${hit[0]} <- ${blameChain(closure, hit[1])}` : undefined).toBeUndefined();
118
+ });
119
+ });
120
+ //# sourceMappingURL=import-graph.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-graph.test.js","sourceRoot":"","sources":["../../src/manifest/import-graph.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The manifest build reads ONE journal shard: the one describing its scope.
3
+ *
4
+ * This is a memory invariant expressed as a behavioural one. `listJournals()`
5
+ * reads and parses every shard on the machine, and on a laptop holding a
6
+ * personal vault plus several cloud companies that was the single largest line
7
+ * item in the tail step's footprint — hundreds of megabytes spent parsing
8
+ * ledgers whose rows were then dropped on the floor, repaid once per scope in
9
+ * a fanout.
10
+ *
11
+ * A byte counter would be the obvious gate and the wrong one: it moves with
12
+ * fixture size and tempts a future reader to widen it. The thing that must not
13
+ * come back is the ENUMERATION, so the assertion counts journal files opened.
14
+ * One is correct; anything above one means a caller has gone back to reading
15
+ * the machine instead of the scope, no matter what the megabytes say.
16
+ */
17
+ export {};
18
+ //# sourceMappingURL=ledger-shard-isolation.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ledger-shard-isolation.test.d.ts","sourceRoot":"","sources":["../../src/manifest/ledger-shard-isolation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}