@indigoai-us/hq-cli 5.345.48 → 5.345.50

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [5.345.50] — 2026-10-08
+- The lane keep-alive audit now admits every `done` stop envelope and splits the unrestarted ones by keep-alive eligibility: a stop keep-alive is specified not to wake is reported as `finished_story` or `idle_no_queued_work` instead of being counted as a liveness failure. `stopped_and_not_restarted_on_their_own` keeps its name and its value on the stops the audit already reported.
+- A finished standing lane that receives queued work long after it stopped now gets the normal grace period measured from when that work appeared, so a normal exit from `idle_no_queued_work` is no longer reported as a keep-alive liveness failure.
+- `hq db usage`, `hq db sql`, `hq db dump` and `hq db destroy` accept the app name or subdomain in `--app`, not only the app id. Names are looked up in the given company only, and a name shared by two apps is refused with both ids.
+- Pinned hq-cloud installs retry transient registry failures with bounded backoff. A cold start will not start a staged or bundled copy that misses the pin. If sync is already running on another version, it stays up while the updater retries the pinned install, and the daemon logs both versions. Updater logs also report the hq-cloud package version installed before the update.
+- Add `hq dm forward` for forwarding existing DM and channel messages with optional notes and file-access choices. DM and channel transcripts identify forwarded messages, and channel posts accept `--details` and `--prompt` text or files behind the `dm.forward-cli` kill switch.
+
+## [5.345.49] — 2026-10-08
+- Persist terminal lane envelopes and story metadata when a final report arrives after the lane has already stopped.
+
+- Keep changelog guard coverage valid after release fragments move into CHANGELOG.md.
+- The CLI now updates the pnpm-managed `hq` install that PATH resolves first, so `hq update` converges when another pnpm home shadows the running process.
+- Preserve an explicit unknown state when the lanes flag registry cannot be read. The four message-delivery and session-wake gates now fail open on unknown; all other lanes gates retain their fail-closed behavior.
+- `hq feedback bug` can include a fail-off, hq-flags-gated agent or human reporter mark derived from runtime context.
+- HQ Anywhere remains enabled when its flag registry is unavailable, while the local kill switch still turns it off.
+- Windows native-resolve cleanup accepts taskkill exit 128 only after confirming the target process has exited.
+
 ## [5.345.48] — 2026-10-08
 - Add default-off multi-company session locks with ordered `hq-session add/remove company` updates and scope-capability enforcement.
 - Give a sync runner that reports stopping 60 seconds to persist pending pushes before SIGKILL. The daemon shutdown deadline includes that grace; other services remain capped at 15 seconds.

package/README.md

@@ -9,7 +9,8 @@ hq --help
 
 The global HQ runtime installs hooks for supported agent runtimes. When the
 `hq-anywhere-runtime` flag is enabled, the hooks use hqd and a per-user folder
-registry. The flag is off by default. See [HQ Anywhere runtime](docs/anywhere-runtime.md)
+registry. The flag defaults on when its registry row cannot be read, and an
+explicit false turns it off. See [HQ Anywhere runtime](docs/anywhere-runtime.md)
 for install and link commands.
 
 ## Live meeting transcripts

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

@@ -1932,7 +1932,7 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--app <app>";
-            readonly description: "Run against this app's remote database schema";
+            readonly description: "Run against this app's remote database (app id, name or subdomain)";
             readonly hidden: false;
         }, {
             readonly flags: "--write";
@@ -2029,8 +2029,8 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Company slug";
             readonly hidden: false;
         }, {
-            readonly flags: "--app <name>";
-            readonly description: "Show one app: included amounts, use, overage, ceiling and estimated charge";
+            readonly flags: "--app <app>";
+            readonly description: "App id, name or subdomain. Shows included amounts, use, overage, ceiling and estimated charge";
             readonly hidden: false;
         }];
         readonly subcommands: readonly [];
