@indigoai-us/hq-cli 5.125.0 → 5.126.0

package/dist/command-catalog.generated.js

@@ -3089,11 +3089,11 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--email <email>",
-                        "description": "Your email (must match Cognito sign-in)"
+                        "description": "Your email (default: your HQ sign-in's email; must match it)"
                     },
                     {
                         "flags": "--person-name <name>",
-                        "description": "Your display name"
+                        "description": "Your display name (default: the name on your HQ sign-in)"
                     },
                     {
                         "flags": "--hq-root <path>",
@@ -8398,12 +8398,17 @@ export const COMMAND_CATALOG = [
                         "hidden": false,
                         "usage": "[options]",
                         "arguments": [],
-                        "options": [],
+                        "options": [
+                            {
+                                "flags": "--hq-root <path>",
+                                "description": "HQ tree root (else HQ_ROOT / persisted trusted roots); the Windows task passes this explicitly"
+                            }
+                        ],
                         "subcommands": []
                     },
                     {
                         "name": "install",
-                        "description": "Install LaunchAgent (macOS) or systemd user unit (Linux)",
+                        "description": "Install LaunchAgent (macOS), systemd user unit (Linux), or Scheduled Task (Windows)",
                         "aliases": [],
                         "hidden": false,
                         "usage": "[options]",
@@ -8413,6 +8418,10 @@ export const COMMAND_CATALOG = [
                                 "flags": "--system-user <user>",
                                 "description": "Write a root-owned unit template for agent boxes (e.g. ec2-user)"
                             },
+                            {
+                                "flags": "--hq-root <path>",
+                                "description": "HQ root to record for the service (else HQ_ROOT, else the nearest HQ root above cwd)"
+                            },
                             {
                                 "flags": "--json",
                                 "description": "Print machine-readable JSON"
@@ -8469,6 +8478,515 @@ export const COMMAND_CATALOG = [
             }
         ]
     },
+    {
+        "name": "lanes",
+        "description": "Create, supervise, and steer worker lanes; routed decision queue",
+        "aliases": [],
+        "hidden": false,
+        "usage": "[options] [command]",
+        "arguments": [],
+        "options": [],
+        "subcommands": [
+            {
+                "name": "create",
+                "description": "Register a lane, run admission, and return immediately",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--company <slug|uid>",
+                        "description": "Company slug or cloud uid"
+                    },
+                    {
+                        "flags": "--project <slug>",
+                        "description": "HQ project slug"
+                    },
+                    {
+                        "flags": "--story <id>",
+                        "description": "Story id from the project's prd.json"
+                    },
+                    {
+                        "flags": "--brief-file <path>",
+                        "description": "Path to the lane brief"
+                    },
+                    {
+                        "flags": "--worker <name>",
+                        "description": "HQ worker id from the registry"
+                    },
+                    {
+                        "flags": "--provider <name>",
+                        "description": "claude | codex | grok"
+                    },
+                    {
+                        "flags": "--account <id>",
+                        "description": "Provider account id"
+                    },
+                    {
+                        "flags": "--senior <ref>",
+                        "description": "session:<id> | lane:<id> | user"
+                    },
+                    {
+                        "flags": "--timeout <secs>",
+                        "description": "Deadline in seconds (warns, does not kill)"
+                    },
+                    {
+                        "flags": "--priority <n>",
+                        "description": "Queue priority; higher runs first"
+                    },
+                    {
+                        "flags": "--outpost <id>",
+                        "description": "Run on this Outpost instead of the local host"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "list",
+                "description": "List lanes",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--company <slug|uid>",
+                        "description": "Filter by company"
+                    },
+                    {
+                        "flags": "--project <slug>",
+                        "description": "Filter by project"
+                    },
+                    {
+                        "flags": "--story <id>",
+                        "description": "Filter by story"
+                    },
+                    {
+                        "flags": "--state <state>",
+                        "description": "Filter by state (queued|running|awaiting_input|blocked|done|failed|interrupted|cancelled|killed)"
+                    },
+                    {
+                        "flags": "--senior <ref>",
+                        "description": "Filter by senior ref"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "show",
+                "description": "Show one lane",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "message",
+                "description": "Send a follow-up message to a lane",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--text <msg>",
+                        "description": "Message text"
+                    },
+                    {
+                        "flags": "--project <slug>",
+                        "description": "Re-point project attribution from this message"
+                    },
+                    {
+                        "flags": "--story <id>",
+                        "description": "Re-point story attribution from this message"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "reparent",
+                "description": "Rewrite a lane's senior edge",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--senior <ref>",
+                        "description": "session:<id> | lane:<id> | user"
+                    },
+                    {
+                        "flags": "--reason <text>",
+                        "description": "Why the senior changed"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "logs",
+                "description": "Print a lane's local logs",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--tail <n>",
+                        "description": "Last N lines"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "stop",
+                "description": "Cancel a queued lane or kill a running one",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "ask",
+                "description": "Queue a mid-run question without blocking the lane",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--question <text>",
+                        "description": "Question text"
+                    },
+                    {
+                        "flags": "--context <text>",
+                        "description": "Context for the audience"
+                    },
+                    {
+                        "flags": "--option <text>",
+                        "description": "Answer choice (repeatable)"
+                    },
+                    {
+                        "flags": "--recommended <text>",
+                        "description": "Recommended option"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "questions",
+                "description": "Routed decision queue",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "list",
+                        "description": "List questions",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--for <ref>",
+                                "description": "Who must decide (ref | me | user)"
+                            },
+                            {
+                                "flags": "--from <lane-id>",
+                                "description": "Which lane asked"
+                            },
+                            {
+                                "flags": "--company <slug|uid>",
+                                "description": "Filter by company"
+                            },
+                            {
+                                "flags": "--project <slug>",
+                                "description": "Filter by project"
+                            },
+                            {
+                                "flags": "--story <id>",
+                                "description": "Filter by story"
+                            },
+                            {
+                                "flags": "--status <status>",
+                                "description": "Filter by status (pending|answered|cancelled|expired)"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "show",
+                        "description": "Show one question",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <question-id>",
+                        "arguments": [
+                            {
+                                "name": "question-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "answer",
+                        "description": "Answer a pending question",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <question-id>",
+                        "arguments": [
+                            {
+                                "name": "question-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--choice <label|N>",
+                                "description": "1-based index or option label"
+                            },
+                            {
+                                "flags": "--notes <text>",
+                                "description": "Free-text notes stored with the body"
+                            },
+                            {
+                                "flags": "--freeform",
+                                "description": "Allow a choice that is not on the menu"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "escalate",
+                        "description": "Advance a question one hop",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <question-id>",
+                        "arguments": [
+                            {
+                                "name": "question-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--note <text>",
+                                "description": "Note recorded with the escalation"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "cancel",
+                        "description": "Cancel a pending question",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <question-id>",
+                        "arguments": [
+                            {
+                                "name": "question-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--reason <text>",
+                                "description": "Why it was cancelled"
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
+            {
+                "name": "accounts",
+                "description": "Provider account registry (configured vs logged in)",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "list",
+                        "description": "List accounts",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--provider <name>",
+                                "description": "claude | codex | grok"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "login",
+                        "description": "Create a home, run the vendor login, and register the account",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <provider> <account-id>",
+                        "arguments": [
+                            {
+                                "name": "provider",
+                                "required": true,
+                                "variadic": false
+                            },
+                            {
+                                "name": "account-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--home <path>",
+                                "description": "Account home directory"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "enable",
+                        "description": "Enable an account without touching credentials",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <provider> <account-id>",
+                        "arguments": [
+                            {
+                                "name": "provider",
+                                "required": true,
+                                "variadic": false
+                            },
+                            {
+                                "name": "account-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "disable",
+                        "description": "Disable an account without touching credentials",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <provider> <account-id>",
+                        "arguments": [
+                            {
+                                "name": "provider",
+                                "required": true,
+                                "variadic": false
+                            },
+                            {
+                                "name": "account-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--reason <text>",
+                                "description": "Why the account is disabled"
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
+            {
+                "name": "sessions",
+                "description": "Session liveness from the work-mesh spool",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "list",
+                        "description": "List sessions",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--state <state>",
+                                "description": "live | idle | ended | lost"
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "Filter by session meta company_slug"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "show",
+                        "description": "Show one session's liveness",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <session-id>",
+                        "arguments": [
+                            {
+                                "name": "session-id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    }
+                ]
+            }
+        ]
+    },
     {
         "name": "bot",
         "description": "Personal local bots that run on this computer with your own model login",

package/dist/command-registration-plan.d.ts

@@ -400,6 +400,12 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "program";
     readonly module: "./commands/mesh.js";
     readonly exportName: "registerMeshCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "lanes";
+    readonly parent: "program";
+    readonly module: "./commands/lanes.js";
+    readonly exportName: "registerLanesCommand";
 }, {
     readonly type: "registrar";
     readonly root: "bot";

package/dist/command-registration-plan.js

@@ -69,6 +69,7 @@ export const REGISTRATION_PLAN = [
     { type: "registrar", root: "index", parent: "program", module: "./commands/index-cmd.js", exportName: "registerIndexCommand" },
     { type: "registrar", root: "doctor", parent: "program", module: "./commands/doctor.js", exportName: "registerDoctorCommand" },
     { type: "registrar", root: "mesh", parent: "program", module: "./commands/mesh.js", exportName: "registerMeshCommand" },
+    { type: "registrar", root: "lanes", parent: "program", module: "./commands/lanes.js", exportName: "registerLanesCommand" },
     { type: "registrar", root: "bot", parent: "program", module: "./commands/bot.js", exportName: "registerBotCommand" },
 ];
 async function executePlan(program, steps) {

package/dist/commands/bot.d.ts

@@ -27,6 +27,16 @@ export interface BotRow {
     lastHeartbeatOk: boolean | null;
     lastInboxPollAt: string | null;
     lastInboxPollOk: boolean | null;
+    /**
+     * The bot is mid-turn right now: it has taken a message and has not finished
+     * answering. Read from the bot's own in-flight marker on this machine, so it
+     * is true even while the model is still thinking and nothing has been posted
+     * yet. Surfaces are what show "thinking"; a progress post in the middle of a
+     * turn does not end it.
+     */
+    busy: boolean;
+    /** When the oldest turn still in flight started (ISO), else null. */
+    busySince: string | null;
     /** Present while the coding tool needs a new sign-in before the bot can work. */
     runtimeSignIn: RuntimeSignInIssue | null;
     daemonInstalled: boolean;

package/dist/commands/bot.js

@@ -1,5 +1,6 @@
 import { OwnerContextCache, lookupOwnerContext } from "../lib/bot/owner-context.js";
 import { hasActivePromotion } from "../lib/bot/promotion-receipt.js";
+import { readInflightTurns } from "../lib/bot/inflight.js";
 import { hasPromotionHold, promotionHoldSummary } from "../lib/bot/promotion-hold.js";
 /**
  * `hq bot` — personal local bots (local-bots US-003/US-004/US-005).
@@ -117,6 +118,8 @@ function rowFor(name, opts = {}) {
     const status = readBotStatus(dir);
     const pid = status?.pid ?? null;
     const processAlive = pid !== null && isPidAlive(pid) && status?.state === "running";
+    // Turns this bot has taken and not finished: what "thinking" means.
+    const inflightTurns = readInflightTurns(dir);
     let daemonInstalled = false;
     let daemonLoaded = false;
     if (opts.withDaemon !== false) {
@@ -147,6 +150,8 @@ function rowFor(name, opts = {}) {
         lastHeartbeatOk: status?.lastHeartbeatOk ?? null,
         lastInboxPollAt: status?.lastInboxPollAt ?? null,
         lastInboxPollOk: status?.lastInboxPollOk ?? null,
+        busy: processAlive && inflightTurns.length > 0,
+        busySince: processAlive ? (inflightTurns[0]?.startedAt ?? null) : null,
         runtimeSignIn: status?.runtimeSignIn ?? null,
         daemonInstalled,
         daemonLoaded,
@@ -723,6 +728,7 @@ async function runBotStatus(nameArg, opts) {
     else if (status?.lastInboxPollAt) {
         console.log(`  inbox:      last poll ${status.lastInboxPollAt}`);
     }
+    console.log(`  answering:  ${row.busy ? chalk.green(`yes${row.busySince ? `, since ${row.busySince}` : ""}`) : chalk.gray("no")}`);
     console.log(`  launchd:    ${row.daemonInstalled ? (row.daemonLoaded ? "installed, loaded" : "installed, not loaded") : "not installed"}`);
     console.log(`  creds:      ${creds ? `present for ${creds.entityUid}` : chalk.red("missing")}`);
     if (status) {