prizmkit 1.1.57 → 1.1.60

package/bundled/dev-pipeline/run-recovery.sh

@@ -24,8 +24,8 @@ set -euo pipefail
 #
 # Environment Variables:
 #   SESSION_TIMEOUT       Session timeout in seconds (default: 0 = no limit)
-#   AI_CLI                AI CLI command name (auto-detected: cbc or claude)
-#   PRIZMKIT_PLATFORM     Force platform: 'codebuddy' or 'claude' (auto-detected)
+#   AI_CLI                AI CLI command name (auto-detected: cbc, claude, or codex)
+#   PRIZMKIT_PLATFORM     Platform hint for custom AI_CLI wrappers: codebuddy, claude, or codex
 #   MODEL                 AI model to use (e.g. claude-opus-4.6)
 #   VERBOSE               Set to 1 to enable --verbose on AI CLI
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
@@ -41,8 +41,10 @@ source "$SCRIPT_DIR/lib/common.sh"
 
 RECOVERY_STATE_DIR="${PRIZMKIT_DIR}/state/recovery"
 SCRIPTS_DIR="$SCRIPT_DIR/scripts"
-# detect-recovery-state.py lives in the installed skill assets (.claude or .codebuddy)
-if [[ -f "${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
+# detect-recovery-state.py lives in the installed skill assets for the active platform.
+if [[ -f "${PROJECT_ROOT}/.agents/skills/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
+    RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/.agents/skills/recovery-workflow/scripts/detect-recovery-state.py"
+elif [[ -f "${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
     RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py"
 elif [[ -f "${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py" ]]; then
     RECOVERY_DETECT_SCRIPT="${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py"
@@ -51,7 +53,8 @@ else
 fi
 
 if [[ -z "$RECOVERY_DETECT_SCRIPT" ]]; then
-    log_error "Recovery detection script not found in either platform location:"
+    log_error "Recovery detection script not found in any platform location:"
+    log_error "  ${PROJECT_ROOT}/.agents/skills/recovery-workflow/scripts/detect-recovery-state.py"
     log_error "  ${PROJECT_ROOT}/.claude/command-assets/recovery-workflow/scripts/detect-recovery-state.py"
     log_error "  ${PROJECT_ROOT}/.codebuddy/skills/recovery-workflow/scripts/detect-recovery-state.py"
     log_error "Ensure PrizmKit is installed (npx prizmkit install) before running recovery."
@@ -260,54 +263,15 @@ spawn_recovery_session() {
     local session_log="$session_dir/logs/session.log"
     local progress_json="$session_dir/logs/progress.json"
 
-    local verbose_flag=""
-    if [[ "$VERBOSE" == "1" ]]; then
-        verbose_flag="--verbose"
-    fi
-
-    local stream_json_flag=""
-    if [[ "$USE_STREAM_JSON" == "true" ]]; then
-        stream_json_flag="--output-format stream-json"
-        verbose_flag="--verbose"
-    fi
-
-    local model_flag=""
     local effective_model="${session_model:-$MODEL}"
-    if [[ -n "$effective_model" ]]; then
-        model_flag="--model $effective_model"
-    fi
-
-    # Unset CLAUDECODE to prevent "nested session" error
-    unset CLAUDECODE 2>/dev/null || true
 
     log_info "Spawning AI CLI session..."
     log_info "CLI: $CLI_CMD"
     [[ -n "$effective_model" ]] && log_info "Model: $effective_model"
     log_info "Prompt: $bootstrap_prompt"
 
-    case "$CLI_CMD" in
-        *claude*)
-            "$CLI_CMD" \
-                -p "$(cat "$bootstrap_prompt")" \
-                --dangerously-skip-permissions \
-                $verbose_flag \
-                $stream_json_flag \
-                $model_flag \
-                > "$session_log" 2>&1 &
-            ;;
-        *)
-            # CodeBuddy (cbc) and others: prompt via stdin
-            "$CLI_CMD" \
-                --print \
-                -y \
-                $verbose_flag \
-                $stream_json_flag \
-                $model_flag \
-                < "$bootstrap_prompt" \
-                > "$session_log" 2>&1 &
-            ;;
-    esac
-    _SESSION_PID=$!
+    prizm_start_ai_session "$bootstrap_prompt" "$session_log" "$effective_model"
+    _SESSION_PID="$PRIZM_AI_PID"
 
     # Start progress parser
     start_progress_parser "$session_log" "$progress_json" "$SCRIPTS_DIR"

package/bundled/dev-pipeline/run-refactor.sh

@@ -16,9 +16,9 @@ set -euo pipefail
 # Environment Variables:
 #   MAX_RETRIES           Max retries per refactor (default: 3)
 #   SESSION_TIMEOUT       Session timeout in seconds (default: 0 = no limit)
-#   AI_CLI                AI CLI command name (auto-detected: cbc or claude)
+#   AI_CLI                AI CLI command name (auto-detected: cbc, claude, or codex)
 #   CODEBUDDY_CLI         Legacy alias for AI_CLI (deprecated, use AI_CLI instead)
-#   PRIZMKIT_PLATFORM     Force platform: 'codebuddy' or 'claude' (auto-detected)
+#   PRIZMKIT_PLATFORM     Platform hint for custom AI_CLI wrappers: codebuddy, claude, or codex
 #   VERBOSE               Set to 1 to enable --verbose on AI CLI
 #   HEARTBEAT_INTERVAL    Heartbeat log interval in seconds (default: 30)
 #   STALE_KILL_THRESHOLD   Auto-kill session after N seconds of no progress (default: 900)
@@ -94,56 +94,19 @@ spawn_and_wait_session() {
     local session_log="$session_dir/logs/session.log"
     local progress_json="$session_dir/logs/progress.json"
 
-    local verbose_flag=""
-    if [[ "$VERBOSE" == "1" ]]; then
-        verbose_flag="--verbose"
-    fi
-
-    local stream_json_flag=""
-    if [[ "$USE_STREAM_JSON" == "true" ]]; then
-        stream_json_flag="--output-format stream-json"
-        # claude-internal requires --verbose when using stream-json with -p/--print
-        verbose_flag="--verbose"
-    fi
-
-    local model_flag=""
+    local effective_model=""
     if [[ -n "$item_model" ]]; then
-        model_flag="--model $item_model"
+        effective_model="$item_model"
     elif [[ -n "${MODEL:-}" ]]; then
-        model_flag="--model $MODEL"
+        effective_model="$MODEL"
     fi
 
-    # Unset CLAUDECODE to prevent "nested session" error when launched from
-    # within an existing Claude Code session (e.g. via launch-refactor-daemon.sh).
-    unset CLAUDECODE 2>/dev/null || true
-
     # Log bootstrap prompt in test mode
     prizm_log_bootstrap_prompt "$bootstrap_prompt" "$refactor_id"
 
-    case "$CLI_CMD" in
-        *claude*)
-            # Claude Code: prompt via -p, --dangerously-skip-permissions for auto-accept
-            "$CLI_CMD" \
-                -p "$(cat "$bootstrap_prompt")" \
-                --dangerously-skip-permissions \
-                $verbose_flag \
-                $stream_json_flag \
-                $model_flag \
-                > "$session_log" 2>&1 &
-            ;;
-        *)
-            # CodeBuddy (cbc) and others: prompt via stdin, -y for auto-accept
-            "$CLI_CMD" \
-                --print \
-                -y \
-                $verbose_flag \
-                $stream_json_flag \
-                $model_flag \
-                < "$bootstrap_prompt" \
-                > "$session_log" 2>&1 &
-            ;;
-    esac
-    local cli_pid=$!
+    local cli_pid
+    prizm_start_ai_session "$bootstrap_prompt" "$session_log" "$effective_model"
+    cli_pid="$PRIZM_AI_PID"
 
     # Start progress parser (no-op if stream-json not supported)
     start_progress_parser "$session_log" "$progress_json" "$SCRIPTS_DIR"
@@ -1039,21 +1002,7 @@ DEPLOY_PROMPT_EOF
                     log_info "Deploy prompt: $deploy_prompt"
                     log_info "Deploy log: $deploy_session_dir/logs/session.log"
 
-                    case "$CLI_CMD" in
-                        *claude*)
-                            "$CLI_CMD" \
-                                -p "$(cat "$deploy_prompt")" \
-                                --dangerously-skip-permissions \
-                                > "$deploy_session_dir/logs/session.log" 2>&1
-                            ;;
-                        *)
-                            "$CLI_CMD" \
-                                --print \
-                                -y \
-                                < "$deploy_prompt" \
-                                > "$deploy_session_dir/logs/session.log" 2>&1
-                            ;;
-                    esac
+                    prizm_run_ai_session "$deploy_prompt" "$deploy_session_dir/logs/session.log"
                     local deploy_exit=$?
 
                     if [[ $deploy_exit -eq 0 ]]; then
@@ -1287,7 +1236,7 @@ show_help() {
     echo "  MODEL                    Default AI model (overridden by per-refactor model in refactor list)"
     echo "  PIPELINE_MODE            Default pipeline mode: lite|standard|full (overridden by --mode)"
     echo "  ENABLE_CRITIC            Enable/disable critic: true|false|1|0 (overridden by --critic/--no-critic)"
-    echo "  AI_CLI                   AI CLI command name (auto-detected: cbc or claude)"
+    echo "  AI_CLI                   AI CLI command name (auto-detected: cbc, claude, or codex)"
     echo "  VERBOSE                  Set to 1 for verbose AI CLI output"
     echo "  STRICT_BEHAVIOR_CHECK    Force full test suite after each refactor (default: 1)"
     echo "  HEARTBEAT_INTERVAL       Heartbeat log interval in seconds (default: 30)"

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

@@ -1190,16 +1190,19 @@ def build_replacements(args, feature, features, global_context, script_dir):
 
     # Auto-detect platform if not set
     if not platform:
+        has_codex = os.path.isdir(os.path.join(project_root, ".codex", "agents"))
         has_claude = os.path.isdir(os.path.join(project_root, ".claude", "agents"))
         has_codebuddy = os.path.isdir(os.path.join(project_root, ".codebuddy", "agents"))
-        if has_claude:
+        if has_codex:
+            platform = "codex"
+        elif has_claude:
             platform = "claude"
         elif has_codebuddy:
             platform = "codebuddy"
         else:
             raise RuntimeError(
-                "PrizmKit agents not found. Neither .claude/agents/ nor .codebuddy/agents/ exists. "
-                "Run `npx prizmkit install` first, or set PRIZMKIT_PLATFORM=claude|codebuddy explicitly."
+                "PrizmKit agents not found. None of .codex/agents/, .claude/agents/, or .codebuddy/agents/ exists. "
+                "Run `npx prizmkit install` first, or set PRIZMKIT_PLATFORM=codex|claude|codebuddy explicitly."
             )
 
     if platform == "claude":
@@ -1208,6 +1211,12 @@ def build_replacements(args, feature, features, global_context, script_dir):
         team_config_path = os.path.join(
             project_root, ".claude", "team-info.json",
         )
+    elif platform == "codex":
+        # Codex: agents and team metadata are project-local references.
+        agents_dir = os.path.join(project_root, ".codex", "agents")
+        team_config_path = os.path.join(
+            project_root, ".codex", "team-info.json",
+        )
     else:
         # CodeBuddy: agents in .codebuddy/agents/, team in ~/.codebuddy/teams/
         agents_dir = os.path.join(project_root, ".codebuddy", "agents")
@@ -1215,15 +1224,16 @@ def build_replacements(args, feature, features, global_context, script_dir):
             home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json",
         )
 
-    # Agent definitions are .md files in the platform-specific agents dir
+    # Agent definitions are native .toml for Codex and .md for Claude/CodeBuddy.
+    agent_ext = ".toml" if platform == "codex" else ".md"
     dev_subagent = os.path.join(
-        agents_dir, "prizm-dev-team-dev.md",
+        agents_dir, f"prizm-dev-team-dev{agent_ext}",
     )
     reviewer_subagent = os.path.join(
-        agents_dir, "prizm-dev-team-reviewer.md",
+        agents_dir, f"prizm-dev-team-reviewer{agent_ext}",
     )
     critic_subagent = os.path.join(
-        agents_dir, "prizm-dev-team-critic.md",
+        agents_dir, f"prizm-dev-team-critic{agent_ext}",
     )
 
     # Verify agent files actually exist — missing files cause confusing

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

@@ -228,7 +228,9 @@ def build_replacements(args, bug, global_context, script_dir):
     home_dir = os.path.expanduser("~")
 
     if not platform:
-        if os.path.isdir(os.path.join(project_root, ".claude", "agents")):
+        if os.path.isdir(os.path.join(project_root, ".codex", "agents")):
+            platform = "codex"
+        elif os.path.isdir(os.path.join(project_root, ".claude", "agents")):
             platform = "claude"
         else:
             platform = "codebuddy"
@@ -236,14 +238,18 @@ def build_replacements(args, bug, global_context, script_dir):
     if platform == "claude":
         agents_dir = os.path.join(project_root, ".claude", "agents")
         team_config_path = os.path.join(project_root, ".claude", "team-info.json")
+    elif platform == "codex":
+        agents_dir = os.path.join(project_root, ".codex", "agents")
+        team_config_path = os.path.join(project_root, ".codex", "team-info.json")
     else:
         agents_dir = os.path.join(project_root, ".codebuddy", "agents")
         team_config_path = os.path.join(
             home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json"
         )
 
-    dev_subagent = os.path.join(agents_dir, "prizm-dev-team-dev.md")
-    reviewer_subagent = os.path.join(agents_dir, "prizm-dev-team-reviewer.md")
+    agent_ext = ".toml" if platform == "codex" else ".md"
+    dev_subagent = os.path.join(agents_dir, f"prizm-dev-team-dev{agent_ext}")
+    reviewer_subagent = os.path.join(agents_dir, f"prizm-dev-team-reviewer{agent_ext}")
 
     # Session status path
     session_status_path = os.path.join(

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

@@ -377,7 +377,9 @@ def build_replacements(args, refactor, refactors, global_context, script_dir):
     home_dir = os.path.expanduser("~")
 
     if not platform:
-        if os.path.isdir(os.path.join(project_root, ".claude", "agents")):
+        if os.path.isdir(os.path.join(project_root, ".codex", "agents")):
+            platform = "codex"
+        elif os.path.isdir(os.path.join(project_root, ".claude", "agents")):
             platform = "claude"
         else:
             platform = "codebuddy"
@@ -385,14 +387,18 @@ def build_replacements(args, refactor, refactors, global_context, script_dir):
     if platform == "claude":
         agents_dir = os.path.join(project_root, ".claude", "agents")
         team_config_path = os.path.join(project_root, ".claude", "team-info.json")
+    elif platform == "codex":
+        agents_dir = os.path.join(project_root, ".codex", "agents")
+        team_config_path = os.path.join(project_root, ".codex", "team-info.json")
     else:
         agents_dir = os.path.join(project_root, ".codebuddy", "agents")
         team_config_path = os.path.join(
             home_dir, ".codebuddy", "teams", "prizm-dev-team", "config.json"
         )
 
-    dev_subagent = os.path.join(agents_dir, "prizm-dev-team-dev.md")
-    reviewer_subagent = os.path.join(agents_dir, "prizm-dev-team-reviewer.md")
+    agent_ext = ".toml" if platform == "codex" else ".md"
+    dev_subagent = os.path.join(agents_dir, f"prizm-dev-team-dev{agent_ext}")
+    reviewer_subagent = os.path.join(agents_dir, f"prizm-dev-team-reviewer{agent_ext}")
 
     # Session status path
     session_status_path = os.path.join(

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

@@ -521,20 +521,22 @@ def enrich_global_context(global_context, project_root):
 
 
 def read_platform_conventions(project_root):
-    """Resolve the path to CLAUDE.md or CODEBUDDY.md for project-level conventions.
+    """Resolve the platform-specific project conventions file.
 
     Returns a path reference for the AI agent to read at runtime,
     rather than inlining the full file content into the prompt.
     """
     platform = os.environ.get("PRIZMKIT_PLATFORM", "claude")
     if platform == "codebuddy":
-        candidates = ["CODEBUDDY.md", "CLAUDE.md"]
+        candidates = ["CODEBUDDY.md", "CLAUDE.md", "AGENTS.md"]
+    elif platform == "codex":
+        candidates = ["AGENTS.md", "CLAUDE.md", "CODEBUDDY.md"]
     else:
-        candidates = ["CLAUDE.md", "CODEBUDDY.md"]
+        candidates = ["CLAUDE.md", "CODEBUDDY.md", "AGENTS.md"]
 
     for filename in candidates:
         filepath = os.path.join(project_root, filename)
         if os.path.isfile(filepath):
             return "`{}`".format(filename)
 
-    return "(No project conventions file found — CLAUDE.md or CODEBUDDY.md)"
+    return "(No project conventions file found — AGENTS.md, CLAUDE.md, or CODEBUDDY.md)"

package/bundled/dev-pipeline-windows/.env.example

@@ -0,0 +1,28 @@
+# PrizmKit Dev-Pipeline Environment Configuration
+# ================================================
+# Copy this file to .prizmkit/.env and uncomment the variables you want to set.
+# All pipeline scripts (run-feature.ps1, run-bugfix.ps1, etc.) automatically
+# load .prizmkit/.env via lib/common.ps1.
+#
+# Priority: Environment variables set before script execution ALWAYS take
+# precedence over values in .prizmkit/.env. In PowerShell, use:
+#   $env:MODEL = "gpt-5.1-codex"; .\.prizmkit\dev-pipeline\run-feature.ps1 run
+# and it will override the .prizmkit/.env value.
+#
+# If .prizmkit/.env does not exist, all defaults apply — no error is raised.
+
+# ─── AI CLI ───────────────────────────────────────────────────────────
+# AI_CLI=codex               # AI CLI command. If unset, PrizmKit prefers the installed
+                              # project platform, then PATH order: codex > claude > cbc
+# MODEL=                     # AI model override (e.g. gpt-5.1-codex)
+                              # Per-task model in *-list.json overrides this
+
+# ─── Pipeline Execution ──────────────────────────────────────────────
+# MAX_RETRIES=3              # Max retry attempts per task before marking failed
+# SESSION_TIMEOUT=0          # Session timeout in seconds (0 = no limit)
+# VERBOSE=1                  # Verbose logging (1=on, 0=off)
+
+# ─── Feature Pipeline Only ────────────────────────────────────────────
+# ENABLE_CRITIC=false        # Enable adversarial critic review (true/false)
+# PIPELINE_MODE=             # Override pipeline mode for all features: lite|standard|full
+                              # Unset = auto-detect from estimated_complexity

package/bundled/dev-pipeline-windows/README.md

@@ -0,0 +1,30 @@
+# PrizmKit Dev Pipeline for Windows PowerShell
+
+This directory is the Windows-native PowerShell runtime installed by `npx prizmkit install` when you select **Windows PowerShell**.
+
+## Requirements
+
+- Windows PowerShell 5.1+ or PowerShell 7+
+- Python 3 available as `python` or `py -3`
+- Git
+- One AI CLI in PATH: `codex`, `claude`, or `cbc`
+
+## Commands
+
+```powershell
+.\.prizmkit\dev-pipeline\run-feature.ps1 run
+.\.prizmkit\dev-pipeline\run-feature.ps1 status
+.\.prizmkit\dev-pipeline\run-feature.ps1 run F-001 --dry-run
+
+.\.prizmkit\dev-pipeline\run-bugfix.ps1 run
+.\.prizmkit\dev-pipeline\run-refactor.ps1 run
+.\.prizmkit\dev-pipeline\run-recovery.ps1 --dry-run
+```
+
+If PowerShell blocks local scripts for the current session, run:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+```
+
+The Windows runner keeps the same user-facing install target as macOS/Linux: `.prizmkit/dev-pipeline/`. The source implementation is separate so the existing Bash pipeline remains unchanged.