tower-studio 0.1.2 → 0.1.3

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

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

@@ -1,180 +0,0 @@
-#!/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/docs/README.md

@@ -1,51 +0,0 @@
-# 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`

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

@@ -1,91 +0,0 @@
-# AI 模块
-
-**Slug:** `ai`
-
-## 概述
-
-Tower 的 AI 能力层，涵盖 Claude Agent SDK 集成、CLI Adapter、助手聊天、任务执行、执行总结等。当前仅实现 Claude Code 适配，预留多 CLI 扩展接口。
-
-## AI 能力调用点
-
-| 能力 | 文件 | 调用方式 | 建议模型 |
-|------|------|----------|----------|
-| 助手聊天 | `api/internal/assistant/chat/route.ts` | Agent SDK `query()` | 当前默认 |
-| 小总结 | `lib/claude-session.ts` → `generateSummaryFromLog` | Agent SDK `aiQuery()` | Haiku 4.5 |
-| 大总结(Dreaming) | `lib/claude-session.ts` → `generateDreamingInsight` | Agent SDK `aiQuery()` | Sonnet 4.6 |
-| 项目分析 | `actions/project-actions.ts` → `analyzeProjectDirectory` | Agent SDK `aiQuery()` | Sonnet 4.6 |
-| 任务执行 | `actions/agent-actions.ts` → `startPtyExecution` | PTY spawn CLI | 当前默认 |
-
-## 文件清单
-
-### 核心库
-
-| 文件 | 说明 |
-|------|------|
-| `lib/claude-session.ts` | AI 统一入口：`aiQuery()`、`generateSummaryFromLog()`、`generateDreamingInsight()` |
-| `lib/assistant-sessions.ts` | 助手会话管理（localStorage 注册表） |
-| `lib/assistant-constants.ts` | `ASSISTANT_SESSION_KEY` 等常量 |
-| `lib/assistant-message-converter.ts` | SDK 消息 → UI 消息格式转换 |
-| `lib/build-multimodal-prompt.ts` | 多模态 prompt 构建（文本+图片） |
-| `lib/execution-summary.ts` | 执行后摘要和 Dreaming 洞察生成 |
-| `lib/cli-test.ts` | CLI Adapter 环境检测 |
-
-### Server Actions
-
-| 文件 | 函数 | 说明 |
-|------|------|------|
-| `actions/agent-actions.ts` | `startPtyExecution` | 启动 Claude CLI PTY |
-| `actions/agent-actions.ts` | `resumePtyExecution` | 恢复会话 |
-| `actions/agent-actions.ts` | `continueLatestPtyExecution` | 继续最近会话 |
-| `actions/cli-profile-actions.ts` | `getDefaultCliProfile` | 获取活跃 CLI 配置 |
-| `actions/prompt-actions.ts` | `getPrompts` / `createPrompt` | Prompt 模板管理 |
-| `actions/project-actions.ts` | `analyzeProjectDirectory` | AI 项目分析 |
-
-### API Routes
-
-| 路由 | 说明 |
-|------|------|
-| `/api/internal/assistant/chat` | 助手聊天 SSE 流式 |
-| `/api/internal/assistant/sessions` | 会话消息检索 |
-| `/api/internal/assistant/images` | 图片服务 |
-| `/api/adapters/test` | CLI Adapter 连接测试 |
-
-### 数据模型
-
-| 模型 | 说明 |
-|------|------|
-| `CliProfile` | CLI 命令、参数、环境变量配置。`command` 仅允许 `claude`/`claude-code` |
-| `AgentConfig` | Agent 特定配置，唯一约束 `(agent, configName)` |
-| `AgentPrompt` | Prompt 模板，支持全局/workspace 级别 |
-| `TaskExecution` | 执行记录，含 `sessionId`、`summary`、`gitLog`、`insightNoteId` |
-
-### 组件
-
-| 组件 | 说明 |
-|------|------|
-| `settings/cli-profile-config.tsx` | CLI Profile 配置 UI |
-| `settings/cli-adapter-tester.tsx` | CLI 连接测试 UI |
-| `settings/prompts-config.tsx` | Prompt 模板管理 UI |
-| `settings/ai-tools-config.tsx` | Agent 配置 UI |
-
-## CLI Adapter 接口（TODO）
-
-当前硬编码 Claude Code，后续接入第二个 CLI 时抽象：
-
-```
-spawn(cwd, args, env)        — 启动 CLI 进程（PTY）
-resume(sessionId)            — 恢复会话
-continue()                   — 继续最近会话
-getSessionId()               — 获取会话 ID
-getHooks() / installHooks()  — Hook 配置注册
-buildEnvOverrides(taskId)    — 环境变量注入
-```
-
-详细接口清单见 [README.md TODO](../../README.md#todo)。
-
-## 安全约束
-
-- `CliProfile.command` 仅白名单 `claude`、`claude-code`
-- `baseArgs` 禁止 shell 元字符 `;&|$()`
-- `envVars` 禁止危险 key: `PATH`, `LD_PRELOAD`, `NODE_OPTIONS` 等
-- 环境变量通过 `envOverrides` 注入，禁止修改 `process.env`