opencode-collaboration 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

{opencode_collaboration-2.0.0.dist-info → opencode_collaboration-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-collaboration
-Version: 2.0.0
+Version: 2.1.0
 Summary: 双Agent协作框架 - 产品经理与开发的分离式协作工具
 Author-email: OpenCode <dev@opencode.ai>
 License: MIT

{opencode_collaboration-2.0.0.dist-info → opencode_collaboration-2.1.0.dist-info}/RECORD

@@ -10,16 +10,24 @@ src/core/auto_engine.py,sha256=bV9VXa0naPpxKuE7p7xHAZKZJe9DIGfzrFwHhiaDHKA,16031
 src/core/auto_git_sync.py,sha256=jklR_NOYBXYgRSdG0rMRgvQM3jvRBpvm-qSjc-vDK28,2077
 src/core/auto_retry.py,sha256=qG4UY2d312PoECJKKuIq3qspe6qP1mTMEQ4M2Y9J1oo,7571
 src/core/brain_engine.py,sha256=OJliBiMIxMwTCyEMJW0Os9SRpB5mCf3ujCnvjFVbLcg,14893
+src/core/config_reloader.py,sha256=Fne2FJ-AgPNnqV7Ody-nRpLOSptde65ZXqyGoFl-PbE,8726
 src/core/daemon.py,sha256=pu776YVEC-dw4mKFh7JZg4q7R6XGPe52wiQtwnsQxb4,6470
+src/core/design_review_notifier.py,sha256=XlWyPXUZ7V4CeWdvgf92QBqbrSvO_VzBW7VhUWmlRqk,9826
 src/core/detector.py,sha256=kSVqZ2EQXKTNByC4sOOAeIS6vdgvnwizLah13MRk54E,2328
 src/core/doc_generator.py,sha256=mwK22Pc9OJ4Mr6ZoLl1ATx4c2ZrhZLny_kCQk5mwfS4,15878
-src/core/exception_handler.py,sha256=nXrNsUoJJsQZa9TgavVVakhwQ7eh9wxjFuUpoucS7ZI,17395
+src/core/error_templates.py,sha256=kHOTVMCGUeT53jwKYGQwPHuKZLyr7znVyzzxZfKAC6Y,7467
+src/core/exception_handler.py,sha256=Yd-crydhgIRcEPnE68yXMyqDzrTRPI9_OtsICaOFbSM,24078
 src/core/git.py,sha256=guy7aE9FX4w62HQ-Wf_N3jzu_rn8JfVFLf8-Ulz-5k8,8928
 src/core/git_monitor.py,sha256=PFZxq_KodaI6zcO67-40h2vid6zdSpr3bGVZiF2fEsA,15009
+src/core/git_workflow_enforcer.py,sha256=0B-xMX4T9bvyuulgqrgOlRYYwi7Vr32apjGz-9NVK00,11583
+src/core/iteration_status_manager.py,sha256=ckPsJK_brsP_NSXtBLLlNrn5DqvmxvEGsE_VqjHOPJ8,9916
+src/core/monitor.py,sha256=3s0xuc6l7pF4MtnRjYVxbfn8MLfKk7p7mljqtsZDQZ0,8949
 src/core/phase_advance.py,sha256=76UN8TI7RpJgRfjgV4bvs7uWlvNt-h_dz6gTDgK2zrY,11285
 src/core/signoff.py,sha256=fG6KFNz3AYh6hKYMPfognU_SBs5amCW2q4bne4huFf0,6643
 src/core/state_machine.py,sha256=L1gfdsYC6mlWcHP5RwQQen8vCTwV2spIP-Ktwz4gux8,14919
 src/core/state_manager.py,sha256=jkgci5q71DRjmKe8igeFhOTxHJ2xqNjAHJo6THFtw_M,16672
+src/core/state_migrator.py,sha256=OYXtwxA_ePFAS_XqOMhKR2fyU1werLePbqCyNZg8eXQ,13746
+src/core/state_validator.py,sha256=Q86jbEO0fNdzDi3zIPB_G_ibQ0QWyXFYV_rPj6Eakjw,18827
 src/core/supervisor.py,sha256=pT_5CkimpFgB_gyqzsUL-25l3MsRGP1TWFEnHdGJtwo,7290
 src/core/task_executor.py,sha256=xcM9sNu8MyAVqlNvtc2GL4eiYeTMmeduTrrA3j292aM,23720
 src/core/workflow.py,sha256=LpH9g6xbtCmYOhhCSxpcstRR7TptN8e6b0mEag3UcW4,5634
@@ -28,8 +36,8 @@ src/utils/date.py,sha256=iWS0hTaoDE2iC0jJb3lTIB5yK5xxRbrC1C98Fgb8LFc,577
 src/utils/file.py,sha256=5IFKkT2m1emJUHDzIiLsa4YG9GCqOhhmiLvc6aVY9-Y,1301
 src/utils/lock.py,sha256=soxYFsBKJHUzN-_QXkorVfgnmt0D5p1SZtqwPNqcWPI,2880
 src/utils/yaml.py,sha256=zcbh0OP7NOqxTexEAR3akQkllUh8xeKt42O2CHIImyg,777
-opencode_collaboration-2.0.0.dist-info/METADATA,sha256=vjjQFCc5AdQX5jBYL7zSuBV-LtJYXOYGjyNoOTmR_MA,3145
-opencode_collaboration-2.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-opencode_collaboration-2.0.0.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
-opencode_collaboration-2.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-opencode_collaboration-2.0.0.dist-info/RECORD,,
+opencode_collaboration-2.1.0.dist-info/METADATA,sha256=S0iMP93dKx2xMA5c-PkSrZ6rAW1btFTuHHOJBdLIeyI,3145
+opencode_collaboration-2.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+opencode_collaboration-2.1.0.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
+opencode_collaboration-2.1.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+opencode_collaboration-2.1.0.dist-info/RECORD,,

src/core/config_reloader.py

@@ -0,0 +1,257 @@
+"""配置热重载模块。
+
+功能：
+1. 监控配置文件变化
+2. 自动重新加载配置
+3. 配置验证和回滚
+"""
+import time
+import logging
+import threading
+from pathlib import Path
+from typing import Dict, Any, Optional, Callable
+import yaml
+
+
+logger = logging.getLogger(__name__)
+
+
+class ConfigReloadError(Exception):
+    """配置重载错误。"""
+    pass
+
+
+class ConfigValidationError(ConfigReloadError):
+    """配置验证错误。"""
+    pass
+
+
+class ConfigReloader:
+    """配置热重载器。"""
+    
+    def __init__(
+        self,
+        config_paths: Dict[str, str],
+        reload_callback: Callable[[str, Dict], None] = None,
+        validation_schema: Optional[Dict] = None
+    ):
+        """初始化。
+        
+        Args:
+            config_paths: 配置路径映射 {name: path}
+            reload_callback: 重载回调函数 (config_name, config_data)
+            validation_schema: 配置验证 schema
+        """
+        self.config_paths = config_paths
+        self.reload_callback = reload_callback
+        self.validation_schema = validation_schema
+        self.configs: Dict[str, Dict] = {}
+        self.mtimes: Dict[str, float] = {}
+        self._stop_event = threading.Event()
+        self._monitor_thread: Optional[threading.Thread] = None
+        self._last_check: float = 0
+    
+    def load_all(self) -> Dict[str, Dict]:
+        """加载所有配置文件。"""
+        for name, path in self.config_paths.items():
+            self.configs[name] = self._load_config(path)
+            self.mtimes[name] = Path(path).stat().st_mtime
+        
+        logger.info(f"已加载 {len(self.configs)} 个配置文件: {list(self.configs.keys())}")
+        return self.configs
+    
+    def get(self, config_name: str) -> Optional[Dict]:
+        """获取指定配置。"""
+        return self.configs.get(config_name)
+    
+    def _load_config(self, path: str) -> Dict:
+        """加载单个配置文件。"""
+        try:
+            with open(path, 'r', encoding='utf-8') as f:
+                return yaml.safe_load(f) or {}
+        except (IOError, yaml.YAMLError) as e:
+            logger.error(f"加载配置文件失败: {path}, {e}")
+            raise ConfigReloadError(f"加载配置文件失败: {path}")
+    
+    def _validate_config(self, config: Dict, config_name: str) -> bool:
+        """验证配置。"""
+        if self.validation_schema and config_name in self.validation_schema:
+            schema = self.validation_schema[config_name]
+            required_fields = schema.get("required", [])
+            for field in required_fields:
+                if field not in config:
+                    logger.error(f"配置验证失败: 缺少必要字段 {field}")
+                    return False
+        return True
+    
+    def start_monitoring(self, interval: int = 60):
+        """开始监控配置变化。
+        
+        Args:
+            interval: 检查间隔（秒），默认 60 秒
+        """
+        if self._monitor_thread is not None and self._monitor_thread.is_alive():
+            logger.warning("监控已在运行")
+            return
+        
+        self._stop_event.clear()
+        self._monitor_thread = threading.Thread(
+            target=self._monitor_loop,
+            args=(interval,),
+            daemon=True
+        )
+        self._monitor_thread.start()
+        logger.info(f"配置监控已启动，间隔 {interval} 秒")
+    
+    def stop_monitoring(self):
+        """停止监控。"""
+        self._stop_event.set()
+        if self._monitor_thread is not None:
+            self._monitor_thread.join(timeout=5)
+            self._monitor_thread = None
+        logger.info("配置监控已停止")
+    
+    def _monitor_loop(self, interval: int):
+        """监控循环。"""
+        while not self._stop_event.is_set():
+            try:
+                self._check_changes()
+            except Exception as e:
+                logger.error(f"配置检查失败: {e}")
+            
+            self._stop_event.wait(timeout=interval)
+    
+    def _check_changes(self):
+        """检查配置变化。"""
+        for name, path in self.config_paths.items():
+            try:
+                current_mtime = Path(path).stat().st_mtime
+                
+                if current_mtime > self.mtimes[name]:
+                    logger.info(f"检测到配置变化: {name}")
+                    
+                    new_config = self._load_config(path)
+                    
+                    if self._validate_config(new_config, name):
+                        old_config = self.configs[name]
+                        self.configs[name] = new_config
+                        self.mtimes[name] = current_mtime
+                        
+                        if self.reload_callback:
+                            self.reload_callback(name, new_config)
+                        
+                        logger.info(f"配置已重新加载: {name}")
+                    else:
+                        logger.error(f"配置验证失败: {name}")
+                        
+            except Exception as e:
+                logger.error(f"检查配置变化失败 {name}: {e}")
+    
+    def reload_config(self, config_name: str) -> bool:
+        """手动重新加载指定配置。"""
+        if config_name not in self.config_paths:
+            logger.error(f"未知配置: {config_name}")
+            return False
+        
+        try:
+            path = self.config_paths[config_name]
+            new_config = self._load_config(path)
+            
+            if self._validate_config(new_config, config_name):
+                self.configs[config_name] = new_config
+                self.mtimes[config_name] = Path(path).stat().st_mtime
+                
+                if self.reload_callback:
+                    self.reload_callback(config_name, new_config)
+                
+                logger.info(f"配置已重新加载: {config_name}")
+                return True
+            else:
+                logger.error(f"配置验证失败: {config_name}")
+                return False
+                
+        except Exception as e:
+            logger.error(f"重新加载配置失败: {config_name}, {e}")
+            return False
+    
+    def add_config(self, name: str, path: str):
+        """添加新配置。"""
+        if name in self.config_paths:
+            logger.warning(f"配置已存在，将被覆盖: {name}")
+        
+        self.config_paths[name] = path
+        config = self._load_config(path)
+        self.configs[name] = config
+        self.mtimes[name] = Path(path).stat().st_mtime
+        logger.info(f"已添加配置: {name}")
+    
+    def remove_config(self, name: str):
+        """移除配置。"""
+        if name in self.config_paths:
+            del self.config_paths[name]
+            self.configs.pop(name, None)
+            self.mtimes.pop(name, None)
+            logger.info(f"已移除配置: {name}")
+    
+    def get_status(self) -> Dict:
+        """获取状态。"""
+        return {
+            "monitoring": self._monitor_thread is not None and self._monitor_thread.is_alive(),
+            "configs": list(self.configs.keys()),
+            "config_count": len(self.configs)
+        }
+
+
+class ConfigManager:
+    """配置管理器（简化版，无需监控）。"""
+    
+    def __init__(self, config_path: str):
+        """初始化。
+        
+        Args:
+            config_path: 配置文件路径
+        """
+        self.config_path = Path(config_path)
+        self.config = self._load()
+    
+    def _load(self) -> Dict:
+        """加载配置。"""
+        if self.config_path.exists():
+            with open(self.config_path, 'r', encoding='utf-8') as f:
+                return yaml.safe_load(f) or {}
+        return {}
+    
+    def get(self, key: str, default: Any = None) -> Any:
+        """获取配置值。"""
+        return self.config.get(key, default)
+    
+    def set(self, key: str, value: Any):
+        """设置配置值。"""
+        self.config[key] = value
+    
+    def save(self):
+        """保存配置。"""
+        with open(self.config_path, 'w', encoding='utf-8') as f:
+            yaml.dump(self.config, f, allow_unicode=True, sort_keys=False)
+    
+    def reload(self):
+        """重新加载配置。"""
+        self.config = self._load()
+
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    
+    reloader = ConfigReloader(
+        config_paths={
+            "project": "state/project_state.yaml",
+            "settings": "config/settings.yaml"
+        }
+    )
+    
+    print("加载配置:")
+    configs = reloader.load_all()
+    print(f"  {list(configs.keys())}")
+    
+    print("\n状态:")
+    print(f"  {reloader.get_status()}")

src/core/design_review_notifier.py

@@ -0,0 +1,303 @@
+"""设计评审通知模块。
+
+功能：
+1. 评审完成后自动通知相关 Agent
+2. 需求变更时通知相关 Agent
+3. 签署完成时通知
+"""
+import logging
+from typing import Dict, List, Optional
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from pathlib import Path
+
+
+logger = logging.getLogger(__name__)
+
+
+class NotificationType(Enum):
+    """通知类型。"""
+    DESIGN_REVIEW_COMPLETE = "design_review_complete"
+    REQUIREMENT_CHANGED = "requirement_changed"
+    SIGNOFF_COMPLETE = "signoff_complete"
+    PHASE_ADVANCE = "phase_advance"
+    GENERAL = "general"
+
+
+class NotificationPriority(Enum):
+    """通知优先级。"""
+    LOW = "low"
+    NORMAL = "normal"
+    HIGH = "high"
+    URGENT = "urgent"
+
+
+@dataclass
+class Notification:
+    """通知。"""
+    type: NotificationType
+    title: str
+    message: str
+    sender: str
+    recipients: List[str]
+    timestamp: datetime = field(default_factory=datetime.now)
+    priority: NotificationPriority = NotificationPriority.NORMAL
+    action_required: bool = False
+    action_url: str = ""
+    
+    def to_dict(self) -> Dict:
+        return {
+            "type": self.type.value,
+            "title": self.title,
+            "message": self.message,
+            "sender": self.sender,
+            "recipients": self.recipients,
+            "timestamp": self.timestamp.isoformat(),
+            "priority": self.priority.value,
+            "action_required": self.action_required,
+            "action_url": self.action_url
+        }
+
+
+class DesignReviewNotifier:
+    """设计评审通知器。"""
+    
+    def __init__(self, project_path: str = "."):
+        """初始化。
+        
+        Args:
+            project_path: 项目路径
+        """
+        self.project_path = Path(project_path)
+        self.notification_log: List[Dict] = []
+        self.notification_file = self.project_path / "state" / "notifications.yaml"
+    
+    def _get_other_agent(self, agent_id: str) -> str:
+        """获取另一个 Agent ID。"""
+        return "agent1" if agent_id == "agent2" else "agent2"
+    
+    def _send_notification(self, notification: Notification):
+        """发送通知。"""
+        self.notification_log.append(notification.to_dict())
+        
+        logger.info(
+            f"通知已发送 - 类型: {notification.type.value}, "
+            f"发送给: {notification.recipients}, "
+            f"标题: {notification.title}"
+        )
+        
+        self._save_notification(notification)
+    
+    def _save_notification(self, notification: Notification):
+        """保存通知到文件。"""
+        notifications = self._load_notifications()
+        notifications.append(notification.to_dict())
+        
+        try:
+            import yaml
+            with open(self.notification_file, 'w', encoding='utf-8') as f:
+                yaml.dump(notifications, f, allow_unicode=True, sort_keys=False)
+        except IOError as e:
+            logger.error(f"保存通知失败: {e}")
+    
+    def _load_notifications(self) -> List[Dict]:
+        """加载通知历史。"""
+        if self.notification_file.exists():
+            try:
+                import yaml
+                with open(self.notification_file, 'r', encoding='utf-8') as f:
+                    return yaml.safe_load(f) or []
+            except (IOError, yaml.YAMLError):
+                pass
+        return []
+    
+    def notify_design_review_complete(self, reviewer: str, version: str):
+        """通知设计评审完成。
+        
+        Args:
+            reviewer: 评审人 ID
+            version: 设计版本
+        """
+        notification = Notification(
+            type=NotificationType.DESIGN_REVIEW_COMPLETE,
+            title="设计评审完成",
+            message=f"Agent {reviewer} 已完成 v{version} 详细设计的评审。",
+            sender=reviewer,
+            recipients=[self._get_other_agent(reviewer)],
+            action_required=True,
+            action_url="docs/02-design/detailed_design_v2.1.0.md"
+        )
+        
+        self._send_notification(notification)
+    
+    def notify_requirement_changed(self, changer: str, section: str):
+        """通知需求变更。
+        
+        Args:
+            changer: 变更人 ID
+            section: 变更的章节
+        """
+        notification = Notification(
+            type=NotificationType.REQUIREMENT_CHANGED,
+            title="需求文档更新",
+            message=f"Agent {changer} 更新了需求文档的 {section} 章节。",
+            sender=changer,
+            recipients=[self._get_other_agent(changer)],
+            action_required=True,
+            action_url="docs/01-requirements/requirements_v2.1.0.md"
+        )
+        
+        self._send_notification(notification)
+    
+    def notify_signoff_complete(self, signer: str, stage: str):
+        """通知签署完成。
+        
+        Args:
+            signer: 签署人 ID
+            stage: 签署的阶段
+        """
+        notification = Notification(
+            type=NotificationType.SIGNOFF_COMPLETE,
+            title=f"{stage} 阶段签署",
+            message=f"Agent {signer} 已签署 {stage} 阶段。",
+            sender=signer,
+            recipients=[self._get_other_agent(signer)],
+            action_required=False
+        )
+        
+        self._send_notification(notification)
+    
+    def notify_phase_advance(self, actor: str, from_phase: str, to_phase: str):
+        """通知阶段推进。
+        
+        Args:
+            actor: 操作人 ID
+            from_phase: 原始阶段
+            to_phase: 目标阶段
+        """
+        notification = Notification(
+            type=NotificationType.PHASE_ADVANCE,
+            title="阶段推进",
+            message=f"Agent {actor} 已将项目从 {from_phase} 推进到 {to_phase}。",
+            sender=actor,
+            recipients=[self._get_other_agent(actor)],
+            action_required=False
+        )
+        
+        self._send_notification(notification)
+    
+    def notify_general(self, title: str, message: str, sender: str, priority: NotificationPriority = NotificationPriority.NORMAL):
+        """发送一般通知。
+        
+        Args:
+            title: 通知标题
+            message: 通知内容
+            sender: 发送人 ID
+            priority: 优先级
+        """
+        notification = Notification(
+            type=NotificationType.GENERAL,
+            title=title,
+            message=message,
+            sender=sender,
+            recipients=[self._get_other_agent(sender)],
+            priority=priority
+        )
+        
+        self._send_notification(notification)
+    
+    def get_notifications(self, agent_id: str = None, limit: int = 10) -> List[Dict]:
+        """获取通知历史。
+        
+        Args:
+            agent_id: 筛选特定 Agent 的通知
+            limit: 返回数量限制
+            
+        Returns:
+            通知列表
+        """
+        notifications = self._load_notifications()
+        
+        if agent_id:
+            notifications = [
+                n for n in notifications
+                if agent_id in n.get("recipients", []) or n.get("sender") == agent_id
+            ]
+        
+        return notifications[-limit:]
+    
+    def get_unread_count(self, agent_id: str) -> int:
+        """获取未读通知数量。"""
+        notifications = self._load_notifications()
+        return len([
+            n for n in notifications
+            if agent_id in n.get("recipients", []) and n.get("priority") in ["high", "urgent"]
+        ])
+    
+    def clear_notifications(self, before_date: datetime = None) -> int:
+        """清理旧通知。
+        
+        Args:
+            before_date: 清理此日期之前的通知
+            
+        Returns:
+            清理的通知数量
+        """
+        notifications = self._load_notifications()
+        cutoff = before_date or datetime.now()
+        
+        original_count = len(notifications)
+        notifications = [
+            n for n in notifications
+            if datetime.fromisoformat(n["timestamp"]) > cutoff
+        ]
+        
+        if len(notifications) < original_count:
+            try:
+                import yaml
+                with open(self.notification_file, 'w', encoding='utf-8') as f:
+                    yaml.dump(notifications, f, allow_unicode=True, sort_keys=False)
+            except IOError as e:
+                logger.error(f"保存通知失败: {e}")
+        
+        return original_count - len(notifications)
+    
+    def get_notification_summary(self) -> Dict:
+        """获取通知摘要。"""
+        notifications = self._load_notifications()
+        
+        by_type = {}
+        by_priority = {}
+        
+        for n in notifications:
+            n_type = n.get("type", "unknown")
+            n_priority = n.get("priority", "normal")
+            by_type[n_type] = by_type.get(n_type, 0) + 1
+            by_priority[n_priority] = by_priority.get(n_priority, 0) + 1
+        
+        return {
+            "total": len(notifications),
+            "by_type": by_type,
+            "by_priority": by_priority,
+            "action_required": len([n for n in notifications if n.get("action_required")])
+        }
+
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    
+    notifier = DesignReviewNotifier(".")
+    
+    print("发送测试通知:")
+    
+    notifier.notify_design_review_complete("agent1", "2.1.0")
+    notifier.notify_signoff_complete("agent2", "requirements")
+    notifier.notify_phase_advance("agent1", "requirements", "design")
+    
+    print("\n通知摘要:")
+    print(notifier.get_notification_summary())
+    
+    print("\n通知历史:")
+    for n in notifier.get_notifications():
+        print(f"  [{n['type']}] {n['title']}")