@proletariat/cli 0.3.55 → 0.3.57

package/dist/lib/runners/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/lib/runners/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/lib/runners/claude-code-runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ClaudeCodeRunner
+ *
+ * AgentRunner implementation for Claude Code.
+ * Wraps the existing runHost() execution logic from execution/runners.ts
+ * to provide a pluggable runner interface while maintaining full backward
+ * compatibility with `prlt work start`.
+ */
+import type { AgentRunner, AgentSession, SpawnConfig } from './agent-runner.js';
+import type { ExecutionContext, ExecutionConfig } from '../execution/types.js';
+/**
+ * Claude Code agent runner.
+ *
+ * Delegates to the existing runHost() function for spawning, which handles:
+ * - tmux session creation for persistence
+ * - Terminal tab opening (iTerm, Terminal.app, Ghostty, etc.)
+ * - Prompt building and script generation
+ * - Permission mode and output mode configuration
+ *
+ * The peek/poke/stop methods use tmux commands directly since Claude Code
+ * sessions always run inside tmux.
+ */
+export declare class ClaudeCodeRunner implements AgentRunner {
+    readonly name = "claude-code";
+    spawn(config: SpawnConfig): Promise<AgentSession>;
+    getStatus(session: AgentSession): Promise<'running' | 'done' | 'error'>;
+    peek(session: AgentSession, lines?: number): Promise<string>;
+    poke(session: AgentSession, message: string): Promise<void>;
+    stop(session: AgentSession): Promise<void>;
+    /**
+     * Build a tmux session name from spawn config.
+     * Uses the same naming convention as the existing system:
+     * "{ticketId}-{action}-{agentName}" or falls back to a generated name.
+     */
+    private buildSessionName;
+    /**
+     * Build an ExecutionContext from SpawnConfig.
+     * Maps the simplified SpawnConfig to the richer ExecutionContext used by runHost().
+     */
+    private buildExecutionContext;
+    /**
+     * Build ExecutionConfig from SpawnConfig defaults.
+     */
+    private buildExecutionConfig;
+}
+/**
+ * Create a ClaudeCodeRunner that uses a full ExecutionContext and config.
+ *
+ * This is the integration point for `prlt work start` — it provides a way
+ * to spawn Claude Code using the existing rich context while still going
+ * through the AgentRunner interface.
+ */
+export declare function createClaudeCodeSession(context: ExecutionContext, config?: ExecutionConfig, displayMode?: 'terminal' | 'background' | 'foreground'): Promise<import("../execution/runners.js").RunnerResult>;

package/dist/lib/runners/claude-code-runner.js