@@ -2050,7 +2050,7 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--app <app>";
-            readonly description: "App id";
+            readonly description: "App id, name or subdomain";
             readonly hidden: false;
         }, {
             readonly flags: "--out <file>";
@@ -2077,15 +2077,15 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--app <app>";
-            readonly description: "App id";
+            readonly description: "App id, name or subdomain";
             readonly hidden: false;
         }, {
             readonly flags: "--confirm <app>";
-            readonly description: "Type the app id again to confirm (required when not interactive)";
+            readonly description: "Type the same --app value again to confirm (required when not interactive)";
             readonly hidden: false;
         }, {
             readonly flags: "--yes";
-            readonly description: "Skip the dump question; the app id confirmation is still required";
+            readonly description: "Skip the dump question; the confirmation is still required";
             readonly hidden: false;
         }, {
             readonly flags: "--dump-first";
@@ -3309,19 +3309,19 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--prompt <text>";
-            readonly description: "Agent-context prompt the recipient can one-click copy into their agent (1:1 DMs only)";
+            readonly description: "Agent-context prompt the recipient can one-click copy into their agent (1:1 DMs; channel sends also supported)";
             readonly hidden: false;
         }, {
             readonly flags: "--prompt-file <path>";
-            readonly description: "Read the agent prompt from a file (1:1 DMs only)";
+            readonly description: "Read the agent prompt from a file (1:1 DMs; channel sends also supported)";
             readonly hidden: false;
         }, {
             readonly flags: "--details <text>";
-            readonly description: "Longer detail shown in the recipient's DM detail window (1:1 DMs only)";
+            readonly description: "Longer detail shown in the recipient's DM detail window (1:1 DMs; channel sends also supported)";
             readonly hidden: false;
         }, {
             readonly flags: "--details-file <path>";
-            readonly description: "Read the details from a file (1:1 DMs only)";
+            readonly description: "Read the details from a file (1:1 DMs; channel sends also supported)";
             readonly hidden: false;
         }, {
             readonly flags: "--at <iso>";
@@ -3337,6 +3337,51 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "forward";
+        readonly description: "Forward a DM or channel message through the existing send routes.";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly helpOption: true;
+        readonly helpCommand: false;
+        readonly usage: "[options] <eventId>";
+        readonly helpText: readonly [];
+        readonly arguments: readonly [{
+            readonly name: "eventId";
+            readonly required: true;
+            readonly variadic: false;
+            readonly description: "";
+        }];
+        readonly options: readonly [{
+            readonly flags: "--from <person|channel>";
+            readonly description: "Source person email/UID or channel name/ID";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--to <person|agent|channel>";
+            readonly description: "Destination person email/UID, agent UID, or channel name/ID";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--note <text>";
+            readonly description: "Optional note to add above the forwarded message";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--note-file <path>";
+            readonly description: "Read the optional forward note from a file";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--grant-files";
+            readonly description: "Grant the recipient access to files they cannot currently open";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--omit-files";
+            readonly description: "Omit files the recipient cannot currently open";
+            readonly hidden: false;
+        }, {
+            readonly flags: "--cross-company";
+            readonly description: "Confirm forwarding across company boundaries";
+            readonly hidden: false;
+        }];
+        readonly subcommands: readonly [];
     }, {
         readonly name: "inbox";
         readonly description: "List your recent incoming direct messages.";
@@ -3673,6 +3718,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--company <slug>";
             readonly description: "Company slug to associate with the report";
             readonly hidden: false;
+        }, {
+            readonly flags: "--reporter <kind>";
+            readonly description: "Mark this bug report as agent-filed (only 'agent' is accepted)";
+            readonly hidden: false;
         }, {
             readonly flags: "--screenshot <path>";
             readonly description: "Attach a screenshot (repeatable, up to 5; .png/.jpg/.jpeg/.webp/.gif)";
@@ -3706,6 +3755,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly flags: "--company <slug>";
             readonly description: "Company slug to associate with the report";
             readonly hidden: false;
+        }, {
+            readonly flags: "--reporter <kind>";
+            readonly description: "Mark this bug report as agent-filed (only 'agent' is accepted)";
+            readonly hidden: false;
         }, {
             readonly flags: "--screenshot <path>";
             readonly description: "Attach a screenshot (repeatable, up to 5; .png/.jpg/.jpeg/.webp/.gif)";

package/dist/command-catalog.generated.js

@@ -2317,7 +2317,7 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--app <app>",
-                        "description": "Run against this app's remote database schema",
+                        "description": "Run against this app's remote database (app id, name or subdomain)",
                         "hidden": false
                     },
                     {
@@ -2434,8 +2434,8 @@ export const COMMAND_CATALOG = [
                         "hidden": false
                     },
                     {
-                        "flags": "--app <name>",
-                        "description": "Show one app: included amounts, use, overage, ceiling and estimated charge",
+                        "flags": "--app <app>",
+                        "description": "App id, name or subdomain. Shows included amounts, use, overage, ceiling and estimated charge",
                         "hidden": false
                     }
                 ],
