@indigoai-us/hq-cli 5.322.0 → 5.324.0

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

@@ -96,10 +96,10 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly description: "Install a package. Sources: bare slug (registry, Cognito-gated), @scope/name[@ver] (npm pack), git URL[#ref], or local path.";
         readonly aliases: readonly [];
         readonly hidden: false;
-        readonly usage: "[options] <source>";
+        readonly usage: "[options] [source]";
         readonly arguments: readonly [{
             readonly name: "source";
-            readonly required: true;
+            readonly required: false;
             readonly variadic: false;
         }];
         readonly options: readonly [{
@@ -114,6 +114,18 @@ export declare const COMMAND_CATALOG: readonly [{
         }, {
             readonly flags: "--branch";
             readonly description: "Follow a ref instead of SHA-pinning (git content-pack flow)";
+        }, {
+            readonly flags: "--global";
+            readonly description: "Install HQ into an agent runtime at user scope (requires the hq-anywhere-runtime flag)";
+        }, {
+            readonly flags: "--runtime <runtime>";
+            readonly description: "Runtime for --global (claude | codex)";
+        }, {
+            readonly flags: "--dry-run";
+            readonly description: "With --global: print every file and config diff without writing";
+        }, {
+            readonly flags: "--hq-root <dir>";
+            readonly description: "With --global: HQ checkout to install from (default: walk up from cwd)";
         }];
         readonly subcommands: readonly [];
     }, {
@@ -368,10 +380,10 @@ export declare const COMMAND_CATALOG: readonly [{
     readonly description: "Install a package. Sources: bare slug (registry, Cognito-gated), @scope/name[@ver] (npm pack), git URL[#ref], or local path.";
     readonly aliases: readonly [];
     readonly hidden: false;
-    readonly usage: "[options] <source>";
+    readonly usage: "[options] [source]";
     readonly arguments: readonly [{
         readonly name: "source";
-        readonly required: true;
+        readonly required: false;
         readonly variadic: false;
     }];
     readonly options: readonly [{
@@ -386,6 +398,18 @@ export declare const COMMAND_CATALOG: readonly [{
     }, {
         readonly flags: "--branch";
         readonly description: "Follow a ref instead of SHA-pinning (git content-pack flow)";
+    }, {
+        readonly flags: "--global";
+        readonly description: "Install HQ into an agent runtime at user scope (requires the hq-anywhere-runtime flag)";
+    }, {
+        readonly flags: "--runtime <runtime>";
+        readonly description: "Runtime for --global (claude | codex)";
+    }, {
+        readonly flags: "--dry-run";
+        readonly description: "With --global: print every file and config diff without writing";
+    }, {
+        readonly flags: "--hq-root <dir>";
+        readonly description: "With --global: HQ checkout to install from (default: walk up from cwd)";
     }];
     readonly subcommands: readonly [];
 }, {
@@ -839,6 +863,79 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly description: "Also report this company's workspace plan state (Starter nag)";
     }];
     readonly subcommands: readonly [];
+}, {
+    readonly name: "link";
+    readonly description: "Link this folder (or its git remote) to an HQ company";
+    readonly aliases: readonly [];
+    readonly hidden: false;
+    readonly usage: "[options] [company]";
+    readonly arguments: readonly [{
+        readonly name: "company";
+        readonly required: false;
+        readonly variadic: false;
+    }];
+    readonly options: readonly [{
+        readonly flags: "--path <dir>";
+        readonly description: "Folder to link (default: current directory)";
+    }, {
+        readonly flags: "--list";
+        readonly description: "Print every linked folder";
+    }, {
+        readonly flags: "--json";
+        readonly description: "Print JSON output";
+    }, {
+        readonly flags: "--seed-manifest <hqRoot>";
+        readonly description: "Seed entries from an HQ companies/manifest.yaml";
+    }];
+    readonly subcommands: readonly [];
+}, {
+    readonly name: "unlink";
+    readonly description: "Remove the HQ company link for this folder";
+    readonly aliases: readonly [];
+    readonly hidden: false;
+    readonly usage: "[options]";
+    readonly arguments: readonly [];
+    readonly options: readonly [{
+        readonly flags: "--path <dir>";
+        readonly description: "Folder to unlink (default: current directory)";
+    }];
+    readonly subcommands: readonly [];
+}, {
+    readonly name: "uninstall";
+    readonly description: "Remove the HQ global install from an agent runtime (use with --global)";
+    readonly aliases: readonly [];
+    readonly hidden: false;
+    readonly usage: "[options]";
+    readonly arguments: readonly [];
+    readonly options: readonly [{
+        readonly flags: "--global";
+        readonly description: "Reverse `hq install --global`";
+    }, {
+        readonly flags: "--runtime <runtime>";
+        readonly description: "Runtime to uninstall from (claude | codex)";
+    }, {
+        readonly flags: "--dry-run";
+        readonly description: "Print what would change without writing";
+    }, {
+        readonly flags: "--hq-root <dir>";
+        readonly description: "HQ checkout (only needed when install state is missing)";
+    }];
+    readonly subcommands: readonly [];
+}, {
+    readonly name: "resolve-company";
+    readonly description: "Print the HQ company linked to this folder (never guesses)";
+    readonly aliases: readonly [];
+    readonly hidden: false;
+    readonly usage: "[options]";
+    readonly arguments: readonly [];
+    readonly options: readonly [{
+        readonly flags: "--path <dir>";
+        readonly description: "Folder to resolve (default: current directory)";
+    }, {
+        readonly flags: "--json";
+        readonly description: "Print JSON output";
+    }];
+    readonly subcommands: readonly [];
 }, {
     readonly name: "version";
     readonly description: "Show HQ, CLI, and latest hq-core versions";
@@ -5932,6 +6029,19 @@ export declare const COMMAND_CATALOG: readonly [{
         }];
         readonly options: readonly [];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "derive-trigger-facts";
+        readonly description: "Build the open fact set for a hook trigger event";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[args...]";
+        readonly arguments: readonly [{
+            readonly name: "args";
+            readonly required: false;
+            readonly variadic: true;
+        }];
+        readonly options: readonly [];
+        readonly subcommands: readonly [];
     }, {
         readonly name: "share-suggestion-state";
         readonly description: "Manage hook share suggestion state";
@@ -9815,6 +9925,25 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Run as a child of this app (only \"desktop\"), which has handed sync over to the daemon";
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "call";
+        readonly description: "Send one request to hqd (policy.check, journal.append, memory.get, memory.put, mesh.presence, …) and print the result as JSON";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options] <op>";
+        readonly arguments: readonly [{
+            readonly name: "op";
+            readonly required: true;
+            readonly variadic: false;
+        }];
+        readonly options: readonly [{
+            readonly flags: "--json <args>";
+            readonly description: "Request args as a JSON object";
+        }, {
+            readonly flags: "--timeout <ms>";
+            readonly description: "Give up after this many milliseconds";
+        }];
+        readonly subcommands: readonly [];
     }, {
         readonly name: "status";
         readonly description: "Show the machine type and each service's state";
@@ -9987,7 +10116,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "restart";
-        readonly description: "Restart one service, or every running service";
+        readonly description: "Restart one service, every service, or the daemon process";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly usage: "[options] [unit]";
@@ -9996,7 +10125,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly required: false;
             readonly variadic: false;
         }];
-        readonly options: readonly [];
+        readonly options: readonly [{
+            readonly flags: "--daemon";
+            readonly description: "Restart the supervisor process itself";
+        }];
         readonly subcommands: readonly [];
     }, {
         readonly name: "trigger";

package/dist/command-catalog.generated.js

@@ -101,11 +101,11 @@ export const COMMAND_CATALOG = [
                 "description": "Install a package. Sources: bare slug (registry, Cognito-gated), @scope/name[@ver] (npm pack), git URL[#ref], or local path.",
                 "aliases": [],
                 "hidden": false,
-                "usage": "[options] <source>",
+                "usage": "[options] [source]",
                 "arguments": [
                     {
                         "name": "source",
-                        "required": true,
+                        "required": false,
                         "variadic": false
                     }
                 ],
@@ -125,6 +125,22 @@ export const COMMAND_CATALOG = [
                     {
                         "flags": "--branch",
                         "description": "Follow a ref instead of SHA-pinning (git content-pack flow)"
+                    },
+                    {
+                        "flags": "--global",
+                        "description": "Install HQ into an agent runtime at user scope (requires the hq-anywhere-runtime flag)"
+                    },
+                    {
+                        "flags": "--runtime <runtime>",
+                        "description": "Runtime for --global (claude | codex)"
+                    },
+                    {
+                        "flags": "--dry-run",
+                        "description": "With --global: print every file and config diff without writing"
+                    },
+                    {
+                        "flags": "--hq-root <dir>",
+                        "description": "With --global: HQ checkout to install from (default: walk up from cwd)"
                     }
                 ],
                 "subcommands": []
@@ -465,11 +481,11 @@ export const COMMAND_CATALOG = [
         "description": "Install a package. Sources: bare slug (registry, Cognito-gated), @scope/name[@ver] (npm pack), git URL[#ref], or local path.",
         "aliases": [],
         "hidden": false,
-        "usage": "[options] <source>",
+        "usage": "[options] [source]",
         "arguments": [
             {
                 "name": "source",
-                "required": true,
+                "required": false,
                 "variadic": false
             }
         ],
@@ -489,6 +505,22 @@ export const COMMAND_CATALOG = [
             {
                 "flags": "--branch",
                 "description": "Follow a ref instead of SHA-pinning (git content-pack flow)"
+            },
+            {
+                "flags": "--global",
+                "description": "Install HQ into an agent runtime at user scope (requires the hq-anywhere-runtime flag)"
+            },
+            {
+                "flags": "--runtime <runtime>",
+                "description": "Runtime for --global (claude | codex)"
+            },
+            {
+                "flags": "--dry-run",
+                "description": "With --global: print every file and config diff without writing"
+            },
+            {
+                "flags": "--hq-root <dir>",
+                "description": "With --global: HQ checkout to install from (default: walk up from cwd)"
             }
         ],
         "subcommands": []
@@ -1073,6 +1105,100 @@ export const COMMAND_CATALOG = [
         ],
         "subcommands": []
     },
+    {
+        "name": "link",
+        "description": "Link this folder (or its git remote) to an HQ company",
+        "aliases": [],
+        "hidden": false,
+        "usage": "[options] [company]",
+        "arguments": [
+            {
+                "name": "company",
+                "required": false,
+                "variadic": false
+            }
+        ],
+        "options": [
+            {
+                "flags": "--path <dir>",
+                "description": "Folder to link (default: current directory)"
+            },
+            {
+                "flags": "--list",
+                "description": "Print every linked folder"
+            },
+            {
+                "flags": "--json",
+                "description": "Print JSON output"
+            },
+            {
+                "flags": "--seed-manifest <hqRoot>",
+                "description": "Seed entries from an HQ companies/manifest.yaml"
+            }
+        ],
+        "subcommands": []
+    },
+    {
+        "name": "unlink",
+        "description": "Remove the HQ company link for this folder",
+        "aliases": [],
+        "hidden": false,
+        "usage": "[options]",
+        "arguments": [],
+        "options": [
+            {
+                "flags": "--path <dir>",
+                "description": "Folder to unlink (default: current directory)"
+            }
+        ],
+        "subcommands": []
+    },
+    {
+        "name": "uninstall",
+        "description": "Remove the HQ global install from an agent runtime (use with --global)",
+        "aliases": [],
+        "hidden": false,
+        "usage": "[options]",
+        "arguments": [],
+        "options": [
+            {
+                "flags": "--global",
+                "description": "Reverse `hq install --global`"
+            },
+            {
+                "flags": "--runtime <runtime>",
+                "description": "Runtime to uninstall from (claude | codex)"
+            },
+            {
+                "flags": "--dry-run",
+                "description": "Print what would change without writing"
+            },
+            {
+                "flags": "--hq-root <dir>",
+                "description": "HQ checkout (only needed when install state is missing)"
+            }
+        ],
+        "subcommands": []
+    },
+    {
+        "name": "resolve-company",
+        "description": "Print the HQ company linked to this folder (never guesses)",
+        "aliases": [],
+        "hidden": false,
+        "usage": "[options]",
+        "arguments": [],
+        "options": [
+            {
+                "flags": "--path <dir>",
+                "description": "Folder to resolve (default: current directory)"
+            },
+            {
+                "flags": "--json",
+                "description": "Print JSON output"
+            }
+        ],
+        "subcommands": []
+    },
     {
         "name": "version",
         "description": "Show HQ, CLI, and latest hq-core versions",
@@ -7633,6 +7759,22 @@ export const COMMAND_CATALOG = [
                 "options": [],
                 "subcommands": []
             },
+            {
+                "name": "derive-trigger-facts",
+                "description": "Build the open fact set for a hook trigger event",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
             {
                 "name": "share-suggestion-state",
                 "description": "Manage hook share suggestion state",
@@ -12645,6 +12787,31 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "call",
+                "description": "Send one request to hqd (policy.check, journal.append, memory.get, memory.put, mesh.presence, …) and print the result as JSON",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <op>",
+                "arguments": [
+                    {
+                        "name": "op",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--json <args>",
+                        "description": "Request args as a JSON object"
+                    },
+                    {
+                        "flags": "--timeout <ms>",
+                        "description": "Give up after this many milliseconds"
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "status",
                 "description": "Show the machine type and each service's state",
@@ -12863,7 +13030,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "restart",
-                "description": "Restart one service, or every running service",
+                "description": "Restart one service, every service, or the daemon process",
                 "aliases": [],
                 "hidden": false,
                 "usage": "[options] [unit]",
@@ -12874,7 +13041,12 @@ export const COMMAND_CATALOG = [
                         "variadic": false
                     }
                 ],
-                "options": [],
+                "options": [
+                    {
+                        "flags": "--daemon",
+                        "description": "Restart the supervisor process itself"
+                    }
+                ],
                 "subcommands": []
             },
             {

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

@@ -177,6 +177,30 @@ export declare const REGISTRATION_PLAN: readonly [{
     readonly parent: "program";
     readonly module: "./commands/whoami.js";
     readonly exportName: "registerWhoamiCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "link";
+    readonly parent: "program";
+    readonly module: "./commands/link.js";
+    readonly exportName: "registerLinkCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "unlink";
+    readonly parent: "program";
+    readonly module: "./commands/link.js";
+    readonly exportName: "registerUnlinkCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "uninstall";
+    readonly parent: "program";
+    readonly module: "./commands/install-global.js";
+    readonly exportName: "registerUninstallCommand";
+}, {
+    readonly type: "registrar";
+    readonly root: "resolve-company";
+    readonly parent: "program";
+    readonly module: "./commands/link.js";
+    readonly exportName: "registerResolveCompanyCommand";
 }, {
     readonly type: "registrar";
     readonly root: "version";

package/dist/command-registration-plan.js

@@ -32,6 +32,10 @@ export const REGISTRATION_PLAN = [
     { type: "registrar", root: "login", parent: "program", module: "./commands/login.js", exportName: "registerLoginCommand" },
     { type: "registrar", root: "logout", parent: "program", module: "./commands/logout.js", exportName: "registerLogoutCommand" },
     { type: "registrar", root: "whoami", parent: "program", module: "./commands/whoami.js", exportName: "registerWhoamiCommand" },
+    { type: "registrar", root: "link", parent: "program", module: "./commands/link.js", exportName: "registerLinkCommand" },
+    { type: "registrar", root: "unlink", parent: "program", module: "./commands/link.js", exportName: "registerUnlinkCommand" },
+    { type: "registrar", root: "uninstall", parent: "program", module: "./commands/install-global.js", exportName: "registerUninstallCommand" },
+    { type: "registrar", root: "resolve-company", parent: "program", module: "./commands/link.js", exportName: "registerResolveCompanyCommand" },
     { type: "registrar", root: "version", parent: "program", module: "./commands/version.js", exportName: "registerVersionCommand" },
     { type: "registrar", root: "auth", parent: "program", module: "./commands/auth.js", exportName: "registerAuthCommands" },
     { type: "registrar", root: "secrets", parent: "program", module: "./commands/secrets.js", exportName: "registerSecretsCommand" },

package/dist/commands/anywhere-runtime-flag.d.ts

@@ -0,0 +1,9 @@
+/** hq-flags key for the staged HQ Anywhere runtime. The registry default is off. */
+export declare const HQ_ANYWHERE_RUNTIME_FLAG = "hq-anywhere-runtime";
+export declare class AnywhereRuntimeDisabledError extends Error {
+    readonly expected: true;
+    constructor();
+}
+export declare function anywhereRuntimeEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function requireAnywhereRuntime(): void;
+//# sourceMappingURL=anywhere-runtime-flag.d.ts.map

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

@@ -0,0 +1,22 @@
+import { resolveFlagGate, resolveProcessFlagGate } from "../lib/flag-registry.js";
+/** hq-flags key for the staged HQ Anywhere runtime. The registry default is off. */
+export const HQ_ANYWHERE_RUNTIME_FLAG = "hq-anywhere-runtime";
+export class AnywhereRuntimeDisabledError extends Error {
+    expected = true;
+    constructor() {
+        super("HQ Anywhere is not enabled. Enable the hq-anywhere-runtime flag to use this command.");
+        this.name = "AnywhereRuntimeDisabledError";
+    }
+}
+export function anywhereRuntimeEnabled(env = process.env) {
+    const fallback = () => false;
+    const lookup = { fallback: false };
+    return env === process.env
+        ? resolveProcessFlagGate(HQ_ANYWHERE_RUNTIME_FLAG, lookup, fallback)
+        : resolveFlagGate(undefined, HQ_ANYWHERE_RUNTIME_FLAG, lookup, fallback, env);
+}
+export function requireAnywhereRuntime() {
+    if (!anywhereRuntimeEnabled())
+        throw new AnywhereRuntimeDisabledError();
+}
+//# sourceMappingURL=anywhere-runtime-flag.js.map

package/dist/commands/cloud.js

@@ -21,7 +21,8 @@ import { DEFAULT_HQ_ROOT, ensureCognitoToken, buildVaultConfig, } from "../utils
 import { resolveUploadAuthor } from "../utils/upload-author.js";
 import { companyFolderExceedsThreshold, emitNarrowHint, isStrictRefusal, resolveBannerLevel, resolveNarrowHintPresentationLevel, resolveNarrowHintMinBytes, } from "../lib/narrow-hint-banner.js";
 import { beginSyncHealthReport, } from "../utils/client-health.js";
-import { recordFirstWorkBearingSync } from "../lib/first-sync-next-step.js";
+import { isWorkBearingSyncResult, recordFirstWorkBearingSync, } from "../lib/first-sync-next-step.js";
+import { maybeShowCliInviteNudge } from "../lib/cli-invite-nudge.js";
 import { createPlanLimitRefusalTracker, describeRefusedCount, describeRefusedFiles, mergePlanLimitRefusals, renderPlanLimitRefusalLines, trackingProgressRecorder, } from "../lib/billing/plan-limit-refusals.js";
 import { formatPlanGateError, planGateErrorFromVaultError, } from "../utils/plan-gate-error.js";
 import { personalTargetedPushPathsEnabled } from "./personal-targeted-push-flag.js";
@@ -663,7 +664,7 @@ function readActiveCompany(hqRoot) {
  * scope. Returns `undefined` only when no company can be resolved at all (then
  * `sync()` resolves the active company itself and pulls `all`, as before).
  */
-async function resolveCliPullScope(client, companyRef, hqRoot) {
+async function resolveCliPullScope(client, companyRef, hqRoot, onResolvedCompanyUid) {
     const ref = companyRef ?? readActiveCompany(hqRoot);
     if (!ref)
         return undefined;
@@ -676,6 +677,7 @@ async function resolveCliPullScope(client, companyRef, hqRoot) {
         const direct = memberships.find((m) => m.companyUid === ref || m.membershipKey === ref);
         if (direct) {
             companyUid = direct.companyUid;
+            onResolvedCompanyUid?.(companyUid);
             const ent = await client.entity.get(direct.companyUid).catch(() => null);
             if (ent?.slug)
                 slug = ent.slug;
@@ -686,6 +688,7 @@ async function resolveCliPullScope(client, companyRef, hqRoot) {
                 if (ent?.slug === ref) {
                     companyUid = m.companyUid;
                     slug = ent.slug;
+                    onResolvedCompanyUid?.(companyUid);
                     break;
                 }
             }
@@ -1653,6 +1656,7 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
         let journalSlug;
         let pushPaths;
         let pushSlug;
+        let nudgeResolvedCompanyUid;
         if (personal) {
             const client = new VaultClient(vaultConfig);
             targetCompany = await resolveCanonicalPersonUid({
@@ -1685,7 +1689,7 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
         let nowPushPrefixSet;
         if (!personalMode) {
             const scopeClient = new VaultClient(vaultConfig);
-            const pushScope = await resolveCliPullScope(scopeClient, targetCompany, hqRoot);
+            const pushScope = await resolveCliPullScope(scopeClient, targetCompany ?? pushSlug, hqRoot, (companyUid) => { nudgeResolvedCompanyUid = companyUid; });
             nowPushPrefixSet = pushScope?.prefixSet;
         }
         const pushProgressCompany = personalMode ? null : (pushSlug ?? null);
@@ -1741,7 +1745,7 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
         // without burning a sync.
         const narrowHintLevel = resolveBannerLevel();
         let resolvedMode;
-        let resolvedCompanyUid;
+        let resolvedCompanyUid = nudgeResolvedCompanyUid;
         if (!personalMode && targetCompany) {
             try {
                 const client = new VaultClient(vaultConfig);
@@ -1845,6 +1849,21 @@ async function runNowSingle(hqRoot, company, personal, message, onConflict, mode
             throw new SyncExitError(1, { health: "succeeded" });
         }
         console.log(chalk.green("\n✓ Sync now complete"));
+        if (!personalMode &&
+            nudgeResolvedCompanyUid &&
+            (isWorkBearingSyncResult(pushResult) || isWorkBearingSyncResult(pullResult))) {
+            try {
+                await maybeShowCliInviteNudge({
+                    companyUid: nudgeResolvedCompanyUid,
+                    companyRef: pushSlug ?? targetCompany ?? "",
+                    accessToken,
+                });
+            }
+            catch (error) {
+                const errorClass = error instanceof Error ? error.name : "unknown";
+                console.error(`hq: Could not show the teammate invite prompt (${errorClass}); sync is complete.`);
+            }
+        }
     }
     catch (err) {
         if (err instanceof SyncExitError)

package/dist/commands/core-derive-trigger-facts-command.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerCoreDeriveTriggerFactsCommand(core: Command): void;
+//# sourceMappingURL=core-derive-trigger-facts-command.d.ts.map

package/dist/commands/core-derive-trigger-facts-command.js

@@ -0,0 +1,47 @@
+import { resolveLiveRoot } from "../utils/hq-roots.js";
+import { runBundledScript } from "../utils/run-bundled-script.js";
+import { describeCoreCommand } from "./core-command-catalog.js";
+import { coreNativeHookHelpersEnabled } from "./core-native-hook-helpers-flag.js";
+import { DERIVE_TRIGGER_FACTS_ASSET, runDeriveTriggerFacts, } from "./core-derive-trigger-facts-native.js";
+export function registerCoreDeriveTriggerFactsCommand(core) {
+    const liveRoot = () => resolveLiveRoot({ hqRoot: core.opts().hqRoot });
+    const command = core
+        .command("derive-trigger-facts")
+        .description("Build the open fact set for a hook trigger event")
+        .allowUnknownOption()
+        .allowExcessArguments()
+        .helpOption(false)
+        .argument("[args...]")
+        .action(async (args = [], _options, commandContext) => {
+        if (!await coreNativeHookHelpersEnabled()) {
+            const root = liveRoot();
+            const result = runBundledScript({
+                asset: DERIVE_TRIGGER_FACTS_ASSET,
+                args: commandContext.args.length ? commandContext.args : args,
+                cwd: root,
+                hqRoot: root,
+            });
+            if (result.code !== 0)
+                process.exit(result.code);
+            return;
+        }
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        const root = liveRoot();
+        const result = runDeriveTriggerFacts({
+            argv: commandContext.args.length ? commandContext.args : args,
+            stdin: Buffer.concat(chunks).toString("utf8"),
+            cwd: process.cwd(),
+            hqRoot: root,
+        });
+        if (result.stdout.length)
+            process.stdout.write(result.stdout);
+        if (result.stderr.length)
+            process.stderr.write(result.stderr);
+        if (result.code !== 0)
+            process.exit(result.code);
+    });
+    describeCoreCommand(command, { execution: "native", asset: DERIVE_TRIGGER_FACTS_ASSET, root: "live" });
+}
+//# sourceMappingURL=core-derive-trigger-facts-command.js.map