traqr-memory-mcp 0.1.4 → 0.1.6

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":"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"}

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":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,gBAAgB,EAAgB,MAAM,eAAe,CAAA;AAE/H,KAAK,UAAU,GAAG;IAChB,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAExC,qBAAqB;IACrB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAA;IAEzD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;QACxE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,eAAe,CAAC;QACd,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC/E,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IACxD,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAA;IACjC,MAAM,aAAa,GAAG,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,KAAK,EAAE,CAAA;IAEhG,yBAAyB;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IACrB,CAAC,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;QACxB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAA;QAC1B,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAC/C,MAAM,CAAC,EAAE,GAAG,IAAI,CAAA;QAChB,CAAC,CAAC,IAAI,CAAC,aAAa,UAAU,cAAc,CAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,aAAa,UAAU,WAAW,CAAC,CAAA;QAC1C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;YACxB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,aAAa,EAAE,CAAA;YACxC,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;YAC7F,MAAM,CAAC,MAAM,GAAG,IAAI,CAAA;YACpB,CAAC,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;YACxB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7D,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,CAAC,CAAC,KAAK,CAAC,wBAAwB,aAAa,MAAM,CAAC,CAAA;IACpD,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAA;YACvB,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;YAChD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;YAC1E,MAAM,CAAC,SAAS,GAAG,IAAI,CAAA;YACvB,CAAC,CAAC,IAAI,CAAC,eAAe,aAAa,MAAM,MAAM,CAAC,UAAU,aAAa,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,eAAe,aAAa,WAAW,CAAC,CAAA;QAC/C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,gDAAgD;IAChD,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAA;QAC/D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,yBAAyB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;YACzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,OAAO,EAAE,WAAW;gBACpB,UAAU,EAAE,SAAS;gBACrB,aAAa,EAAE,aAAa;gBAC5B,UAAU,EAAE,GAAG;aAChB,CAAC,CAAA;YAEF,0CAA0C;YAC1C,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;gBACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;gBAClF,CAAC;YACH,CAAC;YAED,WAAW;YACX,MAAM,EAAE,GAAG,WAAW,EAAE,CAAA;YACxB,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAE1B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAA;YACvB,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;YAC5B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAED,UAAU;IACV,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;IAE9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,UAAU,kBAAkB,aAAa,EAAE,CAAC,CAAA;IAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAA;IACpE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,CAAA;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,sBAAsB,CAAC,CAAA;IAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,oCAAoC,CAAC,CAAA;IACxF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEf,IAAI,SAAS,EAAE,CAAC;QACd,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,mCAAmC,CAAC,CAAA;IAC9D,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,sDAAsD,CAAC,CAAA;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

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';