@indigoai-us/hq-cli 5.315.0 → 5.317.0

package/dist/lib/lanes/hooks-install.js

@@ -96,6 +96,82 @@ function groupsContainCommand(groups, command) {
         return group.hooks.some((hook) => isPlainObject(hook) && hook.type === "command" && hook.command === command);
     });
 }
+/** Parse the single-quoted argv form emitted by shellQuote without invoking a shell. */
+function parseShellQuotedArguments(command) {
+    const args = [];
+    let index = 0;
+    while (index < command.length) {
+        while (/\s/.test(command[index] ?? ""))
+            index += 1;
+        if (index >= command.length)
+            break;
+        if (command[index] !== "'")
+            return null;
+        index += 1;
+        let value = "";
+        let closed = false;
+        while (index < command.length) {
+            if (command.startsWith("'\\''", index)) {
+                value += "'";
+                index += 4;
+            }
+            else if (command[index] === "'") {
+                index += 1;
+                closed = true;
+                break;
+            }
+            else {
+                value += command[index];
+                index += 1;
+            }
+        }
+        if (!closed)
+            return null;
+        args.push(value);
+        if (index < command.length && !/\s/.test(command[index]))
+            return null;
+    }
+    return args;
+}
+function isInstalledDrainEntry(entryPath) {
+    if (!path.isAbsolute(entryPath))
+        return false;
+    const segments = path.resolve(entryPath).split(path.sep);
+    return segments.slice(-5).join(path.sep) ===
+        ["node_modules", "@indigoai-us", "hq-cli", "dist", "lanes-drain-hook.js"].join(path.sep);
+}
+/**
+ * The provider settings can outlive a CLI worktree or global package update.
+ * Both paths target the same hq-cli drain entry, so recognize an installed
+ * package entry alongside the exact entry belonging to this CLI invocation.
+ */
+function drainCommandsMatch(candidate, expected) {
+    if (candidate === expected)
+        return true;
+    const argv = parseShellQuotedArguments(candidate);
+    if (argv === null || argv.length !== 2)
+        return false;
+    if (path.parse(argv[0]).name.toLowerCase() !== "node")
+        return false;
+    if (!isInstalledDrainEntry(argv[1]))
+        return false;
+    return fs.existsSync(argv[0]) && fs.existsSync(argv[1]);
+}
+function groupsContainDrainCommand(groups, expected) {
+    if (!Array.isArray(groups))
+        return false;
+    return groups.some((group) => {
+        if (!isPlainObject(group) || !Array.isArray(group.hooks))
+            return false;
+        return group.hooks.some((hook) => isPlainObject(hook) &&
+            hook.type === "command" &&
+            typeof hook.command === "string" &&
+            drainCommandsMatch(hook.command, expected));
+    });
+}
+function tomlHasDrainCommand(parsed, expected) {
+    return isPlainObject(parsed.hooks) && groupsContainDrainCommand(parsed.hooks.PreToolUse, expected);
+}
 function removeCommandFromGroups(groups, command) {
     let changed = false;
     const next = groups.flatMap((group) => {
@@ -413,7 +489,7 @@ export function probeDrainHookRegistration(provider, providerHome) {
             const toml = parseToml(text);
             return {
                 ...base,
-                registered: isPlainObject(toml) && tomlHasCommand(toml, command) && tomlHooksFeatureEnabled(toml),
+                registered: isPlainObject(toml) && tomlHasDrainCommand(toml, command) && tomlHooksFeatureEnabled(toml),
             };
         }
         const json = JSON.parse(text);
@@ -421,7 +497,7 @@ export function probeDrainHookRegistration(provider, providerHome) {
             ...base,
             registered: isPlainObject(json) &&
                 isPlainObject(json.hooks) &&
-                groupsContainCommand(json.hooks.PreToolUse, command),
+                groupsContainDrainCommand(json.hooks.PreToolUse, command),
         };
     }
     catch (err) {

package/dist/lib/lanes/keep-alive-audit.d.ts

@@ -1,10 +1,10 @@
-export type KeepAliveAuditVerdict = "on_time" | "late" | "early_wake" | "message_wake" | "self_wake" | "early_by_keep_alive" | "not_restarted" | "waiting";
-export interface KeepAliveAuditRestart {
+type KeepAliveAuditVerdict = "on_time" | "late" | "early_wake" | "message_wake" | "self_wake" | "early_by_keep_alive" | "not_restarted" | "waiting";
+interface KeepAliveAuditRestart {
     at: string;
     trigger: string;
     caller: string | null;
 }
-export interface KeepAliveAuditRow {
+interface KeepAliveAuditRow {
     lane: string;
     project: string;
     profile: string | null;
@@ -15,7 +15,7 @@ export interface KeepAliveAuditRow {
     restart: KeepAliveAuditRestart | null;
     verdict: KeepAliveAuditVerdict;
 }
-export interface KeepAliveAuditSummary {
+interface KeepAliveAuditSummary {
     by_verdict: Record<KeepAliveAuditVerdict, number>;
     not_restarted: number;
     late_over_10m: number;
@@ -23,7 +23,7 @@ export interface KeepAliveAuditSummary {
     self_wake: number;
     stopped_and_not_restarted_on_their_own: number;
 }
-export interface KeepAliveAuditError {
+interface KeepAliveAuditError {
     lane: string;
     error: string;
     path: string;
@@ -43,4 +43,5 @@ export declare function buildKeepAliveAudit(input: {
     laneId?: string;
 }): KeepAliveAuditResult;
 export declare function formatKeepAliveAuditText(result: KeepAliveAuditResult): string;
+export {};
 //# sourceMappingURL=keep-alive-audit.d.ts.map

package/dist/lib/lanes/outpost-dispatch.d.ts

@@ -95,10 +95,19 @@ export declare const REMOTE_LANE_READ_ENV = "HQ_LANES_REMOTE_READ";
 export declare function buildOutpostLaneListCommand(input?: {
     hqBinary?: string;
     laneIds?: readonly string[];
+    laneUlids?: readonly string[];
     active?: boolean;
     hierarchy?: string | readonly string[];
     snapshot?: boolean;
 }): string;
+/**
+ * Older Outpost CLIs do not know --lane-ulid. Filter their lane-list output on
+ * the owner host so the exec transport carries only the requested record.
+ */
+export declare function buildOutpostLegacyLaneUlidListCommand(input: {
+    hqBinary?: string;
+    ulid: string;
+}): string;
 /** Read questions on one Outpost, scoped to a company when supplied. */
 export declare function buildOutpostQuestionListCommand(input?: {
     company?: string;

package/dist/lib/lanes/outpost-dispatch.js

@@ -85,6 +85,8 @@ export function buildOutpostLaneListCommand(input = {}) {
     ];
     for (const laneId of input.laneIds ?? [])
         args.push("--lane", laneId);
+    for (const ulid of input.laneUlids ?? [])
+        args.push("--lane-ulid", ulid);
     if (input.active)
         args.push("--active");
     for (const laneId of typeof input.hierarchy === "string"
@@ -95,6 +97,26 @@ export function buildOutpostLaneListCommand(input = {}) {
         args.push("--snapshot");
     return withRemoteHqDir(joinCommandParts(args));
 }
+/**
+ * Older Outpost CLIs do not know --lane-ulid. Filter their lane-list output on
+ * the owner host so the exec transport carries only the requested record.
+ */
+export function buildOutpostLegacyLaneUlidListCommand(input) {
+    const hqBinary = input.hqBinary?.trim() || "hq";
+    const script = [
+        "const { spawnSync } = require('node:child_process');",
+        `const result = spawnSync(${JSON.stringify(hqBinary)}, ['lanes', 'list', '--json'], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024, env: { ...process.env, ${REMOTE_LANE_READ_ENV}: '1' } });`,
+        "if (result.error || result.status !== 0) { console.error(JSON.stringify({ error: result.error?.message || 'legacy Outpost lane list failed', status: result.status, signal: result.signal, stderr_tail: String(result.stderr || '').slice(-4096), stdout_tail: String(result.stdout || '').slice(-4096) })); process.exit(result.status || 1); }",
+        "try {",
+        "const payload = JSON.parse(result.stdout);",
+        "if (!payload || payload.ok !== true || payload.action !== 'list' || !Array.isArray(payload.lanes)) throw new Error('malformed lane list');",
+        `const ulid = ${JSON.stringify(input.ulid.toUpperCase())};`,
+        "payload.lanes = payload.lanes.filter(row => row && typeof row.lane_id === 'string' && row.lane_id.slice(0, 26).toUpperCase() === ulid);",
+        "process.stdout.write(JSON.stringify(payload));",
+        "} catch (error) { console.error('Legacy Outpost returned invalid lane-list JSON: ' + (error instanceof Error ? error.message : String(error))); process.exit(1); }",
+    ].join("\n");
+    return withRemoteHqDir(joinCommandParts(["node", "-e", script]));
+}
 /** Read questions on one Outpost, scoped to a company when supplied. */
 export function buildOutpostQuestionListCommand(input = {}) {
     const args = ["hq", "lanes", "questions", "list"];

package/dist/utils/version-gate.js

@@ -1382,7 +1382,9 @@ function attemptRequiredUpdate(decision, deps, install) {
     const command = decision.updateCommand;
     const isManagedOutsideNpm = install.manager !== "npm";
     const prefix = install.prefix;
-    const stagedNpmPrefix = Boolean(!isManagedOutsideNpm && prefix && /\s/.test(prefix));
+    // Any npm global install with a known prefix must build away from the live package.
+    // An interrupted in-place npm install can leave hq-cli itself un-runnable.
+    const stagedNpmPrefix = Boolean(!isManagedOutsideNpm && prefix);
     const runner = deps.runner ?? runUpdateCommand;
     // Resolve the concrete install argv once so the sudo fallback below can re-run
     // the EXACT same command under elevation.
@@ -1422,7 +1424,7 @@ function attemptRequiredUpdate(decision, deps, install) {
     else if (prefix) {
         console.error(chalk.dim(`  Installing into npm prefix: ${prefix}`));
         if (stagedNpmPrefix) {
-            console.error(chalk.dim("  Building in a space-free temporary prefix before activation."));
+            console.error(chalk.dim("  Building outside the active npm prefix before activation."));
             const installStaged = deps.installNpmPackageStaged;
             if (!installStaged) {
                 result = { ok: false, detail: "staged npm installer was not loaded" };
@@ -1556,11 +1558,10 @@ export async function enforceVersionGate(onUpdateRecommended, options = {}) {
     // neither downstream path repeats it.
     const install = resolveRunningInstall();
     if (decision.updateRequired) {
-        // Load the staged installer only for the uncommon spaced npm-prefix path.
-        // The version gate is imported during every CLI startup, including native
-        // fast routes, so eagerly importing this filesystem-heavy module adds cost
-        // to commands that never update.
-        const installNpmPackageStaged = install.manager === "npm" && install.prefix && /\s/.test(install.prefix)
+        // Load the staged installer only when an npm prefix is resolved. The version
+        // gate is imported during every CLI startup, so keep the filesystem-heavy
+        // module off commands that never need a required update.
+        const installNpmPackageStaged = install.manager === "npm" && install.prefix
             ? (await import("./staged-npm-install.js")).installNpmPackageStaged
             : undefined;
         // Exits the process, EXCEPT when another updater holds the shared update

package/package.json

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