@proletariat/cli 0.3.65 → 0.3.67

package/dist/lib/registry/index.js

@@ -0,0 +1,169 @@
+/**
+ * Machine-level Agent Registry
+ *
+ * Tracks all agents across all projects in a single SQLite database
+ * at ~/.prlt/agents.db. This provides a global view of agent activity
+ * regardless of which workspace they belong to.
+ */
+import Database from 'better-sqlite3';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { throwIfNativeBindingError } from '../database/native-validation.js';
+// =============================================================================
+// Schema
+// =============================================================================
+const REGISTRY_SCHEMA = `
+CREATE TABLE IF NOT EXISTS agents (
+  agent_name TEXT NOT NULL,
+  project_path TEXT NOT NULL,
+  session_id TEXT,
+  ticket_id TEXT,
+  status TEXT NOT NULL DEFAULT 'running' CHECK (status IN ('running', 'idle', 'completed')),
+  spawned_at TEXT NOT NULL,
+  last_seen_at TEXT NOT NULL,
+  PRIMARY KEY (agent_name, project_path)
+);
+
+CREATE INDEX IF NOT EXISTS idx_registry_status ON agents(status);
+CREATE INDEX IF NOT EXISTS idx_registry_project ON agents(project_path);
+`;
+// =============================================================================
+// Helpers
+// =============================================================================
+function rowToMachineAgent(row) {
+    return {
+        agentName: row.agent_name,
+        projectPath: row.project_path,
+        sessionId: row.session_id,
+        ticketId: row.ticket_id,
+        status: row.status,
+        spawnedAt: row.spawned_at,
+        lastSeenAt: row.last_seen_at,
+    };
+}
+function getMachineRegistryPath() {
+    return path.join(os.homedir(), '.prlt', 'agents.db');
+}
+// =============================================================================
+// Database Access
+// =============================================================================
+/**
+ * Open (or create) the machine-level agent registry at ~/.prlt/agents.db.
+ * Ensures the ~/.prlt directory and schema exist.
+ */
+export function openMachineRegistry() {
+    const dbPath = getMachineRegistryPath();
+    const dir = path.dirname(dbPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    try {
+        const db = new Database(dbPath);
+        db.pragma('journal_mode = WAL');
+        db.pragma('busy_timeout = 3000');
+        db.exec(REGISTRY_SCHEMA);
+        return db;
+    }
+    catch (error) {
+        throwIfNativeBindingError(error, 'machine agent registry');
+        throw error;
+    }
+}
+// =============================================================================
+// Write Operations
+// =============================================================================
+/**
+ * Register an agent spawn in the machine registry.
+ * Uses INSERT OR REPLACE so re-spawning the same agent updates the record.
+ */
+export function registerAgent(params) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT OR REPLACE INTO agents (agent_name, project_path, session_id, ticket_id, status, spawned_at, last_seen_at)
+      VALUES (?, ?, ?, ?, 'running', ?, ?)
+    `).run(params.agentName, params.projectPath, params.sessionId ?? null, params.ticketId ?? null, now, now);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Update the status of an agent in the machine registry.
+ */
+export function updateAgentStatus(agentName, projectPath, status) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE agents SET status = ?, last_seen_at = ?
+      WHERE agent_name = ? AND project_path = ?
+    `).run(status, now, agentName, projectPath);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Touch the last_seen_at timestamp for a running agent.
+ */
+export function touchAgentLastSeen(agentName, projectPath) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE agents SET last_seen_at = ?
+      WHERE agent_name = ? AND project_path = ?
+    `).run(now, agentName, projectPath);
+    }
+    finally {
+        db.close();
+    }
+}
+// =============================================================================
+// Read Operations
+// =============================================================================
+/**
+ * Get all agents in the machine registry, optionally filtered.
+ */
+export function getMachineAgents(filters) {
+    const db = openMachineRegistry();
+    try {
+        let sql = 'SELECT * FROM agents';
+        const conditions = [];
+        const params = [];
+        if (filters?.status) {
+            conditions.push('status = ?');
+            params.push(filters.status);
+        }
+        if (filters?.projectPath) {
+            conditions.push('project_path = ?');
+            params.push(filters.projectPath);
+        }
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY last_seen_at DESC';
+        const rows = db.prepare(sql).all(...params);
+        return rows.map(rowToMachineAgent);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Get a single agent by name and project path.
+ */
+export function getMachineAgent(agentName, projectPath) {
+    const db = openMachineRegistry();
+    try {
+        const row = db.prepare('SELECT * FROM agents WHERE agent_name = ? AND project_path = ?').get(agentName, projectPath);
+        return row ? rowToMachineAgent(row) : undefined;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/lib/work-lifecycle/events.d.ts

@@ -42,6 +42,17 @@ export interface WorkPRCreatedEvent {
     prTitle: string | null;
     timestamp: Date;
 }
+/** Emitted when a PR linked to a work item is merged. */
+export interface WorkPRMergedEvent {
+    workItemId: string;
+    source: WorkEventSource;
+    projectId?: string;
+    prNumber: number;
+    prTitle: string | null;
+    prUrl: string | null;
+    mergeMethod: string;
+    timestamp: Date;
+}
 /** Emitted when work on an item is completed (status moved to 'completed' category). */
 export interface WorkCompletedEvent {
     workItemId: string;

package/dist/lib/work-lifecycle/hooks/executor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Hook Executor
+ *
+ * Executes hook actions (shell commands, webhooks, log messages) when
+ * work lifecycle events fire. Each action type has its own execution logic.
+ *
+ * Shell commands receive event data as environment variables prefixed with
+ * PRLT_HOOK_. Webhook actions POST event data as JSON. Log actions print
+ * interpolated messages to stdout.
+ */
+import type { WorkHookConfig, HookExecutionResult } from './types.js';
+/**
+ * Execute a single hook action and return the result.
+ */
+export declare function executeHook(hook: WorkHookConfig, eventName: string, eventData: Record<string, unknown>): HookExecutionResult;

package/dist/lib/work-lifecycle/hooks/executor.js

@@ -0,0 +1,102 @@
+/**
+ * Hook Executor
+ *
+ * Executes hook actions (shell commands, webhooks, log messages) when
+ * work lifecycle events fire. Each action type has its own execution logic.
+ *
+ * Shell commands receive event data as environment variables prefixed with
+ * PRLT_HOOK_. Webhook actions POST event data as JSON. Log actions print
+ * interpolated messages to stdout.
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Build environment variables from event data for shell hook execution.
+ * All keys are uppercased and prefixed with PRLT_HOOK_.
+ */
+function buildEnvVars(eventName, eventData) {
+    const env = {
+        PRLT_HOOK_EVENT: eventName,
+    };
+    for (const [key, value] of Object.entries(eventData)) {
+        if (value === null || value === undefined)
+            continue;
+        const envKey = `PRLT_HOOK_${key.replace(/([A-Z])/g, '_$1').toUpperCase()}`;
+        if (value instanceof Date) {
+            env[envKey] = value.toISOString();
+        }
+        else {
+            env[envKey] = String(value);
+        }
+    }
+    return env;
+}
+/**
+ * Interpolate {{variable}} placeholders in a string with event data.
+ */
+function interpolate(template, eventName, eventData) {
+    let result = template.replace(/\{\{event\}\}/g, eventName);
+    for (const [key, value] of Object.entries(eventData)) {
+        if (value === null || value === undefined)
+            continue;
+        const strValue = value instanceof Date ? value.toISOString() : String(value);
+        result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), strValue);
+    }
+    return result;
+}
+/**
+ * Execute a single hook action and return the result.
+ */
+export function executeHook(hook, eventName, eventData) {
+    const start = Date.now();
+    try {
+        switch (hook.actionType) {
+            case 'shell': {
+                const env = {
+                    ...process.env,
+                    ...buildEnvVars(eventName, eventData),
+                };
+                execSync(hook.actionValue, {
+                    env,
+                    timeout: 30_000, // 30 second timeout
+                    stdio: 'pipe',
+                });
+                break;
+            }
+            case 'webhook': {
+                // Fire-and-forget POST to the configured URL
+                const body = JSON.stringify({
+                    event: eventName,
+                    data: eventData,
+                    hook: { id: hook.id, name: hook.name },
+                    timestamp: new Date().toISOString(),
+                });
+                // Use synchronous fetch via execSync to keep it simple
+                // This avoids async complexity in the event handler
+                execSync(`curl -s -X POST -H "Content-Type: application/json" -d '${body.replace(/'/g, "'\\''")}' '${hook.actionValue}'`, { timeout: 10_000, stdio: 'pipe' });
+                break;
+            }
+            case 'log': {
+                const message = interpolate(hook.actionValue, eventName, eventData);
+                // eslint-disable-next-line no-console
+                console.log(`[hook:${hook.name}] ${message}`);
+                break;
+            }
+        }
+        return {
+            hookId: hook.id,
+            hookName: hook.name,
+            success: true,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            hookId: hook.id,
+            hookName: hook.name,
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/lib/work-lifecycle/hooks/executor.js.map

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

package/dist/lib/work-lifecycle/hooks/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Work Lifecycle Hooks — public API.
+ *
+ * Configurable event-driven actions for work lifecycle events.
+ * Hooks subscribe to the EventBus and execute user-configured
+ * actions (shell commands, webhooks, log messages) when events fire.
+ */
+export type { HookableEvent, HookActionType, WorkHookConfig, WorkHookRow, HookExecutionResult, } from './types.js';
+export { HOOKABLE_EVENTS } from './types.js';
+export { WorkHookStorage, HOOKS_TABLE, HOOKS_TABLE_SCHEMA, HOOKS_TABLE_INDEX, ensureHooksTable, } from './storage.js';
+export { executeHook } from './executor.js';
+export { HookManager, initHookManager, stopHookManager, } from './manager.js';

package/dist/lib/work-lifecycle/hooks/index.js

@@ -0,0 +1,12 @@
+/**
+ * Work Lifecycle Hooks — public API.
+ *
+ * Configurable event-driven actions for work lifecycle events.
+ * Hooks subscribe to the EventBus and execute user-configured
+ * actions (shell commands, webhooks, log messages) when events fire.
+ */
+export { HOOKABLE_EVENTS } from './types.js';
+export { WorkHookStorage, HOOKS_TABLE, HOOKS_TABLE_SCHEMA, HOOKS_TABLE_INDEX, ensureHooksTable, } from './storage.js';
+export { executeHook } from './executor.js';
+export { HookManager, initHookManager, stopHookManager, } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/work-lifecycle/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/work-lifecycle/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EACL,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACL,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAA"}

package/dist/lib/work-lifecycle/hooks/manager.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Work Lifecycle Hook Manager
+ *
+ * Subscribes to work lifecycle events on the global EventBus and
+ * executes matching hook configurations from the database.
+ *
+ * Hooks are fire-and-forget: execution failures are logged but never
+ * block the caller or break the event emission chain.
+ */
+import type Database from 'better-sqlite3';
+/**
+ * HookManager loads hook configs from the database and subscribes to
+ * the global EventBus. When a hookable event fires, it finds all
+ * enabled hooks for that event and executes them.
+ */
+export declare class HookManager {
+    private unsubscribers;
+    private hookStorage;
+    constructor(db: Database.Database);
+    /**
+     * Start listening for hookable events on the global EventBus.
+     * For each event, looks up enabled hooks and executes them.
+     */
+    start(): void;
+    /**
+     * Stop listening for events and clean up subscriptions.
+     */
+    stop(): void;
+    /**
+     * Handle a hookable event by executing all matching enabled hooks.
+     * Hook failures are swallowed to avoid breaking the event chain.
+     */
+    private handleEvent;
+}
+/**
+ * Initialize and start the hook manager.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export declare function initHookManager(db: Database.Database): HookManager;
+/**
+ * Stop the hook manager (primarily for testing).
+ */
+export declare function stopHookManager(): void;

package/dist/lib/work-lifecycle/hooks/manager.js

@@ -0,0 +1,93 @@
+/**
+ * Work Lifecycle Hook Manager
+ *
+ * Subscribes to work lifecycle events on the global EventBus and
+ * executes matching hook configurations from the database.
+ *
+ * Hooks are fire-and-forget: execution failures are logged but never
+ * block the caller or break the event emission chain.
+ */
+import { getEventBus } from '../../events/event-bus.js';
+import { WorkHookStorage } from './storage.js';
+import { executeHook } from './executor.js';
+import { HOOKABLE_EVENTS } from './types.js';
+/**
+ * HookManager loads hook configs from the database and subscribes to
+ * the global EventBus. When a hookable event fires, it finds all
+ * enabled hooks for that event and executes them.
+ */
+export class HookManager {
+    unsubscribers = [];
+    hookStorage;
+    constructor(db) {
+        this.hookStorage = new WorkHookStorage(db);
+    }
+    /**
+     * Start listening for hookable events on the global EventBus.
+     * For each event, looks up enabled hooks and executes them.
+     */
+    start() {
+        const bus = getEventBus();
+        for (const eventName of HOOKABLE_EVENTS) {
+            this.unsubscribers.push(bus.on(eventName, (payload) => {
+                this.handleEvent(eventName, payload);
+            }));
+        }
+    }
+    /**
+     * Stop listening for events and clean up subscriptions.
+     */
+    stop() {
+        for (const unsub of this.unsubscribers) {
+            unsub();
+        }
+        this.unsubscribers = [];
+    }
+    /**
+     * Handle a hookable event by executing all matching enabled hooks.
+     * Hook failures are swallowed to avoid breaking the event chain.
+     */
+    handleEvent(eventName, eventData) {
+        try {
+            const hooks = this.hookStorage.list({ event: eventName, enabled: true });
+            if (hooks.length === 0)
+                return;
+            for (const hook of hooks) {
+                try {
+                    executeHook(hook, eventName, eventData);
+                }
+                catch {
+                    // Hook execution errors are non-fatal
+                }
+            }
+        }
+        catch {
+            // Storage errors are non-fatal
+        }
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let _manager;
+/**
+ * Initialize and start the hook manager.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export function initHookManager(db) {
+    if (!_manager) {
+        _manager = new HookManager(db);
+        _manager.start();
+    }
+    return _manager;
+}
+/**
+ * Stop the hook manager (primarily for testing).
+ */
+export function stopHookManager() {
+    if (_manager) {
+        _manager.stop();
+        _manager = undefined;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/lib/work-lifecycle/hooks/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/lib/work-lifecycle/hooks/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAA;AAEhE;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACd,aAAa,GAAsB,EAAE,CAAA;IACrC,WAAW,CAAiB;IAEpC,YAAY,EAAqB;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;QAEzB,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC5B,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAA6C,CAAC,CAAA;YAC5E,CAAC,CAAC,CACH,CAAA;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;IACzB,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,SAAwB,EAAE,SAAkC;QAC9E,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;CACF;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,IAAI,QAAiC,CAAA;AAErC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,EAAqB;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAA;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAA;IAClB,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,EAAE,CAAA;QACf,QAAQ,GAAG,SAAS,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/lib/work-lifecycle/hooks/storage.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Work Lifecycle Hook Storage
+ *
+ * CRUD operations for hook configurations in the workspace database.
+ * Hooks are stored in the pmo_work_hooks table.
+ */
+import type Database from 'better-sqlite3';
+import type { WorkHookConfig, HookableEvent, HookActionType } from './types.js';
+/** Table name for work hooks. */
+export declare const HOOKS_TABLE = "pmo_work_hooks";
+/** SQL to create the hooks table. */
+export declare const HOOKS_TABLE_SCHEMA = "\n  CREATE TABLE IF NOT EXISTS pmo_work_hooks (\n    id TEXT PRIMARY KEY,\n    name TEXT NOT NULL UNIQUE,\n    event TEXT NOT NULL,\n    action_type TEXT NOT NULL CHECK (action_type IN ('shell', 'webhook', 'log')),\n    action_value TEXT NOT NULL,\n    enabled INTEGER NOT NULL DEFAULT 1,\n    description TEXT,\n    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n  )\n";
+export declare const HOOKS_TABLE_INDEX = "\n  CREATE INDEX IF NOT EXISTS idx_pmo_work_hooks_event ON pmo_work_hooks(event);\n  CREATE INDEX IF NOT EXISTS idx_pmo_work_hooks_enabled ON pmo_work_hooks(enabled);\n";
+/**
+ * Ensure the hooks table exists in the database.
+ * Safe to call multiple times.
+ */
+export declare function ensureHooksTable(db: Database.Database): void;
+/**
+ * WorkHookStorage provides CRUD operations for hook configurations.
+ */
+export declare class WorkHookStorage {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * List all hooks, optionally filtered by event name or enabled status.
+     */
+    list(options?: {
+        event?: HookableEvent;
+        enabled?: boolean;
+    }): WorkHookConfig[];
+    /**
+     * Get a single hook by ID.
+     */
+    getById(id: string): WorkHookConfig | null;
+    /**
+     * Get a single hook by name.
+     */
+    getByName(name: string): WorkHookConfig | null;
+    /**
+     * Create a new hook configuration.
+     */
+    create(params: {
+        name: string;
+        event: HookableEvent;
+        actionType: HookActionType;
+        actionValue: string;
+        description?: string;
+    }): WorkHookConfig;
+    /**
+     * Delete a hook by ID.
+     */
+    delete(id: string): boolean;
+    /**
+     * Enable or disable a hook.
+     */
+    setEnabled(id: string, enabled: boolean): boolean;
+}

package/dist/lib/work-lifecycle/hooks/storage.js

@@ -0,0 +1,117 @@
+/**
+ * Work Lifecycle Hook Storage
+ *
+ * CRUD operations for hook configurations in the workspace database.
+ * Hooks are stored in the pmo_work_hooks table.
+ */
+import { randomUUID } from 'node:crypto';
+/** Table name for work hooks. */
+export const HOOKS_TABLE = 'pmo_work_hooks';
+/** SQL to create the hooks table. */
+export const HOOKS_TABLE_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS ${HOOKS_TABLE} (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    event TEXT NOT NULL,
+    action_type TEXT NOT NULL CHECK (action_type IN ('shell', 'webhook', 'log')),
+    action_value TEXT NOT NULL,
+    enabled INTEGER NOT NULL DEFAULT 1,
+    description TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+  )
+`;
+export const HOOKS_TABLE_INDEX = `
+  CREATE INDEX IF NOT EXISTS idx_pmo_work_hooks_event ON ${HOOKS_TABLE}(event);
+  CREATE INDEX IF NOT EXISTS idx_pmo_work_hooks_enabled ON ${HOOKS_TABLE}(enabled);
+`;
+/**
+ * Ensure the hooks table exists in the database.
+ * Safe to call multiple times.
+ */
+export function ensureHooksTable(db) {
+    db.exec(HOOKS_TABLE_SCHEMA);
+    db.exec(HOOKS_TABLE_INDEX);
+}
+/**
+ * Convert a database row to a WorkHookConfig.
+ */
+function rowToConfig(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        event: row.event,
+        actionType: row.action_type,
+        actionValue: row.action_value,
+        enabled: row.enabled === 1,
+        description: row.description,
+        createdAt: row.created_at,
+    };
+}
+/**
+ * WorkHookStorage provides CRUD operations for hook configurations.
+ */
+export class WorkHookStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+        ensureHooksTable(db);
+    }
+    /**
+     * List all hooks, optionally filtered by event name or enabled status.
+     */
+    list(options) {
+        let sql = `SELECT * FROM ${HOOKS_TABLE} WHERE 1=1`;
+        const params = [];
+        if (options?.event) {
+            sql += ' AND event = ?';
+            params.push(options.event);
+        }
+        if (options?.enabled !== undefined) {
+            sql += ' AND enabled = ?';
+            params.push(options.enabled ? 1 : 0);
+        }
+        sql += ' ORDER BY created_at ASC';
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToConfig);
+    }
+    /**
+     * Get a single hook by ID.
+     */
+    getById(id) {
+        const row = this.db.prepare(`SELECT * FROM ${HOOKS_TABLE} WHERE id = ?`).get(id);
+        return row ? rowToConfig(row) : null;
+    }
+    /**
+     * Get a single hook by name.
+     */
+    getByName(name) {
+        const row = this.db.prepare(`SELECT * FROM ${HOOKS_TABLE} WHERE name = ?`).get(name);
+        return row ? rowToConfig(row) : null;
+    }
+    /**
+     * Create a new hook configuration.
+     */
+    create(params) {
+        const id = randomUUID();
+        this.db.prepare(`
+      INSERT INTO ${HOOKS_TABLE} (id, name, event, action_type, action_value, description)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, params.name, params.event, params.actionType, params.actionValue, params.description ?? null);
+        return this.getById(id);
+    }
+    /**
+     * Delete a hook by ID.
+     */
+    delete(id) {
+        const result = this.db.prepare(`DELETE FROM ${HOOKS_TABLE} WHERE id = ?`).run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Enable or disable a hook.
+     */
+    setEnabled(id, enabled) {
+        const result = this.db.prepare(`UPDATE ${HOOKS_TABLE} SET enabled = ? WHERE id = ?`).run(enabled ? 1 : 0, id);
+        return result.changes > 0;
+    }
+}
+//# sourceMappingURL=storage.js.map