monoco-toolkit 0.3.0__tar.gz → 0.3.2__tar.gz

monoco_toolkit-0.3.2/.github/workflows/deploy-vitepress.yml

@@ -0,0 +1,70 @@
+name: Deploy VitePress to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "site/**"
+      - ".github/workflows/deploy-vitepress.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "site/**"
+      - ".github/workflows/deploy-vitepress.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: npm
+          cache-dependency-path: site/package-lock.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Install dependencies
+        run: |
+          cd site
+          npm ci
+
+      - name: Build VitePress site
+        run: |
+          cd site
+          npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/.vitepress/dist
+
+  deploy:
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{monoco_toolkit-0.3.0 → monoco_toolkit-0.3.2}/.gitignore

@@ -43,6 +43,7 @@ yarn-error.log*
 .next/
 out/
 build/
+**/.vitepress/cache/
 
 # Project Specific
 MemoryDaemon/

{monoco_toolkit-0.3.0 → monoco_toolkit-0.3.2}/.pre-commit-config.yaml

@@ -6,6 +6,8 @@ repos:
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
+      - id: no-commit-to-branch
+        args: [--branch, main, --branch, master]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.1.13
@@ -51,3 +53,19 @@ repos:
         stages: [pre-push]
         files: ^extensions/vscode/
         pass_filenames: false
+
+      - id: vitepress-build
+        name: VitePress Site Build
+        entry: bash -c "cd site && npm run build"
+        language: system
+        stages: [pre-push]
+        files: ^site/
+        pass_filenames: false
+
+      - id: verify-versions
+        name: Verify Version Consistency
+        entry: python scripts/verify_versions.py
+        language: system
+        stages: [pre-push]
+        pass_filenames: false
+        always_run: true

{monoco_toolkit-0.3.0 → monoco_toolkit-0.3.2}/AGENTS.md

@@ -41,3 +41,11 @@ Manage internationalization.
 - **Structure**:
   - Root files: `FILE_ZH.md`
   - Subdirs: `folder/zh/file.md`
+
+### Release Management
+
+Manage release lifecycle and versioning.
+
+- **Protocol**: Releases must be pushed from a dedicated branch `release/vX.Y.Z` matching the version in `pyproject.toml`.
+- **Set Version**: `python Toolkit/scripts/set_version.py <version>` (Update version in all manifests)
+- **Release Check**: `Toolkit/scripts/run_release_checks.sh <version>` (Run full validation suite)

monoco_toolkit-0.3.2/CHANGELOG.md

