@indigoai-us/hq-cli 5.315.0 → 5.317.0

package/dist/command-catalog.generated.js

@@ -7633,6 +7633,118 @@ export const COMMAND_CATALOG = [
                 "options": [],
                 "subcommands": []
             },
+            {
+                "name": "share-suggestion-state",
+                "description": "Manage hook share suggestion state",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "repo-run-registry",
+                "description": "Coordinate active runs across repositories",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "detect-stale-review-base",
+                "description": "Find stale remote review bases in an HQ root",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "session-journal",
+                "description": "Write and read session journal entries",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "session-project",
+                "description": "Find and update native session projects",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "session-title",
+                "description": "Compute the current session title",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
+            {
+                "name": "session-title-config",
+                "description": "Resolve session title settings",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[args...]",
+                "arguments": [
+                    {
+                        "name": "args",
+                        "required": false,
+                        "variadic": true
+                    }
+                ],
+                "options": [],
+                "subcommands": []
+            },
             {
                 "name": "worktree-gc",
                 "description": "Safely collect old, preserved HQ worktrees",
@@ -10750,6 +10862,10 @@ export const COMMAND_CATALOG = [
                         "flags": "--lane <id>",
                         "description": "Filter by lane id (repeatable)"
                     },
+                    {
+                        "flags": "--lane-ulid <ulid>",
+                        "description": "Filter by lane ULID for internal owner lookup"
+                    },
                     {
                         "flags": "--active",
                         "description": "Include only lanes that are not terminal"
@@ -12943,6 +13059,10 @@ export const COMMAND_CATALOG = [
                         "flags": "--tz <zone>",
                         "description": "IANA timezone for the schedule (default: this computer's)"
                     },
+                    {
+                        "flags": "--quiet",
+                        "description": "Skip owner DMs after successful runs (requires rollout flag)"
+                    },
                     {
                         "flags": "--rm <jobId>",
                         "description": "Remove a scheduled job"

package/dist/commands/bot-jobs.d.ts

@@ -74,6 +74,7 @@ export declare function buildCreateJobBody(input: {
     cron: string;
     timezone: string;
     context?: Record<string, unknown>;
+    quiet?: boolean;
 }): CreateJobInput;
 /** A schedule in plain words, falling back to the raw expression. */
 export declare function describeSchedule(job: BotJobRecord): string;
@@ -81,7 +82,7 @@ export declare function describeSchedule(job: BotJobRecord): string;
 export declare function cronInWords(expr: string): string | null;
 /** "never run yet" / "succeeded 2026-09-15 09:00 UTC". */
 export declare function describeLastRun(job: BotJobRecord): string;
-export declare function formatJobsList(botName: string, jobs: BotJobRecord[]): string;
+export declare function formatJobsList(botName: string, jobs: BotJobRecord[], showQuietOption?: boolean): string;
 /**
  * Turn a jobs-route failure into one plain line.
  *
@@ -113,6 +114,8 @@ export interface BotJobsDeps {
     parseSchedule?: typeof parseScheduleText;
     timezone?: () => string;
     out?: (line: string) => void;
+    /** Test seam for the default-off quiet-job rollout gate. */
+    quietOptionEnabled?: () => boolean | Promise<boolean>;
 }
 export interface BotJobsOptions {
     add?: string;
@@ -121,6 +124,7 @@ export interface BotJobsOptions {
     tz?: string;
     rm?: string;
     json?: boolean;
+    quiet?: boolean;
 }
 export declare function runBotJobs(nameArg: string, opts: BotJobsOptions, deps: BotJobsDeps): Promise<void>;
 export declare function registerBotJobsCommand(bot: Command, deps: BotJobsDeps): void;

package/dist/commands/bot-jobs.js

@@ -21,6 +21,8 @@ import * as path from "node:path";
 import { localJobsClient } from "../lib/bot/local-jobs.js";
 import { BotApiError } from "../lib/bot/api.js";
 import { effectiveBotKind } from "../lib/bot/config.js";
+import { isQuietJobContext, JOB_RUN_OPTIONS_CONTEXT_KEY } from "../lib/bot/job-run.js";
+import { BOT_JOB_QUIET_OPTION_FLAG, botJobQuietOptionEnabled } from "../lib/bot/job-quiet-flag.js";
 // ─── Schedule translation ────────────────────────────────────────────────────
 /** Mirrors hq-pro-agents `MIN_RECURRING_INTERVAL_SECONDS`. */
 export const MIN_RECURRING_INTERVAL_SECONDS = 5 * 60;
@@ -245,7 +247,14 @@ export function buildCreateJobBody(input) {
     assertScheduleWithinFloor(cron);
     return {
         prompt,
-        ...(input.context ? { context: input.context } : {}),
+        ...(input.context || input.quiet
+            ? {
+                context: {
+                    ...(input.context ?? {}),
+                    ...(input.quiet ? { [JOB_RUN_OPTIONS_CONTEXT_KEY]: { quiet: true } } : {}),
+                },
+            }
+            : {}),
         schedule: { kind: "recurring", cron, timezone: input.timezone },
     };
 }
@@ -308,7 +317,7 @@ export function describeLastRun(job) {
     const when = job.lastRunAt ? ` ${job.lastRunAt.slice(0, 16).replace("T", " ")} UTC` : "";
     return `${job.lastStatus ?? "ran"}${when}`;
 }
-export function formatJobsList(botName, jobs) {
+export function formatJobsList(botName, jobs, showQuietOption = false) {
     if (jobs.length === 0) {
         return `${botName} has no scheduled jobs. Add one with: hq bot jobs ${botName} --add "<what to do>" --every "<when>"`;
     }
@@ -318,6 +327,8 @@ export function formatJobsList(botName, jobs) {
         lines.push(`  ${chalk.bold(job.jobId)}${job.status && job.status !== "active" ? chalk.yellow(` (${job.status})`) : ""}`);
         lines.push(`    ${job.prompt.replace(/\s+/g, " ").slice(0, 120)}`);
         lines.push(`    runs ${describeSchedule(job)}`);
+        if (showQuietOption && isQuietJobContext(job.context))
+            lines.push("    delivery: quiet after successful runs");
         lines.push(`    next run: ${job.nextRunAt ? `${job.nextRunAt.slice(0, 16).replace("T", " ")} UTC` : "not scheduled yet"}`);
         lines.push(`    last run: ${describeLastRun(job)}`);
     }
@@ -365,6 +376,7 @@ export async function runBotJobs(nameArg, opts, deps) {
     const kind = effectiveBotKind(config);
     const out = deps.out ?? ((line) => console.log(line));
     const ctx = { botName: name, kind };
+    const quietOptionEnabled = deps.quietOptionEnabled ?? botJobQuietOptionEnabled;
     // The schedule lives with the bot: this bot runs on this computer, so its
     // jobs live in its folder and it fires them itself.
     let client;
@@ -377,6 +389,9 @@ export async function runBotJobs(nameArg, opts, deps) {
     if (opts.add !== undefined && opts.rm !== undefined) {
         refuse("Add a job or remove one, not both in the same command.");
     }
+    if (opts.quiet && opts.add === undefined) {
+        refuse("Use --quiet with --add to set a scheduled job's delivery option.");
+    }
     if (opts.rm !== undefined) {
         const jobId = opts.rm.trim();
         if (!jobId)
@@ -392,6 +407,9 @@ export async function runBotJobs(nameArg, opts, deps) {
         return;
     }
     if (opts.add !== undefined) {
+        if (opts.quiet && !(await quietOptionEnabled())) {
+            refuse(`--quiet requires the ${BOT_JOB_QUIET_OPTION_FLAG} flag, which is currently disabled.`);
+        }
         if (!opts.every && !opts.cron) {
             refuse(`Say how often it should run: --every "every weekday at 9am", or --cron "0 9 * * 1-5".`);
         }
@@ -402,7 +420,7 @@ export async function runBotJobs(nameArg, opts, deps) {
         const schedule = opts.every
             ? parse(opts.every, { hqRoot: config.hqRoot, timezone })
             : { cron: opts.cron, timezone };
-        const body = buildCreateJobBody({ prompt: opts.add, cron: schedule.cron, timezone: schedule.timezone });
+        const body = buildCreateJobBody({ prompt: opts.add, cron: schedule.cron, timezone: schedule.timezone, quiet: opts.quiet });
         const api = await jobsApi();
         let created;
         try {
@@ -429,7 +447,8 @@ export async function runBotJobs(nameArg, opts, deps) {
     catch (err) {
         refuse(jobsErrorMessage(err, ctx));
     }
-    out(opts.json ? JSON.stringify(jobs, null, 2) : formatJobsList(name, jobs));
+    const showQuietOption = await quietOptionEnabled();
+    out(opts.json ? JSON.stringify(jobs, null, 2) : formatJobsList(name, jobs, showQuietOption));
 }
 export function registerBotJobsCommand(bot, deps) {
     bot
@@ -439,6 +458,7 @@ export function registerBotJobsCommand(bot, deps) {
         .option("--every <when>", 'How often, in plain language (e.g. "every weekday at 9am")')
         .option("--cron <expr>", 'How often, as a cron expression (e.g. "0 9 * * 1-5")')
         .option("--tz <zone>", "IANA timezone for the schedule (default: this computer's)")
+        .option("--quiet", "Skip owner DMs after successful runs (requires rollout flag)")
         .option("--rm <jobId>", "Remove a scheduled job")
         .option("--json", "Print machine-readable JSON")
         .action(async (name, opts) => {

package/dist/commands/core-detect-stale-review-base-native.d.ts

@@ -0,0 +1,23 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { HookHelperOutput } from "./core-share-suggestion-state-native.js";
+export declare const DETECT_STALE_REVIEW_BASE_ASSET = "core/scripts/detect-stale-review-base.sh";
+export declare const DETECT_STALE_REVIEW_BASE_HELP: string;
+type GitResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type StaleReviewDependencies = {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    fs?: Pick<typeof fs, "existsSync" | "statSync" | "realpathSync">;
+    runGit?: (args: string[]) => GitResult;
+    scriptDir?: string;
+    scriptPath?: string;
+};
+type DirectoryPathOps = Pick<typeof path, "dirname" | "join">;
+export declare function findHqRootAncestor(root: string, existsSync: (candidate: string) => boolean, pathOps?: DirectoryPathOps): string | undefined;
+export declare function runDetectStaleReviewBase(args: readonly string[], deps: StaleReviewDependencies): HookHelperOutput;
+export {};
+//# sourceMappingURL=core-detect-stale-review-base-native.d.ts.map

package/dist/commands/core-detect-stale-review-base-native.js

@@ -0,0 +1,178 @@
+/** Native port of detect-stale-review-base.sh; only git is an external dependency. */
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+export const DETECT_STALE_REVIEW_BASE_ASSET = "core/scripts/detect-stale-review-base.sh";
+export const DETECT_STALE_REVIEW_BASE_HELP = [
+    "# detect-stale-review-base.sh — find remote-tracking refs in the HQ root that",
+    "# have fallen so far behind local HEAD that a diff/review tool will pick one as",
+    "# its comparison base and try to review the entire tree.",
+    "#",
+    "Background: HQ autosaves one commit per edited file (.claude/hooks/hq-autocommit.sh)",
+    "and is never pushed to a remote (policy hq-root-never-push-remote). An HQ root",
+    "that is itself a git repo with a remote attached therefore accumulates local",
+    "commits the remote-tracking ref never receives. The gap only grows.",
+    "#",
+    "Review tools that auto-select a base branch resolve it from refs/remotes/*.",
+    "Once the gap is large enough that base is effectively \"the empty tree\", so the",
+    "review payload becomes the whole repository instead of the working delta. The",
+    "observed failure (2026-07-28) was a Codex desktop git worker taking SIGTRAP on",
+    "a 108,434-path / 29.2 MB payload built against a remote-tracking ref 22,881",
+    "commits behind local main, retried until the app reached 5.5 GB RSS.",
+    "#",
+    "Codex exposes no configuration for the review base — `review_model` only picks",
+    "the reviewing model, and `auto_review` governs the approval-reviewer subagent,",
+    "not code review. `codex review --base` is per-invocation and does not reach the",
+    "desktop app's automatic review. Removing the stale ref is therefore the only",
+    "lever available on the HQ side: with nothing stale to resolve, there is no",
+    "whole-tree base to pick.",
+    "#",
+    "Modes:",
+    "  (default)  human-readable report; exit 0.",
+    "  --json     machine-readable JSON array; exit 0.",
+    "  --check    exit 0 if clean, 1 if any stale base exists (advisory gate).",
+    "  --fix      delete the offending remote-tracking refs; print each action.",
+    "#",
+    "--fix deletes ONLY refs under refs/remotes/. It never touches refs/heads/,",
+    "never removes a configured remote, never fetches, and never pushes. The",
+    "deletion is recoverable: `git fetch <remote>` recreates the ref (and, on an HQ",
+    "root, recreates this condition — HQ roots are not meant to be fetched).",
+    "#",
+    "Thresholds (override with flags or env):",
+    "  --max-paths N    changed paths tolerated vs. a base   (default 5000)",
+    "  --max-commits N  commits ahead tolerated vs. a base   (default 1000)",
+    "A ref is stale when EITHER threshold is exceeded. Path count is the primary",
+    "signal: it is what determines the review payload size.",
+].map((line) => line === "#" || line.startsWith("# ") ? line : `# ${line}`).join("\n") + "\n\n";
+function shellTrim(value) { return value.replace(/\n+$/, ""); }
+export function findHqRootAncestor(root, existsSync, pathOps = path) {
+    let ancestor = pathOps.dirname(root);
+    while (ancestor) {
+        const parent = pathOps.dirname(ancestor);
+        if (parent === ancestor)
+            break;
+        if (existsSync(pathOps.join(ancestor, "core/core.yaml")))
+            return ancestor;
+        ancestor = parent;
+    }
+    return undefined;
+}
+export function runDetectStaleReviewBase(args, deps) {
+    const f = deps.fs ?? fs, env = deps.env ?? process.env;
+    const runGit = deps.runGit ?? ((argv) => {
+        const result = spawnSync("git", argv, { cwd: deps.cwd, env, encoding: "utf8" });
+        return { code: result.status ?? (result.signal ? 128 : 1), stdout: result.stdout ?? "", stderr: result.stderr ?? "" };
+    });
+    let mode = "report", maxPaths = env.HQ_REVIEW_BASE_MAX_PATHS ?? "5000", maxCommits = env.HQ_REVIEW_BASE_MAX_COMMITS ?? "1000", override = "";
+    for (let index = 0; index < args.length;) {
+        const arg = args[index];
+        if (arg === "--json") {
+            mode = "json";
+            index += 1;
+        }
+        else if (arg === "--check") {
+            mode = "check";
+            index += 1;
+        }
+        else if (arg === "--fix") {
+            mode = "fix";
+            index += 1;
+        }
+        else if (arg === "--max-paths" || arg === "--max-commits" || arg === "--root") {
+            const value = args[index + 1];
+            if (value === undefined || value === "") {
+                const line = arg === "--max-paths" ? 54 : arg === "--max-commits" ? 55 : 56;
+                return { code: 1, stdout: "", stderr: `${deps.scriptPath ?? "detect-stale-review-base.sh"}: line ${line}: 2: ${arg} needs a value\n` };
+            }
+            if (arg === "--max-paths")
+                maxPaths = value;
+            else if (arg === "--max-commits")
+                maxCommits = value;
+            else
+                override = value;
+            index += 2;
+        }
+        else if (arg === "-h" || arg === "--help")
+            return { code: 0, stdout: DETECT_STALE_REVIEW_BASE_HELP, stderr: "" };
+        else
+            return { code: 2, stdout: "", stderr: `detect-stale-review-base: unknown argument: ${arg}\nusage: ${deps.scriptPath ?? "detect-stale-review-base.sh"} [--json|--check|--fix] [--max-paths N] [--max-commits N] [--root PATH]\n` };
+    }
+    if (!/^\d+$/.test(maxPaths))
+        return { code: 2, stdout: "", stderr: "detect-stale-review-base: --max-paths must be a non-negative integer\n" };
+    if (!/^\d+$/.test(maxCommits))
+        return { code: 2, stdout: "", stderr: "detect-stale-review-base: --max-commits must be a non-negative integer\n" };
+    const scriptDir = deps.scriptDir ?? path.join(deps.cwd, "core/scripts");
+    let root = override || env.HQ_ROOT || env.CLAUDE_PROJECT_DIR || path.resolve(scriptDir, "../..");
+    if (!f.existsSync(root))
+        return { code: 2, stdout: "", stderr: `detect-stale-review-base: no such directory: ${root}\n` };
+    try {
+        root = f.realpathSync(root);
+    }
+    catch {
+        root = path.resolve(root);
+    }
+    const emitClean = (why) => ({ code: 0, stdout: mode === "json" ? "[]\n" : mode === "check" ? "" : mode === "fix" ? `detect-stale-review-base: nothing to fix (${why})\n` : `detect-stale-review-base: clean (${why})\n`, stderr: "" });
+    if (!f.existsSync(path.join(root, "core/core.yaml")))
+        return { code: 2, stdout: "", stderr: `detect-stale-review-base: ${root} is not an HQ root (no core/core.yaml)\n` };
+    const ancestor = findHqRootAncestor(root, (candidate) => f.existsSync(candidate));
+    if (ancestor)
+        return { code: 2, stdout: "", stderr: `detect-stale-review-base: ${root} is nested inside the HQ root ${ancestor} — refusing. Working clones and worktree checkouts keep their remote-tracking refs; this tool only repairs a top-level HQ install.\n` };
+    const git = (...argv) => runGit(["-C", root, ...argv]);
+    const top = git("rev-parse", "--show-toplevel");
+    if (top.code !== 0 || shellTrim(top.stdout) !== root)
+        return emitClean("HQ root is not a git repository — no review base to go stale");
+    if (git("rev-parse", "--verify", "-q", "HEAD").code !== 0)
+        return emitClean("HQ root has no commits yet");
+    const refsResult = git("for-each-ref", "--format=%(refname)", "refs/remotes");
+    const refs = refsResult.code === 0 ? shellTrim(refsResult.stdout) : "";
+    if (!refs)
+        return emitClean("no remote-tracking refs in the HQ root");
+    const maxP = Number(maxPaths), maxC = Number(maxCommits), stale = [];
+    for (const ref of refs.split("\n")) {
+        if (!ref)
+            continue;
+        if (git("symbolic-ref", "-q", ref).code === 0)
+            continue;
+        const commitResult = git("rev-list", "--count", `${ref}..HEAD`);
+        const commitText = commitResult.code === 0 ? shellTrim(commitResult.stdout) : "";
+        if (!commitText)
+            continue;
+        const commits = Number(commitText);
+        let changedPaths = "";
+        if (commits <= maxC || mode === "json") {
+            const result = git("diff", "--name-only", `${ref}...HEAD`);
+            if (result.code !== 0)
+                return { code: 1, stdout: "", stderr: "" };
+            changedPaths = String((result.stdout.match(/\n/g) ?? []).length);
+        }
+        const paths = Number(changedPaths || 0);
+        if (commits <= maxC && paths <= maxP)
+            continue;
+        stale.push({ ref, commits, paths });
+    }
+    if (!stale.length)
+        return emitClean(`every remote-tracking ref is within ${maxP} paths / ${maxC} commits of HEAD`);
+    if (mode === "json")
+        return { code: 0, stdout: `${JSON.stringify(stale.map((row) => ({ ref: row.ref, commits_ahead: row.commits, changed_paths: row.paths })))}\n`, stderr: "" };
+    if (mode === "check")
+        return { code: 1, stdout: "", stderr: `detect-stale-review-base: ${stale.length} stale review base(s) in ${root}\n` };
+    if (mode === "fix") {
+        const lines = [];
+        for (const row of stale) {
+            const deleted = git("update-ref", "-d", row.ref);
+            if (deleted.code !== 0)
+                return { code: deleted.code, stdout: lines.join(""), stderr: deleted.stderr };
+            lines.push(`detect-stale-review-base: deleted ${row.ref}\n`);
+        }
+        lines.push(`detect-stale-review-base: removed ${stale.length} stale review base(s). A later \`git fetch\` in the HQ root recreates them — HQ roots are not meant to be fetched (policy hq-root-never-push-remote).\n`);
+        return { code: 0, stdout: lines.join(""), stderr: "" };
+    }
+    let out = `detect-stale-review-base: ${stale.length} stale review base(s) in ${root}\n\n`;
+    for (const row of stale) {
+        const commits = git("rev-list", "--count", `${row.ref}..HEAD`), diff = git("diff", "--name-only", `${row.ref}...HEAD`);
+        out += `  ${row.ref} — HEAD is ${shellTrim(commits.stdout) || "?"} commits ahead, ${(diff.stdout.match(/\n/g) ?? []).length} changed paths\n`;
+    }
+    out += "\nA review tool that auto-selects a base will pick one of these and build a\nwhole-tree payload from it. Remove them with:\n\n  bash core/scripts/detect-stale-review-base.sh --fix\n";
+    return { code: 0, stdout: out, stderr: "" };
+}
+//# sourceMappingURL=core-detect-stale-review-base-native.js.map

package/dist/commands/core-hook-state-helpers-native.d.ts

@@ -0,0 +1,11 @@
+/** Shared CLI registrations and fast-route adapters for Wave 8 hook helpers. */
+import type { Command } from "commander";
+import { runShareSuggestionState } from "./core-share-suggestion-state-native.js";
+import { runRepoRunRegistry } from "./core-repo-run-registry-native.js";
+import { runDetectStaleReviewBase } from "./core-detect-stale-review-base-native.js";
+export { runShareSuggestionState, runRepoRunRegistry, runDetectStaleReviewBase };
+export declare function registerCoreHookStateHelpers(core: Command): void;
+export declare function runShareSuggestionStateFast(args: readonly string[], stdin: string, _cwd: string, hqRoot: string | undefined): number;
+export declare function runRepoRunRegistryFast(args: readonly string[], _stdin: string, _cwd: string, hqRoot: string | undefined): number;
+export declare function runDetectStaleReviewBaseFast(args: readonly string[], _stdin: string, _cwd: string, hqRoot: string | undefined): number;
+//# sourceMappingURL=core-hook-state-helpers-native.d.ts.map

package/dist/commands/core-hook-state-helpers-native.js

@@ -0,0 +1,74 @@
+import { resolveBundledAsset, 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 { runShareSuggestionState, SHARE_SUGGESTION_STATE_ASSET } from "./core-share-suggestion-state-native.js";
+import { runRepoRunRegistry, REPO_RUN_REGISTRY_ASSET } from "./core-repo-run-registry-native.js";
+import { runDetectStaleReviewBase, DETECT_STALE_REVIEW_BASE_ASSET } from "./core-detect-stale-review-base-native.js";
+export { runShareSuggestionState, runRepoRunRegistry, runDetectStaleReviewBase };
+const definitions = [
+    { name: "share-suggestion-state", asset: SHARE_SUGGESTION_STATE_ASSET, summary: "Manage hook share suggestion state", run: (args, stdin, _cwd, root) => runShareSuggestionState(args, stdin, { root, cwd: root, env: process.env, stdinIsTty: process.stdin.isTTY }) },
+    { name: "repo-run-registry", asset: REPO_RUN_REGISTRY_ASSET, summary: "Coordinate active runs across repositories", run: (args, _stdin, _cwd, root) => runRepoRunRegistry(args, { root, cwd: root, env: process.env, runShellFallback: (fallbackArgs) => {
+                const { code } = runBundledScript({ asset: REPO_RUN_REGISTRY_ASSET, args: [...fallbackArgs], cwd: root, hqRoot: root });
+                return { code, stdout: "", stderr: "" };
+            } }) },
+    { name: "detect-stale-review-base", asset: DETECT_STALE_REVIEW_BASE_ASSET, summary: "Find stale remote review bases in an HQ root", run: (args, _stdin, _cwd, root) => runDetectStaleReviewBase(args, { cwd: root, env: { ...process.env, HQ_ROOT: root }, scriptPath: resolveBundledAsset(DETECT_STALE_REVIEW_BASE_ASSET) }) },
+];
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8");
+}
+function writeResult(result) {
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    if (result.code !== 0)
+        process.exitCode = result.code;
+}
+export function registerCoreHookStateHelpers(core) {
+    for (const entry of definitions) {
+        const command = core.command(entry.name).description(entry.summary).allowUnknownOption().allowExcessArguments().helpOption(false).argument("[args...]")
+            .action(async (args = [], _options, cmd) => {
+            const cwd = process.cwd(), hqRootArg = core.opts().hqRoot;
+            const root = resolveLiveRoot(hqRootArg ? { hqRoot: hqRootArg } : {});
+            const operands = cmd.args.length > 0 ? cmd.args : args;
+            if (!await coreNativeHookHelpersEnabled()) {
+                const { code } = runBundledScript({ asset: entry.asset, args: operands, cwd: root, hqRoot: root });
+                if (code !== 0)
+                    process.exitCode = code;
+                return;
+            }
+            const stdin = entry.name === "share-suggestion-state" ? await readStdin() : "";
+            writeResult(await entry.run(operands, stdin, cwd, root));
+        });
+        describeCoreCommand(command, { execution: "native", asset: entry.asset, root: "live" });
+    }
+}
+function writeFast(result) {
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    return result.code;
+}
+export function runShareSuggestionStateFast(args, stdin, _cwd, hqRoot) {
+    const root = hqRoot ?? resolveLiveRoot();
+    return writeFast(runShareSuggestionState(args, stdin, { root, cwd: root, env: process.env, stdinIsTty: process.stdin.isTTY }));
+}
+export function runRepoRunRegistryFast(args, _stdin, _cwd, hqRoot) {
+    const root = hqRoot ?? resolveLiveRoot();
+    return writeFast(runRepoRunRegistry(args, { root, cwd: root, env: process.env, runShellFallback: (fallbackArgs) => {
+            const { code } = runBundledScript({ asset: REPO_RUN_REGISTRY_ASSET, args: [...fallbackArgs], cwd: root, hqRoot: root });
+            return { code, stdout: "", stderr: "" };
+        } }));
+}
+export function runDetectStaleReviewBaseFast(args, _stdin, _cwd, hqRoot) {
+    const root = hqRoot ?? resolveLiveRoot();
+    return writeFast(runDetectStaleReviewBase(args, { cwd: root, env: { ...process.env, HQ_ROOT: root }, scriptPath: resolveBundledAsset(DETECT_STALE_REVIEW_BASE_ASSET) }));
+}
+//# sourceMappingURL=core-hook-state-helpers-native.js.map

package/dist/commands/core-repo-run-registry-native.d.ts

@@ -0,0 +1,19 @@
+/** Native, dependency-light port of repo-run-registry.sh. */
+import * as fs from "node:fs";
+import type { HookHelperOutput } from "./core-share-suggestion-state-native.js";
+export declare const REPO_RUN_REGISTRY_ASSET = "core/scripts/repo-run-registry.sh";
+export type RegistryDependencies = {
+    root: string;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    fs?: Pick<typeof fs, "existsSync" | "statSync" | "readFileSync" | "writeFileSync" | "renameSync" | "mkdirSync" | "rmSync">;
+    now?: () => Date;
+    pid?: number;
+    isPidAlive?: (pid: number) => boolean;
+    hostname?: () => string;
+    sleep?: (milliseconds: number) => void;
+    parseDateEpoch?: (value: string) => number;
+    runShellFallback?: (args: readonly string[]) => HookHelperOutput;
+};
+export declare function runRepoRunRegistry(args: readonly string[], deps: RegistryDependencies): HookHelperOutput;
+//# sourceMappingURL=core-repo-run-registry-native.d.ts.map