prizmkit 1.1.129 → 1.1.130

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.129",
-  "bundledAt": "2026-07-14T06:20:56.368Z",
-  "bundledFrom": "60410c0"
+  "frameworkVersion": "1.1.130",
+  "bundledAt": "2026-07-15T08:17:59.816Z",
+  "bundledFrom": "81d54a2"
 }

package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py

@@ -1637,8 +1637,8 @@ def build_replacements(args, feature, features, global_context, script_dir):
         effective_resume = "6"
 
 
-    # Browser verification defaults to a mandatory attempt. It is disabled only
-    # by BROWSER_VERIFY=false or browser_interaction.enabled=false.
+    # Browser verification is opt-in through a browser_interaction object and
+    # can always be disabled globally with BROWSER_VERIFY=false.
     browser_enabled, browser_tool, browser_verify_steps, browser_blocking = browser_enabled_from_item(feature)
 
     if browser_tool not in ("playwright-cli", "opencli", "auto"):

package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py

@@ -362,7 +362,7 @@ def _bugfix_header(pipeline_mode):
     return title + "\n" + desc + "\n"
 
 
-def assemble_bugfix_sections(pipeline_mode, sections_dir, browser_enabled, manual_gate):
+def assemble_bugfix_sections(pipeline_mode, sections_dir, browser_enabled, manual_gate, browser_tool="auto"):
     sections = [
         ("header", _bugfix_header(pipeline_mode)),
         ("bugfix-session-context", load_section(sections_dir, "bugfix-session-context.md")),
@@ -380,7 +380,11 @@ def assemble_bugfix_sections(pipeline_mode, sections_dir, browser_enabled, manua
         ("bugfix-phase-review", load_section(sections_dir, "bugfix-phase-review.md")),
     ])
     if browser_enabled:
