@indigoai-us/hq-cli 5.123.2 → 5.125.0

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 ## [Unreleased]
 
+## [5.125.0] — 2026-09-20
+
+### Fixed
+
+- Work Mesh now preserves an acknowledged company binding through later
+  company-less hook writes, preventing repeated registrations and held events.
+  Held recovery accepts only durable registrations, canonical metadata under a
+  verified HQ root, or manifest-backed repository ownership; conflicting or
+  event-only hints stay unresolved. Its batch cursor rotates across restarts.
+  Both legacy and direct-mode daemons detect an upgraded CLI, and systemd units
+  use `Restart=always` so the installed service reloads the new code.
+
+- Held-session recovery now accepts session metadata only from the daemon's
+  configured HQ root, requires current-session evidence before restoring an
+  acknowledged registration, and retains batch position when held records are
+  compacted. Repeated hook activity no longer re-registers an unchanged binding.
+  CLI updates report installed system units that need their host service manager
+  to restart them. Daemon installs persist verified HQ-root allowlists, inject
+  the primary root into service environments, and rewrite/reload existing user
+  units so upgraded daemons restart reliably.
+
+### Added
+
+- Work Mesh now activates a device default company automatically when a signed-in
+  person has exactly one active membership. Devices with several memberships ask
+  for a choice in interactive CLI paths and show the stored state in `hq mesh
+  context default get --json`. Clearing the default is a durable opt-out until
+  the person explicitly sets one again. Historical held sessions remain unchanged
+  unless `hq mesh context backfill-held --use-device-default` is supplied; those
+  repaired records are labeled lower-confidence and counted by daemon doctor.
+
+## [5.124.0] — 2026-09-20
+
+### Added
+
+- `hq billing sponsor` — ask a company to cover your $50/mo HQ Individual plan
+  from the terminal, and answer those requests if you run the company.
+  `request <company>` asks, `list` shows the queue you can answer or — if you
+  are not an admin there — your own single status for that company, and
+  `approve` / `decline` / `revoke` / `withdraw` resolve one. Pass `--company`
+  to `list` when you are asking about your own state.
+
+  Approving does not always finish the job: if the company has no card on file,
+  HQ accepts the yes but nothing is covered yet, and `approve` says so with the
+  link to add one. This is off until HQ turns it on; until then the commands
+  say it is not available yet rather than failing with a validation error.
+
 ## [5.123.2] — 2026-09-19
 
 ### Fixed

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

