monoco-toolkit 0.3.3__tar.gz → 0.3.6__tar.gz

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/.github/workflows/ci.yml

@@ -2,6 +2,7 @@ name: CI
 
 on:
   push:
+    branches: ['main']
     tags: ['v*']
   pull_request:
     branches: ['main']

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/.monoco/project.yaml

@@ -10,6 +10,7 @@ project:
     agentskills: https://github.com/agentskills/agentskills
     claude-agent-sdk-python: https://github.com/anthropics/claude-agent-sdk-python
     gemini-cli: https://github.com/google-gemini/gemini-cli
+    monoco-toolkit: https://github.com/IndenScale/monoco-toolkit
     qwen-code: https://github.com/QwenLM/qwen-code
     ralph: https://github.com/snarktank/ralph
     skills: https://github.com/anthropics/skills

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/.pre-commit-config.yaml

@@ -6,8 +6,7 @@ repos:
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
-      - id: no-commit-to-branch
-        args: [--branch, main, --branch, master]
+      - id: check-added-large-files
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.1.13

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/AGENTS.md

@@ -47,5 +47,5 @@ Manage internationalization.
 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)
+- **Set Version**: **MUST** use `python Toolkit/scripts/set_version.py <version>` to update version in all manifests. **DO NOT** edit version numbers manually.
 - **Release Check**: `Toolkit/scripts/run_release_checks.sh <version>` (Run full validation suite)

monoco_toolkit-0.3.6/CLAUDE.md

@@ -0,0 +1,53 @@
+## Monoco Toolkit
+
+> **Auto-Generated**: This section is managed by Monoco. Do not edit manually.
+
+### Issue Management
+
+# Issue 管理 (Agent 指引)
+
+## Issue 管理
+
+使用 `monoco issue` 管理任务的系统。
+
+- **创建**: `monoco issue create <type> -t "标题"` (类型: epic, feature, chore, fix)
+- **状态**: `monoco issue open|close|backlog <id>`
+- **检查**: `monoco issue lint` (手动编辑后必须运行)
+- **生命周期**: `monoco issue start|submit|delete <id>`
+- **上下文同步**: `monoco issue sync-files [id]` (更新文件追踪)
+- **结构**: `Issues/{CapitalizedPluralType}/{lowercase_status}/` (如 `Issues/Features/open/`)。
+- **强制规则**:
+  1. **标题**: 必须包含 `## {ID}: {Title}` 标题（与 Front Matter 一致）。
+  2. **内容**: 至少 2 个 Checkbox，使用 `- [ ]`, `- [x]`, `- [-]`, `- [/]`。
+  3. **评审**: `review`/`done` 阶段必须包含 `## Review Comments` 章节且内容不为空。
+  4. **环境策略**:
+     - 必须使用 `monoco issue start --branch` 创建 Feature 分支。
+     - 🛑 **禁止**直接在 `main`/`master` 分支修改代码 (Linter 会报错)。
+     - 修改代码后**必须**更新 `files` 字段（通过 `sync-files` 或手动）。
+
+### Spike (Research)
+
+### Spike (研究)
+
+管理外部参考仓库。
+
+- **添加仓库**: `monoco spike add <url>` (在 `.reference/<name>` 中可读)
+- **同步**: `monoco spike sync` (运行以下载内容)
+- **约束**: 永远不要编辑 `.reference/` 中的文件。将它们视为只读的外部知识。
+
+### Documentation I18n
+
+### 文档国际化
+
+管理国际化。
+
+- **扫描**: `monoco i18n scan` (检查缺失的翻译)
+- **结构**:
+  - 根文件: `FILE_ZH.md`
+  - 子目录: `folder/zh/file.md`
+
+### Release Management
+
+Manage release lifecycle and versioning.
+
+- **Set Version**: **MUST** use `python Toolkit/scripts/set_version.py <version>` to update version in all manifests. **DO NOT** edit version numbers manually.

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/GEMINI.md

@@ -15,6 +15,18 @@
 - **虚拟环境优先**: 必须使用 `uv run monoco` 来运行当前目录下的源代码。
 - **环境切换**: 修改代码后，应立即在 `Toolkit/` 目录下运行 `uv run monoco issue lint` 验证逻辑。
 
