@indigoai-us/hq-cli 5.293.0 → 5.294.0

package/dist/commands/core-handoff-open-steps.js

@@ -0,0 +1,264 @@
+/** Lightweight native handler for the handoff open-steps helper. */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { serializeJqJson } from "../lib/core-utils/jq-json-serializer.js";
+const OPEN_STEPS_UNKNOWN_USAGE = `# hq-core: public
+# handoff-open-steps.sh — list and close next steps across handoff threads
+# (2026-09-07).
+#
+# Handoff threads record next_steps; since 2026-09-07 each carries an \x60id\x60
+# (\x60<thread_id>#<n>\x60) and a \x60status\x60 (open|done|dropped). This script is the
+# closure side: /startwork and /resumework list what is still open instead of
+# re-copying it forward, and a session closes a step when it is actually done.
+#
+# Usage:
+#   handoff-open-steps.sh list [--limit N] [--company <slug>] [--json]
+#   handoff-open-steps.sh close <step-id> [--as done|dropped] [--note "<why>"]
+#   handoff-open-steps.sh reopen <step-id>
+#
+# Threads live in workspace/threads/T-*.json (and archive/**). Closing edits
+# the step in place inside its thread file (only \x60status\x60, \x60closed_at\x60,
+# \x60closed_by\x60, \x60note\x60) and bumps \x60updated_at\x60; nothing else in the thread is
+# touched. Legacy steps without an id are listed with a synthetic id and can be
+# closed the same way (the id is written on first close).
+set -uo pipefail
+HQ_ROOT="\${HQ_ROOT:-\${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "\${BASH_SOURCE[0]}")/../.." && pwd)}}"
+`;
+export function prettyJson(value) {
+    return serializeJqJson(value, "pretty");
+}
+export function compactJson(value) {
+    return serializeJqJson(value, "compact");
+}
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function jqTruthy(value) {
+    return value !== undefined && value !== null && value !== false;
+}
+function listFiles(root, predicate) {
+    const found = [];
+    const visit = (directory) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const file = path.join(directory, entry.name);
+            if (entry.isDirectory())
+                visit(file);
+            else if (entry.isFile() && predicate(file, entry))
+                found.push(file);
+        }
+    };
+    visit(root);
+    return found;
+}
+function sortThreadFilesNewest(files) {
+    return files.sort((left, right) => {
+        const leftMtime = Math.floor(fs.statSync(left).mtimeMs / 1000);
+        const rightMtime = Math.floor(fs.statSync(right).mtimeMs / 1000);
+        if (leftMtime !== rightMtime)
+            return rightMtime - leftMtime;
+        // GNU sort -rn falls back to reverse lexical order for equal numeric keys.
+        return right.localeCompare(left);
+    });
+}
+function normalizedSteps(file, value) {
+    if (!isRecord(value))
+        return undefined;
+    const steps = value.next_steps ?? [];
+    if (!Array.isArray(steps))
+        return undefined;
+    const basename = path.basename(file).replace(/\.json$/, "");
+    const normalized = [];
+    for (let index = 0; index < steps.length; index += 1) {
+        const raw = steps[index];
+        if (typeof raw !== "string" && !isRecord(raw))
+            return undefined;
+        const step = typeof raw === "string" ? { step: raw } : { ...raw };
+        if (!jqTruthy(step.id))
+            step.id = `${basename}#${index + 1}`;
+        if (!jqTruthy(step.status))
+            step.status = "open";
+        delete step.key;
+        normalized.push(step);
+    }
+    return normalized;
+}
+function parseJson(file) {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+}
+export function shellDate(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+export function runHandoffOpenSteps(args, context) {
+    const root = context.root;
+    const threads = path.join(root, "workspace/threads");
+    const argv = [...args];
+    const command = argv[0] || "list";
+    if (argv.length > 0)
+        argv.shift();
+    if (command === "list") {
+        let limitText = "20";
+        let company = "";
+        let json = false;
+        for (let index = 0; index < argv.length;) {
+            const token = argv[index];
+            if (token === "--limit") {
+                limitText = argv[index + 1] ?? "";
+                index += 2;
+            }
+            else if (token === "--company") {
+                company = argv[index + 1] ?? "";
+                index += 2;
+            }
+            else if (token === "--json") {
+                json = true;
+                index += 1;
+            }
+            else
+                index += 1;
+        }
+        const numericLimit = /^-?\d+$/.test(limitText) ? Number(limitText) : Number.NaN;
+        const candidates = sortThreadFilesNewest(listFiles(threads, (file) => {
+            const name = path.basename(file);
+            return /^T-.*\.json$/.test(name) && !name.endsWith(".changeset.json") && !file.split(path.sep).includes("resume-locks");
+        }));
+        let count = 0;
+        const rows = [];
+        for (const file of candidates) {
+            if (!Number.isNaN(numericLimit) && count >= numericLimit)
+                break;
+            count += 1;
+            let thread;
+            let nextSteps;
+            try {
+                thread = parseJson(file);
+                nextSteps = normalizedSteps(file, thread);
+            }
+            catch {
+                continue;
+            }
+            if (!nextSteps || !isRecord(thread))
+                continue;
+            if (company) {
+                const companies = (isRecord(thread.metadata) ? thread.metadata.company : undefined) ?? [];
+                const contains = Array.isArray(companies)
+                    ? companies.includes(company)
+                    : typeof companies === "string" && companies.includes(company);
+                if (!contains)
+                    continue;
+            }
+            for (const step of nextSteps) {
+                if (step.status !== "open")
+                    continue;
+                rows.push({
+                    thread: thread.thread_id,
+                    title: (isRecord(thread.metadata) ? thread.metadata.title : undefined) ?? "",
+                    created: thread.created_at,
+                    id: step.id,
+                    step: step.step ?? null,
+                });
+            }
+        }
+        if (json)
+            return { code: 0, stdout: prettyJson(rows), stderr: "" };
+        if (rows.length === 0)
+            return { code: 0, stdout: `No open handoff steps in the last ${count} thread(s).\n`, stderr: "" };
+        const jqString = (value) => value === null || value === undefined
+            ? "null"
+            : typeof value === "string" ? value : compactJson(value).trimEnd();
+        const output = rows.map((row) => `${jqString(row.id)}  ${jqString(row.step)}  [${jqString(row.title)}]\n`).join("");
+        return { code: 0, stdout: output, stderr: "" };
+    }
+    if (command === "close" || command === "reopen") {
+        const id = argv[0] ?? "";
+        const rest = argv.slice(1);
+        if (!id)
+            return { code: 2, stdout: "", stderr: `usage: ${command} <step-id>\n` };
+        let as = "done";
+        let note = "";
+        for (let index = 0; index < rest.length;) {
+            if (rest[index] === "--as") {
+                as = rest[index + 1] ?? "";
+                index += 2;
+            }
+            else if (rest[index] === "--note") {
+                note = rest[index + 1] ?? "";
+                index += 2;
+            }
+            else
+                index += 1;
+        }
+        if (command === "reopen")
+            as = "open";
+        if (!new Set(["done", "dropped", "open"]).has(as))
+            return { code: 2, stdout: "", stderr: "--as must be done|dropped\n" };
+        const threadId = id.split("#", 1)[0] ?? "";
+        const candidates = listFiles(threads, (file) => path.basename(file) === `${threadId}.json` && !file.split(path.sep).includes("resume-locks"));
+        const file = candidates[0];
+        if (!file)
+            return { code: 3, stdout: "", stderr: `handoff-open-steps: thread ${threadId} not found under ${threads}\n` };
+        const now = shellDate(context.now?.() ?? new Date());
+        const by = process.env.HQ_SESSION_ID || process.env.CLAUDE_SESSION_ID || "unknown-session";
+        let text;
+        try {
+            const thread = parseJson(file);
+            const steps = normalizedSteps(file, thread);
+            if (!steps || !isRecord(thread))
+                throw new Error("Cannot iterate over null (null)");
+            if (!steps.some((step) => step.id === id))
+                throw new Error(`step ${id} not in thread`);
+            const updated = steps.map((step) => {
+                if (step.id !== id)
+                    return step;
+                if (as === "open") {
+                    delete step.closed_at;
+                    delete step.closed_by;
+                    step.status = "open";
+                }
+                else {
+                    step.status = as;
+                    step.closed_at = now;
+                    step.closed_by = by;
+                    if (note !== "")
+                        step.note = note;
+                }
+                return step;
+            });
+            thread.next_steps = updated;
+            thread.updated_at = now;
+            text = prettyJson(thread);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const jqMessage = message.startsWith("step ")
+                ? `jq: error (at <stdin>:1): ${message}`
+                : `jq: error: ${message}`;
+            return { code: 3, stdout: "", stderr: `${jqMessage}\n` };
+        }
+        // jq > file.tmp followed by mv uses the caller's umask for this new inode.
+        const temporary = `${file}.tmp`;
+        fs.writeFileSync(temporary, text);
+        fs.renameSync(temporary, file);
+        return { code: 0, stdout: `handoff-open-steps: ${id} -> ${as}\n`, stderr: "" };
+    }
+    return { code: 2, stdout: OPEN_STEPS_UNKNOWN_USAGE, stderr: "" };
+}
+/** Fast-entry adapter for the lightweight open-steps implementation. */
+export function runHandoffOpenStepsFast(args, _stdin, cwd, hqRoot) {
+    const root = hqRoot ?? cwd;
+    const result = runHandoffOpenSteps([...args], { root, cwd });
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    if (result.code !== 0)
+        process.exitCode = result.code;
+    return result.code;
+}
+//# sourceMappingURL=core-handoff-open-steps.js.map

package/dist/commands/core-handoff.d.ts

@@ -1,5 +1,7 @@
 /** Native implementations of the handoff scaffold command family. */
 import { Command } from "commander";
+import { runHandoffOpenSteps } from "./core-handoff-open-steps.js";
+export { runHandoffOpenSteps };
 type RunResult = {
     code: number;
     stdout: string;
@@ -12,11 +14,11 @@ type HandoffContext = {
     /** Test-only override for the finalizer's historical fixed /tmp paths. */
     tmpDir?: string;
 };
-export declare function runHandoffOpenSteps(args: string[], context: HandoffContext): RunResult;
 export declare function runHandoffFinalize(args: string[], context: HandoffContext): RunResult;
 export declare function runHandoffPost(args: string[], context: HandoffContext): RunResult | Promise<RunResult>;
 export declare function runHandoffPostWorker(args: string[], context: HandoffContext): RunResult;
+/** Fast-entry adapter; the shared family flag is resolved before this module loads. */
+export declare function runHandoffFast(args: readonly string[], _stdin: string, _cwd: string, hqRoot: string | undefined, commandName: string): Promise<number>;
 /** Register native handoff commands behind the shared default-off flag. */
 export declare function registerCoreHandoffCommand(core: Command): void;
-export {};
 //# sourceMappingURL=core-handoff.d.ts.map

package/dist/commands/core-handoff.js

@@ -5,7 +5,6 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { archiveOldThreads } from "../lib/core-utils/archive-old-threads.js";
-import { serializeJqJson } from "../lib/core-utils/jq-json-serializer.js";
 import { summarizeHqStatus } from "../lib/core-utils/hq-status-summary.js";
 import { enqueueSessionEvent } from "../lib/mesh/live/enqueue.js";
 import { renderIndexTarget } from "../lib/index-render/index.js";
@@ -13,7 +12,8 @@ import { defaultBackgroundDependencies, runBackgroundLauncher, } from "../lib/se
 import { resolveLiveRoot } from "../utils/hq-roots.js";
 import { runBundledScript } from "../utils/run-bundled-script.js";
 import { describeCoreCommand } from "./core-command-catalog.js";
-import { coreNativeHandoffEnabled } from "./core-native-handoff-flag.js";
+import { compactJson, isRecord, jqTruthy, prettyJson, runHandoffOpenSteps, shellDate, } from "./core-handoff-open-steps.js";
+export { runHandoffOpenSteps };
 const ASSETS = {
     finalize: "core/scripts/handoff-finalize.sh",
     post: "core/scripts/handoff-post.sh",
@@ -24,28 +24,6 @@ const DESCRIPTIONS = {
     post: "Run best-effort post-handoff maintenance",
     openSteps: "List and update open handoff steps",
 };
-const OPEN_STEPS_UNKNOWN_USAGE = `# hq-core: public
-# handoff-open-steps.sh — list and close next steps across handoff threads
-# (2026-09-07).
-#
-# Handoff threads record next_steps; since 2026-09-07 each carries an \x60id\x60
-# (\x60<thread_id>#<n>\x60) and a \x60status\x60 (open|done|dropped). This script is the
-# closure side: /startwork and /resumework list what is still open instead of
-# re-copying it forward, and a session closes a step when it is actually done.
-#
-# Usage:
-#   handoff-open-steps.sh list [--limit N] [--company <slug>] [--json]
-#   handoff-open-steps.sh close <step-id> [--as done|dropped] [--note "<why>"]
-#   handoff-open-steps.sh reopen <step-id>
-#
-# Threads live in workspace/threads/T-*.json (and archive/**). Closing edits
-# the step in place inside its thread file (only \x60status\x60, \x60closed_at\x60,
-# \x60closed_by\x60, \x60note\x60) and bumps \x60updated_at\x60; nothing else in the thread is
-# touched. Legacy steps without an id are listed with a synthetic id and can be
-# closed the same way (the id is written on first close).
-set -uo pipefail
-HQ_ROOT="\${HQ_ROOT:-\${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "\${BASH_SOURCE[0]}")/../.." && pwd)}}"
-`;
 const SESSION_ID_ENV_KEYS = [
     "HQ_SESSION_ID",
     "CLAUDE_CODE_SESSION_ID",
@@ -173,18 +151,6 @@ function copyClipboardText(value, cwd) {
         return false;
     }
 }
-function prettyJson(value) {
-    return serializeJqJson(value, "pretty");
-}
-function compactJson(value) {
-    return serializeJqJson(value, "compact");
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function jqTruthy(value) {
-    return value !== undefined && value !== null && value !== false;
-}
 function mkdirParent(file) {
     fs.mkdirSync(path.dirname(file), { recursive: true });
 }
@@ -194,219 +160,6 @@ function writeAtomic(file, text, mode) {
     fs.writeFileSync(temporary, text, mode === undefined ? undefined : { mode });
     fs.renameSync(temporary, file);
 }
-function listFiles(root, predicate) {
-    const found = [];
-    const visit = (directory) => {
-        let entries;
-        try {
-            entries = fs.readdirSync(directory, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            const file = path.join(directory, entry.name);
-            if (entry.isDirectory())
-                visit(file);
-            else if (entry.isFile() && predicate(file, entry))
-                found.push(file);
-        }
-    };
-    visit(root);
-    return found;
-}
-function sortThreadFilesNewest(files) {
-    return files.sort((left, right) => {
-        const leftMtime = Math.floor(fs.statSync(left).mtimeMs / 1000);
-        const rightMtime = Math.floor(fs.statSync(right).mtimeMs / 1000);
-        if (leftMtime !== rightMtime)
-            return rightMtime - leftMtime;
-        // GNU sort -rn falls back to reverse lexical order for equal numeric keys.
-        return right.localeCompare(left);
-    });
-}
-function normalizedSteps(file, value) {
-    if (!isRecord(value))
-        return undefined;
-    const steps = value.next_steps ?? [];
-    if (!Array.isArray(steps))
-        return undefined;
-    const basename = path.basename(file).replace(/\.json$/, "");
-    const normalized = [];
-    for (let index = 0; index < steps.length; index += 1) {
-        const raw = steps[index];
-        if (typeof raw !== "string" && !isRecord(raw))
-            return undefined;
-        const step = typeof raw === "string" ? { step: raw } : { ...raw };
-        if (!jqTruthy(step.id))
-            step.id = `${basename}#${index + 1}`;
-        if (!jqTruthy(step.status))
-            step.status = "open";
-        delete step.key;
-        normalized.push(step);
-    }
-    return normalized;
-}
-function parseJson(file) {
-    return JSON.parse(fs.readFileSync(file, "utf8"));
-}
-function shellDate(date) {
-    return date.toISOString().replace(/\.\d{3}Z$/, "Z");
-}
-export function runHandoffOpenSteps(args, context) {
-    const root = context.root;
-    const threads = path.join(root, "workspace/threads");
-    const argv = [...args];
-    const command = argv[0] || "list";
-    if (argv.length > 0)
-        argv.shift();
-    if (command === "list") {
-        let limitText = "20";
-        let company = "";
-        let json = false;
-        for (let index = 0; index < argv.length;) {
-            const token = argv[index];
-            if (token === "--limit") {
-                limitText = argv[index + 1] ?? "";
-                index += 2;
-            }
-            else if (token === "--company") {
-                company = argv[index + 1] ?? "";
-                index += 2;
-            }
-            else if (token === "--json") {
-                json = true;
-                index += 1;
-            }
-            else
-                index += 1;
-        }
-        const numericLimit = /^-?\d+$/.test(limitText) ? Number(limitText) : Number.NaN;
-        const candidates = sortThreadFilesNewest(listFiles(threads, (file) => {
-            const name = path.basename(file);
-            return /^T-.*\.json$/.test(name) && !name.endsWith(".changeset.json") && !file.split(path.sep).includes("resume-locks");
-        }));
-        let count = 0;
-        const rows = [];
-        for (const file of candidates) {
-            if (!Number.isNaN(numericLimit) && count >= numericLimit)
-                break;
-            count += 1;
-            let thread;
-            let nextSteps;
-            try {
-                thread = parseJson(file);
-                nextSteps = normalizedSteps(file, thread);
-            }
-            catch {
-                continue;
-            }
-            if (!nextSteps || !isRecord(thread))
-                continue;
-            if (company) {
-                const companies = (isRecord(thread.metadata) ? thread.metadata.company : undefined) ?? [];
-                const contains = Array.isArray(companies)
-                    ? companies.includes(company)
-                    : typeof companies === "string" && companies.includes(company);
-                if (!contains)
-                    continue;
-            }
-            for (const step of nextSteps) {
-                if (step.status !== "open")
-                    continue;
-                rows.push({
-                    thread: thread.thread_id,
-                    title: (isRecord(thread.metadata) ? thread.metadata.title : undefined) ?? "",
-                    created: thread.created_at,
-                    id: step.id,
-                    step: step.step ?? null,
-                });
-            }
-        }
-        if (json)
-            return { code: 0, stdout: prettyJson(rows), stderr: "" };
-        if (rows.length === 0)
-            return { code: 0, stdout: `No open handoff steps in the last ${count} thread(s).\n`, stderr: "" };
-        const jqString = (value) => value === null || value === undefined
-            ? "null"
-            : typeof value === "string" ? value : compactJson(value).trimEnd();
-        const output = rows.map((row) => `${jqString(row.id)}  ${jqString(row.step)}  [${jqString(row.title)}]\n`).join("");
-        return { code: 0, stdout: output, stderr: "" };
-    }
-    if (command === "close" || command === "reopen") {
-        const id = argv[0] ?? "";
-        const rest = argv.slice(1);
-        if (!id)
-            return { code: 2, stdout: "", stderr: `usage: ${command} <step-id>\n` };
-        let as = "done";
-        let note = "";
-        for (let index = 0; index < rest.length;) {
-            if (rest[index] === "--as") {
-                as = rest[index + 1] ?? "";
-                index += 2;
-            }
-            else if (rest[index] === "--note") {
-                note = rest[index + 1] ?? "";
-                index += 2;
-            }
-            else
-                index += 1;
-        }
-        if (command === "reopen")
-            as = "open";
-        if (!new Set(["done", "dropped", "open"]).has(as))
-            return { code: 2, stdout: "", stderr: "--as must be done|dropped\n" };
-        const threadId = id.split("#", 1)[0] ?? "";
-        const candidates = listFiles(threads, (file) => path.basename(file) === `${threadId}.json` && !file.split(path.sep).includes("resume-locks"));
-        const file = candidates[0];
-        if (!file)
-            return { code: 3, stdout: "", stderr: `handoff-open-steps: thread ${threadId} not found under ${threads}\n` };
-        const now = shellDate(nowFor(context));
-        const by = process.env.HQ_SESSION_ID || process.env.CLAUDE_SESSION_ID || "unknown-session";
-        let text;
-        try {
-            const thread = parseJson(file);
-            const steps = normalizedSteps(file, thread);
-            if (!steps || !isRecord(thread))
-                throw new Error("Cannot iterate over null (null)");
-            if (!steps.some((step) => step.id === id))
-                throw new Error(`step ${id} not in thread`);
-            const updated = steps.map((step) => {
-                if (step.id !== id)
-                    return step;
-                if (as === "open") {
-                    delete step.closed_at;
-                    delete step.closed_by;
-                    step.status = "open";
-                }
-                else {
-                    step.status = as;
-                    step.closed_at = now;
-                    step.closed_by = by;
-                    if (note !== "")
-                        step.note = note;
-                }
-                return step;
-            });
-            thread.next_steps = updated;
-            thread.updated_at = now;
-            text = prettyJson(thread);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            const jqMessage = message.startsWith("step ")
-                ? `jq: error (at <stdin>:1): ${message}`
-                : `jq: error: ${message}`;
-            return { code: 3, stdout: "", stderr: `${jqMessage}\n` };
-        }
-        // jq > file.tmp followed by mv uses the caller's umask for this new inode.
-        const temporary = `${file}.tmp`;
-        fs.writeFileSync(temporary, text);
-        fs.renameSync(temporary, file);
-        return { code: 0, stdout: `handoff-open-steps: ${id} -> ${as}\n`, stderr: "" };
-    }
-    return { code: 2, stdout: OPEN_STEPS_UNKNOWN_USAGE, stderr: "" };
-}
 function isSensitivePath(value) {
     const exceptions = new Set(["core/settings/.gitkeep", "core/settings/pure-ralph.json"]);
     if (exceptions.has(value))
@@ -1331,6 +1084,25 @@ function emitResult(result) {
     if (result.code !== 0)
         process.exit(result.code);
 }
+/** Fast-entry adapter; the shared family flag is resolved before this module loads. */
+export async function runHandoffFast(args, _stdin, _cwd, hqRoot, commandName) {
+    const liveRoot = hqRoot ?? resolveLiveRoot();
+    const context = { root: liveRoot, cwd: liveRoot };
+    const result = await withRootEnvironment(liveRoot, () => {
+        if (commandName === "finalize")
+            return runHandoffFinalize([...args], context);
+        if (commandName === "post")
+            return runHandoffPost([...args], context);
+        return runHandoffOpenSteps([...args], context);
+    });
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    if (result.code !== 0)
+        process.exitCode = result.code;
+    return result.code;
+}
 /** Register native handoff commands behind the shared default-off flag. */
 export function registerCoreHandoffCommand(core) {
     const handoff = core.command("handoff").description("Handoff session helpers");
@@ -1346,6 +1118,7 @@ export function registerCoreHandoffCommand(core) {
             const scope = core.opts();
             const root = resolveLiveRoot({ hqRoot: scope.hqRoot });
             const operands = cmd.args.length > 0 ? cmd.args : args;
+            const { coreNativeHandoffEnabled } = await import("./core-native-handoff-flag.js");
             if (!await coreNativeHandoffEnabled()) {
                 const bundled = runBundledScript({ asset: ASSETS[name === "open-steps" ? "openSteps" : name], args: operands, cwd: root, hqRoot: root });
                 if (bundled.code !== 0)

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

@@ -19,5 +19,7 @@ export type ReconcileOptions = {
 export declare function runReconcile(argv: string[], rootArg?: string, options?: ReconcileOptions): Promise<number>;
 export declare function registerCoreJobsNativeCommand(core: Command): void;
 export declare function rawArgumentsForCommand(command: Command, fallback: string[], raw?: string[]): string[];
+/** Fast-entry adapter; the shared family flag is resolved before this module loads. */
+export declare function runJobsFast(args: readonly string[], _stdin: string, _cwd: string, _liveRoot: string | undefined, commandName: string, hqRootArg: string | undefined): Promise<number>;
 export {};
 //# sourceMappingURL=core-jobs-native.d.ts.map