@cleocode/core 2026.3.42 → 2026.3.43

package/dist/memory/index.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Research commands and manifest operations.
+ * @task T4465
+ * @epic T4454
+ */
+import type { DataAccessor } from '../store/data-accessor.js';
+/** Research entry attached to a task. */
+export interface ResearchEntry {
+    id: string;
+    taskId: string;
+    topic: string;
+    findings: string[];
+    sources: string[];
+    status: 'pending' | 'complete' | 'partial';
+    createdAt: string;
+    updatedAt: string;
+}
+/** Manifest entry (JSONL line). */
+export interface ManifestEntry {
+    id: string;
+    file: string;
+    title: string;
+    date: string;
+    status: 'completed' | 'partial' | 'blocked';
+    agent_type: string;
+    topics: string[];
+    key_findings: string[];
+    actionable: boolean;
+    needs_followup: string[];
+    linked_tasks: string[];
+}
+/** Options for adding research. */
+export interface AddResearchOptions {
+    taskId: string;
+    topic: string;
+    findings?: string[];
+    sources?: string[];
+}
+/** Options for listing research. */
+export interface ListResearchOptions {
+    taskId?: string;
+    status?: 'pending' | 'complete' | 'partial';
+}
+/** Manifest query options. */
+export interface ManifestQueryOptions {
+    status?: string;
+    agentType?: string;
+    topic?: string;
+    taskId?: string;
+    limit?: number;
+}
+/**
+ * Add a research entry.
+ * @task T4465
+ */
+export declare function addResearch(options: AddResearchOptions, cwd?: string, accessor?: DataAccessor): Promise<ResearchEntry>;
+/**
+ * Show a specific research entry.
+ * @task T4465
+ */
+export declare function showResearch(researchId: string, cwd?: string): Promise<ResearchEntry>;
+/**
+ * List research entries with optional filtering.
+ * @task T4465
+ */
+export declare function listResearch(options?: ListResearchOptions, cwd?: string): Promise<ResearchEntry[]>;
+/**
+ * List pending research entries.
+ * @task T4465
+ */
+export declare function pendingResearch(cwd?: string): Promise<ResearchEntry[]>;
+/**
+ * Link a research entry to a task.
+ * @task T4465
+ */
+export declare function linkResearch(researchId: string, taskId: string, cwd?: string, accessor?: DataAccessor): Promise<{
+    researchId: string;
+    taskId: string;
+}>;
+/**
+ * Update research findings.
+ * @task T4465
+ */
+export declare function updateResearch(researchId: string, updates: {
+    findings?: string[];
+    sources?: string[];
+    status?: 'pending' | 'complete' | 'partial';
+}, cwd?: string): Promise<ResearchEntry>;
+/**
+ * Get research statistics.
+ * @task T4474
+ */
+export declare function statsResearch(cwd?: string): Promise<{
+    total: number;
+    byStatus: Record<string, number>;
+    byTopic: Record<string, number>;
+}>;
+/**
+ * Get research entries linked to a specific task.
+ * @task T4474
+ */
+export declare function linksResearch(taskId: string, cwd?: string): Promise<ResearchEntry[]>;
+/**
+ * Archive old research entries by status.
+ * Moves 'complete' entries older than a threshold to an archive,
+ * or returns summary of archivable entries.
+ * @task T4474
+ */
+export declare function archiveResearch(cwd?: string): Promise<{
+    action: string;
+    entriesArchived: number;
+    entriesRemaining: number;
+}>;
+/**
+ * Read manifest entries from MANIFEST.jsonl.
+ * @task T4465
+ */
+export declare function readManifest(cwd?: string): Promise<ManifestEntry[]>;
+/**
+ * Append a manifest entry.
+ * @task T4465
+ */
+export declare function appendManifest(entry: ManifestEntry, cwd?: string): Promise<void>;
+/**
+ * Query manifest entries.
+ * @task T4465
+ */
+export declare function queryManifest(options?: ManifestQueryOptions, cwd?: string): Promise<ManifestEntry[]>;
+/** Extended manifest entry with optional fields used by the engine. */
+export interface ExtendedManifestEntry extends ManifestEntry {
+    confidence?: number;
+    file_checksum?: string;
+    duration_seconds?: number;
+}
+/** Research filter criteria used by the engine. */
+export interface ResearchFilter {
+    taskId?: string;
+    status?: string;
+    agent_type?: string;
+    topic?: string;
+    limit?: number;
+    offset?: number;
+    actionable?: boolean;
+    dateAfter?: string;
+    dateBefore?: string;
+}
+/**
+ * Read all manifest entries as extended entries.
+ * @task T4787
+ */
+export declare function readExtendedManifest(cwd?: string): Promise<ExtendedManifestEntry[]>;
+/**
+ * Filter manifest entries by criteria.
+ * @task T4787
+ */
+export declare function filterManifestEntries(entries: ExtendedManifestEntry[], filter: ResearchFilter): ExtendedManifestEntry[];
+/**
+ * Show a manifest entry by ID with optional file content.
+ * @task T4787
+ */
+export declare function showManifestEntry(researchId: string, cwd?: string): Promise<ExtendedManifestEntry & {
+    fileContent: string | null;
+    fileExists: boolean;
+}>;
+/**
+ * Search manifest entries by text with relevance scoring.
+ * @task T4787
+ */
+export declare function searchManifest(query: string, options?: {
+    confidence?: number;
+    limit?: number;
+}, cwd?: string): Promise<Array<ExtendedManifestEntry & {
+    relevanceScore: number;
+}>>;
+/**
+ * Get pending manifest entries (partial, blocked, or needing followup).
+ * @task T4787
+ */
+export declare function pendingManifestEntries(epicId?: string, cwd?: string): Promise<{
+    entries: ExtendedManifestEntry[];
+    total: number;
+    byStatus: {
+        partial: number;
+        blocked: number;
+        needsFollowup: number;
+    };
+}>;
+/**
+ * Get manifest-based research statistics.
+ * @task T4787
+ */
+export declare function manifestStats(epicId?: string, cwd?: string): Promise<{
+    total: number;
+    byStatus: Record<string, number>;
+    byType: Record<string, number>;
+    actionable: number;
+    needsFollowup: number;
+    averageFindings: number;
+}>;
+/**
+ * Link a manifest entry to a task (adds taskId to linked_tasks array).
+ * @task T4787
+ */
+export declare function linkManifestEntry(taskId: string, researchId: string, cwd?: string): Promise<{
+    taskId: string;
+    researchId: string;
+    alreadyLinked: boolean;
+}>;
+/**
+ * Append an extended manifest entry.
+ * Validates required fields before appending.
+ * @task T4787
+ */
+export declare function appendExtendedManifest(entry: ExtendedManifestEntry, cwd?: string): Promise<{
+    entryId: string;
+    file: string;
+}>;
+/**
+ * Archive manifest entries older than a date.
+ * @task T4787
+ */
+export declare function archiveManifestEntries(beforeDate: string, cwd?: string): Promise<{
+    archived: number;
+    remaining: number;
+    archiveFile: string;
+}>;
+/** Contradiction detail between two manifest entries. */
+export interface ContradictionDetail {
+    entryA: ExtendedManifestEntry;
+    entryB: ExtendedManifestEntry;
+    topic: string;
+    conflictDetails: string;
+}
+/**
+ * Find manifest entries with overlapping topics but conflicting key_findings.
+ * @task T4787
+ */
+export declare function findContradictions(cwd?: string, params?: {
+    topic?: string;
+}): Promise<ContradictionDetail[]>;
+/** Superseded entry detail. */
+export interface SupersededDetail {
+    old: ExtendedManifestEntry;
+    replacement: ExtendedManifestEntry;
+    topic: string;
+}
+/**
+ * Identify research entries replaced by newer work on same topic.
+ * @task T4787
+ */
+export declare function findSuperseded(cwd?: string, params?: {
+    topic?: string;
+}): Promise<SupersededDetail[]>;
+/**
+ * Read protocol injection content for a given protocol type.
+ * @task T4787
+ */
+export declare function readProtocolInjection(protocolType: string, params?: {
+    taskId?: string;
+    variant?: string;
+}, cwd?: string): Promise<{
+    protocolType: string;
+    content: string;
+    path: string;
+    contentLength: number;
+    estimatedTokens: number;
+    taskId: string | null;
+    variant: string | null;
+}>;
+/**
+ * Compact MANIFEST.jsonl by removing duplicate/stale entries.
+ * @task T4787
+ */
+export declare function compactManifest(cwd?: string): Promise<{
+    compacted: boolean;
+    originalLines: number;
+    malformedRemoved: number;
+    duplicatesRemoved: number;
+    remainingEntries: number;
+}>;
+/**
+ * Validate research entries for a task.
+ * @task T4787
+ */
+export declare function validateManifestEntries(taskId: string, cwd?: string): Promise<{
+    taskId: string;
+    valid: boolean;
+    entriesFound: number;
+    issues: Array<{
+        entryId: string;
+        issue: string;
+        severity: 'error' | 'warning';
+    }>;
+    errorCount: number;
+    warningCount: number;
+}>;
+export * from './brain-lifecycle.js';
+export * from './brain-links.js';
+export * from './brain-migration.js';
+export * from './brain-retrieval.js';
+export * from './brain-search.js';
+export * from './decisions.js';
+export * from './learnings.js';
+export * from './patterns.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

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

