@gigaflow/gmux 0.15.0

package/dist/services/auto-summarize.js

@@ -0,0 +1,415 @@
+/**
+ * Auto-summarize: keep the top of `gmux ls` written, without ever making you wait.
+ *
+ * A summary costs a model call (~8s). Ten of them, inline, would turn a 60ms
+ * `gmux ls` into a minute of staring at a cursor — so the foreground command never
+ * runs one. Instead it decides *what* would need summarizing, hands that job to
+ * a DETACHED child process, prints a one-line notice to stderr and exits. The
+ * summaries land in the cache and appear on the next run.
+ *
+ * Three things this module exists to prevent:
+ *
+ * 1. **Blocking.** The child is spawned `detached` with `stdio: "ignore"` and
+ *    unref'd, so it outlives its parent and the parent's event loop drains
+ *    immediately. Nothing is awaited.
+ *
+ * 2. **A stampede.** Five `gmux ls` in a row must not start five summarizers doing
+ *    identical work. A lock file in the cache dir is created with O_EXCL before
+ *    spawning; a lock whose owner is dead — or older than LOCK_STALE_MS — is
+ *    taken over. A short cooldown stops us re-deciding on every invocation.
+ *
+ * 3. **A feedback loop.** The provider is `claude -p`, which itself writes a new
+ *    Claude Code session to disk. If those were eligible targets, gmux
+ *    would summarize its own summarizer forever. `automated` and `sidechain`
+ *    sessions are therefore excluded from the target set — see
+ *    `autoSummarizeCandidates`, which is where that guarantee lives.
+ */
+import { spawn } from "node:child_process";
+import { mkdir, open, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { cacheDir } from "../core/paths.js";
+import { autoSummarizeAllowed, isChildProcess, readConfig } from "./config.js";
+import { defaultSummaryProvider, readSummary, shouldRefresh, summarizeBatch, } from "./summarize.js";
+import { loadRecords } from "./views.js";
+/**
+ * How many recent sessions the background pass keeps summarized.
+ *
+ * This MUST be at least as large as `gmux ls`'s default limit, or the bottom of
+ * the default view is permanently `○` and the feature looks broken — which is
+ * exactly what happened when this was 10 and `gmux ls` showed 20.
+ *
+ * Override with `GMUX_AUTO_SUMMARIZE=<n>`.
+ */
+export const AUTO_SUMMARIZE_LIMIT = 20;
+/**
+ * Hard ceiling on one background pass.
+ *
+ * `gmux ls -n 500` should not fire 500 model calls. Anything beyond this is left
+ * for the next run, and we say so rather than truncating silently.
+ */
+export const MAX_PER_PASS = 50;
+/** A lock older than this belongs to a process that died without cleaning up. */
+export const LOCK_STALE_MS = 10 * 60_000;
+/** Don't re-decide on every invocation; `gmux ls` in a loop should cost nothing. */
+export const COOLDOWN_MS = 60_000;
+/** The hidden CLI command the detached worker runs. It never auto-summarizes itself. */
+export const AUTO_SUMMARIZE_COMMAND = "__auto-summarize";
+export function lockPath() {
+    return join(cacheDir(), "auto-summarize.lock");
+}
+export function statePath() {
+    return join(cacheDir(), "auto-summarize.state.json");
+}
+/** The sessions the running worker is writing right now. Drives the `◐` marker. */
+export function queuePath() {
+    return join(cacheDir(), "auto-summarize.queue.json");
+}
+/** Where a failing background pass leaves its evidence. */
+export function logPath() {
+    return join(cacheDir(), "auto-summarize.log");
+}
+/**
+ * Off via `GMUX_AUTO_SUMMARIZE=0`.
+ *
+ * Background model calls spend tokens. A user who has not opted into that must
+ * be able to say no once, in their shell profile, and be done with it.
+ */
+export function autoSummarizeEnabled(env = process.env) {
+    const raw = env["GMUX_AUTO_SUMMARIZE"];
+    if (raw == null || raw.trim() === "")
+        return true;
+    return !["0", "false", "off", "no"].includes(raw.trim().toLowerCase());
+}
+/**
+ * Every reason the background pass might be off, in one place.
+ *
+ * Three independent "no"s, and any of them is final:
+ *
+ * - the env var — a shell-profile opt-out
+ * - the config — what the user answered in `gmux setup`
+ * - GMUX_CHILD — we are a `gmux` spawned by our own provider
+ *
+ * The last is the one that isn't obvious. `gmux ask`'s provider may run `gmux grep`,
+ * whose postAction hook would start a summarize pass — a model call spawned by a
+ * model call. The lock would absorb most of the damage; this makes it a
+ * non-question.
+ */
+export async function autoSummarizeAllowedNow(env = process.env) {
+    if (!autoSummarizeEnabled(env))
+        return false;
+    if (isChildProcess(env))
+        return false;
+    return autoSummarizeAllowed(await readConfig());
+}
+function processAlive(pid) {
+    if (pid <= 0)
+        return true; // Acquired-but-not-yet-spawned: trust the timestamp.
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM means the process exists but belongs to someone else — still alive.
+        return error.code === "EPERM";
+    }
+}
+/** A lock is stale when its owner is gone, or when it is simply too old. */
+export function isLockStale(lock, now = new Date(), staleMs = LOCK_STALE_MS) {
+    const started = Date.parse(lock.startedAt);
+    if (Number.isNaN(started))
+        return true;
+    if (now.getTime() - started > staleMs)
+        return true;
+    return !processAlive(lock.pid);
+}
+export async function readLock() {
+    try {
+        const parsed = JSON.parse(await readFile(lockPath(), "utf8"));
+        if (typeof parsed?.startedAt !== "string")
+            return null;
+        return { pid: Number(parsed.pid) || 0, startedAt: parsed.startedAt };
+    }
+    catch {
+        return null; // No lock, or an unreadable one: treat as not held.
+    }
+}
+async function writeLock(lock) {
+    await writeFile(lockPath(), JSON.stringify(lock), "utf8");
+}
+async function createLockExclusive(lock) {
+    let handle;
+    try {
+        handle = await open(lockPath(), "wx");
+    }
+    catch {
+        return false; // EEXIST: someone else got there first.
+    }
+    try {
+        await handle.writeFile(JSON.stringify(lock), "utf8");
+        return true;
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Take the lock, or report that someone else holds it.
+ *
+ * The create is O_EXCL, so two `gmux` processes racing cannot both win. A stale
+ * lock is removed and re-created rather than overwritten, so the takeover is
+ * itself a race whose loser backs off instead of double-spawning.
+ */
+export async function acquireLock(now = new Date()) {
+    await mkdir(cacheDir(), { recursive: true });
+    const lock = { pid: 0, startedAt: now.toISOString() };
+    if (await createLockExclusive(lock))
+        return true;
+    const existing = await readLock();
+    if (existing && !isLockStale(existing, now))
+        return false;
+    await rm(lockPath(), { force: true });
+    return createLockExclusive(lock);
+}
+export async function releaseLock() {
+    await rm(lockPath(), { force: true });
+}
+/** Record that we just decided; suppresses the next COOLDOWN_MS worth of checks. */
+export async function noteCheck(now = new Date()) {
+    await mkdir(cacheDir(), { recursive: true });
+    await writeFile(statePath(), JSON.stringify({ lastCheckAt: now.toISOString() }), "utf8");
+}
+export async function inCooldown(now = new Date(), cooldownMs = COOLDOWN_MS) {
+    try {
+        const parsed = JSON.parse(await readFile(statePath(), "utf8"));
+        const last = Date.parse(parsed.lastCheckAt ?? "");
+        if (Number.isNaN(last))
+            return false;
+        return now.getTime() - last < cooldownMs;
+    }
+    catch {
+        return false;
+    }
+}
+/** Publish what the worker is about to write, so the list can mark those rows `◐`. */
+export async function writeQueue(ids, now = new Date()) {
+    await mkdir(cacheDir(), { recursive: true });
+    const queue = { ids: [...ids], startedAt: now.toISOString() };
+    await writeFile(queuePath(), JSON.stringify(queue), "utf8");
+}
+export async function readQueue() {
+    try {
+        const parsed = JSON.parse(await readFile(queuePath(), "utf8"));
+        return Array.isArray(parsed?.ids) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function clearQueue() {
+    await rm(queuePath(), { force: true });
+}
+/**
+ * Sessions being summarized *right now*, for the `◐` marker.
+ *
+ * Guarded by the lock: a queue left behind by a crashed worker would otherwise
+ * mark rows as in-progress forever. No live lock, no in-progress rows.
+ */
+export async function inProgressIds(now = new Date()) {
+    const lock = await readLock();
+    if (!lock || isLockStale(lock, now))
+        return new Set();
+    const queue = await readQueue();
+    return new Set(queue?.ids ?? []);
+}
+/**
+ * The sessions the background pass is allowed to touch.
+ *
+ * THE FEEDBACK-LOOP GUARD. `claude -p` — our own summary provider — writes a
+ * Claude Code session for every summary it produces, flagged `isAutomated`.
+ * Summarizing those would generate more of them, forever, at real token cost.
+ * Sidechains are excluded for the same reason plus a better one: nobody resumes
+ * a subagent transcript.
+ *
+ * Pure. This is the function the anti-loop test pins.
+ */
+export function autoSummarizeCandidates(records, limit = AUTO_SUMMARIZE_LIMIT) {
+    return [...records]
+        .filter((record) => !record.isAutomated && !record.isSidechain)
+        .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+        .slice(0, limit);
+}
+/**
+ * Of the recent, eligible sessions, the ones whose summary is missing or stale.
+ *
+ * Reads the summary cache but calls no model, so tests exercise it for real.
+ */
+export async function selectAutoSummarizeTargets(records, limit = AUTO_SUMMARIZE_LIMIT) {
+    const candidates = autoSummarizeCandidates(records, limit);
+    const needed = await Promise.all(candidates.map(async (record) => shouldRefresh(await readSummary(record), record)));
+    return candidates.filter((_, index) => needed[index] === true);
+}
+/**
+ * Decide whether to kick off a background summarize pass, and if so, do it.
+ *
+ * Never throws and never blocks on a model: every failure path is a silent skip.
+ * A read command must not die because `claude` is missing or a cache file is odd.
+ */
+export async function maybeAutoSummarize(options = {}) {
+    try {
+        return await decide(options);
+    }
+    catch {
+        return { status: "spawn-failed", targets: 0, targetIds: [] };
+    }
+}
+async function decide(options) {
+    const now = options.now ?? new Date();
+    const none = (status) => ({
+        status,
+        targets: 0,
+        targetIds: [],
+    });
+    if (options.enabled === false || !(await autoSummarizeAllowedNow()))
+        return none("disabled");
+    // Cheapest checks first: two small file reads keep a repeated `gmux ls` free.
+    if (options.force !== true && (await inCooldown(now)))
+        return none("cooling-down");
+    const held = await readLock();
+    if (held && !isLockStale(held, now))
+        return none("locked");
+    // A missing model is not an error — it just means no summaries today. Nor is
+    // a null provider: that is `gmux setup`'s "none" being honored.
+    const provider = options.provider ?? (await defaultSummaryProvider());
+    if (!provider || !(await provider.isAvailable()))
+        return none("no-provider");
+    // The window follows what was displayed. With nothing passed (e.g. `gmux show`),
+    // fall back to the default recent window.
+    const records = options.records ?? (await loadRecords({ limit: AUTO_SUMMARIZE_LIMIT }));
+    const limit = Math.max(AUTO_SUMMARIZE_LIMIT, records.length);
+    const all = await selectAutoSummarizeTargets(records, limit);
+    if (all.length === 0) {
+        await noteCheck(now);
+        return none("nothing-to-do");
+    }
+    // Bounded, and never silently: a dropped tail gets picked up next run.
+    const targets = all.slice(0, MAX_PER_PASS);
+    const deferred = all.length - targets.length;
+    if (!(await acquireLock(now)))
+        return none("locked");
+    await noteCheck(now);
+    await writeQueue(targets.map((r) => r.sessionId), now);
+    let pid;
+    try {
+        pid = (options.spawnWorker ?? spawnWorker)();
+    }
+    catch {
+        pid = undefined;
+    }
+    if (pid === undefined) {
+        await releaseLock();
+        await clearQueue();
+        return none("spawn-failed");
+    }
+    await writeLock({ pid, startedAt: now.toISOString() });
+    const plural = targets.length === 1 ? "" : "s";
+    const tail = deferred > 0 ? ` (${deferred} more will follow on the next run)` : "";
+    options.notify?.(`summarizing ${targets.length} session${plural} in the background${tail} — marked \u25d0 below`);
+    return { status: "spawned", targets: targets.length, targetIds: targets.map((r) => r.sessionId) };
+}
+/**
+ * Re-run this same CLI, detached, on the hidden worker command.
+ *
+ * `detached` + `stdio: "ignore"` + `unref()` is the combination that lets the
+ * parent exit at once: detached gives the child its own process group so it
+ * survives the shell reaping the foreground job, ignoring stdio stops it holding
+ * the terminal (or a pipe) open, and unref drops it from the parent's event loop.
+ *
+ * `execArgv` is forwarded so this works under `tsx` (`npm run dev`) as well as
+ * from the built `dist/cli/main.js`.
+ */
+function spawnWorker() {
+    const entry = process.argv[1];
+    if (!entry)
+        return undefined;
+    const child = spawn(process.execPath, [...process.execArgv, entry, AUTO_SUMMARIZE_COMMAND], {
+        detached: true,
+        stdio: "ignore",
+        // Belt and braces: the worker must never auto-summarize, or it would spawn a
+        // grandchild for every summary it writes.
+        env: { ...process.env, GMUX_AUTO_SUMMARIZE: "0" },
+    });
+    child.unref();
+    return child.pid;
+}
+/**
+ * The worker body. Runs in the detached child, holding the lock its parent took.
+ *
+ * Re-selects its own targets rather than trusting a list handed down an argv: by
+ * the time it starts, the parent's view of the store is already stale.
+ */
+export async function runAutoSummarize(provider) {
+    try {
+        // Work the queue its parent published, so `gmux ls -n 50` really does get all
+        // fifty — not just whatever the default window happens to be.
+        const queue = await readQueue();
+        const wanted = new Set(queue?.ids ?? []);
+        // Look up the queued ids across the WHOLE store, with no limit.
+        //
+        // Do not "load the N most recent and filter" — the queue holds human
+        // sessions, while the most recent N of everything is mostly subagent
+        // transcripts, so the filter matches nothing and the pass silently writes
+        // zero summaries. (It did exactly that, once.)
+        const records = await loadRecords(wanted.size > 0 ? { includeSidechains: true, includeAutomated: true } : { limit: AUTO_SUMMARIZE_LIMIT });
+        const targets = wanted.size > 0
+            ? // Re-filter through the guard: a queued id can never smuggle an
+                // automated session past the feedback-loop check.
+                autoSummarizeCandidates(records.filter((r) => wanted.has(r.sessionId)), wanted.size)
+            : await selectAutoSummarizeTargets(records);
+        if (targets.length === 0)
+            return { generated: 0, skipped: 0, failed: [] };
+        const result = await summarizeBatch(targets, provider);
+        if (result.failed.length > 0)
+            await logFailures(result);
+        return result;
+    }
+    catch (error) {
+        await logLine(`pass failed: ${error.message}`);
+        return { generated: 0, skipped: 0, failed: [] };
+    }
+    finally {
+        await clearQueue();
+        await releaseLock();
+    }
+}
+/**
+ * Leave evidence when a background pass fails.
+ *
+ * The worker's stdio is `ignore`d, so without this a broken provider is utterly
+ * silent: summaries just never appear and there is nothing to look at. `gmux doctor`
+ * surfaces the last line of this file.
+ */
+async function logLine(message) {
+    try {
+        await mkdir(cacheDir(), { recursive: true });
+        await writeFile(logPath(), `${new Date().toISOString()}  ${message}\n`, { flag: "a" });
+    }
+    catch {
+        // Logging must never be the thing that breaks the worker.
+    }
+}
+async function logFailures(result) {
+    for (const failure of result.failed.slice(0, 5)) {
+        await logLine(`${failure.sessionId.slice(0, 8)}: ${failure.reason}`);
+    }
+}
+/** The most recent background failure, if any — surfaced by `gmux doctor`. */
+export async function lastAutoSummarizeError() {
+    try {
+        const lines = (await readFile(logPath(), "utf8")).trim().split("\n").filter(Boolean);
+        return lines.at(-1) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=auto-summarize.js.map

package/dist/services/auto-summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-summarize.js","sourceRoot":"","sources":["../../src/services/auto-summarize.ts"],"names":[],"mappings":"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"}

package/dist/services/concurrency.d.ts

@@ -0,0 +1,2 @@
+/** Bounded-parallelism map. Keeps a cold index build from opening 1,100 files at once. */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/services/concurrency.js

@@ -0,0 +1,16 @@
+/** Bounded-parallelism map. Keeps a cold index build from opening 1,100 files at once. */
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        for (;;) {
+            const index = cursor++;
+            if (index >= items.length)
+                return;
+            results[index] = await fn(items[index], index);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/services/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/services/concurrency.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAmB,EACnB,KAAa,EACb,EAA0C;IAE1C,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/E,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/services/config.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Config: the one thing gmux remembers because a human said so.
+ *
+ * Everything else in `~/.cache/gmux` is derived and disposable. This
+ * isn't, which is why it lives under the config dir instead — see core/paths.ts.
+ *
+ * Two rules run through this file:
+ *
+ * 1. **A bad config is not an error.** Unreadable, malformed, or written by a
+ *    future version — all are treated as *absent*. `gmux ls` must not die because
+ *    a JSON file got truncated; it should fall back to the behavior of someone
+ *    who never ran `gmux setup`, which is a behavior that works.
+ * 2. **The env var wins.** `GMUX_SUMMARY_CMD` sat on top before config
+ *    existed, and every script, test and CI job that sets it must keep working
+ *    without being told about a new file.
+ */
+import { type GmuxConfig } from "../core/gmux-types.js";
+import { type GmConfig } from "../core/types.js";
+import { type ProviderSpec } from "./providers.js";
+/** The last-resort provider, unchanged from before config existed. */
+export declare const FALLBACK_COMMAND: readonly string[];
+/** The env var that outranks everything here. */
+export declare const SUMMARY_CMD_ENV = "GMUX_SUMMARY_CMD";
+/**
+ * Set on any `gmux` we spawn ourselves.
+ *
+ * THE RECURSION GUARD. `gmux ask` runs a provider that may run `gmux grep`, and
+ * `gmux grep` would otherwise fire the postAction hook and spawn a summarizer —
+ * from inside a process that a summarizer-adjacent call started. The lock would
+ * absorb most of it; this stops it being a question in the first place.
+ */
+export declare const CHILD_ENV = "GMUX_CHILD";
+export declare function isChildProcess(env?: NodeJS.ProcessEnv): boolean;
+/** The env a spawned provider gets: ours, plus the marker. */
+export declare function childEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function defaultConfig(): GmConfig;
+/** Parse a config blob. Returns null for anything we cannot trust. */
+export declare function parseConfig(raw: string): GmConfig | null;
+/**
+ * Fill in whatever a stored `gmux` block leaves out, from `DEFAULT_GMUX_CONFIG`.
+ *
+ * Never fails on a missing or partial block — older configs have none at all,
+ * and `parseGmuxBlock` above only ever keeps well-typed fields, so what
+ * reaches here is trustworthy as far as it goes.
+ */
+export declare function resolveGmuxConfig(config: GmConfig | null): GmuxConfig;
+/** The config on disk, or null when there isn't a usable one. */
+export declare function readConfig(): Promise<GmConfig | null>;
+/**
+ * True when a config file exists, however broken.
+ *
+ * Distinct from `readConfig() !== null` on purpose: the first-run wizard keys
+ * off *existence*, so a corrupt file doesn't re-launch the wizard on every
+ * single run. It falls back to defaults quietly instead, and `gmux doctor` says so.
+ */
+export declare function configExists(): Promise<boolean>;
+/** Write config through a temp file and a rename, so a kill can't truncate it. */
+export declare function writeConfig(config: GmConfig): Promise<void>;
+/**
+ * Split a command string into argv, honoring quotes and backslash escapes.
+ *
+ * Splitting on whitespace alone was wrong in a way that fails quietly: a
+ * perfectly reasonable `llm -m "model name"` became four arguments with literal
+ * quote characters embedded — `["llm","-m","\"model","name\""]` — and gmux then
+ * spawned a command the user never typed. The wizard invites free-form input, so
+ * "don't type spaces in your arguments" is not a rule we get to have.
+ *
+ * This is not a shell. It handles the quoting a person actually uses in an
+ * answer to a prompt — single quotes, double quotes, backslash escapes — and
+ * deliberately does NOT do expansion, substitution, globbing or operators. The
+ * argv goes to `spawn` without a shell, so there is nothing for those to mean,
+ * and pretending otherwise would invite an injection surface where none exists.
+ *
+ * An unterminated quote closes at end of input rather than throwing: the user is
+ * standing at a prompt, and taking their obvious intent beats an error message
+ * about lexing.
+ */
+export declare function parseCommand(input: string): string[];
+/**
+ * The command to use for summaries, or null for "make no model calls".
+ *
+ * Pure, and takes `detected` rather than probing PATH itself, so the precedence
+ * rule can be tested without a machine that happens to have Claude installed.
+ *
+ * Highest wins:
+ *   1. GMUX_SUMMARY_CMD
+ *   2. config.provider.command
+ *   3. first detected provider
+ *   4. `claude -p`
+ *
+ * Rules 3 and 4 are the pre-config behavior, preserved exactly: someone with no
+ * config file sees no change at all.
+ */
+export declare function resolveSummaryCommand(config: GmConfig | null, env?: NodeJS.ProcessEnv, detected?: ProviderSpec | null): string[] | null;
+/**
+ * The command to use for `gmux ask`, or null for "make no model calls".
+ *
+ * Same precedence, but the catalog's `askArgv` is used where we recognise the
+ * provider — that's the variant permitted to run `gmux grep`.
+ */
+export declare function resolveAskCommand(config: GmConfig | null, env?: NodeJS.ProcessEnv, detected?: ProviderSpec | null): string[] | null;
+/**
+ * Whether background summaries are allowed.
+ *
+ * `GMUX_AUTO_SUMMARIZE=0` is checked by the caller and still wins. This
+ * adds the config answer: a user who said "no" in the wizard has said it once
+ * and for good, and must not be asked again by a token spend they declined.
+ *
+ * No config means yes — the pre-config default.
+ */
+export declare function autoSummarizeAllowed(config: GmConfig | null): boolean;
+/**
+ * Whether a bare `gmux` should drop into the setup wizard.
+ *
+ * Pure, and takes the world as data, because the interesting cases are exactly
+ * the ones you cannot reproduce in a test terminal. Same reason `fzfArgs` is
+ * split from the spawn.
+ *
+ * The TTY and `--json` gates are not politeness — they are non-negotiable #4.
+ * `gmux ls --json` is an interface agents call; a version of it that can block on
+ * a human prompt is a broken interface, whatever it prints.
+ */
+export interface SetupGate {
+    hasConfig: boolean;
+    /** Both stdin and stdout. A wizard needs to ask AND to be seen. */
+    isTty: boolean;
+    isJson: boolean;
+    /** The command commander resolved, e.g. "pick", "ls", "__picker-rows". */
+    commandName: string;
+}
+export declare function shouldRunSetupWizard(gate: SetupGate): boolean;