@cleocode/core 2026.3.44 → 2026.3.46

package/src/agents/__tests__/retry.test.js

@@ -0,0 +1,225 @@
+/**
+ * Tests for retry logic, exponential backoff, and self-healing recovery.
+ *
+ * @module agents/__tests__/retry.test
+ */
+import { mkdir, mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { registerAgent, updateAgentStatus } from '../registry.js';
+import { calculateDelay, createRetryPolicy, DEFAULT_RETRY_POLICY, recoverCrashedAgents, shouldRetry, withRetry, } from '../retry.js';
+// ==========================================================================
+// Retry Policy
+// ==========================================================================
+describe('Retry Policy', () => {
+    describe('createRetryPolicy', () => {
+        it('returns default policy when no overrides', () => {
+            const policy = createRetryPolicy();
+            expect(policy.maxRetries).toBe(3);
+            expect(policy.baseDelayMs).toBe(1_000);
+            expect(policy.maxDelayMs).toBe(30_000);
+            expect(policy.backoffMultiplier).toBe(2);
+            expect(policy.jitter).toBe(true);
+            expect(policy.retryOnUnknown).toBe(true);
+        });
+        it('merges partial overrides with defaults', () => {
+            const policy = createRetryPolicy({ maxRetries: 5, baseDelayMs: 500 });
+            expect(policy.maxRetries).toBe(5);
+            expect(policy.baseDelayMs).toBe(500);
+            expect(policy.maxDelayMs).toBe(30_000); // unchanged default
+        });
+        it('DEFAULT_RETRY_POLICY is frozen', () => {
+            expect(Object.isFrozen(DEFAULT_RETRY_POLICY)).toBe(true);
+        });
+    });
+    describe('calculateDelay', () => {
+        it('applies exponential backoff', () => {
+            const policy = createRetryPolicy({ jitter: false, baseDelayMs: 100, backoffMultiplier: 2 });
+            expect(calculateDelay(0, policy)).toBe(100); // 100 * 2^0
+            expect(calculateDelay(1, policy)).toBe(200); // 100 * 2^1
+            expect(calculateDelay(2, policy)).toBe(400); // 100 * 2^2
+            expect(calculateDelay(3, policy)).toBe(800); // 100 * 2^3
+        });
+        it('caps at maxDelay', () => {
+            const policy = createRetryPolicy({
+                jitter: false,
+                baseDelayMs: 100,
+                maxDelayMs: 500,
+                backoffMultiplier: 10,
+            });
+            expect(calculateDelay(0, policy)).toBe(100);
+            expect(calculateDelay(1, policy)).toBe(500); // capped
+            expect(calculateDelay(2, policy)).toBe(500); // capped
+        });
+        it('adds jitter when enabled', () => {
+            const policy = createRetryPolicy({
+                jitter: true,
+                baseDelayMs: 1000,
+                backoffMultiplier: 1,
+            });
+            // With jitter, delay should be >= base but <= base * 1.25
+            const delays = Array.from({ length: 20 }, () => calculateDelay(0, policy));
+            const allInRange = delays.every((d) => d >= 1000 && d <= 1250);
+            expect(allInRange).toBe(true);
+            // With 20 samples, at least some should differ (jitter is random)
+            const uniqueDelays = new Set(delays);
+            expect(uniqueDelays.size).toBeGreaterThan(1);
+        });
+    });
+    describe('shouldRetry', () => {
+        it('allows retry for retriable errors within limit', () => {
+            const policy = createRetryPolicy({ maxRetries: 3 });
+            expect(shouldRetry(new Error('ECONNREFUSED'), 0, policy)).toBe(true);
+            expect(shouldRetry(new Error('timeout'), 1, policy)).toBe(true);
+            expect(shouldRetry(new Error('503 Service Unavailable'), 2, policy)).toBe(true);
+        });
+        it('denies retry when attempt exceeds maxRetries', () => {
+            const policy = createRetryPolicy({ maxRetries: 3 });
+            expect(shouldRetry(new Error('ECONNREFUSED'), 3, policy)).toBe(false);
+            expect(shouldRetry(new Error('ECONNREFUSED'), 4, policy)).toBe(false);
+        });
+        it('denies retry for permanent errors', () => {
+            const policy = createRetryPolicy({ maxRetries: 10 });
+            expect(shouldRetry(new Error('Permission denied'), 0, policy)).toBe(false);
+            expect(shouldRetry(new Error('401 Unauthorized'), 0, policy)).toBe(false);
+        });
+        it('respects retryOnUnknown policy', () => {
+            const retryUnknown = createRetryPolicy({ retryOnUnknown: true });
+            const noRetryUnknown = createRetryPolicy({ retryOnUnknown: false });
+            const unknownError = new Error('Something weird');
+            expect(shouldRetry(unknownError, 0, retryUnknown)).toBe(true);
+            expect(shouldRetry(unknownError, 0, noRetryUnknown)).toBe(false);
+        });
+    });
+});
+// ==========================================================================
+// withRetry wrapper
+// ==========================================================================
+describe('withRetry', () => {
+    it('succeeds on first attempt', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            return 'success';
+        });
+        expect(result.success).toBe(true);
+        expect(result.value).toBe('success');
+        expect(result.attempts).toBe(1);
+        expect(callCount).toBe(1);
+    });
+    it('retries on retriable error and eventually succeeds', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            if (callCount < 3)
+                throw new Error('ECONNREFUSED');
+            return 'recovered';
+        }, { baseDelayMs: 1, maxDelayMs: 5, jitter: false });
+        expect(result.success).toBe(true);
+        expect(result.value).toBe('recovered');
+        expect(result.attempts).toBe(3);
+        expect(callCount).toBe(3);
+    });
+    it('fails immediately on permanent error', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            throw new Error('Permission denied');
+        }, { baseDelayMs: 1, jitter: false });
+        expect(result.success).toBe(false);
+        expect(result.error?.message).toBe('Permission denied');
+        expect(result.attempts).toBe(1);
+        expect(callCount).toBe(1);
+    });
+    it('exhausts retries and fails', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            throw new Error('ECONNREFUSED');
+        }, { maxRetries: 2, baseDelayMs: 1, maxDelayMs: 5, jitter: false });
+        expect(result.success).toBe(false);
+        expect(result.attempts).toBe(3); // 1 initial + 2 retries
+        expect(callCount).toBe(3);
+    });
+    it('tracks total delay time', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            if (callCount <= 2)
+                throw new Error('timeout');
+            return 'ok';
+        }, { baseDelayMs: 10, backoffMultiplier: 1, jitter: false });
+        expect(result.success).toBe(true);
+        expect(result.totalDelayMs).toBeGreaterThanOrEqual(20); // 10 + 10
+    });
+    it('uses custom retry policy', async () => {
+        let callCount = 0;
+        const result = await withRetry(async () => {
+            callCount++;
+            throw new Error('rate limit');
+        }, { maxRetries: 1, baseDelayMs: 1, jitter: false });
+        expect(result.success).toBe(false);
+        expect(result.attempts).toBe(2); // 1 initial + 1 retry
+        expect(callCount).toBe(2);
+    });
+});
+// ==========================================================================
+// Self-Healing Recovery
+// ==========================================================================
+describe('recoverCrashedAgents', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'cleo-recover-test-'));
+        await mkdir(join(tempDir, '.cleo'), { recursive: true });
+        await mkdir(join(tempDir, '.cleo', 'backups', 'operational'), { recursive: true });
+    });
+    afterEach(async () => {
+        try {
+            const { closeAllDatabases } = await import('../../store/sqlite.js');
+            await closeAllDatabases();
+        }
+        catch {
+            /* module may not be loaded */
+        }
+        await Promise.race([
+            rm(tempDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 300 }).catch(() => { }),
+            new Promise((resolve) => setTimeout(resolve, 8_000)),
+        ]);
+    });
+    it('recovers crashed agents with retriable errors', async () => {
+        const agent = await registerAgent({ agentType: 'executor' }, tempDir);
+        await updateAgentStatus(agent.id, { status: 'crashed', error: 'ECONNREFUSED' }, tempDir);
+        const results = await recoverCrashedAgents(30_000, tempDir);
+        expect(results.length).toBe(1);
+        expect(results[0].recovered).toBe(true);
+        expect(results[0].action).toBe('restarted');
+    });
+    it('abandons agents with permanent errors', async () => {
+        const agent = await registerAgent({ agentType: 'executor' }, tempDir);
+        await updateAgentStatus(agent.id, { status: 'crashed', error: 'Permission denied' }, tempDir);
+        const results = await recoverCrashedAgents(30_000, tempDir);
+        expect(results.length).toBe(1);
+        expect(results[0].recovered).toBe(false);
+        expect(results[0].action).toBe('abandoned');
+    });
+    it('abandons agents exceeding error threshold', async () => {
+        const agent = await registerAgent({ agentType: 'executor' }, tempDir);
+        // Simulate 5+ errors
+        for (let i = 0; i < 5; i++) {
+            await updateAgentStatus(agent.id, { status: 'error', error: `Error ${i}` }, tempDir);
+        }
+        await updateAgentStatus(agent.id, { status: 'crashed' }, tempDir);
+        const results = await recoverCrashedAgents(30_000, tempDir);
+        expect(results.length).toBe(1);
+        expect(results[0].recovered).toBe(false);
+        expect(results[0].action).toBe('abandoned');
+        expect(results[0].reason).toContain('exceeds threshold');
+    });
+    it('returns empty results when no crashed agents', async () => {
+        await registerAgent({ agentType: 'executor' }, tempDir);
+        const results = await recoverCrashedAgents(60_000, tempDir);
+        expect(results.length).toBe(0);
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/src/agents/__tests__/retry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.test.js","sourceRoot":"","sources":["retry.test.ts"],"names":[],"mappings":"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"}

package/src/bootstrap.ts

@@ -141,7 +141,9 @@ async function injectAgentsHub(ctx: BootstrapContext): Promise<void> {
         }
       }
 
-      const action = await inject(globalAgentsMd, '@~/.cleo/templates/CLEO-INJECTION.md');
+      // Direct call — CAAMP 1.8.0 handles idempotency
+      const expectedContent = '@~/.cleo/templates/CLEO-INJECTION.md';
+      const action = await inject(globalAgentsMd, expectedContent);
       ctx.created.push(`~/.agents/AGENTS.md (${action})`);
     } else {
       ctx.created.push('~/.agents/AGENTS.md (would create/update CAAMP block)');

package/src/init.ts

@@ -34,6 +34,7 @@
 
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { copyFile, lstat, mkdir, readFile, symlink, unlink, writeFile } from 'node:fs/promises';
+import { platform } from 'node:os';
 import { basename, dirname, join } from 'node:path';
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from './errors.js';
@@ -83,6 +84,15 @@ export interface InitResult {
   updateDocsOnly?: boolean;
 }
 
+// ── Helpers ──────────────────────────────────────────────────────────
+
+/**
+ * Symlink type for directory symlinks.
+ * On Windows, use 'junction' (no admin privileges required).
+ * On Unix, use 'dir'.
+ */
+const DIR_SYMLINK_TYPE: 'junction' | 'dir' = platform() === 'win32' ? 'junction' : 'dir';
+
 // ── Init-specific operations ─────────────────────────────────────────
 
 /**
@@ -90,10 +100,30 @@ export interface InitResult {
  * @task T4685
  */
 export async function initAgentDefinition(created: string[], warnings: string[]): Promise<void> {
-  const packageRoot = getPackageRoot();
-  const agentSourceDir = join(packageRoot, 'agents', 'cleo-subagent');
+  // Resolve agents package via require.resolve, then workspace/bundled fallback
+  let agentSourceDir: string | null = null;
+  try {
+    const { createRequire } = await import('node:module');
+    const req = createRequire(import.meta.url);
+    const agentsPkgMain = req.resolve('@cleocode/agents/package.json');
+    const agentsPkgRoot = dirname(agentsPkgMain);
+    const candidate = join(agentsPkgRoot, 'cleo-subagent');
+    if (existsSync(candidate)) {
+      agentSourceDir = candidate;
+    }
+  } catch {
+    // Not resolvable via require.resolve — fall through to bundled path
+  }
 
-  if (!existsSync(agentSourceDir)) {
+  if (!agentSourceDir) {
+    const packageRoot = getPackageRoot();
+    const bundled = join(packageRoot, 'agents', 'cleo-subagent');
+    if (existsSync(bundled)) {
+      agentSourceDir = bundled;
+    }
+  }
+
+  if (!agentSourceDir) {
     warnings.push('agents/cleo-subagent/ not found in package, skipping agent definition install');
     return;
   }
@@ -114,7 +144,7 @@ export async function initAgentDefinition(created: string[], warnings: string[])
     }
 
     // Create symlink from ~/.agents/agents/cleo-subagent -> package agents/cleo-subagent/
-    await symlink(agentSourceDir, globalAgentsDir, 'dir');
+    await symlink(agentSourceDir, globalAgentsDir, DIR_SYMLINK_TYPE);
     created.push('agent: cleo-subagent (symlinked)');
   } catch (_err) {
     // If symlink fails (e.g., permissions), try copying
@@ -201,23 +231,38 @@ export async function initCoreSkills(created: string[], warnings: string[]): Pro
       return;
     }
 
-    // Find skills package: bundled first, then node_modules fallback
+    // Find skills package via require.resolve, then workspace path, then node_modules fallback
     const packageRoot = getPackageRoot();
     let ctSkillsRoot: string | null = null;
     try {
-      // Check bundled package first (packages/skills/)
-      const bundledPath = join(packageRoot, 'packages', 'skills');
-      if (existsSync(join(bundledPath, 'skills.json'))) {
-        ctSkillsRoot = bundledPath;
-      } else {
-        // Fallback to node_modules
-        const ctSkillsPath = join(packageRoot, 'node_modules', '@cleocode', 'skills');
-        if (existsSync(join(ctSkillsPath, 'skills.json'))) {
-          ctSkillsRoot = ctSkillsPath;
-        }
+      // Primary: resolve via Node module resolution (@cleocode/skills)
+      const { createRequire } = await import('node:module');
+      const req = createRequire(import.meta.url);
+      const skillsPkgMain = req.resolve('@cleocode/skills/package.json');
+      const skillsPkgRoot = dirname(skillsPkgMain);
+      if (existsSync(join(skillsPkgRoot, 'skills.json'))) {
+        ctSkillsRoot = skillsPkgRoot;
       }
     } catch {
-      // not found
+      // Not resolvable via require.resolve — try workspace and node_modules fallbacks
+    }
+
+    if (!ctSkillsRoot) {
+      try {
+        // Workspace monorepo fallback (packages/skills/)
+        const bundledPath = join(packageRoot, 'packages', 'skills');
+        if (existsSync(join(bundledPath, 'skills.json'))) {
+          ctSkillsRoot = bundledPath;
+        } else {
+          // node_modules fallback
+          const ctSkillsPath = join(packageRoot, 'node_modules', '@cleocode', 'skills');
+          if (existsSync(join(ctSkillsPath, 'skills.json'))) {
+            ctSkillsRoot = ctSkillsPath;
+          }
+        }
+      } catch {
+        // not found
+      }
     }
 
     if (!ctSkillsRoot) {
@@ -651,8 +696,8 @@ export async function initProject(opts: InitOptions = {}): Promise<InitResult> {
   // T4685: Agent definition (cleo-subagent)
   await initAgentDefinition(created, warnings);
 
-  // T4707 + T4689: Core skills installation
-  await initCoreSkills(created, warnings);
+  // Note: Core skills installation is global-only (bootstrapGlobalCleo / installSkillsGlobally).
+  // Skills are NOT installed during project-level init — they are installed once globally.
 
   // T4684: NEXUS registration (reconcile-based handshake, T5368)
   await initNexusRegistration(projRoot, created, warnings);

package/src/injection.ts

@@ -78,7 +78,7 @@ async function removeStaleAgentInjection(projectRoot: string): Promise<boolean>
  *
  * Target architecture:
  *   CLAUDE.md/GEMINI.md -> @AGENTS.md (via injectAll)
- *   AGENTS.md -> @~/.cleo/templates/CLEO-INJECTION.md + @.cleo/project-context.json
+ *   AGENTS.md -> @~/.agents/AGENTS.md + @.cleo/project-context.json + @.cleo/memory-bridge.md
  *
  * @task T4682
  */
@@ -125,8 +125,9 @@ export async function ensureInjection(projectRoot: string): Promise<ScaffoldResu
   }
 
   // Step 2: Inject CLEO protocol content into AGENTS.md itself
+  // Project AGENTS.md references the global hub, which loads CLEO-INJECTION.md
   const agentsMdPath = join(projectRoot, 'AGENTS.md');
-  const agentsMdLines = ['@~/.cleo/templates/CLEO-INJECTION.md'];
+  const agentsMdLines = ['@~/.agents/AGENTS.md'];
 
   const projectContextPath = join(projectRoot, '.cleo', 'project-context.json');
   if (existsSync(projectContextPath)) {
@@ -146,7 +147,10 @@ export async function ensureInjection(projectRoot: string): Promise<ScaffoldResu
     agentsMdLines.push(contributorBlock);
   }
 
-  const agentsAction = await inject(agentsMdPath, agentsMdLines.join('\n'));
+  const agentsMdContent = agentsMdLines.join('\n');
+
+  // Direct call — CAAMP 1.8.0 handles idempotency
+  const agentsAction = await inject(agentsMdPath, agentsMdContent);
   actions.push(`AGENTS.md CLEO content (${agentsAction})`);
 
   // Step 3: Install CLEO-INJECTION.md to global templates dir
@@ -161,12 +165,14 @@ export async function ensureInjection(projectRoot: string): Promise<ScaffoldResu
     }
   }
 
-  // Step 4: Create global ~/.agents/AGENTS.md hub if it doesn't exist
+  // Step 4: Create global ~/.agents/AGENTS.md hub (idempotent)
   try {
     const globalAgentsDir = getAgentsHome();
     const globalAgentsMd = join(globalAgentsDir, 'AGENTS.md');
+    const globalHubContent = '@~/.cleo/templates/CLEO-INJECTION.md';
     await mkdir(globalAgentsDir, { recursive: true });
-    await inject(globalAgentsMd, '@~/.cleo/templates/CLEO-INJECTION.md');
+    // Direct call — CAAMP 1.8.0 handles idempotency
+    await inject(globalAgentsMd, globalHubContent);
   } catch {
     // Best-effort — don't fail if global hub creation fails
   }

package/src/intelligence/__tests__/impact.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tests for impact analysis module.
+ *
+ * Covers:
+ *   - Simple dependency chains (A->B->C)
+ *   - Complex graphs (diamond dependencies)
+ *   - Each change type (cancel, block, complete, reprioritize)
+ *   - Blast radius calculation
+ *   - Critical path detection
+ *   - Edge cases (orphan tasks, circular refs, no deps)
+ *
+ * @module intelligence
+ */
+export {};
+//# sourceMappingURL=impact.test.d.ts.map

package/src/intelligence/__tests__/impact.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.test.d.ts","sourceRoot":"","sources":["impact.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}