@indigoai-us/hq-cli 5.345.162 → 5.345.164

package/dist/command-catalog.generated.js

@@ -5578,7 +5578,7 @@ export const COMMAND_CATALOG = [
                 "hidden": false,
                 "helpOption": true,
                 "helpCommand": false,
-                "usage": "[options] <id>",
+                "usage": "[options] <id> [person]",
                 "helpText": [],
                 "arguments": [
                     {
@@ -5586,6 +5586,12 @@ export const COMMAND_CATALOG = [
                         "required": true,
                         "variadic": false,
                         "description": "Feedback id (feedback_<uuid>)"
+                    },
+                    {
+                        "name": "person",
+                        "required": false,
+                        "variadic": false,
+                        "description": "New assignee: an email address or a prs_ uid"
                     }
                 ],
                 "options": [
@@ -5593,6 +5599,142 @@ export const COMMAND_CATALOG = [
                         "flags": "--to <assignee>",
                         "description": "New assignee: an email address or a prs_ uid",
                         "hidden": false
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print the result as JSON",
+                        "hidden": false
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "list",
+                "description": "List feedback: untriaged (default), yours, or one person's",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options]",
+                "helpText": [],
+                "arguments": [],
+                "options": [
+                    {
+                        "flags": "--untriaged",
+                        "description": "Items nobody has triaged yet (the default)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--mine",
+                        "description": "Items assigned to you",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--assignee <person>",
+                        "description": "Items assigned to this email address or prs_ uid",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--status <status>",
+                        "description": "Only items with this status",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--limit <n>",
+                        "description": "Stop after this many items (default 50)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--all",
+                        "description": "Fetch every page",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print { items, count } as JSON",
+                        "hidden": false
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "triage",
+                "description": "Label a feedback item with its kind, area and summary, or mark it a duplicate",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options] <id>",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "id",
+                        "required": true,
+                        "variadic": false,
+                        "description": "Feedback id (feedback_<uuid>)"
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--kind <kind>",
+                        "description": "One of bug, feature, question",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--area <area>",
+                        "description": "Product area, for example sync or desktop",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--summary <text>",
+                        "description": "One-line triage summary (at most 2000 characters)",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--duplicate-of <id>",
+                        "description": "Mark this item a duplicate of another feedback id",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print the updated item as JSON",
+                        "hidden": false
+                    }
+                ],
+                "subcommands": []
+            },
+            {
+                "name": "close",
+                "description": "Close a feedback item as resolved (or won't fix) with a reason",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options] <id>",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "id",
+                        "required": true,
+                        "variadic": false,
+                        "description": "Feedback id (feedback_<uuid>)"
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--reason <text>",
+                        "description": "Why it is closed: the fix, PR or version, or the decision",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--wont-fix",
+                        "description": "Close as won't fix instead of resolved",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print the updated item as JSON",
+                        "hidden": false
                     }
                 ],
                 "subcommands": []
@@ -23461,6 +23603,285 @@ export const COMMAND_CATALOG = [
                         "subcommands": []
                     }
                 ]
