@indigoai-us/hq-cloud 6.16.47 → 6.16.49

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 (51) hide show
  1. package/dist/bin/rescue-runner.js +1 -1
  2. package/dist/cli/rescue-breaker.test.d.ts +2 -0
  3. package/dist/cli/rescue-breaker.test.d.ts.map +1 -0
  4. package/dist/cli/rescue-breaker.test.js +314 -0
  5. package/dist/cli/rescue-breaker.test.js.map +1 -0
  6. package/dist/cli/rescue-core.d.ts +11 -0
  7. package/dist/cli/rescue-core.d.ts.map +1 -1
  8. package/dist/cli/rescue-core.js +167 -8
  9. package/dist/cli/rescue-core.js.map +1 -1
  10. package/dist/cli/rescue.d.ts +6 -0
  11. package/dist/cli/rescue.d.ts.map +1 -1
  12. package/dist/cli/rescue.js +12 -0
  13. package/dist/cli/rescue.js.map +1 -1
  14. package/dist/cli/rescue.test.js +6 -0
  15. package/dist/cli/rescue.test.js.map +1 -1
  16. package/dist/cli/share-presign-transport.test.js +2 -0
  17. package/dist/cli/share-presign-transport.test.js.map +1 -1
  18. package/dist/cli/share.d.ts.map +1 -1
  19. package/dist/cli/share.js +37 -2
  20. package/dist/cli/share.js.map +1 -1
  21. package/dist/cli/share.test.js +92 -0
  22. package/dist/cli/share.test.js.map +1 -1
  23. package/dist/cli/watch-event-push-conflict.test.js +2 -0
  24. package/dist/cli/watch-event-push-conflict.test.js.map +1 -1
  25. package/dist/cognito-auth.d.ts +30 -0
  26. package/dist/cognito-auth.d.ts.map +1 -1
  27. package/dist/cognito-auth.js +175 -0
  28. package/dist/cognito-auth.js.map +1 -1
  29. package/dist/index.d.ts +2 -2
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +1 -1
  32. package/dist/index.js.map +1 -1
  33. package/dist/machine-auth.test.js +295 -0
  34. package/dist/machine-auth.test.js.map +1 -1
  35. package/dist/object-io.d.ts +2 -2
  36. package/dist/object-io.d.ts.map +1 -1
  37. package/dist/object-io.js +18 -3
  38. package/dist/object-io.js.map +1 -1
  39. package/dist/s3.d.ts +18 -0
  40. package/dist/s3.d.ts.map +1 -1
  41. package/dist/s3.js +45 -4
  42. package/dist/s3.js.map +1 -1
  43. package/dist/s3.test.js +27 -1
  44. package/dist/s3.test.js.map +1 -1
  45. package/dist/sync-core.d.ts +6 -4
  46. package/dist/sync-core.d.ts.map +1 -1
  47. package/dist/sync-core.js +10 -4
  48. package/dist/sync-core.js.map +1 -1
  49. package/dist/sync-core.test.js +25 -1
  50. package/dist/sync-core.test.js.map +1 -1
  51. package/package.json +1 -1
@@ -14,7 +14,7 @@
14
14
  * script (and src/cli/rescue.ts) for the supported flags:
15
15
  * --hq-root --source --ref --floor-sha --paths --preserve
16
16
  * --preserve-subpath --no-history-check --no-backup --backup-dir
17
- * --cloud-update --dry-run --yes
17
+ * --resolve-recovery-snapshots --cloud-update --dry-run --yes
18
18
  *
