@indigoai-us/hq-cli 5.294.0 → 5.296.0

package/dist/fast-lanes-list.js

@@ -1,224 +0,0 @@
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { compareLaneQueueOrder, laneRunsOnHost } from "./lib/lanes/admission.js";
-import { readOutpostIdentity, resolveAdmissionHost } from "./lib/lanes/admission-host.js";
-import { LaneSchemaError, isLanesError } from "./lib/lanes/errors.js";
-import { startOutpostLaneSnapshotRefresh } from "./lib/lanes/outpost-snapshot-refresh.js";
-import { OUTPOST_HIRE_SUMMARY_CACHE_TTL_MS, outpostHireSummaryCacheKey, readOutpostHireSummaryCacheIncludingStale, } from "./lib/lanes/outpost-hire-cache.js";
-import { resolveLanesHqRoot } from "./lib/lanes/hq-root.js";
-import { laneStories } from "./lib/lanes/stories.js";
-import { readAllLanes } from "./lib/lanes/store.js";
-import { isTerminalLaneState } from "./lib/lanes/types.js";
-const LANES_RUNS_REL = path.join("workspace", "lanes-runs");
-function withoutProviderHome(value) {
-    if (Array.isArray(value))
-        return value.map(withoutProviderHome);
-    if (value === null || typeof value !== "object")
-        return value;
-    const safe = {};
-    for (const [key, nested] of Object.entries(value)) {
-        if (key === "provider_home_at_spawn")
-            continue;
-        safe[key] = withoutProviderHome(nested);
-    }
-    return safe;
-}
-function printJson(value) {
-    console.log(JSON.stringify(withoutProviderHome(value), null, 2));
-}
-function errorMessage(err) {
-    return err instanceof Error ? err.message : String(err);
-}
-function failJson(err) {
-    if (isLanesError(err)) {
-        if (err.error === "hire_grant_exhausted") {
-            process.stderr.write(`hq lanes: ${err.message}\n`);
-        }
-        printJson({ ...err.toJSON(), message: err.message });
-    }
-    else {
-        const message = errorMessage(err);
-        process.stderr.write(`hq lanes: ${message}${err instanceof Error && err.stack ? `\n${err.stack}` : ""}\n`);
-        printJson({ error: "internal", message });
-    }
-    process.exitCode = 1;
-}
-function laneHireFields(lane, aliveChildrenByParent) {
-    const aliveChildCount = aliveChildrenByParent.get(lane.lane_id) ?? 0;
-    const hireGrant = lane.hire_grant ?? 0;
-    return {
-        hire_grant: hireGrant,
-        hire_alive_children: aliveChildCount,
-        hire: `${aliveChildCount}/${hireGrant}`,
-        hire_summary: `hire ${aliveChildCount}/${hireGrant}`,
-    };
-}
-function isOverdue(hqRoot, laneId, now) {
-    const filePath = path.join(hqRoot, LANES_RUNS_REL, laneId, "timeout.json");
-    let text;
-    try {
-        text = fs.readFileSync(filePath, "utf8");
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return false;
-        throw err;
-    }
-    let raw;
-    try {
-        raw = JSON.parse(text);
-    }
-    catch (err) {
-        throw new LaneSchemaError(`Invalid JSON in ${filePath}: ${errorMessage(err)}`, { path: filePath });
-    }
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
-        return false;
-    const deadline = raw.deadline_at;
-    if (typeof deadline !== "string")
-        return false;
-    const at = Date.parse(deadline);
-    if (!Number.isFinite(at))
-        return false;
-    return now.getTime() > at;
-}
-function isOwnerLane(lane, host) {
-    return lane.host.kind === "outpost" &&
-        !isTerminalLaneState(lane.state) &&
-        !laneRunsOnHost(lane, host);
-}
-async function buildLaneList(hqRoot, sourceLanes, host, now, env) {
-    const selectedLanes = sourceLanes.sort(compareLaneQueueOrder);
-    const aliveChildrenByParent = new Map();
-    for (const child of selectedLanes) {
-        if (child.senior.kind !== "lane" || !child.senior.id || isTerminalLaneState(child.state))
-            continue;
-        aliveChildrenByParent.set(child.senior.id, (aliveChildrenByParent.get(child.senior.id) ?? 0) + 1);
-    }
-    const ownerLanes = selectedLanes.filter((lane) => isOwnerLane(lane, host));
-    const hireByLane = new Map();
-    const remoteSnapshotMetadata = new Map();
-    let remoteLanesLoading = false;
-    for (const lane of selectedLanes) {
-        if (!isOwnerLane(lane, host)) {
-            hireByLane.set(lane.lane_id, {
-                ...laneHireFields(lane, aliveChildrenByParent),
-                hire_source: "local",
-            });
-        }
-    }
-    if (ownerLanes.length > 0) {
-        const nowMs = now.getTime();
-        const cached = readOutpostHireSummaryCacheIncludingStale(hqRoot, nowMs);
-        let refreshNeeded = false;
-        for (const lane of ownerLanes) {
-            if (lane.host.kind !== "outpost")
-                continue;
-            const summary = cached.get(outpostHireSummaryCacheKey(lane.host.id, lane.lane_id));
-            if (!summary) {
-                hireByLane.set(lane.lane_id, {
-                    ...laneHireFields(lane, aliveChildrenByParent),
-                    hire_source: "local",
-                });
-                remoteSnapshotMetadata.set(lane.lane_id, { ageSeconds: null, stale: true, loading: true });
-                refreshNeeded = true;
-                remoteLanesLoading = true;
-                continue;
-            }
-            const ageMs = Math.max(0, nowMs - Date.parse(summary.cached_at));
-            const stale = ageMs >= OUTPOST_HIRE_SUMMARY_CACHE_TTL_MS;
-            hireByLane.set(lane.lane_id, {
-                hire_grant: summary.hire_grant,
-                hire_alive_children: summary.hire_alive_children,
-                hire: summary.hire,
-                hire_summary: summary.hire_summary,
-                hire_source: "owner",
-            });
-            remoteSnapshotMetadata.set(lane.lane_id, {
-                ageSeconds: Math.floor(ageMs / 1_000),
-                stale,
-                loading: stale,
-            });
-            if (stale) {
-                refreshNeeded = true;
-                remoteLanesLoading = true;
-            }
-        }
-        if (refreshNeeded)
-            startOutpostLaneSnapshotRefresh(hqRoot, env);
-    }
-    const sessions = selectedLanes.filter((lane) => lane.state === "running" && lane.senior.kind === "session" && Boolean(lane.senior.id));
-    let sessionLiveness;
-    let livenessDeps;
-    if (sessions.length > 0) {
-        const liveness = await import("./lib/lanes/liveness.js");
-        sessionLiveness = liveness.sessionLiveness;
-        const base = liveness.defaultLivenessDeps();
-        livenessDeps = {
-            ...base,
-            now: () => now.getTime(),
-            homedir: () => os.homedir(),
-            env,
-            existsSync: (file) => fs.existsSync(file),
-            readFileSync: (file, encoding) => fs.readFileSync(file, encoding),
-            hostname: () => os.hostname(),
-        };
-    }
-    const livenessBySession = new Map();
-    const lanes = selectedLanes.map((lane) => {
-        const stories = laneStories(lane);
-        const remoteQueued = lane.state === "queued" && lane.host.kind === "outpost" && !laneRunsOnHost(lane, host);
-        let seniorLost = false;
-        if (lane.state === "running" && lane.senior.kind === "session" && lane.senior.id && sessionLiveness && livenessDeps) {
-            const sessionId = lane.senior.id;
-            const cached = livenessBySession.get(sessionId);
-            if (cached !== undefined)
-                seniorLost = cached;
-            else {
-                const state = sessionLiveness(hqRoot, sessionId, {
-                    nowMs: now.getTime(),
-                    deps: livenessDeps,
-                });
-                seniorLost = state === null || state === "ended" || state === "lost";
-                livenessBySession.set(sessionId, seniorLost);
-            }
-        }
-        return {
-            ...lane,
-            ...hireByLane.get(lane.lane_id),
-            stories,
-            story_ids: stories.map((story) => story.story_id),
-            no_story_reason: lane.no_story_reason ?? null,
-            ...(remoteQueued ? { state: "remote", remote_state: lane.state, queued_reason: undefined } : {}),
-            ...(remoteSnapshotMetadata.has(lane.lane_id)
-                ? {
-                    remote_snapshot_age_s: remoteSnapshotMetadata.get(lane.lane_id).ageSeconds,
-                    remote_snapshot_stale: remoteSnapshotMetadata.get(lane.lane_id).stale,
-                    ...(remoteSnapshotMetadata.get(lane.lane_id).loading ? { remote_snapshot_loading: true } : {}),
-                }
-                : {}),
-            overdue: Boolean(lane.overdue) || isOverdue(hqRoot, lane.lane_id, now),
-            stalled: Boolean(lane.stalled),
-            senior_lost: seniorLost,
-        };
-    });
-    return { lanes, ...(remoteLanesLoading ? { remote_lanes_loading: true } : {}) };
-}
-/** Lightweight implementation for the exact cache-first `lanes list --json` entrypoint. */
-export async function runFastCachedLanesList() {
-    try {
-        const env = process.env;
-        const hqRoot = resolveLanesHqRoot({ env, cwd: process.cwd() });
-        const now = new Date();
-        const host = resolveAdmissionHost({
-            hostname: () => os.hostname(),
-            readOutpostIdentity: () => readOutpostIdentity(),
-        });
-        const lanes = await buildLaneList(hqRoot, readAllLanes(hqRoot), host, now, env);
-        printJson({ ok: true, action: "list", ...lanes });
-    }
-    catch (err) {
-        failJson(err);
-    }
-}
-//# sourceMappingURL=fast-lanes-list.js.map

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