package/dist/memory/learnings.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Learning Memory system for CLEO BRAIN.
+ *
+ * Records, queries, and applies accumulated insights from
+ * historical task data (completion rates, blocker patterns, epic sizes).
+ *
+ * Storage: SQLite brain_learnings table per ADR-009 Section 3.2.
+ *
+ * @task T4769, T5241
+ * @epic T4763
+ */
+/** Parameters for storing a new learning. */
+export interface StoreLearningParams {
+    insight: string;
+    source: string;
+    confidence: number;
+    actionable?: boolean;
+    application?: string;
+    applicableTypes?: string[];
+}
+/** Parameters for searching learnings. */
+export interface SearchLearningParams {
+    query?: string;
+    minConfidence?: number;
+    actionableOnly?: boolean;
+    applicableType?: string;
+    limit?: number;
+}
+/**
+ * Store a new learning.
+ * @task T4769, T5241
+ */
+export declare function storeLearning(projectRoot: string, params: StoreLearningParams): Promise<{
+    applicableTypes: any;
+    id: string;
+    createdAt: string;
+    updatedAt: string | null;
+    source: string;
+    confidence: number;
+    insight: string;
+    actionable: boolean;
+    application: string | null;
+    applicableTypesJson: string | null;
+}>;
+/**
+ * Search learnings by criteria.
+ * Results sorted by confidence (highest first).
+ * @task T4769, T5241
+ */
+export declare function searchLearnings(projectRoot: string, params?: SearchLearningParams): Promise<{
+    applicableTypes: any;
+    id: string;
+    createdAt: string;
+    updatedAt: string | null;
+    source: string;
+    confidence: number;
+    insight: string;
+    actionable: boolean;
+    application: string | null;
+    applicableTypesJson: string | null;
+}[]>;
+/**
+ * Get learning statistics.
+ * @task T4769, T5241
+ */
+export declare function learningStats(projectRoot: string): Promise<{
+    total: number;
+    actionable: number;
+    averageConfidence: number;
+    bySource: Record<string, number>;
+    highConfidence: number;
+    lowConfidence: number;
+}>;
+//# sourceMappingURL=learnings.d.ts.map

