@indigoai-us/hq-cli 5.176.0 → 5.177.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## [5.177.0] — 2026-09-24
+
+### Added
+
+- `hq lanes create --hire-grant`, `hq lanes grant`, and `hq lanes backfill-grants`
+  manage alive child-lane grants. `lanes.hire-grants` defaults off; lane list and
+  show include grant and alive-child counts. Terminal child resume, message, and
+  account-move paths recheck occupancy and remaining grant allocation. The
+  backfill defaults to dry-run.
+
+- When `lanes.hire-grants` is enabled, `hq lanes list` and `hq lanes show` use counts
+  from the owning Outpost for active remote lanes. If the Outpost does not return
+  counts, both commands show local counts and a warning.
+
 ## [5.176.0] — 2026-09-24
 
 ### Fixed
@@ -32,6 +46,7 @@
 - Bot LaunchAgents and systemd units, the Work Mesh daemon unit, the `hq daemon` unit, and the lanes and agent-kit units now name node by its upgrade-stable path (`/opt/homebrew/bin/node` or `/opt/homebrew/opt/<formula>/bin/node`, or nvm's `current` link) instead of the versioned `/opt/homebrew/Cellar/node/<version>/bin/node`. Before, `brew upgrade node` deleted that path and launchd could no longer start the bots. The stable path is used only when it resolves to the same node binary; otherwise the unit keeps the resolved path as before.
 - Installed bot LaunchAgents that still name a versioned or missing node are repaired: `hq bot start` rewrites and reloads the agent, a bot started by launchd rewrites its own agent and reloads it from a detached shell before it takes any message, and `hq doctor` reports it (`bots.<name>.daemon-node`), with `hq doctor --fix` rewriting only the plist file and not reloading launchd. `hq bot list` and `hq bot status` flag a missing node binary. `hq mesh daemon install --if-stale` also reinstalls a same-version unit whose node path is missing or versioned.
 
+
 ## [5.172.0] — 2026-09-24
 
 ### Changed

package/dist/command-catalog.generated.d.ts

@@ -6886,6 +6886,9 @@ export declare const COMMAND_CATALOG: readonly [{
         }, {
             readonly flags: "--senior <ref>";
             readonly description: "session:<id> | lane:<id> | user";
+        }, {
+            readonly flags: "--hire-grant <n>";
+            readonly description: "Maximum alive direct child lanes assigned to this lane; set by its senior";
         }, {
             readonly flags: "--timeout <secs>";
             readonly description: "Deadline in seconds (warns, does not kill)";
@@ -6906,6 +6909,43 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "JSON on stdout (always)";
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "grant";
+        readonly description: "Set a lane's alive child-lane grant as its senior";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options] <lane-id>";
+        readonly arguments: readonly [{
+            readonly name: "lane-id";
+            readonly required: true;
+            readonly variadic: false;
+        }];
+        readonly options: readonly [{
+            readonly flags: "--hire <n>";
+            readonly description: "Non-negative safe integer hire grant";
+        }, {
+            readonly flags: "--json";
+            readonly description: "JSON on stdout (always)";
+        }];
+        readonly subcommands: readonly [];
+    }, {
+        readonly name: "backfill-grants";
+        readonly description: "Preview or apply missing hire grants for alive manager lanes";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options]";
+        readonly arguments: readonly [];
+        readonly options: readonly [{
+            readonly flags: "--dry-run";
+            readonly description: "Print proposed values without writing (default)";
+        }, {
+            readonly flags: "--apply";
+            readonly description: "Write missing hire grants; only run before enforcement is enabled";
+        }, {
+            readonly flags: "--json";
+            readonly description: "JSON on stdout (always)";
+        }];
+        readonly subcommands: readonly [];
     }, {
         readonly name: "list";
         readonly description: "List lanes";

package/dist/command-catalog.generated.js

@@ -8898,6 +8898,10 @@ export const COMMAND_CATALOG = [
                         "flags": "--senior <ref>",
                         "description": "session:<id> | lane:<id> | user"
                     },
+                    {
+                        "flags": "--hire-grant <n>",
+                        "description": "Maximum alive direct child lanes assigned to this lane; set by its senior"
+                    },
                     {
                         "flags": "--timeout <secs>",
                         "description": "Deadline in seconds (warns, does not kill)"
@@ -8925,6 +8929,54 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "grant",
+                "description": "Set a lane's alive child-lane grant as its senior",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--hire <n>",
+                        "description": "Non-negative safe integer hire grant"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "backfill-grants",
+                "description": "Preview or apply missing hire grants for alive manager lanes",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--dry-run",
+                        "description": "Print proposed values without writing (default)"
+                    },
+                    {
+                        "flags": "--apply",
+                        "description": "Write missing hire grants; only run before enforcement is enabled"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "list",
                 "description": "List lanes",

package/dist/commands/lanes.d.ts

@@ -9,9 +9,10 @@ import { Command } from "commander";
 import type { OutpostIdentity } from "../lib/lanes/admission-host.js";
 export { OUTPOST_DIR, OUTPOST_ID_PATH, readOutpostIdentity } from "../lib/lanes/admission-host.js";
 export type { OutpostIdentity } from "../lib/lanes/admission-host.js";
+export { LANE_HIRE_GRANTS_FLAG };
 import { type OutpostDispatchResult } from "../lib/lanes/outpost-dispatch.js";
 import { emitLaneDecisionEvents, type LaneMesh } from "../lib/lanes/mesh-events.js";
-import { MAX_LANE_DEPTH, type LaneCompanyRef, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type LivenessDeps, type MachineIdentity, type MonitorEvidenceReader, type RunCommand, type ThrottleDeps } from "../lib/lanes/index.js";
+import { LANE_HIRE_GRANTS_FLAG, MAX_LANE_DEPTH, type LaneCompanyRef, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type LivenessDeps, type MachineIdentity, type MonitorEvidenceReader, type RunCommand, type ThrottleDeps } from "../lib/lanes/index.js";
 import { questionBodyAbsPath } from "../lib/lanes/questions.js";
 import { type RunCompactionFn } from "../lib/lanes/compaction.js";
 import { type KnownModelsDeps, type ProbeCommand } from "../lib/lanes/models.js";
@@ -77,6 +78,8 @@ export interface LanesCommandDeps {
     monitorEvidence?: MonitorEvidenceReader;
     /** Test seam for the default-off outpost placement rollout flag. */
     lanePlacementEnabled?: () => boolean;
+    /** Test seam for the default-off lane hire-grants rollout gate. */
+    laneHireGrantsEnabled?: () => boolean;
 }
 export declare const LANE_OUTPOST_LOAD_BALANCING_FLAG = "lanes.outpost-load-balancing";
 export declare function parseSeniorRef(raw: string): SeniorRef;