@indigoai-us/hq-cli 5.344.0 → 5.344.1

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+## [5.344.1] — 2026-10-05
+- Release the MCP server's package lease after its resident modules preload and record a bounded command purpose on CLI package leases.
+
 ## [5.344.0] — 2026-10-04
 - Include a bounded reason in sync-failure client-health reports.
 - Add an explicit opt-in to count usage from HQ sessions with no company toward the default company: `hq mesh context default set` asks in a terminal (default No), takes `--count-usage` / `--no-count-usage`, and writes `usageAttribution` (company and signed-in person) to the work-context config. Changing or clearing the default, logging out, or signing in as another account withdraws it; `get` shows it; an automatic default never opts in.

package/dist/commands/mcp-serve.js

@@ -73,11 +73,12 @@ export async function runMcpServe(opts = {}) {
             process.emitWarning("hq-cli resident package preload completion failed (class=Error, module=unknown)");
         });
     };
+    // Release before the stdio read can remain open indefinitely. The request
+    // handlers and their declared lazy modules are loaded before this point.
+    startResidentPreload();
     const send = (msg) => {
         const response = `${JSON.stringify({ jsonrpc: "2.0", ...msg })}\n`;
-        if (residentPreloadStarted)
-            return output.write(response);
-        return output.write(response, startResidentPreload);
+        return output.write(response);
     };
     const reply = (id, result) => send({ id, result });
     const replyError = (id, code, message) => send({ id, error: { code, message } });

package/dist/utils/package-use-lease.d.ts

@@ -1,4 +1,6 @@
 export declare const PACKAGE_USE_LEASE_HANDOFF_ENV = "HQ_CLI_PACKAGE_USE_LEASE_HANDOFF";
+export declare const PACKAGE_USE_LEASE_PURPOSES: readonly ["command", "resident-preload", "mcp-serve", "hook", "daemon"];
+export type PackageUseLeasePurpose = (typeof PACKAGE_USE_LEASE_PURPOSES)[number];
 export declare class PackageUseUpdatePendingError extends Error {
     constructor(message: string);
 }
@@ -10,7 +12,10 @@ export interface PackageUseLeaseRecord {
     pid: number;
     start_time_ms: number;
     hq_version: string;
+    purpose?: PackageUseLeasePurpose;
 }
