pactkit-opencode 0.1.0__tar.gz

pactkit_opencode-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: pactkit-opencode
+Version: 0.1.0
+Summary: PactKit adapter for OpenCode IDE
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: pactkit>=2.5.0

pactkit_opencode-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pactkit-opencode"
+version = "0.1.0"
+description = "PactKit adapter for OpenCode IDE"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "pactkit>=2.5.0",
+]
+
+[project.entry-points."pactkit.deployers"]
+opencode = "pactkit_opencode:OpenCodeDeployer"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src", "../pactkit/src"]

pactkit_opencode-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pactkit_opencode-0.1.0/src/pactkit_opencode/__init__.py

@@ -0,0 +1,8 @@
+"""PactKit adapter for OpenCode IDE.
+
+Auto-registers OpenCodeDeployer via entry_points when imported.
+"""
+
+from pactkit_opencode.deployer import OpenCodeDeployer
+
+__all__ = ["OpenCodeDeployer"]

pactkit_opencode-0.1.0/src/pactkit_opencode/deployer.py

@@ -0,0 +1,306 @@
+"""OpenCode deployer — generates OpenCode-native configuration.
+
+Extracted from pactkit core (STORY-slim-058).
+"""
+
+import json
+from pathlib import Path
+
+from pactkit import __version__, prompts
+from pactkit.config import (
+    VALID_AGENTS,
+    VALID_COMMANDS,
+    VALID_RULES,
+    VALID_SKILLS,
+    auto_merge_config_file,
+    load_config,
+)
+from pactkit.generators.deploy_base import DeployerBase, register_deployer
+from pactkit.generators.deployer import (
+    _cleanup_legacy,
+    _deploy_agents,
+    _deploy_ci,
+    _deploy_commands,
+    _deploy_rules,
+    _deploy_skills,
+)
+from pactkit.profiles import get_profile
+from pactkit.utils import atomic_write
+
+
+class OpenCodeDeployer(DeployerBase):
+    """OpenCode deployment — generate OpenCode-native configuration (STORY-069).
+
+    OpenCode (anomalyco/opencode) is an open-source AI coding assistant that supports
+    multiple LLM providers. This deployment mode generates OpenCode-native files:
+    - AGENTS.md (slim header — rules loaded via instructions)
+    - rules/ directory with modular rule files (STORY-071 R6)
+    - opencode.json (global config with instructions: ["rules/*.md"])
+    - agents/, commands/, skills/ directories
+
+    STORY-slim-008: Aligned with _deploy_classic() feature set:
+    - Reads pactkit.yaml for selective deployment (R1)
+    - Calls auto_merge_config_file() for automatic config updates (R2)
+    - Calls _cleanup_legacy() to remove stale skill files (R3)
+    - Generates project-level AGENTS.md when not in preview mode (R4)
+    - Prints MCP server recommendations (R5)
+    """
+
+    profile = get_profile("opencode")
+
+    def deploy(self, config=None, target=None):
+        opencode_root = Path(target) if target else Path.home() / ".config" / "opencode"
+
+        print("🚀 PactKit OpenCode Deployment")
+
+        # Prepare directories
+        agents_dir = opencode_root / "agents"
+        commands_dir = opencode_root / "commands"
+        skills_dir = opencode_root / "skills"
+        rules_dir = opencode_root / "rules"
+
+        for d in [opencode_root, agents_dir, commands_dir, skills_dir, rules_dir]:
+            d.mkdir(parents=True, exist_ok=True)
+
+        # STORY-slim-008 R1+R2: Load config from project-level pactkit.yaml
+        from pactkit.config import find_pactkit_yaml
+
+        project_yaml = find_pactkit_yaml()
+
+        if project_yaml is not None:
+            auto_added = auto_merge_config_file(project_yaml)
+            for item in auto_added:
+                print(f"  -> Auto-added: {item}")
+            cfg = load_config(project_yaml)
+        else:
+            cfg = {}
+
+        enabled_agents = cfg.get("agents", sorted(VALID_AGENTS))
+        enabled_commands = cfg.get("commands", sorted(VALID_COMMANDS))
+        enabled_skills = cfg.get("skills", sorted(VALID_SKILLS))
+        enabled_rules = cfg.get("rules", sorted(VALID_RULES))
+
+        # Deploy components with OpenCode profile
+        n_skills = _deploy_skills(skills_dir, enabled_skills, profile=self.profile)
+        _cleanup_legacy(skills_dir)
+
+        n_rules = _deploy_rules(opencode_root, enabled_rules)
+        self._deploy_agents_md_inline(opencode_root)
+
+        providers = self._load_opencode_providers(opencode_root)
+        if not providers:
+            providers = self._load_opencode_providers(
+                Path(self.profile.global_config_dir).expanduser()
+            )
+        command_models = cfg.get("command_models", {})
+        self._update_global_opencode_json(
+            opencode_root, command_models=command_models, providers=providers
+        )
+
+        n_agents = _deploy_agents(agents_dir, enabled_agents, profile=self.profile)
+        n_commands = _deploy_commands(
+            commands_dir, enabled_commands, profile=self.profile, config=cfg
+        )
+
+        ci_config = cfg.get("ci", {})
+        ci_provider = ci_config.get("provider", "none") if isinstance(ci_config, dict) else "none"
+        project_root = Path.cwd()
+        _deploy_ci(ci_provider, project_root, cfg)
+
+        print(
+            f"\n✅ OpenCode: {n_agents} Agents, {n_commands} Commands, "
+            f"{n_skills} Skills, {n_rules} Rules → {opencode_root}"
+        )
+
+        if target is None:
+            self._generate_project_agents_md()
+
+        self._print_mcp_recommendations_opencode()
+
+    # --- OpenCode-specific helpers ---
+
+    @staticmethod
+    def _generate_project_agents_md():
+        """Generate project-level AGENTS.md if it does not exist (STORY-slim-008 R4)."""
+        project_root = Path.cwd()
+        if project_root.resolve() == Path.home().resolve():
+            return
+        agents_md_path = project_root / "AGENTS.md"
+        if agents_md_path.exists():
+            return
+        project_name = project_root.name
+        content = f"# {project_name}\n\n@./docs/product/context.md\noutput MUST use Chinese\n"
+        atomic_write(agents_md_path, content)
+
+    @staticmethod
+    def _deploy_agents_md_inline(opencode_root):
+        """Generate AGENTS.md with on-demand @reference index (STORY-slim-009 R3)."""
+        ref_lines = []
+        ondemand_descriptions = {
+            "08-architecture-principles.md": "Architecture decisions, SOLID/DRY patterns",
+            "04-routing-table.md": "Agent/command routing table",
+            "06-mcp-integration.md": "MCP server integration guide",
+            "05-workflow-conventions.md": "PDCA workflow conventions",
+            "07-shared-protocols.md": "PDCA shared protocols (test mapping, visualize, context.md format)",
+            "03-file-atlas.md": "File atlas (project file locations)",
+        }
+        for filename in sorted(prompts.RULES_ONDEMAND_FILES.values()):
+            desc = ondemand_descriptions.get(filename, filename)
+            ref_lines.append(f"- {desc}: @rules/{filename}")
+
+        core_names = ", ".join(
+            f.replace(".md", "") for f in sorted(prompts.RULES_CORE_FILES.values())
+        )
+
+        lines = [
+            f"# PactKit Global Constitution (v{__version__} Modular)",
+            "",
+            f"Core rules ({core_names}) are always loaded via `instructions`.",
+            "",
+            "## On-Demand Rules",
+            "",
+            "CRITICAL: When you encounter a file reference below (e.g., @rules/xxx.md), "
+            "use your Read tool to load it on a need-to-know basis. "
+            "Do NOT preemptively load all references — use lazy loading based on actual need.",
+            "",
+            *ref_lines,
+            "",
+            "## Quick Reference",
+            "",
+            "- **Specs** (`docs/specs/`) are the source of truth",
+            "- **Sprint Board**: `docs/product/sprint_board.md`",
+            "- **Architecture**: `docs/architecture/graphs/`",
+            "- **Commands**: Type `/` followed by command name (e.g., `/project-plan`)",
+            "",
+            "> **TIP**: Run `/project-init` to set up project governance and enable cross-session context.",
+            "",
+        ]
+        atomic_write(opencode_root / "AGENTS.md", "\n".join(lines))
+
+    @staticmethod
+    def _deploy_opencode_json(opencode_root):
+        """Generate opencode.json project configuration (STORY-071 R1/R2)."""
+        config = {
+            "$schema": "https://opencode.ai/config.json",
+            "instructions": ["AGENTS.md", "docs/product/context.md"],
+            "agent": {
+                "build": {"model": "inherit"},
+                "plan": {"model": "inherit"},
+            },
+            "permission": {
+                "edit": "allow",
+                "bash": {
+                    "*": "allow",
+                    "rm -rf /*": "deny",
+                    "rm -rf /Users/*": "deny",
+                    "rm -rf /System/*": "deny",
+                    "sudo rm *": "deny",
+                    "sudo mkfs *": "deny",
+                    "curl * | sh": "deny",
+                    "wget * | sh": "deny",
+                },
+                "read": {
+                    "*": "allow",
+                    "*.env": "deny",
+                    "*.env.*": "deny",
+                    "*.env.example": "allow",
+                },
+            },
+            "mcp": {
+                "context7": {
+                    "type": "remote",
+                    "url": "https://mcp.context7.com/mcp",
+                },
+            },
+        }
+        content = json.dumps(config, indent=2, ensure_ascii=False) + "\n"
+        atomic_write(opencode_root / "opencode.json", content)
+
+    @staticmethod
+    def _resolve_opencode_model_id(short_name, providers):
+        """Resolve a short model name to a full provider/model-id (STORY-073)."""
+        if not short_name or not providers:
+            return None
+        keyword = short_name.lower()
+        for provider_name, provider_data in providers.items():
+            models = provider_data.get("models", {})
+            for model_id in models:
+                if keyword in model_id.lower():
+                    return f"{provider_name}/{model_id}"
+        return None
+
+    @staticmethod
+    def _load_opencode_providers(opencode_root):
+        """Load provider config from opencode.json for model resolution."""
+        json_path = opencode_root / "opencode.json"
+        if json_path.is_file():
+            try:
+                data = json.loads(json_path.read_text(encoding="utf-8"))
+                return data.get("provider", {})
+            except (json.JSONDecodeError, OSError):
+                pass
+        return {}
+
+    @staticmethod
+    def _update_global_opencode_json(opencode_root, command_models=None, providers=None):
+        """Update global opencode.json with instructions and command model routing."""
+        json_path = opencode_root / "opencode.json"
+        config = {}
+
+        if json_path.is_file():
+            try:
+                config = json.loads(json_path.read_text(encoding="utf-8"))
+            except (json.JSONDecodeError, OSError):
+                config = {}
+
+        config.setdefault("$schema", "https://opencode.ai/config.json")
+
+        credential_path = f"rules/{prompts.CREDENTIAL_SAFETY_FILE}"
+        existing = [
+            i
+            for i in config.get("instructions", [])
+            if i != "rules/*.md" and not (i.startswith("rules/") and i != credential_path)
+        ]
+        if credential_path not in existing:
+            existing.append(credential_path)
+        config["instructions"] = existing
+
+        if command_models and providers:
+            cmd_config = config.get("command", {})
+            for cmd_name, model_short in command_models.items():
+                model_id = OpenCodeDeployer._resolve_opencode_model_id(model_short, providers)
+                if model_id:
+                    if cmd_name not in cmd_config:
+                        cmd_config[cmd_name] = {}
+                    cmd_config[cmd_name]["model"] = model_id
+            if cmd_config:
+                config["command"] = cmd_config
+
+        content = json.dumps(config, indent=2, ensure_ascii=False) + "\n"
+        atomic_write(json_path, content)
+
+    @staticmethod
+    def _print_mcp_recommendations_opencode():
+        """Print MCP server recommendations for OpenCode deployment (STORY-071 R4)."""
+        print("\n📦 MCP Server Configuration (add to opencode.json):")
+        print()
+        print("  Remote MCP (no install needed):")
+        print('    "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp" }')
+        print()
+        print("  Local MCP (requires npx):")
+        print(
+            '    "memory":     { "type": "local", "command": '
+            '["npx", "-y", "@modelcontextprotocol/server-memory"] }'
+        )
+        print(
+            '    "playwright":  { "type": "local", "command": '
+            '["npx", "-y", "@playwright/mcp"] }'
+        )
+        print(
+            '    "puppeteer":   { "type": "local", "command": '
+            '["npx", "-y", "@anthropic/mcp-puppeteer"] }'
+        )
+
+
+# Auto-register when this module is imported
+register_deployer("opencode", OpenCodeDeployer, force=True)

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: pactkit-opencode
+Version: 0.1.0
+Summary: PactKit adapter for OpenCode IDE
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: pactkit>=2.5.0

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+pyproject.toml
+src/pactkit_opencode/__init__.py
+src/pactkit_opencode/deployer.py
+src/pactkit_opencode.egg-info/PKG-INFO
+src/pactkit_opencode.egg-info/SOURCES.txt
+src/pactkit_opencode.egg-info/dependency_links.txt
+src/pactkit_opencode.egg-info/entry_points.txt
+src/pactkit_opencode.egg-info/requires.txt
+src/pactkit_opencode.egg-info/top_level.txt
+tests/test_bug035_opencode_dual_layer.py
+tests/test_deploy_opencode_parity.py
+tests/test_story069_opencode_format.py
+tests/test_story070_opencode_compliance.py
+tests/test_story071_opencode_config_parity.py
+tests/test_story073_command_model_routing.py

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pactkit.deployers]
+opencode = pactkit_opencode:OpenCodeDeployer

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/requires.txt

@@ -0,0 +1 @@
+pactkit>=2.5.0

pactkit_opencode-0.1.0/src/pactkit_opencode.egg-info/top_level.txt

@@ -0,0 +1 @@
+pactkit_opencode

pactkit_opencode-0.1.0/tests/test_bug035_opencode_dual_layer.py

@@ -0,0 +1,105 @@
+"""
+BUG-035: OpenCode Format Should Follow Dual-Layer Architecture
+Tests for dual-layer deployment: global (pactkit init) vs project (/project-init).
+"""
+
+
+from pactkit.generators.deployer import deploy
+from pactkit_opencode.deployer import OpenCodeDeployer
+
+# ===========================================================================
+# R1: Global deployment does NOT generate opencode.json
+# ===========================================================================
+
+
+class TestR1NoGlobalOpencodeJson:
+    """R1: pactkit init --format opencode creates opencode.json with instructions (STORY-071 R7).
+
+    Note: Previously (BUG-035), opencode.json was NOT created by global deployment.
+    STORY-071 R7 changed this: global deployment now creates opencode.json with
+    instructions: ["rules/*.md"] for modular rule loading.
+    """
+
+    def test_global_deploy_has_opencode_json(self, tmp_path):
+        """opencode.json IS created in global deployment (STORY-071 R7)."""
+        out = tmp_path / "opencode-global"
+        deploy(format="opencode", target=str(out))
+        assert (out / "opencode.json").is_file()
+
+    def test_global_deploy_has_agents_md(self, tmp_path):
+        """AGENTS.md IS created in global deployment."""
+        out = tmp_path / "opencode-global"
+        deploy(format="opencode", target=str(out))
+        assert (out / "AGENTS.md").is_file()
+
+    def test_global_deploy_has_agents_dir(self, tmp_path):
+        """agents/ IS created in global deployment."""
+        out = tmp_path / "opencode-global"
+        deploy(format="opencode", target=str(out))
+        assert (out / "agents").is_dir()
+
+    def test_global_deploy_has_commands_dir(self, tmp_path):
+        """commands/ IS created in global deployment."""
+        out = tmp_path / "opencode-global"
+        deploy(format="opencode", target=str(out))
+        assert (out / "commands").is_dir()
+
+    def test_global_deploy_has_skills_dir(self, tmp_path):
+        """skills/ IS created in global deployment."""
+        out = tmp_path / "opencode-global"
+        deploy(format="opencode", target=str(out))
+        assert (out / "skills").is_dir()
+
+
+# ===========================================================================
+# R3/R4: /project-init playbook contains OpenCode detection
+# ===========================================================================
+
+
+class TestR3ProjectInitOpencodeDetection:
+    """R3: /project-init playbook must detect OpenCode environment."""
+
+    def test_project_init_contains_opencode_detection(self):
+        """project-init.md contains OpenCode environment detection instructions."""
+        from pactkit.prompts.commands import COMMANDS_CONTENT
+
+        content = COMMANDS_CONTENT["project-init.md"]
+        assert "opencode" in content.lower() or "OpenCode" in content
+
+    def test_project_init_contains_opencode_json_generation(self):
+        """project-init.md contains opencode.json generation instructions."""
+        from pactkit.prompts.commands import COMMANDS_CONTENT
+
+        content = COMMANDS_CONTENT["project-init.md"]
+        assert "opencode.json" in content
+
+
+# ===========================================================================
+# R5: opencode.json structure (helper function still exists for project-init)
+# ===========================================================================
+
+
+class TestR5OpencodeJsonStructure:
+    """R5: _deploy_opencode_json helper produces correct structure."""
+
+    def test_opencode_json_helper_exists(self):
+        """_deploy_opencode_json function still exists for project-init use."""
+        assert callable(OpenCodeDeployer._deploy_opencode_json)
+
+    def test_opencode_json_has_schema(self, tmp_path):
+        """opencode.json contains $schema field."""
+        import json
+
+        OpenCodeDeployer._deploy_opencode_json(tmp_path)
+        data = json.loads((tmp_path / "opencode.json").read_text())
+        assert "$schema" in data
+        assert "opencode.ai" in data["$schema"]
+
+    def test_opencode_json_has_instructions(self, tmp_path):
+        """opencode.json contains instructions field."""
+        import json
+
+        OpenCodeDeployer._deploy_opencode_json(tmp_path)
+        data = json.loads((tmp_path / "opencode.json").read_text())
+        assert "instructions" in data
+        assert isinstance(data["instructions"], list)