pactkit 2.9.2__tar.gz → 2.9.5__tar.gz

{pactkit-2.9.2 → pactkit-2.9.5}/.github/workflows/ci.yml

@@ -24,8 +24,8 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install --no-deps -e ".[multilang]"
-          pip install pyyaml pytest ruff==0.15.1
+          pip install --no-deps -e .
+          pip install pyyaml pytest ruff==0.15.1 tree-sitter tree-sitter-go tree-sitter-java tree-sitter-typescript
 
       - name: Lint with ruff
         run: ruff check src/ tests/

{pactkit-2.9.2 → pactkit-2.9.5}/.github/workflows/pactkit.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[multilang]"
+          pip install -e .
           pip install pytest ruff
           pactkit init
 

{pactkit-2.9.2 → pactkit-2.9.5}/.gitignore

@@ -45,6 +45,12 @@ docs/architecture/governance/
 # Claude Code local config
 .claude/
 
+# Codex CLI local config
+.codex/
+
+# Plugin deployment artifacts (generated by pactkit update)
+pactkit-plugin/
+
 # Secrets
 .pypirc
 

{pactkit-2.9.2 → pactkit-2.9.5}/.opencode/pactkit.yaml

@@ -1,8 +1,8 @@
 # PactKit Configuration
-# All agents, commands, skills, and rules are deployed by default.
-# To exclude specific items, add an exclude list (e.g., exclude_skills: [pactkit-draw]).
+# Edit this file to customize which components are deployed.
+# Remove items from a list to disable them. Default: all enabled.
 
-version: "2.9.1"
+version: "2.9.5"
 stack: python
 root: .
 developer: "slim"
@@ -10,7 +10,10 @@ developer: "slim"
 # CI/CD — set provider to github or gitlab to generate pipeline config
 ci:
   provider: github
-  install_cmd: "python -m pip install --upgrade pip\n          pip install -e \".[multilang]\"\n          pip install pytest ruff\n          pactkit init"
+  # runner: ubuntu-latest
+  # language_version: "3.11"
+  # github_host: ""  # GHE server (empty = github.com)
+  # actions_ref: ""  # GHE actions prefix
 
 # Issue Tracker — set provider to github to link stories to issues
 issue_tracker:

{pactkit-2.9.2 → pactkit-2.9.5}/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.9.4] - 2026-03-31
+
+### Fixed
+- **Init playbook DIP violation** (STORY-slim-074) — Eliminated `DETECTED_ENV` runtime IDE detection; all hardcoded paths replaced with template variables (`{FORMAT_NAME}`, `{PROJECT_CONFIG_DIR}`, etc.). Adding a new IDE format now requires zero playbook changes.
+- **Full DIP audit** — Fixed hardcoded IDE paths in doctor skill, core-protocol rule, and done command.
+- **tree-sitter promoted to core dependency** — No longer optional; CI install updated to include `tree-sitter-go`, `tree-sitter-java`, `tree-sitter-typescript`.
+- **`--focus` scan optimization** — `_scan_files` now scans only the focused subdirectory, not the full project root. `pactkit visualize --focus` without `--mode` now correctly passes focus through.
+- **SCAN_EXCLUDES expanded** — From 13 to 30+ entries covering Go (`vendor`), Java (`target`, `.gradle`, `.mvn`), Node (`.next`, `.nuxt`, `.turbo`), IDE (`.idea`, `.vscode`), VCS (`.svn`, `.hg`), and more.
+- **Codex pactkit.yaml candidates** — 3 functions in `visualize.py` now include `.codex/pactkit.yaml` in search paths.
+- **Topology markers** — `_TOPOLOGY_MARKERS` and `PdcaParser.markers` now include all 3 IDE format directories.
+
+## [2.9.3] - 2026-03-31
+
+### Added
+- **Multi-language call chain fix** (STORY-slim-069) — Dispatch hint comment parsing (`pactkit-trace: dispatches_to`) and inheritance edge linking extended from Python-only to Go (struct embedding), Java (extends/implements), and TypeScript (class extends) tree-sitter analyzers.
+- **CLI visualize args exposed** (HOTFIX-slim-070) — `--entry`, `--focus`, `--reverse`, `--depth`, `--max-nodes` now reachable from `pactkit visualize` CLI.
+
+### Fixed
+- **4 call chain断链** (STORY-slim-068) — dict.update scan collision, dynamic dispatch hints, abstract method orphan nodes, cross-package stub edges.
+- **CI install command** — Fallback from `.[multilang]` to `.[dev]` in generated pactkit.yml.
+
 ## [2.9.2] - 2026-03-30
 
 ### Fixed

