@proletariat/cli 0.3.55 → 0.3.56

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;

package/dist/lib/shortcut/config.js

@@ -0,0 +1,98 @@
+/**
+ * Shortcut Configuration Storage
+ *
+ * Stores Shortcut credentials and preferences in the workspace_settings table.
+ * Mirrors the Jira config module pattern.
+ */
+const SETTINGS_TABLE = 'workspace_settings';
+const SHORTCUT_CONFIG_KEYS = {
+    apiToken: 'shortcut.api_token',
+    workspaceSlug: 'shortcut.workspace_slug',
+};
+function getSetting(db, key) {
+    const row = db
+        .prepare(`SELECT value FROM ${SETTINGS_TABLE} WHERE key = ?`)
+        .get(key);
+    return row?.value ?? null;
+}
+function setSetting(db, key, value) {
+    db.prepare(`
+    INSERT INTO ${SETTINGS_TABLE} (key, value)
+    VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = excluded.value
+  `).run(key, value);
+}
+function deleteSetting(db, key) {
+    db.prepare(`DELETE FROM ${SETTINGS_TABLE} WHERE key = ?`).run(key);
+}
+/**
+ * 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 function isShortcutConfigured(db) {
+    const hasDbConfig = getSetting(db, SHORTCUT_CONFIG_KEYS.apiToken) !== null;
+    if (hasDbConfig)
+        return true;
+    const hasEnvToken = !!(process.env.PRLT_SHORTCUT_API_TOKEN || process.env.SHORTCUT_API_TOKEN);
+    return hasEnvToken;
+}
+/**
+ * Load Shortcut configuration from the database + environment.
+ * Returns null if not configured.
+ */
+export function loadShortcutConfig(db) {
+    const apiToken = getSetting(db, SHORTCUT_CONFIG_KEYS.apiToken)
+        || process.env.PRLT_SHORTCUT_API_TOKEN
+        || process.env.SHORTCUT_API_TOKEN;
+    if (!apiToken)
+        return null;
+    return {
+        apiToken,
+        workspaceSlug: getSetting(db, SHORTCUT_CONFIG_KEYS.workspaceSlug)
+            || process.env.PRLT_SHORTCUT_WORKSPACE
+            || process.env.SHORTCUT_WORKSPACE_SLUG
+            || undefined,
+    };
+}
+/**
+ * Save Shortcut configuration to the database.
+ */
+export function saveShortcutConfig(db, config) {
+    setSetting(db, SHORTCUT_CONFIG_KEYS.apiToken, config.apiToken);
+    if (config.workspaceSlug) {
+        setSetting(db, SHORTCUT_CONFIG_KEYS.workspaceSlug, config.workspaceSlug);
+    }
+}
+/**
+ * Save the Shortcut API token.
+ */
+export function saveShortcutApiToken(db, apiToken) {
+    setSetting(db, SHORTCUT_CONFIG_KEYS.apiToken, apiToken);
+}
+/**
+ * Save the Shortcut workspace slug.
+ */
+export function saveShortcutWorkspaceSlug(db, slug) {
+    setSetting(db, SHORTCUT_CONFIG_KEYS.workspaceSlug, slug);
+}
+/**
+ * Clear all Shortcut configuration from the database.
+ */
+export function clearShortcutConfig(db) {
+    for (const key of Object.values(SHORTCUT_CONFIG_KEYS)) {
+        deleteSetting(db, key);
+    }
+}
+/**
+ * Get the stored Shortcut API token.
+ * Also checks PRLT_SHORTCUT_API_TOKEN and SHORTCUT_API_TOKEN environment variables.
+ */
+export function getShortcutApiToken(db) {
+    const envKey = process.env.PRLT_SHORTCUT_API_TOKEN || process.env.SHORTCUT_API_TOKEN;
+    if (envKey)
+        return envKey;
+    return getSetting(db, SHORTCUT_CONFIG_KEYS.apiToken);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/shortcut/config.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Shortcut Integration Module
+ *
+ * Provides Shortcut configuration loading and validation.
+ */
+export { isShortcutConfigured, loadShortcutConfig, saveShortcutConfig, saveShortcutApiToken, saveShortcutWorkspaceSlug, clearShortcutConfig, getShortcutApiToken, } from './config.js';
+export type { ShortcutConfig } from './config.js';

package/dist/lib/shortcut/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shortcut Integration Module
+ *
+ * Provides Shortcut configuration loading and validation.
+ */
+export { isShortcutConfigured, loadShortcutConfig, saveShortcutConfig, saveShortcutApiToken, saveShortcutWorkspaceSlug, clearShortcutConfig, getShortcutApiToken, } from './config.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/shortcut/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAA"}

package/dist/lib/work-source/client.d.ts

@@ -0,0 +1,10 @@
+import type { NormalizedIssueEnvelope } from '../external-issues/types.js';
+import type { WorkSourceProvider } from './config.js';
+export interface WorkSourceClient {
+    readonly provider: WorkSourceProvider;
+    fetchByKey(key: string): Promise<NormalizedIssueEnvelope | null>;
+    buildTicketDescription(envelope: NormalizedIssueEnvelope): string;
+    buildMetadata(envelope: NormalizedIssueEnvelope): Record<string, string>;
+    buildSpawnContextMessage(envelope: NormalizedIssueEnvelope, additionalMessage?: string): string;
+}
+export declare function getWorkSourceClient(provider: WorkSourceProvider): WorkSourceClient | null;

package/dist/lib/work-source/client.js

@@ -0,0 +1,74 @@
+import { buildAsanaMetadata, buildAsanaSpawnContextMessage, buildAsanaTicketDescription, getAsanaTaskByGid, } from '../external-issues/asana.js';
+import { buildJiraMetadata, buildJiraSpawnContextMessage, buildJiraTicketDescription, getJiraIssueByKey, } from '../external-issues/jira.js';
+import { buildLinearMetadata, buildLinearSpawnContextMessage, buildLinearTicketDescription, getLinearIssueByIdentifier, } from '../external-issues/linear.js';
+import { buildShortcutMetadata, buildShortcutSpawnContextMessage, buildShortcutTicketDescription, getShortcutStoryByKey, } from '../external-issues/shortcut.js';
+class LinearWorkSourceClient {
+    provider = 'linear';
+    async fetchByKey(key) {
+        return getLinearIssueByIdentifier({}, key);
+    }
+    buildTicketDescription(envelope) {
+        return buildLinearTicketDescription(envelope);
+    }
+    buildMetadata(envelope) {
+        return buildLinearMetadata(envelope);
+    }
+    buildSpawnContextMessage(envelope, additionalMessage) {
+        return buildLinearSpawnContextMessage(envelope, additionalMessage);
+    }
+}
+class JiraWorkSourceClient {
+    provider = 'jira';
+    async fetchByKey(key) {
+        return getJiraIssueByKey({}, key);
+    }
+    buildTicketDescription(envelope) {
+        return buildJiraTicketDescription(envelope);
+    }
+    buildMetadata(envelope) {
+        return buildJiraMetadata(envelope);
+    }
+    buildSpawnContextMessage(envelope, additionalMessage) {
+        return buildJiraSpawnContextMessage(envelope, additionalMessage);
+    }
+}
+class AsanaWorkSourceClient {
+    provider = 'asana';
+    async fetchByKey(key) {
+        return getAsanaTaskByGid({}, key);
+    }
+    buildTicketDescription(envelope) {
+        return buildAsanaTicketDescription(envelope);
+    }
+    buildMetadata(envelope) {
+        return buildAsanaMetadata(envelope);
+    }
+    buildSpawnContextMessage(envelope, additionalMessage) {
+        return buildAsanaSpawnContextMessage(envelope, additionalMessage);
+    }
+}
+class ShortcutWorkSourceClient {
+    provider = 'shortcut';
+    async fetchByKey(key) {
+        return getShortcutStoryByKey({}, key);
+    }
+    buildTicketDescription(envelope) {
+        return buildShortcutTicketDescription(envelope);
+    }
+    buildMetadata(envelope) {
+        return buildShortcutMetadata(envelope);
+    }
+    buildSpawnContextMessage(envelope, additionalMessage) {
+        return buildShortcutSpawnContextMessage(envelope, additionalMessage);
+    }
+}
+const SOURCE_CLIENTS = {
+    linear: new LinearWorkSourceClient(),
+    jira: new JiraWorkSourceClient(),
+    asana: new AsanaWorkSourceClient(),
+    shortcut: new ShortcutWorkSourceClient(),
+};
+export function getWorkSourceClient(provider) {
+    return SOURCE_CLIENTS[provider] ?? null;
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/work-source/client.js.map

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

package/dist/lib/work-source/config.d.ts

@@ -1,5 +1,5 @@
 import Database from 'better-sqlite3';
-export declare const WORK_SOURCE_PROVIDERS: readonly ["pmo", "linear", "jira", "asana", "monday"];
+export declare const WORK_SOURCE_PROVIDERS: readonly ["pmo", "linear", "jira", "shortcut", "asana", "monday"];
 export type WorkSourceProvider = typeof WORK_SOURCE_PROVIDERS[number];
 export interface WorkSourceRef {
     provider: WorkSourceProvider;

package/dist/lib/work-source/config.js

@@ -1,8 +1,10 @@
+import { loadAsanaConfig } from '../asana/config.js';
 import { loadLinearConfig } from '../linear/config.js';
 import { loadJiraConfig } from '../jira/config.js';
+import { loadShortcutConfig } from '../shortcut/config.js';
 const SETTINGS_TABLE = 'workspace_settings';
 const ACTIVE_SOURCE_KEY = 'work.active_source';
-export const WORK_SOURCE_PROVIDERS = ['pmo', 'linear', 'jira', 'asana', 'monday'];
+export const WORK_SOURCE_PROVIDERS = ['pmo', 'linear', 'jira', 'shortcut', 'asana', 'monday'];
 function getSetting(db, key) {
     const row = db
         .prepare(`SELECT value FROM ${SETTINGS_TABLE} WHERE key = ?`)
@@ -74,6 +76,20 @@ export function getRegisteredWorkSources(db) {
             context: jiraConfig.projectKey ?? undefined,
         });
     }
+    const asanaConfig = loadAsanaConfig(db);
+    if (asanaConfig) {
+        providers.set('asana', {
+            provider: 'asana',
+            context: asanaConfig.projectName ?? asanaConfig.projectGid ?? undefined,
+        });
+    }
+    const shortcutConfig = loadShortcutConfig(db);
+    if (shortcutConfig) {
+        providers.set('shortcut', {
+            provider: 'shortcut',
+            context: shortcutConfig.workspaceSlug ?? undefined,
+        });
+    }
     return Array.from(providers.values());
 }
 //# sourceMappingURL=config.js.map