pactkit-opencode 2.22.0__tar.gz → 2.23.0__tar.gz

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/PKG-INFO

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

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/pyproject.toml

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

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/src/pactkit_opencode/deployer.py

@@ -7,11 +7,12 @@ import json
 import re
 from pathlib import Path
 
-from pactkit import __version__, prompts
+from pactkit import __version__
 from pactkit.config import (
+    DEFAULT_RULE_IDS,
+    activate_pactkit_maintainer_overlay,
     VALID_AGENTS,
     VALID_COMMANDS,
-    VALID_RULES,
     VALID_SKILLS,
     auto_merge_config_file,
     load_config,
@@ -19,9 +20,11 @@ from pactkit.config import (
 from pactkit.generators.deploy_base import DeployerBase, register_deployer
 from pactkit.generators.deployer import (
     _cleanup_legacy,
+    _cleanup_legacy_portable_methods,
     _deploy_agents,
     _deploy_ci,
     _deploy_commands,
+    _deploy_guides,
     _deploy_rules,
     _deploy_skills,
 )
@@ -39,7 +42,7 @@ class OpenCodeDeployer(DeployerBase):
     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"])
+    - opencode.json (global config loads only rules/pactkit-runtime.md)
     - agents/ directory
     - commands/ directory (PDCA commands, invoked via /command-name)
     - skills/ directory (embedded skills like pactkit-board, pactkit-visualize)
@@ -73,24 +76,32 @@ class OpenCodeDeployer(DeployerBase):
 
         project_yaml = find_pactkit_yaml()
 
-        if project_yaml is not None:
+        if config is not None:
+            cfg = config
+        elif 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 = {}
+        cfg = activate_pactkit_maintainer_overlay(cfg, Path.cwd())
 
         enabled_agents = cfg.get("agents", sorted(VALID_AGENTS))
         enabled_skills = cfg.get("skills", sorted(VALID_SKILLS))
         enabled_commands = cfg.get("commands", sorted(VALID_COMMANDS))
-        enabled_rules = cfg.get("rules", sorted(VALID_RULES))
+        enabled_rules = cfg.get("rules", sorted(DEFAULT_RULE_IDS))
 
         # Apply explicit format exclusions (currently none).
         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)
+        n_skills = _deploy_skills(
+            skills_dir,
+            enabled_skills,
+            profile=self.profile,
+        )
+        _cleanup_legacy_portable_methods(skills_dir, self.profile)
         _cleanup_legacy(skills_dir)
         # Clean up legacy command skills from skills/ directory (migrated to commands/)
         self._cleanup_command_skills(skills_dir)
@@ -113,6 +124,7 @@ class OpenCodeDeployer(DeployerBase):
                 atomic_write(cmd_md, replaced)
 
         _deploy_rules(opencode_root, enabled_rules, profile=self.profile)
+        _deploy_guides(opencode_root, profile=self.profile)
         self._deploy_agents_md_inline(opencode_root)
 
         providers = self._load_opencode_providers(opencode_root)
@@ -167,45 +179,23 @@ class OpenCodeDeployer(DeployerBase):
 
     @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}")
+        """Generate a small runtime index without globally loading phase rules."""
+        from pactkit.prompts.rules import RULE_DEFINITIONS
 
-        core_names = ", ".join(
-            f.replace(".md", "") for f in sorted(prompts.RULES_CORE_FILES.values())
-        )
+        runtime = RULE_DEFINITIONS["runtime"].filename
 
         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.",
+            f"# PactKit Runtime Contract (v{__version__})",
             "",
-            *ref_lines,
+            f"`rules/{runtime}` is the only always-loaded PactKit rule.",
             "",
-            "## Quick Reference",
+            "## Active Command Rules",
             "",
-            "- **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`)",
+            "PactKit command files inline only their phase contract and declared shared modules. "
+            "Do not load PDCA rules for ordinary questions or ordinary coding.",
             "",
-            "> **TIP**: Run `/project-init` to set up project governance and enable cross-session context.",
+            "Ordinary questions and ordinary coding do not activate PDCA.",
+            "A user-invoked PactKit command loads only its own phase contract and declared shared modules.",
             "",
         ]
         atomic_write(opencode_root / "AGENTS.md", "\n".join(lines))
