@aion0/forge 0.5.26 → 0.5.28

package/.forge/worktrees/pipeline-4dd8dc2d/dev-test.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# dev-test.sh — Start Forge test instance (port 4000, data ~/.forge-test)
+
+mkdir -p ~/.forge-test
+PORT=4000 TERMINAL_PORT=4001 FORGE_DATA_DIR=~/.forge-test FORGE_EXTERNAL_SERVICES=0 npx next dev --turbopack -p 4000

package/.forge/worktrees/pipeline-4dd8dc2d/docs/LOCAL-DEPLOY.md

@@ -0,0 +1,144 @@
+# 本地部署 — Mac 上运行，手机监控
+
+---
+
+## 1. 手机访问本地 Mac 的方案
+
+核心问题：你的 Mac 在局域网内，手机怎么访问？
+
+### 方案对比
+
+| 方案 | 原理                                     | 优点 | 缺点 |
+|------|----------------------------------------|------|------|
+| **同一 WiFi 局域网** | Mac 开 Web 服务，手机直接访问 `192.168.x.x:8403` | 零配置、零成本 | 只能在家用 |
+| **Tailscale** | 虚拟局域网，任何网络下设备互通                        | 免费、安全、无需公网 IP | 需要装客户端 |
+| **Cloudflare Tunnel** | 免费内网穿透，给你一个公网域名                        | 免费、HTTPS、不开端口 | 依赖 Cloudflare |
+| **ngrok** | 临时隧道                                   | 一行命令搞定 | 免费版地址每次变 |
+| **frp** | 自建内网穿透                                 | 完全自控 | 需要一台有公网 IP 的服务器 |
+
+### 推荐组合：Tailscale（推荐） + 局域网（备选）
+
+```
+┌─────────────────────────────────┐
+│         你的 Mac                 │
+│                                 │
+│  my-workflow server             │
+│  ├── REST API    :8403          │
+│  ├── WebSocket   :8403/ws       │
+│  └── Dashboard   :8403          │
+│                                 │
+│  Tailscale IP: 100.x.x.x       │
+│  局域网 IP:    192.168.x.x      │
+└──────────┬──────────────────────┘
+           │
+           │  Tailscale 虚拟网络（加密）
+           │
+┌──────────┴──────────────────────┐
+│         你的手机                 │
+│                                 │
+│  浏览器 → 100.x.x.x:8403       │  ← 任何网络下都能访问
+│  或 Safari → 192.168.x.x:8403  │  ← 同一 WiFi 下
+│                                 │
+└─────────────────────────────────┘
+```
+
+**Tailscale 的好处：**
+- 免费（个人用户 100 台设备）
+- Mac 和手机都装一个客户端就完了
+- 在公司、咖啡厅、4G 网络下都能访问你家里的 Mac
+- 加密传输，不暴露任何端口到公网
+- 以后迁移到云服务器，只需要在服务器上装 Tailscale，手机地址改一下就行
+
+### 快速开始
+
+```bash
+# 1. Mac 安装 Tailscale
+brew install tailscale
+# 或从 Mac App Store 安装
+
+# 2. 登录
+tailscale up
+
+# 3. 查看你的 Tailscale IP
+tailscale ip -4
+# 输出: 100.64.x.x
+
+# 4. 手机安装 Tailscale App，同一账号登录
+
+# 5. 启动 my-workflow
+mw server start
+# → Dashboard: http://100.64.x.x:8403
+
+# 手机浏览器打开这个地址即可
+```
+
+### Mac 不休眠配置
+
+如果你想离开电脑后 agent 继续跑：
+
+```bash
+# 方法 1: 系统设置 → 电池 → 防止自动休眠（接电源时）
+
+# 方法 2: 命令行临时阻止休眠
+caffeinate -d -i -s &
+
+# 方法 3: 用 launchd 注册为系统服务（推荐）
+# 即使合盖，接着电源也不休眠
+# 见下方 "注册为系统服务" 部分
+```
+
+### 注册为系统服务（开机自启 + 崩溃自重启）
+
+```xml
+<!-- ~/Library/LaunchAgents/com.zliu.my-workflow.plist -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.zliu.my-workflow</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/local/bin/mw</string>
+        <string>server</string>
+        <string>start</string>
+        <string>--foreground</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/my-workflow.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/my-workflow.err</string>
+</dict>
+</plist>
+```
+
+```bash
+# 注册服务
+launchctl load ~/Library/LaunchAgents/com.zliu.my-workflow.plist
+
+# 查看状态
+launchctl list | grep my-workflow
+```
+
+---
+
+## 2. 未来迁移到云端
+
+本地跑通后，迁移非常简单：
+
+```
+本地开发阶段:
+  手机 → Tailscale → Mac:8403
+
+迁移到云端:
+  手机 → Tailscale → VPS:8403   (只是 IP 变了)
+  或
+  手机 → https://workflow.yourdomain.com  (Cloudflare Tunnel)
+```
+
+不需要改任何代码，只是服务跑在不同的机器上。