package/dist/memory/learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/memory/learnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB;;;;;;;;;;;GAyCnF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB;;;;;;;;;;;KAiC3F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM;;;;;;;GA2BtD"}

package/dist/memory/memory-bridge.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Memory Bridge Generator
+ *
+ * Generates .cleo/memory-bridge.md from brain.db content. This file is
+ * @-referenced by CLEO-INJECTION.md so that any provider (Claude Code,
+ * OpenCode, Cursor, etc.) automatically loads project memory context.
+ *
+ * Content assembly:
+ *   - Last session handoff summary
+ *   - High-confidence learnings
+ *   - Active patterns (follow + avoid)
+ *   - Recent decisions
+ *   - Recent observations
+ *
+ * Regeneration triggers:
+ *   - session.end
+ *   - tasks.complete
+ *   - memory.observe (high-confidence observations only)
+ *   - Manual: cleo refresh-memory
+ *
+ * @task T5240
+ * @epic T5149
+ */
+/** Configuration for memory bridge content generation. */
+export interface MemoryBridgeConfig {
+    maxObservations: number;
+    maxLearnings: number;
+    maxPatterns: number;
+    maxDecisions: number;
+    includeHandoff: boolean;
+    includeAntiPatterns: boolean;
+}
+/**
+ * Generate memory bridge content from brain.db.
+ * Returns the markdown string (does not write to disk).
+ */
+export declare function generateMemoryBridgeContent(projectRoot: string, config?: Partial<MemoryBridgeConfig>): Promise<string>;
+/**
+ * Write memory bridge content to .cleo/memory-bridge.md.
+ */
+export declare function writeMemoryBridge(projectRoot: string, config?: Partial<MemoryBridgeConfig>): Promise<{
+    path: string;
+    written: boolean;
+}>;
+/**
+ * Best-effort refresh: call from session.end, tasks.complete, or memory.observe.
+ * Never throws.
+ */
+export declare function refreshMemoryBridge(projectRoot: string): Promise<void>;
+//# sourceMappingURL=memory-bridge.d.ts.map

