@cleocode/core 2026.4.30 → 2026.4.31

package/dist/memory/graph-queries.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Brain graph traversal queries using recursive CTEs and native SQLite.
+ *
+ * Implements BFS traversal, typed neighbor lookup, 360-degree context view,
+ * and aggregate statistics for the brain_page_nodes / brain_page_edges graph
+ * populated by T528 + T530.
+ *
+ * Uses getBrainNativeDb() (DatabaseSync) for recursive CTEs that Drizzle's
+ * ORM layer cannot express directly.
+ *
+ * @task T535
+ * @epic T523
+ */
+import type { BrainEdgeType, BrainPageEdgeRow, BrainPageNodeRow } from '../store/brain-schema.js';
+/** A node returned from a BFS traversal, annotated with its discovery depth. */
+export interface TraceNode extends BrainPageNodeRow {
+    /** Distance from the seed node (0 = seed itself). */
+    depth: number;
+}
+/** A neighbor node with the edge that connects it to the queried node. */
+export interface RelatedNode {
+    /** The neighbour node. */
+    node: BrainPageNodeRow;
+    /** Edge relationship type. */
+    edgeType: BrainEdgeType;
+    /** Direction: 'out' (queried node is from_id) or 'in' (queried node is to_id). */
+    direction: 'out' | 'in';
+    /** Edge weight/confidence 0.0–1.0. */
+    weight: number;
+}
+/** Full context for a single node: itself, incoming edges, outgoing edges, and neighbour nodes. */
+export interface NodeContext {
+    /** The node itself. */
+    node: BrainPageNodeRow;
+    /** Edges where this node is the target (in-edges). */
+    inEdges: BrainPageEdgeRow[];
+    /** Edges where this node is the source (out-edges). */
+    outEdges: BrainPageEdgeRow[];
+    /** All neighbour nodes reachable via in- or out-edges, deduplicated. */
+    neighbors: RelatedNode[];
+}
+/** Aggregate statistics for the graph. */
+export interface GraphStats {
+    /** Node counts grouped by node_type. */
+    nodesByType: Array<{
+        nodeType: string;
+        count: number;
+    }>;
+    /** Edge counts grouped by edge_type. */
+    edgesByType: Array<{
+        edgeType: string;
+        count: number;
+    }>;
+    /** Total node count. */
+    totalNodes: number;
+    /** Total edge count. */
+    totalEdges: number;
+}
+/**
+ * Traverse the brain knowledge graph using BFS from a seed node.
+ *
+ * Uses a recursive CTE that follows edges in both directions. Nodes are
+ * returned in ascending depth order, then descending quality_score. The seed
+ * node itself is returned at depth 0.
+ *
+ * @param projectRoot - Absolute path to the project root (locates brain.db)
+ * @param nodeId      - Starting node ID (format: '<type>:<source-id>')
+ * @param maxDepth    - Maximum traversal depth (default 3)
+ * @returns Array of nodes annotated with their discovery depth
+ *
+ * @example
+ * ```typescript
+ * const nodes = await traceBrainGraph('/project', 'decision:D-abc123', 2);
+ * for (const n of nodes) console.log(n.depth, n.id, n.label);
+ * ```
+ */
+export declare function traceBrainGraph(projectRoot: string, nodeId: string, maxDepth?: number): Promise<TraceNode[]>;
+/**
+ * Return the immediate (1-hop) neighbours of a node, including edge metadata.
+ *
+ * Follows edges in both directions. Results are sorted by edge weight
+ * descending, then quality_score descending.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param nodeId      - Node to inspect (format: '<type>:<source-id>')
+ * @param edgeType    - Optional edge type filter (e.g. 'applies_to')
+ * @returns Array of neighbour nodes with edge relationship info
+ *
+ * @example
+ * ```typescript
+ * const related = await relatedBrainNodes('/project', 'decision:D-abc123', 'applies_to');
+ * ```
+ */
+export declare function relatedBrainNodes(projectRoot: string, nodeId: string, edgeType?: string): Promise<RelatedNode[]>;
+/**
+ * Return a 360-degree view of a single graph node.
+ *
+ * Provides the node itself, all incoming edges, all outgoing edges, and the
+ * full set of neighbour nodes with their edge relationships.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param nodeId      - Node to inspect (format: '<type>:<source-id>')
+ * @returns Full context record, or null if the node does not exist
+ *
+ * @example
+ * ```typescript
+ * const ctx = await contextBrainNode('/project', 'decision:D-abc123');
+ * if (ctx) {
+ *   console.log(ctx.node.label, ctx.outEdges.length, 'outgoing edges');
+ * }
+ * ```
+ */
+export declare function contextBrainNode(projectRoot: string, nodeId: string): Promise<NodeContext | null>;
+/**
+ * Return aggregate counts for brain_page_nodes and brain_page_edges by type.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @returns Counts by node type and edge type, plus totals
+ *
+ * @example
+ * ```typescript
+ * const stats = await graphStats('/project');
+ * console.log(stats.totalNodes, stats.totalEdges);
+ * ```
+ */
+export declare function graphStats(projectRoot: string): Promise<GraphStats>;
+//# sourceMappingURL=graph-queries.d.ts.map

