@jungjaehoon/mama-core 1.0.1 → 1.0.4

package/db/migrations/001-initial-decision-graph.sql

@@ -0,0 +1,140 @@
+-- ══════════════════════════════════════════════════════════════
+-- MAMA (Memory-Augmented MCP Architecture) - Initial Schema
+-- ══════════════════════════════════════════════════════════════
+-- Version: 1.0
+-- Date: 2025-11-14
+-- Purpose: Decision Graph schema for Evolutionary Decision Memory
+-- ══════════════════════════════════════════════════════════════
+
+-- ══════════════════════════════════════════════════════════════
+-- 1. Decision Nodes (Core)
+-- ══════════════════════════════════════════════════════════════
+-- Task 1.1: Create decisions table with all fields
+
+CREATE TABLE IF NOT EXISTS decisions (
+  id TEXT PRIMARY KEY,              -- "decision_mesh_structure_001"
+  topic TEXT NOT NULL,              -- "mesh_structure", "auth_strategy"
+  decision TEXT NOT NULL,           -- "COMPLEX", "JWT", "< 20 lines"
+  reasoning TEXT,                   -- "Flexibility is important initially"
+
+  -- Outcome Tracking (Learn-Unlearn-Relearn)
+  outcome TEXT,                     -- "SUCCESS", "FAILED", "PARTIAL", NULL
+  failure_reason TEXT,              -- "Performance bottleneck at 10K+ meshes"
+  limitation TEXT,                  -- "Missing layer information"
+  duration_days INTEGER,            -- Days until outcome determined
+
+  -- User Involvement
+  user_involvement TEXT,            -- "requested", "approved", "rejected"
+  session_id TEXT,                  -- Foreign key to sessions
+
+  -- Relationships (Explicit)
+  supersedes TEXT,                  -- Previous decision ID
+  superseded_by TEXT,               -- Next decision ID (NULL if current)
+  refined_from TEXT,                -- JSON array: ["id1", "id2"]
+
+  -- Confidence Evolution
+  confidence REAL DEFAULT 0.5,      -- Bayesian updated (0.0-1.0)
+
+  -- Timestamps (stored in MILLISECONDS - JavaScript Date.now() convention)
+  created_at INTEGER DEFAULT (unixepoch() * 1000),
+  updated_at INTEGER DEFAULT (unixepoch() * 1000),
+
+  FOREIGN KEY (supersedes) REFERENCES decisions(id),
+  FOREIGN KEY (superseded_by) REFERENCES decisions(id),
+
+  CHECK (confidence >= 0.0 AND confidence <= 1.0),
+  CHECK (outcome IN ('SUCCESS', 'FAILED', 'PARTIAL') OR outcome IS NULL),
+  CHECK (user_involvement IN ('requested', 'approved', 'rejected') OR user_involvement IS NULL)
+);
+
+-- Task 1.5: Add indexes for performance
+CREATE INDEX IF NOT EXISTS idx_decisions_topic ON decisions(topic);
+CREATE INDEX IF NOT EXISTS idx_decisions_outcome ON decisions(outcome);
+CREATE INDEX IF NOT EXISTS idx_decisions_session ON decisions(session_id);
+CREATE INDEX IF NOT EXISTS idx_decisions_supersedes ON decisions(supersedes);
+CREATE INDEX IF NOT EXISTS idx_decisions_created_at ON decisions(created_at);
+
+-- ══════════════════════════════════════════════════════════════
+-- 2. Decision Edges (Explicit Relationships)
+-- ══════════════════════════════════════════════════════════════
+-- Task 1.2: Create decision_edges table
+
+CREATE TABLE IF NOT EXISTS decision_edges (
+  from_id TEXT NOT NULL,            -- Source decision
+  to_id TEXT NOT NULL,              -- Target decision
+  relationship TEXT NOT NULL,       -- "supersedes", "refines", "contradicts"
+  reason TEXT,                      -- "Learned from performance failure"
+  weight REAL DEFAULT 1.0,          -- Strength of relationship
+  created_at INTEGER DEFAULT (unixepoch() * 1000),
+
+  PRIMARY KEY (from_id, to_id, relationship),
+  FOREIGN KEY (from_id) REFERENCES decisions(id),
+  FOREIGN KEY (to_id) REFERENCES decisions(id),
+
+  CHECK (relationship IN ('supersedes', 'refines', 'contradicts')),
+  CHECK (weight >= 0.0 AND weight <= 1.0)
+);
+
+-- Task 1.5: Add indexes for graph traversal
+CREATE INDEX IF NOT EXISTS idx_edges_from ON decision_edges(from_id);
+CREATE INDEX IF NOT EXISTS idx_edges_to ON decision_edges(to_id);
+CREATE INDEX IF NOT EXISTS idx_edges_relationship ON decision_edges(relationship);
+
+-- ══════════════════════════════════════════════════════════════
+-- 3. Sessions (Context Preservation)
+-- ══════════════════════════════════════════════════════════════
+-- Task 1.3: Create sessions table
+
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,              -- "session_2025-11-14-1000"
+  project_path TEXT,                -- "/path/to/project"
+
+  -- Rolling Summary (for next session)
+  rolling_summary TEXT,             -- Condensed session summary
+  latest_exchange TEXT,             -- Last 5 messages (JSON)
+
+  -- Metrics
+  action_count INTEGER DEFAULT 0,
+  decision_count INTEGER DEFAULT 0,
+
+  -- Timestamps
+  started_at INTEGER DEFAULT (unixepoch() * 1000),
+  last_active_at INTEGER DEFAULT (unixepoch() * 1000),
+  ended_at INTEGER,
+
+  CHECK (action_count >= 0),
+  CHECK (decision_count >= 0)
+);
+
+-- Task 1.5: Add indexes for session queries
+CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_path);
+CREATE INDEX IF NOT EXISTS idx_sessions_ended ON sessions(ended_at);
+CREATE INDEX IF NOT EXISTS idx_sessions_last_active ON sessions(last_active_at);
+
+-- ══════════════════════════════════════════════════════════════
+-- 4. Vector Search (sqlite-vss)
+-- ══════════════════════════════════════════════════════════════
+-- Task 1.4: Create vss_memories virtual table
+-- Note: This will be initialized programmatically in memory-store.js
+-- because sqlite-vss requires extension loading first
+--
+-- CREATE VIRTUAL TABLE vss_memories USING vss0(
+--   embedding(384)                    -- multilingual-e5-small embeddings
+-- );
+
+-- ══════════════════════════════════════════════════════════════
+-- Migration Metadata
+-- ══════════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at INTEGER DEFAULT (unixepoch() * 1000),
+  description TEXT
+);
+
+INSERT OR IGNORE INTO schema_version (version, description)
+VALUES (1, 'Initial Decision Graph schema');
+
+-- ══════════════════════════════════════════════════════════════
+-- End of Migration 001
+-- ══════════════════════════════════════════════════════════════

