pactkit 2.14.2__tar.gz → 2.15.0__tar.gz

{pactkit-2.14.2 → pactkit-2.15.0}/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.15.0] - 2026-06-04
+
+### Added
+- **`lint` optional dependency group** — `pip install pactkit[lint]` now includes `ruff>=0.4`. The `all` extra also includes `lint`. Users no longer need to install ruff separately for the lint gate to work.
+- **External tools documentation** — README and pactkit.dev installation pages now document recommended external tools (gh, codegraph) with install commands and fallback behavior.
+
+### Fixed
+- **CI: tree-sitter tests skip when not installed** — `test_story_slim032`, `test_story_slim033`, `test_story_slim034` now use `pytest.importorskip("tree_sitter")` so they skip gracefully in CI environments without the `visualize` extra.
+
 ## [2.14.2] - 2026-06-01
 
 ### Added

{pactkit-2.14.2 → pactkit-2.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.14.2
+Version: 2.15.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
@@ -25,12 +25,15 @@ Requires-Dist: pyyaml>=6.0
 Provides-Extra: all
 Requires-Dist: pactkit-codex>=2.9.0; extra == 'all'
 Requires-Dist: pactkit-opencode>=2.9.0; extra == 'all'
+Requires-Dist: ruff>=0.4; extra == 'all'
 Requires-Dist: tree-sitter-go>=0.25; extra == 'all'
 Requires-Dist: tree-sitter-java>=0.23; extra == 'all'
 Requires-Dist: tree-sitter-typescript>=0.23; extra == 'all'
 Requires-Dist: tree-sitter>=0.25; extra == 'all'
 Provides-Extra: codex
 Requires-Dist: pactkit-codex>=2.9.0; extra == 'codex'
+Provides-Extra: lint
+Requires-Dist: ruff>=0.4; extra == 'lint'
 Provides-Extra: opencode
 Requires-Dist: pactkit-opencode>=2.9.0; extra == 'opencode'
 Provides-Extra: visualize
@@ -117,6 +120,23 @@ Requires Python 3.10+ and one of:
 
 > `pip install pactkit` automatically installs adapters for all 3 IDEs.
 
+### Optional Extras
+
+```bash
+pip install pactkit[lint]        # Includes ruff for lint gate
+pip install pactkit[visualize]   # Includes tree-sitter for AST analysis
+pip install pactkit[all]         # Everything above + IDE adapters
+```
+
+### Recommended External Tools
+
+These tools enhance PactKit but cannot be distributed via pip:
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| [gh](https://cli.github.com) | GitHub CLI (issue sync, release, PR) | `brew install gh` |
+| [codegraph](https://www.npmjs.com/package/codegraph) | Code symbol index & call chain analysis | `npm install -g codegraph` |
+
 ## Quick Start
 
 ```bash

{pactkit-2.14.2 → pactkit-2.15.0}/README.md

@@ -75,6 +75,23 @@ Requires Python 3.10+ and one of:
 
 > `pip install pactkit` automatically installs adapters for all 3 IDEs.
 
+### Optional Extras
+
+```bash
+pip install pactkit[lint]        # Includes ruff for lint gate
+pip install pactkit[visualize]   # Includes tree-sitter for AST analysis
+pip install pactkit[all]         # Everything above + IDE adapters
+```
+
+### Recommended External Tools
+
+These tools enhance PactKit but cannot be distributed via pip:
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| [gh](https://cli.github.com) | GitHub CLI (issue sync, release, PR) | `brew install gh` |
+| [codegraph](https://www.npmjs.com/package/codegraph) | Code symbol index & call chain analysis | `npm install -g codegraph` |
+
 ## Quick Start
 
 ```bash

{pactkit-2.14.2 → pactkit-2.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.14.2"
+version = "2.15.0"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"
@@ -62,8 +62,11 @@ visualize = [
     "tree-sitter-java>=0.23",
     "tree-sitter-typescript>=0.23",
 ]
+lint = [
+    "ruff>=0.4",
+]
 all = [
-    "pactkit[opencode,codex,visualize]",
+    "pactkit[opencode,codex,visualize,lint]",
 ]
 
 [tool.hatch.build.targets.wheel]

{pactkit-2.14.2 → pactkit-2.15.0}/src/pactkit/__init__.py

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

{pactkit-2.14.2 → pactkit-2.15.0}/tests/unit/test_story_slim010_dry_refactor.py

@@ -16,40 +16,9 @@ from pathlib import Path
 # ---------------------------------------------------------------------------
 
 PROJECT_ROOT = Path(__file__).resolve().parents[2]
-# Use .opencode/pactkit.yaml (tracked in git) for CI; .claude/ is gitignored
-OPENCODE_YAML = PROJECT_ROOT / ".opencode" / "pactkit.yaml"
-PYPROJECT = PROJECT_ROOT / "pyproject.toml"
 DEPLOYER = PROJECT_ROOT / "src" / "pactkit" / "generators" / "deployer.py"
 
 
-def _read_pyproject_version() -> str:
-    for line in PYPROJECT.read_text().splitlines():
-        if line.startswith("version"):
-            return line.split("=")[1].strip().strip('"').strip("'")
-    raise ValueError("version not found in pyproject.toml")
-
-
-# ---------------------------------------------------------------------------
-# AC1: Version Consistency
-# ---------------------------------------------------------------------------
-
-
-class TestAC1VersionSync:
-    def test_opencode_yaml_exists(self):
-        """AC1: .opencode/pactkit.yaml must exist (tracked in git for CI)."""
-        assert OPENCODE_YAML.exists(), f"{OPENCODE_YAML} does not exist"
-
-    def test_opencode_yaml_version_matches_pyproject(self):
-        """AC1: .opencode/pactkit.yaml must NOT contain version (STORY-slim-102)."""
-        import yaml
-
-        data = yaml.safe_load(OPENCODE_YAML.read_text())
-        # STORY-slim-102: version removed from project yaml, tracked via global marker
-        assert "version" not in data, (
-            f".opencode/pactkit.yaml should not have a version field; got keys: {list(data.keys())}"
-        )
-
-
 # ---------------------------------------------------------------------------
 # AC2: _build_rule_id_to_key() helper
 # ---------------------------------------------------------------------------

{pactkit-2.14.2 → pactkit-2.15.0}/tests/unit/test_story_slim032.py

@@ -13,6 +13,10 @@ Tests verify:
 import sys
 from pathlib import Path
 
+import pytest
+
+pytest.importorskip("tree_sitter", reason="tree-sitter not installed (optional dep)")
+
 project_root = Path(__file__).resolve().parent.parent.parent
 if str(project_root) not in sys.path:
     sys.path.insert(0, str(project_root))

{pactkit-2.14.2 → pactkit-2.15.0}/tests/unit/test_story_slim033.py

@@ -13,6 +13,10 @@ Tests verify:
 import sys
 from pathlib import Path
 
+import pytest
+
+pytest.importorskip("tree_sitter", reason="tree-sitter not installed (optional dep)")
+
 project_root = Path(__file__).resolve().parent.parent.parent
 if str(project_root) not in sys.path:
     sys.path.insert(0, str(project_root))

{pactkit-2.14.2 → pactkit-2.15.0}/tests/unit/test_story_slim034.py

@@ -3,6 +3,10 @@ import importlib.util
 import pathlib
 import textwrap
 
+import pytest
+
+pytest.importorskip("tree_sitter", reason="tree-sitter not installed (optional dep)")
+
 # Load visualize.py as standalone module
 _vis_path = pathlib.Path(__file__).resolve().parents[2] / "src" / "pactkit" / "skills" / "visualize.py"
 _spec = importlib.util.spec_from_file_location("visualize", _vis_path)

pactkit-2.14.2/.opencode/pactkit.yaml

@@ -1,23 +0,0 @@
-# PactKit Configuration (OpenCode)
-# Only override non-default values. Absent keys = default (all enabled).
-
-stack: python
-developer: "slim"
-
-ci:
-  provider: github
-
-issue_tracker:
-  provider: github
-
-release:
-  github_release: true
-
-visualize:
-  graph_provider: codegraph
-
-agent_models:
-  code-explorer: haiku
-  product-designer: opus
-  system-architect: opus
-  system-medic: haiku