@elhu/pit 0.1.1

package/dist/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration module for pit.
+ *
+ * Reads .pit.json from the project root and merges with CLI flags and defaults.
+ * Exported for use by the daemon and CLI commands.
+ */
+/**
+ * User-facing configuration loaded from .pit.json.
+ * All fields are optional — missing fields fall back to DEFAULT_CONFIG.
+ */
+export interface PitConfig {
+    agent?: "auto" | "opencode" | "claude-code";
+    worktreeDir?: string;
+    baseBranch?: string;
+    tmuxSession?: string;
+    /** Inline prompt template string (NOT a file path). */
+    promptTemplate?: string;
+    /** Delay in ms before clearing agent context after ticket completion. */
+    clearDelay?: number;
+    /** Delay in ms before starting the agent after setup. */
+    initDelay?: number;
+    /** Ticket timeout in minutes, or null to disable. */
+    ticketTimeout?: number | null;
+    /** Model to use for the agent, or null to use agent default. */
+    model?: string | null;
+}
+/**
+ * Fully resolved configuration — every field is required (no optionals).
+ * Produced by resolveConfig() after merging CLI flags > file > defaults.
+ */
+export interface ResolvedConfig {
+    agent: "auto" | "opencode" | "claude-code";
+    worktreeDir: string;
+    baseBranch: string;
+    tmuxSession: string;
+    promptTemplate: string;
+    clearDelay: number;
+    initDelay: number;
+    ticketTimeout: number | null;
+    model: string | null;
+}
+export declare const DEFAULT_CONFIG: ResolvedConfig;
+/**
+ * Load configuration from `<projectRoot>/.pit.json`.
+ *
+ * - Returns `{}` when the file is missing or unparseable (logs a warning).
+ * - Warns on unknown fields (typo detection).
+ * - Warns and drops fields with invalid types (uses default instead).
+ */
+export declare function loadPitConfig(projectRoot: string): PitConfig;
+/**
+ * Three-tier merge: CLI flags > .pit.json values > DEFAULT_CONFIG.
+ *
+ * `cliFlags` should contain ONLY fields the user explicitly set on the CLI
+ * (use Commander's `command.getOptionValueSource(name) === 'cli'` to filter).
+ */
+export declare function resolveConfig(cliFlags: Partial<PitConfig>, fileConfig: PitConfig): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAMD,eAAO,MAAM,cAAc,EAAE,cAU5B,CAAC;AAyBF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAsD5D;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,SAAS,GAAG,cAAc,CAoBjG"}

package/dist/config.js

