@cleocode/core 2026.4.30 → 2026.4.35

package/dist/store/brain-schema.d.ts

@@ -8,6 +8,51 @@
  * @epic T5149
  * @task T5127
  */
+/**
+ * Memory retention tiers for the tiered cognitive memory model (T549).
+ *
+ * - `short`  — Session-scoped working context. Volatile; auto-evicted after 48h if not promoted.
+ * - `medium` — Project-scoped verified facts. Retained for weeks; decays if unverified.
+ * - `long`   — Architectural bedrock. Permanent; supersession-only eviction.
+ *
+ * NULL semantics for legacy rows: treat NULL as 'medium' at query time.
+ * (Legacy rows survived the T523 purge, so medium is a safe tier assumption.)
+ */
+export declare const BRAIN_MEMORY_TIERS: readonly ["short", "medium", "long"];
+/** Discriminated union of all memory retention tiers. */
+export type BrainMemoryTier = (typeof BRAIN_MEMORY_TIERS)[number];
+/**
+ * Cognitive type taxonomy for the tiered memory model (T549).
+ *
+ * Uses `BRAIN_COGNITIVE_TYPES` (not `BRAIN_MEMORY_TYPES`) to avoid collision
+ * with the link table enum `BRAIN_MEMORY_TYPES` (which stores entity type names).
+ *
+ * - `semantic`   — Declarative facts: "what is true about this project"
+ *                  → brain_decisions (always), brain_learnings (default)
+ * - `episodic`   — Event records: "what happened and when"
+ *                  → brain_observations (always), brain_learnings (transcript-derived)
+ * - `procedural` — Process knowledge: "how to do things"
+ *                  → brain_patterns (always)
+ */
+export declare const BRAIN_COGNITIVE_TYPES: readonly ["semantic", "episodic", "procedural"];
+/** Discriminated union of all cognitive memory types. */
+export type BrainCognitiveType = (typeof BRAIN_COGNITIVE_TYPES)[number];
+/**
+ * Source reliability levels for the tiered memory model (T549).
+ *
+ * Separate dimension from content `quality_score` — captures source trustworthiness.
+ * Each level drives a quality multiplier applied at scoring time.
+ *
+ * | Level         | Meaning                                 | Quality multiplier |
+ * |---------------|-----------------------------------------|--------------------|
+ * | `owner`       | Owner explicitly stated this fact       | 1.0                |
+ * | `task-outcome`| Verified by completed task with result  | 0.90               |
+ * | `agent`       | Agent-inferred during work (default)    | 0.70               |
+ * | `speculative` | Agent hypothesis, not yet corroborated  | 0.40               |
+ */
+export declare const BRAIN_SOURCE_CONFIDENCE: readonly ["owner", "task-outcome", "agent", "speculative"];
+/** Discriminated union of all source confidence levels. */
+export type BrainSourceConfidence = (typeof BRAIN_SOURCE_CONFIDENCE)[number];
 /** Decision types from ADR-009. */
 export declare const BRAIN_DECISION_TYPES: readonly ["architecture", "technical", "process", "strategic", "tactical"];
 /** Confidence levels for decisions. */
@@ -104,7 +149,7 @@ export declare const brainDecisions: import("drizzle-orm/sqlite-core").SQLiteTab
             name: string;
             tableName: "brain_decisions";
             dataType: "string enum";
-            data: "low" | "medium" | "high";
+            data: "medium" | "low" | "high";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -196,6 +241,22 @@ export declare const brainDecisions: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
+        qualityScore: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
         createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_decisions";