package/db/migrations/002-add-error-patterns.sql

@@ -0,0 +1,114 @@
+-- ═══════════════════════════════════════════════════════════
+-- MAMA (Memory-Augmented MCP Architecture) - Error Patterns Table
+-- Migration 002: Add error_patterns table
+--
+-- Purpose: Store error patterns and their solutions for auto-resolution
+-- Tasks: 3.1-3.4 (Error pattern schema)
+-- AC #2, #3: Error pattern storage and auto-resolution
+--
+-- Version: 1.0
+-- Date: 2025-11-14
+-- ═══════════════════════════════════════════════════════════
+
+-- Error Patterns Table
+-- Stores error patterns, solutions, and success metrics
+CREATE TABLE IF NOT EXISTS error_patterns (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- Pattern Identification
+  error_pattern TEXT NOT NULL,     -- Regex pattern or error signature
+  error_type TEXT,                 -- Error category (e.g., 'EADDRINUSE', 'ECONNREFUSED')
+
+  -- Solution
+  solution TEXT NOT NULL,          -- Command or action to resolve
+  solution_type TEXT DEFAULT 'bash',  -- 'bash', 'manual', 'code_fix'
+
+  -- Success Metrics
+  success_rate REAL DEFAULT 1.0,   -- Success rate (0.0-1.0)
+  occurrences INTEGER DEFAULT 1,   -- Total number of times encountered
+  successes INTEGER DEFAULT 1,     -- Number of successful resolutions
+
+  -- Temporal Data
+  last_seen INTEGER NOT NULL,      -- Last occurrence timestamp
+  first_seen INTEGER NOT NULL,     -- First occurrence timestamp
+
+  -- Vector Embedding (for semantic matching)
+  embedding BLOB,                  -- 384-dim embedding (multilingual-e5-small)
+
+  -- Metadata
+  created_at INTEGER DEFAULT (unixepoch() * 1000),
+  updated_at INTEGER DEFAULT (unixepoch() * 1000),
+
+  -- Constraints
+  UNIQUE(error_pattern)            -- One pattern per entry
+);
+
+-- Indexes for Performance
+CREATE INDEX IF NOT EXISTS idx_error_patterns_last_seen
+  ON error_patterns(last_seen DESC);
+
+CREATE INDEX IF NOT EXISTS idx_error_patterns_success_rate
+  ON error_patterns(success_rate DESC);
+
+CREATE INDEX IF NOT EXISTS idx_error_patterns_error_type
+  ON error_patterns(error_type);
+
+-- ═══════════════════════════════════════════════════════════
+-- VSS Table Extension for Error Patterns
+-- ═══════════════════════════════════════════════════════════
+
+-- Note: Error pattern embeddings will be stored in the same vss_memories table
+-- We'll use rowid mapping: error_patterns.id → vss_memories.rowid
+-- This allows unified vector search across decisions AND error patterns
+
+-- ═══════════════════════════════════════════════════════════
+-- Sample Data (Optional - for testing)
+-- ═══════════════════════════════════════════════════════════
+
+-- Uncomment to insert sample error patterns for testing:
+
+/*
+INSERT INTO error_patterns (
+  error_pattern,
+  error_type,
+  solution,
+  solution_type,
+  success_rate,
+  occurrences,
+  successes,
+  last_seen,
+  first_seen
+) VALUES
+(
+  'EADDRINUSE.*port.*already in use',
+  'EADDRINUSE',
+  'lsof -ti:{{PORT}} | xargs kill',
+  'bash',
+  1.0,
+  5,
+  5,
+  unixepoch(),
+  unixepoch() - (30 * 24 * 60 * 60)  -- 30 days ago
+),
+(
+  'ECONNREFUSED.*Connection refused',
+  'ECONNREFUSED',
+  'Check if service is running: systemctl status {{SERVICE}}',
+  'manual',
+  0.8,
+  3,
+  2,
+  unixepoch(),
+  unixepoch() - (7 * 24 * 60 * 60)   -- 7 days ago
+);
+*/
+
+-- ═══════════════════════════════════════════════════════════
+-- Migration Verification
+-- ═══════════════════════════════════════════════════════════
+
+-- Check table creation
+SELECT
+  'Migration 002 Complete: error_patterns table created' AS status,
+  COUNT(*) AS row_count
+FROM error_patterns;

