@cleocode/cleo 2026.4.10 → 2026.4.12

package/dist/dispatch/engines/hooks-engine.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Hooks Engine - Phase 2C of T5237
+ *
+ * Dispatch engine for hook-related operations. Queries providers by hook
+ * event support and analyzes hook capabilities across the CAAMP provider ecosystem.
+ *
+ * @module src/dispatch/engines/hooks-engine
+ * @epic T5237
+ * @task T167
+ */
+import { type HookEvent, type ProviderHookEvent } from '@cleocode/core/internal';
+import { type EngineResult } from './_error.js';
+/**
+ * Provider hook capability information
+ */
+interface ProviderHookInfo {
+    id: string;
+    name?: string;
+    supportedHooks: ProviderHookEvent[];
+}
+/**
+ * Query providers that support a specific hook event
+ *
+ * Returns detailed provider information including which hooks each provider
+ * supports, enabling intelligent routing and filtering of hook handlers.
+ *
+ * @param event - The hook event to query providers for
+ * @returns Engine result with provider hook capability data
+ */
+export declare function queryHookProviders(event: HookEvent): Promise<EngineResult<{
+    event: HookEvent;
+    providers: ProviderHookInfo[];
+}>>;
+/**
+ * Get hook events common to specified providers
+ *
+ * Analyzes which hook events are supported by all providers in the given list,
+ * useful for determining the intersection of hook capabilities.
+ *
+ * @param providerIds - Optional array of provider IDs to analyze (uses all active if omitted)
+ * @returns Engine result with common hook events
+ */
+export declare function queryCommonHooks(providerIds?: string[]): Promise<EngineResult<{
+    providerIds?: string[];
+    commonEvents: ProviderHookEvent[];
+}>>;
+/** Coverage summary for a single provider in the hook matrix. */
+export interface ProviderMatrixEntry {
+    /** CAAMP provider identifier (e.g. "claude-code"). */
+    providerId: string;
+    /** Number of canonical events this provider supports. */
+    supportedCount: number;
+    /** Total canonical events in the taxonomy. */
+    totalCanonical: number;
+    /** Coverage percentage (0-100, integer). */
+    coverage: number;
+    /** Canonical events supported by this provider. */
+    supported: string[];
+    /** Canonical events not supported by this provider. */
+    unsupported: string[];
+}
+/** Full hook matrix result. */
+export interface HookMatrixResult {
+    /** CAAMP hook mappings version. */
+    caampVersion: string;
+    /** All canonical event names (rows). */
+    events: string[];
+    /** Provider IDs included in the matrix (columns). */
+    providers: string[];
+    /**
+     * Two-dimensional matrix: event name → provider ID → support flag.
+     * `true` means the provider natively supports the canonical event.
+     */
+    matrix: Record<string, Record<string, boolean>>;
+    /** Per-provider summary with coverage stats. */
+    summary: ProviderMatrixEntry[];
+    /** Provider ID detected as the current runtime, or null. */
+    detectedProvider: string | null;
+}
+/**
+ * Build a cross-provider hook support matrix using CAAMP APIs.
+ *
+ * Calls `buildHookMatrix()` to assemble the two-dimensional grid, then
+ * augments each provider row with `getProviderSummary()` coverage stats.
+ * Optionally runs `detectAllProviders()` to surface the active runtime.
+ *
+ * @param params - Optional filter/detection options
+ * @returns Engine result with the full hook matrix
+ * @task T167
+ */
+export declare function systemHooksMatrix(params?: {
+    providerIds?: string[];
+    detectProvider?: boolean;
+}): Promise<EngineResult<HookMatrixResult>>;
+export {};
+//# sourceMappingURL=hooks-engine.d.ts.map

package/dist/dispatch/engines/hooks-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/hooks-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAAC,CAqB5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAAC,CAQtF;AAMD,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qDAAqD;IACrD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,gDAAgD;IAChD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAwF1C"}

package/dist/dispatch/engines/hooks-engine.js

