pactkit-opencode 2.7.0__tar.gz → 2.9.0__tar.gz

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/PKG-INFO

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

pactkit_opencode-2.9.0/README.md

@@ -0,0 +1,99 @@
+# pactkit-opencode
+
+> PactKit PDCA workflow framework adapted for [OpenCode](https://opencode.ai).
+
+[![PyPI version](https://badge.fury.io/py/pactkit-opencode.svg)](https://pypi.org/project/pactkit-opencode/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is this?
+
+**pactkit-opencode** brings the [PactKit](https://pactkit.dev) spec-driven development workflow to OpenCode IDE. It deploys:
+
+- **Commands** (`commands/*.md`) — 11 PDCA workflow commands, auto-discovered by OpenCode (invoked via `/project-plan`, `/project-act`, etc.)
+- **Skills** (`skills/*/SKILL.md`) — 10 embedded skills loaded by AI agent on demand
+- **Agents** (`agents/*.md`) — 9 specialized agent definitions
+- **Rules** (`rules/*.md`) — Governance rules loaded per-command
+
+## Installation
+
+```bash
+pip install pactkit
+```
+
+> `pactkit-opencode` is automatically installed as a dependency of `pactkit`.
+
+## Quick Start
+
+```bash
+# Deploy PactKit to OpenCode (~/.config/opencode/)
+pactkit init --format opencode
+
+# Update when pactkit is upgraded
+pactkit upgrade --format opencode
+```
+
+Then in OpenCode, use commands like:
+
+```
+/project-plan "Add user authentication"
+/project-act STORY-001
+/project-done
+```
+
+## What Gets Deployed
+
+```
+~/.config/opencode/
+├── AGENTS.md              # Global constitution
+├── rules/                 # Governance rule modules
+├── commands/              # 11 PDCA command playbooks (auto-discovered by OpenCode)
+├── agents/                # 9 agent definitions (mode: subagent)
+├── skills/                # 10 skill packages (AI agent loads on demand)
+└── opencode.json          # Global config (model routing, instructions)
+
+./                         # Project root
+├── .opencode/
+│   ├── pactkit.yaml       # Project config
+│   └── AGENTS.local.md    # Your custom instructions (never overwritten)
+```
+
+## OpenCode Architecture
+
+OpenCode has two separate mechanisms for extending the AI assistant:
+
+| Mechanism | Location | Invocation | Purpose |
+|-----------|----------|------------|---------|
+| **Commands** | `commands/*.md` | User types `/command-name` | PDCA workflow entry points |
+| **Skills** | `skills/*/SKILL.md` | AI agent loads via `skill()` | Embedded tools (visualize, board, scaffold) |
+
+Commands are auto-discovered from `commands/*.md` — no `opencode.json` configuration needed.
+
+## Key Differences from Claude Code
+
+| Feature | Claude Code | OpenCode |
+|---------|-------------|----------|
+| Commands | Skills-only (`skills/project-*/SKILL.md`) | Dual: `commands/` + `skills/` |
+| Config dir | `~/.claude/` | `~/.config/opencode/` |
+| Agent format | Native multi-agent | `mode: subagent` |
+| Model routing | Via skill frontmatter | Via `opencode.json` command entries |
+| Rule loading | `@import` directives | Inline embedding per command |
+
+## Development
+
+```bash
+git clone https://github.com/pactkit/pactkit-opencode.git
+cd pactkit-opencode
+pip install -e .
+pytest tests/ -v
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Related Projects
+
+- [PactKit](https://pactkit.dev) — Core framework
+- [pactkit-codex](https://github.com/pactkit/pactkit-codex) — Adapter for OpenAI Codex CLI
+- [OpenCode](https://opencode.ai) — AI-powered coding IDE

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pactkit-opencode"
-version = "2.7.0"
+version = "2.9.0"
 description = "PactKit adapter for OpenCode IDE"
 requires-python = ">=3.10"
 license = "MIT"
 dependencies = [
-    "pactkit>=2.7.0",
+    "pactkit>=2.9.0",
 ]
 
 [project.entry-points."pactkit.deployers"]

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode/deployer.py

@@ -4,6 +4,7 @@ Extracted from pactkit core (STORY-slim-058).
 """
 
 import json
+import re
 from pathlib import Path
 
 from pactkit import __version__, prompts
@@ -25,8 +26,12 @@ from pactkit.generators.deployer import (
     _deploy_skills,
 )
 from pactkit.profiles import get_profile
+from pactkit.prompts.rules import CREDENTIAL_SAFETY_FILE
 from pactkit.utils import atomic_write
 
+# Commands excluded from OpenCode deployment (require multi-agent capabilities)
+OPENCODE_EXCLUDED_COMMANDS = {"project-sprint"}
+
 
 class OpenCodeDeployer(DeployerBase):
     """OpenCode deployment — generate OpenCode-native configuration (STORY-069).
@@ -36,7 +41,9 @@ class OpenCodeDeployer(DeployerBase):
     - 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
+    - agents/ directory
+    - commands/ directory (PDCA commands, invoked via /command-name)
+    - skills/ directory (embedded skills like pactkit-board, pactkit-visualize)
 
     STORY-slim-008: Aligned with _deploy_classic() feature set:
     - Reads pactkit.yaml for selective deployment (R1)
@@ -55,11 +62,11 @@ class OpenCodeDeployer(DeployerBase):
 
         # Prepare directories
         agents_dir = opencode_root / "agents"
-        commands_dir = opencode_root / "commands"
         skills_dir = opencode_root / "skills"
+        commands_dir = opencode_root / "commands"
         rules_dir = opencode_root / "rules"
 
-        for d in [opencode_root, agents_dir, commands_dir, skills_dir, rules_dir]:
+        for d in [opencode_root, agents_dir, skills_dir, commands_dir, rules_dir]:
             d.mkdir(parents=True, exist_ok=True)
 
         # STORY-slim-008 R1+R2: Load config from project-level pactkit.yaml
@@ -76,13 +83,35 @@ class OpenCodeDeployer(DeployerBase):
             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_commands = cfg.get("commands", sorted(VALID_COMMANDS))
         enabled_rules = cfg.get("rules", sorted(VALID_RULES))
 
-        # Deploy components with OpenCode profile
+        # Filter out excluded commands (project-sprint requires multi-agent)
+        enabled_commands = [c for c in enabled_commands if c not in OPENCODE_EXCLUDED_COMMANDS]
+
+        # Deploy embedded skills (pactkit-board, pactkit-visualize, etc.)
         n_skills = _deploy_skills(skills_dir, enabled_skills, profile=self.profile)
         _cleanup_legacy(skills_dir)
+        # Clean up legacy command skills from skills/ directory (migrated to commands/)
+        self._cleanup_command_skills(skills_dir)
+
+        # Apply CLI-to-script replacement to deployed embedded skill SKILL.md files
+        for skill_md in skills_dir.glob("*/SKILL.md"):
+            content = skill_md.read_text(encoding="utf-8")
+            replaced = _replace_cli_with_scripts(content)
+            if replaced != content:
+                atomic_write(skill_md, replaced)
+
+        # Deploy commands to commands/ directory (OpenCode uses /command-name to invoke)
+        n_commands = _deploy_commands(commands_dir, enabled_commands, profile=self.profile, config=cfg)
+
+        # Apply CLI-to-script replacement to deployed command files
+        for cmd_md in commands_dir.glob("*.md"):
+            content = cmd_md.read_text(encoding="utf-8")
+            replaced = _replace_cli_with_scripts(content)
+            if replaced != content:
+                atomic_write(cmd_md, replaced)
 
         n_rules = _deploy_rules(opencode_root, enabled_rules)
         self._deploy_agents_md_inline(opencode_root)
@@ -94,13 +123,13 @@ class OpenCodeDeployer(DeployerBase):
             )
         command_models = cfg.get("command_models", {})
         self._update_global_opencode_json(
-            opencode_root, command_models=command_models, providers=providers
+            opencode_root,
+            command_models=command_models,
+            providers=providers,
+            enabled_commands=enabled_commands,
         )
 
         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"
@@ -108,8 +137,8 @@ class OpenCodeDeployer(DeployerBase):
         _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}"
+            f"\n✅ OpenCode: {n_agents} Agents, {n_skills} Skills, "
+            f"{n_commands} Commands → {opencode_root}"
         )
 
         if target is None:
@@ -242,8 +271,10 @@ class OpenCodeDeployer(DeployerBase):
         return {}
 
     @staticmethod
-    def _update_global_opencode_json(opencode_root, command_models=None, providers=None):
-        """Update global opencode.json with instructions and command model routing."""
+    def _update_global_opencode_json(
+        opencode_root, command_models=None, providers=None, enabled_commands=None
+    ):
+        """Update global opencode.json with instructions, command templates, and model routing."""
         json_path = opencode_root / "opencode.json"
         config = {}
 
@@ -255,7 +286,7 @@ class OpenCodeDeployer(DeployerBase):
 
         config.setdefault("$schema", "https://opencode.ai/config.json")
 
-        credential_path = f"rules/{prompts.CREDENTIAL_SAFETY_FILE}"
+        credential_path = f"rules/{CREDENTIAL_SAFETY_FILE}"
         existing = [
             i
             for i in config.get("instructions", [])
@@ -265,16 +296,34 @@ class OpenCodeDeployer(DeployerBase):
             existing.append(credential_path)
         config["instructions"] = existing
 
+        # OpenCode auto-discovers commands from commands/*.md directory.
+        # opencode.json "command" entries are only needed for model routing overrides.
+        # NOTE: "template" in JSON is inline prompt text, NOT a file path — do not write it.
+        cmd_config = config.get("command", {})
+        if enabled_commands:
+            # Remove stale command entries not in enabled set
+            stale_keys = [k for k in cmd_config if k.startswith("project-") and k not in enabled_commands]
+            for k in stale_keys:
+                del cmd_config[k]
+            # Remove legacy "template" fields (was incorrectly treated as file path)
+            for cmd_name in list(cmd_config):
+                if cmd_name.startswith("project-") and "template" in cmd_config[cmd_name]:
+                    del cmd_config[cmd_name]["template"]
+                    # Remove entry entirely if only template was present
+                    if not cmd_config[cmd_name]:
+                        del cmd_config[cmd_name]
+
+        # Apply model routing
         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
+
+        if cmd_config:
+            config["command"] = cmd_config
 
         content = json.dumps(config, indent=2, ensure_ascii=False) + "\n"
         atomic_write(json_path, content)
@@ -301,6 +350,54 @@ class OpenCodeDeployer(DeployerBase):
             '["npx", "-y", "@anthropic/mcp-puppeteer"] }'
         )
 
+    @staticmethod
+    def _cleanup_command_skills(skills_dir):
+        """Remove legacy command skills from skills/ directory.
+
+        Previously, PDCA commands were deployed as skills/{name}/SKILL.md.
+        Now they are in commands/{name}.md. Clean up the old entries.
+        """
+        for d in skills_dir.iterdir():
+            if d.is_dir() and d.name.startswith("project-"):
+                import shutil
+                shutil.rmtree(d)
+
+
+# --- Module-level helper functions ---
+
+_VIZ_SCRIPT = "python3 ~/.config/opencode/skills/pactkit-visualize/scripts/visualize.py"
+_BOARD_SCRIPT = "python3 ~/.config/opencode/skills/pactkit-board/scripts/board.py"
+_SCAFFOLD_SCRIPT = "python3 ~/.config/opencode/skills/pactkit-scaffold/scripts/scaffold.py"
+
+# CLI subcommands that map to skill scripts (order matters: longer patterns first)
+_CLI_TO_SCRIPT = [
+    # visualize variants
+    ("Run `pactkit visualize --lazy`", f"Run `{_VIZ_SCRIPT}` (file, `--mode class`, `--mode call` if source changed)"),
+    ("Run `pactkit visualize", f"Run `{_VIZ_SCRIPT}"),
+    ("Run `visualize --focus", f"Run `{_VIZ_SCRIPT} --focus"),
+    ("Run `visualize --mode", f"Run `{_VIZ_SCRIPT} --mode"),
+    ("Run `visualize`", f"Run `{_VIZ_SCRIPT}`"),
+    # board
+    ("Run `python3 ~/.config/opencode/skills/pactkit-board/scripts/board.py", f"Run `{_BOARD_SCRIPT}"),
+    # scaffold
+    ("Run `python3 ~/.config/opencode/skills/pactkit-scaffold/scripts/scaffold.py", f"Run `{_SCAFFOLD_SCRIPT}"),
+    # pactkit CLI → manual fallback hint
+    ("Run `pactkit clean`", "Run language-specific cleanup (e.g., `find . -name '__pycache__' -exec rm -rf {} +` for Python)"),
+]
+
+
+def _replace_cli_with_scripts(content):
+    """Replace pactkit CLI and bare visualize commands with direct OpenCode script paths."""
+    for old, new in _CLI_TO_SCRIPT:
+        content = content.replace(old, new)
+    # Handle backtick-wrapped bare `visualize` with flags
+    content = re.sub(
+        r'`visualize (--(?:focus|mode|entry))',
+        rf'`{_VIZ_SCRIPT} \1',
+        content,
+    )
+    return content
+
 
 # Auto-register when this module is imported
 register_deployer("opencode", OpenCodeDeployer, force=True)

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/PKG-INFO

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

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+README.md
 pyproject.toml
 src/pactkit_opencode/__init__.py
 src/pactkit_opencode/deployer.py

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

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

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/tests/test_bug035_opencode_dual_layer.py

@@ -39,7 +39,7 @@ class TestR1NoGlobalOpencodeJson:
         assert (out / "agents").is_dir()
 
     def test_global_deploy_has_commands_dir(self, tmp_path):
-        """commands/ IS created in global deployment."""
+        """commands/ IS created — OpenCode uses /command-name to invoke."""
         out = tmp_path / "opencode-global"
         deploy(format="opencode", target=str(out))
         assert (out / "commands").is_dir()

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/tests/test_story069_opencode_format.py

@@ -10,8 +10,11 @@ from pactkit.config import VALID_AGENTS, VALID_COMMANDS, VALID_FORMATS, VALID_SK
 from pactkit.generators.deployer import deploy
 from pactkit_opencode.deployer import OpenCodeDeployer
 
-# In pactkit 2.7.0, commands deploy as skills to skills/{name}/SKILL.md in classic format.
-# For OpenCode format, only embedded (non-command) skills go to skills/.
+# OpenCode deploys commands to commands/{name}.md (invoked via /command-name)
+# and embedded skills to skills/{name}/SKILL.md (auto-discovered by AI agent).
+# project-sprint is excluded from OpenCode (requires multi-agent).
+OPENCODE_EXCLUDED_COMMANDS = frozenset({"project-sprint"})
+_DEPLOYABLE_COMMANDS = VALID_COMMANDS - OPENCODE_EXCLUDED_COMMANDS
 _EMBEDDED_SKILLS = VALID_SKILLS - VALID_COMMANDS
 
 # ===========================================================================
@@ -53,8 +56,8 @@ class TestR2GlobalDeployment:
         deploy(format="opencode", target=str(out))
         assert (out / "agents").is_dir()
 
-    def test_commands_dir_exists(self, tmp_path):
-        """commands/ directory is created."""
+    def test_commands_dir_created(self, tmp_path):
+        """commands/ directory IS created — OpenCode uses /command-name to invoke."""
         out = tmp_path / "opencode"
         deploy(format="opencode", target=str(out))
         assert (out / "commands").is_dir()
@@ -73,22 +76,22 @@ class TestR2GlobalDeployment:
         deployed = {f.stem for f in agents_dir.glob("*.md")}
         assert deployed == VALID_AGENTS
 
-    def test_all_commands_deployed(self, tmp_path):
-        """All commands are deployed."""
+    def test_all_commands_deployed_to_commands_dir(self, tmp_path):
+        """All commands (except project-sprint) are deployed as commands/{name}.md."""
         out = tmp_path / "opencode"
         deploy(format="opencode", target=str(out))
         commands_dir = out / "commands"
         deployed = {f.stem for f in commands_dir.glob("*.md")}
-        assert deployed == VALID_COMMANDS
+        for cmd in _DEPLOYABLE_COMMANDS:
+            assert cmd in deployed, f"{cmd}.md not found in commands/"
 
-    def test_all_skills_deployed(self, tmp_path):
-        """All embedded skills are deployed to skills/. (pactkit 2.7.0: commands deploy
-        to commands/{name}.md in opencode format, not skills/.)"""
+    def test_all_embedded_skills_deployed(self, tmp_path):
+        """All embedded skills are in skills/."""
         out = tmp_path / "opencode"
         deploy(format="opencode", target=str(out))
         skills_dir = out / "skills"
         deployed = {d.name for d in skills_dir.iterdir() if d.is_dir()}
-        assert deployed == _EMBEDDED_SKILLS
+        assert _EMBEDDED_SKILLS.issubset(deployed)
 
 
 # ===========================================================================

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/tests/test_story070_opencode_compliance.py

@@ -49,14 +49,18 @@ class TestAC1CommandFrontmatter:
 
     def test_all_commands_converted(self, tmp_path):
         """All command files use OpenCode frontmatter."""
+        from pactkit.config import VALID_COMMANDS
+        EXCLUDED = frozenset({"project-sprint"})
         out = tmp_path / "oc"
         deploy(format="opencode", target=str(out))
         commands_dir = out / "commands"
-        for cmd_file in commands_dir.glob("*.md"):
+        for cmd_name in VALID_COMMANDS - EXCLUDED:
+            cmd_file = commands_dir / f"{cmd_name}.md"
+            assert cmd_file.exists(), f"{cmd_name}.md missing in commands/"
             content = cmd_file.read_text()
             frontmatter = self._extract_frontmatter(content)
-            assert "allowed-tools" not in frontmatter, f"{cmd_file.name} still has allowed-tools"
-            assert "agent: build" in frontmatter, f"{cmd_file.name} missing agent: build"
+            assert "allowed-tools" not in frontmatter, f"{cmd_name} still has allowed-tools"
+            assert "agent: build" in frontmatter, f"{cmd_name} missing agent: build"
 
     def test_command_body_preserved(self, tmp_path):
         """Command body content is preserved after frontmatter conversion."""

{pactkit_opencode-2.7.0 → pactkit_opencode-2.9.0}/tests/test_story073_command_model_routing.py

@@ -65,8 +65,15 @@ class TestAC1CommandModel:
         """Command frontmatter should NOT contain model: (routing is in opencode.json)."""
         out = self._deploy_with_providers(tmp_path)
         content = (out / "commands" / "project-act.md").read_text()
-        parts = content.split("---", 2)
-        frontmatter = parts[1]
+        import re
+        matches = list(re.finditer(r'---\n(.*?)\n---', content, re.DOTALL))
+        assert matches, "No frontmatter found"
+        for m in matches:
+            if "description:" in m.group(1):
+                frontmatter = m.group(1)
+                break
+        else:
+            frontmatter = matches[-1].group(1)
         for line in frontmatter.strip().split("\n"):
             assert not line.strip().startswith("model:"), f"Unexpected model in frontmatter: {line}"
 
@@ -77,10 +84,14 @@ class TestAC1CommandModel:
 
 
 class TestAC2PlanNoModel:
-    """AC2: Commands that inherit main model are NOT in opencode.json command section."""
+    """AC2: Commands that inherit main model have no model override in opencode.json."""
 
     def test_plan_not_in_command_routing(self, tmp_path):
-        """project-plan is NOT in opencode.json command section."""
+        """project-plan has no entry in opencode.json command section (no model override needed).
+
+        OpenCode auto-discovers commands from commands/*.md directory.
+        JSON command entries are only for model routing overrides.
+        """
         out = tmp_path / "oc"
         out.mkdir(parents=True, exist_ok=True)
         providers = {"$schema": "x", "provider": {"tp": {"models": {"claude-sonnet-4.6": {}}}}}
@@ -90,7 +101,7 @@ class TestAC2PlanNoModel:
         assert "project-plan" not in data.get("command", {})
 
     def test_clarify_not_in_command_routing(self, tmp_path):
-        """project-clarify is NOT in opencode.json command section."""
+        """project-clarify has no entry in opencode.json command section (no model override needed)."""
         out = tmp_path / "oc"
         out.mkdir(parents=True, exist_ok=True)
         providers = {"$schema": "x", "provider": {"tp": {"models": {"claude-sonnet-4.6": {}}}}}

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

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