19
19
  * stdout/stderr from the script are inherited so the caller (the menubar's
20
20
  * RescueRunResult tail capture) sees the scan log + trailing summary.
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rescue-breaker.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rescue-breaker.test.d.ts","sourceRoot":"","sources":["../../src/cli/rescue-breaker.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,314 @@
1
+ /**
2
+ * Writability preflight, recovery-snapshot circuit breaker override, and
3
+ * `.hq/rescue-blocked.json` visibility for `hq rescue`.
4
+ *
5
+ * Production (2026-09-16): six agent boxes froze on hq-core releases from
6
+ * 15 Aug–7 Sep because `core/scripts` was root-owned. Drift-rescue
7
+ * `renameSync(core/scripts/qmd-reindex-bg.sh → personal/scripts/...)` failed
8
+ * EACCES twice, the safety snapshot was already allocated, and the breaker
9
+ * then held forever with no heartbeat signal.
10
+ */
11
+ import { afterAll, beforeAll, describe, expect, it } from "vitest";
12
+ import { execFileSync } from "child_process";
13
+ import * as fs from "fs";
14
+ import * as os from "os";
15
+ import * as path from "path";
16
+ import { canonicalRootHash } from "../backup-prune.js";
17
+ import { collectUnwritableRescueMutationPaths, parseRescueArgs, runRescue, } from "./rescue-core.js";
18
+ function has(bin, ...args) {
19
+ try {
20
+ execFileSync(bin, args, { stdio: "ignore" });
21
+ return true;
22
+ }
23
+ catch {
24
+ return false;
25
+ }
26
+ }
27
+ const toolsAvailable = has("git", "--version") && has("rsync", "--version");
28
+ const canChmodDenyWrite = process.platform !== "win32" &&
29
+ (typeof process.getuid !== "function" || process.getuid() !== 0);
30
+ function runRescueCapture(argv, env) {
31
+ let stdout = "";
32
+ let stderr = "";
33
+ const origOut = process.stdout.write.bind(process.stdout);
34
+ const origErr = process.stderr.write.bind(process.stderr);
35
+ process.stdout.write = ((chunk) => {
36
+ stdout += String(chunk);
37
+ return true;
38
+ });
39
+ process.stderr.write = ((chunk) => {
40
+ stderr += String(chunk);
41
+ return true;
42
+ });
43
+ let status;
44
+ let threw;
45
+ try {
46
+ status = runRescue(argv, { env }).status;
47
+ }
48
+ catch (e) {
49
+ threw = e;
50
+ }
51
+ finally {
52
+ process.stdout.write = origOut;
53
+ process.stderr.write = origErr;
54
+ }
55
+ return { status, stdout, stderr, threw };
56
+ }
57
+ describe("parseRescueArgs --resolve-recovery-snapshots", () => {
58
+ it("defaults off and accepts the flag", () => {
59
+ expect(parseRescueArgs([]).resolveRecoverySnapshots).toBe(false);
60
+ expect(parseRescueArgs(["--resolve-recovery-snapshots"]).resolveRecoverySnapshots).toBe(true);
61
+ });
62
+ });
63
+ describe("collectUnwritableRescueMutationPaths", () => {
64
+ it.skipIf(!canChmodDenyWrite)("fails closed on a read-only parent dir", () => {
65
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-preflight-ro-"));
66
+ const parent = path.join(root, "core", "scripts");
67
+ const file = path.join(parent, "qmd-reindex-bg.sh");
68
+ fs.mkdirSync(parent, { recursive: true });
69
+ fs.mkdirSync(path.join(root, "personal"), { recursive: true });
70
+ fs.writeFileSync(file, "local-edit\n");
71
+ fs.chmodSync(parent, 0o555);
72
+ try {
73
+ const failed = collectUnwritableRescueMutationPaths(root, [
74
+ {
75
+ affectedRels: ["core/scripts/qmd-reindex-bg.sh"],
76
+ destParentRels: ["personal/scripts"],
77
+ },
78
+ ]);
79
+ expect(failed).toContain("core/scripts");
80
+ expect(failed.join("\n")).not.toMatch(/personal/);
81
+ }
82
+ finally {
83
+ fs.chmodSync(parent, 0o755);
84
+ fs.rmSync(root, { recursive: true, force: true });
85
+ }
86
+ });
87
+ it("passes on a writable tree", () => {
88
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-preflight-rw-"));
89
+ try {
90
+ const parent = path.join(root, "core", "scripts");
91
+ fs.mkdirSync(parent, { recursive: true });
92
+ fs.mkdirSync(path.join(root, "personal"), { recursive: true });
93
+ fs.writeFileSync(path.join(parent, "qmd-reindex-bg.sh"), "local-edit\n");
94
+ expect(collectUnwritableRescueMutationPaths(root, [
95
+ {
96
+ affectedRels: ["core/scripts/qmd-reindex-bg.sh"],
97
+ destParentRels: ["personal/scripts"],
98
+ },
99
+ ])).toEqual([]);
100
+ }
101
+ finally {
102
+ fs.rmSync(root, { recursive: true, force: true });
103
+ }
104
+ });
105
+ });
106
+ describe.skipIf(!toolsAvailable)("rescue recovery-snapshot breaker + mutation preflight", () => {
107
+ let workDir;
108
+ let upstream;
109
+ let shimDir;
110
+ let floorSha;
111
+ let baseEnv;
112
+ let caseSeq = 0;
113
+ const git = (cwd, ...args) => execFileSync("git", args, {
114
+ cwd,
115
+ stdio: ["ignore", "pipe", "pipe"],
116
+ env: {
117
+ ...process.env,
118
+ GIT_AUTHOR_NAME: "t",
119
+ GIT_AUTHOR_EMAIL: "t@t",
120
+ GIT_COMMITTER_NAME: "t",
121
+ GIT_COMMITTER_EMAIL: "t@t",
122
+ },
123
+ })
124
+ .toString()
125
+ .trim();
126
+ beforeAll(() => {
127
+ workDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-rescue-breaker-"));
128
+ upstream = path.join(workDir, "upstream");
129
+ fs.mkdirSync(path.join(upstream, "core", "scripts"), { recursive: true });
130
+ git(workDir, "init", "-b", "main", "upstream");
131
+ fs.writeFileSync(path.join(upstream, "core/a.md"), "v1\n");
132
+ fs.writeFileSync(path.join(upstream, "core/scripts/qmd-reindex-bg.sh"), "release-v1\n");
133
+ git(upstream, "add", "-A");
134
+ git(upstream, "commit", "-m", "floor");
135
+ floorSha = git(upstream, "rev-parse", "HEAD");
136
+ fs.writeFileSync(path.join(upstream, "core/a.md"), "v2\n");
137
+ fs.writeFileSync(path.join(upstream, "core/scripts/qmd-reindex-bg.sh"), "release-v2\n");
138
+ git(upstream, "add", "-A");
139
+ git(upstream, "commit", "-m", "head");
140
+ const realGit = execFileSync("bash", ["-lc", "command -v git"]).toString().trim() ||
141
+ "/usr/bin/git";
142
+ shimDir = path.join(workDir, "shim");
143
+ fs.mkdirSync(shimDir, { recursive: true });
144
+ const shim = `#!/usr/bin/env bash
145
+ if [ "$1" = "clone" ]; then
146
+ args=()
147
+ for a in "$@"; do
148
+ case "$a" in
149
+ https://github.com/*) a=${JSON.stringify(upstream)} ;;
150
+ esac
151
+ args+=("$a")
152
+ done
153
+ exec ${JSON.stringify(realGit)} "\${args[@]}"
154
+ fi
155
+ exec ${JSON.stringify(realGit)} "$@"
156
+ `;
157
+ fs.writeFileSync(path.join(shimDir, "git"), shim, { mode: 0o755 });
158
+ baseEnv = { ...process.env, PATH: `${shimDir}:${process.env.PATH ?? ""}` };
159
+ }, 60_000);
160
+ afterAll(() => {
161
+ if (workDir)
162
+ fs.rmSync(workDir, { recursive: true, force: true });
163
+ });
164
+ function makeHqRoot() {
165
+ caseSeq += 1;
166
+ const hqRoot = path.join(workDir, `hq-${caseSeq}`);
167
+ fs.mkdirSync(path.join(hqRoot, "core", "scripts"), { recursive: true });
168
+ fs.mkdirSync(path.join(hqRoot, "companies"), { recursive: true });
169
+ fs.mkdirSync(path.join(hqRoot, "personal"), { recursive: true });
170
+ fs.writeFileSync(path.join(hqRoot, "core/a.md"), "v1\n");
171
+ fs.writeFileSync(path.join(hqRoot, "core/scripts/qmd-reindex-bg.sh"), "local-edit\n");
172
+ return hqRoot;
173
+ }
174
+ function liveArgs(hqRoot, backupRoot, extra = []) {
175
+ return [
176
+ "--hq-root",
177
+ hqRoot,
178
+ "--source",
179
+ "test/repo",
180
+ "--ref",
181
+ "main",
182
+ "--floor-sha",
183
+ floorSha,
184
+ "--paths",
185
+ "core",
186
+ "--backup-dir",
187
+ backupRoot,
188
+ "--yes",
189
+ ...extra,
190
+ ];
191
+ }
192
+ function plantRecoverySnapshots(hqRoot, backupRoot) {
193
+ const canonical = fs.realpathSync.native(hqRoot);
194
+ const hash = canonicalRootHash(canonical);
195
+ const names = [
196
+ `pre-update-2026-08-15T12-00-00Z-${hash}-one`,
197
+ `pre-update-2026-09-07T12-00-00Z-${hash}-two`,
198
+ ];
199
+ fs.mkdirSync(backupRoot, { recursive: true });
200
+ for (const name of names) {
201
+ const dir = path.join(backupRoot, name);
202
+ fs.mkdirSync(dir, { recursive: true });
203
+ const at = "2026-08-15T12:00:00.000Z";
204
+ const runId = name.slice(name.lastIndexOf("-") + 1);
205
+ fs.writeFileSync(path.join(dir, "SNAPSHOT.json"), JSON.stringify({
206
+ schemaVersion: 1,
207
+ status: "recovery-required",
208
+ canonicalHqRoot: canonical,
209
+ rootHash: hash,
210
+ runId,
211
+ creatorPid: 1,
212
+ creatorStartedAt: at,
213
+ source: "test/repo",
214
+ ref: "main",
215
+ sourceSha: "abc",
216
+ createdAt: at,
217
+ completedAt: at,
218
+ includedRoots: ["core"],
219
+ fileCount: 1,
220
+ byteCount: 1,
221
+ }) + "\n");
222
+ fs.writeFileSync(path.join(dir, "keep.txt"), "recovery evidence\n");
223
+ }
224
+ return names;
225
+ }
226
+ function snapshotNames(backupRoot) {
227
+ try {
228
+ return fs.readdirSync(backupRoot).filter((name) => name.startsWith("pre-update-"));
229
+ }
230
+ catch {
231
+ return [];
232
+ }
233
+ }
234
+ it.skipIf(!canChmodDenyWrite)("preflight fails closed on a read-only parent dir and does not create a snapshot dir", () => {
235
+ const hqRoot = makeHqRoot();
236
+ const backupRoot = path.join(workDir, `backups-ro-${caseSeq}`);
237
+ fs.mkdirSync(backupRoot, { recursive: true });
238
+ const parent = path.join(hqRoot, "core", "scripts");
239
+ fs.chmodSync(parent, 0o555);
240
+ try {
241
+ const r = runRescueCapture(liveArgs(hqRoot, backupRoot), baseEnv);
242
+ const out = `${r.stdout}\n${r.stderr}\n${String(r.threw ?? "")}`;
243
+ expect(r.threw, out).toBeUndefined();
244
+ expect(r.status, out).toBe(1);
245
+ expect(out).toContain("cannot write the paths rescue would rename or delete");
246
+ expect(out).toContain("chown -R");
247
+ expect(out).toContain(path.join(hqRoot, "core"));
248
+ expect(snapshotNames(backupRoot)).toEqual([]);
249
+ }
250
+ finally {
251
+ fs.chmodSync(parent, 0o755);
252
+ }
253
+ });
254
+ it("preflight passes on a writable tree", () => {
255
+ const hqRoot = makeHqRoot();
256
+ const backupRoot = path.join(workDir, `backups-rw-${caseSeq}`);
257
+ const r = runRescueCapture(liveArgs(hqRoot, backupRoot), baseEnv);
258
+ const out = `${r.stdout}\n${r.stderr}\n${String(r.threw ?? "")}`;
259
+ expect(r.threw, out).toBeUndefined();
260
+ expect(r.status, out).toBe(0);
261
+ expect(out).not.toContain("cannot write the paths rescue would rename or delete");
262
+ expect(snapshotNames(backupRoot)).toHaveLength(1);
263
+ });
264
+ it("with --resolve-recovery-snapshots, two recovery-required snapshots are moved (not deleted) and rescue proceeds to the snapshot phase", () => {
265
+ const hqRoot = makeHqRoot();
266
+ const backupRoot = path.join(workDir, `backups-resolve-${caseSeq}`);
267
+ const planted = plantRecoverySnapshots(hqRoot, backupRoot);
268
+ const r = runRescueCapture(liveArgs(hqRoot, backupRoot, ["--resolve-recovery-snapshots"]), baseEnv);
269
+ const out = `${r.stdout}\n${r.stderr}\n${String(r.threw ?? "")}`;
270
+ expect(r.threw, out).toBeUndefined();
271
+ expect(r.status, out).toBe(0);
272
+ expect(out).toContain("Resolving recovery-required snapshots");
273
+ expect(out).toContain("Safety snapshot ->");
274
+ for (const name of planted) {
275
+ expect(fs.existsSync(path.join(backupRoot, name)), name).toBe(false);
276
+ expect(out).toContain(`moved ${name} ->`);
277
+ }
278
+ const resolvedDirs = fs
279
+ .readdirSync(path.dirname(backupRoot))
280
+ .filter((name) => name.startsWith(`${path.basename(backupRoot)}-resolved-`));
281
+ expect(resolvedDirs).toHaveLength(1);
282
+ const destRoot = path.join(path.dirname(backupRoot), resolvedDirs[0]);
283
+ for (const name of planted) {
284
+ expect(fs.readFileSync(path.join(destRoot, name, "keep.txt"), "utf8")).toBe("recovery evidence\n");
285
+ }
286
+ const live = snapshotNames(backupRoot);
287
+ expect(live.length).toBeGreaterThanOrEqual(1);
288
+ expect(live.some((name) => planted.includes(name))).toBe(false);
289
+ });
290
+ it("writes rescue-blocked.json when the breaker trips and removes it after a successful run", () => {
291
+ const hqRoot = makeHqRoot();
292
+ const backupRoot = path.join(workDir, `backups-marker-${caseSeq}`);
293
+ const planted = plantRecoverySnapshots(hqRoot, backupRoot);
294
+ const marker = path.join(hqRoot, ".hq", "rescue-blocked.json");
295
+ const tripped = runRescueCapture(liveArgs(hqRoot, backupRoot), baseEnv);
296
+ const tripOut = `${tripped.stdout}\n${tripped.stderr}\n${String(tripped.threw ?? "")}`;
297
+ expect(tripped.threw, tripOut).toBeUndefined();
298
+ expect(tripped.status, tripOut).toBe(1);
299
+ expect(tripOut).toContain("safety snapshot circuit breaker is open");
300
+ expect(fs.existsSync(marker)).toBe(true);
301
+ const body = JSON.parse(fs.readFileSync(marker, "utf8"));
302
+ expect(body.reason).toBe("recovery-snapshot-breaker");
303
+ expect(body.snapshots.sort()).toEqual([...planted].sort());
304
+ expect(body.hint).toContain("--resolve-recovery-snapshots");
305
+ expect(Number.isNaN(Date.parse(body.at))).toBe(false);
306
+ expect(snapshotNames(backupRoot).sort()).toEqual([...planted].sort());
307
+ const recovered = runRescueCapture(liveArgs(hqRoot, backupRoot, ["--resolve-recovery-snapshots"]), baseEnv);
308
+ const recoveredOut = `${recovered.stdout}\n${recovered.stderr}\n${String(recovered.threw ?? "")}`;
309
+ expect(recovered.threw, recoveredOut).toBeUndefined();
310
+ expect(recovered.status, recoveredOut).toBe(0);
311
+ expect(fs.existsSync(marker)).toBe(false);
312
+ });
313
+ });
314
+ //# sourceMappingURL=rescue-breaker.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rescue-breaker.test.js","sourceRoot":"","sources":["../../src/cli/rescue-breaker.test.ts"],"names":[],"mappings":"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"}
@@ -18,6 +18,8 @@ interface Config {
18
18
  backupRoot: string;
19
19
  backupRetentionDays: string;
20
20
  backupRetentionCount: string;
21
+ /** Move recovery-required snapshots aside and continue (`--resolve-recovery-snapshots`). */
22
+ resolveRecoverySnapshots: boolean;
21
23
  }
