prizmkit 1.1.111 → 1.1.113

package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py

@@ -884,7 +884,8 @@ class TestDirectOrchestratorImplementationPrompts:
         assert FORBIDDEN_DEV_FIX_PLACEHOLDER not in replacements
         assert FORBIDDEN_DEV_RESUME_PLACEHOLDER not in replacements
         assert "{{AGENT_PROMPT_CRITIC_PLAN_CHALLENGE}}" in replacements
-        assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" in replacements
+        assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" not in replacements
+        assert (templates_dir / "agent-prompts" / "reviewer-review.md").exists() is False
         assert (templates_dir / "agent-prompts" / "dev-implement.md").exists() is False
         assert (templates_dir / "agent-prompts" / FORBIDDEN_DEV_FIX_PROMPT).exists() is False
         assert (templates_dir / "agent-prompts" / FORBIDDEN_DEV_RESUME_PROMPT).exists() is False
@@ -923,9 +924,19 @@ class TestDirectOrchestratorImplementationPrompts:
             assert "Implement — Orchestrator Direct" in rendered
             assert "Spawn Dev subagent" not in rendered
             assert "Spawn Dev agent" not in rendered
+            assert "Spawn Reviewer agent" not in rendered
+            assert "Reviewer Agent Def" not in rendered
+            assert "subagent_type=\"prizm-dev-team-reviewer\"" not in rendered
             assert "Implement — Dev" not in rendered
             assert "{{AGENT_PROMPT_DEV_IMPLEMENT}}" not in rendered
+            assert "{{AGENT_PROMPT_REVIEWER_REVIEW}}" not in rendered
+            assert "reviewer-review.md" not in rendered
             assert "dev-implement.md" not in rendered
+            assert "Bug Fix Documentation Policy" not in rendered
+            assert "For bug-fix sessions" not in rendered
+            assert "fix(<scope>)" not in rendered
+            assert "port check 3000" not in rendered
+            assert "localhost:3000" not in rendered
             assert FORBIDDEN_REVIEW_DEV_FIX not in rendered
             assert FORBIDDEN_REVIEWER_DEV_SPAWN not in rendered
             assert FORBIDDEN_EXPLORE_SUBAGENT not in rendered
@@ -1089,7 +1100,10 @@ def _ensure_agent_files(project, platforms=("claude", "codex")):
             (agents_dir / f"prizm-dev-team-{name}{suffix}").write_text("agent\n", encoding="utf-8")
 
 
-def _render_bugfix_prompt(tmp_path, platform="claude", explicit_platform=None):
+def _render_bugfix_prompt(
+    tmp_path, platform="claude", explicit_platform=None,
+    bug_overrides=None, retry_count="0", resume_phase="null",
+):
     from generate_bugfix_prompt import main as bugfix_main
 
     project = tmp_path / "bugfix-project"
@@ -1101,8 +1115,11 @@ def _render_bugfix_prompt(tmp_path, platform="claude", explicit_platform=None):
     _ensure_agent_files(project)
     bug_list = project / ".prizmkit" / "plans" / "bug-fix-list.json"
     bug_list.parent.mkdir(parents=True)
+    bug = {"id": "B-001", "title": "Broken", "description": "Fix it", "acceptance_criteria": ["Works"]}
+    if bug_overrides:
+        bug.update(bug_overrides)
     bug_list.write_text(json.dumps({
-        "bugs": [{"id": "B-001", "title": "Broken", "description": "Fix it", "acceptance_criteria": ["Works"]}],
+        "bugs": [bug],
         "global_context": {"language": "Python"},
     }), encoding="utf-8")
     output = project / "bugfix-prompt.md"
@@ -1119,8 +1136,8 @@ def _render_bugfix_prompt(tmp_path, platform="claude", explicit_platform=None):
             "--bug-id", "B-001",
             "--session-id", "session-1",
             "--run-id", "run-1",
-            "--retry-count", "0",
-            "--resume-phase", "null",
+            "--retry-count", retry_count,
+            "--resume-phase", resume_phase,
             "--state-dir", str(project / ".prizmkit" / "state" / "bugfix"),
             "--project-root", str(project),
             "--output", str(output),
@@ -1139,7 +1156,7 @@ def _render_bugfix_prompt(tmp_path, platform="claude", explicit_platform=None):
     return output.read_text(encoding="utf-8")
 
 
-def _render_refactor_prompt(tmp_path, platform="claude", explicit_platform=None):
+def _render_refactor_prompt(tmp_path, platform="claude", explicit_platform=None, refactor_overrides=None):
     from generate_refactor_prompt import main as refactor_main
 
     project = tmp_path / "refactor-project"
@@ -1151,14 +1168,17 @@ def _render_refactor_prompt(tmp_path, platform="claude", explicit_platform=None)
     _ensure_agent_files(project)
     refactor_list = project / ".prizmkit" / "plans" / "refactor-list.json"
     refactor_list.parent.mkdir(parents=True)
+    refactor = {
+        "id": "R-001",
+        "title": "Restructure",
+        "description": "Preserve behavior",
+        "acceptance_criteria": ["Behavior preserved"],
+        "scope": {"files": ["src/a.py"], "modules": ["src"]},
+    }
+    if refactor_overrides:
+        refactor.update(refactor_overrides)
     refactor_list.write_text(json.dumps({
-        "refactors": [{
-            "id": "R-001",
-            "title": "Restructure",
-            "description": "Preserve behavior",
-            "acceptance_criteria": ["Behavior preserved"],
-            "scope": {"files": ["src/a.py"], "modules": ["src"]},
-        }],
+        "refactors": [refactor],
         "global_context": {"language": "Python"},
     }), encoding="utf-8")
     output = project / "refactor-prompt.md"
@@ -1178,18 +1198,14 @@ def _render_refactor_prompt(tmp_path, platform="claude", explicit_platform=None)
             "--retry-count", "0",
             "--resume-phase", "null",
             "--state-dir", str(project / ".prizmkit" / "state" / "refactor"),
+            "--project-root", str(project),
             "--output", str(output),
         ]
-        old_cwd = os.getcwd()
-        os.chdir(project)
         try:
-            try:
-                refactor_main()
-            except SystemExit as exc:
-                if exc.code not in (0, None):
-                    raise
-        finally:
-            os.chdir(old_cwd)
+            refactor_main()
+        except SystemExit as exc:
+            if exc.code not in (0, None):
+                raise
     finally:
         os.sys.argv = old_argv
         if old_platform is None:
@@ -1199,6 +1215,67 @@ def _render_refactor_prompt(tmp_path, platform="claude", explicit_platform=None)
     return output.read_text(encoding="utf-8")
 
 
+class TestBrowserBlockingPromptPolicy:
+    def test_feature_bugfix_refactor_blocking_browser_policy_stops_before_commit(self, tmp_path):
+        browser_interaction = {
+            "tool": "auto",
+            "blocking": True,
+            "verify_steps": ["Open the page"],
+        }
+        prompts = [
+            _render_feature_prompt(tmp_path / "feature-browser-blocking", browser_interaction=browser_interaction),
+            _render_bugfix_prompt(tmp_path / "bugfix-browser-blocking", bug_overrides={"browser_interaction": browser_interaction}),
+            _render_refactor_prompt(tmp_path / "refactor-browser-blocking", refactor_overrides={"browser_interaction": browser_interaction}),
+        ]
+
+        for prompt in prompts:
+            assert "Browser blocking policy: `true`" in prompt
+            assert "stop before commit" in prompt
+            assert "Failures do NOT block the commit" not in prompt
+
+    def test_feature_bugfix_refactor_nonblocking_browser_policy_continues(self, tmp_path):
+        browser_interaction = {
+            "tool": "auto",
+            "blocking": False,
+            "verify_steps": ["Open the page"],
+        }
+        prompts = [
+            _render_feature_prompt(tmp_path / "feature-browser-nonblocking", browser_interaction=browser_interaction),
+            _render_bugfix_prompt(tmp_path / "bugfix-browser-nonblocking", bug_overrides={"browser_interaction": browser_interaction}),
+            _render_refactor_prompt(tmp_path / "refactor-browser-nonblocking", refactor_overrides={"browser_interaction": browser_interaction}),
+        ]
+
+        for prompt in prompts:
+            assert "Browser blocking policy: `false`" in prompt
+            assert "clean up the dev server/browser, and continue" in prompt
+            assert "Failures do NOT block the commit" not in prompt
+
+
+class TestManualHybridBugfixPromptPolicy:
+    def test_fresh_manual_bugfix_prompt_stops_before_commit_phase(self, tmp_path):
+        prompt = _render_bugfix_prompt(
+            tmp_path / "fresh-manual-bugfix",
+            bug_overrides={"verification_type": "manual"},
+        )
+
+        assert "Manual / Hybrid Verification Gate" in prompt
+        assert "Stop before `/prizmkit-retrospective` and `/prizmkit-committer`" in prompt
+        assert "### Phase 4: Commit & Learn" not in prompt
+        assert "Run `/prizmkit-committer` with commit prefix" not in prompt
+
+    def test_recovery_manual_bugfix_prompt_includes_commit_phase_with_substitution_policy(self, tmp_path):
+        prompt = _render_bugfix_prompt(
+            tmp_path / "recovery-manual-bugfix",
+            bug_overrides={"verification_type": "manual"},
+            retry_count="1",
+        )
+
+        assert "Manual / Hybrid Verification Gate" not in prompt
+        assert "Recovery-class session: automated verification may substitute for manual/hybrid UAT" in prompt
+        assert "### Phase 4: Commit & Learn" in prompt
+        assert "Run `/prizmkit-committer` with commit prefix" in prompt
+
+
 class TestHeadlessPromptCleanupF033:
     def test_rendered_feature_bugfix_refactor_prompts_are_clean(self, tmp_path):
         prompts = []
@@ -1311,7 +1388,6 @@ class TestHeadlessPromptCleanupF033:
         refactor_prompt = _render_refactor_prompt(tmp_path / "refactor-mixed", platform="claude")
 
         assert replacements["{{REVIEWER_SUBAGENT_PATH}}"].endswith(".claude/agents/prizm-dev-team-reviewer.md")
-        assert ".claude/agents/prizm-dev-team-reviewer.md" in refactor_prompt
         assert ".codex/agents/prizm-dev-team-reviewer.toml" not in refactor_prompt
 
     def test_bugfix_refactor_explicit_codex_override(self, tmp_path, monkeypatch):
@@ -1333,7 +1409,6 @@ class TestHeadlessPromptCleanupF033:
         refactor_prompt = _render_refactor_prompt(tmp_path / "refactor-codex", platform="claude", explicit_platform="codex")
 
         assert replacements["{{REVIEWER_SUBAGENT_PATH}}"].endswith(".codex/agents/prizm-dev-team-reviewer.toml")
-        assert ".codex/agents/prizm-dev-team-reviewer.toml" in refactor_prompt
         assert ".claude/agents/prizm-dev-team-reviewer.md" not in refactor_prompt
 
     def test_explicit_codex_env_still_renders_codex_critic_path(self, tmp_path, monkeypatch):
@@ -1399,7 +1474,9 @@ class TestFeatureBootstrapShellExtraction:
             assert "executable version opencli --arg=--version" in prompt
             assert "process start --pid-file .prizmkit/state/browser-dev-server.pid" in prompt
             assert "process cleanup-pid <pid-from-.prizmkit/state/browser-dev-server.pid>" in prompt
