monoco-toolkit 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

monoco/core/resources/en/AGENTS.md

@@ -6,3 +6,28 @@ Core toolkit commands for project management.
 - **Config**: `monoco config get|set <key> [value]` (Manage configuration)
 - **Sync**: `monoco sync` (Synchronize with agent environments)
 - **Uninstall**: `monoco uninstall` (Clean up agent integrations)
+
+---
+
+## ⚠️ Agent Must-Read: Git Workflow
+
+Before modifying any code, **MUST** follow these steps:
+
+### Standard Process
+
+1. **Create Issue**: `monoco issue create feature -t "Feature Title"`
+2. **🔒 Start Isolation**: `monoco issue start FEAT-XXX --branch`
+   - ⚠️ **Required** `--branch` flag
+   - ❌ Never modify code directly on `main`/`master` branches
+3. **Implement**: Code and test normally
+4. **Sync Files**: `monoco issue sync-files` (must run before commit)
+5. **Submit Review**: `monoco issue submit FEAT-XXX`
+6. **Close Issue**: `monoco issue close FEAT-XXX --solution implemented`
+
+### Quality Gates
+
+- Git Hooks auto-run `monoco issue lint` and tests
+- Don't bypass with `git commit --no-verify`
+- Linter blocks direct modifications on protected branches
+
+> 📖 See `monoco-issue` skill for complete workflow documentation.

monoco/core/resources/en/SKILL.md

@@ -34,7 +34,6 @@ Monoco is a developer productivity toolkit that provides:
 ### Agent Integration
 
 - **`monoco sync`**: Synchronize with agent environments
-
   - Injects system prompts into agent configuration files (GEMINI.md, CLAUDE.md, etc.)
   - Distributes skills to agent framework directories
   - Respects language configuration from `i18n.source_lang`
@@ -43,6 +42,24 @@ Monoco is a developer productivity toolkit that provides:
   - Removes managed blocks from agent configuration files
   - Cleans up distributed skills
 
+### Git Workflow Integration
+
+Monoco enforces a **Feature Branch Workflow** to ensure code isolation and quality:
+
+- **`monoco init`**: Automatically installs Git Hooks
+  - **pre-commit**: Runs Issue Linter and code formatting checks
+  - **pre-push**: Executes test suite and integrity validation
+  - All hooks configurable via `.monoco/config.yaml`
+
+- **Branch Isolation Strategy**:
+  - ⚠️ **Required**: Use `monoco issue start <ID> --branch` to create isolated environment
+  - Auto-generates normalized branch names: `feat/<id>-<slug>`
+  - **Main Protection**: Linter blocks direct code modifications on `main`/`master` branches
+
+- **File Tracking**: `monoco issue sync-files` auto-syncs Git changes to Issue metadata
+
+> 📖 **Detailed Workflow**: See `monoco-issue` skill for complete Issue lifecycle management guide.
+
 ## Configuration Structure
 
 Configuration is stored in YAML format at:
@@ -60,7 +77,21 @@ Key configuration sections:
 
 ## Best Practices
 
+### Basic Operations
+
 1. **Use CLI commands** instead of manual file editing when possible
 2. **Run `monoco sync`** after configuration changes to update agent environments
 3. **Commit `.monoco/config.yaml`** to version control for team consistency
 4. **Keep global config minimal** - most settings should be project-specific
+
+### Git Workflow (⚠️ CRITICAL for Agents)
+
+5. **Strictly follow branch isolation**:
+   - ✅ Always use: `monoco issue start <ID> --branch`
+   - ❌ Never modify code directly on `main`/`master` branches
+   - 📝 Before commit: Run `monoco issue sync-files` to update file tracking
+
+6. **Quality Gates**:
+   - Git Hooks will auto-run checks, don't bypass (`--no-verify`)
+   - Ensure `monoco issue lint` passes before committing
+   - Use `monoco issue submit` to generate delivery reports