package/dist/memory/memory-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bridge.d.ts","sourceRoot":"","sources":["../../src/memory/memory-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAmED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC,CA2GjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA8B7C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5E"}

package/dist/memory/patterns.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Pattern Memory system for CLEO BRAIN.
+ *
+ * Extracts, stores, and queries workflow/blocker/success/failure/optimization
+ * patterns from completed tasks and epics.
+ *
+ * Storage: SQLite brain_patterns table per ADR-009 Section 3.2.
+ *
+ * @task T4768, T5241
+ * @epic T4763
+ */
+/** Pattern types from ADR-009. */
+export type PatternType = 'workflow' | 'blocker' | 'success' | 'failure' | 'optimization';
+/** Impact level. */
+export type PatternImpact = 'low' | 'medium' | 'high';
+/** Parameters for storing a new pattern. */
+export interface StorePatternParams {
+    type: PatternType;
+    pattern: string;
+    context: string;
+    impact?: PatternImpact;
+    antiPattern?: string;
+    mitigation?: string;
+    examples?: string[];
+    successRate?: number;
+}
+/** Parameters for searching patterns. */
+export interface SearchPatternParams {
+    type?: PatternType;
+    impact?: PatternImpact;
+    query?: string;
+    minFrequency?: number;
+    limit?: number;
+}
+/**
+ * Store a new pattern.
+ * If a similar pattern already exists (same type + matching text), increments frequency.
+ * @task T4768, T5241
+ */
+export declare function storePattern(projectRoot: string, params: StorePatternParams): Promise<{
+    examples: any;
+    frequency: number;
+    id: string;
+    updatedAt: string | null;
+    type: "success" | "workflow" | "failure" | "blocker" | "optimization";
+    pattern: string;
+    context: string;
+    successRate: number | null;
+    impact: "high" | "medium" | "low" | null;
+    antiPattern: string | null;
+    mitigation: string | null;
+    examplesJson: string | null;
+    extractedAt: string;
+}>;
+/**
+ * Search patterns by criteria.
+ * @task T4768, T5241
+ */
+export declare function searchPatterns(projectRoot: string, params?: SearchPatternParams): Promise<{
+    examples: any;
+    frequency: number;
+    id: string;
+    updatedAt: string | null;
+    type: "success" | "workflow" | "failure" | "blocker" | "optimization";
+    pattern: string;
+    context: string;
+    successRate: number | null;
+    impact: "high" | "medium" | "low" | null;
+    antiPattern: string | null;
+    mitigation: string | null;
+    examplesJson: string | null;
+    extractedAt: string;
+}[]>;
+/**
+ * Get pattern statistics.
+ * @task T4768, T5241
+ */
+export declare function patternStats(projectRoot: string): Promise<{
+    total: number;
+    byType: Record<string, number>;
+    byImpact: Record<string, number>;
+    highestFrequency: {
+        pattern: string;
+        frequency: number;
+    } | null;
+}>;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/memory/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/memory/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAE1F,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB;;;;;;;;;;;;;;GAiDjF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB;;;;;;;;;;;;;;KA0BzF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM;;;;;iBAa5B,MAAM;mBAAa,MAAM;;GAgBlD"}

