pactkit 2.7.0__tar.gz → 2.8.0__tar.gz

{pactkit-2.7.0 → pactkit-2.8.0}/.github/workflows/publish.yml

@@ -27,8 +27,8 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]" || pip install -e .
-          pip install pytest ruff
+          pip install --no-deps -e ".[dev]" || pip install --no-deps -e .
+          pip install pyyaml pytest ruff
 
       - name: Lint
         run: ruff check src/ tests/

{pactkit-2.7.0 → pactkit-2.8.0}/.opencode/pactkit.yaml

@@ -2,7 +2,7 @@
 # Edit this file to customize which components are deployed.
 # Remove items from a list to disable them. Default: all enabled.
 
-version: "2.6.1"
+version: "2.8.0"
 stack: python
 root: .
 developer: "slim"
@@ -23,18 +23,19 @@ agents:
 commands:
   - project-act
   - project-check
+  - project-clarify
   - project-design
   - project-done
   - project-hotfix
   - project-init
   - project-plan
-  - project-sprint
-  - project-clarify
   - project-pr
   - project-release
+  - project-sprint
 
 # Skills — tool scripts
 skills:
+  - pactkit-analyze
   - pactkit-board
   - pactkit-doctor
   - pactkit-draw
@@ -44,7 +45,6 @@ skills:
   - pactkit-status
   - pactkit-trace
   - pactkit-visualize
-  - pactkit-analyze
   - project-act
   - project-check
   - project-clarify

{pactkit-2.7.0 → pactkit-2.8.0}/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.8.0] - 2026-03-27
+
+### Added
+- **3-IDE default install** — `pip install pactkit` now installs all three IDE adapters (Claude Code + OpenCode + Codex) out of the box.
+
+### Fixed
+- **OpenCode command architecture** — Reverted OpenCode from skills-only back to `commands/` + `skills/` dual architecture. OpenCode auto-discovers commands from `commands/*.md` (invoked via `/project-plan`), while embedded skills in `skills/` are loaded by AI agent on demand. `opencode.json` command entries now only contain model routing (no `template` field — it was incorrectly treated as file path, but is actually inline text).
+- **Spec version confusion** — `/project-plan` Phase 3.2a no longer reads version from `pactkit.yaml` (PactKit toolkit version). Now explicitly reads from project's package manifest (`pyproject.toml`, `package.json`, `Cargo.toml`).
+- **OpenCode path isolation** — All deployed OpenCode files reference `~/.config/opencode/` paths, CLI commands replaced with `python3 ~/.config/opencode/skills/*/scripts/*.py` invocations.
+- **pactkit.yaml simplification** — Removed redundant component lists (agents/commands/skills/rules) from yaml template. Absence = deploy all from `VALID_*` sets. `pactkit doctor` drift check skips absent keys.
+
+### Changed
+- **Cross-IDE command architecture**:
+  - Claude Code: skills-only (`skills/project-*/SKILL.md`), prefix `/`
+  - OpenCode: commands + skills (`commands/project-*.md` + `skills/pactkit-*/SKILL.md`), prefix `/`
+  - Codex: skills-only (`skills/project-*/SKILL.md`), prefix `$`
+
 ## [2.7.0] - 2026-03-27
 
 ### Added

