pactkit-opencode 2.8.0__tar.gz → 2.9.1__tar.gz

{pactkit_opencode-2.8.0 → pactkit_opencode-2.9.1}/PKG-INFO

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

pactkit_opencode-2.9.1/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.8.0 → pactkit_opencode-2.9.1}/pyproject.toml

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

{pactkit_opencode-2.8.0 → pactkit_opencode-2.9.1}/src/pactkit_opencode/deployer.py

@@ -297,33 +297,19 @@ class OpenCodeDeployer(DeployerBase):
         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.
+        # opencode.json "command" section requires BOTH "model" AND "template" fields.
+        # Since we don't control template content (it's inline prompt text, not a file path),
+        # we must NOT write model-only entries — they cause OpenCode validation errors.
+        # Clean up any PactKit-managed command entries that lack template.
         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:
-            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
+        for cmd_name in list(cmd_config):
+            if cmd_name.startswith("project-") and "template" not in cmd_config[cmd_name]:
+                del cmd_config[cmd_name]
 
         if cmd_config:
             config["command"] = cmd_config
+        else:
+            config.pop("command", None)
 
         content = json.dumps(config, indent=2, ensure_ascii=False) + "\n"
         atomic_write(json_path, content)

{pactkit_opencode-2.8.0 → pactkit_opencode-2.9.1}/src/pactkit_opencode.egg-info/PKG-INFO

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

{pactkit_opencode-2.8.0 → pactkit_opencode-2.9.1}/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.1/src/pactkit_opencode.egg-info/requires.txt

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

{pactkit_opencode-2.8.0 → pactkit_opencode-2.9.1}/tests/test_story073_command_model_routing.py

@@ -40,26 +40,16 @@ class TestAC1CommandModel:
         deploy(format="opencode", target=str(out))
         return out
 
-    def test_act_model_in_opencode_json(self, tmp_path):
-        """project-act model routing is in opencode.json command section."""
+    def test_no_model_only_entries_in_opencode_json(self, tmp_path):
+        """Model-only command entries must NOT be written — OpenCode requires both model AND template."""
         out = self._deploy_with_providers(tmp_path)
         data = json.loads((out / "opencode.json").read_text())
         cmd_config = data.get("command", {})
-        assert "project-act" in cmd_config
-        assert "model" in cmd_config["project-act"]
-        assert "sonnet" in cmd_config["project-act"]["model"]
-
-    def test_done_model_in_opencode_json(self, tmp_path):
-        """project-done model routing is in opencode.json command section."""
-        out = self._deploy_with_providers(tmp_path)
-        data = json.loads((out / "opencode.json").read_text())
-        assert "project-done" in data.get("command", {})
-
-    def test_check_model_in_opencode_json(self, tmp_path):
-        """project-check model routing is in opencode.json command section."""
-        out = self._deploy_with_providers(tmp_path)
-        data = json.loads((out / "opencode.json").read_text())
-        assert "project-check" in data.get("command", {})
+        for cmd_name, cmd_val in cmd_config.items():
+            if cmd_name.startswith("project-"):
+                assert "template" in cmd_val, (
+                    f"command.{cmd_name} has model but no template — OpenCode validation will fail"
+                )
 
     def test_frontmatter_has_no_model(self, tmp_path):
         """Command frontmatter should NOT contain model: (routing is in opencode.json)."""

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

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