@indigoai-us/hq-cloud 6.14.23 → 6.14.25

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 (131) hide show
  1. package/dist/bin/sync-runner-company.d.ts.map +1 -1
  2. package/dist/bin/sync-runner-company.js +11 -0
  3. package/dist/bin/sync-runner-company.js.map +1 -1
  4. package/dist/bin/sync-runner-planning.d.ts +11 -0
  5. package/dist/bin/sync-runner-planning.d.ts.map +1 -1
  6. package/dist/bin/sync-runner-planning.js +37 -2
  7. package/dist/bin/sync-runner-planning.js.map +1 -1
  8. package/dist/bin/sync-runner-planning.test.js +1 -0
  9. package/dist/bin/sync-runner-planning.test.js.map +1 -1
  10. package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
  11. package/dist/bin/sync-runner-watch-loop.js +17 -1
  12. package/dist/bin/sync-runner-watch-loop.js.map +1 -1
  13. package/dist/bin/sync-runner.d.ts +6 -0
  14. package/dist/bin/sync-runner.d.ts.map +1 -1
  15. package/dist/bin/sync-runner.js +14 -2
  16. package/dist/bin/sync-runner.js.map +1 -1
  17. package/dist/bin/sync-runner.test.js +155 -1
  18. package/dist/bin/sync-runner.test.js.map +1 -1
  19. package/dist/cli/doctor.d.ts +119 -0
  20. package/dist/cli/doctor.d.ts.map +1 -0
  21. package/dist/cli/doctor.js +485 -0
  22. package/dist/cli/doctor.js.map +1 -0
  23. package/dist/cli/doctor.test.d.ts +13 -0
  24. package/dist/cli/doctor.test.d.ts.map +1 -0
  25. package/dist/cli/doctor.test.js +485 -0
  26. package/dist/cli/doctor.test.js.map +1 -0
  27. package/dist/cli/index.d.ts +2 -0
  28. package/dist/cli/index.d.ts.map +1 -1
  29. package/dist/cli/index.js +4 -0
  30. package/dist/cli/index.js.map +1 -1
  31. package/dist/cli/share.js +6 -1
  32. package/dist/cli/share.js.map +1 -1
  33. package/dist/cli/sync.d.ts +29 -0
  34. package/dist/cli/sync.d.ts.map +1 -1
  35. package/dist/cli/sync.js +140 -2
  36. package/dist/cli/sync.js.map +1 -1
  37. package/dist/cli/sync.test.js +223 -1
  38. package/dist/cli/sync.test.js.map +1 -1
  39. package/dist/cognito-auth.test.js +7 -0
  40. package/dist/cognito-auth.test.js.map +1 -1
  41. package/dist/company-resolver.d.ts +31 -1
  42. package/dist/company-resolver.d.ts.map +1 -1
  43. package/dist/company-resolver.js +329 -21
  44. package/dist/company-resolver.js.map +1 -1
  45. package/dist/company-resolver.test.js +371 -1
  46. package/dist/company-resolver.test.js.map +1 -1
  47. package/dist/index.d.ts +2 -0
  48. package/dist/index.d.ts.map +1 -1
  49. package/dist/index.js +3 -0
  50. package/dist/index.js.map +1 -1
  51. package/dist/lib/conflict-file.d.ts.map +1 -1
  52. package/dist/lib/conflict-file.js +5 -1
  53. package/dist/lib/conflict-file.js.map +1 -1
  54. package/dist/lib/conflict-index.d.ts.map +1 -1
  55. package/dist/lib/conflict-index.js +7 -2
  56. package/dist/lib/conflict-index.js.map +1 -1
  57. package/dist/lib/machine-id.test.js +14 -0
  58. package/dist/lib/machine-id.test.js.map +1 -1
  59. package/dist/local-path-codec.d.ts +18 -0
  60. package/dist/local-path-codec.d.ts.map +1 -1
  61. package/dist/local-path-codec.js +63 -0
  62. package/dist/local-path-codec.js.map +1 -1
  63. package/dist/local-path-codec.test.d.ts +14 -0
  64. package/dist/local-path-codec.test.d.ts.map +1 -0
  65. package/dist/local-path-codec.test.js +102 -0
  66. package/dist/local-path-codec.test.js.map +1 -0
  67. package/dist/machine-auth.test.js +7 -0
  68. package/dist/machine-auth.test.js.map +1 -1
  69. package/dist/s3.d.ts +5 -0
  70. package/dist/s3.d.ts.map +1 -1
  71. package/dist/s3.js +129 -3
  72. package/dist/s3.js.map +1 -1
  73. package/dist/s3.symlink-materialize.test.d.ts +18 -0
  74. package/dist/s3.symlink-materialize.test.d.ts.map +1 -0
  75. package/dist/s3.symlink-materialize.test.js +394 -0
  76. package/dist/s3.symlink-materialize.test.js.map +1 -0
  77. package/dist/s3.test.js +19 -0
  78. package/dist/s3.test.js.map +1 -1
  79. package/dist/skill-telemetry.d.ts.map +1 -1
  80. package/dist/skill-telemetry.js +24 -3
  81. package/dist/skill-telemetry.js.map +1 -1
  82. package/dist/skill-telemetry.test.js +17 -0
  83. package/dist/skill-telemetry.test.js.map +1 -1
  84. package/dist/telemetry.d.ts +10 -1
  85. package/dist/telemetry.d.ts.map +1 -1
  86. package/dist/telemetry.js +95 -4
  87. package/dist/telemetry.js.map +1 -1
  88. package/dist/telemetry.test.js +177 -0
  89. package/dist/telemetry.test.js.map +1 -1
  90. package/dist/vault-client.d.ts +42 -0
  91. package/dist/vault-client.d.ts.map +1 -1
  92. package/dist/vault-client.js +40 -0
  93. package/dist/vault-client.js.map +1 -1
  94. package/dist/watcher.d.ts.map +1 -1
  95. package/dist/watcher.js +10 -1
  96. package/dist/watcher.js.map +1 -1
  97. package/dist/watcher.test.js +28 -0
  98. package/dist/watcher.test.js.map +1 -1
  99. package/package.json +1 -1
  100. package/src/bin/sync-runner-company.ts +10 -0
  101. package/src/bin/sync-runner-planning.test.ts +1 -0
  102. package/src/bin/sync-runner-planning.ts +46 -3
  103. package/src/bin/sync-runner-watch-loop.ts +19 -1
  104. package/src/bin/sync-runner.test.ts +174 -0
  105. package/src/bin/sync-runner.ts +17 -1
  106. package/src/cli/doctor.test.ts +581 -0
  107. package/src/cli/doctor.ts +640 -0
  108. package/src/cli/index.ts +14 -0
  109. package/src/cli/share.ts +6 -1
  110. package/src/cli/sync.test.ts +281 -1
  111. package/src/cli/sync.ts +184 -2
  112. package/src/cognito-auth.test.ts +5 -0
  113. package/src/company-resolver.test.ts +432 -1
  114. package/src/company-resolver.ts +362 -23
  115. package/src/index.ts +10 -0
  116. package/src/lib/conflict-file.ts +6 -1
  117. package/src/lib/conflict-index.ts +7 -2
  118. package/src/lib/machine-id.test.ts +10 -0
  119. package/src/local-path-codec.test.ts +138 -0
  120. package/src/local-path-codec.ts +66 -0
  121. package/src/machine-auth.test.ts +5 -0
  122. package/src/s3.symlink-materialize.test.ts +492 -0
  123. package/src/s3.test.ts +24 -0
  124. package/src/s3.ts +148 -4
  125. package/src/skill-telemetry.test.ts +19 -0
  126. package/src/skill-telemetry.ts +32 -3
  127. package/src/telemetry.test.ts +241 -0
  128. package/src/telemetry.ts +124 -6
  129. package/src/vault-client.ts +68 -0
  130. package/src/watcher.test.ts +33 -0
  131. package/src/watcher.ts +10 -1