{pactkit-2.7.0 → pactkit-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.7.0
+Version: 2.8.0
 Summary: Spec-driven agentic DevOps toolkit for AI coding assistants
 Project-URL: Homepage, https://pactkit.dev
 Project-URL: Repository, https://github.com/pactkit/pactkit-public
@@ -21,7 +21,8 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.10
-Requires-Dist: pactkit-opencode>=2.6.0
+Requires-Dist: pactkit-codex>=2.8.0
+Requires-Dist: pactkit-opencode>=2.8.0
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: multilang
 Requires-Dist: tree-sitter-go>=0.25; extra == 'multilang'

{pactkit-2.7.0 → pactkit-2.8.0}/pyproject.toml

@@ -4,14 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.7.0"
+version = "2.8.0"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
 dependencies = [
     "pyyaml>=6.0",
-    "pactkit-opencode>=2.6.0",
+    "pactkit-opencode>=2.8.0",
+    "pactkit-codex>=2.8.0",
 ]
 
 authors = [

{pactkit-2.7.0 → pactkit-2.8.0}/src/pactkit/__init__.py

@@ -1,3 +1,3 @@
 """PactKit - Spec-driven agentic DevOps toolkit."""
 
-__version__ = "2.7.0"
+__version__ = "2.8.0"

{pactkit-2.7.0 → pactkit-2.8.0}/src/pactkit/config.py

@@ -448,14 +448,12 @@ def auto_merge_config_file(path: Union[Path, str]) -> list[str]:
     added: list[str] = []
 
     # --- List-type keys: merge new items ---
+    # If a list key is absent from yaml, it means "deploy all" (VALID_* default).
+    # Only merge if the user explicitly provides a list (opt-in customization).
     for key, valid_set in _REGISTRY.items():
         user_list = user_data.get(key)
         if user_list is None:
-            # BUG-013: key missing from user yaml → backfill full default list
-            excluded_items = set(exclude.get(key, []) or [])
-            new_items = sorted(item for item in valid_set if item not in excluded_items)
-            user_data[key] = new_items
-            added.append(f"section: {key}")
+            # Key absent = deploy all by default. No backfill needed.
             continue
         if not isinstance(user_list, list):
             continue
@@ -900,34 +898,14 @@ def generate_default_yaml() -> str:
     cfg = get_default_config()
     lines = [
         "# PactKit Configuration",
-        "# Edit this file to customize which components are deployed.",
-        "# Remove items from a list to disable them. Default: all enabled.",
+        "# All agents, commands, skills, and rules are deployed by default.",
+        "# To exclude specific items, add an exclude list (e.g., exclude_skills: [pactkit-draw]).",
         "",
         f'version: "{cfg["version"]}"',
         f"stack: {cfg['stack']}",
         f"root: {cfg['root']}",
         f'developer: "{cfg["developer"]}"',
-        "",
-        "# Agents — AI role definitions",
-        "agents:",
     ]
-    for a in cfg["agents"]:
-        lines.append(f"  - {a}")
-
-    lines.extend(["", "# Commands — PDCA playbooks"])
-    lines.append("commands:")
-    for c in cfg["commands"]:
-        lines.append(f"  - {c}")
-
-    lines.extend(["", "# Skills — tool scripts"])
-    lines.append("skills:")
-    for s in cfg["skills"]:
-        lines.append(f"  - {s}")
-
-    lines.extend(["", "# Rules — constitution modules"])
-    lines.append("rules:")
-    for r in cfg["rules"]:
-        lines.append(f"  - {r}")
 
     ci = cfg.get("ci", {})
     lines.extend(["", "# CI/CD — set provider to github or gitlab to generate pipeline config"])

{pactkit-2.7.0 → pactkit-2.8.0}/src/pactkit/doctor.py

@@ -55,6 +55,10 @@ def check_orphaned_specs(project_root: Path) -> dict:
 def check_config_drift(project_root: Path) -> dict:
     """Compare pactkit.yaml declared items vs deployed files.
 
+    Only checks deployment drift when the yaml explicitly declares
+    component lists (agents, commands, skills, rules). Default behavior
+    (no lists) means "deploy all from VALID_* sets" — no drift possible.
+
     Returns:
         {"missing_deployments": [{"type": ..., "name": ...}]}
     """
@@ -69,33 +73,32 @@ def check_config_drift(project_root: Path) -> dict:
     with open(yaml_path, encoding="utf-8") as f:
         data = yaml.safe_load(f) or {}
 
-    config_dir = yaml_path.parent  # .claude/ or .opencode/
+    config_dir = yaml_path.parent  # .claude/ or .opencode/ or .codex/
     missing: list[dict] = []
 
-    # Check agents
-    for agent in data.get("agents", []):
-        agent_file = config_dir / "agents" / f"{agent}.md"
-        if not agent_file.exists():
-            missing.append({"type": "agent", "name": agent})
-
-    # Check commands
-    for cmd in data.get("commands", []):
-        cmd_file = config_dir / "commands" / f"{cmd}.md"
-        if not cmd_file.exists():
-            missing.append({"type": "command", "name": cmd})
-
-    # Check skills
-    for skill in data.get("skills", []):
-        skill_dir = config_dir / "skills" / skill
-        skill_file = config_dir / "skills" / f"{skill}.md"
-        if not skill_dir.is_dir() and not skill_file.exists():
-            missing.append({"type": "skill", "name": skill})
-
-    # Check rules
-    for rule in data.get("rules", []):
-        rule_file = config_dir / "rules" / f"{rule}.md"
-        if not rule_file.exists():
-            missing.append({"type": "rule", "name": rule})
+    # Only check drift for explicitly declared lists.
+    # If the key is absent, it means "deploy all" — no drift to check.
+    _CHECKS = [
+        ("agents", "agents", ".md"),
+        ("commands", "commands", ".md"),
+        ("rules", "rules", ".md"),
+    ]
+    for key, subdir, suffix in _CHECKS:
+        declared = data.get(key)
+        if not isinstance(declared, list):
+            continue
+        for item in declared:
+            if not (config_dir / subdir / f"{item}{suffix}").exists():
+                missing.append({"type": key.rstrip("s"), "name": item})
+
+    # Skills: check as directory or .md file
+    declared_skills = data.get("skills")
+    if isinstance(declared_skills, list):
+        for skill in declared_skills:
+            skill_dir = config_dir / "skills" / skill
+            skill_file = config_dir / "skills" / f"{skill}.md"
+            if not skill_dir.is_dir() and not skill_file.exists():
+                missing.append({"type": "skill", "name": skill})
 
     return {"missing_deployments": missing}
 

{pactkit-2.7.0 → pactkit-2.8.0}/src/pactkit/generators/deployer.py

@@ -301,10 +301,10 @@ def _deploy_classic(config=None, target=None):
         d.mkdir(parents=True, exist_ok=True)
 
     # Deploy components filtered by config
-    enabled_skills = config.get("skills", [])
-    enabled_rules = config.get("rules", [])
-    enabled_agents = config.get("agents", [])
-    enabled_commands = config.get("commands", [])
+    enabled_skills = config.get("skills", sorted(VALID_SKILLS))
+    enabled_rules = config.get("rules", sorted(VALID_RULES))
+    enabled_agents = config.get("agents", sorted(VALID_AGENTS))
+    enabled_commands = config.get("commands", sorted(VALID_COMMANDS))
 
     classic_profile = get_profile("classic")
     n_skills = _deploy_skills(skills_dir, enabled_skills, profile=classic_profile)

{pactkit-2.7.0 → pactkit-2.8.0}/src/pactkit/prompts/commands.py

@@ -90,7 +90,7 @@ allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
 1.  **Scaffold**: Run `{SCAFFOLD_CMD} create_spec "{ID}" "{title}"` to generate `docs/specs/{ID}.md` from SPEC_TEMPLATE. This creates all sections, tables, and Given/When/Then skeleton — format is guaranteed by Code.
 2.  **Read**: Read `docs/specs/{ID}.md` to see the scaffolded template.
 3.  **Edit placeholders** (use Edit tool, NOT Write):
-    - Edit `Release | TBD` → `Release | {version}` (read version from `{PACTKIT_YAML}` or `pyproject.toml`; if unreadable, keep TBD)
+    - Edit `Release | TBD` → `Release | {version}` (from `pyproject.toml`/`package.json`, NOT `{PACTKIT_YAML}`)
     - Edit `(Description of the problem or feature)` → actual Background content from your Trace findings
     - Edit `## Target Call Chain` placeholder → actual call chain from Phase 1
     - Edit `### R1: (Requirement Name) (MUST)` → actual requirements using RFC 2119 keywords (MUST/SHOULD/MAY). Add more R{N} sections as needed.
@@ -519,18 +519,28 @@ description: "Standalone requirement clarification before planning"
 allowed-tools: [Read, Bash, Glob, Grep]
 ---
 
-# Command: Clarify (v1.0.0)
+# Command: Clarify (v1.1.0)
 - **Usage**: `/project-clarify "$ARGUMENTS"`
 - **Agent**: System Architect
 
-> **PURPOSE**: Standalone requirement clarification. Run before `/project-plan` to surface ambiguities and produce a clarified brief.
+> **PURPOSE**: Standalone requirement clarification. Run before `/project-plan` to surface ambiguities and assess risks upfront.
 
 ## Phase 1: Ambiguity Analysis
 1.  Analyze `$ARGUMENTS` against the AMBIGUITY_SIGNALS checklist (same as Plan Phase 0.7).
 2.  Generate 3–6 structured questions (Scope, Users, Constraints, Scale, Edge Cases, Non-Goals).
 3.  Ask questions in the user's language.
 
-## Phase 2: Clarified Brief Output
+## Phase 2: Pre-mortem Risk Probe
+> **PURPOSE**: Reverse thinking — identify how the plan could fail before it starts.
+1.  Based on `$ARGUMENTS` and Phase 1 findings, generate 1–2 pre-mortem questions (pick the most relevant):
+    - "If this feature is deemed a failure 1 month after launch, what is the most likely reason?"
+    - "What assumptions does this plan rely on? Which assumption is the most fragile?"
+    - "What will the person maintaining this code in 6 months complain about the most?"
+    - "What is the most likely integration point to break?"
+2.  Ask in the user's language, together with Phase 1 questions.
+3.  Total questions across Phase 1 + Phase 2 MUST NOT exceed 6. If Phase 1 already has 5–6, pick only 1 pre-mortem question. If Phase 1 has ≤ 4, pick up to 2.
+
+## Phase 3: Clarified Brief Output
 1.  After user responses, produce a **Clarified Brief**:
     ```markdown
     ## Clarified Brief: {feature name}
@@ -540,6 +550,7 @@ allowed-tools: [Read, Bash, Glob, Grep]
     - **Scale**: {performance expectations}
     - **Edge Cases**: {failure scenarios and expected behavior}
     - **Non-Goals**: {explicitly excluded}
+    - **Risks**: {top 1-2 identified risks from pre-mortem}
     ```
 2.  Output: "Ready for Plan. Run: `/project-plan \\"{clarified brief summary}\\"`"
 """,

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_bug013_config_single_source.py

@@ -154,10 +154,10 @@ class TestAC2NewConfigAtProjectPath:
             'Full config should be generated at $CWD/.claude/pactkit.yaml'
 
         generated = yaml.safe_load(project_yaml.read_text())
-        assert 'agents' in generated, 'Generated config should have agents list'
-        assert 'commands' in generated, 'Generated config should have commands list'
-        assert 'skills' in generated, 'Generated config should have skills list'
-        assert 'rules' in generated, 'Generated config should have rules list'
+        # Component lists (agents, commands, skills, rules) are no longer in yaml —
+        # default is "deploy all" from VALID_* sets. Only operational config remains.
+        assert 'stack' in generated, 'Generated config should have stack'
+        assert 'version' in generated, 'Generated config should have version'
 
     def test_no_config_at_global_path(self, tmp_path):
         from pactkit.generators.deployer import deploy

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_config.py

@@ -223,11 +223,15 @@ class TestGenerateDefaultYaml:
         parsed = yaml.safe_load(result)
         assert isinstance(parsed, dict)
 
-    def test_roundtrip_equals_default(self):
+    def test_roundtrip_contains_core_keys(self):
+        """Generated YAML has operational config but not component lists."""
         result = _config().generate_default_yaml()
         parsed = yaml.safe_load(result)
-        default = _config().get_default_config()
-        assert parsed == default
+        assert "stack" in parsed
+        assert "version" in parsed
+        # Component lists omitted — default is "deploy all" from VALID_* sets
+        for key in ("agents", "commands", "skills", "rules"):
+            assert key not in parsed
 
     def test_contains_comments(self):
         result = _config().generate_default_yaml()

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_config_auto_merge.py

@@ -246,8 +246,8 @@ class TestBackwardCompatibility:
         added = cfg.auto_merge_config_file(yaml_path)
         assert added == []
 
-    def test_yaml_with_only_scalar_keys_backfills_lists(self, tmp_path):
-        """BUG-013: missing list keys are backfilled with full defaults."""
+    def test_yaml_with_only_scalar_keys_no_backfill(self, tmp_path):
+        """Missing list keys are NOT backfilled — absence means 'deploy all'."""
         cfg = _config()
         yaml_path = tmp_path / 'pactkit.yaml'
         _write_yaml(yaml_path, {
@@ -260,11 +260,10 @@ class TestBackwardCompatibility:
         })
 
         added = cfg.auto_merge_config_file(yaml_path)
-        section_reports = [r for r in added if r.startswith('section:')]
-        assert 'section: agents' in section_reports
-        assert 'section: commands' in section_reports
-        assert 'section: skills' in section_reports
-        assert 'section: rules' in section_reports
+        # No list backfill — missing keys mean "deploy all"
+        list_keys = {'agents', 'commands', 'skills', 'rules'}
+        list_backfills = [r for r in added if any(r == f'section: {k}' for k in list_keys)]
+        assert len(list_backfills) == 0
 
     def test_full_list_nothing_added(self, tmp_path):
         """If user already has all VALID items and sections, nothing is added."""

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_selective_deploy.py

@@ -229,7 +229,7 @@ class TestConfigAutoGeneration:
         yaml_path = claude / "pactkit.yaml"
         parsed = yaml.safe_load(yaml_path.read_text())
         assert parsed is not None
-        assert "agents" in parsed
+        assert "stack" in parsed
 
 
 # ===========================================================================

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_story033_config_backfill.py

@@ -233,13 +233,13 @@ class TestAC4BackfillReport:
         assert len(section_reports) == 0
 
     def test_reports_multiple_sections(self, tmp_path):
-        """All missing sections reported when all are absent (BUG-013: includes lists)."""
+        """All missing non-list sections reported when absent."""
         yaml_path = tmp_path / 'pactkit.yaml'
         yaml_path.write_text('stack: python\nversion: "1.2.0"\nroot: .\n')
         result = auto_merge_config_file(yaml_path)
         section_reports = [r for r in result if r.startswith('section:')]
-        # 4 list-type (agents, commands, skills, rules) + 12 non-list (ci, issue_tracker, hooks, lint_blocking, auto_fix, e2e, venv, release, regression, check, done, visualize)
-        assert len(section_reports) == 16
+        # 12 non-list sections only (list-type keys no longer backfilled)
+        assert len(section_reports) == 12
 
 
 # ===========================================================================

{pactkit-2.7.0 → pactkit-2.8.0}/tests/unit/test_story063_prompt_slimming.py

@@ -197,7 +197,8 @@ class TestAC6DevRefGhostResolved:
 # AC7: Total Prompt Size Reduced >= 15%
 # ---------------------------------------------------------------------------
 # STORY-slim-050: bumped +393 for Done smart regression gate (R2)
-BASELINE_TOTAL_CHARS = 73975
+# HOTFIX: bumped +875 for Clarify pre-mortem risk probe
+BASELINE_TOTAL_CHARS = 74850
 
 
 class TestAC7PromptSizeReduced: