@indigoai-us/hq-cli 5.126.0 → 5.127.0

package/dist/command-catalog.generated.js

@@ -7250,7 +7250,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "story",
-                "description": "PATCH one Board story status",
+                "description": "PATCH one Board story status and/or assignee",
                 "aliases": [],
                 "hidden": false,
                 "usage": "[options]",
@@ -7264,6 +7264,10 @@ export const COMMAND_CATALOG = [
                         "flags": "--status <status>",
                         "description": "queued|in_progress|review|done"
                     },
+                    {
+                        "flags": "--assignee <uid|me|none>",
+                        "description": "Assign a person or agent uid, yourself, or clear"
+                    },
                     {
                         "flags": "--company <slug|uid>",
                         "description": "Company slug or cloud uid"
@@ -7283,6 +7287,95 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "project",
+                "description": "Set a project Board view or register its project channel",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "set",
+                        "description": "PUT the project Board view from flags or a PRD JSON file",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <projectId>",
+                        "arguments": [
+                            {
+                                "name": "projectId",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--company <slug|uid>",
+                                "description": "Company slug or cloud uid"
+                            },
+                            {
+                                "flags": "--name <name>",
+                                "description": "Project name"
+                            },
+                            {
+                                "flags": "--description <text>",
+                                "description": "Project description"
+                            },
+                            {
+                                "flags": "--stories-file <path>",
+                                "description": "PRD JSON file with userStories"
+                            },
+                            {
+                                "flags": "--stories-json <json>",
+                                "description": "Story array or JSON object with userStories"
+                            },
+                            {
+                                "flags": "--repos-json <json>",
+                                "description": "Repository array, such as [{path,branch}]"
+                            },
+                            {
+                                "flags": "--repo <path[@branch]>",
+                                "description": "Repository binding (repeatable)"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "register",
+                        "description": "POST project registration to create or bind its project channel and Board",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <projectId>",
+                        "arguments": [
+                            {
+                                "name": "projectId",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--company <slug|uid>",
+                                "description": "Company slug or cloud uid"
+                            },
+                            {
+                                "flags": "--channel <channelId>",
+                                "description": "Reserved: the current server chooses the project channel"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
             {
                 "name": "doctor",
                 "description": "Warm ~/.hq/work-mesh/cache from hq-pro (directory, inbox, pair DMs). Not `hq doctor`.",
@@ -7379,7 +7472,7 @@ export const COMMAND_CATALOG = [
                         "options": [
                             {
                                 "flags": "--dry-run",
-                                "description": "Report what would be reconciled; write nothing, no network"
+                                "description": "Report what would be reconciled; write nothing or deliver events"
                             },
                             {
                                 "flags": "--offline",
@@ -8482,7 +8575,7 @@ export const COMMAND_CATALOG = [
         "name": "lanes",
         "description": "Create, supervise, and steer worker lanes; routed decision queue",
         "aliases": [],
-        "hidden": false,
+        "hidden": true,
         "usage": "[options] [command]",
         "arguments": [],
         "options": [],
@@ -8497,7 +8590,7 @@ export const COMMAND_CATALOG = [
                 "options": [
                     {
                         "flags": "--company <slug|uid>",
-                        "description": "Company slug or cloud uid"
+                        "description": "Company slug or cloud uid; omit for a core/personal lane"
                     },
                     {
                         "flags": "--project <slug>",
@@ -8523,6 +8616,14 @@ export const COMMAND_CATALOG = [
                         "flags": "--account <id>",
                         "description": "Provider account id"
                     },
+                    {
+                        "flags": "--model <id>",
+                        "description": "Model id for the provider CLI"
+                    },
+                    {
+                        "flags": "--effort <level>",
+                        "description": "Effort level; claude: low|medium|high|xhigh|max, codex: minimal|low|medium|high|xhigh|max|ultra, grok: low|medium|high|xhigh"
+                    },
                     {
                         "flags": "--senior <ref>",
                         "description": "session:<id> | lane:<id> | user"
@@ -8538,6 +8639,10 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--outpost <id>",
                         "description": "Run on this Outpost instead of the local host"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8569,6 +8674,10 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--senior <ref>",
                         "description": "Filter by senior ref"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8586,7 +8695,12 @@ export const COMMAND_CATALOG = [
                         "variadic": false
                     }
                 ],
-                "options": [],
+                "options": [
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
                 "subcommands": []
             },
             {
@@ -8614,6 +8728,51 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--story <id>",
                         "description": "Re-point story attribution from this message"
+                    },
+                    {
+                        "flags": "--no-compact",
+                        "description": "Skip the resume-time compaction check for this message"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "resume",
+                "description": "Resume an interrupted, done or blocked lane on its recorded provider session",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <lane-id>",
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--text <msg>",
+                        "description": "Operator message for the resumed turn"
+                    },
+                    {
+                        "flags": "--project <slug>",
+                        "description": "Re-point project attribution from this resume"
+                    },
+                    {
+                        "flags": "--story <id>",
+                        "description": "Re-point story attribution from this resume"
+                    },
+                    {
+                        "flags": "--no-compact",
+                        "description": "Skip the resume-time compaction check for this resume"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8639,6 +8798,10 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--reason <text>",
                         "description": "Why the senior changed"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8660,6 +8823,10 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--tail <n>",
                         "description": "Last N lines"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8677,7 +8844,12 @@ export const COMMAND_CATALOG = [
                         "variadic": false
                     }
                 ],
-                "options": [],
+                "options": [
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
                 "subcommands": []
             },
             {
@@ -8703,6 +8875,10 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--recommended <text>",
                         "description": "Recommended option"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
                     }
                 ],
                 "subcommands": []
@@ -8747,6 +8923,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--status <status>",
                                 "description": "Filter by status (pending|answered|cancelled|expired)"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8764,7 +8944,12 @@ export const COMMAND_CATALOG = [
                                 "variadic": false
                             }
                         ],
-                        "options": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
+                            }
+                        ],
                         "subcommands": []
                     },
                     {
@@ -8790,8 +8975,12 @@ export const COMMAND_CATALOG = [
                                 "description": "Free-text notes stored with the body"
                             },
                             {
-                                "flags": "--freeform",
-                                "description": "Allow a choice that is not on the menu"
+                                "flags": "--freeform <text>",
+                                "description": "Supply a free-form answer for a question with options"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8813,6 +9002,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--note <text>",
                                 "description": "Note recorded with the escalation"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8834,6 +9027,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--reason <text>",
                                 "description": "Why it was cancelled"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8860,6 +9057,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--provider <name>",
                                 "description": "claude | codex | grok"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8886,6 +9087,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--home <path>",
                                 "description": "Account home directory"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8908,7 +9113,12 @@ export const COMMAND_CATALOG = [
                                 "variadic": false
                             }
                         ],
-                        "options": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
+                            }
+                        ],
                         "subcommands": []
                     },
                     {
@@ -8933,6 +9143,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--reason <text>",
                                 "description": "Why the account is disabled"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8963,6 +9177,10 @@ export const COMMAND_CATALOG = [
                             {
                                 "flags": "--company <slug>",
                                 "description": "Filter by session meta company_slug"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
                             }
                         ],
                         "subcommands": []
@@ -8980,7 +9198,101 @@ export const COMMAND_CATALOG = [
                                 "variadic": false
                             }
                         ],
-                        "options": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
+            {
+                "name": "pickup",
+                "description": "Ingest an Outpost-dispatched lane payload and start it on this host",
+                "aliases": [],
+                "hidden": true,
+                "usage": "[options]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--payload-file <path>",
+                        "description": "Local pickup payload JSON"
+                    },
+                    {
+                        "flags": "--payload-url <url>",
+                        "description": "HTTPS URL of a staged pickup payload"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "reconcile",
+                "description": "Run one machine-owned reconcile pass and exit",
+                "aliases": [],
+                "hidden": true,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--dry-run",
+                        "description": "Report what would change and write nothing"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "JSON on stdout (always)"
+                    }
+                ],
+                "subcommands": [
+                    {
+                        "name": "install",
+                        "description": "Write systemd user unit and timer files (idempotent)",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--systemd-root <dir>",
+                                "description": "Directory for unit files (default ~/.config/systemd/user)"
+                            },
+                            {
+                                "flags": "--enable",
+                                "description": "Enable the timer via systemctl --user"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "uninstall",
+                        "description": "Remove systemd user unit and timer files (idempotent)",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--systemd-root <dir>",
+                                "description": "Directory for unit files"
+                            },
+                            {
+                                "flags": "--disable",
+                                "description": "Disable the timer via systemctl --user"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "JSON on stdout (always)"
+                            }
+                        ],
                         "subcommands": []
                     }
                 ]

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

@@ -406,6 +406,7 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "program";
     readonly module: "./commands/lanes.js";
     readonly exportName: "registerLanesCommand";
+    readonly hidden: true;
 }, {
     readonly type: "registrar";
     readonly root: "bot";

package/dist/command-registration-plan.js

@@ -69,14 +69,15 @@ 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: "lanes", parent: "program", module: "./commands/lanes.js", exportName: "registerLanesCommand", hidden: true },
     { type: "registrar", root: "bot", parent: "program", module: "./commands/bot.js", exportName: "registerBotCommand" },
 ];
 async function executePlan(program, steps) {
     const parents = new Map([["program", program]]);
     for (const step of steps) {
         if (step.type === "group") {
-            parents.set(step.id, program.command(step.name).description(step.description));
+            const group = program.command(step.name, step.hidden ? { hidden: true } : {});
+            parents.set(step.id, group.description(step.description));
             continue;
         }
         const parent = parents.get(step.parent);
@@ -87,6 +88,14 @@ async function executePlan(program, steps) {
         if (!register)
             throw new Error(`Missing command registrar '${step.exportName}' from '${step.module}'`);
         const result = register(parent);
+        if (step.hidden) {
+            const command = result ??
+                parent.commands.find((candidate) => candidate.name() === step.root);
+            if (!command) {
+                throw new Error(`Command registrar '${step.exportName}' did not register hidden command '${step.root}'`);
+            }
+            command._hidden = true;
+        }
         if (step.result) {
             if (!result)
                 throw new Error(`Command registrar '${step.exportName}' did not return '${step.result}'`);

package/dist/commands/agents.d.ts

@@ -130,6 +130,18 @@ export interface CompanyAgentView {
     };
     [key: string]: unknown;
 }
+/**
+ * STATUS column for `hq agents list`.
+ *
+ * `agentStatus` is the agent's own stored runtime status and is NOT rewritten
+ * when a teardown starts — an agent that never finished provisioning and is
+ * now being removed keeps reading `provisioning` until the teardown completes
+ * and archives it. Observed live on liverecover/sean 2026-09-21: a removal that
+ * stalled on an object-locked vault bucket sat in the roster as `provisioning`,
+ * so the operator believed the removal had never been accepted. The roster
+ * already carries `setupPhase`, so prefer it whenever a teardown is in flight.
+ */
+export declare function rosterStatusLabel(agent: CompanyAgentView): string;
 export interface ProfilePatch {
     displayName?: string;
     title?: string;

package/dist/commands/agents.js

@@ -216,6 +216,24 @@ export class AgentsHttpError extends Error {
         this.agentCreatePlanLimit = agentCreatePlanLimit;
     }
 }
+/**
+ * STATUS column for `hq agents list`.
+ *
+ * `agentStatus` is the agent's own stored runtime status and is NOT rewritten
+ * when a teardown starts — an agent that never finished provisioning and is
+ * now being removed keeps reading `provisioning` until the teardown completes
+ * and archives it. Observed live on liverecover/sean 2026-09-21: a removal that
+ * stalled on an object-locked vault bucket sat in the roster as `provisioning`,
+ * so the operator believed the removal had never been accepted. The roster
+ * already carries `setupPhase`, so prefer it whenever a teardown is in flight.
+ */
+export function rosterStatusLabel(agent) {
+    if (agent.setupPhase === "deprovisioning")
+        return "removing";
+    if (agent.setupPhase === "deprovisioned")
+        return "removed";
+    return agent.agentStatus ?? "";
+}
 /**
  * Authenticated JSON round-trip against the agents control plane. Throws
  * `AgentsHttpError` on any non-2xx (never swallows — hq-never-swallow-errors),
@@ -466,11 +484,37 @@ function signInProviderName(url) {
         return "Claude";
     return "your provider";
 }
+/**
+ * Brain slot a device sign-in URL belongs to, or null when the provider has no
+ * per-brain slot (Claude) or the host is unknown.
+ */
+function signInBrainSlot(url) {
+    const provider = signInProviderName(url);
+    if (provider === "Grok")
+        return "grok";
+    if (provider === "Codex")
+        return "codex";
+    return null;
+}
+/**
+ * True when the box probe already reports that brain as signed in. A device
+ * pairing file can outlive the sign-in it started, so the probe — not the
+ * leftover code — decides whether a human still has work to do.
+ */
+function brainAlreadySignedIn(status, url) {
+    const slot = signInBrainSlot(url);
+    if (!slot)
+        return false;
+    const brains = recordValue(recordValue(status.agent)?.brains);
+    return brains?.[slot] === "signed-in";
+}
 function currentDeviceSignInAction(status) {
     const pairing = recordValue(status.pairing);
     const url = safeActionUrl(pairing?.url);
     if (!url)
         return null;
+    if (brainAlreadySignedIn(status, url))
+        return null;
     const rawCode = nonEmptyString(pairing?.code);
     const code = rawCode && /^[A-Z0-9]{4,8}-[A-Z0-9]{4,8}$/i.test(rawCode)
         ? rawCode
@@ -1370,7 +1414,7 @@ export function registerAgentsCommand(program) {
             }
             const nameW = Math.max(4, ...roster.map((a) => (a.name ?? "").length));
             const slugW = Math.max(4, ...roster.map((a) => (a.slug ?? "").length));
-            const statusW = Math.max(6, ...roster.map((a) => (a.agentStatus ?? "").length));
+            const statusW = Math.max(6, ...roster.map((a) => rosterStatusLabel(a).length));
             const modelW = Math.max(5, ...roster.map((a) => (a.codexModel ?? "").length));
             console.log(chalk.bold([
                 "NAME".padEnd(nameW),
@@ -1383,7 +1427,7 @@ export function registerAgentsCommand(program) {
                 console.log([
                     (a.name ?? "").padEnd(nameW),
                     (a.slug ?? "").padEnd(slugW),
-                    (a.agentStatus ?? "").padEnd(statusW),
+                    rosterStatusLabel(a).padEnd(statusW),
                     (a.codexModel ?? "").padEnd(modelW),
                     a.uid,
                 ].join("  "));