@@ -0,0 +1,129 @@
+/**
+ * Configuration module for pit.
+ *
+ * Reads .pit.json from the project root and merges with CLI flags and defaults.
+ * Exported for use by the daemon and CLI commands.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createLogger } from "./logger.js";
+const logger = createLogger();
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+export const DEFAULT_CONFIG = {
+    agent: "auto",
+    worktreeDir: ".worktrees",
+    baseBranch: "main",
+    tmuxSession: "pit",
+    promptTemplate: "",
+    clearDelay: 2000,
+    initDelay: 5000,
+    ticketTimeout: null,
+    model: null,
+};
+// ---------------------------------------------------------------------------
+// Field validators
+// ---------------------------------------------------------------------------
+const VALID_AGENTS = new Set(["auto", "opencode", "claude-code"]);
+/** Map of field name → runtime type-check predicate. */
+const FIELD_VALIDATORS = {
+    agent: (v) => typeof v === "string" && VALID_AGENTS.has(v),
+    worktreeDir: (v) => typeof v === "string",
+    baseBranch: (v) => typeof v === "string",
+    tmuxSession: (v) => typeof v === "string",
+    promptTemplate: (v) => typeof v === "string",
+    clearDelay: (v) => typeof v === "number" && Number.isFinite(v),
+    initDelay: (v) => typeof v === "number" && Number.isFinite(v),
+    ticketTimeout: (v) => v === null || (typeof v === "number" && Number.isFinite(v)),
+    model: (v) => v === null || typeof v === "string",
+};
+// ---------------------------------------------------------------------------
+// loadPitConfig
+// ---------------------------------------------------------------------------
+/**
+ * Load configuration from `<projectRoot>/.pit.json`.
+ *
+ * - Returns `{}` when the file is missing or unparseable (logs a warning).
+ * - Warns on unknown fields (typo detection).
+ * - Warns and drops fields with invalid types (uses default instead).
+ */
+export function loadPitConfig(projectRoot) {
+    const configPath = path.join(projectRoot, ".pit.json");
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        // File missing — perfectly fine, return empty config.
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        logger.warn("Failed to parse .pit.json", {
+            error: String(error),
+            configPath,
+        });
+        return {};
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        logger.warn(".pit.json must be a JSON object", { configPath });
+        return {};
+    }
+    const obj = parsed;
+    const knownKeys = new Set(Object.keys(FIELD_VALIDATORS));
+    const result = {};
+    // Warn on unknown fields
+    for (const key of Object.keys(obj)) {
+        if (!knownKeys.has(key)) {
+            logger.warn(`Unknown field in .pit.json: "${key}"`, { configPath });
+        }
+    }
+    // Validate and pick known fields
+    for (const [key, validator] of Object.entries(FIELD_VALIDATORS)) {
+        const typedKey = key;
+        if (typedKey in obj) {
+            const value = obj[typedKey];
+            if (validator(value)) {
+                // Type assertion is safe — validator just confirmed the type.
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                result[typedKey] = value;
+            }
+            else {
+                logger.warn(`Invalid type for "${typedKey}" in .pit.json, ignoring`, { value, configPath });
+            }
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// resolveConfig
+// ---------------------------------------------------------------------------
+/**
+ * Three-tier merge: CLI flags > .pit.json values > DEFAULT_CONFIG.
+ *
+ * `cliFlags` should contain ONLY fields the user explicitly set on the CLI
+ * (use Commander's `command.getOptionValueSource(name) === 'cli'` to filter).
+ */
+export function resolveConfig(cliFlags, fileConfig) {
+    const resolved = { ...DEFAULT_CONFIG };
+    // Layer 1: file config overrides defaults
+    for (const key of Object.keys(FIELD_VALIDATORS)) {
+        if (key in fileConfig && fileConfig[key] !== undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            resolved[key] = fileConfig[key];
+        }
+    }
+    // Layer 2: CLI flags override file config
+    for (const key of Object.keys(FIELD_VALIDATORS)) {
+        if (key in cliFlags && cliFlags[key] !== undefined) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            resolved[key] = cliFlags[key];
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AA2C9B,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,EAAE;IAClB,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,IAAI;IACnB,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAElE,wDAAwD;AACxD,MAAM,gBAAgB,GAAyD;IAC7E,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;IACzC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;IACxC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;IACzC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;IAC5C,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;CAClD,CAAC;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEvD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;YACpB,UAAU;SACX,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,gCAAgC,GAAG,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,GAAsB,CAAC;QACxC,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5B,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,8DAA8D;gBAC9D,8DAA8D;gBAC7D,MAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,qBAAqB,QAAQ,0BAA0B,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAA4B,EAAE,UAAqB;IAC/E,MAAM,QAAQ,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IAEvC,0CAA0C;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAwB,EAAE,CAAC;QACvE,IAAI,GAAG,IAAI,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACvD,8DAA8D;YAC7D,QAAgB,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAwB,EAAE,CAAC;QACvE,IAAI,GAAG,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACnD,8DAA8D;YAC7D,QAAgB,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/daemon/client.d.ts

@@ -0,0 +1,38 @@
+import type { DaemonRequest, DaemonResponse } from "./protocol.js";
+/** Error classes for daemon connection failures */
+export declare class DaemonConnectionError extends Error {
+    readonly code: "NO_SOCKET" | "CONNECTION_REFUSED" | "TIMEOUT";
+    constructor(message: string, code: "NO_SOCKET" | "CONNECTION_REFUSED" | "TIMEOUT");
+}
+export declare class DaemonVersionError extends Error {
+    readonly daemonVersion: string;
+    readonly clientVersion: string;
+    constructor(message: string, daemonVersion: string, clientVersion: string);
+}
+/** Result of daemon discovery */
+export interface DaemonInfo {
+    socketPath: string;
+    running: boolean;
+}
+/** Connected client that can send requests */
+export interface DaemonClientConnection {
+    send<T extends DaemonResponse>(request: DaemonRequest): Promise<T>;
+    close(): void;
+}
+/**
+ * Discover daemon for given project and session
+ */
+export declare function discoverDaemon(projectRoot: string, tmuxSession?: string): Promise<DaemonInfo>;
+/**
+ * Ensure daemon is running, start if needed
+ */
+export declare function ensureDaemon(projectRoot: string, tmuxSession?: string): Promise<string>;
+/**
+ * Connect to daemon socket
+ */
+export declare function connectToDaemon(socketPath: string): Promise<DaemonClientConnection>;
+/** Connect with protocol version check */
+export declare function connectWithVersionCheck(socketPath: string): Promise<DaemonClientConnection>;
+/** Connect with retry logic */
+export declare function connectWithRetry(socketPath: string, maxRetries?: number): Promise<DaemonClientConnection>;
+//# sourceMappingURL=client.d.ts.map

package/dist/daemon/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/daemon/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AAIjF,mDAAmD;AACnD,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,SAAS;gBADpE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,SAAS;CAKvE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,aAAa,EAAE,MAAM;aACrB,aAAa,EAAE,MAAM;gBAFrC,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM;CAKxC;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,KAAK,IAAI,IAAI,CAAC;CACf;AAKD;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,SAAQ,GAClB,OAAO,CAAC,UAAU,CAAC,CASrB;AAeD;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B5F;AAiCD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA6BzF;AAkDD,0CAA0C;AAC1C,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA8BjG;AAED,+BAA+B;AAC/B,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,SAAI,GACb,OAAO,CAAC,sBAAsB,CAAC,CA+BjC"}

package/dist/daemon/client.js

@@ -0,0 +1,254 @@
+import * as fs from "node:fs/promises";
+import * as net from "node:net";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { PROTOCOL_VERSION } from "./protocol.js";
+import { generateSessionId } from "../session.js";
+/** Error classes for daemon connection failures */
+export class DaemonConnectionError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "DaemonConnectionError";
+    }
+}
+export class DaemonVersionError extends Error {
+    daemonVersion;
+    clientVersion;
+    constructor(message, daemonVersion, clientVersion) {
+        super(message);
+        this.daemonVersion = daemonVersion;
+        this.clientVersion = clientVersion;
+        this.name = "DaemonVersionError";
+    }
+}
+const STARTUP_TIMEOUT_MS = 5000;
+const STARTUP_POLL_MS = 100;
+/**
+ * Discover daemon for given project and session
+ */
+export async function discoverDaemon(projectRoot, tmuxSession = "pit") {
+    // Derive session ID (same logic as src/session.ts:generateSessionId)
+    const sessionId = generateSessionId(projectRoot, tmuxSession);
+    const socketPath = path.join("/tmp/pit", sessionId, "daemon.sock");
+    // Test if socket is connectable
+    const running = await testConnection(socketPath);
+    return { socketPath, running };
+}
+async function testConnection(socketPath) {
+    return new Promise((resolve) => {
+        const socket = net.createConnection(socketPath);
+        socket.on("connect", () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.on("error", () => {
+            resolve(false);
+        });
+    });
+}
+/**
+ * Ensure daemon is running, start if needed
+ */
+export async function ensureDaemon(projectRoot, tmuxSession = "pit") {
+    const info = await discoverDaemon(projectRoot, tmuxSession);
+    if (info.running) {
+        return info.socketPath;
+    }
+    // Acquire startup lock to prevent race with other clients
+    const lockPath = path.join(path.dirname(info.socketPath), "daemon.lock");
+    await acquireLock(lockPath);
+    try {
+        // Double-check after acquiring lock (another client may have started it)
+        if (await testConnection(info.socketPath)) {
+            return info.socketPath;
+        }
+        // Spawn daemon process (detached, stdio ignored)
+        await spawnDaemon(projectRoot, tmuxSession);
+        // Wait for socket to become ready
+        await waitForSocket(info.socketPath, STARTUP_TIMEOUT_MS);
+        return info.socketPath;
+    }
+    finally {
+        await releaseLock(lockPath);
+    }
+}
+async function spawnDaemon(projectRoot, _tmuxSession) {
+    // Spawn daemon __run directly (not daemon start) because the caller
+    // (ensureDaemon) already holds daemon.lock. Going through daemon start
+    // would deadlock since it tries to acquire the same lock.
+    const child = spawn(process.execPath, // node
+    [
+        path.resolve(process.argv[1]), // Use resolved path to CLI
+        "daemon",
+        "__run",
+    ], {
+        detached: true,
+        stdio: "ignore",
+        cwd: projectRoot,
+    });
+    child.unref();
+}
+async function waitForSocket(socketPath, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await testConnection(socketPath)) {
+            return;
+        }
+        await new Promise((r) => setTimeout(r, STARTUP_POLL_MS));
+    }
+    throw new Error(`Daemon failed to start within ${timeoutMs}ms`);
+}
+/**
+ * Connect to daemon socket
+ */
+export async function connectToDaemon(socketPath) {
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection(socketPath);
+        const timeout = setTimeout(() => {
+            socket.destroy();
+            reject(new DaemonConnectionError("Connection timeout", "TIMEOUT"));
+        }, 5000);
+        socket.on("connect", () => {
+            clearTimeout(timeout);
+            resolve(createClient(socket));
+        });
+        socket.on("error", (err) => {
+            clearTimeout(timeout);
+            if (err.code === "ENOENT") {
+                reject(new DaemonConnectionError("Daemon socket not found", "NO_SOCKET"));
+            }
+            else if (err.code === "ECONNREFUSED") {
+                reject(new DaemonConnectionError("Daemon not responding (may have crashed)", "CONNECTION_REFUSED"));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+/** Create client with proper error handling */
+function createClient(socket) {
+    let buffer = "";
+    return {
+        async send(request) {
+            const REQUEST_TIMEOUT_MS = 30000;
+            return new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    socket.off("data", onData);
+                    reject(new Error(`Request timeout after ${REQUEST_TIMEOUT_MS}ms`));
+                }, REQUEST_TIMEOUT_MS);
+                const onData = (chunk) => {
+                    buffer += chunk.toString();
+                    const newlineIdx = buffer.indexOf("\n");
+                    if (newlineIdx !== -1) {
+                        const line = buffer.slice(0, newlineIdx);
+                        buffer = buffer.slice(newlineIdx + 1);
+                        socket.off("data", onData);
+                        clearTimeout(timeout);
+                        try {
+                            resolve(JSON.parse(line));
+                        }
+                        catch {
+                            reject(new Error("Invalid JSON response from daemon"));
+                        }
+                    }
+                };
+                socket.on("data", onData);
+                socket.write(JSON.stringify(request) + "\n");
+            });
+        },
+        close() {
+            socket.destroy();
+        },
+    };
+}
+/** Check if daemon protocol version is compatible */
+function isVersionCompatible(daemon, client) {
+    // Same major version = compatible (semver-like)
+    const daemonMajor = daemon.split(".")[0];
+    const clientMajor = client.split(".")[0];
+    return daemonMajor === clientMajor;
+}
+/** Connect with protocol version check */
+export async function connectWithVersionCheck(socketPath) {
+    const client = await connectToDaemon(socketPath);
+    try {
+        // Send status request to check version
+        const status = await client.send({
+            id: "version-check",
+            method: "status",
+            params: {},
+        });
+        if (!status.success || !status.result || !status.result.protocolVersion) {
+            client.close();
+            throw new Error("Daemon status response missing protocol version");
+        }
+        if (!isVersionCompatible(status.result.protocolVersion, PROTOCOL_VERSION)) {
+            client.close();
+            throw new DaemonVersionError(`Daemon version ${status.result.protocolVersion} incompatible with client ${PROTOCOL_VERSION}`, status.result.protocolVersion, PROTOCOL_VERSION);
+        }
+        return client;
+    }
+    catch (err) {
+        client.close();
+        throw err;
+    }
+}
+/** Connect with retry logic */
+export async function connectWithRetry(socketPath, maxRetries = 1) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await connectWithVersionCheck(socketPath);
+        }
+        catch (err) {
+            lastError = err;
+            // Retry only for transient failures
+            if (err instanceof DaemonConnectionError) {
+                if (err.code === "CONNECTION_REFUSED" && attempt < maxRetries) {
+                    // Wait briefly before retry
+                    await new Promise((r) => setTimeout(r, 500));
+                    continue;
+                }
+            }
+            // Don't retry version mismatch or other permanent failures
+            if (err instanceof DaemonVersionError) {
+                throw err;
+            }
+            // Don't retry socket not found (daemon not running)
+            if (err instanceof DaemonConnectionError && err.code === "NO_SOCKET") {
+                throw err;
+            }
+        }
+    }
+    throw lastError;
+}
+async function acquireLock(lockPath) {
+    const dir = path.dirname(lockPath);
+    await fs.mkdir(dir, { recursive: true });
+    // Simple spinlock with exponential backoff
+    let attempts = 0;
+    while (attempts < 50) {
+        try {
+            // O_EXCL ensures atomic creation
+            await fs.writeFile(lockPath, String(process.pid), { flag: "wx" });
+            return;
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+            // Lock held by another process
+            await new Promise((r) => setTimeout(r, Math.min(100, 10 * Math.pow(1.5, attempts))));
+            attempts++;
+        }
+    }
+    throw new Error("Failed to acquire daemon startup lock");
+}
+async function releaseLock(lockPath) {
+    await fs.unlink(lockPath).catch(() => {
+        // Ignore if file doesn't exist
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/daemon/client.js.map

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

package/dist/daemon/context.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared context type for the pit daemon.
+ *
+ * DaemonContext encapsulates all mutable runtime state that daemon handlers
+ * need to close over. It is a plain mutable object — not a class — so that
+ * state updates are straightforward assignments.
+ *
+ * The module-level let variables in commands/daemon.ts (daemonState,
+ * debouncedSaver, loopHandles, agentInstance) will be migrated to this
+ * context in a later task (.7/.8). For now this module only defines the
+ * shared types.
+ */
+import type { AgentAdapter } from "../adapters/types.js";
+import type { DaemonState, PersistedEpicState } from "./state.js";
+import type { LoopHandle } from "../loop.js";
+import type { PitConfig } from "../config.js";
+import type * as beads from "../beads.js";
+/**
+ * All runtime state for a running daemon instance.
+ *
+ * daemonState, debouncedSaver, and agentInstance start as null and are
+ * populated on the first `start` call or during state recovery.
+ */
+export interface DaemonContext {
+    daemonState: DaemonState | null;
+    debouncedSaver: ((state: DaemonState) => void) | null;
+    loopHandles: Map<string, LoopHandle>;
+    agentInstance: AgentAdapter | null;
+    daemonStartTime: number;
+    projectRoot: string;
+    sessionId: string;
+    tmuxSession: string;
+    fileConfig: PitConfig;
+    healthCheckInterval: ReturnType<typeof setInterval> | null;
+}
+/**
+ * Narrowed version of DaemonContext for handlers that require the daemon to
+ * have been started at least once. Guarantees that daemonState, debouncedSaver,
+ * and agentInstance are non-null.
+ */
+export type InitializedDaemonContext = DaemonContext & {
+    daemonState: DaemonState;
+    debouncedSaver: (state: DaemonState) => void;
+    agentInstance: AgentAdapter;
+};
+/**
+ * Signature of the clearAndReprompt helper used by daemon handlers and the
+ * recovery pipeline.
+ *
+ * Moved here (from commands/daemon.ts) to avoid future import cycles between
+ * the handler modules and the recovery module.
+ */
+export type ClearAndRepromptFn = (options: {
+    epicId: string;
+    machine: LoopHandle["machine"];
+    windowName: string;
+    adapter: AgentAdapter;
+    transitionReason: "TICKET_COMPLETE" | "RESUME_NO_MESSAGE";
+    epicState: PersistedEpicState;
+}) => Promise<{
+    nextTicket: beads.BeadTicket | null;
+}>;
+//# sourceMappingURL=context.d.ts.map

package/dist/daemon/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/daemon/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAM1C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,CAAC;IACtB,mBAAmB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC;CAC5D;AAMD;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG;IACrD,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,aAAa,EAAE,YAAY,CAAC;CAC7B,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAC1D,SAAS,EAAE,kBAAkB,CAAC;CAC/B,KAAK,OAAO,CAAC;IAAE,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC"}

package/dist/daemon/context.js

@@ -0,0 +1,14 @@
+/**
+ * Shared context type for the pit daemon.
+ *
+ * DaemonContext encapsulates all mutable runtime state that daemon handlers
+ * need to close over. It is a plain mutable object — not a class — so that
+ * state updates are straightforward assignments.
+ *
+ * The module-level let variables in commands/daemon.ts (daemonState,
+ * debouncedSaver, loopHandles, agentInstance) will be migrated to this
+ * context in a later task (.7/.8). For now this module only defines the
+ * shared types.
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/daemon/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/daemon/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}