{pactkit-2.9.2 → pactkit-2.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.9.2
+Version: 2.9.5
 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
@@ -24,11 +24,10 @@ Requires-Python: >=3.10
 Requires-Dist: pactkit-codex>=2.9.0
 Requires-Dist: pactkit-opencode>=2.9.0
 Requires-Dist: pyyaml>=6.0
-Provides-Extra: multilang
-Requires-Dist: tree-sitter-go>=0.25; extra == 'multilang'
-Requires-Dist: tree-sitter-java>=0.23; extra == 'multilang'
-Requires-Dist: tree-sitter-typescript>=0.23; extra == 'multilang'
-Requires-Dist: tree-sitter>=0.25; extra == 'multilang'
+Requires-Dist: tree-sitter-go>=0.25
+Requires-Dist: tree-sitter-java>=0.23
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.25
 Description-Content-Type: text/markdown
 
 <p align="center">

{pactkit-2.9.2 → pactkit-2.9.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.9.2"
+version = "2.9.5"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"
@@ -13,6 +13,10 @@ dependencies = [
     "pyyaml>=6.0",
     "pactkit-opencode>=2.9.0",
     "pactkit-codex>=2.9.0",
+    "tree-sitter>=0.25",
+    "tree-sitter-go>=0.25",
+    "tree-sitter-java>=0.23",
+    "tree-sitter-typescript>=0.23",
 ]
 
 authors = [
@@ -47,14 +51,6 @@ classifiers = [
     "Topic :: Software Development :: Quality Assurance",
 ]
 
-[project.optional-dependencies]
-multilang = [
-    "tree-sitter>=0.25",
-    "tree-sitter-go>=0.25",
-    "tree-sitter-java>=0.23",
-    "tree-sitter-typescript>=0.23",
-]
-
 [project.urls]
 Homepage = "https://pactkit.dev"
 Repository = "https://github.com/pactkit/pactkit-public"

{pactkit-2.9.2 → pactkit-2.9.5}/src/pactkit/__init__.py

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

{pactkit-2.9.2 → pactkit-2.9.5}/src/pactkit/cli.py

@@ -223,8 +223,13 @@ def main():
     regression_parser = subparsers.add_parser("regression", help="Classify changes for regression testing")
     regression_parser.add_argument("files", nargs="*", help="Changed file paths (default: git diff)")
 
-    # pactkit context (STORY-slim-014 R1)
-    subparsers.add_parser("context", help="Generate docs/product/context.md")
+    # pactkit context (STORY-slim-014 R1, STORY-slim-071 continuation)
+    ctx_parser = subparsers.add_parser("context", help="Generate docs/product/context.md")
+    ctx_parser.add_argument("--continuation", action="store_true", default=False,
+                            help="Update Agent Continuation section")
+    ctx_parser.add_argument("--last-command", default=None, help="Last PDCA command run")
+    ctx_parser.add_argument("--phase", default=None, help="Phase reached")
+    ctx_parser.add_argument("--blockers", default=None, help="Blockers or open questions")
 
     # pactkit sec-scope (STORY-slim-014 R6)
     sec_scope_parser = subparsers.add_parser("sec-scope", help="Auto-detect security scope")
@@ -252,6 +257,22 @@ def main():
         "--mode", choices=["file", "class", "call"], default=None,
         help="Graph mode (default: all three)",
     )
+    # HOTFIX-slim-070: expose visualize.py args to CLI
+    viz_parser.add_argument("--entry", default=None, help="Entry function for call graph BFS")
+    viz_parser.add_argument("--focus", default=None, help="Focus on specific module")
+    viz_parser.add_argument("--reverse", action="store_true", default=False, help="Reverse BFS: find callers of entry")
+    viz_parser.add_argument("--depth", type=int, default=0, help="Limit traversal depth (0=unlimited)")
+    viz_parser.add_argument("--max-nodes", type=int, default=0, help="Truncate graph to N nodes (0=unlimited)")
+
+    # pactkit garden (STORY-slim-070)
+    garden_parser = subparsers.add_parser("garden", help="Codebase quality patrol")
+    garden_parser.add_argument("--json", action="store_true", default=False, help="JSON output")
+    garden_parser.add_argument("--scope", default=None, help="Scan only this directory (relative path)")
+
+    # pactkit observe (STORY-slim-073)
+    observe_parser = subparsers.add_parser("observe", help="Collect runtime observability signals")
+    observe_parser.add_argument("--report", action="store_true", default=False, help="Human-readable report")
+    observe_parser.add_argument("--json", action="store_true", default=False, help="JSON output")
 
     # pactkit doctor (STORY-slim-015 R1-R3)
     subparsers.add_parser("doctor", help="Diagnose project health")
@@ -415,7 +436,19 @@ def main():
 
         from pactkit.context_gen import generate_context
 
-        content = generate_context(Path.cwd(), command="pactkit context")
+        continuation_args = None
+        if args.continuation and args.last_command:
+            continuation_args = {"last_command": args.last_command}
+            if args.phase:
+                continuation_args["phase"] = args.phase
+            if args.blockers:
+                continuation_args["blockers"] = args.blockers
+
+        content = generate_context(
+            Path.cwd(),
+            command="pactkit context",
+            continuation_args=continuation_args,
+        )
         ctx_path = Path.cwd() / "docs" / "product" / "context.md"
         ctx_path.parent.mkdir(parents=True, exist_ok=True)
         ctx_path.write_text(content, encoding="utf-8")
@@ -485,9 +518,31 @@ def main():
             print(f"Visualize needed: {reason}")
         # HOTFIX-slim-023: support --mode for single or all modes
         if args.mode:
-            run_visualize_single(project_root, args.mode)
+            run_visualize_single(
+                project_root, args.mode,
+                entry=args.entry, focus=args.focus, reverse=args.reverse,
+                depth=args.depth, max_nodes=args.max_nodes,
+            )
         else:
-            run_visualize_graphs(project_root)
+            run_visualize_graphs(project_root, focus=args.focus)
+
+    elif args.command == "garden":
+        from pathlib import Path
+
+        from pactkit.garden import run_garden
+
+        root = Path.cwd()
+        scope = Path(args.scope) if args.scope else None
+        output, exit_code = run_garden(root, scope=scope, json_output=args.json)
+        print(output)
+        raise SystemExit(exit_code)
+
+    elif args.command == "observe":
+        from pactkit.observe import run_observe
+
+        output, exit_code = run_observe(report=args.report, json_output=args.json)
+        print(output)
+        raise SystemExit(exit_code)
 
     elif args.command == "doctor":
         from pathlib import Path

{pactkit-2.9.2 → pactkit-2.9.5}/src/pactkit/config.py

@@ -55,6 +55,7 @@ VALID_SKILLS = frozenset(
         "pactkit-draw",
         "pactkit-status",
         "pactkit-doctor",
+        "pactkit-garden",
         "pactkit-review",
         "pactkit-release",
         "pactkit-analyze",
@@ -180,6 +181,18 @@ def get_default_config() -> dict:
         "check": {
             "security_checklist": True,
             "security_scope_override": "none",
+            "pactguard": {
+                "enabled": False,
+                "mode": "all",
+                "ruleset": "",
+                "blocking": False,
+            },
+            "observe": {
+                "enabled": False,
+                "sources": "auto",
+                "max_console": 100,
+                "max_network": 200,
+            },
         },
         "e2e": {
             "type": "none",
@@ -396,8 +409,15 @@ def load_config(path: Path | str | None = None) -> dict:
         if key in merged:
             # BUG-022: Deep merge for nested dict sections
             if key in DEEP_MERGE_KEYS and isinstance(merged[key], dict) and isinstance(value, dict):
-                # Preserve default sub-keys, override with user values
-                merged[key] = {**merged[key], **value}
+                # Two-level deep merge: for sub-keys that are also dicts, merge them too
+                # (e.g., check.pactguard, check.observe)
+                result = {**merged[key]}
+                for sub_key, sub_value in value.items():
+                    if sub_key in result and isinstance(result[sub_key], dict) and isinstance(sub_value, dict):
+                        result[sub_key] = {**result[sub_key], **sub_value}
+                    else:
+                        result[sub_key] = sub_value
+                merged[key] = result
             else:
                 # Shallow override for non-dict keys (strings, lists, booleans)
                 merged[key] = value
@@ -642,7 +662,7 @@ def _rewrite_yaml(path: Path, data: dict) -> None:
         lines.append(f"  max_impact_tests: {regression.get('max_impact_tests', 50)}")
         lines.append("")
 
-    # Write check section (STORY-055, STORY-056)
+    # Write check section (STORY-055, STORY-056, STORY-slim-072, STORY-slim-073)
     check = data.get("check", {})
     if isinstance(check, dict):
         lines.append("# Check — configure QA verification behavior")
@@ -651,6 +671,22 @@ def _rewrite_yaml(path: Path, data: dict) -> None:
         lines.append(f"  security_checklist: {'true' if sc else 'false'}")
         sso = check.get("security_scope_override", "none")
         lines.append(f"  security_scope_override: {sso}")
+        # PactGuard sub-section (STORY-slim-072)
+        pg = check.get("pactguard", {})
+        if isinstance(pg, dict):
+            lines.append("  pactguard:")
+            lines.append(f"    enabled: {'true' if pg.get('enabled') else 'false'}")
+            lines.append(f"    mode: {pg.get('mode', 'all')}")
+            lines.append(f"    ruleset: \"{pg.get('ruleset', '')}\"")
+            lines.append(f"    blocking: {'true' if pg.get('blocking') else 'false'}")
+        # Observe sub-section (STORY-slim-073)
+        obs = check.get("observe", {})
+        if isinstance(obs, dict):
+            lines.append("  observe:")
+            lines.append(f"    enabled: {'true' if obs.get('enabled') else 'false'}")
+            lines.append(f"    sources: {obs.get('sources', 'auto')}")
+            lines.append(f"    max_console: {obs.get('max_console', 100)}")
+            lines.append(f"    max_network: {obs.get('max_network', 200)}")
         lines.append("")
 
     # Write done section (STORY-055)
@@ -832,7 +868,7 @@ def validate_config(config: dict) -> None:
         if not isinstance(max_impact, int) or max_impact <= 0:
             warnings.warn(f"regression.max_impact_tests should be a positive integer, got {max_impact!r}")
 
-    # Validate check section (STORY-055, STORY-056)
+    # Validate check section (STORY-055, STORY-056, STORY-slim-072, STORY-slim-073)
     check = config.get("check", {})
     if isinstance(check, dict):
         sc = check.get("security_checklist", True)
@@ -842,6 +878,25 @@ def validate_config(config: dict) -> None:
         if sso not in ("none", "full"):
             warnings.warn(f"check.security_scope_override should be 'none' or 'full', got {sso!r}")
 
+        # Validate check.pactguard (STORY-slim-072)
+        pactguard = check.get("pactguard", {})
+        if isinstance(pactguard, dict):
+            pg_mode = pactguard.get("mode", "all")
+            if pg_mode not in ("pattern", "all"):
+                warnings.warn(
+                    f"check.pactguard.mode should be 'pattern' or 'all', got '{pg_mode}'"
+                )
+
+        # Validate check.observe (STORY-slim-073)
+        observe = check.get("observe", {})
+        if isinstance(observe, dict):
+            obs_sources = observe.get("sources", "auto")
+            if obs_sources not in ("auto", "chrome-devtools", "playwright", "all"):
+                warnings.warn(
+                    f"check.observe.sources should be 'auto', 'chrome-devtools', "
+                    f"'playwright', or 'all', got '{obs_sources}'"
+                )
+
     # Validate done section (STORY-055)
     done_cfg = config.get("done", {})
     if isinstance(done_cfg, dict):
@@ -955,7 +1010,7 @@ def generate_default_yaml() -> str:
     lines.append(f"  strategy: {regression.get('strategy', 'impact')}")
     lines.append(f"  max_impact_tests: {regression.get('max_impact_tests', 50)}")
 
-    # Write check section (STORY-055, STORY-056)
+    # Write check section (STORY-055, STORY-056, STORY-slim-072, STORY-slim-073)
     check = cfg.get("check", {})
     lines.extend(["", "# Check — configure QA verification behavior"])
     lines.append("check:")
@@ -963,6 +1018,20 @@ def generate_default_yaml() -> str:
     lines.append(f"  security_checklist: {'true' if sc else 'false'}")
     sso = check.get("security_scope_override", "none")
     lines.append(f"  security_scope_override: {sso}")
+    # PactGuard sub-section (STORY-slim-072)
+    pg = check.get("pactguard", {})
+    lines.append("  pactguard:")
+    lines.append(f"    enabled: {'true' if pg.get('enabled') else 'false'}")
+    lines.append(f"    mode: {pg.get('mode', 'all')}")
+    lines.append(f"    ruleset: \"{pg.get('ruleset', '')}\"")
+    lines.append(f"    blocking: {'true' if pg.get('blocking') else 'false'}")
+    # Observe sub-section (STORY-slim-073)
+    obs = check.get("observe", {})
+    lines.append("  observe:")
+    lines.append(f"    enabled: {'true' if obs.get('enabled') else 'false'}")
+    lines.append(f"    sources: {obs.get('sources', 'auto')}")
+    lines.append(f"    max_console: {obs.get('max_console', 100)}")
+    lines.append(f"    max_network: {obs.get('max_network', 200)}")
 
     # Write done section (STORY-055)
     done_cfg = cfg.get("done", {})

{pactkit-2.9.2 → pactkit-2.9.5}/src/pactkit/context_gen.py

@@ -18,6 +18,7 @@ from pactkit.schemas import (
     BOARD_SECTION_DONE,
     BOARD_SECTION_IN_PROGRESS,
     CONTEXT_HEADER,
+    CONTEXT_SECTION_CONTINUATION,
     CONTEXT_SECTIONS,
     LESSONS_TABLE_HEADER,
 )
@@ -145,11 +146,104 @@ def _parse_last_lessons(lessons_path: Path, n: int = 5) -> list[str]:
     return rows[-n:]
 
 
+# ---------------------------------------------------------------------------
+# Agent Continuation helpers (STORY-slim-071)
+# ---------------------------------------------------------------------------
+
+# Pattern to extract AC titles: ### AC1: Title (R1)
+_AC_TITLE_RE = re.compile(r"^###\s+(AC\d+:\s*.+?)(?:\s*\(R\d+\))?\s*$", re.MULTILINE)
+
+# Pattern to extract story ID from command string
+_STORY_ID_FROM_CMD_RE = re.compile(r"((?:STORY|BUG|HOTFIX)-[\w]+-\d+)")
+
+
+def _sanitize_text(text: str) -> str:
+    """Sanitize free-text input: keep only the first line, strip markdown headers."""
+    # Take only the first line to prevent injection of markdown structure
+    first_line = text.split("\n")[0]
+    # Remove any markdown header markers
+    sanitized = re.sub(r"#{1,6}\s+", "", first_line)
+    return sanitized.strip()
+
+
+def _extract_sprint_contract(spec_path: Path) -> str:
+    """Extract AC titles from a spec file as a markdown checklist.
+
+    Returns a string like:
+        ### Sprint Contract (STORY-slim-070)
+        - [ ] AC1: First Check
+        - [ ] AC2: Second Check
+    """
+    if not spec_path.exists():
+        return ""
+
+    text = spec_path.read_text(encoding="utf-8")
+    ac_matches = _AC_TITLE_RE.findall(text)
+    if not ac_matches:
+        return ""
+
+    # Extract story ID from filename
+    stem = spec_path.stem
+    lines = [f"### Sprint Contract ({stem})"]
+    for ac_title in ac_matches:
+        lines.append(f"- [ ] {ac_title}")
+
+    return "\n".join(lines)
+
+
+def _generate_continuation(
+    project_root: Path,
+    board_text: str,
+    continuation_args: dict[str, str] | None,
+) -> str:
+    """Generate the Agent Continuation section content.
+
+    Args:
+        project_root: Project root directory.
+        board_text: The sprint board content (for detecting in-progress stories).
+        continuation_args: Dict with keys 'last_command', 'phase', 'blockers'.
+            If None, returns the default "no active session" message.
+
+    Returns:
+        Content for the ## Agent Continuation section (without the header).
+    """
+    if continuation_args is None:
+        return "No active work session."
+
+    last_cmd = _sanitize_text(continuation_args.get("last_command", "unknown"))
+    phase = _sanitize_text(continuation_args.get("phase", "unknown"))
+    blockers = continuation_args.get("blockers")
+
+    lines = [
+        f"Last Command: {last_cmd}",
+        f"Phase Reached: {phase}",
+    ]
+
+    if blockers:
+        lines.append(f"Blockers: {_sanitize_text(blockers)}")
+
+    # Extract story ID from the command to find spec
+    story_match = _STORY_ID_FROM_CMD_RE.search(last_cmd)
+    if story_match:
+        story_id = story_match.group(1)
+        spec_path = project_root / "docs" / "specs" / f"{story_id}.md"
+        contract = _extract_sprint_contract(spec_path)
+        if contract:
+            lines.append("")
+            lines.append(contract)
+
+    return "\n".join(lines)
+
+
 # ---------------------------------------------------------------------------
 # Main public API
 # ---------------------------------------------------------------------------
 
-def generate_context(project_root: Path, command: str = "pactkit context") -> str:
+def generate_context(
+    project_root: Path,
+    command: str = "pactkit context",
+    continuation_args: dict[str, str] | None = None,
+) -> str:
     """Generate the contents of docs/product/context.md.
 
     Reads the sprint board, git branch list, and lessons file, then composes
@@ -232,4 +326,12 @@ def generate_context(project_root: Path, command: str = "pactkit context") -> st
         lines.append("`/project-design`")
     lines.append("")
 
+    # ---- Agent Continuation (STORY-slim-071) ----
+    lines.append(CONTEXT_SECTION_CONTINUATION)
+    continuation_content = _generate_continuation(
+        project_root, board_text, continuation_args,
+    )
+    lines.append(continuation_content)
+    lines.append("")
+
     return "\n".join(lines)