@indigoai-us/hq-cloud 6.16.37 → 6.16.39

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 (154) hide show
  1. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  2. package/dist/bin/sync-runner-watch-loop.js +9 -9
  3. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  4. package/dist/bin/sync-runner.test.js +3 -3
  5. package/dist/bin/sync-runner.test.js.map +1 -1
  6. package/dist/cli/share.d.ts.map +1 -1
  7. package/dist/cli/share.js +28 -27
  8. package/dist/cli/share.js.map +1 -1
  9. package/dist/cli/share.test.js +53 -0
  10. package/dist/cli/share.test.js.map +1 -1
  11. package/dist/cli/sync.d.ts.map +1 -1
  12. package/dist/cli/sync.js +9 -9
  13. package/dist/cli/sync.js.map +1 -1
  14. package/dist/journal-area-ledger-read-boundary.test.d.ts +2 -0
  15. package/dist/journal-area-ledger-read-boundary.test.d.ts.map +1 -0
  16. package/dist/journal-area-ledger-read-boundary.test.js +420 -0
  17. package/dist/journal-area-ledger-read-boundary.test.js.map +1 -0
  18. package/dist/journal-record-proxy.d.ts +12 -2
  19. package/dist/journal-record-proxy.d.ts.map +1 -1
  20. package/dist/journal-record-proxy.js +8 -1
  21. package/dist/journal-record-proxy.js.map +1 -1
  22. package/dist/journal-row-store.d.ts +64 -0
  23. package/dist/journal-row-store.d.ts.map +1 -1
  24. package/dist/journal-row-store.js +144 -8
  25. package/dist/journal-row-store.js.map +1 -1
  26. package/dist/journal-row-store.test.js +150 -1
  27. package/dist/journal-row-store.test.js.map +1 -1
  28. package/dist/journal-snapshot-memory-helpers.d.ts +3 -0
  29. package/dist/journal-snapshot-memory-helpers.d.ts.map +1 -1
  30. package/dist/journal-snapshot-memory-helpers.js +3 -3
  31. package/dist/journal-snapshot-memory-helpers.js.map +1 -1
  32. package/dist/journal-snapshot-rows.d.ts +17 -1
  33. package/dist/journal-snapshot-rows.d.ts.map +1 -1
  34. package/dist/journal-snapshot-rows.js +18 -0
  35. package/dist/journal-snapshot-rows.js.map +1 -1
  36. package/dist/journal-snapshot-v4.d.ts +3 -2
  37. package/dist/journal-snapshot-v4.d.ts.map +1 -1
  38. package/dist/journal-snapshot-v4.js +9 -3
  39. package/dist/journal-snapshot-v4.js.map +1 -1
  40. package/dist/journal-snapshot-v4.test.js +1 -0
  41. package/dist/journal-snapshot-v4.test.js.map +1 -1
  42. package/dist/journal.d.ts +35 -0
  43. package/dist/journal.d.ts.map +1 -1
  44. package/dist/journal.js +342 -66
  45. package/dist/journal.js.map +1 -1
  46. package/dist/journal.test.js +58 -1
  47. package/dist/journal.test.js.map +1 -1
  48. package/dist/manifest/build-manifest-resident-parity.test.d.ts +2 -0
  49. package/dist/manifest/build-manifest-resident-parity.test.d.ts.map +1 -0
  50. package/dist/manifest/build-manifest-resident-parity.test.js +68 -0
  51. package/dist/manifest/build-manifest-resident-parity.test.js.map +1 -0
  52. package/dist/manifest/build-manifest.bench.test.js +262 -2
  53. package/dist/manifest/build-manifest.bench.test.js.map +1 -1
  54. package/dist/manifest/build-manifest.d.ts +15 -0
  55. package/dist/manifest/build-manifest.d.ts.map +1 -1
  56. package/dist/manifest/build-manifest.js +39 -8
  57. package/dist/manifest/build-manifest.js.map +1 -1
  58. package/dist/manifest/build-manifest.test.js +8 -0
  59. package/dist/manifest/build-manifest.test.js.map +1 -1
  60. package/dist/outposts/command.d.ts +1 -0
  61. package/dist/outposts/command.d.ts.map +1 -1
  62. package/dist/outposts/command.js +6 -0
  63. package/dist/outposts/command.js.map +1 -1
  64. package/dist/outposts/session-host-auth.d.ts +70 -0
  65. package/dist/outposts/session-host-auth.d.ts.map +1 -0
  66. package/dist/outposts/session-host-auth.js +166 -0
  67. package/dist/outposts/session-host-auth.js.map +1 -0
  68. package/dist/outposts/session-host-auth.test.d.ts +16 -0
  69. package/dist/outposts/session-host-auth.test.d.ts.map +1 -0
  70. package/dist/outposts/session-host-auth.test.js +284 -0
  71. package/dist/outposts/session-host-auth.test.js.map +1 -0
  72. package/dist/outposts/session-host-command.d.ts +42 -0
  73. package/dist/outposts/session-host-command.d.ts.map +1 -0
  74. package/dist/outposts/session-host-command.js +223 -0
  75. package/dist/outposts/session-host-command.js.map +1 -0
  76. package/dist/outposts/session-host-command.test.d.ts +10 -0
  77. package/dist/outposts/session-host-command.test.d.ts.map +1 -0
  78. package/dist/outposts/session-host-command.test.js +98 -0
  79. package/dist/outposts/session-host-command.test.js.map +1 -0
  80. package/dist/outposts/session-host-connection.d.ts +44 -0
  81. package/dist/outposts/session-host-connection.d.ts.map +1 -0
  82. package/dist/outposts/session-host-connection.js +227 -0
  83. package/dist/outposts/session-host-connection.js.map +1 -0
  84. package/dist/outposts/session-host-connection.test.d.ts +18 -0
  85. package/dist/outposts/session-host-connection.test.d.ts.map +1 -0
  86. package/dist/outposts/session-host-connection.test.js +392 -0
  87. package/dist/outposts/session-host-connection.test.js.map +1 -0
  88. package/dist/outposts/session-host-fakes.d.ts +61 -0
  89. package/dist/outposts/session-host-fakes.d.ts.map +1 -0
  90. package/dist/outposts/session-host-fakes.js +115 -0
  91. package/dist/outposts/session-host-fakes.js.map +1 -0
  92. package/dist/outposts/session-host-ndjson.d.ts +30 -0
  93. package/dist/outposts/session-host-ndjson.d.ts.map +1 -0
  94. package/dist/outposts/session-host-ndjson.js +64 -0
  95. package/dist/outposts/session-host-ndjson.js.map +1 -0
  96. package/dist/outposts/session-host-ndjson.test.d.ts +11 -0
  97. package/dist/outposts/session-host-ndjson.test.d.ts.map +1 -0
  98. package/dist/outposts/session-host-ndjson.test.js +73 -0
  99. package/dist/outposts/session-host-ndjson.test.js.map +1 -0
  100. package/dist/outposts/session-host-protocol.d.ts +137 -0
  101. package/dist/outposts/session-host-protocol.d.ts.map +1 -0
  102. package/dist/outposts/session-host-protocol.js +244 -0
  103. package/dist/outposts/session-host-protocol.js.map +1 -0
  104. package/dist/outposts/session-host-protocol.test.d.ts +15 -0
  105. package/dist/outposts/session-host-protocol.test.d.ts.map +1 -0
  106. package/dist/outposts/session-host-protocol.test.js +0 -0
  107. package/dist/outposts/session-host-protocol.test.js.map +1 -0
  108. package/dist/outposts/session-host-server.d.ts +25 -0
  109. package/dist/outposts/session-host-server.d.ts.map +1 -0
  110. package/dist/outposts/session-host-server.js +66 -0
  111. package/dist/outposts/session-host-server.js.map +1 -0
  112. package/dist/outposts/session-host-server.test.d.ts +10 -0
  113. package/dist/outposts/session-host-server.test.d.ts.map +1 -0
  114. package/dist/outposts/session-host-server.test.js +118 -0
  115. package/dist/outposts/session-host-server.test.js.map +1 -0
  116. package/dist/outposts/session-host-sessions.d.ts +144 -0
  117. package/dist/outposts/session-host-sessions.d.ts.map +1 -0
  118. package/dist/outposts/session-host-sessions.js +336 -0
  119. package/dist/outposts/session-host-sessions.js.map +1 -0
  120. package/dist/outposts/session-host-sessions.test.d.ts +18 -0
  121. package/dist/outposts/session-host-sessions.test.d.ts.map +1 -0
  122. package/dist/outposts/session-host-sessions.test.js +439 -0
  123. package/dist/outposts/session-host-sessions.test.js.map +1 -0
  124. package/dist/packed-journal-phase2.test.d.ts +2 -0
  125. package/dist/packed-journal-phase2.test.d.ts.map +1 -0
  126. package/dist/packed-journal-phase2.test.js +273 -0
  127. package/dist/packed-journal-phase2.test.js.map +1 -0
  128. package/dist/personal-vault.d.ts.map +1 -1
  129. package/dist/personal-vault.js +6 -4
  130. package/dist/personal-vault.js.map +1 -1
  131. package/dist/remote-pull.d.ts.map +1 -1
  132. package/dist/remote-pull.js +9 -8
  133. package/dist/remote-pull.js.map +1 -1
  134. package/dist/scope-shrink.js +2 -2
  135. package/dist/scope-shrink.js.map +1 -1
  136. package/dist/session-log-retention.d.ts.map +1 -1
  137. package/dist/session-log-retention.js +2 -2
  138. package/dist/session-log-retention.js.map +1 -1
  139. package/dist/sync/area-ledger-migration.d.ts +13 -6
  140. package/dist/sync/area-ledger-migration.d.ts.map +1 -1
  141. package/dist/sync/area-ledger-migration.js +50 -16
  142. package/dist/sync/area-ledger-migration.js.map +1 -1
  143. package/dist/sync/area-ledger-migration.test.js +23 -0
  144. package/dist/sync/area-ledger-migration.test.js.map +1 -1
  145. package/dist/sync/area-ledger.d.ts +31 -1
  146. package/dist/sync/area-ledger.d.ts.map +1 -1
  147. package/dist/sync/area-ledger.js +385 -88
  148. package/dist/sync/area-ledger.js.map +1 -1
  149. package/dist/sync/area-ledger.test.js +127 -10
  150. package/dist/sync/area-ledger.test.js.map +1 -1
  151. package/dist/types.d.ts +2 -0
  152. package/dist/types.d.ts.map +1 -1
  153. package/dist/watcher.test.js.map +1 -1
  154. package/package.json +3 -3
