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

monoco_toolkit-0.1.1/.github/workflows/publish-npm.yml

@@ -0,0 +1,44 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish-kanban:
+    name: Publish Kanban to NPM
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        run: |
+          cd Toolkit/Kanban
+          npm install
+
+      - name: Build WebUI
+        run: |
+          cd Toolkit/Kanban
+          npm run build --workspace=@monoco/kanban-webui
+
+      - 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/
+          # 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
+
+      - name: Publish to NPM
+        run: |
+          cd Toolkit/Kanban/packages/monoco-kanban
+          npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

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

@@ -3,14 +3,16 @@ id: EPIC-0009
 uid: baa5a5
 type: epic
 status: open
-stage: todo
+stage: doing
 title: CICD 基建
-created_at: "2026-01-13T13:21:48"
-opened_at: "2026-01-13T13:21:48"
-updated_at: "2026-01-13T13:21:48"
+created_at: '2026-01-13T13:21:48'
+opened_at: '2026-01-13T13:21:48'
+updated_at: '2026-01-13T13:21:48'
 dependencies: []
 related: []
 tags: []
+progress: 1/1
+files_count: 0
 ---
 
 ## EPIC-0009: CICD 基建

{monoco_toolkit-0.1.0/Issues/Features/open → monoco_toolkit-0.1.1/Issues/Features/closed}/FEAT-0051-cli-/345/267/245/345/205/267/345/210/206/345/217/221-pypi.md

@@ -2,13 +2,15 @@
 id: FEAT-0051
 uid: 40a9be
 type: feature
-status: open
-stage: todo
+status: closed
+stage: done
 title: CLI 工具分发 - PyPI
-created_at: "2026-01-13T13:58:29"
-opened_at: "2026-01-13T13:58:29"
-updated_at: "2026-01-13T13:58:29"
+created_at: '2026-01-13T13:58:29'
+opened_at: '2026-01-13T14:43:49'
+updated_at: '2026-01-13T14:43:55'
+closed_at: '2026-01-13T14:43:55'
 parent: EPIC-0009
+solution: implemented
 dependencies: []
 related: []
 tags: []
@@ -26,13 +28,14 @@ tags: []
 - [x] **质量保障**：发布前自动执行测试套件与 Issue Lint 校验。
 - [x] **元数据完整**：PyPI 页面展示完整的项目信息（描述、关键词、许可证、链接）。
 - [x] **Trusted Publishing**：使用 GitHub OIDC 认证，无需手动管理 API Token。
-- [ ] **版本一致性**：Git Tag 版本与 `pyproject.toml` 版本保持同步。（需首次发布验证）
+- [x] **版本一致性**：Git Tag 版本与 `pyproject.toml` 版本保持同步。（已通过 v0.1.0 验证）
 
 ## Technical Tasks
 
 - [x] 创建 `.github/workflows/publish-pypi.yml` 工作流。
 - [x] 完善 `pyproject.toml` 元数据（许可证、分类器、项目链接）。
-- [ ] 在 PyPI 配置 Trusted Publishing (需要项目管理员权限)。
-- [ ] 验证发布流程：创建测试 Tag 并观察 CI 执行。
+- [x] **创建 GitHub 仓库并完成初始推送** (`IndenScale/monoco-toolkit`)。
+- [x] 在 PyPI 配置 Trusted Publishing (需要项目管理员登录 PyPI 官网操作)。
+- [x] 验证发布流程：创建 v0.1.0 Tag 并观察 CI 执行。
 - [x] 更新 `README.md` 添加安装说明 (`pip install monoco-toolkit`)。
 - [x] 文档化发布流程 (CONTRIBUTING.md 或 docs/)。

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

@@ -0,0 +1,36 @@
+---
+id: FEAT-0052
+uid: af6399
+type: feature
+status: open
+stage: in_progress
+title: Kanban 分发 - NPM/NPX
+created_at: "2026-01-13T14:49:04"
+opened_at: "2026-01-13T14:49:04"
+updated_at: "2026-01-13T14:55:00"
+parent: EPIC-0009
+dependencies: []
+related: []
+tags: []
+---
+
+## Objective
+
+建立 Monoco Kanban 的 NPM 自动发布流水线，使用户能够通过 `npx @monoco/kanban` 或 `npm install -g @monoco/kanban` 一键启动看板界面。该工具应能自动发现并连接本地运行的 Monoco Toolkit 后端。
+
+## Acceptance Criteria
+
+- [ ] **npx 启动**：运行 `npx @monoco/kanban` 能够启动一个轻量级 Web 服务并自动打开浏览器。
+- [ ] **静态分发**：NPM 包应包含 `webui` 的预构建静态资源，无需用户本地进行 `next build`。
+- [ ] **后端发现**：能够默认连接到 `http://localhost:3213` (Monoco 默认端口)，并支持通过参数修改。
+- [ ] **自动化发布**：Git Tag (`v*`) 触发自动发布至 NPM Registry。
+- [ ] **版本同步**：NPM 包版本与 Python Toolkit 版本保持一致。
+
+## Technical Tasks
+
+- [x] 创建 `Toolkit/Kanban/packages/monoco-kanban` 专用分发包。
+- [x] 配置 `webui` 支持静态导出 (`output: 'export'`)。
+- [x] 编写轻量级 CLI 启动器 (使用 `sirv` 或 `express` 配合 `open`)。
+- [x] 创建 `.github/workflows/publish-npm.yml` 工作流并配置 NPM_TOKEN。
+- [x] 更新主项目文档，增加 `npx` 使用说明。
+- [ ] 验证发布流程：创建 v0.1.0-npm 测试版本。