@@ -1,23 +0,0 @@
-import { type FlagClient, type FlagClientOptions } from "@indigoai-us/hq-flags-client";
-export declare const CLIENT_HEALTH_SENTRY_DIRECT_FLAG = "client-health.sentry-direct";
-export declare const CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK = false;
-export declare const CLIENT_HEALTH_SENTRY_DIRECT_TIMEOUT_MS = 150;
-type ClientHealthFlagClient = Pick<FlagClient, "ready" | "isEnabled" | "close">;
-export interface ClientHealthSentryFlagDependencies {
-    env?: NodeJS.ProcessEnv;
-    createClient?: (options: FlagClientOptions) => ClientHealthFlagClient;
-    getToken?: FlagClientOptions["getToken"];
-    tokenTimeoutMs?: number;
-    fetch?: typeof fetch;
-    reportFailure?: (error: unknown) => void;
-}
-export interface ClientHealthSentryCompany {
-    companyUid: string;
-    companySlug?: string;
-}
-/** Resolve the active company gate with a bounded hq-flags read. */
-export declare function clientHealthSentryDirectEnabled(dependencies?: ClientHealthSentryFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
-/** Resolve the default-off gate for one explicitly identified company. */
-export declare function clientHealthSentryDirectEnabledForCompany(company: ClientHealthSentryCompany, dependencies?: ClientHealthSentryFlagDependencies, callerSignal?: AbortSignal): Promise<boolean>;
-export {};
-//# sourceMappingURL=client-health-sentry-flag.d.ts.map

package/dist/lib/doctor/client-health-sentry-flag.js

@@ -1,99 +0,0 @@
-import { createFlagClient, } from "@indigoai-us/hq-flags-client";
-import { resolveFlagRegistryEndpoint } from "../flag-registry-endpoint.js";
-import { getClientHealthFlagToken } from "./client-health-flag-token.js";
-export const CLIENT_HEALTH_SENTRY_DIRECT_FLAG = "client-health.sentry-direct";
-export const CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK = false;
-export const CLIENT_HEALTH_SENTRY_DIRECT_TIMEOUT_MS = 150;
-function reportFlagFailure(error) {
-    const name = error instanceof Error ? error.name : "UnknownError";
-    const safeName = /^[A-Za-z][A-Za-z0-9]{0,63}$/.test(name) ? name : "UnknownError";
-    process.stderr.write(`HQ client-health Sentry flag lookup failed (${safeName}); using default off.\n`);
-}
-function combineSignals(first, second) {
-    return first ? AbortSignal.any([first, second]) : second;
-}
-/** Resolve the active company gate with a bounded hq-flags read. */
-export async function clientHealthSentryDirectEnabled(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_SENTRY_DIRECT_FALLBACK;
-    }
-    return clientHealthSentryDirectEnabledForCompany({
-        companyUid,
-        companySlug: env.HQ_COMPANY_SLUG?.trim() || undefined,
-    }, dependencies, callerSignal);
-}
-/** Resolve the default-off gate for one explicitly identified company. */
-export async function clientHealthSentryDirectEnabledForCompany(company, dependencies = {}, callerSignal) {
-    const env = dependencies.env ?? process.env;
-    const companyUid = company.companyUid.trim();
-    if (!/^cmp_[A-Za-z0-9]{3,128}$/.test(companyUid)) {
-        return CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK;
-    }
-    if (callerSignal?.aborted)
-        return CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK;
-    let client;
-    let failed = false;
-    let failureReported = false;
-    let enabled = CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK;
-    const reportFailureOnce = (error) => {
-        failed = true;
-        if (failureReported)
-            return;
-        failureReported = true;
-        (dependencies.reportFailure ?? reportFlagFailure)(error);
-    };
-    let token;
-    try {
-        token = await getClientHealthFlagToken(dependencies.getToken, dependencies.tokenTimeoutMs, callerSignal);
-    }
-    catch (error) {
-        if (!callerSignal?.aborted)
-            reportFailureOnce(error);
-        return CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK;
-    }
-    const companySlug = company.companySlug?.trim() || "";
-    const deadline = AbortSignal.timeout(CLIENT_HEALTH_SENTRY_DIRECT_TIMEOUT_MS);
-    const signal = callerSignal ? AbortSignal.any([callerSignal, deadline]) : deadline;
-    const doFetch = dependencies.fetch ?? globalThis.fetch;
-    try {
-        client = (dependencies.createClient ?? createFlagClient)({
-            endpoint: resolveFlagRegistryEndpoint(undefined, env),
-            companyUid,
-            ...(companySlug && /^[A-Za-z0-9][A-Za-z0-9-]{0,63}$/.test(companySlug)
-                ? { companyIdentifiers: [companySlug] }
-                : {}),
-            env: {},
-            getToken: () => token,
-            fetch: (input, init) => doFetch(input, {
-                ...init,
-                signal: combineSignals(init?.signal ?? undefined, signal),
-            }),
-            refreshIntervalMs: 0,
-            requestTimeoutMs: CLIENT_HEALTH_SENTRY_DIRECT_TIMEOUT_MS,
-            onError: reportFailureOnce,
-        });
-        await client.ready();
-        if (!failed && !signal.aborted) {
-            enabled = client.isEnabled(CLIENT_HEALTH_SENTRY_DIRECT_FLAG, {
-                fallback: CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK,
-            });
-        }
-    }
-    catch (error) {
-        reportFailureOnce(error);
-    }
-    finally {
-        try {
-            client?.close();
-        }
-        catch (error) {
-            reportFailureOnce(error);
-        }
-    }
-    return failed || signal.aborted
-        ? CLIENT_HEALTH_SENTRY_DIRECT_FALLBACK
-        : enabled;
-}
-//# sourceMappingURL=client-health-sentry-flag.js.map

