@agilemonster/mcp-server 1.0.4 → 1.0.6

package/bin/orchestrator.js

@@ -26,8 +26,19 @@ async function main() {
     case 'bootstrap':
     case 'setup':
     case 'init': {
-      const ideArg = args.find((a) => a.startsWith('--ide='))?.split('=')[1] || args[1];
-      await orchestrator.initInteractive({ ide: ideArg });
+      const ideArg = args.find((a) => a.startsWith('--ide='))?.split('=').slice(1).join('=');
+      const boardArg = args
+        .find((a) => a.startsWith('--board='))
+        ?.split('=')
+        .slice(1)
+        .join('=')
+        ?.replace(/^["']|["']$/g, '');
+      const providerArg = args.find((a) => a.startsWith('--provider='))?.split('=').slice(1).join('=');
+      await orchestrator.initInteractive({
+        ide: ideArg,
+        board: boardArg,
+        provider: providerArg,
+      });
       break;
     }
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { AgileMonsterProjectConfig, Card, ContextResponse } from './types.js';
+import { AgileMonsterProjectConfig, Board, BoardAgentConfig, Card, ContextResponse } from './types.js';
 export declare class AgileMonsterClient {
     private apiKey;
     private baseUrl;
@@ -24,12 +24,16 @@ export declare class AgileMonsterClient {
         first_name?: string;
         last_name?: string;
     }>;
-    getContext(projectName?: string, boardId?: string): Promise<ContextResponse>;
+    getContext(projectName?: string, boardId?: string, gitRemote?: string, detectedIdes?: string[]): Promise<ContextResponse>;
+    createBoard(workspaceId: string, name: string, description?: string): Promise<Board>;
+    saveBoardAgents(boardId: string, agents: BoardAgentConfig[], projectName?: string, projectPath?: string, gitRemote?: string): Promise<{
+        agents: BoardAgentConfig[];
+    }>;
     listAssigned(provider?: string, status?: string, boardId?: string, workspaceId?: string): Promise<{
         provider: string;
         cards: Card[];
     }>;
-    claimTask(cardId: string, provider: string, runRef?: string): Promise<Card>;
+    claimTask(cardId: string, provider: string, runRef?: string, expectedBoardId?: string): Promise<Card>;
     askQuestion(cardId: string, provider: string, question: string): Promise<Card>;
     addProgress(cardId: string, provider: string, update: string, tokensUsed?: number, costUsd?: number): Promise<Card>;
     recordSpend(cardId: string, provider: string, tokens: number, costUsd: number, note?: string): Promise<Card>;

package/dist/client.js

@@ -145,15 +145,43 @@ export class AgileMonsterClient {
     async me() {
         return this.request('/api/agent/me');
     }
-    async getContext(projectName, boardId) {
+    async getContext(projectName, boardId, gitRemote, detectedIdes) {
         const params = new URLSearchParams();
         if (projectName)
             params.set('project_name', projectName);
         if (boardId)
             params.set('board_id', boardId);
+        if (gitRemote)
+            params.set('git_remote', gitRemote);
+        if (detectedIdes && detectedIdes.length > 0) {
+            params.set('detected_ides', detectedIdes.join(','));
+        }
         const qs = params.toString();
         return this.request(`/api/agent/context${qs ? `?${qs}` : ''}`);
     }
+    async createBoard(workspaceId, name, description) {
+        return this.request('/api/boards', {
+            method: 'POST',
+            body: JSON.stringify({
+                workspace_id: workspaceId,
+                name,
+                description,
+                default_lists: true,
+            }),
+        });
+    }
+    async saveBoardAgents(boardId, agents, projectName, projectPath, gitRemote) {
+        return this.request(`/api/boards/${boardId}/agents`, {
+            method: 'POST',
+            body: JSON.stringify({
+                agents,
+                project_name: projectName,
+                project_path: projectPath,
+                git_remote: gitRemote,
+                connected: true,
+            }),
+        });
+    }
     async listAssigned(provider = 'any', status, boardId, workspaceId) {
         const params = new URLSearchParams();
         if (provider)
@@ -167,10 +195,11 @@ export class AgileMonsterClient {
         const qs = params.toString();
         return this.request(`/api/agent/assigned${qs ? `?${qs}` : ''}`);
     }
-    async claimTask(cardId, provider, runRef) {
+    async claimTask(cardId, provider, runRef, expectedBoardId) {
+        const boardId = expectedBoardId || this.loadProjectConfig()?.board_id;
         return this.request(`/api/agent/cards/${cardId}/claim`, {
             method: 'POST',
-            body: JSON.stringify({ provider, run_ref: runRef }),
+            body: JSON.stringify({ provider, run_ref: runRef, board_id: boardId }),
         });
     }
     async askQuestion(cardId, provider, question) {

package/dist/orchestrator.d.ts

@@ -15,13 +15,17 @@ export declare class AgileMonsterOrchestrator {
     }): Promise<Card[]>;
     printDashboard(): Promise<void>;
     runDaemon(options?: OrchestratorOptions): Promise<void>;
+    private detectGitRemote;
+    private detectInstalledIdes;
     initInteractive(options?: {
         provider?: string;
         ide?: string;
+        board?: string;
     }): Promise<void>;
     bootstrapInteractive(options?: {
         provider?: string;
         ide?: string;
+        board?: string;
     }): Promise<void>;
     configureIdes(apiKey: string, selectedIde?: string): void;
     private ensureGitignore;

package/dist/orchestrator.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import fs from 'node:fs';
+import { execSync } from 'node:child_process';
 import { AgileMonsterClient } from './client.js';
 import { AGENT_GUIDELINES_MARKDOWN } from './guidelines.js';
 export class AgileMonsterOrchestrator {
@@ -11,6 +12,10 @@ export class AgileMonsterOrchestrator {
         const projectConfig = this.client.loadProjectConfig();
         const provider = options?.provider || projectConfig?.provider || 'any';
         const boardId = options?.boardId || projectConfig?.board_id;
+        // STRICT BOARD SCOPE GUARD: Never poll across all boards when current folder is unbound!
+        if (!boardId) {
+            return [];
+        }
         const result = await this.client.listAssigned(provider, undefined, boardId);
         return result.cards || [];
     }
@@ -33,8 +38,10 @@ export class AgileMonsterOrchestrator {
             console.log(`🤖 Default Provider: ${config.provider || 'any'}`);
         }
         else {
-            console.log(`ℹ️  No .agilemonster.json found in current directory (${cwdName}).`);
-            console.log('   Run "agilemonster-orchestrator init" to bind this repo to a board.\n');
+            console.log(`⚠️  [UNBOUND REPOSITORY] No .agilemonster.json found in "${cwdName}".`);
+            console.log('   To prevent agents from picking up tasks from the wrong board and burning tokens:');
+            console.log('   Run "npx -y @agilemonster/mcp-server bootstrap" in this folder first!\n');
+            return;
         }
         console.log('\n🔍 Checking for assigned agent tasks...');
         const tasks = await this.checkTasks();
@@ -99,17 +106,54 @@ export class AgileMonsterOrchestrator {
         await poll();
         setInterval(poll, interval);
     }
+    detectGitRemote() {
+        try {
+            const out = execSync('git config --get remote.origin.url', {
+                cwd: process.cwd(),
+                stdio: ['ignore', 'pipe', 'ignore'],
+            })
+                .toString()
+                .trim();
+            return out || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    detectInstalledIdes() {
+        const homedir = process.env.HOME || process.env.USERPROFILE || '';
+        const detected = [];
+        if (fs.existsSync(path.resolve(process.cwd(), '.cursor')) ||
+            (homedir && fs.existsSync(path.join(homedir, '.cursor')))) {
+            detected.push('cursor');
+        }
+        if (fs.existsSync(path.resolve(process.cwd(), '.mcp.json')) ||
+            (homedir && fs.existsSync(path.join(homedir, '.claude')))) {
+            detected.push('claude_code');
+        }
+        if (homedir && fs.existsSync(path.join(homedir, '.gemini'))) {
+            detected.push('antigravity');
+        }
+        if (homedir && fs.existsSync(path.join(homedir, '.codeium', 'windsurf'))) {
+            detected.push('windsurf');
+        }
+        if (fs.existsSync(path.resolve(process.cwd(), '.vscode'))) {
+            detected.push('codex');
+        }
+        return detected.length > 0 ? detected : ['cursor', 'claude_code', 'antigravity'];
+    }
     async initInteractive(options) {
         console.log('\n======================================================');
         console.log('       👾 AGILE MONSTER 1-CLICK AGENT SETUP           ');
         console.log('======================================================\n');
+        const readline = await import('node:readline/promises');
+        const isInteractive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
         let apiKey = this.client.getApiKey();
         if (!apiKey) {
             console.log('🔑 No Agile Monster API key detected.');
             console.log('   1. Open: https://app.agilemonster.com/profile?setup=agents');
             console.log('   2. Click "Generate API key", then "Copy API key"');
             console.log('   3. Paste it below\n');
-            const readline = await import('node:readline/promises');
             const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
             try {
                 const inputKey = await rl.question('👉 Paste your Personal API Key (am_live_...): ');
@@ -128,23 +172,148 @@ export class AgileMonsterOrchestrator {
                 rl.close();
             }
         }
-        console.log('\n🔍 Discovering Agile Monster boards for this repository...');
-        const context = await this.client.getContext(path.basename(process.cwd()));
-        if (!context.available_boards || context.available_boards.length === 0) {
-            console.log('No boards found in your account. Please create a board first on https://app.agilemonster.com');
+        const folderName = path.basename(process.cwd());
+        const gitRemote = this.detectGitRemote();
+        const detectedIdes = this.detectInstalledIdes();
+        console.log(`\n🔍 Analyzing repository "${folderName}" with Agile Monster AI...`);
+        const context = await this.client.getContext(folderName, options?.board, gitRemote, detectedIdes);
+        const boards = context.available_boards || [];
+        const aiMatch = context.ai_match;
+        const suggestedNewBoardName = aiMatch?.suggested_new_board_name || folderName.replace(/\.(com|org|net)$/i, '');
+        let targetBoard = null;
+        if (options?.board) {
+            const needle = options.board.trim().toLowerCase();
+            targetBoard =
+                boards.find((b) => b.id.toLowerCase() === needle || b.name.trim().toLowerCase() === needle) || context.matched_board;
+        }
+        if (!targetBoard) {
+            if (aiMatch?.reason) {
+                console.log(`\n🤖 AI Guidance: ${aiMatch.reason}\n`);
+            }
+            if (isInteractive) {
+                console.log('📋 Which Agile Monster board should connect to this project folder?');
+                boards.forEach((b, idx) => {
+                    const isAiMatched = aiMatch?.matched_board_id === b.id;
+                    const badge = isAiMatched ? `  ✨ [AI Recommended Match]` : '';
+                    console.log(`   [${idx + 1}] ${b.name} (${b.workspace_name || 'Workspace'})${badge}`);
+                });
+                console.log(`   [N] + Create new board "${suggestedNewBoardName}"`);
+                const defaultIdx = aiMatch?.matched_board_id
+                    ? boards.findIndex((b) => b.id === aiMatch.matched_board_id) + 1
+                    : 0;
+                const defaultChoice = defaultIdx > 0 ? String(defaultIdx) : 'N';
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                try {
+                    const answer = (await rl.question(`\n👉 Select board [1-${boards.length} or N] (default: ${defaultChoice}): `))
+                        .trim()
+                        .toUpperCase();
+                    const choice = answer || defaultChoice;
+                    if (choice === 'N' || boards.length === 0) {
+                        const customTitle = (await rl.question(`👉 New board name (Press Enter for "${suggestedNewBoardName}"): `)).trim();
+                        const finalBoardName = customTitle || suggestedNewBoardName;
+                        const workspaceId = boards[0]?.workspace_id || context.workspaces?.[0]?.id || '';
+                        if (!workspaceId) {
+                            console.error('❌ No workspace found in your account. Please create a workspace on https://app.agilemonster.com first.');
+                            return;
+                        }
+                        console.log(`✨ Creating board "${finalBoardName}" with default Kanban columns...`);
+                        targetBoard = await this.client.createBoard(workspaceId, finalBoardName, `Connected to repository ${folderName}`);
+                        console.log(`✅ Created board "${targetBoard.name}" (${targetBoard.id})`);
+                    }
+                    else {
+                        const num = parseInt(choice, 10);
+                        if (!Number.isNaN(num) && num >= 1 && num <= boards.length) {
+                            const candidate = boards[num - 1];
+                            // Safety confirmation if user picks an existing board that AI said didn't match this folder
+                            if (aiMatch &&
+                                aiMatch.matched_board_id !== candidate.id &&
+                                candidate.name.toLowerCase() !== folderName.toLowerCase()) {
+                                const confirm = (await rl.question(`⚠️  Safety Check: Folder is "${folderName}" but board is "${candidate.name}". Are you sure they are the same project? [y/N]: `))
+                                    .trim()
+                                    .toLowerCase();
+                                if (confirm !== 'y' && confirm !== 'yes') {
+                                    console.log('❌ Cancelled to prevent connecting the wrong board.');
+                                    return;
+                                }
+                            }
+                            targetBoard = candidate;
+                        }
+                        else {
+                            console.error(`❌ Invalid selection "${choice}". Aborting so we never bind the wrong board.`);
+                            return;
+                        }
+                    }
+                }
+                finally {
+                    rl.close();
+                }
+            }
+            else {
+                // Non-interactive mode: ONLY auto-bind if AI matched with high confidence OR --board was explicitly passed.
+                // NEVER auto-pick a board or create a board silently if ambiguous!
+                if (context.matched_board && aiMatch?.confidence === 'high') {
+                    targetBoard = context.matched_board;
+                }
+                else {
+                    console.error(`❌ Ambiguous board match for folder "${folderName}" in non-interactive mode.`);
+                    console.error(`   Please run interactively in your terminal or pass --board="<Board Name>" explicitly so we never connect the wrong board.`);
+                    return;
+                }
+            }
+        }
+        if (!targetBoard) {
+            console.log('No board selected. Run "npx -y @agilemonster/mcp-server bootstrap" again to connect a board.');
             return;
         }
-        const targetBoard = context.matched_board || context.available_boards[0];
+        // Prompt for optional short custom agent tag on this board
+        let shortTag = '';
+        if (isInteractive) {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                console.log(`\n🏷️  On board "${targetBoard.name}", your agents will appear as:`);
+                console.log(`   "Cursor: ${targetBoard.name}", "Claude Code: ${targetBoard.name}", "Antigravity: ${targetBoard.name}"`);
+                const tagInput = (await rl.question(`👉 Optional: Enter a shorter project tag (e.g. "PG" -> "Cursor-PG"), or press Enter to keep "${targetBoard.name}": `)).trim();
+                shortTag = tagInput;
+            }
+            finally {
+                rl.close();
+            }
+        }
+        const providerTitles = {
+            cursor: 'Cursor',
+            claude_code: 'Claude Code',
+            antigravity: 'Antigravity',
+            windsurf: 'Windsurf',
+            codex: 'Codex',
+        };
+        try {
+            const agentEntries = Object.entries(providerTitles).map(([prov, label]) => ({
+                provider: prov,
+                custom_name: `${label}: ${targetBoard.name}`,
+                short_name: shortTag ? `${label}-${shortTag}` : null,
+                project_name: folderName,
+                project_path: process.cwd(),
+                git_remote: gitRemote || null,
+                connected: true,
+            }));
+            await this.client.saveBoardAgents(targetBoard.id, agentEntries, folderName, process.cwd(), gitRemote);
+            console.log(`🔗 Registered board agents for "${targetBoard.name}" on Agile Monster.`);
+        }
+        catch {
+            // Non-blocking if backend is older
+        }
         const savedPath = this.client.saveProjectConfig({
             workspace_id: targetBoard.workspace_id,
             board_id: targetBoard.id,
             board_name: targetBoard.name,
-            provider: 'antigravity',
+            project_name: folderName,
+            project_path: process.cwd(),
+            provider: options?.provider || 'antigravity',
             review_list: 'In Review',
             done_list: 'Done',
             api_key: apiKey,
         });
-        console.log(`✅ Bound repository to board "${targetBoard.name}" (${targetBoard.id})`);
+        console.log(`✅ Bound repository "${folderName}" -> Board "${targetBoard.name}" (${targetBoard.id})`);
         console.log(`   Config written to: ${savedPath}`);
         // Ensure AGENTS.md exists
         const agentsPath = path.resolve(process.cwd(), 'AGENTS.md');
@@ -156,19 +325,18 @@ export class AgileMonsterOrchestrator {
             console.log(`📄 AGENTS.md already exists in current directory.`);
         }
         // Configure IDEs (Cursor, Claude Code, Windsurf, Antigravity, VS Code)
-        this.configureIdes(apiKey, options?.provider);
+        this.configureIdes(apiKey, options?.ide || options?.provider);
         this.ensureGitignore();
-        console.log('\n🎉 Project successfully configured for AI Agents!');
+        console.log('\n🎉 Project successfully connected to Agile Monster!');
         console.log('\n======================================================');
         console.log('               🚀 HOW TO USE IT NOW                   ');
         console.log('======================================================');
-        console.log(`1. In Agile Monster (https://app.agilemonster.com), open board "${targetBoard.name}".`);
-        console.log('2. Create or open any card and assign it to your AI Agent (e.g. Antigravity, Cursor, Claude Code).');
-        console.log('3. In your AI IDE chat, simply say:');
+        console.log(`1. Open board "${targetBoard.name}" on https://app.agilemonster.com`);
+        console.log(`2. Open any card and assign Worker to "${shortTag ? `Cursor-${shortTag}` : `Cursor: ${targetBoard.name}`}" (or Claude Code / Antigravity).`);
+        console.log('3. In your AI IDE chat inside this project, simply say:');
         console.log('     "Check my Agile Monster tasks and start the next queued card."');
-        console.log('   Or from your terminal anytime:');
-        console.log('     • Check board & queued tasks:  npx -y @agilemonster/mcp-server status');
-        console.log('     • Auto-watch & run daemon:     npx -y @agilemonster/mcp-server watch\n');
+        console.log('   Or connect another project folder (e.g. Planogram.ai in Cursor) anytime by running:');
+        console.log('     cd /path/to/other-project && npx -y @agilemonster/mcp-server bootstrap\n');
     }
     async bootstrapInteractive(options) {
         return this.initInteractive(options);

package/dist/server.js

@@ -512,12 +512,30 @@ Please strictly follow the Agile Monster Task Lifecycle Protocol:
                     const status = args.status;
                     const boardId = args.board_id || projectConfig?.board_id;
                     const workspaceId = projectConfig?.workspace_id;
+                    if (!boardId) {
+                        return {
+                            isError: true,
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `⚠️ [BOARD SCOPE GUARD] Current project folder "${path.basename(process.cwd())}" is not bound to an Agile Monster board (.agilemonster.json is missing).\n` +
+                                        `Refusing to list tasks across all boards so you never accidentally pick up a task from the wrong project and burn tokens.\n` +
+                                        `Please run "npx -y @agilemonster/mcp-server bootstrap" in this folder or call agilemonster_get_context first to bind the right board.`,
+                                },
+                            ],
+                        };
+                    }
                     const result = await client.listAssigned(provider, status, boardId, workspaceId);
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: JSON.stringify(result, null, 2),
+                                text: JSON.stringify({
+                                    bound_board_id: boardId,
+                                    bound_board_name: projectConfig?.board_name,
+                                    bound_project_name: projectConfig?.project_name || path.basename(process.cwd()),
+                                    ...result,
+                                }, null, 2),
                             },
                         ],
                     };
@@ -526,12 +544,25 @@ Please strictly follow the Agile Monster Task Lifecycle Protocol:
                     const cardId = args.card_id;
                     const provider = args.provider || projectConfig?.provider || 'antigravity';
                     const runRef = args.run_ref;
-                    const card = await client.claimTask(cardId, provider, runRef);
+                    const expectedBoardId = projectConfig?.board_id;
+                    if (!expectedBoardId) {
+                        return {
+                            isError: true,
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `⚠️ [BOARD SCOPE GUARD] Cannot claim card ${cardId} because this repository folder ("${path.basename(process.cwd())}") has no .agilemonster.json board binding.\n` +
+                                        `Run "npx -y @agilemonster/mcp-server bootstrap" first so we verify this folder matches the card's board.`,
+                                },
+                            ],
+                        };
+                    }
+                    const card = await client.claimTask(cardId, provider, runRef, expectedBoardId);
                     return {
                         content: [
                             {
                                 type: 'text',
-                                text: `Task claimed successfully. Status is now "in_progress".\n${JSON.stringify(card, null, 2)}`,
+                                text: `Task claimed successfully on board "${card.board_name || expectedBoardId}". Status is now "in_progress".\n${JSON.stringify(card, null, 2)}`,
                             },
                         ],
                     };

package/dist/types.d.ts

@@ -2,6 +2,8 @@ export interface AgileMonsterProjectConfig {
     workspace_id?: string;
     board_id?: string;
     board_name?: string;
+    project_name?: string;
+    project_path?: string;
     provider?: string;
     review_list?: string;
     done_list?: string;
@@ -38,10 +40,38 @@ export interface ColumnList {
     name: string;
     position: number;
 }
+export interface AiBoardMatch {
+    matched_board_id: string | null;
+    confidence: 'high' | 'medium' | 'none';
+    reason: string;
+    suggested_new_board_name: string;
+    suggested_short_code: string;
+}
+export interface BoardAgentConfig {
+    provider: string;
+    provider_label?: string;
+    board_id?: string;
+    board_name?: string;
+    default_name?: string;
+    custom_name?: string;
+    short_name?: string | null;
+    display_name?: string;
+    project_name?: string | null;
+    project_path?: string | null;
+    git_remote?: string | null;
+    connected?: boolean;
+    last_connected_at?: string | null;
+}
 export interface ContextResponse {
     matched_board: Board | null;
+    ai_match?: AiBoardMatch | null;
     available_boards: Board[];
+    workspaces?: Array<{
+        id: string;
+        name: string;
+    }>;
     lists: ColumnList[];
+    board_agents?: BoardAgentConfig[];
     active_agent_tasks: Card[];
     supported_providers: string[];
 }

package/dist/worker.js

@@ -1,4 +1,5 @@
 import { spawn } from 'node:child_process';
+import path from 'node:path';
 import { AgileMonsterClient } from './client.js';
 export class AgileMonsterWorker {
     client;
@@ -59,8 +60,11 @@ export class AgileMonsterWorker {
         const projectConfig = this.client.loadProjectConfig();
         const provider = options.provider || projectConfig?.provider || 'antigravity';
         const boardId = options.boardId || projectConfig?.board_id;
+        if (!boardId) {
+            throw new Error(`[Board Scope Guard] No .agilemonster.json board binding found in "${path.basename(process.cwd())}". Refusing to poll tasks without an explicit board binding.`);
+        }
         const res = await this.client.listAssigned(provider, 'queued', boardId);
-        const tasks = res.cards || [];
+        const tasks = (res.cards || []).filter((c) => !c.board_id || c.board_id === boardId);
         if (tasks.length === 0) {
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agilemonster/mcp-server",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "description": "Official Model Context Protocol (MCP) server & Orchestrator for Agile Monster (Cursor, Claude Code, Antigravity, Codex, Hermes, Windsurf)",
   "main": "dist/server.js",