@pi-chamber/web 1.0.8-rc.1 → 1.0.8-rc.3

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 (146) hide show
  1. package/dist/assets/{AgentsSurface-BmHImX8m.js → AgentsSurface-wsW9VCRp.js} +1 -1
  2. package/dist/assets/{ChoicesArtifact-C71fGOm2.js → ChoicesArtifact-EwCf4Yxu.js} +1 -1
  3. package/dist/assets/{DiagramView-BZQxoiZu.js → DiagramView-BX6N99cQ.js} +1 -1
  4. package/dist/assets/{DiffView-C70pbgk-.js → DiffView-CI0eSnPP.js} +1 -1
  5. package/dist/assets/{FileSaveConflictDialog-Cu8c3gBV.js → FileSaveConflictDialog-GLj2W7VE.js} +1 -1
  6. package/dist/assets/{FilesView-nFJYEdRw.js → FilesView-CI0tfZQL.js} +1 -1
  7. package/dist/assets/{GitHubDetailScaffold-Jvv_tgbl.js → GitHubDetailScaffold-B85tZ9m7.js} +1 -1
  8. package/dist/assets/{GitHubLinkPicker-BXD2ODRi.js → GitHubLinkPicker-Y6AuNiGl.js} +1 -1
  9. package/dist/assets/{GitHubListPrimitives-BWI706F0.js → GitHubListPrimitives-BJHBud6i.js} +1 -1
  10. package/dist/assets/{GitView-MIDG5RYW.js → GitView-DueE69kW.js} +5 -5
  11. package/dist/assets/{IssuesSurface-uNlozeu0.js → IssuesSurface-Cg-xkdIu.js} +3 -3
  12. package/dist/assets/{JsonTreeView-CSLsTriz.js → JsonTreeView-Cvg6lc40.js} +1 -1
  13. package/dist/assets/{MarkdownRendererImpl-Cs-7BfWi.js → MarkdownRendererImpl-DExPx-QM.js} +1 -1
  14. package/dist/assets/{PatchDiff-axbsnbTJ.js → PatchDiff-_c3HZ34I.js} +1 -1
  15. package/dist/assets/{PierreDiffViewer-lwn6w_5w.js → PierreDiffViewer-CZnaqO-_.js} +1 -1
  16. package/dist/assets/{PullRequestsSurface-o_AXDjbO.js → PullRequestsSurface-C9AYPiwo.js} +2 -2
  17. package/dist/assets/{SessionSwitcherContent-C4CMlcbv.js → SessionSwitcherContent-DOpnN-8S.js} +1 -1
  18. package/dist/assets/{SessionSwitcherDropdown-DCBVuCoo.js → SessionSwitcherDropdown-CmHMPZ69.js} +2 -2
  19. package/dist/assets/{SessionUnreadDot-DyeIrsro.js → SessionUnreadDot-CZCQ4t1J.js} +1 -1
  20. package/dist/assets/SettingsView-D5PO5M3z.js +11 -0
  21. package/dist/assets/{SettingsWindow-Cb4st5y5.js → SettingsWindow-DXV5UOE8.js} +1 -1
  22. package/dist/assets/{SubagentsArtifact-BzeMEoFP.js → SubagentsArtifact-CO1ZiI1x.js} +1 -1
  23. package/dist/assets/{ToolOutputDialog-BP2mOWdV.js → ToolOutputDialog-GOwNLj-y.js} +1 -1
  24. package/dist/assets/{ToolPartDiffPreview-D49XBR9b.js → ToolPartDiffPreview-BoaiZji6.js} +1 -1
  25. package/dist/assets/{VirtualizedFileDiff-CLgDONEQ.js → VirtualizedFileDiff-Chq1X8nw.js} +1 -1
  26. package/dist/assets/VisualFrame-u7aRcX7O.js +22 -0
  27. package/dist/assets/VisualsArtifact-D9vPjihW.js +1 -0
  28. package/dist/assets/{collapsible-BeyKtQGB.js → collapsible-BjpDEohv.js} +1 -1
  29. package/dist/assets/{computeVirtualFileMetrics-DmO6H8u6.js → computeVirtualFileMetrics-DmPCxbok.js} +1 -1
  30. package/dist/assets/{contextFileOpenGuard-DOK251YW.js → contextFileOpenGuard-CukNcUeY.js} +1 -1
  31. package/dist/assets/{fileTreeStatus-CnzR7kxA.js → fileTreeStatus-CDyfNPYO.js} +1 -1
  32. package/dist/assets/{gitStatusPredicates-4kPg2t6j.js → gitStatusPredicates-uI7Y7L5k.js} +1 -1
  33. package/dist/assets/{githubLink-QvaLfNNT.js → githubLink-B9Mxac4R.js} +1 -1
  34. package/dist/assets/{index-DMX9wT1Z.js → index-BWq2ibCw.js} +1 -1
  35. package/dist/assets/index-BxKPJ9uG.js +11 -0
  36. package/dist/assets/index-C5JgjS20.css +1 -0
  37. package/dist/assets/{main-BirYxac2.js → main-CWfC-9xT.js} +4 -4
  38. package/dist/assets/{main-BW9J3Y72.js → main-ckQ0ciIN.js} +2 -2
  39. package/dist/assets/{markdownCore-CxmcPur8.js → markdownCore-p2q2Kxwo.js} +1 -1
  40. package/dist/assets/{miniChat-BRB11eEs.js → miniChat-x2TrwRYA.js} +2 -2
  41. package/dist/assets/{mobile-DJZYYCuB.js → mobile-B0x2G8h1.js} +2 -2
  42. package/dist/assets/{nativeFileSave-B6QpoPRn.js → nativeFileSave-D542OJlG.js} +1 -1
  43. package/dist/assets/{pi-session-focus-preference-PWoh3LNA.js → pi-session-focus-preference-Q_RZUCnt.js} +1 -1
  44. package/dist/assets/{renderDiffWithHighlighter-C48T6YFJ.js → renderDiffWithHighlighter-CSFGSknx.js} +1 -1
  45. package/dist/assets/{renderElectronMiniChatApp-N-BQdJl0.js → renderElectronMiniChatApp-CFIdesZT.js} +2 -2
  46. package/dist/assets/{renderFileWithHighlighter-8Kt2MyTN.js → renderFileWithHighlighter-C5JE0mRX.js} +1 -1
  47. package/dist/assets/renderMobileApp-B1ybjcGM.js +11 -0
  48. package/dist/assets/runtimeEndpointReset-DyZSKCYM.js +66 -0
  49. package/dist/assets/{runtimeSurface-kIEoYsPP.js → runtimeSurface-BR_dhe7_.js} +1 -1
  50. package/dist/assets/{selection-BTEdLRVK.js → selection-CfOpW4rA.js} +1 -1
  51. package/dist/assets/useAppFontEffects-COMvkffC.js +226 -0
  52. package/dist/assets/{useGitHubRemoteSearch-DIBHNu8r.js → useGitHubRemoteSearch-M1AE2YuX.js} +1 -1
  53. package/dist/assets/{useSwitcherItems-DfLbfX37.js → useSwitcherItems-D0i2BYYP.js} +1 -1
  54. package/dist/assets/{web-components-C_DsTJis.js → web-components-wOQkOurQ.js} +1 -1
  55. package/dist/index.html +4 -4
  56. package/dist/mini-chat.html +3 -3
  57. package/dist/mobile.html +3 -3
  58. package/package.json +1 -1
  59. package/plugins/featured.json +12 -0
  60. package/plugins/subagents/package.json +1 -1
  61. package/plugins/visuals/extension.js +8 -5
  62. package/plugins/visuals/package.json +1 -1
  63. package/server/index.js +90 -27
  64. package/server/lib/git/DOCUMENTATION.md +4 -0
  65. package/server/lib/git/service.js +70 -5
  66. package/server/lib/git/service.test.js +179 -0
  67. package/server/lib/github/DOCUMENTATION.md +2 -0
  68. package/server/lib/marketplace/DOCUMENTATION.md +95 -0
  69. package/server/lib/marketplace/featured.js +176 -0
  70. package/server/lib/marketplace/featured.test.js +207 -0
  71. package/server/lib/marketplace/npm-registry.js +255 -0
  72. package/server/lib/marketplace/npm-registry.test.js +227 -0
  73. package/server/lib/marketplace/routes.js +64 -0
  74. package/server/lib/marketplace/routes.test.js +119 -0
  75. package/server/lib/marketplace/service.js +225 -0
  76. package/server/lib/marketplace/service.test.js +174 -0
  77. package/server/lib/notifications/DOCUMENTATION.md +10 -4
  78. package/server/lib/notifications/pi-notification-watcher.js +92 -33
  79. package/server/lib/notifications/pi-notification-watcher.test.js +79 -0
  80. package/server/lib/open-url/DOCUMENTATION.md +1 -0
  81. package/server/lib/pi/merged-event-stream.js +316 -0
  82. package/server/lib/pi/merged-event-stream.test.js +95 -0
  83. package/server/lib/pi/routes-daemon-pool.test.js +348 -0
  84. package/server/lib/pi/routes-merged-events.test.js +327 -0
  85. package/server/lib/pi/routes-sandbox.test.js +1684 -0
  86. package/server/lib/pi/routes.js +491 -90
  87. package/server/lib/pi/routes.test.js +87 -2
  88. package/server/lib/pi/sandbox/DOCUMENTATION.md +68 -0
  89. package/server/lib/pi/sandbox/launcher.js +122 -0
  90. package/server/lib/pi/sandbox/launcher.test.js +91 -0
  91. package/server/lib/pi/sandbox/nono-launcher.js +455 -0
  92. package/server/lib/pi/sandbox/nono-launcher.test.js +371 -0
  93. package/server/lib/pi/sandbox/nono-profile-macos.json +20 -0
  94. package/server/lib/pi/sandbox/nono-profile-wsl2.json +21 -0
  95. package/server/lib/pi/sandbox/nono-profile.json +22 -0
  96. package/server/lib/pi/sandbox/project-sandbox-manager.js +1461 -0
  97. package/server/lib/pi/sandbox/project-sandbox-setting.js +166 -0
  98. package/server/lib/pi/sandbox/project-sandbox.js +207 -0
  99. package/server/lib/pi/sandbox/sandbox-routes.js +110 -0
  100. package/server/lib/pi/sandbox/sandboxed-folders.js +100 -0
  101. package/server/lib/pi/sandbox/sandboxed-folders.test.js +65 -0
  102. package/server/lib/pi/sandbox/trust-ask.js +135 -0
  103. package/server/lib/pi/sandbox/trust-ask.test.js +54 -0
  104. package/server/lib/pi/sandbox/worktree-ids.js +96 -0
  105. package/server/lib/pi/sandbox/worktree-ids.test.js +73 -0
  106. package/server/lib/pi/session-daemon/DOCUMENTATION.md +26 -6
  107. package/server/lib/pi/session-daemon/daemon-pool.js +157 -0
  108. package/server/lib/pi/session-daemon/daemon-process.js +10 -1
  109. package/server/lib/pi/session-daemon/extension-config.js +206 -23
  110. package/server/lib/pi/session-daemon/extension-config.test.js +180 -0
  111. package/server/lib/pi/session-daemon/session-daemon-read-persisted.test.js +167 -0
  112. package/server/lib/pi/session-daemon/session-daemon.js +368 -56
  113. package/server/lib/pi/session-daemon/session-daemon.test.js +227 -0
  114. package/server/lib/pi/session-daemon/session-idle-residency.test.js +98 -1
  115. package/server/lib/pi/session-daemon/session-jsonl.js +49 -10
  116. package/server/lib/pi/session-daemon/session-jsonl.test.js +11 -0
  117. package/server/lib/pi/session-daemon/session-lease.js +93 -15
  118. package/server/lib/pi/session-daemon/session-lease.test.js +107 -1
  119. package/server/lib/pi/session-daemon/supervisor-launcher-stop.test.js +295 -0
  120. package/server/lib/pi/session-daemon/supervisor-sandbox-nono.e2e.test.js +301 -0
  121. package/server/lib/pi/session-daemon/supervisor-sandbox.test.js +444 -0
  122. package/server/lib/pi/session-daemon/supervisor.js +386 -35
  123. package/server/lib/pi/session-daemon/supervisor.test.js +28 -0
  124. package/server/lib/pi/ui-settings-store.js +90 -3
  125. package/server/lib/pi/ui-settings-store.test.js +118 -0
  126. package/server/lib/plugins/DOCUMENTATION.md +17 -5
  127. package/server/lib/plugins/daemon-sync.js +16 -6
  128. package/server/lib/plugins/daemon-sync.test.js +12 -0
  129. package/server/lib/plugins/impact.test.js +2 -1
  130. package/server/lib/plugins/manifest.js +25 -0
  131. package/server/lib/plugins/manifest.test.js +9 -0
  132. package/server/lib/plugins/routes.test.js +28 -0
  133. package/server/lib/plugins/service.js +24 -2
  134. package/server/lib/server/cross-process-lock.js +28 -3
  135. package/server/lib/wallpaper/DOCUMENTATION.md +25 -0
  136. package/server/lib/wallpaper/routes.js +63 -0
  137. package/server/lib/wallpaper/routes.test.js +109 -0
  138. package/server/lib/wallpaper/store.js +87 -0
  139. package/dist/assets/SettingsView-BHBpt2Um.js +0 -7
  140. package/dist/assets/VisualFrame-CJrAvWSo.js +0 -22
  141. package/dist/assets/VisualsArtifact-DqLGgU-Q.js +0 -1
  142. package/dist/assets/index-B2v0_mez.js +0 -11
  143. package/dist/assets/index-D3F4JrPN.css +0 -1
  144. package/dist/assets/renderMobileApp-B7cT7m5b.js +0 -11
  145. package/dist/assets/runtimeEndpointReset-BC6yGnxN.js +0 -62
  146. package/dist/assets/useAppFontEffects-EcTZ_I_I.js +0 -225
