@cleocode/core 2026.3.38 → 2026.3.40

package/dist/memory/brain-reasoning.js

@@ -1,215 +0,0 @@
-/**
- * BRAIN Reasoning — causal trace through task dependency chains.
- *
- * `reasonWhy(taskId)` walks upstream through a task's blocker chain,
- * enriching each node with related brain_decisions. Leaf tasks with
- * no further unresolved blockers are identified as root causes.
- *
- * @task T5390
- * @epic T5149
- */
-import { getBrainAccessor } from '../store/brain-accessor.js';
-import { getAccessor } from '../store/data-accessor.js';
-import { searchBrain } from './brain-search.js';
-import { searchSimilar } from './brain-similarity.js';
-// ============================================================================
-// Implementation
-// ============================================================================
-const MAX_DEPTH = 10;
-/**
- * Build a causal trace for why a task is blocked.
- *
- * Walks upstream through `depends` fields, collecting unresolved blockers
- * and their associated brain decisions. Leaf blockers (no further unresolved
- * deps) are reported as root causes.
- */
-export async function reasonWhy(taskId, projectRoot, taskAccessor) {
-    const acc = taskAccessor ?? (await getAccessor(projectRoot));
-    const { tasks: reasonTasks } = await acc.queryTasks({});
-    const taskMap = new Map(reasonTasks.map((t) => [t.id, t]));
-    const completedStatuses = new Set(['done', 'cancelled']);
-    let accessor = null;
-    try {
-        accessor = await getBrainAccessor(projectRoot);
-    }
-    catch {
-        // brain.db may not exist — proceed without decisions
-    }
-    const visited = new Set();
-    const blockers = [];
-    let maxDepthReached = 0;
-    async function walk(id, depth) {
-        if (visited.has(id))
-            return;
-        if (depth > MAX_DEPTH)
-            return;
-        visited.add(id);
-        if (depth > maxDepthReached) {
-            maxDepthReached = depth;
-        }
-        const task = taskMap.get(id);
-        if (!task)
-            return;
-        // Collect unresolved dependencies
-        const unresolvedDeps = (task.depends ?? []).filter((depId) => {
-            const dep = taskMap.get(depId);
-            return dep && !completedStatuses.has(dep.status);
-        });
-        if (unresolvedDeps.length === 0 && id !== taskId) {
-            // This is a leaf blocker — no further unresolved deps
-            return;
-        }
-        for (const depId of unresolvedDeps) {
-            if (visited.has(depId))
-                continue;
-            const dep = taskMap.get(depId);
-            // Query brain decisions related to this blocker
-            let decisions = [];
-            if (accessor) {
-                const relatedDecisions = await findDecisionsForTask(accessor, depId);
-                decisions = relatedDecisions.map((d) => ({
-                    id: d.id,
-                    title: d.decision,
-                    rationale: d.rationale,
-                }));
-            }
-            blockers.push({
-                taskId: depId,
-                status: dep.status,
-                reason: dep.blockedBy ?? undefined,
-                decisions,
-            });
-            await walk(depId, depth + 1);
-        }
-    }
-    await walk(taskId, 0);
-    // Root causes: leaf blockers whose own deps are all resolved or absent
-    const blockerIds = new Set(blockers.map((b) => b.taskId));
-    const rootCauses = blockers
-        .filter((b) => {
-        const task = taskMap.get(b.taskId);
-        if (!task?.depends?.length)
-            return true;
-        return task.depends.every((depId) => {
-            const dep = taskMap.get(depId);
-            return !dep || completedStatuses.has(dep.status) || !blockerIds.has(depId);
-        });
-    })
-        .map((b) => b.taskId);
-    return {
-        taskId,
-        blockers,
-        rootCauses,
-        depth: maxDepthReached,
-    };
-}
-/**
- * Query brain_decisions for a specific task context.
- */
-async function findDecisionsForTask(accessor, taskId) {
-    return accessor.findDecisions({ contextTaskId: taskId });
-}
-/**
- * Find entries similar to a given brain.db entry.
- *
- * 1. Loads the source entry's text from brain.db.
- * 2. Calls searchSimilar() for vector-based similarity if embeddings exist.
- * 3. Falls back to FTS5 keyword search if no embeddings are available.
- * 4. Filters out the source entry itself.
- *
- * @param entryId - ID of the brain.db entry to find similar entries for
- * @param projectRoot - Project root directory
- * @param limit - Maximum results to return (default 10)
- * @returns Array of similar entries ranked by distance/relevance
- */
-export async function reasonSimilar(entryId, projectRoot, limit) {
-    const maxResults = limit ?? 10;
-    // Load the source entry's text — initialize brain.db before accessor use
-    const { getBrainDb } = await import('../store/brain-sqlite.js');
-    await getBrainDb(projectRoot);
-    const accessor = await getBrainAccessor(projectRoot);
-    let sourceText = null;
-    if (entryId.startsWith('D-') || /^D\d/.test(entryId)) {
-        const row = await accessor.getDecision(entryId);
-        if (row)
-            sourceText = `${row.decision} ${row.rationale}`;
-    }
-    else if (entryId.startsWith('P-') || /^P\d/.test(entryId)) {
-        const row = await accessor.getPattern(entryId);
-        if (row)
-            sourceText = `${row.pattern} ${row.context}`;
-    }
-    else if (entryId.startsWith('L-') || /^L\d/.test(entryId)) {
-        const row = await accessor.getLearning(entryId);
-        if (row)
-            sourceText = `${row.insight} ${row.source}`;
-    }
-    else {
-        const row = await accessor.getObservation(entryId);
-        if (row)
-            sourceText = row.narrative ?? row.title;
-    }
-    if (!sourceText)
-        return [];
-    // Try vector similarity first
-    const vecResults = await searchSimilar(sourceText, projectRoot, maxResults + 1);
-    if (vecResults.length > 0) {
-        return vecResults.filter((r) => r.id !== entryId).slice(0, maxResults);
-    }
-    // FTS5 fallback: extract key terms and search
-    const terms = sourceText
-        .split(/\s+/)
-        .filter((t) => t.length > 3)
-        .slice(0, 5)
-        .join(' ');
-    if (!terms)
-        return [];
-    const ftsResults = await searchBrain(projectRoot, terms, { limit: maxResults + 5 });
-    const entries = [];
-    for (const d of ftsResults.decisions) {
-        if (d.id === entryId)
-            continue;
-        entries.push({
-            id: d.id,
-            distance: 0,
-            type: 'decision',
-            title: d.decision,
-            text: `${d.decision} — ${d.rationale}`,
-        });
-    }
-    for (const p of ftsResults.patterns) {
-        if (p.id === entryId)
-            continue;
-        entries.push({
-            id: p.id,
-            distance: 0,
-            type: 'pattern',
-            title: p.pattern,
-            text: `${p.pattern} — ${p.context}`,
-        });
-    }
-    for (const l of ftsResults.learnings) {
-        if (l.id === entryId)
-            continue;
-        entries.push({
-            id: l.id,
-            distance: 0,
-            type: 'learning',
-            title: l.insight,
-            text: `${l.insight} (source: ${l.source})`,
-        });
-    }
-    for (const o of ftsResults.observations) {
-        if (o.id === entryId)
-            continue;
-        entries.push({
-            id: o.id,
-            distance: 0,
-            type: 'observation',
-            title: o.title,
-            text: o.narrative ?? o.title,
-        });
-    }
-    return entries.slice(0, maxResults);
-}
-//# sourceMappingURL=brain-reasoning.js.map

