fastrmemory 0.3.0 → 0.4.0

package/dist/src/db/schema.js

@@ -1,269 +1,269 @@
 import { DatabaseSync } from 'node:sqlite';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
-export const SCHEMA_SQL = `
-PRAGMA journal_mode = WAL;
-PRAGMA synchronous = NORMAL;
-PRAGMA foreign_keys = ON;
-PRAGMA busy_timeout = 5000;
-
--- 1. Immutable raw observations
-CREATE TABLE IF NOT EXISTS raw_events (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  session_id TEXT NOT NULL,
-  agent_id TEXT DEFAULT 'default',
-  event_type TEXT NOT NULL,
-  tool_name TEXT,
-  file_path TEXT,
-  raw_payload TEXT NOT NULL,
-  content_hash TEXT NOT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_raw_events_session ON raw_events(project_id, session_id);
-CREATE INDEX IF NOT EXISTS idx_raw_events_hash ON raw_events(content_hash);
-CREATE INDEX IF NOT EXISTS idx_raw_events_project_created ON raw_events(project_id, created_at);
-
--- 2. Structured memories with Bi-Temporal Validity Windows & Outcome Multipliers
-CREATE TABLE IF NOT EXISTS memories (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  agent_id TEXT DEFAULT 'default',
-  module TEXT NOT NULL DEFAULT 'general',
-  kind TEXT NOT NULL CHECK (kind IN ('rule', 'decision', 'error_trap', 'workflow')),
-  title TEXT NOT NULL,
-  content TEXT NOT NULL,
-  status TEXT NOT NULL DEFAULT 'staging' CHECK (status IN ('staging', 'verified', 'superseded', 'dormant')),
-  pinned INTEGER NOT NULL DEFAULT 0,
-  reward_score REAL NOT NULL DEFAULT 1.0,
-  retrieval_count INTEGER NOT NULL DEFAULT 0,
-  valid_from TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  valid_to TEXT DEFAULT NULL,
-  superseded_by_id TEXT DEFAULT NULL,
-  superseded_reason TEXT DEFAULT NULL,
-  source_event_ids TEXT NOT NULL DEFAULT '[]',
-  embedding BLOB DEFAULT NULL,
-  embedded INTEGER NOT NULL DEFAULT 0,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  last_recalled_at TEXT DEFAULT NULL,
-  provenance_hash TEXT DEFAULT NULL
-);
-CREATE INDEX IF NOT EXISTS idx_memories_active ON memories(project_id, module, valid_to, status);
-CREATE INDEX IF NOT EXISTS idx_memories_embedded ON memories(project_id, embedded);
-
--- 2b. Per-ID Feedback Audit (confidence tiers and 3-consecutive-bad dormancy)
-CREATE TABLE IF NOT EXISTS memory_feedback (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  memory_id TEXT NOT NULL,
-  outcome TEXT NOT NULL CHECK (outcome IN ('good', 'bad')),
-  note TEXT DEFAULT NULL,
-  reward_before REAL NOT NULL,
-  reward_after REAL NOT NULL,
-  status_before TEXT NOT NULL,
-  status_after TEXT NOT NULL,
-  confidence_tier TEXT NOT NULL CHECK (confidence_tier IN ('high', 'medium', 'low', 'dormant', 'superseded')),
-  bad_streak INTEGER NOT NULL DEFAULT 0,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_memory_feedback_memory ON memory_feedback(memory_id, created_at DESC);
-CREATE INDEX IF NOT EXISTS idx_memory_feedback_project ON memory_feedback(project_id, created_at DESC);
-
--- 3. FTS5 Virtual Table for sub-millisecond BM25 keyword search
-CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
-  id UNINDEXED,
-  title,
-  module,
-  content,
-  tokenize='porter unicode61'
-);
-
--- Keep FTS5 automatically synced via triggers
-CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
-  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
-END;
-
-CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
-  DELETE FROM memories_fts WHERE id = old.id;
-END;
-
--- Only re-index when searchable columns change (not on retrieval counters / scores)
-CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE OF title, module, content ON memories BEGIN
-  DELETE FROM memories_fts WHERE id = old.id;
-  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
-END;
-
--- 4. File & Symbol Graph Links
-CREATE TABLE IF NOT EXISTS file_links (
-  memory_id TEXT NOT NULL,
-  file_path TEXT NOT NULL,
-  symbol_name TEXT DEFAULT '',
-  PRIMARY KEY (memory_id, file_path, symbol_name),
-  FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
-);
-CREATE INDEX IF NOT EXISTS idx_file_links_path ON file_links(file_path);
-
--- 5. Active Task Snapshot & Cross-Agent Handoffs
-CREATE TABLE IF NOT EXISTS handoffs (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  project_id TEXT NOT NULL,
-  session_id TEXT NOT NULL,
-  task_title TEXT NOT NULL,
-  summary TEXT NOT NULL,
-  next_step TEXT NOT NULL,
-  active_files TEXT NOT NULL DEFAULT '[]',
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-
--- 6. Memory Snapshots & Git-Style Point-in-Time Versioning
-CREATE TABLE IF NOT EXISTS memory_snapshots (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  tag TEXT NOT NULL,
-  description TEXT,
-  memory_count INTEGER NOT NULL,
-  state_json TEXT NOT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_snapshots_project ON memory_snapshots(project_id, created_at DESC);
-
--- 6b. Memory Branches and Merge Audit Trail
-CREATE TABLE IF NOT EXISTS memory_branches (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  name TEXT NOT NULL COLLATE NOCASE,
-  base_snapshot_id TEXT NOT NULL,
-  head_snapshot_id TEXT NOT NULL,
-  description TEXT DEFAULT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  UNIQUE (project_id, name),
-  FOREIGN KEY (base_snapshot_id) REFERENCES memory_snapshots(id) ON DELETE RESTRICT,
-  FOREIGN KEY (head_snapshot_id) REFERENCES memory_snapshots(id) ON DELETE RESTRICT
-);
-CREATE INDEX IF NOT EXISTS idx_memory_branches_project ON memory_branches(project_id, created_at DESC);
-
-CREATE TABLE IF NOT EXISTS memory_branch_merges (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  branch_id TEXT NOT NULL,
-  branch_name TEXT NOT NULL,
-  source_snapshot_id TEXT NOT NULL,
-  strategy TEXT NOT NULL CHECK (strategy IN ('target', 'branch')),
-  applied INTEGER NOT NULL DEFAULT 0,
-  added_count INTEGER NOT NULL DEFAULT 0,
-  conflict_count INTEGER NOT NULL DEFAULT 0,
-  report_json TEXT NOT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  FOREIGN KEY (branch_id) REFERENCES memory_branches(id) ON DELETE RESTRICT
-);
-CREATE INDEX IF NOT EXISTS idx_branch_merges_branch ON memory_branch_merges(branch_id, created_at DESC);
-
--- 7. Knowledge Graph Entities
-CREATE TABLE IF NOT EXISTS entities (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  name TEXT NOT NULL,
-  entity_type TEXT NOT NULL CHECK (entity_type IN ('symbol', 'file', 'tech', 'service', 'pattern')),
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_entities_name ON entities(project_id, name);
-
--- 8. Multi-Edge Knowledge Graph Links
-CREATE TABLE IF NOT EXISTS graph_edges (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  source_id TEXT NOT NULL,
-  target_id TEXT NOT NULL,
-  edge_type TEXT NOT NULL CHECK (edge_type IN ('causal', 'entity_link', 'temporal', 'association', 'supersedes')),
-  weight REAL NOT NULL DEFAULT 1.0,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_graph_edges_source ON graph_edges(project_id, source_id);
-CREATE INDEX IF NOT EXISTS idx_graph_edges_target ON graph_edges(project_id, target_id);
-
--- 9. Proactive Contradiction Conflicts
-CREATE TABLE IF NOT EXISTS memory_conflicts (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  project_id TEXT NOT NULL,
-  memory_a_id TEXT NOT NULL,
-  memory_b_id TEXT NOT NULL,
-  reason TEXT NOT NULL,
-  score REAL NOT NULL,
-  status TEXT NOT NULL DEFAULT 'open' CHECK (status IN ('open', 'resolved', 'ignored')),
-  resolved_winner_id TEXT DEFAULT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  resolved_at TEXT DEFAULT NULL,
-  FOREIGN KEY (memory_a_id) REFERENCES memories(id) ON DELETE CASCADE,
-  FOREIGN KEY (memory_b_id) REFERENCES memories(id) ON DELETE CASCADE
-);
-CREATE INDEX IF NOT EXISTS idx_conflicts_status ON memory_conflicts(project_id, status);
-
--- 10. Planning Fallacy Predictions & Baserate
-CREATE TABLE IF NOT EXISTS predictions (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  project_id TEXT NOT NULL,
-  class_tag TEXT NOT NULL,
-  claim_text TEXT NOT NULL,
-  estimate_value REAL,
-  estimate_unit TEXT,
-  actual_value REAL DEFAULT NULL,
-  closure_state TEXT NOT NULL DEFAULT 'open' CHECK (closure_state IN ('open', 'closed', 'closed-unknown')),
-  closed_at TEXT DEFAULT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
-);
-CREATE INDEX IF NOT EXISTS idx_predictions_class ON predictions(project_id, class_tag, closure_state);
-
--- 11. Multi-Agent Work Item Action DAG
-CREATE TABLE IF NOT EXISTS actions (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  title TEXT NOT NULL,
-  description TEXT NOT NULL DEFAULT '',
-  status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'active', 'done', 'blocked', 'cancelled')),
-  priority INTEGER NOT NULL DEFAULT 5,
-  assigned_to TEXT DEFAULT NULL,
-  crystallized_into TEXT DEFAULT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  completed_at TEXT DEFAULT NULL
-);
-CREATE INDEX IF NOT EXISTS idx_actions_status ON actions(project_id, status, priority DESC);
-
-CREATE TABLE IF NOT EXISTS action_edges (
-  source_action_id TEXT NOT NULL,
-  target_action_id TEXT NOT NULL,
-  edge_type TEXT NOT NULL CHECK (edge_type IN ('requires', 'unlocks', 'conflicts_with')),
-  PRIMARY KEY (source_action_id, target_action_id, edge_type),
-  FOREIGN KEY (source_action_id) REFERENCES actions(id) ON DELETE CASCADE,
-  FOREIGN KEY (target_action_id) REFERENCES actions(id) ON DELETE CASCADE
-);
-
--- 12. Bounded Working Memory Slots
-CREATE TABLE IF NOT EXISTS memory_slots (
-  project_id TEXT NOT NULL,
-  slot_key TEXT NOT NULL,
-  content TEXT NOT NULL,
-  size_limit INTEGER NOT NULL DEFAULT 4000,
-  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  PRIMARY KEY (project_id, slot_key)
-);
-
--- 13. Multimodal Vision Assets & Screenshots
-CREATE TABLE IF NOT EXISTS vision_assets (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  file_path TEXT NOT NULL,
-  description TEXT NOT NULL,
-  ocr_text TEXT DEFAULT NULL,
-  memory_id TEXT DEFAULT NULL,
-  task_id TEXT DEFAULT NULL,
-  embedding BLOB DEFAULT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE SET NULL,
-  FOREIGN KEY (task_id) REFERENCES actions(id) ON DELETE SET NULL
-);
-CREATE INDEX IF NOT EXISTS idx_vision_project ON vision_assets(project_id, created_at DESC);
-CREATE INDEX IF NOT EXISTS idx_vision_memory ON vision_assets(memory_id);
+export const SCHEMA_SQL = `
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+PRAGMA foreign_keys = ON;
+PRAGMA busy_timeout = 5000;
+
+-- 1. Immutable raw observations
+CREATE TABLE IF NOT EXISTS raw_events (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  agent_id TEXT DEFAULT 'default',
+  event_type TEXT NOT NULL,
+  tool_name TEXT,
+  file_path TEXT,
+  raw_payload TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_raw_events_session ON raw_events(project_id, session_id);
+CREATE INDEX IF NOT EXISTS idx_raw_events_hash ON raw_events(content_hash);
+CREATE INDEX IF NOT EXISTS idx_raw_events_project_created ON raw_events(project_id, created_at);
+
+-- 2. Structured memories with Bi-Temporal Validity Windows & Outcome Multipliers
+CREATE TABLE IF NOT EXISTS memories (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  agent_id TEXT DEFAULT 'default',
+  module TEXT NOT NULL DEFAULT 'general',
+  kind TEXT NOT NULL CHECK (kind IN ('rule', 'decision', 'error_trap', 'workflow')),
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'staging' CHECK (status IN ('staging', 'verified', 'superseded', 'dormant')),
+  pinned INTEGER NOT NULL DEFAULT 0,
+  reward_score REAL NOT NULL DEFAULT 1.0,
+  retrieval_count INTEGER NOT NULL DEFAULT 0,
+  valid_from TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  valid_to TEXT DEFAULT NULL,
+  superseded_by_id TEXT DEFAULT NULL,
+  superseded_reason TEXT DEFAULT NULL,
+  source_event_ids TEXT NOT NULL DEFAULT '[]',
+  embedding BLOB DEFAULT NULL,
+  embedded INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  last_recalled_at TEXT DEFAULT NULL,
+  provenance_hash TEXT DEFAULT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_memories_active ON memories(project_id, module, valid_to, status);
+CREATE INDEX IF NOT EXISTS idx_memories_embedded ON memories(project_id, embedded);
+
+-- 2b. Per-ID Feedback Audit (confidence tiers and 3-consecutive-bad dormancy)
+CREATE TABLE IF NOT EXISTS memory_feedback (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  memory_id TEXT NOT NULL,
+  outcome TEXT NOT NULL CHECK (outcome IN ('good', 'bad')),
+  note TEXT DEFAULT NULL,
+  reward_before REAL NOT NULL,
+  reward_after REAL NOT NULL,
+  status_before TEXT NOT NULL,
+  status_after TEXT NOT NULL,
+  confidence_tier TEXT NOT NULL CHECK (confidence_tier IN ('high', 'medium', 'low', 'dormant', 'superseded')),
+  bad_streak INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_memory_feedback_memory ON memory_feedback(memory_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_feedback_project ON memory_feedback(project_id, created_at DESC);
+
+-- 3. FTS5 Virtual Table for sub-millisecond BM25 keyword search
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+  id UNINDEXED,
+  title,
+  module,
+  content,
+  tokenize='porter unicode61'
+);
+
+-- Keep FTS5 automatically synced via triggers
+CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+  DELETE FROM memories_fts WHERE id = old.id;
+END;
+
+-- Only re-index when searchable columns change (not on retrieval counters / scores)
+CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE OF title, module, content ON memories BEGIN
+  DELETE FROM memories_fts WHERE id = old.id;
+  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
+END;
+
+-- 4. File & Symbol Graph Links
+CREATE TABLE IF NOT EXISTS file_links (
+  memory_id TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  symbol_name TEXT DEFAULT '',
+  PRIMARY KEY (memory_id, file_path, symbol_name),
+  FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_file_links_path ON file_links(file_path);
+
+-- 5. Active Task Snapshot & Cross-Agent Handoffs
+CREATE TABLE IF NOT EXISTS handoffs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  task_title TEXT NOT NULL,
+  summary TEXT NOT NULL,
+  next_step TEXT NOT NULL,
+  active_files TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+
+-- 6. Memory Snapshots & Git-Style Point-in-Time Versioning
+CREATE TABLE IF NOT EXISTS memory_snapshots (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  tag TEXT NOT NULL,
+  description TEXT,
+  memory_count INTEGER NOT NULL,
+  state_json TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_snapshots_project ON memory_snapshots(project_id, created_at DESC);
+
+-- 6b. Memory Branches and Merge Audit Trail
+CREATE TABLE IF NOT EXISTS memory_branches (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  name TEXT NOT NULL COLLATE NOCASE,
+  base_snapshot_id TEXT NOT NULL,
+  head_snapshot_id TEXT NOT NULL,
+  description TEXT DEFAULT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  UNIQUE (project_id, name),
+  FOREIGN KEY (base_snapshot_id) REFERENCES memory_snapshots(id) ON DELETE RESTRICT,
+  FOREIGN KEY (head_snapshot_id) REFERENCES memory_snapshots(id) ON DELETE RESTRICT
+);
+CREATE INDEX IF NOT EXISTS idx_memory_branches_project ON memory_branches(project_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS memory_branch_merges (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  branch_id TEXT NOT NULL,
+  branch_name TEXT NOT NULL,
+  source_snapshot_id TEXT NOT NULL,
+  strategy TEXT NOT NULL CHECK (strategy IN ('target', 'branch')),
+  applied INTEGER NOT NULL DEFAULT 0,
+  added_count INTEGER NOT NULL DEFAULT 0,
+  conflict_count INTEGER NOT NULL DEFAULT 0,
+  report_json TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  FOREIGN KEY (branch_id) REFERENCES memory_branches(id) ON DELETE RESTRICT
+);
+CREATE INDEX IF NOT EXISTS idx_branch_merges_branch ON memory_branch_merges(branch_id, created_at DESC);
+
+-- 7. Knowledge Graph Entities
+CREATE TABLE IF NOT EXISTS entities (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  entity_type TEXT NOT NULL CHECK (entity_type IN ('symbol', 'file', 'tech', 'service', 'pattern')),
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_entities_name ON entities(project_id, name);
+
+-- 8. Multi-Edge Knowledge Graph Links
+CREATE TABLE IF NOT EXISTS graph_edges (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  source_id TEXT NOT NULL,
+  target_id TEXT NOT NULL,
+  edge_type TEXT NOT NULL CHECK (edge_type IN ('causal', 'entity_link', 'temporal', 'association', 'supersedes')),
+  weight REAL NOT NULL DEFAULT 1.0,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_graph_edges_source ON graph_edges(project_id, source_id);
+CREATE INDEX IF NOT EXISTS idx_graph_edges_target ON graph_edges(project_id, target_id);
+
+-- 9. Proactive Contradiction Conflicts
+CREATE TABLE IF NOT EXISTS memory_conflicts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL,
+  memory_a_id TEXT NOT NULL,
+  memory_b_id TEXT NOT NULL,
+  reason TEXT NOT NULL,
+  score REAL NOT NULL,
+  status TEXT NOT NULL DEFAULT 'open' CHECK (status IN ('open', 'resolved', 'ignored')),
+  resolved_winner_id TEXT DEFAULT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  resolved_at TEXT DEFAULT NULL,
+  FOREIGN KEY (memory_a_id) REFERENCES memories(id) ON DELETE CASCADE,
+  FOREIGN KEY (memory_b_id) REFERENCES memories(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_conflicts_status ON memory_conflicts(project_id, status);
+
+-- 10. Planning Fallacy Predictions & Baserate
+CREATE TABLE IF NOT EXISTS predictions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL,
+  class_tag TEXT NOT NULL,
+  claim_text TEXT NOT NULL,
+  estimate_value REAL,
+  estimate_unit TEXT,
+  actual_value REAL DEFAULT NULL,
+  closure_state TEXT NOT NULL DEFAULT 'open' CHECK (closure_state IN ('open', 'closed', 'closed-unknown')),
+  closed_at TEXT DEFAULT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
+CREATE INDEX IF NOT EXISTS idx_predictions_class ON predictions(project_id, class_tag, closure_state);
+
+-- 11. Multi-Agent Work Item Action DAG
+CREATE TABLE IF NOT EXISTS actions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'active', 'done', 'blocked', 'cancelled')),
+  priority INTEGER NOT NULL DEFAULT 5,
+  assigned_to TEXT DEFAULT NULL,
+  crystallized_into TEXT DEFAULT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  completed_at TEXT DEFAULT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_actions_status ON actions(project_id, status, priority DESC);
+
+CREATE TABLE IF NOT EXISTS action_edges (
+  source_action_id TEXT NOT NULL,
+  target_action_id TEXT NOT NULL,
+  edge_type TEXT NOT NULL CHECK (edge_type IN ('requires', 'unlocks', 'conflicts_with')),
+  PRIMARY KEY (source_action_id, target_action_id, edge_type),
+  FOREIGN KEY (source_action_id) REFERENCES actions(id) ON DELETE CASCADE,
+  FOREIGN KEY (target_action_id) REFERENCES actions(id) ON DELETE CASCADE
+);
+
+-- 12. Bounded Working Memory Slots
+CREATE TABLE IF NOT EXISTS memory_slots (
+  project_id TEXT NOT NULL,
+  slot_key TEXT NOT NULL,
+  content TEXT NOT NULL,
+  size_limit INTEGER NOT NULL DEFAULT 4000,
+  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  PRIMARY KEY (project_id, slot_key)
+);
+
+-- 13. Multimodal Vision Assets & Screenshots
+CREATE TABLE IF NOT EXISTS vision_assets (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  description TEXT NOT NULL,
+  ocr_text TEXT DEFAULT NULL,
+  memory_id TEXT DEFAULT NULL,
+  task_id TEXT DEFAULT NULL,
+  embedding BLOB DEFAULT NULL,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE SET NULL,
+  FOREIGN KEY (task_id) REFERENCES actions(id) ON DELETE SET NULL
+);
+CREATE INDEX IF NOT EXISTS idx_vision_project ON vision_assets(project_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_vision_memory ON vision_assets(memory_id);
 `;
 export function configurePragmas(db) {
     try {
@@ -293,11 +293,11 @@ export function applySchema(db) {
     catch { }
     migrateMemoriesUpdateTrigger(db);
 }
-const MEMORIES_AU_TRIGGER_SQL = `
-CREATE TRIGGER memories_au AFTER UPDATE OF title, module, content ON memories BEGIN
-  DELETE FROM memories_fts WHERE id = old.id;
-  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
-END;
+const MEMORIES_AU_TRIGGER_SQL = `
+CREATE TRIGGER memories_au AFTER UPDATE OF title, module, content ON memories BEGIN
+  DELETE FROM memories_fts WHERE id = old.id;
+  INSERT INTO memories_fts(id, title, module, content) VALUES (new.id, new.title, new.module, new.content);
+END;
 `;
 /**
  * Older databases carry an unconditional AFTER UPDATE trigger that re-indexes FTS on every

package/dist/src/db/spool.js

@@ -97,10 +97,10 @@ export class SpoolManager {
         }
         if (events.length > 0) {
             try {
-                const insertStmt = db.prepare(`
-          INSERT OR IGNORE INTO raw_events (
-            id, project_id, session_id, agent_id, event_type, tool_name, file_path, raw_payload, content_hash, created_at
-          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, COALESCE(?, strftime('%Y-%m-%dT%H:%M:%SZ', 'now')))
+                const insertStmt = db.prepare(`
+          INSERT OR IGNORE INTO raw_events (
+            id, project_id, session_id, agent_id, event_type, tool_name, file_path, raw_payload, content_hash, created_at
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, COALESCE(?, strftime('%Y-%m-%dT%H:%M:%SZ', 'now')))
         `);
                 db.exec('BEGIN TRANSACTION');
                 try {

package/dist/src/export/obsidian.js

@@ -55,25 +55,25 @@ export function exportToObsidianVault(db, projectId, targetDir) {
         fs.mkdirSync(targetDir, { recursive: true });
     }
     // 1. Fetch active memories
-    const memories = db.prepare(`
-    SELECT id, kind, title, module, content, status, reward_score, created_at, valid_to
-    FROM memories
-    WHERE project_id = ?
-      AND (valid_to IS NULL OR valid_to = '')
-      AND status != 'superseded'
-    ORDER BY kind ASC, reward_score DESC, created_at DESC
+    const memories = db.prepare(`
+    SELECT id, kind, title, module, content, status, reward_score, created_at, valid_to
+    FROM memories
+    WHERE project_id = ?
+      AND (valid_to IS NULL OR valid_to = '')
+      AND status != 'superseded'
+    ORDER BY kind ASC, reward_score DESC, created_at DESC
   `).all(projectId);
     // 2. Fetch entities
-    const entities = db.prepare(`
-    SELECT id, name, entity_type
-    FROM entities
-    WHERE project_id = ?
-    ORDER BY name ASC
+    const entities = db.prepare(`
+    SELECT id, name, entity_type
+    FROM entities
+    WHERE project_id = ?
+    ORDER BY name ASC
   `).all(projectId);
     // 3. Fetch file links
-    const fileLinks = db.prepare(`
-    SELECT memory_id, file_path, symbol_name
-    FROM file_links
+    const fileLinks = db.prepare(`
+    SELECT memory_id, file_path, symbol_name
+    FROM file_links
   `).all();
     const memoryFilesMap = new Map();
     for (const fl of fileLinks) {

package/dist/src/import/local.js

@@ -125,10 +125,10 @@ export function parseMarkdownMemories(markdown) {
     });
 }
 function existsInProject(db, projectId, title, content) {
-    const row = db.prepare(`
-    SELECT id FROM memories
-    WHERE project_id = ? AND title = ? AND content = ? AND status != 'superseded'
-    LIMIT 1
+    const row = db.prepare(`
+    SELECT id FROM memories
+    WHERE project_id = ? AND title = ? AND content = ? AND status != 'superseded'
+    LIMIT 1
   `).get(projectId, title, content);
     return Boolean(row);
 }