monoco/core/resources/zh/AGENTS.md

@@ -6,3 +6,28 @@
 - **配置**: `monoco config get|set <key> [value]` (管理配置)
 - **同步**: `monoco sync` (与 agent 环境同步)
 - **卸载**: `monoco uninstall` (清理 agent 集成)
+
+---
+
+## ⚠️ Agent 必读: Git 工作流
+
+在修改任何代码前,**必须**遵循以下步骤:
+
+### 标准流程
+
+1. **创建 Issue**: `monoco issue create feature -t "功能标题"`
+2. **🔒 启动隔离环境**: `monoco issue start FEAT-XXX --branch`
+   - ⚠️ **强制要求** `--branch` 参数
+   - ❌ 禁止在 `main`/`master` 分支直接修改代码
+3. **实现功能**: 正常编码和测试
+4. **同步文件**: `monoco issue sync-files` (提交前必须运行)
+5. **提交审查**: `monoco issue submit FEAT-XXX`
+6. **关闭 Issue**: `monoco issue close FEAT-XXX --solution implemented`
+
+### 质量门禁
+
+- Git Hooks 会自动运行 `monoco issue lint` 和测试
+- 不要使用 `git commit --no-verify` 绕过检查
+- Linter 会阻止在受保护分支上的直接修改
+
+> 📖 详见 `monoco-issue` skill 获取完整工作流文档。

monoco/core/resources/zh/SKILL.md

@@ -42,6 +42,24 @@ Monoco 是一个开发者生产力工具包，提供:
   - 从 agent 配置文件中移除托管块
   - 清理已分发的 skills
 
+### Git 工作流集成
+
+Monoco 强制执行 **Feature Branch 工作流**以确保代码隔离和质量:
+
+- **`monoco init`**: 自动安装 Git Hooks
+  - **pre-commit**: 运行 Issue Linter 和代码格式检查
+  - **pre-push**: 执行测试套件和完整性验证
+  - 所有 Hooks 可通过 `.monoco/config.yaml` 配置
+
+- **分支隔离策略**:
+  - ⚠️ **强制要求**: 使用 `monoco issue start <ID> --branch` 创建隔离环境
+  - 自动创建规范化分支名: `feat/<id>-<slug>`
+  - **主干保护**: Linter 会阻止在 `main`/`master` 分支上的直接代码修改
+
+- **文件追踪**: `monoco issue sync-files` 自动同步 Git 变更到 Issue 元数据
+
+> 📖 **详细工作流**: 参见 `monoco-issue` skill 获取完整的 Issue 生命周期管理指南。
+
 ## 配置结构
 
 配置以 YAML 格式存储在:
@@ -59,7 +77,21 @@ Monoco 是一个开发者生产力工具包，提供:
 
 ## 最佳实践
 
+### 基础操作
+
 1. **优先使用 CLI 命令**，而不是手动编辑文件
 2. **配置更改后运行 `monoco sync`** 以更新 agent 环境
 3. **将 `.monoco/config.yaml` 提交到版本控制**，保持团队一致性
 4. **保持全局配置最小化** - 大多数设置应该是项目特定的
+
+### Git 工作流 (⚠️ CRITICAL for Agents)
+
+5. **严格遵循分支隔离**:
+   - ✅ 始终使用: `monoco issue start <ID> --branch`
+   - ❌ 禁止在 `main`/`master` 分支直接修改代码
+   - 📝 提交前运行: `monoco issue sync-files` 更新文件追踪
+
+6. **质量门禁**:
+   - Git Hooks 会自动运行检查,不要尝试绕过 (`--no-verify`)
+   - 提交前确保 `monoco issue lint` 通过
+   - 使用 `monoco issue submit` 生成交付报告

monoco/features/i18n/core.py