package/dist/memory/brain-reasoning.js.map

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

package/dist/memory/brain-retrieval.d.ts

@@ -1,157 +0,0 @@
-/**
- * BRAIN Retrieval Operations — 3-layer pattern (search -> timeline -> fetch).
- *
- * Provides token-efficient memory access modeled after claude-mem's
- * search/timeline/get_observations workflow:
- *
- * 1. searchBrainCompact — lightweight index (IDs + titles, ~50 tokens/hit)
- * 2. timelineBrain      — chronological context around an anchor entry
- * 3. fetchBrainEntries  — full details for a filtered set of IDs
- * 4. observeBrain       — unified save (observations table)
- *
- * Wave 2A provides the core implementations; Wave 2B wires them through
- * the dispatch layer (engine-compat -> domain handler -> MCP gateway).
- *
- * @task T5131 T5132 T5133 T5134 T5135
- * @epic T5149
- */
-import type { BrainAnchor } from './brain-row-types.js';
-import type { BRAIN_OBSERVATION_SOURCE_TYPES, BRAIN_OBSERVATION_TYPES } from '../store/brain-schema.js';
-/** Compact search hit — minimal fields for index-level results. */
-export interface BrainCompactHit {
-    id: string;
-    type: 'decision' | 'pattern' | 'learning' | 'observation';
-    title: string;
-    date: string;
-    relevance?: number;
-}
-/** Parameters for searchBrainCompact. */
-export interface SearchBrainCompactParams {
-    query: string;
-    limit?: number;
-    tables?: Array<'decisions' | 'patterns' | 'learnings' | 'observations'>;
-    dateStart?: string;
-    dateEnd?: string;
-}
-/** Result from searchBrainCompact. */
-export interface SearchBrainCompactResult {
-    results: BrainCompactHit[];
-    total: number;
-    tokensEstimated: number;
-}
-/** Parameters for timelineBrain. */
-export interface TimelineBrainParams {
-    anchor: string;
-    depthBefore?: number;
-    depthAfter?: number;
-}
-/** Timeline entry — compact id/type/date tuple. */
-export interface TimelineNeighbor {
-    id: string;
-    type: string;
-    date: string;
-}
-/** Result from timelineBrain. */
-export interface TimelineBrainResult {
-    anchor: BrainAnchor | null;
-    before: TimelineNeighbor[];
-    after: TimelineNeighbor[];
-}
-/** Parameters for fetchBrainEntries. */
-export interface FetchBrainEntriesParams {
-    ids: string[];
-}
-/** Fetched entry with full data. */
-export interface FetchedBrainEntry {
-    id: string;
-    type: string;
-    data: unknown;
-}
-/** Result from fetchBrainEntries. */
-export interface FetchBrainEntriesResult {
-    results: FetchedBrainEntry[];
-    notFound: string[];
-    tokensEstimated: number;
-}
-/** Observation type from schema. */
-export type BrainObservationType = (typeof BRAIN_OBSERVATION_TYPES)[number];
-/** Observation source type from schema. */
-export type BrainObservationSourceType = (typeof BRAIN_OBSERVATION_SOURCE_TYPES)[number];
-/** Parameters for observeBrain. */
-export interface ObserveBrainParams {
-    text: string;
-    title?: string;
-    type?: BrainObservationType;
-    project?: string;
-    sourceSessionId?: string;
-    sourceType?: BrainObservationSourceType;
-}
-/** Result from observeBrain. */
-export interface ObserveBrainResult {
-    id: string;
-    type: string;
-    createdAt: string;
-}
-/**
- * Token-efficient compact search across BRAIN tables.
- * Returns index-level hits (~50 tokens per result).
- *
- * Delegates to searchBrain() from brain-search.ts for FTS5/LIKE search,
- * then projects results to a compact format with optional date filtering.
- *
- * @param projectRoot - Project root directory
- * @param params - Search parameters
- * @returns Compact search results with token estimate
- */
-export declare function searchBrainCompact(projectRoot: string, params: SearchBrainCompactParams): Promise<SearchBrainCompactResult>;
-/**
- * Get chronological context around an anchor entry.
- * Fetches the anchor's full data, then queries all 4 BRAIN tables
- * via UNION ALL to find chronological neighbors.
- *
- * @param projectRoot - Project root directory
- * @param params - Timeline parameters with anchor ID and depth
- * @returns Anchor entry data with surrounding chronological entries
- */
-export declare function timelineBrain(projectRoot: string, params: TimelineBrainParams): Promise<TimelineBrainResult>;
-/**
- * Batch-fetch full details by IDs.
- * Groups IDs by prefix to query the correct tables via BrainDataAccessor.
- *
- * @param projectRoot - Project root directory
- * @param params - Fetch parameters with IDs
- * @returns Full entry data for each found ID, plus not-found list
- */
-export declare function fetchBrainEntries(projectRoot: string, params: FetchBrainEntriesParams): Promise<FetchBrainEntriesResult>;
-/**
- * Save an observation to the BRAIN observations table.
- * Replaces the external claude-mem save_observation pattern.
- *
- * Auto-classifies type from text if not provided. Generates a
- * unique ID with O- prefix + base36 timestamp.
- *
- * @param projectRoot - Project root directory
- * @param params - Observation data
- * @returns Created observation ID, type, and timestamp
- */
-export declare function observeBrain(projectRoot: string, params: ObserveBrainParams): Promise<ObserveBrainResult>;
-/** Result from populateEmbeddings backfill. */
-export interface PopulateEmbeddingsResult {
-    processed: number;
-    skipped: number;
-}
-/**
- * Backfill embeddings for existing observations that lack them.
- *
- * Iterates through observations not yet in brain_embeddings and
- * generates vectors using the registered embedding provider.
- * Processes in batches to avoid memory pressure.
- *
- * @param projectRoot - Project root directory
- * @param options - Optional batch size configuration
- * @returns Count of processed and skipped observations
- */
-export declare function populateEmbeddings(projectRoot: string, options?: {
-    batchSize?: number;
-}): Promise<PopulateEmbeddingsResult>;
-//# sourceMappingURL=brain-retrieval.d.ts.map

package/dist/memory/brain-retrieval.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brain-retrieval.d.ts","sourceRoot":"","sources":["../../src/memory/brain-retrieval.ts"],"names":[],"mappings":"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"}