@indigoai-us/hq-cli 5.345.198 → 5.345.200

package/CHANGELOG.md

@@ -2,6 +2,77 @@
 
 ## [Unreleased]
 
+## [5.345.200] — 2026-11-04
+- `hq creators apply`, `hq library` (search, add, describe, link, rm),
+  `hq sync held`, and `hq lanes` no longer open a browser sign-in when no
+  person is at a terminal (a lane worker, daemon, bot, launchd task, or piped
+  child). They print the `hq login` remedy instead. The headless `hq login`
+  URL path now uses a registered callback port, and a stray
+  `HQ_COGNITO_CALLBACK_PORT` warning prints once per process.
+- The stray callback-port warning no longer prints on commands that never
+  sign in; the port is read when a sign-in starts. `hq bot` and `hq secrets`
+  sign-ins now go through the same interactive-caller gate.
+- `hq bot runtime install` downloads and builds the HQ Fleet Runtime once for
+  this computer, with progress, so `hq bot create` afterwards takes seconds.
+  `hq bot runtime status` says which of the three steps (download, Python,
+  environment) are done. `--json` prints one event per line for the desktop app.
+- The runtime download streams to disk, continues where it stopped after a
+  stall or a dropped connection, and no longer has a 20 minute cap. Creates and
+  adopts started at the same time share one download through a machine-wide
+  lock instead of each fetching the same archive. A gzip runtime archive is
+  accepted alongside the plain tar, and a matching archive from any installed
+  release is reused without a download.
+- `hq bot create`, `hq bot adopt` and `hq bot restore` print what the runtime
+  install is doing on stderr (download percentage, then each build step)
+  unless `--json` is given.
+- Personal and unattributed conversations are no longer assigned from a device default company or sent as Work Mesh summaries. Reporting respects the HQ Anywhere off setting.
+- Validate session capability documents before reading company grants.
+
+## [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/assets/scaffold/core/scripts/lib/session-scope-capability.sh

@@ -53,8 +53,8 @@ session_scope_read() {
   local root="${1:-}" sid="${2:-}" aid="${3:-}" cap
   cap="$(session_scope_capability_path "$root" "$sid" "$aid")" || return 0
   [ -f "$cap" ] || return 0
-  jq -r --arg sid "$sid" --arg aid "$aid" \
-    'select(.session_id == $sid and (.agent_id // "") == $aid) | .company_slug // empty' \
+  jq -sr --arg sid "$sid" --arg aid "$aid" \
+    'if length == 1 and (.[0] | type) == "object" then .[0] else error("capability must contain one object") end | select(.session_id == $sid and (.agent_id // "") == $aid) | .company_slug // empty' \
     "$cap" 2>/dev/null || true
 }
 
@@ -66,8 +66,10 @@ session_scope_read_companies() {
   local -a slugs
   cap="$(session_scope_capability_path "$root" "$sid" "$aid")" || return 0
   [ -f "$cap" ] || return 0
-  lock_info="$(jq -er --arg sid "$sid" --arg aid "$aid" '
-    select(.session_id == $sid and (.agent_id // "") == $aid)
+  lock_info="$(jq -ser --arg sid "$sid" --arg aid "$aid" '
+    if length == 1 and (.[0] | type) == "object" then .[0]
+    else error("capability must contain one object") end
+    | select(.session_id == $sid and (.agent_id // "") == $aid)
     | if (.company_slug | type) != "string" or (.company_slug | test("^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$") | not) then error("invalid primary")
       elif has("company_slugs") then
         if (.company_slugs | type) == "array" and all(.company_slugs[]; type == "string" and test("^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"))

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";
@@ -19710,6 +19810,50 @@ export declare const COMMAND_CATALOG: readonly [{
         }];
         readonly options: readonly [];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "runtime";
+        readonly description: "The HQ Fleet Runtime every local bot on this computer shares";
+        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: "install";
+            readonly description: "Download and build the runtime once for this computer, with progress, so creating a bot takes seconds. Safe to run again: a finished install returns at once, an interrupted download continues where it stopped";
+            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: "--json";
+                readonly description: "Print one JSON object per line: progress events, then { ok, event: \"done\", release, runtimeDir }";
+                readonly hidden: false;
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "status";
+            readonly description: "Say whether the runtime is installed on this computer, step by step";
+            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: "--json";
+                readonly description: "Print machine-readable JSON";
+                readonly hidden: false;
+            }];
+            readonly subcommands: readonly [];
+        }];
     }, {
         readonly name: "daemon";
         readonly description: "Manage the bot's launchd user agent (macOS)";

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",
@@ -24035,6 +24159,58 @@ export const COMMAND_CATALOG = [
                 "options": [],
                 "subcommands": []
             },
+            {
+                "name": "runtime",
+                "description": "The HQ Fleet Runtime every local bot on this computer shares",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": true,
+                "usage": "[options] [command]",
+                "helpText": [],
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "install",
+                        "description": "Download and build the runtime once for this computer, with progress, so creating a bot takes seconds. Safe to run again: a finished install returns at once, an interrupted download continues where it stopped",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options]",
+                        "helpText": [],
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print one JSON object per line: progress events, then { ok, event: \"done\", release, runtimeDir }",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "status",
+                        "description": "Say whether the runtime is installed on this computer, step by step",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options]",
+                        "helpText": [],
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
+            },
             {
                 "name": "daemon",
                 "description": "Manage the bot's launchd user agent (macOS)",

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. */