@cleocode/cleo 2026.3.57 → 2026.3.58

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

@@ -0,0 +1,213 @@
+/**
+ * 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 MCP domain handlers.
+ *
+ * @task T4785
+ * @task T4800 - Updated to canonical full-form stage names
+ */
+import { checkGate, checkStagePrerequisites, failGate, getLifecycleGates, getLifecycleHistory, getLifecycleStatus, getStagePrerequisites, listEpicsWithLifecycle, passGate, recordStageProgress, resetStage, skipStageWithReason, } from '@cleocode/core/internal';
+import { engineError, engineSuccess } from './_error.js';
+// ============================================================================
+// Exported engine functions (thin wrappers)
+// ============================================================================
+/**
+ * List all epic IDs that have RCASD pipeline data.
+ */
+export async function listRcsdEpics(projectRoot) {
+    return listEpicsWithLifecycle(projectRoot);
+}
+/**
+ * lifecycle.check / lifecycle.status - Get lifecycle status for epic.
+ * @task T4785
+ */
+export async function lifecycleStatus(epicId, projectRoot) {
+    if (!epicId) {
+        return engineError('E_INVALID_INPUT', 'epicId is required');
+    }
+    try {
+        const data = await getLifecycleStatus(epicId, projectRoot);
+        return engineSuccess(data);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_STATUS', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.history - Stage transition history.
+ * @task T4785
+ */
+export async function lifecycleHistory(taskId, projectRoot) {
+    try {
+        const data = await getLifecycleHistory(taskId, projectRoot);
+        return engineSuccess(data);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_HISTORY', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.gates - Get all gate statuses for an epic.
+ * @task T4785
+ */
+export async function lifecycleGates(taskId, projectRoot) {
+    try {
+        const data = await getLifecycleGates(taskId, projectRoot);
+        return engineSuccess(data);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_GATES', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.prerequisites - Get required prior stages for a target stage.
+ * @task T4785
+ */
+export async function lifecyclePrerequisites(targetStage, _projectRoot) {
+    if (!targetStage) {
+        return engineError('E_INVALID_INPUT', 'targetStage is required');
+    }
+    try {
+        const data = await getStagePrerequisites(targetStage);
+        return engineSuccess({ targetStage, ...data });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_PREREQUISITES', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.check - Check if a stage's prerequisites are met.
+ * @task T4785
+ */
+export async function lifecycleCheck(epicId, targetStage, projectRoot) {
+    if (!epicId || !targetStage) {
+        return engineError('E_INVALID_INPUT', 'epicId and targetStage are required');
+    }
+    try {
+        const data = await checkStagePrerequisites(epicId, targetStage, projectRoot);
+        return engineSuccess(data);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_CHECK', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.progress / lifecycle.record - Record stage completion.
+ * @task T4785
+ */
+export async function lifecycleProgress(taskId, stage, status, notes, projectRoot) {
+    if (!taskId || !stage || !status) {
+        return engineError('E_INVALID_INPUT', 'taskId, stage, and status are required');
+    }
+    try {
+        // Enforce lifecycle gates for stage transitions (T5698)
+        if (status === 'in_progress' || status === 'completed') {
+            const gateResult = await checkGate(taskId, stage, projectRoot);
+            if (!gateResult.allowed) {
+                return engineError('E_LIFECYCLE_GATE_FAILED', gateResult.message);
+            }
+        }
+        const data = await recordStageProgress(taskId, stage, status, notes, projectRoot);
+        return engineSuccess({ ...data, recorded: true });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_PROGRESS', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.skip - Skip a stage with reason.
+ * @task T4785
+ */
+export async function lifecycleSkip(taskId, stage, reason, projectRoot) {
+    if (!taskId || !stage || !reason) {
+        return engineError('E_INVALID_INPUT', 'taskId, stage, and reason are required');
+    }
+    try {
+        const data = await skipStageWithReason(taskId, stage, reason, projectRoot);
+        return engineSuccess({ ...data, skipped: true });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_SKIP', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.reset - Reset a stage (emergency).
+ * @task T4785
+ */
+export async function lifecycleReset(taskId, stage, reason, projectRoot) {
+    if (!taskId || !stage || !reason) {
+        return engineError('E_INVALID_INPUT', 'taskId, stage, and reason are required');
+    }
+    try {
+        const data = await resetStage(taskId, stage, reason, projectRoot);
+        return engineSuccess({ ...data, reset: 'pending' });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_RESET', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.gate.pass - Mark gate as passed.
+ * @task T4785
+ */
+export async function lifecycleGatePass(taskId, gateName, agent, notes, projectRoot) {
+    if (!taskId || !gateName) {
+        return engineError('E_INVALID_INPUT', 'taskId and gateName are required');
+    }
+    try {
+        const data = await passGate(taskId, gateName, agent, notes, projectRoot);
+        return engineSuccess({ ...data, status: 'passed' });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_GATE_PASS', err.message);
+        }
+        throw err;
+    }
+}
+/**
+ * lifecycle.gate.fail - Mark gate as failed.
+ * @task T4785
+ */
+export async function lifecycleGateFail(taskId, gateName, reason, projectRoot) {
+    if (!taskId || !gateName) {
+        return engineError('E_INVALID_INPUT', 'taskId and gateName are required');
+    }
+    try {
+        const data = await failGate(taskId, gateName, reason, projectRoot);
+        return engineSuccess({ ...data, status: 'failed' });
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            return engineError('E_LIFECYCLE_GATE_FAIL', err.message);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=lifecycle-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-engine.js","sourceRoot":"","sources":["../../../src/dispatch/engines/lifecycle-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,SAAS,EACT,uBAAuB,EACvB,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5E,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAoB;IACtD,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,WAAoB;IACxE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,oBAAoB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,WAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,WAAoB;IACvE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,YAAqB;IAErB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC,iBAAiB,EAAE,yBAAyB,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;QACtD,OAAO,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,2BAA2B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,WAAmB,EACnB,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,iBAAiB,EAAE,qCAAqC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAC7E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,KAAa,EACb,MAAc,EACd,KAAc,EACd,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC;QACH,wDAAwD;QACxD,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YAC/D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,WAAW,CAAC,yBAAyB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAClF,OAAO,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,KAAa,EACb,MAAc,EACd,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3E,OAAO,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAa,EACb,MAAc,EACd,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAClE,OAAO,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,QAAgB,EAChB,KAAc,EACd,KAAc,EACd,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,iBAAiB,EAAE,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACzE,OAAO,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,uBAAuB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,QAAgB,EAChB,MAAe,EACf,WAAoB;IAEpB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,iBAAiB,EAAE,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnE,OAAO,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,uBAAuB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Memory Engine
+ *
+ * Dispatch layer adapter for brain.db cognitive memory operations.
+ * Delegates to src/core/memory/engine-compat.ts which implements the EngineResult pattern.
+ *
+ * @task T5674
+ */
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphNeighbors, memoryGraphRemove, memoryGraphShow, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '@cleocode/core/internal';
+//# sourceMappingURL=memory-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-engine.d.ts","sourceRoot":"","sources":["../../../src/dispatch/engines/memory-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Memory Engine
+ *
+ * Dispatch layer adapter for brain.db cognitive memory operations.
+ * Delegates to src/core/memory/engine-compat.ts which implements the EngineResult pattern.
+ *
+ * @task T5674
+ */
+export { memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphNeighbors, memoryGraphRemove, memoryGraphShow, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, } from '@cleocode/core/internal';
+//# sourceMappingURL=memory-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-engine.js","sourceRoot":"","sources":["../../../src/dispatch/engines/memory-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,167 @@
+/**
+ * Nexus Engine — Thin wrapper layer for nexus domain operations.
+ *
+ * Delegates all business logic to src/core/nexus/ and src/core/snapshot/.
+ * Each function catches errors and wraps them into EngineResult.
+ *
+ * Sub-domains:
+ *   Registry   - init, register, unregister, sync, reconcile, list, show, status
+ *   Query      - resolve, deps, graph, path, blockers, orphans
+ *   Discovery  - discover related tasks, search across projects
+ *   Sharing    - status, snapshot export/import
+ *
+ * @task T5704
+ * @epic T5701
+ */
+import { blockingAnalysis, buildGlobalGraph, criticalPath, getSharingStatus, importSnapshot, type NexusPermissionLevel, nexusDeps, nexusGetProject, nexusList, nexusReconcile, orphanDetection, paginate, resolveTask, type TransferParams, type TransferResult } from '@cleocode/core/internal';
+import { type EngineResult } from './_error.js';
+export type { EngineResult };
+/**
+ * Get nexus status (initialized, project count, last updated).
+ */
+export declare function nexusStatus(): Promise<EngineResult<{
+    initialized: boolean;
+    projectCount: number;
+    lastUpdated: string | null;
+}>>;
+/**
+ * List all registered projects.
+ */
+export declare function nexusListProjects(limit?: number, offset?: number): Promise<EngineResult<{
+    projects: Awaited<ReturnType<typeof nexusList>>;
+    count: number;
+    total: number;
+    filtered: number;
+    page: ReturnType<typeof paginate>['page'];
+}>>;
+/**
+ * Show a single project by name.
+ */
+export declare function nexusShowProject(name: string): Promise<EngineResult<Awaited<ReturnType<typeof nexusGetProject>>>>;
+/**
+ * Resolve a cross-project task query.
+ */
+export declare function nexusResolve(query: string, currentProject?: string): Promise<EngineResult<Awaited<ReturnType<typeof resolveTask>>>>;
+/**
+ * Get cross-project dependencies for a task query.
+ */
+export declare function nexusDepsQuery(query: string, direction?: 'forward' | 'reverse'): Promise<EngineResult<Awaited<ReturnType<typeof nexusDeps>>>>;
+/**
+ * Build the global dependency graph.
+ */
+export declare function nexusGraph(): Promise<EngineResult<Awaited<ReturnType<typeof buildGlobalGraph>>>>;
+/**
+ * Get the critical path across projects.
+ */
+export declare function nexusCriticalPath(): Promise<EngineResult<Awaited<ReturnType<typeof criticalPath>>>>;
+/**
+ * Analyze blockers for a task query.
+ */
+export declare function nexusBlockers(query: string): Promise<EngineResult<Awaited<ReturnType<typeof blockingAnalysis>>>>;
+/**
+ * List orphaned cross-project tasks.
+ */
+export declare function nexusOrphans(limit?: number, offset?: number): Promise<EngineResult<{
+    orphans: Awaited<ReturnType<typeof orphanDetection>>;
+    count: number;
+    total: number;
+    filtered: number;
+    page: ReturnType<typeof paginate>['page'];
+}>>;
+/**
+ * Discover tasks related to a given task query across projects.
+ */
+/**
+ * Discover tasks related to a given task query across projects.
+ * Delegates all business logic to src/core/nexus/discover.ts.
+ */
+export declare function nexusDiscover(taskQuery: string, method?: string, limit?: number): Promise<EngineResult<{
+    query: string;
+    method: string;
+    results: Array<{
+        project: string;
+        taskId: string;
+        title: string;
+        score: number;
+        type: string;
+        reason: string;
+    }>;
+    total: number;
+}>>;
+/**
+ * Search for tasks across all registered projects.
+ */
+/**
+ * Search for tasks across all registered projects.
+ * Delegates all business logic to src/core/nexus/discover.ts.
+ */
+export declare function nexusSearch(pattern: string, projectFilter?: string, limit?: number): Promise<EngineResult<{
+    pattern: string;
+    results: Array<{
+        id: string;
+        title: string;
+        status: string;
+        priority?: string;
+        description?: string;
+        _project: string;
+    }>;
+    resultCount: number;
+}>>;
+/**
+ * Initialize the nexus.
+ */
+export declare function nexusInitialize(): Promise<EngineResult<{
+    message: string;
+}>>;
+/**
+ * Register a project in the nexus.
+ */
+export declare function nexusRegisterProject(path: string, name?: string, permission?: NexusPermissionLevel): Promise<EngineResult<{
+    hash: string;
+    message: string;
+}>>;
+/**
+ * Unregister a project from the nexus.
+ */
+export declare function nexusUnregisterProject(name: string): Promise<EngineResult<{
+    message: string;
+}>>;
+/**
+ * Sync a specific project or all projects.
+ */
+export declare function nexusSyncProject(name?: string): Promise<EngineResult<unknown>>;
+/**
+ * Set permission level for a project.
+ */
+export declare function nexusSetPermission(name: string, level: NexusPermissionLevel): Promise<EngineResult<{
+    message: string;
+}>>;
+/**
+ * Reconcile the nexus registry with the filesystem.
+ */
+export declare function nexusReconcileProject(projectRoot: string): Promise<EngineResult<Awaited<ReturnType<typeof nexusReconcile>>>>;
+/**
+ * Get sharing status for a project.
+ */
+export declare function nexusShareStatus(projectRoot: string): Promise<EngineResult<Awaited<ReturnType<typeof getSharingStatus>>>>;
+/**
+ * Export a snapshot of the project's tasks.
+ */
+export declare function nexusShareSnapshotExport(projectRoot: string, outputPath?: string): Promise<EngineResult<{
+    path: string;
+    taskCount: number;
+    checksum: string;
+}>>;
+/**
+ * Import a snapshot into the project.
+ */
+export declare function nexusShareSnapshotImport(projectRoot: string, inputPath: string): Promise<EngineResult<Awaited<ReturnType<typeof importSnapshot>>>>;
+/**
+ * Preview a cross-project task transfer (dry run).
+ */
+export declare function nexusTransferPreview(params: TransferParams): Promise<EngineResult<TransferResult>>;
+/**
+ * Execute a cross-project task transfer.
+ */
+export declare function nexusTransferExecute(params: TransferParams): Promise<EngineResult<TransferResult>>;
+//# sourceMappingURL=nexus-engine.d.ts.map

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

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