tower-studio 0.1.1 → 0.1.2

package/.next/standalone/tower/README.md

@@ -0,0 +1,214 @@
+<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) -->

package/.next/standalone/tower/README.zh.md

@@ -0,0 +1,212 @@
+<p align="center">
+  <img src="public/banner.jpg" width="100%" alt="Tower" />
+</p>
+
+<p align="center">
+  AI 任务调度平台
+</p>
+<p align="center">
+  <a href="./README.md">English</a> | <b>中文</b>
+</p>
+
+AI 任务调度平台 — 通过可视化看板管理、调度、执行 AI 辅助开发任务。
+
+集成终端、代码编辑器、文件树、实时预览和 MCP 工具链，为个人开发者打造一站式 AI 开发办公流程助手。
+
+## 快速开始
+
+### 环境要求
+
+- Node.js >= 22
+- pnpm（推荐）
+
+### 安装
+
+```bash
+git clone <repo-url>
+cd tower
+pnpm install
+
+# 配置环境变量
+cp .env.example .env
+# 默认使用 SQLite，无需额外配置
+
+# 初始化数据库
+pnpm db:push
+pnpm db:seed
+pnpm db:init-fts
+
+# 启动开发服务器
+pnpm dev
+```
+
+浏览器打开 http://localhost:3000
+
+### 生产构建
+
+```bash
+pnpm build
+pnpm start
+```
+
+## 核心概念
+
+```
+Workspace（工作空间）
+  ├── Project（项目）
+  │     └── Task（任务）
+  │           ├── Label（标签）
+  │           ├── Execution（执行记录）
+  │           └── Message（消息历史）
+  └── Label（共享标签）
+```
+
+- **Workspace** — 顶层容器，管理多个项目和共享标签
+- **Project** — 项目，可关联 Git 仓库和本地路径，类型分为 NORMAL 和 GIT
+- **Task** — 任务卡片，在看板上按状态分列展示
+
+## 功能特性
+
+### 看板管理
+
+- 拖拽任务卡片在列间移动（TODO → IN_PROGRESS → IN_REVIEW → DONE）
+- 右键菜单：更改状态、启动执行、查看详情
+- 搜索框模糊搜索任务标题和描述
+- 任务优先级：LOW / MEDIUM / HIGH / CRITICAL
+- 自定义标签（颜色 + 名称）
+
+### 任务工作台
+
+进入任务详情页，左侧为终端面板，右侧为三标签工作区：
+
+#### 终端（Terminal）
+
+- 基于 xterm.js + node-pty 的浏览器终端
+- 完整 ANSI 渲染（颜色、进度条、光标移动）
+- 点击"执行"启动 Claude CLI，实时输出
+- 支持键盘输入，与 Claude 交互式对话
+- 窗口大小自动同步
+- 断开重连不丢失会话
+
+#### 文件浏览器（Files）
+
+- 树形目录浏览 worktree 文件结构
+- gitignore 自动过滤
+- 文件 git 状态标记（M/A/D）
+- 右键菜单：新建文件/文件夹、重命名、删除
+- 执行中自动刷新文件树
+
+#### 代码编辑器
+
+- Monaco Editor（VS Code 同款引擎）
+- 语法高亮：TypeScript、JavaScript、Python、JSON、YAML、CSS、HTML、Markdown、Prisma
+- 多标签编辑，Ctrl+S 保存
+- 未保存文件标记（dirty dot）
+- 主题跟随深色/浅色模式
+
+#### 变更（Changes）
+
+- 查看当前任务分支与基础分支的 diff
+- 合并确认流程
+
+#### 预览（Preview）
+
+- 启动前端开发服务器（如 `npm run dev`）
+- iframe 内嵌预览
+- 自动推算预览地址（根据命令识别端口）
+- 保存文件后自动刷新预览
+- 离开页面自动停止开发服务器
+
+### 任务执行生命周期
+
+```
+创建任务 → 点击执行 → TODO 自动变为 IN_PROGRESS
+    → Claude CLI 在终端运行 → 执行完成（exit 0）→ IN_REVIEW
+    → 人工检查 → 合格则 DONE / 不合格可重新执行
+```
+
+- 启动执行时自动创建 Git worktree（如配置了 baseBranch）
+- 执行完成后触发飞书通知（需配置）
+- 失败时任务保持 IN_PROGRESS，可重试
+
+### 项目管理
+
+- 创建项目时选择本地文件夹，自动检测 Git 仓库并填充 gitUrl
+- 项目类型：FRONTEND / BACKEND（影响预览功能可用性）
+- Git Path Mapping 规则：按 host + owner 自动推算本地路径
+
+### 设置
+
+| 分类 | 配置项 |
+|------|--------|
+| 通用 | 主题（深色/浅色/系统）、语言（中/英）、默认终端 App |
+| 终端 | WebSocket 端口、空闲超时时间 |
+| 系统 | 上传限制、并发数、Git 超时、搜索参数 |
+| CLI Profile | CLI 命令、参数、环境变量 |
+| Prompts | 自定义 Agent 提示词模板 |
+| Agent | Agent 配置管理 |
+| Git 规则 | 路径映射规则（host/owner → 本地路径） |
+
+### 国际化
+
+支持中文和英文，在设置页切换。
+
+## MCP 集成
+
+Tower 提供 MCP Server，可被外部 AI Agent 调用：
+
+```json
+{
+  "mcpServers": {
+    "tower": {
+      "command": "npx",
+      "args": ["tsx", "<project-root>/src/mcp/index.ts"]
+    }
+  }
+}
+```
+
+### 可用工具（24 个）
+
+| 分类 | 工具 |
+|------|------|
+| 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（全局搜索任务/项目/仓库） |
+| Terminal | get_task_terminal_output, send_task_terminal_input, get_task_execution_status |
+| Knowledge | identify_project |
+| Notes/Assets | manage_notes, manage_assets |
+
+## 开发命令
+
+```bash
+pnpm dev            # 启动开发服务器（Webpack 模式，node-pty 需要）
+pnpm build          # 生产构建
+pnpm test           # 运行测试（watch 模式）
+pnpm test:run       # 运行测试（单次）
+pnpm db:push        # 同步 Prisma schema 到数据库
+pnpm db:seed        # 填充种子数据
+pnpm db:studio      # 打开 Prisma Studio（数据库可视化）
+pnpm db:init-fts    # 初始化全文搜索索引
+pnpm mcp            # 启动 MCP Server（独立进程）
+```
+
+## 技术栈
+
+- **框架**: Next.js 16 (App Router)
+- **语言**: TypeScript
+- **数据库**: SQLite (Prisma ORM)
+- **终端**: node-pty + xterm.js + WebSocket
+- **编辑器**: Monaco Editor
+- **样式**: TailwindCSS 4
+- **拖拽**: dnd-kit
+- **测试**: Vitest
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| DATABASE_URL | 数据库连接串 | `file:./prisma/dev.db` (SQLite) |
+| PORT | 服务端口 | 3000 |