package/.forge/worktrees/pipeline-4dd8dc2d/docs/roadmap-multi-agent-workflow.md

@@ -0,0 +1,330 @@
+# Multi-Agent Workflow (Roadmap)
+
+> 让多个 Claude Code 实例协作完成复杂任务，相互传递信息和中间产物。
+
+## 动机
+
+当前的 Flow 系统是线性的：每个 step 独立运行一个 Claude Code，step 之间没有数据传递。真实的复杂工程场景需要：
+
+- **Agent A** 做架构设计 → 把设计文档传给 **Agent B** 写代码 → **Agent C** review + 测试
+- 多个 Agent 并行工作在不同模块，通过共享 artifact 协调
+- Agent 完成后触发下游 Agent，形成 DAG（有向无环图）执行流
+
+## 设计分析
+
+### 核心概念
+
+```
+Pipeline (一次执行实例)
+  └─ Workflow (YAML 定义)
+       └─ Node (一个 Agent 节点)
+            ├─ inputs:  从上游节点或用户获取
+            ├─ action:  运行 Claude Code prompt
+            ├─ outputs: 产出 artifact（文本、文件、diff）
+            └─ routes:  根据条件决定下游节点
+```
+
+**与现有系统的关系：**
+- `Node` 对应现有的 `Task`（一次 Claude Code 执行）
+- `Workflow` 扩展现有的 `Flow`（从线性 steps → DAG nodes）
+- `Pipeline` 是新增的，表示一次 workflow 运行实例
+
+### YAML 定义格式
+
+```yaml
+name: feature-implementation
+description: "从需求到 PR 的完整流程"
+
+# 全局变量，所有节点可用
+vars:
+  project: my-app
+
+nodes:
+  architect:
+    project: "{{vars.project}}"
+    prompt: |
+      分析以下需求并输出技术方案文档（markdown），包括：
+      1. 架构设计
+      2. 需要修改的文件列表
+      3. 接口定义
+      需求：{{input.requirement}}
+    outputs:
+      - name: design_doc
+        extract: result  # 从 Claude 的 result 中提取
+
+  implement:
+    project: "{{vars.project}}"
+    depends_on: [architect]
+    prompt: |
+      按照以下技术方案实现代码：
+      {{nodes.architect.outputs.design_doc}}
+    outputs:
+      - name: diff
+        extract: git_diff
+
+  review:
+    project: "{{vars.project}}"
+    depends_on: [implement]
+    prompt: |
+      Review 以下代码改动，检查：
+      1. 是否符合设计方案
+      2. 是否有 bug 或安全问题
+      3. 测试覆盖
+
+      设计方案：
+      {{nodes.architect.outputs.design_doc}}
+
+      代码改动：
+      {{nodes.implement.outputs.diff}}
+    outputs:
+      - name: review_result
+        extract: result
+    routes:
+      - condition: "{{outputs.review_result contains 'LGTM'}}"
+        next: create_pr
+      - condition: default
+        next: fix
+
+  fix:
+    project: "{{vars.project}}"
+    depends_on: [review]
+    prompt: |
+      根据 Review 意见修复代码：
+      {{nodes.review.outputs.review_result}}
+    routes:
+      - next: review  # 循环回 review（需要设定最大循环次数）
+    max_iterations: 3
+
+  create_pr:
+    project: "{{vars.project}}"
+    depends_on: [review]
+    prompt: |
+      为当前改动创建 Pull Request，标题和描述基于：
+      {{nodes.architect.outputs.design_doc}}
+```
+
+### 并行执行
+
+```yaml
+nodes:
+  frontend:
+    project: my-app-web
+    prompt: "实现前端登录页面..."
+
+  backend:
+    project: my-app-api
+    prompt: "实现后端 auth API..."
+
+  integration:
+    depends_on: [frontend, backend]  # 等两个都完成
+    project: my-app-web
+    prompt: |
+      前端和后端都已完成，进行集成：
+      前端改动：{{nodes.frontend.outputs.diff}}
+      后端改动：{{nodes.backend.outputs.diff}}
+```
+
+### 数据传递机制
+
+节点之间传递信息有三种方式：
+
+| 方式 | 说明 | 适用场景 |
+|------|------|----------|
+| **Output Extraction** | 从 Claude 的 result/diff 中自动提取 | 文本结果、设计文档 |
+| **File Artifact** | Claude 生成的文件保存到共享目录 | 代码文件、配置 |
+| **Git State** | 通过 git branch/commit 传递代码改动 | 同一 repo 的代码接力 |
+
+```yaml
+nodes:
+  generate_config:
+    prompt: "生成 API schema 文件到 shared/api-schema.json"
+    outputs:
+      - name: schema_file
+        type: file
+        path: "shared/api-schema.json"
+
+  use_config:
+    depends_on: [generate_config]
+    prompt: |
+      根据这个 schema 生成客户端代码：
+      {{read_file(nodes.generate_config.outputs.schema_file)}}
+```
+
+### 实现方案（基于现有架构）
+
+#### Phase 1：扩展 Flow → DAG
+
+**改动点：**
+
+1. **`src/types/index.ts`** — 新增类型：
+   ```typescript
+   export interface WorkflowNode {
+     id: string;
+     project: string;
+     prompt: string;           // 支持模板语法 {{...}}
+     dependsOn?: string[];     // 上游节点 ID
+     outputs?: NodeOutput[];
+     routes?: NodeRoute[];
+     maxIterations?: number;   // 防止无限循环
+   }
+
+   export interface NodeOutput {
+     name: string;
+     extract: 'result' | 'git_diff' | 'file';
+     path?: string;            // for file type
+   }
+
+   export interface NodeRoute {
+     condition: string;        // 模板表达式
+     next: string;             // 目标节点 ID
+   }
+
+   export interface Workflow {
+     name: string;
+     description?: string;
+     vars?: Record<string, string>;
+     nodes: Record<string, WorkflowNode>;
+     input?: Record<string, string>;  // 启动时需要的输入
+   }
+
+   export interface Pipeline {
+     id: string;
+     workflowName: string;
+     status: 'running' | 'done' | 'failed' | 'cancelled';
+     input: Record<string, any>;
+     nodeStates: Record<string, PipelineNodeState>;
+     createdAt: string;
+     completedAt?: string;
+   }
+
+   export interface PipelineNodeState {
+     status: TaskStatus;
+     taskId?: string;          // 关联的 Task ID
+     outputs: Record<string, any>;
+     iterations: number;
+     startedAt?: string;
+     completedAt?: string;
+   }
+   ```
+
+2. **`lib/pipeline-engine.ts`** — 新增 Pipeline 执行引擎：
+   - `startPipeline(workflowName, input)` → 创建 Pipeline，解析 DAG，启动无依赖节点
+   - `onTaskComplete(taskId)` → 检查下游节点是否 ready，触发执行
+   - `resolveTemplate(template, context)` → 解析 `{{...}}` 模板
+   - `evaluateRoute(routes, outputs)` → 条件路由
+   - `extractOutput(task, outputDef)` → 从 Task 结果中提取 output
+   - 状态持久化到 SQLite `pipelines` 表
+
+3. **`lib/task-manager.ts`** — 小改动：
+   - `createTask` 增加 `pipelineId` 和 `nodeId` 字段
+   - Task 完成时触发 `pipeline-engine.onTaskComplete`
+
+4. **`lib/flows.ts`** — 兼容升级：
+   - 旧格式（线性 steps）自动转换为 DAG（每个 step depends_on 上一个）
+   - 新格式支持 `nodes` 字段
+
+5. **UI 改动：**
+   - Pipeline 视图：DAG 可视化，显示节点状态和数据流
+   - 节点详情：点击查看 prompt（渲染后）、outputs、关联 task
+   - 启动 workflow 时可填入 input 参数
+
+6. **API 路由：**
+   - `POST /api/pipelines` — 启动 pipeline
+   - `GET /api/pipelines` — 列表
+   - `GET /api/pipelines/[id]` — 详情（含 DAG 状态）
+   - `POST /api/pipelines/[id]/cancel` — 取消
+
+7. **CLI：**
+   - `forge run <workflow> --input requirement="实现用户注册功能"`
+   - `forge pipeline <id>` — 查看 pipeline 状态
+   - `forge pipelines` — 列表
+
+#### Phase 2：实时协作（高级）
+
+更高级的场景——Agent 不是等上游完全结束才开始，而是通过消息通道实时交互：
+
+```yaml
+nodes:
+  coder:
+    prompt: "实现功能..."
+    channels:
+      - name: questions
+        direction: out
+        target: architect
+
+  architect:
+    prompt: "你是架构师，回答 coder 的问题..."
+    channels:
+      - name: questions
+        direction: in
+        source: coder
+```
+
+这需要：
+- 两个 Claude Code 进程同时运行
+- 中间消息总线（可基于 SQLite + polling 或 WebSocket）
+- 一个 Agent 的 output 实时注入另一个 Agent 的 stdin（通过 `--resume` + append message）
+
+**复杂度高，建议 Phase 1 稳定后再考虑。**
+
+### 执行流程示意
+
+```
+User: forge run feature-implementation --input requirement="Add OAuth login"
+  │
+  ▼
+Pipeline created (id: pip-abc123)
+  │
+  ▼ (resolve input template)
+[architect] ──prompt──▶ Claude Code ──result──▶ design_doc
+  │
+  ▼ (depends_on satisfied)
+[implement] ──prompt(with design_doc)──▶ Claude Code ──git_diff──▶ diff
+  │
+  ▼
+[review] ──prompt(with design_doc + diff)──▶ Claude Code ──result──▶ review_result
+  │
+  ├── "LGTM" ──▶ [create_pr]
+  │
+  └── else ──▶ [fix] ──▶ [review] (loop, max 3)
+```
+
+### SQLite Schema
+
+```sql
+CREATE TABLE pipelines (
+  id TEXT PRIMARY KEY,
+  workflow_name TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'running',
+  input TEXT,          -- JSON
+  node_states TEXT,    -- JSON: Record<nodeId, PipelineNodeState>
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  completed_at DATETIME
+);
+
+-- tasks 表增加：
+ALTER TABLE tasks ADD COLUMN pipeline_id TEXT;
+ALTER TABLE tasks ADD COLUMN node_id TEXT;
+```
+
+### 工作量评估
+
+| 模块 | 工作量 | 说明 |
+|------|--------|------|
+| 类型定义 | 小 | 新增 Workflow/Pipeline/Node 类型 |
+| YAML 解析 | 小 | 扩展现有 flows.ts |
+| 模板引擎 | 中 | `{{...}}` 解析 + output 引用 |
+| Pipeline 引擎 | 大 | DAG 调度、状态管理、条件路由 |
+| Task Manager 集成 | 小 | 增加 pipeline/node 关联 |
+| Pipeline UI | 大 | DAG 可视化、实时状态 |
+| CLI 扩展 | 小 | 新增 pipeline 命令 |
+| **总计** | **~3-5 天** | Phase 1 完整可用 |
+
+### 关键设计决策
+
+1. **模板语法**：用 `{{...}}` Mustache 风格，简单够用，不引入 Handlebars 依赖
+2. **Output 提取**：默认取 Claude 的 `result` 字段；`git_diff` 取 task 的 diff；`file` 读指定路径
+3. **循环保护**：`max_iterations` 默认 3，防止 review → fix 无限循环
+4. **错误处理**：单节点失败 → 标记该节点 failed → 下游节点 skip → Pipeline 标记 failed
+5. **并发**：同 project 的节点串行（现有 `runningProjects` 锁），不同 project 的节点并行
+6. **向后兼容**：现有线性 Flow YAML 无需修改，自动适配

