tower-studio 0.1.2 → 0.1.3

package/.next/standalone/tower/AGENTS.md

@@ -1,325 +0,0 @@
-<!-- BEGIN:nextjs-agent-rules -->
-# This is NOT the Next.js you know
-
-This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
-<!-- END:nextjs-agent-rules -->
-
-# currentDate
-Today's date is 2026-04-13.
-
----
-
-# Tower — Agent Reference
-
-## Project Overview
-
-Tower is an AI task management platform with a Kanban board UI. The core hierarchy is:
-
-```
-Workspace → Projects → Tasks
-```
-
-Workspaces are top-level containers. Each workspace holds multiple Projects and a shared set of Labels. Projects hold Tasks. Tasks are displayed as Kanban cards grouped by status.
-
----
-
-## Modules
-
-System modules for GSD phase scoping. Use the **Slug** as the commit scope (e.g. `feat(terminal-08.01): ...`).
-
-| Module | Slug | Description |
-|--------|------|-------------|
-| Workspace | `workspace` | 工作区 CRUD、标签管理 |
-| Project | `project` | 项目 CRUD、导入、git 仓库、描述生成 |
-| Task | `task` | 任务 CRUD、状态流转、Label、详情页 |
-| Board | `board` | 看板 UI、拖拽排序、筛选统计、置顶 |
-| Terminal | `terminal` | PTY 会话、WebSocket、xterm.js、CLI Profile |
-| Assistant | `assistant` | AI 助手聊天、SSE 流式、多模态 |
-| Missions | `missions` | 多任务监控面板、网格布局 |
-| Search | `search` | 全局搜索、代码搜索、FTS |
-| Settings | `settings` | 系统配置、CLI Profile、Agent 配置 |
-| MCP | `mcp` | MCP Server、23 个工具、stdio 传输 |
-| Git | `git` | Git 操作、Worktree、Diff、Merge |
-| Assets & Notes | `assets` | 项目资产上传、笔记系统 |
-| AI | `ai` | Claude SDK、CLI Adapter、执行总结、Prompt 管理 |
-| I18n | `i18n` | 国际化、zh/en 双语 |
-
-Detailed module documentation: [`docs/`](docs/README.md)
-
----
-
-## Data Model
-
-### Hierarchy
-
-```
-Workspace (id, name, description?)
-  ├── Project[] (id, name, alias?, description?, type, gitUrl?, localPath?)
-  │     └── Task[] (id, title, description?, status, priority, order)
-  │           ├── TaskLabel[] → Label
-  │           ├── TaskExecution[]
-  │           └── TaskMessage[]
-  └── Label[] (id, name, color, isBuiltin)
-```
-
-### Models
-
-**Workspace**
-- `id` (cuid), `name`, `description?`
-- Has many: `projects`, `labels`
-
-**Project**
-- `id` (cuid), `name`, `alias?`, `description?`
-- `type`: `NORMAL` | `GIT` — derived from whether `gitUrl` is set
-- `gitUrl?`, `localPath?`
-- `workspaceId` (FK → Workspace, cascade delete)
-- Has many: `tasks`, `repositories`
-
-**Task**
-- `id` (cuid), `title`, `description?`
-- `status`: `TODO` | `IN_PROGRESS` | `IN_REVIEW` | `DONE` | `CANCELLED` (default: `TODO`)
-- `priority`: `LOW` | `MEDIUM` | `HIGH` | `CRITICAL` (default: `MEDIUM`)
-- `order`: integer used for Kanban column ordering (ascending = top)
-- `projectId` (FK → Project, cascade delete)
-- Has many: `labels` (via TaskLabel), `executions`, `messages`
-
-**Label**
-- `id` (cuid), `name`, `color` (hex, default `#94a3b8`)
-- `workspaceId?` — null for builtin labels
-- `isBuiltin`: builtin labels are global and cannot be deleted
-
-**TaskExecution**
-- `id` (cuid), `taskId`, `agent` (default `CLAUDE_CODE`), `config?`
-- `status`: `PENDING` | `RUNNING` | `PAUSED` | `COMPLETED` | `FAILED`
-- `branch?`, `startedAt?`, `endedAt?`
-- `sessionId?` — Claude CLI session ID for resume support
-- `worktreePath?`, `worktreeBranch?` — git worktree isolation
-- `callbackUrl?` — external orchestrator callback URL
-
-**CliProfile**
-- `id` (cuid), `command` (default `claude`), `baseArgs` (JSON string array), `envVars` (JSON object)
-- `isDefault`: boolean — only one default profile allowed
-- Controls which CLI binary and arguments are used for PTY spawning
-
-**TaskMessage**
-- `id` (cuid), `taskId`, `executionId?`
-- `role`: `USER` | `ASSISTANT` | `SYSTEM`
-- `content`, `metadata?`
-
-**Repository**
-- `id` (cuid), `name`, `path`, `branch` (default `main`)
-- `projectId` (FK → Project, cascade delete)
-
-**AgentConfig**
-- `id` (cuid), `agent`, `configName`, `appendPrompt?`, `settings?`, `isDefault`
-- Unique constraint on `(agent, configName)`
-
----
-
-## MCP Server
-
-To expose Tower tools to an AI agent via MCP, add the following to your MCP client configuration:
-
-```json
-{
-  "mcpServers": {
-    "tower": {
-      "command": "npx",
-      "args": ["tsx", "<project-root>/src/mcp/index.ts"]
-    }
-  }
-}
-```
-
-Replace `<project-root>` with the absolute path to this repository.
-
----
-
-## Available MCP Tools
-
-23 tools across 7 categories.
-
-### Workspace Tools (`src/mcp/tools/workspace-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `list_workspaces` | List all workspaces ordered by last updated; includes project count | — |
-| `create_workspace` | Create a new workspace | `name`, `description?` |
-| `update_workspace` | Update name and/or description | `workspaceId`, `name?`, `description?` |
-| `delete_workspace` | Delete workspace (cascades to projects and tasks) | `workspaceId` |
-
-### Project Tools (`src/mcp/tools/project-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `list_projects` | List projects in a workspace; includes task and repository counts | `workspaceId` |
-| `create_project` | Create a project; type auto-set to GIT if gitUrl provided | `workspaceId`, `name`, `gitUrl?`, `localPath?` |
-| `update_project` | Update name, localPath, and/or description | `projectId`, `name?`, `localPath?`, `description?` |
-| `delete_project` | Delete a project (cascades to tasks) | `projectId` |
-
-### Task Tools (`src/mcp/tools/task-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `list_tasks` | List tasks in a project, ordered by `order` then `createdAt`; includes labels | `projectId`, `status?` |
-| `create_task` | Create a task with optional labels | `projectId`, `title`, `description?`, `priority?`, `status?`, `labelIds?`, `useWorktree?`, `baseBranch?`, `autoStart?`, `references?` |
-| `update_task` | Update title, description, priority, and/or labels (replaces all labels) | `taskId`, `title?`, `description?`, `priority?`, `labelIds?` |
-| `move_task` | Move task to a different status column | `taskId`, `status` |
-| `delete_task` | Delete a task | `taskId` |
-
-### Label Tools (`src/mcp/tools/label-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `list_labels` | List all labels for a workspace (builtin + workspace-specific) | `workspaceId` |
-| `create_label` | Create a custom label for a workspace | `workspaceId`, `name`, `color` |
-| `delete_label` | Delete a label by ID | `labelId` |
-| `set_task_labels` | Replace all labels on a task | `taskId`, `labelIds` |
-
-### Search Tools (`src/mcp/tools/search-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `search` | Search tasks, projects, or repositories by query string | `query`, `category?` (`task`\|`project`\|`repository`) |
-
-### Terminal Tools (`src/mcp/tools/terminal-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `get_task_terminal_output` | Get recent terminal output lines from a running task's PTY session | `taskId`, `lines?` (default 50, max 500) |
-| `send_task_terminal_input` | Send text input to a running task's PTY terminal (include `\n` for Enter) | `taskId`, `text` |
-| `get_task_execution_status` | Get execution status (running/idle/exited) with output snippet | `taskId` |
-
-### Report Tools (`src/mcp/tools/report-tools.ts`)
-
-| Tool | Description | Key Params |
-|------|-------------|------------|
-| `daily_summary` | Today's work summary — completed tasks, in-progress tasks with last chat summary, grouped by workspace → project | `date?` (YYYY-MM-DD) |
-| `daily_todo` | All pending tasks (TODO/IN_PROGRESS/IN_REVIEW), sorted by priority severity | `workspaceId?`, `projectId?`, `status?`, `priority?` |
-
----
-
-## Server Actions
-
-For AI working directly in the Next.js codebase, use these server actions (all in `src/actions/`).
-
-### `workspace-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `getWorkspaces` | `() → Workspace[]` |
-| `getWorkspaceById` | `(id) → Workspace \| null` |
-| `createWorkspace` | `({ name, description? }) → Workspace` |
-| `updateWorkspace` | `(id, { name?, description? }) → Workspace` |
-| `deleteWorkspace` | `(id) → void` |
-| `createProject` | `({ name, alias?, description?, gitUrl?, localPath?, workspaceId }) → Project` |
-| `updateProject` | `(id, { name?, alias?, description?, localPath? }) → Project` |
-| `deleteProject` | `(id) → void` |
-| `getProjectByLocalPath` | `(localPath) → Project \| null` |
-| `getRecentLocalProjects` | `(limit?) → Project[]` |
-| `getWorkspacesWithProjects` | `() → { id, name, projects: { id, name, alias }[] }[]` |
-| `getWorkspacesWithRecentTasks` | `(limit?) → { id, name, projects: { id, name, alias, tasks: Task[], _count }[] }[]` — includes recent tasks per project with last sessionId for resume |
-
-### `task-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `createTask` | `({ title, description?, projectId, priority?, status?, labelIds? }) → Task` |
-| `updateTask` | `(taskId, { title?, description?, priority?, labelIds? }) → Task` |
-| `updateTaskStatus` | `(taskId, status) → Task` |
-| `deleteTask` | `(taskId) → void` |
-| `getProjectTasks` | `(projectId) → Task[]` |
-
-### `label-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `getLabelsForWorkspace` | `(workspaceId) → Label[]` |
-| `createLabel` | `({ name, color, workspaceId }) → Label` |
-| `deleteLabel` | `(id) → void` |
-| `setTaskLabels` | `(taskId, labelIds) → void` |
-| `getTaskLabels` | `(taskId) → Label[]` |
-
-### `search-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `globalSearch` | `(query, category?) → SearchResult[]` |
-
-### `report-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `getDailySummary` | `(dateStr?) → DailySummaryResult` — tasks with activity on given date, grouped by workspace/project |
-| `getDailyTodo` | `(filters?) → DailyTodoResult` — pending tasks, filterable by workspace/project/status/priority |
-
-### `agent-actions.ts`
-
-| Function | Signature |
-|----------|-----------|
-| `sendTaskMessage` | `(taskId, content) → { userMessage, assistantMessage }` |
-| `getTaskMessages` | `(taskId) → TaskMessage[]` |
-| `startTaskExecution` | `(taskId, agent?) → TaskExecution` — also sets task status to IN_PROGRESS |
-| `stopTaskExecution` | `(executionId) → TaskExecution` — sets status to COMPLETED |
-| `stopPtyExecution` | `(taskId) → void` — stops the PTY session for a task |
-| `getTaskExecutions` | `(taskId) → TaskExecution[]` |
-| `startPtyExecution` | `(taskId, prompt) → { executionId, worktreePath }` — spawns Claude CLI in PTY with CliProfile settings |
-| `resumePtyExecution` | `(taskId, previousSessionId) → { executionId, worktreePath }` — resumes a previous Claude CLI session |
-| `getActiveExecutionsAcrossWorkspaces` | `() → ActiveExecutionInfo[]` — all RUNNING executions with workspace/project/task metadata |
-
----
-
-## Constraints
-
-- **Cascade deletes**: Deleting a Workspace deletes all its Projects; deleting a Project deletes all its Tasks; deleting a Task deletes its Messages and Executions.
-- **Builtin labels**: Labels with `isBuiltin: true` are global (no `workspaceId`). Do not delete them — enforce this check before calling `deleteLabel`.
-- **Task order**: The `order` field controls Kanban card position within a status column. Lower values appear higher. Always preserve existing order values when creating tasks unless explicitly reordering.
-- **Project type**: `type` is derived from `gitUrl` — always `GIT` when `gitUrl` is set, `NORMAL` otherwise. Do not set type independently.
-- **Label replacement**: `set_task_labels` / `setTaskLabels` / `update_task` with `labelIds` all perform a full replace, not a merge. Pass the complete desired set.
-- **PTY sessions**: Keyed by `taskId` — one active session per task. Use `startPtyExecution` to create, `resumePtyExecution` to resume with a `sessionId`, `stopPtyExecution` to kill.
-- **CliProfile**: Only one default profile (`isDefault: true`). `baseArgs` and `envVars` are JSON strings — parse before use.
-- **Environment injection**: `AI_MANAGER_TASK_ID` and `CALLBACK_URL` are injected into every PTY session environment. Never mutate `process.env` — use `envOverrides`.
-- **Internal HTTP bridge**: `/api/internal/terminal/[taskId]/buffer` (GET) and `/api/internal/terminal/[taskId]/input` (POST) — localhost-only routes for cross-process PTY access. MCP tools use these since MCP stdio processes cannot share in-memory PTY sessions.
-
----
-
-## Mission Control
-
-**Route:** `/missions` — multi-task monitoring dashboard across all workspaces.
-
-**Capabilities:**
-- View all RUNNING task executions with embedded xterm.js terminals
-- Grid layout presets (1×1, 2×1, 3×2, 2×2, 4×2, 3×3) persisted in localStorage
-- Workspace filter dropdown to narrow visible tasks
-- Launch new task execution or resume previous session from Task Picker
-- Stop execution (card removed) / auto-remove on natural completion
-- Drag-and-drop card reordering via dnd-kit
-- 4-second polling for live updates
-
-**For external orchestrators (OpenClaw/Paperclip):**
-
-To dispatch and monitor tasks programmatically, use MCP tools in this workflow:
-
-1. **Create task:** `create_task` → get `taskId`
-2. **Start execution:** Call `startPtyExecution(taskId, prompt)` via server action (or use the internal HTTP bridge)
-3. **Monitor:** `get_task_execution_status` for high-level status, `get_task_terminal_output` for live output
-4. **Send input:** `send_task_terminal_input` to interact with the running Claude CLI
-5. **Check completion:** Poll `get_task_execution_status` — `terminalStatus: "exited"` means done
-6. **Resume if needed:** `resumePtyExecution(taskId, sessionId)` to continue a previous session
-
-**ActiveExecutionInfo type** (returned by `getActiveExecutionsAcrossWorkspaces`):
-```typescript
-{
-  executionId: string;
-  taskId: string;
-  taskTitle: string;
-  projectId: string;
-  projectName: string;
-  projectAlias: string | null;
-  projectLocalPath: string | null;
-  workspaceId: string;
-  workspaceName: string;
-  worktreePath: string | null;
-  startedAt: string | null; // ISO string
-}
-```

package/.next/standalone/tower/CHANGELOG.md

@@ -1,63 +0,0 @@
-# [0.1.0](/compare/v1.0.0...v0.1.0) (2026-03-26)
-
-
-### Bug Fixes
-
-* address code review CRITICAL and HIGH issues 0cd6ac9
-* address remaining code review issues (H-4, M-2/4/6/7) a8fcb92
-
-
-### Features
-
-* add adapter execution engine with Claude Code support 0d1e66e
-* add MCP Server with 18 CRUD tools, AGENTS.md, and SKILL.md 93dd85e
-# [0.1.0](/compare/v1.0.0...v0.1.0) (2026-03-26)
-
-# [1.0.0](/compare/9e77b515af277ff8d2b82bba73b491b7e79cdaa2...v1.0.0) (2026-03-26)
-
-
-### Bug Fixes
-
-* add router.refresh after all server actions, fix task detail messages ca00627
-* board height, project tabs, priority buttons, repo sidebar styling abf4a73
-* improve contrast and readability across dark theme 8ef2182
-* make all buttons functional with toast feedback and proper state 8a85ef0
-* move language toggle from sidebar footer to top-bar header 69b84c6
-* position search dialog at 10vh from top 437cf51
-* prevent unicode escaping of Chinese text, use dialog for workspace edit 5dcce57
-* project creation working, search dialog with Cmd+K, sidebar clip 7a0e0dd
-* project creation, sidebar clip, search dialog with multi-type 82d1299
-* project tab border-b-2 on all states to prevent layout shift 8f63e16
-* replace branch lists with searchable dropdown selectors d4beebc
-* separate sidebar navigation from dropdown menu, add E2E tests ed485bf
-* unify button colors to amber, fix kanban top border clipping 455fff6
-* wire message sending, task editing, and board interactions 62c6211
-* wire sidebar navigation, settings link, and new project dialog 1717334
-
-
-### Features
-
-* 6 UI improvements 9083dd7
-* add agent runner, SSE streaming, and execution server actions b775e4f
-* add app layout with purple sidebar and top bar ab49cb3
-* add kanban board components with drag-and-drop cb7c0d2
-* add seed data and utility helpers with tests e8e557c
-* add settings page with AI Tools configuration 5779870
-* add task detail panel with conversation UI c849d9e
-* apply Midnight Studio theme to right panels 2de04fb
-* collapsible sidebar with icon selection and dialog creation 0a5c8b5, closes #1
-* complete kanban board page with filters, actions, and task creation b53a996
-* create branch dialog with name, base branch selector, and description 013409e
-* define database schema with Prisma models and types 4de5025
-* full git integration in right sidebar f2435c7
-* full label system - create/assign/display labels on tasks with workspace management c440527
-* full workspace CRUD with create/rename/delete in sidebar 98dbdd0
-* i18n zh/en support with language toggle, tooltips on collapsed sidebar 894c243
-* initial commit 9e77b51
-* labels + project edit + UI improvements d5a8633
-* local folder browser for project path selection 0b3f7c8
-* project CRUD, task edit dialog, and search functionality 92ccbc6
-* project details sidebar, enhanced creation dialog, remove ws tabs, fix collapsed clipping 3e0b3bb
-* project details, enhanced creation, labels schema, sidebar cleanup 3a2a360
-* unified project creation with git URL auto-mapping and clone support d395bf2
-* visual redesign — Midnight Studio dark theme 71a6444

package/.next/standalone/tower/CLAUDE.md

@@ -1,33 +0,0 @@
-# Tower
-
-AI 任务调度平台 — 看板 + 终端 + 代码编辑器 + MCP 工具链。
-
-**Tech:** Next.js 16 / TypeScript / SQLite (Prisma) / TailwindCSS 4 / shadcn (base-nova)
-
-## Quick Reference
-
-```bash
-pnpm dev              # 启动（Webpack 模式，node-pty 需要）
-pnpm db:push          # 同步 schema
-pnpm db:seed          # 种子数据
-pnpm db:init-fts      # 全文搜索索引
-pnpm test:run         # 测试
-```
-
-## Architecture
-
-```
-Workspace → Project → Task → Execution
-```
-
-- 数据模型和 API 参考见 @AGENTS.md
-- UI 规范见 `.claude/rules/ui.md`（组件尺寸、Select、Toast、Loading、i18n）
-- 安全规则见 `.claude/rules/security.md`（输入校验、环境注入、API 防护）
-- 进程生命周期见 `.claude/rules/process-lifecycle.md`（PTY、Preview、WS、定时器）
-
-## Key Conventions
-
-- 国际化：所有用户可见文本用 `t("key")`，zh/en 双语
-- Next.js 15+ 异步 params：`const { id } = await params`
-- App Router routes：`export const runtime = "nodejs"` + `export const dynamic = "force-dynamic"`
-- 数据库：SQLite 单文件，Prisma ORM，配置在 `.env` 的 `DATABASE_URL`

