@kybernesis/brain-contracts 0.2.0 → 0.6.0

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export * from './timeline.js';
 export * from './entity.js';
 export * from './fact.js';
 export * from './sleep.js';
+export * from './storage.js';
 export * from './logger.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -4,5 +4,6 @@ export * from './timeline.js';
 export * from './entity.js';
 export * from './fact.js';
 export * from './sleep.js';
+export * from './storage.js';
 export * from './logger.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,593 @@
+/**
+ * Storage provider interfaces — the swappable seam (Stage 1).
+ *
+ * `brain-core` business logic depends ONLY on these interfaces, obtained via
+ * the `setStorageProvider`/`getStorage` seam in brain-core (which mirrors
+ * `setLLMProvider`). Each backend package (brain-storage-sqlite today; a
+ * libsql impl in Stage 3) implements them with its own dialect.
+ *
+ * DESIGN RULES (load-bearing — see docs/specs/storage-provider-di-spec.md):
+ *  - Every method is async. Inserts return `Promise<number>` (the new id), so
+ *    the impl owns `RETURNING` vs `lastInsertRowid` internally.
+ *  - No method ever exposes a driver handle (`better-sqlite3.Database`, a libsql
+ *    client, …). The seam speaks domain operations, never SQL.
+ *  - Returned object fields are snake_case, matching the v0.2.0 realignment and
+ *    guarded by schema-naming.test.ts.
+ *  - The 3 within-kind transactions (mergeEntities, deleteEntity, the vector
+ *    chunk insert) are IMPL-INTERNAL to their methods — no public transaction
+ *    primitive is exposed in Stage 1 (decision ①: keep per-kind best-effort
+ *    semantics; cross-kind unit-of-work is a reserved Stage-3 addition).
+ *  - Param names stay camelCase at the input edge (unchanged public surface);
+ *    only RETURNED fields are snake_case.
+ *
+ * NOTE: as of 0.6.0 (gate U0) the bundle has TWO planes — five CRUD
+ * `*Repository` interfaces under `.repositories` (frozen since 0.5.0) and three
+ * DB-focused domain interfaces under `.domain` (SearchQueries, FactRetrievalQueries,
+ * SleepMaintenance), declared now to freeze the shape and populated per gate
+ * (U1 search, U2 fact-retrieval, U3 sleep). See the BUSINESS PLANE section below
+ * and docs/specs/storage-untangle-0.6.0-kickoff.md.
+ */
+import type { TenantContext } from './tenant.js';
+import type { TimelineEvent, TimelineEventInput } from './timeline.js';
+import type { Entity, EntityMention, Contradiction, EntityInsight } from './entity.js';
+import type { Fact } from './fact.js';
+import type { EntityType, RelationshipType, InsightType, EventType, FactCategory } from './constants.js';
+export interface TimelineQuery {
+    start?: string;
+    end?: string;
+    type?: EventType;
+    search?: string;
+    entities?: string[];
+    topics?: string[];
+    limit?: number;
+    offset?: number;
+}
+export interface TimelineStats {
+    totalEvents: number;
+    byType: Record<EventType, number>;
+    dateRange: {
+        earliest: string | null;
+        latest: string | null;
+    };
+}
+export interface VectorChunkInput {
+    /** Embedding vector; impl marshals to its own binding format. */
+    embedding: number[];
+    ts: string;
+    source?: string;
+    content: string;
+    origin_id?: string;
+}
+export interface VectorSearchRow {
+    ts: string;
+    source: string | null;
+    content: string;
+    origin_id: string | null;
+    distance: number;
+}
+export interface TimelineRepository {
+    ensureSchema(t: TenantContext): Promise<void>;
+    addEvent(t: TenantContext, event: TimelineEventInput): Promise<number>;
+    removeEventByPath(t: TenantContext, sourcePath: string): Promise<boolean>;
+    updateEvent(t: TenantContext, id: number, updates: Partial<Omit<TimelineEventInput, 'source_path'>>): Promise<void>;
+    deleteEventById(t: TenantContext, id: number): Promise<boolean>;
+    getEventById(t: TenantContext, id: number): Promise<TimelineEvent | null>;
+    getEventByPath(t: TenantContext, sourcePath: string): Promise<TimelineEvent | null>;
+    query(t: TenantContext, query: TimelineQuery): Promise<TimelineEvent[]>;
+    findRecentDuplicate(t: TenantContext, title: string, withinHours: number): Promise<{
+        id: number;
+        title: string;
+    } | null>;
+    incrementEventCount(t: TenantContext, eventId: number): Promise<void>;
+    stats(t: TenantContext): Promise<TimelineStats>;
+    /** DISTINCT source_paths whose title/tags/entities LIKE the (lowercased) term. (ops.ts recall) */
+    findSourcePathsMatching(t: TenantContext, termLower: string, limit: number): Promise<string[]>;
+}
+export interface EntityRelatedHit {
+    entity: Entity;
+    relationship: string;
+    strength: number;
+}
+export interface TypedRelationship {
+    entity: Entity;
+    relationship: RelationshipType;
+    direction: 'outgoing' | 'incoming';
+    confidence: number;
+    rationale?: string;
+}
+export interface EntityGraphStats {
+    totalEntities: number;
+    totalMentions: number;
+    totalRelations: number;
+    byType: Record<EntityType, number>;
+}
+export interface EntityRepository {
+    ensureSchema(t: TenantContext): Promise<void>;
+    findOrCreateEntity(t: TenantContext, name: string, type: EntityType, timestamp: string): Promise<Entity>;
+    addEntityAlias(t: TenantContext, entityId: number, alias: string): Promise<void>;
+    addEntityMention(t: TenantContext, entityId: number, conversationId: string, sourcePath: string, context: string, timestamp: string, sourceType?: string, confidence?: number): Promise<void>;
+    linkEntities(t: TenantContext, sourceId: number, targetId: number, relationship?: RelationshipType): Promise<void>;
+    linkEntitiesWithType(t: TenantContext, sourceId: number, targetId: number, options: {
+        relationship: RelationshipType;
+        confidence?: number;
+        rationale?: string;
+        method?: string;
+    }): Promise<void>;
+    getTypedRelationships(t: TenantContext, entityId: number): Promise<TypedRelationship[]>;
+    getEntityContext(t: TenantContext, nameOrId: string | number): Promise<{
+        entity: Entity;
+        mentions: EntityMention[];
+        relatedEntities: EntityRelatedHit[];
+    } | null>;
+    searchEntities(t: TenantContext, query: string, options?: {
+        type?: EntityType;
+        limit?: number;
+    }): Promise<Entity[]>;
+    getRecentEntities(t: TenantContext, limit?: number): Promise<Entity[]>;
+    getMostMentionedEntities(t: TenantContext, options?: {
+        type?: EntityType;
+        limit?: number;
+    }): Promise<Entity[]>;
+    stats(t: TenantContext): Promise<EntityGraphStats>;
+    detectEntitiesInQuery(t: TenantContext, query: string): Promise<{
+        entities: string[];
+        remainingQuery: string;
+    }>;
+    mergeEntities(t: TenantContext, keepId: number, removeId: number, reason: string, confidence?: number, aiRationale?: string, mergedBy?: string): Promise<{
+        mentions_moved: number;
+        relations_moved: number;
+    }>;
+    deleteEntity(t: TenantContext, entityId: number, reason: string, mergedBy?: string): Promise<void>;
+    getEntityProfile(t: TenantContext, entityId: number): Promise<{
+        profile: string;
+        generated_at: string;
+        fact_count: number;
+    } | null>;
+    saveEntityProfile(t: TenantContext, entityId: number, profile: string, factCount: number): Promise<void>;
+    createContradiction(t: TenantContext, entityId: number, factAId: number, factBId: number, factA: string, factB: string, description: string): Promise<number>;
+    getOpenContradictions(t: TenantContext, entityId: number): Promise<Contradiction[]>;
+    resolveContradiction(t: TenantContext, contradictionId: number, resolvedBy: string): Promise<void>;
+    applyContradictions(t: TenantContext, entityId: number, factIds: number[]): Promise<void>;
+    saveEntityInsight(t: TenantContext, entityId: number, insightType: InsightType, insight: string, reasoning: string, confidence: number, sourceEntityIds?: number[], expiresAt?: string): Promise<number>;
+    getEntityInsights(t: TenantContext, entityId: number, minConfidence?: number): Promise<EntityInsight[]>;
+    markInsightsStale(t: TenantContext, entityId: number): Promise<void>;
+    getEntitiesForReasoning(t: TenantContext, limit?: number, staleDays?: number, recencyDays?: number): Promise<Array<{
+        id: number;
+        name: string;
+        type: string;
+    }>>;
+    markEntityReasoned(t: TenantContext, entityId: number): Promise<void>;
+    pinEntity(t: TenantContext, entityId: number, pinned?: boolean): Promise<void>;
+    listPinned(t: TenantContext, type?: EntityType): Promise<Entity[]>;
+    /** Bump access_count + last_accessed for an entity. (ops.ts recall tracking) */
+    trackAccess(t: TenantContext, entityId: number): Promise<void>;
+}
+/** Insert shape for storeFact — server fills id/created_at/is_latest/access_count/is_retracted. */
+export type StoreFactInput = Omit<Fact, 'id' | 'created_at' | 'is_latest' | 'access_count' | 'is_retracted'>;
+export interface FactRepository {
+    ensureFactsTable(t: TenantContext): Promise<void>;
+    storeFact(t: TenantContext, fact: StoreFactInput): Promise<number>;
+    retractFact(t: TenantContext, factId: number, retractedBy?: string): Promise<void>;
+    reinforceFact(t: TenantContext, factId: number): Promise<void>;
+    getFactById(t: TenantContext, factId: number): Promise<Fact | null>;
+    getFactsForEntity(t: TenantContext, entity: string, options?: {
+        latestOnly?: boolean;
+        limit?: number;
+        category?: FactCategory;
+    }): Promise<Fact[]>;
+    markFactSuperseded(t: TenantContext, oldFactId: number, newFactId: number): Promise<void>;
+    factsCount(t: TenantContext): Promise<number>;
+    listFacts(t: TenantContext, options?: {
+        limit?: number;
+        offset?: number;
+        latestOnly?: boolean;
+        category?: FactCategory;
+    }): Promise<Fact[]>;
+    listTemporalFacts(t: TenantContext, options?: {
+        includeExpired?: boolean;
+        limit?: number;
+    }): Promise<Fact[]>;
+    searchFactsFts(t: TenantContext, query: string, limit?: number): Promise<Fact[]>;
+    /**
+     * Active (latest, non-expired) fact CONTENTS for a category. (user-profile.ts)
+     * order 'frecency' = confidence DESC, access_count DESC (fallback confidence-only
+     * if access_count column is absent); 'recent' = timestamp DESC.
+     */
+    getFactContentsByCategory(t: TenantContext, category: string, limit: number, order: 'frecency' | 'recent'): Promise<string[]>;
+}
+export interface MemoryEdgeHit {
+    related_path: string;
+    confidence: number;
+    shared_tags: string;
+}
+/** sleep_runs checkpoint columns (crash-forensics; see where a run died). */
+export interface SleepCheckpointRow {
+    checkpoint_step: string | null;
+    checkpoint_data: string | null;
+}
+/** timeline_events columns the decay step reads (non-archive batch). [U3b] */
+export interface DecayCandidateRow {
+    id: number;
+    title: string | null;
+    source_path: string;
+    timestamp: string;
+    priority: number | null;
+    decay_score: number | null;
+    access_count: number | null;
+    is_pinned: number | null;
+}
+/** timeline_events columns the tag step reads (stale/missing tags). [U3b] */
+export interface TagCandidateRow {
+    id: number;
+    source_path: string;
+    title: string | null;
+    summary: string | null;
+    tags_json: string | null;
+    topics_json: string | null;
+}
+/** memory_edges aggregate for a path: edge count + summed confidence. [U3c] */
+export interface SleepEdgeStats {
+    count: number;
+    total_confidence: number;
+}
+/** A memory_edges reference (id + endpoints) for the link retype pass. [U3c] */
+export interface MemoryEdgeRef {
+    id: number;
+    from_path: string;
+    to_path: string;
+}
+/** Insert payload for a new memory_edge (method/timestamps are impl-filled). [U3c] */
+export interface MemoryEdgeInput {
+    from_path: string;
+    to_path: string;
+    relation: string;
+    confidence: number;
+    shared_tags: string;
+    rationale: string;
+}
+/** timeline_events columns the tier step evaluates. [U3c] */
+export interface TierCandidateRow {
+    id: number;
+    source_path: string;
+    priority: number | null;
+    decay_score: number | null;
+    tier: string | null;
+    last_accessed: string | null;
+    access_count: number | null;
+    is_pinned: number | null;
+}
+/** timeline_events columns the link step reads. [U3c] */
+export interface LinkCandidateRow {
+    id: number;
+    source_path: string;
+    title: string;
+    tier: string | null;
+    tags_json: string | null;
+    topics_json: string | null;
+    entities_json: string | null;
+}
+/** A consolidation group keyed by normalized title (channel-prefix/ellipsis stripped IN SQL). [U3d] */
+export interface ConsolidationGroup {
+    normalized_title: string;
+    cnt: number;
+    ids: string;
+    first_ts: string;
+    last_ts: string;
+}
+/** An entity row for hygiene scanning (phase 1 artifacts, phase 5 profiles). [U3e] */
+export interface HygieneEntityRow {
+    id: number;
+    name: string;
+    type: string;
+    mention_count: number;
+}
+/** A same-normalized-name / different-type group (entity-hygiene phase 2). [U3e] */
+export interface SameNameGroup {
+    normalized_name: string;
+    ids: string;
+    types: string;
+    names: string;
+    mention_counts: string;
+}
+/** An entity row for variant detection (phase 3 — includes normalized_name). [U3e] */
+export interface VariantEntityRow {
+    id: number;
+    name: string;
+    normalized_name: string;
+    type: string;
+    mention_count: number;
+}
+/** Mention contexts + related-entity names for one entity (AI-assessment input). [U3e] */
+export interface HygieneEntityProfile {
+    contexts: string[];
+    related: string[];
+}
+/** A prune candidate (entity-hygiene phase 4 — passed all 5 KAD filters). [U3e] */
+export interface PruneCandidateRow {
+    id: number;
+    name: string;
+    type: string;
+    mention_count: number;
+}
+/** A resummarize queue entry (maintenance_queue task='resummarize'). [U3f] */
+export interface ResummarizeQueueItem {
+    queue_id: number;
+    item_id: string;
+}
+/** timeline_events columns the summarize step reads for one item. [U3f] */
+export interface SummaryEventRow {
+    id: number;
+    source_path: string;
+    title: string | null;
+    tier: string | null;
+    summary: string | null;
+    tags_json: string | null;
+    entities_json: string | null;
+}
+/** An unordered related-edge neighbour for the summarize context block. [U3f] */
+export interface SummaryEdgeRow {
+    related_path: string;
+    shared_tags: string;
+}
+/** An unprocessed conversation to extract facts from (observe step). [U3f] */
+export interface UnprocessedConversationRow {
+    id: number;
+    source_path: string;
+    title: string;
+    summary: string;
+    timestamp: string;
+    entities_json: string | null;
+    topics_json: string | null;
+}
+/** Mention stats for the reasoning induction prompt. [U3f] */
+export interface EntityStatsRow {
+    mention_count: number;
+    first_seen: string;
+    last_seen: string;
+}
+/** A co-occurring entity + relation strength (reasoning induction). [U3f] */
+export interface EntityCooccurrenceRow {
+    name: string;
+    strength: number;
+}
+/**
+ * SleepRepository — CRUD/persistence for the maintenance engine.
+ *
+ * The cohesive sleep store (decision 1): its impl opens whichever DB kinds a
+ * method needs (sleep.db for run-state/edges/queue/transitions, timeline.db for
+ * event reads/writes, entityGraph.db for the observe entity lookup). It carries
+ * NO business thresholds — those live in the brain-core steps (JS) or, where the
+ * heuristic is encoded in SQL, in SleepMaintenance. Cross-kind writes stay
+ * best-effort (separate files; no unit-of-work — decision 2).
+ *
+ * Grows green per sub-gate to match the frozen design in
+ * docs/specs/storage-untangle-0.6.0-progress.md (U3a infra ✓; U3b decay/tag;
+ * U3c tier/link; U3d consolidate; U3e entity-hygiene; U3f summarize/observe).
+ */
+export interface SleepRepository {
+    ensureSchema(t: TenantContext): Promise<void>;
+    /** id of an in-flight run (status='running'), or null. Concurrency guard. */
+    findRunningRun(t: TenantContext): Promise<number | null>;
+    /** INSERT a 'running' sleep_runs row; returns its id. */
+    startRun(t: TenantContext): Promise<number>;
+    completeRun(t: TenantContext, runId: number, metricsJson: string): Promise<void>;
+    failRun(t: TenantContext, runId: number, errorMessage: string): Promise<void>;
+    recordTelemetry(t: TenantContext, runId: number, step: string, eventType: string, count: number, durationMs: number, metadataJson: string): Promise<void>;
+    saveCheckpoint(t: TenantContext, runId: number, step: string, dataJson: string): Promise<void>;
+    getLastCheckpoint(t: TenantContext, runId: number): Promise<SleepCheckpointRow | null>;
+    /** Reap >2h-old 'running' rows to 'failed'; returns rows changed. */
+    recoverStaleRuns(t: TenantContext): Promise<number>;
+    /** memory_edges neighbours of a source path, by confidence DESC. [] if no table. */
+    getRelatedEdges(t: TenantContext, sourcePath: string, limit: number): Promise<MemoryEdgeHit[]>;
+    /** Non-archive events for the decay batch (priority DESC). */
+    fetchDecayCandidates(t: TenantContext, limit: number): Promise<DecayCandidateRow[]>;
+    /** Write a computed decay_score + priority for one event. */
+    updateEventDecay(t: TenantContext, itemId: number, decayScore: number, priority: number): Promise<void>;
+    /** Events with stale/missing tags (enriched before `staleDate`, priority DESC). */
+    fetchTagCandidates(t: TenantContext, staleDate: string, limit: number): Promise<TagCandidateRow[]>;
+    /** Write refreshed tags_json + bump last_enriched for one event. */
+    updateEventTags(t: TenantContext, itemId: number, tagsJson: string): Promise<void>;
+    /** Edge count + summed confidence touching a path (tier relationship score, link cap). */
+    getEdgeStats(t: TenantContext, sourcePath: string): Promise<SleepEdgeStats>;
+    /** Does an edge already connect these two paths (either direction)? */
+    edgeExists(t: TenantContext, pathA: string, pathB: string): Promise<boolean>;
+    insertMemoryEdge(t: TenantContext, edge: MemoryEdgeInput): Promise<void>;
+    /** Edges of a given relation (e.g. 'related') for the retype pass. */
+    listEdgesByRelation(t: TenantContext, relation: string, limit: number): Promise<MemoryEdgeRef[]>;
+    updateEdgeRelation(t: TenantContext, edgeId: number, relation: string): Promise<void>;
+    /** Upsert a 'resummarize' maintenance_queue entry for an event. */
+    enqueueResummarize(t: TenantContext, itemId: number, priority: number): Promise<void>;
+    /** Append a tier_transitions audit row (best-effort; impl swallows errors). */
+    recordTierTransition(t: TenantContext, itemId: number, fromTier: string | null, toTier: string, reason: string): Promise<void>;
+    /** timeline_events batch for tier evaluation. */
+    fetchTierCandidates(t: TenantContext, limit: number): Promise<TierCandidateRow[]>;
+    /** Write a new tier for one event. */
+    updateEventTier(t: TenantContext, itemId: number, tier: string): Promise<void>;
+    /** timeline_events with tags/topics, for link candidate building (priority DESC). */
+    fetchLinkCandidates(t: TenantContext, limit: number): Promise<LinkCandidateRow[]>;
+    /** Pending 'resummarize' queue items (priority DESC). */
+    fetchResummarizeQueue(t: TenantContext, limit: number): Promise<ResummarizeQueueItem[]>;
+    /** Mark a queue item processed. */
+    markQueueProcessed(t: TenantContext, queueId: number): Promise<void>;
+    /** Mark a queue item processed with an error message. */
+    markQueueError(t: TenantContext, queueId: number, error: string): Promise<void>;
+    /** One event's columns for summarization, or null. */
+    getEventForSummary(t: TenantContext, itemId: number): Promise<SummaryEventRow | null>;
+    /** Write a refreshed summary + bump last_enriched. */
+    updateEventSummary(t: TenantContext, itemId: number, summary: string): Promise<void>;
+    /** Up-to-`limit` related neighbours (unordered) for the summarize context block. */
+    getSummaryEdges(t: TenantContext, sourcePath: string, limit: number): Promise<SummaryEdgeRow[]>;
+    /** Exact-name → entity id (observe contradiction recording). null if none. */
+    findEntityIdByName(t: TenantContext, nameLower: string): Promise<number | null>;
+    /** Mention stats for one entity (reasoning induction prompt), or null. */
+    fetchEntityStats(t: TenantContext, entityId: number): Promise<EntityStatsRow | null>;
+}
+export interface VectorRepository {
+    /** Can the vector backend be opened for this tenant? (loads sqlite-vec) */
+    available(t: TenantContext): Promise<boolean>;
+    hasOrigin(t: TenantContext, originId: string): Promise<boolean>;
+    insertChunk(t: TenantContext, chunk: VectorChunkInput): Promise<number>;
+    search(t: TenantContext, embedding: number[], limit: number): Promise<VectorSearchRow[]>;
+    stats(t: TenantContext): Promise<{
+        count: number;
+        available: boolean;
+    }>;
+}
+/** A timeline event row in the minimal shape hybrid-search's channels consume. */
+export interface SearchEventRow {
+    id: number;
+    title: string;
+    summary: string;
+    source_path: string;
+    timestamp: string;
+    type: string;
+}
+/** FTS candidate row carrying the columns post-fetch metadata scoring needs. */
+export interface MetadataCandidateRow {
+    id: number;
+    source_path: string;
+    title: string;
+    summary: string;
+    type: string;
+    timestamp: string;
+    tier: string | null;
+    priority: number | null;
+    tags_json: string | null;
+}
+/** Score-factor columns for one source_path (hybrid-search enrichment pass). */
+export interface SearchEnrichRow {
+    tier: string | null;
+    priority: number | null;
+    tags_json: string | null;
+    entities_json: string | null;
+}
+/**
+ * Hybrid-search candidate/factor SQL (read-only). The SCORING stays in
+ * brain-core (RRF fusion, metadata weights, tier boosts, segment dedup) — these
+ * methods only fetch candidates and the columns scoring needs. SQL relocated
+ * verbatim from brain-core/hybrid-search.ts at gate U1; behaviour held constant.
+ */
+export interface SearchQueries {
+    /** Temporal channel: events whose title/summary LIKE `%term%` (case-insensitive), newest first. */
+    temporalCandidates(t: TenantContext, term: string, limit: number): Promise<SearchEventRow[]>;
+    /** Keyword channel: FTS5 MATCH candidates (sanitizes the query internally; [] if it sanitizes empty). */
+    metadataCandidates(t: TenantContext, query: string, limit: number): Promise<MetadataCandidateRow[]>;
+    /** Entity channel (expandQuery): events mentioned by entities named in the query. Cross-kind (entity+timeline). */
+    entityAugmentedCandidates(t: TenantContext, query: string): Promise<SearchEventRow[]>;
+    /** Enrichment: score-factor columns for a source_path, or null if absent. */
+    enrichByPath(t: TenantContext, sourcePath: string): Promise<SearchEnrichRow | null>;
+}
+/**
+ * A fact row in the shape fact-retrieval's scoring consumes. `source_conversation_id`
+ * is absent on bridge candidates (that query doesn't select it).
+ */
+export interface RetrievalFactRow {
+    id: number;
+    content: string;
+    category: string;
+    confidence: number;
+    timestamp: string;
+    entities_json: string;
+    source_conversation_id?: string | null;
+}
+/** One supporting-context segment (Layer 3). */
+export interface SupportingSegmentRow {
+    source_path: string;
+    summary: string;
+    timestamp: string;
+}
+/**
+ * 4-layer fact-retrieval candidate SQL (read-only). The SCORING stays in
+ * brain-core: hop-distance penalty LUT {0:1.0,1:0.7,2:0.5,3:0.3}, scene ×0.6,
+ * bridge `1.05 + min(setsConnected-2,5)*0.03`, source-priority tie-break, the
+ * word-overlap dedup and token-budget assembly. These methods only fetch
+ * candidates and the columns scoring needs. SQL relocated verbatim from
+ * brain-core/fact-retrieval.ts at gate U2; behaviour held constant.
+ *
+ * `traverseEntityGraph` INVERTS the old handle-passing (it used to take a raw
+ * `Database`): the BFS over entity_relations runs inside the impl and returns
+ * `{id, hopDistance}` so the penalty LUT applies in brain-core.
+ */
+export interface FactRetrievalQueries {
+    /** Layer 1: facts FTS5 MATCH (caller passes the already-sanitized query), latest+unexpired only. */
+    searchFactsByFts(t: TenantContext, ftsQuery: string, limit: number): Promise<RetrievalFactRow[]>;
+    /** Layer 2: BFS over entity_relations from the seeds; returns each reached entity id + its hop distance. */
+    traverseEntityGraph(t: TenantContext, seedIds: number[], maxHops: number, maxEntities: number): Promise<Array<{
+        id: number;
+        hopDistance: number;
+    }>>;
+    /** The source_conversation_id of a fact, or null. */
+    getFactConversationId(t: TenantContext, factId: number): Promise<string | null>;
+    /** Layer 2.5 scene: latest+unexpired facts in the same conversation, nearest by id, excluding `excludeFactId`. */
+    nearbyFactsInConversation(t: TenantContext, conversationId: string, excludeFactId: number, limit: number): Promise<RetrievalFactRow[]>;
+    /** Layer 2.5 bridge: latest+unexpired fact candidates to test for cross-cluster entity overlap. */
+    listBridgeCandidates(t: TenantContext, limit: number): Promise<RetrievalFactRow[]>;
+    /** Layer 3: timeline segments under a conversation's source_path prefix, oldest first. */
+    findSupportingSegments(t: TenantContext, parentPath: string, limit: number): Promise<SupportingSegmentRow[]>;
+}
+/**
+ * SleepMaintenance — the maintenance-engine policy that is encoded IN the SQL.
+ *
+ * Deliberately SMALL: most sleep "policy" (tier OR-thresholds, decay formula,
+ * Jaccard + confidence boosts, artifact/variant detection) is JS and stays in the
+ * brain-core steps. Only where the heuristic lives inside the statement itself — a
+ * normalization GROUP BY, a multi-clause prune WHERE, a policy-bearing UPDATE, an
+ * unprocessed-detection NOT EXISTS — does it relocate here VERBATIM (decision 3:
+ * keep SQL, assert parity, don't rewrite as JS).
+ *
+ * Cross-kind atomicity: tier/summarize write timeline.db AND sleep.db (separate
+ * files); best-effort is PRESERVED (decision 2 — no unit-of-work). Empty until
+ * U3b; grows green per sub-gate to the frozen design in
+ * docs/specs/storage-untangle-0.6.0-progress.md.
+ */
+export interface SleepMaintenance {
+    /** Mark expired temporal facts is_latest=0; returns rows changed. */
+    expireTemporalFacts(t: TenantContext): Promise<number>;
+    /** MAX(updated_at) over decayed facts — the weekly-decay gate. null if never. */
+    lastFactConfidenceDecayAt(t: TenantContext): Promise<string | null>;
+    /** Weekly confidence decay (×0.95 floor 0.15) for old ai-extraction/chat facts; rows changed. */
+    decayFactConfidence(t: TenantContext): Promise<number>;
+    /** Groups of duplicate normalized titles (≥ threshold), highest-count first. */
+    fetchConsolidationGroups(t: TenantContext, threshold: number, limit: number): Promise<ConsolidationGroup[]>;
+    /** Sum access_count over a set of event ids (pre-merge tally). */
+    sumAccessCounts(t: TenantContext, ids: number[]): Promise<number>;
+    /** Fold removeIds into keepId: add `addedAccess` to keep's access_count, delete the rest. */
+    consolidateInto(t: TenantContext, keepId: number, removeIds: number[], addedAccess: number): Promise<void>;
+    /** Phase 0: delete orphaned entity_relations + entity_mentions. */
+    cleanOrphans(t: TenantContext): Promise<void>;
+    /** Phase 1: every entity (artifact-pattern scan happens in JS). */
+    fetchAllEntities(t: TenantContext): Promise<HygieneEntityRow[]>;
+    /** Phase 2: GROUP BY normalized_name HAVING COUNT(DISTINCT type) > 1. */
+    fetchSameNameGroups(t: TenantContext): Promise<SameNameGroup[]>;
+    /** Phase 3: top entities by mention_count for JS variant detection. */
+    fetchVariantEntities(t: TenantContext, limit: number): Promise<VariantEntityRow[]>;
+    /** Mention contexts + related names for AI-assessment of one entity. */
+    fetchEntityProfile(t: TenantContext, entityId: number): Promise<HygieneEntityProfile>;
+    /** Phase 4: the 5-clause prune filter (Bug B11B — all filters, verbatim). */
+    fetchPruneCandidates(t: TenantContext, pruneDate: string): Promise<PruneCandidateRow[]>;
+    /** Phase 5: high-mention entities (>=3) for narrative-profile generation. */
+    fetchProfileCandidates(t: TenantContext, limit: number): Promise<Pick<HygieneEntityRow, 'id' | 'name' | 'type'>[]>;
+    /** Event ids whose summary is missing/short/raw/over-long and not enriched in 3 days. */
+    fetchStaleSummaryIds(t: TenantContext, limit: number): Promise<number[]>;
+    /** Conversations with no observation/fact/realtime children yet (NOT EXISTS detection). */
+    fetchUnprocessedConversations(t: TenantContext, limit: number): Promise<UnprocessedConversationRow[]>;
+    /** Co-occurring entities (strength > 1) for the reasoning induction prompt. */
+    fetchEntityCooccurrence(t: TenantContext, entityId: number, limit: number): Promise<EntityCooccurrenceRow[]>;
+}
+export interface StorageProvider {
+    /** Data plane — CRUD persistence primitives, one per DB kind. */
+    repositories: {
+        timeline: TimelineRepository;
+        entities: EntityRepository;
+        facts: FactRepository;
+        sleep: SleepRepository;
+        vectors: VectorRepository;
+    };
+    /** Business plane — DB-focused domain queries, organized by capability. */
+    domain: {
+        search: SearchQueries;
+        factRetrieval: FactRetrievalQueries;
+        sleep: SleepMaintenance;
+    };
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,31 @@
+/**
+ * Storage provider interfaces — the swappable seam (Stage 1).
+ *
+ * `brain-core` business logic depends ONLY on these interfaces, obtained via
+ * the `setStorageProvider`/`getStorage` seam in brain-core (which mirrors
+ * `setLLMProvider`). Each backend package (brain-storage-sqlite today; a
+ * libsql impl in Stage 3) implements them with its own dialect.
+ *
+ * DESIGN RULES (load-bearing — see docs/specs/storage-provider-di-spec.md):
+ *  - Every method is async. Inserts return `Promise<number>` (the new id), so
+ *    the impl owns `RETURNING` vs `lastInsertRowid` internally.
+ *  - No method ever exposes a driver handle (`better-sqlite3.Database`, a libsql
+ *    client, …). The seam speaks domain operations, never SQL.
+ *  - Returned object fields are snake_case, matching the v0.2.0 realignment and
+ *    guarded by schema-naming.test.ts.
+ *  - The 3 within-kind transactions (mergeEntities, deleteEntity, the vector
+ *    chunk insert) are IMPL-INTERNAL to their methods — no public transaction
+ *    primitive is exposed in Stage 1 (decision ①: keep per-kind best-effort
+ *    semantics; cross-kind unit-of-work is a reserved Stage-3 addition).
+ *  - Param names stay camelCase at the input edge (unchanged public surface);
+ *    only RETURNED fields are snake_case.
+ *
+ * NOTE: as of 0.6.0 (gate U0) the bundle has TWO planes — five CRUD
+ * `*Repository` interfaces under `.repositories` (frozen since 0.5.0) and three
+ * DB-focused domain interfaces under `.domain` (SearchQueries, FactRetrievalQueries,
+ * SleepMaintenance), declared now to freeze the shape and populated per gate
+ * (U1 search, U2 fact-retrieval, U3 sleep). See the BUSINESS PLANE section below
+ * and docs/specs/storage-untangle-0.6.0-kickoff.md.
+ */
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/brain-contracts",
-  "version": "0.2.0",
+  "version": "0.6.0",
   "description": "Zod schemas, provider interfaces, and shared types for the Kybernesis brain library",
   "license": "MIT",
   "author": "David Cruwys (AppyDave)",