@indigoai-us/hq-cli 5.201.1 → 5.201.3

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [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
+
+- The checkpoint ontology plan tells the model to name a person by the full name the input or the company's entities give, not a first name alone.
+
 ## [5.201.1] — 2026-09-25
 
 ### Fixed

package/dist/lib/checkpoint-ontology/plan.js

@@ -29,7 +29,7 @@ const CANDIDATE_INSTRUCTIONS = [
     `Write ${CANDIDATES_FILE} in the run directory as {"schema":"${CANDIDATES_SCHEMA}","candidates":[...]} and nothing else.`,
     "Each candidate: {input, type, name, aliases, confidence, evidence}. input is one of this plan's input ids; type is person, project, company or concept; name is the entity's full proper name; aliases are other names the input uses for it (at most 5); confidence is 0 to 1; evidence is a short quote from the input.",
     "Read only the files and line ranges this plan lists. For a signal, read its body and name the entities in missing_refs if the signal supports them.",
-    "Name the specific people, projects, products, companies and named concepts that the input says something about. That includes the company that owns this knowledge and its own products when the input describes them. Name a third-party tool, vendor or service only when a section of the input is about it; skip ones that appear in a list, a stack summary or a passing mention. Skip generic words, file names and headings.",
+    "Name the specific people, projects, products, companies and named concepts that the input says something about. That includes the company that owns this knowledge and its own products when the input describes them. Name a third-party tool, vendor or service only when a section of the input is about it; skip ones that appear in a list, a stack summary or a passing mention. Skip generic words, file names and headings. Name a person by the full name the input or the company's entities give, not a first name alone.",
     "For the session input (its text is session_text in this plan), name only entities that already exist in the company and that the session did work on. Session candidates are recorded as links, never created.",
     "Do not create, edit, move or delete anything under ontology/, signals/ or sources/ yourself.",
 ];

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.1",
+  "version": "5.201.3",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {