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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/PKG-INFO +2 -2
  2. pactkit_opencode-2.9.0/README.md +99 -0
  3. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/pyproject.toml +2 -2
  4. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/PKG-INFO +2 -2
  5. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/SOURCES.txt +1 -0
  6. pactkit_opencode-2.9.0/src/pactkit_opencode.egg-info/requires.txt +1 -0
  7. pactkit_opencode-2.8.0/src/pactkit_opencode.egg-info/requires.txt +0 -1
  8. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/setup.cfg +0 -0
  9. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode/__init__.py +0 -0
  10. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode/deployer.py +0 -0
  11. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/dependency_links.txt +0 -0
  12. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/entry_points.txt +0 -0
  13. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/src/pactkit_opencode.egg-info/top_level.txt +0 -0
  14. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_bug035_opencode_dual_layer.py +0 -0
  15. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_deploy_opencode_parity.py +0 -0
  16. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_story069_opencode_format.py +0 -0
  17. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_story070_opencode_compliance.py +0 -0
  18. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_story071_opencode_config_parity.py +0 -0
  19. {pactkit_opencode-2.8.0 → pactkit_opencode-2.9.0}/tests/test_story073_command_model_routing.py +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pactkit-opencode
3
- Version: 2.8.0
3
+ Version: 2.9.0
4
4
  Summary: PactKit adapter for OpenCode IDE
5
5
  License-Expression: MIT
6
6
  Requires-Python: >=3.10
7
- Requires-Dist: pactkit>=2.8.0
7
+ Requires-Dist: pactkit>=2.9.0
@@ -0,0 +1,99 @@
1
+ # pactkit-opencode
2
+
3
+ > PactKit PDCA workflow framework adapted for [OpenCode](https://opencode.ai).
4
+
5
+ [![PyPI version](https://badge.fury.io/py/pactkit-opencode.svg)](https://pypi.org/project/pactkit-opencode/)
6
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ ## What is this?
10
+
11
+ **pactkit-opencode** brings the [PactKit](https://pactkit.dev) spec-driven development workflow to OpenCode IDE. It deploys:
12
+
13
+ - **Commands** (`commands/*.md`) — 11 PDCA workflow commands, auto-discovered by OpenCode (invoked via `/project-plan`, `/project-act`, etc.)
14
+ - **Skills** (`skills/*/SKILL.md`) — 10 embedded skills loaded by AI agent on demand
15
+ - **Agents** (`agents/*.md`) — 9 specialized agent definitions
16
+ - **Rules** (`rules/*.md`) — Governance rules loaded per-command
17
+
18
+ ## Installation
19
+
20
+ ```bash
21
+ pip install pactkit
22
+ ```
23
+
24
+ > `pactkit-opencode` is automatically installed as a dependency of `pactkit`.
25
+
26
+ ## Quick Start
27
+
28
+ ```bash
29
+ # Deploy PactKit to OpenCode (~/.config/opencode/)
30
+ pactkit init --format opencode
31
+
32
+ # Update when pactkit is upgraded
33
+ pactkit upgrade --format opencode
34
+ ```
35
+
36
+ Then in OpenCode, use commands like:
37
+
38
+ ```
39
+ /project-plan "Add user authentication"
40
+ /project-act STORY-001
41
+ /project-done
42
+ ```
43
+
44
+ ## What Gets Deployed
45
+
46
+ ```
47
+ ~/.config/opencode/
48
+ ├── AGENTS.md # Global constitution
49
+ ├── rules/ # Governance rule modules
50
+ ├── commands/ # 11 PDCA command playbooks (auto-discovered by OpenCode)
51
+ ├── agents/ # 9 agent definitions (mode: subagent)
52
+ ├── skills/ # 10 skill packages (AI agent loads on demand)
53
+ └── opencode.json # Global config (model routing, instructions)
54
+
55
+ ./ # Project root
56
+ ├── .opencode/
57
+ │ ├── pactkit.yaml # Project config
58
+ │ └── AGENTS.local.md # Your custom instructions (never overwritten)
59
+ ```
60
+
61
+ ## OpenCode Architecture
62
+
63
+ OpenCode has two separate mechanisms for extending the AI assistant:
64
+
65
+ | Mechanism | Location | Invocation | Purpose |
66
+ |-----------|----------|------------|---------|
67
+ | **Commands** | `commands/*.md` | User types `/command-name` | PDCA workflow entry points |
68
+ | **Skills** | `skills/*/SKILL.md` | AI agent loads via `skill()` | Embedded tools (visualize, board, scaffold) |
69
+
70
+ Commands are auto-discovered from `commands/*.md` — no `opencode.json` configuration needed.
71
+
72
+ ## Key Differences from Claude Code
73
+
74
+ | Feature | Claude Code | OpenCode |
75
+ |---------|-------------|----------|
76
+ | Commands | Skills-only (`skills/project-*/SKILL.md`) | Dual: `commands/` + `skills/` |
77
+ | Config dir | `~/.claude/` | `~/.config/opencode/` |
78
+ | Agent format | Native multi-agent | `mode: subagent` |
79
+ | Model routing | Via skill frontmatter | Via `opencode.json` command entries |
80
+ | Rule loading | `@import` directives | Inline embedding per command |
81
+
82
+ ## Development
83
+
84
+ ```bash
85
+ git clone https://github.com/pactkit/pactkit-opencode.git
86
+ cd pactkit-opencode
87
+ pip install -e .
88
+ pytest tests/ -v
89
+ ```
90
+
91
+ ## License
92
+
93
+ MIT License - see [LICENSE](LICENSE) for details.
94
+
95
+ ## Related Projects
96
+
97
+ - [PactKit](https://pactkit.dev) — Core framework
98
+ - [pactkit-codex](https://github.com/pactkit/pactkit-codex) — Adapter for OpenAI Codex CLI
99
+ - [OpenCode](https://opencode.ai) — AI-powered coding IDE
@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "pactkit-opencode"
7
- version = "2.8.0"
7
+ version = "2.9.0"
8
8
  description = "PactKit adapter for OpenCode IDE"
9
9
  requires-python = ">=3.10"
10
10
  license = "MIT"
11
11
  dependencies = [
12
- "pactkit>=2.8.0",
12
+ "pactkit>=2.9.0",
13
13
  ]
14
14
 
15
15
  [project.entry-points."pactkit.deployers"]
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pactkit-opencode
3
- Version: 2.8.0
3
+ Version: 2.9.0
4
4
  Summary: PactKit adapter for OpenCode IDE
5
5
  License-Expression: MIT
6
6
  Requires-Python: >=3.10
7
- Requires-Dist: pactkit>=2.8.0
7
+ Requires-Dist: pactkit>=2.9.0
@@ -1,3 +1,4 @@
1
+ README.md
1
2
  pyproject.toml
2
3
  src/pactkit_opencode/__init__.py
3
4
  src/pactkit_opencode/deployer.py
@@ -1 +0,0 @@
1
- pactkit>=2.8.0