@indigoai-us/hq-cli 5.273.0-alpha.0 → 5.274.0

package/dist/lib/daemon/sync-runner.js

@@ -1,277 +0,0 @@
-/** Local status and resource controls shared by the daemon and its sync runner. */
-import * as crypto from "node:crypto";
-import { spawnSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-export const SYNC_RUNNER_OWNER = "hq-daemon";
-export const SYNC_RUNNER_LEASE_CONFLICT_EXIT = 20;
-export const SYNC_RUNNER_LEASE_RETRY_MS = 15_000;
-export const DEFAULT_SYNC_HEARTBEAT_TIMEOUT_MS = 300_000;
-export const DEFAULT_SYNC_RUNNER_HEAP_MB = 3_584;
-export const SYNC_HEARTBEAT_TIMEOUT_ENV = "HQ_DAEMON_SYNC_HEARTBEAT_TIMEOUT_SECONDS";
-export const SYNC_RUNNER_HEAP_ENV = "HQ_SYNC_RUNNER_MAX_OLD_SPACE_MB";
-const SYNC_RUNNER_COMMAND = /(?:^|[\s/\\])(?:sync-runner\.js|hq-sync-runner(?:\.(?:cmd|exe))?)(?:[\s"']|$)/i;
-function record(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : null;
-}
-/** The status file path used by hq-cloud's watch-owner lease. */
-export function watchRunnerOwnerStatusPath(hqRoot, home = os.homedir(), env = process.env) {
-    let canonicalRoot = path.resolve(hqRoot);
-    try {
-        canonicalRoot = fs.realpathSync.native(canonicalRoot);
-    }
-    catch (error) {
-        // hq-cloud uses the resolved path until the HQ root can be canonicalized.
-        if (error?.code !== "ENOENT") {
-            throw new Error(`could not canonicalize HQ root ${canonicalRoot}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-        }
-    }
-    const rootHash = crypto.createHash("sha1").update(canonicalRoot).digest("hex").slice(0, 16);
-    const stateDir = env.HQ_STATE_DIR?.trim() || path.join(home, ".hq");
-    return path.join(stateDir, "locks", `watch-owner-${rootHash}.json`);
-}
-/** Read the watch-owner status JSON without taking or changing its lease. */
-export function readWatchRunnerOwnerStatus(statusPath) {
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(statusPath, "utf8"));
-    }
-    catch (error) {
-        if (error?.code === "ENOENT")
-            return null;
-        throw new Error(`could not read watch-runner owner status at ${statusPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-    }
-    const value = record(parsed);
-    if (!value ||
-        typeof value.owner !== "string" ||
-        !Number.isInteger(value.pid) ||
-        typeof value.version !== "string" ||
-        typeof value.startedAt !== "string" ||
-        typeof value.heartbeatAt !== "string") {
-        throw new Error(`watch-runner owner status at ${statusPath} has an invalid shape`);
-    }
-    return value;
-}
-/** Match a live process command line to the hq-cloud watch runner executable. */
-export function isSyncRunnerCommandLine(commandLine) {
-    return SYNC_RUNNER_COMMAND.test(commandLine);
-}
-function commandLineArgs(commandLine) {
-    const args = [];
-    let current = "";
-    let quote = null;
-    let started = false;
-    for (let i = 0; i < commandLine.length; i++) {
-        const char = commandLine[i];
-        if (quote) {
-            if (char === quote) {
-                quote = null;
-                started = true;
-            }
-            else if (char === "\\" && commandLine[i + 1] === quote) {
-                current += commandLine[++i];
-                started = true;
-            }
-            else {
-                current += char;
-                started = true;
-            }
-            continue;
-        }
-        if (char === "'" || char === '"') {
-            quote = char;
-            started = true;
-        }
-        else if (/\s/.test(char)) {
-            if (started) {
-                args.push(current);
-                current = "";
-                started = false;
-            }
-        }
-        else {
-            current += char;
-            started = true;
-        }
-    }
-    if (started)
-        args.push(current);
-    return args;
-}
-function syncRunnerHqRoot(commandLine) {
-    const args = commandLineArgs(commandLine);
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === "--hq-root")
-            return args[i + 1] || null;
-        if (arg.startsWith("--hq-root="))
-            return arg.slice("--hq-root=".length) || null;
-    }
-    return null;
-}
-function commandLineNamesRoot(commandLine, hqRoot, platform) {
-    const parsedRoot = syncRunnerHqRoot(commandLine);
-    if (parsedRoot !== null && canonicalRoot(parsedRoot, platform) === canonicalRoot(hqRoot, platform))
-        return true;
-    const pathApi = platform === "win32" ? path.win32 : path;
-    const variants = new Set([pathApi.resolve(hqRoot)]);
-    if (platform === process.platform) {
-        try {
-            variants.add(fs.realpathSync.native(pathApi.resolve(hqRoot)));
-        }
-        catch (error) {
-            if (error?.code !== "ENOENT") {
-                throw new Error(`could not canonicalize sync runner HQ root ${hqRoot}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-            }
-        }
-    }
-    const compareFlags = platform === "win32" ? "i" : "";
-    return [...variants].some((root) => {
-        const escaped = root.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-        return new RegExp(`(?:^|\\s)--hq-root(?:=|\\s+)["']?${escaped}["']?(?=\\s|$)`, compareFlags).test(commandLine);
-    });
-}
-function canonicalRoot(root, platform) {
-    const pathApi = platform === "win32" ? path.win32 : path;
-    let resolved = pathApi.resolve(root);
-    if (platform === process.platform) {
-        try {
-            resolved = fs.realpathSync.native(resolved);
-        }
-        catch (error) {
-            if (error?.code !== "ENOENT") {
-                throw new Error(`could not canonicalize sync runner HQ root ${resolved}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-            }
-        }
-    }
-    return platform === "win32" ? resolved.toLowerCase() : resolved;
-}
-/** Return a clear wait reason when an unleased runner already targets this HQ root. */
-export function syncRunnerUnleasedBlockReason(hqRoot, processes, ownerPid, platform = process.platform, daemonRunnerPids = new Set()) {
-    const runner = processes.find((candidate) => {
-        if (daemonRunnerPids.has(candidate.pid) || candidate.pid === ownerPid)
-            return false;
-        if (!isSyncRunnerCommandLine(candidate.commandLine))
-            return false;
-        return commandLineNamesRoot(candidate.commandLine, hqRoot, platform);
-    });
-    if (!runner)
-        return undefined;
-    const lease = ownerPid === null ? "missing" : `belongs to pid ${ownerPid}`;
-    return `sync runner pid ${runner.pid} for ${hqRoot} is running without the watch-owner lease (status ${lease}); waiting for it to exit`;
-}
-/** Read complete process command lines so root matching can include trailing arguments. */
-export function listSyncRunnerProcesses(platform = process.platform, run = (command, args) => {
-    const result = spawnSync(command, args, {
-        encoding: "utf8",
-        windowsHide: true,
-        timeout: 15_000,
-        maxBuffer: 8 * 1024 * 1024,
-    });
-    return {
-        status: result.status,
-        stdout: result.stdout ?? "",
-        stderr: result.stderr ?? "",
-        ...(result.error ? { error: result.error } : {}),
-    };
-}) {
-    const command = platform === "win32" ? "powershell.exe" : "ps";
-    const args = platform === "win32"
-        ? [
-            "-NoProfile",
-            "-NonInteractive",
-            "-Command",
-            "Get-CimInstance Win32_Process | Select-Object @{Name='pid';Expression={$_.ProcessId}},@{Name='commandLine';Expression={$_.CommandLine}} | ConvertTo-Json -Compress",
-        ]
-        : ["-eww", "-o", "pid=", "-o", "args="];
-    const result = run(command, args);
-    if (result.error)
-        return { ok: false, error: `could not list process command lines: ${result.error.message}` };
-    if (result.status !== 0) {
-        return { ok: false, error: `could not list process command lines: ${(result.stderr ?? "").trim() || `exit ${result.status}`}` };
-    }
-    if (platform === "win32") {
-        let parsed;
-        try {
-            parsed = JSON.parse(result.stdout || "[]");
-        }
-        catch (error) {
-            return { ok: false, error: `could not parse Windows process list: ${error instanceof Error ? error.message : String(error)}` };
-        }
-        const rows = Array.isArray(parsed) ? parsed : [parsed];
-        return {
-            ok: true,
-            processes: rows.flatMap((row) => {
-                if (!row || typeof row !== "object")
-                    return [];
-                const value = row;
-                return Number.isInteger(value.pid) && typeof value.commandLine === "string"
-                    ? [{ pid: value.pid, commandLine: value.commandLine }]
-                    : [];
-            }),
-        };
-    }
-    const processes = [];
-    for (const line of (result.stdout ?? "").split(/\r?\n/)) {
-        const match = /^\s*(\d+)\s+(.+)$/.exec(line);
-        if (match)
-            processes.push({ pid: Number(match[1]), commandLine: match[2] });
-    }
-    return { ok: true, processes };
-}
-/** The watchdog follows the runner's NDJSON protocol, the same liveness signal used by the desktop app. */
-export function parseSyncRunnerProtocolLine(line) {
-    if (!line.trim())
-        return null;
-    const parsed = record(JSON.parse(line));
-    return parsed && typeof parsed.type === "string" && parsed.type.length > 0 ? parsed : null;
-}
-/** Summarize the runner's all-complete event for daemon status. */
-export function syncPassResult(event, completedAt = new Date().toISOString()) {
-    if (event.type !== "all-complete")
-        return null;
-    const errors = Array.isArray(event.errors) ? event.errors.length : 0;
-    const transient = Array.isArray(event.transient) ? event.transient.length : 0;
-    const status = event.partial === true || transient > 0 ? "partial" : errors > 0 ? "failed" : "ok";
-    return {
-        status,
-        completedAt,
-        ...(typeof event.companiesAttempted === "number" ? { companiesAttempted: event.companiesAttempted } : {}),
-        errors,
-        transient,
-    };
-}
-export function syncHeartbeatTimeoutMs(env) {
-    const raw = env[SYNC_HEARTBEAT_TIMEOUT_ENV]?.trim();
-    if (!raw || !/^\d+$/.test(raw))
-        return DEFAULT_SYNC_HEARTBEAT_TIMEOUT_MS;
-    const seconds = Number(raw);
-    const maxSeconds = Math.floor(2_147_483_647 / 1_000);
-    if (!Number.isSafeInteger(seconds) || seconds < 1 || seconds > maxSeconds)
-        return DEFAULT_SYNC_HEARTBEAT_TIMEOUT_MS;
-    return seconds * 1_000;
-}
-function hasHeapOption(options) {
-    const tokens = options.match(/"[^"]*"|'[^']*'|\S+/g) ?? [];
-    for (let i = 0; i < tokens.length; i++) {
-        const token = tokens[i].replaceAll("--max_old_space_size", "--max-old-space-size");
-        if (token === "--max-old-space-size" || token.startsWith("--max-old-space-size="))
-            return true;
-    }
-    return false;
-}
-/** Preserve an explicit NODE_OPTIONS heap setting; otherwise apply the desktop runner's default/override. */
-export function syncRunnerNodeOptions(env) {
-    const inherited = env.NODE_OPTIONS?.trim() ?? "";
-    if (hasHeapOption(inherited))
-        return inherited || undefined;
-    const rawOverride = env[SYNC_RUNNER_HEAP_ENV]?.trim();
-    const override = rawOverride && /^\d+$/.test(rawOverride) ? Number(rawOverride) : undefined;
-    const heapMb = override && Number.isSafeInteger(override) && override > 0 ? override : DEFAULT_SYNC_RUNNER_HEAP_MB;
-    const heapFlag = `--max-old-space-size=${heapMb}`;
-    return inherited ? `${inherited} ${heapFlag}` : heapFlag;
-}
-//# sourceMappingURL=sync-runner.js.map