monoco-toolkit 0.1.1__tar.gz → 0.1.3__tar.gz

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/.github/workflows/publish-npm.yml

@@ -20,25 +20,25 @@ jobs:
 
       - name: Install dependencies
         run: |
-          cd Toolkit/Kanban
+          cd Kanban
           npm install
 
-      - name: Build WebUI
+      - name: Build All Workspaces
         run: |
-          cd Toolkit/Kanban
-          npm run build --workspace=@monoco/kanban-webui
+          cd Kanban
+          npm run build --workspaces
 
       - name: Prepare Package
         run: |
-          mkdir -p Toolkit/Kanban/packages/monoco-kanban/dist
-          cp -r Toolkit/Kanban/apps/webui/out/* Toolkit/Kanban/packages/monoco-kanban/dist/
+          mkdir -p Kanban/packages/monoco-kanban/dist
+          cp -r Kanban/apps/webui/out/* Kanban/packages/monoco-kanban/dist/
           # Sync version from tag
           VERSION=${GITHUB_REF#refs/tags/v}
-          sed -i "s/\"version\": \"0.1.0\"/\"version\": \"$VERSION\"/g" Toolkit/Kanban/packages/monoco-kanban/package.json
+          sed -i "s/\"version\": \"0.1.0\"/\"version\": \"$VERSION\"/g" Kanban/packages/monoco-kanban/package.json
 
       - name: Publish to NPM
         run: |
-          cd Toolkit/Kanban/packages/monoco-kanban
+          cd Kanban/packages/monoco-kanban
           npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

monoco_toolkit-0.1.3/.github/workflows/publish-vscode-extension.yml

@@ -0,0 +1,67 @@
+name: Publish Toolkit VS Code Extension
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "toolkit-v*"
+    paths:
+      - "extensions/vscode/**"
+      - ".github/workflows/publish-vscode-extension.yml"
+  pull_request:
+    paths:
+      - "extensions/vscode/**"
+      - ".github/workflows/publish-vscode-extension.yml"
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    name: Build, Package and Publish
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: extensions/vscode
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: "npm"
+          cache-dependency-path: extensions/vscode/package-lock.json
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Compile
+        run: npm run compile
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Package Extension
+        run: npx @vscode/vsce package
+        # vsce package will generate a .vsix file in the current directory (extensions/vscode)
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: monoco-vscode-extension
+          path: extensions/vscode/*.vsix
+          if-no-files-found: error
+
+      - name: Publish to VS Code Marketplace
+        if: startsWith(github.ref, 'refs/tags/toolkit-v')
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+        run: npx @vscode/vsce publish --pat ${{ secrets.VSCE_PAT }}
+
+      - name: Publish to Open VSX
+        if: startsWith(github.ref, 'refs/tags/toolkit-v')
+        env:
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}
+        run: npx ovsx publish ./*.vsix --pat ${{ secrets.OVSX_PAT }}

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/.gitignore

@@ -14,7 +14,7 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
+# lib/
 lib64/
 parts/
 sdist/

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/Issues/Epics/open/EPIC-0009-cicd-/345/237/272/345/273/272.md

@@ -11,7 +11,7 @@ updated_at: '2026-01-13T13:21:48'
 dependencies: []
 related: []
 tags: []
-progress: 1/1
+progress: 2/2
 files_count: 0
 ---
 
@@ -32,6 +32,6 @@ files_count: 0
 
 - [ ] 配置 GitHub Pages 自动部署流程 (Next.js SSG)。
 - [x] 构建 Toolkit 的 GitHub Action 发布流水线 (FEAT-0051)。
-- [ ] 构建 Kanban 的 GitHub Action 发布流水线 (FEAT-0010)。
+- [x] 构建 Kanban 的 GitHub Action 发布流水线 (FEAT-0058)。
 - [ ] 集成代码质量检查 (Lint, Type Check, Pytest) 到 CI。
 - [ ] 优化缓存策略，减少 CI 运行时间。

monoco_toolkit-0.1.3/Issues/Epics/open/EPIC-0010-agent-terminal-integration.md

@@ -0,0 +1,68 @@
+---
+id: EPIC-0010
+type: Epic
+title: Agent Terminal Integration (PTY & Console)
+status: Open
+owner: Product Owner
+parent: null
+dependencies:
+- EPIC-0005
+- EPIC-0006
+tags:
+- agent-native
+- terminal
+- cli
+- websocket
+created_at: 2026-01-14
+progress: 1/2
+files_count: 0
+stage: doing
+---
+
+# Agent Terminal Integration (PTY & Console)
+
+## Executive Summary
+
+为了实现 Monoco "Agent Cockpit" 的愿景，我们需要在 Kanban 界面中引入原生的终端控制台 (Terminal Console)。这将允许用户直接在一个界面中进行 "战略指挥" (Kanban) 和 "战术执行" (CLI Agents)。
+
+通过引入 PTY (Pseudo-Terminal) 和 WebSocket 支持，用户将能够直接在 Web 界面中运行 `gemini`、`claude` 或 `git` 命令，并享受完整的终端交互体验。
+
+## Outcome & Value
+
+- **God Mode + God Hand**: 用户在查看全局进度的同时，拥有直接操作底层的能力。
+- **Agent Native Interaction**: 不再依赖受限的 Chatbot UI，而是拥抱功能最全、生态最丰富的 CLI Agents。
+- **Context Awareness**: 终端 session 将能够感知 Kanban 当前的上下文（如选中的 Issue），实现无缝的人机协作。
+
+## Key Results (KRs)
+
+- **KR1**: Toolkit Daemon 实现支持多会话 (Multi-Session) 的 PTY 管理器 (`monoco.daemon.terminal`)。
+- **KR2**: Kanban UI 实现带有 Tab 页签切换功能的原生终端面板。
+- **KR3**: 实现 "Context Injection" 与 "Auto-Startup"，支持自动运行预设命令 (e.g. `claude`, `gemini`) 并注入上下文，减少冷启动等待。
+- **KR4**: 验证主流 CLI Agent 在 Web 终端中的交互流畅性。
+
+## Scope
+
+### Infrastructure (Toolkit)
+
+- **WebSocket & PTY Manager**: 引入 `fastapi-websockets`，实现基于 Session ID 的多路复用 PTY 管理。
+- **Auto-Startup Configuration**:
+  - 支持配置 "Default Command" (如 `claude` 或 `monoco agent`)，在 Session 建立时自动执行。
+  - 实现 "Pre-warming" 机制，让 Agent 进程提前就绪，通过 PTY 保持活跃，避免每次交互都重新握手/加载模型。
+- **Security**: Localhost restrictive access.
+
+### User Interface (Kanban)
+
+- **Terminal Emulator**: `xterm.js` + `xterm-addon-fit` 集成.
+- **Multi-Tab Interface**:
+  - 支持并发管理多个 Terminal Session。
+  - 区分 "Global Shell" (主控台) 和 "Task Shell" (任务专用)。
+  - Tab 状态指示器 (Idle/Running/Error)。
+- **Interaction**:
+  - 底部状态栏 Toggle (HUD 风格)。
+  - 全局快捷键 (`Cmd+J`) 唤出并聚焦。
+  - Theme 自动同步 (Glassmorphism 背景)。
+
+### Experience
+
+- **Context Awareness**: 点击 Issue 上的 "Run" 时，自动创建新 Tab 并注入环境变量 (`export CURRENT_ISSUE=...`)。
+- **Seamless Auth**: 确保 CLI Agent 的认证状态（如 OAuth Token）能持久化并在 PTY 中复用，避免重复登录。

monoco_toolkit-0.1.3/Issues/Epics/open/EPIC-0011-vscode-extension-integration.md

@@ -0,0 +1,67 @@
+---
+id: EPIC-0011
+type: Epic
+title: VS Code Cockpit Integration (VS Code 驾驶舱集成)
+status: Open
+owner: Product Owner
+parent: null
+dependencies:
+- EPIC-0006
+- EPIC-0010
+tags:
+- vscode
+- extension
+- webview
+- cockpit
+created_at: 2026-01-14
+progress: 0/4
+files_count: 0
+stage: todo
+---
+
+# EPIC-0011: VS Code Cockpit Integration (VS Code 驾驶舱集成)
+
+## 执行摘要 (Executive Summary)
+
+为了将 Monoco 打造为开发者的“第二大脑”，我们需要将其深度嵌入到开发者最核心的工作场域——VS Code。本项目旨在通过 VS Code Extension 将 Kanban (战略管理) 与 Agent Terminal (战术执行) 集成为一套无缝的“驾驶舱”体验。
+
+这不仅是 UI 的迁移，更是上下文 (Context) 的横向贯通。
+
+## 目标与价值 (Outcome & Value)
+
+- **全链路闭环**: 实现从 Issue 阅读、代码定位、Agent 调度到代码提交的完全闭环，无需离开 IDE。
+- **上下文增强**: 利用 VS Code API 提供的实时代码上下文（当前文件、选中行、诊断信息），大幅提升 Agent 的决策准确率。
+- **极致体验**: 利用 VS Code 原生界面元素（Sidebar, Activity Bar, QuickPick）提供流畅的操作体验。
+
+## 关键结果 (Key Results)
+
+- **KR1**: 支持在 VS Code Sidebar/Webview 完整加载并运行 Monoco Kanban (Next.js 导出版)。
+- **KR2**: 建立一套基于消息总线 (Message Bus) 的跨环境通信协议，支持 Webview、插件进程与 Monoco CLI/Daemon 之间的协同。
+- **KR3**: 提供一键“由代码创建 Issue”和“一键定位 Issue 关联代码”的功能。
+- **KR4**: 在右侧 Agent Bar 实现与 EPIC-0010 PTY 对接的实时执行流展示。
+
+## 范围 (Scope)
+
+### VS Code Extension (桥接层)
+
+- **Activity Bar & Sidebar**: 挂载任务导航。
+- **Status Bar**: 显示 Agent 状态与任务进度。
+- **Command Palette Integration**: 快速调用 `monoco issue` 等命令。
+- **Webview Adapter**: 实现 `acquireVsCodeApi` 到 Monoco Protocol 的适配。
+
+### Toolkit/Kanban (展现层)
+
+- **Universal Adpater**: 适配 Web 环境与 VS Code 环境的通信差异。
+- **UX Tuning**: 针对小尺寸侧边栏设计的高密压缩视图。
+
+### Experience (体验层)
+
+- **Code Link**: Issue 详情页中的文件路径可点击，直接在 VS Code 中打开对应位置。
+- **Agent Cockpit**: 类似 Cursor 的侧边交互栏，用于触发和监控 Agent 行为。
+
+## 路线图 (Roadmap)
+
+1. **原型验证 (P0)**: 验证 Webview 通信与样式适配。
+2. **核心链接 (P1)**: 实现看板与 IDE 代码定位的联动。
+3. **Agent 协同 (P2)**: 实现右侧 Agent Bar 与 PTY 的集成。
+4. **生态扩展 (P3)**: 发布至 VS Code Marketplace。

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/Issues/Features/closed/FEAT-0019-/345/205/250/345/261/200/344/273/252/350/241/250/347/233/230.md

@@ -44,7 +44,7 @@ tags: []
   - **实现方案**: 新增 `GET /api/v1/stats/dashboard`。
   - **Blocked 定义**: 暂定为 "存在未 Close 的前置依赖 (dependencies)" 的 Issue。
 - [x] **前端状态管理**: 重构前端状态管理 (Zustand)。
-  - **Store 设计**: 在 `@monoco/kanban-core` 中扩展或新增 Store，统一管理 Project Stats 与 Issues。
+  - **Store 设计**: 在 `@monoco-io/kanban-core` 中扩展或新增 Store，统一管理 Project Stats 与 Issues。
     - `useDashboardStore`: 管理聚合指标 (Stats) 和动态 (Activity)。
     - `useKanbanStore`: 继续管理 Issue 列表数据。
   - **数据同步**: 升级 `useKanbanSync` Hook。

monoco_toolkit-0.1.3/Issues/Features/closed/FEAT-0056-toolkit-pty-service.md

@@ -0,0 +1,73 @@
+---
+id: FEAT-0056
+type: feature
+status: closed
+stage: done
+title: Implement monoco-pty Service via WebSockets
+created_at: '2026-01-14T00:00:00'
+updated_at: '2026-01-14T08:24:53'
+closed_at: '2026-01-14T08:24:53'
+parent: EPIC-0010
+solution: implemented
+dependencies: []
+related: []
+tags:
+- pty
+- websocket
+- cli
+- daemon
+owner: Backend Engineer
+---
+
+# Feature: Implement monoco-pty Service
+
+## Context
+
+为了支持 EPIC-0010 "Agent Terminal Integration"，我们需要一个专门负责终端会话管理的服务。
+根据架构决策，该服务将独立于 `monoco serve` 运行，通过独立的命令 `monoco pty` 启动，以保证系统的解耦与稳定性。
+
+## Goals
+
+1.  实现 `monoco.features.pty` 模块与 `monoco pty` CLI 命令。
+2.  提供基于 WebSocket 的 PTY 流式接口。
+3.  支持多 Session 管理与自动环境注入。
+
+## Technical Design
+
+### 1. Service Architecture
+
+- **Entry Point**: `monoco pty` (Uvicorn running FastAPI/Starlette).
+- **Port**: Default to `3124` (Distinct from main daemon).
+- **State Sharing**: 启动时读取 `.monoco/state.json` (或通过参数) 确定 Workspace Root。
+
+### 2. WebSocket Protocol
+
+- **Endpoint**: `ws://localhost:3124/ws/{session_id}`
+- **Handshake Params**:
+  - `cols`, `rows`: Terminal dimensions.
+  - `env`: JSON string identifying context (e.g., `{"CURRENT_ISSUE": "FEAT-123"}`).
+  - `command`: (Optional) Auto-run command (e.g., `claude`).
+
+### 3. PTY Manager Logic
+
+- 使用 Python `pty` (Unix) 或 `pywinpty` (Windows) 库。
+- **Session Lifecycle**:
+  - Connection Open -> Spawn Process.
+  - Process Exit -> Close Connection.
+  - Connection Drop -> Kill Process (or configurable keep-alive).
+
+## Tasks
+
+- [ ] **Core**: 创建 `monoco/features/pty/` 目录结构。
+- [ ] **Server**: 实现 `monoco pty` CLI 命令与 FastAPI App 初始化。
+- [ ] **Logic**: 实现 `PTYManager` 类，负责 spawn shell 和 IO forwarding。
+- [ ] **API**: 实现 WebSocket 路由与双向数据管道 (Input -> Stdin, Stdout -> Output)。
+- [ ] **Context**: 实现环境变量注入逻辑 (`env` param -> `subprocess.Popen(env=...)`)。
+- [ ] **Test**: 编写简单的 HTML/JS Client 验证连通性。
+
+## Acceptance Criteria
+
+- [ ] 运行 `monoco pty` 后，可以通过 WebSocket 客户端连接并获得交互式 Shell。
+- [ ] 支持同时打开多个独立的 Shell Session。
+- [ ] 传递 `env={"TEST": "1"}` 时，在该 Shell 中执行 `echo $TEST` 输出 `1`。
+- [ ] 进程崩溃或退出时，WebSocket 连接正常关闭。

monoco_toolkit-0.1.3/Issues/Features/closed/FEAT-0058-kanban-/345/210/206/345/217/221-npm.md

@@ -0,0 +1,27 @@
+---
+id: FEAT-0058
+uid: 679ef5
+type: feature
+status: closed
+stage: done
+title: Kanban 分发 - npm
+created_at: '2026-01-14T11:34:18'
+opened_at: '2026-01-14T11:34:18'
+updated_at: '2026-01-14T11:35:25'
+closed_at: '2026-01-14T11:35:25'
+parent: EPIC-0009
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## FEAT-0058: Kanban 分发 - npm
+
+## Objective
+
+## Acceptance Criteria
+
+## Technical Tasks
+
+- [ ] 

monoco_toolkit-0.1.3/Issues/Features/closed/FEAT-0063-optimize-vs-code-extension-ui.md

@@ -0,0 +1,37 @@
+---
+id: FEAT-0063
+uid: b2cc31
+type: feature
+status: closed
+stage: done
+title: Optimize VS Code Extension UI
+created_at: '2026-01-14T16:42:55'
+opened_at: '2026-01-14T16:42:55'
+updated_at: '2026-01-14T16:43:38'
+closed_at: '2026-01-14T16:43:38'
+solution: implemented
+dependencies: []
+related: []
+tags: []
+progress: 4/4
+files_count: 0
+---
+
+## FEAT-0063: Optimize VS Code Extension UI
+
+## Objective
+
+Optimize the toolkit extension UI for a better user experience, focusing on aesthetics and usability.
+
+## Acceptance Criteria
+
+1.  Toolbar icons are abstract, monoline, and theme-consistent.
+2.  "Create Issue" and "Settings" use full forms in dedicated views (cards) instead of input boxes.
+3.  Support dynamic configuration of API URLs.
+
+## Technical Tasks
+
+- [x] Replace emojis with abstract monoline SVGs in webview.
+- [x] Implement multi-view architecture (Home, Create, Settings) in `index.html` and `main.js`.
+- [x] Implement native HTML forms for Issue Creation and Settings.
+- [x] Update extension host (`extension.ts`) to support `OPEN_URL` message.

monoco_toolkit-0.1.3/Issues/Features/closed/FEAT-0064-smart-parent-selection.md

@@ -0,0 +1,27 @@
+---
+id: FEAT-0064
+uid: d856b0
+type: feature
+status: closed
+stage: done
+title: Smart Parent Selection
+created_at: '2026-01-14T16:51:26'
+opened_at: '2026-01-14T16:51:26'
+updated_at: '2026-01-14T16:51:31'
+closed_at: '2026-01-14T16:51:31'
+parent: FEAT-0063
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## FEAT-0064: Smart Parent Selection
+
+## Objective
+
+## Acceptance Criteria
+
+## Technical Tasks
+
+- [ ] 

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/Issues/Features/open/FEAT-0043-toolkit-/345/210/206/345/217/221/346/270/240/351/201/223/345/273/272/350/256/276.md

@@ -29,8 +29,8 @@ tags: []
   - [ ] `monoco serve` 成功启动并对外暴露开发者 API。
 - [ ] **Tier 2 (Package Managers)**:
   - [ ] Homebrew Formula 验证通过。
-  - [ ] NPM Shim (`npm i -g @monoco/kanban`) 发布。
-  - [ ] 用户可以通过 `npx @monoco/kanban` 快速打开本地 Kanban 界面。
+  - [ ] NPM Shim (`npm i -g @monoco-io/kanban`) 发布。
+  - [ ] 用户可以通过 `npx @monoco-io/kanban` 快速打开本地 Kanban 界面。
 - [ ] **Tier 3 (Consumer Native)**:
   - [ ] MacOS App (.dmg) 打包验证 (PyInstaller)。
   - [ ] Windows App (.exe) 打包验证 (PyInstaller)。

{monoco_toolkit-0.1.1 → monoco_toolkit-0.1.3}/Issues/Features/open/FEAT-0052-kanban-/345/210/206/345/217/221-npm-npx.md

@@ -16,11 +16,11 @@ tags: []
 
 ## Objective
 
-建立 Monoco Kanban 的 NPM 自动发布流水线，使用户能够通过 `npx @monoco/kanban` 或 `npm install -g @monoco/kanban` 一键启动看板界面。该工具应能自动发现并连接本地运行的 Monoco Toolkit 后端。
+建立 Monoco Kanban 的 NPM 自动发布流水线，使用户能够通过 `npx @monoco-io/kanban` 或 `npm install -g @monoco-io/kanban` 一键启动看板界面。该工具应能自动发现并连接本地运行的 Monoco Toolkit 后端。
 
 ## Acceptance Criteria
 
-- [ ] **npx 启动**：运行 `npx @monoco/kanban` 能够启动一个轻量级 Web 服务并自动打开浏览器。
+- [ ] **npx 启动**：运行 `npx @monoco-io/kanban` 能够启动一个轻量级 Web 服务并自动打开浏览器。
 - [ ] **静态分发**：NPM 包应包含 `webui` 的预构建静态资源，无需用户本地进行 `next build`。
 - [ ] **后端发现**：能够默认连接到 `http://localhost:3213` (Monoco 默认端口)，并支持通过参数修改。
 - [ ] **自动化发布**：Git Tag (`v*`) 触发自动发布至 NPM Registry。

monoco_toolkit-0.1.3/Issues/Features/open/FEAT-0053-kanban-ui-/351/207/215/346/236/204/344/270/216/344/276/235/350/265/226/347/216/260/344/273/243/345/214/226.md

@@ -0,0 +1,42 @@
+---
+id: FEAT-0053
+uid: e1a2b3
+type: feature
+status: in_progress
+stage: todo
+title: Kanban UI 重构与依赖现代化
+created_at: "2026-01-13T16:33:00"
+opened_at: "2026-01-13T16:33:00"
+updated_at: "2026-01-13T16:33:00"
+parent: EPIC-0003
+dependencies: []
+related: []
+tags:
+  - tech-debt
+  - ui
+---
+
+## FEAT-0053: Kanban UI 重构与依赖现代化
+
+## Objective
+
+重写 Kanban WebUI 以彻底解决 React 19、Next.js 16+ 与旧版组件库（Blueprint.js）之间的依赖冲突问题，并提升 UI 现代化程度。目前的临时方案（依赖锁定降级）不可持续，阻碍了技术栈的升级。
+
+## Acceptance Criteria
+
+- [ ] **现代化组件库**：迁移至 Shadcn/UI 或 Mantine 等现代 React 组件库，全面支持 React 19。
+- [ ] **技术栈升级**：
+  - Next.js: 升级至 `16.1.1` 或更新。
+  - React: 升级至 `19.2.x` (最新稳定版)。
+  - Node.js: 升级至 `v24` (Current/LTS Candidate)。
+- [ ] **React 19 支持**：确保所有依赖与 React 19 兼容，无 Peer Dependency 警告。
+- [ ] **ESLint 9 兼容**：升级构建和 lint 工具链至最新标准。
+- [ ] **功能对齐**：确保现有的看板、列表、详情页等功能在重构后完整保留。
+
+## Technical Tasks
+
+- [x] 评估并选型新的 UI 组件库（推荐 Shadcn/UI）。
+- [x] 初始化新的 UI 框架配置。
+- [ ] 逐步迁移 `apps/webui` 中的组件。
+- [x] 移除 `Toolkit/Kanban/package.json` 中的 `overrides` 配置。
+- [ ] 验证全链路构建通过。

monoco_toolkit-0.1.3/Issues/Features/open/FEAT-0057-kanban-terminal-ui.md

@@ -0,0 +1,73 @@
+---
+id: FEAT-0057
+type: feature
+status: open
+stage: todo
+title: Kanban Terminal Integration (xterm.js)
+created_at: '2026-01-14T00:00:00'
+updated_at: '2026-01-14T11:47:28'
+parent: EPIC-0010
+dependencies:
+- FEAT-0056
+related: []
+tags:
+- kanban
+- ui
+- pty
+- xterm
+owner: Frontend Engineer
+---
+
+# Feature: Kanban Terminal Integration
+
+## Context
+
+Backend PTY Service (`monoco pty`) has been implemented via FEAT-0056.
+Now we need to integrate the Terminal interface into the Kanban Web UI to achieve the "Cockpit" experience.
+
+## Goals
+
+1.  Integrate `xterm.js` into the Next.js application.
+2.  Implement a collapsable Bottom Panel for the terminal.
+3.  Connect to `ws://localhost:3124` to stream PTY data.
+
+## Technical Design
+
+### 1. Dependencies
+
+- `xterm`: Core terminal emulator.
+- `xterm-addon-fit`: Auto-resize support.
+- `xterm-addon-web-links`: Clickable links.
+
+### 2. Components
+
+- **`TerminalPanel`**:
+  - Position: Fixed at bottom (`z-50`).
+  - Layout: Header (Tabs + Actions) + Body (Xterm Container).
+  - State: `isOpen`, `activeSessionId`.
+
+### 3. State Management
+
+- Use `React Context` (`TerminalContext`) to manage the WebSocket connection and global visibility.
+- **Shortcuts**: Listen for `Cmd+J` locally to toggle visibility.
+
+### 4. Connection Logic
+
+- Connect to `ws://localhost:3124/ws/{session_id}`.
+- Handshake: Send initial resize event on connect.
+- Reconnect: Implement simple backoff retry strategy.
+
+## Tasks
+
+- [x] **Setup**: Install `xterm`, `xterm-addon-fit`.
+- [x] **Component**: Create `src/components/terminal/XTermView.tsx`.
+- [x] **Layout**: Create global `TerminalPanel` in `providers.tsx` or layout root.
+- [x] **Logic**: Implement WebSocket hook to pipe data to/from xterm instance.
+- [x] **Style**: Apply Monoco theme (colors, fonts) to xterm.
+
+## Acceptance Criteria
+
+- [x] Kanban 底部出现 Terminal 条。
+- [x] 点击或按快捷键可展开/折叠面板。
+- [x] 终端能成功连接后端，显示 prompt，并能执行 `ls` 命令。
+- [x] 调整浏览器窗口大小时，终端内容自适应重排 (resize)。

monoco_toolkit-0.1.3/Issues/Features/open/FEAT-0059-vscode-extension-bridge.md

@@ -0,0 +1,42 @@
+---
+id: FEAT-0059
+uid: vsc001
+type: feature
+status: open
+stage: review
+title: VS Code Extension Scaffold & Webview Bridge
+created_at: '2026-01-14T13:40:00'
+opened_at: '2026-01-14T13:40:00'
+updated_at: '2026-01-14T14:08:05'
+parent: EPIC-0011
+dependencies:
+- FEAT-0044
+related: []
+tags:
+- vscode
+- infrastructure
+---
+
+## FEAT-0059: VS Code Extension Scaffold & Webview Bridge
+
+## Objective
+
+搭建 VS Code 插件的基础脚手架，并建立 Webview 与插件进程、插件进程与 Monoco CLI 之间的双向通信桥梁。
+
+## Acceptance Criteria
+
+- [x] **插件脚手架**:
+  - [x] 初始化 VS Code Extension 项目 (TypeScript)。
+  - [x] 配置 Activity Bar 图标与 Sidebar View 容器。
+- [x] **Webview 桥接**:
+  - [x] 实现基础的 `VsCodeMessenger` 类，封装 `postMessage` 调用。
+  - [x] 在前端 Kanban 中集成消息监听器，能够响应来自插件的指令。
+- [x] **CLI 唤起**:
+  - [x] 插件能够自动探测并启动 `monoco serve`（如果尚未启动）。
+  - [x] 插件能够通过 HTTP/WebSocket 与 Monoco Daemon 交互。
+
+## Technical Tasks
+
+- [x] 创建 `extensions/vscode` 目录。
+- [x] 实现 VS Code 端的 `WebviewProvider`。
+- [x] 制定 Webview 指令集定义 (e.g., `OPEN_FILE`, `GET_CONFIG`)。

monoco_toolkit-0.1.3/Issues/Features/open/FEAT-0060-kanban-sidebar-ux.md

@@ -0,0 +1,43 @@
+---
+id: FEAT-0060
+uid: vsc002
+type: feature
+status: open
+stage: todo
+title: Kanban Sidebar UX Optimization
+created_at: "2026-01-14T13:42:00"
+opened_at: "2026-01-14T13:42:00"
+updated_at: "2026-01-14T13:42:00"
+parent: EPIC-0011
+dependencies:
+  - FEAT-0044
+  - FEAT-0059
+related: []
+tags:
+  - vscode
+  - ui
+  - ux
+---
+
+## FEAT-0060: Kanban Sidebar UX Optimization
+
+## Objective
+
+针对 VS Code 侧边栏 (Sidebar) 的狭窄宽度进行 UI/UX 专项优化，确保看板在小尺寸下依然可用且美观。
+
+## Acceptance Criteria
+
+- [ ] **自适应布局**:
+  - [ ] 实现 "Sidebar Mode" 媒体查询，在宽度极小时自动隐藏非核心列。
+  - [ ] 优化侧边栏下的导航栏（转为底部 Tab 或 汉堡菜单）。
+- [ ] **高密度视图**:
+  - [ ] Issue 列表支持“紧凑模式”。
+  - [ ] 优化字体大小与间距，确保 VS Code 风格的视觉一致性。
+- [ ] **主题同步**:
+  - [ ] 自动检测并匹配 VS Code 的当前主题颜色（背景、前景、Accent Color）。
+
+## Technical Tasks
+
+- [ ] 在 `PageHeader` 中集成侧边栏探测逻辑。
+- [ ] 为 `IssueCard` 增加 `compact` 变体。
+- [ ] 编写 CSS 变量映射层，对接 VS Code 的 `--vscode-*` CSS 变量。