opencode-collaboration 2.2.0.post2__tar.gz → 2.2.0.post3__tar.gz

{opencode_collaboration-2.2.0.post2 → opencode_collaboration-2.2.0.post3}/PKG-INFO

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

{opencode_collaboration-2.2.0.post2 → opencode_collaboration-2.2.0.post3}/opencode_collaboration.egg-info/PKG-INFO

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

{opencode_collaboration-2.2.0.post2 → opencode_collaboration-2.2.0.post3}/opencode_collaboration.egg-info/SOURCES.txt

@@ -35,6 +35,7 @@ src/core/monitor.py
 src/core/phase_advance.py
 src/core/project_manager.py
 src/core/resource_lock.py
+src/core/session_manager.py
 src/core/signoff.py
 src/core/state_machine.py
 src/core/state_manager.py
@@ -80,6 +81,7 @@ tests/test_package_completeness.py
 tests/test_phase_advance.py
 tests/test_project_manager.py
 tests/test_resource_lock.py
+tests/test_session_manager.py
 tests/test_signoff.py
 tests/test_state_machine.py
 tests/test_state_manager.py

{opencode_collaboration-2.2.0.post2 → opencode_collaboration-2.2.0.post3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opencode-collaboration"
-version = "2.2.0.post2"
+version = "2.2.0.post3"
 description = "双Agent协作框架 - 产品经理与开发的分离式协作工具"
 readme = "README.md"
 requires-python = ">=3.8"

{opencode_collaboration-2.2.0.post2 → opencode_collaboration-2.2.0.post3}/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)

opencode_collaboration-2.2.0.post3/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"
+            ))

opencode_collaboration-2.2.0.post3/tests/test_session_manager.py

@@ -0,0 +1,239 @@
+import pytest
+import tempfile
+import os
+from pathlib import Path
+
+
+def test_session_config_defaults():
+    from src.core.session_manager import SessionConfig
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        config = SessionConfig(tmpdir)
+        assert config.enabled is True
+        assert config.show_responsibilities is True
+        assert config.show_todo is True
+        assert config.show_pending is True
+
+
+def test_session_config_with_state_file():
+    from src.core.session_manager import SessionConfig
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  enabled: false\n  show_responsibilities: false\n  show_todo: true\n  show_pending: true\n")
+
+        config = SessionConfig(tmpdir)
+        assert config.enabled is False
+        assert config.show_responsibilities is False
+
+
+def test_session_config_exception_handling():
+    from src.core.session_manager import SessionConfig
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("invalid: yaml: [[[")
+
+        config = SessionConfig(tmpdir)
+        assert config.enabled is True
+
+
+def test_get_agent_info():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        info = manager.get_agent_info("agent1")
+        assert "role" in info
+        assert "responsibilities" in info
+        assert "产品经理" in info["role"]
+
+
+def test_get_agent_info_with_state():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        info = manager.get_agent_info("agent1")
+        assert info["role"] == "产品经理"
+
+
+def test_get_agent_info_unknown_agent():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        info = manager.get_agent_info("unknown_agent")
+        assert info["role"] == "未知"
+
+
+def test_get_project_info():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        info = manager.get_project_info()
+        assert "name" in info
+        assert "phase" in info
+        assert "milestone" in info
+
+
+def test_get_project_info_with_metadata():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("metadata:\n  project_name: TestProject\nproject:\n  phase: development\n")
+
+        manager = SessionManager(tmpdir)
+        info = manager.get_project_info()
+        assert info["name"] == "TestProject"
+        assert info["phase"] == "development"
+
+
+def test_get_responsibilities_text():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        text = manager.get_responsibilities_text("agent1")
+        assert "你的职责:" in text
+        assert "编写和评审需求文档" in text
+        assert "定义验收标准" in text
+
+
+def test_get_responsibilities_hidden():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  show_responsibilities: false\n")
+
+        manager = SessionManager(tmpdir)
+        text = manager.get_responsibilities_text("agent1")
+        assert text == ""
+
+
+def test_get_todo_items_empty():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        text = manager.get_todo_items()
+        assert "待办事项:" in text
+        assert "暂无" in text
+
+
+def test_get_todo_items_with_content():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  show_todo: true\n")
+
+        manager = SessionManager(tmpdir)
+        text = manager.get_todo_items()
+        assert "待办事项:" in text
+
+
+def test_get_todo_items_hidden():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  show_todo: false\n")
+
+        manager = SessionManager(tmpdir)
+        text = manager.get_todo_items()
+        assert text == ""
+
+
+def test_get_pending_issues_empty():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        text = manager.get_pending_issues()
+        assert "上次会话遗留:" in text
+        assert "无遗留问题" in text
+
+
+def test_get_pending_issues_with_content():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  show_pending: true\n")
+
+        pending_file = Path(tmpdir) / "state" / "memory" / "pending.yaml"
+        pending_file.parent.mkdir(parents=True, exist_ok=True)
+        pending_file.write_text("- description: Bug BUG-001 pending\n")
+
+        manager = SessionManager(tmpdir)
+        text = manager.get_pending_issues()
+        assert "上次会话遗留:" in text
+        assert "Bug BUG-001 pending" in text
+
+
+def test_get_pending_issues_hidden():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        state_file = Path(tmpdir) / "state" / "project_state.yaml"
+        state_file.parent.mkdir(parents=True, exist_ok=True)
+        state_file.write_text("session_start:\n  show_pending: false\n")
+
+        manager = SessionManager(tmpdir)
+        text = manager.get_pending_issues()
+        assert text == ""
+
+
+def test_get_welcome_message():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        message = manager.get_welcome_message("agent1")
+        assert "Agent 1" in message
+        assert "当前项目" in message
+        assert "当前阶段" in message
+
+
+def test_welcome_disabled():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        config_path = Path(tmpdir) / "state" / "project_state.yaml"
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+        config_path.write_text("session_start:\n  enabled: false\n")
+
+        manager = SessionManager(tmpdir)
+        message = manager.get_welcome_message("agent1")
+        assert message == ""
+
+
+def test_common_commands():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        message = manager.get_welcome_message("agent2")
+        assert "oc-collab status" in message
+        assert "oc-collab todo" in message
+
+
+def test_get_common_commands():
+    from src.core.session_manager import SessionManager
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = SessionManager(tmpdir)
+        text = manager.get_common_commands()
+        assert "常用命令:" in text
+        assert "oc-collab status" in text