prizmkit 1.1.118 → 1.1.119

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.118",
-  "bundledAt": "2026-07-09T14:31:05.918Z",
-  "bundledFrom": "932cf65"
+  "frameworkVersion": "1.1.119",
+  "bundledAt": "2026-07-09T15:35:51.674Z",
+  "bundledFrom": "8a729da"
 }

package/bundled/dev-pipeline/prizmkit_runtime/gitops.py

@@ -33,10 +33,8 @@ HIDDEN_TOOL_WORKTREE_EXCLUDES = (
     ":(top,exclude).prizmkit/manifest.json",
     ":(top,exclude).prizmkit/state",
     ":(top,exclude,glob).prizmkit/state/**",
-    ":(top,exclude).prizmkit/dev-pipeline/scripts",
-    ":(top,exclude,glob).prizmkit/dev-pipeline/scripts/**",
-    ":(top,exclude).prizmkit/dev-pipeline/prizmkit_runtime",
-    ":(top,exclude,glob).prizmkit/dev-pipeline/prizmkit_runtime/**",
+    ":(top,exclude).prizmkit/dev-pipeline",
+    ":(top,exclude,glob).prizmkit/dev-pipeline/**",
 )
 
 PIPELINE_FALLBACK_GIT_NAME = "PrizmKit Pipeline"

package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py

@@ -46,18 +46,27 @@ def _visible_status_result(project_root: Path) -> GitCommandResult:
     return run_git_command(project_root, ("status", "--porcelain", "--", ".", *HIDDEN_TOOL_WORKTREE_EXCLUDES))
 
 
+def _paths_from_status(stdout: str) -> tuple[str, ...]:
+    changed: list[str] = []
+    seen: set[str] = set()
+    for line in stdout.splitlines():
+        if len(line) < 4:
+            continue
+        path = line[3:].strip()
+        paths = path.split(" -> ", 1) if " -> " in path else [path]
+        for candidate in paths:
+            candidate = candidate.strip()
+            if candidate and candidate not in seen:
+                changed.append(candidate)
+                seen.add(candidate)
+    return tuple(changed)
+
+
 def _changed_paths_in(project_root: Path, paths: Sequence[str]) -> tuple[str, ...]:
     result = run_git_command(project_root, ("status", "--porcelain", "--", *paths))
     if result.return_code != 0:
         return ()
