olly-molly 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+<p align="center">
+  <img src="app-icon.png" width="80" height="80" alt="Olly Molly">
+</p>
+
+<h1 align="center">Olly Molly</h1>
+
+<p align="center">
+  <strong>Your AI Development Team, Running Locally</strong>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#how-it-works">How It Works</a> •
+  <a href="#contributing">Contributing</a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/olly-molly?style=flat-square" alt="npm version">
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="license">
+  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square" alt="PRs welcome">
+</p>
+
+---
+
+**Olly Molly** is a local-first AI development team manager. Assign tasks to AI agents (PM, Frontend, Backend, QA) and watch them work on your codebase—all from a beautiful kanban board interface.
+
+## Quick Start
+
+```bash
+npx olly-molly
+```
+
+That's it. Open `http://localhost:1234` and start managing your AI team.
+
+## Features
+
+- 🎯 **Kanban Board** — Drag-and-drop task management
+- 🤖 **AI Agents** — PM, Frontend Dev, Backend Dev, QA agents
+- 💬 **Natural Requests** — Ask PM in plain language, get structured tickets
+- 🔒 **Local-First** — Everything runs on your machine
+- 🎨 **Minimal Design** — Clean, paper-like UI inspired by fontshare.com
+- 🌙 **Dark Mode** — Easy on the eyes
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                      Olly Molly                         │
+├─────────────────────────────────────────────────────────┤
+│                                                         │
+│  You ──▶ PM Agent ──▶ Creates Tickets                  │
+│              │                                          │
+│              ▼                                          │
+│  ┌─────────────────────────────────────────────────┐   │
+│  │  TODO  │  PROGRESS  │  REVIEW  │  DONE  │ HOLD  │   │
+│  │   📋   │     🔄     │    👀    │   ✅   │  ⏸️   │   │
+│  └─────────────────────────────────────────────────┘   │
+│              │                                          │
+│              ▼                                          │
+│  Agents (FE/BE/QA) work on assigned tickets            │
+│              │                                          │
+│              ▼                                          │
+│  Code changes in YOUR local project                    │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Setup
+
+### Prerequisites
+
+- Node.js 18+
+- OpenAI API key (or compatible provider)
+
+### Run with npx (Recommended)
+
+```bash
+npx olly-molly
+```
+
+### Or install globally
+
+```bash
+npm install -g olly-molly
+olly-molly
+```
+
+### Development
+
+```bash
+git clone https://github.com/YOUR_USERNAME/olly-molly.git
+cd olly-molly
+npm install
+npm run dev
+```
+
+## Configuration
+
+On first launch, you'll be prompted to enter your OpenAI API key. This is stored locally in your browser's localStorage.
+
+You can also set it via environment variable:
+
+```bash
+export OPENAI_API_KEY=your-key-here
+npx olly-molly
+```
+
+## Project Selection
+
+1. Click "Select Project" in the header
+2. Add your project path (e.g., `/Users/you/my-app`)
+3. AI agents will work within that directory
+
+## Contributing
+
+We love contributions! Here's how you can help:
+
+### Ways to Contribute
+
+- 🐛 **Bug Reports** — Found a bug? Open an issue
+- 💡 **Feature Requests** — Have an idea? Let's discuss
+- 🔧 **Pull Requests** — Code contributions are welcome
+- 📖 **Documentation** — Help improve our docs
+- 🎨 **Design** — UI/UX improvements
+
+### Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/YOUR_USERNAME/olly-molly.git
+cd olly-molly
+
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Open http://localhost:1234
+```
+
+### Project Structure
+
+```
+olly-molly/
+├── app/                 # Next.js app router
+│   ├── api/            # API routes
+│   ├── design-system/  # Design system docs
+│   └── page.tsx        # Main dashboard
+├── components/         # React components
+│   ├── kanban/        # Kanban board
+│   ├── ui/            # Reusable UI components
+│   └── ...
+├── db/                 # SQLite schemas
+└── lib/               # Utilities
+```
+
+### Code Style
+
+- TypeScript for type safety
+- Functional components with hooks
+- CSS variables for theming
+- Minimal dependencies
+
+## Tech Stack
+
+- **Framework**: Next.js 16
+- **UI**: React 19, Tailwind CSS 4
+- **Database**: SQLite (better-sqlite3)
+- **Drag & Drop**: dnd-kit
+- **AI**: OpenAI API
+
+## License
+
+MIT © [Your Name]
+
+---
+
+<p align="center">
+  <sub>Built with ❤️ for developers who love AI</sub>
+</p>

package/app/api/agent/execute/route.ts

@@ -0,0 +1,157 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { ticketService, memberService, projectService, activityService, conversationService } from '@/lib/db';
+import { startBackgroundJob, AgentProvider } from '@/lib/agent-jobs';
+import { v4 as uuidv4 } from 'uuid';
+
+interface AgentExecuteRequest {
+    ticket_id: string;
+    feedback?: string;
+    provider?: AgentProvider;
+}
+
+function buildAgentPrompt(ticket: {
+    title: string;
+    description?: string | null;
+}, agent: {
+    name: string;
+    role: string;
+    system_prompt: string;
+}, project: {
+    name: string;
+    path: string;
+}, feedback?: string): string {
+    // Check if role is QA to add specific port instructions
+    const isQA = agent.role === 'QA';
+    const qaInstruction = isQA
+        ? `\nIMPORTANT:
+1. PORT CONFIGURATION: When running tests or starting servers for the TARGET PROJECT, you MUST use port 3001 (or any port other than 1234) to avoid conflict with this dashboard app. Use "PORT=3001 npm run dev" or equivalent.
+2. TOOL USAGE: You MUST use the **Playwright MCP** (https://github.com/microsoft/playwright-mcp) tools for automated testing. verify the available tools and use them for browser automation and testing. Do NOT rely solely on manual terminal commands.`
+        : '';
+
+    const feedbackSection = feedback
+        ? `\n\nIMPORTANT FEEDBACK FROM USER:\n${feedback}\n\nPlease address this feedback specifically in your implementation.`
+        : '';
+
+    return `You are acting as ${agent.name} (${agent.role}) for the project "${project.name}".
+
+${agent.system_prompt}
+
+---
+
+TASK TO COMPLETE:
+Title: ${ticket.title}
+${ticket.description ? `Description: ${ticket.description}` : ''}
+${feedbackSection}
+
+---
+
+INSTRUCTIONS:
+1. Analyze the task requirements carefully
+2. Make the necessary code changes to complete this task
+3. Focus only on what's needed for this specific task
+4. Write clean, well-documented code
+5. After completing, provide a brief summary of changes made
+6. If you make changes, commit them with a meaningful message
+7. CRITICAL: You are working on the external project "${project.name}". When starting its server, ALWAYS use port 3001 (e.g. "PORT=3001 npm run dev"). NEVER use port 1234.${qaInstruction}
+
+Please complete this task now.`;
+}
+
+export async function POST(request: NextRequest) {
+    try {
+        const body: AgentExecuteRequest = await request.json();
+
+        if (!body.ticket_id) {
+            return NextResponse.json({ error: 'ticket_id is required' }, { status: 400 });
+        }
+
+        // Get ticket
+        const ticket = ticketService.getById(body.ticket_id);
+        if (!ticket) {
+            return NextResponse.json({ error: 'Ticket not found' }, { status: 404 });
+        }
+
+        // Get assignee (agent)
+        if (!ticket.assignee_id) {
+            return NextResponse.json({ error: 'Ticket has no assignee' }, { status: 400 });
+        }
+
+        const agent = memberService.getById(ticket.assignee_id);
+        if (!agent) {
+            return NextResponse.json({ error: 'Agent not found' }, { status: 404 });
+        }
+
+        // Get active project
+        const project = projectService.getActive();
+        if (!project) {
+            return NextResponse.json({ error: 'No active project selected. Please select a project first.' }, { status: 400 });
+        }
+
+        // Build prompt
+        const prompt = buildAgentPrompt(ticket, agent, project, body.feedback);
+
+        // Use provided provider or default to 'claude'
+        const provider: AgentProvider = body.provider || 'claude';
+
+        // Generate job ID
+        const jobId = uuidv4();
+
+        // Update ticket status to IN_PROGRESS
+        ticketService.update(body.ticket_id, { status: 'IN_PROGRESS' }, agent.id);
+
+        // Create conversation for this execution
+        const conversation = conversationService.create({
+            ticket_id: body.ticket_id,
+            agent_id: agent.id,
+            provider,
+            prompt,
+            feedback: body.feedback,
+        });
+
+        // Log activity
+        activityService.log({
+            ticket_id: body.ticket_id,
+            member_id: agent.id,
+            action: 'AGENT_WORK_STARTED',
+            details: `${agent.name} started working on this task using ${provider === 'opencode' ? 'OpenCode' : 'Claude Code'}`,
+        });
+
+        // Start background job (non-blocking)
+        startBackgroundJob({
+            jobId,
+            conversationId: conversation.id,
+            ticketId: body.ticket_id,
+            agentId: agent.id,
+            agentName: agent.name,
+            projectPath: project.path,
+            prompt,
+            provider,
+        });
+
+        // Return immediately with job info
+        return NextResponse.json({
+            success: true,
+            job_id: jobId,
+            conversation_id: conversation.id,
+            message: `${agent.name} started working on the task. The job is running in the background.`,
+            agent: {
+                id: agent.id,
+                name: agent.name,
+                role: agent.role,
+                avatar: agent.avatar,
+            },
+            project: {
+                id: project.id,
+                name: project.name,
+                path: project.path,
+            },
+            ticket_status: 'IN_PROGRESS',
+        });
+    } catch (error) {
+        console.error('Error executing agent:', error);
+        return NextResponse.json({
+            error: 'Failed to execute agent',
+            details: String(error)
+        }, { status: 500 });
+    }
+}