22
24
  /** Read an environment value without relying on Windows' case-insensitive proxy. */
23
25
  export declare function envValue(env: NodeJS.ProcessEnv, name: string): string | undefined;
@@ -205,5 +207,14 @@ interface ReconcileCtx {
205
207
  * rescue's posture elsewhere.
206
208
  */
207
209
  export declare function reconcileClaudeSettings(ctx: ReconcileCtx, preRescueSettingsJson: string | null, out: (s: string) => void, err: (s: string) => void): void;
210
+ /**
211
+ * Paths the current process cannot write among the action plan's rename/delete
212
+ * sources (and their parents) plus rename destination parents. Empty means the
213
+ * plan is writable; a non-empty result must refuse before allocating a snapshot.
214
+ */
215
+ export declare function collectUnwritableRescueMutationPaths(hqRoot: string, actions: ReadonlyArray<{
216
+ affectedRels: readonly string[];
217
+ destParentRels?: readonly string[];
218
+ }>): string[];
208
219
  export {};
209
220
  //# sourceMappingURL=rescue-core.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rescue-core.d.ts","sourceRoot":"","sources":["../../src/cli/rescue-core.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAa7B,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AA0CD,UAAU,MAAM;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AA6CD,oFAAoF;AACpF,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS3D;AA0BD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAoBD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,kBAAkB,GAAG,SAAS,CAqBhC;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACvB,aAAa,CA8Cf;AAmED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CA2JtD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACrC,eAAe,CAkCjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,IAAI,CAAC,YAAmB,GACrC,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAwB1E;AAshCD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,GAAG,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAycvE,KAAK,SAAS,GACZ,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAM9E,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAajE;AAWD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,WAAW,GAAE,MAAM,EAAiB,EACpC,UAAU,SAAK,GACd,SAAS,GAAG,SAAS,CAkDvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClC,KAAK,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAChC;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAkB5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClC,IAAI,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAChC,IAAI,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC/B,IAAI,CAcN;AA8BD,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,eAAe,GAAG,cAAc,CAAC;IAC/C;uDACmD;IACnD,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,YAAY,EACjB,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACxB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACvB,IAAI,CA8LN"}
1
+ {"version":3,"file":"rescue-core.d.ts","sourceRoot":"","sources":["../../src/cli/rescue-core.ts"],"names":[],"mappings":"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"}
@@ -327,6 +327,7 @@ export function parseRescueArgs(argv) {
327
327
  backupRoot: process.env.HQ_BACKUP_DIR || path.join(os.homedir(), ".hq", "backups"),
328
328
  backupRetentionDays: process.env.HQ_BACKUP_RETENTION_DAYS || "7",
329
329
  backupRetentionCount: process.env.HQ_BACKUP_RETENTION_COUNT || "2",
330
+ resolveRecoverySnapshots: false,
330
331
  };
331
332
  const usage = () => {
332
333
  // The legacy script printed its comment header here; we emit a concise
@@ -335,7 +336,7 @@ export function parseRescueArgs(argv) {
335
336
  " [--preserve PATH]... [--preserve-subpath REL]...\n" +
336
337
  " [--hq-root DIR] [--no-history-check] [--floor-sha SHA]\n" +
337
338
  " [--no-backup] [--backup-dir DIR] [--cloud-update]\n" +
338
- " [--dry-run] [--yes]\n");
339
+ " [--resolve-recovery-snapshots] [--dry-run] [--yes]\n");
339
340
  throw new ExitError(1);
340
341
  };