@@ -0,0 +1,420 @@
1
+ import * as fs from "node:fs";
2
+ import * as os from "node:os";
3
+ import * as path from "node:path";
4
+ import * as v8 from "node:v8";
5
+ import * as vm from "node:vm";
6
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
7
+ const layoutStateReads = vi.hoisted(() => vi.fn());
8
+ vi.mock("./sync/area-ledger-migration.js", async (importOriginal) => {
9
+ const original = await importOriginal();
10
+ return {
11
+ ...original,
12
+ // Keep the real layout-state reader on the exercised path; only count its
13
+ // use from journal.ts so the assertion covers authority resolution.
14
+ readAreaLayoutState: (...args) => {
15
+ layoutStateReads();
16
+ return original.readAreaLayoutState(...args);
17
+ },
18
+ };
19
+ });
20
+ import { closeCachedAreaJournalMigration, journalDeltaForTest, listJournals, openJournalStateStoreForMigration, journalDeltaPathForTest, readJournal, readJournalForPass, readJournalSummary, releaseCachedAreaJournalMigrations, writeJournal, } from "./journal.js";
21
+ import { AreaLedgerMigration } from "./sync/area-ledger-migration.js";
22
+ import { AreaResolver } from "./sync/area-resolver.js";
23
+ import { AreaLedger } from "./sync/area-ledger.js";
24
+ import { JournalRowOverlay } from "./journal-row-store.js";
25
+ let stateDir = "";
26
+ // Keep the same definition as journal-snapshot-memory-helpers.ts: retained
27
+ // ArrayBuffers are part of the resident cost, and a single GC is too noisy.
28
+ function acquireGc() {
29
+ const existing = globalThis.gc;
30
+ if (typeof existing === "function")
31
+ return existing;
32
+ v8.setFlagsFromString("--expose-gc");
33
+ const exposed = vm.runInNewContext("gc");
34
+ v8.setFlagsFromString("--no-expose-gc");
35
+ if (typeof exposed !== "function")
36
+ throw new Error("area read memory gate requires an exposed garbage collector");
37
+ return exposed;
38
+ }
39
+ function usedBytes() {
40
+ const usage = process.memoryUsage();
41
+ return usage.heapUsed + usage.arrayBuffers;
42
+ }
43
+ function collectGarbage(collect) {
44
+ collect();
45
+ collect();
46
+ collect();
47
+ }
48
+ const areaLayout = {
49
+ format: 1,
50
+ routerVersion: 1,
51
+ areas: [
52
+ { id: "root:alpha", prefixes: ["alpha"], paths: [] },
53
+ { id: "root:beta", prefixes: ["beta"], paths: [] },
54
+ { id: "root:@files", prefixes: [], paths: [], rootFiles: true },
55
+ ],
56
+ };
57
+ function entry(index) {
58
+ return {
59
+ hash: index.toString(16).padStart(64, "0"),
60
+ size: index * 17.25,
61
+ syncedAt: new Date(1_700_000_000_000 + index).toISOString(),
62
+ direction: index % 2 === 0 ? "up" : "down",
63
+ kind: index % 3 === 0 ? "symlink" : "file",
64
+ remoteEtag: index.toString(16).padStart(32, "a"),
65
+ mtimeMs: 1_700_000_000_000 + index,
66
+ ctimeMs: 1_700_000_100_000 + index,
67
+ ...(index % 5 === 0 ? {
68
+ localDeleteIntent: {
69
+ version: 1,
70
+ remoteEtag: index.toString(16).padStart(32, "b"),
71
+ localHash: (index + 1).toString(16).padStart(64, "c"),
72
+ localKind: "file",
73
+ },
74
+ } : {}),
75
+ };
76
+ }
77
+ function journal(rows) {
78
+ const files = {};
79
+ for (let index = 0; index < rows; index += 1)
80
+ files[`alpha/row-${index}.md`] = entry(index);
81
+ return { version: "2", lastSync: "seed", files, pulls: [] };
82
+ }
83
+ function seedAreaAuthoritative(slug, rows) {
84
+ writeJournal(slug, journal(rows));
85
+ const migration = new AreaLedgerMigration({
86
+ rootDir: stateDir,
87
+ journalSlug: slug,
88
+ resolver: new AreaResolver(areaLayout),
89
+ legacyStore: openJournalStateStoreForMigration(slug),
90
+ maxRecordBytes: 32 * 1024 * 1024,
91
+ maxRowsPerRecord: rows,
92
+ });
93
+ migration.copyAndCatchUp();
94
+ // Large fixtures must not make test setup depend on wall-clock speed.
95
+ expect(migration.cutOver(Number.POSITIVE_INFINITY).phase).toBe("area-authoritative");
96
+ return migration;
97
+ }
98
+ function churn(migration, rows) {
99
+ const keys = Array.from({ length: rows }, (_, index) => `alpha/row-${index}.md`);
100
+ for (let round = 0; round < 3; round += 1) {
101
+ migration.reverseShadow({ deletes: keys });
102
+ const upserts = {};
103
+ for (let index = 0; index < rows; index += 1)
104
+ upserts[keys[index]] = entry((round + 1) * rows + index);
105
+ migration.reverseShadow({ upserts });
106
+ }
107
+ }
108
+ function measureHeldJournal(makeJournal) {
109
+ const collect = acquireGc();
110
+ collectGarbage(collect);
111
+ const baseline = usedBytes();
112
+ let held = makeJournal();
113
+ expect(Object.keys(held.files)).not.toHaveLength(0);
114
+ collectGarbage(collect);
115
+ const bytes = usedBytes() - baseline;
116
+ held = undefined;
117
+ collectGarbage(collect);
118
+ return bytes;
119
+ }
120
+ function warmFullPullPass(slug, rows) {
121
+ let pass = readJournalForPass(slug);
122
+ expect(Object.keys(pass.files)).toHaveLength(rows);
123
+ pass = undefined;
124
+ }
125
+ function measureEnumeratedRetention(slug, rows) {
126
+ const collect = acquireGc();
127
+ // `listJournals` owns a separate cached bridge from the writer used for
128
+ // churn. Refresh that bridge before the baseline so this measures wrappers
129
+ // retained by enumeration, not the aggregate it necessarily caches.
130
+ let warmed = readJournalSummary(slug);
131
+ expect(warmed).toBeDefined();
132
+ warmed = undefined;
133
+ collectGarbage(collect);
134
+ const baseline = usedBytes();
135
+ let observed = listJournals().find((candidate) => candidate.slug === slug);
136
+ expect(observed).toBeDefined();
137
+ let seen = 0;
138
+ for (const row of Object.values(observed.journal.files)) {
139
+ seen += row.size;
140
+ }
141
+ expect(Object.keys(observed.journal.files)).toHaveLength(rows);
142
+ expect(seen).toBeGreaterThan(0);
143
+ observed = undefined;
144
+ collectGarbage(collect);
145
+ return usedBytes() - baseline;
146
+ }
147
+ beforeEach(() => {
148
+ stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-area-read-boundary-"));
149
+ process.env.HQ_STATE_DIR = stateDir;
150
+ });
151
+ afterEach(() => {
152
+ releaseCachedAreaJournalMigrations();
153
+ delete process.env.HQ_STATE_DIR;
154
+ fs.rmSync(stateDir, { recursive: true, force: true });
155
+ });
156
+ describe("area-authoritative read boundaries", () => {
157
+ it.each([
158
+ {
159
+ name: "a legacy journal",
160
+ slug: "legacy-layout-read-once",
161
+ seed: (slug) => writeJournal(slug, journal(1)),
162
+ },
163
+ {
164
+ name: "an area-authoritative journal",
165
+ slug: "area-layout-read-once",
166
+ seed: (slug) => seedAreaAuthoritative(slug, 1),
167
+ },
168
+ ])("resolves area authority once for $name", ({ slug, seed }) => {
169
+ seed(slug);
170
+ layoutStateReads.mockClear();
171
+ expect(readJournal(slug).files["alpha/row-0.md"]).toEqual(entry(0));
172
+ expect(layoutStateReads).toHaveBeenCalledTimes(1);
173
+ });
174
+ it("gives listJournals and readJournalSummary the legacy path's frozen rows and isolated files map", () => {
175
+ const slug = "area-public-parity";
176
+ seedAreaAuthoritative(slug, 3);
177
+ const listed = listJournals().find((candidate) => candidate.slug === slug).journal;
178
+ const summary = readJournalSummary(slug).journal;
179
+ for (const result of [listed, summary]) {
180
+ const row = result.files["alpha/row-1.md"];
181
+ expect(Object.isFrozen(row)).toBe(true);
182
+ expect(() => { row.size = 999; }).toThrow(TypeError);
183
+ result.files["alpha/added.md"] = entry(999);
184
+ delete result.files["alpha/row-2.md"];
185
+ }
186
+ const later = readJournalSummary(slug).journal;
187
+ expect(later.files["alpha/added.md"]).toBeUndefined();
188
+ expect(later.files["alpha/row-2.md"]).toEqual(entry(2));
189
+ closeCachedAreaJournalMigration(slug);
190
+ expect(readJournal(slug).files["alpha/added.md"]).toBeUndefined();
191
+ expect(readJournal(slug).files["alpha/row-2.md"]).toEqual(entry(2));
192
+ });
193
+ it("holds less than one quarter of a detached full record while an area journal result is live", () => {
194
+ const slug = "area-transient-bound";
195
+ const rows = 20_000;
196
+ const migration = seedAreaAuthoritative(slug, rows);
197
+ const measure = () => {
198
+ // Build the owned aggregate first. The comparison is the public result,
199
+ // not an unrelated first-read cache warm-up.
200
+ migration.readAreaJournalCached();
201
+ return {
202
+ viewBytes: measureHeldJournal(() => migration.readAreaJournal()),
203
+ cloneBytes: measureHeldJournal(() => {
204
+ const cached = migration.readAreaJournalCached();
205
+ return { ...cached.journal, files: cached.rows.toRecord() };
206
+ }),
207
+ };
208
+ };
209
+ const seeded = measure();
210
+ churn(migration, rows);
211
+ // Refresh the long-lived bridge before the post-churn baseline for the
212
+ // same reason as the seeded warm-up above.
213
+ warmFullPullPass(slug, rows);
214
+ const churned = measure();
215
+ console.info(`area-read transient rows=${rows} seededViewBytes=${seeded.viewBytes} seededCloneBytes=${seeded.cloneBytes}` +
216
+ ` churnedViewBytes=${churned.viewBytes} churnedCloneBytes=${churned.cloneBytes}`);
217
+ expect(seeded.viewBytes).toBeLessThan(seeded.cloneBytes / 4);
218
+ expect(churned.viewBytes).toBeLessThan(churned.cloneBytes / 4);
219
+ }, 120_000);
220
+ it("holds less than one third of a detached full record while a full-pull journal is live", () => {
221
+ const slug = "area-full-pull-transient-bound";
222
+ const rows = 20_000;
223
+ const migration = seedAreaAuthoritative(slug, rows);
224
+ // The runner keeps the authoritative bridge warm between operations. Build
225
+ // that bridge before the baseline: a cold bridge recovery is not memory
226
+ // retained by the pass journal itself.
227
+ warmFullPullPass(slug, rows);
228
+ const measure = () => {
229
+ migration.readAreaJournalCached();
230
+ return {
231
+ passBytes: measureHeldJournal(() => readJournalForPass(slug)),
232
+ cloneBytes: measureHeldJournal(() => {
233
+ const cached = migration.readAreaJournalCached();
234
+ return { ...cached.journal, files: cached.rows.toRecord() };
235
+ }),
236
+ };
237
+ };
238
+ const seeded = measure();
239
+ churn(migration, rows);
240
+ const churned = measure();
241
+ console.info(`full-pull pass rows=${rows} seededPassBytes=${seeded.passBytes} seededPassBytesPerRow=${seeded.passBytes / rows}` +
242
+ ` seededCloneBytes=${seeded.cloneBytes} churnedPassBytes=${churned.passBytes}` +
243
+ ` churnedPassBytesPerRow=${churned.passBytes / rows} churnedCloneBytes=${churned.cloneBytes}`);
244
+ expect(seeded.passBytes).toBeLessThan(seeded.cloneBytes / 3);
245
+ expect(churned.passBytes).toBeLessThan(churned.cloneBytes / 3);
246
+ }, 120_000);
247
+ it("writes a pass journal through its registered dirty log with legacy readJournal parity", () => {
248
+ const passSlug = "area-full-pull-write-pass";
249
+ const legacySlug = "area-full-pull-write-legacy";
250
+ seedAreaAuthoritative(passSlug, 4);
251
+ seedAreaAuthoritative(legacySlug, 4);
252
+ const pass = readJournalForPass(passSlug);
253
+ expect(journalDeltaPathForTest(pass)).toBe("dirty-log");
254
+ const areaReads = vi.spyOn(AreaLedgerMigration.prototype, "readAreaJournal");
255
+ pass.files["alpha/added.md"] = entry(100);
256
+ delete pass.files["alpha/row-1.md"];
257
+ pass.lastSync = "pass-write";
258
+ writeJournal(passSlug, pass);
259
+ expect(areaReads).not.toHaveBeenCalled();
260
+ areaReads.mockRestore();
261
+ const legacy = readJournal(legacySlug);
262
+ legacy.files["alpha/added.md"] = entry(100);
263
+ delete legacy.files["alpha/row-1.md"];
264
+ legacy.lastSync = "pass-write";
265
+ writeJournal(legacySlug, legacy);
266
+ expect(readJournal(passSlug)).toEqual(readJournal(legacySlug));
267
+ });
268
+ it("keeps every full-pull checkpoint delta proportional to its three changed keys", () => {
269
+ const slug = "area-full-pull-checkpoint-work";
270
+ const rows = 30_000;
271
+ seedAreaAuthoritative(slug, rows);
272
+ const pass = readJournalForPass(slug);
273
+ // The first checkpoint verifies every inherited row once, so malformed
274
+ // historical keys are repaired before a pass can publish. Later checkpoints
275
+ // may inspect only their dirty paths; scanning the full packed base here
276
+ // would turn a full pull into rows × checkpoints work.
277
+ writeJournal(slug, pass);
278
+ const checkpoints = [
279
+ {
280
+ replace: ["alpha/row-101.md", entry(100_101)],
281
+ remove: "alpha/row-202.md",
282
+ add: ["alpha/checkpoint-one.md", entry(100_301)],
283
+ },
284
+ {
285
+ replace: ["alpha/row-303.md", entry(100_303)],
286
+ remove: "alpha/row-404.md",
287
+ add: ["alpha/checkpoint-two.md", entry(100_404)],
288
+ },
289
+ {
290
+ replace: ["alpha/row-505.md", entry(100_505)],
291
+ remove: "alpha/row-606.md",
292
+ add: ["alpha/checkpoint-three.md", entry(100_606)],
293
+ },
294
+ ];
295
+ for (const checkpoint of checkpoints) {
296
+ pass.files[checkpoint.replace[0]] = checkpoint.replace[1];
297
+ delete pass.files[checkpoint.remove];
298
+ pass.files[checkpoint.add[0]] = checkpoint.add[1];
299
+ // `writeJournal` uses this same delta builder. Seeing the 30k-row pass
300
+ // map or iterating its packed overlay here would prove a checkpoint still
301
+ // scales with total journal size; the incremental path must inspect only
302
+ // its three dirty keys.
303
+ const originalObjectKeys = Object.keys;
304
+ const enumeratedPassMapLengths = [];
305
+ const objectKeys = vi.spyOn(Object, "keys").mockImplementation((value) => {
306
+ const keys = originalObjectKeys(value);
307
+ if (value === pass.files)
308
+ enumeratedPassMapLengths.push(keys.length);
309
+ return keys;
310
+ });
311
+ const overlayKeys = vi.spyOn(JournalRowOverlay.prototype, "keys");
312
+ let delta;
313
+ let overlayKeyCalls = 0;
314
+ try {
315
+ delta = journalDeltaForTest(pass);
316
+ writeJournal(slug, pass);
317
+ }
318
+ finally {
319
+ overlayKeyCalls = overlayKeys.mock.calls.length;
320
+ objectKeys.mockRestore();
321
+ overlayKeys.mockRestore();
322
+ }
323
+ // Invariant and headroom: each checkpoint has exactly three mutations,
324
+ // and its delta builder must perform zero full-pass-map enumerations.
325
+ expect(Object.keys(delta.upserts)).toHaveLength(2);
326
+ expect(delta.deletes).toEqual([checkpoint.remove]);
327
+ expect(enumeratedPassMapLengths).toEqual([]);
328
+ expect(overlayKeyCalls).toBe(0);
329
+ }
330
+ });
331
+ it("drains the full-pull checkpoint log before the next three-key delta", () => {
332
+ const slug = "area-full-pull-checkpoint-drain";
333
+ seedAreaAuthoritative(slug, 30_000);
334
+ const pass = readJournalForPass(slug);
335
+ expect(journalDeltaPathForTest(pass)).toBe("dirty-log");
336
+ pass.files["alpha/row-701.md"] = entry(100_701);
337
+ delete pass.files["alpha/row-702.md"];
338
+ pass.files["alpha/checkpoint-first.md"] = entry(100_703);
339
+ const first = journalDeltaForTest(pass);
340
+ expect(Object.keys(first.upserts).sort()).toEqual([
341
+ "alpha/checkpoint-first.md",
342
+ "alpha/row-701.md",
343
+ ]);
344
+ expect(first.deletes).toEqual(["alpha/row-702.md"]);
345
+ writeJournal(slug, pass);
346
+ pass.files["alpha/row-704.md"] = entry(100_704);
347
+ delete pass.files["alpha/row-705.md"];
348
+ pass.files["alpha/checkpoint-second.md"] = entry(100_706);
349
+ const second = journalDeltaForTest(pass);
350
+ expect(Object.keys(second.upserts).sort()).toEqual([
351
+ "alpha/checkpoint-second.md",
352
+ "alpha/row-704.md",
353
+ ]);
354
+ expect(second.deletes).toEqual(["alpha/row-705.md"]);
355
+ });
356
+ it("isolates the pass files map while retaining immutable ledger rows", () => {
357
+ const slug = "area-full-pull-row-isolation";
358
+ const migration = seedAreaAuthoritative(slug, 3);
359
+ const pass = readJournalForPass(slug);
360
+ const cachedRow = readJournalSummary(slug).journal.files["alpha/row-1.md"];
361
+ const original = migration.readAreaJournalCached().journal.files["alpha/row-1.md"];
362
+ expect(pass.files["alpha/row-1.md"]).toEqual(cachedRow);
363
+ expect(pass.files["alpha/row-1.md"]).not.toBe(cachedRow);
364
+ expect(Object.isFrozen(pass.files["alpha/row-1.md"])).toBe(true);
365
+ expect(() => { pass.files["alpha/row-1.md"].size = 999; }).toThrow(TypeError);
366
+ delete pass.files["alpha/row-1.md"];
367
+ pass.files["alpha/row-2.md"] = entry(999);
368
+ expect(migration.readAreaJournalCached().journal.files["alpha/row-1.md"]).toEqual(original);
369
+ expect(migration.readAreaJournalCached().journal.files["alpha/row-2.md"]).toEqual(entry(2));
370
+ expect(readJournal(slug).files["alpha/row-1.md"]).toEqual(original);
371
+ expect(readJournal(slug).files["alpha/row-2.md"]).toEqual(entry(2));
372
+ });
373
+ it("does not retain per-row read wrappers after listJournals enumeration, including after write churn", () => {
374
+ const slug = "area-retention-bound";
375
+ const rows = 20_000;
376
+ const migration = seedAreaAuthoritative(slug, rows);
377
+ const seededBytes = measureEnumeratedRetention(slug, rows);
378
+ churn(migration, rows);
379
+ const churnedBytes = measureEnumeratedRetention(slug, rows);
380
+ console.info(`area-read retention rows=${rows} seededBytes=${seededBytes} seededBytesPerRow=${seededBytes / rows}` +
381
+ ` churnedBytes=${churnedBytes} churnedBytesPerRow=${churnedBytes / rows}`);
382
+ expect(seededBytes / rows).toBeLessThan(128);
383
+ expect(churnedBytes / rows).toBeLessThan(128);
384
+ }, 120_000);
385
+ it("keeps ledger and area list results record-shaped and JSON-round-trippable", () => {
386
+ const root = fs.mkdtempSync(path.join(stateDir, "ledger-"));
387
+ const ledger = AreaLedger.open({
388
+ rootDir: root,
389
+ journalSlug: "cloneable",
390
+ layoutEpoch: 1,
391
+ areaIds: ["root:alpha"],
392
+ resolveArea: () => "root:alpha",
393
+ });
394
+ ledger.append({ upserts: { "alpha/row.md": entry(1) } });
395
+ const direct = ledger.read();
396
+ expect(Object.keys(direct.files)).toEqual(["alpha/row.md"]);
397
+ expect(Object.entries(direct.files)).toEqual([["alpha/row.md", entry(1)]]);
398
+ expect(JSON.parse(JSON.stringify(direct))).toEqual({
399
+ version: "2",
400
+ lastSync: "",
401
+ files: { "alpha/row.md": entry(1) },
402
+ pulls: [],
403
+ });
404
+ const slug = "area-cloneable";
405
+ seedAreaAuthoritative(slug, 3);
406
+ const listed = listJournals().find((candidate) => candidate.slug === slug).journal;
407
+ expect(Object.keys(listed.files)).toEqual(["alpha/row-0.md", "alpha/row-1.md", "alpha/row-2.md"]);
408
+ expect(JSON.parse(JSON.stringify(listed))).toEqual({
409
+ version: "2",
410
+ lastSync: "seed",
411
+ files: {
412
+ "alpha/row-0.md": entry(0),
413
+ "alpha/row-1.md": entry(1),
414
+ "alpha/row-2.md": entry(2),
415
+ },
416
+ pulls: [],
417
+ });
418
+ });
419
+ });
420
+ //# sourceMappingURL=journal-area-ledger-read-boundary.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"journal-area-ledger-read-boundary.test.js","sourceRoot":"","sources":["../src/journal-area-ledger-read-boundary.test.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,15 @@
1
1
  import type { JournalEntry } from "./types.js";
