@vectorize-io/hindsight-coding-agents 0.5.3 → 0.5.5

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 (48) hide show
  1. package/README.md +5 -2
  2. package/dist/antigravity-hook.js +185 -41
  3. package/dist/antigravity-stop-hook.js +114 -36
  4. package/dist/claude-hook.js +185 -41
  5. package/dist/claude-sessionstart-hook.js +292 -76
  6. package/dist/claude-stop-hook.js +114 -36
  7. package/dist/cline.js +331 -58
  8. package/dist/codex-hook.js +185 -41
  9. package/dist/codex-sessionstart-hook.js +292 -76
  10. package/dist/codex-stop-hook.js +114 -36
  11. package/dist/copilot-hook.js +185 -41
  12. package/dist/copilot-sessionstart-hook.js +292 -76
  13. package/dist/copilot-stop-hook.js +114 -36
  14. package/dist/cursor-hook.js +185 -41
  15. package/dist/cursor-sessionstart-hook.js +292 -76
  16. package/dist/cursor-stop-hook.js +114 -36
  17. package/dist/dcode-hook.js +185 -41
  18. package/dist/dcode-sessionstart-hook.js +292 -76
  19. package/dist/dcode-stop-hook.js +114 -36
  20. package/dist/deepen.js +93 -18
  21. package/dist/devin-hook.js +185 -41
  22. package/dist/devin-sessionstart-hook.js +292 -76
  23. package/dist/devin-stop-hook.js +114 -36
  24. package/dist/droid-hook.js +185 -41
  25. package/dist/droid-sessionstart-hook.js +292 -76
  26. package/dist/droid-stop-hook.js +114 -36
  27. package/dist/dsh.js +333 -60
  28. package/dist/grok-hook.js +185 -41
  29. package/dist/grok-sessionstart-hook.js +292 -76
  30. package/dist/grok-stop-hook.js +114 -36
  31. package/dist/index.js +333 -60
  32. package/dist/installer.js +1030 -268
  33. package/dist/kilo.js +333 -60
  34. package/dist/mcp-server.js +86 -11
  35. package/dist/opencode2.js +333 -60
  36. package/dist/pi.js +332 -59
  37. package/dist/prime-agent.js +332 -59
  38. package/dist/qwen-hook.js +185 -41
  39. package/dist/qwen-sessionstart-hook.js +292 -76
  40. package/dist/qwen-stop-hook.js +114 -36
  41. package/dist/status.js +84 -9
  42. package/dist/survey-supervisor.js +81 -0
  43. package/dist/zcode-hook.js +185 -41
  44. package/dist/zcode-sessionstart-hook.js +292 -76
  45. package/dist/zcode-stop-hook.js +114 -36
  46. package/package.json +2 -1
  47. package/plugin.json +1 -1
  48. package/skill/SKILL.md +5 -2
@@ -629,6 +629,22 @@ var KnowledgePagesUnavailableError = class extends Error {
629
629
  }
630
630
  };
631
631
  var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled", "error"]);
632
+ var ReflectError = class extends Error {
633
+ constructor(message, status, timedOut, options) {
634
+ super(message, options);
635
+ this.status = status;
636
+ this.timedOut = timedOut;
637
+ this.name = "ReflectError";
638
+ }
639
+ status;
640
+ timedOut;
641
+ /** A timeout or a 5xx means reflect's synthesis (the slow LLM path) broke, while the cheap
642
+ * retrieval endpoints may still answer — worth falling back. A 4xx will fail the same way on
643
+ * every endpoint (auth, missing bank), so it is not. */
644
+ get fallbackEligible() {
645
+ return this.timedOut || this.status !== void 0 && this.status >= 500;
646
+ }
647
+ };
632
648
  var DEFAULT_MAX_PARALLEL_RETAINS = 10;
633
649
  var POLL_CYCLE_MS = 5e3;
634
650
  var RETRY_AFTER_FLOOR_MS = 10 * 1e3;