package/.next/standalone/tower/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 jp-liu
-
-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/.next/standalone/tower/README.md

@@ -1,214 +0,0 @@
-<p align="center">
-  <img src="public/banner.jpg" width="100%" alt="Tower" />
-</p>
-
-<p align="center">
-  AI Task Orchestration Platform
-</p>
-<p align="center">
-  <b>English</b> | <a href="./README.zh.md">中文</a>
-</p>
-
-An AI task orchestration platform — manage, dispatch, and execute AI-assisted development tasks through a visual Kanban board.
-
-Integrates terminal, code editor, file tree, live preview, and MCP toolchain into an all-in-one AI development workflow assistant for individual developers.
-
-## Quick Start
-
-### Requirements
-
-- Node.js >= 22
-- pnpm (recommended)
-
-### Installation
-
-```bash
-git clone <repo-url>
-cd tower
-pnpm install
-
-# Configure environment
-cp .env.example .env
-# Uses SQLite by default — no extra setup needed
-
-# Initialize database
-pnpm db:push
-pnpm db:seed
-pnpm db:init-fts
-
-# Start dev server
-pnpm dev
-```
-
-Open http://localhost:3000 in your browser.
-
-### Production Build
-
-```bash
-pnpm build
-pnpm start
-```
-
-## Core Concepts
-
-```
-Workspace
-  ├── Project
-  │     └── Task
-  │           ├── Label
-  │           ├── Execution
-  │           └── Message
-  └── Label (shared)
-```
-
-- **Workspace** — Top-level container for projects and shared labels
-- **Project** — Linked to a Git repo and/or local path; type is NORMAL or GIT
-- **Task** — Work item displayed as a Kanban card grouped by status
-
-## Features
-
-### Kanban Board
-
-- Drag-and-drop task cards between columns (TODO → IN_PROGRESS → IN_REVIEW → DONE)
-- Right-click context menu: change status, launch execution, view details
-- Search box for fuzzy matching task titles and descriptions
-- Priority levels: LOW / MEDIUM / HIGH / CRITICAL
-- Custom labels with color
-
-### Task Workbench
-
-The task detail page has a terminal panel on the left and a three-tab workspace on the right:
-
-#### Terminal
-
-- Browser terminal powered by xterm.js + node-pty
-- Full ANSI rendering (colors, progress bars, cursor movement)
-- Click "Execute" to launch Claude CLI with live output
-- Interactive keyboard input — chat with Claude directly
-- Auto-synced terminal dimensions
-- Reconnect without losing the session
-
-#### File Browser (Files)
-
-- Tree view of the worktree directory structure
-- Automatic gitignore filtering
-- Git status badges (M/A/D)
-- Context menu: create file/folder, rename, delete
-- Auto-refresh during execution
-
-#### Code Editor
-
-- Monaco Editor (same engine as VS Code)
-- Syntax highlighting: TypeScript, JavaScript, Python, JSON, YAML, CSS, HTML, Markdown, Prisma
-- Multi-tab editing with Ctrl+S save
-- Dirty dot indicator for unsaved files
-- Theme follows dark/light mode
-
-#### Changes
-
-- Diff view of the task branch against the base branch
-- Merge confirmation workflow
-
-#### Preview
-
-- Launch a frontend dev server (e.g. `npm run dev`)
-- Embedded iframe preview
-- Auto-detected preview URL based on command pattern
-- Auto-refresh on file save
-- Auto-stops dev server when leaving the page
-
-### Task Execution Lifecycle
-
-```
-Create task → Click Execute → TODO auto-transitions to IN_PROGRESS
-    → Claude CLI runs in terminal → Completes (exit 0) → IN_REVIEW
-    → Manual review → Pass → DONE / Fail → re-execute
-```
-
-- Automatically creates a Git worktree on execution (if baseBranch is set)
-- Sends Feishu notification on completion (when configured)
-- On failure, task stays IN_PROGRESS for retry
-
-### Project Management
-
-- Selecting a local folder auto-detects Git remote and fills in gitUrl
-- Project types: FRONTEND / BACKEND (controls preview availability)
-- Git Path Mapping rules: auto-resolve local paths by host + owner
-
-### Settings
-
-| Category | Options |
-|----------|---------|
-| General | Theme (dark/light/system), Language (zh/en), Default terminal app |
-| Terminal | WebSocket port, Idle timeout |
-| System | Upload limits, Concurrency, Git timeout, Search parameters |
-| CLI Profile | CLI command, Args, Environment variables |
-| Prompts | Custom agent prompt templates |
-| Agent | Agent configuration management |
-| Git Rules | Path mapping rules (host/owner → local path) |
-
-### Internationalization
-
-Supports Chinese and English. Switch in Settings.
-
-## MCP Integration
-
-Tower exposes an MCP Server for external AI agents:
-
-```json
-{
-  "mcpServers": {
-    "tower": {
-      "command": "npx",
-      "args": ["tsx", "<project-root>/src/mcp/index.ts"]
-    }
-  }
-}
-```
-
-### Available Tools (24)
-
-| Category | Tools |
-|----------|-------|
-| Workspace | list_workspaces, create_workspace, update_workspace, delete_workspace |
-| Project | list_projects, create_project, update_project, delete_project |
-| Task | list_tasks, create_task, update_task, delete_task, move_task |
-| Label | list_labels, create_label, delete_label, set_task_labels |
-| Search | search (global search across tasks/projects/repos) |
-| Terminal | get_task_terminal_output, send_task_terminal_input, get_task_execution_status |
-| Knowledge | identify_project |
-| Notes/Assets | manage_notes, manage_assets |
-
-## Development Commands
-
-```bash
-pnpm dev            # Start dev server (Webpack mode — required for node-pty)
-pnpm build          # Production build
-pnpm test           # Run tests (watch mode)
-pnpm test:run       # Run tests (single run)
-pnpm db:push        # Sync Prisma schema to database
-pnpm db:seed        # Seed initial data
-pnpm db:studio      # Open Prisma Studio (database GUI)
-pnpm db:init-fts    # Initialize full-text search index
-pnpm mcp            # Start MCP Server (standalone process)
-```
-
-## Tech Stack
-
-- **Framework**: Next.js 16 (App Router)
-- **Language**: TypeScript
-- **Database**: SQLite (Prisma ORM)
-- **Terminal**: node-pty + xterm.js + WebSocket
-- **Editor**: Monaco Editor
-- **Styling**: TailwindCSS 4
-- **Drag & Drop**: dnd-kit
-- **Testing**: Vitest
-
-## Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| DATABASE_URL | Database connection string | `file:./prisma/dev.db` (SQLite) |
-| PORT | Server port | 3000 |
-
-<!-- Internal notes (TODO, pitfalls) moved to .notes/ (gitignored) -->