traqr-memory-mcp 0.1.4 → 0.1.5

package/README.md

@@ -1,68 +1,114 @@
-# TraqrDB — Memory-as-a-Service for AI Agents
+# traqr-memory-mcp
 
-A schema + intelligence layer on top of Postgres + pgvector. Store memories, search by meaning, track entity relationships, manage memory lifecycle — all via 10 MCP tools.
+MCP server for persistent AI agent memory. 10 tools, Postgres + pgvector, multi-strategy retrieval (semantic + BM25 + RRF). Works with Claude Code, Cursor, Codex, and any MCP client.
 
-## Quick Start (10 minutes)
+## Quick Start
 
 ### 1. Set Up Your Database
 
-**Option A: Supabase (easiest, free tier)**
+**Supabase (easiest, free tier)**
 1. Create a project at [supabase.com](https://supabase.com)
 2. Go to SQL Editor, paste contents of `setup.sql`, run
 3. Copy your project URL + service role key from Settings > API
 
-**Option B: AWS RDS / Aurora**
-1. Create RDS Postgres 15+ instance
-2. Enable pgvector: `CREATE EXTENSION vector;`
-3. Run setup.sql via psql: `psql $DATABASE_URL -f setup.sql`
+**Postgres (RDS, Aurora, Docker, any Postgres 15+)**
+1. Enable pgvector: `CREATE EXTENSION vector;`
+2. Run setup.sql: `psql $DATABASE_URL -f setup.sql`
 
-**Option C: Docker (local dev)**
+**Docker (local dev)**
 ```bash
-docker run -d --name traqrdb \
-  -e POSTGRES_PASSWORD=postgres \
-  -p 5432:5432 \
-  pgvector/pgvector:pg16
+docker run -d --name traqrdb -e POSTGRES_PASSWORD=postgres -p 5432:5432 pgvector/pgvector:pg16
 psql postgresql://postgres:postgres@localhost:5432/postgres -f setup.sql
 ```
 
-### 2. Configure Environment
+### 2. Add to Your MCP Client
 
-```bash
-# Required: Postgres connection
-export DATABASE_URL="postgresql://user:pass@host:5432/dbname"
-# OR for Supabase:
-export SUPABASE_URL="https://xxx.supabase.co"
-export SUPABASE_SERVICE_ROLE_KEY="eyJ..."
-
-# Embedding provider (choose one)
-export OPENAI_API_KEY="sk-..."        # OpenAI ($0.02/1M tokens)
-export GOOGLE_API_KEY="AIza..."       # Gemini Embedding 2 (free tier)
-# OR neither — entities use name matching, no semantic search
-
-# Optional
-export COHERE_API_KEY="..."           # Cohere Rerank v3.5
+<!-- AI agents: copy the appropriate JSON block below into the user's MCP config -->
+
+**Supabase + OpenAI** (most common)
+```json
+{
+  "traqr-memory": {
+    "command": "npx",
+    "args": ["traqr-memory-mcp"],
+    "env": {
+      "SUPABASE_URL": "https://xxx.supabase.co",
+      "SUPABASE_SERVICE_ROLE_KEY": "eyJ...",
+      "OPENAI_API_KEY": "sk-..."
+    }
+  }
+}
+```
+
+**Postgres + OpenAI**
+```json
+{
+  "traqr-memory": {
+    "command": "npx",
+    "args": ["-p", "pg", "traqr-memory-mcp"],
+    "env": {
+      "DATABASE_URL": "postgresql://user:pass@host:5432/dbname",
+      "OPENAI_API_KEY": "sk-..."
+    }
+  }
+}
+```
+
+**Postgres + Amazon Bedrock** (enterprise/AWS)
+```json
+{
+  "traqr-memory": {
+    "command": "npx",
+    "args": ["-p", "@aws-sdk/client-bedrock-runtime", "-p", "pg", "traqr-memory-mcp"],
+    "env": {
+      "DATABASE_URL": "postgresql://user:pass@host:5432/dbname",
+      "EMBEDDING_PROVIDER": "bedrock",
+      "EMBEDDING_MODEL": "amazon.nova-embed-v1:0",
+      "AWS_REGION": "us-east-1"
+    }
+  }
+}
 ```
 
-### 3. Connect to Your AI Agent
+**Supabase + Gemini** (free embeddings)
+```json
+{
+  "traqr-memory": {
+    "command": "npx",
+    "args": ["traqr-memory-mcp"],
+    "env": {
+      "SUPABASE_URL": "https://xxx.supabase.co",
+      "SUPABASE_SERVICE_ROLE_KEY": "eyJ...",
+      "GOOGLE_API_KEY": "AIza..."
+    }
+  }
+}
+```
 
-Add to your MCP client config (Claude Code, Cursor, etc.):
+**No embeddings** (BM25 keyword search only)
 ```json
 {
   "traqr-memory": {
     "command": "npx",
     "args": ["traqr-memory-mcp"],
     "env": {
-      "DATABASE_URL": "postgresql://...",
-      "OPENAI_API_KEY": "sk-..."
+      "SUPABASE_URL": "https://xxx.supabase.co",
+      "SUPABASE_SERVICE_ROLE_KEY": "eyJ...",
+      "EMBEDDING_PROVIDER": "none"
     }
   }
 }
 ```
 
-### 4. Verify
+### 3. Verify
 
 Use `memory_audit` to check health, then `memory_store` to create your first memory.
 
+On startup you should see:
+```
+TraqrDB Memory MCP v0.1.3 | Schema v2 | DB: Supabase | Embeddings: openai/text-embedding-3-small | Ready
+```
+
 ---
 
 ## 10 MCP Tools
@@ -70,65 +116,92 @@ Use `memory_audit` to check health, then `memory_store` to create your first mem
 | Tool | Description |
 |------|-------------|
 | `memory_store` | Remember something. Only content required — everything else auto-derived. |
-| `memory_search` | Search memories by meaning. Returns summaries. |
-| `memory_read` | Expand a memory by ID. Full content + version history. |
+| `memory_search` | Search memories by meaning. Returns summaries (~30 tokens each). |
+| `memory_read` | Expand a memory by ID. Full content + metadata + version history. |
 | `memory_enhance` | Deepen understanding. Creates connected memories via triage pipeline. |
 | `memory_browse` | Navigate by facet. Domain > category > summaries. Zero embedding cost. |
 | `memory_context` | Load task-relevant context — principles, preferences, gotchas. |
-| `memory_pulse` | Batch: capture multiple learnings + search + update in one call. |
+| `memory_pulse` | Batch: capture multiple learnings + search in one call. |
 | `memory_audit` | System health, stats, quality metrics. |
 | `memory_archive` | Archive stale content that was once correct. |
 | `memory_forget` | Forget incorrect or harmful content permanently. |
 
+## Environment Variables
+
+### Database (required — choose one)
+
+| Variable | Description |
+|----------|-------------|
+| `SUPABASE_URL` | Supabase project URL (e.g., `https://xxx.supabase.co`) |
+| `SUPABASE_SERVICE_ROLE_KEY` | Supabase service role key (not anon key) |
+| `DATABASE_URL` | Raw Postgres connection string. Requires `npm install pg`. |
+
+### Embedding Provider (choose one)
+
+| Variable | Provider | Notes |
+|----------|----------|-------|
+| `OPENAI_API_KEY` | OpenAI | text-embedding-3-small, 1536 dims. $0.02/1M tokens. |
+| `GOOGLE_API_KEY` | Gemini | gemini-embedding-001, 1536 dims. Free tier available. |
+| `EMBEDDING_PROVIDER=bedrock` | Amazon Bedrock | Requires AWS credentials (IAM role, env vars, or ~/.aws/credentials). |
+| `EMBEDDING_PROVIDER=ollama` | Ollama | Local models. Set `OLLAMA_BASE_URL` if not localhost:11434. |
+| `EMBEDDING_PROVIDER=none` | None | BM25 keyword search only. No API key needed. |
+
+### Provider-Specific
+
+| Variable | When | Description |
+|----------|------|-------------|
+| `EMBEDDING_PROVIDER` | Always | Explicit provider selection: `openai`, `gemini`, `bedrock`, `ollama`, `none`. Auto-detects from API keys if not set. |
+| `EMBEDDING_MODEL` | Bedrock/Ollama | Override default model (e.g., `amazon.nova-embed-v1:0`, `nomic-embed-text`) |
+| `EMBEDDING_DIMENSIONS` | Bedrock/Ollama | Override embedding dimensions (default: 1536 for Bedrock, 768 for Ollama) |
+| `OPENAI_BASE_URL` | OpenAI | Custom base URL for corporate proxies or compatible APIs |
+| `OLLAMA_BASE_URL` | Ollama | Ollama server URL (default: `http://localhost:11434`) |
+| `AWS_REGION` | Bedrock | AWS region (default: `us-east-1`) |
+
+### Optional
+
+| Variable | Description |
+|----------|-------------|
+| `COHERE_API_KEY` | Cohere Rerank v3.5 (quality boost for search results) |
+| `TRAQR_USER_ID` | Override default user ID (for multi-user setups) |
+| `TRAQR_PROJECT_ID` | Override default project ID |
+
 ## What's Inside
 
 **Schema** (created by `setup.sql`):
-- `traqr_memories` — content, embeddings, lifecycle, dual tsvectors
-- `memory_relationships` — graph edges between memories
+- `traqr_memories` — content, embeddings, lifecycle metadata, dual tsvectors for BM25
+- `memory_relationships` — typed graph edges between memories
 - `memory_entities` — extracted entities with embeddings
 - `memory_entity_links` — memory-to-entity junction table
 - 12+ indexes including partial HNSW, BM25 GIN, lifecycle
-- 10+ RPC functions for search, BM25, temporal, graph, confidence decay
+- 10+ SQL functions for search, BM25, temporal, graph, confidence decay
 
 **Intelligence** (in the TypeScript package):
 - Multi-strategy retrieval: semantic + BM25 > RRF fusion > optional Cohere rerank
 - 3-zone cosine triage: NOOP (>=0.90), ADD (<0.60), borderline (GPT-4o-mini decision)
 - Type-aware lifecycle: facts invalidate, preferences supersede, patterns coexist
-- Entity extraction: multi-signal canonicalization (name > ILIKE > embedding)
-- Quality gate: 3-layer ingestion filter prevents noise
+- Entity extraction: multi-signal canonicalization (exact name > ILIKE > embedding similarity)
+- Citation-aware decay: frequently cited memories resist archival
 
 ## Graceful Degradation
 
-| Missing | Behavior |
-|---------|----------|
-| No embedding API key | Entities use name matching. BM25 keyword search works. No vector search. |
-| No COHERE_API_KEY | Search uses RRF scores instead of Cohere rerank. |
+| Configuration | Search Behavior | Entity Behavior |
+|---------------|----------------|-----------------|
+| OpenAI/Gemini/Bedrock + Cohere | Full: semantic + BM25 + RRF + Cohere rerank | Full: name + fuzzy + embedding matching |
+| OpenAI/Gemini/Bedrock (no Cohere) | Semantic + BM25 + RRF fusion | Full: name + fuzzy + embedding matching |
+| Ollama (local) | Semantic + BM25 + RRF fusion | Full: name + fuzzy + embedding matching |
+| `EMBEDDING_PROVIDER=none` | BM25 keyword search only | Name + fuzzy matching only (no embedding) |
 
-## TypeScript Library API
+## Troubleshooting
 
-```typescript
-import { storeMemory, searchMemories, triageAndStore } from '@traqr/memory'
+If something goes wrong, the MCP server prints structured error messages with fix steps. Common issues:
 
-// Store a memory
-await storeMemory({ content: 'Always use bun', sourceType: 'manual' })
+**"schema_version table not found"** — Run `setup.sql` on your database. For Supabase: paste into SQL Editor. For Postgres: `psql $DATABASE_URL -f setup.sql`.
 
-// Search by meaning
-const results = await searchMemories('package manager', { limit: 5 })
+**"SUPABASE_SERVICE_ROLE_KEY is missing"** — Find it at Supabase Dashboard > Settings > API > service_role (not the anon key).
 
-// Store with triage (dedup + edges + LLM borderline)
-const result = await triageAndStore({ content: '...', sourceType: 'session' })
-// result.zone: 'noop' | 'add' | 'borderline'
-```
-
-## Environment Variables
+**"Raw Postgres requires the pg package"** — Install it: `npm install pg` or add `-p pg` to your npx args.
 
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `DATABASE_URL` or `SUPABASE_URL` | Yes | Postgres connection |
-| `SUPABASE_SERVICE_ROLE_KEY` | Supabase only | Service role key |
-| `OPENAI_API_KEY` | Recommended | OpenAI embeddings |
-| `GOOGLE_API_KEY` | Alternative | Gemini Embedding 2 (free) |
-| `COHERE_API_KEY` | No | Cohere Rerank (quality boost) |
+**Embedding errors** — Check your API key is valid. For Bedrock, ensure AWS credentials are configured (IAM role, env vars, or `~/.aws/credentials`).
 
 ## License
 

package/dist/cli/config-templates.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Config Templates
+ *
+ * Builds the JSON config block that goes into the user's MCP client config.
+ * Templates match the README exactly — same args, same env vars.
+ */
+export type DbProvider = 'supabase' | 'postgres';
+export type EmbeddingProvider = 'openai' | 'gemini' | 'bedrock' | 'ollama' | 'none';
+export interface WizardAnswers {
+    db: DbProvider;
+    embedding: EmbeddingProvider;
+    supabaseUrl?: string;
+    supabaseKey?: string;
+    databaseUrl?: string;
+    openaiKey?: string;
+    googleKey?: string;
+    awsRegion?: string;
+    ollamaUrl?: string;
+    ollamaModel?: string;
+}
+export declare function buildMcpConfig(answers: WizardAnswers): Record<string, any>;
+export declare function formatConfig(config: Record<string, any>): string;
+//# sourceMappingURL=config-templates.d.ts.map

package/dist/cli/config-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-templates.d.ts","sourceRoot":"","sources":["../../src/cli/config-templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;AAChD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,UAAU,CAAA;IACd,SAAS,EAAE,iBAAiB,CAAA;IAE5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiD1E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAEhE"}

package/dist/cli/config-templates.js

@@ -0,0 +1,66 @@
+/**
+ * MCP Config Templates
+ *
+ * Builds the JSON config block that goes into the user's MCP client config.
+ * Templates match the README exactly — same args, same env vars.
+ */
+export function buildMcpConfig(answers) {
+    const args = [];
+    // Optional peer deps via npx -p
+    if (answers.embedding === 'bedrock')
+        args.push('-p', '@aws-sdk/client-bedrock-runtime');
+    if (answers.db === 'postgres')
+        args.push('-p', 'pg');
+    args.push('traqr-memory-mcp');
+    // Env vars
+    const env = {};
+    // DB
+    if (answers.db === 'supabase') {
+        if (answers.supabaseUrl)
+            env.SUPABASE_URL = answers.supabaseUrl;
+        if (answers.supabaseKey)
+            env.SUPABASE_SERVICE_ROLE_KEY = answers.supabaseKey;
+    }
+    else {
+        if (answers.databaseUrl)
+            env.DATABASE_URL = answers.databaseUrl;
+    }
+    // Embedding
+    switch (answers.embedding) {
+        case 'openai':
+            if (answers.openaiKey)
+                env.OPENAI_API_KEY = answers.openaiKey;
+            break;
+        case 'gemini':
+            if (answers.googleKey)
+                env.GOOGLE_API_KEY = answers.googleKey;
+            break;
+        case 'bedrock':
+            env.EMBEDDING_PROVIDER = 'bedrock';
+            env.EMBEDDING_MODEL = 'amazon.nova-embed-v1:0';
+            if (answers.awsRegion)
+                env.AWS_REGION = answers.awsRegion;
+            break;
+        case 'ollama':
+            env.EMBEDDING_PROVIDER = 'ollama';
+            if (answers.ollamaUrl)
+                env.OLLAMA_BASE_URL = answers.ollamaUrl;
+            if (answers.ollamaModel)
+                env.EMBEDDING_MODEL = answers.ollamaModel;
+            break;
+        case 'none':
+            env.EMBEDDING_PROVIDER = 'none';
+            break;
+    }
+    return {
+        'traqr-memory': {
+            command: 'npx',
+            args,
+            env,
+        },
+    };
+}
+export function formatConfig(config) {
+    return JSON.stringify(config, null, 2);
+}
+//# sourceMappingURL=config-templates.js.map

package/dist/cli/config-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-templates.js","sourceRoot":"","sources":["../../src/cli/config-templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,gCAAgC;IAChC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAA;IACvF,IAAI,OAAO,CAAC,EAAE,KAAK,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACpD,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAE7B,WAAW;IACX,MAAM,GAAG,GAA2B,EAAE,CAAA;IAEtC,KAAK;IACL,IAAI,OAAO,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,WAAW;YAAE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;QAC/D,IAAI,OAAO,CAAC,WAAW;YAAE,GAAG,CAAC,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAA;IAC9E,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,CAAC,WAAW;YAAE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;IACjE,CAAC;IAED,YAAY;IACZ,QAAQ,OAAO,CAAC,SAAS,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,IAAI,OAAO,CAAC,SAAS;gBAAE,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,CAAA;YAC7D,MAAK;QACP,KAAK,QAAQ;YACX,IAAI,OAAO,CAAC,SAAS;gBAAE,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,CAAA;YAC7D,MAAK;QACP,KAAK,SAAS;YACZ,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAAA;YAClC,GAAG,CAAC,eAAe,GAAG,wBAAwB,CAAA;YAC9C,IAAI,OAAO,CAAC,SAAS;gBAAE,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;YACzD,MAAK;QACP,KAAK,QAAQ;YACX,GAAG,CAAC,kBAAkB,GAAG,QAAQ,CAAA;YACjC,IAAI,OAAO,CAAC,SAAS;gBAAE,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAA;YAC9D,IAAI,OAAO,CAAC,WAAW;gBAAE,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,WAAW,CAAA;YAClE,MAAK;QACP,KAAK,MAAM;YACT,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAA;YAC/B,MAAK;IACT,CAAC;IAED,OAAO;QACL,cAAc,EAAE;YACd,OAAO,EAAE,KAAK;YACd,IAAI;YACJ,GAAG;SACJ;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA2B;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC"}

package/dist/cli/detect-client.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Client Detection
+ *
+ * Finds the config file for the user's MCP client so --install
+ * can write the traqr-memory server config directly.
+ */
+export interface DetectedClient {
+    name: string;
+    configPath: string;
+    configKey: string;
+}
+export declare function detectMcpClients(): DetectedClient[];
+export declare function readClientConfig(client: DetectedClient): Record<string, any>;
+//# sourceMappingURL=detect-client.d.ts.map

package/dist/cli/detect-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-client.d.ts","sourceRoot":"","sources":["../../src/cli/detect-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAsBD,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAInD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAM5E"}

package/dist/cli/detect-client.js

@@ -0,0 +1,40 @@
+/**
+ * MCP Client Detection
+ *
+ * Finds the config file for the user's MCP client so --install
+ * can write the traqr-memory server config directly.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const HOME = process.env.HOME || '';
+const CLIENTS = [
+    {
+        name: 'Claude Code',
+        path: join(HOME, '.claude', 'settings.json'),
+        key: 'mcpServers',
+    },
+    {
+        name: 'Claude Desktop',
+        path: join(HOME, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+        key: 'mcpServers',
+    },
+    {
+        name: 'Cursor',
+        path: join(process.cwd(), '.cursor', 'mcp.json'),
+        key: 'mcpServers',
+    },
+];
+export function detectMcpClients() {
+    return CLIENTS
+        .filter(c => existsSync(c.path))
+        .map(c => ({ name: c.name, configPath: c.path, configKey: c.key }));
+}
+export function readClientConfig(client) {
+    try {
+        return JSON.parse(readFileSync(client.configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=detect-client.js.map

package/dist/cli/detect-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-client.js","sourceRoot":"","sources":["../../src/cli/detect-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAQhC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;AAEnC,MAAM,OAAO,GAAuD;IAClE;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC;QAC5C,GAAG,EAAE,YAAY;KAClB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC;QAC1F,GAAG,EAAE,YAAY;KAClB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;QAChD,GAAG,EAAE,YAAY;KAClB;CACF,CAAA;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/cli/install.d.ts

@@ -0,0 +1,10 @@
+/**
+ * --install — Interactive Setup Wizard
+ *
+ * Detects MCP client, asks 2-3 questions, writes config.
+ * Uses @clack/prompts for polished interactive UI.
+ *
+ * Usage: npx traqr-memory-mcp --install
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli/install.js

@@ -0,0 +1,223 @@
+/**
+ * --install — Interactive Setup Wizard
+ *
+ * Detects MCP client, asks 2-3 questions, writes config.
+ * Uses @clack/prompts for polished interactive UI.
+ *
+ * Usage: npx traqr-memory-mcp --install
+ */
+import * as p from '@clack/prompts';
+import { writeFileSync } from 'node:fs';
+import { detectMcpClients, readClientConfig } from './detect-client.js';
+import { buildMcpConfig, formatConfig } from './config-templates.js';
+async function run() {
+    p.intro('TraqrDB Memory — Setup Wizard');
+    // Step 1: Detect MCP clients
+    const clients = detectMcpClients();
+    let targetClient = null;
+    if (clients.length === 1) {
+        p.log.info(`Detected ${clients[0].name} at ${clients[0].configPath}`);
+        targetClient = clients[0];
+    }
+    else if (clients.length > 1) {
+        const choice = await p.select({
+            message: 'Multiple MCP clients detected. Which one?',
+            options: [
+                ...clients.map(c => ({ label: c.name, value: c.configPath })),
+                { label: 'Print config to terminal (manual setup)', value: '__stdout__' },
+            ],
+        });
+        if (p.isCancel(choice)) {
+            p.cancel('Setup cancelled.');
+            process.exit(0);
+        }
+        if (choice !== '__stdout__') {
+            targetClient = clients.find(c => c.configPath === choice) || null;
+        }
+    }
+    else {
+        p.log.warn('No MCP client config detected. Config will be printed to terminal.');
+    }
+    // Step 2: Database provider
+    const db = await p.select({
+        message: 'Where is your database?',
+        options: [
+            { label: 'Supabase', value: 'supabase', hint: 'easiest — free tier at supabase.com' },
+            { label: 'Postgres', value: 'postgres', hint: 'RDS, Aurora, Docker, any Postgres 15+ with pgvector' },
+            { label: "I don't have one yet", value: 'none', hint: 'we\'ll help you set one up' },
+        ],
+    });
+    if (p.isCancel(db)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+    }
+    if (db === 'none') {
+        p.log.info('Create a free Supabase project at https://supabase.com');
+        p.log.info('Then run this wizard again with your project URL and service role key.');
+        p.outro('Come back when your database is ready!');
+        process.exit(0);
+    }
+    // Step 3: Collect DB credentials
+    const answers = { db: db, embedding: 'none' };
+    if (db === 'supabase') {
+        const url = await p.text({
+            message: 'Supabase project URL',
+            placeholder: 'https://xxx.supabase.co',
+            validate: (v) => v && !v.includes('supabase.co') ? 'Should be a Supabase URL (https://xxx.supabase.co)' : undefined,
+        });
+        if (p.isCancel(url)) {
+            p.cancel('Setup cancelled.');
+            process.exit(0);
+        }
+        answers.supabaseUrl = url;
+        const key = await p.text({
+            message: 'Supabase service role key',
+            placeholder: 'eyJ...',
+            validate: (v) => v && !v.startsWith('eyJ') ? 'Service role key starts with eyJ (not the anon key)' : undefined,
+        });
+        if (p.isCancel(key)) {
+            p.cancel('Setup cancelled.');
+            process.exit(0);
+        }
+        answers.supabaseKey = key;
+    }
+    else {
+        const url = await p.text({
+            message: 'Postgres connection string',
+            placeholder: 'postgresql://user:pass@host:5432/dbname',
+            validate: (v) => v && !v.startsWith('postgres') ? 'Should start with postgresql:// or postgres://' : undefined,
+        });
+        if (p.isCancel(url)) {
+            p.cancel('Setup cancelled.');
+            process.exit(0);
+        }
+        answers.databaseUrl = url;
+    }
+    // Step 4: Embedding provider
+    const embedding = await p.select({
+        message: 'Which embedding provider?',
+        options: [
+            { label: 'OpenAI', value: 'openai', hint: 'text-embedding-3-small — $0.02/1M tokens' },
+            { label: 'Gemini', value: 'gemini', hint: 'gemini-embedding-001 — free tier available' },
+            { label: 'Amazon Bedrock', value: 'bedrock', hint: 'Nova Embeddings — uses AWS credentials' },
+            { label: 'Ollama', value: 'ollama', hint: 'local models — no API key needed' },
+            { label: 'None', value: 'none', hint: 'BM25 keyword search only — no embeddings' },
+        ],
+    });
+    if (p.isCancel(embedding)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+    }
+    answers.embedding = embedding;
+    // Step 5: Collect embedding credentials
+    switch (embedding) {
+        case 'openai': {
+            const key = await p.text({
+                message: 'OpenAI API key',
+                placeholder: 'sk-...',
+                validate: (v) => v && !v.startsWith('sk-') ? 'OpenAI keys start with sk-' : undefined,
+            });
+            if (p.isCancel(key)) {
+                p.cancel('Setup cancelled.');
+                process.exit(0);
+            }
+            answers.openaiKey = key;
+            break;
+        }
+        case 'gemini': {
+            const key = await p.text({
+                message: 'Google API key',
+                placeholder: 'AIza...',
+            });
+            if (p.isCancel(key)) {
+                p.cancel('Setup cancelled.');
+                process.exit(0);
+            }
+            answers.googleKey = key;
+            break;
+        }
+        case 'bedrock': {
+            const region = await p.text({
+                message: 'AWS region',
+                placeholder: 'us-east-1',
+                initialValue: 'us-east-1',
+            });
+            if (p.isCancel(region)) {
+                p.cancel('Setup cancelled.');
+                process.exit(0);
+            }
+            answers.awsRegion = region;
+            p.log.info('Bedrock uses your AWS credentials (IAM role, env vars, or ~/.aws/credentials).');
+            p.log.info('Make sure the role has bedrock:InvokeModel permission.');
+            break;
+        }
+        case 'ollama': {
+            const url = await p.text({
+                message: 'Ollama URL',
+                placeholder: 'http://localhost:11434',
+                initialValue: 'http://localhost:11434',
+            });
+            if (p.isCancel(url)) {
+                p.cancel('Setup cancelled.');
+                process.exit(0);
+            }
+            answers.ollamaUrl = url;
+            break;
+        }
+        // 'none' needs no credentials
+    }
+    // Step 6: Build config
+    const config = buildMcpConfig(answers);
+    const configJson = formatConfig(config);
+    // Step 7: Write or print config
+    if (targetClient) {
+        const existingConfig = readClientConfig(targetClient);
+        const servers = existingConfig[targetClient.configKey] || {};
+        if (servers['traqr-memory']) {
+            const overwrite = await p.confirm({
+                message: 'traqr-memory already exists in your config. Overwrite?',
+            });
+            if (p.isCancel(overwrite) || !overwrite) {
+                p.log.info('Existing config preserved. Here\'s the new config for reference:');
+                console.log('\n' + configJson + '\n');
+                p.outro('Add it manually if needed.');
+                process.exit(0);
+            }
+        }
+        servers['traqr-memory'] = config['traqr-memory'];
+        existingConfig[targetClient.configKey] = servers;
+        try {
+            writeFileSync(targetClient.configPath, JSON.stringify(existingConfig, null, 2) + '\n');
+            p.log.success(`Written to ${targetClient.configPath}`);
+        }
+        catch (err) {
+            p.log.error(`Failed to write config: ${err instanceof Error ? err.message : err}`);
+            p.log.info('Add this to your MCP config manually:');
+            console.log('\n' + configJson + '\n');
+        }
+    }
+    else {
+        p.log.info('Add this to your MCP client config:');
+        console.log('\n' + configJson + '\n');
+    }
+    // Step 8: Next steps
+    p.log.step('Next steps:');
+    if (db === 'supabase') {
+        p.log.info('1. Run setup.sql in your Supabase SQL Editor');
+        p.log.info('   Get it: npx traqr-memory-mcp --setup');
+    }
+    else {
+        p.log.info('1. Run: npx traqr-memory-mcp --setup');
+        p.log.info('   This will create the schema in your Postgres database');
+    }
+    p.log.info('2. Restart your MCP client');
+    p.log.info('3. Run: npx traqr-memory-mcp --verify');
+    p.log.info('4. Optional: npx traqr-memory-mcp --print-instructions');
+    p.log.info('   Prints a CLAUDE.md section that teaches Claude how to use memory proactively');
+    p.outro('Setup complete! Restart your MCP client to connect.');
+}
+run().catch((err) => {
+    console.error('Setup failed:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAA4B,aAAa,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAuB,MAAM,oBAAoB,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,YAAY,EAA+D,MAAM,uBAAuB,CAAA;AAEjI,KAAK,UAAU,GAAG;IAChB,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAExC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAA;IAElC,IAAI,YAAY,GAA0B,IAAI,CAAA;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;QACrE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;SAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;YAC5B,OAAO,EAAE,2CAA2C;YACpD,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC7D,EAAE,KAAK,EAAE,yCAAyC,EAAE,KAAK,EAAE,YAAY,EAAE;aAC1E;SACF,CAAC,CAAA;QACF,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QACzE,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI,CAAA;QACnE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;IAClF,CAAC;IAED,4BAA4B;IAC5B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,yBAAyB;QAClC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,qCAAqC,EAAE;YAC9F,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,qDAAqD,EAAE;YAC9G,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,EAAE;SAC9F;KACF,CAAC,CAAA;IACF,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAAC,CAAC;IAErE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAClB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;QACpE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;QACpF,CAAC,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAkB,EAAE,EAAE,EAAE,EAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IAE1E,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,sBAAsB;YAC/B,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,oDAAoD,CAAC,CAAC,CAAC,SAAS;SACpH,CAAC,CAAA;QACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QACtE,OAAO,CAAC,WAAW,GAAG,GAAG,CAAA;QAEzB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,2BAA2B;YACpC,WAAW,EAAE,QAAQ;YACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,SAAS;SAC/G,CAAC,CAAA;QACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QACtE,OAAO,CAAC,WAAW,GAAG,GAAG,CAAA;IAC3B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,4BAA4B;YACrC,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC,SAAS;SAC/G,CAAC,CAAA;QACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QACtE,OAAO,CAAC,WAAW,GAAG,GAAG,CAAA;IAC3B,CAAC;IAED,6BAA6B;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAiB,EAAE,IAAI,EAAE,0CAA0C,EAAE;YAC/F,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAiB,EAAE,IAAI,EAAE,4CAA4C,EAAE;YACjG,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAkB,EAAE,IAAI,EAAE,wCAAwC,EAAE;YACtG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAiB,EAAE,IAAI,EAAE,kCAAkC,EAAE;YACvF,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAe,EAAE,IAAI,EAAE,0CAA0C,EAAE;SAC5F;KACF,CAAC,CAAA;IACF,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAAC,CAAC;IAC5E,OAAO,CAAC,SAAS,GAAG,SAA8B,CAAA;IAElD,wCAAwC;IACxC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACvB,OAAO,EAAE,gBAAgB;gBACzB,WAAW,EAAE,QAAQ;gBACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,SAAS;aACtF,CAAC,CAAA;YACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YACtE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAA;YACvB,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACvB,OAAO,EAAE,gBAAgB;gBACzB,WAAW,EAAE,SAAS;aACvB,CAAC,CAAA;YACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YACtE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAA;YACvB,MAAK;QACP,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBAC1B,OAAO,EAAE,YAAY;gBACrB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,WAAW;aAC1B,CAAC,CAAA;YACF,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YACzE,OAAO,CAAC,SAAS,GAAG,MAAM,CAAA;YAC1B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAA;YAC5F,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;YACpE,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;gBACvB,OAAO,EAAE,YAAY;gBACrB,WAAW,EAAE,wBAAwB;gBACrC,YAAY,EAAE,wBAAwB;aACvC,CAAC,CAAA;YACF,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YACtE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAA;YACvB,MAAK;QACP,CAAC;QACD,8BAA8B;IAChC,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IAEvC,gCAAgC;IAChC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,cAAc,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAA;QACrD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QAE5D,IAAI,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;gBAChC,OAAO,EAAE,wDAAwD;aAClE,CAAC,CAAA;YACF,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACxC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAA;gBAC9E,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,CAAA;gBACrC,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;gBACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;QAChD,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,OAAO,CAAA;QAEhD,IAAI,CAAC;YACH,aAAa,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;YACtF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,YAAY,CAAC,UAAU,EAAE,CAAC,CAAA;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;YAClF,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;YACnD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACjD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,CAAA;IACvC,CAAC;IAED,qBAAqB;IACrB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACzB,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;QAC1D,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IACvD,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAA;QAClD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAA;IACxE,CAAC;IACD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IACxC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;IACnD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;IACpE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAA;IAE7F,CAAC,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAA;AAChE,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/cli/instructions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * --print-instructions — Print MEMORY_INSTRUCTIONS.md to stdout
+ *
+ * Users paste this into their CLAUDE.md to teach Claude
+ * how to use memory proactively.
+ *
+ * Usage: npx traqr-memory-mcp --print-instructions
+ */
+export {};
+//# sourceMappingURL=instructions.d.ts.map

package/dist/cli/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/cli/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli/instructions.js

@@ -0,0 +1,22 @@
+/**
+ * --print-instructions — Print MEMORY_INSTRUCTIONS.md to stdout
+ *
+ * Users paste this into their CLAUDE.md to teach Claude
+ * how to use memory proactively.
+ *
+ * Usage: npx traqr-memory-mcp --print-instructions
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+try {
+    const content = readFileSync(join(__dirname, '..', 'MEMORY_INSTRUCTIONS.md'), 'utf-8');
+    console.log(content);
+}
+catch {
+    console.error('MEMORY_INSTRUCTIONS.md not found.');
+    console.error('If installed via npm, it should be at: node_modules/traqr-memory-mcp/MEMORY_INSTRUCTIONS.md');
+    process.exit(1);
+}
+//# sourceMappingURL=instructions.js.map

package/dist/cli/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/cli/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAEzD,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,wBAAwB,CAAC,EAAE,OAAO,CAAC,CAAA;IACtF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAClD,OAAO,CAAC,KAAK,CAAC,6FAA6F,CAAC,CAAA;IAC5G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/cli/setup-db.d.ts

@@ -0,0 +1,10 @@
+/**
+ * --setup — Run setup.sql on configured database
+ *
+ * For Postgres: executes setup.sql directly via pg.
+ * For Supabase: prints the SQL with instructions to paste into SQL Editor.
+ *
+ * Usage: npx traqr-memory-mcp --setup
+ */
+export {};
+//# sourceMappingURL=setup-db.d.ts.map

package/dist/cli/setup-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-db.d.ts","sourceRoot":"","sources":["../../src/cli/setup-db.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli/setup-db.js

@@ -0,0 +1,114 @@
+/**
+ * --setup — Run setup.sql on configured database
+ *
+ * For Postgres: executes setup.sql directly via pg.
+ * For Supabase: prints the SQL with instructions to paste into SQL Editor.
+ *
+ * Usage: npx traqr-memory-mcp --setup
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import * as p from '@clack/prompts';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function run() {
+    p.intro('TraqrDB Memory — Database Setup');
+    const setupSqlPath = join(__dirname, '..', 'setup.sql');
+    let setupSql;
+    try {
+        setupSql = readFileSync(setupSqlPath, 'utf-8');
+    }
+    catch {
+        p.log.error(`setup.sql not found at ${setupSqlPath}`);
+        p.log.info('If installed via npm, it should be at: node_modules/traqr-memory-mcp/setup.sql');
+        process.exit(1);
+    }
+    const databaseUrl = process.env.DATABASE_URL;
+    const supabaseUrl = process.env.SUPABASE_URL;
+    if (!databaseUrl && !supabaseUrl) {
+        p.log.error('No database configured.');
+        p.log.info('Set DATABASE_URL or SUPABASE_URL environment variable, then run again.');
+        p.log.info('Or run: npx traqr-memory-mcp --install');
+        process.exit(1);
+    }
+    if (databaseUrl) {
+        // Postgres: execute directly
+        p.log.info(`Connecting to Postgres...`);
+        let pg;
+        try {
+            pg = await Function('return import("pg")')();
+        }
+        catch {
+            p.log.error('The pg package is required for direct Postgres setup.');
+            p.log.info('Install it: npm install pg');
+            process.exit(1);
+        }
+        const Pool = pg.default?.Pool || pg.Pool;
+        const pool = new Pool({ connectionString: databaseUrl });
+        try {
+            // Check if schema already exists
+            try {
+                const result = await pool.query('SELECT version FROM schema_version ORDER BY version DESC LIMIT 1');
+                if (result.rows.length > 0) {
+                    const version = result.rows[0].version;
+                    p.log.success(`Schema v${version} already exists.`);
+                    const proceed = await p.confirm({
+                        message: 'Re-run setup.sql anyway? (safe — uses IF NOT EXISTS)',
+                    });
+                    if (p.isCancel(proceed) || !proceed) {
+                        p.outro('Schema is up to date.');
+                        await pool.end();
+                        process.exit(0);
+                    }
+                }
+            }
+            catch {
+                // schema_version doesn't exist — fresh database
+                p.log.info('Fresh database detected. Running setup.sql...');
+            }
+            const s = p.spinner();
+            s.start('Running setup.sql...');
+            await pool.query(setupSql);
+            s.stop('Schema created successfully!');
+            // Verify
+            const result = await pool.query('SELECT version FROM schema_version ORDER BY version DESC LIMIT 1');
+            if (result.rows.length > 0) {
+                p.log.success(`Schema v${result.rows[0].version} is ready.`);
+            }
+            await pool.end();
+        }
+        catch (err) {
+            p.log.error(`Failed to run setup.sql: ${err instanceof Error ? err.message : err}`);
+            p.log.info('Check your DATABASE_URL and ensure pgvector is enabled:');
+            p.log.info('  CREATE EXTENSION IF NOT EXISTS vector;');
+            await pool.end();
+            process.exit(1);
+        }
+    }
+    else {
+        // Supabase: print instructions
+        p.log.info('Supabase detected. Setup.sql must be run via the Supabase SQL Editor.');
+        p.log.step('Steps:');
+        p.log.info('1. Go to your Supabase project dashboard');
+        p.log.info('2. Open SQL Editor (left sidebar)');
+        p.log.info('3. Paste the contents of setup.sql');
+        p.log.info('4. Click "Run"');
+        p.log.info('');
+        p.log.info(`setup.sql location: ${setupSqlPath}`);
+        p.log.info('');
+        const print = await p.confirm({
+            message: 'Print setup.sql contents to terminal? (for easy copy-paste)',
+        });
+        if (!p.isCancel(print) && print) {
+            console.log('\n--- BEGIN setup.sql ---\n');
+            console.log(setupSql);
+            console.log('\n--- END setup.sql ---\n');
+        }
+    }
+    p.outro('Database setup complete! Run: npx traqr-memory-mcp --verify');
+}
+run().catch((err) => {
+    console.error('Setup failed:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=setup-db.js.map

package/dist/cli/setup-db.js.map

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

package/dist/cli/verify.d.ts

@@ -0,0 +1,9 @@
+/**
+ * --verify — Health check + round trip test
+ *
+ * Verifies the complete setup: DB connection, schema, embeddings, round trip.
+ *
+ * Usage: npx traqr-memory-mcp --verify
+ */
+export {};
+//# sourceMappingURL=verify.d.ts.map

package/dist/cli/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/cli/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/cli/verify.js

@@ -0,0 +1,133 @@
+/**
+ * --verify — Health check + round trip test
+ *
+ * Verifies the complete setup: DB connection, schema, embeddings, round trip.
+ *
+ * Usage: npx traqr-memory-mcp --verify
+ */
+import * as p from '@clack/prompts';
+import { configureMemory, getVectorDB, getEmbeddingProvider, storeMemory, searchMemoriesV2 } from '@traqr/memory';
+async function run() {
+    p.intro('TraqrDB Memory — Verify Setup');
+    // Configure from env
+    const supabaseUrl = process.env.SUPABASE_URL;
+    const databaseUrl = process.env.DATABASE_URL;
+    const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+    if (!supabaseUrl && !databaseUrl) {
+        p.log.error('No database configured. Set DATABASE_URL or SUPABASE_URL.');
+        p.log.info('Run: npx traqr-memory-mcp --install');
+        process.exit(1);
+    }
+    configureMemory({
+        supabaseUrl,
+        supabaseKey,
+        databaseUrl,
+    });
+    const checks = { db: false, schema: false, embedding: false, roundTrip: false };
+    const dbProvider = supabaseUrl ? 'Supabase' : 'Postgres';
+    const ep = getEmbeddingProvider();
+    const embeddingInfo = ep.provider === 'none' ? 'None (BM25 only)' : `${ep.provider}/${ep.model}`;
+    // Check 1: DB connection
+    const s = p.spinner();
+    s.start('Checking database connection...');
+    try {
+        const db = getVectorDB();
+        const ok = await db.ping();
+        if (!ok)
+            throw new Error('ping returned false');
+        checks.db = true;
+        s.stop(`Database: ${dbProvider} — connected`);
+    }
+    catch (err) {
+        s.stop(`Database: ${dbProvider} — FAILED`);
+        p.log.error(err instanceof Error ? err.message : String(err));
+    }
+    // Check 2: Schema version
+    if (checks.db) {
+        s.start('Checking schema version...');
+        try {
+            const db = getVectorDB();
+            const version = await db.schemaVersion();
+            if (version === null)
+                throw new Error('schema_version table not found — run setup.sql first');
+            checks.schema = true;
+            s.stop(`Schema: v${version}`);
+        }
+        catch (err) {
+            s.stop('Schema: FAILED');
+            p.log.error(err instanceof Error ? err.message : String(err));
+            p.log.info('Run: npx traqr-memory-mcp --setup');
+        }
+    }
+    // Check 3: Embedding provider
+    s.start(`Checking embeddings (${embeddingInfo})...`);
+    try {
+        if (ep.provider === 'none') {
+            checks.embedding = true;
+            s.stop(`Embeddings: None (BM25 keyword search only)`);
+        }
+        else {
+            const result = await ep.generate('health check');
+            if (!result.embedding?.length)
+                throw new Error('Empty embedding returned');
+            checks.embedding = true;
+            s.stop(`Embeddings: ${embeddingInfo} — ${result.dimensions} dimensions`);
+        }
+    }
+    catch (err) {
+        s.stop(`Embeddings: ${embeddingInfo} — FAILED`);
+        p.log.error(err instanceof Error ? err.message : String(err));
+    }
+    // Check 4: Round trip (store → search → delete)
+    if (checks.db && checks.schema) {
+        s.start('Running round-trip test (store → search → delete)...');
+        try {
+            const testContent = `TraqrDB verify test — ${Date.now()}`;
+            const memory = await storeMemory({
+                content: testContent,
+                sourceType: 'session',
+                sourceProject: 'verify-test',
+                confidence: 0.1,
+            });
+            // Search for it (only if embeddings work)
+            if (checks.embedding && ep.provider !== 'none') {
+                const results = await searchMemoriesV2(testContent, { limit: 1 });
+                if (results.length === 0) {
+                    p.log.warn('Search returned no results for test memory (may be indexing delay)');
+                }
+            }
+            // Clean up
+            const db = getVectorDB();
+            await db.delete(memory.id);
+            checks.roundTrip = true;
+            s.stop('Round trip: store → search → delete — OK');
+        }
+        catch (err) {
+            s.stop('Round trip: FAILED');
+            p.log.error(err instanceof Error ? err.message : String(err));
+        }
+    }
+    // Summary
+    const allPassed = Object.values(checks).every(Boolean);
+    const passCount = Object.values(checks).filter(Boolean).length;
+    console.log('');
+    p.log.info(`DB: ${dbProvider} | Embeddings: ${embeddingInfo}`);
+    console.log('');
+    console.log(`  ${checks.db ? 'pass' : 'FAIL'}  Database connection`);
+    console.log(`  ${checks.schema ? 'pass' : 'FAIL'}  Schema version`);
+    console.log(`  ${checks.embedding ? 'pass' : 'FAIL'}  Embedding provider`);
+    console.log(`  ${checks.roundTrip ? 'pass' : 'FAIL'}  Round trip (store/search/delete)`);
+    console.log('');
+    if (allPassed) {
+        p.outro(`All ${passCount} checks passed! TraqrDB is ready.`);
+    }
+    else {
+        p.outro(`${passCount}/4 checks passed. Fix the failures above and re-run.`);
+        process.exit(1);
+    }
+}
+run().catch((err) => {
+    console.error('Verify failed:', err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=verify.js.map

package/dist/cli/verify.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,12 @@
 /**
  * TraqrDB Memory MCP Server
  *
+ * CLI flags (run instead of MCP server):
+ *   --install             Interactive setup wizard
+ *   --setup               Run setup.sql on your database
+ *   --verify              Health check + round trip test
+ *   --print-instructions  Print CLAUDE.md memory instructions
+ *
  * Standalone MCP server for AI agents. 10 memory tools powered by
  * Postgres + pgvector. Multi-strategy retrieval (semantic + BM25 + RRF),
  * cosine triage, LLM borderline decisions, entity extraction.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/index.js

@@ -2,6 +2,12 @@
 /**
  * TraqrDB Memory MCP Server
  *
+ * CLI flags (run instead of MCP server):
+ *   --install             Interactive setup wizard
+ *   --setup               Run setup.sql on your database
+ *   --verify              Health check + round trip test
+ *   --print-instructions  Print CLAUDE.md memory instructions
+ *
  * Standalone MCP server for AI agents. 10 memory tools powered by
  * Postgres + pgvector. Multi-strategy retrieval (semantic + BM25 + RRF),
  * cosine triage, LLM borderline decisions, entity extraction.
@@ -9,6 +15,44 @@
  * Usage:
  *   SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... npx traqr-memory-mcp
  */
+// CLI flag routing — handle before heavy imports
+const cliFlag = process.argv[2];
+if (cliFlag === '--install') {
+    await import('./cli/install.js');
+    process.exit(0);
+}
+if (cliFlag === '--setup') {
+    await import('./cli/setup-db.js');
+    process.exit(0);
+}
+if (cliFlag === '--verify') {
+    await import('./cli/verify.js');
+    process.exit(0);
+}
+if (cliFlag === '--print-instructions') {
+    await import('./cli/instructions.js');
+    process.exit(0);
+}
+if (cliFlag === '--help' || cliFlag === '-h') {
+    console.log(`
+  traqr-memory-mcp — MCP server for persistent AI agent memory
+
+  Usage: npx traqr-memory-mcp [flag]
+
+  Flags:
+    --install             Interactive setup wizard
+    --setup               Run setup.sql on your database
+    --verify              Health check + round trip test
+    --print-instructions  Print CLAUDE.md memory instructions
+    --help, -h            Show this help
+
+  No flags: start MCP server (for MCP client config, not direct use)
+
+  Quick start:
+    npx traqr-memory-mcp --install
+`);
+    process.exit(0);
+}
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traqr-memory-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Memory-as-a-service MCP server for AI agents. 10 tools, Postgres + pgvector, multi-strategy retrieval. Works with Claude Code, Cursor, Codex, and any MCP client.",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,8 +26,9 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@traqr/memory": "^0.1.0",
+    "@clack/prompts": "^1.1.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "@traqr/memory": "^0.1.0",
     "zod": "^3.24.2"
   },
   "keywords": [