@@ -0,0 +1,132 @@
+/**
+ * ClaudeCodeRunner
+ *
+ * AgentRunner implementation for Claude Code.
+ * Wraps the existing runHost() execution logic from execution/runners.ts
+ * to provide a pluggable runner interface while maintaining full backward
+ * compatibility with `prlt work start`.
+ */
+import { execSync } from 'node:child_process';
+import { runHost, } from '../execution/runners.js';
+import { DEFAULT_EXECUTION_CONFIG } from '../execution/types.js';
+import { captureTmuxPane } from '../execution/session-utils.js';
+/**
+ * Claude Code agent runner.
+ *
+ * Delegates to the existing runHost() function for spawning, which handles:
+ * - tmux session creation for persistence
+ * - Terminal tab opening (iTerm, Terminal.app, Ghostty, etc.)
+ * - Prompt building and script generation
+ * - Permission mode and output mode configuration
+ *
+ * The peek/poke/stop methods use tmux commands directly since Claude Code
+ * sessions always run inside tmux.
+ */
+export class ClaudeCodeRunner {
+    name = 'claude-code';
+    async spawn(config) {
+        const sessionName = this.buildSessionName(config);
+        const context = this.buildExecutionContext(config, sessionName);
+        const executionConfig = this.buildExecutionConfig(config);
+        const result = await runHost(context, 'claude-code', executionConfig, config.background ? 'background' : 'terminal');
+        if (!result.success) {
+            throw new Error(result.error || 'Failed to spawn Claude Code session');
+        }
+        return {
+            id: result.sessionId || sessionName,
+            runner: this.name,
+            sessionName: result.sessionId || sessionName,
+            task: config.task,
+            workdir: config.workdir,
+            startedAt: new Date(),
+            status: 'running',
+        };
+    }
+    async getStatus(session) {
+        try {
+            const output = execSync(`tmux has-session -t "${session.sessionName}" 2>/dev/null && echo "exists"`, { encoding: 'utf-8', stdio: 'pipe' }).trim();
+            if (output === 'exists') {
+                return 'running';
+            }
+            return 'done';
+        }
+        catch {
+            // tmux session doesn't exist — agent has finished or was killed
+            return 'done';
+        }
+    }
+    async peek(session, lines = 50) {
+        const output = captureTmuxPane(session.sessionName, lines);
+        return output ?? '';
+    }
+    async poke(session, message) {
+        try {
+            // Send the message as keystrokes followed by Enter
+            execSync(`tmux send-keys -t "${session.sessionName}" ${JSON.stringify(message)} Enter`, { stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to send message to session "${session.sessionName}": ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    async stop(session) {
+        try {
+            // Send C-c first to gracefully interrupt the running process
+            execSync(`tmux send-keys -t "${session.sessionName}" C-c`, { stdio: 'pipe' });
+            // Brief delay to let the process handle the signal
+            await new Promise(resolve => setTimeout(resolve, 500));
+            // Kill the tmux session
+            execSync(`tmux kill-session -t "${session.sessionName}"`, { stdio: 'pipe' });
+        }
+        catch {
+            // Session may already be dead — that's fine
+        }
+    }
+    /**
+     * Build a tmux session name from spawn config.
+     * Uses the same naming convention as the existing system:
+     * "{ticketId}-{action}-{agentName}" or falls back to a generated name.
+     */
+    buildSessionName(config) {
+        // If we have a full ExecutionContext-like task with ticket info, use buildSessionName
+        // Otherwise generate a simple name from the runner and timestamp
+        return `claude-${Date.now()}`;
+    }
+    /**
+     * Build an ExecutionContext from SpawnConfig.
+     * Maps the simplified SpawnConfig to the richer ExecutionContext used by runHost().
+     */
+    buildExecutionContext(config, sessionName) {
+        return {
+            ticketId: sessionName,
+            ticketTitle: config.task.slice(0, 80),
+            ticketDescription: config.task,
+            agentName: 'agent',
+            agentDir: config.workdir,
+            worktreePath: config.workdir,
+            branch: 'main',
+            createPR: config.createPR,
+            actionName: 'work',
+            actionPrompt: config.task,
+        };
+    }
+    /**
+     * Build ExecutionConfig from SpawnConfig defaults.
+     */
+    buildExecutionConfig(config) {
+        return {
+            ...DEFAULT_EXECUTION_CONFIG,
+            permissionMode: 'danger',
+        };
+    }
+}
+/**
+ * Create a ClaudeCodeRunner that uses a full ExecutionContext and config.
+ *
+ * This is the integration point for `prlt work start` — it provides a way
+ * to spawn Claude Code using the existing rich context while still going
+ * through the AgentRunner interface.
+ */
+export function createClaudeCodeSession(context, config = DEFAULT_EXECUTION_CONFIG, displayMode = 'terminal') {
+    return runHost(context, 'claude-code', config, displayMode);
+}
+//# sourceMappingURL=claude-code-runner.js.map

package/dist/lib/runners/claude-code-runner.js.map

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

package/dist/lib/runners/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Runner Registry
+ *
+ * Central registry for agent runners. Provides auto-detection of available
+ * runtimes and a simple API for retrieving runner instances.
+ *
+ * Auto-detect order: claude-code → codex → pi
+ */
+import type { AgentRunner } from './agent-runner.js';
+export type { AgentRunner, AgentSession, SpawnConfig } from './agent-runner.js';
+export { ClaudeCodeRunner } from './claude-code-runner.js';
+export { createClaudeCodeSession } from './claude-code-runner.js';
+/**
+ * Get all runners whose CLI binary is available on PATH.
+ *
+ * Returns runners in detection order (claude-code, codex, pi).
+ * Only runners with an installed CLI are included.
+ */
+export declare function getAvailableRunners(): AgentRunner[];
+/**
+ * Get a specific runner by name, or the default (first available) runner.
+ *
+ * @param name - Runner name to look up (e.g. 'claude-code', 'codex').
+ *               If omitted, returns the first available runner.
+ * @returns The runner instance, or null if not found / not available.
+ */
+export declare function getRunner(name?: string): AgentRunner | null;
+/**
+ * Wrap a runner with event emission.
+ *
+ * Returns an EventEmittingRunner that delegates to the given runner
+ * while emitting runtime events on the global EventBus.
+ */
+export declare function withEvents(runner: AgentRunner): AgentRunner;

package/dist/lib/runners/index.js

@@ -0,0 +1,97 @@
+/**
+ * Runner Registry
+ *
+ * Central registry for agent runners. Provides auto-detection of available
+ * runtimes and a simple API for retrieving runner instances.
+ *
+ * Auto-detect order: claude-code → codex → pi
+ */
+import { execSync } from 'node:child_process';
+import { ClaudeCodeRunner } from './claude-code-runner.js';
+import { EventEmittingRunner } from '../events/emitting-runner.js';
+export { ClaudeCodeRunner } from './claude-code-runner.js';
+export { createClaudeCodeSession } from './claude-code-runner.js';
+// =============================================================================
+// Runner Registry
+// =============================================================================
+/**
+ * Known runner definitions.
+ * Maps runner name to the CLI binary that must be on PATH and a factory function.
+ *
+ * Detection order matters — first available runner is the default.
+ */
+const RUNNER_DEFINITIONS = [
+    {
+        name: 'claude-code',
+        binary: 'claude',
+        create: () => new ClaudeCodeRunner(),
+    },
+    // Future runners — uncomment when implemented:
+    // {
+    //   name: 'codex',
+    //   binary: 'codex',
+    //   create: () => new CodexRunner(),
+    // },
+    // {
+    //   name: 'pi',
+    //   binary: 'pi',
+    //   create: () => new PiRunner(),
+    // },
+];
+/**
+ * Check if a CLI binary is available on PATH.
+ */
+function isBinaryAvailable(binary) {
+    try {
+        execSync(`command -v ${binary}`, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get all runners whose CLI binary is available on PATH.
+ *
+ * Returns runners in detection order (claude-code, codex, pi).
+ * Only runners with an installed CLI are included.
+ */
+export function getAvailableRunners() {
+    return RUNNER_DEFINITIONS
+        .filter(def => isBinaryAvailable(def.binary))
+        .map(def => def.create());
+}
+/**
+ * Get a specific runner by name, or the default (first available) runner.
+ *
+ * @param name - Runner name to look up (e.g. 'claude-code', 'codex').
+ *               If omitted, returns the first available runner.
+ * @returns The runner instance, or null if not found / not available.
+ */
+export function getRunner(name) {
+    if (name) {
+        const def = RUNNER_DEFINITIONS.find(d => d.name === name);
+        if (!def)
+            return null;
+        if (!isBinaryAvailable(def.binary))
+            return null;
+        return def.create();
+    }
+    // Auto-detect: return first available
+    for (const def of RUNNER_DEFINITIONS) {
+        if (isBinaryAvailable(def.binary)) {
+            return def.create();
+        }
+    }
+    return null;
+}
+/**
+ * Wrap a runner with event emission.
+ *
+ * Returns an EventEmittingRunner that delegates to the given runner
+ * while emitting runtime events on the global EventBus.
+ */
+export function withEvents(runner) {
+    return new EventEmittingRunner(runner);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/runners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/runners/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAIlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,kBAAkB,GAInB;IACH;QACE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;KACrC;IACD,+CAA+C;IAC/C,IAAI;IACJ,mBAAmB;IACnB,qBAAqB;IACrB,qCAAqC;IACrC,KAAK;IACL,IAAI;IACJ,gBAAgB;IAChB,kBAAkB;IAClB,kCAAkC;IAClC,KAAK;CACN,CAAA;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,kBAAkB;SACtB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SAC5C,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QACzD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAA;QAC/C,OAAO,GAAG,CAAC,MAAM,EAAE,CAAA;IACrB,CAAC;IAED,sCAAsC;IACtC,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,MAAM,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}

package/dist/lib/session-store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Global Session Store
+ *
+ * Tracks agent sessions across all repos on the machine.
+ * Works without HQ / PMO — just needs ~/.proletariat/sessions.db.
+ *
+ * Schema: id, agentName, runner, task, workdir, sessionName,
+ *         environment, permissionMode, status, startedAt, endedAt
+ */
+export interface SessionRecord {
+    id: string;
+    agentName: string;
+    runner: string;
+    task: string;
+    workdir: string;
+    sessionName: string;
+    environment: 'host' | 'docker' | 'podman';
+    permissionMode: 'danger' | 'safe';
+    status: 'running' | 'done' | 'error' | 'stopped';
+    startedAt: Date;
+    endedAt?: Date;
+}
+export declare class SessionStore {
+    private db;
+    constructor(dbPath?: string);
+    private ensureSchema;
+    /**
+     * Create a new session record.
+     */
+    create(params: {
+        agentName: string;
+        runner: string;
+        task: string;
+        workdir: string;
+        sessionName: string;
+        environment: SessionRecord['environment'];
+        permissionMode: SessionRecord['permissionMode'];
+    }): SessionRecord;
+    /**
+     * Get a session by ID or agent name.
+     */
+    get(idOrName: string): SessionRecord | null;
+    /**
+     * Get a session by tmux session name.
+     */
+    getBySessionName(sessionName: string): SessionRecord | null;
+    /**
+     * List sessions, optionally filtered by status.
+     */
+    list(status?: SessionRecord['status']): SessionRecord[];
+    /**
+     * Update session status.
+     */
+    updateStatus(id: string, status: SessionRecord['status']): void;
+    /**
+     * Reconcile session statuses with actual tmux sessions.
+     * Marks sessions as 'done' if their tmux session no longer exists.
+     */
+    reconcile(): void;
+    /**
+     * Resolve an identifier to a session.
+     * Tries: exact ID match, agent name, partial match on agent name or session name.
+     */
+    resolve(identifier: string): SessionRecord | null;
+    /**
+     * Check if a tmux session is alive.
+     */
+    private isTmuxSessionAlive;
+    close(): void;
+}

package/dist/lib/session-store.js

@@ -0,0 +1,167 @@
+/**
+ * Global Session Store
+ *
+ * Tracks agent sessions across all repos on the machine.
+ * Works without HQ / PMO — just needs ~/.proletariat/sessions.db.
+ *
+ * Schema: id, agentName, runner, task, workdir, sessionName,
+ *         environment, permissionMode, status, startedAt, endedAt
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import Database from 'better-sqlite3';
+import { execSync } from 'node:child_process';
+// =============================================================================
+// Helpers
+// =============================================================================
+function rowToSession(row) {
+    return {
+        id: row.id,
+        agentName: row.agent_name,
+        runner: row.runner,
+        task: row.task,
+        workdir: row.workdir,
+        sessionName: row.session_name,
+        environment: row.environment,
+        permissionMode: row.permission_mode,
+        status: row.status,
+        startedAt: new Date(row.started_at),
+        endedAt: row.ended_at ? new Date(row.ended_at) : undefined,
+    };
+}
+function getDbPath() {
+    const dir = path.join(os.homedir(), '.proletariat');
+    fs.mkdirSync(dir, { recursive: true });
+    return path.join(dir, 'sessions.db');
+}
+// =============================================================================
+// Session Store
+// =============================================================================
+export class SessionStore {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath ?? getDbPath());
+        this.ensureSchema();
+    }
+    ensureSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        agent_name TEXT NOT NULL,
+        runner TEXT NOT NULL,
+        task TEXT NOT NULL,
+        workdir TEXT NOT NULL,
+        session_name TEXT NOT NULL,
+        environment TEXT NOT NULL DEFAULT 'host',
+        permission_mode TEXT NOT NULL DEFAULT 'safe',
+        status TEXT NOT NULL DEFAULT 'running',
+        started_at INTEGER NOT NULL,
+        ended_at INTEGER
+      )
+    `);
+    }
+    /**
+     * Create a new session record.
+     */
+    create(params) {
+        const id = `SES-${Date.now().toString(36).toUpperCase()}`;
+        const now = Date.now();
+        this.db.prepare(`
+      INSERT INTO sessions (id, agent_name, runner, task, workdir, session_name, environment, permission_mode, status, started_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', ?)
+    `).run(id, params.agentName, params.runner, params.task, params.workdir, params.sessionName, params.environment, params.permissionMode, now);
+        return {
+            id,
+            agentName: params.agentName,
+            runner: params.runner,
+            task: params.task,
+            workdir: params.workdir,
+            sessionName: params.sessionName,
+            environment: params.environment,
+            permissionMode: params.permissionMode,
+            status: 'running',
+            startedAt: new Date(now),
+        };
+    }
+    /**
+     * Get a session by ID or agent name.
+     */
+    get(idOrName) {
+        const row = this.db.prepare(`SELECT * FROM sessions WHERE id = ? OR agent_name = ? ORDER BY started_at DESC LIMIT 1`).get(idOrName, idOrName);
+        return row ? rowToSession(row) : null;
+    }
+    /**
+     * Get a session by tmux session name.
+     */
+    getBySessionName(sessionName) {
+        const row = this.db.prepare(`SELECT * FROM sessions WHERE session_name = ? ORDER BY started_at DESC LIMIT 1`).get(sessionName);
+        return row ? rowToSession(row) : null;
+    }
+    /**
+     * List sessions, optionally filtered by status.
+     */
+    list(status) {
+        let rows;
+        if (status) {
+            rows = this.db.prepare(`SELECT * FROM sessions WHERE status = ? ORDER BY started_at DESC`).all(status);
+        }
+        else {
+            rows = this.db.prepare(`SELECT * FROM sessions ORDER BY started_at DESC`).all();
+        }
+        return rows.map(rowToSession);
+    }
+    /**
+     * Update session status.
+     */
+    updateStatus(id, status) {
+        const endedAt = (status === 'done' || status === 'error' || status === 'stopped') ? Date.now() : null;
+        this.db.prepare(`UPDATE sessions SET status = ?, ended_at = COALESCE(?, ended_at) WHERE id = ?`).run(status, endedAt, id);
+    }
+    /**
+     * Reconcile session statuses with actual tmux sessions.
+     * Marks sessions as 'done' if their tmux session no longer exists.
+     */
+    reconcile() {
+        const running = this.list('running');
+        for (const session of running) {
+            if (!this.isTmuxSessionAlive(session.sessionName)) {
+                this.updateStatus(session.id, 'done');
+            }
+        }
+    }
+    /**
+     * Resolve an identifier to a session.
+     * Tries: exact ID match, agent name, partial match on agent name or session name.
+     */
+    resolve(identifier) {
+        // Exact ID match
+        const byId = this.get(identifier);
+        if (byId)
+            return byId;
+        // Partial agent name match (prefer running sessions)
+        const allSessions = this.list();
+        const running = allSessions.filter(s => s.status === 'running');
+        const pool = running.length > 0 ? running : allSessions;
+        const match = pool.find(s => s.agentName.includes(identifier) ||
+            s.sessionName.includes(identifier) ||
+            s.id.includes(identifier.toUpperCase()));
+        return match ?? null;
+    }
+    /**
+     * Check if a tmux session is alive.
+     */
+    isTmuxSessionAlive(sessionName) {
+        try {
+            execSync(`tmux has-session -t "${sessionName}" 2>/dev/null`, { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/lib/session-store.js.map

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

package/dist/lib/shortcut/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shortcut Configuration Storage
+ *
+ * Stores Shortcut credentials and preferences in the workspace_settings table.
+ * Mirrors the Jira config module pattern.
+ */
+import Database from 'better-sqlite3';
+export interface ShortcutConfig {
+    apiToken: string;
+    workspaceSlug?: string;
+}
+/**
+ * Check if Shortcut is configured.
+ * Returns true if either:
+ * - Database has shortcut.api_token stored, OR
+ * - Environment variables PRLT_SHORTCUT_API_TOKEN/SHORTCUT_API_TOKEN are set
+ */
+export declare function isShortcutConfigured(db: Database.Database): boolean;
+/**
+ * Load Shortcut configuration from the database + environment.
+ * Returns null if not configured.
+ */
+export declare function loadShortcutConfig(db: Database.Database): ShortcutConfig | null;
+/**
+ * Save Shortcut configuration to the database.
+ */
+export declare function saveShortcutConfig(db: Database.Database, config: ShortcutConfig): void;
+/**
+ * Save the Shortcut API token.
+ */
+export declare function saveShortcutApiToken(db: Database.Database, apiToken: string): void;
+/**
+ * Save the Shortcut workspace slug.
+ */
+export declare function saveShortcutWorkspaceSlug(db: Database.Database, slug: string): void;
+/**
+ * Clear all Shortcut configuration from the database.
+ */
+export declare function clearShortcutConfig(db: Database.Database): void;
+/**
+ * Get the stored Shortcut API token.
+ * Also checks PRLT_SHORTCUT_API_TOKEN and SHORTCUT_API_TOKEN environment variables.
+ */
+export declare function getShortcutApiToken(db: Database.Database): string | null;