@joseph0926/plan-loop 1.0.2 → 1.0.3

package/README.md

@@ -4,7 +4,9 @@ Plan Loop is an MCP server that enables an asynchronous plan review loop between
 
 ## Repository layout
 
-- src/: MCP server source code (Node.js + TypeScript)
+- packages/cli/src/: MCP server source code (Node.js + TypeScript)
+- packages/core/src/: MCP core library (state + tools)
+- packages/vscode/: VSCode extension (Marketplace only)
 - .mcp.json.example: sample MCP server configuration (copy to `.mcp.json` to use)
 
 ## Quick start

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@joseph0926/plan-loop",
-  "version": "1.0.2",
-  "packageManager": "pnpm@10.28.0",
+  "version": "1.0.3",
   "description": "MCP server for Claude-Code and Codex async collaboration with CLI setup",
   "type": "module",
   "main": "dist/index.js",
@@ -16,16 +15,13 @@
     "node": ">=24.0.0"
   },
   "scripts": {
-    "build": "turbo run build && pnpm run build:mcp",
-    "build:mcp": "tsc",
-    "build:packages": "turbo run build",
+    "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
-    "test": "turbo run test",
-    "test:mcp": "vitest run",
+    "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "pnpm run build:mcp"
+    "prepublishOnly": "pnpm run build"
   },
   "keywords": [
     "mcp",
@@ -38,21 +34,24 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/joseph0926/plan-loop.git"
+    "url": "https://github.com/joseph0926/plan-loop",
+    "directory": "packages/cli"
   },
   "bugs": {
     "url": "https://github.com/joseph0926/plan-loop/issues"
   },
   "homepage": "https://github.com/joseph0926/plan-loop#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
-    "@joseph0926/plan-loop-core": "1.0.2",
+    "@joseph0926/plan-loop-core": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^2.0.0",
-    "turbo": "^2.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.0.0"
   }

package/README.ko.md

@@ -1,245 +0,0 @@
-# Plan Loop
-
-Plan Loop는 Claude-Code(설계자)와 Codex(검토자) 간의 비동기 계획 검토 루프를 디스크의 세션 상태 공유를 통해 가능하게 하는 MCP 서버입니다.
-
-## 저장소 구조
-
-- src/: MCP 서버 소스 코드 (Node.js + TypeScript)
-- .mcp.json.example: MCP 서버 설정 샘플 (`.mcp.json`으로 복사하여 사용)
-
-## 빠른 시작
-
-1) 설치 및 설정 (권장)
-
-```bash
-# npx로 1회 실행 (설치 불필요)
-npx @joseph0926/plan-loop setup
-
-# 또는 글로벌 설치
-npm install -g @joseph0926/plan-loop
-plan-loop setup
-```
-
-### 설정 옵션
-
-```bash
-plan-loop setup                    # Claude (project) + Codex (user) 모두 설정
-plan-loop setup --claude           # Claude Code만 (project scope)
-plan-loop setup --claude --user    # Claude Code (user scope, ~/.claude.json)
-plan-loop setup --codex            # Codex만 (user scope)
-```
-
-2) 수동 등록 (선택)
-
-**Claude Code** - `.mcp.json` (프로젝트) 또는 `~/.claude.json` (사용자)에 추가:
-
-```json
-{
-  "mcpServers": {
-    "plan-loop": {
-      "command": "npx",
-      "args": ["-y", "@joseph0926/plan-loop"]
-    }
-  }
-}
-```
-
-**Codex** - `~/.codex/config.toml`에 추가:
-
-```toml
-[mcp_servers.plan-loop]
-command = "npx"
-args = ["-y", "@joseph0926/plan-loop"]
-```
-
-3) 도구 사용 예시
-
-```text
-pl_start({ goal: "로그인 기능 계획" })
-pl_submit({ session_id: "abc123", plan: "1. ..." })
-pl_get_plan({ session_id: "abc123" })
-pl_feedback({ session_id: "abc123", rating: "🟢", content: "LGTM" })
-```
-
-## 도구 목록
-
-- pl_start: 세션 시작
-- pl_submit: 계획 제출
-- pl_get_plan: 최신 계획 조회
-- pl_feedback: 최신 계획에 대한 피드백 제출
-- pl_get_feedback: 최신 피드백 조회
-- pl_status: 전체 세션 데이터 조회
-- pl_list: 모든 세션 목록 (필터/정렬 지원)
-- pl_delete: 세션 삭제
-- pl_force_approve: exhausted 세션 강제 승인
-
-## 에이전트 협업
-
-Claude-Code(설계자)와 Codex(검토자)가 협업하여 계획을 검토합니다.
-
-### 빠른 시작
-
-```text
-# 1. Claude-Code: 세션 시작 및 계획 제출
-pl_start({ goal: "로그인 기능 구현" })
-pl_submit({ session_id: "...", plan: "1. DB 스키마..." })
-
-# 2. Codex: 계획 조회 및 피드백
-pl_get_plan({ session_id: "..." })
-pl_feedback({ session_id: "...", rating: "🟡", content: "인증 방식 명시 필요" })
-
-# 3. Claude-Code: 피드백 확인 및 수정
-pl_get_feedback({ session_id: "..." })
-pl_submit({ session_id: "...", plan: "수정된 계획..." })
-
-# 4. Codex: 승인
-pl_feedback({ session_id: "...", rating: "🟢", content: "LGTM" })
-```
-
-### 역할별 상세 지침
-
-자세한 워크플로우와 피드백 자동완성 가이드는 [AGENTS.md](AGENTS.md) 참조.
-
-## 상태 저장
-
-세션 파일은 `~/.plan-loop/sessions/`에 저장됩니다.
-
-## 상태 전이
-
-```
-                              pl_start
-                                  │
-                                  ▼
-                            [drafting]
-                                  │
-                             pl_submit
-                                  │
-                                  ▼
-                          [pending_review]
-                                  │
-                            pl_feedback
-                                  │
-        ┌─────────────────────────┼─────────────────────────┐
-        ▼                         ▼                         ▼
-    🔴 / 🟡                      🟢                   iteration >= max
-        │                         │                         │
-        ▼                         ▼                         ▼
-[pending_revision]           [approved]              [exhausted]
-        │                         │                         │
-   pl_submit                  pl_delete               pl_force_approve
-        │                         │                         │
-        ▼                         ▼                         ▼
-[pending_review]              [deleted]               [approved]
-```
-
-## 응답 형식
-
-### 성공 응답 (데이터 있음)
-```typescript
-{ ready: true, data: { ... } }
-```
-
-### 대기 응답 (데이터 없음)
-```typescript
-{ ready: false, reason: "no_plan_submitted" | "no_feedback_yet" | "awaiting_feedback" }
-```
-
-#### Pending reason 매핑
-- `pl_get_plan`: plan 없음 → `no_plan_submitted`
-- `pl_get_feedback`:
-  - plan 없음 → `no_plan_submitted`
-  - 최신 plan에 대한 피드백 대기 → `awaiting_feedback`
-  - 기타 피드백 없음 → `no_feedback_yet`
-
-### 에러 응답
-```typescript
-{
-  isError: true,
-  content: [{ type: "text", text: "Invalid state: current='approved', expected=['drafting']" }]
-}
-```
-
-## 세션 관리
-
-### pl_list 필터링 및 정렬
-
-```
-// status 필터
-> pl_list({ status: "approved" })
-> pl_list({ status: ["drafting", "pending_review"] })
-
-// 정렬
-> pl_list({ sort: "createdAt", order: "asc" })
-> pl_list({ sort: "updatedAt", order: "desc" })  // 기본값
-```
-
-### pl_delete 세션 삭제
-
-```
-// approved/exhausted 세션 삭제
-> pl_delete({ session_id: "abc123" })
-
-// 활성 세션 삭제 (force 필요)
-> pl_delete({ session_id: "abc123", force: true })
-```
-
-## 버전 규칙
-
-| 필드 | 증가 시점 |
-|------|-----------|
-| `version` | `pl_submit` 호출 시 +1 |
-| `iteration` | `pl_feedback`에서 🔴/🟡 시 +1 |
-
-`maxIterations`는 기본값 5이며 **1 이상의 정수**만 허용됩니다.
-
-## 설계 결정
-
-### 최신 plan 자동 매핑
-- `pl_feedback`은 항상 최신 plan에 매핑됨
-- planVersion 파라미터 없음 (단순화)
-- **Trade-off**: 동시 호출 시 race condition 가능 → 운영 규칙으로 관리
-
-### 역할 구분
-- 서버는 호출자를 검증하지 않음
-- Claude-Code는 submit 계열, Codex는 feedback 계열 사용 (약속)
-
-### 상태 영속화
-- `~/.plan-loop/sessions/{id}.json`
-- Atomic write (temp → rename)
-
-### goal 길이 제한
-- `pl_list` 응답에서 goal은 30자(UTF-16 코드 유닛 기준) 초과 시 `...` 추가
-- 최대 33자 (30자 + "...")
-
-## 개발
-
-```bash
-npm run dev
-npm run build
-```
-
-## 샘플 설정 파일
-
-프로젝트에 MCP 설정을 추가하려면:
-
-```bash
-cp .mcp.json.example .mcp.json
-```
-
-## 테스트
-
-```bash
-npm test              # 테스트 실행
-npm run test:watch    # 워치 모드
-npm run test:coverage # 커버리지 리포트
-```
-
-테스트 격리를 위해 `PLAN_LOOP_STATE_DIR` 환경변수를 지원합니다:
-
-```bash
-PLAN_LOOP_STATE_DIR=/tmp/test-sessions npm test
-```
-
-## 라이선스
-
-MIT