@elhu/pit 0.1.1

package/dist/commands/daemon.js

@@ -0,0 +1,162 @@
+import * as fs from "node:fs";
+import { loadPitConfig } from "../config.js";
+import { recoverFromPersistedState } from "../daemon/recovery.js";
+import { handleDaemonStart, handleDaemonRun, handleDaemonStop, handleDaemonStatus, handleDaemonRestart, } from "../daemon/lifecycle.js";
+import { PitDaemonServer } from "../daemon/server.js";
+import { createLogger } from "../logger.js";
+import { registerAllHandlers, startHealthCheck, makeClearAndReprompt } from "../daemon/handlers.js";
+import { saveDaemonState } from "../daemon/state.js";
+import { daemonInstallCommand, daemonUninstallCommand } from "../daemon/systemd.js";
+const logger = createLogger();
+async function runDaemon(projectRoot, sessionId, tmuxSession) {
+    const server = new PitDaemonServer({ sessionId, projectRoot, tmuxSession });
+    const fileConfig = loadPitConfig(projectRoot);
+    const pidPath = `/tmp/pit/${sessionId}/daemon.pid`;
+    await fs.promises.writeFile(pidPath, process.pid.toString());
+    const ctx = {
+        daemonState: null,
+        debouncedSaver: null,
+        loopHandles: new Map(),
+        agentInstance: null,
+        daemonStartTime: Date.now(),
+        projectRoot,
+        sessionId,
+        tmuxSession,
+        fileConfig,
+        healthCheckInterval: null,
+    };
+    registerAllHandlers(server, ctx);
+    let isShuttingDown = false;
+    const shutdown = async () => {
+        if (isShuttingDown) {
+            // Force exit on second signal
+            process.exit(1);
+        }
+        isShuttingDown = true;
+        // 1. Stop health check interval
+        if (ctx.healthCheckInterval) {
+            clearInterval(ctx.healthCheckInterval);
+            ctx.healthCheckInterval = null;
+        }
+        // 2. Flush daemon state to disk synchronously (bypass debounce) so recovery works
+        if (ctx.daemonState) {
+            try {
+                await saveDaemonState(ctx.daemonState);
+            }
+            catch {
+                // Best-effort — don't prevent shutdown
+            }
+        }
+        // 3. Close the server socket
+        await server.shutdown("shutdown");
+        // 4. Remove PID file (signals the daemon is dead for liveness checks)
+        await fs.promises.unlink(pidPath).catch((_e) => undefined);
+        // NOTE: We intentionally do NOT rm -rf the session directory here.
+        // daemon-state.json must survive for recoverFromPersistedState() to work.
+        // Only 'pit teardown' should remove the session directory.
+        process.exit(0);
+    };
+    // Single shutdown path for both RPC and signal-triggered shutdowns
+    server.once("shutdown-requested", () => {
+        shutdown().catch(() => process.exit(1));
+    });
+    process.once("SIGTERM", () => {
+        shutdown().catch(() => process.exit(1));
+    });
+    process.once("SIGINT", () => {
+        shutdown().catch(() => process.exit(1));
+    });
+    const clearAndReprompt = makeClearAndReprompt(ctx);
+    await recoverFromPersistedState(ctx, clearAndReprompt);
+    try {
+        await server.start();
+        logger.info("Daemon started", { socketPath: server.getSocketPath() });
+        ctx.healthCheckInterval = startHealthCheck(ctx);
+    }
+    catch (error) {
+        logger.error("Failed to start daemon", { error: String(error) });
+        process.exit(1);
+    }
+}
+export function registerDaemon(program) {
+    const daemonCommand = program.command("daemon").description("Manage the pit daemon service");
+    daemonCommand
+        .command("start")
+        .description("Start the pit daemon")
+        .option("--project-root <path>", "Project root directory")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        const args = opts.projectRoot ? ["--project-root", opts.projectRoot] : [];
+        await handleDaemonStart(args, pretty);
+    });
+    daemonCommand
+        .command("__run")
+        .description("Internal command to run the daemon process")
+        .action(async () => {
+        await handleDaemonRun(runDaemon);
+    });
+    daemonCommand
+        .command("stop")
+        .description("Stop the pit daemon")
+        .option("--pause-epics", "Pause all running epics before stopping daemon")
+        .option("--project-root <path>", "Project root directory")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        await handleDaemonStop(pretty, opts.pauseEpics || false, opts.projectRoot);
+    });
+    daemonCommand
+        .command("status")
+        .description("Check pit daemon status")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        await handleDaemonStatus(pretty);
+    });
+    daemonCommand
+        .command("restart")
+        .description("Restart the pit daemon")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        await handleDaemonRestart([], pretty);
+    });
+    daemonCommand
+        .command("install")
+        .description("Install and enable systemd user service for auto-start")
+        .option("--project-root <path>", "Project root directory")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        try {
+            await daemonInstallCommand({ projectRoot: opts.projectRoot });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (pretty) {
+                console.error(`Error: ${errorMessage}`);
+            }
+            else {
+                console.log(JSON.stringify({ error: errorMessage }));
+            }
+            process.exit(1);
+        }
+    });
+    daemonCommand
+        .command("uninstall")
+        .description("Disable and stop systemd user service")
+        .option("--project-root <path>", "Project root directory")
+        .action(async (opts, cmd) => {
+        const pretty = cmd.parent?.parent?.opts().pretty;
+        try {
+            await daemonUninstallCommand({ projectRoot: opts.projectRoot });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (pretty) {
+                console.error(`Error: ${errorMessage}`);
+            }
+            else {
+                console.log(JSON.stringify({ error: errorMessage }));
+            }
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/commands/daemon.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from "commander";
+export interface InitOutput {
+    file: string;
+    action: "created" | "updated" | "added";
+}
+export declare class InitError extends Error {
+    constructor(message: string);
+}
+/**
+ * Inject orchestrator instructions into the target project's AGENTS.md.
+ *
+ * - If AGENTS.md does not exist, create it with the orchestrator section.
+ * - If it exists but has no pit section, append the section.
+ * - If it already has a pit section (detected by sentinel comments), replace it.
+ *
+ * Returns the action taken: "created", "added", or "updated".
+ */
+export declare function initProject(projectRoot: string): Promise<InitOutput>;
+export declare function registerInit(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CACzC;AAMD,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwD1E;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0CnD"}

package/dist/commands/init.js

@@ -0,0 +1,125 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { printError, printOutput } from "../output.js";
+import { ORCHESTRATOR_INSTRUCTIONS, ORCHESTRATOR_SECTION_START, ORCHESTRATOR_SECTION_END, } from "../orchestrator-instructions-template.js";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Core init logic (exported for testability)
+// ---------------------------------------------------------------------------
+export class InitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InitError";
+    }
+}
+/**
+ * Inject orchestrator instructions into the target project's AGENTS.md.
+ *
+ * - If AGENTS.md does not exist, create it with the orchestrator section.
+ * - If it exists but has no pit section, append the section.
+ * - If it already has a pit section (detected by sentinel comments), replace it.
+ *
+ * Returns the action taken: "created", "added", or "updated".
+ */
+export async function initProject(projectRoot) {
+    const agentsPath = join(projectRoot, "AGENTS.md");
+    let existing;
+    try {
+        existing = await readFile(agentsPath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            existing = null;
+        }
+        else {
+            throw err;
+        }
+    }
+    let content;
+    let action;
+    if (existing === null) {
+        // No AGENTS.md — create one with just the pit section
+        content = ORCHESTRATOR_INSTRUCTIONS;
+        action = "created";
+    }
+    else if (existing.includes(ORCHESTRATOR_SECTION_START)) {
+        // Pit section exists — replace it
+        const startIdx = existing.indexOf(ORCHESTRATOR_SECTION_START);
+        const endIdx = existing.indexOf(ORCHESTRATOR_SECTION_END);
+        if (endIdx === -1) {
+            throw new InitError(`Found ${ORCHESTRATOR_SECTION_START} in AGENTS.md but no matching ${ORCHESTRATOR_SECTION_END} — file may be corrupted`);
+        }
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + ORCHESTRATOR_SECTION_END.length);
+        // Trim trailing newlines from 'before' to avoid blank line accumulation,
+        // then ensure exactly one blank line before the section
+        const trimmedBefore = before.replace(/\n+$/, "");
+        const trimmedAfter = after.replace(/^\n+/, "");
+        const parts = [trimmedBefore, ORCHESTRATOR_INSTRUCTIONS];
+        if (trimmedAfter.length > 0) {
+            parts.push(trimmedAfter);
+        }
+        content = parts.filter((p) => p.length > 0).join("\n\n");
+        // Ensure file ends with a single newline
+        content = content.replace(/\n*$/, "\n");
+        action = "updated";
+    }
+    else {
+        // AGENTS.md exists but no pit section — append
+        const trimmed = existing.replace(/\n+$/, "");
+        content = trimmed + "\n\n" + ORCHESTRATOR_INSTRUCTIONS;
+        // Ensure file ends with a single newline
+        content = content.replace(/\n*$/, "\n");
+        action = "added";
+    }
+    await writeFile(agentsPath, content, "utf-8");
+    return { file: "AGENTS.md", action };
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerInit(program) {
+    program
+        .command("init")
+        .description("Inject pit orchestrator instructions into AGENTS.md")
+        .action(async (_opts, cmd) => {
+        const pretty = (cmd.parent?.opts()).pretty ?? false;
+        // Resolve project root
+        let projectRoot;
+        try {
+            const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"]);
+            projectRoot = stdout.trim();
+        }
+        catch (err) {
+            printError({ error: `Failed to resolve project root: ${err.message}` }, pretty);
+            process.exit(1);
+            return;
+        }
+        let result;
+        try {
+            result = await initProject(projectRoot);
+        }
+        catch (err) {
+            if (err instanceof InitError) {
+                printError({ error: err.message }, pretty);
+                process.exit(1);
+                return;
+            }
+            throw err;
+        }
+        if (pretty) {
+            const verb = result.action === "created"
+                ? "Created AGENTS.md with"
+                : result.action === "updated"
+                    ? "Updated existing"
+                    : "Added";
+            process.stdout.write(`${verb} pit orchestrator instructions in ${result.file}\n`);
+        }
+        else {
+            printOutput(result, false);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/install-keybinding.d.ts

@@ -0,0 +1,61 @@
+import type { Command } from "commander";
+export interface InstalledBinding {
+    key: string;
+    binding: string;
+}
+export interface InstallKeybindingOutput {
+    status: "installed";
+    bindings: InstalledBinding[];
+    note: string;
+}
+/**
+ * Build the tmux bind-key command string for `pit resume`.
+ *
+ * tmux windows are named 'epic-<name>', so we strip the 'epic-' prefix
+ * to derive the epic ID for `pit resume`.
+ *
+ * We use a shell command inside run-shell that invokes sed to strip the
+ * prefix for portability with tmux < 3.1.
+ *
+ * NOTE: tmux >= 3.1 supports a cleaner approach using format substitution:
+ *   bind-key R run-shell 'pit resume #{s/epic-//:window_name}'
+ * When the minimum supported tmux version can be bumped to 3.1+, switch
+ * to that syntax instead.
+ */
+export declare function buildBindKeyCommand(key: string): string;
+/**
+ * Build the run-shell argument portion of the resume bind-key command.
+ * This is the value that gets passed to tmux bind-key directly.
+ */
+export declare function buildRunShellArg(): string;
+/**
+ * Build the tmux bind-key command string for `pit pause`.
+ *
+ * Uses the same epic-name derivation as the resume binding.
+ */
+export declare function buildPauseBindKeyCommand(key: string): string;
+/**
+ * Build the run-shell argument portion of the pause bind-key command.
+ */
+export declare function buildPauseRunShellArg(): string;
+/**
+ * Install the keybindings into the running tmux server.
+ *
+ * Installs two bindings:
+ *   - resumeKey (default R): pit resume <epic>
+ *   - pauseKey  (default H): pit pause  <epic>  (H for Halt)
+ *
+ * Steps:
+ * 1. Check for existing bindings on both keys and warn if there are conflicts.
+ * 2. Apply both bindings via `tmux bind-key`.
+ *
+ * Note: bind-key is SERVER-GLOBAL, not session-scoped. The binding applies
+ * to all tmux sessions on this server. If the user presses a key in a
+ * non-pit window, the pit command will fail with EPIC_NOT_FOUND (graceful failure).
+ */
+export declare function installKeybinding(resumeKey: string, pauseKey: string): Promise<{
+    output: InstallKeybindingOutput;
+    warnings: string[];
+}>;
+export declare function registerInstallKeybinding(program: Command): void;
+//# sourceMappingURL=install-keybinding.d.ts.map

package/dist/commands/install-keybinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-keybinding.d.ts","sourceRoot":"","sources":["../../src/commands/install-keybinding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CA+CD;AAMD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiChE"}

package/dist/commands/install-keybinding.js

@@ -0,0 +1,138 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { printOutput, printError } from "../output.js";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Core logic (exported for testability)
+// ---------------------------------------------------------------------------
+/**
+ * Build the tmux bind-key command string for `pit resume`.
+ *
+ * tmux windows are named 'epic-<name>', so we strip the 'epic-' prefix
+ * to derive the epic ID for `pit resume`.
+ *
+ * We use a shell command inside run-shell that invokes sed to strip the
+ * prefix for portability with tmux < 3.1.
+ *
+ * NOTE: tmux >= 3.1 supports a cleaner approach using format substitution:
+ *   bind-key R run-shell 'pit resume #{s/epic-//:window_name}'
+ * When the minimum supported tmux version can be bumped to 3.1+, switch
+ * to that syntax instead.
+ */
+export function buildBindKeyCommand(key) {
+    return `bind-key ${key} run-shell "pit resume \\$(tmux display-message -p '#{window_name}' | sed 's/^epic-//')"`;
+}
+/**
+ * Build the run-shell argument portion of the resume bind-key command.
+ * This is the value that gets passed to tmux bind-key directly.
+ */
+export function buildRunShellArg() {
+    return `pit resume $(tmux display-message -p '#{window_name}' | sed 's/^epic-//')`;
+}
+/**
+ * Build the tmux bind-key command string for `pit pause`.
+ *
+ * Uses the same epic-name derivation as the resume binding.
+ */
+export function buildPauseBindKeyCommand(key) {
+    return `bind-key ${key} run-shell "pit pause \\$(tmux display-message -p '#{window_name}' | sed 's/^epic-//')"`;
+}
+/**
+ * Build the run-shell argument portion of the pause bind-key command.
+ */
+export function buildPauseRunShellArg() {
+    return `pit pause $(tmux display-message -p '#{window_name}' | sed 's/^epic-//')`;
+}
+/**
+ * Install the keybindings into the running tmux server.
+ *
+ * Installs two bindings:
+ *   - resumeKey (default R): pit resume <epic>
+ *   - pauseKey  (default H): pit pause  <epic>  (H for Halt)
+ *
+ * Steps:
+ * 1. Check for existing bindings on both keys and warn if there are conflicts.
+ * 2. Apply both bindings via `tmux bind-key`.
+ *
+ * Note: bind-key is SERVER-GLOBAL, not session-scoped. The binding applies
+ * to all tmux sessions on this server. If the user presses a key in a
+ * non-pit window, the pit command will fail with EPIC_NOT_FOUND (graceful failure).
+ */
+export async function installKeybinding(resumeKey, pauseKey) {
+    const warnings = [];
+    // Check for existing bindings on both keys
+    try {
+        const { stdout } = await execFileAsync("tmux", ["list-keys"]);
+        const lines = stdout.split("\n");
+        for (const { key, pitCmd } of [
+            { key: resumeKey, pitCmd: "pit resume" },
+            { key: pauseKey, pitCmd: "pit pause" },
+        ]) {
+            const existingBinding = lines.find((line) => {
+                const match = line.match(/bind-key\s+-T\s+prefix\s+(\S+)/);
+                return match && match[1] === key;
+            });
+            if (existingBinding && !existingBinding.includes(pitCmd)) {
+                warnings.push(`Key '${key}' already has a binding: ${existingBinding.trim()}. It will be overwritten.`);
+            }
+        }
+    }
+    catch {
+        // tmux not running or list-keys failed — proceed anyway,
+        // bind-key will fail with a clearer error if tmux isn't available
+    }
+    // Apply the resume binding
+    await execFileAsync("tmux", ["bind-key", resumeKey, "run-shell", buildRunShellArg()]);
+    // Apply the pause binding
+    await execFileAsync("tmux", ["bind-key", pauseKey, "run-shell", buildPauseRunShellArg()]);
+    const resumeBindKeyLine = buildBindKeyCommand(resumeKey);
+    const pauseBindKeyLine = buildPauseBindKeyCommand(pauseKey);
+    const persistLines = [resumeBindKeyLine, pauseBindKeyLine].join("\n  ");
+    const output = {
+        status: "installed",
+        bindings: [
+            { key: resumeKey, binding: resumeBindKeyLine },
+            { key: pauseKey, binding: pauseBindKeyLine },
+        ],
+        note: `Bindings are server-global (apply to all tmux sessions). To persist, add to your tmux.conf:\n  ${persistLines}`,
+    };
+    return { output, warnings };
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerInstallKeybinding(program) {
+    program
+        .command("install-keybinding")
+        .description("Install tmux keybindings for quick epic resume (R) and pause/halt (H)")
+        .option("--tmux-session <name>", "tmux session name", "pit")
+        .action(async (_opts, cmd) => {
+        const pretty = (cmd.parent?.opts()).pretty ?? false;
+        const resumeKey = "R";
+        const pauseKey = "H";
+        try {
+            const { output, warnings } = await installKeybinding(resumeKey, pauseKey);
+            if (pretty) {
+                for (const w of warnings) {
+                    process.stderr.write(`Warning: ${w}\n`);
+                }
+                process.stdout.write(`Installed tmux keybindings:\n`);
+                for (const { key, binding } of output.bindings) {
+                    process.stdout.write(`  prefix + ${key}: ${binding}\n`);
+                }
+                process.stdout.write(`\nNote: ${output.note}\n`);
+            }
+            else {
+                for (const w of warnings) {
+                    process.stderr.write(JSON.stringify({ warning: w }) + "\n");
+                }
+                printOutput(output, false);
+            }
+        }
+        catch (err) {
+            printError({ error: `Failed to install keybinding: ${err.message}` }, pretty);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=install-keybinding.js.map

package/dist/commands/install-keybinding.js.map

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

package/dist/commands/install-status.d.ts

@@ -0,0 +1,35 @@
+import type { Command } from "commander";
+export type InstallStatusResult = {
+    status: "installed";
+    segment: "#{@pit-status}";
+    previous: string;
+    current: string;
+    note: string;
+} | {
+    status: "already_installed";
+    segment: "#{@pit-status}";
+    note: string;
+};
+/**
+ * Append #{@pit-status} to the tmux server's global status-right option.
+ *
+ * Steps:
+ * 1. Read the current status-right value via `tmux show-options -gv status-right`.
+ * 2. If #{@pit-status} is already present, return { status: "already_installed" }.
+ * 3. Append ` #{@pit-status}` (with a space separator, or no separator if empty).
+ * 4. Set the new value via `tmux set-option -g status-right "<new_value>"`.
+ * 5. Return { status: "installed", previous, current }.
+ *
+ * Corner cases:
+ * - tmux not running: show-options throws → propagate with friendly error message.
+ * - status-right is empty/unset: set to #{@pit-status} with no leading space.
+ * - status-right already contains #{@pit-status}: idempotent, return already_installed.
+ * - Special characters (quotes, #): use execFileAsync args array to avoid shell injection.
+ *
+ * Note: set-option -g is SERVER-GLOBAL (applies to all sessions on this server).
+ * #{@pit-status} evaluates to empty string when the @pit-status option is unset,
+ * so it is invisible when pit isn't running.
+ */
+export declare function installStatus(): Promise<InstallStatusResult>;
+export declare function registerInstallStatus(program: Command): void;
+//# sourceMappingURL=install-status.d.ts.map

package/dist/commands/install-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-status.d.ts","sourceRoot":"","sources":["../../src/commands/install-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBzC,MAAM,MAAM,mBAAmB,GAC3B;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAQN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA4ClE;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiC5D"}