@cleocode/cleo 2026.3.56 → 2026.3.58

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

@@ -0,0 +1,356 @@
+/**
+ * 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, nexusDiscoverRelated as discoverRelated, executeTransfer, exportSnapshot, getDefaultSnapshotPath, getSharingStatus, importSnapshot, nexusDeps, nexusGetProject, nexusInit, nexusList, nexusReconcile, nexusRegister, nexusSync, nexusSyncAll, nexusUnregister, orphanDetection, paginate, previewTransfer, nexusReadRegistry as readRegistry, readSnapshot, resolveTask, searchAcrossProjects, setPermission, validateSyntax, writeSnapshot, } from '@cleocode/core/internal';
+import { engineError, engineSuccess } from './_error.js';
+// ---------------------------------------------------------------------------
+// Registry operations
+// ---------------------------------------------------------------------------
+/**
+ * Get nexus status (initialized, project count, last updated).
+ */
+export async function nexusStatus() {
+    try {
+        const registry = await readRegistry();
+        const initialized = registry !== null;
+        const projectCount = initialized ? Object.keys(registry.projects).length : 0;
+        return engineSuccess({
+            initialized,
+            projectCount,
+            lastUpdated: registry?.lastUpdated ?? null,
+        });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * List all registered projects.
+ */
+export async function nexusListProjects(limit, offset) {
+    try {
+        const projects = await nexusList();
+        const page = paginate(projects, limit, offset);
+        return {
+            success: true,
+            data: {
+                projects: page.items,
+                count: projects.length,
+                total: projects.length,
+                filtered: projects.length,
+                page: page.page,
+            },
+            page: page.page,
+        };
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Show a single project by name.
+ */
+export async function nexusShowProject(name) {
+    try {
+        const project = await nexusGetProject(name);
+        if (!project) {
+            return engineError('E_NOT_FOUND', `Project not found: ${name}`);
+        }
+        return engineSuccess(project);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Resolve a cross-project task query.
+ */
+export async function nexusResolve(query, currentProject) {
+    try {
+        if (!validateSyntax(query)) {
+            return engineError('E_INVALID_INPUT', `Invalid query syntax: ${query}. Expected: T001, project:T001, .:T001, or *:T001`);
+        }
+        const result = await resolveTask(query, currentProject);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Get cross-project dependencies for a task query.
+ */
+export async function nexusDepsQuery(query, direction = 'forward') {
+    try {
+        const result = await nexusDeps(query, direction);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Build the global dependency graph.
+ */
+export async function nexusGraph() {
+    try {
+        const graph = await buildGlobalGraph();
+        return engineSuccess(graph);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Get the critical path across projects.
+ */
+export async function nexusCriticalPath() {
+    try {
+        const path = await criticalPath();
+        return engineSuccess(path);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Analyze blockers for a task query.
+ */
+export async function nexusBlockers(query) {
+    try {
+        const analysis = await blockingAnalysis(query);
+        return engineSuccess(analysis);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * List orphaned cross-project tasks.
+ */
+export async function nexusOrphans(limit, offset) {
+    try {
+        const orphans = await orphanDetection();
+        const page = paginate(orphans, limit, offset);
+        return {
+            success: true,
+            data: {
+                orphans: page.items,
+                count: orphans.length,
+                total: orphans.length,
+                filtered: orphans.length,
+                page: page.page,
+            },
+            page: page.page,
+        };
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+// ---------------------------------------------------------------------------
+// Discovery & Search
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function nexusDiscover(taskQuery, method = 'auto', limit = 10) {
+    try {
+        const result = await discoverRelated(taskQuery, method, limit);
+        if ('error' in result) {
+            return engineError(result.error.code, result.error.message);
+        }
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * 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 async function nexusSearch(pattern, projectFilter, limit = 20) {
+    try {
+        const result = await searchAcrossProjects(pattern, projectFilter, limit);
+        if ('error' in result) {
+            return engineError(result.error.code, result.error.message);
+        }
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+// ---------------------------------------------------------------------------
+// Registry mutation operations
+// ---------------------------------------------------------------------------
+/**
+ * Initialize the nexus.
+ */
+export async function nexusInitialize() {
+    try {
+        await nexusInit();
+        return engineSuccess({ message: 'NEXUS initialized successfully' });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Register a project in the nexus.
+ */
+export async function nexusRegisterProject(path, name, permission = 'read') {
+    try {
+        const hash = await nexusRegister(path, name, permission);
+        return engineSuccess({ hash, message: `Project registered with hash: ${hash}` });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Unregister a project from the nexus.
+ */
+export async function nexusUnregisterProject(name) {
+    try {
+        await nexusUnregister(name);
+        return engineSuccess({ message: `Project unregistered: ${name}` });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Sync a specific project or all projects.
+ */
+export async function nexusSyncProject(name) {
+    try {
+        if (name) {
+            await nexusSync(name);
+            return engineSuccess({ message: `Project synced: ${name}` });
+        }
+        const result = await nexusSyncAll();
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Set permission level for a project.
+ */
+export async function nexusSetPermission(name, level) {
+    try {
+        await setPermission(name, level);
+        return engineSuccess({ message: `Permission for '${name}' set to '${level}'` });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Reconcile the nexus registry with the filesystem.
+ */
+export async function nexusReconcileProject(projectRoot) {
+    try {
+        const result = await nexusReconcile(projectRoot);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+// ---------------------------------------------------------------------------
+// Sharing operations
+// ---------------------------------------------------------------------------
+/**
+ * Get sharing status for a project.
+ */
+export async function nexusShareStatus(projectRoot) {
+    try {
+        const result = await getSharingStatus(projectRoot);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Export a snapshot of the project's tasks.
+ */
+export async function nexusShareSnapshotExport(projectRoot, outputPath) {
+    try {
+        const snapshot = await exportSnapshot(projectRoot);
+        const resolvedPath = outputPath ?? getDefaultSnapshotPath(projectRoot);
+        await writeSnapshot(snapshot, resolvedPath);
+        return engineSuccess({
+            path: resolvedPath,
+            taskCount: snapshot._meta.taskCount,
+            checksum: snapshot._meta.checksum,
+        });
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Import a snapshot into the project.
+ */
+export async function nexusShareSnapshotImport(projectRoot, inputPath) {
+    try {
+        const snapshot = await readSnapshot(inputPath);
+        const result = await importSnapshot(snapshot, projectRoot);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+// ---------------------------------------------------------------------------
+// Transfer operations
+// ---------------------------------------------------------------------------
+/**
+ * Preview a cross-project task transfer (dry run).
+ */
+export async function nexusTransferPreview(params) {
+    try {
+        const result = await previewTransfer(params);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Execute a cross-project task transfer.
+ */
+export async function nexusTransferExecute(params) {
+    try {
+        const result = await executeTransfer(params);
+        return engineSuccess(result);
+    }
+    catch (error) {
+        return engineError('E_INTERNAL', error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=nexus-engine.js.map

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

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

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

@@ -0,0 +1,133 @@
+/**
+ * Orchestrate Engine
+ *
+ * Thin wrapper layer that delegates to core modules.
+ * All business logic lives in src/core/orchestration/.
+ *
+ * @task T4478
+ * @task T4784
+ */
+import type { BrainState } from '@cleocode/contracts';
+import { type EngineResult } from './_error.js';
+interface OrchestrateHandoffParams {
+    taskId: string;
+    protocolType: string;
+    note?: string;
+    nextAction?: string;
+    variant?: string;
+    tier?: 0 | 1 | 2;
+    idempotencyKey?: string;
+}
+/**
+ * orchestrate.status - Get orchestrator status
+ * @task T4478
+ */
+export declare function orchestrateStatus(epicId?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.analyze - Dependency analysis
+ * @task T4478
+ */
+export declare function orchestrateAnalyze(epicId?: string, projectRoot?: string, mode?: string): Promise<EngineResult>;
+/**
+ * orchestrate.ready - Get parallel-safe tasks (ready to execute)
+ * @task T4478
+ */
+export declare function orchestrateReady(epicId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.next - Next task to spawn
+ * @task T4478
+ */
+export declare function orchestrateNext(epicId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.waves - Compute dependency waves
+ * @task T4478
+ */
+export declare function orchestrateWaves(epicId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.context - Context usage check
+ * @task T4478
+ */
+export declare function orchestrateContext(epicId?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.validate - Validate spawn readiness for a task
+ * @task T4478
+ */
+export declare function orchestrateValidate(taskId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.spawn.select - Select best provider for spawn based on required capabilities
+ * @task T5236
+ */
+export declare function orchestrateSpawnSelectProvider(capabilities: Array<'supportsSubagents' | 'supportsProgrammaticSpawn' | 'supportsInterAgentComms' | 'supportsParallelSpawn'>, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.spawn.execute - Execute spawn for a task using adapter registry
+ * @task T5236
+ */
+export declare function orchestrateSpawnExecute(taskId: string, adapterId?: string, protocolType?: string, projectRoot?: string, tier?: 0 | 1 | 2): Promise<EngineResult>;
+/**
+ * orchestrate.spawn - Generate spawn prompt for a task
+ * @task T4478
+ */
+export declare function orchestrateSpawn(taskId: string, protocolType?: string, projectRoot?: string, tier?: 0 | 1 | 2): Promise<EngineResult>;
+/**
+ * orchestrate.startup - Initialize orchestration for an epic
+ * @task T4478
+ */
+export declare function orchestrateStartup(epicId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.bootstrap - Load brain state for agent bootstrapping
+ * @task T4478
+ * @task T4657
+ */
+export declare function orchestrateBootstrap(projectRoot?: string, params?: {
+    speed?: 'fast' | 'full' | 'complete';
+}): Promise<EngineResult<BrainState>>;
+/**
+ * orchestrate.critical-path - Find the longest dependency chain
+ * @task T4478
+ */
+export declare function orchestrateCriticalPath(projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.unblock-opportunities - Analyze dependency graph for unblocking opportunities
+ * @task T4478
+ */
+export declare function orchestrateUnblockOpportunities(projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.parallel - Manage parallel execution (start/end)
+ * @task T4632
+ */
+export declare function orchestrateParallel(action: 'start' | 'end', epicId: string, wave?: number, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.parallel.start - Start parallel execution for a wave
+ * @task T4632
+ */
+export declare function orchestrateParallelStart(epicId: string, wave: number, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.parallel.end - End parallel execution for a wave
+ * @task T4632
+ */
+export declare function orchestrateParallelEnd(epicId: string, wave: number, projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.check - Check current orchestration state
+ * @task T4632
+ */
+export declare function orchestrateCheck(projectRoot?: string): Promise<EngineResult>;
+/**
+ * orchestrate.skill.inject - Read skill content for injection into agent context
+ * @task T4632
+ */
+export declare function orchestrateSkillInject(skillName: string, projectRoot?: string): EngineResult;
+/**
+ * orchestrate.handoff - Composite session handoff + successor spawn
+ *
+ * Step order is explicit and fixed:
+ * 1) session.context.inject
+ * 2) session.end
+ * 3) orchestrate.spawn
+ *
+ * Idempotency policy:
+ * - Non-idempotent overall. A retry after step 2 can duplicate spawn output.
+ * - Failures include exact step state and a safe retry entry point.
+ */
+export declare function orchestrateHandoff(params: OrchestrateHandoffParams, projectRoot?: string): Promise<EngineResult>;
+export {};
+//# sourceMappingURL=orchestrate-engine.d.ts.map

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

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