get-claudia 1.51.4 → 1.51.6

package/cli/commands/google-auth.js

@@ -9,6 +9,7 @@
  *   claudia gmail status     - Check Gmail connection status
  *   claudia gmail search     - Search emails
  *   claudia gmail read       - Read a specific email
+ *   claudia gmail send       - Send an email with optional attachments
  *   claudia gmail logout     - Sign out of Gmail
  *   claudia calendar login   - Sign in with Google (Calendar only)
  *   claudia calendar status  - Check Calendar connection status
@@ -18,9 +19,146 @@
  *   claudia calendar logout  - Sign out of Calendar
  */
 
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { basename, extname } from 'node:path';
+import { randomBytes } from 'node:crypto';
 import { authenticate, getAccessToken, isAuthenticated, revokeTokens, authStatus } from '../core/google-oauth.js';
 import { outputJson as output } from '../core/output.js';
 
+// ── MIME Helpers (for gmail send) ──
+
+const MIME_TYPES = {
+  png: 'image/png',
+  jpg: 'image/jpeg',
+  jpeg: 'image/jpeg',
+  gif: 'image/gif',
+  webp: 'image/webp',
+  svg: 'image/svg+xml',
+  pdf: 'application/pdf',
+  txt: 'text/plain',
+  csv: 'text/csv',
+  json: 'application/json',
+  xml: 'application/xml',
+  html: 'text/html',
+  zip: 'application/zip',
+  gz: 'application/gzip',
+  doc: 'application/msword',
+  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+  xls: 'application/vnd.ms-excel',
+  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+  ppt: 'application/vnd.ms-powerpoint',
+  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+  mp3: 'audio/mpeg',
+  mp4: 'video/mp4',
+  wav: 'audio/wav',
+};
+
+function getMimeType(filePath) {
+  const ext = extname(filePath).toLowerCase().replace('.', '');
+  return MIME_TYPES[ext] || 'application/octet-stream';
+}
+
+/**
+ * Validate and read attachment files from disk.
+ * @param {string[]} filePaths
+ * @returns {Array<{path: string, data: Buffer, mimeType: string, filename: string}>}
+ */
+function prepareAttachments(filePaths) {
+  const MAX_SIZE = 25 * 1024 * 1024; // 25 MB Gmail limit
+  const attachments = [];
+
+  for (const filePath of filePaths) {
+    if (!existsSync(filePath)) {
+      throw new Error(`Attachment not found: ${filePath}`);
+    }
+    const stat = statSync(filePath);
+    if (!stat.isFile()) {
+      throw new Error(`Not a file: ${filePath}`);
+    }
+    if (stat.size > MAX_SIZE) {
+      throw new Error(`File too large (${(stat.size / 1024 / 1024).toFixed(1)} MB, max 25 MB): ${filePath}`);
+    }
+    attachments.push({
+      path: filePath,
+      data: readFileSync(filePath),
+      mimeType: getMimeType(filePath),
+      filename: basename(filePath),
+    });
+  }
+  return attachments;
+}
+
+/**
+ * Build an RFC 2822 MIME message string.
+ * @param {Object} opts
+ * @param {string[]} opts.to
+ * @param {string} opts.subject
+ * @param {string} opts.body
+ * @param {string[]} [opts.cc]
+ * @param {string[]} [opts.bcc]
+ * @param {boolean} [opts.html]
+ * @param {string} [opts.replyTo] - Message-ID for In-Reply-To/References
+ * @param {Array} [opts.attachments] - From prepareAttachments()
+ * @returns {string}
+ */
+function buildMimeMessage(opts) {
+  const lines = [];
+
+  // Headers
+  lines.push(`To: ${opts.to.join(', ')}`);
+  lines.push(`Subject: ${opts.subject}`);
+  lines.push('MIME-Version: 1.0');
+  if (opts.cc && opts.cc.length) lines.push(`Cc: ${opts.cc.join(', ')}`);
+  if (opts.bcc && opts.bcc.length) lines.push(`Bcc: ${opts.bcc.join(', ')}`);
+
+  if (opts.replyTo) {
+    const msgId = opts.replyTo.startsWith('<') ? opts.replyTo : `<${opts.replyTo}>`;
+    lines.push(`In-Reply-To: ${msgId}`);
+    lines.push(`References: ${msgId}`);
+  }
+
+  const hasAttachments = opts.attachments && opts.attachments.length > 0;
+  const contentType = opts.html ? 'text/html; charset=UTF-8' : 'text/plain; charset=UTF-8';
+
+  if (!hasAttachments) {
+    // Simple single-part message
+    lines.push(`Content-Type: ${contentType}`);
+    lines.push('Content-Transfer-Encoding: base64');
+    lines.push(''); // blank line separating headers from body
+    lines.push(Buffer.from(opts.body, 'utf-8').toString('base64'));
+  } else {
+    // Multipart/mixed
+    const boundary = `claudia_${randomBytes(16).toString('hex')}`;
+    lines.push(`Content-Type: multipart/mixed; boundary="${boundary}"`);
+    lines.push('');
+
+    // Text part
+    lines.push(`--${boundary}`);
+    lines.push(`Content-Type: ${contentType}`);
+    lines.push('Content-Transfer-Encoding: base64');
+    lines.push('');
+    lines.push(Buffer.from(opts.body, 'utf-8').toString('base64'));
+    lines.push('');
+
+    // Attachment parts
+    for (const att of opts.attachments) {
+      lines.push(`--${boundary}`);
+      lines.push(`Content-Type: ${att.mimeType}; name="${att.filename}"`);
+      lines.push(`Content-Disposition: attachment; filename="${att.filename}"`);
+      lines.push('Content-Transfer-Encoding: base64');
+      lines.push('');
+      // Split base64 into 76-char lines per RFC 2045
+      const b64 = att.data.toString('base64');
+      lines.push((b64.match(/.{1,76}/g) || []).join('\r\n'));
+      lines.push('');
+    }
+
+    lines.push(`--${boundary}--`);
+  }
+
+  return lines.join('\r\n');
+}
+
 // ── Gmail Commands ──
 
 export async function gmailLoginCommand() {
@@ -146,6 +284,90 @@ export async function gmailReadCommand(messageId) {
   });
 }
 