@@ -290,9 +280,9 @@ class OpenCodeDeployer(DeployerBase):
 
         config.setdefault("$schema", "https://opencode.ai/config.json")
 
-        # Always-load layer: the merged constitution + credential safety must be
-        # globally referenced (RULES_INSTRUCTIONS_CORE). Older logic stripped
-        # rules/* entries — that silently dropped pactkit.md (drift 2026-08-13).
+        # Always-load layer: only the self-contained Runtime Kernel is global.
+        # Phase, command, conditional, and risk rules are activated by the
+        # current command instead of through a wildcard instruction.
         from pactkit.prompts.rules import RULES_INSTRUCTIONS_CORE
 
         managed = set(RULES_INSTRUCTIONS_CORE)

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/src/pactkit_opencode.egg-info/PKG-INFO

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

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/src/pactkit_opencode.egg-info/SOURCES.txt

@@ -13,4 +13,5 @@ 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
+tests/test_story073_command_model_routing.py
+tests/test_story_work_units.py

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

@@ -0,0 +1 @@
+pactkit<2.24.0,>=2.23.0

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/tests/test_story069_opencode_format.py

@@ -85,6 +85,24 @@ class TestR2GlobalDeployment:
         for cmd in _DEPLOYABLE_COMMANDS:
             assert cmd in deployed, f"{cmd}.md not found in commands/"
 
+    def test_sprint_uses_managed_phase_capsules_without_retired_runtime(self, tmp_path):
+        out = tmp_path / "opencode"
+        deploy(format="opencode", target=str(out))
+
+        sprint = (out / "commands" / "project-sprint.md").read_text()
+        assert "current session" in sprint.lower()
+        assert "# sprint orchestrator" in sprint.lower()
+        assert "Plan Contract" not in sprint
+        assert "Act Contract" not in sprint
+        assert "Check Contract" not in sprint
+        assert "Done Contract" not in sprint
+        for retired in ("TeamCreate", "TaskCreate", "WorkUnit", "codex runner"):
+            assert retired not in sprint
+        for phase in ("plan", "act", "check", "done"):
+            capsule = out / "skills" / "_rules" / "phases" / f"{phase}-contract.md"
+            assert capsule.is_file()
+            assert str(capsule).split(str(out), 1)[-1].lstrip("/")
+
     def test_all_embedded_skills_deployed(self, tmp_path):
         """All embedded skills are in skills/."""
         out = tmp_path / "opencode"
@@ -159,16 +177,24 @@ class TestR4AgentsMdInlineRules:
         assert "PactKit" in content
 
     def test_rules_in_separate_files(self, tmp_path):
-        """Merged constitution is deployed to rules/ (post-merge layout)."""
+        """Only the minimal Runtime Kernel is globally deployed."""
         out = tmp_path / "opencode"
         deploy(format="opencode", target=str(out))
         rules_dir = out / "rules"
         assert rules_dir.is_dir()
-        # Post-merge (slim-126+): the constitution ships as a single pactkit.md
+        # Scenario-driven architecture: only the Runtime Kernel is global.
         rule_files = {f.name for f in rules_dir.glob("*.md")}
-        assert "pactkit.md" in rule_files
-        content = (rules_dir / "pactkit.md").read_text()
-        assert "Hierarchy of Truth" in content
+        assert rule_files == {"pactkit-runtime.md"}
+        content = (rules_dir / "pactkit-runtime.md").read_text()
+        assert "current session" in content
+
+    def test_engineering_guides_are_deployed_at_the_rendered_path(self, tmp_path):
+        out = tmp_path / "opencode"
+        deploy(format="opencode", target=str(out))
+
+        guide = out / "skills" / "_rules" / "guides" / "caching.md"
+        assert guide.is_file()
+        assert "## Trigger" in guide.read_text(encoding="utf-8")
 
 
 # ===========================================================================

{pactkit_opencode-2.22.0 → pactkit_opencode-2.23.0}/tests/test_story071_opencode_config_parity.py

@@ -155,10 +155,9 @@ class TestAC6RulesModularization:
         out = tmp_path / "oc"
         deploy(format="opencode", target=str(out))
         rule_files = list((out / "rules").glob("*.md"))
-        # Post-merge layout: the 8 VALID_RULES components deploy as one merged
-        # pactkit.md (+ user-managed credential file when present)
+        # Scenario-driven layout: only Runtime is globally loaded.
         assert len(rule_files) >= 1
-        assert (out / "rules" / "pactkit.md").exists()
+        assert (out / "rules" / "pactkit-runtime.md").exists()
 
     def test_agents_md_slim(self, tmp_path):
         """AGENTS.md is slim (< 30 lines) after modularization."""
@@ -190,7 +189,7 @@ class TestAC6RulesModularization:
 
 
 class TestAC7GlobalOpencodeJson:
-    """AC7: Global opencode.json has instructions with rules/*.md."""
+    """AC7: Global opencode.json loads only the Runtime Kernel."""
 
     def test_global_json_created(self, tmp_path):
         """opencode.json is created in the opencode root."""
@@ -198,14 +197,13 @@ class TestAC7GlobalOpencodeJson:
         deploy(format="opencode", target=str(out))
         assert (out / "opencode.json").is_file()
 
-    def test_instructions_contains_credential_only(self, tmp_path):
-        """STORY-slim-011: instructions only contains 09-credential-safety (rules are per-command)."""
+    def test_instructions_contains_runtime_only(self, tmp_path):
         out = tmp_path / "oc"
         deploy(format="opencode", target=str(out))
         data = json.loads((out / "opencode.json").read_text())
         assert "instructions" in data
         assert "rules/*.md" not in data["instructions"]
-        assert "rules/09-credential-safety.md" in data["instructions"]
+        assert data["instructions"] == ["rules/pactkit-runtime.md"]
         # Core rules moved to per-command injection
         assert "rules/01-core-protocol.md" not in data["instructions"]
         assert "rules/02-hierarchy-of-truth.md" not in data["instructions"]
@@ -226,6 +224,6 @@ class TestAC7GlobalOpencodeJson:
         # Provider must be preserved
         assert "provider" in data
         assert data["provider"]["anthropic"]["options"]["apiKey"] == "test-key"
-        # instructions must be added — STORY-slim-011: only credential safety
+        # The one self-contained Runtime instruction must be added.
         assert "instructions" in data
-        assert "rules/09-credential-safety.md" in data["instructions"]
+        assert "rules/pactkit-runtime.md" in data["instructions"]

pactkit_opencode-2.23.0/tests/test_story_work_units.py

@@ -0,0 +1,42 @@
+import json
+
+from pactkit.generators.deployer import _render_skill_md
+from pactkit.portable_methods import get_portable_methods
+from pactkit.profiles import get_profile
+from pactkit_opencode.deployer import OpenCodeDeployer
+
+
+def test_opencode_uses_native_current_session_contract_without_portable_methods(tmp_path):
+    OpenCodeDeployer().deploy(target=tmp_path)
+    method = tmp_path / "skills/pactkit-method-spec-writing/SKILL.md"
+    assert not method.exists()
+    assert not list((tmp_path / "skills").glob("pactkit-method-*"))
+    plan = (tmp_path / "commands/project-plan.md").read_text()
+    assert "pactkit work-unit acquire" not in plan
+    assert "Codex runner" not in plan
+    assert "current session" in plan
+    manifest = json.loads((tmp_path / ".pactkit-deployed.json").read_text())
+    assert manifest["host_capabilities"]["execution_mode"] == "portable"
+    assert manifest["workflow_continuation"]["stop_hook_required"] is False
+    assert len(manifest["skills"]) == 13
+
+
+def test_opencode_upgrade_removes_only_unmodified_portable_methods(tmp_path):
+    profile = get_profile("opencode")
+    methods = get_portable_methods()
+    generated = tmp_path / "skills" / methods[0]["name"] / "SKILL.md"
+    generated.parent.mkdir(parents=True)
+    generated.write_text(
+        _render_skill_md(methods[0], profile, profile.skills_path_var),
+        encoding="utf-8",
+    )
+    customized = tmp_path / "skills" / methods[1]["name"] / "SKILL.md"
+    customized.parent.mkdir(parents=True)
+    customized.write_text("user-owned method customization\n", encoding="utf-8")
+
+    OpenCodeDeployer().deploy(config={}, target=tmp_path)
+
+    assert not generated.parent.exists()
+    assert customized.read_text(encoding="utf-8") == (
+        "user-owned method customization\n"
+    )

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

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