package/app/api/agent/status/route.ts

@@ -0,0 +1,38 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getRunningJobs, getJobByTicketId, getJobOutput, cancelJob } from '@/lib/agent-jobs';
+
+// Get all running jobs
+export async function GET(request: NextRequest) {
+    const url = new URL(request.url);
+    const ticketId = url.searchParams.get('ticket_id');
+    const jobId = url.searchParams.get('job_id');
+
+    if (jobId) {
+        // Get specific job output
+        const output = getJobOutput(jobId);
+        return NextResponse.json({ output });
+    }
+
+    if (ticketId) {
+        // Get job for specific ticket
+        const job = getJobByTicketId(ticketId);
+        return NextResponse.json({ job });
+    }
+
+    // Get all running jobs
+    const jobs = getRunningJobs();
+    return NextResponse.json({ jobs });
+}
+
+// Cancel a job
+export async function DELETE(request: NextRequest) {
+    const url = new URL(request.url);
+    const jobId = url.searchParams.get('job_id');
+
+    if (!jobId) {
+        return NextResponse.json({ error: 'job_id is required' }, { status: 400 });
+    }
+
+    const cancelled = cancelJob(jobId);
+    return NextResponse.json({ success: cancelled });
+}

package/app/api/check-api-key/route.ts

@@ -0,0 +1,12 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+export async function GET(request: NextRequest) {
+    try {
+        // Check if OPENAI_API_KEY exists in environment
+        const hasKey = !!process.env.OPENAI_API_KEY;
+
+        return NextResponse.json({ hasKey });
+    } catch (error) {
+        return NextResponse.json({ hasKey: false }, { status: 500 });
+    }
+}

