@agilemonster/mcp-server 0.0.0-stage → 1.0.1

package/dist/orchestrator.d.ts

@@ -0,0 +1,27 @@
+import { AgileMonsterClient } from './client.js';
+import { Card } from './types.js';
+export interface OrchestratorOptions {
+    watch?: boolean;
+    intervalMs?: number;
+    provider?: string;
+    boardId?: string;
+}
+export declare class AgileMonsterOrchestrator {
+    private client;
+    constructor(client?: AgileMonsterClient);
+    checkTasks(options?: {
+        provider?: string;
+        boardId?: string;
+    }): Promise<Card[]>;
+    printDashboard(): Promise<void>;
+    runDaemon(options?: OrchestratorOptions): Promise<void>;
+    initInteractive(options?: {
+        provider?: string;
+        ide?: string;
+    }): Promise<void>;
+    bootstrapInteractive(options?: {
+        provider?: string;
+        ide?: string;
+    }): Promise<void>;
+    configureIdes(apiKey: string, selectedIde?: string): void;
+}

package/dist/orchestrator.js

@@ -0,0 +1,306 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { AgileMonsterClient } from './client.js';
+import { AGENT_GUIDELINES_MARKDOWN } from './guidelines.js';
+export class AgileMonsterOrchestrator {
+    client;
+    constructor(client = new AgileMonsterClient()) {
+        this.client = client;
+    }
+    async checkTasks(options) {
+        const projectConfig = this.client.loadProjectConfig();
+        const provider = options?.provider || projectConfig?.provider || 'any';
+        const boardId = options?.boardId || projectConfig?.board_id;
+        const result = await this.client.listAssigned(provider, undefined, boardId);
+        return result.cards || [];
+    }
+    async printDashboard() {
+        console.log('\n======================================================');
+        console.log('       👾 AGILE MONSTER AGENT ORCHESTRATOR           ');
+        console.log('======================================================\n');
+        const config = this.client.loadProjectConfig();
+        const cwdName = path.basename(process.cwd());
+        try {
+            const me = await this.client.me();
+            console.log(`👤 Connected as: ${me.email} (${me.first_name || ''} ${me.last_name || ''})`);
+        }
+        catch (e) {
+            console.error(`❌ Authentication failed: ${e.message}`);
+            return;
+        }
+        if (config?.board_id) {
+            console.log(`📁 Project bound to Board: ${config.board_id} (${config.board_name || cwdName})`);
+            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('\n🔍 Checking for assigned agent tasks...');
+        const tasks = await this.checkTasks();
+        if (tasks.length === 0) {
+            console.log('✨ No pending tasks assigned to agents for this project right now.');
+            console.log('   Assign a card to an AI agent in the Agile Monster board to get started!\n');
+            return;
+        }
+        console.log(`\n📋 Found ${tasks.length} active agent task(s):\n`);
+        for (const t of tasks) {
+            const statusIcon = t.agent_status === 'queued'
+                ? '⏳ [QUEUED]'
+                : t.agent_status === 'in_progress'
+                    ? '⚙️ [IN PROGRESS]'
+                    : t.agent_status === 'waiting_for_input'
+                        ? '❓ [WAITING INPUT]'
+                        : t.agent_status === 'review'
+                            ? '🔍 [IN REVIEW]'
+                            : `[${t.agent_status?.toUpperCase() || 'ASSIGNED'}]`;
+            console.log(`------------------------------------------------------`);
+            console.log(`${statusIcon} ${t.title}`);
+            console.log(`   ID:       ${t.id}`);
+            console.log(`   Column:   ${t.list_name || t.list_id}`);
+            console.log(`   Board:    ${t.board_name || t.board_id}`);
+            console.log(`   Worker:   ${t.agent_provider || 'any'}`);
+            if (t.description) {
+                const preview = t.description.slice(0, 120).replace(/\n/g, ' ');
+                console.log(`   Details:  ${preview}${t.description.length > 120 ? '...' : ''}`);
+            }
+            console.log(`   Actions:`);
+            console.log(`     • Claim:   agilemonster-orchestrator claim ${t.id}`);
+            console.log(`     • Review:  agilemonster-orchestrator review ${t.id} "Summary..."`);
+            console.log(`     • Question: agilemonster-orchestrator question ${t.id} "Question..."`);
+        }
+        console.log(`------------------------------------------------------\n`);
+    }
+    async runDaemon(options = {}) {
+        const interval = options.intervalMs || 15000;
+        console.log(`🚀 Starting Agile Monster Orchestrator daemon (polling every ${interval / 1000}s)...`);
+        console.log('Press Ctrl+C to stop.\n');
+        const seenTaskIds = new Set();
+        const poll = async () => {
+            try {
+                const tasks = await this.checkTasks(options);
+                for (const task of tasks) {
+                    if (task.agent_status === 'queued' && !seenTaskIds.has(task.id)) {
+                        seenTaskIds.add(task.id);
+                        console.log(`\n🔔 [NEW TASK DETECTED] ${task.title}`);
+                        console.log(`   Card ID: ${task.id}`);
+                        console.log(`   Board:   ${task.board_name || task.board_id}`);
+                        console.log(`   Worker:  ${task.agent_provider || 'agent'}`);
+                        if (task.description) {
+                            console.log(`   Description:\n${task.description}\n`);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.error(`[Orchestrator Polling Error]: ${err.message}`);
+            }
+        };
+        await poll();
+        setInterval(poll, interval);
+    }
+    async initInteractive(options) {
+        console.log('\n======================================================');
+        console.log('       👾 AGILE MONSTER 1-CLICK AGENT SETUP           ');
+        console.log('======================================================\n');
+        let apiKey = this.client.getApiKey();
+        if (!apiKey) {
+            console.log('🔑 No Agile Monster API key detected.');
+            console.log('   Generate an API key in: https://app.agilemonster.com/profile (API Keys tab)\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_...): ');
+                if (inputKey && inputKey.trim()) {
+                    apiKey = inputKey.trim();
+                    this.client.setApiKey(apiKey);
+                    AgileMonsterClient.saveGlobalConfig({ api_key: apiKey });
+                    console.log('✅ API key saved to ~/.agilemonster/config.json (usable across all projects)!');
+                }
+                else {
+                    console.error('❌ API key is required to connect to Agile Monster.');
+                    return;
+                }
+            }
+            finally {
+                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');
+            return;
+        }
+        const targetBoard = context.matched_board || context.available_boards[0];
+        const savedPath = this.client.saveProjectConfig({
+            workspace_id: targetBoard.workspace_id,
+            board_id: targetBoard.id,
+            board_name: targetBoard.name,
+            provider: 'antigravity',
+            review_list: 'In Review',
+            done_list: 'Done',
+            api_key: apiKey,
+        });
+        console.log(`✅ Bound repository to board "${targetBoard.name}" (${targetBoard.id})`);
+        console.log(`   Config written to: ${savedPath}`);
+        // Ensure AGENTS.md exists
+        const agentsPath = path.resolve(process.cwd(), 'AGENTS.md');
+        if (!fs.existsSync(agentsPath)) {
+            fs.writeFileSync(agentsPath, AGENT_GUIDELINES_MARKDOWN, 'utf-8');
+            console.log(`📄 Created AGENTS.md with autonomous agent operational guidelines.`);
+        }
+        else {
+            console.log(`📄 AGENTS.md already exists in current directory.`);
+        }
+        // Configure IDEs (Cursor, Claude Code, Windsurf, Antigravity, VS Code)
+        this.configureIdes(apiKey, options?.provider);
+        console.log('\n🎉 Project successfully configured for AI Agents (Cursor, Claude Code, Antigravity, Windsurf)!');
+    }
+    async bootstrapInteractive(options) {
+        return this.initInteractive(options);
+    }
+    configureIdes(apiKey, selectedIde) {
+        const homedir = process.env.HOME || process.env.USERPROFILE || '';
+        const ide = (selectedIde || 'all').toLowerCase();
+        // 1. Cursor (.cursor/mcp.json)
+        if (ide === 'all' || ide === 'cursor') {
+            try {
+                const cursorDir = path.resolve(process.cwd(), '.cursor');
+                const cursorMcpPath = path.join(cursorDir, 'mcp.json');
+                if (!fs.existsSync(cursorDir))
+                    fs.mkdirSync(cursorDir, { recursive: true });
+                let existing = { mcpServers: {} };
+                if (fs.existsSync(cursorMcpPath)) {
+                    try {
+                        existing = JSON.parse(fs.readFileSync(cursorMcpPath, 'utf8'));
+                    }
+                    catch { }
+                }
+                existing.mcpServers = existing.mcpServers || {};
+                existing.mcpServers.agilemonster = {
+                    command: 'npx',
+                    args: ['-y', '@agilemonster/mcp-server'],
+                    env: {
+                        AGILEMONSTER_API_KEY: apiKey,
+                        AGILEMONSTER_API_URL: 'https://api.agilemonster.com',
+                    },
+                };
+                fs.writeFileSync(cursorMcpPath, JSON.stringify(existing, null, 2), 'utf8');
+                console.log(`🤖 Configured Cursor in: .cursor/mcp.json`);
+            }
+            catch (e) {
+                console.warn(`Could not write Cursor config: ${e.message}`);
+            }
+        }
+        // 2. Claude Code (.mcp.json)
+        if (ide === 'all' || ide === 'claude' || ide === 'claude_code') {
+            try {
+                const claudeMcpPath = path.resolve(process.cwd(), '.mcp.json');
+                let existing = { mcpServers: {} };
+                if (fs.existsSync(claudeMcpPath)) {
+                    try {
+                        existing = JSON.parse(fs.readFileSync(claudeMcpPath, 'utf8'));
+                    }
+                    catch { }
+                }
+                existing.mcpServers = existing.mcpServers || {};
+                existing.mcpServers.agilemonster = {
+                    command: 'npx',
+                    args: ['-y', '@agilemonster/mcp-server'],
+                    env: {
+                        AGILEMONSTER_API_KEY: apiKey,
+                        AGILEMONSTER_API_URL: 'https://api.agilemonster.com',
+                    },
+                };
+                fs.writeFileSync(claudeMcpPath, JSON.stringify(existing, null, 2), 'utf8');
+                console.log(`🤖 Configured Claude Code in: .mcp.json`);
+            }
+            catch (e) {
+                console.warn(`Could not write Claude Code config: ${e.message}`);
+            }
+        }
+        // 3. Windsurf (~/.codeium/windsurf/mcp_config.json)
+        if ((ide === 'all' || ide === 'windsurf') && homedir) {
+            try {
+                const windsurfDir = path.join(homedir, '.codeium', 'windsurf');
+                const windsurfMcpPath = path.join(windsurfDir, 'mcp_config.json');
+                if (fs.existsSync(windsurfDir) || ide === 'windsurf') {
+                    if (!fs.existsSync(windsurfDir))
+                        fs.mkdirSync(windsurfDir, { recursive: true });
+                    let existing = { mcpServers: {} };
+                    if (fs.existsSync(windsurfMcpPath)) {
+                        try {
+                            existing = JSON.parse(fs.readFileSync(windsurfMcpPath, 'utf8'));
+                        }
+                        catch { }
+                    }
+                    existing.mcpServers = existing.mcpServers || {};
+                    existing.mcpServers.agilemonster = {
+                        command: 'npx',
+                        args: ['-y', '@agilemonster/mcp-server'],
+                        env: {
+                            AGILEMONSTER_API_KEY: apiKey,
+                            AGILEMONSTER_API_URL: 'https://api.agilemonster.com',
+                        },
+                    };
+                    fs.writeFileSync(windsurfMcpPath, JSON.stringify(existing, null, 2), 'utf8');
+                    console.log(`🤖 Configured Windsurf in: ~/.codeium/windsurf/mcp_config.json`);
+                }
+            }
+            catch { }
+        }
+        // 4. Antigravity / Gemini (~/.gemini/antigravity/mcp/agilemonster.json)
+        if ((ide === 'all' || ide === 'antigravity' || ide === 'gemini') && homedir) {
+            try {
+                const antigravityDir = path.join(homedir, '.gemini', 'antigravity', 'mcp');
+                const antigravityMcpPath = path.join(antigravityDir, 'agilemonster.json');
+                if (fs.existsSync(antigravityDir) || ide === 'antigravity') {
+                    if (!fs.existsSync(antigravityDir))
+                        fs.mkdirSync(antigravityDir, { recursive: true });
+                    const config = {
+                        command: 'npx',
+                        args: ['-y', '@agilemonster/mcp-server'],
+                        env: {
+                            AGILEMONSTER_API_KEY: apiKey,
+                            AGILEMONSTER_API_URL: 'https://api.agilemonster.com',
+                        },
+                    };
+                    fs.writeFileSync(antigravityMcpPath, JSON.stringify(config, null, 2), 'utf8');
+                    console.log(`🤖 Configured Antigravity in: ~/.gemini/antigravity/mcp/agilemonster.json`);
+                }
+            }
+            catch { }
+        }
+        // 5. VS Code (.vscode/mcp.json)
+        if (ide === 'all' || ide === 'vscode' || ide === 'codex') {
+            try {
+                const vscodeDir = path.resolve(process.cwd(), '.vscode');
+                const vscodeMcpPath = path.join(vscodeDir, 'mcp.json');
+                if (fs.existsSync(vscodeDir) || ide === 'vscode') {
+                    if (!fs.existsSync(vscodeDir))
+                        fs.mkdirSync(vscodeDir, { recursive: true });
+                    let existing = { mcpServers: {} };
+                    if (fs.existsSync(vscodeMcpPath)) {
+                        try {
+                            existing = JSON.parse(fs.readFileSync(vscodeMcpPath, 'utf8'));
+                        }
+                        catch { }
+                    }
+                    existing.mcpServers = existing.mcpServers || {};
+                    existing.mcpServers.agilemonster = {
+                        command: 'npx',
+                        args: ['-y', '@agilemonster/mcp-server'],
+                        env: {
+                            AGILEMONSTER_API_KEY: apiKey,
+                            AGILEMONSTER_API_URL: 'https://api.agilemonster.com',
+                        },
+                    };
+                    fs.writeFileSync(vscodeMcpPath, JSON.stringify(existing, null, 2), 'utf8');
+                    console.log(`🤖 Configured VS Code in: .vscode/mcp.json`);
+                }
+            }
+            catch { }
+        }
+    }
+}

package/dist/server.d.ts

@@ -0,0 +1,37 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { AgileMonsterClient } from './client.js';
+export declare function createServer(client?: AgileMonsterClient): Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+export declare function runStdioServer(): Promise<void>;