+### 3. 工程流 (Engineering Workflow)
+
+采用 **主干开发 (Trunk Based Development)** 模式。
+
+- **分支策略**:
+  - **Main**: 唯一真理源 (Source of Truth)。
+  - **Feature**: 短命分支 (`feat/ID`, `fix/ID`)，完成后 Squash Merge 并删除。
+- **发布策略**:
+  - **Trigger**: 仅通过 Git Tag (`v*`) 触发发布流水线。
+  - **Constraint**: 严禁维护长周期的 `release` 分支。
+  - **Version Update**: 必须使用 `python Toolkit/scripts/set_version.py <version>` 更新版本号，严禁手动修改配置文件。
+
 ## Issue 管理 (Agent 指引)
 
 使用 `monoco issue` 子命令进行生命周期管理。
@@ -28,10 +40,12 @@
 
 ### 强制规则 (Hard Rules)
 
-1. **标题对齐**: 必须包含 `## {ID}: {Title}` 标题，且与 Frontmatter 一致。
-2. **任务颗粒度**: 至少包含 2 个任务项，使用 `- [ ]` 语法。
-3. **评审义务**: 进入 `review` 或 `done` 阶段时，必须包含 `## Review Comments` 章节。
-4. **分支策略**: 必须使用 `monoco issue start --branch` 创建独立特性分支，**禁止**在 `main` 分支直接提交。
+1. **先有 Issue，后有 Draft**: 开始任何调研、设计或 Draft 阶段之前，必须使用 `monoco issue create` 创建 Issue。禁止在没有 Issue 的情况下开展工作。
+2. **分支隔离 (Build 阶段)**: 进行代码构建或修改时，**必须**使用 `monoco issue start --branch` 创建特有的 Git 分支。禁止在 `main` 分支直接提交。
+3. **环境清理时机**: 环境清理（分支/Worktree 删除）**仅**应在 `monoco issue close --prune` 时执行。**禁止**在 `submit` 阶段清理环境，因为 Review 过程可能需要进一步修改。
+4. **标题对齐**: 必须包含 `## {ID}: {Title}` 标题，且与 Frontmatter 一致。
+5. **任务颗粒度**: 至少包含 2 个任务项，使用 `- [ ]` 语法。
+6. **评审义务**: 进入 `review` 或 `done` 阶段时，必须包含 `## Review Comments` 章节。
 
 ## Spike (研究)
 

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0002-/345/256/214/346/210/220I18n/346/226/207/346/241/243.md

@@ -5,7 +5,7 @@ status: closed
 stage: done
 title: 完善 monoco i18n 命令文档 (Complete i18n Docs)
 created_at: '2026-01-09'
-solution: completed
+solution: implemented
 domains: []
 tags:
 - '#CHORE-0002'

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0003-refactor-config-loading-for-unified-context.md

@@ -1,5 +1,6 @@
 ---
 id: CHORE-0003
+parent: EPIC-0000
 uid: ee962c
 type: chore
 status: closed
@@ -15,6 +16,7 @@ related: []
 domains: []
 tags:
 - '#CHORE-0003'
+- '#EPIC-0000'
 ---
 
 ## CHORE-0003: 重构配置加载以统一上下文

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0004-vscode-/346/217/222/344/273/266/347/230/246/345/256/242/346/210/267/347/253/257/346/236/266/346/236/204/351/207/215/346/236/204.md

@@ -1,5 +1,6 @@
 ---
 id: CHORE-0004
+parent: EPIC-0000
 uid: d31189
 type: chore
 status: closed
@@ -15,6 +16,7 @@ related: []
 domains: []
 tags:
 - '#CHORE-0004'
+- '#EPIC-0000'
 ---
 
 ## CHORE-0004: VSCode 插件瘦客户端架构重构

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0005-update-vs-code-extension-documentation.md

@@ -1,5 +1,6 @@
 ---
 id: CHORE-0005
+parent: EPIC-0000
 uid: d42e3c
 type: chore
 status: closed
@@ -15,6 +16,7 @@ related: []
 domains: []
 tags:
 - '#CHORE-0005'
+- '#EPIC-0000'
 ---
 
 ## CHORE-0005: Update VS Code Extension Documentation

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0006-research-enhanced-issue-templates.md

@@ -9,13 +9,14 @@ created_at: '2026-01-17T09:55:05'
 opened_at: '2026-01-17T09:55:05'
 updated_at: '2026-01-17T10:25:00'
 closed_at: '2026-01-17T10:25:00'
-parent: null
+parent: EPIC-0000
 solution: implemented
 dependencies: []
 related: []
 domains: []
 tags:
 - '#CHORE-0006'
+- '#EPIC-0000'
 ---
 
 ## CHORE-0006: 调研增强型 Issue 模板

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0010-document-governance-maturity-and-changelog.md

