@indigoai-us/hq-cli 5.345.191 → 5.345.193

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

@@ -3245,7 +3245,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "purge";
-        readonly description: "Permanently delete ONE retained (noncurrent) version of an exact vault key, for example a version that held data which must not live in HQ. Owner only; audited; cannot be undone. Delete the file first if the version is current. Use --personal for your personal vault.";
+        readonly description: "Schedule permanent deletion of ONE retained (noncurrent) version of an exact vault key, for example a version that held data which must not live in HQ. The version is deleted 7 days later and can be cancelled until then with --cancel. Owner only; audited. Delete the file first if the version is current. Use --personal for your personal vault.";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly helpOption: true;
@@ -3266,6 +3266,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--version-id <id>";
             readonly description: "Exact version ID to purge (see `hq files versions`)";
             readonly hidden: false;
+        }, {
+            readonly flags: "--cancel";
+            readonly description: "Cancel a scheduled purge of this version instead of scheduling one";
+            readonly hidden: false;
         }, {
             readonly flags: "-y, --yes";
             readonly description: "Skip the confirmation prompt (for scripts)";
@@ -5482,6 +5486,67 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "run";
+        readonly description: "Run the local signals engine (garden, adapters, extract, garden, upload) for companies with capture on";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: true;
+        readonly helpCommand: false;
+        readonly usage: "[options]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [];
+        readonly options: readonly [{
+            readonly flags: "--company <slug>";
+            readonly description: "Run one company (default: every company listed in the companies manifest)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--dry-run";
+            readonly description: "Print what would run; run no mutating step and write nothing";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--step <step>";
+            readonly description: "Run one step";
+            readonly hidden: false;
+            readonly choices: readonly ["garden", "extract", "adapters", "upload", "all"];
+            readonly defaultValue: "all";
+        }, {
+            readonly flags: "--trigger <trigger>";
+            readonly description: "What started the run";
+            readonly hidden: false;
+            readonly choices: readonly ["job", "chat", "manual", "brief"];
+            readonly defaultValue: "manual";
+        }, {
+            readonly flags: "--force";
+            readonly description: "Rerun a job trigger that already ran today";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--catch-up";
+            readonly description: "Mark the run as a catch-up run (also HQ_SIGNALS_CATCH_UP=1)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--max-turns <n>";
+            readonly description: "Model turn cap for the extract step (default from core/settings/signals.yaml, else 40)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--max-budget-usd <x>";
+            readonly description: "Spend cap in USD for the extract step (default from core/settings/signals.yaml, else 2.00)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--json";
+            readonly description: "Print the run record as JSON";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--report-found";
+            readonly description: "Print the owner's run reply only when the run found new signals; print nothing otherwise";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--hq-root <path>";
+            readonly description: "HQ root (default: <runtime-path>)";
+            readonly hidden: false;
+            readonly defaultValue: "<runtime-path>";
+        }];
+        readonly subcommands: readonly [];
     }];
 }, {
     readonly name: "integrations";
@@ -8277,7 +8342,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "provision";
-        readonly description: "Provision a new Outpost ($80/month — requires --yes)";
+        readonly description: "Provision a new Outpost (priced by size: small, medium, large or xlarge; requires --yes)";
         readonly aliases: readonly ["create"];
         readonly hidden: false;
         readonly helpOption: true;
@@ -8286,6 +8351,10 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly helpText: readonly [];
         readonly arguments: readonly [];
         readonly options: readonly [{
+            readonly flags: "--size <size>";
+            readonly description: "Outpost size: small | medium | large | xlarge. Without it, a terminal shows a menu with prices; the default is $100/month";
+            readonly hidden: false;
+        }, {
             readonly flags: "--runtime <runtime>";
             readonly description: "Agent runtime: claude | codex (default claude). Personal boxes only.";
             readonly hidden: false;
@@ -8307,7 +8376,7 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--yes";
-            readonly description: "Confirm the monthly charge (required to provision or create)";
+            readonly description: "Confirm the monthly charge for the chosen size (required to provision or create)";
             readonly hidden: false;
         }, {
             readonly flags: "--json";
@@ -18637,6 +18706,18 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly arguments: readonly [];
             readonly options: readonly [];
             readonly subcommands: readonly [];
+        }, {
+            readonly name: "fleet-bots-update";
+            readonly description: "Move each installed HQ Fleet bot to the current runtime release while it is idle, and restart it";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly helpOption: true;
+            readonly helpCommand: false;
+            readonly usage: "[options]";
+            readonly helpText: readonly [];
+            readonly arguments: readonly [];
+            readonly options: readonly [];
+            readonly subcommands: readonly [];
         }, {
             readonly name: "sync-core-reconcile";
             readonly description: "Read each company's new-sync-engine switch and write this machine's engine homes and legacy off-switches";
@@ -19015,31 +19096,27 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly defaultValue: readonly [];
         }, {
             readonly flags: "--runtime <runtime>";
-            readonly description: "Model CLI to run the bot with: claude|codex|grok";
+            readonly description: "Model provider the bot answers with: claude|codex|grok (same as --provider; default claude)";
             readonly hidden: false;
         }, {
             readonly flags: "--provider <provider>";
-            readonly description: "HQ Fleet provider: claude|codex|grok (interactive Fleet creation prompts when omitted)";
+            readonly description: "HQ Fleet provider: claude|codex|grok (default claude)";
             readonly hidden: false;
         }, {
             readonly flags: "--hq-fleet-runtime";
-            readonly description: "Create this personal bot with the local HQ Fleet Runtime";
+            readonly description: "Accepted for compatibility; every new bot runs on the HQ Fleet Runtime";
             readonly hidden: false;
         }, {
             readonly flags: "--legacy-runtime";
-            readonly description: "Run this bot with the model CLI even where the HQ Fleet Runtime is the default";
+            readonly description: "No longer supported; new bots always run on the HQ Fleet Runtime";
             readonly hidden: false;
         }, {
             readonly flags: "--model <model>";
-            readonly description: "Model override passed to the runtime CLI";
+            readonly description: "Model the bot answers with";
             readonly hidden: false;
         }, {
-            readonly flags: "--effort <level>";
-            readonly description: "Thinking level: claude low|medium|high|xhigh|max; codex minimal|low|medium|high|xhigh; grok low|medium|high|xhigh (default medium)";
-            readonly hidden: false;
-        }, {
-            readonly flags: "--no-auto-approve";
-            readonly description: "Keep the runtime's permission gates (default: everything pre-approved; a headless bot cannot answer prompts)";
+            readonly flags: "--auto-approve";
+            readonly description: "Turn the runtime's command approval prompts off for every sender (default: prompts stay on; the owner's own turns are always allowed)";
             readonly hidden: false;
         }, {
             readonly flags: "--worker <workerId>";
@@ -19062,13 +19139,9 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Where the bot keeps its memory: synced (personal/workers/<name>/memory in HQ) or local (~/.hq/bots/<name>/memory, this computer only)";
             readonly hidden: false;
             readonly defaultValue: "synced";
-        }, {
-            readonly flags: "--lean";
-            readonly description: "Claude bots: run each turn without this computer's plugins, MCP servers and HQ's session hooks (HQ's tool hooks still run), so replies take seconds";
-            readonly hidden: false;
         }, {
             readonly flags: "--no-daemon";
-            readonly description: "Do not install the launchd agent (macOS)";
+            readonly description: "Accepted for compatibility; HQ Fleet bots run under their own background service";
             readonly hidden: false;
         }, {
             readonly flags: "--no-start";
@@ -20430,6 +20503,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "-y, --yes";
             readonly description: "Skip the typed-email confirmation prompt (still sends confirmEmail).";
             readonly hidden: false;
+        }, {
+            readonly flags: "--handoff-shared-companies";
+            readonly description: "Keep a company with real members and hand it to one, instead of refusing the reset.";
+            readonly hidden: false;
         }];
         readonly subcommands: readonly [];
     }, {

package/dist/command-catalog.generated.js

@@ -3914,7 +3914,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "purge",
-                "description": "Permanently delete ONE retained (noncurrent) version of an exact vault key, for example a version that held data which must not live in HQ. Owner only; audited; cannot be undone. Delete the file first if the version is current. Use --personal for your personal vault.",
+                "description": "Schedule permanent deletion of ONE retained (noncurrent) version of an exact vault key, for example a version that held data which must not live in HQ. The version is deleted 7 days later and can be cancelled until then with --cancel. Owner only; audited. Delete the file first if the version is current. Use --personal for your personal vault.",
                 "aliases": [],
                 "hidden": false,
                 "helpOption": true,
@@ -3940,6 +3940,11 @@ export const COMMAND_CATALOG = [
                         "description": "Exact version ID to purge (see `hq files versions`)",
                         "hidden": false
                     },
+                    {
+                        "flags": "--cancel",
+                        "description": "Cancel a scheduled purge of this version instead of scheduling one",
+                        "hidden": false
+                    },
                     {
                         "flags": "-y, --yes",
                         "description": "Skip the confirmation prompt (for scripts)",
@@ -6646,6 +6651,91 @@ export const COMMAND_CATALOG = [
                     }
                 ],
                 "subcommands": []
+            },
+            {
+                "name": "run",
+                "description": "Run the local signals engine (garden, adapters, extract, garden, upload) for companies with capture on",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options]",
+                "helpText": [],
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--company <slug>",
+                        "description": "Run one company (default: every company listed in the companies manifest)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--dry-run",
+                        "description": "Print what would run; run no mutating step and write nothing",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--step <step>",
+                        "description": "Run one step",
+                        "hidden": false,
+                        "choices": [
+                            "garden",
+                            "extract",
+                            "adapters",
+                            "upload",
+                            "all"
+                        ],
+                        "defaultValue": "all"
+                    },
+                    {
+                        "flags": "--trigger <trigger>",
+                        "description": "What started the run",
+                        "hidden": false,
+                        "choices": [
+                            "job",
+                            "chat",
+                            "manual",
+                            "brief"
+                        ],
+                        "defaultValue": "manual"
+                    },
+                    {
+                        "flags": "--force",
+                        "description": "Rerun a job trigger that already ran today",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--catch-up",
+                        "description": "Mark the run as a catch-up run (also HQ_SIGNALS_CATCH_UP=1)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--max-turns <n>",
+                        "description": "Model turn cap for the extract step (default from core/settings/signals.yaml, else 40)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--max-budget-usd <x>",
+                        "description": "Spend cap in USD for the extract step (default from core/settings/signals.yaml, else 2.00)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print the run record as JSON",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--report-found",
+                        "description": "Print the owner's run reply only when the run found new signals; print nothing otherwise",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--hq-root <path>",
+                        "description": "HQ root (default: <runtime-path>)",
+                        "hidden": false,
+                        "defaultValue": "<runtime-path>"
+                    }
+                ],
+                "subcommands": []
             }
         ]
     },
