@indigoai-us/hq-cli 5.301.0 → 5.303.0

package/dist/lib/report-snapshot.d.ts

@@ -1,7 +1,5 @@
 /** File name of the snapshot inside the published report. */
 export declare const REPORT_PREVIEW_FILE = "hq-preview.png";
-export declare const REPORT_PREVIEW_WIDTH = 1280;
-export declare const REPORT_PREVIEW_HEIGHT = 720;
 /** First installed browser that can take a snapshot, or null. */
 export declare function findSnapshotBrowser(env?: NodeJS.ProcessEnv, platform?: string, exists?: (file: string) => boolean): string | null;
 export declare function snapshotArgs(indexFile: string, outFile: string, profileDir: string): string[];

package/dist/lib/report-snapshot.js

@@ -13,8 +13,8 @@ import * as path from "node:path";
 import { pathToFileURL } from "node:url";
 /** File name of the snapshot inside the published report. */
 export const REPORT_PREVIEW_FILE = "hq-preview.png";
-export const REPORT_PREVIEW_WIDTH = 1280;
-export const REPORT_PREVIEW_HEIGHT = 720;
+const REPORT_PREVIEW_WIDTH = 1280;
+const REPORT_PREVIEW_HEIGHT = 720;
 const SNAPSHOT_TIMEOUT_MS = 30_000;
 const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47]);
 const BROWSER_PATHS = {

package/dist/lib/search-index/background.d.ts

@@ -47,6 +47,7 @@ export type SpawnWorkerIo = {
     closeSync: (fd: number) => void;
     spawn: (command: string, args: string[], options: {
         detached: boolean;
+        windowsHide: boolean;
         stdio: StdioOptions;
     }) => {
         pid?: number;

package/dist/lib/search-index/background.js

@@ -92,6 +92,7 @@ export function defaultSpawnWorker({ logPath, fallbackLogPath }, io = defaultSpa
         : ['ignore', opened.fd, opened.fd];
     const child = io.spawn(process.execPath, [entry, 'index', 'background', '--worker', ...logArgs], {
         detached: true,
+        windowsHide: true,
         stdio,
     });
     if (opened.fd !== null)

package/dist/utils/run-bundled-script.js

@@ -29,6 +29,7 @@
  *     script needs to see termination, not a success code.
  */
 import { spawnSync } from "child_process";
+import * as fs from "node:fs";
 import * as path from "path";
 import { resolveBundledAsset } from "./hq-roots.js";
 /**
@@ -41,6 +42,93 @@ export function interpreterFor(asset) {
     const ext = path.extname(asset).toLowerCase();
     return ext === ".mjs" || ext === ".js" || ext === ".cjs" ? "node" : "bash";
 }
+function envValue(env, name) {
+    const key = Object.keys(env).find((candidate) => candidate.toLowerCase() === name.toLowerCase());
+    return key ? env[key] : undefined;
+}
+function isFile(file, lookupErrors) {
+    try {
+        return fs.statSync(file).isFile();
+    }
+    catch (error) {
+        // Missing PATH candidates are expected during lookup; retain the cause so
+        // the final actionable error can expose why no interpreter was resolved.
+        lookupErrors.push(error);
+        return false;
+    }
+}
+function isWithinWindowsDirectory(file, directory) {
+    const normalizedFile = path.win32.resolve(file).toLowerCase();
+    const normalizedDirectory = path.win32.resolve(directory).toLowerCase();
+    return (normalizedFile === normalizedDirectory ||
+        normalizedFile.startsWith(`${normalizedDirectory}${path.win32.sep}`));
+}
+function isExcludedWindowsBash(file, env) {
+    if (path.win32.basename(file).toLowerCase() !== "bash.exe")
+        return false;
+    const windowsDir = envValue(env, "SystemRoot") ?? envValue(env, "WINDIR") ?? "C:\\Windows";
+    const systemBash = path.win32.resolve(windowsDir, "System32", "bash.exe");
+    if (path.win32.resolve(file).toLowerCase() === systemBash.toLowerCase())
+        return true;
+    const localAppData = envValue(env, "LOCALAPPDATA");
+    return Boolean(localAppData &&
+        isWithinWindowsDirectory(file, path.win32.resolve(localAppData, "Microsoft", "WindowsApps")));
+}
+function findOnWindowsPath(executable, env, lookupErrors) {
+    const pathValue = envValue(env, "PATH") ?? "";
+    const extensions = executable.includes(".")
+        ? [""]
+        : (envValue(env, "PATHEXT") ?? ".COM;.EXE;.BAT;.CMD")
+            .split(";")
+            .filter(Boolean)
+            .map((ext) => ext.toLowerCase());
+    for (const entry of pathValue.split(";").filter(Boolean)) {
+        const directory = entry.trim().replace(/^"|"$/g, "");
+        for (const extension of extensions) {
+            const candidate = path.win32.join(directory, `${executable}${extension}`);
+            if (!isExcludedWindowsBash(candidate, env) && isFile(candidate, lookupErrors))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+function resolveWindowsBash(env) {
+    const lookupErrors = [];
+    const configured = envValue(env, "CLAUDE_CODE_GIT_BASH_PATH");
+    if (configured && !isExcludedWindowsBash(configured, env) && isFile(configured, lookupErrors)) {
+        return { executable: configured, cause: lookupErrors.at(-1) };
+    }
+    const pathBash = findOnWindowsPath("bash", env, lookupErrors);
+    if (pathBash)
+        return { executable: pathBash, cause: lookupErrors.at(-1) };
+    const gitExe = findOnWindowsPath("git.exe", env, lookupErrors);
+    if (gitExe) {
+        const derived = path.win32.resolve(path.win32.dirname(gitExe), "..", "bin", "bash.exe");
+        if (!isExcludedWindowsBash(derived, env) && isFile(derived, lookupErrors)) {
+            return { executable: derived, cause: lookupErrors.at(-1) };
+        }
+    }
+    const programFiles = envValue(env, "ProgramFiles") ?? "C:\\Program Files";
+    const localAppData = envValue(env, "LOCALAPPDATA");
+    const standardPaths = [
+        path.win32.join(programFiles, "Git", "bin", "bash.exe"),
+        ...(localAppData ? [path.win32.join(localAppData, "Programs", "Git", "bin", "bash.exe")] : []),
+    ];
+    const executable = standardPaths.find((candidate) => !isExcludedWindowsBash(candidate, env) && isFile(candidate, lookupErrors));
+    return {
+        executable,
+        cause: lookupErrors.at(-1) ??
+            Object.assign(new Error("Bash was not found (ENOENT)"), { code: "ENOENT" }),
+    };
+}
+function bashNotFoundError(asset, cause) {
+    const isHandoff = asset.replaceAll("\\", "/").endsWith("core/scripts/handoff-finalize.sh");
+    const recovery = isHandoff
+        ? "The handoff was not saved; rerun the command."
+        : "The script did not run; rerun this command.";
+    return new Error(`Bash was not found to run bundled script ${asset}. Install Git for Windows or ` +
+        `set CLAUDE_CODE_GIT_BASH_PATH. ${recovery}`, { cause });
+}
 /**
  * Execute a bundled scaffold script and return its exit code.
  *
@@ -56,12 +144,26 @@ export function runBundledScript(opts) {
         env.CLAUDE_PROJECT_DIR = opts.hqRoot;
     }
     Object.assign(env, opts.env ?? {});
-    const result = spawnSync(interpreterFor(opts.asset), [script, ...(opts.args ?? [])], {
+    const interpreter = interpreterFor(opts.asset);
+    const windowsBash = process.platform === "win32" && interpreter === "bash"
+        ? resolveWindowsBash(env)
+        : undefined;
+    const executable = windowsBash?.executable ?? interpreter;
+    if (windowsBash && !windowsBash.executable) {
+        throw bashNotFoundError(opts.asset, windowsBash.cause);
+    }
+    const result = spawnSync(executable, [script, ...(opts.args ?? [])], {
         cwd: opts.cwd,
         env,
         stdio: "inherit",
     });
     if (result.error) {
+        const spawnError = result.error;
+        if (process.platform === "win32" &&
+            interpreter === "bash" &&
+            spawnError.code === "ENOENT") {
+            throw bashNotFoundError(opts.asset, spawnError);
+        }
         throw new Error(`Failed to run bundled script ${opts.asset}: ${result.error.message}`);
     }
     if (result.signal) {

package/dist/utils/update-command-supervisor.cjs

@@ -186,6 +186,7 @@ function runUpdateSupervisor(config, dependencies = {}) {
   try {
     child = spawn(config.cmd, config.args, {
       detached: true,
+      windowsHide: true,
       stdio: ["ignore", "inherit", config.diagnosticMarker ? "pipe" : "inherit"],
       shell: config.shell,
     });

package/dist/utils/version-gate.js

@@ -637,7 +637,7 @@ export { buildSpawnPlan, quoteForWindowsShell };
  * protection silently disappearing.
  */
 export function inOwnProcessGroup(options) {
-    return { ...options, detached: true };
+    return { ...options, detached: true, windowsHide: true };
 }
 /** Tail of captured installer stderr kept to explain a failure. */
 const INSTALL_DETAIL_MAX_CHARS = 400;

package/package.json

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