@indigoai-us/hq-cli 5.201.2 → 5.201.3

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [5.201.3] — 2026-09-25
+
+### Fixed
+
+- A flag-registry worker whose startup fails because the working directory was deleted or its package files were being replaced no longer creates a Sentry issue. Other flag-registry worker errors remain visible with a worker tag.
+
 ## [5.201.2] — 2026-09-25
 
 ### Changed

package/dist/lib/flag-registry.js

@@ -6,6 +6,7 @@
  * keep a short-lived, offline CLI alive until the client's network deadline.
  */
 import { Worker } from "node:worker_threads";
+import * as Sentry from "@sentry/node";
 import { isFlagSnapshot, readLocalOverride, resolveFlag, } from "@indigoai-us/hq-flags-client";
 import { readMachineCompanyBinding } from "./work-context/company.js";
 import { readSessionState } from "./work-context/state.js";
@@ -116,12 +117,19 @@ export function kickFlagRegistryReadiness(dependencies = {}) {
     const companyIdentifiers = [companyUid, company.companySlug].filter((value) => Boolean(value));
     processReader = processSnapshotReader(companyIdentifiers);
     try {
-        const worker = (dependencies.createWorker ?? ((filename, options) => new Worker(filename, options)))(new URL("./flag-registry-worker.js", import.meta.url), {
-            workerData: {
-                endpoint,
-                ...(companyUid ? { companyUid } : {}),
-                ...(company.companySlug ? { companyIdentifiers: [company.companySlug] } : {}),
-            },
+        // The SDK's child-process integration captures every Worker error unless
+        // its process-wide captureWorkerErrors option is disabled. Scope only this
+        // worker so the reporting boundary can classify its startup errors without
+        // changing capture for unrelated workers.
+        const worker = Sentry.withScope((scope) => {
+            scope.setTag("worker", "flag-registry");
+            return (dependencies.createWorker ?? ((filename, options) => new Worker(filename, options)))(new URL("./flag-registry-worker.js", import.meta.url), {
+                workerData: {
+                    endpoint,
+                    ...(companyUid ? { companyUid } : {}),
+                    ...(company.companySlug ? { companyIdentifiers: [company.companySlug] } : {}),
+                },
+            });
         });
         worker.on("message", (value) => {
             if (isFlagSnapshot(value))

package/dist/sentry.js

@@ -20,7 +20,14 @@ import { installTreeTornSentryTagsFor, sentryFingerprintFor, sentryMcpCollisionC
  * Consistent with the swallow-EPIPE posture established in #138.
  */
 export function epipeAwareBeforeSend(event, hint) {
-    if (isEpipe(hint?.originalException))
+    const flagRegistryWorkerEvent = isFlagRegistryWorkerEvent(event);
+    if (flagRegistryWorkerEvent) {
+        if (isExpectedFlagRegistryWorkerStartupFailure(hint?.originalException))
+            return null;
+        event.level = "warning";
+        event.tags = { ...event.tags, worker: "flag-registry" };
+    }
+    if (!flagRegistryWorkerEvent && isEpipe(hint?.originalException))
         return null;
     // Path-independent belt for environmental filesystem failures (ENOSPC /
     // EDQUOT / EROFS — a full disk, exhausted quota, or read-only mount, e.g.
@@ -31,7 +38,7 @@ export function epipeAwareBeforeSend(event, hint) {
     // either. handleTopLevelError already prints an actionable message for the
     // boundary route; dropping the event here suppresses the fatal regardless of
     // route, while the CLI still exits non-zero. HQ-CLI-R (Sentry 7671416365).
-    if (environmentalFsErrorMessage(hint?.originalException))
+    if (!flagRegistryWorkerEvent && environmentalFsErrorMessage(hint?.originalException))
         return null;
     // Path-independent belt for an IN-PROCESS incomplete-install module-load
     // failure — hq-cli's own globally installed tree is not intact at load time
@@ -50,7 +57,7 @@ export function epipeAwareBeforeSend(event, hint) {
     // node_modules, so an hq-cli packaging fault (a dist/ miss, or a bare miss the
     // requirer does NOT declare — a possible undeclared/peer dependency) and the
     // path-less unattributable shape are NOT dropped here and stay captured.
-    if (incompleteInstallMessage(hint?.originalException))
+    if (!flagRegistryWorkerEvent && incompleteInstallMessage(hint?.originalException))
         return null;
     // An incomplete-install shape that is NOT suppressed (a bare miss the requirer
     // does not declare, or a path-less loader/resolver ENOENT) should still arrive
@@ -95,6 +102,27 @@ export function epipeAwareBeforeSend(event, hint) {
     }
     return beforeSend(event, hint);
 }
+function isFlagRegistryWorkerEvent(event) {
+    return event.tags?.worker === "flag-registry" && Boolean(event.exception?.values?.some((value) => value.mechanism?.type === "auto.child_process.worker_thread"));
+}
+function isExpectedFlagRegistryWorkerStartupFailure(error) {
+    if (typeof error !== "object" || error === null)
+        return false;
+    const details = error;
+    if (details.code === "ENOENT" && details.syscall === "uv_cwd") {
+        const stack = typeof details.stack === "string" ? details.stack : "";
+        return stack.includes("node:internal/main/worker_thread") && /\bat process\.cwd \(/.test(stack);
+    }
+    if (details.code !== "MODULE_NOT_FOUND" && details.code !== "ERR_MODULE_NOT_FOUND") {
+        return false;
+    }
+    const message = typeof details.message === "string" ? details.message : "";
+    const missingModule = /Cannot find module\s+['"]([^'"]+)['"]/.exec(message)?.[1];
+    if (!missingModule)
+        return false;
+    return missingModule.replaceAll("\\", "/").endsWith("/flag-registry-worker.js") ||
+        missingModule === "flag-registry-worker.js";
+}
 /**
  * Tests substitute only the transport so the real SDK lifecycle can be
  * exercised without an ingest request. Production callers pass nothing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.201.2",
+  "version": "5.201.3",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {