traqr-memory-mcp 0.1.0

package/MEMORY_INSTRUCTIONS.md

@@ -0,0 +1,62 @@
+# TraqrDB Memory Instructions for CLAUDE.md
+
+> Copy this section into your project's CLAUDE.md to enable automatic memory behavior.
+> Without these instructions, Claude has the tools but won't use them proactively.
+
+---
+
+## Memory System
+
+TraqrDB memory via MCP tools. Persistent vector database that remembers across sessions.
+Only `content` is required for any store — domain, category, summary, topic, tags are all
+auto-derived from content.
+
+### Reading
+- `memory_search` — search by meaning, returns summaries (~30 tokens/result)
+- `memory_read` — expand one memory by ID (full content + version history)
+- `memory_browse` — navigate by domain/category facets (no embedding cost)
+- `memory_context` — load assembled task context (principles, preferences, gotchas)
+
+### Writing
+- `memory_store` — store a memory (just pass content, rest auto-derived)
+- `memory_enhance` — deepen existing understanding with new context
+- `memory_pulse` — batch capture 2+ learnings at once
+
+### Managing
+- `memory_audit` — system health, stats, quality metrics
+- `memory_archive` — archive stale content (was correct, now outdated)
+- `memory_forget` — forget incorrect or harmful content permanently
+
+### Capture Triggers — Fire Automatically, Don't Ask
+
+**Immediate captures** (call `memory_store` right after these happen):
+1. **Bug root cause found** — "X broke because Y in file Z"
+2. **User states a preference** — "I prefer/hate/want/always/never..." — capture exactly
+3. **API behaves unexpectedly** — document the gotcha with specifics
+4. **Architecture decision made** — what was decided AND why
+5. **Something fails silently** — the most dangerous kind, always capture
+
+**Use `memory_enhance`** when deepening existing understanding:
+6. **User reacts to your output** — what does this reveal about how they work?
+7. **User corrects your approach** — store the correction AND the reasoning
+8. **New detail about user's style** — compounds into existing personality memories
+
+**Session checkpoints:**
+9. **After completing a subtask** — "Did I learn anything non-obvious?"
+10. **Before ending a session** — memory_pulse with session learnings
+
+**Do NOT capture:**
+- Generic advice any developer would know
+- Observations about code that are obvious from reading it
+- Anything already documented in CLAUDE.md or project docs
+
+### Search Before You Start
+
+At the beginning of significant tasks, search memory for relevant context:
+```
+memory_search("topic of the current task")
+memory_context({ taskDescription: "what you're about to do" })
+```
+
+This surfaces gotchas, preferences, and patterns from prior sessions that
+inform your approach before you write a single line of code.

package/README.md

@@ -0,0 +1,135 @@
+# TraqrDB — Memory-as-a-Service for AI Agents
+
+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.
+
+## Quick Start (10 minutes)
+
+### 1. Set Up Your Database
+
+**Option A: 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`
+
+**Option C: Docker (local dev)**
+```bash
+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
+
+```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
+```
+
+### 3. Connect to Your AI Agent
+
+Add to your MCP client config (Claude Code, Cursor, etc.):
+```json
+{
+  "traqr-memory": {
+    "command": "npx",
+    "args": ["traqr-memory-mcp"],
+    "env": {
+      "DATABASE_URL": "postgresql://...",
+      "OPENAI_API_KEY": "sk-..."
+    }
+  }
+}
+```
+
+### 4. Verify
+
+Use `memory_audit` to check health, then `memory_store` to create your first memory.
+
+---
+
+## 10 MCP Tools
+
+| 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_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_audit` | System health, stats, quality metrics. |
+| `memory_archive` | Archive stale content that was once correct. |
+| `memory_forget` | Forget incorrect or harmful content permanently. |
+
+## What's Inside
+
+**Schema** (created by `setup.sql`):
+- `traqr_memories` — content, embeddings, lifecycle, dual tsvectors
+- `memory_relationships` — 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
+
+**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
+
+## 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. |
+
+## TypeScript Library API
+
+```typescript
+import { storeMemory, searchMemories, triageAndStore } from '@traqr/memory'
+
+// Store a memory
+await storeMemory({ content: 'Always use bun', sourceType: 'manual' })
+
+// Search by meaning
+const results = await searchMemories('package manager', { limit: 5 })
+
+// Store with triage (dedup + edges + LLM borderline)
+const result = await triageAndStore({ content: '...', sourceType: 'session' })
+// result.zone: 'noop' | 'add' | 'borderline'
+```
+
+## Environment Variables
+
+| 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) |
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * TraqrDB Memory MCP Server
+ *
+ * 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.
+ *
+ * Usage:
+ *   SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... npx traqr-memory-mcp
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * TraqrDB Memory MCP Server
+ *
+ * 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.
+ *
+ * Usage:
+ *   SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... npx traqr-memory-mcp
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configureMemory } from '@traqr/memory';
+import { registerTools } from './tools.js';
+// Configure database from environment
+const supabaseUrl = process.env.SUPABASE_URL || process.env.DATABASE_URL;
+const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY || 'service_role';
+if (!supabaseUrl) {
+    console.error('Error: SUPABASE_URL or DATABASE_URL environment variable required.');
+    console.error('See README.md for setup instructions.');
+    process.exit(1);
+}
+configureMemory({
+    supabaseUrl,
+    supabaseKey,
+    userId: process.env.TRAQR_USER_ID,
+    projectId: process.env.TRAQR_PROJECT_ID,
+});
+// Create and start MCP server
+const server = new McpServer({
+    name: 'traqr-memory',
+    version: '1.0.0',
+});
+registerTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('TraqrDB Memory MCP server failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,sCAAsC;AACtC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;AACxE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,cAAc,CAAA;AAE3E,IAAI,CAAC,WAAW,EAAE,CAAC;IACjB,OAAO,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACnF,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAA;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,eAAe,CAAC;IACd,WAAW;IACX,WAAW;IACX,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;IACjC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;CACxC,CAAC,CAAA;AAEF,8BAA8B;AAC9B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,aAAa,CAAC,MAAM,CAAC,CAAA;AAErB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAA;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Tool Handlers
+ *
+ * 10 memory tools calling @traqr/memory library functions directly.
+ * No HTTP layer, no apiCall(), no localhost server needed.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AA8CxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QA6S9C"}

package/dist/tools.js

@@ -0,0 +1,301 @@
+/**
+ * MCP Tool Handlers
+ *
+ * 10 memory tools calling @traqr/memory library functions directly.
+ * No HTTP layer, no apiCall(), no localhost server needed.
+ */
+import { z } from 'zod';
+import { storeMemory, searchMemoriesV2, getMemory, archiveMemory, triageAndStore, getSystemHealth, getDetailedStats, assembleSessionContext, deriveAll, getMemoryClient, } from '@traqr/memory';
+// ---------------------------------------------------------------------------
+// Shared schemas
+// ---------------------------------------------------------------------------
+const categoryEnum = z.enum(['gotcha', 'pattern', 'fix', 'insight', 'question', 'preference', 'convention']);
+const controlledTagEnum = z.enum(['critical', 'important', 'nice-to-know', 'evergreen', 'active', 'stale-risk', 'from-incident', 'from-decision', 'from-observation']);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function errorResult(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+}
+function toSummaryResult(r) {
+    return {
+        id: r.id,
+        summary: r.summary || (r.content ? r.content.slice(0, 120) + '...' : ''),
+        domain: r.domain,
+        category: r.category,
+        topic: r.topic,
+        score: Math.round((r.relevanceScore || r.similarity || 0) * 1000) / 1000,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool Registration
+// ---------------------------------------------------------------------------
+export function registerTools(server) {
+    // --- memory_store ---
+    server.tool('memory_store', 'Remember something. Only content required — domain, category, summary, topic, tags are all auto-derived. ' +
+        'Use when you learn a fact, preference, or pattern worth keeping. Override any field if auto-detection is wrong.', {
+        content: z.string().describe('What you learned — be specific. Include WHAT, WHY, WHERE.'),
+        summary: z.string().max(120).optional().describe('Override auto-summary'),
+        category: categoryEnum.optional().describe('Override auto-category'),
+        topic: z.string().optional().describe('Override auto-topic'),
+        tags: z.array(controlledTagEnum).optional().describe('Override auto-tags'),
+        confidence: z.number().min(0).max(1).default(0.8),
+    }, async ({ content, summary, category, topic, tags, confidence }) => {
+        try {
+            const derived = deriveAll(content, { summary, category, topic, tags, sourceTool: 'mcp-store' });
+            const input = {
+                content,
+                summary: derived.summary,
+                category: derived.category,
+                tags: derived.tags,
+                sourceType: 'session',
+                sourceProject: 'default',
+                confidence,
+                domain: derived.domain,
+                topic: derived.topic,
+                memoryType: derived.memoryType,
+                sourceTool: 'mcp-store',
+            };
+            const memory = await storeMemory(input);
+            return {
+                content: [{ type: 'text', text: `Stored [${derived.domain}/${derived.category}] ${derived.summary}` }],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_search ---
+    server.tool('memory_search', 'Search memories by meaning. Returns summaries (~30 tokens each). Use memory_read to expand a specific result.', {
+        query: z.string().describe('Natural language search query'),
+        limit: z.number().min(1).max(50).default(10),
+        category: categoryEnum.optional(),
+        memoryType: z.enum(['fact', 'preference', 'pattern']).optional(),
+        threshold: z.number().min(0).max(1).optional(),
+    }, async ({ query, limit, category, memoryType, threshold }) => {
+        try {
+            const options = {
+                limit,
+                category,
+                memoryType: memoryType,
+                similarityThreshold: threshold,
+            };
+            const results = await searchMemoriesV2(query, options);
+            const summaries = results.map(toSummaryResult);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({
+                            query, total: summaries.length, showing: summaries.length, results: summaries,
+                        }, null, 2) }],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_read ---
+    server.tool('memory_read', 'Expand a memory by ID. Shows full content, metadata, version history, and related memories.', { memoryId: z.string().describe('UUID of the memory') }, async ({ memoryId }) => {
+        try {
+            const memory = await getMemory(memoryId);
+            if (!memory)
+                return { content: [{ type: 'text', text: `Memory ${memoryId} not found` }] };
+            return { content: [{ type: 'text', text: JSON.stringify(memory, null, 2) }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_enhance ---
+    server.tool('memory_enhance', 'Deepen understanding of a topic. Stores a new connected memory that extends existing knowledge. ' +
+        'Use when you learn something that adds to what you already know.', {
+        content: z.string().describe('New observation or detail to add'),
+        context: z.string().optional().describe('Why this matters or when it applies'),
+    }, async ({ content, context }) => {
+        try {
+            const fullContent = context ? `${content}\n\nContext: ${context}` : content;
+            const derived = deriveAll(fullContent, { sourceTool: 'mcp-enhance' });
+            const input = {
+                content: fullContent,
+                summary: derived.summary,
+                category: derived.category,
+                tags: derived.tags,
+                sourceType: 'session',
+                sourceProject: 'default',
+                confidence: 0.85,
+                domain: derived.domain,
+                topic: derived.topic,
+                memoryType: derived.memoryType,
+                sourceTool: 'mcp-enhance',
+            };
+            const result = await triageAndStore(input);
+            return {
+                content: [{ type: 'text', text: `Enhanced [${derived.domain}/${derived.category}]: ${derived.summary} (zone: ${result.zone})` }],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_browse ---
+    server.tool('memory_browse', 'Navigate memories by facet. No args = domain counts. +domain = categories. +category = summaries. Zero embedding cost.', {
+        domain: z.string().optional(),
+        category: categoryEnum.optional(),
+    }, async ({ domain, category }) => {
+        try {
+            // Direct query via client — browse doesn't need the full search pipeline
+            const client = getMemoryClient();
+            let query = client.from('traqr_memories')
+                .select('domain, category, content, summary, id')
+                .eq('is_archived', false)
+                .eq('is_forgotten', false);
+            if (domain)
+                query = query.eq('domain', domain);
+            if (category)
+                query = query.eq('category', category);
+            query = query.limit(20).order('created_at', { ascending: false });
+            const { data, error } = await query;
+            if (error)
+                throw new Error(error.message);
+            if (!domain && !category) {
+                // Return domain counts
+                const counts = {};
+                for (const row of data || []) {
+                    const d = row.domain || 'unknown';
+                    counts[d] = (counts[d] || 0) + 1;
+                }
+                return { content: [{ type: 'text', text: JSON.stringify({ domains: counts }, null, 2) }] };
+            }
+            const summaries = (data || []).map((r) => ({
+                id: r.id,
+                summary: r.summary || r.content?.slice(0, 100),
+                domain: r.domain,
+                category: r.category,
+            }));
+            return { content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_context ---
+    server.tool('memory_context', 'Load task-relevant context — principles, preferences, gotchas for the current work.', {
+        taskDescription: z.string().optional(),
+    }, async ({ taskDescription }) => {
+        try {
+            const result = await assembleSessionContext({
+                slotName: 'standalone',
+                taskDescription,
+            });
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_pulse ---
+    server.tool('memory_pulse', 'Batch operation: capture multiple learnings + search + update in one call. Each capture only needs content.', {
+        search: z.string().optional(),
+        searchLimit: z.number().min(1).max(5).default(3),
+        captures: z.array(z.object({
+            content: z.string().describe('What you learned (min 20 chars)'),
+            category: categoryEnum.optional(),
+            tags: z.array(controlledTagEnum).optional(),
+        })).default([]),
+    }, async ({ search, searchLimit, captures }) => {
+        try {
+            // Run captures through triage
+            const captureResults = await Promise.all(captures
+                .filter((c) => c.content.trim().length >= 20)
+                .slice(0, 5)
+                .map((cap) => {
+                const derived = deriveAll(cap.content, {
+                    category: cap.category, tags: cap.tags, sourceTool: 'mcp-pulse',
+                });
+                const input = {
+                    content: cap.content.trim(),
+                    summary: derived.summary,
+                    category: derived.category,
+                    tags: [...(derived.tags || []), 'pulse'],
+                    sourceType: 'session',
+                    sourceProject: 'default',
+                    confidence: 0.8,
+                    domain: derived.domain,
+                    topic: derived.topic,
+                    memoryType: derived.memoryType,
+                    sourceTool: 'mcp-pulse',
+                };
+                return triageAndStore(input).catch(() => null);
+            }));
+            // Run search if requested
+            let searchResults = [];
+            if (search) {
+                const results = await searchMemoriesV2(search, { limit: searchLimit }).catch(() => []);
+                searchResults = results.map(toSummaryResult);
+            }
+            const successful = captureResults.filter(Boolean);
+            const zones = {
+                noop: successful.filter((r) => r?.zone === 'noop').length,
+                add: successful.filter((r) => r?.zone === 'add').length,
+                borderline: successful.filter((r) => r?.zone === 'borderline').length,
+            };
+            const summary = `Captured ${successful.filter((r) => !r?.deduplicated).length}, merged ${successful.filter((r) => r?.merged).length} | Zones: ${zones.noop} noop, ${zones.add} new, ${zones.borderline} borderline`;
+            const text = searchResults.length > 0
+                ? `${summary}\n\nSearch: ${searchResults.length} results\n${JSON.stringify(searchResults, null, 2)}`
+                : summary;
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_audit ---
+    server.tool('memory_audit', 'Memory system health, stats, and quality metrics.', {}, async () => {
+        try {
+            const [health, stats] = await Promise.all([
+                getSystemHealth(),
+                getDetailedStats(),
+            ]);
+            return { content: [{ type: 'text', text: JSON.stringify({ health, stats }, null, 2) }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_archive ---
+    server.tool('memory_archive', 'Archive a memory. Use for stale or outdated content that was once correct.', {
+        memoryId: z.string(),
+        reason: z.string().describe('Why: stale, incorrect, duplicate, noise'),
+    }, async ({ memoryId, reason }) => {
+        try {
+            await archiveMemory(memoryId, reason);
+            return { content: [{ type: 'text', text: `Archived ${memoryId}: ${reason}` }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // --- memory_forget ---
+    server.tool('memory_forget', 'Forget a memory. Use for incorrect, irrelevant, or harmful content that should never surface again. ' +
+        'Different from archive: archive = once correct but now stale, forget = should not exist.', {
+        memoryId: z.string().describe('UUID of the memory to forget'),
+        reason: z.string().optional().describe('Why this memory should be forgotten'),
+    }, async ({ memoryId, reason }) => {
+        try {
+            const client = getMemoryClient();
+            const { error } = await client.from('traqr_memories')
+                .update({
+                is_forgotten: true,
+                forgotten_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            })
+                .eq('id', memoryId);
+            if (error)
+                throw new Error(error.message);
+            return { content: [{ type: 'text', text: `Forgotten ${memoryId}${reason ? `: ${reason}` : ''}` }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "traqr-memory-mcp",
+  "version": "0.1.0",
+  "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",
+  "bin": {
+    "traqr-memory-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "setup.sql",
+    "README.md",
+    "MEMORY_INSTRUCTIONS.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@traqr/memory": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai",
+    "agent",
+    "postgres",
+    "pgvector",
+    "embedding",
+    "rag",
+    "claude-code",
+    "cursor",
+    "codex"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jiggycapital/traqr-oss"
+  }
+}