@cleocode/core 2026.3.38 → 2026.3.40

package/src/cleo.ts

@@ -18,46 +18,33 @@ import path from 'node:path';
 import type {
   DataAccessor,
   ExternalTask,
+  ExternalTaskLink,
   ReconcileOptions,
   ReconcileResult,
-  SyncSessionState,
   Task,
   TaskPriority,
   TaskSize,
   TaskStatus,
   TaskType,
 } from '@cleocode/contracts';
-
-// Tasks
-import { addTask } from './tasks/add.js';
-import { archiveTasks } from './tasks/archive.js';
-import { completeTask } from './tasks/complete.js';
-import { deleteTask } from './tasks/delete.js';
-import { findTasks } from './tasks/find.js';
-import { listTasks } from './tasks/list.js';
-import { showTask } from './tasks/show.js';
-import { updateTask } from './tasks/update.js';
-
-// Sessions
+// Admin
+import { exportTasks } from './admin/export.js';
+import type { ImportParams } from './admin/import.js';
+import { importTasks } from './admin/import.js';
+// Lifecycle
 import {
-  computeBriefing,
-  computeHandoff,
-  endSession,
-  findSessions,
-  gcSessions,
-  getContextDrift,
-  getDecisionLog,
-  getLastHandoff,
-  listSessions,
-  recordAssumption,
-  recordDecision,
-  resumeSession,
-  sessionStatus,
-  showSession,
-  startSession,
-  suspendSession,
-} from './sessions/index.js';
-
+  checkGate,
+  completeStage,
+  failGate,
+  getLifecycleHistory,
+  getLifecycleStatus,
+  PIPELINE_STAGES,
+  passGate,
+  resetStage,
+  skipStage,
+  startStage,
+} from './lifecycle/index.js';
+import type { BrainObservationType } from './memory/brain-retrieval.js';
 // Memory
 import {
   fetchBrainEntries,
@@ -65,10 +52,21 @@ import {
   searchBrainCompact,
   timelineBrain,
 } from './memory/brain-retrieval.js';
-import type { BrainObservationType } from './memory/brain-retrieval.js';
-import { hybridSearch, searchBrain } from './memory/brain-search.js';
 import type { HybridSearchOptions } from './memory/brain-search.js';
-
+import { hybridSearch, searchBrain } from './memory/brain-search.js';
+// Nexus
+import { discoverRelated, searchAcrossProjects } from './nexus/discover.js';
+import { setPermission } from './nexus/permissions.js';
+import {
+  nexusGetProject,
+  nexusInit,
+  nexusList,
+  nexusRegister,
+  nexusSync,
+  nexusSyncAll,
+  nexusUnregister,
+} from './nexus/registry.js';
+import { getSharingStatus } from './nexus/sharing/index.js';
 // Orchestration
 import {
   analyzeEpic,
@@ -80,20 +78,13 @@ import {
   getReadyTasks,
   startOrchestration,
 } from './orchestration/index.js';
-
-// Lifecycle
+// Reconciliation (sync)
+import { reconcile } from './reconciliation/index.js';
 import {
-  checkGate,
-  completeStage,
-  failGate,
-  getLifecycleHistory,
-  getLifecycleStatus,
-  passGate,
-  PIPELINE_STAGES,
-  resetStage,
-  skipStage,
-  startStage,
-} from './lifecycle/index.js';
+  getLinksByProvider,
+  getLinksByTaskId,
+  removeLinksByProvider,
+} from './reconciliation/link-store.js';
 
 // Release
 import {
@@ -105,12 +96,25 @@ import {
   rollbackRelease,
   tagRelease,
 } from './release/index.js';
-
-// Admin
-import { exportTasks } from './admin/export.js';
-import { importTasks } from './admin/import.js';
-import type { ImportParams } from './admin/import.js';
-
+// Sessions
+import {
+  computeBriefing,
+  computeHandoff,
+  endSession,
+  findSessions,
+  gcSessions,
+  getContextDrift,
+  getDecisionLog,
+  getLastHandoff,
+  listSessions,
+  recordAssumption,
+  recordDecision,
+  resumeSession,
+  sessionStatus,
+  showSession,
+  startSession,
+  suspendSession,
+} from './sessions/index.js';
 // Sticky
 import {
   addSticky,
@@ -121,27 +125,17 @@ import {
   listStickies,
   purgeSticky,
 } from './sticky/index.js';
-
-// Reconciliation (sync)
-import { reconcile } from './reconciliation/index.js';
-import { clearSyncState, readSyncState, writeSyncState } from './reconciliation/sync-state.js';
-
-// Nexus
-import { discoverRelated, searchAcrossProjects } from './nexus/discover.js';
-import { setPermission } from './nexus/permissions.js';
-import {
-  nexusGetProject,
-  nexusInit,
-  nexusList,
-  nexusRegister,
-  nexusSync,
-  nexusSyncAll,
-  nexusUnregister,
-} from './nexus/registry.js';
-import { getSharingStatus } from './nexus/sharing/index.js';
-
 // Store
 import { getAccessor } from './store/data-accessor.js';
+// Tasks
+import { addTask } from './tasks/add.js';
+import { archiveTasks } from './tasks/archive.js';
+import { completeTask } from './tasks/complete.js';
+import { deleteTask } from './tasks/delete.js';
+import { findTasks } from './tasks/find.js';
+import { listTasks } from './tasks/list.js';
+import { showTask } from './tasks/show.js';
+import { updateTask } from './tasks/update.js';
 
 // ============================================================================
 // Domain API interfaces
@@ -160,7 +154,12 @@ export interface TasksAPI {
     depends?: string[];
     notes?: string;
   }): Promise<unknown>;
-  find(params: { query?: string; id?: string; status?: TaskStatus; limit?: number }): Promise<unknown>;
+  find(params: {
+    query?: string;
+    id?: string;
+    status?: TaskStatus;
+    limit?: number;
+  }): Promise<unknown>;
   show(taskId: string): Promise<unknown>;
   list(params?: {
     status?: TaskStatus;
@@ -188,7 +187,12 @@ export interface SessionsAPI {
   status(): Promise<unknown>;
   resume(sessionId: string): Promise<unknown>;
   list(params?: { status?: string; limit?: number }): Promise<unknown>;
-  find(params?: { status?: string; scope?: string; query?: string; limit?: number }): Promise<unknown>;
+  find(params?: {
+    status?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+  }): Promise<unknown>;
   show(sessionId: string): Promise<unknown>;
   suspend(sessionId: string, reason?: string): Promise<unknown>;
   briefing(params?: { maxNextTasks?: number; scope?: string }): Promise<unknown>;
@@ -265,9 +269,19 @@ export interface AdminAPI {
 }
 
 export interface StickyAPI {
-  add(params: { content: string; tags?: string[]; priority?: string; color?: string }): Promise<unknown>;
+  add(params: {
+    content: string;
+    tags?: string[];
+    priority?: string;
+    color?: string;
+  }): Promise<unknown>;
   show(stickyId: string): Promise<unknown>;
-  list(params?: { status?: string; color?: string; priority?: string; limit?: number }): Promise<unknown>;
+  list(params?: {
+    status?: string;
+    color?: string;
+    priority?: string;
+    limit?: number;
+  }): Promise<unknown>;
   archive(stickyId: string): Promise<unknown>;
   purge(stickyId: string): Promise<unknown>;
   convert(params: {
@@ -293,6 +307,7 @@ export interface NexusAPI {
 }
 
 export interface SyncAPI {
+  /** Reconcile external tasks with CLEO as SSoT. */
   reconcile(params: {
     externalTasks: ExternalTask[];
     providerId: string;
@@ -301,9 +316,12 @@ export interface SyncAPI {
     defaultPhase?: string;
     defaultLabels?: string[];
   }): Promise<ReconcileResult>;
-  readState(providerId: string): Promise<SyncSessionState | null>;
-  writeState(providerId: string, state: SyncSessionState): Promise<void>;
-  clearState(providerId: string): Promise<void>;
+  /** Get all external task links for a provider. */
+  getLinks(providerId: string): Promise<ExternalTaskLink[]>;
+  /** Get all external task links for a CLEO task. */
+  getTaskLinks(taskId: string): Promise<ExternalTaskLink[]>;
+  /** Remove all external task links for a provider. */
+  removeProviderLinks(providerId: string): Promise<number>;
 }
 
 // ============================================================================
@@ -343,14 +361,55 @@ export class Cleo {
     const root = this.projectRoot;
     const store = this._store ?? undefined;
     return {
-      add: (p) => addTask({ title: p.title, description: p.description, parentId: p.parent, priority: p.priority, type: p.type, size: p.size, phase: p.phase, labels: p.labels, depends: p.depends, notes: p.notes }, root, store),
-      find: (p) => findTasks({ query: p.query, id: p.id, status: p.status, limit: p.limit }, root, store),
+      add: (p) =>
+        addTask(
+          {
+            title: p.title,
+            description: p.description,
+            parentId: p.parent,
+            priority: p.priority,
+            type: p.type,
+            size: p.size,
+            phase: p.phase,
+            labels: p.labels,
+            depends: p.depends,
+            notes: p.notes,
+          },
+          root,
+          store,
+        ),
+      find: (p) =>
+        findTasks({ query: p.query, id: p.id, status: p.status, limit: p.limit }, root, store),
       show: (taskId) => showTask(taskId, root, store),
-      list: (p) => listTasks({ status: p?.status, priority: p?.priority, parentId: p?.parentId, phase: p?.phase, limit: p?.limit }, root, store),
-      update: (p) => updateTask({ taskId: p.taskId, title: p.title, status: p.status, priority: p.priority, description: p.description, notes: p.notes }, root, store),
+      list: (p) =>
+        listTasks(
+          {
+            status: p?.status,
+            priority: p?.priority,
+            parentId: p?.parentId,
+            phase: p?.phase,
+            limit: p?.limit,
+          },
+          root,
+          store,
+        ),
+      update: (p) =>
+        updateTask(
+          {
+            taskId: p.taskId,
+            title: p.title,
+            status: p.status,
+            priority: p.priority,
+            description: p.description,
+            notes: p.notes,
+          },
+          root,
+          store,
+        ),
       complete: (p) => completeTask({ taskId: p.taskId, notes: p.notes }, root, store),
       delete: (p) => deleteTask({ taskId: p.taskId, force: p.force }, root, store),
-      archive: (p) => archiveTasks({ before: p?.before, taskIds: p?.taskIds, dryRun: p?.dryRun }, root, store),
+      archive: (p) =>
+        archiveTasks({ before: p?.before, taskIds: p?.taskIds, dryRun: p?.dryRun }, root, store),
     };
   }
 
@@ -364,11 +423,18 @@ export class Cleo {
       status: () => sessionStatus(root, store),
       resume: (id) => resumeSession(id, root, store),
       list: (p) => listSessions({ status: p?.status, limit: p?.limit }, root, store),
-      find: async (p) => findSessions(store ?? await getAccessor(root), { status: p?.status, scope: p?.scope, query: p?.query, limit: p?.limit }),
+      find: async (p) =>
+        findSessions(store ?? (await getAccessor(root)), {
+          status: p?.status,
+          scope: p?.scope,
+          query: p?.query,
+          limit: p?.limit,
+        }),
       show: (id) => showSession(root, id),
       suspend: (id, reason) => suspendSession(root, id, reason),
       briefing: (p) => computeBriefing(root, { maxNextTasks: p?.maxNextTasks, scope: p?.scope }),
-      handoff: (id, opts) => computeHandoff(root, { sessionId: id, note: opts?.note, nextAction: opts?.nextAction }),
+      handoff: (id, opts) =>
+        computeHandoff(root, { sessionId: id, note: opts?.note, nextAction: opts?.nextAction }),
       gc: (hours) => gcSessions(hours, root, store),
       recordDecision: (p) => recordDecision(root, p),
       recordAssumption: (p) => recordAssumption(root, p),
@@ -385,7 +451,12 @@ export class Cleo {
       observe: (p) => observeBrain(root, { text: p.text, title: p.title, type: p.type }),
       find: (p) => searchBrainCompact(root, { query: p.query, limit: p.limit, tables: p.tables }),
       fetch: (p) => fetchBrainEntries(root, { ids: p.ids }),
-      timeline: (p) => timelineBrain(root, { anchor: p.anchor, depthBefore: p.depthBefore, depthAfter: p.depthAfter }),
+      timeline: (p) =>
+        timelineBrain(root, {
+          anchor: p.anchor,
+          depthBefore: p.depthBefore,
+          depthAfter: p.depthAfter,
+        }),
       search: (query, opts) => searchBrain(root, query, { limit: opts?.limit }),
       hybridSearch: (query, opts) => hybridSearch(query, root, opts),
     };
@@ -451,9 +522,27 @@ export class Cleo {
   get sticky(): StickyAPI {
     const root = this.projectRoot;
     return {
-      add: (p) => addSticky({ content: p.content, tags: p.tags, priority: p.priority as 'low' | 'medium' | 'high' | undefined, color: p.color as 'yellow' | 'blue' | 'green' | 'red' | 'purple' | undefined }, root),
+      add: (p) =>
+        addSticky(
+          {
+            content: p.content,
+            tags: p.tags,
+            priority: p.priority as 'low' | 'medium' | 'high' | undefined,
+            color: p.color as 'yellow' | 'blue' | 'green' | 'red' | 'purple' | undefined,
+          },
+          root,
+        ),
       show: (id) => getSticky(id, root),
-      list: (p) => listStickies({ status: p?.status as 'active' | 'converted' | 'archived' | undefined, color: p?.color as 'yellow' | 'blue' | 'green' | 'red' | 'purple' | undefined, priority: p?.priority as 'low' | 'medium' | 'high' | undefined, limit: p?.limit }, root),
+      list: (p) =>
+        listStickies(
+          {
+            status: p?.status as 'active' | 'converted' | 'archived' | undefined,
+            color: p?.color as 'yellow' | 'blue' | 'green' | 'red' | 'purple' | undefined,
+            priority: p?.priority as 'low' | 'medium' | 'high' | undefined,
+            limit: p?.limit,
+          },
+          root,
+        ),
       archive: (id) => archiveSticky(id, root),
       purge: (id) => purgeSticky(id, root),
       convert: (p) => {
@@ -468,7 +557,8 @@ export class Cleo {
   get nexus(): NexusAPI {
     return {
       init: () => nexusInit(),
-      register: (p) => nexusRegister(p.path, p.name, p.permissions as 'read' | 'write' | 'execute' | undefined),
+      register: (p) =>
+        nexusRegister(p.path, p.name, p.permissions as 'read' | 'write' | 'execute' | undefined),
       unregister: (p) => nexusUnregister(p.name),
       list: () => nexusList(),
       show: (p) => nexusGetProject(p.name),
@@ -498,9 +588,9 @@ export class Cleo {
           },
           store,
         ),
-      readState: (providerId) => readSyncState(providerId, root),
-      writeState: (providerId, state) => writeSyncState(providerId, state, root),
-      clearState: (providerId) => clearSyncState(providerId, root),
+      getLinks: (providerId) => getLinksByProvider(providerId, root),
+      getTaskLinks: (taskId) => getLinksByTaskId(taskId, root),
+      removeProviderLinks: (providerId) => removeLinksByProvider(providerId, root),
     };
   }
 }

package/src/compliance/__tests__/sync.test.d.ts

@@ -2,4 +2,4 @@
  * Tests for syncComplianceMetrics.
  */
 export {};
-//# sourceMappingURL=sync.test.d.ts.map
+//# sourceMappingURL=sync.test.d.ts.map

package/src/compliance/index.ts

@@ -6,8 +6,8 @@
 
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
-import { atomicWriteJson } from '../store/atomic.js';
 import { getManifestPath as getManifestPathFromPaths } from '../paths.js';
+import { atomicWriteJson } from '../store/atomic.js';
 import { getComplianceJsonlPath, readComplianceJsonl } from './store.js';
 // CleoError and ExitCode available if needed for future error cases
 

package/src/config/build-config.ts

@@ -1,31 +1,31 @@
 /**
  * BUILD CONFIGURATION - AUTO-GENERATED FILE
- * 
+ *
  * This file is generated by dev/generate-build-config.js
  * DO NOT EDIT MANUALLY - Changes will be overwritten on next build
- * 
+ *
  * Source of truth: package.json
  * Generated at: 2026-03-18T09:06:32.935Z
- * 
+ *
  * @task T5245
  * @auto-generated
  */
 
 export const BUILD_CONFIG = {
-  "name": "@cleocode/cleo",
-  "version": "2026.3.36",
-  "description": "CLEO V2 - TypeScript task management CLI for AI coding agents",
-  "repository": {
-    "owner": "kryptobaseddev",
-    "name": "cleo",
-    "fullName": "kryptobaseddev/cleo",
-    "url": "https://github.com/kryptobaseddev/cleo.git",
-    "issuesUrl": "https://github.com/kryptobaseddev/cleo/issues"
+  name: '@cleocode/cleo',
+  version: '2026.3.36',
+  description: 'CLEO V2 - TypeScript task management CLI for AI coding agents',
+  repository: {
+    owner: 'kryptobaseddev',
+    name: 'cleo',
+    fullName: 'kryptobaseddev/cleo',
+    url: 'https://github.com/kryptobaseddev/cleo.git',
+    issuesUrl: 'https://github.com/kryptobaseddev/cleo/issues',
+  },
+  buildDate: '2026-03-18T09:06:32.935Z',
+  templates: {
+    issueTemplatesDir: 'templates/issue-templates',
   },
-  "buildDate": "2026-03-18T09:06:32.935Z",
-  "templates": {
-    "issueTemplatesDir": "templates/issue-templates"
-  }
 } as const;
 
 // Type exports for TypeScript consumers

package/src/config.ts

@@ -10,9 +10,9 @@
 import { existsSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
-import { readJson, saveJson } from './store/json.js';
 import type { CleoConfig, ConfigSource, ResolvedValue } from '@cleocode/contracts';
 import { getConfigPath, getGlobalConfigPath } from './paths.js';
+import { readJson, saveJson } from './store/json.js';
 
 /** Default configuration values. */
 const DEFAULTS: CleoConfig = {

package/src/error-catalog.ts

@@ -9,8 +9,8 @@
  * @task T5240
  */
 
-import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
 import { ExitCode } from '@cleocode/contracts';
+import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
 
 /**
  * A single entry in the unified error catalog.

package/src/error-registry.ts

@@ -12,8 +12,8 @@
  * @epic T4663
  */
 
-import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
 import { ExitCode } from '@cleocode/contracts';
+import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
 
 /**
  * Entry in the CLEO-to-LAFS error registry.

package/src/errors.ts

@@ -7,8 +7,8 @@
  * @task T5240
  */
 
-import type { LAFSError, LAFSErrorCategory } from '@cleocode/lafs-protocol';
 import { ExitCode, getExitCodeName, isRecoverableCode } from '@cleocode/contracts';
+import type { LAFSError, LAFSErrorCategory } from '@cleocode/lafs-protocol';
 import { getErrorDefinition } from './error-catalog.js';
 
 /**

package/src/hooks/__tests__/provider-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=provider-hooks.test.d.ts.map
+//# sourceMappingURL=provider-hooks.test.d.ts.map

package/src/hooks/__tests__/registry.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=registry.test.d.ts.map
+//# sourceMappingURL=registry.test.d.ts.map

package/src/hooks/handlers/__tests__/error-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=error-hooks.test.d.ts.map
+//# sourceMappingURL=error-hooks.test.d.ts.map

package/src/hooks/handlers/__tests__/file-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=file-hooks.test.d.ts.map
+//# sourceMappingURL=file-hooks.test.d.ts.map

package/src/hooks/handlers/__tests__/mcp-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=mcp-hooks.test.d.ts.map
+//# sourceMappingURL=mcp-hooks.test.d.ts.map

package/src/hooks/handlers/__tests__/session-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=session-hooks.test.d.ts.map
+//# sourceMappingURL=session-hooks.test.d.ts.map

package/src/hooks/handlers/__tests__/task-hooks.test.d.ts

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=task-hooks.test.d.ts.map
+//# sourceMappingURL=task-hooks.test.d.ts.map

package/src/hooks/provider-hooks.ts

@@ -38,5 +38,5 @@ export function getSharedHookEvents(providerIds?: string[]): CAAMPHookEvent[] {
   return getCommonHookEvents(providerIds);
 }
 
-export { getProvidersByHookEvent, getCommonHookEvents };
 export type { CAAMPHookEvent as ProviderHookEvent, HookEvent };
+export { getCommonHookEvents, getProvidersByHookEvent };

package/src/hooks.ts

@@ -36,7 +36,7 @@ export interface EnsureGitHooksOptions {
 // ── Constants ────────────────────────────────────────────────────────
 
 /** Git hooks managed by CLEO. */
-export const MANAGED_HOOKS = ['commit-msg', 'pre-commit'] as const;
+export const MANAGED_HOOKS = ['commit-msg', 'pre-commit', 'pre-push'] as const;
 
 export type ManagedHook = (typeof MANAGED_HOOKS)[number];