pactkit 2.3.0__tar.gz → 2.3.1__tar.gz

{pactkit-2.3.0 → pactkit-2.3.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.2.0"
+version: "2.3.1"
 stack: python
 root: .
 developer: "slim"

{pactkit-2.3.0 → pactkit-2.3.1}/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.3.1] - 2026-03-23
+
+### Fixed
+- **Plan Phase 3.2 Stall** (STORY-slim-019) — Split monolithic Spec-writing phase into 4 sub-steps (3.2a Skeleton, 3.2b Acceptance Criteria, 3.2c Security Scope, 3.2d Spec Lint) with output checkpoints between each, eliminating AI buffering stall on large Spec generation.
+- **Explore Subagent Stall** (STORY-slim-020) — Added Bounded Delegation template to Plan Phase 1 (target/scope/limit/output constraints for Explore subagents), reduced `code-explorer` maxTurns from 50 to 15, and added scope-limiting instructions to prevent unbounded codebase exploration.
+- **CI Workflow** — Reverted `actions/checkout` and `actions/setup-python` from v6 back to v4/v5 for CI stability after Dependabot upgrades caused failures.
+
 ## [2.3.0] - 2026-03-22
 
 ### Added

{pactkit-2.3.0 → pactkit-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.3.0
+Version: 2.3.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

{pactkit-2.3.0 → pactkit-2.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.3.0"
+version = "2.3.1"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"

{pactkit-2.3.0 → pactkit-2.3.1}/src/pactkit/__init__.py

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

{pactkit-2.3.0 → pactkit-2.3.1}/src/pactkit/prompts/agents.py

@@ -248,7 +248,7 @@ Generate system architecture diagrams using Draw.io XML. Supports three diagram
     "code-explorer": {
         "desc": "Deep code analysis and execution tracing.",
         "tools": "Read, Bash, Grep, Glob, Find",
-        "maxTurns": 50,
+        "maxTurns": 15,  # STORY-slim-020: reduced from 50 to prevent unbounded exploration stalls
         "memory": "user",
         "prompt": """You are the **Code Explorer** (aka System Archaeologist).
 **Motto**: "Read little, understand much."

{pactkit-2.3.0 → pactkit-2.3.1}/src/pactkit/prompts/commands.py

@@ -64,11 +64,18 @@ allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
 6.  **Output**: The enriched_input (original + answers) is used as context for Phase 1 onwards.
 
 ## 🎬 Phase 1: Archaeology (The "Know Before You Change" Step)
-1.  **Visual Scan**: Run `visualize` to see the module dependency graph. Use `--mode class` for structure, `--mode call` for logic.
-    - For large codebases (50+ files), use `--focus <module> --depth 2` to limit scope.
+> **Subagent Scope Rule**: When delegating research to an Explore subagent, always provide a **bounded** prompt: target function/class, directory scope, file limit, and expected output. Never delegate open-ended "trace the whole codebase" tasks.
+
+1.  **Visual Scan**: Run `visualize --focus <module> --depth 2` to see the targeted dependency graph. Only expand to `--mode class` or `--mode call` if the focused scan is insufficient.
 2.  **Logic Trace (CRITICAL)** — use pactkit-trace skill:
     - If modifying existing logic, trace the current implementation.
     - *Goal*: Identify the exact function/class responsible for the logic.
+    - **Delegation Template**: When using an Explore subagent for trace, formulate the prompt with:
+      - **Target**: specific function or class name to trace
+      - **Scope**: specific directory (e.g., `src/pactkit/generators/`)
+      - **Limit**: read at most 8-10 files
+      - **Output**: what to return (entry file, call chain, key data transformations)
+      - Example: `Agent(subagent_type="Explore", prompt="Find the deploy() entry point in src/pactkit/generators/deployer.py. Trace the call chain to file writes. Read at most 8 files. Return: entry function, call chain list, key data transformations.")`
 
 ## 🎬 Phase 2: Design & Impact
 1.  **Diff**: Compare User Request vs Current Reality (from Phase 1).
@@ -79,9 +86,9 @@ allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
 1.  Run `pactkit next-id` to get the next Story ID (reads developer prefix from pactkit.yaml, scans `docs/specs/`).
 2.  **Output checkpoint**: Print "Story ID determined: {ID}. Writing Spec now."
 
-## 🎬 Phase 3.2: Write Spec
-1.  **Spec**: Create `docs/specs/{ID}.md` detailing the *Change*.
-    - **MUST — Metadata Table**: Include a metadata table at the top of the Spec using this EXACT format:
+## 🎬 Phase 3.2a: Spec Skeleton (Metadata + Requirements)
+1.  **Create file**: Create `docs/specs/{ID}.md` with the following sections:
+    - **MUST — Metadata Table**: Include a metadata table at the top using this EXACT format:
       ```markdown
       | Field | Value |
       |-------|-------|
@@ -91,41 +98,41 @@ allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
       | Release | {version} |
       ```
       Field names MUST be exact case (ID, Status, Priority, Release) — not bold, not different names.
-    - *Requirement*: Include a "Target Call Chain" section in the Spec based on your Trace findings.
+    - **MUST**: Fill in the `Release` metadata field by reading the `version` field from `{PACTKIT_YAML}` or `pyproject.toml`. Use that EXACT value — do NOT increment or predict a future version. If the file cannot be read, use `TBD`.
+    - **MUST**: Include `## Background` and `## Target Call Chain` sections based on your Trace findings.
     - **MUST**: Fill in the `## Requirements` section using RFC 2119 keywords (MUST/SHOULD/MAY).
-    - **MUST**: Fill in the `## Acceptance Criteria` section with Given/When/Then scenarios.
+2.  **Output checkpoint**: Print "Spec skeleton written. Adding acceptance criteria."
+
+## 🎬 Phase 3.2b: Acceptance Criteria & Implementation Steps
+1.  **MUST**: Add `## Acceptance Criteria` section with Given/When/Then scenarios.
     - Each Scenario SHOULD map to a verifiable test case in `docs/test_cases/`.
-    - **MUST**: Fill in the `Release` metadata field by reading the `version` field from `{PACTKIT_YAML}` or `pyproject.toml`. Use that EXACT value — do NOT increment or predict a future version. If the file cannot be read, use `TBD`.
-    - **OPTIONAL — Implementation Steps**: If Phase 1 Trace identifies 2+ files to modify, add `## Implementation Steps` section with table format:
-      ```
-      | Step | File | Action | Dependencies | Risk |
-      |------|------|--------|--------------|------|
-      | 1 | `src/foo.py` | Description | None | Low |
-      ```
-      The `Dependencies` column accepts `None`, `Step N`, or comma-separated step references. The `Risk` column accepts `Low`, `Medium`, `High`. This section is optional but RECOMMENDED for multi-file changes.
-    - **MUST — Security Scope**: Run `pactkit sec-scope <changed-files>` to auto-detect SEC-1~SEC-8 applicability. Paste the output Markdown table into the `## Security Scope` section of the Spec. If `pactkit sec-scope` is unavailable, apply these detection rules manually:
-      | Check | Applicable When |
-      |-------|-----------------|
-      | SEC-1 | Any source code file modified (`.py`, `.js`, `.ts`, `.go`, `.java`, etc.) |
-      | SEC-2 | Code contains `request.`, `form.`, `input`, `argv`, `sys.stdin`, `process.argv` |
-      | SEC-3 | Files in `models/`, `dao/`, `repository/`; or code contains SQL/ORM patterns |
-      | SEC-4 | Frontend files (`.tsx`, `.vue`, `.svelte`, `.html`); or code contains `innerHTML`, `dangerouslySetInnerHTML` |
-      | SEC-5 | Files in `auth/`, `session/`, `login/`; or code contains `token`, `jwt`, `cookie`, `session` |
-      | SEC-6 | Files in `api/`, `routes/`, `endpoints/`, `controllers/` |
-      | SEC-7 | Files in `api/`, `routes/`; or code contains exception handling patterns |
-      | SEC-8 | Dependency files modified (`package.json`, `requirements.txt`, `pyproject.toml`, `go.mod`, `Cargo.toml`) |
-
-      **Docs/tests-only shortcut**: If ONLY `docs/**`, `tests/**`, `*.md`, `README*` files changed, mark ALL checks N/A with Reason "docs/tests only".
-
-      Output format (the table must include a Reason column):
-      ```markdown
-      ## Security Scope
-      | Check | Applicable | Reason |
-      |-------|------------|--------|
-      | SEC-1 | Yes | Source code modified |
-      | SEC-2 | N/A | No user input handling |
-      ```
-    - **Spec Lint Self-Check**: After writing the Spec, run `pactkit spec-lint docs/specs/{ID}.md`. If ERROR rules fail, self-correct the Spec immediately (you wrote it — you have authority to fix it). Re-run until clean. This prevents the Spec from being rejected at Act Phase 0.5.
+2.  **OPTIONAL — Implementation Steps**: If Phase 1 Trace identifies 2+ files to modify, add `## Implementation Steps` section with table format:
+    ```
+    | Step | File | Action | Dependencies | Risk |
+    |------|------|--------|--------------|------|
+    | 1 | `src/foo.py` | Description | None | Low |
+    ```
+    The `Dependencies` column accepts `None`, `Step N`, or comma-separated step references. The `Risk` column accepts `Low`, `Medium`, `High`.
+3.  **Output checkpoint**: Print "Acceptance criteria written. Running security scope."
+
+## 🎬 Phase 3.2c: Security Scope
+1.  **MUST**: Run `pactkit sec-scope <changed-files>` to auto-detect SEC-1~SEC-8 applicability. Append the output to `## Security Scope` in the Spec.
+2.  **Fallback**: If `pactkit sec-scope` is unavailable, manually assess each SEC-1 through SEC-8 check based on changed file paths and code patterns. Apply docs/tests-only shortcut if applicable (mark ALL N/A with Reason "docs/tests only").
+3.  **Output format** (the table must include a Reason column):
+    ```markdown
+    ## Security Scope
+    | Check | Applicable | Reason |
+    |-------|------------|--------|
+    | SEC-1 | Yes | Source code modified |
+    | SEC-2 | N/A | No user input handling |
+    ```
+4.  **Output checkpoint**: Print "Security scope appended. Running lint."
+
+## 🎬 Phase 3.2d: Spec Lint Self-Check
+1.  Run `pactkit spec-lint docs/specs/{ID}.md`.
+2.  If ERROR rules fail, self-correct the Spec immediately (you wrote it — you have authority to fix it). Re-run until clean.
+3.  This prevents the Spec from being rejected at Act Phase 0.5.
+4.  **Output checkpoint**: Print "Spec lint passed."
 
 ## 🎬 Phase 3.3: Board, Memory & Handover
 1.  **Board**: Add Story using `add_story`.

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_agent_features.py

@@ -69,12 +69,12 @@ class TestCodeExplorerLimits:
     def test_max_turns_in_data(self):
         from pactkit.prompts import AGENTS_EXPERT
         cfg = AGENTS_EXPERT['code-explorer']
-        assert cfg.get('maxTurns') == 50
+        assert cfg.get('maxTurns') == 15  # STORY-slim-020: reduced from 50
 
     def test_max_turns_in_deployed_file(self, tmp_path):
         content = _deploy_and_read_agent(tmp_path, 'code-explorer')
         fm = _parse_agent_frontmatter(content)
-        assert fm.get('maxTurns') == '50'
+        assert fm.get('maxTurns') == '15'  # STORY-slim-020: reduced from 50
 
     def test_memory_in_data(self):
         from pactkit.prompts import AGENTS_EXPERT

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_agents_enrichment.py

@@ -150,7 +150,7 @@ class TestFrontmatterUnchanged:
 
     def test_code_explorer_max_turns(self):
         p = _prompts()
-        assert p.AGENTS_EXPERT['code-explorer']['maxTurns'] == 50
+        assert p.AGENTS_EXPERT['code-explorer']['maxTurns'] == 15  # STORY-slim-020
 
     def test_visual_architect_max_turns(self):
         p = _prompts()

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_bug_slim006.py

@@ -2,7 +2,6 @@
 from pathlib import Path
 from unittest.mock import patch
 
-
 PROJECT_ROOT = Path(__file__).resolve().parents[2]
 
 

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story020_horizon.py

@@ -86,7 +86,7 @@ class TestPromptGuidance:
     def test_plan_prompt_mentions_focus_heuristic(self):
         """S4: Plan prompt should have a heuristic for large codebases."""
         prompt = COMMANDS_CONTENT["project-plan.md"]
-        assert "50" in prompt or "large" in prompt.lower()
+        assert "--focus" in prompt  # STORY-slim-020: replaced "50+ files" with targeted --focus
 
     def test_act_prompt_mentions_depth(self):
         """Act prompt should also mention --depth."""

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim014_context.py

@@ -13,7 +13,6 @@ from pactkit.schemas import (
     CONTEXT_SECTIONS,
 )
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim014_lazy_viz.py

@@ -5,11 +5,11 @@ Tests for pactkit.lazy_visualize module.
 
 from __future__ import annotations
 
-import unittest
-from pathlib import Path
-from unittest.mock import patch, MagicMock
 import subprocess
 import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import MagicMock, patch
 
 
 class TestShouldVisualize(unittest.TestCase):

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim014_validators.py

@@ -5,10 +5,9 @@ Tests for pactkit.validators module.
 
 from __future__ import annotations
 
+import tempfile
 import unittest
 from pathlib import Path
-import tempfile
-import os
 
 
 class TestLintContext(unittest.TestCase):

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim015_doctor.py

@@ -4,11 +4,10 @@ Covers R1-R7: doctor diagnostics, backfill-release, issue-sync, CLI wiring, prom
 """
 from __future__ import annotations
 
-import re
+import shutil
 from pathlib import Path
 from unittest.mock import patch
 
-
 # ---------------------------------------------------------------------------
 # R1: check_orphaned_specs
 # ---------------------------------------------------------------------------
@@ -141,6 +140,7 @@ class TestR3StaleGraphs:
         """Graph older than source by > threshold → stale."""
         import os
         import time
+
         from pactkit.doctor import check_stale_graphs
 
         # Create source dir with a recent file
@@ -343,7 +343,7 @@ class TestR5IssueSync:
 class TestR6CLIWiring:
     """CLI must expose doctor, backfill-release, issue-sync subcommands."""
 
-    _PACTKIT = str(Path(__file__).parents[2] / ".venv" / "bin" / "pactkit")
+    _PACTKIT = shutil.which("pactkit") or str(Path(__file__).parents[2] / ".venv" / "bin" / "pactkit")
 
     def test_doctor_subcommand_exists(self):
         """pactkit doctor should be a recognized subcommand."""
@@ -382,6 +382,7 @@ class TestR7PromptDelegation:
 
     def _reload_prompts(self):
         import importlib
+
         import pactkit.prompts as p
         importlib.reload(p)
         return p

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim016_testmap_lint.py

@@ -4,10 +4,10 @@ Covers R1-R4: test-map, lint runner, CLI wiring, prompt delegation.
 """
 from __future__ import annotations
 
+import shutil
 from pathlib import Path
 from unittest.mock import patch
 
-
 # ---------------------------------------------------------------------------
 # R1: map_to_tests
 # ---------------------------------------------------------------------------
@@ -139,7 +139,7 @@ class TestR2LintRunner:
 class TestR3CLIWiring:
     """CLI must expose test-map and lint subcommands."""
 
-    _PACTKIT = str(Path(__file__).parents[2] / ".venv" / "bin" / "pactkit")
+    _PACTKIT = shutil.which("pactkit") or str(Path(__file__).parents[2] / ".venv" / "bin" / "pactkit")
 
     def test_test_map_subcommand_exists(self):
         """pactkit test-map should be a recognized subcommand."""
@@ -169,6 +169,7 @@ class TestR4PromptDelegation:
 
     def _reload_prompts(self):
         import importlib
+
         import pactkit.prompts as p
         importlib.reload(p)
         return p

{pactkit-2.3.0 → pactkit-2.3.1}/tests/unit/test_story_slim017.py

@@ -12,7 +12,6 @@ from __future__ import annotations
 import inspect
 import textwrap
 from datetime import date
-from pathlib import Path
 from unittest.mock import patch
 
 

pactkit-2.3.1/tests/unit/test_story_slim019_plan_subphases.py

@@ -0,0 +1,101 @@
+"""Tests for STORY-slim-019: Split Plan Phase 3.2 into sub-steps.
+
+Verifies the project-plan prompt template has 4 sub-phases (3.2a-3.2d)
+with explicit output checkpoints, while preserving all required content.
+"""
+
+from pactkit.prompts import COMMANDS_CONTENT
+
+PLAN = COMMANDS_CONTENT["project-plan.md"]
+
+
+class TestSubPhaseStructure:
+    """R1: Phase 3.2 must be split into 4 sub-phases."""
+
+    def test_has_phase_3_2a(self):
+        assert "Phase 3.2a" in PLAN
+
+    def test_has_phase_3_2b(self):
+        assert "Phase 3.2b" in PLAN
+
+    def test_has_phase_3_2c(self):
+        assert "Phase 3.2c" in PLAN
+
+    def test_has_phase_3_2d(self):
+        assert "Phase 3.2d" in PLAN
+
+    def test_subphases_in_order(self):
+        a = PLAN.index("Phase 3.2a")
+        b = PLAN.index("Phase 3.2b")
+        c = PLAN.index("Phase 3.2c")
+        d = PLAN.index("Phase 3.2d")
+        assert a < b < c < d
+
+
+class TestOutputCheckpoints:
+    """R1: Each sub-phase must have an output checkpoint."""
+
+    def test_3_2a_checkpoint(self):
+        assert "Spec skeleton written" in PLAN
+
+    def test_3_2b_checkpoint(self):
+        assert "Acceptance criteria written" in PLAN
+
+    def test_3_2c_checkpoint(self):
+        assert "Security scope appended" in PLAN
+
+    def test_3_2d_checkpoint(self):
+        assert "Spec lint passed" in PLAN
+
+
+class TestPreservedContent:
+    """R1+R3: All original required content must still be present."""
+
+    def test_metadata_table_instructions(self):
+        assert "Metadata Table" in PLAN
+
+    def test_requirements_section_rfc2119(self):
+        assert "RFC 2119" in PLAN
+
+    def test_acceptance_criteria_given_when_then(self):
+        assert "Given/When/Then" in PLAN
+
+    def test_release_field_from_yaml(self):
+        assert "Release" in PLAN and "pyproject.toml" in PLAN
+
+    def test_implementation_steps_optional(self):
+        assert "Implementation Steps" in PLAN
+
+    def test_security_scope_sec_scope_cli(self):
+        assert "pactkit sec-scope" in PLAN
+
+    def test_spec_lint_self_check(self):
+        assert "pactkit spec-lint" in PLAN
+
+    def test_target_call_chain(self):
+        assert "Target Call Chain" in PLAN
+
+
+class TestNoSideEffects:
+    """R3: Other phases must not be altered."""
+
+    def test_phase_0_intact(self):
+        assert "Phase 0: The Thinking Process" in PLAN
+
+    def test_phase_0_5_intact(self):
+        assert "Phase 0.5: Init Guard" in PLAN
+
+    def test_phase_0_7_intact(self):
+        assert "Phase 0.7: Clarify Gate" in PLAN
+
+    def test_phase_1_intact(self):
+        assert "Phase 1: Archaeology" in PLAN
+
+    def test_phase_2_intact(self):
+        assert "Phase 2: Design" in PLAN
+
+    def test_phase_3_1_intact(self):
+        assert "Phase 3.1: Story ID Generation" in PLAN
+
+    def test_phase_3_3_intact(self):
+        assert "Phase 3.3: Board, Memory" in PLAN

pactkit-2.3.1/tests/unit/test_story_slim020_explore_stall_fix.py

@@ -0,0 +1,91 @@
+"""Tests for STORY-slim-020: Fix Explore subagent stall during Plan Phase 1.
+
+Verifies:
+- Phase 1 has scope-limiting instructions and delegation template
+- code-explorer maxTurns reduced to 15
+- Other phases unchanged
+"""
+
+from pactkit.prompts import COMMANDS_CONTENT, AGENTS_EXPERT
+
+PLAN = COMMANDS_CONTENT["project-plan.md"]
+EXPLORER = AGENTS_EXPERT["code-explorer"]
+
+
+class TestR1ScopeLimiting:
+    """R1: Phase 1 must have scope-limiting instructions."""
+
+    def test_file_count_limit_mentioned(self):
+        """Phase 1 must recommend a file-count limit for subagent delegation."""
+        # Must mention limiting files to read
+        assert "file" in PLAN.lower() and ("limit" in PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")].lower()
+                                           or "at most" in PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")].lower())
+
+    def test_scope_guidance_in_phase1(self):
+        """Phase 1 must instruct providing specific directory/function scope."""
+        phase1 = PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")]
+        has_scope = ("directory" in phase1.lower() or "scope" in phase1.lower()
+                     or "target" in phase1.lower())
+        assert has_scope, "Phase 1 must mention directory/scope/target for subagent"
+
+
+class TestR2MaxTurns:
+    """R2: code-explorer maxTurns must be reduced."""
+
+    def test_max_turns_is_15(self):
+        assert EXPLORER["maxTurns"] == 15
+
+    def test_max_turns_not_50(self):
+        assert EXPLORER["maxTurns"] != 50
+
+
+class TestR3DelegationTemplate:
+    """R3: Phase 1 must include a delegation template."""
+
+    def test_delegation_template_present(self):
+        phase1 = PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")]
+        assert "Explore" in phase1, "Phase 1 must mention Explore subagent"
+
+    def test_template_has_example_prompt(self):
+        phase1 = PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")]
+        # Must show an example of how to formulate the prompt
+        has_example = ("example" in phase1.lower() or "prompt=" in phase1.lower()
+                       or "at most" in phase1.lower())
+        assert has_example, "Phase 1 must include an example delegation prompt"
+
+    def test_template_specifies_output_format(self):
+        phase1 = PLAN[PLAN.index("Phase 1"):PLAN.index("Phase 2")]
+        has_output = ("return" in phase1.lower() or "output" in phase1.lower()
+                      or "report" in phase1.lower())
+        assert has_output, "Phase 1 must specify expected output from subagent"
+
+
+class TestR4NoSideEffects:
+    """R4: Other phases must not be altered."""
+
+    def test_phase_0_intact(self):
+        assert "Phase 0: The Thinking Process" in PLAN
+
+    def test_phase_0_5_intact(self):
+        assert "Phase 0.5: Init Guard" in PLAN
+
+    def test_phase_0_7_intact(self):
+        assert "Phase 0.7: Clarify Gate" in PLAN
+
+    def test_phase_2_intact(self):
+        assert "Phase 2: Design" in PLAN
+
+    def test_phase_3_1_intact(self):
+        assert "Phase 3.1: Story ID Generation" in PLAN
+
+    def test_phase_3_2a_intact(self):
+        assert "Phase 3.2a" in PLAN
+
+    def test_phase_3_3_intact(self):
+        assert "Phase 3.3: Board, Memory" in PLAN
+
+    def test_explorer_boundaries_intact(self):
+        """code-explorer core protocol must not be changed."""
+        assert "Read-only operations" in EXPLORER["prompt"]
+        assert "Do not write code" in EXPLORER["prompt"]
+        assert "Do not modify Specs" in EXPLORER["prompt"]