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

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.5}/.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.5}/.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.5}/.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.5}/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.5/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.5}/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.5/Issues/Chores/closed/CHORE-0014-fix-readme-spelling-errors.md

@@ -0,0 +1,44 @@
+---
+id: CHORE-0014
+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'
+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.5/Issues/Chores/closed/CHORE-0015-sync-issue-best-practices-to-agent-prompts.md

@@ -0,0 +1,42 @@
+---
+id: CHORE-0015
+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'
+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.5/Issues/Chores/closed/CHORE-0016-refactor-toolkit-readme-for-clarity-and-impact.md

@@ -0,0 +1,38 @@
+---
+id: CHORE-0016
+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'
+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.5/Issues/Chores/closed/CHORE-0017-update-readme-workflow-to-agent-first.md

@@ -0,0 +1,37 @@
+---
+id: CHORE-0017
+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'
+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.5/Issues/Chores/closed/CHORE-0018-update-value-proposition-with-co-pilot-philosophy.md

@@ -0,0 +1,37 @@
+---
+id: CHORE-0018
+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'
+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.5/Issues/Chores/closed/CHORE-0019-bump-version-to-0-3-4.md

@@ -0,0 +1,36 @@
+---
+id: CHORE-0019
+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'
+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.5}/Issues/Epics/open/EPIC-0000-Monoco-Toolkit-Root.md

@@ -14,8 +14,7 @@ tags:
 - '#EPIC-0000'
 - root
 - toolkit
-domains:
-- intelligence
+domains: []
 progress: 18/20
 files_count: 1
 ---

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.5}/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: 7/7
 files_count: 0
 stage: doing
 uid: f49381