-    changed: list[str] = []
-    for line in result.stdout.splitlines():
-        path = line[3:].strip()
-        if " -> " in path:
-            path = path.split(" -> ", 1)[1].strip()
-        if path:
-            changed.append(path)
-    return tuple(changed)
+    return _paths_from_status(result.stdout)
 
 
 def commit_bookkeeping_changes(
@@ -80,14 +89,15 @@ def commit_preflight_ready_changes(project_root: Path, item_id: str) -> Bookkeep
     visible_status = _visible_status_result(project_root)
     if visible_status.return_code != 0:
         return BookkeepingResult(attempted=True, committed=False, result=visible_status)
-    if not visible_status.stdout.strip():
+    paths = _paths_from_status(visible_status.stdout)
+    if not paths:
         return BookkeepingResult(attempted=False, committed=False)
-    add_result = run_git_command(project_root, ("add", "-A", "--", ".", *HIDDEN_TOOL_WORKTREE_EXCLUDES))
+    add_result = run_git_command(project_root, ("add", "-A", "-f", "--", *paths))
     if add_result.return_code != 0:
         return BookkeepingResult(attempted=True, committed=False, result=add_result)
     result = run_git_command(
         project_root,
-        ("commit", "--no-verify", "-m", f"chore: ready for {item_id}", "--", ".", *HIDDEN_TOOL_WORKTREE_EXCLUDES),
+        ("commit", "--no-verify", "-m", f"chore: ready for {item_id}", "--", *paths),
     )
     if result.return_code != 0:
         return BookkeepingResult(attempted=True, committed=False, result=result)

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

@@ -1771,7 +1771,8 @@ def test_git_status_safe_ignores_worktree_support_assets(monkeypatch, tmp_path):
     joined = " ".join(status_args)
     assert ":(top,exclude).prizmkit-worktree" in status_args
     assert ":(top,exclude).claude" in status_args
-    assert ":(top,exclude).prizmkit/dev-pipeline/scripts" in status_args
+    assert ":(top,exclude).prizmkit/dev-pipeline" in status_args
+    assert ":(top,exclude,glob).prizmkit/dev-pipeline/**" in status_args
     assert all(exclude in status_args for exclude in HIDDEN_TOOL_WORKTREE_EXCLUDES)
     assert ".prizmkit-worktree" in joined
 
@@ -1958,6 +1959,26 @@ def test_preflight_ready_commit_preserves_dirty_changes_without_repo_git_identit
     assert _short_status(repo) == ""
 
 
+def test_preflight_ready_commit_force_stages_visible_file_when_prizmkit_dir_is_ignored(tmp_path):
+    from prizmkit_runtime.runner_bookkeeping import commit_preflight_ready_changes
+
+    repo = tmp_path / "repo"
+    _init_temp_repo(repo)
+    (repo / ".gitignore").write_text(".prizmkit/*\n", encoding="utf-8")
+    subprocess.run(["git", "add", ".gitignore"], cwd=repo, check=True)
+    subprocess.run(["git", "commit", "-m", "ignore prizmkit"], cwd=repo, check=True, stdout=subprocess.DEVNULL)
+    (repo / ".prizmkit" / "dev-pipeline" / "templates").mkdir(parents=True)
+    (repo / ".prizmkit" / "dev-pipeline" / "templates" / "bootstrap-prompt.md").write_text("ignored runtime\n", encoding="utf-8")
+    (repo / "visible.txt").write_text("dirty\n", encoding="utf-8")
+
+    result = commit_preflight_ready_changes(repo, "F-008")
+
+    assert result.committed
+    assert _head_commit_message(repo) == "chore: ready for F-008"
+    assert _head_files(repo) == {"visible.txt"}
+    assert _short_status(repo) == ""
+
+
 def test_materialize_worktree_support_assets_copies_ignored_assets_without_retired_shell_sources(tmp_path):
     from prizmkit_runtime.gitops import (
         BranchContext,

package/bundled/skills/_metadata.json

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

package/bundled/skills/bugfix-pipeline-launcher/SKILL.md

@@ -46,13 +46,15 @@ Before any action, validate:
 
 1. **bugfix pipeline exists**: Confirm `.prizmkit/dev-pipeline/cli.py` is present
 2. **For start**: `.prizmkit/plans/bug-fix-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
-3. **Dependencies**: `python3`, `git`, and AI CLI (`cbc` or `claude`) must be in PATH
+3. **Dependencies**: `python3`, `git`, and the configured AI CLI must be in PATH. Resolve and report the AI CLI from `AI_CLI` env, then `.prizmkit/config.json` `ai_cli`, then fallback to `claude` only when neither is configured. Read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check before running the AI CLI check.
 4. **Python version**: Requires Python 3.10+ for the unified dev-pipeline runtime
 5. **Browser tools** (optional): If any bug has `browser_interaction` field, check the corresponding tool is available. Bugs may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
 
 Quick check:
 ```bash
-command -v python3 && command -v git && (command -v cbc || command -v claude) && echo "All dependencies OK"
+command -v python3 >/dev/null && command -v git >/dev/null && echo "Core dependencies OK"
+# AI CLI check: read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check.
+# It must print `Configured AI CLI: <name>` and verify that exact executable.
 # Optional: browser interaction support (check both tools — bugs may use either)
 command -v playwright-cli && echo "playwright-cli OK" || echo "playwright-cli not found (playwright browser verification will be skipped)"
 command -v opencli && echo "opencli OK" || echo "opencli not found (opencli browser verification will be skipped)"

package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md

@@ -2,6 +2,45 @@
 
 Environment variable mappings for the bugfix launcher.
 
+## Configured AI CLI Prerequisite Check
+
+Read this section during launcher prerequisite validation before reporting AI CLI availability.
+
+Runtime AI CLI selection is config-driven. Resolve the executable name in this order:
+1. `AI_CLI` environment variable when set.
+2. `.prizmkit/config.json` `ai_cli` when present.
+3. `claude` fallback only when neither is configured.
+
+Run this quick check from the project root:
+```bash
+command -v python3 >/dev/null && command -v git >/dev/null || { echo "python3 or git missing"; exit 1; }
+AI_CLI="$(
+  python3 - <<'PY'
+import json, os, shlex
+from pathlib import Path
+cli = os.environ.get("AI_CLI", "").strip()
+if not cli:
+    config_path = Path(".prizmkit/config.json")
+    if config_path.is_file():
+        try:
+            data = json.loads(config_path.read_text(encoding="utf-8"))
+            cli = str(data.get("ai_cli") or "").strip()
+        except (OSError, json.JSONDecodeError):
+            cli = ""
+cli = cli or "claude"
+try:
+    print(shlex.split(cli)[0])
+except ValueError:
+    print(cli.split()[0] if cli.split() else "claude")
+PY
+)"
+printf 'Configured AI CLI: %s\n' "$AI_CLI"
+command -v "$AI_CLI" >/dev/null && printf 'AI CLI OK: %s\n' "$(command -v "$AI_CLI")" || { printf 'AI CLI not found: %s\n' "$AI_CLI"; exit 1; }
+echo "All dependencies OK"
+```
+
+Report the configured executable, for example `Configured AI CLI: claude`. Do not report the first arbitrary PATH match such as `cbc` when project config selects a different AI CLI.
+
 ## Environment Variable Mapping
 
 Translating user responses to env vars:
@@ -73,7 +112,7 @@ Note: Bug filter defaults to all bugs. Runtime selects eligible bugs in stable l
 | `.prizmkit/plans/bug-fix-list.json` not found | Tell user to run `bug-planner` skill first |
 | `python3` not installed | Install Python 3.10+ and rerun the Python runtime command |
 | `git` not installed | Install git; the Python runtime uses git for branch/worktree/status operations |
-| `cbc`/`claude` not in PATH | Check AI CLI installation |
+| Configured AI CLI not in PATH | Install the executable selected by `AI_CLI` or `.prizmkit/config.json` `ai_cli`, or update the config to a CLI available in PATH. |
 | Bugfix pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `python3 ./.prizmkit/dev-pipeline/cli.py daemon bugfix start .prizmkit/plans/bug-fix-list.json` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `python3 ./.prizmkit/dev-pipeline/cli.py daemon bugfix logs --lines 20` |

package/bundled/skills/feature-pipeline-launcher/SKILL.md

@@ -40,13 +40,15 @@ Before any action, validate:
 
 1. **dev-pipeline exists**: Confirm `.prizmkit/dev-pipeline/cli.py` is present
 2. **For start**: `.prizmkit/plans/feature-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
-3. **Dependencies**: `python3`, `git`, and AI CLI (`cbc` or `claude`) must be in PATH
+3. **Dependencies**: `python3`, `git`, and the configured AI CLI must be in PATH. Resolve and report the AI CLI from `AI_CLI` env, then `.prizmkit/config.json` `ai_cli`, then fallback to `claude` only when neither is configured. Read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check before running the AI CLI check.
 4. **Python version**: Requires Python 3.10+ for the unified dev-pipeline runtime
 5. **Browser tools** (optional): If any feature has `browser_interaction` field, check the corresponding tool is available. Features may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
 
 Quick check:
 ```bash
-command -v python3 && command -v git && (command -v cbc || command -v claude) && echo "All dependencies OK"
+command -v python3 >/dev/null && command -v git >/dev/null && echo "Core dependencies OK"
+# AI CLI check: read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check.
+# It must print `Configured AI CLI: <name>` and verify that exact executable.
 # Optional: browser interaction support (check both tools — features may use either)
 command -v playwright-cli && echo "playwright-cli OK" || echo "playwright-cli not found (playwright browser verification will be skipped)"
 command -v opencli && echo "opencli OK" || echo "opencli not found (opencli browser verification will be skipped)"

package/bundled/skills/feature-pipeline-launcher/references/configuration.md

@@ -22,6 +22,45 @@ Asked only when the user chose "Yes" to Advanced config in step 6.
 - xhigh — Extensive reasoning (`PRIZMKIT_EFFORT=xhigh`)
 - max — Maximum reasoning, Claude Code only (`PRIZMKIT_EFFORT=max`)
 
+## Configured AI CLI Prerequisite Check
+
+Read this section during launcher prerequisite validation before reporting AI CLI availability.
+
+Runtime AI CLI selection is config-driven. Resolve the executable name in this order:
+1. `AI_CLI` environment variable when set.
+2. `.prizmkit/config.json` `ai_cli` when present.
+3. `claude` fallback only when neither is configured.
+
+Run this quick check from the project root:
+```bash
+command -v python3 >/dev/null && command -v git >/dev/null || { echo "python3 or git missing"; exit 1; }
+AI_CLI="$(
+  python3 - <<'PY'
+import json, os, shlex
+from pathlib import Path
+cli = os.environ.get("AI_CLI", "").strip()
+if not cli:
+    config_path = Path(".prizmkit/config.json")
+    if config_path.is_file():
+        try:
+            data = json.loads(config_path.read_text(encoding="utf-8"))
+            cli = str(data.get("ai_cli") or "").strip()
+        except (OSError, json.JSONDecodeError):
+            cli = ""
+cli = cli or "claude"
+try:
+    print(shlex.split(cli)[0])
+except ValueError:
+    print(cli.split()[0] if cli.split() else "claude")
+PY
+)"
+printf 'Configured AI CLI: %s\n' "$AI_CLI"
+command -v "$AI_CLI" >/dev/null && printf 'AI CLI OK: %s\n' "$(command -v "$AI_CLI")" || { printf 'AI CLI not found: %s\n' "$AI_CLI"; exit 1; }
+echo "All dependencies OK"
+```
+
+Report the configured executable, for example `Configured AI CLI: claude`. Do not report the first arbitrary PATH match such as `cbc` when project config selects a different AI CLI.
+
 ## Environment Variable Mapping
 
 Translating user responses to env vars:
@@ -55,7 +94,7 @@ Not exposed in interactive menu, pass via `--env`:
 | `.prizmkit/plans/feature-list.json` not found | Tell user to run `feature-planner` skill first |
 | `python3` not installed | Install Python 3.10+ and rerun the Python runtime command |
 | `git` not installed | Install git; the Python runtime uses git for branch/worktree/status operations |
-| `cbc`/`claude` not in PATH | Check AI CLI installation |
+| Configured AI CLI not in PATH | Install the executable selected by `AI_CLI` or `.prizmkit/config.json` `ai_cli`, or update the config to a CLI available in PATH. |
 | Pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `python3 ./.prizmkit/dev-pipeline/cli.py daemon feature start .prizmkit/plans/feature-list.json` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `python3 ./.prizmkit/dev-pipeline/cli.py daemon feature logs --lines 20` |

package/bundled/skills/refactor-pipeline-launcher/SKILL.md

@@ -47,13 +47,15 @@ Before any action, validate:
 
 1. **refactor pipeline exists**: Confirm `.prizmkit/dev-pipeline/cli.py` is present
 2. **For start**: `.prizmkit/plans/refactor-list.json` must exist in `.prizmkit/plans/` (or user-specified path)
-3. **Dependencies**: `python3`, `git`, and AI CLI (`cbc` or `claude`) must be in PATH
+3. **Dependencies**: `python3`, `git`, and the configured AI CLI must be in PATH. Resolve and report the AI CLI from `AI_CLI` env, then `.prizmkit/config.json` `ai_cli`, then fallback to `claude` only when neither is configured. Read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check before running the AI CLI check.
 4. **Python version**: Requires Python 3.10+ for the unified dev-pipeline runtime
 5. **Browser tools** (optional): If any refactor has `browser_interaction` field, check the corresponding tool is available. Refactors may specify `tool: "playwright-cli"`, `tool: "opencli"`, or `tool: "auto"` (AI chooses at runtime).
 
 Quick check:
 ```bash
-command -v python3 && command -v git && (command -v cbc || command -v claude) && echo "All dependencies OK"
+command -v python3 >/dev/null && command -v git >/dev/null && echo "Core dependencies OK"
+# AI CLI check: read `${SKILL_DIR}/references/configuration.md` §Configured AI CLI Prerequisite Check.
+# It must print `Configured AI CLI: <name>` and verify that exact executable.
 # Optional: browser interaction support (check both tools — refactors may use either)
 command -v playwright-cli && echo "playwright-cli OK" || echo "playwright-cli not found (playwright browser verification will be skipped)"
 command -v opencli && echo "opencli OK" || echo "opencli not found (opencli browser verification will be skipped)"

package/bundled/skills/refactor-pipeline-launcher/references/configuration.md

@@ -2,6 +2,45 @@
 
 Environment variable mappings for the refactor launcher.
 
+## Configured AI CLI Prerequisite Check
+
+Read this section during launcher prerequisite validation before reporting AI CLI availability.
+
+Runtime AI CLI selection is config-driven. Resolve the executable name in this order:
+1. `AI_CLI` environment variable when set.
+2. `.prizmkit/config.json` `ai_cli` when present.
+3. `claude` fallback only when neither is configured.
+
+Run this quick check from the project root:
+```bash
+command -v python3 >/dev/null && command -v git >/dev/null || { echo "python3 or git missing"; exit 1; }
+AI_CLI="$(
+  python3 - <<'PY'
+import json, os, shlex
+from pathlib import Path
+cli = os.environ.get("AI_CLI", "").strip()
+if not cli:
+    config_path = Path(".prizmkit/config.json")
+    if config_path.is_file():
+        try:
+            data = json.loads(config_path.read_text(encoding="utf-8"))
+            cli = str(data.get("ai_cli") or "").strip()
+        except (OSError, json.JSONDecodeError):
+            cli = ""
+cli = cli or "claude"
+try:
+    print(shlex.split(cli)[0])
+except ValueError:
+    print(cli.split()[0] if cli.split() else "claude")
+PY
+)"
+printf 'Configured AI CLI: %s\n' "$AI_CLI"
+command -v "$AI_CLI" >/dev/null && printf 'AI CLI OK: %s\n' "$(command -v "$AI_CLI")" || { printf 'AI CLI not found: %s\n' "$AI_CLI"; exit 1; }
+echo "All dependencies OK"
+```
+
+Report the configured executable, for example `Configured AI CLI: claude`. Do not report the first arbitrary PATH match such as `cbc` when project config selects a different AI CLI.
+
 ## Environment Variable Mapping
 
 Translating user responses to env vars:
@@ -38,7 +77,7 @@ Not exposed in interactive menu, pass via `--env`:
 | Test baseline failing | Fix failing tests before starting refactoring — behavior preservation requires a green baseline |
 | `python3` not installed | Install Python 3.10+ and rerun the Python runtime command |
 | `git` not installed | Install git; the Python runtime uses git for branch/worktree/status operations |
-| `cbc`/`claude` not in PATH | Check AI CLI installation |
+| Configured AI CLI not in PATH | Install the executable selected by `AI_CLI` or `.prizmkit/config.json` `ai_cli`, or update the config to a CLI available in PATH. |
 | Refactor pipeline already running | Show status, ask if user wants to stop and restart |
 | PID file stale (process dead) | `python3 ./.prizmkit/dev-pipeline/cli.py daemon refactor start .prizmkit/plans/refactor-list.json` auto-cleans, retry start |
 | Launch failed (process died immediately) | Show last 20 lines of log: `python3 ./.prizmkit/dev-pipeline/cli.py daemon refactor logs --lines 20` |

package/package.json

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