@@ -5,18 +5,18 @@ 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
+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"
+- '#CHORE-0010'
+- '#EPIC-0000'
 files: []
-# parent: <EPIC-ID>   # 可选：父级 Issue ID
-# solution: null      # 关闭状态（已实现、已取消等）必填
+parent: EPIC-0000
 ---
 
 ## CHORE-0010: Document Governance Maturity and Changelog

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0012-refactor-documentation-structure-and-unify-source.md

@@ -1,5 +1,6 @@
 ---
 id: CHORE-0012
+parent: EPIC-0000
 uid: 6ab718
 type: chore
 status: closed
@@ -19,6 +20,7 @@ related: []
 domains: []
 tags:
 - '#CHORE-0012'
+- '#EPIC-0000'
 files:
 - '"Issues/Epics/closed/EPIC-0002-\346\231\272\350\203\275\344\273\273\345\212\241\345\206\205\346\240\270\344\270\216\347\212\266\346\200\201\346\234\272.md"'
 - '"Issues/Epics/closed/EPIC-0006-Monoco\347\234\213\346\235\277Web\345\272\224\347\224\250.md"'

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Chores/closed/CHORE-0013-/346/233/264/346/226/260-agent-/346/226/207/346/241/243/344/273/245/345/217/215/346/230/240-git-/351/232/224/347/246/273/345/267/245/344/275/234/346/265/201.md

@@ -1,5 +1,6 @@
 ---
 id: CHORE-0013
+parent: EPIC-0000
 uid: 6f0ea3
 type: chore
 status: closed
@@ -19,6 +20,7 @@ related: []
 domains: []
 tags:
 - '#CHORE-0013'
+- '#EPIC-0000'
 files:
 - '"Issues/Epics/closed/EPIC-0002-\346\231\272\350\203\275\344\273\273\345\212\241\345\206\205\346\240\270\344\270\216\347\212\266\346\200\201\346\234\272.md"'
 - '"Issues/Epics/closed/EPIC-0006-Monoco\347\234\213\346\235\277Web\345\272\224\347\224\250.md"'

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0014-fix-readme-spelling-errors.md

@@ -0,0 +1,46 @@
+---
+id: CHORE-0014
+parent: EPIC-0000
+uid: f8fd18
+type: chore
+status: closed
+stage: done
+title: Fix README spelling errors
+created_at: '2026-01-24T19:37:33'
+opened_at: '2026-01-24T19:37:33'
+updated_at: 2026-01-25 22:58:17
+closed_at: '2026-01-25T22:58:17'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0014'
+- '#EPIC-0000'
+files: []
+---
+
+## CHORE-0014: Fix README spelling errors
+
+## 目标
+确保所有项目文档 (READMEs) 均达到专业水准，格式正确，且无拼写或结构性错误。此任务专注于打磨面向外部的文档，以维持高标准的交付质量。
+
+## 验收标准
+- [x] 根目录 `README.md` 和 `README_ZH.md` 中无拼写或语法错误。
+- [x] 移除 `README_ZH.md` “快速开始”部分的冗余格式。
+- [x] 验证主要 README 中的所有内部和外部链接。
+- [x] 确保所有文档中术语（如 "Agentic Engineering"、"Issue as Code"）的一致性。
+
+## 技术任务
+- [x] 扫描并修复根目录 README 的拼写/语法。
+  - [x] 识别 `README_ZH.md` 中的冗余内容。
+  - [x] 对 `README.md` 进行全面审查。
+  - [x] 对 `README_ZH.md` 进行全面审查。
+- [x] 验证 `Kanban/README.md` 和 `Kanban/README_ZH.md`。
+- [x] 验证 `extensions/vscode/README.md`。
+- [x] 检查这 5 个文件中的所有链接。
+
+## Review Comments
+- 已修复 `README_ZH.md` 中的代码块冗余问题。
+- 已验证 `Toolkit` 及子模块 `Kanban`, `extensions/vscode` 的 README 文档链接有效性。
+- 拼写检查通过。

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0015-sync-issue-best-practices-to-agent-prompts.md