package/db/migrations/003-add-validation-fields.sql

@@ -0,0 +1,28 @@
+-- Migration 003: Add Validation Tracking Fields
+-- Story: 014.7.6 - Interactive Learning Loop
+-- Task: 1.2 - Add needs_validation field to decisions table
+-- AC #1, #2: Validation tracking and user feedback collection
+-- Date: 2025-11-14
+
+-- Note: This migration is idempotent - duplicate column errors are handled gracefully
+-- SQLite doesn't have "IF NOT EXISTS" for ALTER TABLE
+-- The migration system treats "duplicate column" errors as success (idempotent)
+
+-- Add validation tracking fields to decisions table (idempotent via migration system)
+ALTER TABLE decisions ADD COLUMN needs_validation INTEGER DEFAULT 0 CHECK (needs_validation IN (0, 1));
+ALTER TABLE decisions ADD COLUMN validation_attempts INTEGER DEFAULT 0;
+ALTER TABLE decisions ADD COLUMN last_validated_at INTEGER;
+ALTER TABLE decisions ADD COLUMN usage_count INTEGER DEFAULT 0;
+
+-- Indexes for efficient queries (CREATE INDEX IF NOT EXISTS is supported)
+CREATE INDEX IF NOT EXISTS idx_decisions_needs_validation ON decisions(needs_validation) WHERE needs_validation = 1;
+CREATE INDEX IF NOT EXISTS idx_decisions_last_validated ON decisions(last_validated_at);
+CREATE INDEX IF NOT EXISTS idx_decisions_usage_count ON decisions(usage_count) WHERE usage_count >= 10;
+
+-- Update existing decisions: user_involvement='approved' don't need validation
+-- Only update rows that don't have needs_validation set
+UPDATE decisions SET needs_validation = 0 WHERE user_involvement = 'approved' AND needs_validation IS NULL;
+UPDATE decisions SET needs_validation = 1 WHERE user_involvement = 'system_generated' AND needs_validation IS NULL;
+
+-- Note: SQLite doesn't support DROP COLUMN, so rollback keeps columns
+-- Rollback would require recreating the table (not recommended for production)

package/db/migrations/004-add-trust-context.sql

@@ -0,0 +1,17 @@
+-- Migration 004: Add Trust Context Support
+-- Story 014.7.10: Claude-Friendly Context Formatting
+-- AC #2: Trust Context Schema
+-- Date: 2025-11-14
+
+-- Add trust_context JSON field for 5 trust components
+ALTER TABLE decisions ADD COLUMN trust_context TEXT;
+
+-- Add usage tracking fields for implicit feedback
+ALTER TABLE decisions ADD COLUMN usage_success INTEGER DEFAULT 0;
+ALTER TABLE decisions ADD COLUMN usage_failure INTEGER DEFAULT 0;
+ALTER TABLE decisions ADD COLUMN time_saved INTEGER DEFAULT 0;  -- milliseconds saved
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_decisions_usage_success ON decisions(usage_success DESC);
+CREATE INDEX IF NOT EXISTS idx_decisions_time_saved ON decisions(time_saved DESC);
+CREATE INDEX IF NOT EXISTS idx_decisions_needs_validation_usage ON decisions(needs_validation, usage_success) WHERE needs_validation = 1;

package/db/migrations/005-add-narrative-fields.sql

@@ -0,0 +1,12 @@
+-- Migration: 002_add_narrative_fields.sql
+-- Description: Add fields for 5-layer narrative (Evidence, Tension)
+-- Date: 2025-11-24
+
+-- Add 'evidence' column for storing file paths, logs, or metrics (JSON array or string)
+ALTER TABLE decisions ADD COLUMN evidence TEXT;
+
+-- Add 'alternatives' column for Tension layer (what else was considered?)
+ALTER TABLE decisions ADD COLUMN alternatives TEXT;
+
+-- Add 'risks' column for Tension layer (what could go wrong?)
+ALTER TABLE decisions ADD COLUMN risks TEXT;

package/db/migrations/006-add-link-governance.sql