+export async function gmailSendCommand(opts) {
+  const token = await getAccessToken('gmail');
+  if (!token) {
+    console.error('Not authenticated. Run: claudia gmail login');
+    process.exitCode = 1;
+    return;
+  }
+
+  // Validate required fields (belt-and-suspenders; Commander's requiredOption catches most)
+  if (!opts.to || opts.to.length === 0) {
+    console.error('At least one --to recipient is required.');
+    process.exitCode = 1;
+    return;
+  }
+  if (!opts.subject) {
+    console.error('--subject is required.');
+    process.exitCode = 1;
+    return;
+  }
+  if (!opts.body) {
+    console.error('--body is required.');
+    process.exitCode = 1;
+    return;
+  }
+
+  // Prepare attachments
+  let attachments = [];
+  if (opts.attach && opts.attach.length > 0) {
+    try {
+      attachments = prepareAttachments(opts.attach);
+    } catch (err) {
+      console.error(err.message);
+      process.exitCode = 1;
+      return;
+    }
+  }
+
+  // Build MIME message and base64url-encode it
+  const rawMessage = buildMimeMessage({
+    to: opts.to,
+    subject: opts.subject,
+    body: opts.body,
+    cc: opts.cc,
+    bcc: opts.bcc,
+    html: opts.html,
+    replyTo: opts.replyTo,
+    attachments,
+  });
+
+  const encodedMessage = Buffer.from(rawMessage, 'utf-8')
+    .toString('base64')
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=+$/, '');
+
+  const requestBody = { raw: encodedMessage };
+  if (opts.thread) {
+    requestBody.threadId = opts.thread;
+  }
+
+  const resp = await fetch('https://gmail.googleapis.com/gmail/v1/users/me/messages/send', {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(requestBody),
+  });
+
+  if (!resp.ok) {
+    const err = await resp.text();
+    console.error(`Gmail API error (${resp.status}): ${err}`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const data = await resp.json();
+  output({
+    id: data.id,
+    threadId: data.threadId,
+    labelIds: data.labelIds || [],
+  });
+}
+
 export async function gmailLogoutCommand() {
   const removed = revokeTokens('gmail');
   if (removed) {

package/cli/core/database.js

@@ -901,7 +901,7 @@ class ClaudiaDatabase {
         "ALTER TABLE memories ADD COLUMN lifecycle_tier TEXT DEFAULT 'active'",
         'ALTER TABLE memories ADD COLUMN sacred_reason TEXT',
         'ALTER TABLE memories ADD COLUMN archived_at TEXT',
-        'ALTER TABLE memories ADD COLUMN fact_id TEXT UNIQUE',
+        'ALTER TABLE memories ADD COLUMN fact_id TEXT',
         'ALTER TABLE memories ADD COLUMN hash TEXT',
         'ALTER TABLE memories ADD COLUMN prev_hash TEXT',
         'ALTER TABLE entities ADD COLUMN close_circle BOOLEAN DEFAULT FALSE',
@@ -920,7 +920,7 @@ class ClaudiaDatabase {
           'CREATE INDEX IF NOT EXISTS idx_memories_lifecycle ON memories(lifecycle_tier)'
         );
         this.db.exec(
-          'CREATE INDEX IF NOT EXISTS idx_memories_fact_id ON memories(fact_id)'
+          'CREATE UNIQUE INDEX IF NOT EXISTS idx_memories_fact_id ON memories(fact_id)'
         );
         this.db.exec(
           'CREATE INDEX IF NOT EXISTS idx_entities_close_circle ON entities(close_circle) WHERE close_circle = 1'

package/cli/index.js

@@ -522,7 +522,7 @@ program
 // ── Gmail subcommand group ──
 const gmail = program
   .command('gmail')
-  .description('Gmail integration (login, search, read)');
+  .description('Gmail integration (login, search, read, send)');
 
 gmail
   .command('login')
@@ -559,6 +559,23 @@ gmail
     await gmailReadCommand(messageId);
   });
 
+gmail
+  .command('send')
+  .description('Send an email (with optional attachments)')
+  .requiredOption('--to <email...>', 'Recipient email address(es)')
+  .requiredOption('--subject <text>', 'Email subject')
+  .requiredOption('--body <text>', 'Email body text')
+  .option('--cc <email...>', 'CC recipient(s)')
+  .option('--bcc <email...>', 'BCC recipient(s)')
+  .option('--attach <filepath...>', 'File(s) to attach')
+  .option('--html', 'Treat body as HTML', false)
+  .option('--thread <threadId>', 'Thread ID (for replies)')
+  .option('--reply-to <messageId>', 'Message-ID for In-Reply-To header')
+  .action(async (opts) => {
+    const { gmailSendCommand } = await import('./commands/google-auth.js');
+    await gmailSendCommand(opts);
+  });
+
 gmail
   .command('logout')
   .description('Sign out of Gmail (remove stored tokens)')

package/memory-daemon/claudia_memory/schema.sql

@@ -0,0 +1,477 @@
+-- Claudia Memory System Schema
+-- SQLite with sqlite-vec for vector similarity search
+-- WAL mode enabled for crash safety
+
+-- Enable WAL mode for crash safety
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+PRAGMA foreign_keys = ON;
+
+-- ============================================================================
+-- ENTITIES: People, organizations, projects, concepts
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS entities (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    type TEXT NOT NULL CHECK (type IN ('person', 'organization', 'project', 'concept', 'location')),
+    canonical_name TEXT,  -- Normalized name for matching (lowercase, no titles)
+    description TEXT,
+    importance REAL DEFAULT 1.0,  -- Decays over time but never deleted
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now')),
+    metadata TEXT,  -- JSON blob for flexible attributes
+    last_contact_at TEXT,  -- Last time user interacted with this entity
+    contact_frequency_days REAL,  -- Average days between contacts (rolling)
+    contact_trend TEXT,  -- accelerating, stable, decelerating, dormant
+    attention_tier TEXT DEFAULT 'standard',  -- active, watchlist, standard, archive
+    close_circle BOOLEAN DEFAULT FALSE,  -- Inner circle: never decay, auto-sacred
+    close_circle_reason TEXT,  -- Why this entity is close-circle
+    UNIQUE(canonical_name, type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type);
+CREATE INDEX IF NOT EXISTS idx_entities_canonical ON entities(canonical_name);
+CREATE INDEX IF NOT EXISTS idx_entities_importance ON entities(importance DESC);
+CREATE INDEX IF NOT EXISTS idx_entities_last_contact ON entities(last_contact_at);
+CREATE INDEX IF NOT EXISTS idx_entities_trend ON entities(contact_trend);
+CREATE INDEX IF NOT EXISTS idx_entities_attention_tier ON entities(attention_tier);
+CREATE INDEX IF NOT EXISTS idx_entities_close_circle ON entities(close_circle) WHERE close_circle = 1;
+
+-- Entity aliases for matching variations (e.g., "Sarah", "Sarah Chen", "S. Chen")
+CREATE TABLE IF NOT EXISTS entity_aliases (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    alias TEXT NOT NULL,
+    canonical_alias TEXT NOT NULL,  -- Normalized for matching
+    created_at TEXT DEFAULT (datetime('now')),
+    UNIQUE(entity_id, canonical_alias)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_aliases_canonical ON entity_aliases(canonical_alias);
+
+-- ============================================================================
+-- MEMORIES: Facts, preferences, observations, learnings
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS memories (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    content TEXT NOT NULL,
+    content_hash TEXT UNIQUE,  -- SHA256 for deduplication
+    type TEXT NOT NULL CHECK (type IN ('fact', 'preference', 'observation', 'learning', 'commitment', 'pattern')),
+    importance REAL DEFAULT 1.0,  -- Decays over time
+    confidence REAL DEFAULT 1.0,  -- How sure we are about this
+    source TEXT,  -- Where this came from (conversation, document, etc.)
+    source_id TEXT,  -- Reference to source (episode_id, etc.)
+    source_context TEXT,  -- One-line breadcrumb (e.g., "Email from Jim re: Forum V+, 2025-01-28")
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now')),
+    last_accessed_at TEXT,  -- For rehearsal-based importance boost
+    access_count INTEGER DEFAULT 0,
+    verified_at TEXT,  -- When this memory was verified
+    verification_status TEXT DEFAULT 'pending',  -- pending, verified, flagged, contradicts
+    metadata TEXT,  -- JSON blob for flexible attributes
+    source_channel TEXT DEFAULT 'claude_code',  -- Origin channel: claude_code, telegram, slack
+    deadline_at TEXT,  -- ISO datetime for commitment deadlines (Phase 2: temporal intelligence)
+    temporal_markers TEXT,  -- JSON: extracted temporal references from content
+    lifecycle_tier TEXT DEFAULT 'active',  -- sacred/active/cooling/archived
+    sacred_reason TEXT,  -- Why this memory is sacred (user-protected, auto-detected)
+    archived_at TEXT,  -- When this memory was archived
+    fact_id TEXT UNIQUE,  -- UUID for human-friendly reference
+    hash TEXT,  -- SHA-256 chain hash
+    prev_hash TEXT  -- Previous hash in chain (NULL for genesis)
+);
+
+CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+CREATE INDEX IF NOT EXISTS idx_memories_importance ON memories(importance DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_hash ON memories(content_hash);
+CREATE INDEX IF NOT EXISTS idx_memories_deadline ON memories(deadline_at);
+CREATE INDEX IF NOT EXISTS idx_memories_verification ON memories(verification_status);
+CREATE INDEX IF NOT EXISTS idx_memories_lifecycle ON memories(lifecycle_tier);
+CREATE INDEX IF NOT EXISTS idx_memories_fact_id ON memories(fact_id);
+
+-- Junction table linking memories to entities
+CREATE TABLE IF NOT EXISTS memory_entities (
+    memory_id INTEGER NOT NULL REFERENCES memories(id) ON DELETE CASCADE,
+    entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    relationship TEXT DEFAULT 'about',  -- about, by, to, from, etc.
+    PRIMARY KEY (memory_id, entity_id, relationship)
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_entities_entity ON memory_entities(entity_id);
+
+-- ============================================================================
+-- RELATIONSHIPS: Graph connections between entities
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS relationships (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    target_entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    relationship_type TEXT NOT NULL,  -- works_with, manages, client_of, etc.
+    strength REAL DEFAULT 1.0,  -- Relationship strength (decays/grows)
+    origin_type TEXT DEFAULT 'extracted',  -- user_stated, extracted, inferred, corrected
+    direction TEXT DEFAULT 'bidirectional' CHECK (direction IN ('forward', 'backward', 'bidirectional')),
+    valid_at TEXT,  -- When this relationship became true in the real world
+    invalid_at TEXT,  -- When this relationship was superseded (NULL = current)
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now')),
+    metadata TEXT,
+    lifecycle_tier TEXT DEFAULT 'active',  -- Mirrors memory lifecycle for consistency
+    UNIQUE(source_entity_id, target_entity_id, relationship_type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_relationships_source ON relationships(source_entity_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_target ON relationships(target_entity_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_type ON relationships(relationship_type);
+CREATE INDEX IF NOT EXISTS idx_relationships_temporal ON relationships(invalid_at, valid_at);
+
+-- ============================================================================
+-- EPISODES: Conversation session summaries
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS episodes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT UNIQUE,  -- External session identifier
+    summary TEXT,
+    narrative TEXT,  -- Free-form session narrative (tone, context, unresolved threads)
+    started_at TEXT DEFAULT (datetime('now')),
+    ended_at TEXT,
+    message_count INTEGER DEFAULT 0,
+    turn_count INTEGER DEFAULT 0,  -- Buffered turns count
+    is_summarized INTEGER DEFAULT 0,  -- Whether session has been summarized by Claude
+    source TEXT,  -- Origin channel: 'claude_code', 'telegram', 'slack', etc.
+    ingested_at TEXT,  -- When Claude Code read this (NULL = unread)
+    key_topics TEXT,  -- JSON array of main topics
+    metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_episodes_session ON episodes(session_id);
+CREATE INDEX IF NOT EXISTS idx_episodes_started ON episodes(started_at DESC);
+
+-- ============================================================================
+-- MESSAGES: Individual conversation turns
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS messages (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER REFERENCES episodes(id) ON DELETE CASCADE,
+    role TEXT NOT NULL CHECK (role IN ('user', 'assistant', 'system')),
+    content TEXT NOT NULL,
+    content_hash TEXT,  -- For deduplication
+    created_at TEXT DEFAULT (datetime('now')),
+    metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_messages_episode ON messages(episode_id);
+CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at DESC);
+
+-- ============================================================================
+-- PATTERNS: Detected behavioral patterns
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS patterns (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    description TEXT NOT NULL,
+    pattern_type TEXT NOT NULL,  -- behavioral, communication, scheduling, relationship
+    occurrences INTEGER DEFAULT 1,
+    first_observed_at TEXT DEFAULT (datetime('now')),
+    last_observed_at TEXT DEFAULT (datetime('now')),
+    confidence REAL DEFAULT 0.5,  -- Grows with observations
+    is_active INTEGER DEFAULT 1,
+    evidence TEXT,  -- JSON array of supporting observations
+    metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_patterns_type ON patterns(pattern_type);
+CREATE INDEX IF NOT EXISTS idx_patterns_active ON patterns(is_active);
+CREATE INDEX IF NOT EXISTS idx_patterns_confidence ON patterns(confidence DESC);
+
+-- ============================================================================
+-- PREDICTIONS: Proactive suggestions
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS predictions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    content TEXT NOT NULL,
+    prediction_type TEXT NOT NULL,  -- reminder, suggestion, warning, insight
+    priority REAL DEFAULT 0.5,
+    expires_at TEXT,  -- When this prediction is no longer relevant
+    is_shown INTEGER DEFAULT 0,  -- Whether user has seen this
+    is_acted_on INTEGER DEFAULT 0,  -- Whether user acted on this
+    created_at TEXT DEFAULT (datetime('now')),
+    shown_at TEXT,
+    prediction_pattern_name TEXT,  -- Links to pattern for feedback loop
+    metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_predictions_type ON predictions(prediction_type);
+CREATE INDEX IF NOT EXISTS idx_predictions_expires ON predictions(expires_at);
+CREATE INDEX IF NOT EXISTS idx_predictions_shown ON predictions(is_shown);
+CREATE INDEX IF NOT EXISTS idx_predictions_priority ON predictions(priority DESC);
+
+-- ============================================================================
+-- CONFIG: Runtime configuration stored in database
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS config (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL,
+    updated_at TEXT DEFAULT (datetime('now'))
+);
+
+-- ============================================================================
+-- VECTOR TABLES: sqlite-vec virtual tables for semantic search
+-- ============================================================================
+-- NOTE: vec0 virtual tables are created by database.py initialize() with
+-- configurable dimensions from config.embedding_dimensions.
+-- This allows changing embedding models without schema changes.
+
+-- ============================================================================
+-- TURN BUFFER: Raw conversation turns awaiting session summary
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS turn_buffer (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER NOT NULL REFERENCES episodes(id) ON DELETE CASCADE,
+    turn_number INTEGER NOT NULL,
+    user_content TEXT,
+    assistant_content TEXT,
+    is_archived INTEGER DEFAULT 0,
+    source TEXT,  -- Origin channel: 'claude_code', 'telegram', 'slack', etc.
+    created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_turn_buffer_episode ON turn_buffer(episode_id);
+
+-- Episode narrative embeddings are created by database.py with configurable dimensions.
+
+-- ============================================================================
+-- DOCUMENTS: File registry for provenance tracking
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS documents (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_hash TEXT,  -- SHA-256 of file contents for deduplication
+    filename TEXT NOT NULL,
+    mime_type TEXT,
+    file_size INTEGER,
+    storage_provider TEXT DEFAULT 'local' CHECK (storage_provider IN ('local', 'google_drive')),
+    storage_path TEXT,  -- Resolved file path on disk or cloud URI
+    source_type TEXT CHECK (source_type IN ('gmail', 'transcript', 'upload', 'capture', 'session')),
+    source_ref TEXT,  -- External reference (email ID, URL, etc.)
+    summary TEXT,
+    lifecycle TEXT DEFAULT 'active' CHECK (lifecycle IN ('active', 'dormant', 'archived', 'purged')),
+    last_accessed_at TEXT,
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now')),
+    workspace_id TEXT,  -- Project hash for isolation
+    metadata TEXT  -- JSON blob
+);
+
+CREATE INDEX IF NOT EXISTS idx_documents_hash ON documents(file_hash);
+CREATE INDEX IF NOT EXISTS idx_documents_lifecycle ON documents(lifecycle);
+CREATE INDEX IF NOT EXISTS idx_documents_source_type ON documents(source_type);
+CREATE INDEX IF NOT EXISTS idx_documents_workspace ON documents(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_documents_source_lookup ON documents(source_type, source_ref);
+
+-- Links documents to entities (people, projects, etc.)
+CREATE TABLE IF NOT EXISTS entity_documents (
+    entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    document_id INTEGER NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+    relationship TEXT DEFAULT 'about' CHECK (relationship IN ('sent_by', 'about', 'mentioned_in', 'authored', 'received_by')),
+    created_at TEXT DEFAULT (datetime('now')),
+    PRIMARY KEY (entity_id, document_id, relationship)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_documents_doc ON entity_documents(document_id);
+
+-- Links memories to source documents (provenance)
+CREATE TABLE IF NOT EXISTS memory_sources (
+    memory_id INTEGER NOT NULL REFERENCES memories(id) ON DELETE CASCADE,
+    document_id INTEGER NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+    excerpt TEXT,  -- Relevant excerpt from the document
+    created_at TEXT DEFAULT (datetime('now')),
+    PRIMARY KEY (memory_id, document_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_sources_doc ON memory_sources(document_id);
+
+-- ============================================================================
+-- DATABASE METADATA
+-- ============================================================================
+
+-- Stores database-level metadata like workspace path for identification
+CREATE TABLE IF NOT EXISTS _meta (
+    key TEXT PRIMARY KEY,
+    value TEXT,
+    updated_at TEXT DEFAULT (datetime('now'))
+);
+
+-- ============================================================================
+-- MIGRATION TRACKING
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS schema_migrations (
+    version INTEGER PRIMARY KEY,
+    applied_at TEXT DEFAULT (datetime('now')),
+    description TEXT
+);
+
+-- Record schema versions
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (1, 'Initial schema with entities, memories, relationships, episodes, patterns, predictions');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (2, 'Add turn_buffer table, episode narrative/summary columns, episode_embeddings');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (3, 'Add source_context to memories, is_archived to turn_buffer for episodic provenance');
+
+-- NOTE: FTS5 full-text search (migration v4) is created by database.py migration code
+-- rather than here, because CREATE TRIGGER statements contain internal semicolons
+-- that the schema.sql line-based parser cannot handle.
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (5, 'Add verification columns to memories, prediction_pattern_name to predictions');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (6, 'Add source and ingested_at to episodes, source to turn_buffer for gateway integration');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (7, 'Add documents, entity_documents, memory_sources tables for provenance tracking');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (8, 'Add valid_at, invalid_at to relationships for bi-temporal tracking');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (9, 'Add _meta table for database identification and workspace path tracking');
+
+-- ============================================================================
+-- REFLECTIONS: Persistent learnings and observations (from /meditate)
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS reflections (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    episode_id INTEGER REFERENCES episodes(id),
+
+    -- Type and content
+    reflection_type TEXT NOT NULL CHECK (reflection_type IN ('observation', 'pattern', 'learning', 'question')),
+    content TEXT NOT NULL,
+    content_hash TEXT,  -- For deduplication
+
+    -- Optional entity association
+    about_entity_id INTEGER REFERENCES entities(id),
+
+    -- Scoring (reflections are user-approved, so start high)
+    importance REAL DEFAULT 0.7,
+    confidence REAL DEFAULT 0.8,
+
+    -- Very slow decay (reflections are long-term learnings)
+    decay_rate REAL DEFAULT 0.999,
+
+    -- Aggregation tracking
+    aggregated_from TEXT,  -- JSON array of reflection IDs this merged from
+    aggregation_count INTEGER DEFAULT 1,
+
+    -- Timeline tracking (pattern evolution)
+    first_observed_at TEXT DEFAULT (datetime('now')),
+    last_confirmed_at TEXT DEFAULT (datetime('now')),
+
+    -- Embedding for semantic search
+    embedding BLOB,
+
+    -- Timestamps
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT,
+    surfaced_count INTEGER DEFAULT 0,
+    last_surfaced_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_reflections_type ON reflections(reflection_type);
+CREATE INDEX IF NOT EXISTS idx_reflections_importance ON reflections(importance DESC);
+CREATE INDEX IF NOT EXISTS idx_reflections_entity ON reflections(about_entity_id);
+CREATE INDEX IF NOT EXISTS idx_reflections_episode ON reflections(episode_id);
+
+-- Reflection embeddings are created by database.py with configurable dimensions.
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (10, 'Add reflections table and reflection_embeddings for /meditate skill');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (11, 'Add compound index for fast source lookup on documents');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (13, 'Add origin_type to memories, agent_dispatches table for Trust North Star');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (14, 'Add dispatch_tier to agent_dispatches for native agent team support');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (15, 'Add origin_type to relationships for organic trust model');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (16, 'Add source_channel to memories for channel-aware memory');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (17, 'Add deadline_at and temporal_markers to memories for temporal intelligence');
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (18, 'Add contact velocity and attention tier to entities for proactive relationship intelligence');
+
+-- ============================================================================
+-- ENTITY SUMMARIES: Hierarchical summaries for graph-aware retrieval
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS entity_summaries (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entity_id INTEGER NOT NULL REFERENCES entities(id) ON DELETE CASCADE,
+    summary TEXT NOT NULL,  -- Generated summary of all memories about this entity
+    summary_type TEXT DEFAULT 'overview',  -- overview, relationship_map, timeline
+    memory_count INTEGER DEFAULT 0,  -- Number of memories summarized
+    relationship_count INTEGER DEFAULT 0,  -- Number of relationships included
+    generated_at TEXT DEFAULT (datetime('now')),
+    expires_at TEXT,  -- When to regenerate (NULL = never expires)
+    metadata TEXT,  -- JSON: entity_ids_included, key_themes, etc.
+    UNIQUE(entity_id, summary_type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_summaries_entity ON entity_summaries(entity_id);
+CREATE INDEX IF NOT EXISTS idx_entity_summaries_expires ON entity_summaries(expires_at);
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (19, 'Add entity_summaries table for hierarchical graph-aware retrieval');
+
+-- ============================================================================
+-- AGENT DISPATCHES: Track delegated tasks to sub-agents
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_dispatches (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    agent_name TEXT NOT NULL,
+    dispatch_category TEXT NOT NULL,
+    task_summary TEXT,
+    started_at TEXT DEFAULT (datetime('now')),
+    completed_at TEXT,
+    duration_ms INTEGER,
+    success INTEGER DEFAULT 1,
+    required_claudia_judgment INTEGER DEFAULT 0,
+    judgment_reason TEXT,
+    episode_id INTEGER REFERENCES episodes(id),
+    user_approved INTEGER DEFAULT 1,
+    dispatch_tier TEXT DEFAULT 'task',
+    metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_dispatches_agent ON agent_dispatches(agent_name);
+CREATE INDEX IF NOT EXISTS idx_agent_dispatches_category ON agent_dispatches(dispatch_category);
+CREATE INDEX IF NOT EXISTS idx_agent_dispatches_started ON agent_dispatches(started_at DESC);
+
+-- NOTE: dispatch_tier validation trigger is created by database.py migration code
+-- rather than here, because CREATE TRIGGER statements contain internal semicolons
+-- that the schema.sql line-based parser cannot handle.
+
+INSERT OR IGNORE INTO schema_migrations (version, description)
+VALUES (20, 'Add lifecycle tiers, sacred memories, close-circle entities, fact_id, SHA-256 chain');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.51.4",
+  "version": "1.51.6",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",
@@ -34,7 +34,8 @@
     "cli",
     "template-v2",
     "assets",
-    "visualizer"
+    "visualizer",
+    "memory-daemon/claudia_memory/schema.sql"
   ],
   "dependencies": {
     "better-sqlite3": "^11.8.1",

package/template-v2/CLAUDE.md

@@ -328,6 +328,7 @@ I adapt to whatever tools are available. When you ask me to do something that ne
 | `claudia gmail status` | Check if Gmail is connected |
 | `claudia gmail search "<query>"` | Search emails (Gmail search syntax) |
 | `claudia gmail read <messageId>` | Read a specific email |
+| `claudia gmail send --to <email> --subject <text> --body <text>` | Send email (supports --attach, --cc, --bcc, --html, --thread, --reply-to) |
 | `claudia gmail logout` | Disconnect Gmail, remove tokens |
 | `claudia calendar login` | Opens browser for Calendar-only OAuth |
 | `claudia calendar status` | Check if Calendar is connected |