package/.next/standalone/tower/bin/tower.mjs

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * Tower CLI — install via npm, run `tower` to start.
+ *
+ * Usage:
+ *   tower                Start server (auto-init on first run)
+ *   tower migrate        Migrate data from old project-local paths to ~/.tower
+ *   tower --help         Show help
+ *   tower --version      Show version
+ *
+ * Options:
+ *   -p, --port <port>    Server port (default: 3000)
+ *   -H, --host <host>    Server host (default: 0.0.0.0)
+ */
+
+import { existsSync, readFileSync, mkdirSync } from "fs";
+import { join, dirname, resolve } from "path";
+import { execSync, spawn } from "child_process";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = resolve(__dirname, "..");
+
+// ─── Data directory: ~/.tower ───
+const TOWER_DIR = join(homedir(), ".tower");
+const DB_DIR = join(TOWER_DIR, "database");
+const DB_PATH = join(DB_DIR, "tower.db");
+const DB_URL = `file:${DB_PATH}`;
+
+// ─── Parse CLI args ───
+import { parseArgs } from "node:util";
+
+const { values: flags, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    port:    { type: "string", short: "p" },
+    host:    { type: "string", short: "H" },
+    help:    { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" },
+  },
+  allowPositionals: true,
+});
+
+const command = positionals[0] ?? "start";
+
+const PORT = flags.port ?? process.env.PORT ?? "3000";
+const HOST = flags.host ?? "0.0.0.0";
+
+// ─── Help ───
+if (flags.help) {
+  console.log(`
+  Tower — AI Task Orchestration Platform
+
+  Usage:
+    tower              Start server (auto-init on first run)
+    tower migrate      Migrate data from old project-local paths to ~/.tower
+
+  Options:
+    -p, --port <port>   Server port (default: 3000)
+    -H, --host <host>   Server host (default: 0.0.0.0)
+    -h, --help          Show help
+    -v, --version       Show version
+  `);
+  process.exit(0);
+}
+
+// ─── Version ───
+if (flags.version) {
+  const pkg = JSON.parse(readFileSync(join(PROJECT_ROOT, "package.json"), "utf-8"));
+  console.log(`tower v${pkg.version}`);
+  process.exit(0);
+}
+
+// ─── Utilities ───
+function log(msg) {
+  console.log(`\x1b[36m[tower]\x1b[0m ${msg}`);
+}
+
+function logError(msg) {
+  console.error(`\x1b[31m[tower]\x1b[0m ${msg}`);
+}
+
+function childEnv() {
+  return { ...process.env, DATABASE_URL: DB_URL };
+}
+
+function run(cmd, opts = {}) {
+  try {
+    execSync(cmd, {
+      cwd: PROJECT_ROOT,
+      stdio: "inherit",
+      env: childEnv(),
+      ...opts,
+    });
+  } catch {
+    logError(`Command failed: ${cmd}`);
+    process.exit(1);
+  }
+}
+
+function needsInit() {
+  return !existsSync(DB_PATH);
+}
+
+function ensureDirs() {
+  for (const dir of [TOWER_DIR, DB_DIR, join(TOWER_DIR, "storage"), join(TOWER_DIR, "assistant"), join(TOWER_DIR, "logs")]) {
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+  }
+}
+
+async function initDatabase() {
+  log("Initializing Tower...");
+  ensureDirs();
+  log(`Data directory: ${TOWER_DIR}`);
+
+  log("Generating Prisma client...");
+  run("npx prisma generate");
+
+  log("Syncing database schema...");
+  run("npx prisma db push --skip-generate");
+
+  log("Seeding initial data...");
+  run("npx tsx scripts/init-db.ts");
+
+  log("Initializing full-text search...");
+  run("npx tsx prisma/init-fts.ts");
+
+  log("Initialization complete!");
+}
+
+// ─── Commands ───
+async function cmdMigrate() {
+  log("Running data migration...");
+  run("npx tsx scripts/migrate-data.ts --run");
+}
+
+async function cmdStart() {
+  if (needsInit()) {
+    await initDatabase();
+  }
+
+  // Use standalone server.js if available (npm install), fallback to next start (dev)
+  const standaloneServer = join(PROJECT_ROOT, ".next", "standalone", "tower", "server.js");
+  const useStandalone = existsSync(standaloneServer);
+
+  log(`Starting Tower on http://${HOST === "0.0.0.0" ? "localhost" : HOST}:${PORT}`);
+  const child = useStandalone
+    ? spawn("node", [standaloneServer], {
+        cwd: join(PROJECT_ROOT, ".next", "standalone", "tower"),
+        stdio: "inherit",
+        env: { ...childEnv(), PORT, HOSTNAME: HOST },
+      })
+    : spawn("npx", ["next", "start", "-p", PORT, "-H", HOST], {
+        cwd: PROJECT_ROOT,
+        stdio: "inherit",
+        env: childEnv(),
+      });
+
+  child.on("exit", (code) => process.exit(code ?? 0));
+  process.on("SIGINT", () => child.kill("SIGINT"));
+  process.on("SIGTERM", () => child.kill("SIGTERM"));
+}
+
+// ─── Dispatch ───
+switch (command) {
+  case "migrate":
+    await cmdMigrate();
+    break;
+  case "start":
+    await cmdStart();
+    break;
+  default:
+    logError(`Unknown command: ${command}`);
+    process.exit(1);
+}

