pactkit 2.4.0__tar.gz → 2.4.1__tar.gz

{pactkit-2.4.0 → pactkit-2.4.1}/.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 ".[dev]" || pip install -e .
           pip install pytest ruff
           pactkit init
 

pactkit-2.4.1/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]" || pip install -e .
+          pip install pytest ruff
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Test
+        run: pytest tests/ -v --ignore=tests/unit/test_story_slim032.py --ignore=tests/unit/test_story_slim033.py --ignore=tests/unit/test_story_slim034.py
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{pactkit-2.4.0 → pactkit-2.4.1}/.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.4.0"
+version: "2.4.1"
 stack: python
 root: .
 developer: "slim"

{pactkit-2.4.0 → pactkit-2.4.1}/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.4.1] - 2026-03-26
+
+### Fixed
+- **CI Template Override** (HOTFIX-slim-051) — `_build_github_workflow()` now reads `ci.install_cmd` from `pactkit.yaml` before falling back to `CI_PROFILES` default, preventing `pactkit update` from reverting custom install commands.
+- **Board ITEM_ID_RE** (HOTFIX-slim-052) — Regex now supports developer-prefixed IDs (`HOTFIX-slim-052`, `STORY-alice-001`), matching the pattern already used by `backfill.py` and `doctor.py`.
+
+### Added
+- **Board `move_story` Command** (HOTFIX-slim-052) — New `board.py move_story <ID> <target>` CLI subcommand moves stories between Backlog/In Progress/Done sections regardless of checkbox state.
+- **Automated PyPI Publish** — New `publish.yml` GitHub Actions workflow triggers on `v*` tags; runs full test matrix (Python 3.10-3.13) then publishes via PyPI trusted publisher (OIDC).
+
+### Changed
+- **Closed-Source Migration** — Source repo moved to `pactkit/pactkit-src` (private); public entry point at `pactkit/pactkit-public` (README, issues, install guide). PyPI distribution unchanged.
+
 ## [2.4.0] - 2026-03-25
 
 ### Added

