monoco-toolkit 0.3.5__py3-none-any.whl → 0.3.9__py3-none-any.whl

monoco/features/{scheduler → agent}/session.py

@@ -1,7 +1,11 @@
 from datetime import datetime
 from typing import Optional
-from pydantic import BaseModel, Field
+from pathlib import Path
+from pydantic import BaseModel, Field, ConfigDict
+
 from .worker import Worker
+from monoco.core.hooks import HookContext, HookRegistry, get_registry
+from monoco.core.config import find_monoco_root
 
 
 class Session(BaseModel):
@@ -10,6 +14,8 @@ class Session(BaseModel):
     Persisted state of the session.
     """
 
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
     id: str = Field(..., description="Unique session ID (likely UUID)")
     issue_id: str = Field(..., description="The Issue ID this session is working on")
     role_name: str = Field(..., description="Name of the role employed")
@@ -24,18 +30,27 @@ class Session(BaseModel):
     # History could be a list of logs or pointers to git commits
     # For now, let's keep it simple. The git log IS the history.
 
-    class Config:
-        arbitrary_types_allowed = True
-
 
 class RuntimeSession:
     """
     The in-memory wrapper around the Session model and the active Worker.
     """
 
-    def __init__(self, session_model: Session, worker: Worker):
+    def __init__(
+        self, 
+        session_model: Session, 
+        worker: Worker,
+        hook_registry: Optional[HookRegistry] = None,
+        project_root: Optional[Path] = None,
+    ):
         self.model = session_model
         self.worker = worker
+        self.hook_registry = hook_registry or get_registry()
+        self.project_root = project_root or find_monoco_root()
+
+    def _create_hook_context(self) -> HookContext:
+        """Create a HookContext from the current session state."""
+        return HookContext.from_runtime_session(self, self.project_root)
 
     def start(self, context: Optional[dict] = None):
         print(
@@ -46,6 +61,10 @@ class RuntimeSession:
         self.model.updated_at = datetime.now()
 
         try:
+            # Execute on_session_start hooks
+            hook_context = self._create_hook_context()
+            self.hook_registry.execute_on_session_start(hook_context)
+            
             self.worker.start(context)
             # Async mode: we assume it started running.
             # Use poll or refresh_status to check later.
@@ -82,6 +101,21 @@ class RuntimeSession:
 
     def terminate(self):
         print(f"Session {self.model.id}: Terminating")
+        
+        # Execute on_session_end hooks before stopping worker
+        # This allows hooks to perform cleanup while session context is still valid
+        try:
+            hook_context = self._create_hook_context()
+            results = self.hook_registry.execute_on_session_end(hook_context)
+            
+            # Log hook results
+            for result in results:
+                if result.status == "failure":
+                    print(f"  Hook warning: {result.message}")
+        except Exception as e:
+            # Don't let hook errors prevent session termination
+            print(f"  Hook execution error: {e}")
+        
         self.worker.stop()
         self.model.status = "terminated"
         self.model.updated_at = datetime.now()

monoco/features/{scheduler → agent}/worker.py

@@ -38,8 +38,8 @@ class Worker:
         import sys
 
         # Prepare the prompt
-        # We treat 'crafter' as a drafter when context is provided (Draft Mode)
-        if (self.role.name == "drafter" or self.role.name == "crafter") and context:
+        # We treat 'Planner' as a drafter when context is provided (Draft Mode)
+        if (self.role.name == "drafter" or self.role.name == "Planner") and context:
             issue_type = context.get("type", "feature")
             description = context.get("description", "No description")
             prompt = (

monoco/features/i18n/resources/skills/i18n_scan_workflow/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: i18n-scan-workflow
+description: I18n 扫描工作流 (Flow Skill)。定义从扫描缺失翻译到生成翻译任务的标准操作流程，确保多语言文档质量。
+type: flow
+domain: i18n
+version: 1.0.0
+---
+
+# I18n Scan Workflow
+
+I18n 扫描的标准化工作流，确保 "Scan → Identify → Generate Tasks" 流程。
+
+## 工作流状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> Scan: 触发扫描
+    
+    Scan --> Identify: 扫描完成
+    Scan --> Scan: 配置错误<br/>(修复配置)
+    
+    Identify --> GenerateTasks: 发现缺失
+    Identify --> [*]: 无缺失<br/>(完成)
+    
+    GenerateTasks --> [*]: 任务生成完成
+```
+
+## 执行步骤
+
+### 1. Scan (扫描)
+
+- **目标**: 扫描项目中所有文档，识别翻译覆盖情况
+- **输入**: 项目文件、i18n 配置
+- **输出**: 扫描报告
+- **检查点**:
+  - [ ] 检查 `.monoco/config.yaml` 中的 i18n 配置
+  - [ ] 运行 `monoco i18n scan`
+  - [ ] 确认源语言和目标语言设置正确
+  - [ ] 验证排除规则（.gitignore、build 目录等）
+
+### 2. Identify (识别缺失)
+
+- **目标**: 分析扫描结果，识别具体缺失的翻译
+- **策略**: 对比源文件和目标文件
+- **检查点**:
+  - [ ] 列出所有缺失翻译的源文件
+  - [ ] 识别缺失的目标语言
+  - [ ] 评估缺失翻译的影响范围
+  - [ ] 按优先级排序（核心文档优先）
+
+### 3. Generate Tasks (生成任务)
+
+- **目标**: 为缺失的翻译创建追踪任务
+- **策略**: 根据缺失情况创建 Issue 或备忘录
+- **检查点**:
+  - [ ] 为核心文档缺失创建 Feature Issue
+  - [ ] 为次要文档缺失创建 Memo 提醒
+  - [ ] 在 Issue 中标注需要翻译的文件路径
+  - [ ] 设置合理的优先级和截止日期
+
+## 决策分支
+
+| 条件 | 动作 |
+|------|------|
+| 配置错误 | 修复 `.monoco/config.yaml`，重新扫描 |
+| 无缺失翻译 | 流程完成，无需进一步操作 |
+| 大量缺失 | 创建 Epic，拆分为多个 Feature |
+| 关键文档缺失 | 高优先级，立即创建 Issue |
+
+## 合规要求
+
+- **必须**: 扫描前验证 i18n 配置正确
+- **必须**: 所有核心文档必须有对应翻译
+- **建议**: 定期运行扫描（如每周）
+- **建议**: 将翻译任务与功能开发绑定
+
+## 相关命令
+
+```bash
+# 扫描缺失翻译
+monoco i18n scan
+
+# 创建翻译任务
+monoco issue create feature -t "翻译 {filename} 到 {lang}"
+
+# 添加备忘录
+monoco memo add "需要翻译: {filepath}"
+```
+
+## 输出示例
+
+扫描完成后，应生成如下报告：
+
+```
+I18n Scan Report
+================
+Source Language: en
+Target Languages: zh, ja
+
+Missing Translations:
+- docs/guide.md → zh/guide.md [MISSING]
+- docs/api.md → ja/api.md [MISSING]
+
+Coverage: 85%
+```