@@ -0,0 +1,144 @@
+/**
+ * Hooks Engine - Phase 2C of T5237
+ *
+ * Dispatch engine for hook-related operations. Queries providers by hook
+ * event support and analyzes hook capabilities across the CAAMP provider ecosystem.
+ *
+ * @module src/dispatch/engines/hooks-engine
+ * @epic T5237
+ * @task T167
+ */
+import { isProviderHookEvent, } from '@cleocode/core/internal';
+import { engineError, engineSuccess } from './_error.js';
+/**
+ * Query providers that support a specific hook event
+ *
+ * Returns detailed provider information including which hooks each provider
+ * supports, enabling intelligent routing and filtering of hook handlers.
+ *
+ * @param event - The hook event to query providers for
+ * @returns Engine result with provider hook capability data
+ */
+export async function queryHookProviders(event) {
+    if (!isProviderHookEvent(event)) {
+        return engineSuccess({
+            event,
+            providers: [],
+        });
+    }
+    const { getProvidersByHookEvent } = await import('@cleocode/caamp');
+    const providers = getProvidersByHookEvent(event);
+    return engineSuccess({
+        event,
+        providers: providers.map((p) => ({
+            id: p.id,
+            name: p.name,
+            supportedHooks: p.capabilities
+                ?.hooks?.supported ?? [],
+        })),
+    });
+}
+/**
+ * Get hook events common to specified providers
+ *
+ * Analyzes which hook events are supported by all providers in the given list,
+ * useful for determining the intersection of hook capabilities.
+ *
+ * @param providerIds - Optional array of provider IDs to analyze (uses all active if omitted)
+ * @returns Engine result with common hook events
+ */
+export async function queryCommonHooks(providerIds) {
+    const { getCommonHookEvents } = await import('@cleocode/caamp');
+    const commonEvents = getCommonHookEvents(providerIds);
+    return engineSuccess({
+        providerIds,
+        commonEvents,
+    });
+}
+/**
+ * Build a cross-provider hook support matrix using CAAMP APIs.
+ *
+ * Calls `buildHookMatrix()` to assemble the two-dimensional grid, then
+ * augments each provider row with `getProviderSummary()` coverage stats.
+ * Optionally runs `detectAllProviders()` to surface the active runtime.
+ *
+ * @param params - Optional filter/detection options
+ * @returns Engine result with the full hook matrix
+ * @task T167
+ */
+export async function systemHooksMatrix(params) {
+    try {
+        const { buildHookMatrix, getProviderSummary, getHookMappingsVersion, detectAllProviders } = await import('@cleocode/caamp');
+        const caampVersion = getHookMappingsVersion();
+        const raw = buildHookMatrix(params?.providerIds);
+        // Flatten the matrix to boolean supported flags
+        const boolMatrix = {};
+        for (const event of raw.events) {
+            boolMatrix[event] = {};
+            for (const providerId of raw.providers) {
+                const mapping = raw.matrix[event]?.[providerId];
+                boolMatrix[event][providerId] = mapping?.supported ?? false;
+            }
+        }
+        // Build per-provider summary
+        const summary = raw.providers.map((providerId) => {
+            const provSummary = getProviderSummary(providerId);
+            if (provSummary) {
+                return {
+                    providerId,
+                    supportedCount: provSummary.supportedCount,
+                    totalCanonical: provSummary.totalCanonical,
+                    coverage: provSummary.coverage,
+                    supported: provSummary.supported,
+                    unsupported: provSummary.unsupported,
+                };
+            }
+            // Derive from matrix if no summary profile available
+            const supported = raw.events.filter((ev) => boolMatrix[ev]?.[providerId] === true);
+            const unsupported = raw.events.filter((ev) => boolMatrix[ev]?.[providerId] !== true);
+            const totalCanonical = raw.events.length;
+            const coverage = totalCanonical > 0 ? Math.round((supported.length / totalCanonical) * 100) : 0;
+            return {
+                providerId,
+                supportedCount: supported.length,
+                totalCanonical,
+                coverage,
+                supported,
+                unsupported,
+            };
+        });
+        // Detect current provider if requested (default: true)
+        let detectedProvider = null;
+        const shouldDetect = params?.detectProvider !== false;
+        if (shouldDetect) {
+            try {
+                const detectionResults = detectAllProviders();
+                const detected = detectionResults.find((r) => r.installed && r.projectDetected);
+                if (detected) {
+                    detectedProvider = detected.provider.id;
+                }
+                else {
+                    const anyInstalled = detectionResults.find((r) => r.installed);
+                    if (anyInstalled) {
+                        detectedProvider = anyInstalled.provider.id;
+                    }
+                }
+            }
+            catch {
+                // Detection is best-effort; leave detectedProvider null
+            }
+        }
+        return engineSuccess({
+            caampVersion,
+            events: raw.events,
+            providers: raw.providers,
+            matrix: boolMatrix,
+            summary,
+            detectedProvider,
+        });
+    }
+    catch (err) {
+        return engineError('E_GENERAL', err.message);
+    }
+}
+//# sourceMappingURL=hooks-engine.js.map