@@ -0,0 +1,221 @@
+# Changelog
+
+Generated on 2026-01-19
+
+## [v0.3.2] - Recent Releases
+
+### FEAT-0095: 文档内容与 CLI 参考
+- *Result*: Implemented - Core documentation pages (Manifesto, CLI Reference, Landing Page) populated and verified.
+
+### FEAT-0094: 内容管道与国际化策略
+- *Result*: implemented
+
+### FEAT-0093: 站点基础设施与设计系统
+- *Result*: implemented
+
+### FEAT-0092: Governance Maturity Checks
+- *Result*: Implemented
+
+### FEAT-0091: 实现 Git Hooks 机制
+- *Result*: implemented
+
+### FEAT-0090: VSCode Extension 组件化模块化重构
+- *Result*: Core refactoring (Phase 1-4) completed. Webview and LSP are now modular
+
+### FEAT-0088: 可配置 Issue Schema 加载器 (YAML 配置)
+- *Result*: implemented
+
+### FEAT-0087: 动态状态机引擎 (数据驱动逻辑)
+- *Result*: implemented
+
+### FEAT-0086: DDD Issue 建模 (影子对象层)
+- *Result*: implemented
+
+### FEAT-0085: 更新 VS Code 扩展以支持优化的动作系统
+- *Result*: Cancelled - Agent functionality removed from VS Code extension.
+
+### FEAT-0084: 优化 Issue 生命周期动作与 Agent 集成
+- *Result*: Cancelled - Agent functionality removed from Monoco core.
+
+### FEAT-0083: Integration of Monoco CLI as LSP Backend
+- *Result*: implemented
+
+### FEAT-0082: Issue Ticket Validator
+- *Result*: implemented
+
+### FEAT-0081: Prompty Action System: Context-Aware Agent Skills
+- *Result*: implemented
+
+### FEAT-0080: VS Code Execution UI: Sidebar & CodeLens
+- *Result*: implemented
+
+### FEAT-0079: VS Code 扩展与 Agent 状态的集成
+- *Result*: implemented
+
+### FEAT-0078: Agent 执行层与 CLI 集成
+- *Result*: implemented
+
+### FEAT-0077: Migrate Cockpit View to Pure LSP Architecture
+- *Result*: Implemented Pure LSP architecture, removing Python dependency for the Kanban
+
+### FEAT-0076: Implement Monoco Language Server
+- *Result*: Implemented a dual-project structure (client/server) within `extensions/vscode`.
+
+### FEAT-0075: VS Code Extension Realignment: Implementation of Proxy Pattern
+- *Result*: implemented
+
+### FEAT-0074: Core Integration Registry
+- *Result*: implemented
+
+### FEAT-0073: Implement Skill Manager and Distribution
+- *Result*: implemented
+
+### FEAT-0072: Core Agent Environment Manager (Sync & Uninstall)
+- *Result*: implemented
+
+### FEAT-0071: Implement Monoco Sync and Prompt Injection System
+- *Result*: implemented
+
+### FEAT-0070: 实现标准化的 monoco config 命令
+- *Result*: implemented
+
+### FEAT-0069: Spike 内容清洗与元数据增强
+- *Result*: cancelled
+
+### FEAT-0067: 执行配置与提示词管理
+- *Result*: implemented
+
+### FEAT-0066: 智能体运行时诊断 (Agent Runtime Diagnostics)
+- *Result*: implemented
+
+### FEAT-0065: 智能体运行时配置 (Agent Runtime Configuration)
+- *Result*: implemented
+
+### FEAT-0064: 智能父级选择
+- *Result*: implemented
+
+### FEAT-0063: 优化 VS Code 扩展 UI
+- *Result*: implemented
+
+### FEAT-0062: Drag-and-Drop Workflow via Text/URL
+- *Result*: Implemented
+
+### FEAT-0061: Cockpit Navigation Bridge (Webview to Editor)
+- *Result*: Implemented
+
+### FEAT-0059: VS Code Extension Scaffold & Webview Bridge
+- *Result*: implemented
+
+### FEAT-0058: Kanban 分发 - npm
+- *Result*: implemented
+
+### FEAT-0057: 看板终端集成 (xterm.js)
+- *Result*: implemented
+
+### FEAT-0056: Implement monoco-pty Service via WebSockets
+- *Result*: implemented
+
+### FEAT-0052: Kanban 分发 - NPM/NPX
+- *Result*: implemented
+
+### FEAT-0051: CLI 工具分发 - PyPI
+- *Result*: implemented
+
+### FEAT-0050: 一键安装脚本
+- *Result*: implemented
+
+### FEAT-0049: 安全清理
+- *Result*: implemented
+
+### FEAT-0048: 工具包自述文件完善
+- *Result*: implemented
+
+### FEAT-0047: 社区健康文件
+- *Result*: implemented
+
+### FEAT-0046: GitHub Page 维护
+- *Result*: implemented
+
+### FEAT-0043: Toolkit 分发渠道建设
+- *Result*: Implemented
+
+### FEAT-0038: Workspace 内跨项目引用互操作性
+- *Result*: implemented
+
+### FEAT-0037: CLI Advanced Issue Query
+- *Result*: implemented
+
+### FEAT-0036: Advanced Kanban Filter
+- *Result*: implemented
+
+### FEAT-0034: UI术语可配置化
+- *Result*: implemented
+
+### FEAT-0033: 交互式状态流转与合法性校验
+- *Result*: implemented
+
+### FEAT-0032: 可选分支隔离 (Optional Branch Isolation)
+- *Result*: implemented
+
+### FEAT-0031: 状态递归聚合 (Recursive State Aggregation)
+- *Result*: implemented
+
+### FEAT-0030: 提交溯源与扫描器 (Commit Traceability & Scanner)
+- *Result*: implemented
+
+### FEAT-0029: Web 看板实现 (Web Kanban Implementation)
+- *Result*: implemented
+
+### FEAT-0020: 工程视图 (Engineering View)
+- *Result*: implemented
+
+### FEAT-0019: 全局仪表盘 (Global Dashboard)
+- *Result*: implemented
+
+### FEAT-0016: 安全 Issue 编辑 (Safe Issue Editing)
+- *Result*: implemented
+
+### FEAT-0015: 看板 UI 增强 (Kanban UI Enhancements)
+- *Result*: implemented
+
+### FEAT-0014: 实现 Issue 管理 API (Implement Issue API)
+- *Result*: implemented
+
+### FEAT-0013: 实现 monoco issue list 命令 (Implement List Command)
+- *Result*: implemented
+
+### FEAT-0012: 增强 CLI 与 Server 的多工作区支持 (Enhance Workspace Support)
+- *Result*: implemented
+
+### FEAT-0011: 增强 i18n 报告功能: 支持缺失文档清单输出 (Enhance i18n Reporting)
+- *Result*: implemented
+
+### FEAT-0010: 增强 Init 命令 (Enhanced Init Command)
+- *Result*: implemented
+
+### FEAT-0009: 建立 Spike 系统使用文档体系 (Establish Spike Docs)
+- *Result*: implemented
+
+### FEAT-0008: 建立 Issue 系统使用文档体系 (Establish Issue Docs)
+- *Result*: implemented
+
+### FEAT-0007: 支持外部或子项目 Issue 根目录 (Support External Issue Roots)
+- *Result*: implemented
+
+### FEAT-0006: 支持层级 Issue 组织 (Support Hierarchical Issue Organization)
+- *Result*: implemented
+
+### FEAT-0005: 实现 i18n 扫描能力 (Implement i18n scan)
+- *Result*: implemented
+
+### FEAT-0004: 特性: 仓库管理 (Spike) (Repo Management - Spike)
+- *Result*: implemented
+
+### FEAT-0003: 特性: Issue 管理 (本地) (Issue Management - Local)
+- *Result*: implemented
+
+### FEAT-0002: Toolkit 核心基础设施 (Toolkit Core Infrastructure)
+- *Result*: implemented
+
+### FEAT-0001: 重构 Issue 术语为原生代理语义 (Refactor Issue Terminology)
+- *Result*: implemented