@@ -0,0 +1,394 @@
1
+ /**
2
+ * Regression tests for US-001 (hq-sync-windows-skill-symlink-collision):
3
+ * Windows-safe, idempotent symlink materialization in downloadFile.
4
+ *
5
+ * Background: the .claude/skills/<ns>:<skill> link farm is materialized from
6
+ * `hq-symlink:<target>` records. Pre-fix, downloadFile always did
7
+ * symlinkSync(temp) + renameSync(temp, dest). On Windows that is doubly
8
+ * broken: (1) rename() can never replace an existing directory — and a
9
+ * directory symlink counts as one — so every pull over the farm EPERM'd,
10
+ * never journaled, and re-downloaded forever; (2) a bare symlinkSync mints a
11
+ * FILE-type link, which is broken for directory targets on Windows.
12
+ *
13
+ * Windows semantics are exercised via the injectable `win32` option (the
14
+ * local-path-codec.ts convention) plus scripted fs fakes, so these tests are
15
+ * deterministic on POSIX CI and on a real Windows host alike.
16
+ */
17
+ import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
18
+ import * as fs from "fs";
19
+ import * as os from "os";
20
+ import * as path from "path";
21
+ // Re-export node:fs as a plain mutable object so vi.spyOn can instrument
22
+ // individual functions (the frozen ESM namespace of a builtin cannot be
23
+ // spied on directly). Every copied function still delegates to the real
24
+ // implementation until a test overrides it.
25
+ vi.mock("fs", async (importOriginal) => {
26
+ const actual = await importOriginal();
27
+ return { ...actual };
28
+ });
29
+ import { downloadFile, SYMLINK_BODY_PREFIX, SYMLINK_MARKER_META_VALUE } from "./s3.js";
30
+ import { localPathForVaultKey } from "./local-path-codec.js";
31
+ import { setObjectIOFactory } from "./object-io.js";
32
+ function makeCtx() {
33
+ return {
34
+ uid: "cmp_TEST",
35
+ slug: "acme",
36
+ bucketName: "hq-vault-acme-123",
37
+ region: "us-east-1",
38
+ credentials: {
39
+ accessKeyId: "ASIA_TEST",
40
+ secretAccessKey: "secret",
41
+ sessionToken: "session",
42
+ },
43
+ expiresAt: new Date(Date.now() + 15 * 60 * 1000).toISOString(),
44
+ };
45
+ }
46
+ /** ObjectIO stub serving a single symlink record (marker + prefixed body). */
47
+ function symlinkRecordIO(target) {
48
+ return {
49
+ putObject: async () => ({ etag: '"unused"' }),
50
+ getObject: async () => ({
51
+ body: Buffer.from(SYMLINK_BODY_PREFIX + target, "utf-8"),
52
+ metadata: { "hq-symlink-target": SYMLINK_MARKER_META_VALUE },
53
+ }),
54
+ listObjects: async () => ({ objects: [] }),
55
+ deleteObject: async () => undefined,
56
+ headObject: async () => null,
57
+ };
58
+ }
59
+ function errnoError(code) {
60
+ const err = new Error(`${code}: scripted test failure`);
61
+ err.code = code;
62
+ return err;
63
+ }
64
+ /** Minimal fs.Stats fake — only the predicates downloadFile consults. */
65
+ function fakeStats(shape) {
66
+ return {
67
+ isSymbolicLink: () => shape.symlink ?? false,
68
+ isDirectory: () => shape.dir ?? false,
69
+ isFile: () => shape.file ?? false,
70
+ };
71
+ }
72
+ describe("downloadFile symlink materialization (US-001)", () => {
73
+ let tmpRoot;
74
+ beforeEach(() => {
75
+ tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "s3-symlink-mat-test-"));
76
+ });
77
+ afterEach(() => {
78
+ vi.restoreAllMocks();
79
+ setObjectIOFactory(null);
80
+ fs.rmSync(tmpRoot, { recursive: true, force: true });
81
+ });
82
+ it("fast path: an unchanged symlink is a success WITHOUT touching disk", async () => {
83
+ // The perpetual-churn half of the bug: an already-correct link went
84
+ // through temp+rename anyway, EPERM'd on Windows, never journaled, and
85
+ // re-downloaded every pass. A pull whose incoming target matches the
86
+ // existing link must return success (so the caller journals it) with
87
+ // zero writes — no temp link, no rename, no beforeReplace.
88
+ const target = "../real-target.md";
89
+ const localPath = path.join(tmpRoot, "skills", "link.md");
90
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
91
+ // Real target on disk: the win32 fast path stat-follows the link to
92
+ // confirm it functions as the desired type (a dangling link would
93
+ // deliberately fall through to replacement).
94
+ fs.writeFileSync(path.join(tmpRoot, "real-target.md"), "target body");
95
+ fs.symlinkSync(target, localPath);
96
+ setObjectIOFactory(() => symlinkRecordIO(target));
97
+ const symlinkSpy = vi.spyOn(fs, "symlinkSync");
98
+ const renameSpy = vi.spyOn(fs, "renameSync");
99
+ const beforeReplace = vi.fn();
100
+ const res = await downloadFile(makeCtx(), "skills/link.md", localPath, {
101
+ beforeReplace,
102
+ });
103
+ // Success shape matches a materializing pull, so the caller journals it.
104
+ expect(res.metadata?.["hq-symlink-target"]).toBe(SYMLINK_MARKER_META_VALUE);
105
+ expect(symlinkSpy).not.toHaveBeenCalled();
106
+ expect(renameSpy).not.toHaveBeenCalled();
107
+ expect(beforeReplace).not.toHaveBeenCalled();
108
+ expect(fs.lstatSync(localPath).isSymbolicLink()).toBe(true);
109
+ });
110
+ it("fast path compares readlink() separator-insensitively on win32", async () => {
111
+ // Windows stores the substitute path with backslashes (Node converts
112
+ // '/' at symlink() time), so readlink() of a link created from the
113
+ // POSIX-slashed wire target returns '..\\dir\\target'. The comparison
114
+ // must treat that as equal to the incoming '../dir/target' or the fast
115
+ // path would never fire for any multi-segment target on Windows.
116
+ const wireTarget = "../companies/indigo/skills/call-prep-brief";
117
+ const localPath = path.join(tmpRoot, "farm", "indigo%3Acall-prep-brief");
118
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
119
+ // Real directory at the resolved target: the link farm's normal shape,
120
+ // and what makes the desired flavor directory-ish (a junction, post-#219).
121
+ fs.mkdirSync(path.resolve(path.dirname(localPath), wireTarget), {
122
+ recursive: true,
123
+ });
124
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
125
+ vi.spyOn(fs, "lstatSync").mockImplementation(() => fakeStats({ symlink: true }));
126
+ // A RELATIVE substitute path — the spelling an older client's 'dir'
127
+ // symlink left behind. It still resolves to the same target, so the
128
+ // fast path must accept it rather than churn the link.
129
+ vi.spyOn(fs, "readlinkSync").mockImplementation(() => "..\\companies\\indigo\\skills\\call-prep-brief");
130
+ const realStatSync = fs.statSync.bind(fs);
131
+ // The follow-probe on the link itself reports a traversable directory,
132
+ // matching the flavor createStagedSymlink would mint — fast path holds.
133
+ vi.spyOn(fs, "statSync").mockImplementation(((p) => p === localPath
134
+ ? fakeStats({ dir: true })
135
+ : realStatSync(p)));
136
+ const symlinkSpy = vi.spyOn(fs, "symlinkSync");
137
+ const renameSpy = vi.spyOn(fs, "renameSync");
138
+ const res = await downloadFile(makeCtx(), ".claude/skills/indigo:call-prep-brief", localPath, { win32: true });
139
+ expect(res.metadata).toBeDefined();
140
+ expect(symlinkSpy).not.toHaveBeenCalled();
141
+ expect(renameSpy).not.toHaveBeenCalled();
142
+ });
143
+ it("fast path accepts a JUNCTION's absolute substitute path against a relative wire target", async () => {
144
+ // Post-#219, win32 directory overlays are materialized as junctions, and
145
+ // a junction can only store an ABSOLUTE substitute path. readlink() of a
146
+ // link this client itself created therefore returns
147
+ // 'C:\\...\\companies\\indigo\\skills\\call-prep-brief' while the wire
148
+ // target stays '../companies/...'. If equality were a raw string compare
149
+ // the fast path could never fire for the link farm on Windows — every
150
+ // pull would re-stage the whole farm, which is precisely the perpetual
151
+ // churn US-001 exists to kill. Both sides must be resolved before compare.
152
+ const wireTarget = "../companies/indigo/skills/call-prep-brief";
153
+ const localPath = path.join(tmpRoot, "farm", "indigo%3Acall-prep-brief");
154
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
155
+ const absTarget = path.resolve(path.dirname(localPath), wireTarget);
156
+ fs.mkdirSync(absTarget, { recursive: true });
157
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
158
+ vi.spyOn(fs, "lstatSync").mockImplementation(() => fakeStats({ symlink: true }));
159
+ vi.spyOn(fs, "readlinkSync").mockImplementation(() => absTarget.split("/").join("\\"));
160
+ const realStatSync = fs.statSync.bind(fs);
161
+ vi.spyOn(fs, "statSync").mockImplementation(((p) => p === localPath
162
+ ? fakeStats({ dir: true })
163
+ : realStatSync(p)));
164
+ const symlinkSpy = vi.spyOn(fs, "symlinkSync");
165
+ const renameSpy = vi.spyOn(fs, "renameSync");
166
+ const res = await downloadFile(makeCtx(), ".claude/skills/indigo:call-prep-brief", localPath, { win32: true });
167
+ expect(res.metadata).toBeDefined();
168
+ expect(symlinkSpy).not.toHaveBeenCalled();
169
+ expect(renameSpy).not.toHaveBeenCalled();
170
+ });
171
+ it("win32: a FILE-flavor link at a DIRECTORY target is broken despite a matching target string — recreated as a junction, never fast-pathed", async () => {
172
+ // Round-3 review P1: flavors matter on Windows. An older client (or a
173
+ // pull that ran while the target dir was absent) can leave a file-type
174
+ // link whose target string matches the incoming record exactly; it
175
+ // still cannot be traversed. The fast path must fall through and the
176
+ // materializer must mint the correct directory flavor — post-#219 that
177
+ // is a junction (unprivileged) rather than a 'dir' NTFS symlink.
178
+ const wireTarget = "../companies/indigo/skills/call-prep-brief";
179
+ const localPath = path.join(tmpRoot, "farm", "indigo%3Acall-prep-brief");
180
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
181
+ const resolvedTarget = path.resolve(path.dirname(localPath), wireTarget);
182
+ fs.mkdirSync(resolvedTarget, { recursive: true });
183
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
184
+ const realStatSync = fs.statSync.bind(fs);
185
+ vi.spyOn(fs, "lstatSync").mockImplementation(((p) => p === localPath
186
+ ? fakeStats({ symlink: true })
187
+ : fakeStats({})));
188
+ vi.spyOn(fs, "readlinkSync").mockImplementation((() => "..\\companies\\indigo\\skills\\call-prep-brief"));
189
+ // Windows refuses to traverse the wrong-flavor link: stat on the link
190
+ // throws, while the resolved target itself stats as a real directory.
191
+ vi.spyOn(fs, "statSync").mockImplementation(((p) => {
192
+ if (p === localPath)
193
+ throw errnoError("EINVAL");
194
+ return realStatSync(p);
195
+ }));
196
+ const symlinkSpy = vi
197
+ .spyOn(fs, "symlinkSync")
198
+ .mockImplementation(() => undefined);
199
+ vi.spyOn(fs, "unlinkSync").mockImplementation(() => undefined);
200
+ vi.spyOn(fs, "renameSync").mockImplementation(() => undefined);
201
+ await downloadFile(makeCtx(), ".claude/skills/indigo:call-prep-brief", localPath, {
202
+ win32: true,
203
+ });
204
+ // Fell through the fast path and minted the correct flavor: a junction,
205
+ // which requires an absolute substitute path.
206
+ expect(symlinkSpy).toHaveBeenCalledTimes(1);
207
+ expect(symlinkSpy.mock.calls[0][2]).toBe("junction");
208
+ expect(symlinkSpy.mock.calls[0][0]).toBe(resolvedTarget);
209
+ });
210
+ it("win32: replaces a directory symlink via backup-swap, minting a junction temp link", async () => {
211
+ // Failure signature 1 from the incident: EPERM on rename over
212
+ // '...\\indigo%3Acall-prep-brief\\scripts' — the destination was a
213
+ // directory symlink, which Windows rename() can never replace.
214
+ // replaceStagedPath (upstream #193) swaps a symlink destination out to
215
+ // a sibling backup, installs the staged link, then removes the backup.
216
+ const wireTarget = "../companies/indigo/skills/call-prep-brief";
217
+ const localPath = path.join(tmpRoot, "farm", "indigo%3Acall-prep-brief");
218
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
219
+ // Real directory at the resolved target so the type probe picks 'dir'.
220
+ fs.mkdirSync(path.resolve(path.dirname(localPath), wireTarget), {
221
+ recursive: true,
222
+ });
223
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
224
+ const realLstatSync = fs.lstatSync.bind(fs);
225
+ const realStatSync = fs.statSync.bind(fs);
226
+ // Destination is scripted as a live directory symlink to a STALE target.
227
+ vi.spyOn(fs, "lstatSync").mockImplementation(((p) => p === localPath
228
+ ? fakeStats({ symlink: true })
229
+ : realLstatSync(p)));
230
+ vi.spyOn(fs, "readlinkSync").mockImplementation((() => "..\\stale\\old-skill"));
231
+ vi.spyOn(fs, "statSync").mockImplementation(((p) => p === localPath
232
+ ? fakeStats({ dir: true })
233
+ : realStatSync(p)));
234
+ const symlinkSpy = vi
235
+ .spyOn(fs, "symlinkSync")
236
+ .mockImplementation(() => undefined);
237
+ const unlinkSpy = vi
238
+ .spyOn(fs, "unlinkSync")
239
+ .mockImplementation(() => undefined);
240
+ const renameSpy = vi
241
+ .spyOn(fs, "renameSync")
242
+ .mockImplementation(() => undefined);
243
+ await downloadFile(makeCtx(), ".claude/skills/indigo:call-prep-brief", localPath, {
244
+ win32: true,
245
+ });
246
+ // Typed temp link: directory target ⇒ junction with an ABSOLUTE
247
+ // substitute path (#219 — a bare symlinkSync mints a broken file-type
248
+ // link, and a 'dir' NTFS symlink EPERMs without Developer Mode).
249
+ expect(symlinkSpy).toHaveBeenCalledTimes(1);
250
+ expect(symlinkSpy.mock.calls[0][0]).toBe(path.resolve(path.dirname(localPath), wireTarget));
251
+ expect(String(symlinkSpy.mock.calls[0][1])).toContain(".hq-tmp-");
252
+ expect(symlinkSpy.mock.calls[0][2]).toBe("junction");
253
+ // Backup-swap: old link → .hq-backup-*, staged link → destination,
254
+ // backup removed. The destination itself is never rm'd in place.
255
+ expect(renameSpy).toHaveBeenCalledTimes(2);
256
+ expect(renameSpy.mock.calls[0][0]).toBe(localPath);
257
+ expect(String(renameSpy.mock.calls[0][1])).toContain(".hq-backup-");
258
+ expect(String(renameSpy.mock.calls[1][0])).toContain(".hq-tmp-");
259
+ expect(renameSpy.mock.calls[1][1]).toBe(localPath);
260
+ expect(unlinkSpy).not.toHaveBeenCalledWith(localPath);
261
+ expect(unlinkSpy.mock.calls.some((c) => String(c[0]).includes(".hq-backup-"))).toBe(true);
262
+ });
263
+ it("win32: replaces a file symlink via backup-swap, minting a 'file'-type temp link", async () => {
264
+ const wireTarget = "../personal/skills/dm/SKILL.md";
265
+ const localPath = path.join(tmpRoot, "farm", "personal%3Adm");
266
+ fs.mkdirSync(path.dirname(localPath), { recursive: true });
267
+ // A GENUINE regular file at the resolved target — the only shape that
268
+ // still earns a real 'file' symlink post-#219. An unresolvable target is
269
+ // deliberately materialized as a junction instead (vault overlays are
270
+ // directories, and a junction needs no Windows symlink privilege).
271
+ const resolvedTarget = path.resolve(path.dirname(localPath), wireTarget);
272
+ fs.mkdirSync(path.dirname(resolvedTarget), { recursive: true });
273
+ fs.writeFileSync(resolvedTarget, "# dm skill");
274
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
275
+ const realLstatSync = fs.lstatSync.bind(fs);
276
+ vi.spyOn(fs, "lstatSync").mockImplementation(((p) => p === localPath
277
+ ? fakeStats({ symlink: true })
278
+ : realLstatSync(p)));
279
+ vi.spyOn(fs, "readlinkSync").mockImplementation((() => "..\\stale\\dm.md"));
280
+ const symlinkSpy = vi
281
+ .spyOn(fs, "symlinkSync")
282
+ .mockImplementation(() => undefined);
283
+ const rmdirSpy = vi.spyOn(fs, "rmdirSync");
284
+ const unlinkSpy = vi
285
+ .spyOn(fs, "unlinkSync")
286
+ .mockImplementation(() => undefined);
287
+ const renameSpy = vi
288
+ .spyOn(fs, "renameSync")
289
+ .mockImplementation(() => undefined);
290
+ await downloadFile(makeCtx(), ".claude/skills/personal:dm", localPath, {
291
+ win32: true,
292
+ });
293
+ expect(symlinkSpy.mock.calls[0][2]).toBe("file");
294
+ // Backup-swap: two renames (old→backup, staged→destination) and the
295
+ // backup removed; the destination is never unlinked in place.
296
+ expect(renameSpy).toHaveBeenCalledTimes(2);
297
+ expect(unlinkSpy).not.toHaveBeenCalledWith(localPath);
298
+ expect(unlinkSpy.mock.calls.some((c) => String(c[0]).includes(".hq-backup-"))).toBe(true);
299
+ expect(rmdirSpy).not.toHaveBeenCalledWith(localPath);
300
+ });
301
+ it("win32: NEVER deletes a real (non-symlink) directory — the rename failure surfaces", async () => {
302
+ // The engine-level guarantee behind the caller's "manual reconciliation
303
+ // required" warning: a real directory at the destination is the user's
304
+ // data. The replace path may only remove SYMLINK destinations; a real
305
+ // dir is left in place and the (scripted, Windows-faithful) EPERM from
306
+ // rename-over-dir propagates.
307
+ const wireTarget = "../companies/indigo/skills/capture";
308
+ const localPath = path.join(tmpRoot, "farm", "indigo%3Acapture");
309
+ fs.mkdirSync(localPath, { recursive: true }); // REAL directory
310
+ fs.mkdirSync(path.resolve(path.dirname(localPath), wireTarget), {
311
+ recursive: true,
312
+ });
313
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
314
+ vi.spyOn(fs, "symlinkSync").mockImplementation(() => undefined);
315
+ const rmdirSpy = vi.spyOn(fs, "rmdirSync");
316
+ const unlinkSpy = vi.spyOn(fs, "unlinkSync");
317
+ const renameSpy = vi.spyOn(fs, "renameSync").mockImplementation(() => {
318
+ throw errnoError("EPERM");
319
+ });
320
+ await expect(downloadFile(makeCtx(), ".claude/skills/indigo:capture", localPath, {
321
+ win32: true,
322
+ })).rejects.toThrow(/EPERM/);
323
+ // Surfaced on the first failure — never silently swallowed, and a
324
+ // non-symlink destination gets no backup-swap (nothing to roll back).
325
+ expect(renameSpy).toHaveBeenCalledTimes(1);
326
+ // The real directory was never removed (temp cleanup may touch the
327
+ // .hq-tmp- path, but the destination itself is untouchable).
328
+ expect(rmdirSpy).not.toHaveBeenCalledWith(localPath);
329
+ expect(unlinkSpy).not.toHaveBeenCalledWith(localPath);
330
+ expect(fs.statSync(localPath).isDirectory()).toBe(true);
331
+ });
332
+ it("POSIX: symlink destination is replaced cleanly — fresh target installed, no temp/backup litter", async () => {
333
+ // replaceStagedPath backup-swaps symlink destinations on every
334
+ // platform; the observable contract is a clean replacement with no
335
+ // .hq-tmp-/.hq-backup- litter and a bare (no type hint) staged link.
336
+ const localPath = path.join(tmpRoot, "posix-link.md");
337
+ fs.symlinkSync("stale-target.md", localPath);
338
+ setObjectIOFactory(() => symlinkRecordIO("fresh-target.md"));
339
+ const symlinkSpy = vi.spyOn(fs, "symlinkSync");
340
+ await downloadFile(makeCtx(), "posix-link.md", localPath, {
341
+ win32: false,
342
+ });
343
+ expect(symlinkSpy).toHaveBeenCalledTimes(1);
344
+ expect(symlinkSpy.mock.calls[0][2]).toBeUndefined();
345
+ expect(fs.readlinkSync(localPath)).toBe("fresh-target.md");
346
+ const litter = fs
347
+ .readdirSync(tmpRoot)
348
+ .filter((n) => n.startsWith(".hq-tmp-") || n.startsWith(".hq-backup-"));
349
+ expect(litter).toEqual([]);
350
+ });
351
+ it("2026-07-16 ENOENT mode (US-002): parents are created at the ENCODED local path, never the raw-colon path", async () => {
352
+ // Failure signature 2 from the incident:
353
+ // ENOENT mkdir 'C:\...\skills\indigo:team-agent-telemetry-report'
354
+ // — the pre-codec caller handed downloadFile a RAW-key local path, and
355
+ // Windows cannot mkdir a colon segment. The pull pipeline now derives
356
+ // localPath through the codec (sync.ts resolveContainedVaultPath →
357
+ // localPathForVaultKey); this pins the contract end-to-end: pulling the
358
+ // incident's exact key with a codec-derived localPath materializes the
359
+ // parent chain at `indigo%3Ateam-agent-telemetry-report`, and no
360
+ // raw-colon sibling ever appears.
361
+ const key = ".claude/skills/indigo:team-agent-telemetry-report/agents";
362
+ const wireTarget = "../../../companies/indigo/skills/team-agent-telemetry-report/agents";
363
+ const localPath = localPathForVaultKey(tmpRoot, key, true);
364
+ setObjectIOFactory(() => symlinkRecordIO(wireTarget));
365
+ // Leaf materialization is exercised by the suites above; this test is
366
+ // about the parent chain, so the link+rename pair is inert.
367
+ vi.spyOn(fs, "symlinkSync").mockImplementation(() => undefined);
368
+ vi.spyOn(fs, "renameSync").mockImplementation(() => undefined);
369
+ await downloadFile(makeCtx(), key, localPath, { win32: true });
370
+ const encodedParent = path.join(tmpRoot, ".claude", "skills", "indigo%3Ateam-agent-telemetry-report");
371
+ expect(fs.existsSync(encodedParent)).toBe(true);
372
+ expect(fs.statSync(encodedParent).isDirectory()).toBe(true);
373
+ // The raw-colon spelling must not exist anywhere in the farm.
374
+ expect(fs.readdirSync(path.join(tmpRoot, ".claude", "skills"))).toEqual(["indigo%3Ateam-agent-telemetry-report"]);
375
+ });
376
+ it("POSIX: fast path also fires with exact string equality", async () => {
377
+ // Separator normalization is win32-only; POSIX equality is exact (a
378
+ // backslash is an ordinary filename character there). A separator-free
379
+ // target makes this deterministic on any host platform.
380
+ const target = "plain-target.md";
381
+ const localPath = path.join(tmpRoot, "posix-noop.md");
382
+ fs.symlinkSync(target, localPath);
383
+ setObjectIOFactory(() => symlinkRecordIO(target));
384
+ const symlinkSpy = vi.spyOn(fs, "symlinkSync");
385
+ const renameSpy = vi.spyOn(fs, "renameSync");
386
+ const res = await downloadFile(makeCtx(), "posix-noop.md", localPath, {
387
+ win32: false,
388
+ });
389
+ expect(res.metadata).toBeDefined();
390
+ expect(symlinkSpy).not.toHaveBeenCalled();
391
+ expect(renameSpy).not.toHaveBeenCalled();
392
+ });
393
+ });
394
+ //# sourceMappingURL=s3.symlink-materialize.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"s3.symlink-materialize.test.js","sourceRoot":"","sources":["../src/s3.symlink-materialize.test.ts"],"names":[],"mappings":"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"}
package/dist/s3.test.js CHANGED
@@ -886,6 +886,25 @@ describe("downloadFile", () => {
886
886
  expect(fs.readFileSync(localPath, "utf8")).toBe("remote replacement");
887
887
  expect(fs.readFileSync(path.join(targetDir, "sentinel.txt"), "utf8")).toBe("source-owned");
888
888
  });
