bitcompass 0.1.0 → 0.2.0

package/README.md

@@ -54,16 +54,13 @@ Add the `bitcompass` entry under `mcpServers`:
     "bitcompass": {
       "type": "stdio",
       "command": "bitcompass",
-      "args": ["mcp", "start"],
-      "env": {
-        "BITCOMPASS_CONFIG_DIR": "~/.bitcompass"
-      }
+      "args": ["mcp", "start"]
     }
   }
 }
 ```
 
-Replace `~` with your full home path if your environment doesn’t expand it. Run `bitcompass login` before using MCP.
+Run `bitcompass login` before using MCP. If you added the MCP before logging in, restart the MCP server in Cursor after logging in.
 
 ### Development (this repo)
 
@@ -73,7 +70,7 @@ This repo includes **`.cursor/mcp.json`** so Cursor points at the local CLI when
 cd packages/bitcompass-cli && npm run build && bitcompass login
 ```
 
-**Manual (local path):** Settings → MCP → stdio, Command **node**, Args **path/to/packages/bitcompass-cli/dist/index.js** **mcp** **start**. Optionally set env or envFile to the CLI `.env`.
+**Manual (local path):** Settings → MCP → stdio, Command **node**, Args **path/to/packages/bitcompass-cli/dist/index.js** **mcp** **start**.
 
 Tools: `search-rules`, `search-solutions`, `post-rules`. Prompts: `share_new_rule`, `share_problem_solution`.
 

package/dist/api/client.d.ts

@@ -1,6 +1,13 @@
 import { type SupabaseClient } from '@supabase/supabase-js';
 import type { Rule, RuleInsert } from '../types.js';
+/** Shown when MCP is used before logging in; instructs user to login and restart MCP. */
+export declare const AUTH_REQUIRED_MSG = "BitCompass needs authentication. Run `bitcompass login`, then restart the MCP server in your editor.";
+/** Shown when Supabase URL/key are not set; instructs config then login then restart MCP. */
+export declare const NOT_CONFIGURED_MSG = "BitCompass is not configured. Run `bitcompass config set supabaseUrl` and `bitcompass config set supabaseAnonKey`, then `bitcompass login`, then restart the MCP server in your editor.";
+/** Client for writes and authenticated reads (uses token when available). */
 export declare const getSupabaseClient: () => SupabaseClient | null;
+/** Client for public read-only (rules/solutions). Works without login when RLS allows public select. */
+export declare const getSupabaseClientForRead: () => SupabaseClient | null;
 export declare const fetchRules: (kind?: "rule" | "solution") => Promise<Rule[]>;
 export declare const searchRules: (queryText: string, options?: {
     kind?: "rule" | "solution";

package/dist/api/client.js

@@ -1,40 +1,75 @@
 import { createClient } from '@supabase/supabase-js';
 import { loadConfig, loadCredentials } from '../auth/config.js';
-export const getSupabaseClient = () => {
+import { DEFAULT_SUPABASE_ANON_KEY, DEFAULT_SUPABASE_URL } from '../auth/defaults.js';
+/** Shown when MCP is used before logging in; instructs user to login and restart MCP. */
+export const AUTH_REQUIRED_MSG = 'BitCompass needs authentication. Run `bitcompass login`, then restart the MCP server in your editor.';
+/** Shown when Supabase URL/key are not set; instructs config then login then restart MCP. */
+export const NOT_CONFIGURED_MSG = 'BitCompass is not configured. Run `bitcompass config set supabaseUrl` and `bitcompass config set supabaseAnonKey`, then `bitcompass login`, then restart the MCP server in your editor.';
+const isAuthError = (err) => {
+    const m = (err.message ?? '').toLowerCase();
+    const c = err.code ?? '';
+    return (c === 'PGRST301' ||
+        c === '401' ||
+        m.includes('jwt') ||
+        m.includes('row-level security') ||
+        m.includes('permission denied') ||
+        m.includes('not authenticated'));
+};
+const getSupabaseUrlAndKey = () => {
     const config = loadConfig();
+    const url = config.supabaseUrl ??
+        process.env.BITCOMPASS_SUPABASE_URL ??
+        DEFAULT_SUPABASE_URL;
+    const key = config.supabaseAnonKey ??
+        process.env.BITCOMPASS_SUPABASE_ANON_KEY ??
+        DEFAULT_SUPABASE_ANON_KEY;
+    if (!url || !key)
+        return null;
+    return { url, key };
+};
+/** Client for writes and authenticated reads (uses token when available). */
+export const getSupabaseClient = () => {
+    const pair = getSupabaseUrlAndKey();
+    if (!pair)
+        return null;
     const creds = loadCredentials();
-    const url = config.supabaseUrl ?? process.env.BITCOMPASS_SUPABASE_URL;
-    const key = config.supabaseAnonKey ?? process.env.BITCOMPASS_SUPABASE_ANON_KEY;
-    if (!url || !key) {
+    const accessToken = creds?.access_token;
+    return createClient(pair.url, pair.key, {
+        global: accessToken
+            ? { headers: { Authorization: `Bearer ${accessToken}` } }
+            : undefined,
+    });
+};
+/** Client for public read-only (rules/solutions). Works without login when RLS allows public select. */
+export const getSupabaseClientForRead = () => {
+    const pair = getSupabaseUrlAndKey();
+    if (!pair)
         return null;
-    }
+    const creds = loadCredentials();
     const accessToken = creds?.access_token;
-    const client = createClient(url, key, {
+    return createClient(pair.url, pair.key, {
         global: accessToken
             ? { headers: { Authorization: `Bearer ${accessToken}` } }
             : undefined,
     });
-    return client;
 };
 export const fetchRules = async (kind) => {
-    const client = getSupabaseClient();
-    if (!client) {
-        throw new Error('Supabase not configured. Set BITCOMPASS_SUPABASE_URL and BITCOMPASS_SUPABASE_ANON_KEY or run bitcompass config.');
-    }
+    const client = getSupabaseClientForRead();
+    if (!client)
+        throw new Error(NOT_CONFIGURED_MSG);
     let query = client.from('rules').select('*').order('created_at', { ascending: false });
     if (kind) {
         query = query.eq('kind', kind);
     }
     const { data, error } = await query;
     if (error)
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
     return (data ?? []);
 };
 export const searchRules = async (queryText, options = {}) => {
-    const client = getSupabaseClient();
-    if (!client) {
-        throw new Error('Supabase not configured.');
-    }
+    const client = getSupabaseClientForRead();
+    if (!client)
+        throw new Error(NOT_CONFIGURED_MSG);
     let query = client
         .from('rules')
         .select('*')
@@ -46,44 +81,44 @@ export const searchRules = async (queryText, options = {}) => {
     }
     const { data, error } = await query;
     if (error)
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
     return (data ?? []);
 };
 export const getRuleById = async (id) => {
-    const client = getSupabaseClient();
+    const client = getSupabaseClientForRead();
     if (!client)
-        throw new Error('Supabase not configured.');
+        throw new Error(NOT_CONFIGURED_MSG);
     const { data, error } = await client.from('rules').select('*').eq('id', id).single();
     if (error) {
         if (error.code === 'PGRST116')
             return null;
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
     }
     return data;
 };
 export const insertRule = async (rule) => {
     const client = getSupabaseClient();
     if (!client)
-        throw new Error('Supabase not configured.');
+        throw new Error(NOT_CONFIGURED_MSG);
     const { data, error } = await client.from('rules').insert(rule).select().single();
     if (error)
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
     return data;
 };
 export const updateRule = async (id, updates) => {
     const client = getSupabaseClient();
     if (!client)
-        throw new Error('Supabase not configured.');
+        throw new Error(NOT_CONFIGURED_MSG);
     const { data, error } = await client.from('rules').update(updates).eq('id', id).select().single();
     if (error)
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
     return data;
 };
 export const deleteRule = async (id) => {
     const client = getSupabaseClient();
     if (!client)
-        throw new Error('Supabase not configured.');
+        throw new Error(NOT_CONFIGURED_MSG);
     const { error } = await client.from('rules').delete().eq('id', id);
     if (error)
-        throw new Error(error.message);
+        throw new Error(isAuthError(error) ? AUTH_REQUIRED_MSG : error.message);
 };

package/dist/auth/defaults.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default Supabase connection for the Company Compass BitCompass CLI.
+ * Used when config file and env vars are not set.
+ */
+export declare const DEFAULT_SUPABASE_URL = "https://uikzqfzqgqegatmfhhsz.supabase.co";
+export declare const DEFAULT_SUPABASE_ANON_KEY = "sb_publishable_Q_68F2rTNKd8h_2j-UcLOQ_Gq7pTjQC";

package/dist/auth/defaults.js

@@ -0,0 +1,6 @@
+/**
+ * Default Supabase connection for the Company Compass BitCompass CLI.
+ * Used when config file and env vars are not set.
+ */
+export const DEFAULT_SUPABASE_URL = 'https://uikzqfzqgqegatmfhhsz.supabase.co';
+export const DEFAULT_SUPABASE_ANON_KEY = 'sb_publishable_Q_68F2rTNKd8h_2j-UcLOQ_Gq7pTjQC';

package/dist/commands/login.js

@@ -4,6 +4,7 @@ import { createServer } from 'http';
 import open from 'open';
 import ora from 'ora';
 import { getTokenFilePath, loadConfig, saveCredentials } from '../auth/config.js';
+import { DEFAULT_SUPABASE_ANON_KEY, DEFAULT_SUPABASE_URL } from '../auth/defaults.js';
 const CALLBACK_PORT = 38473;
 const createInMemoryStorage = () => {
     const store = new Map();
@@ -19,8 +20,12 @@ const createInMemoryStorage = () => {
 };
 export const runLogin = async () => {
     const config = loadConfig();
-    const url = config.supabaseUrl ?? process.env.BITCOMPASS_SUPABASE_URL;
-    const anonKey = config.supabaseAnonKey ?? process.env.BITCOMPASS_SUPABASE_ANON_KEY;
+    const url = config.supabaseUrl ??
+        process.env.BITCOMPASS_SUPABASE_URL ??
+        DEFAULT_SUPABASE_URL;
+    const anonKey = config.supabaseAnonKey ??
+        process.env.BITCOMPASS_SUPABASE_ANON_KEY ??
+        DEFAULT_SUPABASE_ANON_KEY;
     if (!url || !anonKey) {
         console.error(chalk.red('Supabase not configured. Set supabaseUrl and supabaseAnonKey:\n  bitcompass config set supabaseUrl https://YOUR_PROJECT.supabase.co\n  bitcompass config set supabaseAnonKey YOUR_ANON_KEY\nOr set BITCOMPASS_SUPABASE_URL and BITCOMPASS_SUPABASE_ANON_KEY.'));
         process.exit(1);

package/dist/mcp/server.js

@@ -1,4 +1,4 @@
-import { insertRule, searchRules } from '../api/client.js';
+import { AUTH_REQUIRED_MSG, insertRule, searchRules } from '../api/client.js';
 import { loadCredentials } from '../auth/config.js';
 function createStdioServer() {
     const handlers = new Map();
@@ -172,30 +172,36 @@ function createStdioServer() {
         }
     };
     process.stdin.on('data', onData);
-    // Register tool implementations
+    // Register tool implementations (search is public; post requires login)
     handlers.set('search-rules', async (args) => {
-        const creds = loadCredentials();
-        if (!creds?.access_token)
-            return { error: 'Run bitcompass login first.' };
         const query = args.query ?? '';
         const kind = args.kind;
         const limit = args.limit ?? 20;
-        const list = await searchRules(query, { kind, limit });
-        return { rules: list.map((r) => ({ id: r.id, title: r.title, kind: r.kind, snippet: r.body.slice(0, 200) })) };
+        try {
+            const list = await searchRules(query, { kind, limit });
+            return { rules: list.map((r) => ({ id: r.id, title: r.title, kind: r.kind, author: r.author_display_name ?? null, snippet: r.body.slice(0, 200) })) };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : 'Search failed.';
+            return { error: msg };
+        }
     });
     handlers.set('search-solutions', async (args) => {
-        const creds = loadCredentials();
-        if (!creds?.access_token)
-            return { error: 'Run bitcompass login first.' };
         const query = args.query ?? '';
         const limit = args.limit ?? 20;
-        const list = await searchRules(query, { kind: 'solution', limit });
-        return { solutions: list.map((r) => ({ id: r.id, title: r.title, snippet: r.body.slice(0, 200) })) };
+        try {
+            const list = await searchRules(query, { kind: 'solution', limit });
+            return { solutions: list.map((r) => ({ id: r.id, title: r.title, author: r.author_display_name ?? null, snippet: r.body.slice(0, 200) })) };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : 'Search failed.';
+            return { error: msg };
+        }
     });
     handlers.set('post-rules', async (args) => {
         const creds = loadCredentials();
         if (!creds?.access_token)
-            return { error: 'Run bitcompass login first.' };
+            return { error: AUTH_REQUIRED_MSG };
         const payload = {
             kind: args.kind ?? 'rule',
             title: args.title ?? 'Untitled',
@@ -205,8 +211,14 @@ function createStdioServer() {
             examples: Array.isArray(args.examples) ? args.examples : undefined,
             technologies: Array.isArray(args.technologies) ? args.technologies : undefined,
         };
-        const created = await insertRule(payload);
-        return { id: created.id, title: created.title, success: true };
+        try {
+            const created = await insertRule(payload);
+            return { id: created.id, title: created.title, success: true };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : 'Failed to publish rule.';
+            return { error: msg };
+        }
     });
     return {
         async connect() {
@@ -215,11 +227,8 @@ function createStdioServer() {
     };
 }
 export const startMcpServer = async () => {
-    const creds = loadCredentials();
-    if (!creds?.access_token) {
-        process.stderr.write('Not logged in. Run bitcompass login first.\n');
-        process.exit(1);
-    }
     const server = createStdioServer();
     await server.connect();
+    // Do not exit when not logged in: Cursor needs the process alive to complete
+    // the MCP handshake. Tools return an auth message (run bitcompass login, then restart MCP) when needed.
 };

package/dist/types.d.ts

@@ -9,6 +9,7 @@ export interface Rule {
     examples?: string[];
     technologies?: string[];
     user_id: string;
+    author_display_name?: string | null;
     created_at: string;
     updated_at: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitcompass",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "BitCompass CLI - rules, solutions, and MCP server",
   "type": "module",
   "bin": { "bitcompass": "./dist/index.js" },