@cleocode/core 2026.4.30 → 2026.4.35

package/src/internal.ts

@@ -22,6 +22,16 @@ export * from './index.js';
 // Extended flat exports (required by @cleocode/cleo)
 // ---------------------------------------------------------------------------
 
+// Code analysis (Smart Explore) — canonical source: @cleocode/nexus
+export {
+  batchParse,
+  isTreeSitterAvailable,
+  parseFile,
+  type SmartSearchOptions,
+  smartOutline,
+  smartSearch,
+  smartUnfold,
+} from '@cleocode/nexus';
 export { exportTasks } from './admin/export.js';
 export { exportTasksPackage } from './admin/export-tasks.js';
 // Admin
@@ -36,17 +46,17 @@ export type { AuditEntry } from './audit.js';
 // Backfill
 export type { BackfillOptions, BackfillResult, BackfillTaskChange } from './backfill/index.js';
 export { backfillTasks, generateAcFromDescription } from './backfill/index.js';
-export type { BootstrapContext, BootstrapOptions } from './bootstrap.js';
+export type {
+  BootstrapContext,
+  BootstrapOptions,
+  BootstrapVerificationResult,
+} from './bootstrap.js';
 // Bootstrap (global setup)
 export {
   bootstrapGlobalCleo,
   installSkillsGlobally,
+  verifyBootstrapComplete,
 } from './bootstrap.js';
-export { smartOutline } from './code/outline.js';
-// Code analysis (Smart Explore)
-export { batchParse, isTreeSitterAvailable, parseFile } from './code/parser.js';
-export { type SmartSearchOptions, smartSearch } from './code/search.js';
-export { smartUnfold } from './code/unfold.js';
 export type { ViolationLogEntry } from './compliance/protocol-enforcement.js';
 // Compliance
 export { ProtocolEnforcer, protocolEnforcer } from './compliance/protocol-enforcement.js';
@@ -63,9 +73,21 @@ export { validatePayload } from './hooks/payload-schemas.js';
 // Hooks
 export type { HookEvent, ProviderHookEvent } from './hooks/provider-hooks.js';
 export { isProviderHookEvent } from './hooks/types.js';
-
 // Init (additional)
 export { isAutoInitEnabled } from './init.js';