package/.next/standalone/tower/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/.next/standalone/tower/docs/README.md

@@ -0,0 +1,51 @@
+# Tower 系统文档
+
+按模块拆分的技术文档，用于开发参考和 GSD phase 规划。
+
+## 模块索引
+
+| 模块 | Slug | 目录 | 说明 |
+|------|------|------|------|
+| Workspace | `workspace` | [workspace/](workspace/) | 工作区管理 |
+| Project | `project` | [project/](project/) | 项目 CRUD、导入、git 仓库 |
+| Task | `task` | [task/](task/) | 任务 CRUD、状态流转、详情页 |
+| Board | `board` | [board/](board/) | 看板 UI、拖拽排序、筛选 |
+| Terminal | `terminal` | [terminal/](terminal/) | PTY 会话、WebSocket、xterm.js |
+| Assistant | `assistant` | [assistant/](assistant/) | AI 助手聊天、SSE 流式 |
+| Missions | `missions` | [missions/](missions/) | 多任务监控面板 |
+| Search | `search` | [search/](search/) | 全局搜索、代码搜索、FTS |
+| Settings | `settings` | [settings/](settings/) | 系统配置、CLI Profile、Agent 配置 |
+| MCP | `mcp` | [mcp/](mcp/) | MCP Server、工具链 |
+| Git | `git` | [git/](git/) | Git 操作、Worktree、Diff、Merge |
+| Assets & Notes | `assets` | [assets-notes/](assets-notes/) | 项目资产、笔记 |
+| AI | `ai` | [ai/](ai/) | Claude SDK、CLI Adapter、执行总结、Prompt |
+| I18n | `i18n` | [i18n/](i18n/) | 国际化、中英双语 |
+
+## 架构图
+
+浏览器打开 HTML 文件查看（暗色主题，自适应缩放）。
+
+| 图 | 文件 | 说明 |
+|----|------|------|
+| 系统架构 | [diagrams/tower-system-architecture.html](diagrams/tower-system-architecture.html) | 7 层：客户端→服务端→WS→PTY→DB/MCP→AI→外部 |
+| 数据模型 | [diagrams/tower-data-model.html](diagrams/tower-data-model.html) | 13 实体 ER 图，含关联和级联删除 |
+| 任务生命周期 | [diagrams/tower-task-lifecycle.html](diagrams/tower-task-lifecycle.html) | 创建→执行→运行→退出→评审流程 |
+| AI 架构 | [diagrams/tower-ai-architecture.html](diagrams/tower-ai-architecture.html) | Agent SDK / CLI PTY / 能力矩阵 |
+| 模块依赖 | [diagrams/tower-module-map.html](diagrams/tower-module-map.html) | 14 模块 4 层依赖关系 |
+
+## TODO
+
+- [x] 用户确认模块划分（增删改 slug、合并/拆分模块）
+- [x] 将最终模块列表写入 AGENTS.md，供 GSD 读取
+- [x] 生成系统架构图（5 张暗色主题 HTML）
+- [ ] 配置 `.planning/config.json` 的 commit scope 映射
+- [ ] 各模块文档补充完善（API 细节、状态图、交互流程）
+
+## GSD Commit Scope 映射
+
+GSD phase 按模块命名时，commit scope 使用上表的 **Slug** 列。
+
+示例：
+- `feat(workspace-08.01): add workspace archiving`
+- `fix(terminal-12.02): fix PTY reconnect on timeout`
+- `refactor(board-05.01): extract kanban column component`