{monoco_toolkit-0.1.0 → monoco_toolkit-0.1.1}/Kanban/apps/webui/next.config.js

@@ -2,6 +2,7 @@ const path = require("path");
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  output: "export",
   transpilePackages: ["@monoco/kanban-core"],
   outputFileTracingRoot: path.join(__dirname, "../../../"),
   experimental: {

monoco_toolkit-0.1.1/Kanban/packages/monoco-kanban/bin/monoco-kanban.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+const { program } = require("commander");
+const open = require("open");
+const path = require("path");
+const polka = require("polka");
+const sirv = require("sirv");
+
+program
+  .name("monoco-kanban")
+  .description("Launch the Monoco Kanban Board")
+  .version("0.1.0")
+  .option("-p, --port <number>", "port to run the board on", "3123")
+  .option("-h, --host <string>", "host to run the board on", "127.0.0.1")
+  .option("--no-open", "do not open the browser automatically")
+  .action(async (options) => {
+    const distPath = path.resolve(__dirname, "../dist");
+    const port = parseInt(options.port, 10);
+    const host = options.host;
+    const url = `http://${host}:${port}`;
+
+    console.log(`\n🚀 Monoco Kanban Board`);
+    console.log(`------------------------`);
+    console.log(`Serving from: ${distPath}`);
+    console.log(`URL: ${url}\n`);
+
+    const assets = sirv(distPath, {
+      single: true,
+      dev: false,
+    });
+
+    polka()
+      .use(assets)
+      .listen(port, host, (err) => {
+        if (err) {
+          console.error(`❌ Failed to start server: ${err.message}`);
+          process.exit(1);
+        }
+
+        if (options.open) {
+          console.log(`Opening browser...`);
+          open(url);
+        }
+
+        console.log(`Press Ctrl+C to stop.\n`);
+      });
+  });
+
+program.parse();

monoco_toolkit-0.1.1/Kanban/packages/monoco-kanban/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@monoco/kanban",
+  "version": "0.1.0",
+  "description": "Monoco Kanban Board CLI - Agent Native Mission Dashboard",
+  "bin": {
+    "monoco-kanban": "./bin/monoco-kanban.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "author": "Monoco Team",
+  "license": "MIT",
+  "dependencies": {
+    "sirv": "^3.0.0",
+    "polka": "^0.5.2",
+    "open": "^10.1.0",
+    "commander": "^12.0.0"
+  }
+}

{monoco_toolkit-0.1.0 → monoco_toolkit-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: monoco-toolkit
-Version: 0.1.0
+Version: 0.1.1
 Summary: Agent Native Toolkit for Monoco - Task Management & Kanban for AI Agents
 Project-URL: Homepage, https://monoco.io
 Project-URL: Repository, https://github.com/IndenScale/Monoco
@@ -74,12 +74,19 @@ monoco init
 
 ### 3. Take Control
 
+Start the backend control hub:
+
 ```bash
-# Start the control hub
 monoco serve
 ```
 
-Visit `http://localhost:3213` to enter your cockpit.
+Then, launch the visual mission dashboard from anywhere:
+
+```bash
+npx @monoco/kanban
+```
+
+Visit `http://localhost:3123` (or the URL displayed in your terminal) to enter your cockpit.
 
 ---
 

{monoco_toolkit-0.1.0 → monoco_toolkit-0.1.1}/README.md

@@ -39,12 +39,19 @@ monoco init
 
 ### 3. Take Control
 
+Start the backend control hub:
+
 ```bash
-# Start the control hub
 monoco serve
 ```
 
-Visit `http://localhost:3213` to enter your cockpit.
+Then, launch the visual mission dashboard from anywhere:
+
+```bash
+npx @monoco/kanban
+```
+
+Visit `http://localhost:3123` (or the URL displayed in your terminal) to enter your cockpit.
 
 ---
 

{monoco_toolkit-0.1.0 → monoco_toolkit-0.1.1}/README_ZH.md

@@ -39,12 +39,19 @@ monoco init
 
 ### 3. 掌握全局实况
 
+启动后台控制中枢：
+
 ```bash
-# 启动控制中枢
 monoco serve
 ```
 
-访问 `http://localhost:3213` 即可进入你的驾驶舱。
+在任意位置启动可视化看板控制台：
+
+```bash
+npx @monoco/kanban
+```
+
+访问 `http://localhost:3123`（或终端显示的地址）即可进入你的驾驶舱。
 
 ---
 

{monoco_toolkit-0.1.0 → monoco_toolkit-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "monoco-toolkit"
-version = "0.1.0"
+version = "0.1.1"
 description = "Agent Native Toolkit for Monoco - Task Management & Kanban for AI Agents"
 readme = "README.md"
 requires-python = ">=3.10"