@proletariat/cli 0.3.102 → 0.3.103

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

@@ -1,22 +1,61 @@
 /**
  * Work Lifecycle Hook Manager
  *
+ * The single hook execution system for the entire application.
  * Subscribes to work lifecycle events on the global EventBus and
- * executes matching hook configurations from the database.
+ * executes matching hook configurations from the database with
+ * mode-aware behavior (auto/confirm/notify/off).
  *
- * Hooks are fire-and-forget: execution failures are logged but never
- * block the caller or break the event emission chain.
+ * Used by both the interactive CLI (with default auto mode) and
+ * the orchestrate daemon (with full mode/callback support).
+ *
+ * Hooks are fire-and-forget when triggered via EventBus: execution
+ * failures are logged but never block the caller or break the event
+ * emission chain.
  */
 import type Database from 'better-sqlite3';
+import { type HookExecutionResult, type HookActionHandler, type WorkHookConfig } from './types.js';
+/**
+ * Options for creating a HookManager.
+ */
+export interface HookManagerOptions {
+    /** Database connection */
+    db: Database.Database;
+    /** Logger function */
+    log?: (msg: string) => void;
+    /** Callback for confirm-mode hooks (returns true to approve) */
+    onConfirm?: (hookName: string, event: string, action: string) => Promise<boolean>;
+    /** Callback for notifications (notify-mode hooks) */
+    onNotify?: (hookName: string, event: string, action: string, result: HookExecutionResult) => void;
+    /**
+     * Built-in action handlers (e.g., merge-pr, spawn-agent).
+     * When a hook's action resolves to a key in this map, the handler
+     * is called instead of shell/webhook/log execution.
+     */
+    actionHandlers?: Record<string, HookActionHandler>;
+}
+interface PendingConfirmation {
+    hookName: string;
+    event: string;
+    action: string;
+    ctx: Record<string, unknown>;
+    config?: Record<string, unknown>;
+}
 /**
  * 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.
+ * enabled hooks for that event and executes them with mode-aware behavior.
  */
 export declare class HookManager {
     private unsubscribers;
     private hookStorage;
-    constructor(db: Database.Database);
+    private db;
+    private log;
+    private onConfirm?;
+    private onNotify?;
+    private actionHandlers;
+    private _pendingConfirmations;
+    constructor(options: HookManagerOptions);
     /**
      * Start listening for hookable events on the global EventBus.
      * For each event, looks up enabled hooks and executes them.
@@ -27,17 +66,63 @@ export declare class HookManager {
      */
     stop(): void;
     /**
-     * Handle a hookable event by executing all matching enabled hooks.
-     * Hook failures are swallowed to avoid breaking the event chain.
+     * Fire an event explicitly (used by orchestrate daemon and `prlt hook fire`).
+     * Returns the execution results for all matching hooks.
+     */
+    fireEvent(event: string, eventData: Record<string, unknown>): Promise<HookExecutionResult[]>;
+    /**
+     * Get pending confirmations for hooks in confirm mode.
+     */
+    getPendingConfirmations(): PendingConfirmation[];
+    /**
+     * Approve a pending confirmation and execute it.
+     */
+    approveConfirmation(index: number): Promise<HookExecutionResult | null>;
+    /**
+     * Deny a pending confirmation.
+     */
+    denyConfirmation(index: number): boolean;
+    /**
+     * Build a context object from raw event data.
+     * Normalizes common field names for built-in action handlers.
+     *
+     * Public so it can be tested in isolation.
+     */
+    static buildContext(eventName: string, data: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Resolve the action name from a hook config and a set of known action handlers.
+     *
+     * - If the action_value contains `--action <name>`, extracts the name
+     * - If the action_value is a known built-in action, uses it directly
+     * - Otherwise uses the raw action_value (shell command)
+     *
+     * Public so it can be tested in isolation.
+     */
+    static resolveActionName(hook: WorkHookConfig, knownActions?: Record<string, unknown>): string;
+    /**
+     * Handle an event by finding and executing all matching enabled hooks.
+     * Supports mode-aware execution: auto, confirm, notify, off.
      */
     private handleEvent;
+    /**
+     * Execute a hook action — either via a built-in handler or the standard executor.
+     */
+    private executeHookAction;
+    /**
+     * Execute an action by name (used for approved confirmations).
+     */
+    private executeActionByName;
 }
 /**
  * Initialize and start the hook manager.
  * Safe to call multiple times — subsequent calls are no-ops.
+ *
+ * When called with just a db (interactive CLI), hooks default to auto mode.
+ * Pass additional options for mode-aware execution (orchestrate daemon).
  */
-export declare function initHookManager(db: Database.Database): HookManager;
+export declare function initHookManager(db: Database.Database, options?: Omit<HookManagerOptions, 'db'>): HookManager;
 /**
  * Stop the hook manager (primarily for testing).
  */
 export declare function stopHookManager(): void;
+export {};

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

@@ -1,26 +1,47 @@
 /**
  * Work Lifecycle Hook Manager
  *
+ * The single hook execution system for the entire application.
  * Subscribes to work lifecycle events on the global EventBus and
- * executes matching hook configurations from the database.
+ * executes matching hook configurations from the database with
+ * mode-aware behavior (auto/confirm/notify/off).
  *
- * Hooks are fire-and-forget: execution failures are logged but never
- * block the caller or break the event emission chain.
+ * Used by both the interactive CLI (with default auto mode) and
+ * the orchestrate daemon (with full mode/callback support).
+ *
+ * Hooks are fire-and-forget when triggered via EventBus: execution
+ * failures are logged but never block the caller or break the event
+ * emission chain.
  */
+import { execSync } from 'node:child_process';
 import { getEventBus } from '../../events/event-bus.js';
 import { WorkHookStorage } from './storage.js';
 import { executeHook } from './executor.js';
-import { HOOKABLE_EVENTS } from './types.js';
+import { HOOKABLE_EVENTS, } from './types.js';
+// =============================================================================
+// Manager
+// =============================================================================
 /**
  * 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.
+ * enabled hooks for that event and executes them with mode-aware behavior.
  */
 export class HookManager {
     unsubscribers = [];
     hookStorage;
-    constructor(db) {
-        this.hookStorage = new WorkHookStorage(db);
+    db;
+    log;
+    onConfirm;
+    onNotify;
+    actionHandlers;
+    _pendingConfirmations = [];
+    constructor(options) {
+        this.db = options.db;
+        this.hookStorage = new WorkHookStorage(options.db);
+        this.log = options.log ?? (() => { });
+        this.onConfirm = options.onConfirm;
+        this.onNotify = options.onNotify;
+        this.actionHandlers = options.actionHandlers ?? {};
     }
     /**
      * Start listening for hookable events on the global EventBus.
@@ -30,7 +51,7 @@ export class HookManager {
         const bus = getEventBus();
         for (const eventName of HOOKABLE_EVENTS) {
             this.unsubscribers.push(bus.on(eventName, (payload) => {
-                this.handleEvent(eventName, payload);
+                void this.handleEvent(eventName, payload);
             }));
         }
     }
@@ -42,27 +63,231 @@ export class HookManager {
             unsub();
         }
         this.unsubscribers = [];
+        this._pendingConfirmations = [];
+    }
+    /**
+     * Fire an event explicitly (used by orchestrate daemon and `prlt hook fire`).
+     * Returns the execution results for all matching hooks.
+     */
+    async fireEvent(event, eventData) {
+        return this.handleEvent(event, eventData);
+    }
+    /**
+     * Get pending confirmations for hooks in confirm mode.
+     */
+    getPendingConfirmations() {
+        return [...this._pendingConfirmations];
+    }
+    /**
+     * Approve a pending confirmation and execute it.
+     */
+    async approveConfirmation(index) {
+        if (index < 0 || index >= this._pendingConfirmations.length)
+            return null;
+        const pending = this._pendingConfirmations.splice(index, 1)[0];
+        const result = this.executeActionByName(pending.action, pending.ctx, pending.config);
+        this.log(`[hooks] Approved: ${pending.hookName} → ${pending.action} (${result.success ? 'success' : 'failed'})`);
+        return result;
+    }
+    /**
+     * Deny a pending confirmation.
+     */
+    denyConfirmation(index) {
+        if (index < 0 || index >= this._pendingConfirmations.length)
+            return false;
+        const pending = this._pendingConfirmations.splice(index, 1)[0];
+        this.log(`[hooks] Denied: ${pending.hookName} → ${pending.action}`);
+        return true;
+    }
+    // ===========================================================================
+    // Testable Utilities (public for PRLT-1223 test suite)
+    // ===========================================================================
+    /**
+     * Build a context object from raw event data.
+     * Normalizes common field names for built-in action handlers.
+     *
+     * Public so it can be tested in isolation.
+     */
+    static buildContext(eventName, data) {
+        return {
+            event: eventName,
+            ticket: (data.ticketId ?? data.workItemId ?? data.ticket),
+            pr: (data.prNumber ?? data.pr),
+            branch: data.branch,
+            agent: (data.agentName ?? data.agent ?? data.sessionId),
+            container: data.containerId,
+            executionId: data.executionId,
+            prUrl: data.prUrl,
+            projectId: data.projectId,
+            ...data,
+        };
     }
     /**
-     * Handle a hookable event by executing all matching enabled hooks.
-     * Hook failures are swallowed to avoid breaking the event chain.
+     * Resolve the action name from a hook config and a set of known action handlers.
+     *
+     * - If the action_value contains `--action <name>`, extracts the name
+     * - If the action_value is a known built-in action, uses it directly
+     * - Otherwise uses the raw action_value (shell command)
+     *
+     * Public so it can be tested in isolation.
      */
-    handleEvent(eventName, eventData) {
+    static resolveActionName(hook, knownActions = {}) {
+        // If the action_value contains --action, extract the action name
+        const actionMatch = hook.actionValue.match(/--action\s+(\S+)/);
+        if (actionMatch)
+            return actionMatch[1];
+        // If it's a known built-in action name directly
+        if (knownActions[hook.actionValue])
+            return hook.actionValue;
+        // Otherwise it's a raw shell command — use the action_value as-is
+        return hook.actionValue;
+    }
+    // ===========================================================================
+    // Private
+    // ===========================================================================
+    /**
+     * Handle an event by finding and executing all matching enabled hooks.
+     * Supports mode-aware execution: auto, confirm, notify, off.
+     */
+    async handleEvent(eventName, eventData) {
+        const results = [];
         try {
             const hooks = this.hookStorage.list({ event: eventName, enabled: true });
             if (hooks.length === 0)
-                return;
+                return results;
+            // Build context from the payload
+            const ctx = HookManager.buildContext(eventName, eventData);
             for (const hook of hooks) {
-                try {
-                    executeHook(hook, eventName, eventData);
+                const mode = hook.mode || 'auto';
+                const actionName = HookManager.resolveActionName(hook, this.actionHandlers);
+                // --- off: skip silently ---
+                if (mode === 'off') {
+                    results.push({
+                        hookId: hook.id,
+                        hookName: hook.name,
+                        action: actionName,
+                        success: true,
+                        durationMs: 0,
+                        skipped: true,
+                    });
+                    continue;
+                }
+                // --- confirm: require approval ---
+                if (mode === 'confirm') {
+                    if (this.onConfirm) {
+                        const approved = await this.onConfirm(hook.name, eventName, actionName);
+                        if (!approved) {
+                            this.log(`[hooks] Skipped (not confirmed): ${hook.name} → ${actionName}`);
+                            results.push({
+                                hookId: hook.id,
+                                hookName: hook.name,
+                                action: actionName,
+                                success: true,
+                                durationMs: 0,
+                                skipped: true,
+                            });
+                            continue;
+                        }
+                        // Approved — fall through to execution
+                    }
+                    else {
+                        // No confirm handler — queue for later approval
+                        this._pendingConfirmations.push({
+                            hookName: hook.name,
+                            event: eventName,
+                            action: actionName,
+                            ctx,
+                            config: hook.config ?? undefined,
+                        });
+                        this.log(`[hooks] Queued for confirmation: ${hook.name} → ${actionName}`);
+                        results.push({
+                            hookId: hook.id,
+                            hookName: hook.name,
+                            action: actionName,
+                            success: true,
+                            durationMs: 0,
+                            awaitingConfirmation: true,
+                        });
+                        continue;
+                    }
                 }
-                catch {
-                    // Hook execution errors are non-fatal
+                // --- auto / notify / confirmed: execute ---
+                const result = this.executeHookAction(hook, eventName, eventData, ctx);
+                results.push(result);
+                this.log(`[hooks] ${hook.name} → ${actionName}: ${result.success ? 'success' : `failed: ${result.error}`} (${result.durationMs}ms)`);
+                // For notify mode, also fire the notification callback
+                if (mode === 'notify' && this.onNotify) {
+                    this.onNotify(hook.name, eventName, actionName, result);
                 }
             }
         }
-        catch {
-            // Storage errors are non-fatal
+        catch (err) {
+            this.log(`[hooks] Error handling event ${eventName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return results;
+    }
+    /**
+     * Execute a hook action — either via a built-in handler or the standard executor.
+     */
+    executeHookAction(hook, eventName, eventData, ctx) {
+        const actionName = HookManager.resolveActionName(hook, this.actionHandlers);
+        // Try built-in action handler first
+        if (this.actionHandlers[actionName]) {
+            const handlerResult = this.actionHandlers[actionName](ctx, hook.config ?? undefined);
+            return {
+                hookId: hook.id,
+                hookName: hook.name,
+                action: handlerResult.action,
+                success: handlerResult.success,
+                error: handlerResult.error,
+                durationMs: handlerResult.durationMs,
+                skipped: handlerResult.skipped,
+            };
+        }
+        // For shell/webhook/log hooks, use the standard executor
+        const result = executeHook(hook, eventName, eventData);
+        return {
+            ...result,
+            action: actionName,
+        };
+    }
+    /**
+     * Execute an action by name (used for approved confirmations).
+     */
+    executeActionByName(actionName, ctx, config) {
+        // Try built-in action handler first
+        if (this.actionHandlers[actionName]) {
+            const handlerResult = this.actionHandlers[actionName](ctx, config);
+            return {
+                hookId: '',
+                hookName: '',
+                action: handlerResult.action,
+                success: handlerResult.success,
+                error: handlerResult.error,
+                durationMs: handlerResult.durationMs,
+                skipped: handlerResult.skipped,
+            };
+        }
+        // Fallback to shell execution
+        const start = Date.now();
+        try {
+            const env = {
+                ...process.env,
+                PRLT_HOOK_EVENT: ctx.event ?? '',
+                PRLT_HOOK_TICKET: ctx.ticket ?? '',
+                PRLT_HOOK_PR: ctx.pr ? String(ctx.pr) : '',
+                PRLT_HOOK_BRANCH: ctx.branch ?? '',
+                PRLT_HOOK_AGENT: ctx.agent ?? '',
+            };
+            execSync(actionName, { env, timeout: 30_000, stdio: 'pipe' });
+            return { hookId: '', hookName: '', action: actionName, success: true, durationMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                hookId: '', hookName: '', action: actionName, success: false,
+                error: err instanceof Error ? err.message : String(err),
+                durationMs: Date.now() - start,
+            };
         }
     }
 }
@@ -73,10 +298,13 @@ let _manager;
 /**
  * Initialize and start the hook manager.
  * Safe to call multiple times — subsequent calls are no-ops.
+ *
+ * When called with just a db (interactive CLI), hooks default to auto mode.
+ * Pass additional options for mode-aware execution (orchestrate daemon).
  */
-export function initHookManager(db) {
+export function initHookManager(db, options) {
     if (!_manager) {
-        _manager = new HookManager(db);
+        _manager = new HookManager({ db, ...options });
         _manager.start();
     }
     return _manager;

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

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

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

@@ -24,6 +24,7 @@ export declare class WorkHookStorage {
     constructor(db: Database.Database);
     /**
      * List all hooks, optionally filtered by event name or enabled status.
+     * Returns hooks ordered by priority (ascending), then creation time.
      */
     list(options?: {
         event?: HookableEvent;

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

@@ -36,6 +36,15 @@ export function ensureHooksTable(db) {
  * Convert a database row to a WorkHookConfig.
  */
 function rowToConfig(row) {
+    let config = null;
+    if (row.config) {
+        try {
+            config = JSON.parse(row.config);
+        }
+        catch {
+            // Invalid JSON — ignore
+        }
+    }
     return {
         id: row.id,
         name: row.name,
@@ -45,6 +54,9 @@ function rowToConfig(row) {
         enabled: row.enabled === 1,
         description: row.description,
         createdAt: row.created_at,
+        mode: row.mode || 'auto',
+        priority: row.priority ?? 0,
+        config,
     };
 }
 /**
@@ -58,21 +70,31 @@ export class WorkHookStorage {
     }
     /**
      * List all hooks, optionally filtered by event name or enabled status.
+     * Returns hooks ordered by priority (ascending), then creation time.
      */
     list(options) {
-        let sql = `SELECT * FROM ${HOOKS_TABLE} WHERE 1=1`;
         const params = [];
+        let where = ' WHERE 1=1';
         if (options?.event) {
-            sql += ' AND event = ?';
+            where += ' AND event = ?';
             params.push(options.event);
         }
         if (options?.enabled !== undefined) {
-            sql += ' AND enabled = ?';
+            where += ' 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);
+        // Try extended query with mode/priority/config columns first
+        try {
+            const sql = `SELECT id, name, event, action_type, action_value, enabled, description, created_at, mode, priority, config FROM ${HOOKS_TABLE}${where} ORDER BY priority ASC, created_at ASC`;
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(rowToConfig);
+        }
+        catch {
+            // Fallback without mode/priority/config (pre-migration)
+            const sql = `SELECT id, name, event, action_type, action_value, enabled, description, created_at FROM ${HOOKS_TABLE}${where} ORDER BY created_at ASC`;
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(rowToConfig);
+        }
     }
     /**
      * Get a single hook by ID.

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

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

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

@@ -22,6 +22,17 @@ export declare const HOOKABLE_EVENTS: HookableEvent[];
  * - log: Write a message to stdout (useful for notifications/debugging)
  */
 export type HookActionType = 'shell' | 'webhook' | 'log';
+/**
+ * Automation mode for a hook.
+ *
+ * - auto: fires immediately, no human needed
+ * - confirm: pauses, waits for approval before executing
+ * - notify: fires immediately but also sends a notification
+ * - off: disabled, skipped silently
+ */
+export type HookMode = 'auto' | 'confirm' | 'notify' | 'off';
+/** All valid hook modes. */
+export declare const HOOK_MODES: HookMode[];
 /**
  * Persisted hook configuration stored in the database.
  */
@@ -42,6 +53,12 @@ export interface WorkHookConfig {
     description: string | null;
     /** When the hook was created */
     createdAt: string;
+    /** Automation mode (auto/confirm/notify/off) */
+    mode: HookMode;
+    /** Execution priority (lower = higher priority) */
+    priority: number;
+    /** Optional JSON config for built-in actions */
+    config: Record<string, unknown> | null;
 }
 /**
  * Row shape from the database (snake_case columns).
@@ -55,15 +72,35 @@ export interface WorkHookRow {
     enabled: number;
     description: string | null;
     created_at: string;
+    mode: string | null;
+    priority: number | null;
+    config: string | null;
 }
+/**
+ * Handler function for built-in actions injected into HookManager.
+ * Receives event context and optional per-hook config, returns an execution result.
+ */
+export type HookActionHandler = (ctx: Record<string, unknown>, config?: Record<string, unknown>) => {
+    action: string;
+    success: boolean;
+    error?: string;
+    durationMs: number;
+    skipped?: boolean;
+};
 /**
  * Result of executing a single hook.
  */
 export interface HookExecutionResult {
     hookId: string;
     hookName: string;
+    /** The resolved action name (built-in action or raw command) */
+    action: string;
     success: boolean;
     error?: string;
     /** Duration in ms */
     durationMs: number;
+    /** True when hook was skipped (mode=off or confirm denied) */
+    skipped?: boolean;
+    /** True when hook is queued for confirmation */
+    awaitingConfirmation?: boolean;
 }

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

@@ -26,4 +26,6 @@ export const HOOKABLE_EVENTS = [
     'on_agent_idle',
     'on_version_published',
 ];
+/** All valid hook modes. */
+export const HOOK_MODES = ['auto', 'confirm', 'notify', 'off'];
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/work-lifecycle/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,sBAAsB;CACvB,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/work-lifecycle/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,sBAAsB;CACvB,CAAA;AAqBD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA"}

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

@@ -7,7 +7,8 @@
  */
 export type { WorkEventSource, WorkStartedEvent, WorkStatusChangedEvent, WorkPRCreatedEvent, WorkCompletedEvent, } from './events.js';
 export { WorkLifecycleAdapter, initWorkLifecycleAdapter, stopWorkLifecycleAdapter, } from './adapter.js';
-export { initHookManager, stopHookManager, } from './hooks/index.js';
+export { initHookManager, stopHookManager, HookManager, } from './hooks/index.js';
+export type { HookManagerOptions } from './hooks/index.js';
 export { handlePostExecutionTransition, type PostExecutionContext, type PostExecutionResult, } from './post-execution.js';
 export { validateCommits, tryValidateCommits, type CommitValidationResult, } from '../execution/commit-validation.js';
 export { WorkflowRuleEvaluator, initWorkflowRuleEvaluator, stopWorkflowRuleEvaluator, } from './rule-evaluator.js';