@indigoai-us/hq-cli 5.345.198 → 5.345.199

package/CHANGELOG.md

@@ -2,6 +2,51 @@
 
 ## [Unreleased]
 
+## [5.345.199] — 2026-11-04
+- `hq bot status <name>` shows the bot's last reported failure: when, the
+  failure class, the plain-language cause and fix the owner was sent, the HQ
+  report id, and whether the report was uploaded and the owner DM sent. The
+  JSON output carries it as `status.lastFailure`. HQ Fleet Runtime bots write
+  it when a turn ends in the canned away line.
+- `hq doctor` checks that a Claude bot on the HQ Fleet Runtime can read a
+  Claude Code login the way the runtime reads it (ANTHROPIC_TOKEN,
+  CLAUDE_CODE_OAUTH_TOKEN, ANTHROPIC_API_KEY, the HQ Fleet login file,
+  ~/.claude/.credentials.json, then the macOS Keychain item "Claude
+  Code-credentials") and fails with the sources it checked and the fix
+  (`claude /login`, then `hq bot restart <name>`). It also fails on a bot's
+  last reported failure until a later turn works.
+- `hq bot create` with the Claude provider refuses, before creating any
+  identity, when no Claude Code login is readable on this computer, naming
+  the sources it checked and the fix.
+- The HQ Fleet profile's bootstrap marker records the hq-cli version that
+  installed it, so a bot's failure reports name it.
+- `hq bot create` and `hq bot update` now install HQ Fleet Local 0.4.24 on hq-fleet-runtime d257fdd1, the release that uploads failure reports and DMs the owner.
+- Local CLI bots can run jobs when an event arrives with `hq bot jobs --on` and payload filters. Add `hq bot events emit` and `tail`, durable event queues with journal rotation, and a registry for built-in event handlers that run without a model turn.
+- Lane envelopes can include a structured outcome with gathered facts and next steps. Process and subagent lanes retain it, and `hq lanes status <lane-id> --json` exposes it.
+- The Executive can ride an attended meeting in-process, extract signals every 20 seconds, resume after a bot restart, and emit one meeting-ended event after three terminal polls. The rider respects the desktop opt-out setting.
+- The Executive detects attended live meetings every minute while the desktop is closed, using the same meeting rider setting. Bot status now shows the Executive selection, rider preference, and latest detection source and time.
+- Create an Executive lane directly from an action-item signal with `hq lanes create --company <slug> --signal <id>`. Repeating the command returns the existing lane. Generated briefs include your standing rules, and workers report through your conductor's link.
+- Browser sign-in now refuses a callback port that is not registered with
+  Cognito (8765, 3000, 53682). A stray `HQ_COGNITO_CALLBACK_PORT` such as
+  57726 opened a sign-in tab that failed with `redirect_mismatch`; the CLI now
+  uses 8765 instead and prints a warning on stderr.
+- Background `hq` processes no longer open a browser sign-in tab on their own.
+  When a token refresh failed, any caller (daemon, lane, bot, monitor,
+  `hq mcp serve`, the sync runner, or a launchd task) fell back to a browser
+  sign-in that nobody had started. The implicit sign-in now runs only when
+  stdin and stdout are terminals and none of those markers is present; other
+  callers get an error that says to run `hq login`. `hq login` is unchanged.
+- The plan-limit warning now says which account it is about ("your personal
+  account" or "the <slug> company"), shows storage in GB instead of raw bytes,
+  and no longer claims that new files and new secrets are paused. After
+  `hq dm --attach` it used to print "storage 47012700666 of 10737418240. New
+  files and new secrets are paused." right after the uploads had succeeded.
+- `hq mesh session status` and `hq mesh daemon doctor` no longer crash when a local work-mesh queue file (usually `dead-letter.jsonl`) is larger than 512 MB. Queue counts are now read line by line.
+- The Morning signals job now carries prior signals from the same source into extraction, refreshes longer final-pass bodies in place, and reports new, updated and skipped counts. Live meeting signal IDs and index rows remain stable through the final pass.
+- `hq signals run --company <slug> --source meeting:<id> --incremental` extracts signals while a meeting transcript grows. Landed documents use `<channel>:<file>`. Each source keeps a cursor and prior signal IDs, so unchanged content costs no model turn. Incremental runs default to 12 turns and $0.40, preserve meeting signal references across transcript revisions, and retain signal events for retry.
+- The personal Executive now opens conductor lanes from newly written action-item signals, with one event job per served company and deferred retries when no conductor is linked.
+- `hq lanes report --company <slug> --source <ref>` reports source-linked lane outcomes, pending decisions, progress, and remaining work in text or JSON. Owner wording can be customized in `personal/settings/executive/report.md`.
+
 ## [5.345.198] — 2026-11-04
 - A personal bot that locked itself to its HQ's only company no longer resumes old conversations under that lock after the HQ gains a second company, loses its only company, or switches to a different one. On restart it archives those conversations and starts fresh, as it already did when a bot's company settings changed. A company bot whose bot.json lists "personal" as well as its company now starts normally after this upgrade, including with unfinished work, instead of stopping with "could not isolate previous company conversations". A personal bot no longer treats an extra top-level manifest key such as `version:` or `deployments:` as a company, and it reads a manifest saved with a UTF-8 byte order mark.
 - A local bot no longer asks "Which company is this for?" in every channel when its HQ has only one company. A personal bot (including one created before bot kinds existed) with no company in bot.json now locks its sessions to the HQ's only company, scheduled jobs included. A bot with two or more real companies stays unbound and does not guess. A "personal" entry in a company bot's membership list no longer counts as a second company.

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

@@ -5545,6 +5545,14 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--company <slug>";
             readonly description: "Run one company (default: every company listed in the companies manifest)";
             readonly hidden: false;
+        }, {
+            readonly flags: "--source <ref>";
+            readonly description: "Read a growing source: meeting:<id> or <channel>:<file> (needs --incremental and --company)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--incremental";
+            readonly description: "Extract only new signals from --source, retaining a cursor and prior signal ids";
+            readonly hidden: false;
         }, {
             readonly flags: "--dry-run";
             readonly description: "Print what would run; run no mutating step and write nothing";
@@ -15390,6 +15398,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--company <slug>";
             readonly description: "Select the company by slug";
             readonly hidden: false;
+        }, {
+            readonly flags: "--source <ref>";
+            readonly description: "Report lanes for a source (requires --company; excludes --since)";
+            readonly hidden: false;
         }, {
             readonly flags: "--since <iso>";
             readonly description: "Report activity from this ISO timestamp";
@@ -15859,7 +15871,23 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--project <slug>";
-            readonly description: "HQ project slug";
+            readonly description: "HQ project slug (executive-bot for --signal)";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--signal <id>";
+            readonly description: "Create one lane for a company signal";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--rules-file <path>";
+            readonly description: "Standing rules for a signal lane";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--any-type";
+            readonly description: "Allow signal types other than action_item";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--link <id>";
+            readonly description: "Conductor link for a signal lane";
             readonly hidden: false;
         }, {
             readonly flags: "--story <id>";
@@ -15879,7 +15907,7 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--brief-file <path>";
-            readonly description: "Path to the lane brief";
+            readonly description: "Path to the lane brief (generated for --signal)";
             readonly hidden: false;
         }, {
             readonly flags: "--worker <name>";
@@ -16435,17 +16463,22 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "status";
-        readonly description: "Summarize project stories, lanes, PRs, blockers, and pending questions";
+        readonly description: "Summarize project stories, lanes, PRs, blockers, and pending questions; with a lane id, report that lane's outcome";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly helpOption: true;
         readonly helpCommand: false;
-        readonly usage: "[options]";
+        readonly usage: "[options] [lane-id]";
         readonly helpText: readonly [];
-        readonly arguments: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "lane-id";
+            readonly required: false;
+            readonly variadic: false;
+            readonly description: "Report one lane's state and outcome block instead of a project";
+        }];
         readonly options: readonly [{
             readonly flags: "--project <slug>";
-            readonly description: "HQ project slug";
+            readonly description: "HQ project slug (required without a lane id)";
             readonly hidden: false;
         }, {
             readonly flags: "--company <slug|uid>";
@@ -19072,6 +19105,15 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--cron <expr>";
             readonly description: "How often, as a cron expression (e.g. \"0 9 * * 1-5\")";
             readonly hidden: false;
+        }, {
+            readonly flags: "--on <event>";
+            readonly description: "Run when this event is emitted";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--filter <key=value>";
+            readonly description: "Match an event payload field (repeatable)";
+            readonly hidden: false;
+            readonly defaultValue: readonly [];
         }, {
             readonly flags: "--tz <zone>";
             readonly description: "IANA timezone for the schedule (default: this computer's)";
@@ -19094,6 +19136,64 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "events";
+        readonly description: "Emit and inspect local bot events";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: true;
+        readonly helpCommand: true;
+        readonly usage: "[options] [command]";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [];
+        readonly options: readonly [];
+        readonly subcommands: readonly [{
+            readonly name: "emit";
+            readonly description: "";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly helpOption: true;
+            readonly helpCommand: false;
+            readonly usage: "[options] <event>";
+            readonly helpText: readonly [];
+            readonly arguments: readonly [{
+                readonly name: "event";
+                readonly required: true;
+                readonly variadic: false;
+                readonly description: "";
+            }];
+            readonly options: readonly [{
+                readonly flags: "--bot <name>";
+                readonly description: "Bot receiving the event";
+                readonly hidden: false;
+            }, {
+                readonly flags: "--json <payload>";
+                readonly description: "JSON object under 16 KB";
+                readonly hidden: false;
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "tail";
+            readonly description: "";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly helpOption: true;
+            readonly helpCommand: false;
+            readonly usage: "[options] <name>";
+            readonly helpText: readonly [];
+            readonly arguments: readonly [{
+                readonly name: "name";
+                readonly required: true;
+                readonly variadic: false;
+                readonly description: "";
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Print the last 50 events as a JSON array";
+                readonly hidden: false;
+            }];
+            readonly subcommands: readonly [];
+        }];
     }, {
         readonly name: "promote";
         readonly description: "Move this local bot to cloud compute, preserving its identity and private context";

package/dist/command-catalog.generated.js

@@ -6723,6 +6723,16 @@ export const COMMAND_CATALOG = [
                         "description": "Run one company (default: every company listed in the companies manifest)",
                         "hidden": false
                     },
+                    {
+                        "flags": "--source <ref>",
+                        "description": "Read a growing source: meeting:<id> or <channel>:<file> (needs --incremental and --company)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--incremental",
+                        "description": "Extract only new signals from --source, retaining a cursor and prior signal ids",
+                        "hidden": false
+                    },
                     {
                         "flags": "--dry-run",
                         "description": "Print what would run; run no mutating step and write nothing",
@@ -18754,6 +18764,11 @@ export const COMMAND_CATALOG = [
                         "description": "Select the company by slug",
                         "hidden": false
                     },
+                    {
+                        "flags": "--source <ref>",
+                        "description": "Report lanes for a source (requires --company; excludes --since)",
+                        "hidden": false
+                    },
                     {
                         "flags": "--since <iso>",
                         "description": "Report activity from this ISO timestamp",
@@ -19323,7 +19338,27 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--project <slug>",
-                        "description": "HQ project slug",
+                        "description": "HQ project slug (executive-bot for --signal)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--signal <id>",
+                        "description": "Create one lane for a company signal",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--rules-file <path>",
+                        "description": "Standing rules for a signal lane",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--any-type",
+                        "description": "Allow signal types other than action_item",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--link <id>",
+                        "description": "Conductor link for a signal lane",
                         "hidden": false
                     },
                     {
@@ -19348,7 +19383,7 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--brief-file <path>",
-                        "description": "Path to the lane brief",
+                        "description": "Path to the lane brief (generated for --signal)",
                         "hidden": false
                     },
                     {
@@ -20037,18 +20072,25 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "status",
-                "description": "Summarize project stories, lanes, PRs, blockers, and pending questions",
+                "description": "Summarize project stories, lanes, PRs, blockers, and pending questions; with a lane id, report that lane's outcome",
                 "aliases": [],
                 "hidden": false,
                 "helpOption": true,
                 "helpCommand": false,
-                "usage": "[options]",
+                "usage": "[options] [lane-id]",
                 "helpText": [],
-                "arguments": [],
+                "arguments": [
+                    {
+                        "name": "lane-id",
+                        "required": false,
+                        "variadic": false,
+                        "description": "Report one lane's state and outcome block instead of a project"
+                    }
+                ],
                 "options": [
                     {
                         "flags": "--project <slug>",
-                        "description": "HQ project slug",
+                        "description": "HQ project slug (required without a lane id)",
                         "hidden": false
                     },
                     {
@@ -23249,6 +23291,17 @@ export const COMMAND_CATALOG = [
                         "description": "How often, as a cron expression (e.g. \"0 9 * * 1-5\")",
                         "hidden": false
                     },
+                    {
+                        "flags": "--on <event>",
+                        "description": "Run when this event is emitted",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--filter <key=value>",
+                        "description": "Match an event payload field (repeatable)",
+                        "hidden": false,
+                        "defaultValue": []
+                    },
                     {
                         "flags": "--tz <zone>",
                         "description": "IANA timezone for the schedule (default: this computer's)",
@@ -23277,6 +23330,77 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "events",
+                "description": "Emit and inspect local bot events",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": true,
+                "usage": "[options] [command]",
+                "helpText": [],
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "emit",
+                        "description": "",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <event>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "event",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--bot <name>",
+                                "description": "Bot receiving the event",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json <payload>",
+                                "description": "JSON object under 16 KB",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "tail",
+                        "description": "",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <name>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "name",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print the last 50 events as a JSON array",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
             {
                 "name": "promote",
                 "description": "Move this local bot to cloud compute, preserving its identity and private context",

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

@@ -0,0 +1,19 @@
+import type { Command } from "commander";
+import { type BotConfig } from "../lib/bot/config.js";
+export interface BotEventsDeps {
+    requireBot(name: string): {
+        name: string;
+        dir: string;
+        config: BotConfig;
+    };
+    out?: (line: string) => void;
+}
+export declare function runBotEventEmit(event: string, opts: {
+    bot: string;
+    json: string;
+}, deps: BotEventsDeps): void;
+export declare function runBotEventsTail(name: string, opts: {
+    json?: boolean;
+}, deps: BotEventsDeps): void;
+export declare function registerBotEventsCommand(bot: Command, deps: BotEventsDeps): void;
+//# sourceMappingURL=bot-events.d.ts.map

package/dist/commands/bot-events.js

@@ -0,0 +1,46 @@
+import { emitBotEvent, tailBotEvents } from "../lib/bot/events.js";
+import { HQ_FLEET_RUNTIME_ENGINE_ID } from "../lib/bot/config.js";
+export function runBotEventEmit(event, opts, deps) {
+    const { dir, config } = deps.requireBot(opts.bot);
+    if (config.engine?.id === HQ_FLEET_RUNTIME_ENGINE_ID)
+        throw new Error("Event journals require a local CLI bot; HQ Fleet Runtime does not drain them.");
+    let payload;
+    try {
+        payload = JSON.parse(opts.json);
+    }
+    catch {
+        throw new Error("Event payload must be valid JSON.");
+    }
+    const record = emitBotEvent(dir, event, payload);
+    (deps.out ?? console.log)(JSON.stringify(record));
+}
+export function runBotEventsTail(name, opts, deps) {
+    const { dir } = deps.requireBot(name);
+    const records = tailBotEvents(dir);
+    const out = deps.out ?? console.log;
+    if (opts.json)
+        out(JSON.stringify(records, null, 2));
+    else
+        for (const record of records)
+            out(`${record.at} ${record.event} ${JSON.stringify(record.payload)}`);
+}
+export function registerBotEventsCommand(bot, deps) {
+    const events = bot.command("events").description("Emit and inspect local bot events");
+    const action = (fn) => {
+        try {
+            fn();
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+        }
+    };
+    events.command("emit <event>")
+        .requiredOption("--bot <name>", "Bot receiving the event")
+        .requiredOption("--json <payload>", "JSON object under 16 KB")
+        .action((event, opts) => action(() => runBotEventEmit(event, opts, deps)));
+    events.command("tail <name>")
+        .option("--json", "Print the last 50 events as a JSON array")
+        .action((name, opts) => action(() => runBotEventsTail(name, opts, deps)));
+}
+//# sourceMappingURL=bot-events.js.map

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

@@ -114,6 +114,8 @@ export interface BotJobsOptions {
     add?: string;
     every?: string;
     cron?: string;
+    on?: string;
+    filter?: string[];
     tz?: string;
     rm?: string;
     /** Change an existing job's schedule, keeping its id, instruction and history. */

package/dist/commands/bot-jobs.js

@@ -16,7 +16,7 @@
  * back when it checks what is due.
  */
 import chalk from "chalk";
-import { localJobsClient } from "../lib/bot/local-jobs.js";
+import { addLocalJob, localJobsClient, readLocalJobs, toJobRecord } from "../lib/bot/local-jobs.js";
 import { BotApiError } from "../lib/bot/api.js";
 import { effectiveBotKind, HQ_FLEET_RUNTIME_ENGINE_ID } from "../lib/bot/config.js";
 import { fleetCronOps, fleetOwnerOrigin, fleetScheduleFromLegacy } from "../lib/bot/fleet-cron.js";
@@ -318,6 +318,10 @@ export function fleetJobsClient(config, ops, timezone) {
 // ─── Reading jobs back ───────────────────────────────────────────────────────
 /** A schedule in plain words, falling back to the raw expression. */
 export function describeSchedule(job) {
+    if (job.trigger) {
+        const filters = Object.entries(job.trigger.filter ?? {}).map(([key, value]) => `${key}=${value}`).join(", ");
+        return `on ${job.trigger.event}${filters ? ` (${filters})` : ""}`;
+    }
     const schedule = job.schedule;
     if (!schedule)
         return "on a schedule";
@@ -391,7 +395,7 @@ export function formatJobsList(botName, jobs, showQuietOption = false) {
         lines.push(`    runs ${describeSchedule(job)}`);
         if (showQuietOption && isQuietJobContext(job.context))
             lines.push("    delivery: quiet after successful runs");
-        lines.push(`    next run: ${job.nextRunAt ? `${utcMinute(job.nextRunAt)} UTC` : "not scheduled yet"}`);
+        lines.push(`    next run: ${job.trigger ? "when a matching event arrives" : job.nextRunAt ? `${utcMinute(job.nextRunAt)} UTC` : "not scheduled yet"}`);
         lines.push(`    last run: ${describeLastRun(job)}`);
     }
     return lines.join("\n");
@@ -454,6 +458,11 @@ export async function runBotJobs(nameArg, opts, deps) {
     if (opts.quiet && opts.add === undefined) {
         refuse("Use --quiet with --add to set a scheduled job's delivery option.");
     }
+    if (opts.on !== undefined && (opts.add === undefined || opts.every !== undefined || opts.cron !== undefined || opts.tz !== undefined)) {
+        refuse("Use --on with --add and without --every, --cron, or --tz.");
+    }
+    if (opts.filter?.length && opts.on === undefined)
+        refuse("Use --filter with --on.");
     // Shared by --add and --reschedule: one schedule from --every or --cron, in
     // the stored form, held to the same floor.
     const scheduleFromOptions = () => {
@@ -516,6 +525,36 @@ export async function runBotJobs(nameArg, opts, deps) {
         if (opts.quiet && !(await quietOptionEnabled())) {
             refuse(`--quiet requires the ${BOT_JOB_QUIET_OPTION_FLAG} flag, which is currently disabled.`);
         }
+        if (opts.on !== undefined) {
+            if (fleet)
+                refuse("Event jobs require a local CLI bot; HQ Fleet Runtime does not drain this event journal.");
+            const event = opts.on.trim();
+            if (!event || event.length > 256 || /[\r\n]/.test(event))
+                refuse("Event name must be 1–256 characters without newlines.");
+            const prompt = opts.add.trim();
+            if (!prompt || Buffer.byteLength(prompt, "utf8") > MAX_PROMPT_BYTES)
+                refuse("Job instruction must be non-empty and at most 16 KB.");
+            const filter = Object.create(null);
+            for (const entry of opts.filter ?? []) {
+                const split = entry.indexOf("=");
+                if (split < 1 || !entry.slice(0, split).trim())
+                    refuse("Each --filter must be key=value.");
+                const key = entry.slice(0, split).trim();
+                if (Object.hasOwn(filter, key))
+                    refuse(`Duplicate filter key: ${key}`);
+                filter[key] = entry.slice(split + 1);
+            }
+            if (readLocalJobs(dir).length >= MAX_ACTIVE_JOBS_PER_AGENT)
+                refuse(`${name} already has the maximum of ${MAX_ACTIVE_JOBS_PER_AGENT} jobs. Remove one first.`);
+            const created = toJobRecord(addLocalJob(dir, {
+                prompt,
+                timezone: localZone,
+                trigger: { kind: "event", event, ...(Object.keys(filter).length ? { filter } : {}) },
+                ...(opts.quiet ? { context: { [JOB_RUN_OPTIONS_CONTEXT_KEY]: { quiet: true } } } : {}),
+            }));
+            out(opts.json ? JSON.stringify({ ok: true, job: created }, null, 2) : `Added ${created.jobId}: ${name} runs it ${describeSchedule(created)}.`);
+            return;
+        }
         const schedule = scheduleFromOptions();
         const body = buildCreateJobBody({ prompt: opts.add, cron: schedule.cron, timezone: schedule.timezone, quiet: opts.quiet });
         const api = await jobsApi();
@@ -558,6 +597,8 @@ export function registerBotJobsCommand(bot, deps) {
         .option("--add <what>", "Schedule new work, in plain language")
         .option("--every <when>", 'How often, in plain language (e.g. "every weekday at 9am")')
         .option("--cron <expr>", 'How often, as a cron expression (e.g. "0 9 * * 1-5")')
+        .option("--on <event>", "Run when this event is emitted")
+        .option("--filter <key=value>", "Match an event payload field (repeatable)", (value, values) => [...values, value], [])
         .option("--tz <zone>", "IANA timezone for the schedule (default: this computer's)")
         .option("--quiet", "Skip owner DMs after successful runs (requires rollout flag)")
         .option("--rm <jobId>", "Remove a scheduled job")

package/dist/commands/bot.d.ts

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 import { type RuntimeSignInCheck, type RuntimeSignInIssue } from "../lib/bot/runtime-sign-in.js";
+import { type ClaudeLoginCheck } from "../lib/bot/claude-login.js";
 import type { BotStatusFile } from "../lib/bot/status.js";
 import { probeBotRuntime, type RuntimeProbeResult } from "../lib/bot/probe.js";
 import { type SpawnInteractive } from "../lib/bot/runtime-auth.js";
@@ -115,6 +116,10 @@ export declare function spawnDetachedRun(name: string, dir: string): number;
  * "unreadable output: trailing characters").
  */
 /** Seams for the self-stop path, replaced in tests. */
+export declare const botCreateSeams: {
+    /** The Claude Code login read the way the HQ Fleet Runtime reads it. */
+    claudeLogin: () => ClaudeLoginCheck;
+};
 export declare const botStopSeams: {
     /** True when this process runs inside the bot process `botPid` (one of its turns). */
     isInsideBot: (botPid: number) => boolean;