@@ -2459,7 +2459,7 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--app <app>",
-                        "description": "App id",
+                        "description": "App id, name or subdomain",
                         "hidden": false
                     },
                     {
@@ -2493,17 +2493,17 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--app <app>",
-                        "description": "App id",
+                        "description": "App id, name or subdomain",
                         "hidden": false
                     },
                     {
                         "flags": "--confirm <app>",
-                        "description": "Type the app id again to confirm (required when not interactive)",
+                        "description": "Type the same --app value again to confirm (required when not interactive)",
                         "hidden": false
                     },
                     {
                         "flags": "--yes",
-                        "description": "Skip the dump question; the app id confirmation is still required",
+                        "description": "Skip the dump question; the confirmation is still required",
                         "hidden": false
                     },
                     {
@@ -4001,22 +4001,22 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--prompt <text>",
-                        "description": "Agent-context prompt the recipient can one-click copy into their agent (1:1 DMs only)",
+                        "description": "Agent-context prompt the recipient can one-click copy into their agent (1:1 DMs; channel sends also supported)",
                         "hidden": false
                     },
                     {
                         "flags": "--prompt-file <path>",
-                        "description": "Read the agent prompt from a file (1:1 DMs only)",
+                        "description": "Read the agent prompt from a file (1:1 DMs; channel sends also supported)",
                         "hidden": false
                     },
                     {
                         "flags": "--details <text>",
-                        "description": "Longer detail shown in the recipient's DM detail window (1:1 DMs only)",
+                        "description": "Longer detail shown in the recipient's DM detail window (1:1 DMs; channel sends also supported)",
                         "hidden": false
                     },
                     {
                         "flags": "--details-file <path>",
-                        "description": "Read the details from a file (1:1 DMs only)",
+                        "description": "Read the details from a file (1:1 DMs; channel sends also supported)",
                         "hidden": false
                     },
                     {
@@ -4037,6 +4037,62 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "forward",
+                "description": "Forward a DM or channel message through the existing send routes.",
+                "aliases": [],
+                "hidden": false,
+                "helpOption": true,
+                "helpCommand": false,
+                "usage": "[options] <eventId>",
+                "helpText": [],
+                "arguments": [
+                    {
+                        "name": "eventId",
+                        "required": true,
+                        "variadic": false,
+                        "description": ""
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--from <person|channel>",
+                        "description": "Source person email/UID or channel name/ID",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--to <person|agent|channel>",
+                        "description": "Destination person email/UID, agent UID, or channel name/ID",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--note <text>",
+                        "description": "Optional note to add above the forwarded message",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--note-file <path>",
+                        "description": "Read the optional forward note from a file",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--grant-files",
+                        "description": "Grant the recipient access to files they cannot currently open",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--omit-files",
+                        "description": "Omit files the recipient cannot currently open",
+                        "hidden": false
+                    },
+                    {
+                        "flags": "--cross-company",
+                        "description": "Confirm forwarding across company boundaries",
+                        "hidden": false
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "inbox",
                 "description": "List your recent incoming direct messages.",
@@ -4442,6 +4498,11 @@ export const COMMAND_CATALOG = [
                         "description": "Company slug to associate with the report",
                         "hidden": false
                     },
+                    {
+                        "flags": "--reporter <kind>",
+                        "description": "Mark this bug report as agent-filed (only 'agent' is accepted)",
+                        "hidden": false
+                    },
                     {
                         "flags": "--screenshot <path>",
                         "description": "Attach a screenshot (repeatable, up to 5; .png/.jpg/.jpeg/.webp/.gif)",
@@ -4482,6 +4543,11 @@ export const COMMAND_CATALOG = [
                         "description": "Company slug to associate with the report",
                         "hidden": false
                     },
+                    {
+                        "flags": "--reporter <kind>",
+                        "description": "Mark this bug report as agent-filed (only 'agent' is accepted)",
+                        "hidden": false
+                    },
                     {
                         "flags": "--screenshot <path>",
                         "description": "Attach a screenshot (repeatable, up to 5; .png/.jpg/.jpeg/.webp/.gif)",

package/dist/commands/anywhere-runtime-flag.js

@@ -1,5 +1,5 @@
 import { resolveFlagGate, resolveProcessFlagGate } from "../lib/flag-registry.js";
-import { HQ_ANYWHERE_RUNTIME_FLAG } from "../lib/anywhere-runtime-flag-key.js";
+import { HQ_ANYWHERE_RUNTIME_FLAG, hqAnywhereRuntimeLocallyDisabled } from "../lib/anywhere-runtime-flag-key.js";
 export { HQ_ANYWHERE_RUNTIME_FLAG };
 export class AnywhereRuntimeDisabledError extends Error {
     expected = true;
@@ -9,8 +9,10 @@ export class AnywhereRuntimeDisabledError extends Error {
     }
 }
 export function anywhereRuntimeEnabled(env = process.env) {
-    const fallback = () => false;
-    const lookup = { fallback: false };
+    if (hqAnywhereRuntimeLocallyDisabled(env))
+        return false;
+    const fallback = () => true;
+    const lookup = { fallback: true };
     return env === process.env
         ? resolveProcessFlagGate(HQ_ANYWHERE_RUNTIME_FLAG, lookup, fallback)
         : resolveFlagGate(undefined, HQ_ANYWHERE_RUNTIME_FLAG, lookup, fallback, env);

package/dist/commands/db-destroy.js

@@ -6,7 +6,7 @@ import * as readline from "node:readline";
 import { safeErrorMessage } from "../lib/db/redact.js";
 import { isPlanGateError } from "../utils/plan-gate-error.js";
 import { dumpAppDatabase, describeSessionGap } from "./db-dump.js";
-import { controlPlaneClient, defaultRemoteDeps, describeRemoteError, } from "./db-remote-deps.js";
+import { controlPlaneClient, defaultRemoteDeps, describeRemoteError, resolveAppId, } from "./db-remote-deps.js";
 const NOT_ADMIN = "Only company owners and admins can destroy an app database.";
 async function defaultCheckRole(deps, companyUid) {
     if (process.env.HQ_DB_MOCK_CONTROL_PLANE === "1")
@@ -60,9 +60,9 @@ export function registerDbDestroyCommand(db, depsFactory = defaultRemoteDeps, io
     db.command("destroy")
         .description("Permanently delete an app's remote database (owners and admins only; cannot be undone)")
         .requiredOption("--company <slug>", "Company slug")
-        .requiredOption("--app <app>", "App id")
-        .option("--confirm <app>", "Type the app id again to confirm (required when not interactive)")
-        .option("--yes", "Skip the dump question; the app id confirmation is still required")
+        .requiredOption("--app <app>", "App id, name or subdomain")
+        .option("--confirm <app>", "Type the same --app value again to confirm (required when not interactive)")
+        .option("--yes", "Skip the dump question; the confirmation is still required")
         .option("--dump-first", "Run hq db dump before destroying (non-interactive)")
         .option("--no-dump", "Do not dump before destroying (non-interactive)")
         .option("--out <file>", "Dump output file (default: <app>.sql)")
@@ -86,17 +86,19 @@ export function registerDbDestroyCommand(db, depsFactory = defaultRemoteDeps, io
                 fail(NOT_ADMIN);
                 return;
             }
-            console.error(chalk.yellow(`Warning: this deletes the database for app ${app} in ${resolved.companySlug} immediately. It cannot be undone.`));
+            const appId = await resolveAppId(deps, resolved.companySlug, app);
+            const label = appId === app ? app : `${app} (${appId})`;
+            console.error(chalk.yellow(`Warning: this deletes the database for app ${label} in ${resolved.companySlug} immediately. It cannot be undone.`));
             let confirmed = opts.confirm;
             if (confirmed === undefined) {
                 if (!interactive) {
                     fail(`Confirmation required. Re-run with --confirm ${app}.`);
                     return;
                 }
-                confirmed = await io.ask(`Type the app id (${app}) to confirm: `);
+                confirmed = await io.ask(`Type the app (${app}) to confirm: `);
             }
-            if (confirmed.trim() !== app) {
-                fail("The confirmation did not match the app id. Nothing was deleted.");
+            if (confirmed.trim() !== app && confirmed.trim() !== appId) {
+                fail("The confirmation did not match the app. Nothing was deleted.");
                 return;
             }
             let dumpFirst = opts.dumpFirst === true;
@@ -115,7 +117,7 @@ export function registerDbDestroyCommand(db, depsFactory = defaultRemoteDeps, io
                 try {
                     const summary = await dumpAppDatabase(deps, {
                         companyUid: resolved.companyUid,
-                        appId: app,
+                        appId,
                         out: opts.out,
                     });
                     console.log(`Wrote ${summary.tables} table(s) and ${summary.rows} row(s) to ${summary.outPath}.`);
@@ -129,10 +131,10 @@ export function registerDbDestroyCommand(db, depsFactory = defaultRemoteDeps, io
             }
             const result = await controlPlaneClient(deps).destroyApp({
                 companyUid: resolved.companyUid,
-                appId: app,
+                appId,
             });
             const what = result.mode === "schema" ? "schema and roles dropped" : "database cluster deleted";
-            console.log(`Destroyed the database for app ${app}: ${what}.`);
+            console.log(`Destroyed the database for app ${label}: ${what}.`);
         }
         catch (error) {
             if (isPlanGateError(error))

package/dist/commands/db-dump.js

@@ -6,7 +6,7 @@ import fs from "node:fs";
 import { safeErrorMessage } from "../lib/db/redact.js";
 import { dumpRemoteSchema, openRemoteAppConnection } from "../lib/db/remote-engine.js";
 import { isPlanGateError } from "../utils/plan-gate-error.js";
-import { defaultRemoteDeps, describeRemoteError, remoteEngineDeps, } from "./db-remote-deps.js";
+import { defaultRemoteDeps, describeRemoteError, remoteEngineDeps, resolveAppId, } from "./db-remote-deps.js";
 export function describeSessionGap(error) {
     const status = error.status;
     if (status === 404 || status === 405) {
@@ -34,7 +34,7 @@ export function registerDbDumpCommand(db, depsFactory = defaultRemoteDeps) {
     db.command("dump")
         .description("Export an app's remote database schema and data to a SQL file")
         .requiredOption("--company <slug>", "Company slug")
-        .requiredOption("--app <app>", "App id")
+        .requiredOption("--app <app>", "App id, name or subdomain")
         .option("--out <file>", "Output file (default: <app>.sql)")
         .action(async (opts) => {
         try {
@@ -42,7 +42,7 @@ export function registerDbDumpCommand(db, depsFactory = defaultRemoteDeps) {
             const resolved = await deps.resolveCompany(String(opts.company ?? "").trim());
             const summary = await dumpAppDatabase(deps, {
                 companyUid: resolved.companyUid,
-                appId: opts.app,
+                appId: await resolveAppId(deps, resolved.companySlug, String(opts.app ?? "")),
                 out: opts.out,
             });
             console.log(`Wrote ${summary.tables} table(s) and ${summary.rows} row(s) to ${summary.outPath}.`);

package/dist/commands/db-remote-deps.d.ts

@@ -6,11 +6,14 @@ export interface DbRemoteCommandDeps {
         companySlug: string;
     }>;
     getAccessToken: () => Promise<string>;
+    /** Turn an app id, name or subdomain into the app id, within one company. */
+    resolveApp?: (companySlug: string, ref: string) => Promise<string>;
     apiBaseUrl: string;
     fetchImpl?: typeof fetch;
     engine?: Partial<Pick<RemoteEngineDeps, "tokenFactory" | "clientFactory" | "provider">>;
 }
 export declare function defaultRemoteDeps(): DbRemoteCommandDeps;
+export declare function resolveAppId(deps: DbRemoteCommandDeps, companySlug: string, ref: string): Promise<string>;
 export declare function controlPlaneClient(deps: DbRemoteCommandDeps): ControlPlaneDbClient;
 export declare function remoteEngineDeps(deps: DbRemoteCommandDeps): RemoteEngineDeps;
 /** Plain-language message for a failed remote call, or null when the error is not recognized. */

package/dist/commands/db-remote-deps.js

@@ -2,6 +2,7 @@ import { ControlPlaneDbClient } from "../lib/db/control-plane.js";
 import { controlPlaneCredentialProvider, } from "../lib/db/remote-engine.js";
 import { DEFAULT_VAULT_API_URL, ensureCognitoToken, } from "../utils/cognito-session.js";
 import { getCompanyUid } from "../utils/vault-api.js";
+import { AppRefError, resolveAppRef } from "../lib/db/app-ref.js";
 export function defaultRemoteDeps() {
     return {
         async resolveCompany(slug) {
@@ -17,12 +18,22 @@ export function defaultRemoteDeps() {
                 return "mock-token";
             return ensureCognitoToken({ interactive: false });
         },
+        async resolveApp(companySlug, ref) {
+            if (process.env.HQ_DB_MOCK_CONTROL_PLANE === "1")
+                return ref;
+            const token = await ensureCognitoToken({ interactive: false });
+            return resolveAppRef({ token, companySlug, ref });
+        },
         apiBaseUrl: process.env.HQ_VAULT_API_URL ||
             process.env.HQ_API_BASE_URL ||
             process.env.HQ_CLOUD_API_URL ||
             DEFAULT_VAULT_API_URL,
     };
 }
+export async function resolveAppId(deps, companySlug, ref) {
+    const trimmed = ref.trim();
+    return deps.resolveApp ? deps.resolveApp(companySlug, trimmed) : trimmed;
+}
 export function controlPlaneClient(deps) {
     return new ControlPlaneDbClient({
         baseUrl: deps.apiBaseUrl,
@@ -39,6 +50,8 @@ export function remoteEngineDeps(deps) {
 }
 /** Plain-language message for a failed remote call, or null when the error is not recognized. */
 export function describeRemoteError(error) {
+    if (error instanceof AppRefError)
+        return error.message;
     const status = error.status;
     const code = error.code;
     if (code === "REMOTE_DB_NOT_AVAILABLE" || status === 501) {

package/dist/commands/db-sql.js

@@ -11,7 +11,7 @@ import { safeErrorMessage } from "../lib/db/redact.js";
 import { formatRemoteResults, openRemoteAppConnection, runRemoteSql, } from "../lib/db/remote-engine.js";
 import { formatSqlResult, runLocalSql } from "../lib/db/sql.js";
 import { isPlanGateError } from "../utils/plan-gate-error.js";
-import { defaultRemoteDeps, describeRemoteError, remoteEngineDeps, } from "./db-remote-deps.js";
+import { defaultRemoteDeps, describeRemoteError, remoteEngineDeps, resolveAppId, } from "./db-remote-deps.js";
 import { describeSessionGap } from "./db-dump.js";
 function readSqlArg(sqlArgs, stdinFlag) {
     if (stdinFlag || sqlArgs.length === 0) {
@@ -26,7 +26,7 @@ export function registerDbSqlCommand(db, remoteDepsFactory = defaultRemoteDeps)
     db.command("sql")
         .description("Run SQL against the company vault DB (local) or an app's remote database (--app); read-only by default")
         .requiredOption("--company <slug>", "Company slug (tenant scope; required)")
-        .option("--app <app>", "Run against this app's remote database schema")
+        .option("--app <app>", "Run against this app's remote database (app id, name or subdomain)")
         .option("--write", "Allow write/DDL statements (discouraged for ad-hoc DDL)", false)
         .addOption(new Option("--remote", "Remote SQL is not available in this CLI build yet; local queries work without --remote").hideHelp())
         .option("--db-path <path>", "Dangerous: open a non-canonical DB path (denied unless --allow-cross-company-path)")
@@ -75,9 +75,10 @@ export function registerDbSqlCommand(db, remoteDepsFactory = defaultRemoteDeps)
 }
 async function runRemote(deps, company, app, sql, write) {
     const resolved = await deps.resolveCompany(company);
+    const appId = await resolveAppId(deps, resolved.companySlug, app);
     const conn = await openRemoteAppConnection(remoteEngineDeps(deps), {
         companyUid: resolved.companyUid,
-        appId: app,
+        appId,
     });
     try {
         console.log(formatRemoteResults(await runRemoteSql(conn, sql, write)));

package/dist/commands/db-usage.js

@@ -5,12 +5,12 @@ import chalk from "chalk";
 import { safeErrorMessage } from "../lib/db/redact.js";
 import { formatAppUsageResponse, formatUsage } from "../lib/db/usage-format.js";
 import { isPlanGateError } from "../utils/plan-gate-error.js";
-import { controlPlaneClient, defaultRemoteDeps, describeRemoteError, } from "./db-remote-deps.js";
+import { controlPlaneClient, defaultRemoteDeps, describeRemoteError, resolveAppId, } from "./db-remote-deps.js";
 export function registerDbUsageCommand(db, depsFactory = defaultRemoteDeps) {
     db.command("usage")
         .description("Show this month's remote database usage. With --app: included, used, overage, ceiling and the estimated charge for one app")
         .requiredOption("--company <slug>", "Company slug")
-        .option("--app <name>", "Show one app: included amounts, use, overage, ceiling and estimated charge")
+        .option("--app <app>", "App id, name or subdomain. Shows included amounts, use, overage, ceiling and estimated charge")
         .action(async (opts) => {
         try {
             const deps = depsFactory();
@@ -18,7 +18,8 @@ export function registerDbUsageCommand(db, depsFactory = defaultRemoteDeps) {
             const client = controlPlaneClient(deps);
             const app = String(opts.app ?? "").trim();
             if (app) {
-                console.log(formatAppUsageResponse(await client.appUsage(resolved.companyUid, app)));
+                const appId = await resolveAppId(deps, resolved.companySlug, app);
+                console.log(formatAppUsageResponse(await client.appUsage(resolved.companyUid, appId)));
             }
             else {
                 console.log(formatUsage(await client.usage(resolved.companyUid)));

package/dist/commands/dm-forward-flag.d.ts

@@ -0,0 +1,4 @@
+export declare const DM_FORWARD_CLI_FLAG = "dm.forward-cli";
+/** Forwarding and channel details stay available unless the kill switch is off. */
+export declare function dmForwardCliEnabled(): boolean;
+//# sourceMappingURL=dm-forward-flag.d.ts.map

package/dist/commands/dm-forward-flag.js

@@ -0,0 +1,7 @@
+import { resolveProcessFlagGate } from "../lib/flag-registry.js";
+export const DM_FORWARD_CLI_FLAG = "dm.forward-cli";
+/** Forwarding and channel details stay available unless the kill switch is off. */
+export function dmForwardCliEnabled() {
+    return resolveProcessFlagGate(DM_FORWARD_CLI_FLAG, { fallback: true }, () => true);
+}
+//# sourceMappingURL=dm-forward-flag.js.map

package/dist/commands/dm.d.ts

@@ -226,6 +226,13 @@ export interface DmThreadMessage {
     audience?: DmAudience;
     attachments?: DmAttachment[];
     attachment?: DmAttachment;
+    forwardedFrom?: ForwardedFrom;
+}
+export interface ForwardedFrom {
+    senderUid?: string;
+    senderName?: string;
+    sourceKind?: "dm" | "group" | "channel";
+    originalCreatedAt?: string;
 }
 /** One channel/group message from GET /v1/notify/channels/{id}/messages. */
 export interface ChannelMessageItem {
@@ -240,6 +247,7 @@ export interface ChannelMessageItem {
     rootEventId?: string;
     attachments?: DmAttachment[];
     attachment?: DmAttachment;
+    forwardedFrom?: ForwardedFrom;
 }
 /**
  * One file attached to a DM (US-007 `attachments[]` on the read endpoints). The