2
- import { JournalRowStore } from "./journal-row-store.js";
2
+ /** The record operations needed at the public journal boundary. */
3
+ export interface JournalRecordRows {
4
+ readonly size?: number;
5
+ get(path: string): Readonly<JournalEntry> | undefined;
6
+ set(path: string, entry: JournalEntry): void;
7
+ delete(path: string): boolean;
8
+ has(path: string): boolean;
9
+ keys(): IterableIterator<string>;
10
+ }
11
+ /** Return the internal lazy view behind a record-compatible journal boundary. */
12
+ export declare function journalRecordRows(files: Record<string, JournalEntry>): JournalRecordRows | undefined;
3
13
  /**
4
14
  * Record-compatible public boundary over a packed row store.
5
15
  *
@@ -7,5 +17,5 @@ import { JournalRowStore } from "./journal-row-store.js";
7
17
  * Object.hasOwn and for-in need only key metadata; Object.entries and JSON
8
18
  * obtain a row through get when they actually consume its value.
9
19
  */
10
- export declare function createJournalRecordProxy(store: JournalRowStore): Record<string, JournalEntry>;
20
+ export declare function createJournalRecordProxy(store: JournalRecordRows): Record<string, JournalEntry>;
11
21
  //# sourceMappingURL=journal-record-proxy.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"journal-record-proxy.d.ts","sourceRoot":"","sources":["../src/journal-record-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAuBzD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAmC7F"}
