@indigoai-us/hq-cli 5.300.0 → 5.301.0

package/CHANGELOG.md

@@ -2,8 +2,28 @@
 
 ## [Unreleased]
 
+## [5.301.0] — 2026-10-01
+- `hq meetings transcript` and `hq meetings notes` stop a stalled document download after two minutes and say so, instead of waiting forever.
+
+- Keep `hq access` from reporting a denied vault path as missing or exposing matching paths.
+- Fix self-updates for npm installs whose global prefix contains spaces.
+- `hq files acl companies/<slug>` and `hq files unshare companies/<slug> --with ...` now handle ACL rows at that exact company path instead of treating it as the vault root.
+- Add native hq core job notify and remediate commands behind core-native-jobs, retaining bundled shell companions.
+- Allow owners to disconnect custom Factory connections without installation records, and send the company UID required by the revoked-connection purge endpoint.
+- Fail company provisioning when its initial sync reports per-file upload failures, while retaining the successful upload count in failure details.
+- Treat plan-limited files as initial-sync failures and keep provisioning progress snapshots updated.
+- Preserve story attribution after a message is durably queued by lane admission or an account move.
+- The token usage report accepts `--project-dir <path>` to read one Claude activity folder instead of the default folders.
+
 ## [5.300.0] — 2026-09-30
+- `hq files unshare --with agt_...` removes a grant made to an agent. Before, agent uids were rejected as invalid principals.
 - With the default-off hq-flags gate `files.share-empty-prefix-warning`, `hq files share` warns when a granted prefix has no files. A failed or timed-out list check does not block the grant.
+- Recognize pnpm v11+ global installs and handle Windows drive-path tar archives without waiting for the asynchronous feature-flag snapshot.
+- Self-update failure reports now include the npm error code and a sanitized reason.
+
+### Fixed
+
+- `hq core rebuild-index companies --company <slug>` scopes the generated write to that company (behind the default-off `cli.rebuild-index-company-scope` flag), and `--help` exits without reading or writing company indexes. The unscoped run also ignores orchestrator state tied to another company's PRD.
 
 - Lane messages and resumes that switch project or story attribution now tell the provider which story is active. Reused completion artifacts no longer close the new story.
 - Make signed-out `hq sync` commands fail fast with `hq login` guidance when stdin or stdout is not a terminal, while keeping browser login in a terminal.

package/assets/scaffold/core/scripts/token-usage-report.sh

@@ -5,6 +5,7 @@
 #   scripts/token-usage-report.sh --last 14      # last 14 days
 #   scripts/token-usage-report.sh --since 2026-05-01
 #   scripts/token-usage-report.sh --json         # machine-readable
+#   scripts/token-usage-report.sh --project-dir <path> # read one activity folder
 #
 # Effective tokens weighting (matches weekly rate-limit volume):
 #   input + 5×output + 1.25×cache_creation + 0.1×cache_read
@@ -24,6 +25,14 @@ while [ $# -gt 0 ]; do
     --last) LAST_DAYS="$2"; shift 2 ;;
     --since) SINCE="$2"; shift 2 ;;
     --json) JSON_MODE=1; shift ;;
+    --project-dir)
+      if [ "$#" -lt 2 ] || [ -z "$2" ]; then
+        echo "token-usage-report: --project-dir requires a path" >&2
+        exit 1
+      fi
+      PROJECT_DIR="$2"
+      shift 2
+      ;;
     --compare-windows) shift ;;   # flag, presence triggers compare mode via --before/--after
     --before) COMPARE_BEFORE="$2"; shift 2 ;;
     --after)  COMPARE_AFTER="$2"; shift 2 ;;

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