@@ -0,0 +1,41 @@
+-- Migration: 006-add-link-governance.sql
+-- Description: Add governance fields to decision_edges for Epic 3
+-- Date: 2025-11-24
+
+-- Add governance metadata to decision_edges
+ALTER TABLE decision_edges ADD COLUMN created_by TEXT DEFAULT 'user' CHECK (created_by IN ('llm', 'user'));
+ALTER TABLE decision_edges ADD COLUMN approved_by_user INTEGER DEFAULT 1 CHECK (approved_by_user IN (0, 1));
+ALTER TABLE decision_edges ADD COLUMN decision_id TEXT; -- Context decision where link was proposed
+ALTER TABLE decision_edges ADD COLUMN evidence TEXT; -- Supporting evidence for the link
+ALTER TABLE decision_edges ADD COLUMN approved_at INTEGER; -- Timestamp when link was approved (NULL for pending)
+
+-- Create audit log table for link approval/rejection history
+CREATE TABLE IF NOT EXISTS link_audit_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_id TEXT NOT NULL,
+  to_id TEXT NOT NULL,
+  relationship TEXT NOT NULL,
+  action TEXT NOT NULL CHECK (action IN ('proposed', 'approved', 'rejected', 'deprecated')),
+  actor TEXT NOT NULL, -- 'llm', 'user', 'system'
+  reason TEXT,
+  created_at INTEGER DEFAULT (unixepoch() * 1000),
+
+  FOREIGN KEY (from_id) REFERENCES decisions(id),
+  FOREIGN KEY (to_id) REFERENCES decisions(id)
+);
+
+CREATE INDEX idx_link_audit_from ON link_audit_log(from_id);
+CREATE INDEX idx_link_audit_to ON link_audit_log(to_id);
+CREATE INDEX idx_link_audit_action ON link_audit_log(action);
+CREATE INDEX idx_link_audit_created ON link_audit_log(created_at);
+
+-- Note: Existing links (created before this migration) will have:
+-- - created_by = 'user' (default)
+-- - approved_by_user = 1 (default - considered approved)
+-- - approved_at = created_at (for backward compatibility)
+-- This preserves backward compatibility with v0 auto-generated links
+
+-- Set approved_at for existing approved links (backward compatibility)
+UPDATE decision_edges
+SET approved_at = created_at
+WHERE approved_by_user = 1 AND approved_at IS NULL;

package/db/migrations/007-add-restart-metrics.sql