package/dist/dispatch/engines/hooks-engine.js.map

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

package/dist/dispatch/engines/init-engine.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Init Engine
+ *
+ * Thin wrapper around core init operations.
+ * Business logic lives in src/core/init.ts.
+ *
+ * CRITICAL: Init is explicit, not automatic. CLEO MUST NOT
+ * silently create .cleo/ directories on first write.
+ *
+ * @task T4815
+ */
+import { type EngineResult } from './_error.js';
+/**
+ * Initialize a CLEO project directory.
+ *
+ * Creates the .cleo/ directory structure with empty data files.
+ * Returns error if already initialized (unless force=true).
+ */
+export declare function initProject(projectRoot: string, options?: {
+    projectName?: string;
+    force?: boolean;
+    mapCodebase?: boolean;
+}): Promise<EngineResult<{
+    initialized: boolean;
+    projectRoot: string;
+    filesCreated: string[];
+    skipped: string[];
+    warnings: string[];
+    classification?: {
+        kind: 'greenfield' | 'brownfield';
+        signalCount: number;
+        topLevelFileCount: number;
+        hasGit: boolean;
+    };
+    nextSteps?: Array<{
+        action: string;
+        command: string;
+    }>;
+}>>;
+/**
+ * Check if auto-init is enabled via environment variable
+ */
+export declare function isAutoInitEnabled(): boolean;
+/**
+ * Check initialization status and auto-init if configured
+ */
+export declare function ensureInitialized(projectRoot: string): Promise<EngineResult<{
+    initialized: boolean;
+}>>;
+/**
+ * Get current version (native implementation)
+ */
+export declare function getVersion(projectRoot: string): Promise<EngineResult<{
+    version: string;
+}>>;
+//# sourceMappingURL=init-engine.d.ts.map

package/dist/dispatch/engines/init-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/init-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CACR,YAAY,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,CAAC,CACH,CA8BA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAOjD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAOhG"}

package/dist/dispatch/engines/init-engine.js

@@ -0,0 +1,78 @@
+/**
+ * Init Engine
+ *
+ * Thin wrapper around core init operations.
+ * Business logic lives in src/core/init.ts.
+ *
+ * CRITICAL: Init is explicit, not automatic. CLEO MUST NOT
+ * silently create .cleo/ directories on first write.
+ *
+ * @task T4815
+ */
+import { ensureInitialized as coreEnsureInitialized, getVersion as coreGetVersion, initProject as coreInitProject, isAutoInitEnabled as coreIsAutoInitEnabled, } from '@cleocode/core/internal';
+import { engineError } from './_error.js';
+/**
+ * Initialize a CLEO project directory.
+ *
+ * Creates the .cleo/ directory structure with empty data files.
+ * Returns error if already initialized (unless force=true).
+ */
+export async function initProject(projectRoot, options) {
+    try {
+        const result = await coreInitProject({
+            name: options?.projectName,
+            force: options?.force,
+            mapCodebase: options?.mapCodebase,
+        });
+        return {
+            success: true,
+            data: {
+                initialized: result.initialized,
+                projectRoot,
+                filesCreated: result.created,
+                skipped: result.skipped,
+                warnings: result.warnings,
+                classification: result.classification,
+                nextSteps: result.nextSteps,
+            },
+        };
+    }
+    catch (err) {
+        const message = err.message;
+        if (message.includes('already initialized')) {
+            return engineError('E_ALREADY_INITIALIZED', 'CLEO project already initialized. Use force=true to reinitialize.');
+        }
+        return engineError('E_INIT_FAILED', message);
+    }
+}
+/**
+ * Check if auto-init is enabled via environment variable
+ */
+export function isAutoInitEnabled() {
+    return coreIsAutoInitEnabled();
+}
+/**
+ * Check initialization status and auto-init if configured
+ */
+export async function ensureInitialized(projectRoot) {
+    try {
+        const result = await coreEnsureInitialized(projectRoot);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_NOT_INITIALIZED', err.message);
+    }
+}
+/**
+ * Get current version (native implementation)
+ */
+export async function getVersion(projectRoot) {
+    try {
+        const result = await coreGetVersion(projectRoot);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_VERSION_FAILED', err.message);
+    }
+}
+//# sourceMappingURL=init-engine.js.map

