@joseph0926/plan-loop 1.0.0

package/dist/index.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * Plan Loop MCP Server
+ * Claude-Code와 Codex 간의 비동기 협업을 위한 MCP 서버
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import * as tools from './tools.js';
+// Create server instance
+const server = new Server({
+    name: 'plan-loop-mcp',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Tool definitions
+const TOOL_DEFINITIONS = [
+    {
+        name: 'pl_start',
+        description: 'Start a new plan loop session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                goal: {
+                    type: 'string',
+                    description: 'The goal of this planning session',
+                },
+                maxIterations: {
+                    type: 'number',
+                    description: 'Maximum feedback iterations (default: 5)',
+                },
+            },
+            required: ['goal'],
+        },
+    },
+    {
+        name: 'pl_submit',
+        description: 'Submit a plan for review. Allowed states: drafting, pending_revision',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+                plan: {
+                    type: 'string',
+                    description: 'The plan content',
+                },
+            },
+            required: ['session_id', 'plan'],
+        },
+    },
+    {
+        name: 'pl_get_plan',
+        description: 'Get the latest plan from a session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+    {
+        name: 'pl_feedback',
+        description: 'Submit feedback for the latest plan. Allowed states: pending_review',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+                rating: {
+                    type: 'string',
+                    enum: ['🔴', '🟡', '🟢'],
+                    description: 'Feedback rating: 🔴 (major revision), 🟡 (minor revision), 🟢 (approved)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Feedback content',
+                },
+            },
+            required: ['session_id', 'rating', 'content'],
+        },
+    },
+    {
+        name: 'pl_get_feedback',
+        description: 'Get the latest feedback for a session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+    {
+        name: 'pl_status',
+        description: 'Get the full status of a session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+    {
+        name: 'pl_list',
+        description: 'List all plan loop sessions. Supports filtering by status and sorting.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    oneOf: [
+                        { type: 'string', enum: ['drafting', 'pending_review', 'pending_revision', 'approved', 'exhausted'] },
+                        { type: 'array', items: { type: 'string', enum: ['drafting', 'pending_review', 'pending_revision', 'approved', 'exhausted'] } },
+                    ],
+                    description: 'Filter by status (single value or array)',
+                },
+                sort: {
+                    type: 'string',
+                    enum: ['createdAt', 'updatedAt'],
+                    description: 'Sort field (default: updatedAt)',
+                },
+                order: {
+                    type: 'string',
+                    enum: ['asc', 'desc'],
+                    description: 'Sort order (default: desc)',
+                },
+            },
+        },
+    },
+    {
+        name: 'pl_force_approve',
+        description: 'Force approve an exhausted session. Allowed states: exhausted',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Reason for force approval',
+                },
+            },
+            required: ['session_id', 'reason'],
+        },
+    },
+    {
+        name: 'pl_delete',
+        description: 'Delete a session. By default only approved/exhausted sessions can be deleted. Use force=true to delete active sessions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID',
+                },
+                force: {
+                    type: 'boolean',
+                    description: 'Force delete even if session is active (default: false)',
+                },
+            },
+            required: ['session_id'],
+        },
+    },
+];
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: TOOL_DEFINITIONS,
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    console.error(`[plan-loop] Tool called: ${name}`);
+    // 전역 입력 가드: 객체가 아니면 빈 객체로 대체
+    // 비객체 인자는 각 도구 함수 내 검증에서 "필수 필드 누락" 에러로 처리됨
+    const input = typeof args === 'object' && args !== null && !Array.isArray(args)
+        ? args
+        : {};
+    switch (name) {
+        case 'pl_start':
+            return tools.plStart(input);
+        case 'pl_submit':
+            return tools.plSubmit(input);
+        case 'pl_get_plan':
+            return tools.plGetPlan(input);
+        case 'pl_feedback':
+            return tools.plFeedback(input);
+        case 'pl_get_feedback':
+            return tools.plGetFeedback(input);
+        case 'pl_status':
+            return tools.plStatus(input);
+        case 'pl_list':
+            return tools.plList(input);
+        case 'pl_force_approve':
+            return tools.plForceApprove(input);
+        case 'pl_delete':
+            return tools.plDelete(input);
+        default:
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            };
+    }
+});
+// Start server
+async function main() {
+    console.error('[plan-loop] Starting MCP server...');
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[plan-loop] MCP server connected');
+}
+main().catch((err) => {
+    console.error('[plan-loop] Fatal error:', 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":"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"}

package/dist/setup/claude.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude Code MCP Setup
+ * Configures .mcp.json (project) or ~/.claude.json (user)
+ */
+export interface SetupOptions {
+    scope: 'project' | 'user';
+}
+export interface SetupResult {
+    success: boolean;
+    message: string;
+    filePath?: string;
+}
+/**
+ * Setup Claude Code MCP configuration
+ */
+export declare function setupClaude(options: SetupOptions): Promise<SetupResult>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/setup/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/setup/claude.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAa7E"}

package/dist/setup/claude.js

@@ -0,0 +1,114 @@
+/**
+ * Claude Code MCP Setup
+ * Configures .mcp.json (project) or ~/.claude.json (user)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const MCP_CONFIG = {
+    command: 'npx',
+    args: ['-y', '@joseph0926/plan-loop'],
+};
+/**
+ * Setup Claude Code MCP configuration
+ */
+export async function setupClaude(options) {
+    const { scope } = options;
+    try {
+        if (scope === 'project') {
+            return await setupProjectScope();
+        }
+        else {
+            return await setupUserScope();
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, message: `Failed to setup Claude: ${message}` };
+    }
+}
+/**
+ * Setup project-scoped .mcp.json in current directory
+ */
+async function setupProjectScope() {
+    const filePath = path.join(process.cwd(), '.mcp.json');
+    let config = {};
+    // Read existing config if exists
+    if (fs.existsSync(filePath)) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // Invalid JSON, start fresh
+            config = {};
+        }
+    }
+    // Ensure mcpServers object exists
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+        config.mcpServers = {};
+    }
+    const mcpServers = config.mcpServers;
+    // Check if plan-loop already exists
+    if (mcpServers['plan-loop']) {
+        // Update existing configuration
+        mcpServers['plan-loop'] = MCP_CONFIG;
+        fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+        return {
+            success: true,
+            message: `Updated plan-loop in ${filePath}`,
+            filePath,
+        };
+    }
+    // Add new configuration
+    mcpServers['plan-loop'] = MCP_CONFIG;
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+    return {
+        success: true,
+        message: `Added plan-loop to ${filePath}`,
+        filePath,
+    };
+}
+/**
+ * Setup user-scoped ~/.claude.json
+ */
+async function setupUserScope() {
+    const filePath = path.join(os.homedir(), '.claude.json');
+    let config = {};
+    // Read existing config if exists
+    if (fs.existsSync(filePath)) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch {
+            // Invalid JSON, start fresh but warn
+            console.log('   ⚠️  Warning: Existing ~/.claude.json was invalid, creating new file');
+            config = {};
+        }
+    }
+    // Ensure mcpServers object exists
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+        config.mcpServers = {};
+    }
+    const mcpServers = config.mcpServers;
+    // Check if plan-loop already exists
+    if (mcpServers['plan-loop']) {
+        mcpServers['plan-loop'] = MCP_CONFIG;
+        fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+        return {
+            success: true,
+            message: `Updated plan-loop in ${filePath}`,
+            filePath,
+        };
+    }
+    // Add new configuration
+    mcpServers['plan-loop'] = MCP_CONFIG;
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+    return {
+        success: true,
+        message: `Added plan-loop to ${filePath}`,
+        filePath,
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/setup/claude.js.map

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

package/dist/setup/codex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Codex MCP Setup
+ * Configures ~/.codex/config.toml
+ */
+export interface SetupResult {
+    success: boolean;
+    message: string;
+    filePath?: string;
+}
+/**
+ * Setup Codex MCP configuration in ~/.codex/config.toml
+ */
+export declare function setupCodex(): Promise<SetupResult>;
+//# sourceMappingURL=codex.d.ts.map

package/dist/setup/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/setup/codex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAmDvD"}

package/dist/setup/codex.js

@@ -0,0 +1,62 @@
+/**
+ * Codex MCP Setup
+ * Configures ~/.codex/config.toml
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import TOML from '@iarna/toml';
+const MCP_CONFIG = {
+    command: 'npx',
+    args: ['-y', '@joseph0926/plan-loop'],
+};
+/**
+ * Setup Codex MCP configuration in ~/.codex/config.toml
+ */
+export async function setupCodex() {
+    try {
+        const codexDir = path.join(os.homedir(), '.codex');
+        const filePath = path.join(codexDir, 'config.toml');
+        // Ensure ~/.codex directory exists
+        if (!fs.existsSync(codexDir)) {
+            fs.mkdirSync(codexDir, { recursive: true });
+        }
+        let config = {};
+        // Read existing config if exists
+        if (fs.existsSync(filePath)) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                config = TOML.parse(content);
+                console.log('   ⚠️  Note: TOML comments may be lost during update');
+            }
+            catch (parseError) {
+                // Invalid TOML, start fresh but warn
+                console.log('   ⚠️  Warning: Existing config.toml was invalid, creating new file');
+                config = {};
+            }
+        }
+        // Ensure mcp_servers object exists
+        if (!config.mcp_servers || typeof config.mcp_servers !== 'object') {
+            config.mcp_servers = {};
+        }
+        const mcpServers = config.mcp_servers;
+        // Check if plan-loop already exists
+        const existed = !!mcpServers['plan-loop'];
+        mcpServers['plan-loop'] = MCP_CONFIG;
+        // Write back to file
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tomlContent = TOML.stringify(config);
+        fs.writeFileSync(filePath, tomlContent);
+        const action = existed ? 'Updated' : 'Added';
+        return {
+            success: true,
+            message: `${action} plan-loop in ${filePath}`,
+            filePath,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, message: `Failed to setup Codex: ${message}` };
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/setup/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/setup/codex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,IAAI,MAAM,aAAa,CAAC;AAQ/B,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAEpD,mCAAmC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,GAA4B,EAAE,CAAC;QAEzC,iCAAiC;QACjC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;gBACxD,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;YACtE,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,qCAAqC;gBACrC,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;gBACnF,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAsC,CAAC;QAEjE,oCAAoC;QACpC,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC1C,UAAU,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC;QAErC,qBAAqB;QACrB,8DAA8D;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAa,CAAC,CAAC;QAClD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,GAAG,MAAM,iBAAiB,QAAQ,EAAE;YAC7C,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,OAAO,EAAE,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plan Loop MCP - State Management
+ * Atomic write (temp → rename) for safe concurrent access
+ */
+import type { Session, SessionStatus } from './types.js';
+/**
+ * Save session with atomic write
+ */
+export declare function save(session: Session): void;
+/**
+ * Load session by ID
+ * Returns null if not found or corrupted
+ */
+export declare function load(id: string): Session | null;
+export interface ListOptions {
+    status?: SessionStatus | SessionStatus[];
+    sort?: 'createdAt' | 'updatedAt';
+    order?: 'asc' | 'desc';
+}
+/**
+ * List all sessions (summary only)
+ * goal is truncated to 30 characters (UTF-16 units) + "..." if exceeded
+ * Supports filtering by status and sorting
+ */
+export declare function list(options?: ListOptions): {
+    id: string;
+    goal: string;
+    status: SessionStatus;
+    createdAt: string;
+    updatedAt: string;
+}[];
+/**
+ * Create a new session
+ */
+export declare function create(goal: string, maxIterations?: number): Session;
+/**
+ * Get latest plan from session
+ */
+export declare function getLatestPlan(session: Session): import("./types.js").Plan | null;
+/**
+ * Get latest feedback from session
+ */
+export declare function getLatestFeedback(session: Session): import("./types.js").Feedback | null;
+/**
+ * Delete session by ID
+ * Returns true if deleted, false if not found
+ */
+export declare function remove(id: string): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAezD;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS3C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAa/C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;IACzC,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,CAkD3I;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,OAAO,CAkB/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,oCAK7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,wCAKjD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAc1C"}