+export type {
+  AdaptiveValidationSuggestion,
+  GateFocusRecommendation,
+  StorePredictionOptions,
+  VerificationConfidenceScore,
+} from './intelligence/adaptive-validation.js';
+// Intelligence — adaptive validation (suggestGateFocus, scoreVerificationConfidence)
+export {
+  predictAndStore,
+  scoreVerificationConfidence,
+  storePrediction,
+  suggestGateFocus,
+} from './intelligence/adaptive-validation.js';
 export {
   analyzeChangeImpact,
   analyzeTaskImpact,
@@ -146,6 +168,8 @@ export {
 } from './lifecycle/index.js';
 export { STAGE_DEFINITIONS } from './lifecycle/stages.js';
 export { instantiateTessera, showTessera } from './lifecycle/tessera-engine.js';
+export type { BrainBackfillResult } from './memory/brain-backfill.js';
+export { backfillBrainGraph } from './memory/brain-backfill.js';
 // Memory — brain lifecycle (temporal decay + consolidation)
 export type { ConsolidationResult, DecayResult } from './memory/brain-lifecycle.js';
 export { applyTemporalDecay, consolidateMemories } from './memory/brain-lifecycle.js';
@@ -159,11 +183,16 @@ export type {
   BrainMaintenanceResult,
 } from './memory/brain-maintenance.js';
 export { runBrainMaintenance } from './memory/brain-maintenance.js';
+export type { PurgeResult } from './memory/brain-purge.js';
+export { purgeBrainNoise } from './memory/brain-purge.js';
 export type {
+  BudgetedEntry,
+  BudgetedResult,
+  BudgetedRetrievalOptions,
   PopulateEmbeddingsOptions,
   PopulateEmbeddingsResult,
 } from './memory/brain-retrieval.js';
-export { populateEmbeddings } from './memory/brain-retrieval.js';
+export { populateEmbeddings, retrieveWithBudget } from './memory/brain-retrieval.js';
 export { migrateClaudeMem } from './memory/claude-mem-migration.js';
 // Memory — engine-compat
 export {
@@ -174,9 +203,13 @@ export {
   memoryFetch,
   memoryFind,
   memoryGraphAdd,
+  memoryGraphContext,
   memoryGraphNeighbors,
+  memoryGraphRelated,
   memoryGraphRemove,
   memoryGraphShow,
+  memoryGraphStatsFull,
+  memoryGraphTrace,
   memoryLearningFind,
   memoryLearningStats,
   memoryLearningStore,
@@ -193,6 +226,13 @@ export {
   memoryTimeline,
   memoryUnlink,
 } from './memory/engine-compat.js';
+// Memory — graph traversal query functions (T535)
+export type {
+  GraphStats,
+  NodeContext,
+  RelatedNode,
+  TraceNode,
+} from './memory/graph-queries.js';
 // Memory — pipeline manifests
 export {
   pipelineManifestAppend,
@@ -413,6 +453,9 @@ export { createBackup, listBackups, restoreFromBackup } from './store/backup.js'
 // Backup portability — bundle packer (T311 / T347)
 export type { PackBundleInput, PackBundleResult } from './store/backup-pack.js';
 export { packBundle } from './store/backup-pack.js';
+export type { BrainDataAccessor } from './store/brain-accessor.js';
+// Brain accessor — for intelligence domain handler construction
+export { getBrainAccessor } from './store/brain-accessor.js';
 export { getBrainDb, getBrainNativeDb } from './store/brain-sqlite.js';
 export type { LegacyCleanupResult, StrayNexusCleanupResult } from './store/cleanup-legacy.js';
 export {
@@ -491,6 +534,12 @@ export type { BackupEntry, BackupResult, RestoreResult } from './system/backup.j
 export { listSystemBackups, restoreBackup } from './system/backup.js';
 export type { CleanupResult } from './system/cleanup.js';
 export { cleanupSystem } from './system/cleanup.js';
+// System — dependency registry
+export {
+  checkAllDependencies,
+  checkDependency,
+  getDependencySpecs,
+} from './system/dependencies.js';
 export type { DiagnosticsResult, HealthResult } from './system/health.js';
 export { getSystemDiagnostics, getSystemHealth, startupHealthCheck } from './system/health.js';
 export type {
@@ -837,7 +886,11 @@ export type {
   BrainTimelineNeighborRow,
 } from './memory/brain-row-types.js';
 // Memory (additional)
-export { generateContextAwareContent, writeMemoryBridge } from './memory/memory-bridge.js';
+export {
+  generateContextAwareContent,
+  refreshMemoryBridge,
+  writeMemoryBridge,
+} from './memory/memory-bridge.js';
 export type { SessionMemoryContext } from './memory/session-memory.js';
 export {
   buildSummarizationPrompt,
@@ -851,6 +904,12 @@ export {
   discoverRelated as nexusDiscoverRelated,
   searchAcrossProjects as nexusSearchAcrossProjects,
 } from './nexus/discover.js';
+// Nexus — bridge (code intelligence summary for agents)
+export {
+  generateNexusBridgeContent,
+  refreshNexusBridge,
+  writeNexusBridge,
+} from './nexus/nexus-bridge.js';
 // Nexus — readRegistry (exported as nexusReadRegistry to avoid name clash with skills readRegistry)
 export { readRegistry as nexusReadRegistry } from './nexus/registry.js';
 // Nexus — transfer

package/src/lib/tree-sitter-languages.ts

@@ -1,10 +1,11 @@
 /**
  * Tree-sitter language detection and grammar resolution.
  *
- * Maps file extensions to tree-sitter grammar packages for use by
- * the Smart Explore code analysis pipeline.
+ * Maps file extensions to tree-sitter language identifiers used by
+ * the Smart Explore code analysis pipeline (outline, search, unfold).
+ * Grammar loading is handled internally by parser.ts via native Node bindings.
  *
- * @task T148
+ * @task T509
  */
 
 /** Supported tree-sitter language identifiers. */
@@ -60,9 +61,9 @@ const GRAMMAR_PACKAGE_MAP: Record<TreeSitterLanguage, string> = {
 };
 
 /**
- * Detect tree-sitter language from a file path.
+ * Detect tree-sitter language from a file path or file name.
  *
- * @param filePath - Path to a source file
+ * @param filePath - Path to a source file (or bare file name)
  * @returns The detected language, or undefined if unsupported
  */
 export function detectLanguage(filePath: string): TreeSitterLanguage | undefined {
@@ -74,6 +75,9 @@ export function detectLanguage(filePath: string): TreeSitterLanguage | undefined
 /**
  * Get the npm grammar package name for a language.
  *
+ * The package name matches the native Node binding that parser.ts loads
+ * via {@link createRequire}. Useful for diagnostics and install hints.
+ *
  * @param language - A tree-sitter language identifier
  * @returns The npm package name containing the grammar
  */
@@ -81,8 +85,8 @@ export function grammarPackage(language: TreeSitterLanguage): string {
   return GRAMMAR_PACKAGE_MAP[language];
 }
 
-/** All supported file extensions. */
+/** All supported file extensions (without leading dot). */
 export const SUPPORTED_EXTENSIONS = Object.keys(EXTENSION_MAP);
 
-/** All supported languages. */
+/** All supported languages (deduplicated). */
 export const SUPPORTED_LANGUAGES: TreeSitterLanguage[] = [...new Set(Object.values(EXTENSION_MAP))];

package/src/memory/__tests__/auto-extract.test.ts

@@ -1,7 +1,11 @@
 /**
  * Unit tests for auto-extract memory pipeline.
  *
- * All external dependencies are mocked — this tests extraction logic only.
+ * extractTaskCompletionMemory and extractSessionEndMemory are disabled no-ops
+ * per T523 CA1 specification. Tests verify the no-op contract holds.
+ *
+ * @task T526
+ * @epic T523
  */
 
 import type { Task } from '@cleocode/contracts';
@@ -21,7 +25,7 @@ vi.mock('../decisions.js', () => ({
   storeDecision: vi.fn().mockResolvedValue(undefined),
 }));
 
-// Mock getAccessor used inside auto-extract for pattern detection
+// Mock getAccessor — should never be called by disabled functions
 vi.mock('../../store/data-accessor.js', () => ({
   getAccessor: vi.fn(),
 }));
@@ -80,24 +84,16 @@ beforeEach(() => {
 });
 
 describe('extractTaskCompletionMemory', () => {
-  it('creates a learning from completed task', async () => {
+  it('is a no-op — does not write learnings', async () => {
     const task = makeTask({ id: 'T001', title: 'Fix auth bug', description: 'Auth was broken' });
     setupAccessor([task]);
 
     await extractTaskCompletionMemory('/mock/root', task);
 
-    expect(storeLearning).toHaveBeenCalledWith(
-      '/mock/root',
-      expect.objectContaining({
-        insight: `Completed: ${task.title} — ${task.description}`,
-        source: `task-completion:${task.id}`,
-        confidence: 0.7,
-        actionable: true,
-      }),
-    );
+    expect(storeLearning).not.toHaveBeenCalled();
   });
 
-  it('creates dependency learning when task has dependencies', async () => {
+  it('is a no-op — does not write dependency learnings', async () => {
     const task = makeTask({
       id: 'T002',
       title: 'Deploy feature',
@@ -108,28 +104,10 @@ describe('extractTaskCompletionMemory', () => {
 
     await extractTaskCompletionMemory('/mock/root', task);
 
-    const calls = (storeLearning as ReturnType<typeof vi.fn>).mock.calls;
-    const depCall = calls.find((c) =>
-      (c[1] as { insight: string }).insight.includes('depended on'),
-    );
-    expect(depCall).toBeDefined();
-    expect((depCall![1] as { insight: string }).insight).toContain('T001, T003');
-    expect((depCall![1] as { source: string }).source).toBe('task-completion:T002');
-  });
-
-  it('does not create dependency learning when task has no dependencies', async () => {
-    const task = makeTask({ id: 'T003', title: 'Solo task', depends: [] });
-    setupAccessor([task]);
-
-    await extractTaskCompletionMemory('/mock/root', task);
-
-    const depCall = (storeLearning as ReturnType<typeof vi.fn>).mock.calls.find((c) =>
-      (c[1] as { insight: string }).insight.includes('depended on'),
-    );
-    expect(depCall).toBeUndefined();
+    expect(storeLearning).not.toHaveBeenCalled();
   });
 
-  it('stores a pattern when a label appears 3+ times in done tasks', async () => {
+  it('is a no-op — does not write label patterns', async () => {
     const completedTasks = [
       makeTask({ id: 'T010', title: 'A', labels: ['bug'] }),
       makeTask({ id: 'T011', title: 'B', labels: ['bug'] }),
@@ -140,17 +118,11 @@ describe('extractTaskCompletionMemory', () => {
 
     await extractTaskCompletionMemory('/mock/root', trigger);
 
-    expect(storePattern).toHaveBeenCalledWith(
-      '/mock/root',
-      expect.objectContaining({
-        type: 'success',
-        impact: 'medium',
-      }),
-    );
+    expect(storePattern).not.toHaveBeenCalled();
+    expect(getAccessor).not.toHaveBeenCalled();
   });
 
-  it('does not throw on error', async () => {
-    (storeLearning as ReturnType<typeof vi.fn>).mockRejectedValueOnce(new Error('db error'));
+  it('resolves to undefined without throwing', async () => {
     setupAccessor([]);
 
     await expect(
@@ -160,7 +132,7 @@ describe('extractTaskCompletionMemory', () => {
 });
 
 describe('extractSessionEndMemory', () => {
-  it('creates a decision when tasks are completed', async () => {
+  it('is a no-op — does not write a session decision', async () => {
     const tasks = [
       makeTask({ id: 'T001', title: 'Task one' }),
       makeTask({ id: 'T002', title: 'Task two' }),
@@ -169,32 +141,10 @@ describe('extractSessionEndMemory', () => {
 
     await extractSessionEndMemory('/mock/root', session, tasks);
 
-    expect(storeDecision).toHaveBeenCalledWith(
-      '/mock/root',
-      expect.objectContaining({
-        type: 'process',
-        confidence: 'medium',
-      }),
-    );
-    const call = (storeDecision as ReturnType<typeof vi.fn>).mock.calls[0][1] as {
-      decision: string;
-      rationale: string;
-    };
-    expect(call.decision).toContain('S-001');
-    expect(call.decision).toContain('T001');
-    expect(call.decision).toContain('T002');
-    expect(call.rationale).toContain('test scope');
-  });
-
-  it('does not create a decision when no tasks completed', async () => {
-    const session = makeSessionData({ tasksCompleted: [] });
-
-    await extractSessionEndMemory('/mock/root', session, []);
-
     expect(storeDecision).not.toHaveBeenCalled();
   });
 
-  it('creates per-task learnings', async () => {
+  it('is a no-op — does not write per-task learnings', async () => {
     const tasks = [
       makeTask({ id: 'T001', title: 'Task one', description: 'Desc one' }),
       makeTask({ id: 'T002', title: 'Task two', description: 'Desc two' }),
@@ -203,15 +153,10 @@ describe('extractSessionEndMemory', () => {
 
     await extractSessionEndMemory('/mock/root', session, tasks);
 
-    const calls = (storeLearning as ReturnType<typeof vi.fn>).mock.calls;
-    expect(calls.length).toBe(2);
-    calls.forEach((c) => {
-      expect((c[1] as { source: string }).source).toBe('session-end:S-002');
-      expect((c[1] as { confidence: number }).confidence).toBe(0.7);
-    });
+    expect(storeLearning).not.toHaveBeenCalled();
   });
 
-  it('stores a workflow pattern when 2+ tasks share a label', async () => {
+  it('is a no-op — does not write workflow patterns', async () => {
     const tasks = [
       makeTask({ id: 'T001', title: 'A', labels: ['feature'] }),
       makeTask({ id: 'T002', title: 'B', labels: ['feature'] }),
@@ -220,17 +165,10 @@ describe('extractSessionEndMemory', () => {
 
     await extractSessionEndMemory('/mock/root', session, tasks);
 
-    expect(storePattern).toHaveBeenCalledWith(
-      '/mock/root',
-      expect.objectContaining({
-        type: 'workflow',
-        impact: 'medium',
-      }),
-    );
+    expect(storePattern).not.toHaveBeenCalled();
   });
 
-  it('does not throw on error', async () => {
-    (storeDecision as ReturnType<typeof vi.fn>).mockRejectedValueOnce(new Error('db fail'));
+  it('resolves to undefined without throwing', async () => {
     const tasks = [makeTask({ id: 'T001', title: 'X' })];
     const session = makeSessionData({ tasksCompleted: ['T001'] });