package/app/api/conversations/[id]/route.ts

@@ -0,0 +1,35 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { conversationService, conversationMessageService } from '@/lib/db';
+
+interface RouteParams {
+    params: Promise<{
+        id: string;
+    }>;
+}
+
+// GET /api/conversations/[id]
+export async function GET(request: NextRequest, { params }: RouteParams) {
+    try {
+        // Await params for Next.js 15+
+        const { id } = await params;
+
+        const conversation = conversationService.getById(id);
+
+        if (!conversation) {
+            return NextResponse.json({ error: 'Conversation not found' }, { status: 404 });
+        }
+
+        const messages = conversationMessageService.getByConversationId(id);
+
+        return NextResponse.json({
+            conversation,
+            messages
+        });
+    } catch (error) {
+        console.error('Error fetching conversation:', error);
+        return NextResponse.json({
+            error: 'Failed to fetch conversation',
+            details: String(error)
+        }, { status: 500 });
+    }
+}

package/app/api/conversations/route.ts

@@ -0,0 +1,24 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { conversationService, conversationMessageService } from '@/lib/db';
+
+// GET /api/conversations?ticket_id=xxx
+export async function GET(request: NextRequest) {
+    try {
+        const { searchParams } = new URL(request.url);
+        const ticketId = searchParams.get('ticket_id');
+
+        if (!ticketId) {
+            return NextResponse.json({ error: 'ticket_id is required' }, { status: 400 });
+        }
+
+        const conversations = conversationService.getByTicketId(ticketId);
+
+        return NextResponse.json({ conversations });
+    } catch (error) {
+        console.error('Error fetching conversations:', error);
+        return NextResponse.json({
+            error: 'Failed to fetch conversations',
+            details: String(error)
+        }, { status: 500 });
+    }
+}

package/app/api/members/[id]/route.ts

@@ -0,0 +1,37 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { memberService } from '@/lib/db';
+
+export async function GET(
+    request: NextRequest,
+    { params }: { params: Promise<{ id: string }> }
+) {
+    try {
+        const { id } = await params;
+        const member = memberService.getById(id);
+        if (!member) {
+            return NextResponse.json({ error: 'Member not found' }, { status: 404 });
+        }
+        return NextResponse.json(member);
+    } catch (error) {
+        console.error('Error fetching member:', error);
+        return NextResponse.json({ error: 'Failed to fetch member' }, { status: 500 });
+    }
+}
+
+export async function PATCH(
+    request: NextRequest,
+    { params }: { params: Promise<{ id: string }> }
+) {
+    try {
+        const { id } = await params;
+        const body = await request.json();
+        const member = memberService.update(id, body);
+        if (!member) {
+            return NextResponse.json({ error: 'Member not found' }, { status: 404 });
+        }
+        return NextResponse.json(member);
+    } catch (error) {
+        console.error('Error updating member:', error);
+        return NextResponse.json({ error: 'Failed to update member' }, { status: 500 });
+    }
+}

package/app/api/members/route.ts

@@ -0,0 +1,12 @@
+import { NextResponse } from 'next/server';
+import { memberService } from '@/lib/db';
+
+export async function GET() {
+    try {
+        const members = memberService.getAll();
+        return NextResponse.json(members);
+    } catch (error) {
+        console.error('Error fetching members:', error);
+        return NextResponse.json({ error: 'Failed to fetch members' }, { status: 500 });
+    }
+}

package/app/api/pm/breakdown/route.ts