@@ -712,11 +728,11 @@ var HindsightClient = class {
712
728
  return `${this.apiUrl}/v1/default/banks/${encodeURIComponent(this.bank)}${suffix}`;
713
729
  }
714
730
  /** `tolerate` adds statuses that are returned to the caller instead of thrown (404 always is). */
715
- async req(method, url, body, tolerate = []) {
731
+ async req(method, url, body, tolerate = [], timeoutMs = 15e3) {
716
732
  const r = await this.fetchWithAuth(url, {
717
733
  method,
718
734
  body: body ? JSON.stringify(body) : void 0,
719
- signal: AbortSignal.timeout(15e3)
735
+ signal: AbortSignal.timeout(timeoutMs)
720
736
  });
721
737
  if (r.status === 429 && !tolerate.includes(429))
722
738
  throw new RateLimitedError(retryAfterMs(r.headers.get("retry-after")));
@@ -909,7 +925,7 @@ var HindsightClient = class {
909
925
  /**
910
926
  * Reflect: synthesized, root-cause answer over the bank. Bounded so a slow server never hangs a
911
927
  * caller — but `timeoutMs` is REQUIRED, deliberately: the right deadline differs by an order of
912
- * magnitude between the automatic hook (25s, to fit the host's window) and the agent-invoked
928
+ * magnitude between the automatic hook (20s, to fit the host's window) and the agent-invoked
913
929
  * tool (minutes, on a populated bank). This used to default to 120s, which silently overrode the
914
930
  * tool's configured window and aborted every high-budget synthesis mid-flight (#3590).
915
931
  */
@@ -922,13 +938,46 @@ var HindsightClient = class {
922
938
  body: JSON.stringify({ query, budget: opts.budget ?? "high" }),
923
939
  signal: ctrl.signal
924
940
  });
925
- if (!resp.ok) throw new Error(`reflect ${resp.status}${this.authHint(resp.status)}`);
941
+ if (!resp.ok)
942
+ throw new ReflectError(
943
+ `reflect ${resp.status} ${(await resp.text()).slice(0, 1e3)}${this.authHint(resp.status)}`,
944
+ resp.status,
945
+ false
946
+ );
926
947
  const data = await resp.json();
927
948
  return (data.text || "").trim();
949
+ } catch (e) {
950
+ if (ctrl.signal.aborted)
951
+ throw new ReflectError(`reflect timed out after ${opts.timeoutMs}ms`, void 0, true, {
952
+ cause: e
953
+ });
954
+ throw e;
928
955
  } finally {
929
956
  clearTimeout(timer);
930
957
  }
931
958
  }
959
+ /**
960
+ * Raw recall restricted to consolidated observations — no LLM in the loop, so it still answers
961
+ * when reflect's synthesis times out or 5xxs. Returns the observation texts in rank order.
962
+ */
963
+ async recallObservations(query, opts) {
964
+ const r = await this.req(
965
+ "POST",
966
+ this.bankUrl("/memories/recall"),
967
+ {
968
+ query,
969
+ types: ["observation"],
970
+ budget: "low",
971
+ max_tokens: opts.maxTokens,
972
+ include: { entities: null }
973
+ },
974
+ [],
975
+ opts.timeoutMs
976
+ );
977
+ if (r.status === 404) return [];
978
+ const j = await r.json();
979
+ return (j.results ?? []).map((x) => (x.text ?? "").trim()).filter(Boolean);
980
+ }
932
981
  /**
933
982
  * The bank's knowledge-base tree (folders + pages, nested). The tree carries names, source
934
983
  * queries and staleness but NOT synthesized content, so it is cheap enough to poll.
@@ -993,10 +1042,16 @@ var HindsightClient = class {
993
1042
  /** Hybrid (BM25 + vector, RRF-fused) server-side search over the bank's knowledge pages.
994
1043
  * Returns page-level hits with a relevance snippet — the real search behind
995
1044
  * hindsight_search_knowledge_pages. */