@@ -0,0 +1,44 @@
+---
+id: CHORE-0015
+parent: EPIC-0000
+uid: df018a
+type: chore
+status: closed
+stage: done
+title: 同步 Issue 最佳实践到 Agent 提示词
+created_at: '2026-01-26T00:51:15'
+opened_at: '2026-01-26T00:51:15'
+updated_at: 2026-01-26 00:55:25
+closed_at: '2026-01-26T00:54:36'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0015'
+- '#EPIC-0000'
+files:
+- Issues/Chores/open/CHORE-0015-sync-issue-best-practices-to-agent-prompts.md
+- monoco/features/issue/resources/en/AGENTS.md
+- monoco/features/issue/resources/zh/AGENTS.md
+---
+
+## CHORE-0015: 同步 Issue 最佳实践到 Agent 提示词
+
+## 目标 (Objective)
+确保英汉双语的 Agent 指南 (AGENTS.md) 准确反映严格的 Issue 驱动开发最佳实践，特别是 "Issue First" 规则和环境清理的精确时机。
+
+## 验收标准 (Acceptance Criteria)
+- [x] 英文 AGENTS.md 包含 "Issue First" 规则。
+- [x] 英文 AGENTS.md 包含正确的 prune 时机 (仅 close 时)。
+- [x] 中文 AGENTS.md 包含 "Issue First" 规则。
+- [x] 中文 AGENTS.md 包含正确的 prune 时机 (仅 close 时)。
+
+## 技术任务 (Technical Tasks)
+
+- [x] 更新 `monoco/features/issue/resources/en/AGENTS.md`
+- [x] 更新 `monoco/features/issue/resources/zh/AGENTS.md`
+
+## 评审备注 (Review Comments)
+<!-- Required for Review/Done stage. Record review feedback here. -->
+Self-reviewed. Changes align with GEMINI.md core principles.

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0016-refactor-toolkit-readme-for-clarity-and-impact.md

@@ -0,0 +1,40 @@
+---
+id: CHORE-0016
+parent: EPIC-0000
+uid: 751c88
+type: chore
+status: closed
+stage: done
+title: 重构 Toolkit README 以提升清晰度与影响力
+created_at: '2026-01-26T01:01:01'
+opened_at: '2026-01-26T01:01:01'
+updated_at: '2026-01-26T01:02:38'
+closed_at: '2026-01-26T01:02:38'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0016'
+- '#EPIC-0000'
+files: []
+---
+
+## CHORE-0016: 重构 Toolkit README 以提升清晰度与影响力
+
+## 目标 (Objective)
+改进 Toolkit 文档，以清晰传达 "Agentic Engineering" 与 "Chat" 的价值主张差异，并正确记录 `monoco init` 和 `monoco sync` 命令，以避免关于其冗余性的歧义。
+
+## 验收标准 (Acceptance Criteria)
+- [x] README.md 已更新，价值主张清晰。
+- [x] README_ZH.md 已更新，价值主张清晰。
+- [x] `monoco init` 和 `monoco sync` 已在快速开始中正确记录上下文。
+
+## 技术任务 (Technical Tasks)
+- [x] 分析当前 README 和代码库以验证命令用法。
+- [x] 更新 `Toolkit/README.md`。
+- [x] 更新 `Toolkit/README_ZH.md`。
+
+## 评审备注 (Review Comments)
+- 验证了 `monoco init` 引导工作区，`monoco sync` 注入 agent prompts/skills。它们是独特且必要的步骤。
+- 文档现在强调 "Engineering" 方面而非 "Chat"。

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0017-update-readme-workflow-to-agent-first.md

@@ -0,0 +1,39 @@
+---
+id: CHORE-0017
+parent: EPIC-0000
+uid: eb92ec
+type: chore
+status: closed
+stage: done
+title: 更新 README 工作流为 Agent 优先
+created_at: '2026-01-26T01:05:52'
+opened_at: '2026-01-26T01:05:52'
+updated_at: '2026-01-26T01:06:42'
+closed_at: '2026-01-26T01:06:42'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0017'
+- '#EPIC-0000'
+files: []
+---
+
+## CHORE-0017: 更新 README 工作流为 Agent 优先
+
+## 目标 (Objective)
+更新 README 中的 "工程闭环" 章节，以反映 Agent 优先的工作流 (Chat -> Plan -> Build -> Ship)，而非手动 CLI 使用。用户不应需要为日常工作学习 CLI API。
+
+## 验收标准 (Acceptance Criteria)
+- [x] README.md 步骤 4 简化为 Agent 交互。
+- [x] README_ZH.md 步骤 4 简化为 Agent 交互。
+- [x] 从执行循环描述中移除了 CLI 命令。
+
+## 技术任务 (Technical Tasks)
+- [x] 重写 `Toolkit/README.md` 中的 "The Engineering Loop"。
+- [x] 重写 `Toolkit/README_ZH.md` 中的 "工程闭环"。
+
+## 评审备注 (Review Comments)
+- 更新了文档以强调 Agent 充当 DevOps 工程师，处理底层 CLI 命令。
+- 流程现在是：Chat -> Plan (Ticket) -> Review -> Build (Branch/Code) -> Ship (Merge/Close)。

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0018-update-value-proposition-with-co-pilot-philosophy.md