-        sections.append(("phase-browser", load_section(sections_dir, "phase-browser-verification-auto.md")))
+        browser_section_file = {
+            "playwright-cli": "phase-browser-verification.md",
+            "opencli": "phase-browser-verification-opencli.md",
+        }.get(browser_tool, "phase-browser-verification-auto.md")
+        sections.append(("phase-browser", load_section(sections_dir, browser_section_file)))
     if manual_gate:
         sections.append(("bugfix-manual-gate", load_section(sections_dir, "bugfix-phase-manual-verification.md")))
         sections.extend([
@@ -463,6 +467,7 @@ def main():
         try:
             sections = assemble_bugfix_sections(
                 pipeline_mode, sections_dir, browser_enabled, manual_gate,
+                browser_tool=replacements["{{BROWSER_TOOL}}"],
             )
             rendered = render_from_sections(sections, replacements)
         except FileNotFoundError as exc:

package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py

@@ -383,7 +383,7 @@ def _refactor_header(pipeline_mode):
     return title + "\n" + desc + "\n"
 
 
-def assemble_refactor_sections(pipeline_mode, sections_dir, browser_enabled):
+def assemble_refactor_sections(pipeline_mode, sections_dir, browser_enabled, browser_tool="auto"):
     sections = [
         ("header", _refactor_header(pipeline_mode)),
         ("refactor-session-context", load_section(sections_dir, "refactor-session-context.md")),
@@ -401,7 +401,11 @@ def assemble_refactor_sections(pipeline_mode, sections_dir, browser_enabled):
         ("refactor-phase-review", load_section(sections_dir, "refactor-phase-review.md")),
     ])
     if browser_enabled:
-        sections.append(("phase-browser", load_section(sections_dir, "phase-browser-verification-auto.md")))
+        browser_section_file = {
+            "playwright-cli": "phase-browser-verification.md",
+            "opencli": "phase-browser-verification-opencli.md",
+        }.get(browser_tool, "phase-browser-verification-auto.md")
+        sections.append(("phase-browser", load_section(sections_dir, browser_section_file)))
     sections.extend([
         ("refactor-phase-commit-report", load_section(sections_dir, "refactor-phase-commit-report.md")),
         ("refactor-session-status", load_section(sections_dir, "refactor-session-status.md")),
@@ -469,7 +473,10 @@ def main():
     sections = []
     if use_sections:
         try:
-            sections = assemble_refactor_sections(pipeline_mode, sections_dir, browser_enabled)
+            sections = assemble_refactor_sections(
+                pipeline_mode, sections_dir, browser_enabled,
+                browser_tool=replacements["{{BROWSER_TOOL}}"],
+            )
             rendered = render_from_sections(sections, replacements)
         except FileNotFoundError as exc:
             LOGGER.warning("Refactor section assembly failed (%s), falling back to legacy template", exc)

package/bundled/dev-pipeline/scripts/prompt_framework.py

@@ -327,21 +327,19 @@ def detect_dev_server_port(project_root):
 
 
 def browser_enabled_from_item(item):
-    """Return browser enabled/tool/steps with mandatory-attempt defaults."""
+    """Return browser enabled/tool/steps with explicit opt-in semantics."""
     browser_interaction = item.get("browser_interaction") if isinstance(item, dict) else None
     env_value = os.environ.get("BROWSER_VERIFY", "").lower()
     if env_value == "false":
         return False, "auto", "", False
 
-    enabled = True
+    enabled = False
     tool = "auto"
     blocking = False
     steps = []
 
-    if isinstance(browser_interaction, bool):
-        enabled = browser_interaction
-    elif isinstance(browser_interaction, dict):
-        enabled = browser_interaction.get("enabled", True)
+    if isinstance(browser_interaction, dict):
+        enabled = True
         tool = browser_interaction.get("tool", "auto")
         blocking = bool(browser_interaction.get("blocking", False))
         steps = browser_interaction.get("verify_steps", []) or []

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

@@ -1310,7 +1310,7 @@ class TestFeaturePromptUnifiedFullGuidance:
             assert "### Scoped Feature Test Gate — PrizmKit Test" in prompt
             assert "## Test Failure Recovery Protocol" in prompt
             assert "Boundary Matrix" in prompt
-            assert "### Browser Verification — MANDATORY" in prompt
+            assert "### Browser Verification — MANDATORY" not in prompt
             assert "### TERMINAL STOP — Commit Completed" in prompt
             assert "# Dev-Pipeline Session Bootstrap — Tier 1" not in prompt
             assert "# Dev-Pipeline Session Bootstrap — Tier 2" not in prompt
@@ -1420,7 +1420,99 @@ class TestBrowserBlockingPromptPolicy:
             assert "Failures do NOT block the commit" not in prompt
 
 
-class TestManualHybridBugfixPromptPolicy:
+class TestBrowserOptInPromptPolicy:
+    @staticmethod
+    def _rendered_outputs(tmp_path, browser_interaction=None, env_value=None):
+        previous_env = os.environ.get("BROWSER_VERIFY")
+        if env_value is None:
+            os.environ.pop("BROWSER_VERIFY", None)
+        else:
+            os.environ["BROWSER_VERIFY"] = env_value
+        try:
+            feature_prompt = _render_feature_prompt(
+                tmp_path / "feature", browser_interaction=browser_interaction,
+            )
+            bugfix_prompt = _render_bugfix_prompt(
+                tmp_path / "bugfix",
+                bug_overrides=(
+                    {"browser_interaction": browser_interaction}
+                    if browser_interaction is not None else None
+                ),
+            )
+            refactor_prompt = _render_refactor_prompt(
+                tmp_path / "refactor",
+                refactor_overrides=(
+                    {"browser_interaction": browser_interaction}
+                    if browser_interaction is not None else None
+                ),
+            )
+            return feature_prompt, bugfix_prompt, refactor_prompt
+        finally:
+            if previous_env is None:
+                os.environ.pop("BROWSER_VERIFY", None)
+            else:
+                os.environ["BROWSER_VERIFY"] = previous_env
+
+    @staticmethod
+    def _checkpoint_skills(project_root, family):
+        if family == "feature":
+            pattern = "**/workflow-checkpoint.json"
+        elif family == "bugfix":
+            pattern = "**/bugfix/B-001/workflow-checkpoint.json"
+        else:
+            pattern = "**/refactor/R-001/workflow-checkpoint.json"
+        path = next(project_root.glob(pattern))
+        return [step["skill"] for step in json.loads(path.read_text(encoding="utf-8"))["steps"]]
+
+    def test_omitted_browser_interaction_disables_browser_for_all_families(self, tmp_path):
+        prompts = self._rendered_outputs(tmp_path / "omitted")
+
+        for prompt in prompts:
+            assert "Browser Verification" not in prompt
+            assert "playwright-cli" not in prompt
+            assert "opencli" not in prompt
+            assert "development-server" not in prompt
+            assert "browser-dev-server.pid" not in prompt
+
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "omitted" / "feature", "feature")
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "omitted" / "bugfix", "bugfix")
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "omitted" / "refactor", "refactor")
+
+    def test_explicit_browser_interaction_preserves_configuration_for_all_families(self, tmp_path):
+        browser_interaction = {
+            "tool": "playwright-cli",
+            "verify_steps": ["Open the page", "Submit the form"],
+        }
+        prompts = self._rendered_outputs(tmp_path / "explicit", browser_interaction)
+
+        for prompt in prompts:
+            assert "Browser Verification" in prompt
+            assert "Browser Verification (playwright-cli)" in prompt
+            assert "playwright-cli" in prompt
+            assert "opencli" not in prompt
+            assert "Goal 1: Open the page" in prompt
+            assert "Goal 2: Submit the form" in prompt
+
+        assert "browser-verification" in self._checkpoint_skills(tmp_path / "explicit" / "feature", "feature")
+        assert "browser-verification" in self._checkpoint_skills(tmp_path / "explicit" / "bugfix", "bugfix")
+        assert "browser-verification" in self._checkpoint_skills(tmp_path / "explicit" / "refactor", "refactor")
+
+    def test_global_disable_suppresses_explicit_browser_for_all_families(self, tmp_path):
+        prompts = self._rendered_outputs(
+            tmp_path / "global-disable",
+            {"tool": "opencli", "verify_steps": ["Open the page"]},
+            env_value="false",
+        )
+
+        for prompt in prompts:
+            assert "Browser Verification" not in prompt
+            assert "opencli" not in prompt
+            assert "browser-dev-server.pid" not in prompt
+
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "global-disable" / "feature", "feature")
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "global-disable" / "bugfix", "bugfix")
+        assert "browser-verification" not in self._checkpoint_skills(tmp_path / "global-disable" / "refactor", "refactor")
+
     def test_fresh_manual_bugfix_prompt_stops_before_commit_phase(self, tmp_path):
         prompt = _render_bugfix_prompt(
             tmp_path / "fresh-manual-bugfix",

package/bundled/skills/_metadata.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.129",
+  "version": "1.1.130",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {