@indigoai-us/hq-cloud 5.1.0 → 5.1.8

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 (100) hide show
  1. package/dist/bin/sync-runner.d.ts +111 -0
  2. package/dist/bin/sync-runner.d.ts.map +1 -0
  3. package/dist/bin/sync-runner.js +285 -0
  4. package/dist/bin/sync-runner.js.map +1 -0
  5. package/dist/bin/sync-runner.test.d.ts +10 -0
  6. package/dist/bin/sync-runner.test.d.ts.map +1 -0
  7. package/dist/bin/sync-runner.test.js +492 -0
  8. package/dist/bin/sync-runner.test.js.map +1 -0
  9. package/dist/cli/index.d.ts +1 -1
  10. package/dist/cli/index.d.ts.map +1 -1
  11. package/dist/cli/share.js +2 -2
  12. package/dist/cli/share.js.map +1 -1
  13. package/dist/cli/share.test.js +9 -1
  14. package/dist/cli/share.test.js.map +1 -1
  15. package/dist/cli/sync.d.ts +28 -0
  16. package/dist/cli/sync.d.ts.map +1 -1
  17. package/dist/cli/sync.js +33 -10
  18. package/dist/cli/sync.js.map +1 -1
  19. package/dist/cli/sync.test.js +15 -4
  20. package/dist/cli/sync.test.js.map +1 -1
  21. package/dist/cognito-auth.d.ts.map +1 -1
  22. package/dist/cognito-auth.js +19 -1
  23. package/dist/cognito-auth.js.map +1 -1
  24. package/dist/cognito-auth.test.d.ts +9 -0
  25. package/dist/cognito-auth.test.d.ts.map +1 -0
  26. package/dist/cognito-auth.test.js +113 -0
  27. package/dist/cognito-auth.test.js.map +1 -0
  28. package/dist/context.d.ts.map +1 -1
  29. package/dist/context.js +1 -0
  30. package/dist/context.js.map +1 -1
  31. package/dist/daemon-worker.d.ts +6 -1
  32. package/dist/daemon-worker.d.ts.map +1 -1
  33. package/dist/daemon-worker.js +12 -16
  34. package/dist/daemon-worker.js.map +1 -1
  35. package/dist/daemon.d.ts +2 -0
  36. package/dist/daemon.d.ts.map +1 -1
  37. package/dist/daemon.js +2 -0
  38. package/dist/daemon.js.map +1 -1
  39. package/dist/ignore.d.ts +13 -2
  40. package/dist/ignore.d.ts.map +1 -1
  41. package/dist/ignore.js +69 -12
  42. package/dist/ignore.js.map +1 -1
  43. package/dist/index.d.ts +24 -28
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +19 -134
  46. package/dist/index.js.map +1 -1
  47. package/dist/journal.d.ts +20 -4
  48. package/dist/journal.d.ts.map +1 -1
  49. package/dist/journal.js +45 -8
  50. package/dist/journal.js.map +1 -1
  51. package/dist/journal.test.d.ts +9 -0
  52. package/dist/journal.test.d.ts.map +1 -0
  53. package/dist/journal.test.js +114 -0
  54. package/dist/journal.test.js.map +1 -0
  55. package/dist/s3.d.ts +18 -6
  56. package/dist/s3.d.ts.map +1 -1
  57. package/dist/s3.js +57 -56
  58. package/dist/s3.js.map +1 -1
  59. package/dist/types.d.ts +34 -0
  60. package/dist/types.d.ts.map +1 -1
  61. package/dist/vault-client.d.ts +16 -0
  62. package/dist/vault-client.d.ts.map +1 -1
  63. package/dist/vault-client.js +19 -0
  64. package/dist/vault-client.js.map +1 -1
  65. package/dist/vault-client.test.js +25 -0
  66. package/dist/vault-client.test.js.map +1 -1
  67. package/dist/watcher.d.ts +7 -1
  68. package/dist/watcher.d.ts.map +1 -1
  69. package/dist/watcher.js +11 -5
  70. package/dist/watcher.js.map +1 -1
  71. package/package.json +15 -3
  72. package/src/bin/sync-runner.test.ts +617 -0
  73. package/src/bin/sync-runner.ts +390 -0
  74. package/src/cli/accept.ts +97 -0
  75. package/src/cli/conflict.ts +119 -0
  76. package/src/cli/index.ts +25 -0
  77. package/src/cli/invite.test.ts +247 -0
  78. package/src/cli/invite.ts +180 -0
  79. package/src/cli/promote.ts +123 -0
  80. package/src/cli/share.test.ts +155 -0
  81. package/src/cli/share.ts +212 -0
  82. package/src/cli/sync.test.ts +225 -0
  83. package/src/cli/sync.ts +225 -0
  84. package/src/cognito-auth.test.ts +156 -0
  85. package/src/cognito-auth.ts +18 -1
  86. package/src/context.test.ts +202 -0
  87. package/src/context.ts +178 -0
  88. package/src/daemon-worker.ts +13 -19
  89. package/src/daemon.ts +2 -0
  90. package/src/ignore.ts +76 -12
  91. package/src/index.ts +93 -165
  92. package/src/journal.test.ts +146 -0
  93. package/src/journal.ts +53 -11
  94. package/src/s3.ts +76 -66
  95. package/src/types.ts +37 -0
  96. package/src/vault-client.test.ts +390 -0
  97. package/src/vault-client.ts +400 -0
  98. package/src/watcher.ts +12 -5
  99. package/test/invite-flow.integration.test.ts +244 -0
  100. package/test/share-sync.integration.test.ts +210 -0