@@ -0,0 +1,39 @@
+---
+id: CHORE-0018
+parent: EPIC-0000
+uid: c7337a
+type: chore
+status: closed
+stage: done
+title: 更新价值主张为 Co-pilot 哲学
+created_at: '2026-01-26T01:11:50'
+opened_at: '2026-01-26T01:11:50'
+updated_at: '2026-01-26T01:12:45'
+closed_at: '2026-01-26T01:12:45'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0018'
+- '#EPIC-0000'
+files: []
+---
+
+## CHORE-0018: 更新价值主张为 Co-pilot 哲学
+
+## 目标 (Objective)
+增强 README 中的价值主张，强调 Monoco 的 "Co-pilot" 本质：恰到好处的自动化（用户掌控）、遵循 SWE 最佳实践（IDD, Git）以及 "过程即产品" (Dogfooding) 哲学。
+
+## 验收标准 (Acceptance Criteria)
+- [x] README_ZH.md "核心概念" 替换为 3 个新支柱：Co-pilot, Best Practices, Dogfooding。
+- [x] README.md "Core Concepts" 替换为等效的英文支柱。
+- [x] 语调强调 "辅助驾驶" 胜过 "全自动驾驶"。
+
+## 技术任务 (Technical Tasks)
+- [x] 更新 `Toolkit/README_ZH.md`。
+- [x] 更新 `Toolkit/README.md`。
+
+## 评审备注 (Review Comments)
+- 文档现在清楚地将 Monoco 定位为具有人类监督的 "Agentic Engineering" 工具，而不是黑盒自动化工具。
+- "Dogfooding" 点对于建立信任至关重要。

monoco_toolkit-0.3.6/Issues/Chores/closed/CHORE-0019-bump-version-to-0-3-4.md

@@ -0,0 +1,38 @@
+---
+id: CHORE-0019
+parent: EPIC-0000
+uid: 8c2798
+type: chore
+status: closed
+stage: done
+title: 升级版本至 0.3.4
+created_at: '2026-01-26T01:17:29'
+opened_at: '2026-01-26T01:17:29'
+updated_at: '2026-01-26T01:18:07'
+closed_at: '2026-01-26T01:18:07'
+solution: implemented
+dependencies: []
+related: []
+domains: []
+tags:
+- '#CHORE-0019'
+- '#EPIC-0000'
+files: []
+---
+
+## CHORE-0019: 升级版本至 0.3.4
+
+## 目标 (Objective)
+将所有 Toolkit 组件的版本升级到 0.3.4，紧随 v0.3.3 发布之后。这确保所有包在下一个开发周期中保持同步。
+
+## 验收标准 (Acceptance Criteria)
+- [x] 所有包 (`pyproject.toml`, `package.json`s) 均已更新至 0.3.4。
+- [x] 验证脚本通过。
+
+## 技术任务 (Technical Tasks)
+- [x] 运行 `scripts/set_version.py 0.3.4`。
+- [x] 运行 `scripts/verify_versions.py` 以确认一致性。
+
+## 评审备注 (Review Comments)
+- 使用辅助脚本成功更新了 5 个文件。
+- 验证了所有组件的一致性。

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Epics/open/EPIC-0000-Monoco-Toolkit-Root.md

@@ -14,10 +14,9 @@ tags:
 - '#EPIC-0000'
 - root
 - toolkit
-domains:
-- intelligence
-progress: 18/20
-files_count: 1
+domains: []
+progress: 64/67
+files_count: 7
 ---
 
 ## EPIC-0000: Monoco Toolkit 核心根节点

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Epics/open/EPIC-0001-Monoco/345/267/245/345/205/267/347/256/261.md

@@ -11,7 +11,7 @@ tags:
 - core
 - infrastructure
 - toolkit
-progress: 5/6
+progress: 8/8
 files_count: 0
 stage: doing
 uid: f49381

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Epics/open/EPIC-0019-implement-agent-scheduler-module.md

@@ -3,7 +3,7 @@ id: EPIC-0019
 uid: '638912'
 type: epic
 status: open