package/dist/lib/doctor/client-health-sentry.d.ts

@@ -1,71 +0,0 @@
-export declare const CLIENT_HEALTH_SENTRY_NOT_HANDLED_EXIT_CODE = 10;
-export declare const CLIENT_HEALTH_SENTRY_MAX_INPUT_BYTES: number;
-export declare const CLIENT_HEALTH_SENTRY_MAX_FINDINGS = 250;
-export declare const CLIENT_HEALTH_INSTALL_ID_FILENAME = "install-id";
-export declare const CLIENT_HEALTH_LAST_RESULT_FILENAME = "last-result.json";
-export type ClientHealthFixOutcome = "not_auto_fixable" | "fix_failed" | "fix_timed_out";
-export type ClientHealthStatus = "FAIL" | "WARN";
-export type ClientHealthCheckClass = "sync.update.core" | "sync.journal.personal" | "sync.journal.personal_vault" | "sync.journal.company" | "sync.manifest.personal" | "sync.manifest.personal_vault" | "sync.manifest.company" | "sync.runtime" | "other";
-export interface ClientHealthSentryEvent {
-    message: string;
-    level: "warning";
-    fingerprint: ["client-health", ClientHealthCheckClass, string];
-    tags: {
-        check_class: ClientHealthCheckClass;
-        reason_code: string;
-        fix_outcome: ClientHealthFixOutcome;
-        status: ClientHealthStatus;
-        failing_check_count: string;
-        cli_version: string;
-        core_version: string;
-        sync_version: string;
-        platform: string;
-        arch: string;
-    };
-    user: {
-        id: string;
-        ip_address: null;
-    };
-}
-interface ClientHealthFinding {
-    checkClass: ClientHealthCheckClass;
-    companySlug: string | null;
-    reasonCode: string;
-    status: ClientHealthStatus;
-}
-export interface ClientHealthLastResult {
-    check_class: ClientHealthCheckClass;
-    outcome: ClientHealthFixOutcome;
-    next_step: string;
-    result_id: string;
-}
-export interface ClientHealthReportVersions {
-    cli: string | null;
-    core: string | null;
-    sync: string | null;
-}
-export interface ClientHealthSentryReportDependencies {
-    resolveFlagForCompany: (companySlug: string | null) => Promise<boolean>;
-    sendEvents: (events: readonly ClientHealthSentryEvent[]) => Promise<boolean>;
-    randomUUID?: () => string;
-    versions?: (hqRoot: string) => ClientHealthReportVersions;
-    platform?: () => string;
-    arch?: () => string;
-}
-/** Collapse company-specific doctor ids before any value can enter a Sentry event. */
-export declare function normalizeClientHealthCheckId(checkId: string): ClientHealthCheckClass;
-/** Keep only the doctor fields needed for safe health reporting. */
-export declare function parseClientHealthDoctorFindings(input: string): ClientHealthFinding[];
-/** Store a random UUID once per local HQ install, without using host identity. */
-export declare function getOrCreateClientHealthInstallId(hqRoot: string, randomUUID?: () => string): string;
-/**
- * Report only after every finding's company has opted in. A mixed rollout
- * falls back as one batch so the old path cannot duplicate partially sent rows.
- */
-export declare function handleClientHealthSentryReport(input: {
-    hqRoot: string;
-    doctorJson: string;
-    fixOutcome: string;
-}, dependencies: ClientHealthSentryReportDependencies): Promise<"handled" | "not_handled" | "send_failed">;
-export {};
-//# sourceMappingURL=client-health-sentry.d.ts.map