lemma-mcp 0.8.8 → 0.10.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Lemma Project Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Lemma Project Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,11 +2,11 @@
   <img src="assets/logo.png" width="200" alt="Lemma Logo">
 </p>
 
-# Lemma - Persistent Memory for LLMs via MCP
+# Lemma — Persistent Memory for LLMs via MCP
 
 [English](README.md) | [Türkçe](docs/README.tr.md)
 
-Lemma is an MCP server that gives LLMs persistent, cross-session memory. Memories are injected automatically into every session — no explicit tool call needed. Knowledge evolves through use: frequently accessed memories strengthen, unused ones fade, and patterns are promoted into reusable skills.
+Lemma is an MCP server that gives LLMs persistent, cross-session memory. Memories are injected automatically into every session — no explicit tool call needed. Knowledge evolves through use: frequently accessed memories strengthen, unused ones fade, and patterns are promoted into reusable skills. An autonomous intelligence layer runs in the background — detecting conflicts, suggesting actions, and auto-linking related knowledge.
 
 ## Quick Start
 
@@ -14,7 +14,8 @@ Add Lemma to your MCP client configuration:
 
 **Claude Desktop (Windows):** `%APPDATA%\Claude\claude_desktop_config.json`
 **Claude Desktop (macOS):** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**opencode:** `%APPDATA%\opencode\opencode.json`