@@ -0,0 +1,135 @@
1
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
2
+ import { readFileSync, realpathSync, statSync } from 'node:fs';
3
+ import { basename, dirname, isAbsolute, join, resolve, sep } from 'node:path';
4
+
5
+ const MAX_DIRECTORIES = 4096;
6
+
7
+ /**
8
+ * Folders whose Pi project trust was reset to "ask" when their project was
9
+ * switched from sandboxed to off (#242). A sandboxed agent may have written
10
+ * project `.pi` extensions; PiChamber's automatic trust of known projects
11
+ * must not trust them again unasked. The list lives in PiChamber's data
12
+ * folder, which no sandbox can write, and an explicit trust decision for a
13
+ * folder removes it.
14
+ */
15
+ export const trustAskFile = (dataDir) => join(dataDir, 'pi', 'trust-ask.json');
16
+
17
+ const normalizeList = (value) => {
18
+ if (!value || typeof value !== 'object' || !Array.isArray(value.directories)) return null;
19
+ if (!value.directories.every((dir) => typeof dir === 'string' && isAbsolute(dir))) return null;
20
+ return value.directories.map((dir) => resolve(dir));
21
+ };
22
+
23
+ const inside = (root, directory) => directory === root
24
+ || directory.startsWith(root.endsWith(sep) ? root : `${root}${sep}`);
25
+
26
+ export const createTrustAskStore = ({ dataDir, file = trustAskFile(dataDir) }) => {
27
+ let queue = Promise.resolve();
28
+ // Missing means nothing is recorded. A file that exists but cannot be read
29
+ // or parsed throws: reading it as empty and writing on top of it would
30
+ // forget folders whose trust was reset, and they would be trusted again.
31
+ const read = async () => {
32
+ let raw;
33
+ try {
34
+ raw = await readFile(file, 'utf8');
35
+ } catch (error) {
36
+ if (error?.code === 'ENOENT') return [];
37
+ throw Object.assign(new Error('The trust-ask list is unreadable.'), { code: 'TRUST_ASK_UNREADABLE' });
38
+ }
39
+ let parsed = null;
40
+ try {
41
+ parsed = normalizeList(JSON.parse(raw));
42
+ } catch {
43
+ parsed = null;
44
+ }
45
+ if (!parsed) throw Object.assign(new Error('The trust-ask list is unreadable.'), { code: 'TRUST_ASK_UNREADABLE' });
46
+ return parsed;
47
+ };
48
+ const write = async (directories) => {
49
+ await mkdir(dirname(file), { recursive: true, mode: 0o700 });
50
+ const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
51
+ await writeFile(temp, `${JSON.stringify({ version: 1, directories }, null, 2)}\n`, { mode: 0o600 });
52
+ await rename(temp, file);
53
+ };
54
+ const update = (change) => {
55
+ const run = queue.then(async () => {
56
+ const current = await read();
57
+ const next = change(current);
58
+ if (next === current) return;
59
+ // A full list refuses new folders instead of forgetting old ones:
60
+ // a forgotten folder would be trusted again without being asked.
61
+ if (next.length > MAX_DIRECTORIES && next.length > current.length) {
62
+ throw Object.assign(new Error('The trust-ask list is full.'), { code: 'TRUST_ASK_FULL' });
63
+ }
64
+ await write(next);
65
+ });
66
+ queue = run.catch(() => {});
67
+ return run;
68
+ };
69
+ return {
70
+ list: read,
71
+ add: (directories) => update((current) => {
72
+ const additions = directories.filter((dir) => typeof dir === 'string' && isAbsolute(dir)).map((dir) => resolve(dir))
73
+ .filter((dir) => !current.includes(dir));
74
+ return additions.length > 0 ? [...current, ...additions] : current;
75
+ }),
76
+ remove: (directory) => update((current) => {
77
+ if (typeof directory !== 'string' || !isAbsolute(directory)) return current;
78
+ const target = resolve(directory);
79
+ return current.includes(target) ? current.filter((dir) => dir !== target) : current;
80
+ }),
81
+ };
82
+ };
83
+
84
+ /**
85
+ * Daemon-side check, synchronous because Pi's trust store is: whether
86
+ * `directory` (or a folder containing it) must stay "ask". Reread only when
87
+ * the file changes. A malformed or unreadable file counts as every folder.
88
+ * Folders are compared by their written and their real path, so a symlinked
89
+ * spelling of a listed folder still asks.
90
+ */
91
+ export const createTrustAskReader = ({ dataDir, file = dataDir ? trustAskFile(dataDir) : null } = {}) => {
92
+ let cachedStamp = null;
93
+ let cached = [];
94
+ const load = () => {
95
+ if (!file) return [];
96
+ let stamp;
97
+ try {
98
+ const info = statSync(file);
99
+ stamp = `${info.ino}:${info.size}:${info.mtimeMs}`;
100
+ } catch (error) {
101
+ cachedStamp = null;
102
+ cached = [];
103
+ return error?.code === 'ENOENT' ? [] : null;
104
+ }
105
+ if (stamp === cachedStamp) return cached;
106
+ try {
107
+ cached = normalizeList(JSON.parse(readFileSync(file, 'utf8')));
108
+ } catch {
109
+ cached = null;
110
+ }
111
+ cachedStamp = stamp;
112
+ return cached;
113
+ };
114
+ return (directory) => {
115
+ const list = load();
116
+ if (list === null) return true;
117
+ if (typeof directory !== 'string' || directory.length === 0) return true;
118
+ const target = resolve(directory);
119
+ if (list.some((root) => inside(root, target))) return true;
120
+ // The real path of the nearest folder that exists, plus the rest, so a
121
+ // symlinked spelling of a folder that is not there yet still matches.
122
+ let real = target;
123
+ let rest = '';
124
+ for (let probe = target; ; probe = dirname(probe)) {
125
+ try {
126
+ real = join(realpathSync(probe), rest);
127
+ break;
128
+ } catch {
129
+ if (dirname(probe) === probe) break;
130
+ rest = rest ? join(basename(probe), rest) : basename(probe);
131
+ }
132
+ }
133
+ return real !== target && list.some((root) => inside(root, real));
134
+ };
135
+ };
@@ -0,0 +1,54 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { mkdir, mkdtemp, readFile, symlink, writeFile } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+
6
+ import { createTrustAskReader, createTrustAskStore, trustAskFile } from './trust-ask.js';
7
+
8
+ describe('trust reset list', () => {
9
+ it('records folders, clears one on an explicit decision, and the daemon reader matches folders inside them', async () => {
10
+ const dataDir = await mkdtemp(join(tmpdir(), 'pichamber-trust-ask-'));
11
+ const store = createTrustAskStore({ dataDir });
12
+ const isAsk = createTrustAskReader({ dataDir });
13
+ expect(await store.list()).toEqual([]);
14
+ expect(isAsk('/work/a')).toBe(false);
15
+
16
+ await Promise.all([store.add(['/work/a', '/work/b']), store.add(['/work/a', 'relative'])]);
17
+ expect(await store.list()).toEqual(['/work/a', '/work/b']);
18
+ expect(isAsk('/work/a')).toBe(true);
19
+ expect(isAsk('/work/a/src')).toBe(true);
20
+ expect(isAsk('/work/ab')).toBe(false);
21
+
22
+ await store.remove('/work/a');
23
+ expect(await store.list()).toEqual(['/work/b']);
24
+ expect(isAsk('/work/a')).toBe(false);
25
+ });
26
+
27
+ it('treats an unreadable list as every folder, and a write refuses to replace it', async () => {
28
+ const dataDir = await mkdtemp(join(tmpdir(), 'pichamber-trust-ask-bad-'));
29
+ await mkdir(join(dataDir, 'pi'), { recursive: true });
30
+ for (const raw of ['not json', '{"directories":["relative"]}', '[]']) {
31
+ await writeFile(trustAskFile(dataDir), raw);
32
+ expect(createTrustAskReader({ dataDir })('/anything')).toBe(true);
33
+ const store = createTrustAskStore({ dataDir });
34
+ await expect(store.list()).rejects.toMatchObject({ code: 'TRUST_ASK_UNREADABLE' });
35
+ await expect(store.add(['/work/c'])).rejects.toMatchObject({ code: 'TRUST_ASK_UNREADABLE' });
36
+ await expect(store.remove('/work/c')).rejects.toMatchObject({ code: 'TRUST_ASK_UNREADABLE' });
37
+ expect(await readFile(trustAskFile(dataDir), 'utf8')).toBe(raw);
38
+ }
39
+ });
40
+
41
+ it('keeps earlier entries when the file is repaired, and asks for a symlinked spelling', async () => {
42
+ const dataDir = await mkdtemp(join(tmpdir(), 'pichamber-trust-ask-link-'));
43
+ const real = await mkdtemp(join(tmpdir(), 'pichamber-trust-ask-real-'));
44
+ const link = join(dataDir, 'link');
45
+ await symlink(real, link);
46
+ const store = createTrustAskStore({ dataDir });
47
+ await store.add([real]);
48
+ const isAsk = createTrustAskReader({ dataDir });
49
+ expect(isAsk(real)).toBe(true);
50
+ expect(isAsk(link)).toBe(true);
51
+ expect(isAsk(join(link, 'src'))).toBe(true);
52
+ expect(isAsk(dataDir)).toBe(false);
53
+ });
54
+ });
@@ -0,0 +1,96 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
3
+ import { dirname, isAbsolute, join, resolve } from 'node:path';
4
+
5
+ const MAX_PROJECTS = 4096;
6
+ const GIT_PROJECT_ID = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
7
+
8
+ /**
9
+ * The worktree folder id of each sandboxed project, remembered the first
10
+ * time PiChamber sees it (#242). The id comes from `<project>/.git/pichamber`,
11
+ * which a sandboxed agent can rewrite or delete; a project's worktree root is
12
+ * what its sandbox daemon owns and is granted, so the id must not follow
13
+ * that file once it is known. The record lives in PiChamber's data folder,
14
+ * which no sandbox can write.
15
+ */
16
+ /** A worktree folder id no other project has: a hash of the project's path. */
17
+ export const ownWorktreeId = (projectRoot) => createHash('sha256')
18
+ .update(`pichamber-worktrees\n${resolve(projectRoot)}`).digest('hex');
19
+
20
+ export const worktreeIdsFile = (dataDir) => join(dataDir, 'pi', 'sandbox', 'worktree-ids.json');
21
+
22
+ const normalize = (value) => {
23
+ const projects = value && typeof value === 'object' && !Array.isArray(value) ? value.projects : null;
24
+ if (!projects || typeof projects !== 'object' || Array.isArray(projects)) return null;
25
+ const result = new Map();
26
+ for (const [root, id] of Object.entries(projects)) {
27
+ if (!isAbsolute(root) || typeof id !== 'string' || !GIT_PROJECT_ID.test(id)) return null;
28
+ result.set(resolve(root), id);
29
+ }
30
+ return result;
31
+ };
32
+
33
+ export const createWorktreeIdStore = ({ dataDir, file = worktreeIdsFile(dataDir) }) => {
34
+ let queue = Promise.resolve();
35
+ // Missing means nothing is remembered yet. A file that exists but cannot
36
+ // be read or parsed throws: forgetting an id would hand its worktrees to
37
+ // the main daemon.
38
+ const read = async () => {
39
+ let raw;
40
+ try {
41
+ raw = await readFile(file, 'utf8');
42
+ } catch (error) {
43
+ if (error?.code === 'ENOENT') return new Map();
44
+ throw Object.assign(new Error('The worktree id record is unreadable.'), { code: 'SANDBOX_WORKTREE_IDS_UNREADABLE' });
45
+ }
46
+ let parsed = null;
47
+ try {
48
+ parsed = normalize(JSON.parse(raw));
49
+ } catch {
50
+ parsed = null;
51
+ }
52
+ if (!parsed) throw Object.assign(new Error('The worktree id record is unreadable.'), { code: 'SANDBOX_WORKTREE_IDS_UNREADABLE' });
53
+ return parsed;
54
+ };
55
+ const write = async (projects) => {
56
+ await mkdir(dirname(file), { recursive: true, mode: 0o700 });
57
+ const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
58
+ await writeFile(temp, `${JSON.stringify({ version: 1, projects: Object.fromEntries(projects) }, null, 2)}\n`, { mode: 0o600 });
59
+ await rename(temp, file);
60
+ };
61
+ return {
62
+ /** Remembered ids, project root -> id. Throws when the record is unreadable. */
63
+ read,
64
+ /**
65
+ * Remember a worktree folder id for `projectRoot` unless one is
66
+ * remembered already; returns the id that is remembered afterwards.
67
+ * `id` (from the project's file) is taken only when no other project
68
+ * uses it: not one in `taken` (the ids of the other known projects) and
69
+ * not one remembered for another root. Two clones of one repository
70
+ * have the same file id, and a sandbox must not be granted a folder
71
+ * another project's worktrees are in. Otherwise, and for a project with
72
+ * no file id yet, the id is the project's own, made from its path.
73
+ */
74
+ remember: (projectRoot, id, { taken = [] } = {}) => {
75
+ const run = queue.then(async () => {
76
+ const root = resolve(projectRoot);
77
+ const current = await read();
78
+ const known = current.get(root);
79
+ if (known) return known;
80
+ // A full record takes no new project: dropping an older one would
81
+ // let that project's file name a new id on its next use.
82
+ if (current.size >= MAX_PROJECTS) {
83
+ throw Object.assign(new Error('The worktree id record is full.'), { code: 'SANDBOX_WORKTREE_IDS_FULL' });
84
+ }
85
+ const free = typeof id === 'string' && GIT_PROJECT_ID.test(id)
86
+ && !taken.includes(id) && ![...current.values()].includes(id);
87
+ const next = free ? id : ownWorktreeId(root);
88
+ current.set(root, next);
89
+ await write(current);
90
+ return next;
91
+ });
92
+ queue = run.catch(() => {});
93
+ return run;
94
+ },
95
+ };
96
+ };
@@ -0,0 +1,73 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { mkdir, mkdtemp, readFile, writeFile } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { dirname, join } from 'node:path';
5
+
6
+ import { createWorktreeIdStore, ownWorktreeId, worktreeIdsFile } from './worktree-ids.js';
7
+
8
+ const setup = async () => {
9
+ const dataDir = await mkdtemp(join(tmpdir(), 'pichamber-worktree-ids-'));
10
+ return { dataDir, file: worktreeIdsFile(dataDir), store: createWorktreeIdStore({ dataDir }) };
11
+ };
12
+
13
+ const A = 'a'.repeat(40);
14
+ const B = 'b'.repeat(64);
15
+
16
+ describe('remembered worktree ids', () => {
17
+ it('keeps the first id seen for a project, whatever is offered later', async () => {
18
+ const { store, file } = await setup();
19
+ expect(await store.remember('/code/app', A)).toBe(A);
20
+ expect(await store.remember('/code/app', B)).toBe(A);
21
+ expect(await store.remember('/code/app/', null)).toBe(A);
22
+ expect(await store.remember('/code/other', B)).toBe(B);
23
+ expect(JSON.parse(await readFile(file, 'utf8'))).toEqual({ version: 1, projects: { '/code/app': A, '/code/other': B } });
24
+ });
25
+
26
+ it('gives a project its own id for a missing id or one that is not a git object id', async () => {
27
+ const { store } = await setup();
28
+ for (const [index, id] of [null, '', '../../etc', 'A'.repeat(40), 'a'.repeat(39)].entries()) {
29
+ const root = `/code/app-${index}`;
30
+ expect(await store.remember(root, id)).toBe(ownWorktreeId(root));
31
+ }
32
+ expect(ownWorktreeId('/code/app-0')).toMatch(/^[0-9a-f]{64}$/);
33
+ expect(ownWorktreeId('/code/app-0')).not.toBe(ownWorktreeId('/code/app-1'));
34
+ });
35
+
36
+ it('never remembers an id another project uses', async () => {
37
+ const { store } = await setup();
38
+ expect(await store.remember('/code/app', A)).toBe(A);
39
+ // A second clone: the id is remembered for another root already.
40
+ expect(await store.remember('/code/app-review', A)).toBe(ownWorktreeId('/code/app-review'));
41
+ // A clone that is not sandboxed holds the id (`taken`).
42
+ expect(await store.remember('/code/third', B, { taken: [B] })).toBe(ownWorktreeId('/code/third'));
43
+ expect(await store.remember('/code/fourth', B)).toBe(B);
44
+ });
45
+
46
+ it('keeps concurrent first sights apart', async () => {
47
+ const { store } = await setup();
48
+ expect(await Promise.all([store.remember('/code/app', A), store.remember('/code/app', B)])).toEqual([A, A]);
49
+ });
50
+
51
+ it('throws on a record it cannot parse instead of forgetting the ids', async () => {
52
+ const { store, file } = await setup();
53
+ await mkdir(dirname(file), { recursive: true });
54
+ for (const raw of ['{', '[]', JSON.stringify({ projects: { 'code/app': A } }), JSON.stringify({ projects: { '/code/app': '../x' } })]) {
55
+ await writeFile(file, raw);
56
+ await expect(store.read()).rejects.toMatchObject({ code: 'SANDBOX_WORKTREE_IDS_UNREADABLE' });
57
+ await expect(store.remember('/code/app', A)).rejects.toMatchObject({ code: 'SANDBOX_WORKTREE_IDS_UNREADABLE' });
58
+ }
59
+ });
60
+
61
+ it('takes no new project when the record is full, and forgets none', async () => {
62
+ const { store, file } = await setup();
63
+ await mkdir(dirname(file), { recursive: true });
64
+ const projects = Object.fromEntries(Array.from({ length: 4096 }, (_, index) => [`/code/p${index}`, A]));
65
+ await writeFile(file, JSON.stringify({ version: 1, projects }));
66
+ await expect(store.remember('/code/new', B)).rejects.toMatchObject({ code: 'SANDBOX_WORKTREE_IDS_FULL' });
67
+ const saved = JSON.parse(await readFile(file, 'utf8')).projects;
68
+ expect(Object.keys(saved)).toHaveLength(4096);
69
+ expect(saved['/code/p0']).toBe(A);
70
+ // A project already in it is still answered.
71
+ expect(await store.remember('/code/p0', B)).toBe(A);
72
+ });
73
+ });