+            },
+            {
+                "name": "domains",
+                "description": "Manage custom domains on your deployed apps, and buy domains",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": true,
+                "usage": "[options] [command]",
+                "helpText": [
+                    {
+                        "position": "after",
+                        "text": "\nadd, remove and buy ask for approval in an interactive terminal. Without one (a script, CI, or a Windows shell that does not report a terminal, such as Git Bash under mintty), pass --yes."
+                    }
+                ],
+                "arguments": [],
+                "options": [],
+                "subcommands": [
+                    {
+                        "name": "list",
+                        "description": "List the custom domains on an app",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options]",
+                        "helpText": [],
+                        "arguments": [],
+                        "options": [
+                            {
+                                "flags": "--app <app>",
+                                "description": "app id, subdomain or name (default: the app linked to this folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--path <dir>",
+                                "description": "folder linked to the app (default: current folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the linked or active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "add",
+                        "description": "Link a custom domain to an app and print the DNS records to create",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <domain>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "domain",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--env <name>",
+                                "description": "environment to serve",
+                                "hidden": false,
+                                "defaultValue": "production"
+                            },
+                            {
+                                "flags": "--yes",
+                                "description": "add without a prompt (the domain can add a monthly charge)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--app <app>",
+                                "description": "app id, subdomain or name (default: the app linked to this folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--path <dir>",
+                                "description": "folder linked to the app (default: current folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the linked or active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "refresh",
+                        "description": "Check DNS validation and start serving once the certificate is issued (exits 2 while not live)",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <domain>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "domain",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--app <app>",
+                                "description": "app id, subdomain or name (default: the app linked to this folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--path <dir>",
+                                "description": "folder linked to the app (default: current folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the linked or active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "remove",
+                        "description": "Unlink a custom domain from an app",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <domain>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "domain",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--env <name>",
+                                "description": "pick the environment when the domain points at more than one",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--yes",
+                                "description": "remove without a prompt",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--app <app>",
+                                "description": "app id, subdomain or name (default: the app linked to this folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--path <dir>",
+                                "description": "folder linked to the app (default: current folder)",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the linked or active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "search",
+                        "description": "Check whether a domain can be bought, and its price",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <query>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "query",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    },
+                    {
+                        "name": "buy",
+                        "description": "Buy a domain for the company (owner or admin)",
+                        "aliases": [],
+                        "hidden": false,
+                        "helpOption": true,
+                        "helpCommand": false,
+                        "usage": "[options] <domain>",
+                        "helpText": [],
+                        "arguments": [
+                            {
+                                "name": "domain",
+                                "required": true,
+                                "variadic": false,
+                                "description": ""
+                            }
+                        ],
+                        "options": [
+                            {
+                                "flags": "--price <usd>",
+                                "description": "first-year price shown by 'hq deploy domains search'",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--registrant-file <path>",
+                                "description": "JSON file with the registrant contact",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--idempotency-key <key>",
+                                "description": "retry an earlier order that did not finish",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--company <slug>",
+                                "description": "use this company instead of the active company",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--yes",
+                                "description": "buy without a prompt",
+                                "hidden": false
+                            },
+                            {
+                                "flags": "--json",
+                                "description": "print machine-readable JSON",
+                                "hidden": false
+                            }
+                        ],
+                        "subcommands": []
+                    }
+                ]
             }
         ]
     },

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

@@ -551,6 +551,12 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "deploy";
     readonly module: "./commands/deploy-access.js";
     readonly exportName: "registerDeployAccessCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "deploy";
