monoco-toolkit 0.2.2__tar.gz → 0.2.6__tar.gz

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/.github/workflows/ci.yml

@@ -2,9 +2,14 @@ name: CI
 
 on:
   push:
-    branches: ["main"]
+    tags: ["v*"]
   pull_request:
     branches: ["main"]
+    paths-ignore:
+      - "**.md"
+      - "docs/**"
+      - "mkdocs.yml"
+      - "Kanban/docs/**"
 
 jobs:
   build-and-test:
@@ -29,8 +34,5 @@ jobs:
       - name: Install Python Dependencies
         run: uv sync --all-extras --dev
 
-      - name: Run Issue Lint
-        run: uv run monoco issue lint --recursive
-
       - name: Run Python Tests
         run: uv run pytest

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/.github/workflows/publish-pypi.yml

@@ -33,9 +33,6 @@ jobs:
       - name: Run Tests
         run: uv run pytest
 
-      - name: Lint Issues
-        run: uv run monoco issue lint --recursive
-
       - name: Build distribution
         run: uv build
 

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

@@ -0,0 +1,130 @@
+name: Publish Toolkit VS Code Extension
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build-and-package:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: linux-x64
+            binary_name: monoco
+          - os: macos-latest
+            target: darwin-arm64
+            binary_name: monoco
+          - os: macos-13
+            target: darwin-x64
+            binary_name: monoco
+          - os: windows-latest
+            target: win32-x64
+            binary_name: monoco.exe
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      # ----------------------------------------------------
+      # Python / Binary Build Setup
+      # ----------------------------------------------------
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Python Dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Build CLI Binary
+        run: |
+          uv run --with pyinstaller pyinstaller \
+            --name monoco \
+            --onefile \
+            --clean \
+            --distpath ./dist \
+            --workpath ./build \
+            --specpath ./build \
+            monoco/main.py
+        shell: bash
+
+      - name: Prepare Binary
+        run: |
+          mkdir -p extensions/vscode/bin
+          cp dist/${{ matrix.binary_name }} extensions/vscode/bin/
+        shell: bash
+
+      # ----------------------------------------------------
+      # Node.js / VS Code Extension Package
+      # ----------------------------------------------------
+      - 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
+        working-directory: extensions/vscode
+
+      - name: Install Server Dependencies
+        run: cd server && npm ci
+        working-directory: extensions/vscode
+
+      - name: Compile
+        run: npm run compile
+        working-directory: extensions/vscode
+
+      - name: Lint
+        run: npm run lint
+        working-directory: extensions/vscode
+
+      - name: Prune Server Development Dependencies
+        run: cd server && npm prune --production
+        working-directory: extensions/vscode
+
+      - name: Package Extension
+        run: npx @vscode/vsce package --target ${{ matrix.target }}
+        working-directory: extensions/vscode
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: vsix-${{ matrix.target }}
+          path: extensions/vscode/*.vsix
+          if-no-files-found: error
+
+  publish:
+    name: Publish to Open VSX
+    needs: build-and-package
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          pattern: vsix-*
+          merge-multiple: true
+
+      - name: Create Open VSX Namespace
+        env:
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}
+        run: npx ovsx create-namespace indenscale --pat ${{ secrets.OVSX_PAT }} || echo "Namespace might already exist"
+
+      - name: Publish to Open VSX
+        env:
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}
+        run: npx ovsx publish artifacts/*.vsix --pat ${{ secrets.OVSX_PAT }}

monoco_toolkit-0.2.6/.monoco/actions/critique.prompty

@@ -0,0 +1,16 @@
+---
+name: critique
+description: Critique the code or design against requirements.
+provider: chat
+---
+You are a Principal Code Reviewer.
+Your task is to critique the following implementation/design:
+
+{{file}}
+
+# Instructions
+1. **Gap Analysis**: Check if all Acceptance Criteria are met.
+2. **Code Quality**: Identify potential bugs, security issues, or performance bottlenecks.
+3. **Design Patterns**: Suggest better patterns if applicable.
+
+Output a structured review.

monoco_toolkit-0.2.6/.monoco/actions/develop.prompty

@@ -0,0 +1,16 @@
+---
+name: develop
+description: 执行核心开发任务：编码与单元测试。
+provider: chat
+---
+You are a Principal Software Engineer.
+Your task is to implement the feature described in this Issue:
+
+{{file}}
+
+# Instructions
+1.  **Implementation**: Write the code required to satisfy the Acceptance Criteria.
+2.  **Unit Tests**: Add or update unit tests to verify your changes.
+3.  **Linting**: Ensure code follows project style guidelines.
+
+Please provide the code changes.

monoco_toolkit-0.2.6/.monoco/actions/investigate.prompty

@@ -0,0 +1,16 @@
+---
+name: investigate
+description: 扫描 Codebase，识别架构设计、业务约束，丰富 Issue 引用网络。
+provider: chat
+---
+You are a Senior Software Architect.
+Your task is to investigate the feasibility and impact of the following Issue:
+
+{{file}}
+
+# Instructions
+1.  **Architecture Scan**: Identify which modules/files need to be modified.
+2.  **Dependency Analysis**: Suggest `parent`, `dependencies`, and `related` issues.
+3.  **Constraint Check**: Identify any business rules or technical constraints (e.g., Billing module impact).
+
+Output your findings as a comment or update the Issue description directly.

monoco_toolkit-0.2.6/.monoco/actions/refine.prompty

@@ -0,0 +1,14 @@
+---
+name: refine
+description: 细化需求，将 Draft 转化为可执行的 Plan。
+provider: chat
+---
+You are a Product Owner / Systems Analyst.
+Refine the following Draft Issue into a concrete Technical Plan:
+
+{{file}}
+
+# Instructions
+1.  **Clarify Objective**: Ensure the goal is specific and standard.
+2.  **Expand Criteria**: Add detailed Acceptance Criteria.
+3.  **Breakdown Tasks**: List concrete Technical Tasks.

monoco_toolkit-0.2.6/.monoco/actions/verify.prompty

@@ -0,0 +1,16 @@
+---
+name: verify
+description: 代为检查工单完整性、代码质量与逻辑一致性。
+provider: chat
+---
+You are a QA Lead / Release Manager.
+Your task is to verify if the following Issue is ready for delivery:
+
+{{file}}
+
+# Instructions
+1.  **Definition of Done**: Check if all Technical Tasks are checked and Acceptance Criteria met.
+2.  **Quality Check**: Review the code changes (if provided in context) for bugs or antipatterns.
+3.  **Completeness**: Ensure documentation and tests are present.
+
+Output "PASS" if ready, or a list of "BLOCKERS" if not.

monoco_toolkit-0.2.2/.monoco/config.yaml → monoco_toolkit-0.2.6/.monoco/project.yaml

@@ -1,17 +1,12 @@
-i18n:
-  source_lang: zh
-  target_langs:
-  - en
+agent:
+  providers:
+    research: gemini
 project:
   key: TOO
-  members:
-    MON: ..
   name: Monoco Toolkit
   spike_repos:
-    vibe-kanban: https://github.com/BloopAI/vibe-kanban
+    agentskills: https://github.com/agentskills/agentskills
     gemini-cli: https://github.com/google-gemini/gemini-cli
     qwen-code: https://github.com/QwenLM/qwen-code
     skills: https://github.com/anthropics/skills
-    agentskills: https://github.com/agentskills/agentskills
-telemetry:
-  enabled: null
+    vibe-kanban: https://github.com/BloopAI/vibe-kanban

monoco_toolkit-0.2.6/.monoco/state.json

@@ -0,0 +1,3 @@
+{
+  "last_active_project_id": "Toolkit"
+}

monoco_toolkit-0.2.6/.monoco/workspace.yaml

@@ -0,0 +1,190 @@
+i18n:
+  source_lang: zh
+  target_langs:
+    - en
+telemetry:
+  enabled: null
+
+issue:
+  types:
+    - name: epic
+      label: Epic
+      prefix: EPIC
+      folder: Epics
+      description: Large strategic initiative
+    - name: feature
+      label: Feature
+      prefix: FEAT
+      folder: Features
+      description: Value delivery atom
+    - name: chore
+      label: Chore
+      prefix: CHORE
+      folder: Chores
+      description: Engineering maintenance task
+    - name: fix
+      label: Bug Fix
+      prefix: FIX
+      folder: Fixes
+      description: Defect resolution
+    - name: story
+      label: User Story
+      prefix: STORY
+      folder: Stories
+      description: User-centric requirement
+    - name: arch
+      label: Architecture Decision
+      prefix: ARCH
+      folder: Arch
+      description: Architecture Decision Record (ADR)
+
+  statuses:
+    - open
+    - closed
+    - backlog
+
+  stages:
+    - draft
+    - doing
+    - review
+    - done
+    - freezed
+
+  solutions:
+    - implemented
+    - cancelled
+    - wontfix
+    - duplicate
+
+  workflows:
+    # --- Universal Agent Actions ---
+    - name: investigate
+      label: Investigate
+      icon: "$(telescope)"
+      to_status: open
+      command_template: "monoco agent run investigate"
+      description: "Run agent investigation"
+
+    # --- Open -> Open (Stage Transitions) ---
+    - name: start
+      label: Start
+      icon: "$(play)"
+      from_status: open
+      from_stage: draft
+      to_status: open
+      to_stage: doing
+      command_template: "monoco issue start {id}"
+      description: "Start working on the issue"
+
+    - name: develop
+      label: Develop
+      icon: "$(tools)"
+      from_status: open
+      from_stage: doing
+      to_status: open
+      to_stage: doing
+      command_template: "monoco agent run develop"
+      description: "Run agent development"
+
+    - name: stop
+      label: Stop
+      icon: "$(stop)"
+      from_status: open
+      from_stage: doing
+      to_status: open
+      to_stage: draft
+      command_template: "monoco issue stop {id}"
+      description: "Stop working and return to draft"
+
+    - name: submit
+      label: Submit
+      icon: "$(check)"
+      from_status: open
+      from_stage: doing
+      to_status: open
+      to_stage: review
+      command_template: "monoco issue submit {id}"
+      description: "Submit for review"
+
+    - name: reject
+      label: Reject
+      icon: "$(error)"
+      from_status: open
+      from_stage: review
+      to_status: open
+      to_stage: doing
+      command_template: "monoco issue update {id} --stage doing"
+      description: "Reject review and return to doing"
+
+    # --- Open -> Closed Transitions ---
+    - name: accept
+      label: Accept
+      icon: "$(pass-filled)"
+      from_status: open
+      from_stage: review
+      to_status: closed
+      to_stage: done
+      required_solution: implemented
+      command_template: "monoco issue close {id} --solution implemented"
+      description: "Accept and close issue"
+
+    - name: close_done
+      label: Close
+      icon: "$(close)"
+      from_status: open
+      from_stage: done
+      to_status: closed
+      to_stage: done
+      required_solution: implemented
+      command_template: "monoco issue close {id} --solution implemented"
+      description: "Close completed issue"
+
+    - name: cancel
+      label: Cancel
+      icon: "$(trash)"
+      from_status: open
+      to_status: closed
+      to_stage: done
+      required_solution: cancelled
+      command_template: "monoco issue cancel {id}"
+      description: "Cancel the issue"
+
+    - name: wontfix
+      label: Won't Fix
+      icon: "$(circle-slash)"
+      from_status: open
+      to_status: closed
+      to_stage: done
+      required_solution: wontfix
+      command_template: "monoco issue close {id} --solution wontfix"
+      description: "Mark as won't fix"
+
+    # --- Backlog Transitions ---
+    - name: pull
+      label: Pull
+      icon: "$(arrow-up)"
+      from_status: backlog
+      to_status: open
+      to_stage: draft
+      command_template: "monoco issue backlog pull {id}"
+      description: "Restore issue from backlog"
+
+    - name: cancel_backlog
+      label: Cancel
+      icon: "$(trash)"
+      from_status: backlog
+      to_status: closed
+      to_stage: done
+      required_solution: cancelled
+      command_template: "monoco issue cancel {id}"
+      description: "Cancel backlog issue"
+
+    # --- Closed Transitions ---
+    - name: reopen
+      label: Reopen
+      icon: "$(refresh)"
+      from_status: closed
+      to_status: open
+      to_stage: draft
+      command_template: "monoco issue open {id}"
+      description: "Reopen a closed issue"

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/AGENTS.md

@@ -2,6 +2,14 @@
 
 > **Auto-Generated**: This section is managed by Monoco. Do not edit manually.
 
+### Design Philosophy
+
+Monoco CLI is designed as an **Agent-Native Interface**.
+
+- **Strictly Non-Interactive**: Commands MUST NOT prompt for user input. If arguments are missing, the command MUST fail immediately. This ensures deterministic behavior for Agents.
+- **Text as Interface**: We prefer structured text (Markdown/YAML) over complex UI states.
+- **Explicit Context**: Agents must provide full context (e.g., explicit paths) to avoid ambiguity.
+
 ### Issue Management
 
 System for managing tasks using `monoco issue`.

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to Monoco Toolkit will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.6] - 2026-01-18
+
+### 🔧 Improvements
+
+- Updated Agent Settings UI with better organization and section headers
+- Improved Agent inheritance logic (Inherit from Default)
+- Fixed Webview initialization and local storage data migration
+- Enhanced Issue Validator with stricter "Technical Tasks" requirements
+- Synced all components (CLI, VS Code Extension, Kanban) to v0.2.6
+
 ## [0.2.0] - 2026-01-16
 
 ### 🎯 Major Features

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/CLAUDE.md

@@ -2,6 +2,21 @@
 
 > **Auto-Generated**: This section is managed by Monoco. Do not edit manually.
 
+### Design Philosophy
+### 设计哲学
+
+Monoco CLI is designed as an **Agent-Native Interface**.
+Monoco CLI 被设计为 **Agent 原生接口**。
+
+- **Strictly Non-Interactive**: Commands MUST NOT prompt for user input. If arguments are missing, the command MUST fail immediately.
+- **严格非交互**: 命令绝不允许提示用户输入。如果参数缺失，命令必须立即失败。这确保了 Agent 行为的确定性。
+
+- **Text as Interface**: We prefer structured text (Markdown/YAML) over complex UI states.
+- **文本即接口**: 我们倾向于结构化文本 (Markdown/YAML) 而非复杂的 UI 状态。
+
+- **Explicit Context**: Agents must provide full context (e.g., explicit paths) to avoid ambiguity.
+- **显式上下文**: Agent 必须提供完整上下文（如显式路径）以避免歧义。
+
 ### Issue Management
 
 ### Issue 管理

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/GEMINI.md

@@ -2,6 +2,21 @@
 
 > **Auto-Generated**: This section is managed by Monoco. Do not edit manually.
 
+### Design Philosophy
+### 设计哲学
+
+Monoco CLI is designed as an **Agent-Native Interface**.
+Monoco CLI 被设计为 **Agent 原生接口**。
+
+- **Strictly Non-Interactive**: Commands MUST NOT prompt for user input. If arguments are missing, the command MUST fail immediately.
+- **严格非交互**: 命令绝不允许提示用户输入。如果参数缺失，命令必须立即失败。这确保了 Agent 行为的确定性。
+
+- **Text as Interface**: We prefer structured text (Markdown/YAML) over complex UI states.
+- **文本即接口**: 我们倾向于结构化文本 (Markdown/YAML) 而非复杂的 UI 状态。
+
+- **Explicit Context**: Agents must provide full context (e.g., explicit paths) to avoid ambiguity.
+- **显式上下文**: Agent 必须提供完整上下文（如显式路径）以避免歧义。
+
 ### Issue Management
 
 ### Issue 管理

{monoco_toolkit-0.2.2 → monoco_toolkit-0.2.6}/Issues/Chores/closed/CHORE-0001-/346/233/264/346/226/260Issue/346/226/207/346/241/243/345/222/214I18n.md

@@ -5,7 +5,7 @@ status: closed
 stage: done
 title: 更新 Issue 管理文档并扫描 i18n (Update Issue Docs)
 created_at: '2026-01-10T20:55:18.498670'
-opened_at: '2026-01-10T20:55:18.498656'
+opened_at: '2026-01-10T20:55:18.498670'
 updated_at: '2026-01-10T20:56:33.172498'
 closed_at: '2026-01-10T20:56:33.172533'
 solution: implemented
@@ -16,7 +16,7 @@ parent: EPIC-0001
 uid: a6fb7c
 ---
 
-## CHORE-0001: 更新 Issue 管理文档并扫描 i18n
+## CHORE-0001: 更新 Issue 管理文档并扫描 i18n (Update Issue Docs)
 
 ## 目标 (Objective)
 
@@ -30,4 +30,8 @@ uid: a6fb7c
 ## 技术任务 (Technical Tasks)
 
 - [x] 运行 `monoco i18n scan`。
-- [x] 更新 `docs/` 中的 `.md` 文件。
+- [x] 更新 `docs/` 中的 `.md` 文件。
+
+## Review Comments
+
+- [x] Self-Review

monoco_toolkit-0.2.6/Issues/Chores/closed/CHORE-0003-refactor-config-loading-for-unified-context.md

@@ -0,0 +1,56 @@
+---
+id: CHORE-0003
+uid: ee962c
+type: chore
+status: closed
+stage: done
+title: 重构配置加载以统一上下文
+created_at: '2026-01-15T12:55:25'
+opened_at: '2026-01-15T12:55:25'
+updated_at: '2026-01-15T13:06:28'
+closed_at: '2026-01-15T13:06:28'
+solution: implemented
+dependencies: []
+related: []
+tags: []
+---
+
+## CHORE-0003: 重构配置加载以统一上下文
+
+## 上下文
+
+目前，系统同时支持 `monoco.yaml`（在文件根目录）和 `.monoco/config.yaml`。
+这种双重支持造成了歧义和维护开销。
+**决定**：我们将标准化使用 **`.monoco/` 目录** 作为 Monoco 上下文的唯一标识符。
+
+## 目标
+
+从代码库中移除对 `monoco.yaml` 的所有依赖。
+配置必须驻留在 `.monoco/config.yaml` 中。
+
+## 父级
+
+EPIC-0013
+
+## 技术任务
+
+- [x] **更新配置加载器**：修改 `monoco.core.config.py` 以停止查找 `monoco.yaml`。
+- [x] **更新工作区扫描器**：修改 `monoco.core.workspace.py`（以及任何 `ProjectManager` 逻辑）仅通过 `.monoco/` 目录的存在来识别项目。
+- [x] **迁移工具（可选）**：添加逻辑片段，如果找到 `monoco.yaml` 则警告用户并建议移动它。
+
+## 验收标准
+
+- [x] `monoco.core.config.get_config` 被标记为旧版/已弃用或严格限制在当前工作目录范围内。
+- [x] `ProjectManager` 可以加载项目 A 和项目 B，且 `ProjectContext(A).config` 与 `ProjectContext(B).config` 不同。
+- [x] `monoco serve` 正确启动。
+
+## 解决方案
+
+重构了配置加载以标准化为 `.monoco/config.yaml`。移除了对 `monoco.yaml` 的所有依赖。
+将存储库中现有的 `monoco.yaml` 文件迁移到其各自的 `.monoco/` 目录中。
+在 `monoco.core.config.py` 中为仍在使用 `monoco.yaml` 的用户添加了旧版警告。
+更新了 `core.workspace.is_project_root` 以仅通过 `.monoco/` 目录的存在来识别项目。
+
+## Review Comments
+
+- [x] Self review