npm - tower-studio - Versions diffs - 0.1.1 → 0.1.2 - Mend

tower-studio 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1138) hide show

package/.next/standalone/tower/docs/diagrams/tower-task-lifecycle.html ADDED Viewed

@@ -0,0 +1,251 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Tower Task Lifecycle</title>
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;600;700&display=swap');
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    background: #020617;
+    font-family: 'JetBrains Mono', monospace;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: 100vh;
+    padding: 2rem;
+  }
+  svg { max-width: 1000px; width: 100%; height: auto; }
+</style>
+</head>
+<body>
+<svg viewBox="0 0 1000 880" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <!-- Grid pattern -->
+    <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
+      <path d="M 40 0 L 0 0 0 40" fill="none" stroke="rgba(148,163,184,0.06)" stroke-width="0.5"/>
+    </pattern>
+    <!-- Arrow markers -->
+    <marker id="arrow-emerald" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#34d399"/>
+    </marker>
+    <marker id="arrow-rose" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fb7185"/>
+    </marker>
+    <marker id="arrow-orange" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fb923c"/>
+    </marker>
+    <marker id="arrow-amber" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fbbf24"/>
+    </marker>
+    <marker id="arrow-slate" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#94a3b8"/>
+    </marker>
+    <!-- Glow filters -->
+    <filter id="glow-emerald" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#34d399" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-amber" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#fbbf24" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-cyan" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#22d3ee" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-orange" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#fb923c" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+  <!-- Background -->
+  <rect width="1000" height="880" fill="#020617"/>
+  <rect width="1000" height="880" fill="url(#grid)"/>
+  <!-- ============================== -->
+  <!-- STEP 1: 创建任务 (y=30)        -->
+  <!-- ============================== -->
+  <rect x="350" y="30" width="300" height="52" rx="26" fill="rgba(8,145,178,0.2)" stroke="#22d3ee" stroke-width="1.5" filter="url(#glow-cyan)"/>
+  <text x="500" y="52" text-anchor="middle" fill="#22d3ee" font-family="JetBrains Mono" font-size="14" font-weight="600">创建任务 (TODO)</text>
+  <text x="500" y="70" text-anchor="middle" fill="rgba(148,163,184,0.7)" font-family="JetBrains Mono" font-size="9">标题 / 描述 / 优先级 / 标签 / baseBranch</text>
+  <!-- Arrow: Step 1 → Step 2 -->
+  <rect x="490" y="82" width="20" height="18" fill="#020617"/>
+  <line x1="500" y1="82" x2="500" y2="104" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <rect x="508" y="86" width="70" height="12" fill="#020617"/>
+  <text x="512" y="96" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">点击「执行」</text>
+  <!-- ============================== -->
+  <!-- STEP 2: startPtyExecution()    -->
+  <!-- ============================== -->
+  <rect x="310" y="108" width="380" height="130" rx="8" fill="rgba(6,78,59,0.4)" stroke="#34d399" stroke-width="1.5" filter="url(#glow-emerald)"/>
+  <text x="500" y="130" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="13" font-weight="700">startPtyExecution()</text>
+  <line x1="330" y1="140" x2="670" y2="140" stroke="rgba(52,211,153,0.2)" stroke-width="1"/>
+  <!-- Detail items -->
+  <circle cx="335" cy="157" r="2.5" fill="#34d399"/>
+  <text x="345" y="160" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 TaskExecution (PENDING → RUNNING)</text>
+  <circle cx="335" cy="175" r="2.5" fill="#34d399"/>
+  <text x="345" y="178" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">Task: TODO → IN_PROGRESS</text>
+  <circle cx="335" cy="193" r="2.5" fill="#34d399"/>
+  <text x="345" y="196" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 Git Worktree (如有 baseBranch)</text>
+  <circle cx="335" cy="211" r="2.5" fill="#34d399"/>
+  <text x="345" y="214" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">加载 CliProfile · 注入 TOWER_TASK_ID</text>
+  <circle cx="335" cy="229" r="2.5" fill="#34d399"/>
+  <text x="345" y="232" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 PTY 会话 (session-store)</text>
+  <!-- Arrow: Step 2 → Step 3 -->
+  <rect x="490" y="238" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="238" x2="500" y2="264" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <!-- ============================== -->
+  <!-- STEP 3: 运行中 (IN_PROGRESS)   -->
+  <!-- ============================== -->
+  <rect x="310" y="268" width="380" height="120" rx="8" fill="rgba(76,29,149,0.25)" stroke="#a78bfa" stroke-width="1.5"/>
+  <!-- Status badge -->
+  <rect x="420" y="276" width="160" height="20" rx="10" fill="rgba(52,211,153,0.15)" stroke="#34d399" stroke-width="1"/>
+  <text x="500" y="290" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="10" font-weight="600">运行中 (IN_PROGRESS)</text>
+  <line x1="330" y1="302" x2="670" y2="302" stroke="rgba(167,139,250,0.2)" stroke-width="1"/>
+  <!-- Detail items -->
+  <circle cx="335" cy="319" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="322" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">Claude CLI 在终端运行 · 用户可交互输入</text>
+  <circle cx="335" cy="337" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="340" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">WebSocket 中继 I/O → xterm.js 实时显示</text>
+  <circle cx="335" cy="355" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="358" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">SessionStart Hook → 上报 sessionId</text>
+  <circle cx="335" cy="373" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="376" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">PostToolUse Hook → 捕获文件变更</text>
+  <!-- Arrow: Step 3 → Step 4 -->
+  <rect x="490" y="388" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="388" x2="500" y2="414" stroke="#fbbf24" stroke-width="1.5" marker-end="url(#arrow-amber)"/>
+  <!-- ============================== -->
+  <!-- STEP 4: Decision Diamond       -->
+  <!-- ============================== -->
+  <g filter="url(#glow-amber)">
+    <polygon points="500,418 590,468 500,518 410,468" fill="rgba(120,53,15,0.3)" stroke="#fbbf24" stroke-width="1.5"/>
+  </g>
+  <text x="500" y="462" text-anchor="middle" fill="#fbbf24" font-family="JetBrains Mono" font-size="13" font-weight="600">exitCode?</text>
+  <text x="500" y="478" text-anchor="middle" fill="rgba(251,191,36,0.6)" font-family="JetBrains Mono" font-size="9">进程退出</text>
+  <!-- Left arrow: != 0 retry → back to Step 3 -->
+  <rect x="290" y="458" width="116" height="20" fill="#020617"/>
+  <line x1="410" y1="468" x2="296" y2="468" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <text x="340" y="462" text-anchor="middle" fill="#fb7185" font-family="JetBrains Mono" font-size="9" font-weight="500">!= 0 重试</text>
+  <!-- Up from left to Step 3 -->
+  <line x1="296" y1="468" x2="296" y2="328" stroke="#fb7185" stroke-width="1.5"/>
+  <line x1="296" y1="328" x2="306" y2="328" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <!-- Right arrow: == 0 success → Step 5 -->
+  <rect x="594" y="458" width="116" height="20" fill="#020617"/>
+  <line x1="590" y1="468" x2="700" y2="468" stroke="#34d399" stroke-width="1.5"/>
+  <text x="650" y="462" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">== 0 成功</text>
+  <!-- Down from right then back to center for Step 5 -->
+  <line x1="700" y1="468" x2="700" y2="540" stroke="#34d399" stroke-width="1.5"/>
+  <line x1="700" y1="540" x2="504" y2="540" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <!-- ============================== -->
+  <!-- STEP 5: 评审阶段 (IN_REVIEW)   -->
+  <!-- ============================== -->
+  <rect x="310" y="530" width="380" height="90" rx="8" fill="rgba(76,29,149,0.25)" stroke="#c4b5fd" stroke-width="1.5"/>
+  <!-- Status badge -->
+  <rect x="410" y="538" width="180" height="20" rx="10" fill="rgba(139,92,246,0.2)" stroke="#a78bfa" stroke-width="1"/>
+  <text x="500" y="552" text-anchor="middle" fill="#c4b5fd" font-family="JetBrains Mono" font-size="10" font-weight="600">评审阶段 (IN_REVIEW)</text>
+  <line x1="330" y1="564" x2="670" y2="564" stroke="rgba(196,181,253,0.2)" stroke-width="1"/>
+  <circle cx="335" cy="580" r="2.5" fill="#c4b5fd"/>
+  <text x="345" y="583" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">生成小总结 + Dreaming 洞察</text>
+  <circle cx="335" cy="598" r="2.5" fill="#c4b5fd"/>
+  <text x="345" y="601" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">查看 Diff (worktree vs base branch)</text>
+  <!-- Exit Down: 合并 → DONE -->
+  <rect x="490" y="620" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="620" x2="500" y2="646" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <rect x="400" y="650" width="200" height="40" rx="20" fill="rgba(6,78,59,0.4)" stroke="#34d399" stroke-width="1.5" filter="url(#glow-emerald)"/>
+  <text x="500" y="668" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="11" font-weight="600">DONE ✓</text>
+  <text x="500" y="682" text-anchor="middle" fill="rgba(52,211,153,0.6)" font-family="JetBrains Mono" font-size="8">合并 · 清理 Worktree</text>
+  <!-- Exit Left: 重新执行 → loops to Step 2 -->
+  <rect x="218" y="565" width="88" height="16" fill="#020617"/>
+  <line x1="310" y1="575" x2="232" y2="575" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3"/>
+  <text x="268" y="571" text-anchor="middle" fill="#fb923c" font-family="JetBrains Mono" font-size="8" font-weight="500">重新执行</text>
+  <line x1="232" y1="575" x2="232" y2="173" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3"/>
+  <line x1="232" y1="173" x2="306" y2="173" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3" marker-end="url(#arrow-orange)"/>
+  <!-- Exit Right: CANCELLED -->
+  <rect x="694" y="565" width="80" height="16" fill="#020617"/>
+  <line x1="690" y1="575" x2="740" y2="575" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <rect x="744" y="555" width="120" height="40" rx="20" fill="rgba(159,18,57,0.3)" stroke="#fb7185" stroke-width="1.5"/>
+  <text x="804" y="579" text-anchor="middle" fill="#fb7185" font-family="JetBrains Mono" font-size="11" font-weight="600">CANCELLED</text>
+  <!-- ============================== -->
+  <!-- SIDE PANEL: 恢复执行 (left)     -->
+  <!-- ============================== -->
+  <rect x="50" y="290" width="195" height="70" rx="6" fill="rgba(120,53,15,0.15)" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="6,3" filter="url(#glow-orange)"/>
+  <text x="148" y="312" text-anchor="middle" fill="#fb923c" font-family="JetBrains Mono" font-size="11" font-weight="600">恢复执行</text>
+  <text x="148" y="330" text-anchor="middle" fill="rgba(251,146,60,0.7)" font-family="JetBrains Mono" font-size="9">--resume sessionId</text>
+  <text x="148" y="346" text-anchor="middle" fill="rgba(251,146,60,0.7)" font-family="JetBrains Mono" font-size="9">--continue (最近会话)</text>
+  <!-- Arrow right into Step 3 -->
+  <line x1="245" y1="328" x2="306" y2="328" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3" marker-end="url(#arrow-orange)"/>
+  <!-- ============================== -->
+  <!-- LEGEND (bottom-right)          -->
+  <!-- ============================== -->
+  <!-- Card 1: 执行流程 -->
+  <rect x="50" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(52,211,153,0.3)" stroke-width="1"/>
+  <circle cx="68" cy="738" r="5" fill="#34d399"/>
+  <text x="80" y="742" fill="#34d399" font-family="JetBrains Mono" font-size="10" font-weight="600">执行流程</text>
+  <text x="68" y="762" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">创建→执行→运行→退出→评审→完成</text>
+  <!-- Card 2: 自动化 -->
+  <rect x="360" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(251,191,36,0.3)" stroke-width="1"/>
+  <circle cx="378" cy="738" r="5" fill="#fbbf24"/>
+  <text x="390" y="742" fill="#fbbf24" font-family="JetBrains Mono" font-size="10" font-weight="600">自动化</text>
+  <text x="378" y="756" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">Worktree 自动创建</text>
+  <text x="378" y="768" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">环境变量注入 · Hook 捕获 sessionId</text>
+  <!-- Card 3: 恢复机制 -->
+  <rect x="670" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(251,146,60,0.3)" stroke-width="1"/>
+  <circle cx="688" cy="738" r="5" fill="#fb923c"/>
+  <text x="700" y="742" fill="#fb923c" font-family="JetBrains Mono" font-size="10" font-weight="600">恢复机制</text>
+  <text x="688" y="756" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">--resume 恢复指定会话</text>
+  <text x="688" y="768" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">--continue 继续最近会话</text>
+  <!-- ============================== -->
+  <!-- STATUS BADGES ROW              -->
+  <!-- ============================== -->
+  <rect x="170" y="800" width="660" height="24" rx="12" fill="rgba(30,41,59,0.3)" stroke="rgba(148,163,184,0.1)" stroke-width="1"/>
+  <!-- TODO -->
+  <circle cx="230" cy="812" r="4" fill="#22d3ee"/>
+  <text x="240" y="816" fill="#22d3ee" font-family="JetBrains Mono" font-size="9" font-weight="500">TODO</text>
+  <!-- IN_PROGRESS -->
+  <circle cx="320" cy="812" r="4" fill="#34d399"/>
+  <text x="330" y="816" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">IN_PROGRESS</text>
+  <!-- IN_REVIEW -->
+  <circle cx="460" cy="812" r="4" fill="#a78bfa"/>
+  <text x="470" y="816" fill="#a78bfa" font-family="JetBrains Mono" font-size="9" font-weight="500">IN_REVIEW</text>
+  <!-- DONE -->
+  <circle cx="580" cy="812" r="4" fill="#34d399"/>
+  <text x="590" y="816" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">DONE</text>
+  <!-- CANCELLED -->
+  <circle cx="650" cy="812" r="4" fill="#fb7185"/>
+  <text x="660" y="816" fill="#fb7185" font-family="JetBrains Mono" font-size="9" font-weight="500">CANCELLED</text>
+  <!-- ============================== -->
+  <!-- FOOTER                         -->
+  <!-- ============================== -->
+  <text x="500" y="858" text-anchor="middle" fill="rgba(148,163,184,0.35)" font-family="JetBrains Mono" font-size="10">Tower Task Lifecycle · 5 Status States</text>
+</svg>
+</body>
+</html>

package/.next/standalone/tower/docs/en/guide/architecture.md ADDED Viewed

@@ -0,0 +1,79 @@
+---
+title: Architecture
+description: Tower system architecture and design overview
+---
+## System Overview
+Tower is built on Next.js 16 with the App Router pattern, using a full-stack architecture where the frontend and backend coexist in a single codebase.
+## Data Architecture
+```
+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)
+```
+- **Cascade deletes**: Deleting a Workspace removes all its Projects; deleting a Project removes all its Tasks
+- **SQLite + Prisma**: Lightweight single-file database with WAL mode and busy_timeout=5000
+## Runtime Architecture
+```
+Browser (Next.js App)
+  ├── Server Actions (src/actions/)
+  ├── API Routes (src/app/api/)
+  ├── WebSocket Client (xterm.js)
+  │
+Next.js Server
+  ├── Prisma ORM → SQLite
+  ├── PTY Session Store (in-memory, keyed by taskId)
+  ├── WebSocket Server (ws-server.ts, port 3001)
+  └── MCP Server (stdio transport)
+```
+## Key Subsystems
+### PTY Terminal System
+Each task gets an independent PTY session running Claude CLI. Communication flows through WebSocket for real-time terminal I/O:
+```
+Client (xterm.js) ←→ WebSocket ←→ ws-server.ts ←→ PTY Session (node-pty)
+                                                         ↕
+                                                    session-store.ts
+```
+### MCP Server
+Exposes 24+ tools via the Model Context Protocol, allowing external AI agents to manage workspaces, projects, tasks, and interact with running terminals. Runs as a stdio transport process.
+### Internal HTTP Bridge
+MCP stdio processes cannot access in-memory PTY sessions directly. Internal HTTP routes bridge this gap:
+- `GET /api/internal/terminal/[taskId]/buffer` -- Read terminal output
+- `POST /api/internal/terminal/[taskId]/input` -- Send terminal input
+- Restricted to localhost only
+## Module Dependency Overview
+Tower is composed of 14 modules:
+| Layer | Modules |
+|-------|---------|
+| **UI** | Board, Missions, Assistant, Search, Settings |
+| **Core** | Workspace, Project, Task, Terminal |
+| **Integration** | MCP, Git, AI, Assets & Notes |
+| **Cross-cutting** | I18n |
+## Process Lifecycle
+- **PTY Sessions**: One active session per task, 2h keepalive while running, 5min after exit, SIGTERM cleanup
+- **WebSocket**: Batched sender flushed on close, polling timer cleared on error
+- **Database**: Prisma `$disconnect()` on SIGTERM/SIGINT
+- **Timers**: All `setTimeout`/`setInterval` cleared in cleanup handlers

package/.next/standalone/tower/docs/en/guide/diagrams.md ADDED Viewed

@@ -0,0 +1,24 @@
+---
+title: Diagrams
+description: Interactive architecture and design diagrams for Tower
+---
+## System Architecture
+<iframe src="/tower/diagrams/tower-system-architecture.html" width="100%" height="600" style="border: 1px solid var(--vp-c-border); border-radius: 8px;" />
+## Data Model
+<iframe src="/tower/diagrams/tower-data-model.html" width="100%" height="600" style="border: 1px solid var(--vp-c-border); border-radius: 8px;" />
+## Task Lifecycle
+<iframe src="/tower/diagrams/tower-task-lifecycle.html" width="100%" height="600" style="border: 1px solid var(--vp-c-border); border-radius: 8px;" />
+## AI Architecture
+<iframe src="/tower/diagrams/tower-ai-architecture.html" width="100%" height="600" style="border: 1px solid var(--vp-c-border); border-radius: 8px;" />
+## Module Dependencies
+<iframe src="/tower/diagrams/tower-module-deps.html" width="100%" height="600" style="border: 1px solid var(--vp-c-border); border-radius: 8px;" />

package/.next/standalone/tower/docs/en/guide/getting-started.md ADDED Viewed

@@ -0,0 +1,80 @@
+---
+title: Getting Started
+description: Steps to install and run the Tower project
+---
+## Prerequisites
+- **Node.js** >= 22
+- **pnpm** (package manager)
+## Installation
+### 1. Clone the Repository
+```bash
+git clone <repo-url> tower
+cd tower
+```
+### 2. Install Dependencies
+```bash
+pnpm install
+```
+### 3. Configure Environment Variables
+```bash
+cp .env.example .env
+```
+Edit the `.env` file as needed. The main configuration is `DATABASE_URL` (SQLite database path).
+### 4. Initialize the Database
+```bash
+# Sync Prisma schema to the database
+pnpm db:push
+# Import seed data
+pnpm db:seed
+# Create full-text search index
+pnpm db:init-fts
+```
+### 5. Start the Development Server
+```bash
+pnpm dev
+```
+Open your browser and visit [http://localhost:3000](http://localhost:3000).
+## MCP Integration
+To expose Tower's tool capabilities to external AI agents, 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 the project.
+## Common Commands
+| Command | Description |
+|---------|-------------|
+| `pnpm dev` | Start development server (Webpack mode, required for node-pty) |
+| `pnpm db:push` | Sync Prisma schema |
+| `pnpm db:seed` | Import seed data |
+| `pnpm db:init-fts` | Create full-text search index |
+| `pnpm test:run` | Run tests |

package/.next/standalone/tower/docs/en/guide/introduction.md ADDED Viewed

@@ -0,0 +1,84 @@
+---
+title: Introduction
+description: What Tower is, core concepts, and tech stack overview
+---
+## What is Tower
+Tower is an AI task orchestration platform for individual developers. It integrates Kanban board management, terminal interaction, code editing, and an MCP toolchain into a unified environment for task management and AI agent collaboration.
+## Why Tower
+AI has changed how developers work. Before, you'd write code step by step, adjust requirements when issues came up, and keep everything in sync at your own pace.
+That's no longer the case. AI now handles most of the coding, and your role has shifted from *writing code* to *reviewing code*. You're also juggling more projects than ever — running several in parallel has become the norm.
+This creates real problems:
+- **Constant interruptions** — A new task or change request can drop in at any moment, breaking your train of thought. You finish reviewing a PR, switch to debug something in another project, and by the time you're back, you've lost your place.
+- **Lost context** — Bouncing between tasks means decisions, changes, and lessons learned slip through the cracks. There's nowhere to capture them, and by the time you need them again, they're gone.
+- **No way to review** — Conversations, code changes, terminal logs — they're scattered everywhere. When you want to look back, summarize, or extract lessons from a completed task, there's nothing to work with.
+Tower exists to fix this: **give every task a complete record**.
+Conversations, terminal logs, code diffs, file assets, execution summaries — everything is automatically captured in one place. You can switch between tasks without losing context, and once a task is done, use AI-powered review (Dreaming) to distill problems and insights into structured knowledge.
+Down the road, this feeds into a personal knowledge base — making everything searchable and reusable.
+## Core Concepts
+Tower's data model follows a three-level hierarchy:
+```
+Workspace → Project → Task
+```
+- **Workspace**: Top-level container that manages the namespace for projects and labels
+- **Project**: Belongs to a Workspace, holds tasks and code repositories. Supports both regular and Git-based projects
+- **Task**: The core work unit that flows across Kanban columns via status (TODO / IN_PROGRESS / IN_REVIEW / DONE / CANCELLED)
+Each Task can be associated with labels, execution records, and messages, with support for automated AI agent execution.
+## Tech Stack
+| Technology | Description |
+|------------|-------------|
+| **Next.js 16** | App Router, full-stack framework |
+| **TypeScript** | Type safety |
+| **SQLite + Prisma** | Lightweight database + ORM |
+| **TailwindCSS 4** | Utility-first CSS |
+| **shadcn (base-nova)** | UI component library |
+| **xterm.js + node-pty** | Terminal emulation |
+| **Monaco Editor** | Code editor |
+| **MCP Protocol** | AI tool protocol |
+## Feature Overview
+- **Kanban Board** -- Drag-and-drop sorting, label filtering, priority management
+- **AI Terminal** -- Independent Claude CLI terminal session per task
+- **Code Editing** -- Monaco Editor with multi-tab editing and Git diff view
+- **MCP Toolchain** -- 24+ tools for external AI agent integration
+- **Multi-task Monitoring** -- Missions panel for real-time monitoring of multiple executions
+- **Global Search** -- Full-text search across tasks, projects, and repositories
+- **Internationalization** -- Chinese and English bilingual support
+## Module Documentation
+Tower consists of the following 14 modules:
+| Module | Description |
+|--------|-------------|
+| [Workspace](../modules/workspace) | Workspace management |
+| [Project](../modules/project) | Project management |
+| [Task](../modules/task) | Task management |
+| [Board](../modules/board) | Kanban UI |
+| [Terminal](../modules/terminal) | PTY terminal system |
+| [Assistant](../modules/assistant) | AI assistant chat |
+| [Missions](../modules/missions) | Multi-task monitoring |
+| [Search](../modules/search) | Global search |
+| [Settings](../modules/settings) | System configuration |
+| [MCP](../modules/mcp) | MCP Server |
+| [Git](../modules/git) | Git integration |
+| [Assets & Notes](../modules/assets-notes) | Assets and notes |
+| [AI](../modules/ai) | AI capability layer |
+| [I18n](../modules/i18n) | Internationalization |

package/.next/standalone/tower/docs/en/index.md ADDED Viewed

@@ -0,0 +1,36 @@
+---
+layout: home
+hero:
+  name: Tower
+  text: AI Task Orchestration Platform
+  tagline: Kanban + Terminal + Code Editor + MCP Toolchain
+  image:
+    src: /logo.png
+    alt: Tower Logo
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /en/guide/getting-started
+    - theme: alt
+      text: Modules
+      link: /en/modules/workspace
+features:
+  - icon: 📋
+    title: Kanban Board
+    details: Drag-and-drop task cards with pinning, labels, priority filters, and context menus
+  - icon: 🤖
+    title: AI Terminal
+    details: xterm.js + Claude CLI for real-time interactive execution with auto-generated summaries
+  - icon: 🔧
+    title: MCP Toolchain
+    details: 24 MCP tools across 7 categories for seamless external AI agent integration
+  - icon: ✏️
+    title: Code Editor
+    details: Monaco Editor with multi-tab editing, syntax highlighting, and Ctrl+S save
+  - icon: 📡
+    title: Mission Control
+    details: Multi-task parallel monitoring dashboard with grid layouts and live terminal output
+  - icon: 🔍
+    title: Global Search
+    details: FTS5 full-text search across tasks, projects, notes, and assets
+---