1
+ {"version":3,"file":"journal-record-proxy.d.ts","sourceRoot":"","sources":["../src/journal-record-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACtD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAClC;AAID,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAEpG;AAuBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAqC/F"}
@@ -1,3 +1,8 @@
1
+ const rowsByRecordProxy = new WeakMap();
2
+ /** Return the internal lazy view behind a record-compatible journal boundary. */
3
+ export function journalRecordRows(files) {
4
+ return rowsByRecordProxy.get(files);
5
+ }
1
6
  function isArrayIndex(key) {
2
7
  const number = Number(key);
3
8
  return Number.isInteger(number) && number >= 0 && number < 4_294_967_295 && String(number) === key;
@@ -28,7 +33,7 @@ function ownRecordKeys(store) {
28
33
  */
29
34
  export function createJournalRecordProxy(store) {
30
35
  const target = {};
31
- return new Proxy(target, {
36
+ const proxy = new Proxy(target, {
32
37
  get(target, property, receiver) {
33
38
  if (typeof property !== "string")
34
39
  return Reflect.get(target, property, receiver);
@@ -67,5 +72,7 @@ export function createJournalRecordProxy(store) {
67
72
  };
68
73
  },
69
74
  });
75
+ rowsByRecordProxy.set(proxy, store);
76
+ return proxy;
70
77
  }
71
78
  //# sourceMappingURL=journal-record-proxy.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"journal-record-proxy.js","sourceRoot":"","sources":["../src/journal-record-proxy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"journal-record-proxy.js","sourceRoot":"","sources":["../src/journal-record-proxy.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,7 @@ export declare const JOURNAL_ENTRY_STORAGE: {
5
5
  size: "column";
6
6
  syncedAt: "column";
7
7
  direction: "column";
8
+ message: "side-table";
8
9
  kind: "column";
9
10
  createdBySub: "column";
10
11
  remoteEtag: "column";
@@ -58,6 +59,7 @@ export interface JournalRowStoreSnapshot {
58
59
  readonly removedAts: readonly (readonly [number, string])[];
59
60
  readonly removedReasons: readonly (readonly [number, NonNullable<JournalEntry["removedReason"]>])[];
60
61
  readonly localDeleteIntents: readonly (readonly [number, LocalDeleteIntent])[];
62
+ readonly messages: readonly (readonly [number, string])[];
61
63
  }
62
64
  type LocalDeleteIntent = NonNullable<JournalEntry["localDeleteIntent"]>;
63
65
  /** Compact before-image used by the dirty log to avoid retaining row objects. */
@@ -79,6 +81,65 @@ export declare class JournalRows {
79
81
  values(): IterableIterator<Readonly<JournalEntry>>;
80
82
  toRecord(): Record<string, JournalEntry>;
81
83
  }
84
+ /** The read-only portion of a journal row collection that an overlay can borrow. */
85
+ export interface JournalRowSource {
86
+ get(path: string): Readonly<JournalEntry> | undefined;
87
+ has(path: string): boolean;
88
+ keys(): IterableIterator<string>;
89
+ }
90
+ /**
91
+ * Internal journal-row surface. Callers use this instead of record indexing so
92
+ * a packed store can retain its one resident copy all the way through a pass.
93
+ */
94
+ export interface JournalRowsView extends JournalRowSource {
95
+ readonly size: number;
96
+ set(path: string, entry: JournalEntry): void;
97
+ delete(path: string): boolean;
98
+ entries(): IterableIterator<[string, Readonly<JournalEntry>]>;
99
+ values(): IterableIterator<Readonly<JournalEntry>>;
100
+ toRecord(): Record<string, JournalEntry>;
101
+ }
102
+ /** The compact before-image a record-shaped overlay needs to build a delta. */
103
+ export interface JournalRowOverlayChange {
104
+ readonly path: string;
105
+ readonly hadPrevious: boolean;
106
+ readonly previousFingerprint: number | undefined;
107
+ }
108
+ /**
109
+ * A mutable, record-compatible overlay over immutable journal rows.
110
+ *
111
+ * The base remains the one resident packed store. Only paths a caller changes
112
+ * are copied into this map, and the dirty log carries fingerprints rather than
113
+ * materialized before-images. `keys()` deliberately walks the base lazily: a
114
+ * caller that asks for all keys pays for that enumeration, but constructing an
115
+ * overlay does not.
116
+ */
117
+ export declare class JournalRowOverlay implements JournalRowsView {
118
+ private readonly base;
119
+ private readonly changes;
120
+ private readonly dirtyPaths;
121
+ private dirtyLog;
122
+ constructor(base: JournalRowSource);
123
+ get size(): number;
124
+ get(path: string): Readonly<JournalEntry> | undefined;
125
+ has(path: string): boolean;
126
+ set(path: string, entry: JournalEntry): void;
127
+ delete(path: string): boolean;
128
+ keys(): IterableIterator<string>;
129
+ entries(): IterableIterator<[string, Readonly<JournalEntry>]>;
130
+ values(): IterableIterator<Readonly<JournalEntry>>;
131
+ toRecord(): Record<string, JournalEntry>;
132
+ dirtyLogSnapshot(): readonly JournalRowOverlayChange[];
133
+ drainDirtyLog(): JournalRowOverlayChange[];
134
+ /**
135
+ * Drop rows whose delta has reached the shared store. The overlay never owns
136
+ * the base, so its caller must publish first; retaining these materialized
137
+ * replacements after a successful checkpoint would recreate a full journal
138
+ * copy over a long full-sync pass.
139
+ */
140
+ clearCommittedChanges(): void;
141
+ private recordDirty;
142
+ }
82
143
  /**
83
144
  * A struct-of-arrays store for resident journal rows. It deliberately owns no
84
145
  * file format or proxy boundary; those arrive in later journal phases.
@@ -113,6 +174,7 @@ export declare class JournalRowStore {
113
174
  private readonly removedAts;
114
175
  private readonly removedReasons;
115
176
  private readonly localDeleteIntents;
177
+ private readonly messages;
116
178
  private readonly propertyOrders;
117
179
  private readonly propertyOrderIdsByLayout;
118
180
  private dirtyLog;
@@ -134,6 +196,8 @@ export declare class JournalRowStore {
134
196
  has(path: string): boolean;
135
197
  /** Remove all rows and pending changes so the store can be reused cleanly. */
136
198
  clear(): void;
199
+ /** Replace the packed rows from a legacy record at its conversion boundary. */
200
+ replaceFromRecord(files: Readonly<Record<string, JournalEntry>>): void;
137
201
  set(path: string, entry: JournalEntry, propertyOrder?: string[]): void;
138
202
  delete(path: string): boolean;
139
203
  entries(): IterableIterator<[string, Readonly<JournalEntry>]>;