+    readonly parent: "deploy";
+    readonly module: "./commands/deploy-domains.js";
+    readonly exportName: "registerDeployDomainsCommand";
 }, {
     readonly type: "group";
     readonly root: "staff";

package/dist/command-registration-plan.js

@@ -94,6 +94,7 @@ export const REGISTRATION_PLAN = [
     { type: "registrar", root: "deploy", parent: "deploy", module: "./commands/deploy-comments.js", exportName: "registerDeployCommentsCommand" },
     { type: "registrar", root: "deploy", parent: "deploy", module: "./commands/deploy-list.js", exportName: "registerDeployListCommand" },
     { type: "registrar", root: "deploy", parent: "deploy", module: "./commands/deploy-access.js", exportName: "registerDeployAccessCommand" },
+    { type: "registrar", root: "deploy", parent: "deploy", module: "./commands/deploy-domains.js", exportName: "registerDeployDomainsCommand" },
     // onboarding-test-accounts US-007 — super-admin staff CLI wrappers over the
     // hq-pro admin surface. New wrappers land under this group; the reset
     // command mirrors POST /v1/admin/test-account/reset.

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

@@ -28,7 +28,8 @@
  */
 import type { Command } from "commander";
 import { type BillingUsageReport, type ReadMonthUsageDeps, type StorageSplit, type UsageScope } from "../lib/billing/usage-cost.js";
-import { type PricingPlan } from "../lib/billing/usage-only.js";
+import { type UsageCard } from "../lib/billing/usage-card.js";
+import { type SharedBillingState, type PricingPlan } from "../lib/billing/usage-only.js";
 export interface MembershipRef {
     uid: string;
     slug: string;
@@ -60,6 +61,11 @@ export interface BillingUsageDeps {
      * for the plan when usage-limits does not carry it (older server).
      */
     fetchBillingSummary?: (scope: UsageScope) => Promise<unknown | null>;
+    /**
+     * The shared billing state for the scope, read when neither the statement
+     * nor the usage-limits body carries one. Null when it is not known.
+     */
+    readBillingState?: (scope: UsageScope) => Promise<SharedBillingState | null>;
     now(): Date;
 }
 export interface BillingUsageOptions {
@@ -91,7 +97,11 @@ export declare function resolveOnUsagePricing(limitsPlan: PricingPlan | null, su
 /** Thrown when the company statement is refused to a caller who is not its owner. */
 export declare class UsageStatementForbiddenError extends Error {
 }
-export declare function runBillingUsage(opts: BillingUsageOptions, deps: BillingUsageDeps): Promise<BillingUsageReport>;
+/** The usage report plus the shared billing state it was read with (US-025). */
+export type BillingUsageResult = BillingUsageReport & {
+    billingState?: SharedBillingState | null;
+};
+export declare function runBillingUsage(opts: BillingUsageOptions, deps: BillingUsageDeps): Promise<BillingUsageResult>;
 /**
  * `hq billing usage --card`: the card from GET /v1/pricing, or the bundled
  * card when the feed has none. Needs no sign-in.
@@ -99,6 +109,10 @@ export declare function runBillingUsage(opts: BillingUsageOptions, deps: Billing
 export declare function renderUsageCard(opts?: {
     json?: boolean;
     fetchPricing?: () => Promise<unknown | null>;
+    /** The caller's billing state, best effort. Absent or null prints the card alone. */
+    readState?: () => Promise<SharedBillingState | null>;
 }): Promise<string>;
+/** The text output: the report, then the account lines from the billing state. */
+export declare function formatUsageResult(report: BillingUsageResult, card: UsageCard): string;
 export declare function registerBillingUsageCommand(billing: Command): void;
 //# sourceMappingURL=billing-usage.d.ts.map

package/dist/commands/billing-usage.js

@@ -27,12 +27,13 @@
  * projected bill.
  */
 import chalk from "chalk";
-import { ensureCognitoToken } from "../utils/cognito-session.js";
+import { ensureCognitoToken, hasPersonCachedSession } from "../utils/cognito-session.js";
 import { vaultApiFetch, vaultApiFetchPublic } from "../utils/vault-api.js";
 import { buildReadingsReport, buildReport, formatReport, readMonthUsage, usageLimitsSource, usageStatementSource, } from "../lib/billing/usage-cost.js";
 import { ratesFromPricingStatement } from "../lib/billing/usage-rate-card.js";
 import { fetchUsageCard, formatUsageCardLines } from "../lib/billing/usage-card.js";
-import { fetchCompanyBillingSummary, pricingPlanFromBody, hasBillingStateField, usageTrialActiveFromBody, } from "../lib/billing/usage-only.js";
+import { accountStatusLines } from "../lib/billing/billing-status-lines.js";
+import { fetchCompanyBillingSummary, pricingPlanFromBody, hasBillingStateField, readBillingState, usageTrialActiveFromBody, } from "../lib/billing/usage-only.js";
 export class UsageScopeError extends Error {
 }
 /** Pick the scope. Never reaches outside the caller's own memberships. */
@@ -153,9 +154,14 @@ export async function runBillingUsage(opts, deps) {
         })
         : null;
     const onUsagePricing = resolveOnUsagePricing(limitsPlan, pricingPlanFromSummary(summary));
+    const billingState = readBillingState(statement?.body) ??
+        readBillingState(limitsBody) ??
+        readBillingState(summary) ??
+        (deps.readBillingState ? await deps.readBillingState(scope).catch(() => null) : undefined);
+    const withState = (report) => billingState === undefined ? report : { ...report, billingState };
     if (onUsagePricing !== true)
-        return buildReadingsReport(usage, onUsagePricing);
-    return { ...buildReport(usage, ratesFromPricingStatement(pricing)), onUsagePricing: true };
+        return withState(buildReadingsReport(usage, onUsagePricing));
+    return withState({ ...buildReport(usage, ratesFromPricingStatement(pricing)), onUsagePricing: true });
 }
 // ── Production deps ─────────────────────────────────────────────────────────
 function productionDeps() {
@@ -223,6 +229,9 @@ function productionDeps() {
                 return null;
             return res.json().catch(() => null);
         },
+        async readBillingState(scope) {
+            return readBillingState(await this.fetchBillingSummary(scope));
+        },
         now: () => new Date(),
     };
 }
