@cleocode/core 2026.3.37 → 2026.3.39

package/src/admin/import.ts

@@ -8,8 +8,8 @@
 
 import { constants as fsConstants } from 'node:fs';
 import { access, readFile } from 'node:fs/promises';
-import { getAccessor } from '../store/data-accessor.js';
 import type { Task, TaskPriority, TaskStatus } from '@cleocode/contracts';
+import { getAccessor } from '../store/data-accessor.js';
 
 type DuplicateStrategy = 'skip' | 'overwrite' | 'rename';
 
@@ -137,7 +137,8 @@ export async function importTasks(params: ImportParams): Promise<ImportResult> {
     imported.push(importTask);
   }
 
-  const totalTasks = existingTasks.length + imported.filter((t) => !existingTasks.some((e) => e.id === t.id)).length;
+  const totalTasks =
+    existingTasks.length + imported.filter((t) => !existingTasks.some((e) => e.id === t.id)).length;
 
   if (params.dryRun) {
     return {

package/src/admin/sync.ts

@@ -9,8 +9,8 @@
 
 import { rm, rmdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
-import { readJson } from '../store/json.js';
 import { getCleoDir } from '../paths.js';
+import { readJson } from '../store/json.js';
 
 /** Sync session state stored in .cleo/sync/todowrite-session.json. */
 interface SyncSessionState {

package/src/adrs/validate.ts

@@ -13,7 +13,9 @@ import { default as AjvImport } from 'ajv';
 
 // Handle ESM/CJS interop for Ajv
 const ajvMod = AjvImport as Record<string, unknown>;
-const Ajv = (typeof ajvMod.default === 'function' ? ajvMod.default : AjvImport) as new (opts?: Record<string, unknown>) => AjvInstance;
+const Ajv = (typeof ajvMod.default === 'function' ? ajvMod.default : AjvImport) as new (
+  opts?: Record<string, unknown>,
+) => AjvInstance;
 
 import { parseAdrFile } from './parse.js';
 

package/src/bootstrap.ts

@@ -135,10 +135,7 @@ async function injectAgentsHub(ctx: BootstrapContext): Promise<void> {
       // Strip any legacy CLEO blocks first
       if (existsSync(globalAgentsMd)) {
         const content = await readFile(globalAgentsMd, 'utf8');
-        const stripped = content.replace(
-          /\n?<!-- CLEO:START -->[\s\S]*?<!-- CLEO:END -->\n?/g,
-          '',
-        );
+        const stripped = content.replace(/\n?<!-- CLEO:START -->[\s\S]*?<!-- CLEO:END -->\n?/g, '');
         if (stripped !== content) {
           await writeFile(globalAgentsMd, stripped, 'utf8');
         }

package/src/caamp/adapter.ts

@@ -517,22 +517,21 @@ export async function dualScopeConfigure(
 // Utility Re-exports (passthrough, no EngineResult wrapping)
 // ============================================================
 
-export {
-  resolveAlias as caampResolveAlias,
-  buildServerConfig as caampBuildServerConfig,
-  generateInjectionContent as caampGenerateInjectionContent,
-  getInstructionFiles as caampGetInstructionFiles,
-};
-
 // Re-export CAAMP types for downstream consumers
 export type {
-  Provider as CaampProvider,
-  McpServerConfig as CaampMcpServerConfig,
-  DetectionResult as CaampDetectionResult,
-  InstallResult as CaampInstallResult,
-  InjectionStatus as CaampInjectionStatus,
   BatchInstallOptions as CaampBatchInstallOptions,
   BatchInstallResult as CaampBatchInstallResult,
+  DetectionResult as CaampDetectionResult,
   DualScopeConfigureOptions as CaampDualScopeConfigureOptions,
   DualScopeConfigureResult as CaampDualScopeConfigureResult,
+  InjectionStatus as CaampInjectionStatus,
+  InstallResult as CaampInstallResult,
+  McpServerConfig as CaampMcpServerConfig,
+  Provider as CaampProvider,
+};
+export {
+  buildServerConfig as caampBuildServerConfig,
+  generateInjectionContent as caampGenerateInjectionContent,
+  getInstructionFiles as caampGetInstructionFiles,
+  resolveAlias as caampResolveAlias,
 };

package/src/cleo.ts

@@ -27,37 +27,24 @@ import type {
   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,9 @@ import {
   getReadyTasks,
   startOrchestration,
 } from './orchestration/index.js';
-
-// Lifecycle
-import {
-  checkGate,
-  completeStage,
-  failGate,
-  getLifecycleHistory,
-  getLifecycleStatus,
-  passGate,
-  PIPELINE_STAGES,
-  resetStage,
-  skipStage,
-  startStage,
-} from './lifecycle/index.js';
+// Reconciliation (sync)
+import { reconcile } from './reconciliation/index.js';
+import { clearSyncState, readSyncState, writeSyncState } from './reconciliation/sync-state.js';
 
 // Release
 import {
@@ -105,12 +92,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 +121,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 +150,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 +183,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 +265,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: {
@@ -343,14 +353,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 +415,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 +443,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 +514,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 +549,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),

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