@@ -228,6 +289,118 @@ export declare const brainDecisions: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
+        memoryTier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "string enum";
+            data: "short" | "medium" | "long";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["short", "medium", "long"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        memoryType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "string enum";
+            data: "semantic" | "episodic" | "procedural";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["semantic", "episodic", "procedural"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        verified: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        validAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        invalidAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        sourceConfidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "string enum";
+            data: "owner" | "task-outcome" | "agent" | "speculative";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["owner", "task-outcome", "agent", "speculative"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        citationCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_decisions";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -335,7 +508,7 @@ export declare const brainPatterns: import("drizzle-orm/sqlite-core").SQLiteTabl
             name: string;
             tableName: "brain_patterns";
             dataType: "string enum";
-            data: "low" | "medium" | "high";
+            data: "medium" | "low" | "high";
             driverParam: string;
             notNull: false;
             hasDefault: false;
@@ -427,6 +600,134 @@ export declare const brainPatterns: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}>;
+        qualityScore: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        memoryTier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "string enum";
+            data: "short" | "medium" | "long";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["short", "medium", "long"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        memoryType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "string enum";
+            data: "semantic" | "episodic" | "procedural";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["semantic", "episodic", "procedural"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        verified: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        validAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        invalidAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        sourceConfidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "string enum";
+            data: "owner" | "task-outcome" | "agent" | "speculative";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["owner", "task-outcome", "agent", "speculative"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        citationCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_patterns";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -461,44 +762,172 @@ export declare const brainLearnings: import("drizzle-orm/sqlite-core").SQLiteTab
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        source: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        confidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        actionable: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        application: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        applicableTypesJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        qualityScore: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_learnings";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}>;
-        source: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        memoryTier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
-            dataType: "string";
-            data: string;
+            dataType: "string enum";
+            data: "short" | "medium" | "long";
             driverParam: string;
-            notNull: true;
-            hasDefault: false;
+            notNull: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: ["short", "medium", "long"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}>;
-        confidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        memoryType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
-            dataType: "number double";
-            data: number;
-            driverParam: number;
-            notNull: true;
-            hasDefault: false;
+            dataType: "string enum";
+            data: "semantic" | "episodic" | "procedural";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: undefined;
+            enumValues: ["semantic", "episodic", "procedural"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}>;
-        actionable: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        verified: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
             dataType: "boolean";
@@ -514,14 +943,14 @@ export declare const brainLearnings: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
-        application: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        validAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
             dataType: "string";
             data: string;
             driverParam: string;
-            notNull: false;
-            hasDefault: false;
+            notNull: true;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -530,7 +959,7 @@ export declare const brainLearnings: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
-        applicableTypesJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        invalidAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
             dataType: "string";
@@ -546,34 +975,34 @@ export declare const brainLearnings: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
-        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        sourceConfidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
-            dataType: "string";
-            data: string;
+            dataType: "string enum";
+            data: "owner" | "task-outcome" | "agent" | "speculative";
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: ["owner", "task-outcome", "agent", "speculative"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}>;
-        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        citationCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_learnings";
-            dataType: "string";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
@@ -826,6 +1255,22 @@ export declare const brainObservations: import("drizzle-orm/sqlite-core").SQLite
             identity: undefined;
             generated: undefined;
         }, {}>;
+        qualityScore: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
         createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_observations";
@@ -858,6 +1303,118 @@ export declare const brainObservations: import("drizzle-orm/sqlite-core").SQLite
             identity: undefined;
             generated: undefined;
         }, {}>;
+        memoryTier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "string enum";
+            data: "short" | "medium" | "long";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["short", "medium", "long"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        memoryType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "string enum";
+            data: "semantic" | "episodic" | "procedural";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["semantic", "episodic", "procedural"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        verified: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "boolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        validAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        invalidAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        sourceConfidence: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "string enum";
+            data: "owner" | "task-outcome" | "agent" | "speculative";
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["owner", "task-outcome", "agent", "speculative"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        citationCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_observations";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -998,7 +1555,7 @@ export declare const brainStickyNotes: import("drizzle-orm/sqlite-core").SQLiteT
             name: string;
             tableName: "brain_sticky_notes";
             dataType: "string enum";
-            data: "low" | "medium" | "high";
+            data: "medium" | "low" | "high";
             driverParam: string;
             notNull: false;
             hasDefault: false;
@@ -1156,11 +1713,35 @@ export declare const brainSchemaMeta: import("drizzle-orm/sqlite-core").SQLiteTa
     };
     dialect: "sqlite";
 }>;
-/** Node types for PageIndex graph. */
-export declare const BRAIN_NODE_TYPES: readonly ["task", "doc", "file", "concept"];
-/** Edge types for PageIndex graph. */
-export declare const BRAIN_EDGE_TYPES: readonly ["depends_on", "relates_to", "implements", "documents"];
-/** Documents/concepts as graph nodes for cross-document linking. */
+/**
+ * Node types for the graph-native memory model.
+ * Mirrors typed tables (decision, pattern, learning, observation, sticky),
+ * adds task provenance (task, session, epic), codebase bridging (file, symbol),
+ * and abstract/synthesized types (concept, summary).
+ */
+export declare const BRAIN_NODE_TYPES: readonly ["decision", "pattern", "learning", "observation", "sticky", "task", "session", "epic", "file", "symbol", "concept", "summary"];
+/** Discriminated union of all supported brain graph node types. */
+export type BrainNodeType = (typeof BRAIN_NODE_TYPES)[number];
+/**
+ * Edge types for the graph-native memory model.
+ * Covers provenance/derivation, semantic relationships, structural links,
+ * and graph bridging between memory entities and codebase nodes.
+ */
+export declare const BRAIN_EDGE_TYPES: readonly ["derived_from", "produced_by", "informed_by", "supports", "contradicts", "supersedes", "applies_to", "documents", "summarizes", "part_of", "references", "modified_by"];
+/** Discriminated union of all supported brain graph edge types. */
+export type BrainEdgeType = (typeof BRAIN_EDGE_TYPES)[number];
+/**
+ * Graph nodes table — the traversable knowledge graph layer.
+ *
+ * Every entity row in a typed table (decisions, patterns, learnings,
+ * observations) gets a corresponding node here. The typed table row is
+ * the source of truth; the graph node is the index entry for traversal
+ * and cross-entity reasoning.
+ *
+ * Node ID convention: '<type>:<source-id>'
+ * Examples: 'decision:D-abc123', 'observation:O-mntphoj6-0',
+ *           'task:T523', 'symbol:src/store/brain-schema.ts::brainPageNodes'
+ */
 export declare const brainPageNodes: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "brain_page_nodes";
     schema: undefined;
@@ -1185,14 +1766,14 @@ export declare const brainPageNodes: import("drizzle-orm/sqlite-core").SQLiteTab
             name: string;
             tableName: "brain_page_nodes";
             dataType: "string enum";
-            data: "file" | "task" | "doc" | "concept";
+            data: "symbol" | "file" | "decision" | "pattern" | "learning" | "observation" | "sticky" | "task" | "session" | "epic" | "concept" | "summary";
             driverParam: string;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["task", "doc", "file", "concept"];
+            enumValues: ["decision", "pattern", "learning", "observation", "sticky", "task", "session", "epic", "file", "symbol", "concept", "summary"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
@@ -1213,6 +1794,54 @@ export declare const brainPageNodes: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
+        qualityScore: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_page_nodes";
+            dataType: "number double";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        contentHash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_page_nodes";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        lastActivityAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_page_nodes";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
         metadataJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_page_nodes";
@@ -1245,10 +1874,32 @@ export declare const brainPageNodes: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_page_nodes";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
-/** Directed links between graph nodes. */
+/**
+ * Graph edges table — directed, typed, weighted, provenance-aware links
+ * between brain_page_nodes entries (or external nexus node IDs).
+ *
+ * The composite primary key (fromId, toId, edgeType) prevents duplicate
+ * edges of the same type between the same pair of nodes.
+ */
 export declare const brainPageEdges: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "brain_page_edges";
     schema: undefined;
@@ -1289,14 +1940,14 @@ export declare const brainPageEdges: import("drizzle-orm/sqlite-core").SQLiteTab
             name: string;
             tableName: "brain_page_edges";
             dataType: "string enum";
-            data: "depends_on" | "relates_to" | "implements" | "documents";
+            data: "produced_by" | "applies_to" | "informed_by" | "contradicts" | "derived_from" | "supports" | "supersedes" | "documents" | "summarizes" | "part_of" | "references" | "modified_by";
             driverParam: string;
             notNull: true;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["depends_on", "relates_to", "implements", "documents"];
+            enumValues: ["derived_from", "produced_by", "informed_by", "supports", "contradicts", "supersedes", "applies_to", "documents", "summarizes", "part_of", "references", "modified_by"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
@@ -1307,7 +1958,7 @@ export declare const brainPageEdges: import("drizzle-orm/sqlite-core").SQLiteTab
             dataType: "number double";
             data: number;
             driverParam: number;
-            notNull: false;
+            notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -1317,6 +1968,22 @@ export declare const brainPageEdges: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}>;
+        provenance: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "brain_page_edges";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
         createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: string;
             tableName: "brain_page_edges";