@@ -1713,7 +1713,7 @@ export declare const COMMAND_CATALOG: readonly [{
         }];
         readonly options: readonly [{
             readonly flags: "--with <principal>";
-            readonly description: "Person uid, email address, group id, or '@all' to remove the grant";
+            readonly description: "Person uid, agent uid, email address, group id, or '@all' to remove the grant";
         }];
         readonly subcommands: readonly [];
     }, {
@@ -5620,13 +5620,26 @@ export declare const COMMAND_CATALOG: readonly [{
         }];
     }, {
         readonly name: "job";
-        readonly description: "Run or inspect one scheduled job";
+        readonly description: "Run, inspect, notify, or remediate one scheduled job";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly usage: "[options] [command]";
         readonly arguments: readonly [];
         readonly options: readonly [];
         readonly subcommands: readonly [{
+            readonly name: "notify";
+            readonly description: "Send a scheduled-job status alert to its owner";
+            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: "probe";
             readonly description: "Check scheduled-job requirements and report readiness";
             readonly aliases: readonly [];
@@ -5639,6 +5652,19 @@ export declare const COMMAND_CATALOG: readonly [{
             }];
             readonly options: readonly [];
             readonly subcommands: readonly [];
+        }, {
+            readonly name: "remediate";
+            readonly description: "Run bounded remediation for a scheduled-job failure";
+            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: "run";
             readonly description: "Run a scheduled job";

package/dist/command-catalog.generated.js

@@ -2185,7 +2185,7 @@ export const COMMAND_CATALOG = [
                 "options": [
                     {
                         "flags": "--with <principal>",
-                        "description": "Person uid, email address, group id, or '@all' to remove the grant"
+                        "description": "Person uid, agent uid, email address, group id, or '@all' to remove the grant"
                     }
                 ],
                 "subcommands": []
@@ -7246,13 +7246,29 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "job",
-                "description": "Run or inspect one scheduled job",
+                "description": "Run, inspect, notify, or remediate one scheduled job",
                 "aliases": [],
                 "hidden": false,
                 "usage": "[options] [command]",
                 "arguments": [],
                 "options": [],
                 "subcommands": [
+                    {
+                        "name": "notify",
+                        "description": "Send a scheduled-job status alert to its owner",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
                     {
                         "name": "probe",
                         "description": "Check scheduled-job requirements and report readiness",
@@ -7269,6 +7285,22 @@ export const COMMAND_CATALOG = [
                         "options": [],
                         "subcommands": []
                     },
+                    {
+                        "name": "remediate",
+                        "description": "Run bounded remediation for a scheduled-job failure",
+                        "aliases": [],
+                        "hidden": false,
+                        "usage": "[args...]",
+                        "arguments": [
+                            {
+                                "name": "args",
+                                "required": false,
+                                "variadic": true
+                            }
+                        ],
+                        "options": [],
+                        "subcommands": []
+                    },
                     {
                         "name": "run",
                         "description": "Run a scheduled job",

package/dist/commands/__fixtures__/access-vault.d.ts

@@ -82,6 +82,8 @@ export interface MakeAccessFixtureOptions {
      * without read on the prefix — the server refuses to enumerate.
      */
     listDenied?: boolean;
+    /** present-denied only: let a test isolate list denial from vend denial. */
+    vendDenied?: boolean;
     /** Deny only the ROOT (prefix "") list — the caller can read the prefix but not enumerate the bucket. */
     rootListDenied?: boolean;
 }

package/dist/commands/__fixtures__/access-vault.js

@@ -93,7 +93,7 @@ export function makeAccessFixture(opts) {
         if (opts.state === "missing") {
             throw attachStatus(new Error("not found (404)"), 404);
         }
-        if (opts.state === "present-denied") {
+        if (opts.state === "present-denied" && opts.vendDenied !== false) {
             throw attachStatus(new Error("caller lacks read on this prefix (403)"), 403);
         }
         return FAKE_VEND;

package/dist/commands/access.d.ts

@@ -122,7 +122,8 @@ export interface RunAccessResult {
     outcome: AccessOutcome;
     path: string;
     company: string;
-    exists: boolean;
+    /** Omitted when an authorization denial leaves vault existence unknown. */
+    exists?: boolean;
     grantor?: AccessGrantor;
     candidates?: string[];
     steps: string[];

package/dist/commands/access.js

@@ -52,7 +52,7 @@ export function formatAccessOutcome(result) {
             lines.push(result.path);
             break;
         case "no-access":
-            lines.push(`The file exists in the vault, but you do not have read access.`);
+            lines.push(`You do not have read access to this path.`);
             lines.push(result.path);
             break;
         case "pending-confirmation":
@@ -236,72 +236,81 @@ export async function runAccess(input) {
     const bucket = entity?.bucketName ?? `hq-vault-cmp-${slug}`;
     const s3 = deps.companyClient({ companyUid: deps.companyUid });
     let listDenied = false;
-    const prefixList = await listKeys(s3, bucket, relative);
-    const exact = prefixList.keys.find((k) => k === relative);
     let key;
-    if (prefixList.denied) {
-        // The server refused to enumerate — the caller has no read on this
-        // prefix. Keep the target as the key so the request rung can still name
-        // it for the grantor.
+    if (vendDenied) {
+        // The caller is denied at the company boundary. Do not use list results to
+        // resolve or disclose matching keys, even if a separate listing succeeds.
         listDenied = true;
         key = relative;
-        steps.push("list: 403 (no-access)");
-    }
-    else if (exact) {
-        key = exact;
-        steps.push("resolve: exact key");
-        steps.push("list: 1 hit");
+        steps.push("list: skipped after vend 403 (no-access)");
     }
     else {
-        const allList = await listKeys(s3, bucket, "");
-        const q = relative.toLowerCase();
-        // A root-list 403 only says the caller cannot enumerate the WHOLE bucket.
-        // The prefix list above succeeded, so fuzzy-match within it first; the
-        // root denial is the verdict only when the readable prefix has no match.
-        const pool = allList.denied ? prefixList.keys : allList.keys;
-        const fuzzy = pool.filter((k) => k.toLowerCase().includes(q));
-        if (allList.denied && fuzzy.length === 0) {
+        const prefixList = await listKeys(s3, bucket, relative);
+        const exact = prefixList.keys.find((k) => k === relative);
+        if (prefixList.denied) {
+            // The server refused to enumerate — the caller has no read on this
+            // prefix. Keep the target as the key so the request rung can still name
+            // it for the grantor.
             listDenied = true;
             key = relative;
             steps.push("list: 403 (no-access)");
         }
-        else if (fuzzy.length === 0) {
-            steps.push("list: 0 hits");
-            const result = finish("never-existed", {
-                path: anchored(relative) || input.target,
-                company: slug,
-                exists: false,
-                steps,
-            }, finishCtx);
-            emit(input, result, log);
-            return result;
-        }
-        else if (fuzzy.length === 1) {
-            key = fuzzy[0];
-            steps.push("resolve: fuzzy (1 hit)");
+        else if (exact) {
+            key = exact;
+            steps.push("resolve: exact key");
             steps.push("list: 1 hit");
         }
         else {
-            const candidates = fuzzy.map(anchored);
-            steps.push(`list: ${fuzzy.length} hits`);
-            let picked = null;
-            if (deps.pick) {
-                picked = await deps.pick(candidates);
+            const allList = await listKeys(s3, bucket, "");
+            const q = relative.toLowerCase();
+            // A root-list 403 only says the caller cannot enumerate the WHOLE bucket.
+            // The prefix list above succeeded, so fuzzy-match within it first; the
+            // root denial is the verdict only when the readable prefix has no match.
+            const pool = allList.denied ? prefixList.keys : allList.keys;
+            const fuzzy = pool.filter((k) => k.toLowerCase().includes(q));
+            if (allList.denied && fuzzy.length === 0) {
+                listDenied = true;
+                key = relative;
+                steps.push("list: 403 (no-access)");
             }
-            if (!picked) {
-                const result = finish("ambiguous", {
-                    path: input.target,
+            else if (fuzzy.length === 0) {
+                steps.push("list: 0 hits");
+                const result = finish("never-existed", {
+                    path: anchored(relative) || input.target,
                     company: slug,
                     exists: false,
-                    candidates,
                     steps,
                 }, finishCtx);
                 emit(input, result, log);
                 return result;
             }
-            const stripped = normalizeTarget(picked, slug);
-            key = stripped;
-            steps.push("resolve: pick");
+            else if (fuzzy.length === 1) {
+                key = fuzzy[0];
+                steps.push("resolve: fuzzy (1 hit)");
+                steps.push("list: 1 hit");
+            }
+            else {
+                const candidates = fuzzy.map(anchored);
+                steps.push(`list: ${fuzzy.length} hits`);
+                let picked = null;
+                if (deps.pick) {
+                    picked = await deps.pick(candidates);
+                }
+                if (!picked) {
+                    const result = finish("ambiguous", {
+                        path: input.target,
+                        company: slug,
+                        exists: false,
+                        candidates,
+                        steps,
+                    }, finishCtx);
+                    emit(input, result, log);
+                    return result;
+                }
+                const stripped = normalizeTarget(picked, slug);
+                key = stripped;
+                steps.push("resolve: pick");
+            }
         }
     }
     const resolvedKey = key;
@@ -524,7 +533,7 @@ export async function runAccess(input) {
     const result = finish(outcome, {
         path: resolvedPath,
         company: slug,
-        exists: true,
+        ...(vendDenied || listDenied ? {} : { exists: true }),
         steps,
         ...(fixed ? { fixed, localPath } : {}),
         ...(grantor ? { grantor } : {}),
@@ -541,7 +550,7 @@ function emit(input, result, log) {
             outcome: result.outcome,
             path: result.path,
             company: result.company,
-            exists: result.exists,
+            ...(result.exists !== undefined ? { exists: result.exists } : {}),
             steps: result.steps,
         };
         if (result.grantor)

package/dist/commands/cloud-provision.js

@@ -32,7 +32,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import * as yaml from "js-yaml";
 import { parseUserYaml } from "../utils/user-yaml-error.js";
-import { share } from "@indigoai-us/hq-cloud";
+import { createSyncProgressRecorder, share, } from "@indigoai-us/hq-cloud";
 import { DEFAULT_HQ_ROOT, DEFAULT_VAULT_API_URL, ensureCognitoToken, buildVaultConfig, } from "../utils/cognito-session.js";
 /** Custom error class so the CLI runner can map to exit codes. */
 export class ProvisionError extends Error {
@@ -421,7 +421,32 @@ async function safeBody(res) {
     }
 }
 // ── Default initial-sync runner (wraps share()) ──────────────────────────────
+const INITIAL_SYNC_ERROR_FIELD_LIMIT = 240;
+function truncateInitialSyncErrorField(value) {
+    return value.length <= INITIAL_SYNC_ERROR_FIELD_LIMIT
+        ? value
+        : `${value.slice(0, INITIAL_SYNC_ERROR_FIELD_LIMIT - 1)}…`;
+}
+class InitialSyncUploadFailureError extends Error {
+    filesUploaded;
+    constructor(filesUploaded, failureCount, firstFailure) {
+        const detail = `${truncateInitialSyncErrorField(firstFailure.path)}: ` +
+            truncateInitialSyncErrorField(firstFailure.message);
+        const failureLabel = failureCount === 1
+            ? "upload failure"
+            : "upload failures";
+        super(`${failureCount} ${failureLabel}; first failure: ${detail}`);
+        this.filesUploaded = filesUploaded;
+        this.name = "InitialSyncUploadFailureError";
+    }
+}
 async function defaultRunInitialSync(args) {
+    let failureCount = 0;
+    let firstFailure;
+    const recordProgress = createSyncProgressRecorder({
+        company: args.slug,
+        phase: "push",
+    });
     const result = await share({
         paths: [companyDirPath(args.hqRoot, args.slug)],
         company: args.slug,
@@ -429,7 +454,25 @@ async function defaultRunInitialSync(args) {
         onConflict: "keep",
         vaultConfig: buildVaultConfig(args.accessToken),
         hqRoot: args.hqRoot,
+        progressRecorder: (event) => {
+            recordProgress(event);
+            if (event.type === "plan-limit") {
+                failureCount += Math.max(1, event.count ?? 0, event.paths?.length ?? 0);
+                firstFailure ??= {
+                    path: event.paths?.[0] ?? "plan limit",
+                    message: event.message ?? "plan limit refused upload",
+                };
+                return;
+            }
+            if (event.type !== "error" || event.diagnostic === true)
+                return;
+            failureCount++;
+            firstFailure ??= { path: event.path, message: event.message };
+        },
     });
+    if (failureCount > 0 && firstFailure) {
+        throw new InitialSyncUploadFailureError(result.filesUploaded, failureCount, firstFailure);
+    }
     return {
         filesUploaded: result.filesUploaded,
         bytesUploaded: result.bytesUploaded,
@@ -654,7 +697,13 @@ export async function provisionCompany(options) {
                 created_entity: createdEntity,
                 manifest_patched: true,
                 config_written: true,
-                initial_sync: { ok: false, error: msg },
+                initial_sync: {
+                    ok: false,
+                    error: msg,
+                    ...(err instanceof InitialSyncUploadFailureError
+                        ? { files_uploaded: err.filesUploaded }
+                        : {}),
+                },
             });
         }
     }

package/dist/commands/core-company-index-scope-flag.d.ts

@@ -0,0 +1,3 @@
+export declare const CORE_COMPANY_INDEX_SCOPE_FLAG = "cli.rebuild-index-company-scope";
+export declare function coreCompanyIndexScopeEnabled(): boolean;
+//# sourceMappingURL=core-company-index-scope-flag.d.ts.map

package/dist/commands/core-company-index-scope-flag.js

@@ -0,0 +1,6 @@
+import { resolveProcessFlagGate } from "../lib/flag-registry.js";
+export const CORE_COMPANY_INDEX_SCOPE_FLAG = "cli.rebuild-index-company-scope";
+export function coreCompanyIndexScopeEnabled() {
+    return resolveProcessFlagGate(CORE_COMPANY_INDEX_SCOPE_FLAG, { fallback: false }, () => false);
+}
+//# sourceMappingURL=core-company-index-scope-flag.js.map

package/dist/commands/core-job-native-utils.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/** Preserve raw argv (including the option terminator) through Commander. */
+export declare function rawJobArgumentsForCommand(command: Command, fallback: string[], raw?: string[]): string[];
+/** Shared gated registration path for each leaf in the singular job group. */
+export declare function registerCoreJobLeaf(group: Command, core: Command, name: string, asset: string, summary: string, run: (args: string[], hqRoot: string) => number, canUseLiveRoot: (args: string[]) => boolean, valueOptions: readonly string[], booleanOptions?: readonly string[]): void;
+//# sourceMappingURL=core-job-native-utils.d.ts.map

package/dist/commands/core-job-native-utils.js

@@ -0,0 +1,80 @@
+import { resolveLiveRoot } from "../utils/hq-roots.js";
+import { runBundledScript } from "../utils/run-bundled-script.js";
+import { describeCoreCommand } from "./core-command-catalog.js";
+import { coreNativeJobsEnabled } from "./core-native-jobs-flag.js";
+/** Preserve raw argv (including the option terminator) through Commander. */
+export function rawJobArgumentsForCommand(command, fallback, raw = process.argv) {
+    const names = [];
+    for (let current = command; current?.parent; current = current.parent) {
+        names.unshift(current.name());
+    }
+    let start = -1;
+    let cursor = 0;
+    for (const name of names) {
+        const index = raw.indexOf(name, cursor);
+        if (index < 0)
+            return command.args.length ? command.args : fallback;
+        cursor = index + 1;
+        start = cursor;
+    }
+    return start >= 0 ? raw.slice(start) : (command.args.length ? command.args : fallback);
+}
+/** Shared gated registration path for each leaf in the singular job group. */
+export function registerCoreJobLeaf(group, core, name, asset, summary, run, canUseLiveRoot, valueOptions, booleanOptions = []) {
+    const command = group.command(name)
+        .description(summary)
+        .helpOption(false)
+        .allowUnknownOption()
+        .allowExcessArguments(true)
+        .argument("[args...]", "Arguments passed to the scaffold helper")
+        .action(async (args, _options, current) => {
+        const argv = rawJobArgumentsForCommand(current, args);
+        const groupHqRoot = core.opts().hqRoot;
+        const hqRoot = canUseLiveRoot(argv)
+            ? resolveLiveRoot({ hqRoot: leafRootOverride(argv, valueOptions, booleanOptions) ?? groupHqRoot })
+            : groupHqRoot ?? "";
+        if (!await coreNativeJobsEnabled()) {
+            const result = runBundledScript({ asset, args: argv, cwd: process.cwd(), hqRoot: hqRoot || undefined });
+            if (result.code !== 0)
+                process.exit(result.code);
+            return;
+        }
+        const result = run(argv, hqRoot);
+        if (result !== 0)
+            process.exit(result);
+    });
+    describeCoreCommand(command, { execution: "native", asset, root: "live" });
+}
+/**
+ * Find a leaf --hq-root without resolving anything until the leaf parser has
+ * had the chance to return its own help or usage error. The option lists are
+ * the same grammar used by the shell and native leaves.
+ */
+function leafRootOverride(argv, valueOptions, booleanOptions) {
+    let root;
+    for (let index = 0; index < argv.length;) {
+        const flag = argv[index];
+        if (flag === "--")
+            return root;
+        if (flag === "--hq-root") {
+            const value = argv[index + 1] ?? "";
+            if (!value)
+                return undefined;
+            root = value;
+            index += 2;
+            continue;
+        }
+        if (valueOptions.includes(flag)) {
+            index += 2;
+            continue;
+        }
+        if (booleanOptions.includes(flag)) {
+            index += 1;
+            continue;
+        }
+        // The preflight parser has already rejected invalid options and operands.
+        return root;
+    }
+    return root;
+}
+//# sourceMappingURL=core-job-native-utils.js.map

package/dist/commands/core-job-native.d.ts

@@ -1,7 +1,5 @@
-/** Native `hq core job <name>` command group. */
+/** Native hq core job command group. */
 import type { Command } from "commander";
-export declare function registerCoreJobNativeCommand(core: Command): void;
-export declare function registerCoreJobCommand(core: Command): void;
-/** Keep eager `core` registration complete while the jobs fast route loads only its own module. */
+/** Register all job leaves on one singular group plus the existing plural group. */
 export declare function registerCoreJobsNativeCommand(core: Command): void;
 //# sourceMappingURL=core-job-native.d.ts.map

package/dist/commands/core-job-native.js

@@ -1,19 +1,15 @@
+import { registerCoreJobNotifyNativeCommand } from "./core-job-notify-native.js";
 import { registerCoreJobProbeCommand } from "./core-job-probe-native.js";
+import { registerCoreJobRemediateNativeCommand } from "./core-job-remediate-native.js";
 import { registerCoreJobRunCommand } from "./core-job-run-native.js";
 import { registerCoreJobsNativeCommand as registerPluralJobsCommand } from "./core-jobs-native.js";
-const JOB_GROUP_DESCRIPTION = "Run or inspect one scheduled job";
-export function registerCoreJobNativeCommand(core) {
-    const job = core.command("job").description(JOB_GROUP_DESCRIPTION);
-    registerCoreJobProbeCommand(job);
-}
-export function registerCoreJobCommand(core) {
-    const job = core.command("job").description(JOB_GROUP_DESCRIPTION);
-    registerCoreJobRunCommand(job);
-}
-/** Keep eager `core` registration complete while the jobs fast route loads only its own module. */
+const JOB_GROUP_DESCRIPTION = "Run, inspect, notify, or remediate one scheduled job";
+/** Register all job leaves on one singular group plus the existing plural group. */
 export function registerCoreJobsNativeCommand(core) {
     const job = core.command("job").description(JOB_GROUP_DESCRIPTION);
+    registerCoreJobNotifyNativeCommand(job, core);
     registerCoreJobProbeCommand(job);
+    registerCoreJobRemediateNativeCommand(job, core);
     registerCoreJobRunCommand(job);
     registerPluralJobsCommand(core);
 }

package/dist/commands/core-job-notify-native.d.ts

@@ -0,0 +1,36 @@
+/** Native TypeScript port of hq-job-notify.sh. */
+import { Command } from "commander";
+type Environment = Record<string, string | undefined>;
+export type JobNotifyProcessResult = {
+    code: number;
+    stdout: string;
+};
+export type JobNotifyRunOptions = {
+    cwd: string;
+    env: Environment;
+    captureStdout: boolean;
+    logPath?: string;
+};
+export type JobNotifyDependencies = {
+    env: Environment;
+    cwd: string;
+    now: () => Date;
+    exists: (file: string) => boolean;
+    readFile: (file: string) => string;
+    mkdir: (directory: string) => void;
+    writeFile: (file: string, content: string) => void;
+    appendFile: (file: string, content: string) => void;
+    chmod: (file: string, mode: number) => void;
+    commandExists: (command: string) => boolean;
+    run: (command: string, args: string[], options: JobNotifyRunOptions) => JobNotifyProcessResult;
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+};
+export declare function defaultJobNotifyDependencies(env?: Environment, cwd?: string): JobNotifyDependencies;
+export declare function runJobNotify(argv: string[], options?: {
+    hqRoot?: string;
+    dependencies?: Partial<JobNotifyDependencies>;
+}): number;
+export declare function registerCoreJobNotifyNativeCommand(group: Command, core: Command): void;
+export {};
+//# sourceMappingURL=core-job-notify-native.d.ts.map