@cleocode/core 2026.3.73 → 2026.3.74

package/dist/nexus/index.d.ts

@@ -16,4 +16,6 @@ export { getNexusCacheDir, getNexusHome, type NexusHealthStatus, type NexusPermi
 export { getSharingStatus, type SharingStatus, syncGitignore, } from './sharing/index.js';
 export { executeTransfer, previewTransfer } from './transfer.js';
 export type { ImportFromPackageOptions, ImportFromPackageResult, TransferManifest, TransferManifestEntry, TransferMode, TransferOnConflict, TransferOnMissingDep, TransferParams, TransferResult, TransferScope, } from './transfer-types.js';
+export type { ParsedDirective, ProjectACL, RouteResult, WorkspaceAgent, WorkspaceProjectSummary, WorkspaceStatus, } from './workspace.js';
+export { parseDirective, routeDirective, workspaceAgents, workspaceStatus, } from './workspace.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/nexus/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,WAAW,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,cAAc,EACnB,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EACL,UAAU,EACV,OAAO,EACP,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,KAAK,qBAAqB,EAE1B,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,UAAU,EACV,kBAAkB,EAClB,WAAW,EAEX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAEhB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,eAAe,EACf,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,eAAe,EAEf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,gBAAgB,EAEhB,KAAK,aAAa,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nexus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,WAAW,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,cAAc,EACnB,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EACL,UAAU,EACV,OAAO,EACP,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,KAAK,qBAAqB,EAE1B,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,UAAU,EACV,kBAAkB,EAClB,WAAW,EAEX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAEhB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,eAAe,EACf,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,eAAe,EAEf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,gBAAgB,EAEhB,KAAK,aAAa,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/nexus/workspace.d.ts

@@ -0,0 +1,128 @@
+/**
+ * NEXUS Workspace — Cross-project orchestration operations.
+ *
+ * Implements ORCH-PLAN Phase B:
+ * - B.2: nexus.route(directiveEvent) — dispatch Conduit directives to the correct project
+ * - B.3: nexus.workspace.status() — aggregated cross-project task view
+ * - B.4: nexus.workspace.agents() — cross-project agent registry view
+ *
+ * Security: project-level ACL enforced on all routing operations (HIGH-02).
+ * Rate limiting: per-agent throttling on route operations (MEDIUM-05).
+ * Audit: all routing operations logged (LOW-06).
+ *
+ * @module nexus/workspace
+ */
+import type { ConduitMessage } from '@cleocode/contracts';
+/** Parsed directive from a Conduit message. */
+export interface ParsedDirective {
+    /** The directive verb (claim, done, blocked, action, etc.). */
+    verb: string;
+    /** Task references extracted from the message (e.g., T042, T1234). */
+    taskRefs: string[];
+    /** The agent ID that sent the directive. */
+    agentId: string;
+    /** Original message ID for audit trail. */
+    messageId: string;
+    /** Timestamp of the directive. */
+    timestamp: string;
+}
+/** Result of routing a directive to a project. */
+export interface RouteResult {
+    /** Whether the routing succeeded. */
+    success: boolean;
+    /** The project that was routed to. */
+    project: string;
+    /** The project's filesystem path. */
+    projectPath: string;
+    /** The task that was affected. */
+    taskId: string;
+    /** What operation was performed. */
+    operation: string;
+    /** Error message if routing failed. */
+    error?: string;
+}
+/** Aggregated task status across all projects. */
+export interface WorkspaceStatus {
+    /** Total projects in the workspace. */
+    projectCount: number;
+    /** Per-project task summaries. */
+    projects: WorkspaceProjectSummary[];
+    /** Aggregated totals. */
+    totals: {
+        pending: number;
+        active: number;
+        done: number;
+        total: number;
+    };
+    /** When the status was computed. */
+    computedAt: string;
+}
+/** Task summary for a single project. */
+export interface WorkspaceProjectSummary {
+    /** Project name. */
+    name: string;
+    /** Project path. */
+    path: string;
+    /** Task counts by status. */
+    counts: {
+        pending: number;
+        active: number;
+        done: number;
+        total: number;
+    };
+    /** Health status from the Nexus registry. */
+    health: string;
+    /** Last sync time. */
+    lastSync: string;
+}
+/** Agent info aggregated across projects. */
+export interface WorkspaceAgent {
+    /** Agent instance ID. */
+    agentId: string;
+    /** Agent type. */
+    agentType: string;
+    /** Current status. */
+    status: string;
+    /** Which project this agent is registered in. */
+    project: string;
+    /** Current task (if any). */
+    taskId: string | null;
+    /** Last heartbeat. */
+    lastHeartbeat: string;
+}
+/** Project-level ACL entry. */
+export interface ProjectACL {
+    /** Agent IDs with write access. */
+    authorizedAgents: string[];
+}
+/**
+ * Parse a Conduit message into a structured directive.
+ *
+ * Extracts directive verbs (/claim, /done, /blocked) and task references
+ * from the message content and metadata.
+ */
+export declare function parseDirective(message: ConduitMessage): ParsedDirective | null;
+/**
+ * Route a Conduit directive to the correct project's CLEO instance.
+ *
+ * Resolves which project owns the referenced task, checks ACL,
+ * and dispatches the appropriate CLEO operation.
+ *
+ * @param directive - Parsed directive from a Conduit message
+ * @returns Array of route results (one per task reference)
+ */
+export declare function routeDirective(directive: ParsedDirective): Promise<RouteResult[]>;
+/**
+ * Get aggregated task status across all registered projects.
+ *
+ * Returns per-project task counts and workspace-wide totals.
+ * Respects project permissions — only includes readable projects.
+ */
+export declare function workspaceStatus(): Promise<WorkspaceStatus>;
+/**
+ * Get all agents registered across all projects.
+ *
+ * Queries each project's agent_instances table and returns a unified list.
+ */
+export declare function workspaceAgents(): Promise<WorkspaceAgent[]>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/nexus/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/nexus/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW1D,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,yBAAyB;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAqED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,GAAG,IAAI,CAmC9E;AAYD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBvF;AA4JD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CA+ChE;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAwBjE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.3.73",
+  "version": "2026.3.74",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,10 +37,10 @@
     "write-file-atomic": "^6.0.0",
     "yaml": "^2.8.2",
     "zod": "^3.25.76",
-    "@cleocode/adapters": "2026.3.73",
-    "@cleocode/agents": "2026.3.73",
-    "@cleocode/contracts": "2026.3.73",
-    "@cleocode/skills": "2026.3.73"
+    "@cleocode/adapters": "2026.3.74",
+    "@cleocode/agents": "2026.3.74",
+    "@cleocode/skills": "2026.3.74",
+    "@cleocode/contracts": "2026.3.74"
   },
   "engines": {
     "node": ">=24.0.0"

package/src/cleo.ts

@@ -81,6 +81,13 @@ import {
   nexusUnregister,
 } from './nexus/registry.js';
 import { getSharingStatus } from './nexus/sharing/index.js';
+// Nexus workspace (ORCH-PLAN Phase B)
+import {
+  parseDirective,
+  routeDirective,
+  workspaceAgents,
+  workspaceStatus,
+} from './nexus/workspace.js';
 // Orchestration
 import {
   analyzeEpic,
@@ -427,6 +434,13 @@ export class Cleo {
       search: (p) => searchAcrossProjects(p.pattern, p.project, p.limit),
       setPermission: (p) => setPermission(p.name, p.level),
       sharingStatus: () => getSharingStatus(),
+      route: (message) => {
+        const directive = parseDirective(message);
+        if (!directive) return Promise.resolve([]);
+        return routeDirective(directive);
+      },
+      workspaceStatus: () => workspaceStatus(),
+      workspaceAgents: () => workspaceAgents(),
     };
   }
 

package/src/nexus/index.ts

@@ -112,3 +112,18 @@ export type {
   TransferResult,
   TransferScope,
 } from './transfer-types.js';
+export type {
+  ParsedDirective,
+  ProjectACL,
+  RouteResult,
+  WorkspaceAgent,
+  WorkspaceProjectSummary,
+  WorkspaceStatus,
+} from './workspace.js';
+// Workspace - cross-project orchestration (ORCH-PLAN Phase B)
+export {
+  parseDirective,
+  routeDirective,
+  workspaceAgents,
+  workspaceStatus,
+} from './workspace.js';