@cleocode/cleo 2026.4.66 → 2026.4.68

package/migrations/drizzle-brain/20260408000001_t417-agent-field/migration.sql

@@ -0,0 +1,13 @@
+-- T417: Wave 8 Mental Models — add `agent` provenance field to brain_observations.
+-- Identifies the spawned agent that produced an observation for per-agent mental
+-- model retrieval via `memory.find --agent <name>`.
+--
+-- Idempotent: SQLite does not support ADD COLUMN IF NOT EXISTS in all versions,
+-- so we use a best-effort pattern with a guard query; the migrator journal
+-- prevents double-execution, making idempotency via the journal sufficient.
+
+ALTER TABLE `brain_observations` ADD COLUMN `agent` text;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_agent`
+  ON `brain_observations` (`agent`);

package/migrations/drizzle-brain/20260408000001_t417-agent-field/snapshot.json

@@ -0,0 +1,28 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "id": "t417-agent-field-20260408",
+  "prevIds": [
+    "t033-brain-indexes-20260321"
+  ],
+  "tables": {
+    "brain_observations": {
+      "name": "brain_observations",
+      "columns": {
+        "agent": {
+          "name": "agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {
+        "idx_brain_observations_agent": {
+          "name": "idx_brain_observations_agent",
+          "columns": ["agent"],
+          "isUnique": false
+        }
+      }
+    }
+  }
+}

package/migrations/drizzle-brain/20260411000001_t528-graph-schema-expansion/migration.sql

@@ -0,0 +1,47 @@
+-- T528: Graph-native memory model — expand brain_page_nodes and brain_page_edges schemas.
+-- Adds quality scoring, content hashing, last-activity tracking, provenance, and new
+-- indexes to support traversable knowledge graph operations.
+--
+-- Additive only: all new columns have defaults so existing rows are unaffected.
+-- brain_page_nodes has 0 rows and brain_page_edges has 0 rows (confirmed by R1 audit),
+-- so no data migration is required.
+
+ALTER TABLE `brain_page_nodes` ADD COLUMN `quality_score` real NOT NULL DEFAULT 0.5;
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `content_hash` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `last_activity_at` text NOT NULL DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_page_nodes` ADD COLUMN `updated_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `provenance` text;
+--> statement-breakpoint
+
+-- brain_page_edges.weight was nullable (DEFAULT 1) in the initial schema;
+-- changing NOT NULL constraint requires recreating the table in SQLite.
+-- Since brain_page_edges has 0 rows, we drop and recreate.
+DROP TABLE IF EXISTS `brain_page_edges`;
+--> statement-breakpoint
+CREATE TABLE `brain_page_edges` (
+	`from_id` text NOT NULL,
+	`to_id` text NOT NULL,
+	`edge_type` text NOT NULL,
+	`weight` real NOT NULL DEFAULT 1,
+	`provenance` text,
+	`created_at` text NOT NULL DEFAULT (datetime('now')),
+	CONSTRAINT `brain_page_edges_pk` PRIMARY KEY(`from_id`, `to_id`, `edge_type`)
+);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_quality` ON `brain_page_nodes` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_content_hash` ON `brain_page_nodes` (`content_hash`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_nodes_last_activity` ON `brain_page_nodes` (`last_activity_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_type` ON `brain_page_edges` (`edge_type`);
+--> statement-breakpoint
+-- Re-create existing edge indexes (dropped with table)
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_from` ON `brain_page_edges` (`from_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_to` ON `brain_page_edges` (`to_id`);

package/migrations/drizzle-brain/20260412000001_t531-quality-score-typed-tables/migration.sql

@@ -0,0 +1,23 @@
+-- T531: Wire quality scoring into brain memory store functions.
+-- Adds quality_score column to the four typed brain tables.
+-- NULL is used for legacy rows (not yet scored); new rows get a computed score.
+-- Search filtering uses "IS NULL OR quality_score >= 0.3" so legacy entries are retained.
+--
+-- Additive only: all columns are nullable so existing rows are unaffected.
+
+ALTER TABLE `brain_decisions` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `quality_score` real;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_quality` ON `brain_decisions` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_quality` ON `brain_patterns` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_quality` ON `brain_learnings` (`quality_score`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_quality` ON `brain_observations` (`quality_score`);

package/migrations/drizzle-brain/20260413000001_t549-tiered-typed-memory/migration.sql

@@ -0,0 +1,195 @@
+-- T549: Tiered + Typed Memory Architecture v2
+-- Adds: memory_tier, memory_type (cognitive), verified, valid_at, invalid_at,
+--       source_confidence, citation_count to all four typed brain tables.
+--
+-- Strategy: all columns are nullable or have defaults; no existing rows are broken.
+-- NULL-handling contracts: legacy rows are backfilled at the end of this migration.
+-- memory_tier NULL → treated as 'medium' at query time (survived T523 purge).
+-- memory_type NULL → treated as table default at query time.
+-- CONFLICT-03 resolution: citation_count added per cross-validation report (T549-XV).
+-- CONFLICT-01 resolution: cognitive type enum is BRAIN_COGNITIVE_TYPES (semantic/episodic/procedural).
+-- T553 fix: valid_at columns use nullable DEFAULT (datetime('now')) instead of NOT NULL DEFAULT
+--   because SQLite forbids ALTER TABLE ADD COLUMN with a non-constant default on non-empty tables.
+--   The backfill UPDATEs at the end of this migration set valid_at = created_at for all existing
+--   rows, so no row ever has a NULL valid_at after migration completes.
+
+-- ============================================================
+-- brain_decisions
+-- ============================================================
+
+ALTER TABLE `brain_decisions` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `memory_type` text DEFAULT 'semantic';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_patterns
+-- ============================================================
+
+ALTER TABLE `brain_patterns` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `memory_type` text DEFAULT 'procedural';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_learnings
+-- ============================================================
+
+ALTER TABLE `brain_learnings` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `memory_type` text DEFAULT 'semantic';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_observations
+-- ============================================================
+
+ALTER TABLE `brain_observations` ADD COLUMN `memory_tier` text DEFAULT 'short';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `memory_type` text DEFAULT 'episodic';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `verified` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `valid_at` text DEFAULT (datetime('now'));
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `invalid_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `source_confidence` text DEFAULT 'agent';
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `citation_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+
+-- ============================================================
+-- Indexes for new columns (query hot paths)
+-- ============================================================
+
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_tier` ON `brain_decisions` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_type` ON `brain_decisions` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_verified` ON `brain_decisions` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_valid_at` ON `brain_decisions` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_source_conf` ON `brain_decisions` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_tier` ON `brain_patterns` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_type` ON `brain_patterns` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_verified` ON `brain_patterns` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_valid_at` ON `brain_patterns` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_source_conf` ON `brain_patterns` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_tier` ON `brain_learnings` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_type` ON `brain_learnings` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_verified` ON `brain_learnings` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_valid_at` ON `brain_learnings` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_invalid` ON `brain_learnings` (`invalid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_source_conf` ON `brain_learnings` (`source_confidence`);
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_tier` ON `brain_observations` (`memory_tier`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_type` ON `brain_observations` (`memory_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_verified` ON `brain_observations` (`verified`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_valid_at` ON `brain_observations` (`valid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_invalid` ON `brain_observations` (`invalid_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_source_conf` ON `brain_observations` (`source_confidence`);
+--> statement-breakpoint
+
+-- ============================================================
+-- Backfill: legacy rows (survivors of the T523 purge)
+-- Treat existing rows as medium-to-long-term based on quality signals.
+-- valid_at defaults to created_at so bitemporal queries work correctly.
+-- ============================================================
+
+UPDATE `brain_decisions` SET
+  memory_tier = CASE
+    WHEN confidence = 'high' THEN 'long'
+    WHEN confidence = 'medium' THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'semantic',
+  valid_at = created_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_patterns` SET
+  memory_tier = CASE
+    WHEN frequency >= 5 THEN 'long'
+    WHEN frequency >= 2 THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'procedural',
+  valid_at = extracted_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_learnings` SET
+  memory_tier = CASE
+    WHEN confidence >= 0.80 THEN 'long'
+    WHEN confidence >= 0.60 THEN 'medium'
+    ELSE 'medium'
+  END,
+  memory_type = 'semantic',
+  valid_at = created_at,
+  source_confidence = 'agent'
+WHERE memory_tier IS NULL;
+--> statement-breakpoint
+
+UPDATE `brain_observations` SET
+  memory_tier = 'medium',
+  memory_type = 'episodic',
+  valid_at = created_at,
+  source_confidence = CASE
+    WHEN source_type = 'manual' THEN 'owner'
+    WHEN source_type = 'session-debrief' THEN 'task-outcome'
+    ELSE 'agent'
+  END
+WHERE memory_tier IS NULL;

package/migrations/drizzle-brain/20260415000001_t626-normalize-co-retrieved-edge-type/migration.sql

@@ -0,0 +1,14 @@
+-- T626-M1: Normalize co_retrieved edge type
+--
+-- The shipped Hebbian strengthener (brain-lifecycle.ts:strengthenCoRetrievedEdges)
+-- was emitting edge_type = 'relates_to' instead of 'co_retrieved'. This migration
+-- relabels all existing rows that were created by that code path.
+--
+-- Safety: the WHERE clause constrains to rows whose provenance starts with
+-- 'consolidation:' so only Hebbian edges are touched; no semantic edges are
+-- affected. co_retrieved is already in BRAIN_EDGE_TYPES so Drizzle accepts it.
+
+UPDATE `brain_page_edges`
+SET edge_type = 'co_retrieved'
+WHERE edge_type = 'relates_to'
+  AND provenance LIKE 'consolidation:%';

package/migrations/drizzle-brain/20260416000001_t673-retrieval-log-plasticity-columns/migration.sql

@@ -0,0 +1,57 @@
+-- T673-M1: Plasticity columns for brain_retrieval_log
+--
+-- Adds two NEW columns to the live table:
+--   session_id    — declared in Drizzle at brain-schema.ts but never applied to
+--                   the live table via ALTER TABLE (was missing from live DDL)
+--   reward_signal — R-STDP third-factor scalar [-1.0, +1.0] (D-BRAIN-VIZ-13)
+--
+-- NOTE: retrieval_order and delta_ms are NOT added here — they already exist in
+-- the live table via the self-healing DDL in brain-sqlite.ts (logRetrieval
+-- CREATE TABLE IF NOT EXISTS). The Drizzle schema declaration in brain-schema.ts
+-- now includes them for type-safety only (schema drift sync, no migration needed).
+--
+-- SAFETY: brain_retrieval_log may not exist on a fresh DB (it was created only
+-- via self-healing DDL). CREATE TABLE IF NOT EXISTS ensures it exists so the
+-- ALTER TABLE statements can succeed on fresh installs.
+--
+-- All UPDATE statements are idempotent via their WHERE clauses.
+-- Migration sequence: M1 must precede M2/M3/M4.
+-- Spec ref: docs/specs/stdp-wire-up-spec.md §5.1
+
+CREATE TABLE IF NOT EXISTS `brain_retrieval_log` (
+  `id` integer PRIMARY KEY AUTOINCREMENT,
+  `query` text NOT NULL,
+  `entry_ids` text NOT NULL,
+  `entry_count` integer NOT NULL,
+  `source` text NOT NULL,
+  `tokens_used` integer,
+  `created_at` text NOT NULL DEFAULT (datetime('now'))
+);
+--> statement-breakpoint
+
+ALTER TABLE `brain_retrieval_log` ADD COLUMN `session_id` text;
+--> statement-breakpoint
+ALTER TABLE `brain_retrieval_log` ADD COLUMN `reward_signal` real;
+--> statement-breakpoint
+
+-- Convert comma-separated entry_ids to JSON array format (idempotent).
+-- Rows already in JSON format (starting with '[') are untouched.
+-- Fixes BUG-2: readers call JSON.parse() but writer stored CSV.
+-- Per spec §2.3.
+UPDATE `brain_retrieval_log`
+SET entry_ids = '["' || REPLACE(entry_ids, ',', '","') || '"]'
+WHERE entry_ids IS NOT NULL AND entry_ids != '' AND entry_ids NOT LIKE '[%';
+--> statement-breakpoint
+
+-- Backfill synthetic session IDs for historical rows (spec §2.4 / T715).
+-- One ses_backfill_YYYY-MM-DD per calendar day in created_at.
+-- Rows already having a session_id are untouched (idempotent).
+-- backfillRewardSignals MUST skip rows where session_id LIKE 'ses_backfill_%'.
+UPDATE `brain_retrieval_log`
+SET session_id = 'ses_backfill_' || substr(created_at, 1, 10)
+WHERE session_id IS NULL;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_retrieval_log_reward` ON `brain_retrieval_log` (`reward_signal`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_retrieval_log_session` ON `brain_retrieval_log` (`session_id`);

package/migrations/drizzle-brain/20260416000002_t673-plasticity-events-expand/migration.sql

@@ -0,0 +1,44 @@
+-- T673-M2: Expand brain_plasticity_events with observability columns.
+--
+-- Adds 5 new nullable columns to brain_plasticity_events:
+--   weight_before  — edge weight immediately before this event
+--   weight_after   — edge weight immediately after this event
+--   retrieval_log_id — soft FK to brain_retrieval_log.id (causal trace)
+--   reward_signal  — R-STDP reward signal at time of event
+--   delta_t_ms     — Δt in ms between the two spikes that generated this event
+--
+-- Safety: table currently has 0 rows so all new nullable columns have no data impact.
+-- New INSERT statements in brain-stdp.ts MUST populate these columns going forward.
+--
+-- SAFETY: brain_plasticity_events is not in the initial migration — it was created
+-- only via self-healing DDL in brain-sqlite.ts. On a fresh DB this migration
+-- runs before the self-healing code. CREATE TABLE IF NOT EXISTS ensures the
+-- table exists so the ALTER TABLE statements below can succeed.
+--
+-- Per docs/specs/stdp-wire-up-spec.md §2.1.2 and T673-council-schema.md §4.2.
+
+CREATE TABLE IF NOT EXISTS `brain_plasticity_events` (
+  `id` integer PRIMARY KEY AUTOINCREMENT,
+  `source_node` text NOT NULL,
+  `target_node` text NOT NULL,
+  `delta_w` real NOT NULL,
+  `kind` text NOT NULL,
+  `timestamp` text NOT NULL DEFAULT (datetime('now')),
+  `session_id` text
+);
+--> statement-breakpoint
+
+ALTER TABLE `brain_plasticity_events` ADD COLUMN `weight_before` real;
+--> statement-breakpoint
+ALTER TABLE `brain_plasticity_events` ADD COLUMN `weight_after` real;
+--> statement-breakpoint
+ALTER TABLE `brain_plasticity_events` ADD COLUMN `retrieval_log_id` integer;
+--> statement-breakpoint
+ALTER TABLE `brain_plasticity_events` ADD COLUMN `reward_signal` real;
+--> statement-breakpoint
+ALTER TABLE `brain_plasticity_events` ADD COLUMN `delta_t_ms` integer;
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_plasticity_retrieval_log` ON `brain_plasticity_events` (`retrieval_log_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_plasticity_reward` ON `brain_plasticity_events` (`reward_signal`);

package/migrations/drizzle-brain/20260416000003_t673-page-edges-plasticity-columns/migration.sql

@@ -0,0 +1,44 @@
+-- T673-M3: Add plasticity tracking columns to brain_page_edges.
+--
+-- Adds 6 new columns enabling the STDP plasticity substrate:
+--   last_reinforced_at    — ISO 8601 timestamp of last LTP event
+--   reinforcement_count   — count of LTP events applied lifetime (DEFAULT 0)
+--   plasticity_class      — routing class: 'static' | 'hebbian' | 'stdp' (DEFAULT 'static')
+--   last_depressed_at     — ISO 8601 timestamp of last LTD event
+--   depression_count      — count of LTD events applied lifetime (DEFAULT 0)
+--   stability_score       — tanh(rc/10) * exp(-(days/30)), null = not yet computed
+--
+-- Seeding strategy:
+--   - All existing edges: plasticity_class = 'static' (safe default via ALTER TABLE)
+--   - co_retrieved edges are overridden to 'hebbian' (Hebbian strengthener origin)
+--
+-- New indexes:
+--   idx_brain_edges_last_reinforced — decay pass filter (skip recently reinforced)
+--   idx_brain_edges_plasticity_class — class routing (skip static edges in decay)
+--   idx_brain_edges_stability — fast stable-edge skip filter
+--
+-- Per docs/specs/stdp-wire-up-spec.md §2.1.3 and T673-council-schema.md §4.3.
+
+ALTER TABLE `brain_page_edges` ADD COLUMN `last_reinforced_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `reinforcement_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `plasticity_class` text NOT NULL DEFAULT 'static';
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `last_depressed_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `depression_count` integer NOT NULL DEFAULT 0;
+--> statement-breakpoint
+ALTER TABLE `brain_page_edges` ADD COLUMN `stability_score` real;
+--> statement-breakpoint
+
+-- Seed: co_retrieved edges are Hebbian-origin, not static.
+-- This UPDATE is idempotent — re-running sets already-hebbian rows to hebbian.
+UPDATE `brain_page_edges` SET plasticity_class = 'hebbian' WHERE edge_type = 'co_retrieved';
+--> statement-breakpoint
+
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_last_reinforced` ON `brain_page_edges` (`last_reinforced_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_plasticity_class` ON `brain_page_edges` (`plasticity_class`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_edges_stability` ON `brain_page_edges` (`stability_score`);

package/migrations/drizzle-brain/20260416000004_t673-new-plasticity-tables/migration.sql

@@ -0,0 +1,73 @@
+-- T673-M4: New plasticity infrastructure tables
+-- brain_weight_history: per-edge delta-w audit log (owner Q4 mandate -- 90-day rolling retention)
+-- brain_modulators: R-STDP reward/correction/user_feedback event log
+-- brain_consolidation_events: pipeline run audit for T628 auto-dream + manual consolidations
+-- All IF NOT EXISTS -- safe to apply multiple times (idempotent).
+-- Retention: brain_weight_history rows older than 90 days are swept by runConsolidation Step 9d.
+-- Actual pruning wired in Wave 3 (T690 homeostatic decay per spec §4.2 Step 9d).
+
+CREATE TABLE IF NOT EXISTS `brain_weight_history` (
+  `id` integer PRIMARY KEY AUTOINCREMENT,
+  `edge_from_id` text NOT NULL,
+  `edge_to_id` text NOT NULL,
+  `edge_type` text NOT NULL,
+  `weight_before` real,
+  `weight_after` real NOT NULL,
+  `delta_weight` real NOT NULL,
+  `event_kind` text NOT NULL,
+  `source_plasticity_event_id` integer,
+  `retrieval_log_id` integer,
+  `reward_signal` real,
+  `changed_at` text NOT NULL DEFAULT (datetime('now'))
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_edge` ON `brain_weight_history` (`edge_from_id`, `edge_to_id`, `edge_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_from` ON `brain_weight_history` (`edge_from_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_to` ON `brain_weight_history` (`edge_to_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_changed_at` ON `brain_weight_history` (`changed_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_event_kind` ON `brain_weight_history` (`event_kind`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_weight_history_plasticity_event` ON `brain_weight_history` (`source_plasticity_event_id`);
+--> statement-breakpoint
+
+CREATE TABLE IF NOT EXISTS `brain_modulators` (
+  `id` integer PRIMARY KEY AUTOINCREMENT,
+  `modulator_type` text NOT NULL,
+  `valence` real NOT NULL,
+  `magnitude` real NOT NULL DEFAULT 1.0,
+  `source_event_id` text,
+  `session_id` text,
+  `description` text,
+  `created_at` text NOT NULL DEFAULT (datetime('now'))
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_modulators_type` ON `brain_modulators` (`modulator_type`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_modulators_session` ON `brain_modulators` (`session_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_modulators_created_at` ON `brain_modulators` (`created_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_modulators_source_event` ON `brain_modulators` (`source_event_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_modulators_valence` ON `brain_modulators` (`valence`);
+--> statement-breakpoint
+
+CREATE TABLE IF NOT EXISTS `brain_consolidation_events` (
+  `id` integer PRIMARY KEY AUTOINCREMENT,
+  `trigger` text NOT NULL,
+  `session_id` text,
+  `step_results_json` text NOT NULL,
+  `duration_ms` integer,
+  `succeeded` integer NOT NULL DEFAULT 1,
+  `started_at` text NOT NULL DEFAULT (datetime('now'))
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_consolidation_events_started_at` ON `brain_consolidation_events` (`started_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_consolidation_events_trigger` ON `brain_consolidation_events` (`trigger`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_consolidation_events_session` ON `brain_consolidation_events` (`session_id`);

package/migrations/drizzle-brain/20260416000005_t726-dedup-tier-columns/migration.sql

@@ -0,0 +1,77 @@
+-- T726 Wave 1A: Memory dedup gates + tier promotion audit columns
+--
+-- T741 + T743: Add tier_promoted_at + tier_promotion_reason to all 4 memory tables.
+--   Enables auditable promotion history without a separate log table.
+-- T737: Add content_hash to brain_decisions, brain_patterns, brain_learnings.
+--   All three tables had the column in the original design intent (hash-dedup for all
+--   typed tables) but it was only added to brain_observations in T033. This migration
+--   closes the gap so hashDedupCheck() can gate all four tables.
+-- T746: No DDL needed — the DEFAULT 'medium' fix is a Drizzle-schema-only correction.
+--   Existing rows already have 'medium' assigned by the write-path; only the Drizzle
+--   column declaration was wrong (DEFAULT 'short' vs 'medium').
+--
+-- All ALTER statements are idempotent-safe: columns are nullable, added after existing
+-- columns, no NOT NULL without a default.
+
+-- ============================================================
+-- brain_decisions — tier promotion audit + content_hash
+-- ============================================================
+
+ALTER TABLE `brain_decisions` ADD COLUMN `tier_promoted_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `tier_promotion_reason` text;
+--> statement-breakpoint
+ALTER TABLE `brain_decisions` ADD COLUMN `content_hash` text;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_patterns — tier promotion audit + content_hash
+-- ============================================================
+
+ALTER TABLE `brain_patterns` ADD COLUMN `tier_promoted_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `tier_promotion_reason` text;
+--> statement-breakpoint
+ALTER TABLE `brain_patterns` ADD COLUMN `content_hash` text;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_learnings — tier promotion audit + content_hash
+-- ============================================================
+
+ALTER TABLE `brain_learnings` ADD COLUMN `tier_promoted_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `tier_promotion_reason` text;
+--> statement-breakpoint
+ALTER TABLE `brain_learnings` ADD COLUMN `content_hash` text;
+--> statement-breakpoint
+
+-- ============================================================
+-- brain_observations — tier promotion audit only
+-- (content_hash already exists from T033)
+-- ============================================================
+
+ALTER TABLE `brain_observations` ADD COLUMN `tier_promoted_at` text;
+--> statement-breakpoint
+ALTER TABLE `brain_observations` ADD COLUMN `tier_promotion_reason` text;
+--> statement-breakpoint
+
+-- ============================================================
+-- Indexes on tier_promoted_at for promotion history queries
+-- ============================================================
+
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_tier_promoted_at` ON `brain_decisions` (`tier_promoted_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_tier_promoted_at` ON `brain_patterns` (`tier_promoted_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_tier_promoted_at` ON `brain_learnings` (`tier_promoted_at`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_observations_tier_promoted_at` ON `brain_observations` (`tier_promoted_at`);
+--> statement-breakpoint
+
+-- Indexes on content_hash for the new typed tables (mirrors obs index pattern)
+CREATE INDEX IF NOT EXISTS `idx_brain_decisions_content_hash` ON `brain_decisions` (`content_hash`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_patterns_content_hash` ON `brain_patterns` (`content_hash`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_brain_learnings_content_hash` ON `brain_learnings` (`content_hash`);