@indigoai-us/hq-cli 5.345.19 → 5.345.21

package/dist/lib/core-utils/sentry-report.js

@@ -48,6 +48,7 @@ const SENTRY_REPORT_LEVELS = new Set([
 const HOOK_TIMEOUT_WARNING_TYPE = "hook_timeout_warning";
 const HOOK_TIMEOUT_EXCEEDED_TYPE = "hook_timeout_exceeded";
 const HOOK_LATE_FINISH_TYPE = "hook_late_finish";
+const HOOK_TIMEOUT_FINGERPRINT = "hook-timeout";
 const HOOK_TIMEOUT_WARNING_METRIC = "hq.hook_timeout_warning";
 const HOOK_TIMEOUT_EXCEEDED_METRIC = "hq.hook_timeout_exceeded";
 const MAX_HOOK_SEQUENCE_ENTRIES = 20;
@@ -275,6 +276,17 @@ function safeSlowPhase(value) {
         return "unknown";
     return SAFE_SLOW_PHASES.has(value) ? value : "other";
 }
+function resolvedSlowPhase(metadata) {
+    const reported = safeSlowPhase(metadata.slow_phase);
+    if (reported !== "unknown" && reported !== "other")
+        return reported;
+    // Which measured master-hook phase consumed the most time when the caller's
+    // active-phase field was absent or unusable?
+    const debugContext = metadata.hook_timeout_debug_context;
+    const slowestPhase = debugContext?.phase_timings
+        .reduce((slowest, timing) => slowest === undefined || timing.elapsed_ms > slowest.elapsed_ms ? timing : slowest, undefined);
+    return slowestPhase ? safeSlowPhase(slowestPhase.phase) : reported;
+}
 function boundedDebugHookEvent(value) {
     return typeof value === "string" && DEBUG_CONTEXT_HOOK_EVENTS.has(value) ? value : "other";
 }
@@ -534,6 +546,28 @@ function timeoutElapsedMs(metadata) {
 function formatNumber(value) {
     return value.toFixed(2).replace(/\.00$|(?<=\.[0-9])0$/, "");
 }
+function formatSeconds(milliseconds) {
+    return `${formatNumber(milliseconds / 1_000)}s`;
+}
+// How much of the declared timeout has elapsed, and how much remains?
+function hookTimeoutMessage(event) {
+    if (event.type !== HOOK_TIMEOUT_WARNING_TYPE)
+        return event.message;
+    const elapsedMs = timeoutElapsedMs(event.metadata);
+    const declaredTimeoutMs = event.metadata.declared_timeout_ms;
+    if (elapsedMs === undefined ||
+        typeof declaredTimeoutMs !== "number" ||
+        !Number.isFinite(declaredTimeoutMs) ||
+        declaredTimeoutMs <= 0) {
+        return event.message;
+    }
+    const elapsed = formatSeconds(elapsedMs);
+    const budget = formatSeconds(declaredTimeoutMs);
+    if (elapsedMs >= declaredTimeoutMs) {
+        return `HQ hook used ${elapsed} of its ${budget} configured timeout (${formatSeconds(elapsedMs - declaredTimeoutMs)} over budget).`;
+    }
+    return `HQ hook used ${elapsed} of its ${budget} configured timeout (${formatSeconds(declaredTimeoutMs - elapsedMs)} remaining).`;
+}
 function elapsedBucket(elapsedMs) {
     if (elapsedMs === undefined)
         return "unknown";
@@ -672,9 +706,33 @@ function safeSlowChild(metadata) {
         (typeof value !== "string" || value.length === 0 || value === "other")) {
         return "entry-bash-startup";
     }
-    if (typeof value !== "string" || !SAFE_HOOK_SCRIPT.test(value))
-        return "other";
-    return value;
+    return typeof value === "string" && SAFE_HOOK_SCRIPT.test(value) ? value : "other";
+}
+function resolvedSlowChild(metadata) {
+    const directName = safeSlowChild(metadata);
+    const directDuration = metadata.slow_child_ms;
+    const hasDirectDuration = typeof directDuration === "number" && Number.isFinite(directDuration) && directDuration >= 0;
+    if (directName !== "other") {
+        return { name: directName, ...(hasDirectDuration ? { durationMs: directDuration } : {}) };
+    }
+    const currentScript = hookScript(metadata);
+    const currentEvent = stringMetadata(metadata, "hook_event", "");
+    const sequence = metadata.hook_sequence;
+    if (Array.isArray(sequence)) {
+        // Which named hook from this event's serialized sequence took longest
+        // when dispatch could not directly name its slow child?
+        const slowestNamedHook = sequence
+            .filter((entry) => entry.event === currentEvent &&
+            entry.script !== currentScript &&
+            SAFE_HOOK_SCRIPT.test(entry.script) &&
+            Number.isFinite(entry.ms) &&
+            entry.ms >= 0)
+            .reduce((slowest, entry) => (slowest === undefined || entry.ms > slowest.ms ? entry : slowest), undefined);
+        if (slowestNamedHook) {
+            return { name: slowestNamedHook.script, durationMs: slowestNamedHook.ms };
+        }
+    }
+    return { name: directName, ...(hasDirectDuration ? { durationMs: directDuration } : {}) };
 }
 function isMachineWideHookSlowness(metadata) {
     const spawnMs = metadata.spawn_ms;
@@ -717,7 +775,7 @@ function hookTimeoutTags(event) {
     const shell = stringMetadata(metadata, "shell");
     const nproc = metadata.nproc;
     const loadAverage = parsedLoadAverage(metadata);
-    const slowChildMs = metadata.slow_child_ms;
+    const slowChild = resolvedSlowChild(metadata);
     return {
         hook_timeout_kind: hookTimeoutKind(event),
         hook_event: hookEvent(metadata),
@@ -738,11 +796,9 @@ function hookTimeoutTags(event) {
         load_bucket: typeof loadAverage === "string" ? loadAverage : loadBucket(loadAverage),
         root_storage_class: rootStorageClassTag(metadata),
         spawn_ms_bucket: spawnMsBucket(metadata),
-        slow_child: safeSlowChild(metadata),
-        slow_phase: safeSlowPhase(metadata.slow_phase),
-        slow_child_ms_bucket: typeof slowChildMs === "number" && Number.isFinite(slowChildMs)
-            ? elapsedBucket(slowChildMs)
-            : "unknown",
+        slow_child: slowChild.name,
+        slow_phase: resolvedSlowPhase(metadata),
+        slow_child_ms_bucket: elapsedBucket(slowChild.durationMs),
         machine_wide: isMachineWideHookSlowness(metadata) ? "true" : "false",
         nproc: typeof nproc === "number" || typeof nproc === "string"
             ? safeTagValue(String(nproc), SAFE_NPROC)
@@ -777,7 +833,7 @@ function sentryEnvelope(event, overrides, additionalTags = {}) {
 /** Build the same scrubbed event projection that the live SDK path uses. */
 function scrubbedSentryEnvelope(event, overrides, additionalTags = {}) {
     return beforeSend({
-        message: event.message,
+        message: hookTimeoutMessage(event),
         ...sentryEnvelope(event, overrides, additionalTags),
     }, {});
 }
@@ -787,7 +843,7 @@ function hookTimeoutExceededOverrides(event) {
         return undefined;
     return {
         level: "warning",
-        fingerprint: ["hook-timeout", hookTimeoutKind(event)],
+        fingerprint: [HOOK_TIMEOUT_FINGERPRINT, hookTimeoutKind(event)],
     };
 }
 /**
@@ -1090,7 +1146,7 @@ export async function reportSentryEvent(stdin, options = {}, dependencies = defa
             : {};
         const envelope = sentryEnvelope(event, overrides, { ...debugContextTags, ...tags });
         try {
-            dependencies.sentry.captureMessage(event.message, envelope);
+            dependencies.sentry.captureMessage(hookTimeoutMessage(event), envelope);
             rateLimit.commitCapture();
             if (await flushWithin(dependencies.sentry, timeoutMs))
                 return result;
@@ -1104,7 +1160,7 @@ export async function reportSentryEvent(stdin, options = {}, dependencies = defa
     }
     const envelope = sentryEnvelope(event, overrides, debugContextTags);
     try {
-        dependencies.sentry.captureMessage(event.message, envelope);
+        dependencies.sentry.captureMessage(hookTimeoutMessage(event), envelope);
         if (await flushWithin(dependencies.sentry, timeoutMs))
             return result;
     }

package/dist/lib/doctor/client-health-reason-codes-flag.d.ts

@@ -2,6 +2,8 @@ import { type FlagClient, type FlagClientOptions } from "@indigoai-us/hq-flags-c
 export declare const CLIENT_HEALTH_REASON_CODES_FLAG = "client-health-sync-reason-codes";
 export declare const CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK = false;
 export declare const CLIENT_HEALTH_REASON_CODES_FLAG_TIMEOUT_MS = 150;
+export declare const CLIENT_HEALTH_CHECK_STATUS_FLAG = "client-health-sync-check-status";
+export declare const CLIENT_HEALTH_CHECK_STATUS_FLAG_FALLBACK = false;
 type ClientHealthFlagClient = Pick<FlagClient, "ready" | "isEnabled" | "close">;
 export interface ClientHealthReasonCodesFlagDependencies {
     env?: NodeJS.ProcessEnv;
@@ -21,7 +23,11 @@ export interface ClientHealthReasonCodesCompany {
  * off so a flag outage cannot delay the doctor's health result.
  */
 export declare function clientHealthReasonCodesEnabled(dependencies?: ClientHealthReasonCodesFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
+/** Resolve the separate status-report gate for the active company. */
+export declare function clientHealthCheckStatusEnabled(dependencies?: ClientHealthReasonCodesFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
 /** Resolve the same default-off gate for one explicitly identified company. */
 export declare function clientHealthReasonCodesEnabledForCompany(company: ClientHealthReasonCodesCompany, dependencies?: ClientHealthReasonCodesFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
+/** Resolve the separate default-off check-status gate for one company. */
+export declare function clientHealthCheckStatusEnabledForCompany(company: ClientHealthReasonCodesCompany, dependencies?: ClientHealthReasonCodesFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
 export {};
 //# sourceMappingURL=client-health-reason-codes-flag.d.ts.map

package/dist/lib/doctor/client-health-reason-codes-flag.js

@@ -4,12 +4,14 @@ import { getClientHealthFlagToken } from "./client-health-flag-token.js";
 export const CLIENT_HEALTH_REASON_CODES_FLAG = "client-health-sync-reason-codes";
 export const CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK = false;
 export const CLIENT_HEALTH_REASON_CODES_FLAG_TIMEOUT_MS = 150;
+export const CLIENT_HEALTH_CHECK_STATUS_FLAG = "client-health-sync-check-status";
+export const CLIENT_HEALTH_CHECK_STATUS_FLAG_FALLBACK = false;
 function safeErrorClass(error) {
     const name = error instanceof Error ? error.name : "UnknownError";
     return /^[A-Za-z][A-Za-z0-9]{0,63}$/.test(name) ? name : "UnknownError";
 }
 function reportFlagFailure(error) {
-    process.stderr.write(`HQ client-health reason-code flag lookup failed (${safeErrorClass(error)}); using default off.\n`);
+    process.stderr.write(`HQ client-health flag lookup failed (${safeErrorClass(error)}); using default off.\n`);
 }
 function combineSignals(first, second) {
     return first ? AbortSignal.any([first, second]) : second;
@@ -30,13 +32,32 @@ export async function clientHealthReasonCodesEnabled(dependencies = {}, callerSi
         companySlug: env.HQ_COMPANY_SLUG?.trim() || undefined,
     }, dependencies, callerSignal);
 }
+/** Resolve the separate status-report gate for the active company. */
+export async function clientHealthCheckStatusEnabled(dependencies = {}, callerSignal) {
+    const env = dependencies.env ?? process.env;
+    const companyUid = env.HQ_COMPANY_UID?.trim() || "";
+    if (!/^cmp_[A-Za-z0-9]{3,128}$/.test(companyUid)) {
+        return CLIENT_HEALTH_CHECK_STATUS_FLAG_FALLBACK;
+    }
+    return clientHealthCheckStatusEnabledForCompany({
+        companyUid,
+        companySlug: env.HQ_COMPANY_SLUG?.trim() || undefined,
+    }, dependencies, callerSignal);
+}
 /** Resolve the same default-off gate for one explicitly identified company. */
 export async function clientHealthReasonCodesEnabledForCompany(company, dependencies = {}, callerSignal) {
+    return clientHealthFlagEnabledForCompany(CLIENT_HEALTH_REASON_CODES_FLAG, CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK, company, dependencies, callerSignal);
+}
+/** Resolve the separate default-off check-status gate for one company. */
+export async function clientHealthCheckStatusEnabledForCompany(company, dependencies = {}, callerSignal) {
+    return clientHealthFlagEnabledForCompany(CLIENT_HEALTH_CHECK_STATUS_FLAG, CLIENT_HEALTH_CHECK_STATUS_FLAG_FALLBACK, company, dependencies, callerSignal);
+}
+async function clientHealthFlagEnabledForCompany(flagKey, fallback, company, dependencies, callerSignal) {
     const env = dependencies.env ?? process.env;
     const endpoint = resolveFlagRegistryEndpoint(undefined, env);
     const companyUid = company.companyUid.trim();
-    if (!/^cmp_[A-Za-z0-9]{3,128}$/.test(companyUid)) {
-        return CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK;
+    if (!endpoint || !/^cmp_[A-Za-z0-9]{3,128}$/.test(companyUid)) {
+        return fallback;
     }
     const companySlug = company.companySlug?.trim() || "";
     if (callerSignal?.aborted)
@@ -44,7 +65,7 @@ export async function clientHealthReasonCodesEnabledForCompany(company, dependen
     let client;
     let failed = false;
     let failureReported = false;
-    let enabled = CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK;
+    let enabled = fallback;
     const reportFailureOnce = (error) => {
         failed = true;
         if (failureReported)
@@ -83,8 +104,8 @@ export async function clientHealthReasonCodesEnabledForCompany(company, dependen
         });
         await client.ready();
         if (!failed && !signal.aborted) {
-            enabled = client.isEnabled(CLIENT_HEALTH_REASON_CODES_FLAG, {
-                fallback: CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK,
+            enabled = client.isEnabled(flagKey, {
+                fallback,
             });
         }
     }
@@ -100,7 +121,7 @@ export async function clientHealthReasonCodesEnabledForCompany(company, dependen
         }
     }
     return failed || signal.aborted
-        ? CLIENT_HEALTH_REASON_CODES_FLAG_FALLBACK
+        ? fallback
         : enabled;
 }
 //# sourceMappingURL=client-health-reason-codes-flag.js.map

package/dist/lib/doctor/json-output.d.ts

@@ -54,6 +54,8 @@ export interface DoctorJsonResult {
     reasonCode?: SyncReasonCode;
     /** Present only when this result's company opted in through hq-flags. */
     clientHealthReasonCodesEnabled?: true;
+    /** Present only when this result's company opted in to status reporting through hq-flags. */
+    clientHealthCheckStatusEnabled?: true;
     /** What was inspected. Present only when the result carries one. */
     target?: string;
     /** Human-readable explanation. */
@@ -100,6 +102,8 @@ export interface BuildDoctorJsonInput {
     scope?: readonly string[];
     /** Check ids whose own company enabled diagnostic reason codes in hq-flags. */
     clientHealthReasonCodesEnabledCheckIds?: ReadonlySet<string>;
+    /** Check ids whose own company enabled per-check status reporting in hq-flags. */
+    clientHealthCheckStatusEnabledCheckIds?: ReadonlySet<string>;
 }
 /** Assemble the machine-readable document from a completed run. */
 export declare function buildDoctorJson(input: BuildDoctorJsonInput): DoctorJsonDocument;

package/dist/lib/doctor/json-output.js

@@ -34,7 +34,7 @@ export function buildDoctorJson(input) {
     const results = [];
     for (const run of input.families) {
         for (const result of run.results) {
-            results.push(toJsonResult(run.family.id, result, input.clientHealthReasonCodesEnabledCheckIds));
+            results.push(toJsonResult(run.family.id, result, input.clientHealthReasonCodesEnabledCheckIds, input.clientHealthCheckStatusEnabledCheckIds));
         }
     }
     return {
@@ -48,7 +48,7 @@ export function buildDoctorJson(input) {
     };
 }
 /** Convert one {@link CheckResult} into its JSON form, omitting empty optionals. */
-function toJsonResult(familyId, result, clientHealthReasonCodesEnabledCheckIds) {
+function toJsonResult(familyId, result, clientHealthReasonCodesEnabledCheckIds, clientHealthCheckStatusEnabledCheckIds) {
     const remediation = deriveRemediation(result);
     return {
         status: result.status,
@@ -58,6 +58,9 @@ function toJsonResult(familyId, result, clientHealthReasonCodesEnabledCheckIds)
         ...(clientHealthReasonCodesEnabledCheckIds?.has(result.checkId)
             ? { clientHealthReasonCodesEnabled: true }
             : {}),
+        ...(clientHealthCheckStatusEnabledCheckIds?.has(result.checkId)
+            ? { clientHealthCheckStatusEnabled: true }
+            : {}),
         ...(result.target !== undefined ? { target: result.target } : {}),
         message: result.message,
         ...(result.details !== undefined ? { details: result.details } : {}),

package/dist/lib/lanes/autopilot.js

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { safeCaughtError } from "../../utils/safe-caught-error.js";
 import { laneRunsOnHost } from "./admission.js";
 import { isControllerAliasOutpostId } from "./admission-host.js";
 import { LEAD_REGISTRY_REL, validateOutpostLeadRegistry } from "./autopilot-registry.js";
@@ -783,7 +784,10 @@ async function runLeadAutopilotPassUnlocked(input) {
             input.outpostId === registered.host &&
             lead.host.kind === "local" &&
             lead.host.id === input.hostname &&
-            await (input.readFlag ?? readLanesRegistryFlag)(LEAD_AUTOPILOT_OUTPOST_NATIVE_LEADS_FLAG, { company }).catch(() => false);
+            await (input.readFlag ?? readLanesRegistryFlag)(LEAD_AUTOPILOT_OUTPOST_NATIVE_LEADS_FLAG, { company }).catch((error) => {
+                console.warn("[hq-cli:lanes/autopilot] outpost-native lead flag read failed", safeCaughtError(error));
+                return false;
+            });
         const hostMatchesRegistry = registeredLocalHost
             ? lead.host.kind === "local"
             : outpostNativeLead ||

package/dist/lib/lanes/grants.d.ts

@@ -2,7 +2,10 @@ import { type LaneRecord } from "./types.js";
 import { LanesError } from "./errors.js";
 export type LaneHireGrantRow = Pick<LaneRecord, "lane_id" | "state" | "senior" | "hire_grant">;
 export declare function isFinishedResumableHireChild(state: LaneRecord["state"]): boolean;
+export declare function laneHoldsHireGrantCarve(lane: Pick<LaneHireGrantRow, "state">, finishedChildrenDoNotCount?: boolean): boolean;
 export declare function aliveDirectChildren<T extends LaneHireGrantRow>(lanes: readonly T[], parentLaneId: string, finishedChildrenDoNotCount?: boolean): T[];
+/** Children whose existing hire grants occupy their senior's carve. */
+export declare function childrenHoldingHireGrantCarve<T extends LaneHireGrantRow>(lanes: readonly T[], parentLaneId: string, finishedChildrenDoNotCount?: boolean): T[];
 export declare function assignedChildHireGrants(children: readonly LaneHireGrantRow[], exceptLaneId?: string): number;
 export interface HireGrantAdmissionSnapshot {
     parent: LaneHireGrantRow;

package/dist/lib/lanes/grants.js

@@ -4,11 +4,18 @@ import { LanesError } from "./errors.js";
 export function isFinishedResumableHireChild(state) {
     return state === "awaiting_input" || state === "blocked" || state === "done";
 }
+export function laneHoldsHireGrantCarve(lane, finishedChildrenDoNotCount = false) {
+    return !isTerminalLaneState(lane.state) &&
+        !(finishedChildrenDoNotCount && isFinishedResumableHireChild(lane.state));
+}
 export function aliveDirectChildren(lanes, parentLaneId, finishedChildrenDoNotCount = false) {
+    return childrenHoldingHireGrantCarve(lanes, parentLaneId, finishedChildrenDoNotCount);
+}
+/** Children whose existing hire grants occupy their senior's carve. */
+export function childrenHoldingHireGrantCarve(lanes, parentLaneId, finishedChildrenDoNotCount = false) {
     return lanes.filter((lane) => lane.senior.kind === "lane" &&
         lane.senior.id === parentLaneId &&
-        !isTerminalLaneState(lane.state) &&
-        !(finishedChildrenDoNotCount && isFinishedResumableHireChild(lane.state)));
+        laneHoldsHireGrantCarve(lane, finishedChildrenDoNotCount));
 }
 export function assignedChildHireGrants(children, exceptLaneId) {
     return children.reduce((sum, child) => child.lane_id === exceptLaneId ? sum : sum + (child.hire_grant ?? 0), 0);
@@ -101,7 +108,7 @@ export function withHireGrantAdmission(hqRoot, parentLaneId, fn, suppliedHierarc
             }
             parent = suppliedParent;
         }
-        const children = aliveDirectChildren(allLanes, parentLaneId, finishedChildrenDoNotCount);
+        const children = childrenHoldingHireGrantCarve(allLanes, parentLaneId, finishedChildrenDoNotCount);
         const parentGrant = parent.hire_grant ?? 0;
         const availableChildGrant = Math.max(0, parentGrant - assignedChildHireGrants(children));
         return fn({ parent, children, parentGrant, availableChildGrant });

package/dist/lib/lanes/index.d.ts

@@ -3,7 +3,7 @@
  */
 export { AccountResolutionError, LaneNotFoundError, LaneSchemaError, LaneVersionConflict, LanesConfigError, LanesError, WorkerResolutionError, isLaneVersionConflict, isLanesError, } from "./errors.js";
 export { MAX_LANE_DEPTH } from "./constants.js";
-export { assignedChildHireGrants, aliveDirectChildren, isFinishedResumableHireChild, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, } from "./grants.js";
+export { assignedChildHireGrants, aliveDirectChildren, childrenHoldingHireGrantCarve, isFinishedResumableHireChild, laneHoldsHireGrantCarve, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, } from "./grants.js";
 export type { HireGrantBackfillRow } from "./grants.js";
 export { compareLaneQueueOrder, hasActiveAdmissionReservation, hasActivePendingResume, hasEarlierEligibleQueuedLane, laneOccupiesRunningSlot, laneAdmissionCapReason, laneRunsOnHost, withAllLaneAdmissionLocks, withLaneAdmissionLock, } from "./admission.js";
 export type { AdmissionCapReason, AdmissionHost } from "./admission.js";

package/dist/lib/lanes/index.js

@@ -3,7 +3,7 @@
  */
 export { AccountResolutionError, LaneNotFoundError, LaneSchemaError, LaneVersionConflict, LanesConfigError, LanesError, WorkerResolutionError, isLaneVersionConflict, isLanesError, } from "./errors.js";
 export { MAX_LANE_DEPTH } from "./constants.js";
-export { assignedChildHireGrants, aliveDirectChildren, isFinishedResumableHireChild, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, } from "./grants.js";
+export { assignedChildHireGrants, aliveDirectChildren, childrenHoldingHireGrantCarve, isFinishedResumableHireChild, laneHoldsHireGrantCarve, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, } from "./grants.js";
 export { compareLaneQueueOrder, hasActiveAdmissionReservation, hasActivePendingResume, hasEarlierEligibleQueuedLane, laneOccupiesRunningSlot, laneAdmissionCapReason, laneRunsOnHost, withAllLaneAdmissionLocks, withLaneAdmissionLock, } from "./admission.js";
 export { buildHostCapacitySnapshot, chooseHostForLane, parseHostCapacitySnapshot, } from "./host-capacity.js";
 export { CONFIG_SCHEMA_VERSION, ENVELOPE_DECISIONS, ENVELOPE_SCHEMA_VERSION, HISTORY_CAP, HOST_KINDS, LANE_PROVIDERS, LANE_SCHEMA_VERSION, LANE_STORY_STATUSES, LANE_STATES, LIVENESS_STATES, QUESTION_BODY_STORES, QUESTION_SCHEMA_VERSION, QUESTION_STATUSES, QUEUED_REASONS, RAISED_VIA, ROUTING_REASONS, SENIOR_KINDS, STORY_STATUSES, TERMINAL_LANE_STATES, isEnvelopeDecision, isHostKind, isLaneProvider, isLaneState, isLivenessState, isQuestionStatus, isSeniorKind, isTerminalLaneState, parseLaneEnvelope, parseLaneProvider, parseLaneState, parseLivenessState, parseMajorSchema, parseQuestionStatus, parseSeniorKind, } from "./types.js";

package/dist/utils/safe-caught-error.d.ts

@@ -0,0 +1,3 @@
+/** Render an unknown rejection safely for a concise diagnostic log. */
+export declare function safeCaughtError(error: unknown): string;
+//# sourceMappingURL=safe-caught-error.d.ts.map

package/dist/utils/safe-caught-error.js

@@ -0,0 +1,16 @@
+import { redactErrorText } from "./redact-error-text.js";
+/** Render an unknown rejection safely for a concise diagnostic log. */
+export function safeCaughtError(error) {
+    const rawName = error instanceof Error ? error.name : "UnknownError";
+    // A writable `name` can carry arbitrary text, so only class-shaped names are logged.
+    const name = /^[A-Za-z]{1,64}(?:Error|Exception)$/.test(rawName) ? rawName : "Error";
+    const rawMessage = error instanceof Error ? error.message : "non-Error rejection";
+    const message = redactErrorText(rawMessage)
+        .replace(/\b[a-z][a-z0-9+.-]*:\/\/[^\s"<>]+/gi, "[URL]")
+        .replace(/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi, "[EMAIL]")
+        .replace(/\b(?:agt|cmp|prs|prj|session|sess|usr|user|acct|fin|st|e)_[A-Za-z0-9_-]+\b/gi, "[ID]")
+        .replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\b/gi, "[ID]")
+        .slice(0, 160);
+    return `${name}: ${message || "[empty]"}`;
+}
+//# sourceMappingURL=safe-caught-error.js.map

package/package.json

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