{pactkit-2.4.0 → pactkit-2.4.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.4.0
+Version: 2.4.1
 Summary: Spec-driven agentic DevOps toolkit for AI coding assistants
 Project-URL: Homepage, https://pactkit.dev
-Project-URL: Repository, https://github.com/pactkit/pactkit
+Project-URL: Repository, https://github.com/pactkit/pactkit-public
 Project-URL: Documentation, https://pactkit.dev/docs
-Project-URL: Issues, https://github.com/pactkit/pactkit/issues
+Project-URL: Issues, https://github.com/pactkit/pactkit-public/issues
 Author: Slim
 License-Expression: MIT
 License-File: LICENSE

{pactkit-2.4.0 → pactkit-2.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.4.0"
+version = "2.4.1"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"
@@ -55,9 +55,9 @@ multilang = [
 
 [project.urls]
 Homepage = "https://pactkit.dev"
-Repository = "https://github.com/pactkit/pactkit"
+Repository = "https://github.com/pactkit/pactkit-public"
 Documentation = "https://pactkit.dev/docs"
-Issues = "https://github.com/pactkit/pactkit/issues"
+Issues = "https://github.com/pactkit/pactkit-public/issues"
 
 [project.scripts]
 pactkit = "pactkit.cli:main"

{pactkit-2.4.0 → pactkit-2.4.1}/src/pactkit/__init__.py

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

{pactkit-2.4.0 → pactkit-2.4.1}/src/pactkit/generators/deployer.py

@@ -996,9 +996,10 @@ def _build_github_workflow(stack, ci_config, lang_profile, is_ghe=False):
         for key, val in ci_prof["extra_setup"].items():
             lines.append(f"          {key}: {val}")
     lines.append("")
+    install_cmd = ci_config.get("install_cmd", ci_prof["install_cmd"])
     lines.append("      - name: Install dependencies")
     lines.append("        run: |")
-    lines.append(f"          {ci_prof['install_cmd']}")
+    lines.append(f"          {install_cmd}")
     lines.append("")
     lines.append("      - name: Lint")
     lines.append(f"        run: {lint_command}")

{pactkit-2.4.0 → pactkit-2.4.1}/src/pactkit/skills/board.py

@@ -16,7 +16,7 @@ def nl():
 # === SCRIPT BODY ===
 
 # Shared pattern for all recognized work item prefixes
-ITEM_ID_RE = r"(?:STORY|HOTFIX|BUG)-\d+"
+ITEM_ID_RE = r"(?:STORY|HOTFIX|BUG)(?:-[a-z]+)?-\d+"
 
 # Flexible story title pattern: matches ### or #### (tolerant) with [ID] or ID: or ID formats
 # Group 1: story ID, Group 2: title text
@@ -206,6 +206,54 @@ def snapshot_graph(version):
     return f"✅ Snapshot {version}: {count} graphs saved"
 
 
+# --- MOVE ---
+def move_story(sid, target):
+    """Move a story to the specified section regardless of checkbox state."""
+    valid_targets = {"backlog": _BACKLOG, "in_progress": _IN_PROGRESS, "done": _DONE}
+    if target not in valid_targets:
+        return f"❌ Invalid target: {target}. Use: backlog, in_progress, done"
+    p = Path.cwd() / "docs/product/sprint_board.md"
+    if not p.exists():
+        return "❌ No Board"
+    content = p.read_text(encoding="utf-8")
+    blocks = _parse_story_blocks(content)
+    # Find the target story
+    story_block = None
+    for block_sid, block_text in blocks:
+        if block_sid == sid:
+            story_block = block_text
+            break
+    if story_block is None:
+        return f"❌ Story {sid} not found on board"
+    # Remove the story block from its current position
+    idx = content.find(story_block)
+    if idx == -1:
+        return f"❌ Story {sid} block not found in content"
+    content = content[:idx] + content[idx + len(story_block):]
+    content = re.sub(r"\n{3,}", nl() + nl(), content)
+    # Find target section and the next section after it
+    target_header = valid_targets[target]
+    section_order = [_BACKLOG, _IN_PROGRESS, _DONE]
+    target_idx = content.find(target_header)
+    if target_idx == -1:
+        return f"❌ Section '{target_header}' not found"
+    # Find the next section header after target
+    next_section_idx = len(content)
+    for sec in section_order:
+        sec_idx = content.find(sec)
+        if sec_idx > target_idx and sec_idx < next_section_idx:
+            next_section_idx = sec_idx
+    # Insert story block just before the next section (or at end)
+    insert_point = next_section_idx
+    entry = nl() + story_block + nl() + nl()
+    content = content[:insert_point].rstrip() + entry + content[insert_point:]
+    content = re.sub(r"\n{3,}", nl() + nl(), content)
+    tmp = p.with_suffix(".tmp")
+    tmp.write_text(content, encoding="utf-8")
+    os.replace(tmp, p)
+    return f"✅ Moved {sid} to {target}"
+
+
 # --- LIST ---
 def list_stories():
     p = Path.cwd() / "docs/product/sprint_board.md"
@@ -289,6 +337,9 @@ if __name__ == "__main__":
     p_ver.add_argument("version")
     p_snap = sub.add_parser("snapshot")
     p_snap.add_argument("version")
+    p_move = sub.add_parser("move_story")
+    p_move.add_argument("story_id")
+    p_move.add_argument("target", choices=["backlog", "in_progress", "done"])
     sub.add_parser("archive")
     sub.add_parser("list_stories")
     sub.add_parser("fix_board")
@@ -306,5 +357,7 @@ if __name__ == "__main__":
         print(archive_stories())
     elif a.cmd == "list_stories":
         print(list_stories())
+    elif a.cmd == "move_story":
+        print(move_story(a.story_id, a.target))
     elif a.cmd == "fix_board":
         print(fix_board())

{pactkit-2.4.0 → pactkit-2.4.1}/src/pactkit/skills/visualize.py

@@ -875,9 +875,24 @@ def impact(target='.', entry=None):
 
 
 # --- MAIN VISUALIZE (v1.3.0 Multi-Mode) ---
-def visualize(target='.', focus=None, mode='file', entry=None, depth=0, max_nodes=0, reverse=False, lazy=False):
+def visualize(target='.', focus=None, mode='file', entry=None, depth=0, max_nodes=0, reverse=False, lazy=False, split=False):
     root = Path(target).resolve()
 
+    # --- Unified mode (STORY-slim-049) ---
+    if mode == 'unified':
+        graph = build_unified_graph(root)
+        graphs_dir = root / 'docs' / 'architecture' / 'graphs'
+        graphs_dir.mkdir(parents=True, exist_ok=True)
+        dest = graphs_dir / 'unified_graph.mmd'
+        dest.write_text(graph.to_mermaid(), encoding='utf-8')
+        result = f'✅ Graph: {dest}'
+        # HOTFIX-slim-050: auto-split only for large graphs; --split forces it
+        if split or len(graph.nodes) > MAX_WORKFLOW_NODES:
+            focus_dir = graphs_dir / 'focus'
+            written = export_focus_graphs(graph, focus_dir)
+            result += f' + {len(written)} focus graphs in {focus_dir}'
+        return result
+
     # --- Workflow mode (STORY-slim-036) ---
     if mode == 'workflow':
         dest = root / 'docs' / 'architecture' / 'graphs' / 'workflow_graph.mmd'
@@ -1006,7 +1021,7 @@ class WorkflowGraph:
         """Sanitize a string for use as a Mermaid node ID."""
         return re.sub(r'[^a-zA-Z0-9_]', '_', raw)
 
-    def to_mermaid(self) -> str:
+    def to_mermaid(self, max_render_nodes: int = 0) -> str:
         lines = ['graph TD']
         if self.layered:
             # STORY-slim-048 R3: Group by dimension for unified/layered graphs
@@ -1044,13 +1059,54 @@ class WorkflowGraph:
                     sid = self._sanitize_id(n.id)
                     lines.append(f'        {sid}["{n.label}"]')
                 lines.append('    end')
+        # STORY-slim-049 R3: max_render_nodes truncation for human-readable output
+        if max_render_nodes > 0:
+            node_lines = [ln for ln in lines[1:] if '[' in ln and 'NOTE' not in ln]
+            if len(node_lines) > max_render_nodes:
+                truncated_count = len(node_lines) - max_render_nodes
+                keep_ids = set()
+                for ln in node_lines[:max_render_nodes]:
+                    nid = ln.strip().split('[')[0].strip()
+                    keep_ids.add(nid)
+                filtered = ['graph TD']
+                for ln in lines[1:]:
+                    if '[' in ln:
+                        line_id = ln.strip().split('[')[0].strip()
+                        if line_id in keep_ids:
+                            filtered.append(ln)
+                    elif 'subgraph' in ln or 'end' == ln.strip():
+                        filtered.append(ln)
+                filtered.append(f'    NOTE["... and {truncated_count} more nodes"]')
+                lines = filtered
+
         for e in self.edges:
             src = self._sanitize_id(e.source)
             dst = self._sanitize_id(e.target)
             arrow = '-.->' if e.relation == 'sequence' else '-->'
+            if max_render_nodes > 0 and len(lines) > 1:
+                rendered_ids = {ln.strip().split('[')[0].strip() for ln in lines if '[' in ln and 'NOTE' not in ln}
+                if src not in rendered_ids or dst not in rendered_ids:
+                    continue
             lines.append(f'    {src} {arrow}|{e.relation}| {dst}')
         return nl().join(lines)
 
+    def forward_reach(self, entry_id: str) -> set[str]:
+        """Forward BFS from entry_id — follow edges forward (source→target)."""
+        forward_map: dict[str, list[str]] = {}
+        for e in self.edges:
+            forward_map.setdefault(e.source, []).append(e.target)
+        visited: set[str] = set()
+        queue = [entry_id]
+        while queue:
+            current = queue.pop(0)
+            if current in visited:
+                continue
+            visited.add(current)
+            for dst in forward_map.get(current, []):
+                if dst not in visited:
+                    queue.append(dst)
+        return visited
+
     def reverse_reach(self, entry_id: str) -> set[str]:
         """Reverse BFS from entry_id — follow edges backward (target→source)."""
         reverse_map: dict[str, list[str]] = {}
@@ -1963,9 +2019,8 @@ def build_unified_graph(root) -> 'WorkflowGraph':
     """Build a unified layered graph merging all topology dimensions with code-level graph (STORY-slim-048 R1).
 
     Returns WorkflowGraph with layered=True.
-    Enforces MAX_WORKFLOW_NODES — truncates with warning if exceeded.
+    STORY-slim-049 R1: No truncation — full graph for accurate reverse_reach() impact analysis.
     """
-    import warnings as _warnings
     root = Path(root).resolve()
     unified = WorkflowGraph()
     unified.layered = True
@@ -1987,19 +2042,49 @@ def build_unified_graph(root) -> 'WorkflowGraph':
     # Bridge edges across dimensions
     _build_bridge_edges(func_registry, topology_graph, unified)
 
-    # Enforce MAX_WORKFLOW_NODES
-    if len(unified.nodes) > MAX_WORKFLOW_NODES:
-        _warnings.warn(
-            f'Unified graph has {len(unified.nodes)} nodes, truncating to {MAX_WORKFLOW_NODES}',
-            stacklevel=2,
-        )
-        keep_ids = set(list(unified.nodes.keys())[:MAX_WORKFLOW_NODES])
-        unified.nodes = {k: v for k, v in unified.nodes.items() if k in keep_ids}
-        unified.edges = [e for e in unified.edges if e.source in keep_ids and e.target in keep_ids]
+    # STORY-slim-049 R1: No truncation — full graph for accurate reverse_reach() impact analysis.
+    # MAX_WORKFLOW_NODES constant retained for backward compatibility but not enforced here.
 
     return unified
 
 
+# --- STORY-slim-049: Focused Sub-Graph Export ---
+
+_ENTRY_POINT_KINDS = {'command', 'service', 'page'}
+
+
+def export_focus_graphs(graph: WorkflowGraph, output_dir) -> list:
+    """Export per-entry-point focused sub-graph .mmd files (STORY-slim-049 R2).
+
+    Identifies first-level entry points (command/service/page), extracts
+    reachable sub-graphs via reverse_reach(), writes each as a standalone .mmd.
+    Returns list of Path objects for written files.
+    """
+    output_dir = Path(output_dir)
+    entry_points = [n for n in graph.nodes.values() if n.kind in _ENTRY_POINT_KINDS]
+    if not entry_points:
+        return []
+    output_dir.mkdir(parents=True, exist_ok=True)
+    written = []
+    for entry in sorted(entry_points, key=lambda n: n.id):
+        reached_ids = graph.forward_reach(entry.id)
+        # Build sub-graph
+        sub = WorkflowGraph()
+        for nid in reached_ids:
+            node = graph.nodes.get(nid)
+            if node:
+                sub.add_node(node)
+        for edge in graph.edges:
+            if edge.source in reached_ids and edge.target in reached_ids:
+                sub.add_edge(edge)
+        # Write .mmd
+        sanitized = WorkflowGraph._sanitize_id(entry.id)
+        dest = output_dir / f'focus_{sanitized}.mmd'
+        dest.write_text(sub.to_mermaid(), encoding='utf-8')
+        written.append(dest)
+    return written
+
+
 # --- CLI ---
 if __name__ == '__main__':
     parser = argparse.ArgumentParser()
@@ -2008,17 +2093,18 @@ if __name__ == '__main__':
     sub.add_parser('list_rules')
     p_viz = sub.add_parser('visualize')
     p_viz.add_argument('--focus')
-    p_viz.add_argument('--mode', choices=['file', 'class', 'call', 'workflow'], default='file')
+    p_viz.add_argument('--mode', choices=['file', 'class', 'call', 'workflow', 'unified'], default='file')
     p_viz.add_argument('--entry')
     p_viz.add_argument('--depth', type=int, default=0, help='Limit graph traversal to N levels (0=unlimited)')
     p_viz.add_argument('--max-nodes', type=int, default=0, help='Truncate graph to N nodes (0=unlimited)')
     p_viz.add_argument('--reverse', action='store_true', default=False, help='Reverse BFS: find callers of entry function (STORY-053)')
     p_viz.add_argument('--lazy', action='store_true', default=False, help='Skip regeneration if graph is up-to-date')
+    p_viz.add_argument('--split', action='store_true', default=False, help='Generate per-entry-point focus graphs (unified mode only)')
     p_impact = sub.add_parser('impact', help='Find test files impacted by a changed function (STORY-053)')
     p_impact.add_argument('--entry', required=True, help='Changed function name')
 
     a = parser.parse_args()
     if a.cmd == 'init_arch': print(init_architecture())
-    elif a.cmd == 'visualize': print(visualize('.', a.focus, a.mode, a.entry, depth=a.depth, max_nodes=a.max_nodes, reverse=a.reverse, lazy=a.lazy))
+    elif a.cmd == 'visualize': print(visualize('.', a.focus, a.mode, a.entry, depth=a.depth, max_nodes=a.max_nodes, reverse=a.reverse, lazy=a.lazy, split=a.split))
     elif a.cmd == 'impact': print(impact('.', a.entry))
     elif a.cmd == 'list_rules': print(list_rules())

pactkit-2.4.1/tests/unit/test_story_slim049.py

@@ -0,0 +1,200 @@
+"""Tests for STORY-slim-049: Split unified graph — full for AI + focused sub-graphs for humans."""
+import sys
+import warnings
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent.parent / 'src'))
+from pactkit.skills.visualize import (
+    MAX_WORKFLOW_NODES,
+    WorkflowEdge,
+    WorkflowGraph,
+    WorkflowNode,
+    build_unified_graph,
+    export_focus_graphs,
+)
+
+
+def _make_project(tmp_path, files: dict[str, str]) -> Path:
+    for rel, content in files.items():
+        p = tmp_path / rel
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(content, encoding='utf-8')
+    return tmp_path
+
+
+# --- R1: No truncation in build_unified_graph ---
+
+class TestNoTruncation:
+    def test_full_graph_no_truncation_warning(self, tmp_path):
+        """AC1: build_unified_graph returns all nodes without truncation warning."""
+        # Create a project with 600+ functions (exceeding MAX_WORKFLOW_NODES)
+        funcs = '\n'.join(f'def func_{i}(): pass' for i in range(600))
+        _make_project(tmp_path, {
+            'pyproject.toml': '[project]\nname = "bigproject"',
+            'src/big.py': funcs,
+        })
+        with warnings.catch_warnings(record=True) as w:
+            warnings.simplefilter('always')
+            graph = build_unified_graph(str(tmp_path))
+            truncation_warnings = [x for x in w if 'truncating' in str(x.message).lower()]
+            assert len(truncation_warnings) == 0, f'Unexpected truncation warning: {truncation_warnings}'
+        # All 600 function nodes should be present
+        func_nodes = [n for n in graph.nodes.values() if n.kind == 'function']
+        assert len(func_nodes) >= 600
+
+    def test_max_workflow_nodes_constant_still_defined(self):
+        """R5: MAX_WORKFLOW_NODES constant still exists for backward compat."""
+        assert isinstance(MAX_WORKFLOW_NODES, int)
+        assert MAX_WORKFLOW_NODES == 500
+
+
+# --- R2: export_focus_graphs ---
+
+class TestExportFocusGraphs:
+    def _build_graph_with_entries(self) -> WorkflowGraph:
+        """Build a graph with commands, services, and pages as entry points."""
+        g = WorkflowGraph()
+        g.layered = True
+        # Commands
+        g.add_node(WorkflowNode(id='project-act', kind='command', label='project-act'))
+        g.add_node(WorkflowNode(id='project-plan', kind='command', label='project-plan'))
+        # Services
+        g.add_node(WorkflowNode(id='order-svc', kind='service', label='order-svc'))
+        # Pages
+        g.add_node(WorkflowNode(id='/dashboard', kind='page', label='/dashboard'))
+        # Supporting nodes
+        g.add_node(WorkflowNode(id='senior-dev', kind='agent', label='Senior Developer'))
+        g.add_node(WorkflowNode(id='pactkit-board', kind='skill', label='pactkit-board'))
+        # Edges
+        g.add_edge(WorkflowEdge(source='project-act', target='senior-dev', relation='invokes'))
+        g.add_edge(WorkflowEdge(source='project-act', target='pactkit-board', relation='depends_on'))
+        g.add_edge(WorkflowEdge(source='project-plan', target='senior-dev', relation='invokes'))
+        return g
+
+    def test_creates_files_per_entry_point(self, tmp_path):
+        """AC2: One .mmd file per entry point (command, service, page)."""
+        graph = self._build_graph_with_entries()
+        result = export_focus_graphs(graph, tmp_path)
+        assert isinstance(result, list)
+        # 4 entry points: project-act, project-plan, order-svc, /dashboard
+        assert len(result) == 4
+        for p in result:
+            assert p.exists()
+            assert p.suffix == '.mmd'
+
+    def test_focus_file_starts_with_graph_td(self, tmp_path):
+        """AC3: Each focused sub-graph is valid Mermaid starting with 'graph TD'."""
+        graph = self._build_graph_with_entries()
+        result = export_focus_graphs(graph, tmp_path)
+        for p in result:
+            content = p.read_text(encoding='utf-8')
+            assert content.startswith('graph TD'), f'{p.name} does not start with graph TD'
+
+    def test_focus_graph_contains_only_reachable_nodes(self, tmp_path):
+        """AC2: Each focus file contains only nodes reachable via reverse_reach."""
+        graph = self._build_graph_with_entries()
+        export_focus_graphs(graph, tmp_path)
+        # Find the project-act focus file
+        act_files = list(tmp_path.glob('focus_project_act*'))
+        assert len(act_files) == 1
+        content = act_files[0].read_text(encoding='utf-8')
+        # project-act's reverse_reach should include senior-dev and pactkit-board
+        assert 'senior_dev' in content or 'senior-dev' in content
+        assert 'pactkit_board' in content or 'pactkit-board' in content
+        # order-svc should NOT be in project-act's focus graph
+        assert 'order_svc' not in content and 'order-svc' not in content
+
+    def test_empty_graph_returns_empty_list(self, tmp_path):
+        """Edge case: graph with no entry points produces no files."""
+        graph = WorkflowGraph()
+        graph.add_node(WorkflowNode(id='some-func', kind='function', label='some_func'))
+        result = export_focus_graphs(graph, tmp_path)
+        assert result == []
+
+    def test_output_dir_created_if_missing(self, tmp_path):
+        """export_focus_graphs creates output_dir if it doesn't exist."""
+        graph = self._build_graph_with_entries()
+        out = tmp_path / 'nested' / 'focus'
+        result = export_focus_graphs(graph, out)
+        assert out.is_dir()
+        assert len(result) > 0
+
+
+# --- R3: max_render_nodes in to_mermaid ---
+
+class TestMaxRenderNodes:
+    def test_default_renders_all(self):
+        """Default max_render_nodes=0 renders all nodes."""
+        g = WorkflowGraph()
+        for i in range(100):
+            g.add_node(WorkflowNode(id=f'n{i}', kind='function', label=f'n{i}'))
+        mermaid = g.to_mermaid()
+        # Should have all 100 nodes
+        node_lines = [l for l in mermaid.split('\n') if '[' in l and 'NOTE' not in l]
+        assert len(node_lines) == 100
+
+    def test_truncates_at_limit(self):
+        """AC4: max_render_nodes=50 renders 50 nodes + NOTE."""
+        g = WorkflowGraph()
+        for i in range(100):
+            g.add_node(WorkflowNode(id=f'n{i}', kind='function', label=f'n{i}'))
+        mermaid = g.to_mermaid(max_render_nodes=50)
+        node_lines = [l for l in mermaid.split('\n') if '[' in l and 'NOTE' not in l]
+        assert len(node_lines) == 50
+        assert 'NOTE' in mermaid
+        assert '50 more' in mermaid
+
+    def test_no_truncation_when_under_limit(self):
+        """When graph has fewer nodes than limit, no NOTE added."""
+        g = WorkflowGraph()
+        for i in range(10):
+            g.add_node(WorkflowNode(id=f'n{i}', kind='function', label=f'n{i}'))
+        mermaid = g.to_mermaid(max_render_nodes=50)
+        assert 'NOTE' not in mermaid
+
+
+# --- R4: CLI unified mode ---
+
+class TestUnifiedCLI:
+    def test_unified_mode_writes_unified_graph(self, tmp_path):
+        """AC5: visualize --mode unified writes unified_graph.mmd."""
+        from pactkit.skills.visualize import visualize
+        _make_project(tmp_path, {
+            'pyproject.toml': '[project]\nname = "test"',
+            'src/app.py': 'def main(): pass\n',
+        })
+        result = visualize(target=str(tmp_path), mode='unified')
+        expected = tmp_path / 'docs' / 'architecture' / 'graphs' / 'unified_graph.mmd'
+        assert expected.exists()
+        content = expected.read_text(encoding='utf-8')
+        assert content.startswith('graph TD')
+
+    def test_unified_split_creates_focus_dir(self, tmp_path):
+        """AC6: --split generates focus/ directory with per-entry-point files."""
+        from pactkit.skills.visualize import visualize
+        _make_project(tmp_path, {
+            'pyproject.toml': '[project]\nname = "test"',
+            '.claude/commands/project-act.md': '# Act\n- **Agent**: Senior Developer\n',
+            'src/app.py': 'def main(): pass\n',
+        })
+        result = visualize(target=str(tmp_path), mode='unified', split=True)
+        focus_dir = tmp_path / 'docs' / 'architecture' / 'graphs' / 'focus'
+        assert focus_dir.is_dir()
+        focus_files = list(focus_dir.glob('*.mmd'))
+        assert len(focus_files) >= 1
+
+
+# --- R5: Backward compatibility ---
+
+class TestBackwardCompat:
+    def test_workflow_mode_unchanged(self, tmp_path):
+        """AC7: workflow mode still works identically."""
+        from pactkit.skills.visualize import visualize
+        _make_project(tmp_path, {
+            'pyproject.toml': '[project]\nname = "test"',
+            '.claude/commands/project-act.md': '# Act\n- **Agent**: Senior Developer\n',
+        })
+        result = visualize(target=str(tmp_path), mode='workflow')
+        expected = tmp_path / 'docs' / 'architecture' / 'graphs' / 'workflow_graph.mmd'
+        assert expected.exists()
+        assert 'unified_graph' not in result

pactkit-2.4.0/.opencode/.gitignore

@@ -1,4 +0,0 @@
-node_modules
-package.json
-bun.lock
-.gitignore

pactkit-2.4.0/.opencode/bun.lock

@@ -1,18 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "dependencies": {
-        "@opencode-ai/plugin": "1.2.27",
-      },
-    },
-  },
-  "packages": {
-    "@opencode-ai/plugin": ["@opencode-ai/plugin@1.2.27", "", { "dependencies": { "@opencode-ai/sdk": "1.2.27", "zod": "4.1.8" } }, "sha512-h+8Bw9v9nghMg7T+SUCTzxlIhOrsTqXW7U0HVLGQST5DjbN7uyCUM51roZWZ8LRjGxzbzFhvPnY1bj8i+ioZyw=="],
-
-    "@opencode-ai/sdk": ["@opencode-ai/sdk@1.2.27", "", {}, "sha512-Wk0o/I+Fo+wE3zgvlJDs8Fb67KlKqX0PrV8dK5adSDkANq6r4Z25zXJg2iOir+a8ntg3rAcpel1OY4FV/TwRUA=="],
-
-    "zod": ["zod@4.1.8", "", {}, "sha512-5R1P+WwQqmmMIEACyzSvo4JXHY5WiAFHRMg+zBZKgKS+Q1viRa0C1hmUKtHltoIFKtIdki3pRxkmpP74jnNYHQ=="],
-  }
-}

pactkit-2.4.0/.opencode/memory/.gitignore

@@ -1 +0,0 @@
-*

pactkit-2.4.0/.opencode/memory/project.md

@@ -1,7 +0,0 @@
----
-description: ''
-label: project
-limit: 5000
-read_only: false
----
-