{monoco_toolkit-0.3.0 → monoco_toolkit-0.3.2}/CLAUDE.md

@@ -55,3 +55,19 @@ Monoco CLI 被设计为 **Agent 原生接口**。
 - **结构**:
   - 根文件: `FILE_ZH.md`
   - 子目录: `folder/zh/file.md`
+
+### Release Management
+
+### 发布管理
+
+Manage release lifecycle and versioning.
+管理发布生命周期和版本控制。
+
+- **Protocol**: Releases must be pushed from a dedicated branch `release/vX.Y.Z` matching the version in `pyproject.toml`.
+- **协议**: 发布必须从名为 `release/vX.Y.Z` 的专用分支推送，且分支名必须与 `pyproject.toml` 中的版本号匹配。
+
+- **Set Version**: `python Toolkit/scripts/set_version.py <version>` (Update version in all manifests)
+- **设置版本**: `python Toolkit/scripts/set_version.py <version>` (更新所有清单文件中的版本)
+
+- **Release Check**: `Toolkit/scripts/run_release_checks.sh <version>` (Run full validation suite)
+- **发布检查**: `Toolkit/scripts/run_release_checks.sh <version>` (运行完整验证套件)

{monoco_toolkit-0.3.0 → monoco_toolkit-0.3.2}/GEMINI.md

@@ -63,6 +63,9 @@ Monoco CLI 被设计为 **Agent 原生接口**。
 Manage release lifecycle and versioning.
 管理发布生命周期和版本控制。
 
+- **Protocol**: Releases must be pushed from a dedicated branch `release/vX.Y.Z` matching the version in `pyproject.toml`.
+- **协议**: 发布必须从名为 `release/vX.Y.Z` 的专用分支推送，且分支名必须与 `pyproject.toml` 中的版本号匹配。
+
 - **Set Version**: `python Toolkit/scripts/set_version.py <version>` (Update version in all manifests)
 - **设置版本**: `python Toolkit/scripts/set_version.py <version>` (更新所有清单文件中的版本)
 