package/.forge/worktrees/pipeline-4dd8dc2d/forge-logo.svg

@@ -0,0 +1,106 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="1050.000000pt" height="1102.000000pt" viewBox="0 0 1050.000000 1102.000000"
+ preserveAspectRatio="xMidYMid meet">
+
+<g transform="translate(0.000000,1102.000000) scale(0.100000,-0.100000)"
+fill="#000000" stroke="none">
+<path d="M0 5510 l0 -5510 5250 0 5250 0 0 5510 0 5510 -5250 0 -5250 0 0
+-5510z m2410 3369 c37 -18 164 -120 395 -319 584 -503 1025 -883 1101 -946 39
+-34 111 -96 159 -138 52 -45 96 -76 109 -76 12 0 233 45 492 99 258 55 503
+106 544 115 67 13 83 14 137 1 74 -17 147 -33 398 -85 105 -21 233 -48 285
+-60 237 -52 327 -70 350 -70 25 0 127 84 655 541 61 52 162 139 225 193 63 54
+171 147 240 207 475 410 597 512 643 536 74 38 198 44 279 13 66 -24 145 -92
+181 -153 60 -101 57 -27 57 -1656 l0 -1492 54 -217 c57 -224 150 -590 185
+-722 10 -41 38 -147 62 -235 23 -88 47 -185 54 -215 7 -30 16 -67 20 -82 6
+-25 5 -28 -19 -28 -15 0 -29 6 -32 14 -4 11 -13 12 -35 6 -16 -5 -68 -12 -114
+-15 l-84 -7 -6 29 c-4 15 -9 35 -12 43 -2 8 -29 110 -58 225 -30 116 -75 289
+-100 385 -25 96 -81 316 -125 488 l-80 313 0 1495 c0 1664 5 1554 -65 1554
+-29 0 -49 -13 -123 -77 -88 -77 -479 -412 -617 -528 -40 -33 -213 -181 -385
+-330 -173 -148 -399 -343 -504 -432 -121 -105 -197 -163 -211 -163 -21 0 -115
+19 -525 106 -204 43 -302 64 -500 105 l-155 32 -115 -23 c-63 -12 -155 -31
+-205 -42 -49 -11 -133 -28 -185 -39 -52 -11 -124 -27 -160 -34 -259 -56 -505
+-105 -526 -105 -17 0 -66 36 -162 119 -341 296 -862 743 -1486 1275 -166 142
+-194 156 -230 120 -9 -8 -17 -16 -18 -17 -2 -1 -5 -688 -8 -1527 l-5 -1525
+-53 -195 c-28 -107 -79 -298 -111 -425 -33 -126 -72 -275 -86 -330 -15 -55
+-46 -177 -70 -271 -64 -248 -50 -226 -142 -219 -129 10 -144 11 -149 3 -8 -13
+-54 -9 -54 5 0 6 5 28 11 47 6 19 17 60 24 90 11 50 115 454 165 645 12 44 56
+213 98 375 l77 295 5 1540 5 1540 33 67 c40 81 117 155 193 186 78 31 202 27
+279 -9z m560 -1324 c0 -85 0 -85 -26 -85 -36 0 -81 -29 -94 -59 -6 -14 -14
+-112 -19 -217 -9 -212 -21 -257 -83 -309 l-30 -25 40 -44 c58 -63 73 -120 78
+-301 2 -82 4 -160 4 -173 0 -37 52 -82 94 -82 l36 0 0 -85 0 -85 -47 0 c-107
+1 -190 39 -237 111 -42 63 -56 137 -56 294 0 77 -3 157 -6 177 -9 50 -43 85
+-98 100 l-46 12 0 78 c0 77 0 78 28 84 111 24 115 34 123 268 6 204 13 236 58
+307 45 72 133 113 254 118 l27 1 0 -85z m4810 42 c117 -58 150 -147 150 -406
+0 -192 17 -229 113 -246 l38 -7 -3 -76 -3 -75 -49 -17 c-84 -28 -89 -41 -97
+-254 -4 -101 -10 -199 -14 -218 -17 -79 -79 -154 -153 -185 -19 -8 -66 -15
+-106 -16 l-71 -2 0 80 0 79 45 8 c81 13 86 27 93 239 7 208 18 258 73 316 19
+20 34 37 34 38 0 1 -16 19 -35 40 -52 57 -65 109 -66 254 0 196 -10 259 -43
+287 -15 13 -45 27 -67 30 l-39 7 0 77 c0 54 4 80 13 83 32 12 126 -6 187 -36z
+m-3638 -2314 c233 -236 490 -501 596 -615 72 -77 72 -77 72 -133 l0 -57 -177
+-181 c-455 -467 -688 -697 -710 -697 -23 0 -198 181 -198 206 0 7 159 173 354
+369 195 195 353 357 350 360 -17 18 -186 194 -424 438 -154 159 -282 293 -284
+299 -3 10 197 218 210 218 3 0 98 -93 211 -207z m2473 -1633 l0 -145 -95 -6
+c-121 -9 -1077 -8 -1320 0 l-185 6 -3 134 c-2 90 1 138 9 147 10 12 136 14
+803 12 l791 -3 0 -145z m-4912 -141 c21 -35 42 -73 48 -84 22 -47 71 -129 86
+-143 14 -14 16 -14 25 1 5 9 14 17 20 17 7 0 6 -5 -2 -15 -6 -8 -9 -19 -5 -26
+4 -6 2 -15 -5 -19 -9 -5 -5 -20 13 -56 13 -27 28 -59 32 -72 4 -13 25 -55 47
+-93 38 -65 44 -106 16 -97 -11 4 -40 53 -160 278 -66 123 -173 337 -188 374
+-10 28 -10 29 12 14 13 -9 40 -44 61 -79z m7221 54 c-4 -16 -28 -68 -54 -118
+-26 -49 -80 -153 -120 -230 -40 -77 -90 -170 -112 -207 -21 -36 -38 -71 -38
+-77 0 -13 -27 -15 -34 -2 -3 5 8 41 24 79 17 39 30 78 30 87 0 9 5 13 11 9 8
+-4 9 1 4 17 -4 13 -4 21 0 17 5 -4 14 0 21 10 9 13 10 20 1 31 -10 12 -9 14 4
+9 17 -7 40 30 132 212 74 146 149 240 131 163z m-284 -35 c-7 -18 -33 -75 -57
+-126 -24 -51 -43 -99 -43 -106 0 -7 -7 -19 -15 -26 -9 -7 -13 -20 -10 -30 3
+-10 -5 -26 -21 -41 -14 -13 -46 -59 -71 -101 -30 -53 -49 -75 -59 -71 -8 3
+-14 9 -14 13 0 28 233 461 252 468 4 2 8 8 8 13 0 11 33 47 39 43 2 -2 -2 -18
+-9 -36z m-6543 -260 c99 -190 119 -235 106 -241 -18 -11 -8 -24 -87 113 -87
+148 -108 179 -124 180 -14 0 -36 49 -27 58 3 4 8 -4 12 -16 3 -12 10 -22 15
+-22 5 0 0 17 -11 38 -28 52 -51 111 -51 132 0 10 -5 20 -12 22 -7 3 -8 9 -3
+18 15 24 52 -34 182 -282z m-231 54 c-18 -18 -29 -12 -20 11 3 9 12 13 21 10
+13 -5 13 -8 -1 -21z m6779 -162 c3 -5 1 -10 -4 -10 -6 0 -11 5 -11 10 0 6 2
+10 4 10 3 0 8 -4 11 -10z m-751 -568 c-22 -19 -66 -52 -99 -75 -33 -22 -99
+-69 -146 -103 -48 -35 -89 -64 -93 -64 -3 0 -14 -7 -23 -16 -17 -14 -69 -51
+-248 -174 -36 -25 -107 -74 -158 -110 -51 -36 -100 -69 -109 -75 -8 -5 -43
+-30 -78 -55 -34 -25 -75 -53 -92 -62 -17 -9 -34 -21 -37 -25 -15 -20 -72 -53
+-82 -47 -12 7 48 63 69 64 6 0 12 4 12 8 0 5 33 31 72 58 40 27 77 53 83 57
+16 12 252 181 414 295 73 52 180 126 205 142 27 17 67 46 204 147 62 45 106
+71 121 70 22 -1 21 -4 -15 -35z m-5149 -18 c5 -5 30 -23 54 -39 25 -15 50 -32
+55 -37 6 -5 65 -47 131 -93 66 -46 125 -88 130 -92 6 -4 30 -21 55 -37 25 -16
+72 -50 105 -75 58 -45 100 -75 134 -96 9 -5 32 -22 51 -37 20 -14 71 -50 115
+-79 44 -29 97 -71 119 -93 21 -21 36 -34 32 -28 -12 20 10 13 36 -10 14 -13
+35 -30 47 -38 11 -8 21 -20 21 -28 0 -12 -27 2 -75 40 -5 5 -53 37 -105 71
+-134 89 -261 177 -285 197 -11 10 -74 54 -140 99 -66 45 -147 102 -180 126
+-70 52 -161 116 -183 130 -12 7 -140 100 -181 131 -1 1 0 7 3 13 7 11 39 -2
+61 -25z m5388 -81 c-5 -12 -3 -14 8 -8 68 39 -178 -142 -435 -320 -154 -106
+-291 -203 -384 -270 -53 -39 -135 -96 -182 -127 -102 -69 -351 -246 -383 -273
+-52 -44 -168 -104 -167 -88 1 11 75 67 195 148 96 65 153 106 288 206 34 25
+107 76 162 114 93 63 384 273 467 337 20 15 39 28 43 28 3 0 45 29 93 64 78
+57 294 206 299 206 1 0 -1 -7 -4 -17z m-5615 -47 c71 -47 139 -94 159 -111 6
+-5 49 -36 95 -68 46 -32 162 -114 258 -183 96 -69 231 -164 300 -211 122 -85
+260 -185 290 -210 8 -7 24 -19 35 -27 11 -8 17 -17 13 -21 -7 -8 -42 10 -84
+42 -16 12 -76 54 -134 93 -58 39 -143 98 -190 131 -47 33 -96 68 -110 77 -26
+17 -177 125 -195 139 -5 4 -30 21 -55 38 -25 16 -95 66 -156 111 -61 45 -122
+87 -135 94 -25 14 -113 79 -140 105 -9 8 -20 15 -26 15 -5 0 -10 7 -10 15 0
+23 13 19 85 -29z m1347 -667 c11 -17 -1 -21 -15 -4 -8 9 -8 15 -2 15 6 0 14
+-5 17 -11z m2850 1 c10 -16 -258 -206 -276 -195 -15 10 0 25 19 18 9 -3 14 -3
+10 2 -9 9 26 42 53 50 11 4 19 11 19 17 0 6 3 8 7 5 3 -4 16 5 29 18 13 14 27
+25 31 26 4 0 28 15 53 34 53 40 47 37 55 25z m-2795 -49 c-1 -15 -2 -15 -13 0
+-7 9 -19 14 -27 12 -13 -4 -13 -3 -1 5 19 13 41 4 41 -17z m178 -117 c34 -27
+37 -39 8 -28 -9 3 -14 10 -11 14 3 4 -8 10 -23 13 -15 4 -40 19 -57 34 -16 15
+-43 35 -58 43 -16 8 -24 16 -18 18 6 2 8 8 5 14 -7 11 99 -63 154 -108z m-190
+-152 c62 -43 76 -62 47 -62 -8 0 -15 3 -15 8 0 4 -15 13 -32 21 -18 8 -35 17
+-38 20 -3 3 -27 22 -55 40 -27 19 -52 37 -55 41 -3 3 -24 18 -47 33 -25 18
+-40 34 -36 43 5 13 36 -6 231 -144z m452 28 c0 -5 -15 -10 -34 -10 -19 0 -38
+5 -41 10 -4 6 10 10 34 10 23 0 41 -4 41 -10z m685 5 c-25 -8 -675 -12 -675
+-4 0 5 141 9 343 8 188 0 338 -2 332 -4z m705 -5 c-96 -3 -249 -3 -340 0 -113
+4 -58 6 175 6 246 0 291 -2 165 -6z m263 3 c-7 -2 -21 -2 -30 0 -10 3 -4 5 12
+5 17 0 24 -2 18 -5z m165 0 c-21 -2 -57 -2 -80 0 -24 2 -7 4 37 4 44 0 63 -2
+43 -4z m401 -119 c-6 -7 -15 -12 -19 -9 -5 3 -11 1 -15 -5 -4 -6 -11 -7 -17
+-4 -5 4 2 14 18 25 30 20 52 15 33 -7z m-134 -84 c3 -5 -3 -10 -15 -10 -12 0
+-18 5 -15 10 3 6 10 10 15 10 5 0 12 -4 15 -10z m-71 -39 c3 -5 -11 -7 -32 -4
+-49 7 -54 13 -9 13 20 0 38 -4 41 -9z"/>
+</g>
+</svg>