{monoco_toolkit-0.3.3 → monoco_toolkit-0.3.5}/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.3 → monoco_toolkit-0.3.5}/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` 进行唯一性识别。

{monoco_toolkit-0.3.3/Issues/Features/open → monoco_toolkit-0.3.5/Issues/Features/closed}/FEAT-0101-implement-stateless-agent-draft-command.md

@@ -2,12 +2,12 @@
 id: FEAT-0101
 uid: 4e0731
 type: feature
-status: open
-stage: draft
+status: closed
+stage: done
 title: 实现无状态 Agent Draft 命令
 created_at: '2026-01-24T19:10:47'
-opened_at: '2026-01-24T19:10:47'
-updated_at: '2026-01-24T19:10:47'
+updated_at: '2026-01-25T23:19:11'
+parent: EPIC-0019
 dependencies: []
 related: []
 domains: []
@@ -15,8 +15,13 @@ tags:
 - '#EPIC-0019'
 - '#FEAT-0101'
 files: []
-parent: EPIC-0019
-# solution: null      # Required for Closed state (implemented, cancelled, etc.)
+opened_at: '2026-01-24T19:10:47'
+closed_at: '2026-01-25T23:19:11'
+solution: implemented
+isolation:
+  type: branch
+  ref: feat/feat-0101-实现无状态-agent-draft-命令
+  created_at: '2026-01-25T23:03:10'
 ---
 
 ## FEAT-0101: 实现无状态 Agent Draft 命令
@@ -27,30 +32,20 @@ parent: EPIC-0019
 这将 Agent 智能与 Daemon 运行时解耦，允许快速、可脚本化的使用。
 
 ## 验收标准
-<!-- Define binary conditions for success. -->
-- [ ] **CLI 命令**: `monoco agent draft` 可用。
-- [ ] **输入**: 支持 `--type` 和 `--desc` (description)。
-- [ ] **输出**: 根据描述自动生成结构化的 Issue 文件。
-- [ ] **无状态**: 不需要运行中的 Daemon 或 Session。
+- [x] **CLI 命令**: `monoco agent draft` 可用。
+- [x] **输入**: 支持 `--type` 和 `--desc` (description)。
+- [x] **输出**: 根据描述自动生成结构化的 Issue 文件。
+- [x] **无状态**: 不需要运行中的 Daemon 或 Session。
 
 ## 技术任务
-<!-- Breakdown into atomic steps. Use nested lists for sub-tasks. -->
-
-<!-- Status Syntax: -->
-<!-- [ ] To Do -->
-<!-- [/] Doing -->
-<!-- [x] Done -->
-<!-- [~] Cancelled -->
-<!-- - [ ] Parent Task -->
-<!--   - [ ] Sub Task -->
 
-- [ ] CLI 命令实现 (`monoco agent draft`)
+- [x] CLI 命令实现 (`monoco agent draft`)
 - [x] Mock 生成逻辑 (Template-based for MVP)
-- [ ] 基于 Session 的集成 (作为短生命周期的 Agent Session 运行)
+- [x] 基于 Session 的集成 (作为短生命周期的 Agent Session 运行)
 - [x] 与 Issue Core 集成 (create_issue_file)
 
 ## Review Comments
-<!-- Required for Review/Done stage. Record review feedback here. -->
+- 2026-01-25: Implemented `draft` command in CLI. Fixed role name mismatch (crafter vs drafter). Fixed session monitoring loop to correctly poll worker status.
 
 ## Post-mortem (Session ae71e4f9)
 **Date**: 2026-01-24
@@ -66,6 +61,6 @@ parent: EPIC-0019
 3.  **状态不一致**: 任务在 Issue 文件中被标记为完成，但代码未反映这一点。
 
 ### 恢复计划
--   重置任务: "CLI 命令实现" 和 "基于 Session 的集成"。
--   下一个 Agent 必须在 `monoco/features/scheduler/cli.py` 中实现 `draft` 命令。
--   验证 `monoco agent draft --desc "..."` 正确调用逻辑以创建 issue 文件。
+-   [x] 重置任务: "CLI 命令实现" 和 "基于 Session 的集成"。
+-   [x] 下一个 Agent 必须在 `monoco/features/scheduler/cli.py` 中实现 `draft` 命令。
+-   [x] 验证 `monoco agent draft --desc "..."` 正确调用逻辑以创建 issue 文件。

{monoco_toolkit-0.3.3/Issues/Features/open → monoco_toolkit-0.3.5/Issues/Features/closed}/FEAT-0102-async-worker.md

@@ -2,13 +2,13 @@
 id: FEAT-0102
 uid: a1b2c3
 type: feature
-status: open
-stage: review
+status: closed
+stage: done
 title: 重构 Worker 为异步执行模式
 created_at: '2026-01-25T14:30:00'
-updated_at: '2026-01-25T14:30:00'
-priority: high
-parent: null
+updated_at: '2026-01-25T22:53:01'
+closed_at: '2026-01-25T22:53:01'
+solution: implemented
 dependencies: []
 related: []
 domains: []
@@ -21,6 +21,7 @@ files:
 - monoco/features/scheduler/manager.py
 - tests/features/test_scheduler.py
 - tests/features/test_session.py
+priority: high
 ---
 
 ## FEAT-0102: 重构 Worker 为异步执行模式

{monoco_toolkit-0.3.3/Issues/Features/open → monoco_toolkit-0.3.5/Issues/Features/closed}/FEAT-0103-configurable-role-loader.md

@@ -2,13 +2,13 @@
 id: FEAT-0103
 uid: d4e5f6
 type: feature
-status: open
-stage: doing
+status: closed
+stage: done
 title: 实现配置驱动的角色加载机制
 created_at: '2026-01-25T14:30:00'
-updated_at: '2026-01-25T14:30:00'
+updated_at: '2026-01-25T23:19:11'
 priority: high
-parent: null
+parent: null # <EPIC-ID> Optional
 dependencies: []
 related: []
 domains: []
@@ -19,6 +19,12 @@ files:
 - monoco/features/scheduler/config.py
 - monoco/features/scheduler/defaults.py
 - monoco/features/scheduler/models.py
+closed_at: '2026-01-25T23:19:11'
+solution: implemented
+isolation:
+  type: branch
+  ref: feat/feat-0103-实现配置驱动的角色加载机制
+  created_at: '2026-01-25T23:13:37'
 ---
 
 ## FEAT-0103: 实现配置驱动的角色加载机制
@@ -42,7 +48,11 @@ files:
 3. **命令支持**: `monoco role list` 显示当前生效的所有角色及其来源。
 
 ### 任务
-- [ ] 定义 `roles.yaml` Schema (基于 Pydantic Model)。
-- [ ] 实现 `ConfigLoader` 类，支持层级加载和字典合并。
-- [ ] 重构 `SessionManager` 使用 `ConfigLoader` 而非 `DEFAULT_ROLES`。
-- [ ] 添加单测验证覆盖逻辑。
+- [x] 定义 `roles.yaml` Schema (基于 Pydantic Model)。
+- [x] 实现 `RoleLoader` 类，支持层级加载和字典合并。
+- [x] 重构 `ApoptosisManager` 和 CLI 使用 `RoleLoader` 而非硬编码 Defaults。
+- [x] 添加 `monoco role list` 命令。
+- [x] 验证 Level 1-3 覆盖逻辑。
+
+## Review Comments
+- 2026-01-25: Implemented `RoleLoader` with tiered support (builtin, home, project). Added `monoco role list` command. Verified override logic via project-local configuration.