@@ -232,12 +241,44 @@ function productionDeps() {
  */
 export async function renderUsageCard(opts = {}) {
     const { card, source } = await fetchUsageCard(opts.fetchPricing ? { fetchPricing: opts.fetchPricing } : {});
-    if (opts.json)
-        return JSON.stringify({ source, card }, null, 2);
+    const state = opts.readState ? await opts.readState().catch(() => null) : null;
+    if (opts.json) {
+        return JSON.stringify({ source, card, ...(opts.readState ? { billingState: state } : {}) }, null, 2);
+    }
+    const account = accountStatusLines(state, card);
     const from = source === "feed"
         ? "from GET /v1/pricing"
         : "bundled copy; the pricing feed has no usage card yet";
-    return [`HQ usage pricing (card ${card.version}, ${from})`, "", ...formatUsageCardLines(card)].join("\n");
+    return [
+        `HQ usage pricing (card ${card.version}, ${from})`,
+        "",
+        ...formatUsageCardLines(card),
+        ...(account.length > 0 ? ["", "Your account:", ...account.map((l) => `  ${l}`)] : []),
+    ].join("\n");
+}
+/**
+ * The billing state for `--card`, only when a sign-in is already cached: the
+ * card needs no sign-in, so this never opens a browser login. Any failure is
+ * null and the card prints alone.
+ */
+async function cachedSessionBillingState(company) {
+    if (!hasPersonCachedSession())
+        return null;
+    const token = await ensureCognitoToken({ interactive: false });
+    const res = await vaultApiFetch({ token, path: "/membership/me" });
+    if (!res.ok)
+        return null;
+    const { companiesFromMemberships } = await import("./storage.js");
+    const scope = resolveUsageScope(companiesFromMemberships(await res.json()), { company });
+    if (scope.kind === "company")
+        return readBillingState(await fetchCompanyBillingSummary(token, scope.companyUid));
+    const person = await vaultApiFetch({ token, path: "/v1/billing/person/summary" });
+    return person.ok ? readBillingState(await person.json().catch(() => null)) : null;
+}
+/** The text output: the report, then the account lines from the billing state. */
+export function formatUsageResult(report, card) {
+    const account = accountStatusLines(report.billingState ?? null, card);
+    return account.length > 0 ? [formatReport(report), "", ...account].join("\n") : formatReport(report);
 }
 export function registerBillingUsageCommand(billing) {
     billing
@@ -252,12 +293,25 @@ export function registerBillingUsageCommand(billing) {
         .action(async function (opts) {
         try {
             if (opts.card) {
-                console.log(await renderUsageCard({ json: opts.json === true }));
+                const cardCompany = opts.company ?? this.parent?.opts().company;
+                console.log(await renderUsageCard({
+                    json: opts.json === true,
+                    readState: () => cachedSessionBillingState(cardCompany),
+                }));
                 return;
             }
             const parentCompany = this.parent?.opts().company ?? undefined;
             const report = await runBillingUsage({ ...opts, company: opts.company ?? parentCompany }, productionDeps());
-            console.log(opts.json ? JSON.stringify(report, null, 2) : formatReport(report));
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else if (report.billingState) {
+                const { card } = await fetchUsageCard();
+                console.log(formatUsageResult(report, card));
+            }
+            else {
+                console.log(formatReport(report));
+            }
         }
         catch (err) {
             console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));