@indigoai-us/hq-cli 5.167.0 → 5.169.0

package/dist/lib/lanes/outpost-worktree-pruner-flag.js

@@ -0,0 +1,76 @@
+import { loadCachedTokens } from "@indigoai-us/hq-cloud";
+import { createFlagClient } from "@indigoai-us/hq-flags-client";
+export const OUTPOST_WORKTREE_PRUNER_FLAG = "outpost.worktree-pruner";
+export const OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK = false;
+export const OUTPOST_WORKTREE_PRUNER_FLAG_TIMEOUT_MS = 5_000;
+/**
+ * Read the company-scoped rollout flag with bounded I/O. Missing endpoint,
+ * company identity, registry row, cached token, or registry availability all
+ * leave destructive pruning disabled.
+ */
+function errorClass(error) {
+    return error instanceof Error ? error.name : "UnknownError";
+}
+function reportFlagFailure(error) {
+    process.stderr.write(`${JSON.stringify({
+        event: "outpost.worktree_pruner.flag_read_failed",
+        flag: OUTPOST_WORKTREE_PRUNER_FLAG,
+        error: errorClass(error),
+        fallback: OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK,
+    })}\n`);
+}
+export async function outpostWorktreePrunerEnabled(dependencies = {}) {
+    const env = dependencies.env ?? process.env;
+    const endpoint = env.HQ_FLAGS_API_URL?.trim() || "";
+    const companyUid = env.HQ_COMPANY_UID?.trim() || "";
+    if (!endpoint || !companyUid) {
+        process.stderr.write(`${JSON.stringify({
+            event: "outpost.worktree_pruner.flag_config_missing",
+            flag: OUTPOST_WORKTREE_PRUNER_FLAG,
+            missing: [
+                ...(!endpoint ? ["HQ_FLAGS_API_URL"] : []),
+                ...(!companyUid ? ["HQ_COMPANY_UID"] : []),
+            ],
+            fallback: OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK,
+        })}\n`);
+        return OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK;
+    }
+    const companySlug = env.HQ_COMPANY_SLUG?.trim() || "";
+    let client;
+    let enabled = OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK;
+    let failed = false;
+    let reported = false;
+    const reportFailure = (error) => {
+        failed = true;
+        if (reported)
+            return;
+        reported = true;
+        (dependencies.reportFailure ?? reportFlagFailure)(error);
+    };
+    try {
+        client = (dependencies.createClient ?? createFlagClient)({
+            endpoint,
+            companyUid,
+            ...(companySlug ? { companyIdentifiers: [companySlug] } : {}),
+            getToken: dependencies.getToken ?? (() => loadCachedTokens()?.idToken ?? ""),
+            refreshIntervalMs: 0,
+            requestTimeoutMs: OUTPOST_WORKTREE_PRUNER_FLAG_TIMEOUT_MS,
+            onError: reportFailure,
+        });
+        await client.ready();
+        enabled = client.isEnabled(OUTPOST_WORKTREE_PRUNER_FLAG, {
+            fallback: OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK,
+        });
+    }
+    catch (error) {
+        reportFailure(error);
+    }
+    try {
+        client?.close();
+    }
+    catch (error) {
+        reportFailure(error);
+    }
+    return failed ? OUTPOST_WORKTREE_PRUNER_FLAG_FALLBACK : enabled;
+}
+//# sourceMappingURL=outpost-worktree-pruner-flag.js.map

package/dist/lib/lanes/outpost-worktree-pruner.d.ts

@@ -0,0 +1,60 @@
+/** Safe, host-local cleanup for terminal HQ worktrees on outposts. */
+export type PrunerTrigger = "pressure" | "daily" | "manual";
+export interface OutpostWorktreePrunerOptions {
+    hqRoot: string;
+    trigger: PrunerTrigger;
+    dryRun: boolean;
+    featureEnabled: boolean;
+    minAgeDays: number;
+    now?: number;
+    /** Test seam. Production uses /proc. */
+    processRoot?: string;
+    /** Test seam. Production safely resolves and runs `pnpm store prune`. */
+    runPackageStorePrune?: () => PackageStorePruneResult;
+    /** Test seam for the storage threshold; production reads filesystem stats. */
+    readDiskUsedPercent?: (hqRoot: string) => number | null;
+    /** Test seam for classifying inaccessible /proc entries by owner. */
+    processUserId?: number;
+    /** Test seam for /proc reads; production uses the host filesystem. */
+    processPathReader?: ProcessPathReader;
+}
+export interface ProcessPathReader {
+    readdirSync(path: string): string[];
+    readlinkSync(path: string): string;
+    uid(path: string): number;
+}
+export interface PackageStorePruneResult {
+    attempted: boolean;
+    reason?: string;
+    bytes_freed?: number;
+}
+export interface OutpostWorktreePrunerResult {
+    event: "outpost.worktree_pruner.run";
+    trigger: PrunerTrigger;
+    dry_run: boolean;
+    feature_enabled: boolean;
+    skipped?: string;
+    pressure_percent?: number;
+    min_age_days: number;
+    candidates: string[];
+    removed: Array<{
+        path: string;
+        bytes_freed: number;
+    }>;
+    kept: Array<{
+        path: string;
+        reason: string;
+    }>;
+    bytes_freed: number;
+    bytes_freed_basis: "statfs_available_byte_delta";
+    package_store: PackageStorePruneResult;
+}
+/**
+ * Prune only registered worktrees beneath workspace/worktrees after every
+ * local, git, age, and liveness check has passed. The function never shells
+ * out to rm and never follows symlinks while estimating or checking age.
+ */
+export declare function runOutpostWorktreePruner(options: OutpostWorktreePrunerOptions): OutpostWorktreePrunerResult;
+export declare const OUTPOST_WORKTREE_PRUNER_DEFAULT_MIN_AGE_DAYS = 14;
+export declare const OUTPOST_WORKTREE_PRUNER_PRESSURE_THRESHOLD_PERCENT = 78;
+//# sourceMappingURL=outpost-worktree-pruner.d.ts.map