idea-manager 0.1.0

package/src/lib/mcp/server.ts

@@ -0,0 +1,117 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { getNextTask, getProjectContext, formatItemForMcp, formatTreeForMcp } from '@/lib/mcp/tools';
+import type { McpToolContext } from '@/lib/mcp/tools';
+
+export async function startMcpServer(ctx: McpToolContext) {
+  const server = new McpServer({
+    name: 'idea-manager',
+    version: '1.0.0',
+  });
+
+  // Tool 1: list-projects
+  server.tool(
+    'list-projects',
+    'IM 프로젝트 목록 조회',
+    {},
+    async () => {
+      const projects = ctx.listProjects();
+      const text = projects.length === 0
+        ? '프로젝트가 없습니다.'
+        : projects.map(p => `[${p.id}] ${p.name} - ${p.description}`).join('\n');
+      return { content: [{ type: 'text', text }] };
+    }
+  );
+
+  // Tool 2: get-project-context
+  server.tool(
+    'get-project-context',
+    '프로젝트 전체 구조와 상태 조회',
+    { projectId: z.string().describe('프로젝트 ID') },
+    async ({ projectId }) => {
+      const result = getProjectContext(ctx, projectId);
+      if (!result.project) {
+        return { content: [{ type: 'text', text: '프로젝트를 찾을 수 없습니다.' }] };
+      }
+
+      const lines = [
+        `프로젝트: ${result.project.name}`,
+        `설명: ${result.project.description}`,
+        '',
+        `전체: ${result.stats.total} | 대기: ${result.stats.pending} | 진행중: ${result.stats.inProgress} | 완료: ${result.stats.done} | 해제됨: ${result.stats.unlocked}`,
+        '',
+        '--- 구조 ---',
+        formatTreeForMcp(result.tree),
+      ];
+
+      return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+  );
+
+  // Tool 3: get-next-task
+  server.tool(
+    'get-next-task',
+    '다음 실행 가능한 작업과 프롬프트 조회 (해제 + 대기 상태)',
+    { projectId: z.string().describe('프로젝트 ID') },
+    async ({ projectId }) => {
+      const result = getNextTask(ctx, projectId);
+      if (!result) {
+        return { content: [{ type: 'text', text: '실행 가능한 작업이 없습니다. 항목을 해제(unlock)하세요.' }] };
+      }
+
+      const text = formatItemForMcp(result.item, result.prompt);
+      return { content: [{ type: 'text', text }] };
+    }
+  );
+
+  // Tool 4: get-prompt
+  server.tool(
+    'get-prompt',
+    '특정 항목의 프롬프트 조회',
+    { itemId: z.string().describe('항목 ID') },
+    async ({ itemId }) => {
+      const prompt = ctx.getPrompt(itemId);
+      if (!prompt) {
+        return { content: [{ type: 'text', text: '이 항목에 프롬프트가 없습니다. 웹 UI에서 먼저 생성하세요.' }] };
+      }
+      return { content: [{ type: 'text', text: prompt.content }] };
+    }
+  );
+
+  // Tool 5: update-status
+  server.tool(
+    'update-status',
+    '작업 상태 변경 (pending, in_progress, done)',
+    {
+      itemId: z.string().describe('항목 ID'),
+      status: z.enum(['pending', 'in_progress', 'done']).describe('새 상태'),
+    },
+    async ({ itemId, status }) => {
+      const updated = ctx.updateItem(itemId, { status });
+      if (!updated) {
+        return { content: [{ type: 'text', text: '항목을 찾을 수 없습니다.' }] };
+      }
+      return { content: [{ type: 'text', text: `${updated.title}: 상태가 '${status}'로 변경되었습니다.` }] };
+    }
+  );
+
+  // Tool 6: report-completion
+  server.tool(
+    'report-completion',
+    '작업 완료 보고 (상태를 done으로 변경 + 자동 잠금)',
+    { itemId: z.string().describe('항목 ID') },
+    async ({ itemId }) => {
+      const updated = ctx.updateItem(itemId, { status: 'done', is_locked: true });
+      if (!updated) {
+        return { content: [{ type: 'text', text: '항목을 찾을 수 없습니다.' }] };
+      }
+      return { content: [{ type: 'text', text: `✅ ${updated.title}: 완료 처리되었습니다. (자동 잠금)` }] };
+    }
+  );
+
+  // Start server with stdio transport
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('IM MCP server running on stdio');
+}

package/src/lib/mcp/tools.ts

@@ -0,0 +1,83 @@
+import type { IItemTree, IItem, IPrompt } from '@/types';
+
+// Re-export query functions for MCP tools
+// These are imported from DB queries when the MCP server initializes
+
+export interface McpToolContext {
+  listProjects: () => { id: string; name: string; description: string; created_at: string; updated_at: string }[];
+  getProject: (id: string) => { id: string; name: string; description: string } | undefined;
+  getItemTree: (projectId: string) => IItemTree[];
+  getItems: (projectId: string) => IItem[];
+  getPrompt: (itemId: string) => IPrompt | undefined;
+  updateItem: (id: string, data: Record<string, unknown>) => IItem | undefined;
+}
+
+export function getNextTask(ctx: McpToolContext, projectId: string): {
+  item: IItem;
+  prompt?: IPrompt;
+} | null {
+  const items = ctx.getItems(projectId);
+
+  // Find unlocked + pending items (ready to execute)
+  const ready = items.filter(i => !i.is_locked && i.status === 'pending');
+
+  if (ready.length === 0) return null;
+
+  // Sort by sort_order
+  ready.sort((a, b) => a.sort_order - b.sort_order);
+  const item = ready[0];
+  const prompt = ctx.getPrompt(item.id);
+
+  return { item, prompt };
+}
+
+export function getProjectContext(ctx: McpToolContext, projectId: string): {
+  project: { id: string; name: string; description: string } | undefined;
+  tree: IItemTree[];
+  stats: { total: number; pending: number; inProgress: number; done: number; unlocked: number };
+} {
+  const project = ctx.getProject(projectId);
+  const tree = ctx.getItemTree(projectId);
+  const items = ctx.getItems(projectId);
+
+  const stats = {
+    total: items.length,
+    pending: items.filter(i => i.status === 'pending').length,
+    inProgress: items.filter(i => i.status === 'in_progress').length,
+    done: items.filter(i => i.status === 'done').length,
+    unlocked: items.filter(i => !i.is_locked).length,
+  };
+
+  return { project, tree, stats };
+}
+
+export function formatItemForMcp(item: IItem, prompt?: IPrompt): string {
+  const lines = [
+    `제목: ${item.title}`,
+    `설명: ${item.description}`,
+    `유형: ${item.item_type}`,
+    `우선순위: ${item.priority}`,
+    `상태: ${item.status}`,
+    `잠금: ${item.is_locked ? '잠금' : '해제'}`,
+  ];
+
+  if (prompt) {
+    lines.push('', '--- 프롬프트 ---', prompt.content);
+  }
+
+  return lines.join('\n');
+}
+
+export function formatTreeForMcp(tree: IItemTree[], indent = 0): string {
+  const lines: string[] = [];
+  for (const item of tree) {
+    const prefix = '  '.repeat(indent);
+    const lock = item.is_locked ? '🔐' : '🔓';
+    const status = item.status === 'done' ? '✅' : item.status === 'in_progress' ? '🔄' : '⏳';
+    lines.push(`${prefix}${lock} ${item.title} ${status}`);
+    if (item.children.length > 0) {
+      lines.push(formatTreeForMcp(item.children, indent + 1));
+    }
+  }
+  return lines.join('\n');
+}

package/src/lib/utils/id.ts

@@ -0,0 +1,5 @@
+import { nanoid } from 'nanoid';
+
+export function generateId(): string {
+  return nanoid(16);
+}

package/src/lib/utils/paths.ts

@@ -0,0 +1,16 @@
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+
+const DATA_DIR = path.join(os.homedir(), '.idea-manager', 'data');
+
+export function getDataDir(): string {
+  if (!fs.existsSync(DATA_DIR)) {
+    fs.mkdirSync(DATA_DIR, { recursive: true });
+  }
+  return DATA_DIR;
+}
+
+export function getDbPath(): string {
+  return path.join(getDataDir(), 'im.db');
+}

package/src/types/index.ts

@@ -0,0 +1,97 @@
+export interface IProject {
+  id: string;
+  name: string;
+  description: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface IBrainstorm {
+  id: string;
+  project_id: string;
+  content: string;
+  version: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export type ItemType = 'feature' | 'task' | 'bug' | 'idea' | 'note';
+export type ItemStatus = 'pending' | 'in_progress' | 'done';
+export type ItemPriority = 'high' | 'medium' | 'low';
+
+export interface IItem {
+  id: string;
+  project_id: string;
+  brainstorm_id: string | null;
+  parent_id: string | null;
+  title: string;
+  description: string;
+  item_type: ItemType;
+  priority: ItemPriority;
+  status: ItemStatus;
+  is_locked: boolean;
+  sort_order: number;
+  metadata: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface IItemTree extends IItem {
+  children: IItemTree[];
+}
+
+export interface IStructureResult {
+  items: {
+    id?: string;
+    parent_id: string | null;
+    title: string;
+    description: string;
+    item_type: ItemType;
+    priority: ItemPriority;
+    children?: IStructureResult['items'];
+  }[];
+}
+
+export interface IConversation {
+  id: string;
+  project_id: string;
+  role: 'assistant' | 'user';
+  content: string;
+  metadata: string | null;
+  created_at: string;
+}
+
+export interface IMemo {
+  id: string;
+  project_id: string;
+  conversation_id: string | null;
+  anchor_text: string;
+  question: string;
+  is_resolved: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface IPrompt {
+  id: string;
+  project_id: string;
+  item_id: string;
+  content: string;
+  prompt_type: 'auto' | 'manual';
+  version: number;
+  created_at: string;
+}
+
+export interface IStructureWithQuestions {
+  items: {
+    title: string;
+    description: string;
+    item_type: ItemType;
+    priority: ItemPriority;
+    children?: IStructureWithQuestions['items'];
+  }[];
+  questions: {
+    anchor_text: string;
+    question: string;
+  }[];
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}