package/dist/dispatch/engines/init-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-engine.js","sourceRoot":"","sources":["../../../src/dispatch/engines/init-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,iBAAiB,IAAI,qBAAqB,EAC1C,UAAU,IAAI,cAAc,EAC5B,WAAW,IAAI,eAAe,EAC9B,iBAAiB,IAAI,qBAAqB,GAC3C,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAIC;IAiBD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,IAAI,EAAE,OAAO,EAAE,WAAW;YAC1B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,WAAW,EAAE,OAAO,EAAE,WAAW;SAClC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW;gBACX,YAAY,EAAE,MAAM,CAAC,OAAO;gBAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAI,GAAa,CAAC,OAAO,CAAC;QACvC,IAAI,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC5C,OAAO,WAAW,CAChB,uBAAuB,EACvB,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,qBAAqB,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,mBAAmB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,kBAAkB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/dispatch/engines/lifecycle-engine.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Lifecycle Engine — Thin EngineResult Wrapper
+ *
+ * Delegates all business logic to src/core/lifecycle/index.ts.
+ * This file only wraps core function calls in EngineResult format
+ * for the dispatch domain handlers.
+ *
+ * @task T4785
+ * @task T4800 - Updated to canonical full-form stage names
+ */
+import { type EngineResult } from './_error.js';
+/**
+ * List all epic IDs that have RCASD pipeline data.
+ */
+export declare function listRcsdEpics(projectRoot?: string): Promise<string[]>;
+/**
+ * lifecycle.check / lifecycle.status - Get lifecycle status for epic.
+ * @task T4785
+ */
+export declare function lifecycleStatus(epicId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.history - Stage transition history.
+ * @task T4785
+ */
+export declare function lifecycleHistory(taskId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.gates - Get all gate statuses for an epic.
+ * @task T4785
+ */
+export declare function lifecycleGates(taskId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.prerequisites - Get required prior stages for a target stage.
+ * @task T4785
+ */
+export declare function lifecyclePrerequisites(targetStage: string, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.check - Check if a stage's prerequisites are met.
+ * @task T4785
+ */
+export declare function lifecycleCheck(epicId: string, targetStage: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.progress / lifecycle.record - Record stage completion.
+ * @task T4785
+ */
+export declare function lifecycleProgress(taskId: string, stage: string, status: string, notes?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.skip - Skip a stage with reason.
+ * @task T4785
+ */
+export declare function lifecycleSkip(taskId: string, stage: string, reason: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.reset - Reset a stage (emergency).
+ * @task T4785
+ */
+export declare function lifecycleReset(taskId: string, stage: string, reason: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.gate.pass - Mark gate as passed.
+ * @task T4785
+ */
+export declare function lifecycleGatePass(taskId: string, gateName: string, agent?: string, notes?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * lifecycle.gate.fail - Mark gate as failed.
+ * @task T4785
+ */
+export declare function lifecycleGateFail(taskId: string, gateName: string, reason?: string, projectRoot?: string): Promise<EngineResult>;
+//# sourceMappingURL=lifecycle-engine.d.ts.map

package/dist/dispatch/engines/lifecycle-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/lifecycle-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,aAAa,CAAC;AAM5E;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAajG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAUhG;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAsCvB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAavB"}