-            assert "port check <DEV_PORT>" in prompt or "port check 3000" in prompt
+            assert "port check <DEV_PORT>" in prompt
+            assert "port check 3000" not in prompt
+            assert "localhost:3000" not in prompt
 
     def test_rendered_legacy_tier_feature_prompts_use_runtime_helper_not_extracted_bash(self, tmp_path):
         cases = [
@@ -1419,7 +1496,8 @@ class TestFeatureBootstrapShellExtraction:
             self.assert_shell_extracted_operations_removed(prompt)
             assert "process start --pid-file .prizmkit/state/browser-dev-server.pid" in prompt
             assert "process cleanup-pid <pid-from-.prizmkit/state/browser-dev-server.pid>" in prompt
-            assert "port check 3000" in prompt
+            assert "port check 3000" not in prompt
+            assert "localhost:3000" not in prompt
 
     def test_legacy_tier_specific_extracted_operations_map_to_helper_commands(self, tmp_path):
         tier1 = _render_feature_prompt(

package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py

@@ -307,6 +307,20 @@ def test_template_source_is_clean_for_headless_prompt_contract():
         assert forbidden not in content
 
 
+def test_bugfix_prompt_keeps_fine_grained_phases_out_of_external_status_contract():
+    content = Path("dev-pipeline/templates/bugfix-bootstrap-prompt.md").read_text(encoding="utf-8")
+    old_statuses = ["triaging", "reproducing", "fixing", "verifying"]
+
+    assert "external bug-list status field" in content
+    assert "pending`, `in_progress`, `completed`, `failed`, `skipped`, or `needs_info`" in content
+    for status in old_statuses:
+        assert f"status=\"{status}\"" not in content
+        assert f"status = \"{status}\"" not in content
+        assert f"status='{status}'" not in content
+        assert f"status = '{status}'" not in content
+        assert f"Set bug status to `{status}`" not in content
+
+
 # ---------------------------------------------------------------------------
 # Anti-Bash regression guardrails (F-039)
 # Note: grep -n, sed -n, grep -q, wc -l excluded — referenced in bugfix context

package/bundled/dev-pipeline/tests/test_python_runner_parity.py

@@ -61,6 +61,35 @@ def _write_feature_list(paths):
     )
 
 
+def _write_family_plan(paths, kind, items):
+    plan_config = {
+        "feature": (paths.feature_plan, "features", "dev-pipeline-feature-list-v1"),
+        "bugfix": (paths.bugfix_plan, "bugs", "dev-pipeline-bug-fix-list-v1"),
+        "refactor": (paths.refactor_plan, "refactors", "dev-pipeline-refactor-list-v1"),
+    }
+    plan_path, list_key, schema = plan_config[kind]
+    plan_path.write_text(
+        json.dumps({"$schema": schema, "project_name": "Fake", list_key: items}),
+        encoding="utf-8",
+    )
+    return plan_path
+
+
+def _get_next_result(kind, paths):
+    from prizmkit_runtime.runner_models import family_for, parse_invocation
+    from prizmkit_runtime.runner_status import get_next
+
+    family = family_for(kind, paths)
+    invocation = parse_invocation(family, "run", ())
+    invocation = invocation.__class__(**{**invocation.__dict__, "list_path": family.plan_path})
+    return get_next(family, invocation, paths.project_root)
+
+
+def _item_id_from_next_result(kind, result):
+    key = {"feature": "feature_id", "bugfix": "bug_id", "refactor": "refactor_id"}[kind]
+    return result.data[key]
+
+
 def test_retired_shell_runtime_files_are_absent_from_source():
     retired = [
         "run-feature.sh",
@@ -360,6 +389,216 @@ def test_status_bridge_preserves_feature_filter_selection(tmp_path):
     assert update.data["context_overflow_count"] == 1
 
 
+def test_status_bridge_uses_stable_dependency_order_across_pipeline_families(tmp_path):
+    cases = {
+        "feature": [
+            {"id": "F-001", "title": "Blocked", "status": "pending", "priority": "critical", "dependencies": ["F-002"]},
+            {"id": "F-002", "title": "First", "status": "pending", "priority": "low", "dependencies": []},
+            {"id": "F-003", "title": "Independent", "status": "pending", "priority": "high", "dependencies": []},
+        ],
+        "bugfix": [
+            {"id": "B-001", "title": "Blocked", "status": "pending", "severity": "critical", "priority": "high", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": ["B-002"]},
+            {"id": "B-002", "title": "First", "status": "pending", "severity": "low", "priority": "low", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": []},
+            {"id": "B-003", "title": "Independent", "status": "pending", "severity": "high", "priority": "high", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": []},
+        ],
+        "refactor": [
+            {"id": "R-001", "title": "Blocked", "description": "blocked", "scope": {}, "type": "restructure", "priority": "critical", "complexity": "high", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": ["R-002"], "status": "pending"},
+            {"id": "R-002", "title": "First", "description": "first", "scope": {}, "type": "extract", "priority": "low", "complexity": "low", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": [], "status": "pending"},
+            {"id": "R-003", "title": "Independent", "description": "independent", "scope": {}, "type": "simplify", "priority": "high", "complexity": "medium", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": [], "status": "pending"},
+        ],
+    }
+
+    for kind, items in cases.items():
+        paths = _make_paths(tmp_path / f"stable-{kind}")
+        _write_family_plan(paths, kind, items)
+
+        result = _get_next_result(kind, paths)
+
+        assert result.ok
+        assert _item_id_from_next_result(kind, result) == {"feature": "F-002", "bugfix": "B-002", "refactor": "R-002"}[kind]
+
+
+def test_status_bridge_prefers_in_progress_items_with_satisfied_dependencies(tmp_path):
+    cases = {
+        "feature": [
+            {"id": "F-001", "title": "Done", "status": "completed", "priority": "low", "dependencies": []},
+            {"id": "F-002", "title": "Resume", "status": "in_progress", "priority": "low", "dependencies": ["F-001"]},
+            {"id": "F-003", "title": "Pending", "status": "pending", "priority": "critical", "dependencies": []},
+        ],
+        "bugfix": [
+            {"id": "B-001", "title": "Done", "status": "completed", "severity": "low", "priority": "low", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": []},
+            {"id": "B-002", "title": "Resume", "status": "in_progress", "severity": "low", "priority": "low", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": ["B-001"]},
+            {"id": "B-003", "title": "Pending", "status": "pending", "severity": "critical", "priority": "high", "error_source": {"type": "user_report"}, "verification_type": "manual", "acceptance_criteria": ["fixed"], "dependencies": []},
+        ],
+        "refactor": [
+            {"id": "R-001", "title": "Done", "description": "done", "scope": {}, "type": "extract", "priority": "low", "complexity": "low", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": [], "status": "completed"},
+            {"id": "R-002", "title": "Resume", "description": "resume", "scope": {}, "type": "extract", "priority": "low", "complexity": "low", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": ["R-001"], "status": "in_progress"},
+            {"id": "R-003", "title": "Pending", "description": "pending", "scope": {}, "type": "migrate", "priority": "critical", "complexity": "high", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": [], "status": "pending"},
+        ],
+    }
+
+    for kind, items in cases.items():
+        paths = _make_paths(tmp_path / f"resume-{kind}")
+        _write_family_plan(paths, kind, items)
+
+        result = _get_next_result(kind, paths)
+
+        assert result.ok
+        assert _item_id_from_next_result(kind, result) == {"feature": "F-002", "bugfix": "B-002", "refactor": "R-002"}[kind]
+
+
+def test_refactor_dependencies_require_completed_not_other_terminal_statuses(tmp_path):
+    paths = _make_paths(tmp_path)
+    _write_family_plan(
+        paths,
+        "refactor",
+        [
+            {"id": "R-001", "title": "Failed Dependency", "description": "failed", "scope": {}, "type": "extract", "priority": "high", "complexity": "low", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": [], "status": "failed"},
+            {"id": "R-002", "title": "Blocked", "description": "blocked", "scope": {}, "type": "restructure", "priority": "high", "complexity": "medium", "behavior_preservation": {"strategy": "test-gate"}, "acceptance_criteria": ["done"], "dependencies": ["R-001"], "status": "pending"},
+        ],
+    )
+
+    result = _get_next_result("refactor", paths)
+
+    assert result.ok
+    assert result.text == "PIPELINE_BLOCKED"
+    assert result.data is None
+
+
+def test_init_scripts_reject_missing_self_and_cycle_dependencies(tmp_path):
+    script_config = {
+        "feature": ("init-pipeline.py", "--feature-list", "F-", "missing dependency"),
+        "bugfix": ("init-bugfix-pipeline.py", "--bug-list", "B-", "missing dependency"),
+        "refactor": ("init-refactor-pipeline.py", "--refactor-list", "R-", "missing dependency"),
+    }
+    scenarios = {
+        "missing": lambda kind, prefix: _family_items(kind, [
+            (f"{prefix}001", [f"{prefix}999"], "pending"),
+        ]),
+        "self": lambda kind, prefix: _family_items(kind, [
+            (f"{prefix}001", [f"{prefix}001"], "pending"),
+        ]),
+        "cycle": lambda kind, prefix: _family_items(kind, [
+            (f"{prefix}001", [f"{prefix}002"], "pending"),
+            (f"{prefix}002", [f"{prefix}001"], "pending"),
+        ]),
+    }
+    expected_fragments = {
+        "missing": "missing dependency",
+        "self": "cannot depend on itself",
+        "cycle": "Dependency cycle detected",
+    }
+
+    for kind, (script_name, list_arg, prefix, _missing_fragment) in script_config.items():
+        for scenario, build_items in scenarios.items():
+            paths = _make_paths(tmp_path / f"init-{kind}-{scenario}")
+            plan_path = _write_family_plan(paths, kind, build_items(kind, prefix))
+            result = subprocess.run(
+                [
+                    PYTHON_310_PLUS,
+                    str(PIPELINE_ROOT / "scripts" / script_name),
+                    list_arg,
+                    str(plan_path),
+                    "--state-dir",
+                    str(paths.project_root / ".prizmkit" / "state" / f"init-{kind}-{scenario}"),
+                ],
+                cwd=REPO_ROOT,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+                check=False,
+            )
+
+            assert result.returncode == 1, (kind, scenario, result.stdout, result.stderr)
+            payload = json.loads(result.stdout)
+            assert any(expected_fragments[scenario] in error for error in payload["errors"])
+
+
+def test_bug_planner_validator_rejects_dependency_cycles():
+    from importlib.util import module_from_spec, spec_from_file_location
+
+    script_path = REPO_ROOT / "core" / "skills" / "orchestration-skill" / "pipelines" / "bug-planner" / "scripts" / "validate-bug-list.py"
+    spec = spec_from_file_location("bug_planner_validate_bug_list", script_path)
+    module = module_from_spec(spec)
+    spec.loader.exec_module(module)
+
+    result = module.validate({
+        "$schema": "dev-pipeline-bug-fix-list-v1",
+        "project_name": "Fake",
+        "bugs": [
+            {
+                "id": "B-001",
+                "title": "First",
+                "description": "First bug",
+                "severity": "medium",
+                "error_source": {"type": "user_report"},
+                "verification_type": "manual",
+                "acceptance_criteria": ["fixed"],
+                "dependencies": ["B-002"],
+                "status": "pending",
+            },
+            {
+                "id": "B-002",
+                "title": "Second",
+                "description": "Second bug",
+                "severity": "medium",
+                "error_source": {"type": "user_report"},
+                "verification_type": "manual",
+                "acceptance_criteria": ["fixed"],
+                "dependencies": ["B-001"],
+                "status": "pending",
+            },
+        ],
+    })
+
+    assert result["valid"] is False
+    assert any("Dependency cycle detected" in error for error in result["errors"])
+
+
+
+def _family_items(kind, entries):
+    items = []
+    for item_id, dependencies, status in entries:
+        if kind == "feature":
+            items.append({
+                "id": item_id,
+                "title": item_id,
+                "description": "Implement this feature with enough detail for initialization validation.",
+                "priority": "medium",
+                "dependencies": dependencies,
+                "acceptance_criteria": ["done"],
+                "status": status,
+            })
+        elif kind == "bugfix":
+            items.append({
+                "id": item_id,
+                "title": item_id,
+                "description": "Bug description",
+                "severity": "medium",
+                "priority": "medium",
+                "error_source": {"type": "user_report"},
+                "verification_type": "manual",
+                "acceptance_criteria": ["fixed"],
+                "dependencies": dependencies,
+                "status": status,
+            })
+        else:
+            items.append({
+                "id": item_id,
+                "title": item_id,
+                "description": "Refactor description",
+                "scope": {},
+                "type": "extract",
+                "priority": "medium",
+                "complexity": "low",
+                "behavior_preservation": {"strategy": "test-gate"},
+                "acceptance_criteria": ["done"],
+                "dependencies": dependencies,
+                "status": status,
+            })
+    return items
+
+
 def test_status_bridge_passes_max_retries_from_invocation_or_environment(monkeypatch, tmp_path):
     import subprocess
     from prizmkit_runtime.runner_models import family_for, parse_invocation

package/bundled/dev-pipeline/tests/test_unified_cli.py

@@ -458,7 +458,7 @@ def test_interoperability_preserves_existing_utility_mapping():
     explicitly_library_only = set(UTILITY_LIBRARY_ONLY)
 
     assert actual_scripts == mapped_scripts | explicitly_library_only
-    assert explicitly_library_only == {"continuation.py", "utils.py"}
+    assert explicitly_library_only == {"continuation.py", "prompt_framework.py", "utils.py"}
     assert "parse-stream-progress.py" in mapped_scripts
     assert "prizmkit-test-gate.py" not in mapped_scripts
 
@@ -803,7 +803,11 @@ def test_headless_subagent_prompt_guidance_keeps_no_worktree_boundary_visible():
 
     for path in guidance_files:
         text = path.read_text(encoding="utf-8")
-        assert "default/no worktree" in text, path
+        assert (
+            "default/no worktree" in text
+            or "current-workspace / active-checkout / no-worktree" in text
+            or "current workspace / active checkout / no worktree" in text
+        ), path
         assert "do not request or create" in text.lower() or "do not request worktree isolation" in text.lower(), path
         assert ".claude/worktrees/..." in text, path
         assert ".prizmkit/state/worktrees/..." in text, path

package/bundled/dev-pipeline/tests/test_utils.py

@@ -4,7 +4,13 @@ import json
 import os
 import tempfile
 
-from utils import load_json_file, write_json_file, pad_right, _build_progress_bar
+from utils import (
+    load_json_file,
+    write_json_file,
+    pad_right,
+    _build_progress_bar,
+    stable_topological_order,
+)
 
 
 # ---------------------------------------------------------------------------
@@ -80,3 +86,62 @@ class TestBuildProgressBar:
     def test_fifty_percent(self):
         bar = _build_progress_bar(50, width=10)
         assert "50%" in bar
+
+
+# ---------------------------------------------------------------------------
+# stable_topological_order
+# ---------------------------------------------------------------------------
+
+class TestStableTopologicalOrder:
+    def test_dependencies_precede_dependents_with_stable_tie_breaking(self):
+        items = [
+            {"id": "F-001", "dependencies": []},
+            {"id": "F-002", "dependencies": ["F-001"]},
+            {"id": "F-003", "dependencies": []},
+        ]
+
+        ordered, errors = stable_topological_order(items, item_label="Feature")
+
+        assert errors == []
+        assert [item["id"] for item in ordered] == ["F-001", "F-002", "F-003"]
+
+    def test_unrelated_items_preserve_original_list_order(self):
+        items = [
+            {"id": "F-010", "dependencies": []},
+            {"id": "F-002", "dependencies": []},
+            {"id": "F-007", "dependencies": []},
+        ]
+
+        ordered, errors = stable_topological_order(items, item_label="Feature")
+
+        assert errors == []
+        assert [item["id"] for item in ordered] == ["F-010", "F-002", "F-007"]
+
+    def test_missing_dependency_is_blocking_error(self):
+        items = [
+            {"id": "B-001", "dependencies": ["B-999"]},
+        ]
+
+        _ordered, errors = stable_topological_order(items, item_label="Bug")
+
+        assert errors == ["Bug 'B-001' depends on missing dependency 'B-999'"]
+
+    def test_self_dependency_is_blocking_error(self):
+        items = [
+            {"id": "R-001", "dependencies": ["R-001"]},
+        ]
+
+        _ordered, errors = stable_topological_order(items, item_label="Refactor")
+
+        assert errors == ["Refactor 'R-001' cannot depend on itself"]
+
+    def test_cycle_reports_chain(self):
+        items = [
+            {"id": "F-001", "dependencies": ["F-003"]},
+            {"id": "F-002", "dependencies": ["F-001"]},
+            {"id": "F-003", "dependencies": ["F-002"]},
+        ]
+
+        _ordered, errors = stable_topological_order(items, item_label="Feature")
+
+        assert errors == ["Dependency cycle detected: F-001 -> F-003 -> F-002 -> F-001"]

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.111",
+  "version": "1.1.113",
   "skills": {
     "prizmkit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",