@@ -0,0 +1,111 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * hq-sync-runner — machine-targeted entrypoint for `@indigoai-us/hq-cloud`
4
+ * (ADR-0001).
5
+ *
6
+ * The AppBar Sync menubar (Tauri + Rust) spawns this binary as a subprocess
7
+ * and reads ndjson events from stdout. The protocol is intentionally narrow
8
+ * and versioned-by-shape, not by tooling — no chalk, no colors, no human
9
+ * prose. If you want to invoke sync as a human, use `hq sync` in
10
+ * `@indigoai-us/hq-cli`.
11
+ *
12
+ * Flags:
13
+ * --companies Fan out across every membership the caller has
14
+ * --company <slug-or-uid> Sync a single company (alternative to --companies)
15
+ * --on-conflict <strategy> abort | overwrite | keep (default: abort)
16
+ * --hq-root <path> Local HQ directory (default: $HOME/hq)
17
+ * --json Ignored — ndjson on stdout is the default and
18
+ * only output mode. Accepted for symmetry with the
19
+ * AppBar's argv in case someone passes it.
20
+ *
21
+ * Event protocol (one JSON object per line on stdout):
22
+ * setup-needed — caller signed in but has no person entity yet
23
+ * auth-error — no valid token available (interactive login disabled)
24
+ * fanout-plan — list of companies we're about to sync
25
+ * progress — per-file download
26
+ * error — per-file or per-company error
27
+ * complete — per-company summary
28
+ * all-complete — aggregate summary after fanout
29
+ *
30
+ * Exit code:
31
+ * 0 — event stream describes the outcome (including setup-needed)
32
+ * 1 — argv parse error or unrecoverable pre-sync failure
33
+ */
34
+ import { type VaultServiceConfig, type Membership, type EntityInfo } from "../index.js";
35
+ import type { SyncOptions, SyncResult, SyncProgressEvent } from "../cli/sync.js";
36
+ /**
37
+ * Every event emitted on stdout. The `company` field is present on every
38
+ * event except `setup-needed` / `auth-error` / `fanout-plan` / `all-complete`
39
+ * (which describe the whole run) — consumers should treat its absence as
40
+ * "meta-event, not tied to a specific company".
41
+ */
42
+ export type RunnerEvent = {
43
+ type: "setup-needed";
44
+ } | {
45
+ type: "auth-error";
46
+ message: string;
47
+ } | {
48
+ type: "fanout-plan";
49
+ companies: Array<{
50
+ uid: string;
51
+ slug: string;
52
+ }>;
53
+ } | ({
54
+ type: "progress";
55
+ company: string;
56
+ } & Omit<Extract<SyncProgressEvent, {
57
+ type: "progress";
58
+ }>, "type">) | ({
59
+ type: "error";
60
+ company?: string;
61
+ } & Omit<Extract<SyncProgressEvent, {
62
+ type: "error";
63
+ }>, "type">) | ({
64
+ type: "complete";
65
+ company: string;
66
+ } & SyncResult) | {
67
+ type: "all-complete";
68
+ companiesAttempted: number;
69
+ filesDownloaded: number;
70
+ bytesDownloaded: number;
71
+ errors: Array<{
72
+ company: string;
73
+ message: string;
74
+ }>;
75
+ };
76
+ /**
77
+ * The narrow VaultClient surface the runner actually uses. Declared here (not
78
+ * `Pick<VaultClient, ...>`) because `Pick` preserves the *entire* `entity`
79
+ * accessor object — but the runner only needs `entity.get`, and forcing test
80
+ * stubs to also implement `findBySlug`/`create` would be dishonest about the
81
+ * real dependency. Keep this interface in sync with the real VaultClient
82
+ * method signatures (both return types come straight from the SDK).
83
+ */
84
+ export interface VaultClientSurface {
85
+ listMyMemberships: () => Promise<Membership[]>;
86
+ entity: {
87
+ get: (uid: string) => Promise<EntityInfo>;
88
+ };
89
+ }
90
+ export interface RunnerDeps {
91
+ /** Where to write ndjson events. Defaults to `process.stdout`. */
92
+ stdout?: {
93
+ write: (chunk: string) => boolean | void;
94
+ };
95
+ /** Where to write diagnostics. Defaults to `process.stderr`. */
96
+ stderr?: {
97
+ write: (chunk: string) => boolean | void;
98
+ };
99
+ /** Resolve a valid access token. Defaults to `getValidAccessToken` non-interactive. */
100
+ getAccessToken?: () => Promise<string>;
101
+ /**
102
+ * Produce a VaultClient-like object. Defaults to `new VaultClient(config)`.
103
+ * Tests inject a stub here — only `listMyMemberships` and `entity.get` are
104
+ * called by the runner, so stubs only need to implement those.
105
+ */
106
+ createVaultClient?: (config: VaultServiceConfig) => VaultClientSurface;
107
+ /** Sync function. Defaults to `cli/sync.sync`. */
108
+ sync?: (options: SyncOptions) => Promise<SyncResult>;
109
+ }
110
+ export declare function runRunner(argv: string[], deps?: RunnerDeps): Promise<number>;
111
+ //# sourceMappingURL=sync-runner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AA6BxB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD,GACD,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GACxG,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GACnG,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAAC,GACpD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/C,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;KAC3C,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD,gEAAgE;IAChE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IACvE,kDAAkD;IAClD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACtD;AAiED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,MAAM,CAAC,CAqJjB"}
@@ -0,0 +1,285 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * hq-sync-runner — machine-targeted entrypoint for `@indigoai-us/hq-cloud`
4
+ * (ADR-0001).
5
+ *
6
+ * The AppBar Sync menubar (Tauri + Rust) spawns this binary as a subprocess
7
+ * and reads ndjson events from stdout. The protocol is intentionally narrow
8
+ * and versioned-by-shape, not by tooling — no chalk, no colors, no human
9
+ * prose. If you want to invoke sync as a human, use `hq sync` in
10
+ * `@indigoai-us/hq-cli`.
11
+ *
12
+ * Flags:
13
+ * --companies Fan out across every membership the caller has
14
+ * --company <slug-or-uid> Sync a single company (alternative to --companies)
15
+ * --on-conflict <strategy> abort | overwrite | keep (default: abort)
16
+ * --hq-root <path> Local HQ directory (default: $HOME/hq)
17
+ * --json Ignored — ndjson on stdout is the default and
18
+ * only output mode. Accepted for symmetry with the
19
+ * AppBar's argv in case someone passes it.
20
+ *
21
+ * Event protocol (one JSON object per line on stdout):
22
+ * setup-needed — caller signed in but has no person entity yet
23
+ * auth-error — no valid token available (interactive login disabled)
24
+ * fanout-plan — list of companies we're about to sync
25
+ * progress — per-file download
26
+ * error — per-file or per-company error
27
+ * complete — per-company summary
28
+ * all-complete — aggregate summary after fanout
29
+ *
30
+ * Exit code:
31
+ * 0 — event stream describes the outcome (including setup-needed)
32
+ * 1 — argv parse error or unrecoverable pre-sync failure
33
+ */
34
+ import * as os from "os";
35
+ import * as path from "path";
36
+ import * as fs from "fs";
37
+ import { fileURLToPath } from "url";
38
+ import { getValidAccessToken, VaultClient, VaultAuthError, } from "../index.js";
39
+ import { sync as defaultSync } from "../cli/sync.js";
40
+ // ---------------------------------------------------------------------------
41
+ // Defaults — mirror `hq-cli/src/utils/cognito-session.ts`. Inlined (not
42
+ // imported) to avoid a circular dep between hq-cli and hq-cloud. If these
43
+ // drift, the symptom is "runner talks to a different stage than hq sync"
44
+ // — keep both files lined up.
45
+ // ---------------------------------------------------------------------------
46
+ const DEFAULT_COGNITO = {
47
+ region: process.env.AWS_REGION ?? "us-east-1",
48
+ userPoolDomain: process.env.HQ_COGNITO_DOMAIN ?? "hq-vault-dev",
49
+ clientId: process.env.HQ_COGNITO_CLIENT_ID ?? "4mmujmjq3srakdueg656b9m0mp",
50
+ port: process.env.HQ_COGNITO_CALLBACK_PORT
51
+ ? Number(process.env.HQ_COGNITO_CALLBACK_PORT)
52
+ : 8765,
53
+ };
54
+ const DEFAULT_VAULT_API_URL = process.env.HQ_VAULT_API_URL ??
55
+ "https://tqdwdqxv75.execute-api.us-east-1.amazonaws.com";
56
+ const DEFAULT_HQ_ROOT = path.join(os.homedir(), "hq");
57
+ function parseArgs(argv) {
58
+ let companies = false;
59
+ let company;
60
+ let onConflict = "abort";
61
+ let hqRoot = DEFAULT_HQ_ROOT;
62
+ for (let i = 0; i < argv.length; i++) {
63
+ const arg = argv[i];
64
+ switch (arg) {
65
+ case "--companies":
66
+ companies = true;
67
+ break;
68
+ case "--company":
69
+ company = argv[++i];
70
+ if (!company)
71
+ return { error: "--company requires a value" };
72
+ break;
73
+ case "--on-conflict": {
74
+ const val = argv[++i];
75
+ if (val !== "abort" && val !== "overwrite" && val !== "keep") {
76
+ return {
77
+ error: `--on-conflict must be one of abort|overwrite|keep, got: ${val ?? "(missing)"}`,
78
+ };
79
+ }
80
+ onConflict = val;
81
+ break;
82
+ }
83
+ case "--hq-root":
84
+ hqRoot = argv[++i];
85
+ if (!hqRoot)
86
+ return { error: "--hq-root requires a value" };
87
+ break;
88
+ case "--json":
89
+ // Accepted but ignored — ndjson is the only output mode.
90
+ break;
91
+ default:
92
+ return { error: `Unknown argument: ${arg}` };
93
+ }
94
+ }
95
+ if (companies && company) {
96
+ return { error: "Pass --companies OR --company <slug>, not both" };
97
+ }
98
+ if (!companies && !company) {
99
+ return { error: "Pass --companies or --company <slug>" };
100
+ }
101
+ return { companies, company, onConflict, hqRoot };
102
+ }
103
+ // ---------------------------------------------------------------------------
104
+ // runRunner — testable entrypoint
105
+ // ---------------------------------------------------------------------------
106
+ export async function runRunner(argv, deps = {}) {
107
+ const stdout = deps.stdout ?? process.stdout;
108
+ const stderr = deps.stderr ?? process.stderr;
109
+ const emit = (event) => {
110
+ stdout.write(`${JSON.stringify(event)}\n`);
111
+ };
112
+ // ---- argv -------------------------------------------------------------
113
+ const parsed = parseArgs(argv);
114
+ if ("error" in parsed) {
115
+ stderr.write(`hq-sync-runner: ${parsed.error}\n`);
116
+ return 1;
117
+ }
118
+ // ---- auth -------------------------------------------------------------
119
+ let accessToken;
120
+ try {
121
+ const getAccessToken = deps.getAccessToken ??
122
+ (() => getValidAccessToken(DEFAULT_COGNITO, { interactive: false }));
123
+ accessToken = await getAccessToken();
124
+ }
125
+ catch (err) {
126
+ emit({
127
+ type: "auth-error",
128
+ message: err instanceof Error ? err.message : String(err),
129
+ });
130
+ return 0;
131
+ }
132
+ // ---- vault client -----------------------------------------------------
133
+ const vaultConfig = {
134
+ apiUrl: DEFAULT_VAULT_API_URL,
135
+ authToken: accessToken,
136
+ region: DEFAULT_COGNITO.region,
137
+ };
138
+ const client = deps.createVaultClient?.(vaultConfig) ?? new VaultClient(vaultConfig);
139
+ // ---- resolve targets --------------------------------------------------
140
+ let memberships;
141
+ try {
142
+ if (parsed.companies) {
143
+ memberships = await client.listMyMemberships();
144
+ if (memberships.length === 0) {
145
+ emit({ type: "setup-needed" });
146
+ return 0;
147
+ }
148
+ }
149
+ else {
150
+ // Single-company mode: fabricate a minimal membership so the fanout
151
+ // loop below treats it uniformly. We don't need to hit
152
+ // /membership/me — the caller already told us which company.
153
+ memberships = [{ companyUid: parsed.company }];
154
+ }
155
+ }
156
+ catch (err) {
157
+ if (err instanceof VaultAuthError) {
158
+ emit({
159
+ type: "auth-error",
160
+ message: err.message,
161
+ });
162
+ return 0;
163
+ }
164
+ // Any other failure is unrecoverable — surface as an error event and
165
+ // exit non-zero so the spawner knows the runner didn't get far enough
166
+ // to emit a useful protocol stream.
167
+ emit({
168
+ type: "error",
169
+ message: err instanceof Error ? err.message : String(err),
170
+ path: "(discovery)",
171
+ });
172
+ return 1;
173
+ }
174
+ // ---- resolve slugs for the fanout plan --------------------------------
175
+ // The menubar wants "Syncing indigo" in its UI, not the raw cmp_* ULID.
176
+ // If the entity fetch fails for some row (entity deleted, scoping issue),
177
+ // degrade to using the UID as the slug rather than aborting the run.
178
+ const plan = [];
179
+ for (const m of memberships) {
180
+ let slug = m.companyUid;
181
+ try {
182
+ const info = await client.entity.get(m.companyUid);
183
+ slug = info.slug || m.companyUid;
184
+ }
185
+ catch {
186
+ // Best-effort — keep UID as the display identifier.
187
+ }
188
+ plan.push({ uid: m.companyUid, slug });
189
+ }
190
+ emit({ type: "fanout-plan", companies: plan });
191
+ // ---- fanout -----------------------------------------------------------
192
+ const syncFn = deps.sync ?? defaultSync;
193
+ let totalFiles = 0;
194
+ let totalBytes = 0;
195
+ const errors = [];
196
+ for (const target of plan) {
197
+ const companyLabel = target.slug;
198
+ try {
199
+ const result = await syncFn({
200
+ company: target.uid,
201
+ vaultConfig,
202
+ hqRoot: parsed.hqRoot,
203
+ onConflict: parsed.onConflict,
204
+ onEvent: (event) => {
205
+ // Tag per-file events with the company they belong to so the
206
+ // menubar can route them to the right company's progress bar.
207
+ if (event.type === "progress") {
208
+ emit({
209
+ type: "progress",
210
+ company: companyLabel,
211
+ path: event.path,
212
+ bytes: event.bytes,
213
+ ...(event.message ? { message: event.message } : {}),
214
+ });
215
+ }
216
+ else {
217
+ emit({
218
+ type: "error",
219
+ company: companyLabel,
220
+ path: event.path,
221
+ message: event.message,
222
+ });
223
+ }
224
+ },
225
+ });
226
+ emit({ type: "complete", company: companyLabel, ...result });
227
+ totalFiles += result.filesDownloaded;
228
+ totalBytes += result.bytesDownloaded;
229
+ }
230
+ catch (err) {
231
+ const message = err instanceof Error ? err.message : String(err);
232
+ errors.push({ company: companyLabel, message });
233
+ emit({
234
+ type: "error",
235
+ company: companyLabel,
236
+ path: "(company)",
237
+ message,
238
+ });
239
+ // Continue — one company's failure shouldn't abort the whole fanout.
240
+ }
241
+ }
242
+ emit({
243
+ type: "all-complete",
244
+ companiesAttempted: plan.length,
245
+ filesDownloaded: totalFiles,
246
+ bytesDownloaded: totalBytes,
247
+ errors,
248
+ });
249
+ return 0;
250
+ }
251
+ // ---------------------------------------------------------------------------
252
+ // Entrypoint — only runs when invoked directly, not when imported for tests
253
+ // ---------------------------------------------------------------------------
254
+ // Detect whether this module is the entry point. The obvious check
255
+ // (`import.meta.url === file://${argv[1]}`) breaks for every real-world
256
+ // install shape: npm-link'd binaries, global installs via Homebrew, and
257
+ // pnpm's `node_modules/.bin` shims all leave `process.argv[1]` pointing
258
+ // at a symlink named `hq-sync-runner` (no `.js` suffix) while
259
+ // `import.meta.url` always resolves to the underlying `sync-runner.js`.
260
+ //
261
+ // Resolve both sides through realpath before comparing — that's the only
262
+ // way to handle all symlink layouts without false negatives. If realpath
263
+ // fails (argv[1] gone, permissions), fall through to `false` so we
264
+ // don't run twice when imported as a library.
265
+ const isDirectInvocation = (() => {
266
+ if (!process.argv[1])
267
+ return false;
268
+ try {
269
+ const modulePath = fs.realpathSync(fileURLToPath(import.meta.url));
270
+ const argvPath = fs.realpathSync(process.argv[1]);
271
+ return modulePath === argvPath;
272
+ }
273
+ catch {
274
+ return false;
275
+ }
276
+ })();
277
+ if (isDirectInvocation) {
278
+ runRunner(process.argv.slice(2))
279
+ .then((code) => process.exit(code))
280
+ .catch((err) => {
281
+ process.stderr.write(`hq-sync-runner: uncaught error — ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
282
+ process.exit(1);
283
+ });
284
+ }
285
+ //# sourceMappingURL=sync-runner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner.js","sourceRoot":"","sources":["../../src/bin/sync-runner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Unit tests for hq-sync-runner (ADR-0001).
3
+ *
4
+ * The runner is designed around `RunnerDeps` — every side effect is
5
+ * injectable, so tests assert on captured ndjson output rather than mocking
6
+ * modules. That keeps each test honest about what the runner does vs what
7
+ * its collaborators do.
8
+ */
9
+ export {};
10
+ //# sourceMappingURL=sync-runner.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-runner.test.d.ts","sourceRoot":"","sources":["../../src/bin/sync-runner.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}