341
342
  let narrowCsv = "";
@@ -384,6 +385,9 @@ export function parseRescueArgs(argv) {
384
385
  case "--backup-dir":
385
386
  cfg.backupRoot = need(a);
386
387
  break;
388
+ case "--resolve-recovery-snapshots":
389
+ cfg.resolveRecoverySnapshots = true;
390
+ break;
387
391
  case "--dry-run":
388
392
  cfg.dryRun = true;
389
393
  break;
@@ -1012,6 +1016,15 @@ function doRescue(cfg, env, out, err, setTmp) {
1012
1016
  throw new ExitError(overlayPreflight.status || 1);
1013
1017
  }
1014
1018
  ctx.actions = buildRescueActions(ctx);
1019
+ // Permission preflight is deliberately before snapshot allocation. A
1020
+ // root-owned release tree (EACCES on rename/delete) used to allocate a
1021
+ // snapshot, fail apply twice, and then freeze rescue behind the
1022
+ // recovery-required circuit breaker. Fail closed with no snapshot instead.
1023
+ const unwritable = collectUnwritableRescueMutationPaths(hqRoot, ctx.actions);
1024
+ if (unwritable.length > 0) {
1025
+ reportUnwritableRescuePaths(hqRoot, unwritable, err);
1026
+ throw new ExitError(1);
1027
+ }
1015
1028
  // Snapshot allocation is deliberately after the entire read-only walk and
1016
1029
  // action-plan build. A no-op (or a classifier fault above) cannot consume
1017
1030
  // backup space.
@@ -1025,9 +1038,15 @@ function doRescue(cfg, env, out, err, setTmp) {
1025
1038
  const prePlan = pruneManagedBackups(cfg, hqRoot, out, false);
1026
1039
  const unresolved = prePlan.protected.filter((x) => x.reason === "recovery-required-no-later-good");
1027
1040
  if (unresolved.length >= 2) {
1028
- err("error: safety snapshot circuit breaker is open: two unresolved recovery-required snapshots exist.\n");
1029
- err(" Inspect/restore those snapshots and repair the release source before retrying (operator override required).\n");
1030
- throw new ExitError(1);
1041
+ const snapshotNames = unresolved.map((x) => x.entry.name);
1042
+ writeRescueBlockedMarker(hqRoot, snapshotNames);
1043
+ if (!cfg.resolveRecoverySnapshots) {
1044
+ err("error: safety snapshot circuit breaker is open: two unresolved recovery-required snapshots exist.\n");
1045
+ err(" Inspect/restore those snapshots and repair the release source before retrying (operator override required).\n");
1046
+ err(" Re-run with --resolve-recovery-snapshots to move those snapshot directories aside (never deleted) and continue.\n");
1047
+ throw new ExitError(1);
1048
+ }
1049
+ resolveRecoveryRequiredSnapshots(cfg.backupRoot, RUN_TS, snapshotNames, out);
1031
1050
  }
1032
1051
  requireBackupCapacity(cfg, hqRoot, wipeToplevel, env, err);
1033
1052
  fs.mkdirSync(cfg.backupRoot, { recursive: true });
@@ -1319,6 +1338,7 @@ function doRescue(cfg, env, out, err, setTmp) {
1319
1338
  if (cfg.doBackup && backupDir) {
1320
1339
  out(` A filtered pre-update snapshot is at ${backupDir} (RECOVERY.md explains restore).\n`);
1321
1340
  }
1341
+ clearRescueBlockedMarker(hqRoot);
1322
1342
  return { status: 0 };
1323
1343
  }
1324
1344
  catch (error) {
@@ -2410,10 +2430,11 @@ function renderDryRunDecision(ctx, decision) {
2410
2430
  }
2411
2431
  function buildRescueActions(ctx) {
2412
2432
  const actions = [];
2413
- const add = (label, affectedRels, runAction) => {
2433
+ const add = (label, affectedRels, runAction, destParentRels = []) => {
2414
2434
  actions.push({
2415
2435
  label,
2416
2436
  affectedRels,
2437
+ destParentRels,
2417
2438
  expectedPaths: affectedRels.map((rel) => ({
2418
2439
  rel,
2419
2440
  kind: rescuePathKind(path.join(ctx.hqRoot, rel)),
@@ -2452,7 +2473,7 @@ function buildRescueActions(ctx) {
2452
2473
  });
2453
2474
  break;
2454
2475
  case "user-edit-diff-append":
2455
- add(`rescue diff-append: ${decision.rel}`, [decision.rel], () => rescueOne(ctx, decision.rel));
2476
+ add(`rescue diff-append: ${decision.rel}`, [decision.rel], () => rescueOne(ctx, decision.rel), [path.posix.dirname(mapRescueTarget(decision.rel))]);
2456
2477
  break;
2457
2478
  case "user-edit-overwrite-safe":
2458
2479
  add(`overwrite-safe: ${decision.rel}`, [decision.rel], () => {
@@ -2473,10 +2494,12 @@ function buildRescueActions(ctx) {
2473
2494
  });
2474
2495
  break;
2475
2496
  case "user-edit-conflict":
2476
- add(`conflict quarantine: ${decision.rel}`, [decision.rel], () => conflictOne(ctx, decision.rel));
2497
+ add(`conflict quarantine: ${decision.rel}`, [decision.rel], () => conflictOne(ctx, decision.rel), [
2498
+ path.posix.dirname(`.hq-conflicts/rescue-${ctx.runTs}/${decision.rel}`),
2499
+ ]);
2477
2500
  break;
2478
2501
  case "user-edit-rescue":
2479
- add(`rescue: ${decision.rel}`, [decision.rel], () => rescueOne(ctx, decision.rel));
2502
+ add(`rescue: ${decision.rel}`, [decision.rel], () => rescueOne(ctx, decision.rel), [path.posix.dirname(mapRescueTarget(decision.rel))]);
2480
2503
  break;
2481
2504
  case "unchanged-preserve":
2482
2505
  add(`preserve unchanged: ${decision.rel}`, [], () => {
@@ -2749,6 +2772,142 @@ function restoreMtimesFromGit(srcDir, env, out) {
2749
2772
  }
2750
2773
  }
2751
2774
  }
2775
+ const RESCUE_BLOCKED_MARKER_REL = ".hq/rescue-blocked.json";
2776
+ const RESCUE_BLOCKED_REASON = "recovery-snapshot-breaker";
2777
+ function posixRelFromRoot(hqRoot, abs) {
2778
+ const root = path.resolve(hqRoot);
2779
+ const resolved = path.resolve(abs);
2780
+ if (resolved === root)
2781
+ return ".";
2782
+ const prefix = root.endsWith(path.sep) ? root : root + path.sep;
2783
+ if (resolved.startsWith(prefix)) {
2784
+ return resolved.slice(prefix.length).split(path.sep).join("/");
2785
+ }
2786
+ return resolved;
2787
+ }
2788
+ function firstExistingAncestor(abs) {
2789
+ let current = abs;
2790
+ for (;;) {
2791
+ if (lexists(current))
2792
+ return current;
2793
+ const parent = path.dirname(current);
2794
+ if (parent === current)
2795
+ return null;
2796
+ current = parent;
2797
+ }
2798
+ }
2799
+ function canWrite(abs) {
2800
+ try {
2801
+ fs.accessSync(abs, fs.constants.W_OK);
2802
+ return true;
2803
+ }
2804
+ catch {
2805
+ return false;
2806
+ }
2807
+ }
2808
+ function topLevelRel(rel) {
2809
+ const normalized = rel.replace(/\\/g, "/").replace(/^\.\//, "");
2810
+ if (normalized === "." || normalized === "")
2811
+ return ".";
2812
+ return normalized.split("/")[0] ?? ".";
2813
+ }
2814
+ /**
2815
+ * Paths the current process cannot write among the action plan's rename/delete
2816
+ * sources (and their parents) plus rename destination parents. Empty means the
2817
+ * plan is writable; a non-empty result must refuse before allocating a snapshot.
2818
+ */
2819
+ export function collectUnwritableRescueMutationPaths(hqRoot, actions) {
2820
+ const failed = new Set();
2821
+ const note = (abs) => {
2822
+ failed.add(posixRelFromRoot(hqRoot, abs));
2823
+ };
2824
+ const checkParent = (abs) => {
2825
+ const existing = firstExistingAncestor(abs);
2826
+ if (!existing || !canWrite(existing))
2827
+ note(existing ?? abs);
2828
+ };
2829
+ for (const action of actions) {
2830
+ for (const rel of action.affectedRels) {
2831
+ if (!rel)
2832
+ continue;
2833
+ const abs = path.join(hqRoot, rel);
2834
+ const st = lstatOrNull(abs);
2835
+ if (st && !st.isSymbolicLink() && !canWrite(abs))
2836
+ note(abs);
2837
+ checkParent(path.dirname(abs));
2838
+ }
2839
+ for (const rel of action.destParentRels ?? []) {
2840
+ if (!rel || rel === ".")
2841
+ continue;
2842
+ checkParent(path.join(hqRoot, rel));
2843
+ }
2844
+ }
2845
+ return [...failed].sort();
2846
+ }
2847
+ function reportUnwritableRescuePaths(hqRoot, unwritable, err) {
2848
+ const shown = unwritable.slice(0, 10);
2849
+ err("error: cannot write the paths rescue would rename or delete (permission denied).\n");
2850
+ err(" Refusing before a safety snapshot is allocated so this cannot trip the recovery-snapshot circuit breaker.\n");
2851
+ err(unwritable.length > 10
2852
+ ? ` Unwritable paths (showing 10 of ${unwritable.length}):\n`
2853
+ : " Unwritable paths:\n");
2854
+ for (const rel of shown)
2855
+ err(` ${rel}\n`);
2856
+ const uid = typeof process.getuid === "function" ? String(process.getuid()) : "<uid>";
2857
+ const gid = typeof process.getgid === "function" ? String(process.getgid()) : "<gid>";
2858
+ const tops = [
2859
+ ...new Set(unwritable.map((rel) => topLevelRel(rel)).filter((top) => top !== ".")),
2860
+ ].sort();
2861
+ err(" Repair ownership, then retry:\n");
2862
+ if (tops.length === 0) {
2863
+ err(` chown -R ${uid}:${gid} ${hqRoot}\n`);
2864
+ }
2865
+ else {
2866
+ for (const top of tops) {
2867
+ err(` chown -R ${uid}:${gid} ${path.join(hqRoot, top)}\n`);
2868
+ }
2869
+ }
2870
+ }
2871
+ function rescueBlockedMarkerPath(hqRoot) {
2872
+ return path.join(hqRoot, RESCUE_BLOCKED_MARKER_REL);
2873
+ }
2874
+ function writeRescueBlockedMarker(hqRoot, snapshots) {
2875
+ const body = {
2876
+ at: new Date().toISOString(),
2877
+ reason: RESCUE_BLOCKED_REASON,
2878
+ snapshots,
2879
+ hint: "Inspect/restore those snapshots and repair the release source before retrying, or re-run with --resolve-recovery-snapshots (moves the snapshot directories aside under <backup-dir>-resolved-<timestamp>/; never deletes).",
2880
+ };
2881
+ try {
2882
+ fs.mkdirSync(path.dirname(rescueBlockedMarkerPath(hqRoot)), {
2883
+ recursive: true,
2884
+ });
2885
+ fs.writeFileSync(rescueBlockedMarkerPath(hqRoot), JSON.stringify(body, null, 2) + "\n");
2886
+ }
2887
+ catch {
2888
+ /* stderr remains the operator-facing signal if .hq is unwritable */
2889
+ }
2890
+ }
2891
+ function clearRescueBlockedMarker(hqRoot) {
2892
+ try {
2893
+ fs.unlinkSync(rescueBlockedMarkerPath(hqRoot));
2894
+ }
2895
+ catch {
2896
+ /* absent is the success state */
2897
+ }
2898
+ }
2899
+ function resolveRecoveryRequiredSnapshots(backupRoot, runTs, names, out) {
2900
+ const destRoot = `${backupRoot}-resolved-${runTs}`;
2901
+ fs.mkdirSync(destRoot, { recursive: true });
2902
+ out(`==> Resolving recovery-required snapshots (--resolve-recovery-snapshots) -> ${destRoot}\n`);
2903
+ for (const name of names) {
2904
+ const from = path.join(backupRoot, name);
2905
+ const to = path.join(destRoot, name);
2906
+ fs.renameSync(from, to);
2907
+ out(` moved ${name} -> ${to}\n`);
2908
+ }
2909
+ return destRoot;
2910
+ }
2752
2911
  function allocateSnapshotDir(backupRoot, runTs, rootHash, runId) {
2753
2912
  return path.join(backupRoot, `pre-update-${runTs}-${rootHash}-${runId}`);
2754
2913
  }