monoco-toolkit 0.1.2__tar.gz → 0.1.4__tar.gz

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

@@ -0,0 +1,64 @@
+name: Publish Toolkit VS Code Extension
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+  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/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/v')
+        env:
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}
+        run: npx ovsx publish ./*.vsix --pat ${{ secrets.OVSX_PAT }}

monoco_toolkit-0.1.4/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.4/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.4/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.4/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.4/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 变量。

monoco_toolkit-0.1.4/Issues/Features/open/FEAT-0061-interactive-goto-definition.md

@@ -0,0 +1,39 @@
+---
+id: FEAT-0061
+uid: vsc003
+type: feature
+status: open
+stage: todo
+title: Interactive Context Actions (Go-to & File Linking)
+created_at: "2026-01-14T14:05:00"
+opened_at: "2026-01-14T14:05:00"
+updated_at: "2026-01-14T14:05:00"
+parent: EPIC-0011
+dependencies:
+  - FEAT-0059
+related: []
+tags:
+  - vscode
+  - interaction
+---
+
+## FEAT-0061: Interactive Context Actions (Go-to & File Linking)
+
+## Objective
+
+实现看板 Webview 与 VS Code 编辑器之间的深度联动，允许用户在看板中点击文件路径直接跳转到编辑器对应位置。
+
+## Acceptance Criteria
+
+- [ ] **双向通信协议**:
+  - [ ] 定义 `OPEN_FILE` 消息格式，包含 `path`, `line`, `column`。
+- [ ] **VS Code 侧响应**:
+  - [ ] 插件进程接收消息后，使用 `vscode.window.showTextDocument` 打开文件并定位光标。
+- [ ] **Kanban 侧交互**:
+  - [ ] 在 Issue 详情页及活动流中，检测符合 `/path/to/file:line` 格式的文本并渲染为可点击链接。
+  - [ ] 实现点击后的消息发送逻辑。
+
+## Technical Tasks
+
+- [ ] 实现 VS Code 端的 `FileOpener` 服务。
+- [ ] 在 `Toolkit/Kanban` 中增加路径解析 Common Component。

monoco_toolkit-0.1.4/Issues/Features/open/FEAT-0062-drag-and-drop-text.md

@@ -0,0 +1,40 @@
+---
+id: FEAT-0062
+uid: vsc004
+type: feature
+status: open
+stage: todo
+title: Drag-and-Drop Workflow via Text/URL
+created_at: "2026-01-14T14:07:00"
+opened_at: "2026-01-14T14:07:00"
+updated_at: "2026-01-14T14:07:00"
+parent: EPIC-0011
+dependencies:
+  - FEAT-0059
+related: []
+tags:
+  - vscode
+  - interaction
+  - ux
+---
+
+## FEAT-0062: Drag-and-Drop Workflow via Text/URL
+
+## Objective
+
+实现物理感十足的拖拽交互。用户可以将 Issue 卡片直接拖入终端或 Agent Bar，本质上是填充该 Issue 的标识符（URL 或 ID）。
+
+## Acceptance Criteria
+
+- [ ] **看板拖拽导出**:
+  - [ ] 为 Issue 卡片配置 HTML5 Drag & Drop。
+  - [ ] `dataTransfer` 设置为 Issue 的引用（如 `Issues/Features/open/FEAT-xxxx.md` 或自定义 URL）。
+- [ ] **终端集成**:
+  - [ ] 验证拖拽到原生终端时的粘贴行为（通常 VS Code 终端会自动粘贴 `text/plain` 内容）。
+- [ ] **Agent Bar 适配**:
+  - [ ] Agent Bar 的输入框应支持 `drop` 事件，自动填充拖入的 Issue 引用。
+
+## Technical Tasks
+
+- [ ] 在 Kanban 中实现 `DraggableIssue` 包装器。
+- [ ] 确定拖拽内容的标准格式，确保 Agent 指令能够无缝解析。

monoco_toolkit-0.1.4/Issues/Fixes/closed/FIX-0006-polish-icons-and-layout.md

@@ -0,0 +1,27 @@
+---
+id: FIX-0006
+uid: a7357f
+type: fix
+status: closed
+stage: done
+title: Polish Icons and Layout
+created_at: '2026-01-14T16:47:25'
+opened_at: '2026-01-14T16:47:25'
+updated_at: '2026-01-14T16:47:34'
+closed_at: '2026-01-14T16:47:34'
+parent: FEAT-0063
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## FIX-0006: Polish Icons and Layout
+
+## Objective
+
+## Acceptance Criteria
+
+## Technical Tasks
+
+- [ ] 

monoco_toolkit-0.1.4/Issues/Fixes/closed/FIX-0007-fix-add-button-event-propagation.md

@@ -0,0 +1,27 @@
+---
+id: FIX-0007
+uid: 6c4546
+type: fix
+status: closed
+stage: done
+title: Fix Add Button Event Propagation
+created_at: '2026-01-14T16:53:55'
+opened_at: '2026-01-14T16:53:55'
+updated_at: '2026-01-14T16:54:00'
+closed_at: '2026-01-14T16:54:00'
+parent: FEAT-0063
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## FIX-0007: Fix Add Button Event Propagation
+
+## Objective
+
+## Acceptance Criteria
+
+## Technical Tasks
+
+- [ ] 

monoco_toolkit-0.1.4/Issues/Fixes/closed/FIX-0008-enable-issue-creation-for-orphans.md

@@ -0,0 +1,27 @@
+---
+id: FIX-0008
+uid: afa8e7
+type: fix
+status: closed
+stage: done
+title: Enable Issue Creation for Orphans
+created_at: '2026-01-14T16:57:42'
+opened_at: '2026-01-14T16:57:42'
+updated_at: '2026-01-14T16:57:47'
+closed_at: '2026-01-14T16:57:47'
+parent: FEAT-0063
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## FIX-0008: Enable Issue Creation for Orphans
+
+## Objective
+
+## Acceptance Criteria
+
+## Technical Tasks
+
+- [ ] 

{monoco_toolkit-0.1.2 → monoco_toolkit-0.1.4}/Kanban/apps/webui/next.config.js

@@ -11,6 +11,9 @@ const nextConfig = {
     appIsrStatus: false,
     buildActivity: false,
   },
+  images: {
+    unoptimized: true,
+  },
 };
 
 module.exports = nextConfig;