+/** Map only fixed command words to a bounded lease purpose; never persist argv values. */
+export declare function packageUseLeasePurposeForArgv(argv: readonly string[]): PackageUseLeasePurpose;
 export interface PackageUseLeaseHandoff {
     readonly envValue: string;
     waitForChild(pid: number, childAlive: () => boolean): Promise<boolean>;
@@ -20,7 +25,7 @@ export declare function npmPrefix(root: string, platform?: NodeJS.Platform): str
 export declare function packageUseLeaseDirectory(prefix: string, stateDirectory?: string): string;
 export declare function packageUseUpdateRequestPath(prefix: string, stateDirectory?: string): string;
 declare function waitForUpdateRequest(requestPath: string, timeoutMs: number): void;
-export declare function acquirePackageUseLease(prefix: string, hqVersion: string, stateDirectory?: string): PackageUseLease;
+export declare function acquirePackageUseLease(prefix: string, hqVersion: string, stateDirectory?: string, purpose?: PackageUseLeasePurpose): PackageUseLease;
 /**
  * Create a bounded, per-reexec rendezvous in the current lease directory.
  * The child confirms readiness only after publishing its own atomic lease.
@@ -29,7 +34,7 @@ export declare function createPackageUseLeaseHandoff(lease: PackageUseLease, tim
 export declare function createCurrentPackageUseLeaseHandoff(timeoutMs?: number): PackageUseLeaseHandoff | null;
 /** Publish this process's lease identity to a parent waiting in the same prefix. */
 export declare function publishPackageUseLeaseHandoff(lease: PackageUseLease, env?: NodeJS.ProcessEnv): boolean;
-export declare function acquireCurrentPackageUseLease(): PackageUseLease | null;
+export declare function acquireCurrentPackageUseLease(argv?: readonly string[]): PackageUseLease | null;
 /** Release this process's package-use lease after a long-running command has loaded its package modules. */
 export declare function releaseCurrentPackageUseLease(): void;
 /** The lease remains held through command execution and is released on process exit. */

package/dist/utils/package-use-lease.js

@@ -8,12 +8,47 @@ const CLI_NAME = "@indigoai-us/hq-cli";
 const UPDATE_REQUEST = "update.pending.json";
 export const PACKAGE_USE_LEASE_HANDOFF_ENV = "HQ_CLI_PACKAGE_USE_LEASE_HANDOFF";
 const HANDOFF_TIMEOUT_MS = 2_000;
+export const PACKAGE_USE_LEASE_PURPOSES = [
+    "command",
+    "resident-preload",
+    "mcp-serve",
+    "hook",
+    "daemon",
+];
 export class PackageUseUpdatePendingError extends Error {
     constructor(message) {
         super(message);
         this.name = "PackageUseUpdatePendingError";
     }
 }
+/** Map only fixed command words to a bounded lease purpose; never persist argv values. */
+export function packageUseLeasePurposeForArgv(argv) {
+    const args = argv.slice(2);
+    if (args[0] === "mcp" && args[1] === "serve")
+        return "mcp-serve";
+    if ((args[0] === "daemon" && args[1] === "run") ||
+        (args[0] === "mesh" && args[1] === "daemon" && args[2] === "run"))
+        return "daemon";
+    if (args[0] === "core" && ["hq-session", "checkpoint-stop-gate"].includes(args[1] ?? "")) {
+        return "hook";
+    }
+    const hasOption = (...options) => options.some((option) => args.includes(option));
+    if (args[0] === "login" ||
+        (args[0] === "auth" && args[1] === "login") ||
+        (args[0] === "agents" && ["kit", "mcp"].includes(args[1] ?? "")) ||
+        (args[0] === "agents" && ["terminal", "message"].includes(args[1] ?? "") &&
+            (args[1] === "terminal" || hasOption("--wait"))) ||
+        (args[0] === "bot" && (args[1] === "run" || (args[1] === "logs" && hasOption("--follow", "-f")))) ||
+        (args[0] === "daemon" && args[1] === "logs" && hasOption("--follow", "-f")) ||
+        (args[0] === "integrations" && args[1] === "connect") ||
+        (args[0] === "lanes" && ["watch", "message", "resume"].includes(args[1] ?? "")) ||
+        (args[0] === "monitor" && ["wait", "_run"].includes(args[1] ?? "")) ||
+        (args[0] === "pack" && args[1] === "install") ||
+        (args[0] === "pkg" && args[1] === "update") ||
+        (args[0] === "secrets" && args[1] === "sandbox"))
+        return "resident-preload";
+    return "command";
+}
 let currentPackageUseLease = null;
 function errorLabel(error) {
     if (error && typeof error === "object") {
@@ -131,7 +166,7 @@ function waitForUpdateRequest(requestPath, timeoutMs) {
         Atomics.wait(sleeper, 0, 0, 100);
     }
 }
-export function acquirePackageUseLease(prefix, hqVersion, stateDirectory) {
+export function acquirePackageUseLease(prefix, hqVersion, stateDirectory, purpose = "command") {
     const directory = packageUseLeaseDirectory(prefix, stateDirectory);
     mkdirSync(directory, { recursive: true, mode: 0o700 });
     const requestPath = path.join(directory, UPDATE_REQUEST);
@@ -139,6 +174,7 @@ export function acquirePackageUseLease(prefix, hqVersion, stateDirectory) {
         pid: process.pid,
         start_time_ms: Math.floor(performance.timeOrigin),
         hq_version: hqVersion,
+        purpose,
     };
     const leasePath = path.join(directory, `${record.pid}-${record.start_time_ms}.json`);
     const tempPath = `${leasePath}.${Math.random().toString(36).slice(2)}.tmp`;
@@ -272,7 +308,7 @@ function exists(file) {
         throw error;
     }
 }
-export function acquireCurrentPackageUseLease() {
+export function acquireCurrentPackageUseLease(argv = process.argv) {
     const pkg = findCliPackage(path.dirname(fileURLToPath(import.meta.url)));
     if (!pkg || isPnpmGlobal(pkg.root) || isBunGlobal(pkg.root))
         return null;
@@ -285,7 +321,7 @@ export function acquireCurrentPackageUseLease() {
         if (nodeModules > 0 && parts[nodeModules - 1] !== "lib")
             return null;
     }
-    const lease = acquirePackageUseLease(prefix, pkg.version);
+    const lease = acquirePackageUseLease(prefix, pkg.version, undefined, packageUseLeasePurposeForArgv(argv));
     currentPackageUseLease = lease;
     publishPackageUseLeaseHandoff(lease);
     return lease;

package/package.json

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