monoco_toolkit-0.3.2/Issues/Chores/closed/CHORE-0010-document-governance-maturity-and-changelog.md

@@ -0,0 +1,57 @@
+---
+id: CHORE-0010
+uid: c5e860
+type: chore
+status: closed
+stage: done
+title: Document Governance Maturity and Changelog
+created_at: "2026-01-19T11:12:33"
+opened_at: "2026-01-19T11:12:33"
+updated_at: "2026-01-19T14:45:00"
+solution: Implemented
+domains: []
+dependencies: []
+related: []
+tags:
+  - "#CHORE-0010"
+files: []
+# parent: <EPIC-ID>   # 可选：父级 Issue ID
+# solution: null      # 关闭状态（已实现、已取消等）必填
+---
+
+## CHORE-0010: Document Governance Maturity and Changelog
+
+## 目标 (Objective)
+
+<!-- 清晰描述 “为什么” 和 “是什么”。专注于价值。 -->
+
+记录治理成熟度要求，并建立变更日志（Changelog）机制。
+
+## 验收标准 (Acceptance Criteria)
+
+<!-- 定义成功的二进制条件。 -->
+
+- [x] 在 `docs/` 中记录治理成熟度模型。
+- [x] 实现基础的变更日志自动生成。
+
+## 技术任务 (Technical Tasks)
+
+<!-- 分解为原子步骤。对子任务使用嵌套列表。 -->
+
+- [x] 编写治理成熟度文档。
+- [x] 创建 Changelog 模板。
+- [x] 编写 `scripts/generate_changelog.py` 自动化脚本。
+
+## Solution
+
+1.  **治理成熟度文档**: 已在 `docs/zh/issue/07_governance.md` 中详细阐述了 L1-L3 的渐进式治理策略。
+2.  **Changelog 机制**:
+    - 编写了 `scripts/generate_changelog.py` 脚本，支持自动解析 `Issues/Features/closed/` 中的元数据。
+    - 成功生成了包含 72 项变更的 `CHANGELOG.md`。
+
+## Review Comments
+
+<!-- Review/Done 阶段必填。在此记录评审反馈。 -->
+
+- [x] 内容已覆盖当前治理逻辑。
+- [x] 变更日志生成脚本在 Python 11 环境验证通过。

monoco_toolkit-0.3.2/Issues/Chores/closed/CHORE-0011-site-deployment-configuration.md

@@ -0,0 +1,50 @@
+---
+id: CHORE-0011
+uid: d65c6f
+type: chore
+status: closed
+stage: done
+title: 站点部署配置
+created_at: '2026-01-19T13:57:44'
+opened_at: '2026-01-19T13:57:44'
+updated_at: '2026-01-19T14:26:16'
+closed_at: '2026-01-19T14:26:16'
+parent: EPIC-0018
+solution: implemented
+isolation:
+  type: branch
+  ref: feat/chore-0011-站点部署配置
+  created_at: '2026-01-19T14:25:48'
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0011'
+- '#EPIC-0018'
+files: []
+---
+
+## CHORE-0011: 站点部署配置
+
+## 目标
+
+配置持续集成/持续部署 (CI/CD) 流水线，实现文档站点的自动化发布。
+
+## 验收标准
+
+- [x] 配置了 Vercel 部署所需的 `vercel.json`。
+- [x] 提供了 GitHub Actions 流水线示例。
+- [x] 构建命令集成了内容同步脚本。
+
+## 技术任务
+
+- [x] 选择部署平台 (推荐 Vercel)。
+- [x] 添加构建配置 (`site/vercel.json`)。
+- [x] 配置 GitHub Actions (`.github/workflows/deploy-docs.yml`)。
+- [x] 验证生产环境构建流程。
+
+## Review Comments
+
+- 已添加 `site/vercel.json`。
+- 已添加 `.github/workflows/deploy-docs.yml`。
+- 构建流程已将内容从 `docs/` 同步至 `site/src/`。