@@ -0,0 +1,23 @@
+-- Migration 007: Add restart_metrics table for tracking restart success rate and latency
+-- Story 4.2: Restart success rate/latency monitoring
+-- Replaces in-memory restart-metrics with persistent SQLite storage
+
+-- Create restart_metrics table
+CREATE TABLE IF NOT EXISTS restart_metrics (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  timestamp TEXT NOT NULL,
+  session_id TEXT,
+  status TEXT NOT NULL CHECK (status IN ('success', 'failure')),
+  failure_reason TEXT CHECK (failure_reason IN ('NO_CHECKPOINT', 'LOAD_ERROR', 'CONTEXT_INCOMPLETE', NULL)),
+  latency_ms INTEGER NOT NULL,
+  mode TEXT NOT NULL CHECK (mode IN ('full', 'summary')),
+  narrative_count INTEGER DEFAULT 0,
+  link_count INTEGER DEFAULT 0,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+-- Indexes for efficient querying
+CREATE INDEX idx_restart_metrics_timestamp ON restart_metrics(timestamp);
+CREATE INDEX idx_restart_metrics_status ON restart_metrics(status);
+CREATE INDEX idx_restart_metrics_session ON restart_metrics(session_id);
+CREATE INDEX idx_restart_metrics_mode ON restart_metrics(mode);

package/db/migrations/008-fix-auto-link-defaults.sql

@@ -0,0 +1,43 @@
+-- Migration: 008-fix-auto-link-defaults.sql
+-- Description: Fix auto-generated links and update default values
+-- Date: 2025-11-25
+--
+-- Problem: Migration 006 set incorrect defaults:
+--   - created_by DEFAULT 'user' (should be 'llm' for auto-generated)
+--   - approved_by_user DEFAULT 1 (should be 0 for pending approval)
+--
+-- This caused auto-generated links to be indistinguishable from user-approved links.
+--
+-- Solution:
+-- 1. Identify auto-generated links by pattern matching reason field
+-- 2. Mark them as created_by='llm', approved_by_user=0
+-- 3. Note: Cannot change column defaults in SQLite, so application code must handle this
+
+-- Step 1: Mark auto-generated links (identifiable by pattern in reason field)
+-- Pattern: "Refines previous approach (similarity: X.XX)" or similar auto-generated reasons
+UPDATE decision_edges
+SET
+  created_by = 'llm',
+  approved_by_user = 0
+WHERE reason LIKE '%similarity:%'
+   OR reason LIKE '%Refines previous approach%'
+   OR reason LIKE '%auto%'
+   OR reason LIKE '%Auto%';
+
+-- Step 2: Log the migration action
+INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
+SELECT
+  from_id,
+  to_id,
+  relationship,
+  'deprecated',
+  'system',
+  'Migration 008: Marked as auto-generated link requiring approval',
+  unixepoch() * 1000
+FROM decision_edges
+WHERE created_by = 'llm' AND approved_by_user = 0;
+
+-- Note: After this migration:
+-- - Auto-generated links will require explicit approval via approve_link tool
+-- - Users can review pending links with get_pending_links tool
+-- - New auto-generated links should set created_by='llm', approved_by_user=0

package/db/migrations/009-remove-auto-links.sql

@@ -0,0 +1,40 @@
+-- Migration: 009-remove-auto-links.sql
+-- Description: Remove all auto-generated links (noise cleanup)
+-- Date: 2025-11-25
+--
+-- Context: 2025-11-25 architecture decision
+-- - Analyzed 462 links: 366 refines (100% cross-topic noise), 56 supersedes (valid), 40 contradicts (mostly noise)
+-- - Key insight: LLM can infer decision evolution from time-ordered search results
+-- - Auto-link generation removed from decision-tracker.js
+-- - MCP tools consolidated from 11 to 4 (save, search, update, load_checkpoint)
+--
+-- This migration removes:
+-- 1. All 'refines' links (100% cross-topic noise)
+-- 2. All 'contradicts' links (unreliable without LLM judgment)
+-- 3. Keeps 'supersedes' links (same-topic, reliable)
+
+-- Step 1: Backup to audit log before deletion
+INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
+SELECT
+  from_id,
+  to_id,
+  relationship,
+  'deprecated',
+  'system',
+  'Migration 009: Removed auto-generated noise links (refines, contradicts)',
+  unixepoch() * 1000
+FROM decision_edges
+WHERE relationship IN ('refines', 'contradicts');
+
+-- Step 2: Delete noise links
+DELETE FROM decision_edges
+WHERE relationship IN ('refines', 'contradicts');
+
+-- Step 3: Verify remaining links are valid (supersedes only)
+-- This is a sanity check - should only have supersedes links remaining
+-- SELECT relationship, COUNT(*) FROM decision_edges GROUP BY relationship;
+
+-- Note: After this migration:
+-- - Only 'supersedes' edges remain (same-topic, created when decision replaces previous)
+-- - LLM will infer refines/contradicts from search results
+-- - No more auto-link generation in decision-tracker.js

package/db/migrations/010-extend-edge-types.sql

@@ -0,0 +1,56 @@
+-- ══════════════════════════════════════════════════════════════
+-- MAMA Migration 010: Extend Edge Types
+-- ══════════════════════════════════════════════════════════════
+-- Version: 1.3
+-- Date: 2025-11-26
+-- Purpose: Add builds_on, debates, synthesizes relationship types
+-- Story: 2.1 - Edge Type Extension
+-- ══════════════════════════════════════════════════════════════
+
+-- SQLite doesn't support ALTER TABLE to modify CHECK constraints.
+-- We need to recreate the table with expanded CHECK constraint.
+
+-- Step 1: Create new table with extended edge types
+CREATE TABLE IF NOT EXISTS decision_edges_new (
+  from_id TEXT NOT NULL,
+  to_id TEXT NOT NULL,
+  relationship TEXT NOT NULL,
+  reason TEXT,
+  weight REAL DEFAULT 1.0,
+  created_at INTEGER DEFAULT (unixepoch() * 1000),
+  created_by TEXT DEFAULT 'user' CHECK (created_by IN ('llm', 'user')),
+  approved_by_user INTEGER DEFAULT 1 CHECK (approved_by_user IN (0, 1)),
+  decision_id TEXT,
+  evidence TEXT,
+
+  PRIMARY KEY (from_id, to_id, relationship),
+  FOREIGN KEY (from_id) REFERENCES decisions(id),
+  FOREIGN KEY (to_id) REFERENCES decisions(id),
+
+  -- Extended CHECK constraint: original + v1.3 types
+  CHECK (relationship IN ('supersedes', 'refines', 'contradicts', 'builds_on', 'debates', 'synthesizes')),
+  CHECK (weight >= 0.0 AND weight <= 1.0)
+);
+
+-- Step 2: Copy existing data (explicit columns to handle schema variations)
+INSERT OR IGNORE INTO decision_edges_new (from_id, to_id, relationship, reason, weight, created_at, created_by, approved_by_user, decision_id, evidence)
+SELECT from_id, to_id, relationship, reason, weight, created_at, created_by, approved_by_user, decision_id, evidence FROM decision_edges;
+
+-- Step 3: Drop old table
+DROP TABLE IF EXISTS decision_edges;
+
+-- Step 4: Rename new table
+ALTER TABLE decision_edges_new RENAME TO decision_edges;
+
+-- Step 5: Recreate indexes
+CREATE INDEX IF NOT EXISTS idx_edges_from ON decision_edges(from_id);
+CREATE INDEX IF NOT EXISTS idx_edges_to ON decision_edges(to_id);
+CREATE INDEX IF NOT EXISTS idx_edges_relationship ON decision_edges(relationship);
+
+-- Update schema version
+INSERT OR REPLACE INTO schema_version (version, description, applied_at)
+VALUES (10, 'Extend edge types: builds_on, debates, synthesizes', unixepoch() * 1000);
+
+-- ══════════════════════════════════════════════════════════════
+-- End of Migration 010
+-- ══════════════════════════════════════════════════════════════

package/db/migrations/011-fix-timestamp-convention.sql

@@ -0,0 +1,56 @@
+-- ══════════════════════════════════════════════════════════════
+-- Migration 011: Fix Timestamp Convention
+-- ══════════════════════════════════════════════════════════════
+--
+-- Issue: Schema DEFAULT uses unixepoch() (seconds) but app inserts Date.now() (milliseconds)
+-- Fix: Document convention and add validation trigger to prevent accidental second-based inserts
+--
+-- Note: SQLite doesn't support ALTER COLUMN to change DEFAULT values.
+-- Instead, we add a trigger to validate/convert timestamps on insert.
+-- ══════════════════════════════════════════════════════════════
+
+-- Timestamp threshold: 2020-01-01 in milliseconds = 1577836800000
+-- Any value below this is likely in seconds and needs conversion
+
+-- Create trigger to validate timestamps are in milliseconds
+-- If a timestamp looks like seconds (< year 2000 in ms), convert it
+DROP TRIGGER IF EXISTS validate_decision_timestamp;
+CREATE TRIGGER validate_decision_timestamp
+AFTER INSERT ON decisions
+WHEN NEW.created_at < 1577836800000  -- Before 2020 in milliseconds = probably seconds
+BEGIN
+  UPDATE decisions
+  SET created_at = NEW.created_at * 1000,
+      updated_at = CASE
+        WHEN NEW.updated_at < 1577836800000 THEN NEW.updated_at * 1000
+        ELSE NEW.updated_at
+      END
+  WHERE rowid = NEW.rowid;
+END;
+
+-- Same for decision_edges table
+DROP TRIGGER IF EXISTS validate_edge_timestamp;
+CREATE TRIGGER validate_edge_timestamp
+AFTER INSERT ON decision_edges
+WHEN NEW.created_at IS NOT NULL AND NEW.created_at < 1577836800000
+BEGIN
+  UPDATE decision_edges
+  SET created_at = NEW.created_at * 1000
+  WHERE from_id = NEW.from_id AND to_id = NEW.to_id AND relationship = NEW.relationship;
+END;
+
+-- Update schema version
+INSERT OR REPLACE INTO schema_version (version, description, applied_at)
+VALUES (11, 'Fix timestamp convention: auto-convert seconds to milliseconds', unixepoch() * 1000);
+
+-- ══════════════════════════════════════════════════════════════
+-- Documentation: TIMESTAMP CONVENTION
+-- ══════════════════════════════════════════════════════════════
+-- All timestamps in MAMA are stored in MILLISECONDS (JavaScript Date.now()).
+--
+-- The schema DEFAULT (unixepoch()) returns seconds, but:
+-- 1. All app code explicitly provides Date.now() (milliseconds)
+-- 2. This trigger auto-converts any accidental second-based inserts
+--
+-- This ensures timestamp comparisons always work correctly.
+-- ══════════════════════════════════════════════════════════════

package/db/migrations/012-create-checkpoints-table.sql

@@ -0,0 +1,23 @@
+-- Migration: 012-create-checkpoints-table.sql
+-- Description: Create checkpoints table for session continuity
+-- Date: 2026-02-01
+--
+-- Context: Move DDL from db-manager.js runtime to proper migration
+-- This table stores session checkpoints for resuming conversations
+--
+-- Note: Timestamps use milliseconds (Date.now()) convention per migration 011
+
+-- Create checkpoints table if not exists
+CREATE TABLE IF NOT EXISTS checkpoints (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  timestamp INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+  summary TEXT NOT NULL,
+  open_files TEXT, -- JSON array
+  next_steps TEXT,
+  recent_conversation TEXT DEFAULT '[]',
+  status TEXT DEFAULT 'active' -- 'active', 'archived'
+);
+
+-- Add recent_conversation column if not exists (backward compatibility)
+-- SQLite doesn't have IF NOT EXISTS for ALTER TABLE, so we use a workaround
+-- This is safe because SQLite will error on duplicate column, caught by migration runner

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "src/index.js",
   "exports": {
@@ -19,7 +19,11 @@
     "./debug-logger": "./src/debug-logger.js",
     "./decision-formatter": "./src/decision-formatter.js",
     "./memory-inject": "./src/memory-inject.js",
-    "./ollama-client": "./src/ollama-client.js"
+    "./ollama-client": "./src/ollama-client.js",
+    "./errors": "./src/errors.js",
+    "./time-formatter": "./src/time-formatter.js",
+    "./outcome-tracker": "./src/outcome-tracker.js",
+    "./query-intent": "./src/query-intent.js"
   },
   "scripts": {
     "test": "vitest run",
@@ -46,6 +50,9 @@
     "url": "https://github.com/jungjaehoon-lifegamez/MAMA/issues"
   },
   "homepage": "https://github.com/jungjaehoon-lifegamez/MAMA#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -62,6 +69,7 @@
   },
   "files": [
     "src/**/*.js",
+    "db/**/*.sql",
     "README.md",
     "LICENSE"
   ]