package/dist/memory/graph-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-queries.d.ts","sourceRoot":"","sources":["../../src/memory/graph-queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAOlG,gFAAgF;AAChF,MAAM,WAAW,SAAU,SAAQ,gBAAgB;IACjD,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,IAAI,EAAE,gBAAgB,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,kFAAkF;IAClF,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mGAAmG;AACnG,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,wEAAwE;IACxE,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,wCAAwC;IACxC,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AA0DD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,OAAO,CAAC,SAAS,EAAE,CAAC,CAgDtB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CA+CxB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqF7B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BzE"}

package/dist/memory/learnings.d.ts

@@ -34,6 +34,7 @@ export declare function storeLearning(projectRoot: string, params: StoreLearning
     applicableTypes: any;
     id: string;
     confidence: number;
+    qualityScore: number | null;
     createdAt: string;
     updatedAt: string | null;
     insight: string;
@@ -51,6 +52,7 @@ export declare function searchLearnings(projectRoot: string, params?: SearchLear
     applicableTypes: any;
     id: string;
     confidence: number;
+    qualityScore: number | null;
     createdAt: string;
     updatedAt: string | null;
     insight: string;

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

@@ -1 +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"}
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/memory/learnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,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;;;;;;;;;;;;GAuFnF;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/patterns.d.ts

@@ -43,6 +43,7 @@ export declare function storePattern(projectRoot: string, params: StorePatternPa
     type: "success" | "failure" | "workflow" | "blocker" | "optimization";
     pattern: string;
     id: string;
+    qualityScore: number | null;
     updatedAt: string | null;
     context: string;
     successRate: number | null;
@@ -62,6 +63,7 @@ export declare function searchPatterns(projectRoot: string, params?: SearchPatte
     type: "success" | "failure" | "workflow" | "blocker" | "optimization";
     pattern: string;
     id: string;
+    qualityScore: number | null;
     updatedAt: string | null;
     context: string;
     successRate: number | null;

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

@@ -1 +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"}
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/memory/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,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;;;;;;;;;;;;;;;GAoGjF;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/quality-scoring.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Quality scoring for CLEO BRAIN memory entries.
+ *
+ * Computes a 0.0–1.0 quality score at insert time for each typed brain table entry.
+ * Entries with a score below the minimum threshold are excluded from search results.
+ *
+ * Score formula per CA1 spec Section 3: source reliability * content richness * recency signals.
+ * Each helper clamps the result to [0.0, 1.0].
+ *
+ * Exported for use in backfill (T530) and future scoring hooks.
+ *
+ * @task T531
+ * @epic T523
+ */
+/** Minimum quality score for inclusion in search results. */
+export declare const QUALITY_SCORE_THRESHOLD = 0.3;
+/** Input shape for pattern quality computation — mirrors StorePatternParams. */
+export interface PatternQualityInput {
+    type: string;
+    pattern: string;
+    context?: string | null;
+    examples_json?: string | null;
+}
+/**
+ * Compute quality score for a brain_patterns row.
+ *
+ * Base: 0.4 (auto-generated patterns start lower).
+ * Bonuses:
+ *   +0.10 for 'workflow' type (structured operational knowledge)
+ *   +0.05 for 'success' type (validated positive pattern)
+ *   +0.10 if pattern text exceeds 100 chars (richer description)
+ *   +0.10 if context exceeds 50 chars (contextual detail present)
+ *   +0.10 if examples_json contains more than 3 items (empirically validated)
+ *
+ * Result clamped to [0.0, 1.0].
+ */
+export declare function computePatternQuality(params: PatternQualityInput): number;
+/** Input shape for learning quality computation — mirrors StoreLearningParams. */
+export interface LearningQualityInput {
+    confidence: number;
+    actionable?: boolean | null;
+    insight: string;
+    application?: string | null;
+}
+/**
+ * Compute quality score for a brain_learnings row.
+ *
+ * Base: confidence value (already 0.0–1.0, caller-provided).
+ * Bonuses:
+ *   +0.10 if actionable (directly applicable guidance)
+ *   +0.10 if insight text exceeds 100 chars (detailed insight)
+ *   +0.10 if application exceeds 20 chars (concrete application context)
+ *
+ * Result clamped to [0.0, 1.0].
+ */
+export declare function computeLearningQuality(params: LearningQualityInput): number;
+/** Input shape for decision quality computation — mirrors StoreDecisionParams. */
+export interface DecisionQualityInput {
+    confidence: 'low' | 'medium' | 'high';
+    rationale?: string | null;
+    contextTaskId?: string | null;
+}
+/**
+ * Compute quality score for a brain_decisions row.
+ *
+ * Base: mapped from confidence level (high=0.9, medium=0.7, low=0.5).
+ * Bonuses:
+ *   +0.10 if rationale exceeds 50 chars (substantiated reasoning)
+ *   +0.05 if linked to a specific task (anchored in real work)
+ *
+ * Result clamped to [0.0, 1.0].
+ */
+export declare function computeDecisionQuality(params: DecisionQualityInput): number;
+/** Input shape for observation quality computation — mirrors ObserveBrainParams. */
+export interface ObservationQualityInput {
+    text: string;
+    title?: string | null;
+}
+/**
+ * Compute quality score for a brain_observations row.
+ *
+ * Base: 0.6 (manual observations start higher than auto-extracted entries).
+ * Bonuses:
+ *   +0.10 if text exceeds 200 chars (rich narrative)
+ *   +0.05 if title exceeds 10 chars (meaningful label)
+ *
+ * Result clamped to [0.0, 1.0].
+ */
+export declare function computeObservationQuality(params: ObservationQualityInput): number;
+//# sourceMappingURL=quality-scoring.d.ts.map

package/dist/memory/quality-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-scoring.d.ts","sourceRoot":"","sources":["../../src/memory/quality-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAM3C,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAmBzE;AAMD,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAQ3E;AAMD,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AASD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAO3E;AAMD,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAOjF"}

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

@@ -1,12 +1,17 @@
 /**
- * Memory-session bridge — records session summaries as brain observations.
+ * Memory-session bridge — no-op placeholder retained for call-site compatibility.
  *
- * Hooks into the session end flow to persist a summary of the session's
- * work (tasks completed, scope, duration) into brain.db as an observation.
- * This is best-effort: failures do not affect the session end operation.
+ * Previously this function wrote a session summary observation to brain.db and
+ * triggered auto-extraction of structured memory. Both were removed in T527
+ * because session data already lives in the sessions table; duplicating it to
+ * brain_observations was pure noise.
+ *
+ * The function is kept (as a no-op) so callers in sessions/index.ts do not need
+ * to be updated in this task.
  *
  * @task T5392
  * @epic T5149
+ * @see T527 — removal of duplicate session observation writes
  */
 /** Session data needed to create a memory bridge observation. */
 export interface SessionBridgeData {
@@ -16,13 +21,14 @@ export interface SessionBridgeData {
     duration: number;
 }
 /**
- * Bridge session end data to brain.db as an observation.
+ * Bridge session end data — currently a no-op.
  *
- * Builds a summary text from the session metadata and saves it
- * as a 'change' observation with source_type 'agent'.
+ * Retained for call-site compatibility. Previously wrote a duplicate summary
+ * observation to brain.db and triggered extractSessionEndMemory; both were
+ * removed in T527 to reduce brain.db noise.
  *
- * @param projectRoot - Project root directory for brain.db resolution
- * @param sessionData - Session metadata to record
+ * @param _projectRoot - Project root directory (unused)
+ * @param _sessionData - Session metadata (unused)
  */
-export declare function bridgeSessionToMemory(projectRoot: string, sessionData: SessionBridgeData): Promise<void>;
+export declare function bridgeSessionToMemory(_projectRoot: string, _sessionData: SessionBridgeData): Promise<void>;
 //# sourceMappingURL=session-memory-bridge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session-memory-bridge.d.ts","sourceRoot":"","sources":["../../src/sessions/session-memory-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"session-memory-bridge.d.ts","sourceRoot":"","sources":["../../src/sessions/session-memory-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,iBAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAGf"}

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

@@ -71,10 +71,17 @@ export declare class BrainDataAccessor {
     getPageNode(id: string): Promise<BrainPageNodeRow | null>;
     findPageNodes(params?: {
         nodeType?: (typeof brainSchema.BRAIN_NODE_TYPES)[number];
+        minQualityScore?: number;
         limit?: number;
     }): Promise<BrainPageNodeRow[]>;
+    updatePageNode(id: string, updates: Partial<NewBrainPageNodeRow>): Promise<void>;
     removePageNode(id: string): Promise<void>;
     addPageEdge(edge: NewBrainPageEdgeRow): Promise<BrainPageEdgeRow>;
+    findPageEdges(params?: {
+        edgeType?: (typeof brainSchema.BRAIN_EDGE_TYPES)[number];
+        provenance?: string;
+        limit?: number;
+    }): Promise<BrainPageEdgeRow[]>;
     getPageEdges(nodeId: string, direction?: 'in' | 'out' | 'both'): Promise<BrainPageEdgeRow[]>;
     getNeighbors(nodeId: string, edgeType?: (typeof brainSchema.BRAIN_EDGE_TYPES)[number]): Promise<BrainPageNodeRow[]>;
     removePageEdge(fromId: string, toId: string, edgeType: (typeof brainSchema.BRAIN_EDGE_TYPES)[number]): Promise<void>;

package/dist/store/brain-accessor.d.ts.map

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

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

@@ -196,6 +196,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";
@@ -427,6 +443,22 @@ 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;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -578,6 +610,22 @@ export declare const brainLearnings: import("drizzle-orm/sqlite-core").SQLiteTab
             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;
+        }, {}>;
     };
     dialect: "sqlite";
 }>;
@@ -826,6 +874,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";
@@ -1156,11 +1220,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 +1273,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 +1301,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 +1381,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 +1447,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 +1465,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 +1475,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";