-stage: draft
+stage: doing
 title: Implement Agent Scheduler Module
 created_at: '2026-01-24T18:45:05'
 opened_at: '2026-01-24T18:45:05'
@@ -16,6 +16,8 @@ tags:
 - '#EPIC-0019'
 files: []
 parent: EPIC-0000
+progress: 1/1
+files_count: 0
 ---
 
 ## EPIC-0019: Implement Agent Scheduler Module

monoco_toolkit-0.3.6/Issues/Epics/open/EPIC-0021-build-strict-issue-validation-system.md

@@ -0,0 +1,41 @@
+---
+id: EPIC-0021
+uid: 772b8c
+type: epic
+status: open
+stage: doing
+title: 构建测试体系：严密的 Issue Ticket 验证机制
+created_at: '2026-01-29T15:48:00'
+opened_at: '2026-01-29T15:48:00'
+updated_at: '2026-01-29T15:48:00'
+parent: EPIC-0000
+dependencies: []
+related: []
+domains: []
+tags:
+- '#EPIC-0000'
+- '#EPIC-0021'
+- '#Quality'
+files: []
+progress: 1/1
+files_count: 0
+---
+
+## EPIC-0021: 构建测试体系：严密的 Issue Ticket 验证机制
+
+## Objective
+Monoco 的核心哲学是 "Task as Code"。为了确保任务系统的鲁棒性，必须建立严密的验证机制。
+本 Epic 旨在通过强化 Pydantic 模型约束和引入 Pytest 自动化测试，确保 Issue Ticket 的静态字段及状态流转符合设计预期。
+
+## Acceptance Criteria
+- [ ] **强类型约束**: IssueMetadata 的 type, status, stage, solution 字段必须使用 Enum。
+- [ ] **防御性解析**: 对于非规范的输入（如大小写不一），具备自动纠偏或明确报错的能力。
+- [ ] **单元测试覆盖**: 建立专门针对 `monoco.features.issue.models` 的测试套件。
+- [ ] **边界检查**: 覆盖 solution 字段乱填、状态机非法流转等边界情况。
+
+## Technical Tasks
+- [x] **FIX-0015**: 修正 IssueMetadata 字段约束为枚举类型。
+- [ ] **FEAT-0101**: 构建 monoco-issue 核心库的 pytest 单元测试体系。
+
+## Review Comments
+<!-- Required for Review/Done stage. Record review feedback here. -->

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Features/closed/FEAT-0029-Web/347/234/213/346/235/277/345/256/236/347/216/260.md

@@ -1,5 +1,6 @@
 ---
 id: FEAT-0029
+parent: EPIC-0000
 type: feature
 status: closed
 stage: done
@@ -14,6 +15,7 @@ related:
 - EPIC-0003
 domains: []
 tags:
+- '#EPIC-0000'
 - '#EPIC-0003'
 - '#FEAT-0029'
 uid: a8bcfe

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Features/closed/FEAT-0036-advanced-kanban-filter.md

@@ -1,5 +1,6 @@
 ---
 id: FEAT-0036
+parent: EPIC-0000
 type: feature
 status: closed
 stage: done
@@ -13,6 +14,7 @@ dependencies: []
 related: []
 domains: []
 tags:
+- '#EPIC-0000'
 - '#FEAT-0036'
 uid: e64f42
 ---

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Features/closed/FEAT-0037-cli-advanced-issue-query.md

@@ -1,5 +1,6 @@
 ---
 id: FEAT-0037
+parent: EPIC-0000
 type: feature
 status: closed
 stage: done
@@ -13,6 +14,7 @@ dependencies: []
 related: []
 domains: []
 tags:
+- '#EPIC-0000'
 - '#FEAT-0037'
 uid: f37584
 ---

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.6}/Issues/Features/closed/FEAT-0038-workspace-/345/206/205/350/267/250/351/241/271/347/233/256/345/274/225/347/224/250/344/272/222/346/223/215/344/275/234/346/200/247.md

@@ -29,7 +29,7 @@ tags:
 
 - [x] **Project Namespace Support**:
   - `monoco.yaml` 支持定义 Workspace 成员项目。
-  - 支持 `project::ID` (例如 `toolkit::FEAT-0004`) 的引用语法。
+  - 支持 `project::ID` (例如 `FEAT-0004`) 的引用语法。
 - [x] **Identity Stabilization (UID)**:
   - 在 Issue 元数据中引入全局唯一的 `uid` (Short Hash)。
   - 当 Issue 跨项目移动导致物理 ID 冲突时，系统能根据 `uid` 进行唯一性识别。