opencode-collaboration 2.2.0.post1__py3-none-any.whl → 2.2.0.post3__py3-none-any.whl

{opencode_collaboration-2.2.0.post1.dist-info → opencode_collaboration-2.2.0.post3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-collaboration
-Version: 2.2.0.post1
+Version: 2.2.0.post3
 Summary: 双Agent协作框架 - 产品经理与开发的分离式协作工具
 Author-email: liuzhen <dev@opencode.ai>
 License: MIT
@@ -128,7 +128,7 @@ myproject/
 ## 详细文档
 
 完整使用指南请参见项目 GitHub 仓库：
-https://github.com/opencode/dual-agent-collaboration-system
+https://github.com/legoland01/dual-agent-collaboration-system
 
 ---
 

{opencode_collaboration-2.2.0.post1.dist-info → opencode_collaboration-2.2.0.post3.dist-info}/RECORD

@@ -2,7 +2,7 @@ src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/main.py,sha256=W_G68r7XFyioa8wHlSsdwBK1eIyWDaIQWciyZxhZHgg,15
 src/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/cli/agent.py,sha256=o8-3UpfcnUMePltpBdVBuBFMECMiKnOA7airyvi1m54,9874
-src/cli/main.py,sha256=E91PR24_r1gfKPlmtgQin2OZ-YHCck4dUe01X81FpIo,44189
+src/cli/main.py,sha256=e3lgFfCSB9qHx0GOcG3f00VSQ_e_4AfMSWg-gSGAzeY,47300
 src/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/core/agent_manager.py,sha256=Mxe4G_IfEaQ1lERdGNfMvK0tIS6DuE3WJUNOxgtAD8o,16535
 src/core/auto_doc_git.py,sha256=_yphH8tLAMq3R-yMHpc2bcmmap2p7b2So4qVmXUtCh8,1396
@@ -27,6 +27,7 @@ src/core/monitor.py,sha256=3s0xuc6l7pF4MtnRjYVxbfn8MLfKk7p7mljqtsZDQZ0,8949
 src/core/phase_advance.py,sha256=76UN8TI7RpJgRfjgV4bvs7uWlvNt-h_dz6gTDgK2zrY,11285
 src/core/project_manager.py,sha256=qayc8NHy3go26LWZgw17nL57p8LXKjpprAS1_iKZHDg,16637
 src/core/resource_lock.py,sha256=1G2yOdbqZnWqVdcIt6IKbhRLhSg23kLgJhdwiFt7jdY,13889
+src/core/session_manager.py,sha256=2Hr36C71kIPia4UYKXx8Ym86T7_9TTQxC8ZrXm65IZU,6825
 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
@@ -41,8 +42,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.2.0.post1.dist-info/METADATA,sha256=aVXyO5Cbqzqx6DLDogUlcrc5d_FaG9nHzSE7SRJ987U,3125
-opencode_collaboration-2.2.0.post1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-opencode_collaboration-2.2.0.post1.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
-opencode_collaboration-2.2.0.post1.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-opencode_collaboration-2.2.0.post1.dist-info/RECORD,,
+opencode_collaboration-2.2.0.post3.dist-info/METADATA,sha256=bwam0apvaWCByCngne2gy9fW3X1pjX_Who0Gy1LmZgc,3127
+opencode_collaboration-2.2.0.post3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+opencode_collaboration-2.2.0.post3.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
+opencode_collaboration-2.2.0.post3.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+opencode_collaboration-2.2.0.post3.dist-info/RECORD,,

src/cli/main.py

@@ -17,6 +17,7 @@ from ..core.auto_engine import AutoCollaborationEngine, TodoCommandExecutor, Wor
 from ..core.auto_retry import AutoRetry, AutoRetryConfig
 from ..core.auto_docs import AutoDocs, AutoDocsConfig
 from ..core.phase_advance import PhaseAdvanceEngine
+from ..core.session_manager import SessionManager
 from ..utils.lock import LockExistsError
 
 
@@ -123,6 +124,9 @@ def status_command():
         req_status = state_manager.get_signoff_status("requirements")
         console.print(f"需求签署 - 产品经理: {'✓' if req_status['pm_signoff'] else '✗'}, 开发: {'✓' if req_status['dev_signoff'] else '✗'}")
 
+        session_manager = SessionManager(project_path)
+        session_manager.show_welcome(active_agent)
+
     except StateFileNotFoundError:
         click.echo("错误: 未找到项目状态文件，请先初始化项目")
         sys.exit(1)
@@ -136,22 +140,33 @@ def status_command():
 
 @main.command("switch")
 @click.argument("agent_id", type=click.IntRange(1, 2))
-def switch_command(agent_id: int):
+@click.option("--welcome/--no-welcome", "-w", default=True, help="显示欢迎信息")
+def switch_command(agent_id: int, welcome: bool):
     """切换Agent角色。"""
     try:
         project_path = get_project_path()
         state_manager = StateManager(project_path)
-        
+
         current_agent = state_manager.get_active_agent()
         if current_agent == f"agent{agent_id}":
             click.echo(f"已经是 Agent {agent_id}")
             return
-        
+
         state_manager.set_active_agent(f"agent{agent_id}")
-        
-        agent_info = state_manager.load_state()["agents"][f"agent{agent_id}"]
-        click.echo(f"已切换到 Agent {agent_id} ({agent_info['role']})")
-        
+
+        if welcome:
+            session_manager = SessionManager(project_path)
+            session_manager.show_welcome(f"agent{agent_id}")
+        else:
+            try:
+                state = state_manager.load_state()
+                agents = state.get("agents", {})
+                agent_info = agents.get(f"agent{agent_id}", {})
+                role = agent_info.get("role", "未知")
+            except Exception:
+                role = "未知"
+            click.echo(f"已切换到 Agent {agent_id} ({role})")
+
     except Exception as e:
         click.echo(f"错误: {e}")
         sys.exit(1)
@@ -159,26 +174,75 @@ def switch_command(agent_id: int):
 
 @main.command("review")
 @click.argument("stage", type=click.Choice(["requirements", "design", "test"]))
+@click.option("--file", "-f", help="指定评审文件路径")
+@click.option("--checklist", "-c", is_flag=True, default=False, help="显示动态检查清单")
 @click.option("--new", is_flag=True, default=False)
 @click.option("--list", "-l", is_flag=True, default=False)
-def review_command(stage: str, new: bool, list: bool):
+def review_command(stage: str, file: str, checklist: bool, new: bool, list: bool):
     """管理评审流程。"""
     try:
         project_path = get_project_path()
         state_manager = StateManager(project_path)
         workflow_engine = WorkflowEngine(state_manager)
-        
+
+        if checklist:
+            from ..core.checklist_generator import ChecklistGenerator, CheckStatus
+
+            generator = ChecklistGenerator(project_path)
+
+            if stage == "requirements":
+                if file:
+                    doc_path = file
+                else:
+                    req_dir = Path(project_path) / "docs" / "01-requirements"
+                    doc_path = str(sorted(req_dir.glob("*.md"))[-1] if req_dir.exists() else "")
+
+                if doc_path and Path(doc_path).exists():
+                    checklist_items = generator.generate_requirements_checklist(doc_path)
+                    rendered = generator.render_checklist(checklist_items, f"{stage.upper()} 评审 Checklist")
+                    console.print(Panel(rendered, title="动态检查清单", style="green"))
+                else:
+                    click.echo("错误: 未找到需求文档")
+
+            elif stage == "design":
+                if file:
+                    doc_path = file
+                else:
+                    design_dir = Path(project_path) / "docs" / "02-design"
+                    doc_path = str(sorted(design_dir.glob("*.md"))[-1] if design_dir.exists() else "")
+
+                if doc_path and Path(doc_path).exists():
+                    checklist_items = generator.generate_design_checklist(doc_path)
+                    rendered = generator.render_checklist(checklist_items, f"{stage.upper()} 评审 Checklist")
+                    console.print(Panel(rendered, title="动态检查清单", style="green"))
+                else:
+                    click.echo("错误: 未找到设计文档")
+
+            elif stage == "test":
+                if file:
+                    doc_path = file
+                else:
+                    test_dir = Path(project_path) / "docs" / "03-test"
+                    doc_path = str(sorted(test_dir.glob("*.md"))[-1] if test_dir.exists() else "")
+
+                if doc_path and Path(doc_path).exists():
+                    checklist_items = generator.generate_test_checklist(doc_path)
+                    rendered = generator.render_checklist(checklist_items, f"{stage.upper()} 评审 Checklist")
+                    console.print(Panel(rendered, title="动态检查清单", style="green"))
+                else:
+                    click.echo("错误: 未找到测试文档")
+
         if new:
             workflow_engine.start_review(stage)
             click.echo(f"已发起 {stage} 评审")
-        
+
         if list:
             history = state_manager.get_history()
             console.print(f"\n[bold]{stage.upper()} 评审历史[/bold]")
             for item in history[:10]:
                 if "review" in item["action"] or "signoff" in item["action"]:
                     console.print(f"- {item['timestamp']}: Agent {item['agent']} - {item['details']}")
-        
+
     except Exception as e:
         click.echo(f"错误: {e}")
         sys.exit(1)

src/core/session_manager.py

@@ -0,0 +1,213 @@
+from pathlib import Path
+from typing import Optional, List
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from .state_manager import StateManager
+
+console = Console()
+
+AGENT_ROLES = {
+    "agent1": {
+        "role": "产品经理",
+        "responsibilities": [
+            "编写和评审需求文档",
+            "定义验收标准",
+            "签署需求确认",
+            "评审设计文档",
+            "评审测试报告"
+        ]
+    },
+    "agent2": {
+        "role": "开发负责人",
+        "responsibilities": [
+            "评审需求文档",
+            "编写详细设计",
+            "代码实现",
+            "编写单元测试",
+            "签署技术确认"
+        ]
+    }
+}
+
+COMMON_COMMANDS = [
+    ("oc-collab status", "查看项目状态"),
+    ("oc-collab todo", "查看待办事项"),
+    ("oc-collab review", "评审文档"),
+    ("oc-collab signoff", "签署确认"),
+    ("oc-collab history", "查看协作历史"),
+    ("oc-collab switch <1|2>", "切换Agent角色")
+]
+
+
+class SessionConfig:
+    def __init__(self, project_path: str):
+        self.project_path = project_path
+        self.enabled = True
+        self.show_responsibilities = True
+        self.show_todo = True
+        self.show_pending = True
+        self.load_config()
+
+    def load_config(self):
+        state_file = Path(self.project_path) / "state" / "project_state.yaml"
+        if state_file.exists():
+            try:
+                import yaml
+                with open(state_file) as f:
+                    state = yaml.safe_load(f) or {}
+                session_config = state.get("session_start", {})
+                self.enabled = session_config.get("enabled", True)
+                self.show_responsibilities = session_config.get("show_responsibilities", True)
+                self.show_todo = session_config.get("show_todo", True)
+                self.show_pending = session_config.get("show_pending", True)
+            except Exception:
+                pass
+
+
+class SessionManager:
+    def __init__(self, project_path: str):
+        self.project_path = project_path
+        self.state_manager = StateManager(project_path)
+        self.config = SessionConfig(project_path)
+
+    def get_project_info(self) -> dict:
+        try:
+            state = self.state_manager.load_state()
+            metadata = state.get("metadata", {})
+            project_info = state.get("project", {})
+
+            return {
+                "name": metadata.get("project_name") or project_info.get("name", "未配置"),
+                "phase": project_info.get("phase") or state.get("phase", "未知"),
+                "milestone": state.get("current_milestone", "待定义")
+            }
+        except Exception:
+            return {"name": "未配置", "phase": "未知", "milestone": "待定义"}
+
+    def get_agent_info(self, agent_id: str) -> dict:
+        agent_config = AGENT_ROLES.get(agent_id, {
+            "role": "未知",
+            "responsibilities": []
+        })
+
+        try:
+            state = self.state_manager.load_state()
+            agents = state.get("agents", {})
+            agent_state = agents.get(agent_id, {})
+        except KeyError:
+            agent_state = {}
+        except Exception:
+            agent_state = {}
+
+        return {
+            "id": agent_id,
+            "role": agent_config["role"],
+            "current_task": agent_state.get("current_task", ""),
+            "responsibilities": agent_config["responsibilities"]
+        }
+
+    def get_responsibilities_text(self, agent_id: str) -> str:
+        agent = self.get_agent_info(agent_id)
+        if not self.config.show_responsibilities:
+            return ""
+
+        lines = ["你的职责:"]
+        for resp in agent["responsibilities"]:
+            lines.append(f"  - {resp}")
+        return "\n".join(lines)
+
+    def get_todo_items(self) -> str:
+        if not self.config.show_todo:
+            return ""
+
+        try:
+            from .auto_engine import TodoCommandExecutor
+            executor = TodoCommandExecutor(self.project_path)
+            todo_list = executor.get_todo_list()
+
+            if not todo_list:
+                return "待办事项:\n  暂无待办事项"
+
+            lines = ["待办事项:"]
+            for item in todo_list[:5]:
+                task = item.get("task", "")
+                lines.append(f"  [ ] {task}")
+            return "\n".join(lines)
+        except Exception:
+            return "待办事项:\n  暂无待办事项"
+
+    def get_pending_issues(self) -> str:
+        if not self.config.show_pending:
+            return ""
+
+        pending_file = Path(self.project_path) / "state" / "memory" / "pending.yaml"
+        if not pending_file.exists():
+            return "上次会话遗留:\n  无遗留问题"
+
+        try:
+            import yaml
+            with open(pending_file) as f:
+                pending = yaml.safe_load(f) or []
+
+            if not pending:
+                return "上次会话遗留:\n  无遗留问题"
+
+            lines = ["上次会话遗留:"]
+            for item in pending[:5]:
+                desc = item.get("description", item)
+                lines.append(f"  - {desc}")
+            return "\n".join(lines)
+        except Exception:
+            return "上次会话遗留:\n  无遗留问题"
+
+    def get_common_commands(self) -> str:
+        lines = ["常用命令:"]
+        for cmd, desc in COMMON_COMMANDS:
+            lines.append(f"  - {cmd}: {desc}")
+        return "\n".join(lines)
+
+    def get_welcome_message(self, agent_id: str) -> str:
+        if not self.config.enabled:
+            return ""
+
+        project = self.get_project_info()
+        agent = self.get_agent_info(agent_id)
+
+        parts = [
+            f"=== Agent {agent_id.replace('agent', '')} ({agent['role']}) ===",
+            "",
+            f"当前项目: {project['name']}",
+            f"当前阶段: {project['phase']}",
+            f"当前里程碑: {project['milestone']}",
+            ""
+        ]
+
+        resp_text = self.get_responsibilities_text(agent_id)
+        if resp_text:
+            parts.append(resp_text)
+            parts.append("")
+
+        todo_text = self.get_todo_items()
+        if todo_text:
+            parts.append(todo_text)
+            parts.append("")
+
+        pending_text = self.get_pending_issues()
+        if pending_text:
+            parts.append(pending_text)
+            parts.append("")
+
+        parts.append(self.get_common_commands())
+
+        return "\n".join(parts)
+
+    def show_welcome(self, agent_id: str):
+        message = self.get_welcome_message(agent_id)
+        if message:
+            console.print(Panel(
+                Text(message, justify="left"),
+                title="会话引导",
+                style="blue"
+            ))