889
+ it("default ops replace a directory symlink destination end-to-end (dir-reparse-safe cleanup)", () => {
890
+ // No ops seam: exercises DEFAULT_REPLACE_STAGED_PATH_OPS on the real
891
+ // filesystem. The backup of the old DIR-type link must be removable on
892
+ // every platform (unlink with rmdir fallback for directory reparse
893
+ // points), or the replacement rolls back and the Windows churn returns.
894
+ const oldTarget = path.join(tmpRoot, "default-ops-old");
895
+ const newTarget = path.join(tmpRoot, "default-ops-new");
896
+ const localPath = path.join(tmpRoot, "default-ops-link");
897
+ const stagedPath = path.join(tmpRoot, ".hq-tmp-default-ops-test");
898
+ fs.mkdirSync(oldTarget);
899
+ fs.mkdirSync(newTarget);
900
+ fs.symlinkSync(oldTarget, localPath, "dir");
901
+ fs.symlinkSync(newTarget, stagedPath, "dir");
902
+ replaceStagedPath(stagedPath, localPath);
903
+ expect(fs.lstatSync(localPath).isSymbolicLink()).toBe(true);
904
+ expect(fs.readlinkSync(localPath)).toBe(newTarget);
905
+ expect(fs.readdirSync(tmpRoot).filter((n) => n.startsWith(".hq-backup-"))).toEqual([]);
906
+ expect(fs.existsSync(stagedPath)).toBe(false);
907
+ });
889
908
  it("restores an existing directory link when staged replacement fails", () => {
890
909
  const targetDir = path.join(tmpRoot, "rollback-source");
891
910
  const localPath = path.join(tmpRoot, "rollback-link");