996
- async searchKnowledgePages(query, limit = 3) {
1045
+ async searchKnowledgePages(query, limit = 3, timeoutMs) {
997
1046
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
998
1047
  const q = `?q=${encodeURIComponent(query)}&limit=${limit}`;
999
- const r = await this.req("GET", this.bankUrl(`/knowledge-base/search${q}`));
1048
+ const r = await this.req(
1049
+ "GET",
1050
+ this.bankUrl(`/knowledge-base/search${q}`),
1051
+ void 0,
1052
+ [],
1053
+ timeoutMs
1054
+ );
1000
1055
  const j = await r.json();
1001
1056
  return (j.results ?? []).map((x) => ({
1002
1057
  id: x.id,
@@ -2173,7 +2228,7 @@ async function runRetainHook(spec, makeClient = (o) => new HindsightClient(o)) {
2173
2228
  }
2174
2229
 
2175
2230
  // src/core/session-start.ts
2176
- import { readFileSync as readFileSync9 } from "fs";
2231
+ import { readFileSync as readFileSync10 } from "fs";
2177
2232
 
2178
2233
  // src/core/git.ts
2179
2234
  import { execFileSync as execFileSync2 } from "child_process";
@@ -2183,24 +2238,42 @@ import { resolve as resolve2 } from "path";
2183
2238
  import { execFileSync as execFileSync3 } from "child_process";
2184
2239
 
2185
2240
  // src/core/survey.ts
2186
- import { spawn as realSpawn3 } from "child_process";
2241
+ import { spawn as realSpawn4 } from "child_process";
2242
+ import { createHash as createHash4 } from "crypto";
2187
2243
  import { existsSync as existsSync3 } from "fs";
2188
- import { homedir as homedir3 } from "os";
2189
- import { dirname as dirname8, join as join10 } from "path";
2244
+ import { homedir as homedir3, tmpdir as tmpdir4 } from "os";
2245
+ import { dirname as dirname8, join as join11 } from "path";
2190
2246
  import { fileURLToPath as fileURLToPath3 } from "url";
2191
2247
 
2248
+ // src/core/survey-lease.ts
2249
+ import { spawn as realSpawn3 } from "child_process";
2250
+ import { randomUUID } from "crypto";
2251
+ import {
2252
+ mkdirSync as mkdirSync4,
2253
+ mkdtempSync,
2254
+ readdirSync,
2255
+ renameSync as renameSync2,
2256
+ rmdirSync,
2257
+ rmSync as rmSync2,
2258
+ statSync as statSync3,
2259
+ unlinkSync,
2260
+ utimesSync,
2261
+ writeFileSync as writeFileSync2
2262
+ } from "fs";
2263
+ import { join as join10 } from "path";
2264
+
2192
2265
  // src/core/auto-update.ts
2193
- import { spawn as realSpawn4 } from "child_process";
2266
+ import { spawn as realSpawn5 } from "child_process";
2194
2267
  import {
2195
2268
  existsSync as existsSync4,
2196
- mkdirSync as mkdirSync4,
2269
+ mkdirSync as mkdirSync5,
2197
2270
  readFileSync as readFileSync7,
2198
2271
  realpathSync as realpathSync2,
2199
- unlinkSync,
2200
- writeFileSync as writeFileSync2
2272
+ unlinkSync as unlinkSync2,
2273
+ writeFileSync as writeFileSync3
2201
2274
  } from "fs";
2202
- import { homedir as homedir4, tmpdir as tmpdir4 } from "os";
2203
- import { dirname as dirname9, join as join11 } from "path";
2275
+ import { homedir as homedir4, tmpdir as tmpdir5 } from "os";
2276
+ import { dirname as dirname9, join as join12 } from "path";
2204
2277
  import { fileURLToPath as fileURLToPath4 } from "url";
2205
2278
  var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
2206
2279
  var LOCK_STALE_MS = 10 * 60 * 1e3;
@@ -2208,9 +2281,14 @@ var LOCK_STALE_MS = 10 * 60 * 1e3;
2208
2281
  // src/core/skill-sync.ts
2209
2282
  import { cpSync, existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
2210
2283
  import { homedir as homedir5 } from "os";
2211
- import { dirname as dirname10, join as join12 } from "path";
2284
+ import { dirname as dirname10, join as join13 } from "path";
2212
2285
  import { fileURLToPath as fileURLToPath5 } from "url";
2213
2286
 
2287
+ // src/core/legacy.ts
2288
+ import { existsSync as existsSync6, readFileSync as readFileSync9 } from "fs";
2289
+ import { homedir as homedir6 } from "os";
2290
+ import { join as join14, relative, isAbsolute as isAbsolute2 } from "path";
2291
+
2214
2292
  // src/core/transcript-codex.ts
2215
2293
  function isSyntheticUserText(text) {
2216
2294
  const s = text.trimStart();
@@ -2341,19 +2419,19 @@ function readCopilotTranscript(path) {
2341
2419
  }
2342
2420
 
2343
2421
  // src/core/transcript-grok.ts
2344
- import { existsSync as existsSync6, readFileSync as readFileSync10, readdirSync } from "fs";
2345
- import { homedir as homedir6 } from "os";
2346
- import { join as join13 } from "path";
2422
+ import { existsSync as existsSync7, readFileSync as readFileSync11, readdirSync as readdirSync2 } from "fs";
2423
+ import { homedir as homedir7 } from "os";
2424
+ import { join as join15 } from "path";
2347
2425
  var CHAT_HISTORY = "chat_history.jsonl";
2348
- function grokTranscriptPath(cwd, sessionId, grokHome = process.env.GROK_HOME || join13(homedir6(), ".grok")) {
2349
- const sessionsDir = join13(grokHome, "sessions");
2350
- const direct = join13(sessionsDir, encodeURIComponent(cwd), sessionId, CHAT_HISTORY);
2351
- if (existsSync6(direct)) return direct;
2426
+ function grokTranscriptPath(cwd, sessionId, grokHome = process.env.GROK_HOME || join15(homedir7(), ".grok")) {
2427
+ const sessionsDir = join15(grokHome, "sessions");
2428
+ const direct = join15(sessionsDir, encodeURIComponent(cwd), sessionId, CHAT_HISTORY);
2429
+ if (existsSync7(direct)) return direct;
2352
2430
  try {
2353
- for (const candidate of readdirSync(sessionsDir)) {
2354
- const directory = join13(sessionsDir, candidate);
2355
- if (readFileSync10(join13(directory, ".cwd"), "utf8").trim() === cwd) {
2356
- return join13(directory, sessionId, CHAT_HISTORY);
2431
+ for (const candidate of readdirSync2(sessionsDir)) {
2432
+ const directory = join15(sessionsDir, candidate);
2433
+ if (readFileSync11(join15(directory, ".cwd"), "utf8").trim() === cwd) {
2434
+ return join15(directory, sessionId, CHAT_HISTORY);
2357
2435
  }
2358
2436
  }
2359
2437
  } catch {
@@ -2388,12 +2466,12 @@ function readGrokTranscript(path) {
2388
2466
  }
2389
2467
 
2390
2468
  // src/core/transcript-devin.ts
2391
- import { existsSync as existsSync7 } from "fs";
2469
+ import { existsSync as existsSync8 } from "fs";
2392
2470
  import { createRequire } from "module";
2393
- import { homedir as homedir7 } from "os";
2394
- import { join as join14 } from "path";
2395
- function devinSessionDb(home = homedir7()) {
2396
- return join14(home, ".local", "share", "devin", "cli", "sessions.db");
2471
+ import { homedir as homedir8 } from "os";
2472
+ import { join as join16 } from "path";
2473
+ function devinSessionDb(home = homedir8()) {
2474
+ return join16(home, ".local", "share", "devin", "cli", "sessions.db");
2397
2475
  }
2398
2476
  function parseDevinMessages(nodes) {
2399
2477
  const messages = /* @__PURE__ */ new Map();
@@ -2430,7 +2508,7 @@ function readDevinTranscript(sessionId, dbPath = devinSessionDb()) {
2430
2508
  diag("devin-cli", "sqlite_unavailable", { node: process.version, dbPath });
2431
2509
  return [];
2432
2510
  }
2433
- if (!existsSync7(dbPath)) {
2511
+ if (!existsSync8(dbPath)) {
2434
2512
  diag("devin-cli", "session_db_missing", { dbPath });
2435
2513
  return [];
2436
2514
  }
@@ -2703,7 +2781,7 @@ function readDroidTranscript(path) {
2703
2781
  }
2704
2782
 
2705
2783
  // src/core/transcript-zcode.ts
2706
- import { readFileSync as readFileSync11 } from "fs";
2784
+ import { readFileSync as readFileSync12 } from "fs";
2707
2785
  function messageText2(content) {
2708
2786
  if (typeof content === "string") return content.trim();
2709
2787
  if (!Array.isArray(content)) return "";
@@ -2713,7 +2791,7 @@ function readZcodeTranscript(path) {
2713
2791
  if (!path) return [];
2714
2792
  let body;
2715
2793
  try {
2716
- body = readFileSync11(path, "utf8");
2794
+ body = readFileSync12(path, "utf8");
2717
2795
  } catch {
2718
2796
  return [];
2719
2797
  }
package/dist/status.js CHANGED
@@ -609,6 +609,22 @@ var KnowledgePagesUnavailableError = class extends Error {
609
609
  }
610
610
  };
611
611
  var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled", "error"]);
612
+ var ReflectError = class extends Error {
613
+ constructor(message, status, timedOut, options) {
614
+ super(message, options);
615
+ this.status = status;
616
+ this.timedOut = timedOut;
617
+ this.name = "ReflectError";
618
+ }
619
+ status;
620
+ timedOut;
621
+ /** A timeout or a 5xx means reflect's synthesis (the slow LLM path) broke, while the cheap
622
+ * retrieval endpoints may still answer — worth falling back. A 4xx will fail the same way on
623
+ * every endpoint (auth, missing bank), so it is not. */
624
+ get fallbackEligible() {
625
+ return this.timedOut || this.status !== void 0 && this.status >= 500;
626
+ }
627
+ };
612
628
  var DEFAULT_MAX_PARALLEL_RETAINS = 10;
613
629
  var POLL_CYCLE_MS = 5e3;
614
630
  var RETRY_AFTER_FLOOR_MS = 10 * 1e3;
@@ -692,11 +708,11 @@ var HindsightClient = class {
692
708
  return `${this.apiUrl}/v1/default/banks/${encodeURIComponent(this.bank)}${suffix}`;
693
709
  }
694
710
  /** `tolerate` adds statuses that are returned to the caller instead of thrown (404 always is). */
695
- async req(method, url, body, tolerate = []) {
711
+ async req(method, url, body, tolerate = [], timeoutMs = 15e3) {
696
712
  const r = await this.fetchWithAuth(url, {
697
713
  method,
698
714
  body: body ? JSON.stringify(body) : void 0,
699
- signal: AbortSignal.timeout(15e3)
715
+ signal: AbortSignal.timeout(timeoutMs)
700
716
  });
701
717
  if (r.status === 429 && !tolerate.includes(429))
702
718
  throw new RateLimitedError(retryAfterMs(r.headers.get("retry-after")));
@@ -889,7 +905,7 @@ var HindsightClient = class {
889
905
  /**
890
906
  * Reflect: synthesized, root-cause answer over the bank. Bounded so a slow server never hangs a
891
907
  * caller — but `timeoutMs` is REQUIRED, deliberately: the right deadline differs by an order of
892
- * magnitude between the automatic hook (25s, to fit the host's window) and the agent-invoked
908
+ * magnitude between the automatic hook (20s, to fit the host's window) and the agent-invoked
893
909
  * tool (minutes, on a populated bank). This used to default to 120s, which silently overrode the
894
910
  * tool's configured window and aborted every high-budget synthesis mid-flight (#3590).
895
911
  */
@@ -902,13 +918,46 @@ var HindsightClient = class {
902
918
  body: JSON.stringify({ query, budget: opts.budget ?? "high" }),
903
919
  signal: ctrl.signal
904
920
  });
905
- if (!resp.ok) throw new Error(`reflect ${resp.status}${this.authHint(resp.status)}`);
921
+ if (!resp.ok)
922
+ throw new ReflectError(
923
+ `reflect ${resp.status} ${(await resp.text()).slice(0, 1e3)}${this.authHint(resp.status)}`,
924
+ resp.status,
925
+ false
926
+ );
906
927
  const data = await resp.json();
907
928
  return (data.text || "").trim();
929
+ } catch (e) {
930
+ if (ctrl.signal.aborted)
931
+ throw new ReflectError(`reflect timed out after ${opts.timeoutMs}ms`, void 0, true, {
932
+ cause: e
933
+ });
934
+ throw e;
908
935
  } finally {
909
936
  clearTimeout(timer);
910
937
  }
911
938
  }
939
+ /**
940
+ * Raw recall restricted to consolidated observations — no LLM in the loop, so it still answers
941
+ * when reflect's synthesis times out or 5xxs. Returns the observation texts in rank order.
942
+ */
943
+ async recallObservations(query, opts) {
944
+ const r = await this.req(
945
+ "POST",
946
+ this.bankUrl("/memories/recall"),
947
+ {
948
+ query,
949
+ types: ["observation"],
950
+ budget: "low",
951
+ max_tokens: opts.maxTokens,
952
+ include: { entities: null }
953
+ },
954
+ [],
955
+ opts.timeoutMs
956
+ );
957
+ if (r.status === 404) return [];
958
+ const j = await r.json();
959
+ return (j.results ?? []).map((x) => (x.text ?? "").trim()).filter(Boolean);
960
+ }
912
961
  /**
913
962
  * The bank's knowledge-base tree (folders + pages, nested). The tree carries names, source
914
963
  * queries and staleness but NOT synthesized content, so it is cheap enough to poll.
@@ -973,10 +1022,16 @@ var HindsightClient = class {
973
1022
  /** Hybrid (BM25 + vector, RRF-fused) server-side search over the bank's knowledge pages.
974
1023
  * Returns page-level hits with a relevance snippet — the real search behind
975
1024
  * hindsight_search_knowledge_pages. */
976
- async searchKnowledgePages(query, limit = 3) {
1025
+ async searchKnowledgePages(query, limit = 3, timeoutMs) {
977
1026
  if (this.knowledgePagesSupported === false) throw new KnowledgePagesUnavailableError();
978
1027
  const q = `?q=${encodeURIComponent(query)}&limit=${limit}`;
979
- const r = await this.req("GET", this.bankUrl(`/knowledge-base/search${q}`));
1028
+ const r = await this.req(
1029
+ "GET",
1030
+ this.bankUrl(`/knowledge-base/search${q}`),
1031
+ void 0,
1032
+ [],
1033
+ timeoutMs
1034
+ );
980
1035
  const j = await r.json();
981
1036
  return (j.results ?? []).map((x) => ({
982
1037
  id: x.id,
@@ -1458,11 +1513,31 @@ function parsePageList(raw) {
1458
1513
  }
1459
1514
 
1460
1515
  // src/core/survey.ts
1461
- import { spawn as realSpawn2 } from "child_process";
1516
+ import { spawn as realSpawn3 } from "child_process";
1517
+ import { createHash as createHash2 } from "crypto";
1462
1518
  import { existsSync as existsSync2 } from "fs";
1463
- import { homedir as homedir3 } from "os";
1464
- import { dirname as dirname5, join as join7 } from "path";
1519
+ import { homedir as homedir3, tmpdir as tmpdir2 } from "os";
1520
+ import { dirname as dirname5, join as join8 } from "path";
1465
1521
  import { fileURLToPath as fileURLToPath2 } from "url";
1522
+
1523
+ // src/core/survey-lease.ts
1524
+ import { spawn as realSpawn2 } from "child_process";
1525
+ import { randomUUID } from "crypto";
1526
+ import {
1527
+ mkdirSync as mkdirSync2,
1528
+ mkdtempSync,
1529
+ readdirSync,
1530
+ renameSync,
1531
+ rmdirSync,
1532
+ rmSync,
1533
+ statSync,
1534
+ unlinkSync,
1535
+ utimesSync,
1536
+ writeFileSync
1537
+ } from "fs";
1538
+ import { join as join7 } from "path";
1539
+
1540
+ // src/core/survey.ts
1466
1541
  var SURVEY_DOC_IDS = [
1467
1542
  "repository-component-map",
1468
1543
  "repository-core-concepts",
@@ -0,0 +1,81 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/core/survey-lease.ts
4
+ import { spawn as realSpawn } from "child_process";
5
+ import { randomUUID } from "crypto";
6
+ import {
7
+ mkdirSync,
8
+ mkdtempSync,
9
+ readdirSync,
10
+ renameSync,
11
+ rmdirSync,
12
+ rmSync,
13
+ statSync,
14
+ unlinkSync,
15
+ utimesSync,
16
+ writeFileSync
17
+ } from "fs";
18
+ import { join } from "path";
19
+ var LEASE_HEARTBEAT_MS = 5e3;
20
+ var SURVEY_SPEC_ENV = "HINDSIGHT_SURVEY_SPEC";
21
+ function releaseLease(lease) {
22
+ try {
23
+ unlinkSync(join(lease.directory, lease.owner));
24
+ } catch {
25
+ return;
26
+ }
27
+ try {
28
+ rmdirSync(lease.directory);
29
+ } catch {
30
+ }
31
+ }
32
+ function heartbeatLease(lease) {
33
+ try {
34
+ const now = /* @__PURE__ */ new Date();
35
+ utimesSync(join(lease.directory, lease.owner), now, now);
36
+ return true;
37
+ } catch (error) {
38
+ return error.code !== "ENOENT";
39
+ }
40
+ }
41
+ function superviseSurvey(spec2, spawnFn = realSpawn) {
42
+ let stop = () => {
43
+ };
44
+ const done = new Promise((resolve) => {
45
+ if (!heartbeatLease(spec2.lease)) return resolve();
46
+ let child;
47
+ try {
48
+ child = spawnFn(spec2.bin, spec2.args, { stdio: "ignore", windowsHide: true });
49
+ } catch {
50
+ releaseLease(spec2.lease);
51
+ return resolve();
52
+ }
53
+ let finished = false;
54
+ const finish = (release) => {
55
+ if (finished) return;
56
+ finished = true;
57
+ clearInterval(timer);
58
+ if (release) releaseLease(spec2.lease);
59
+ resolve();
60
+ };
61
+ const timer = setInterval(() => {
62
+ if (heartbeatLease(spec2.lease)) return;
63
+ child.kill();
64
+ finish(false);
65
+ }, spec2.heartbeatMs ?? LEASE_HEARTBEAT_MS);
66
+ child.on("error", () => finish(true));
67
+ child.once("exit", () => finish(true));
68
+ stop = () => {
69
+ child.kill();
70
+ finish(true);
71
+ };
72
+ });
73
+ return { done, stop: () => stop() };
74
+ }
75
+
76
+ // src/survey-supervisor.ts
77
+ var spec = JSON.parse(process.env[SURVEY_SPEC_ENV] ?? "");
78
+ delete process.env[SURVEY_SPEC_ENV];
79
+ var run = superviseSurvey(spec);
80
+ for (const signal of ["SIGTERM", "SIGINT", "SIGHUP"]) process.once(signal, run.stop);
81
+ void run.done;