+**Claude Code (Linux):** `~/.claude.json` or `~/.claude/settings.json`
+**opencode:** `~/.config/opencode/opencode.json` (Linux/macOS) or `%APPDATA%\opencode\opencode.json` (Windows)
 
 ```json
 {
@@ -29,121 +30,102 @@ Add Lemma to your MCP client configuration:
 
 > Using `@latest` ensures npx always fetches the newest version.
 
-**Requirements:** Node.js 18.0.0 or higher
+**Requirements:** Node.js 20.0.0 or higher
 
-## How It Works
-
-### Universal Memory Injection
-
-Memories are injected into tool descriptions via `tools/list`. The LLM starts every session already knowing its most important memories — works on every MCP client.
-
-**3-layer architecture:**
-- Layer 1: Full content for top memories (token-budgeted)
-- Layer 2: Summary index for remaining memories
-- Layer 3: Active guides with learnings
+### CLI Usage
 
-### Fragment Types
+```bash
+lemma -lib    # Library Mode: snapshot of your entire knowledge base
+```
 
-Every memory fragment has a type that classifies its nature:
+Outputs a full analysis of all memories, guides, relations, stale fragments, distill candidates, and suggested actions. Useful for periodic maintenance and review.
 
-| Type | Use For | Example |
-|------|---------|---------|
-| `fact` | Technical info, API behavior, versions | "Node.js 22 has native fetch" |
-| `pattern` | Repeated solution, best practice | "React useEffect cleanup pattern" |
-| `lesson` | Learned from experience, debugging | "JSONL parse errors silently swallow broken lines" |
-| `warning` | Caution, gotcha, pitfall | "fs.writeFileSync blocks the event loop" |
-| `context` | Environment info, project setup | "This project uses Python 3.11 with py launcher" |
+## How It Works
 
-Default is `fact` if not specified.
+Memories are injected into tool descriptions via `tools/list`. The LLM starts every session already knowing its most important memories — works on every MCP client.
 
-### Memory ↔ Guide Pipeline
+**3-layer injection:**
+- Full content for top memories (token-budgeted)
+- Summary index for remaining memories
+- Active guides with learnings
 
-Knowledge flows through a two-way pipeline:
+**Memory types:** `fact`, `pattern`, `lesson`, `warning`, `context`
 
-1. **Memory** = WHAT you know — facts, observations, technical details (`memory_add`)
-2. **Guide** = HOW you work — accumulated experience, procedural skills (`guide_practice`, `guide_distill`)
+**Knowledge pipeline:** Memory (what you know, `memory_add`) → Pattern (`type: "pattern"`) → Guide (how you work, `guide_distill` → `guide_practice`)
 
-Connections are **bidirectional** and automatic:
-- `guide_distill` → links memory to guide AND guide to memory
-- `guide_practice` → session-read memories validate the guide
-- `memory_merge` → relations, guide links, and associations are inherited by the merged fragment
+**AGENTS.md injection:** Lemma automatically injects a system prompt into your project's `AGENTS.md`, teaching the LLM how to use the memory system effectively. This ensures consistent behavior across all MCP clients.
 
-### Response Hooks (Suggested Actions)
+## Autonomous Intelligence
 
-Tool responses include contextual `SUGGESTED ACTIONS` when meaningful connections are detected. For example:
+Lemma runs intelligence in the background — no manual triggering needed:
 
-- `memory_add` with topic overlap → "Call `memory_relate` to link these fragments"
-- `memory_add` with type `pattern` → "Call `guide_distill` to promote into a skill"
-- `memory_feedback` positive → "Call `guide_distill` to convert into a reusable skill"
-- `session_end` with activity → Full review with relate + distill + practice suggestions
+- **Conflict Detection:** Automatically checks new memories against existing knowledge for contradictions. Reports conflicts with suggestions to resolve.
+- **Proactive Suggestions:** After adding memories or practicing guides, suggests actions like distilling patterns, merging duplicates, or refining low-performing guides.
+- **Auto-linking:** Frequently co-read memories and topic-overlapping fragments are automatically connected with relations.
 
-Hooks only appear when there's meaningful context — no noise in empty states.
+Manual deep analysis is also available via dedicated tools.
 
-### Learning System
+## Tools (24)
 
-Knowledge evolves through use with a biological memory model:
+### Memory (11)
 
-- **Shield**: Accessed items are protected from decay entirely
-- **Unused items** decay very slowly (0.002 per session)
-- **Negative feedback** reduces confidence by -0.02
-- **Associations**: Fragments used together build cross-references automatically
-- **No time-based decay**: Confidence only changes when the system is actively used
+| Tool | Purpose |
+|------|---------|
+| `memory_read` | Read/search fragments. Summary mode or full detail by ID |
+| `memory_add` | Save findings. Auto-redacts secrets, detects duplicates and conflicts |
+| `memory_update` | Update fragment by ID |
+| `memory_feedback` | Positive/negative feedback, adjusts confidence |
+| `memory_forget` | Delete fragment |
+| `memory_merge` | Merge fragments, inherit relations & guide links |
+| `memory_relate` | Create typed links (`contradicts`, `supersedes`, `supports`, `related_to`) |
+| `memory_stats` | Fragment counts, confidence, project breakdown |
+| `memory_audit` | Integrity check for orphans, duplicates, anomalies |
+| `memory_library` | Full knowledge base snapshot with analysis signals and suggestions |
 
-### Memory Structure
+### Guides (8)
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | string | Unique identifier (`m` + 12 hex chars) |
-| `title` | string | Short title |
-| `fragment` | string | Synthesized memory text |
-| `type` | FragmentType | `fact`, `pattern`, `lesson`, `warning`, or `context` |
-| `project` | string | Project scope (`null` for global) |
-| `confidence` | float | Reliability 0.0-1.0 |
-| `source` | string | `"user"` or `"ai"` |
-| `relations` | MemoryRelation[] | Typed links to other fragments |
-| `related_guides` | string[] | Guide names this fragment informs |
-| `associatedWith` | string[] | IDs of co-accessed fragments |
-| `tags` | string[] | Context tags from usage |
-| `accessed` | int | Access count in current decay cycle |
+| Tool | Purpose |
+|------|---------|
+| `guide_get` | Get guides sorted by usage, filter by category or task |
+| `guide_practice` | Record guide usage. Auto-creates guide if missing |
+| `guide_create` | Create guide with detailed manual |
+| `guide_distill` | Transform memory → guide learning (bidirectional link) |
+| `guide_update` | Update guide properties, anti-patterns, pitfalls |
+| `guide_forget` | Remove guide |
+| `guide_merge` | Merge guides, inherit source memories |
 
-### Guide Structure
+### Sessions (3)
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `guide` | string | Guide name |
-| `category` | string | Category (e.g., `web-frontend`, `dev-tool`) |
-| `description` | string | Full manual/protocols |
-| `source_memories` | string[] | Memory IDs that spawned this guide |
-| `validated_by` | string[] | Memory IDs that validated this guide in practice |
-| `usage_count` | int | Times practiced |
-| `success_count` | int | Successful uses |
-| `failure_count` | int | Failed uses |
-| `learnings` | string[] | Accumulated learnings |
-| `contexts` | string[] | Contexts where used |
+| Tool | Purpose |
+|------|---------|
+| `session_start` | Start traced session, pre-loads relevant context |
+| `session_end` | End session with review, auto-linking, and suggestions |
+| `session_stats` | Virtual session statistics |
 
-### Virtual Sessions
+### Intelligence (4)
 
-Tool calls are automatically correlated into virtual sessions:
-- Auto-starts on first tool call, auto-finalizes after 30 min inactivity
-- Tracks technologies seen, guides used, memories created/accessed
-- No explicit `session_start`/`session_end` required
+| Tool | Purpose |
+|------|---------|
+| `conflict_scan` | Scan all memories for contradictions |
+| `proactive_analysis` | Full knowledge base analysis: stale, orphan, distill, deprecated |
+| `project_analytics` | Cross-session project health, growth rate, skill coverage |
+| `semantic_search` | TF-IDF similarity search across memories |
 
-### Configuration
+## Configuration
 
 Optional config at `~/.lemma/config.json`:
 
 ```json
 {
   "token_budget": {
-    "full_content": 3000,
+    "full_content": 5000,
     "summary_index": 1000,
     "guides_detail": 1000
   },
   "injection": {
     "max_full_content_fragments": 15,
     "max_summary_fragments": 30,
-    "max_guides": 20,
-    "max_guide_detail": 3
+    "max_guides": 20
   },
   "virtual_session": {
     "timeout_minutes": 30
@@ -151,274 +133,51 @@ Optional config at `~/.lemma/config.json`:
 }
 ```
 
-### File Locations
+## File Locations
 
 | OS | Path |
 |---|---|
 | **Windows** | `C:\Users\{username}\.lemma\` |
-| **macOS** | `/Users/{username}/.lemma/` |
-| **Linux** | `/home/{username}/.lemma/` |
-
-Files: `memory.jsonl`, `guides.jsonl`, `config.json`, `sessions/`, `logs/`, `.bak` backups
-
----
-
-## Available Tools (21)
-
-### Memory Tools (11)
-
-#### `memory_read`
-
-Read memory fragments. SUMMARY MODE shows title + description; use `id` for full detail.
-
-**Parameters:**
-- `project` (string, optional): Project name to filter
-- `query` (string, optional): Semantic search keyword
-- `id` (string, optional): Get full detail for a specific fragment
-- `ids` (string[], optional): Get full details for multiple fragments at once
-- `context` (string, optional): Tag this access with a context (e.g., "debugging")
-- `all` (boolean, optional): Show fragments from all projects (default: false)
-- `minConfidence` (number, optional): Minimum confidence threshold (0-1)
-- `afterDate` (string, optional): ISO date — only fragments created on or after
-- `beforeDate` (string, optional): ISO date — only fragments created on or before
-
-#### `memory_add`
-
-**MANDATORY:** Call AFTER completing analysis to save findings. Automatically redacts secrets unless `confirm: true`.
-
-**Parameters:**
-- `fragment` (string, required): Memory text. Use structured markdown: `## [Topic]\n[Context]\n- [Key points]`
-- `title` (string, optional): Short title (max 80 chars)
-- `description` (string, optional): Short summary (max 150 chars)
-- `project` (string, optional): Project scope (null = global)
-- `source` (string, optional): "user" or "ai", default "ai"
-- `confirm` (boolean, optional): Store as-is even if secrets detected (default: false)
-- `type` (string, optional): Fragment type — `fact`, `pattern`, `lesson`, `warning`, or `context` (default: `fact`)
-
-#### `memory_update`
-
-Update an existing fragment by ID.
-
-**Parameters:**
-- `id` (string, required): Fragment ID
-- `title` (string, optional): New title
-- `fragment` (string, optional): New text
-- `confidence` (number, optional): New confidence 0-1
-
-#### `memory_feedback`
-
-Provide feedback on a memory fragment after use. Positive boosts confidence; negative reduces by -0.02.
-
-**Parameters:**
-- `id` (string, required): Fragment ID
-- `useful` (boolean, required): `true` if helpful, `false` if not
-
-#### `memory_forget`
-
-Remove a memory fragment by ID.
-
-**Parameters:**
-- `id` (string, required): Fragment ID
-
-#### `memory_merge`
-
-Merge multiple fragments into one. Relations, guide links, and associations are inherited by the merged fragment.
-
-**Parameters:**
-- `ids` (string[], required): Fragment IDs to merge
-- `title` (string, required): Title for merged fragment
-- `fragment` (string, required): Merged content
-- `project` (string, optional): Project scope
-
-#### `memory_relate`
-
-Create a typed relation between two memory fragments. Bidirectional — reverse relation auto-created.
-
-**Parameters:**
-- `sourceId` (string, required): Source fragment ID
-- `targetId` (string, required): Target fragment ID
-- `type` (string, required): `contradicts`, `supersedes`, `supports`, or `related_to`
-- `note` (string, optional): Note explaining the relation
-
-#### `memory_stats`
-
-Get memory store statistics.
-
-**Parameters:**
-- `project` (string, optional): Filter by project
-
-#### `memory_audit`
-
-Audit memory store for integrity issues.
-
-### Guide Tools (8)
-
-#### `guide_get`
-
-Get guides with usage statistics, sorted by usage count.
-
-**Parameters:**
-- `category` (string, optional): Filter by category
-- `guide` (string, optional): Get detail for specific guide
-- `task` (string, optional): Task description to get relevant suggestions
+| **macOS/Linux** | `~/.lemma/` |
 
-#### `guide_practice`
+Files: `lemma.db` (SQLite), `config.json`, `sessions/`, `logs/`
 
-**MANDATORY:** Record guide usage during work.
+## Search
 
-**Parameters:**
-- `guide` (string, required): Guide name
-- `category` (string, required): Category
-- `description` (string, optional): Detailed manual/protocols
-- `contexts` (string[], required): Contexts where used
-- `learnings` (string[], required): New learnings discovered
-- `outcome` (string, optional): "success" or "failure"
+Lemma uses **SQLite FTS5** full-text search for memory lookup, dedup, and topic overlap detection.
 
-#### `guide_create`
+**Architecture:**
+- `searchAndSortFragments()` — FTS5 full-text search, fallback to in-memory ranking
+- `findSimilarFragment()` — FTS5 BM25-based dedup with keyword overlap fallback
+- `findTopicOverlaps()` — FTS5 search + word overlap scoring for related fragment detection
 
-Create a guide with a detailed manual.
+## Data Storage
 
-**Parameters:**
-- `guide` (string, required): Guide name
-- `category` (string, required): Category
-- `description` (string, required): Full manual/protocols
-- `contexts` (string[], optional): Initial contexts
-- `learnings` (string[], optional): Initial learnings
+All data is stored in a single SQLite database (`~/.lemma/lemma.db`):
 
-#### `guide_distill`
+| Table | Purpose |
+|-------|---------|
+| `memories` | Memory fragments (FTS5 + metadata) |
+| `guides` | Procedural knowledge with learnings |
+| `sessions` | Session tracking and outcomes |
+| `relations` | Typed links between memories |
+| `guide_learnings` | Per-guide accumulated learnings |
+| `guide_memory_links` | Bidirectional guide ↔ memory links |
 
-Transform a memory fragment into a guide's learning. Creates bidirectional link (memory ↔ guide).
+Legacy JSONL files are automatically migrated on first run.
 
-**Parameters:**
-- `memory_id` (string, required): Memory fragment ID
-- `guide` (string, required): Target guide name
-- `category` (string, optional): Category (required if creating new guide)
-
-#### `guide_update`
-
-Update an existing guide's properties.
-
-**Parameters:**
-- `guide` (string, required): Current guide name
-- `new_name` (string, optional): New name
-- `category` (string, optional): New category
-- `description` (string, optional): New description/manual
-- `add_anti_patterns` (string[], optional): Add anti-patterns
-- `add_pitfalls` (string[], optional): Add known pitfalls
-- `superseded_by` (string, optional): Mark as superseded
-- `deprecated` (boolean, optional): Mark as deprecated
-
-#### `guide_forget`
-
-Remove a guide.
-
-**Parameters:**
-- `guide` (string, required): Guide name
-
-#### `guide_merge`
-
-Merge multiple guides into one. Source memories and validations are inherited.
-
-**Parameters:**
-- `guides` (string[], required): Guide names to merge
-- `guide` (string, required): Name for merged guide
-- `category` (string, required): Category
-- `description` (string, optional): Merged description
-- `contexts` (string[], optional): Merged contexts
-- `learnings` (string[], optional): Merged learnings
-
-### Session Tools (2)
-
-#### `session_start`
-
-Start a traced work session. Pre-loads relevant guides and memories.
-
-**Parameters:**
-- `task_type` (string, required): "debugging", "implementation", "refactoring", "testing", "research", "documentation", "optimization", or "other"
-- `technologies` (string[], optional): Technologies involved
-- `initial_approach` (string, optional): Initial plan
-
-#### `session_end`
-
-End the current session. Shows SESSION REVIEW with activity summary and suggestions.
-
-**Parameters:**
-- `outcome` (string, required): "success", "partial", "failure", or "abandoned"
-- `final_approach` (string, optional): What approach worked
-- `lessons` (string[], optional): What was learned
-
-#### `session_stats`
-
-Get virtual session statistics.
-
-**Parameters:**
-- `count` (number, optional): Number of recent sessions (default 10)
-
----
-
-## Manual Installation
-
-```bash
-git clone https://github.com/xenitV1/lemma
-cd Lemma
-npm install
-```
-
-```json
-{
-  "mcpServers": {
-    "lemma": {
-      "command": "node",
-      "args": ["C:\\path\\to\\Lemma\\dist\\index.js"]
-    }
-  }
-}
-```
-
-## Development
-
-```bash
-npm test            # 481 tests
-npm run typecheck   # TypeScript type checking
-npm run build       # Compile to dist/
-```
+## Security
 
-### Project Structure
+All data is stored locally in `~/.lemma/`. Nothing is sent to external servers. Secrets are automatically redacted from memory fragments (17 regex patterns for API keys, tokens, connection strings).
 
-```
-Lemma/
-├── src/
-│   ├── index.ts              # MCP server entry point
-│   ├── types.ts              # Shared TypeScript interfaces (MemoryFragment, Guide, FragmentType...)
-│   ├── memory/
-│   │   ├── core.ts           # Core memory logic, decay, search, dedup, relations, associations
-│   │   ├── config.ts         # User configuration loader
-│   │   ├── seed.ts           # Built-in seed knowledge fragments
-│   │   └── privacy.ts        # Secret scanning and redaction
-│   ├── guides/
-│   │   ├── core.ts           # Core guides logic, fuzzy dedup, source_memories, validated_by
-│   │   └── task-map.ts       # Task-to-guide mapping
-│   ├── server/
-│   │   ├── index.ts          # Server setup, injection, notifications
-│   │   ├── handlers.ts       # Tool handlers (21 tools) + response hooks
-│   │   ├── tools.ts          # Tool definitions
-│   │   ├── hooks.ts          # Hook system & prompt modifiers
-│   │   └── system-prompt.ts  # Dynamic system prompt
-│   └── sessions/
-│       ├── core.ts           # Session lifecycle
-│       └── virtual.ts        # Virtual session tracking
-├── tests/                    # 36 test files, 481 tests
-├── docs/                     # Research papers and references
-├── package.json
-├── tsconfig.json
-├── CHANGELOG.md
-└── README.md
-```
-
-## Security
+## Documentation
 
-All data is stored locally in `~/.lemma/`. Nothing is sent to external servers. Secrets are automatically redacted from memory fragments.
+- [Development Guide](docs/development/DEVELOPMENT.md) — Architecture, project structure, testing
+- [Handlers Refactor](docs/development/HANDLERS-REFACTOR.md) — Targeted SQL migration plan
+- [Roadmap](docs/development/ROADMAP.md) — v0.9, v0.10, v1.0 plans
+- [Research](docs/research/README.md) — Academic papers that influenced Lemma's design
+- [Changelog](CHANGELOG.md) — Version history
 
 ## License
 
-MIT License
+MIT

package/dist/db/database.d.ts

@@ -0,0 +1,12 @@
+import Database from "better-sqlite3";
+export declare class LemmaDB {
+    readonly db: Database.Database;
+    private stmtCache;
+    constructor(dbPath?: string);
+    prepareCached(sql: string): Database.Statement;
+    close(): void;
+}
+export declare function setDataDir(dir: string): void;
+export declare function getDb(dbPath?: string): LemmaDB;
+export declare function closeDb(): void;
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,OAAO,CAAC,SAAS,CAA8C;gBAEnD,MAAM,GAAE,MAAwB;IAoB5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS;IAS9C,KAAK,IAAI,IAAI;CAKd;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO5C;AAED,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAW9C;AAED,wBAAgB,OAAO,IAAI,IAAI,CAM9B"}

package/dist/db/database.js

@@ -0,0 +1,77 @@
+import path from "path";
+import os from "os";
+import fs from "fs";
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { logger } from "../logger.js";
+import { runMigrations } from "./migration.js";
+const DEFAULT_DB_PATH = path.join(os.homedir(), ".lemma", "lemma.db");
+export class LemmaDB {
+    db;
+    stmtCache = new Map();
+    constructor(dbPath = DEFAULT_DB_PATH) {
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        sqliteVec.load(this.db);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("synchronous = NORMAL");
+        this.db.pragma("foreign_keys = ON");
+        this.db.pragma("busy_timeout = 5000");
+        this.db.pragma("cache_size = -64000");
+        this.db.pragma("temp_store = MEMORY");
+        logger.info("Database opened", { path: dbPath });
+    }
+    prepareCached(sql) {
+        let stmt = this.stmtCache.get(sql);
+        if (!stmt) {
+            stmt = this.db.prepare(sql);
+            this.stmtCache.set(sql, stmt);
+        }
+        return stmt;
+    }
+    close() {
+        this.stmtCache.clear();
+        this.db.close();
+        logger.info("Database closed");
+    }
+}
+let _instance = null;
+let _currentPath = null;
+let _dataDir = null;
+export function setDataDir(dir) {
+    _dataDir = dir;
+    if (_instance) {
+        try {
+            _instance.close();
+        }
+        catch { }
+        _instance = null;
+        _currentPath = null;
+    }
+}
+export function getDb(dbPath) {
+    const resolvedPath = dbPath ?? (_dataDir ? path.join(_dataDir, "lemma.db") : DEFAULT_DB_PATH);
+    if (!_instance || _currentPath !== resolvedPath) {
+        if (_instance) {
+            try {
+                _instance.close();
+            }
+            catch { }
+        }
+        _instance = new LemmaDB(resolvedPath);
+        _currentPath = resolvedPath;
+        runMigrations(_instance);
+    }
+    return _instance;
+}
+export function closeDb() {
+    if (_instance) {
+        _instance.close();
+        _instance = null;
+        _currentPath = null;
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/db/database.js.map

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

package/dist/db/index.d.ts

@@ -0,0 +1,6 @@
+export { getDb, closeDb, setDataDir, LemmaDB } from "./database.js";
+export { SCHEMA_V1, MIGRATIONS } from "./schema.js";
+export { runMigrations, migrateFromJsonl } from "./migration.js";
+export { addMemory, getMemoryById, updateMemory, deleteMemory, searchMemories, addRelation, getRelations, boostConfidence, decayMemories, getMemoryStats, mergeMemories } from "./memory-store.js";
+export declare function initDatabase(dbPath?: string): void;
+//# sourceMappingURL=index.d.ts.map