@@ -24,6 +24,13 @@ DEFAULT_EXCLUDES = [
     ".vscode",
     ".idea",
     ".fleet",
+    ".vscode-test",
+    ".cache",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".tox",
+    ".nox",
     # System Prompts & Agent Configs
     "AGENTS.md",
     "CLAUDE.md",
@@ -55,17 +62,16 @@ def load_gitignore_patterns(root: Path) -> List[str]:
 
 
 def is_excluded(
-    path: Path, root: Path, patterns: List[str], excludes: Optional[List[str]] = None
+    path: Path, root: Path, patterns: List[str], excludes_set: Optional[set] = None
 ) -> bool:
     """Check if a path should be excluded based on patterns and defaults."""
     rel_path = str(path.relative_to(root))
 
-    final_excludes = excludes if excludes is not None else DEFAULT_EXCLUDES
-
     # 1. Check default excludes (exact match for any path component, case-insensitive)
-    for part in path.parts:
-        if part.lower() in [e.lower() for e in final_excludes]:
-            return True
+    if excludes_set:
+        for part in path.parts:
+            if part.lower() in excludes_set:
+                return True
 
     # 2. Check gitignore patterns
     for pattern in patterns:
@@ -98,11 +104,25 @@ def discover_markdown_files(root: Path, include_issues: bool = False) -> List[Pa
     if not include_issues:
         excludes.append("Issues")
 
-    # We walk to ensure we can skip directories early if needed,
-    # but for now rglob + filter is simpler.
-    for p in root.rglob("*.md"):
-        if p.is_file() and not is_excluded(p, root, patterns, excludes=excludes):
-            all_md_files.append(p)
+    # Pre-calculate lowercase set for performance
+    excludes_set = {e.lower() for e in excludes}
+
+    # Use walk to skip excluded directories early
+    for current_root, dirs, files in root.walk():
+        # Filter directories in-place to skip excluded ones
+        dirs[:] = [
+            d
+            for d in dirs
+            if not is_excluded(
+                current_root / d, root, patterns, excludes_set=excludes_set
+            )
+        ]
+
+        for file in files:
+            if file.endswith(".md"):
+                p = current_root / file
+                if not is_excluded(p, root, patterns, excludes_set=excludes_set):
+                    all_md_files.append(p)
 
     return sorted(all_md_files)
 

monoco/features/issue/validator.py

@@ -66,7 +66,7 @@ class IssueValidator:
         diagnostics.extend(self._validate_references(meta, content, all_issue_ids))
 
         # 5.5 Domain Integrity
-        diagnostics.extend(self._validate_domains(meta, content))
+        diagnostics.extend(self._validate_domains(meta, content, all_issue_ids))
 
         # 6. Time Consistency
         diagnostics.extend(self._validate_time_consistency(meta, content))
@@ -562,7 +562,9 @@ class IssueValidator:
 
         return diagnostics
 
-    def _validate_domains(self, meta: IssueMetadata, content: str) -> List[Diagnostic]:
+    def _validate_domains(
+        self, meta: IssueMetadata, content: str, all_ids: Set[str] = set()
+    ) -> List[Diagnostic]:
         diagnostics = []
         # Check if 'domains' field exists in frontmatter text
         # We rely on text parsing because Pydantic defaults 'domains' to [] if missing.
@@ -585,15 +587,25 @@ class IssueValidator:
                     has_domains_field = True
                     break
 
+        # Governance Maturity Check
+        # Rule: If Epics > 8 or Issues > 50, enforce Domain usage
+        num_issues = len(all_ids)
+        num_epics = len(
+            [i for i in all_ids if "EPIC-" in i]
+        )  # Simple heuristic, ideally check type
+
+        is_mature = num_issues > 50 or num_epics > 8
+
         if not has_domains_field:
-            # We report it on line 0 (start of file) or line 1
-            diagnostics.append(
-                self._create_diagnostic(
-                    "Structure Error: Missing 'domains' field in frontmatter.",
-                    DiagnosticSeverity.Warning,
-                    line=0,
+            if is_mature:
+                # We report it on line 0 (start of file) or line 1
+                diagnostics.append(
+                    self._create_diagnostic(
+                        "Governance Maturity: Project scale (Epics>8 or Issues>50) requires 'domains' field in frontmatter.",
+                        DiagnosticSeverity.Warning,
+                        line=0,
+                    )
                 )
-            )
 
         return diagnostics
 

{monoco_toolkit-0.3.0.dist-info → monoco_toolkit-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: monoco-toolkit
-Version: 0.3.0
+Version: 0.3.2
 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

{monoco_toolkit-0.3.0.dist-info → monoco_toolkit-0.3.2.dist-info}/RECORD

@@ -24,10 +24,10 @@ monoco/core/agent/action.py,sha256=qkQGJERhL4N5MSuwDivn8NAw4sMhEa346huGtqNyFTM,5
 monoco/core/agent/adapters.py,sha256=q6obVcXve46mVNBaSCBRFRYs8gImv6Y2gAJVv173Z6w,4376
 monoco/core/agent/protocol.py,sha256=eB0OiMjDQu1DOoeVqb_PpHsMyPy2LdNenNyt4vJ9qbQ,798
 monoco/core/agent/state.py,sha256=Z8qqY7loms5nt3524_TrEMmlpnurxf0aHfiCT1FgvDI,3385
-monoco/core/resources/en/AGENTS.md,sha256=3TpCLNC1s_lIbDfJJBRmmROMoy9sZXu8BOag8M9NXI0,327
-monoco/core/resources/en/SKILL.md,sha256=1PrBqCgjDxT1LMSeu11BzlMhfboo_UlgZxdzBm7Tp9c,2161
-monoco/core/resources/zh/AGENTS.md,sha256=pGQOLt8mcRygJotd5oC8l9604hikQoUiS99QsHCe-UM,298
-monoco/core/resources/zh/SKILL.md,sha256=8py8tD7s23cw2srKFnTjLO_miyuGXb3NLyEbk5gchqA,1886
+monoco/core/resources/en/AGENTS.md,sha256=vf9z43UU-LPwYKPWCrtw8TpWrmkeZ6zfMyHP4Q9JqdQ,1178
+monoco/core/resources/en/SKILL.md,sha256=wBXNpPqATOxO8TGiOM8S091gMNZ8du_WhQubO6TfNyg,3504
+monoco/core/resources/zh/AGENTS.md,sha256=KBNZSCPBIals6jDdvG5wJgjZuswi_1nKljggJSMtfy8,1156
+monoco/core/resources/zh/SKILL.md,sha256=1D8_FqzDVqowZWk4Qkyx4me53NTd8qihP20gaCH6gJY,3153
 monoco/daemon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monoco/daemon/app.py,sha256=tAtLxzw_aRzU0r6Bk9lhshaCyqZRkQKUJmg5FDi7-1c,15431
 monoco/daemon/commands.py,sha256=2AGsqDZ0edg34KuAGZrTvKlJZ1fhxNXgus7vGn2km4c,1115
@@ -40,7 +40,7 @@ monoco/features/config/commands.py,sha256=i6_fKhSGLeO8RCbWrYKxelFgaHWcPiQERS2uxU
 monoco/features/i18n/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monoco/features/i18n/adapter.py,sha256=-ifDKQ7UH8tDoOdB_fSKoIrNRJROIPNuzZor2FPJVfo,932
 monoco/features/i18n/commands.py,sha256=NJ2lZRRjiTW-3UbqxhEKURdWSDxQPkfnBAUgnwoVCL8,8416
-monoco/features/i18n/core.py,sha256=MZPn6dJCj9CYy1gihHPOOgLlIlsbqwz97Dl9KpAnX-w,9188
+monoco/features/i18n/core.py,sha256=bnEV9D7KgxbC5I3l-1RN1-H8hek1loDL6KFXzmdq0pQ,9658
 monoco/features/i18n/resources/en/AGENTS.md,sha256=zzuF7BW6x8Mj6LZZmeM6wTbG5CSCDMShf4rwtN7XITg,197
 monoco/features/i18n/resources/en/SKILL.md,sha256=Z8fAAqeMvpLDw1D_9AzZIykS5-HLVM9nnlRZLWBTPqM,2203
 monoco/features/i18n/resources/zh/AGENTS.md,sha256=lKkwLLCADRH7UDq9no4eQY2sRfJrb64JoZ_HNved8vA,175
@@ -52,7 +52,7 @@ monoco/features/issue/linter.py,sha256=DQ3UruGUUMZu63EFn71eczoFDoqj31JxHHaRR3Ej6
 monoco/features/issue/migration.py,sha256=i0xlxZjrpmuHGHOAIN4iu31EwwVIvZn7yjveS-kU22c,4896
 monoco/features/issue/models.py,sha256=7oIMxvUEfe00n7wni9bZgKU2e9404flvArixbLQ95Dg,5902
 monoco/features/issue/monitor.py,sha256=vZN0TbR3V5fHKHRGkIhimO6UwWcwYjDHQs2qzjEG174,3549
-monoco/features/issue/validator.py,sha256=LC0biKkCBdeUT9fsST4_25p43xCILItFSdg8wDbz5oM,24261
+monoco/features/issue/validator.py,sha256=Rbn5M_RLEHVPi5n0Y19-VCWZvVlRWcCRFYRbsw-Oc-I,24732
 monoco/features/issue/domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monoco/features/issue/domain/lifecycle.py,sha256=oIuLYTVy1RRHGngAzbNU4kTWOHMBhjuw_TuYCwNqMJw,4991
 monoco/features/issue/domain/models.py,sha256=eo5Ks7VzWDQsqzuu9gcBuxIafvfqnzUDNDG9wbaghsc,5797
@@ -77,8 +77,8 @@ monoco/features/spike/resources/en/AGENTS.md,sha256=NG3CMnlDk_0J8hnRUcueAM9lgIQr
 monoco/features/spike/resources/en/SKILL.md,sha256=qKDcVh0D3pDRvfNLh1Bzo4oQU3obpl4tqdlzxeiWYMk,1911
 monoco/features/spike/resources/zh/AGENTS.md,sha256=5RHNl7fc3RdYYTFH483ojJl_arGPKkyYziOuGgFbqqg,290
 monoco/features/spike/resources/zh/SKILL.md,sha256=Q82e9lCQOAYIwBs5rGnvlVUDq7bp0pz8yvO10KTWFYQ,1710
-monoco_toolkit-0.3.0.dist-info/METADATA,sha256=wlJBNo4dO5EsFridU9MVpUeCxue6Bno-pbfEMWY89hc,4866
-monoco_toolkit-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-monoco_toolkit-0.3.0.dist-info/entry_points.txt,sha256=iYj7FWYBdtClU15-Du1skqD0s6SFSIhJvxJ29VWp8ng,43
-monoco_toolkit-0.3.0.dist-info/licenses/LICENSE,sha256=ACAGGjV6aod4eIlVUTx1q9PZbnZGN5bBwkSs9RHj83s,1071
-monoco_toolkit-0.3.0.dist-info/RECORD,,
+monoco_toolkit-0.3.2.dist-info/METADATA,sha256=9Xyk-ImLkR4WvBAz6eQb8_N-QZiJ7TPu27P3u48Y35c,4866
+monoco_toolkit-0.3.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+monoco_toolkit-0.3.2.dist-info/entry_points.txt,sha256=iYj7FWYBdtClU15-Du1skqD0s6SFSIhJvxJ29VWp8ng,43
+monoco_toolkit-0.3.2.dist-info/licenses/LICENSE,sha256=ACAGGjV6aod4eIlVUTx1q9PZbnZGN5bBwkSs9RHj83s,1071
+monoco_toolkit-0.3.2.dist-info/RECORD,,