@@ -0,0 +1,142 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { ticketService, memberService } from '@/lib/db';
+import OpenAI from 'openai';
+
+const openai = new OpenAI({
+    apiKey: process.env.OPENAI_API_KEY,
+});
+
+/**
+ * PM Agent - AI-powered feature breakdown
+ * 
+ * Uses OpenAI to analyze feature requests and create appropriate tasks
+ * with intelligent assignment to team members.
+ */
+
+interface TaskFromAI {
+    title: string;
+    description: string;
+    priority: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    assignee_role: 'FE_DEV' | 'BACKEND_DEV' | 'QA' | 'DEVOPS';
+}
+
+const SYSTEM_PROMPT = `You are a PM (Project Manager) AI agent for a software development team.
+
+Your team consists of:
+- FE_DEV (Frontend Developer): Handles UI/UX, React, Next.js, CSS, components, user interfaces
+- BACKEND_DEV (Backend Developer): Handles APIs, databases, server logic, authentication, business logic
+- QA (QA Engineer): Handles testing, quality assurance, bug verification, E2E tests
+- DEVOPS (DevOps Engineer): Handles deployment, CI/CD, infrastructure, monitoring
+
+When given a feature request, you must:
+1. Break it down into specific, actionable tasks
+2. Assign each task to the appropriate team member based on their expertise
+3. Set priorities (CRITICAL > HIGH > MEDIUM > LOW)
+
+IMPORTANT RULES:
+- Create focused, single-responsibility tasks
+- Backend tasks should come before frontend integration tasks
+- Always include a QA task for testing
+- Be specific in task descriptions
+- Use Korean for titles and descriptions
+
+Respond in JSON format:
+{
+  "tasks": [
+    {
+      "title": "Task title in Korean",
+      "description": "Detailed task description in Korean",
+      "priority": "HIGH",
+      "assignee_role": "BACKEND_DEV"
+    }
+  ],
+  "summary": "Brief summary of the breakdown in Korean"
+}`;
+
+async function breakdownWithAI(request: string): Promise<{ tasks: TaskFromAI[]; summary: string }> {
+    const completion = await openai.chat.completions.create({
+        model: 'gpt-4o-mini',
+        messages: [
+            { role: 'system', content: SYSTEM_PROMPT },
+            { role: 'user', content: `Feature Request: ${request}` }
+        ],
+        response_format: { type: 'json_object' },
+        temperature: 0.7,
+        max_tokens: 2000,
+    });
+
+    const content = completion.choices[0].message.content;
+    if (!content) {
+        throw new Error('No response from AI');
+    }
+
+    return JSON.parse(content);
+}
+
+function getAssigneeByRole(role: string): string | null {
+    const member = memberService.getByRole(role);
+    return member?.id || null;
+}
+
+export async function POST(request: NextRequest) {
+    try {
+        const body = await request.json();
+
+        if (!body.request) {
+            return NextResponse.json(
+                { error: 'Feature request is required' },
+                { status: 400 }
+            );
+        }
+
+        if (!process.env.OPENAI_API_KEY) {
+            return NextResponse.json(
+                { error: 'OpenAI API key not configured' },
+                { status: 500 }
+            );
+        }
+
+        const pmMember = memberService.getByRole('PM');
+
+        // Use AI to break down the request
+        const aiResponse = await breakdownWithAI(body.request);
+
+        const createdTickets = [];
+
+        for (const task of aiResponse.tasks) {
+            const assigneeId = getAssigneeByRole(task.assignee_role);
+
+            const ticket = ticketService.create({
+                title: task.title,
+                description: task.description,
+                priority: task.priority,
+                assignee_id: assigneeId || undefined,
+                project_id: body.project_id,
+                created_by: pmMember?.id,
+            });
+
+            const assignee = assigneeId ? memberService.getById(assigneeId) : null;
+            createdTickets.push({
+                ...ticket,
+                assignee,
+                assigned_role: task.assignee_role,
+            });
+        }
+
+        return NextResponse.json({
+            success: true,
+            original_request: body.request,
+            created_by: pmMember,
+            tickets_created: createdTickets.length,
+            tickets: createdTickets,
+            ai_summary: aiResponse.summary,
+            message: `PM이 AI를 사용해 "${body.request}" 요청을 분석하여 ${createdTickets.length}개의 태스크를 생성했습니다.`,
+        }, { status: 201 });
+    } catch (error) {
+        console.error('Error in PM breakdown:', error);
+        return NextResponse.json(
+            { error: 'Failed to process feature request', details: String(error) },
+            { status: 500 }
+        );
+    }
+}