@@ -4850,6 +4850,110 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Emit the Checkout URL as JSON";
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "sponsor";
+        readonly description: "Ask a company to cover your $50 plan, or answer a request";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options] [command]";
+        readonly arguments: readonly [];
+        readonly options: readonly [];
+        readonly subcommands: readonly [{
+            readonly name: "request";
+            readonly description: "Ask a company to cover your $50 HQ plan";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options] <company>";
+            readonly arguments: readonly [{
+                readonly name: "company";
+                readonly required: true;
+                readonly variadic: false;
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "list";
+            readonly description: "Show sponsorship requests — the company's queue, or your own";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options]";
+            readonly arguments: readonly [];
+            readonly options: readonly [{
+                readonly flags: "--company <slug>";
+                readonly description: "Company slug (resolves to companyUid)";
+            }, {
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "approve";
+            readonly description: "Say yes — put someone's $50 plan on the company bill";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options] <id>";
+            readonly arguments: readonly [{
+                readonly name: "id";
+                readonly required: true;
+                readonly variadic: false;
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "decline";
+            readonly description: "Say no to a plan sponsorship request";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options] <id>";
+            readonly arguments: readonly [{
+                readonly name: "id";
+                readonly required: true;
+                readonly variadic: false;
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "revoke";
+            readonly description: "End a sponsorship the company is currently paying for";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options] <id>";
+            readonly arguments: readonly [{
+                readonly name: "id";
+                readonly required: true;
+                readonly variadic: false;
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }, {
+            readonly name: "withdraw";
+            readonly description: "Take back a sponsorship request you made";
+            readonly aliases: readonly [];
+            readonly hidden: false;
+            readonly usage: "[options] <id>";
+            readonly arguments: readonly [{
+                readonly name: "id";
+                readonly required: true;
+                readonly variadic: false;
+            }];
+            readonly options: readonly [{
+                readonly flags: "--json";
+                readonly description: "Emit raw JSON";
+            }];
+            readonly subcommands: readonly [];
+        }];
     }];
 }, {
     readonly name: "core";
@@ -5625,7 +5729,10 @@ export declare const COMMAND_CATALOG: readonly [{
                 readonly description: "Cap sessions processed (default 0 = no cap)";
             }, {
                 readonly flags: "--company <slug>";
-                readonly description: "Optional non-forcing company hint (resolver default still wins)";
+                readonly description: "Optional non-forcing company hint";
+            }, {
+                readonly flags: "--use-device-default";
+                readonly description: "Opt in to historical repair using the device default (lower-confidence attribution)";
             }, {
                 readonly flags: "--json";
                 readonly description: "Print machine-readable JSON";
@@ -5765,6 +5872,9 @@ export declare const COMMAND_CATALOG: readonly [{
                 readonly options: readonly [{
                     readonly flags: "--allow-without-migration";
                     readonly description: "Deprecated compatibility no-op; selected-company membership is always verified";
+                }, {
+                    readonly flags: "--repair-held-with-default";
+                    readonly description: "Persist opt-in for lower-confidence historical held-session repair";
                 }, {
                     readonly flags: "--company <slug|uid>";
                     readonly description: "Deprecated no-op; the selected company is verified directly";

package/dist/command-catalog.generated.js

@@ -6268,6 +6268,141 @@ export const COMMAND_CATALOG = [
                     }
                 ],
                 "subcommands": []
+            },
+            {
+                "name": "sponsor",
+                "description": "Ask a company to cover your $50 plan, or answer a request",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] [command]",
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "request",
+                        "description": "Ask a company to cover your $50 HQ plan",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <company>",
+                        "arguments": [
+                            {
+                                "name": "company",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "list",
+                        "description": "Show sponsorship requests — the company's queue, or your own",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options]",
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--company <slug>",
+                                "description": "Company slug (resolves to companyUid)"
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "approve",
+                        "description": "Say yes — put someone's $50 plan on the company bill",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <id>",
+                        "arguments": [
+                            {
+                                "name": "id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "decline",
+                        "description": "Say no to a plan sponsorship request",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <id>",
+                        "arguments": [
+                            {
+                                "name": "id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "revoke",
+                        "description": "End a sponsorship the company is currently paying for",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <id>",
+                        "arguments": [
+                            {
+                                "name": "id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "withdraw",
+                        "description": "Take back a sponsorship request you made",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[options] <id>",
+                        "arguments": [
+                            {
+                                "name": "id",
+                                "required": true,
+                                "variadic": false
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--json",
+                                "description": "Emit raw JSON"
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
             }
         ]
     },
@@ -7256,7 +7391,11 @@ export const COMMAND_CATALOG = [
                             },
                             {
                                 "flags": "--company <slug>",
-                                "description": "Optional non-forcing company hint (resolver default still wins)"
+                                "description": "Optional non-forcing company hint"
+                            },
+                            {
+                                "flags": "--use-device-default",
+                                "description": "Opt in to historical repair using the device default (lower-confidence attribution)"
                             },
                             {
                                 "flags": "--json",
@@ -7438,6 +7577,10 @@ export const COMMAND_CATALOG = [
                                         "flags": "--allow-without-migration",
                                         "description": "Deprecated compatibility no-op; selected-company membership is always verified"
                                     },
+                                    {
+                                        "flags": "--repair-held-with-default",
+                                        "description": "Persist opt-in for lower-confidence historical held-session repair"
+                                    },
                                     {
                                         "flags": "--company <slug|uid>",
                                         "description": "Deprecated no-op; the selected company is verified directly"

package/dist/commands/billing-sponsor.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `hq billing sponsor` — the individual-pull half of plan sponsorship, from the
+ * terminal ("ask a company to sponsor me", hq-pro #3609).
+ *
+ * A person who is over a personal limit has exactly three ways out: pay $50
+ * themselves, reduce what they store, or ask a company to cover the $50 plan
+ * line. This command is the third one, plus the admin side that answers it.
+ *
+ *   hq billing sponsor request <company>   — ask that company to cover my plan
+ *   hq billing sponsor list                — the queue (admins), or my own
+ *                                            single status (everyone else)
+ *   hq billing sponsor approve <id>        — admin: say yes
+ *   hq billing sponsor decline <id>        — admin: say no
+ *   hq billing sponsor revoke  <id>        — admin: end an active sponsorship
+ *   hq billing sponsor withdraw <id>       — me: take back my own request
+ *
+ * Every subcommand talks to the SAME hq-pro routes the console uses
+ * (`/v1/billing/sponsorship/...`). hq-pro is the authoritative gate on all of
+ * them: it resolves the caller's person id and the company's admin set
+ * server-side, so nothing here is trusted from the client.
+ *
+ * FEATURE SWITCH. The `plan` request kind only exists while hq-pro's
+ * `PLAN_SPONSORSHIP_REQUESTS_ENABLED` switch is on. With the switch off the
+ * backend does not recognise `plan` and answers 400 `MISSING_FIELDS` — which
+ * would read as "you typed something wrong". We translate that one case into a
+ * plain "not available yet" line so a person never sees a validation error for
+ * a feature that simply is not turned on.
+ */
+import { Command } from "commander";
+/** The request kind this command files. Matches hq-pro's contract. */
+export declare const PLAN_RESOURCE: "plan";
+/** What a person is told when hq-pro's plan-sponsorship switch is off. */
+export declare const FEATURE_OFF_MESSAGE = "Asking a company to sponsor your plan isn't available yet.";
+/** What v1 sponsorship covers, stated wherever a person confirms or reads it. */
+export declare const COVERAGE_SENTENCE = "Your company pays your $50 plan. Storage above your plan's allowance is still yours.";
+/** What a person is told while an approval waits on the sponsor's card. */
+export declare const HELD_FOR_CARD_SENTENCE = "Your company said yes and is adding a card. Your limits still apply until then.";
+/** One request row as hq-pro persists and returns it. */
+export interface SponsorshipRequestRecord {
+    requestId: string;
+    companyUid: string;
+    requestedBy: string;
+    resourceId?: string;
+    resource: "outpost" | "agent" | "plan";
+    status: "pending" | "active" | "declined" | "pending-sponsor-billing" | "expired";
+    payer: "person" | "company";
+    requestedAt: string;
+    updatedAt: string;
+}
+/** An hq-pro error body: `{ error, code }` on every non-2xx these routes send. */
+interface ApiErrorBody {
+    error?: string;
+    message?: string;
+    code?: string;
+}
+/**
+ * Turn an hq-pro non-2xx into one plain sentence.
+ *
+ * The switch-off 400 is the important translation: with the feature off,
+ * `plan` is an unrecognised resource kind and the generic body reads
+ * "companyUid and resource ('outpost'|'agent') are required", which tells a
+ * person nothing true about what happened.
+ */
+export declare function messageForError(status: number, body: ApiErrorBody): string;
+/**
+ * The member self-read's shape. hq-pro answers
+ * `GET /v1/billing/sponsorship/mine?companyUid=…&resource=…` with ONE status —
+ * not a list — because the route is a self-scoped "am I covered" question.
+ * `active` is true only for an approved COMPANY-paid row; everything else
+ * (never asked, still pending, declined) comes back `active: false` with null
+ * fields.
+ */
+export interface SponsorshipSelfState {
+    active: boolean;
+    status: string | null;
+    payer: "person" | "company" | null;
+    requestId: string | null;
+}
+/** Plain label for a request status. Never shows the raw enum. */
+export declare function statusLabel(status: string): string;
+export declare function registerBillingSponsorCommands(billing: Command): void;
+export {};
+//# sourceMappingURL=billing-sponsor.d.ts.map