package/.forge/worktrees/pipeline-4dd8dc2d/hooks/useSidebarResize.ts

@@ -0,0 +1,52 @@
+import { useState, useRef, useCallback } from 'react';
+
+interface UseSidebarResizeOptions {
+  defaultWidth?: number;
+  minWidth?: number;
+  maxWidth?: number;
+}
+
+/**
+ * Provides drag-to-resize behaviour for a vertical split panel sidebar.
+ *
+ * Usage:
+ *   const { sidebarWidth, onSidebarDragStart } = useSidebarResize({ defaultWidth: 224 });
+ *
+ *   <aside style={{ width: sidebarWidth }} className="flex flex-col shrink-0 overflow-hidden">…</aside>
+ *   <div onMouseDown={onSidebarDragStart} className="w-1 cursor-col-resize shrink-0 bg-[var(--border)] hover:bg-[var(--accent)]/50" />
+ *   <main className="flex-1 min-w-0">…</main>
+ */
+export function useSidebarResize({
+  defaultWidth = 224,
+  minWidth = 120,
+  maxWidth = 480,
+}: UseSidebarResizeOptions = {}) {
+  const [sidebarWidth, setSidebarWidth] = useState(defaultWidth);
+  // Track the in-progress drag without causing re-renders in the move handler
+  const dragRef = useRef<{ startX: number; startW: number } | null>(null);
+  // Keep a mutable copy so the stable onSidebarDragStart callback always reads the latest width
+  const widthRef = useRef(defaultWidth);
+
+  const onSidebarDragStart = useCallback((e: React.MouseEvent) => {
+    e.preventDefault();
+    dragRef.current = { startX: e.clientX, startW: widthRef.current };
+
+    const onMove = (ev: MouseEvent) => {
+      if (!dragRef.current) return;
+      const next = Math.max(minWidth, Math.min(maxWidth, dragRef.current.startW + ev.clientX - dragRef.current.startX));
+      widthRef.current = next;
+      setSidebarWidth(next);
+    };
+
+    const onUp = () => {
+      dragRef.current = null;
+      window.removeEventListener('mousemove', onMove);
+      window.removeEventListener('mouseup', onUp);
+    };
+
+    window.addEventListener('mousemove', onMove);
+    window.addEventListener('mouseup', onUp);
+  }, [minWidth, maxWidth]);
+
+  return { sidebarWidth, onSidebarDragStart };
+}

package/.forge/worktrees/pipeline-4dd8dc2d/install.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# install.sh — Install Forge globally, ready to run
+#
+# Usage:
+#   ./install.sh          # from npm
+#   ./install.sh local    # from local source
+
+set -e
+
+if [ "$1" = "local" ] || [ "$1" = "--local" ]; then
+  echo "[forge] Installing from local source..."
+  npm uninstall -g @aion0/forge 2>/dev/null || true
+  npm link
+  echo "[forge] Building..."
+  pnpm build || echo "[forge] Build completed with warnings (non-critical)"
+else
+  echo "[forge] Installing from npm..."
+  rm -rf "$(npm root -g)/@aion0/forge" 2>/dev/null || true
+  npm cache clean --force 2>/dev/null || true
+  # Install from /tmp to avoid pnpm node_modules conflict
+  (cd /tmp && npm install -g @aion0/forge)
+  echo "[forge] Building..."
+  cd "$(npm root -g)/@aion0/forge" && (npx next build || echo "[forge] Build completed with warnings") && cd -
+fi
+
+echo ""
+echo "[forge] Done."
+forge --version
+echo "Run: forge server start"