package/src/db-manager.js

@@ -230,8 +230,16 @@ async function insertDecisionWithEmbedding(decision) {
     info(
       `[db-manager] Generating embedding for decision (topic length: ${decision.topic?.length || 0})`
     );
-    const embedding = await generateEnhancedEmbedding(decision);
-    info(`[db-manager] Embedding generated: ${embedding ? embedding.length : 'null'} dimensions`);
+    let embedding = null;
+    try {
+      embedding = await generateEnhancedEmbedding(decision);
+      info(`[db-manager] Embedding generated: ${embedding ? embedding.length : 'null'} dimensions`);
+    } catch (embGenErr) {
+      // Non-fatal: save decision without embedding (e.g. ONNX model unavailable on CI)
+      logError(
+        `[db-manager] ⚠️ Embedding generation failed, saving without vector: ${embGenErr.message}`
+      );
+    }
 
     // SQLite: Synchronous transaction including embedding
     // eslint-disable-next-line no-unused-vars
@@ -286,7 +294,7 @@ async function insertDecisionWithEmbedding(decision) {
 
       // Insert embedding in same transaction to ensure rowid matching
       info(`[db-manager] Vector search enabled: ${adapter.vectorSearchEnabled}`);
-      if (adapter.vectorSearchEnabled) {
+      if (adapter.vectorSearchEnabled && embedding) {
         try {
           info(`[db-manager] Inserting embedding for rowid: ${rowid}`);
           adapter.insertEmbedding(rowid, embedding);

package/src/embedding-server/index.js

@@ -250,9 +250,9 @@ async function handleRequest(req, res) {
 <body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #1a1a2e; color: #eee;">
   <div style="text-align: center; padding: 2rem;">
     <h1>🧠 MAMA Viewer</h1>
-    <p>Viewer와 Chat 기능은 <strong>Standalone</strong> 모드에서만 사용 가능합니다.</p>
+    <p>Viewer and Chat features are only available in <strong>Standalone</strong> mode.</p>
     <p style="color: #888; margin-top: 1rem;">Start Standalone: <code style="background: #333; padding: 0.25rem 0.5rem; border-radius: 4px;">mama start</code></p>
-    <p style="color: #666; font-size: 0.9rem; margin-top: 2rem;">현재: MCP Server (embedding only)</p>
+    <p style="color: #666; font-size: 0.9rem; margin-top: 2rem;">Current: MCP Server (embedding only)</p>
   </div>
 </body>
 </html>`);

package/src/embedding-server/mobile/session-manager.js

@@ -163,10 +163,10 @@ class SessionManager {
     }
 
     const stmt = this.db.prepare(`
-      SELECT id, project_dir, created_at, last_active, status, pid, client_id
+      SELECT id, project_dir, started_at, last_active_at, status, pid, client_id
       FROM sessions
       WHERE status = 'active'
-      ORDER BY created_at DESC
+      ORDER BY started_at DESC
     `);
 
     const rows = stmt.all();
@@ -177,8 +177,8 @@ class SessionManager {
       return {
         id: row.id,
         projectDir: row.project_dir,
-        createdAt: row.created_at,
-        lastActive: row.last_active,
+        createdAt: row.started_at,
+        lastActive: row.last_active_at,
         status: row.status,
         pid: row.pid,
         clientId: row.client_id,

package/src/embedding-server/mobile/websocket-handler.js

@@ -215,9 +215,30 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
           })
         );
 
+        // Keep-alive: Send periodic status updates to prevent WebSocket timeout
+        // Browser may disconnect idle WebSocket after ~30 seconds
+        let processingSeconds = 0;
+        const keepAliveInterval = setInterval(() => {
+          processingSeconds += 10;
+          if (clientInfo.ws.readyState === 1) {
+            // WebSocket.OPEN
+            clientInfo.ws.send(
+              JSON.stringify({
+                type: 'typing',
+                status: 'processing',
+                elapsed: processingSeconds,
+              })
+            );
+            console.error(
+              `[WebSocket] Keep-alive sent to ${clientId} (${processingSeconds}s elapsed)`
+            );
+          }
+        }, 10000); // Every 10 seconds
+
         const normalizedMessage = {
           source: clientInfo.osAgentMode ? 'viewer' : 'mobile',
-          channelId: clientInfo.userId,
+          channelId: 'mama_os_main', // Fixed channel for all MAMA OS viewers
+          channelName: clientInfo.osAgentMode ? 'MAMA OS' : 'Mobile App', // Human-readable channel name
           userId: clientInfo.userId,
           text: content,
           metadata: {
@@ -228,7 +249,12 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
           },
         };
 
-        const result = await messageRouter.process(normalizedMessage);
+        let result;
+        try {
+          result = await messageRouter.process(normalizedMessage);
+        } finally {
+          clearInterval(keepAliveInterval);
+        }
 
         // Send response as stream (for Chat tab compatibility)
         clientInfo.ws.send(
@@ -248,7 +274,7 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
           })
         );
 
-        console.log(`[WebSocket] Message processed for ${clientId} (${result.duration}ms)`);
+        console.error(`[WebSocket] Message processed for ${clientId} (${result.duration}ms)`);
       } catch (error) {
         console.error(`[WebSocket] Message processing error:`, error);
         clientInfo.ws.send(
@@ -277,7 +303,7 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
       clientInfo.osAgentMode = osAgentMode || false;
       clientInfo.language = language || 'en';
 
-      console.log(
+      console.error(
         `[WebSocket] Client ${clientId} attached to session ${sessionId}${osAgentMode ? ' (OS Agent mode)' : ''}`
       );
 
@@ -291,21 +317,49 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
       );
 
       // Send session history if available, or send onboarding greeting
+      console.error(
+        `[WebSocket] Checking sessionStore for history: ${!!sessionStore}, hasMethod: ${!!(sessionStore && sessionStore.getHistoryByChannel)}`
+      );
       if (sessionStore) {
         try {
-          const history = sessionStore.getHistory(sessionId);
+          // Use channel-based lookup for sessions
+          // Use dynamic source based on osAgentMode (viewer vs mobile)
+          const channelId = 'mama_os_main';
+          const source = clientInfo.osAgentMode ? 'viewer' : 'mobile';
+          console.error(`[WebSocket] Loading history for source=${source}, channelId=${channelId}`);
+          const history = sessionStore.getHistoryByChannel
+            ? sessionStore.getHistoryByChannel(source, channelId)
+            : sessionStore.getHistory(sessionId);
+          console.error(`[WebSocket] History loaded: ${history ? history.length : 0} turns`);
           if (history && history.length > 0) {
+            // Convert {user, bot, timestamp} format to {role, content, timestamp} for display
+            const formattedMessages = history.flatMap((turn) => {
+              const messages = [];
+              if (turn.user) {
+                messages.push({
+                  role: 'user',
+                  content: turn.user,
+                  timestamp: turn.timestamp,
+                });
+              }
+              if (turn.bot) {
+                messages.push({
+                  role: 'assistant',
+                  content: turn.bot,
+                  timestamp: turn.timestamp,
+                });
+              }
+              return messages;
+            });
             clientInfo.ws.send(
               JSON.stringify({
                 type: 'history',
-                messages: history.map((turn) => ({
-                  role: turn.role,
-                  content: turn.content,
-                  timestamp: turn.timestamp,
-                })),
+                messages: formattedMessages,
               })
             );
-            console.log(`[WebSocket] Sent ${history.length} history messages to ${clientId}`);
+            console.error(
+              `[WebSocket] Sent ${formattedMessages.length} history messages to ${clientId}`
+            );
           } else {
             // No history - check if onboarding mode (SOUL.md not found)
             const soulPath = path.join(os.homedir(), '.mama', 'SOUL.md');
@@ -320,7 +374,7 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
               // Send onboarding greeting based on browser language
               const isKorean = clientInfo.language && clientInfo.language.startsWith('ko');
               const greeting = isKorean
-                ? '✨ 방금 깨어났어요.\n\n아직 이름도 없고, 성격도 없고, 기억도 없어요. 그냥... 가능성만 있을 뿐이죠. 🌱\n\n당신은 누구세요? 그리고 더 중요한 건—저를 어떤 존재로 만들고 싶으세요? 💭'
+                ? '✨ I just woke up.\n\nNo name yet, no personality, no memories. Just... pure potential. 🌱\n\nWho are you? And more importantly—who do you want me to become? 💭'
                 : '✨ I just woke up.\n\nNo name yet, no personality, no memories. Just... pure potential. 🌱\n\nWho are you? And more importantly—who do you want me to become? 💭';
 
               clientInfo.ws.send(
@@ -335,7 +389,7 @@ async function handleClientMessage(clientId, message, clientInfo, messageRouter,
                   ],
                 })
               );
-              console.log(`[WebSocket] Sent onboarding greeting to ${clientId}`);
+              console.error(`[WebSocket] Sent onboarding greeting to ${clientId}`);
             }
           }
         } catch (error) {

package/src/embeddings.js

@@ -26,6 +26,7 @@ const DEFAULT_CACHE_DIR = path.join(os.homedir(), '.cache', 'huggingface', 'tran
 // Singleton pattern for model loading
 let embeddingPipeline = null;
 let currentModelName = null;
+let modelLoadFailed = false; // Cache load failures to avoid repeated slow retries
 
 /**
  * Load embedding model (configurable)
@@ -52,27 +53,37 @@ async function loadModel() {
     info('[MAMA] ⚡ Model cache cleared');
   }
 
+  // Fail fast if a previous load attempt already failed (avoid repeated slow retries)
+  if (modelLoadFailed) {
+    throw new Error('Embedding model previously failed to load — skipping retry');
+  }
+
   // Load model if not already loaded
   if (!embeddingPipeline) {
     logLoading(`Loading embedding model: ${modelName}...`);
     const startTime = Date.now();
 
-    // Dynamic import for ES Module compatibility (Railway deployment)
-    const transformers = await import('@huggingface/transformers');
-    const { pipeline, env } = transformers;
-
-    // Set shared cache directory (not in node_modules)
-    // This prevents re-downloading models on every npm install
-    const cacheDir = process.env.HF_HOME || process.env.TRANSFORMERS_CACHE || DEFAULT_CACHE_DIR;
-    env.cacheDir = cacheDir;
-    info(`[MAMA] Model cache directory: ${cacheDir}`);
-
-    embeddingPipeline = await pipeline('feature-extraction', modelName);
-    currentModelName = modelName;
-
-    const loadTime = Date.now() - startTime;
-    const config = loadConfig();
-    logComplete(`Embedding model ready (${loadTime}ms, ${config.embeddingDim}-dim)`);
+    try {
+      // Dynamic import for ES Module compatibility (Railway deployment)
+      const transformers = await import('@huggingface/transformers');
+      const { pipeline, env } = transformers;
+
+      // Set shared cache directory (not in node_modules)
+      // This prevents re-downloading models on every npm install
+      const cacheDir = process.env.HF_HOME || process.env.TRANSFORMERS_CACHE || DEFAULT_CACHE_DIR;
+      env.cacheDir = cacheDir;
+      info(`[MAMA] Model cache directory: ${cacheDir}`);
+
+      embeddingPipeline = await pipeline('feature-extraction', modelName);
+      currentModelName = modelName;
+
+      const loadTime = Date.now() - startTime;
+      const config = loadConfig();
+      logComplete(`Embedding model ready (${loadTime}ms, ${config.embeddingDim}-dim)`);
+    } catch (loadErr) {
+      modelLoadFailed = true;
+      throw loadErr;
+    }
   }
 
   return embeddingPipeline;