super-memory-pro 0.2.0

package/README.md

@@ -0,0 +1,247 @@
+<div align="center">
+  <br/>
+  <h1>🧠 Super Memory</h1>
+  <p><strong>Ultra-persistent, automatic memory plugin for OpenCode</strong></p>
+  <p><em>Learn. Remember. Recall. Across every session.</em></p>
+  <br/>
+
+  <p>
+    <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"/>
+    <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"/>
+    <img src="https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge&logo=postgresql&logoColor=white" alt="PostgreSQL"/>
+    <img src="https://img.shields.io/badge/Express-000000?style=for-the-badge&logo=express&logoColor=white" alt="Express"/>
+  </p>
+
+  <p>
+    <img src="https://img.shields.io/github/license/luftwaffe66/Super-Memory" alt="License"/>
+    <img src="https://img.shields.io/badge/OpenCode-Plugin-8B5CF6" alt="OpenCode Plugin"/>
+    <img src="https://img.shields.io/badge/status-alpha-yellow" alt="Status"/>
+  </p>
+
+  <img src="super-memory-opencode.png" alt="Super Memory Banner" width="100%"/>
+  <br/>
+</div>
+
+---
+
+## 🌟 What is Super Memory?
+
+**Super Memory** is an OpenCode plugin that gives your AI coding assistant **permanent, cross-session memory**. It automatically learns from every interaction — your tech stack, decisions, preferences, and project context — and recalls them in future sessions.
+
+> **No more repeating yourself.** Every session builds upon the last.
+
+### ✨ Key Features
+
+- **🧠 Automatic Learning** — Every message, command, and tool result is analyzed and stored
+- **🔍 Smart Recall** — Relevant memories are injected into the system prompt on each session
+- **📂 Tech Stack Detection** — Automatically recognizes languages, frameworks, databases, and tools
+- **📝 Decision Tracking** — Captures architectural decisions and preferences
+- **👤 User Profiling** — Learns your working style, preferences, and patterns
+- **🔧 Custom Tools** — Query, save, and manage memories directly from chat
+- **🔄 Cross-Platform** — Works on Linux, macOS, Windows, and Termux (Android)
+- **📦 Auto-Installer** — Smart setup that detects and configures PostgreSQL automatically
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                     OpenCode                             │
+│  ┌──────────────────────────────────────────────────┐   │
+│  │           Super Memory Plugin (TS/Node)           │   │
+│  │                                                    │   │
+│  │  ┌──────────┐  ┌──────────┐  ┌────────────────┐   │   │
+│  │  │  Hooks   │  │  Tools   │  │  Express API    │   │   │
+│  │  │          │  │          │  │  Server         │   │   │
+│  │  │ • Message│  │ • mem_save│  │                │   │   │
+│  │  │ • System │  │ • mem_sea-│  │  CRUD + Search │   │   │
+│  │  │   Prompt │  │   rch    │  │  + Health       │   │   │
+│  │  │ • Compact│  │ • mem_for-│  │                │   │   │
+│  │  │   ion    │  │   get    │  │                │   │   │
+│  │  │ • Tool   │  │ • mem_sta-│  │                │   │   │
+│  │  │   Execute│  │   ts     │  │                │   │   │
+│  │  └────┬─────┘  └────┬─────┘  └───────┬────────┘   │   │
+│  │       │              │                │            │   │
+│  │       └──────────────┴────────────────┘            │   │
+│  │                        │                           │   │
+│  │               ┌────────▼────────┐                  │   │
+│  │               │  Memory         │                  │   │
+│  │               │  Processor      │                  │   │
+│  │               │  (Extract →     │                  │   │
+│  │               │   Store →       │                  │   │
+│  │               │   Recall)       │                  │   │
+│  │               └────────┬────────┘                  │   │
+│  └────────────────────────┼───────────────────────────┘   │
+│                           │                                │
+│                    ┌──────▼──────┐                         │
+│                    │ PostgreSQL  │                         │
+│                    │ (ultra_memo-│                         │
+│                    │  ry DB)     │                         │
+│                    └─────────────┘                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- **Node.js** >= 18.0.0
+- **PostgreSQL** (auto-installed if missing)
+- **OpenCode** with plugin support
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/luftwaffe66/Super-Memory.git
+cd Super-Memory
+
+# Install dependencies
+npm install
+
+# Run the installer (detects/installs PostgreSQL, creates DB, runs migrations)
+npm run install:plugin
+
+# Build the plugin
+npm run build
+```
+
+### OpenCode Configuration
+
+Add the plugin to your `~/.config/opencode/opencode.jsonc`:
+
+```json
+{
+  "plugin": [
+    "super-memory"
+  ]
+}
+```
+
+> **Note**: For local development, use `npm link` or a local path reference.
+
+---
+
+## 🛠️ Memory Tools
+
+Super Memory registers four custom tools accessible from your OpenCode chat:
+
+| Tool | Description | Example |
+|------|-------------|---------|
+| `mem_save` | Save an explicit memory | `mem_save(key="framework", content="Using React with TypeScript")` |
+| `mem_search` | Search stored memories | `mem_search(query="React components")` |
+| `mem_forget` | Delete a specific memory | `mem_forget(id="uuid-here")` |
+| `mem_stats` | View memory statistics | `mem_stats()` |
+
+---
+
+## 🧠 How It Works
+
+### Automatic Learning
+
+Every message you send is processed through multiple extractors:
+
+1. **Tech Stack Detector** — Identifies languages, frameworks, and tools mentioned
+2. **Decision Parser** — Captures architectural and design decisions
+3. **Preference Analyzer** — Learns your working style and preferences
+4. **Pattern Recognizer** — Identifies recurring workflows and commands
+
+### Smart Recall
+
+When a new session starts, Super Memory:
+
+1. Searches for memories relevant to the current conversation
+2. Ranks them by importance and relevance
+3. Injects the most relevant memories into the system prompt
+4. Updates access timestamps to track usage patterns
+
+### Data Storage
+
+All memories are stored in PostgreSQL with:
+- **Full-text search** via `tsvector` indexes for fast retrieval
+- **JSONB columns** for flexible metadata
+- **Automatic deduplication** to prevent memory bloat
+- **Importance scoring** (1-5) to prioritize critical information
+
+---
+
+## 📁 Project Structure
+
+```
+Super-Memory/
+├── package.json              # Plugin manifest
+├── tsconfig.json             # TypeScript configuration
+├── scripts/
+│   └── install.sh            # Shell installer wrapper
+├── src/
+│   ├── index.ts              # Plugin entry point
+│   ├── types.ts              # TypeScript type definitions
+│   ├── config.ts             # Environment configuration
+│   ├── db/
+│   │   ├── connection.ts     # PostgreSQL connection pool
+│   │   ├── queries.ts        # Database CRUD operations
+│   │   ├── migrations.ts     # Schema migration runner
+│   │   └── migrations/
+│   │       └── 001_initial.sql  # Initial schema
+│   ├── memory/
+│   │   ├── index.ts          # Module barrel
+│   │   ├── extractor.ts      # Pattern extraction (regex/heuristic)
+│   │   ├── store.ts          # Memory storage with dedup
+│   │   ├── search.ts         # Memory search and formatting
+│   │   └── processor.ts      # Core orchestrator
+│   ├── server/
+│   │   ├── index.ts          # Express app factory
+│   │   ├── schemas.ts        # Zod validation schemas
+│   │   ├── middleware/
+│   │   │   ├── async-handler.ts  # Async error wrapper
+│   │   │   └── error-handler.ts  # Global error handler
+│   │   └── routes/
+│   │       ├── health.ts     # Health check endpoint
+│   │       └── memory.ts     # Memory CRUD REST API
+│   ├── hooks/
+│   │   └── ...               # OpenCode hook handlers (WIP)
+│   ├── tools/
+│   │   └── definitions.ts    # Custom tool schemas
+│   └── installer/
+│       └── index.ts          # Cross-platform installer
+└── tests/                    # Test suite (WIP)
+```
+
+---
+
+## 🌐 Cross-Platform Support
+
+Super Memory's auto-installer handles multiple environments:
+
+| Platform | Package Manager | PostgreSQL Install |
+|----------|---------------|-------------------|
+| **Linux** | `apt`, `dnf`, `yum`, `apk` | Auto-detected, installs if missing |
+| **macOS** | `brew` | `brew install postgresql@17` |
+| **Termux (Android)** | `pkg` | `pkg install postgresql` |
+| **Windows** | — | Manual setup (instructions provided) |
+
+The installer **never hardcodes `sudo`** — it detects whether it's available and uses it only when necessary.
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License**.
+
+---
+
+<div align="center">
+  <br/>
+  <p>
+    Built with ❤️ for the OpenCode ecosystem
+  </p>
+  <p>
+    <a href="https://github.com/luftwaffe66/Super-Memory/issues">Report Bug</a>
+    ·
+    <a href="https://github.com/luftwaffe66/Super-Memory/issues">Request Feature</a>
+  </p>
+  <br/>
+</div>

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { PluginConfig } from './types.js';
+/**
+ * Load configuration from environment variables with sensible defaults.
+ */
+export declare function loadConfig(): PluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAoBzC"}

package/dist/config.js

@@ -0,0 +1,25 @@
+/**
+ * Load configuration from environment variables with sensible defaults.
+ */
+export function loadConfig() {
+    return {
+        db: {
+            host: process.env.UM_DB_HOST || 'localhost',
+            port: parseInt(process.env.UM_DB_PORT || '5432', 10),
+            database: process.env.UM_DB_NAME || 'ultra_memory',
+            user: process.env.UM_DB_USER || process.env.USER || 'postgres',
+            password: process.env.UM_DB_PASSWORD || '',
+            maxConnections: parseInt(process.env.UM_DB_POOL_MAX || '10', 10),
+        },
+        server: {
+            port: parseInt(process.env.UM_SERVER_PORT || '0', 10), // 0 = random port
+            host: process.env.UM_SERVER_HOST || '127.0.0.1',
+        },
+        memory: {
+            maxInjections: parseInt(process.env.UM_MAX_INJECTIONS || '5', 10),
+            minImportance: parseInt(process.env.UM_MIN_IMPORTANCE || '2', 10),
+            autoExtract: process.env.UM_AUTO_EXTRACT !== 'false',
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,EAAE,EAAE;YACF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW;YAC3C,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,EAAE,EAAE,CAAC;YACpD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,cAAc;YAClD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,UAAU;YAC9D,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;YAC1C,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,EAAE,CAAC;SACjE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,EAAE,EAAE,CAAC,EAAE,kBAAkB;YACzE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW;SAChD;QACD,MAAM,EAAE;YACN,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,GAAG,EAAE,EAAE,CAAC;YACjE,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,GAAG,EAAE,EAAE,CAAC;YACjE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,OAAO;SACrD;KACF,CAAC;AACJ,CAAC"}

package/dist/db/connection.d.ts

@@ -0,0 +1,20 @@
+import pg from 'pg';
+import type { PluginConfig } from '../types.js';
+/**
+ * Create and return the PostgreSQL connection pool.
+ * Lazily initialized — safe to call multiple times.
+ */
+export declare function getPool(config?: PluginConfig): pg.Pool;
+/**
+ * Quick health check: returns true if the database is reachable.
+ */
+export declare function healthCheck(): Promise<boolean>;
+/**
+ * Gracefully close the connection pool.
+ */
+export declare function closePool(): Promise<void>;
+/**
+ * Connect to a different database (used by installer to create the target DB).
+ */
+export declare function createAdminPool(config: PluginConfig): pg.Pool;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,EAAE,CAAC,IAAI,CAwBtD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAQpD;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,EAAE,CAAC,IAAI,CAU7D"}

package/dist/db/connection.js

@@ -0,0 +1,66 @@
+import pg from 'pg';
+let pool = null;
+/**
+ * Create and return the PostgreSQL connection pool.
+ * Lazily initialized — safe to call multiple times.
+ */
+export function getPool(config) {
+    if (pool)
+        return pool;
+    const cfg = config;
+    pool = new pg.Pool({
+        host: cfg.db.host,
+        port: cfg.db.port,
+        database: cfg.db.database,
+        user: cfg.db.user,
+        password: cfg.db.password,
+        max: cfg.db.maxConnections,
+        idleTimeoutMillis: 30_000,
+        connectionTimeoutMillis: 5_000,
+    });
+    pool.on('error', (err) => {
+        console.error('[UltraMemory] PostgreSQL pool error:', err.message);
+    });
+    pool.on('connect', () => {
+        // Connection established — nothing to log in production
+    });
+    return pool;
+}
+/**
+ * Quick health check: returns true if the database is reachable.
+ */
+export async function healthCheck() {
+    if (!pool)
+        return false;
+    try {
+        const result = await pool.query('SELECT 1 AS ok');
+        return result.rows[0]?.ok === 1;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Gracefully close the connection pool.
+ */
+export async function closePool() {
+    if (pool) {
+        await pool.end();
+        pool = null;
+    }
+}
+/**
+ * Connect to a different database (used by installer to create the target DB).
+ */
+export function createAdminPool(config) {
+    return new pg.Pool({
+        host: config.db.host,
+        port: config.db.port,
+        database: 'postgres',
+        user: config.db.user,
+        password: config.db.password,
+        max: 1,
+        connectionTimeoutMillis: 5_000,
+    });
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,IAAI,IAAI,GAAmB,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAqB;IAC3C,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,GAAG,GAAG,MAAO,CAAC;IACpB,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI;QACjB,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI;QACjB,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ;QACzB,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI;QACjB,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ;QACzB,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,cAAc;QAC1B,iBAAiB,EAAE,MAAM;QACzB,uBAAuB,EAAE,KAAK;KAC/B,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACtB,wDAAwD;IAC1D,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;QACpB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;QACpB,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI;QACpB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ;QAC5B,GAAG,EAAE,CAAC;QACN,uBAAuB,EAAE,KAAK;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/db/migrations/001_initial.sql

@@ -0,0 +1,102 @@
+-- Ultra Memory: Initial Schema
+-- Creates core tables for persistent memory storage
+
+-- Migration tracking table
+CREATE TABLE IF NOT EXISTS _migrations (
+    id      SERIAL PRIMARY KEY,
+    name    TEXT NOT NULL UNIQUE,
+    applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Projects table
+CREATE TABLE IF NOT EXISTS projects (
+    id          TEXT PRIMARY KEY,
+    name        TEXT NOT NULL,
+    path        TEXT,
+    description TEXT,
+    tech_stack  JSONB NOT NULL DEFAULT '[]'::jsonb,
+    conventions JSONB NOT NULL DEFAULT '{}'::jsonb,
+    metadata    JSONB NOT NULL DEFAULT '{}'::jsonb,
+    created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Sessions table
+CREATE TABLE IF NOT EXISTS sessions (
+    id           TEXT PRIMARY KEY,
+    project_id   TEXT REFERENCES projects(id) ON DELETE SET NULL,
+    summary      TEXT,
+    message_count INTEGER NOT NULL DEFAULT 0,
+    tokens_used  INTEGER NOT NULL DEFAULT 0,
+    started_at   TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    ended_at     TIMESTAMPTZ,
+    metadata     JSONB NOT NULL DEFAULT '{}'::jsonb
+);
+
+-- Core memories table
+CREATE TABLE IF NOT EXISTS memories (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    memory_type     TEXT NOT NULL CHECK (memory_type IN (
+                        'user_profile',
+                        'tech_stack',
+                        'project_context',
+                        'session',
+                        'pattern',
+                        'decision',
+                        'explicit'
+                    )),
+    project_id      TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    session_id      TEXT REFERENCES sessions(id) ON DELETE SET NULL,
+    key             TEXT NOT NULL,
+    value           JSONB NOT NULL DEFAULT '{}'::jsonb,
+    content         TEXT NOT NULL,
+    importance      INTEGER NOT NULL DEFAULT 1 CHECK (importance BETWEEN 1 AND 5),
+    source          TEXT NOT NULL DEFAULT 'auto',
+    metadata        JSONB NOT NULL DEFAULT '{}'::jsonb,
+    access_count    INTEGER NOT NULL DEFAULT 0,
+    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    last_accessed_at TIMESTAMPTZ,
+    -- Full-text search vector
+    search_vector   TSVECTOR GENERATED ALWAYS AS (
+                        to_tsvector('english', coalesce(content, ''))
+                    ) STORED,
+    -- Unique constraint: one key per type per project
+    UNIQUE (memory_type, project_id, key)
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_memories_type        ON memories(memory_type);
+CREATE INDEX IF NOT EXISTS idx_memories_project     ON memories(project_id);
+CREATE INDEX IF NOT EXISTS idx_memories_key         ON memories(key);
+CREATE INDEX IF NOT EXISTS idx_memories_importance  ON memories(importance DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_fts         ON memories USING GIN(search_vector);
+CREATE INDEX IF NOT EXISTS idx_memories_created     ON memories(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_last_access ON memories(last_accessed_at DESC NULLS LAST);
+CREATE INDEX IF NOT EXISTS idx_sessions_project     ON sessions(project_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_started     ON sessions(started_at DESC);
+
+-- Updated_at trigger function
+CREATE OR REPLACE FUNCTION update_updated_at_column()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Apply trigger to tables
+DO $$
+BEGIN
+    IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'update_projects_updated_at') THEN
+        CREATE TRIGGER update_projects_updated_at
+            BEFORE UPDATE ON projects
+            FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
+    END IF;
+    IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'update_memories_updated_at') THEN
+        CREATE TRIGGER update_memories_updated_at
+            BEFORE UPDATE ON memories
+            FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
+    END IF;
+END;
+$$;

package/dist/db/migrations.d.ts

@@ -0,0 +1,14 @@
+import pg from 'pg';
+/**
+ * Run all pending migrations.
+ * Idempotent: safe to call multiple times.
+ */
+export declare function runMigrations(pool?: pg.Pool): Promise<string[]>;
+/**
+ * Get migration status.
+ */
+export declare function getMigrationStatus(pool?: pg.Pool): Promise<{
+    name: string;
+    applied_at: string;
+}[]>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,IAAI,CAAC;AA8BpB;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyCrE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAUxG"}

package/dist/db/migrations.js

@@ -0,0 +1,86 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getPool } from './connection.js';
+function getMigrationsDir() {
+    // Resolve migrations directory relative to this source file at runtime
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    return join(__dirname, 'migrations');
+}
+/**
+ * Ensure the _migrations tracking table exists.
+ */
+async function ensureMigrationTable(pool) {
+    await pool.query(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      id    SERIAL PRIMARY KEY,
+      name  TEXT NOT NULL UNIQUE,
+      applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    )
+  `);
+}
+/**
+ * Get list of already-applied migrations.
+ */
+async function getAppliedMigrations(pool) {
+    const result = await pool.query('SELECT name FROM _migrations ORDER BY name');
+    return new Set(result.rows.map((r) => r.name));
+}
+/**
+ * Run all pending migrations.
+ * Idempotent: safe to call multiple times.
+ */
+export async function runMigrations(pool) {
+    const p = pool ?? getPool();
+    const applied = [];
+    await ensureMigrationTable(p);
+    const alreadyApplied = await getAppliedMigrations(p);
+    const migrationsDir = getMigrationsDir();
+    let files;
+    try {
+        files = readdirSync(migrationsDir)
+            .filter((f) => f.endsWith('.sql'))
+            .sort();
+    }
+    catch {
+        console.warn('[UltraMemory] No migration directory found at', migrationsDir);
+        return [];
+    }
+    for (const file of files) {
+        if (alreadyApplied.has(file))
+            continue;
+        const sql = readFileSync(join(migrationsDir, file), 'utf-8');
+        const client = await p.connect();
+        try {
+            await client.query('BEGIN');
+            await client.query(sql);
+            await client.query('INSERT INTO _migrations (name) VALUES ($1)', [file]);
+            await client.query('COMMIT');
+            applied.push(file);
+            console.log(`[UltraMemory] Applied migration: ${file}`);
+        }
+        catch (err) {
+            await client.query('ROLLBACK');
+            console.error(`[UltraMemory] Migration ${file} failed:`, err);
+            throw err;
+        }
+        finally {
+            client.release();
+        }
+    }
+    return applied;
+}
+/**
+ * Get migration status.
+ */
+export async function getMigrationStatus(pool) {
+    const p = pool ?? getPool();
+    try {
+        const result = await p.query('SELECT name, applied_at FROM _migrations ORDER BY name');
+        return result.rows;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/db/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"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"}

package/dist/db/queries.d.ts

@@ -0,0 +1,24 @@
+import type { MemoryCreate, MemoryQuery, MemoryRecord, MemorySearchResult, MemoryType, MemoryUpdate, Session, Project } from '../types.js';
+export declare function createMemory(data: MemoryCreate): Promise<MemoryRecord>;
+export declare function getMemory(id: string): Promise<MemoryRecord | null>;
+export declare function searchMemories(query: MemoryQuery): Promise<MemorySearchResult[]>;
+export declare function updateMemory(id: string, data: MemoryUpdate): Promise<MemoryRecord | null>;
+export declare function deleteMemory(id: string): Promise<boolean>;
+export declare function recordMemoryAccess(id: string): Promise<void>;
+export declare function getMemoryStats(): Promise<{
+    type: MemoryType;
+    count: number;
+}[]>;
+export declare function createSession(id: string, projectId?: string): Promise<Session>;
+export declare function getSession(id: string): Promise<Session | null>;
+export declare function updateSession(id: string, data: Partial<Pick<Session, 'summary' | 'message_count' | 'tokens_used' | 'ended_at' | 'metadata'>>): Promise<Session | null>;
+export declare function createProject(data: {
+    id: string;
+    name: string;
+    path?: string;
+    description?: string;
+}): Promise<Project>;
+export declare function getProject(id: string): Promise<Project | null>;
+export declare function updateProjectTechStack(projectId: string, tech: string[]): Promise<void>;
+export declare function getAllProjects(): Promise<Project[]>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/db/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/db/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3I,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB5E;AAED,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAOxE;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiDtF;AAED,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA6B/F;AAED,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/D;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAMrF;AAID,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpF;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIpE;AAED,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAkB5K;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7H;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIpE;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAIzD"}