@@ -10092,7 +10182,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "provision",
-                "description": "Provision a new Outpost ($80/month — requires --yes)",
+                "description": "Provision a new Outpost (priced by size: small, medium, large or xlarge; requires --yes)",
                 "aliases": [
                     "create"
                 ],
@@ -10103,6 +10193,11 @@ export const COMMAND_CATALOG = [
                 "helpText": [],
                 "arguments": [],
                 "options": [
+                    {
+                        "flags": "--size <size>",
+                        "description": "Outpost size: small | medium | large | xlarge. Without it, a terminal shows a menu with prices; the default is $100/month",
+                        "hidden": false
+                    },
                     {
                         "flags": "--runtime <runtime>",
                         "description": "Agent runtime: claude | codex (default claude). Personal boxes only.",
@@ -10130,7 +10225,7 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--yes",
-                        "description": "Confirm the monthly charge (required to provision or create)",
+                        "description": "Confirm the monthly charge for the chosen size (required to provision or create)",
                         "hidden": false
                     },
                     {
@@ -22712,6 +22807,19 @@ export const COMMAND_CATALOG = [
                         "options": [],
                         "subcommands": []
                     },
+                    {
+                        "name": "fleet-bots-update",
+                        "description": "Move each installed HQ Fleet bot to the current runtime release while it is idle, and restart it",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options]",
+                        "helpText": [],
+                        "arguments": [],
+                        "options": [],
+                        "subcommands": []
+                    },
                     {
                         "name": "sync-core-reconcile",
                         "description": "Read each company's new-sync-engine switch and write this machine's engine homes and legacy off-switches",
@@ -23171,37 +23279,32 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--runtime <runtime>",
-                        "description": "Model CLI to run the bot with: claude|codex|grok",
+                        "description": "Model provider the bot answers with: claude|codex|grok (same as --provider; default claude)",
                         "hidden": false
                     },
                     {
                         "flags": "--provider <provider>",
-                        "description": "HQ Fleet provider: claude|codex|grok (interactive Fleet creation prompts when omitted)",
+                        "description": "HQ Fleet provider: claude|codex|grok (default claude)",
                         "hidden": false
                     },
                     {
                         "flags": "--hq-fleet-runtime",
-                        "description": "Create this personal bot with the local HQ Fleet Runtime",
+                        "description": "Accepted for compatibility; every new bot runs on the HQ Fleet Runtime",
                         "hidden": false
                     },
                     {
                         "flags": "--legacy-runtime",
-                        "description": "Run this bot with the model CLI even where the HQ Fleet Runtime is the default",
+                        "description": "No longer supported; new bots always run on the HQ Fleet Runtime",
                         "hidden": false
                     },
                     {
                         "flags": "--model <model>",
-                        "description": "Model override passed to the runtime CLI",
+                        "description": "Model the bot answers with",
                         "hidden": false
                     },
                     {
-                        "flags": "--effort <level>",
-                        "description": "Thinking level: claude low|medium|high|xhigh|max; codex minimal|low|medium|high|xhigh; grok low|medium|high|xhigh (default medium)",
-                        "hidden": false
-                    },
-                    {
-                        "flags": "--no-auto-approve",
-                        "description": "Keep the runtime's permission gates (default: everything pre-approved; a headless bot cannot answer prompts)",
+                        "flags": "--auto-approve",
+                        "description": "Turn the runtime's command approval prompts off for every sender (default: prompts stay on; the owner's own turns are always allowed)",
                         "hidden": false
                     },
                     {
@@ -23230,14 +23333,9 @@ export const COMMAND_CATALOG = [
                         "hidden": false,
                         "defaultValue": "synced"
                     },
-                    {
-                        "flags": "--lean",
-                        "description": "Claude bots: run each turn without this computer's plugins, MCP servers and HQ's session hooks (HQ's tool hooks still run), so replies take seconds",
-                        "hidden": false
-                    },
                     {
                         "flags": "--no-daemon",
-                        "description": "Do not install the launchd agent (macOS)",
+                        "description": "Accepted for compatibility; HQ Fleet bots run under their own background service",
                         "hidden": false
                     },
                     {
@@ -24913,6 +25011,11 @@ export const COMMAND_CATALOG = [
                         "flags": "-y, --yes",
                         "description": "Skip the typed-email confirmation prompt (still sends confirmEmail).",
                         "hidden": false
+                    },
+                    {
+                        "flags": "--handoff-shared-companies",
+                        "description": "Keep a company with real members and hand it to one, instead of refusing the reset.",
+                        "hidden": false
                     }
                 ],
                 "subcommands": []

package/dist/commands/bot-jobs.d.ts

@@ -10,13 +10,16 @@
  * The schedule lives with the bot: its jobs sit in the bot's own folder
  * (lib/bot/local-jobs.ts) and the bot's inbox loop fires them while it runs
  * (see lib/bot/job-run.ts). Nothing here writes a crontab, a launchd plist, or
- * a systemd unit — by rule. Schedules are still written in the EventBridge form
- * and held to the same limits, so a job reads the same wherever it runs.
+ * a systemd unit — by rule. A schedule is stored as a six-field
+ * `cron(m h dom mon dow year)` string (Sunday = 1, `?` in one day field), the
+ * same string format hosted agent jobs use, and lib/bot/local-jobs.ts reads it
+ * back when it checks what is due.
  */
 import type { Command } from "commander";
 import { type LocalJobsApi } from "../lib/bot/local-jobs.js";
 import { type BotJobRecord, type CreateJobInput } from "../lib/bot/api.js";
 import { type BotConfig, type BotKind } from "../lib/bot/config.js";
+import { type FleetCronJob, type FleetCronOps } from "../lib/bot/fleet-cron.js";
 /** Mirrors hq-pro-agents `MIN_RECURRING_INTERVAL_SECONDS`. */
 export declare const MIN_RECURRING_INTERVAL_SECONDS: number;
 /** Mirrors hq-pro-agents `DEFAULT_MAX_ACTIVE_JOBS_PER_AGENT`. */
@@ -29,9 +32,11 @@ export declare class BotJobsError extends Error {
 /** The machine's own IANA zone, so "9am" means 9am where the owner lives. */
 export declare function machineTimezone(): string;
 /**
- * Standard 5-field cron → the EventBridge form the cloud stores.
+ * Standard 5-field cron → the six-field `cron(...)` string a job is stored as.
  *
- * EventBridge cron has SIX fields (a trailing year), numbers its days of week
+ * The stored form (the six-field cron syntax hosted agent jobs also use, so
+ * local and hosted jobs share one format; the function keeps its historical
+ * name) has SIX fields (a trailing year), numbers its days of week
  * 1–7 with SUNDAY = 1 (standard cron uses 0–6 with SUNDAY = 0), and refuses
  * `*` in BOTH the day-of-month and day-of-week fields — exactly one must be
  * `?`. An expression that is already `cron(...)` or `rate(...)` is passed
@@ -45,7 +50,7 @@ export declare function toEventBridgeCron(expr: string): string;
  * the server's own reason instead of a round-trip and a raw 400.
  */
 export declare function recurringIntervalSeconds(expr: string): number | null;
-/** Refuse a schedule the cloud would refuse, with the cloud's own reason. */
+/** Refuse a schedule that fires more often than the recurring floor (the same floor hosted agent jobs use). */
 export declare function assertScheduleWithinFloor(expr: string): void;
 export interface ParsedSchedule {
     /** Standard 5-field cron, as the HQ helper emits it. */
@@ -58,7 +63,7 @@ export interface ParsedSchedule {
 export declare function parseScheduleText(text: string, opts: {
     timezone: string;
 }): ParsedSchedule;
-/** The create body the cloud expects, with the client-side limits enforced first. */
+/** The create body for a new job, with the schedule limits enforced first. */
 export declare function buildCreateJobBody(input: {
     prompt: string;
     cron: string;
@@ -66,27 +71,24 @@ export declare function buildCreateJobBody(input: {
     context?: Record<string, unknown>;
     quiet?: boolean;
 }): CreateJobInput;
+export declare function fromEventBridgeCron(expr: string): string;
+export declare function fleetJobRecord(job: FleetCronJob, timezone: string): BotJobRecord;
+export declare function fleetJobsClient(config: Pick<BotConfig, "ownerUid" | "hqRoot">, ops: FleetCronOps, timezone: string): Required<LocalJobsApi>;
 /** A schedule in plain words, falling back to the raw expression. */
 export declare function describeSchedule(job: BotJobRecord): string;
 /** A small humaniser for the shapes `--every` actually produces. */
 export declare function cronInWords(expr: string): string | null;
+export declare function utcMinute(iso: string): string;
 /** "never run yet" / "succeeded 2026-09-15 09:00 UTC". */
 export declare function describeLastRun(job: BotJobRecord): string;
 export declare function formatJobsList(botName: string, jobs: BotJobRecord[], showQuietOption?: boolean): string;
 /**
- * Turn a jobs-route failure into one plain line.
+ * Turn a jobs failure into one plain line.
  *
- * Personal bots are refused by the cloud today: their JWT carries the owner's
- * `per_…` company claim and the jobs routes require a `cmp_…`, so the fail-closed
- * guard answers 403 `CROSS_AGENT_JOB` (hq-pro-agents jobs/errors.ts
- * `CrossAgentJobError`). That server fix is a separate change; until it lands the
- * refusal must read as "not available yet for this kind of bot", not as a raw 403.
- * Once the server accepts personal bots the refusal simply stops happening — no
- * client change needed.
- *
- * ONLY that exact code is rewritten. Every other 403, and every 404, keeps its
- * real message: masking them would hide a genuinely missing job or a different
- * permission problem behind copy about the wrong thing.
+ * `hq bot jobs` answers from the bot's own jobs.json (localJobsClient), for
+ * personal and company bots alike, so there is no cloud refusal to explain
+ * here. Only the local client's own errors (quota, unknown job, validation)
+ * get rewritten; anything else keeps its real message.
  */
 export declare function jobsErrorMessage(err: unknown, ctx: {
     botName: string;
@@ -106,6 +108,7 @@ export interface BotJobsDeps {
     out?: (line: string) => void;
     /** Test seam for the default-off quiet-job rollout gate. */
     quietOptionEnabled?: () => boolean | Promise<boolean>;
+    fleetCron?: (agentUid: string) => FleetCronOps;
 }
 export interface BotJobsOptions {
     add?: string;