package/dist/memory/pipeline-manifest-sqlite.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Pipeline Manifest SQLite Implementation
+ *
+ * Reimplements all 14 pipeline manifest operations using Drizzle ORM +
+ * SQLite (tasks.db pipeline_manifest table) instead of JSONL file I/O.
+ *
+ * Provides a one-time migration function to import existing MANIFEST.jsonl
+ * entries into the new table.
+ *
+ * @task T5581
+ * @epic T5576
+ */
+import type { EngineResult } from '../engine-result.js';
+import { type ContradictionDetail, type ExtendedManifestEntry, filterManifestEntries, type ResearchFilter, type SupersededDetail } from './index.js';
+export type ManifestEntry = ExtendedManifestEntry;
+export type { ContradictionDetail, ResearchFilter, SupersededDetail };
+export { filterManifestEntries };
+interface PipelineManifestListParams extends ResearchFilter {
+    type?: string;
+    offset?: number;
+}
+/** pipeline.manifest.show - Get manifest entry details by ID */
+export declare function pipelineManifestShow(researchId: string, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.list - List manifest entries with filters */
+export declare function pipelineManifestList(params: PipelineManifestListParams, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.find - Find manifest entries by text (LIKE search on content + type) */
+export declare function pipelineManifestFind(query: string, options?: {
+    confidence?: number;
+    limit?: number;
+}, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.pending - Get pending manifest items */
+export declare function pipelineManifestPending(epicId?: string, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.stats - Manifest statistics */
+export declare function pipelineManifestStats(epicId?: string, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.read - Read manifest entries with optional filter */
+export declare function pipelineManifestRead(filter?: ResearchFilter, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.append - Append entry to pipeline_manifest table */
+export declare function pipelineManifestAppend(entry: ExtendedManifestEntry, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.archive - Archive old manifest entries by date */
+export declare function pipelineManifestArchive(beforeDate: string, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.compact - Dedup by contentHash (keep newest by createdAt) */
+export declare function pipelineManifestCompact(projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.validate - Validate manifest entries for a task */
+export declare function pipelineManifestValidate(taskId: string, projectRoot?: string): Promise<EngineResult>;
+/** pipeline.manifest.contradictions - Find entries with overlapping topics but conflicting key_findings */
+export declare function pipelineManifestContradictions(projectRoot?: string, params?: {
+    topic?: string;
+}): Promise<EngineResult<{
+    contradictions: ContradictionDetail[];
+}>>;
+/** pipeline.manifest.superseded - Identify entries replaced by newer work on same topic */
+export declare function pipelineManifestSuperseded(projectRoot?: string, params?: {
+    topic?: string;
+}): Promise<EngineResult<{
+    superseded: SupersededDetail[];
+}>>;
+/** pipeline.manifest.link - Link manifest entry to a task */
+export declare function pipelineManifestLink(taskId: string, researchId: string, notes?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * Read all manifest entries from the pipeline_manifest table.
+ * Replaces readManifestEntries() from pipeline-manifest-compat.
+ */
+export declare function readManifestEntries(projectRoot?: string): Promise<ExtendedManifestEntry[]>;
+/**
+ * Filter manifest entries by criteria (alias for backward compatibility).
+ */
+export declare function filterEntries(entries: ExtendedManifestEntry[], filter: ResearchFilter): ExtendedManifestEntry[];
+/**
+ * Distill a manifest entry to brain.db observation (Phase 3, pending).
+ */
+export declare function distillManifestEntry(_entryId: string, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * Migrate existing .cleo/MANIFEST.jsonl entries into the pipeline_manifest table.
+ * Skips entries that already exist (by id). Renames MANIFEST.jsonl to
+ * MANIFEST.jsonl.migrated when done.
+ *
+ * @returns Count of migrated and skipped entries.
+ */
+export declare function migrateManifestJsonlToSqlite(projectRoot?: string): Promise<{
+    migrated: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=pipeline-manifest-sqlite.d.ts.map

package/dist/memory/pipeline-manifest-sqlite.d.ts.map

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