prizmkit 1.1.100 → 1.1.102

package/bin/create-prizmkit.js

@@ -5,10 +5,10 @@
  *
  * Usage:
  *   npx prizmkit install .
- *   npx prizmkit install my-project --platform claude --runtime unix --non-interactive
+ *   npx prizmkit install my-project --platform claude --runtime python --non-interactive
  *   npx prizmkit uninstall . --dry-run
  *   npx prizmkit upgrade .
- *   npx prizmkit config . --platform codebuddy --runtime windows
+ *   npx prizmkit config . --platform codebuddy --runtime auto
  */
 
 import { readFileSync } from 'fs';
@@ -32,7 +32,7 @@ program
   .command('install [directory]')
   .description('Install PrizmKit into a project directory')
   .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, or all')
-  .option('--runtime <runtime>', 'Runtime assets: unix, windows, or auto')
+  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
   .option('--skills <suite>', 'Skill suite: core, minimal, or recommended:<type> (frontend/backend/fullstack/library)', 'core')
   .option('--team', 'Enable multi-agent team mode (default: true)')
   .option('--no-team', 'Disable multi-agent team mode')
@@ -91,7 +91,7 @@ program
   .command('config [directory]')
   .description('Reconfigure existing PrizmKit installation (change platform, skills, rules, options)')
   .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, or all')
-  .option('--runtime <runtime>', 'Runtime assets: unix, windows, or auto')
+  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
   .option('--skills <suite>', 'Skill suite: core, minimal, or recommended:<type>')
   .option('--rules <preset>', 'Rules preset: recommended, minimal, or none')
   .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex)')

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.100",
-  "bundledAt": "2026-07-05T09:02:21.156Z",
-  "bundledFrom": "c1f7dba"
+  "frameworkVersion": "1.1.102",
+  "bundledAt": "2026-07-06T15:09:00.037Z",
+  "bundledFrom": "e918269"
 }

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

@@ -1,12 +1,12 @@
 # PrizmKit Dev-Pipeline Environment Configuration
 # ================================================
 # Copy this file to .prizmkit/.env and uncomment the variables you want to set.
-# All pipeline scripts (run-feature.sh, run-bugfix.sh, etc.) automatically
-# load .prizmkit/.env via lib/common.sh.
+# The Python runtime CLI (cli.py feature, cli.py bugfix, etc.) automatically
+# load .prizmkit/.env via prizmkit_runtime/config.py.
 #
 # Priority: Environment variables set before script execution ALWAYS take
 # precedence over values in .prizmkit/.env. This means you can still do:
-#   MODEL=claude-opus-4 ./.prizmkit/dev-pipeline/run-feature.sh run
+#   MODEL=claude-opus-4 python3 ./.prizmkit/dev-pipeline/cli.py feature run
 # and it will override the .prizmkit/.env value.
 #
 # If .prizmkit/.env does not exist, all defaults apply — no error is raised.

package/bundled/dev-pipeline/README.md

@@ -4,12 +4,32 @@ Autonomous development pipeline that drives the `prizm-dev-team` multi-agent tea
 
 ## Prerequisites
 
+### Python runtime prerequisites
+
 - Python 3.8+
 - [jq](https://jqlang.github.io/jq/) (`brew install jq`)
 - AI CLI in PATH: CodeBuddy (`cbc`), Claude Code (`claude`), or Codex (`codex`)
 - `.prizmkit/plans/feature-list.json` generated by the `feature-planner` skill (for feature pipeline)
 - `.prizmkit/plans/bug-fix-list.json` generated by the `bug-planner` skill (for bug pipeline)
 
+### Unified Python CLI prerequisites
+
+- Python 3.10+ for the unified Python CLI skeleton under `dev-pipeline/cli.py`
+- No third-party Python runtime packages are required by the CLI skeleton
+- The existing Python runtime is canonical for behavior while parity-based Python porting proceeds
+
+Inspect the transition command surface without invoking legacy shell wrappers:
+
+```bash
+python3 dev-pipeline/cli.py --help
+python3 dev-pipeline/cli.py diagnostics paths
+python3 dev-pipeline/cli.py diagnostics entrypoints
+python3 dev-pipeline/cli.py feature describe
+python3 dev-pipeline/cli.py daemon feature describe
+```
+
+The unified CLI currently describes command contracts for feature, bugfix, refactor, recovery, reset, daemon, status, and diagnostics flows. It is an architecture skeleton and transition layer; it does not yet replace the shell implementation for runtime behavior.
+
 ## Quick Start
 
 ```bash
@@ -22,30 +42,30 @@ python3 .prizmkit/dev-pipeline/scripts/init-pipeline.py \
   --state-dir .prizmkit/state/features
 
 # 3. Run the pipeline (foreground, Ctrl+C to pause, re-run to resume)
-./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 
 # 4. Check progress at any time (from another terminal)
-./.prizmkit/dev-pipeline/run-feature.sh status .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py feature status .prizmkit/plans/feature-list.json
 
 # 5. Or run as a background daemon
-./.prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py daemon feature start .prizmkit/plans/feature-list.json
 ```
 
 ---
 
-## Shell Scripts Reference
+## Python Runtime CLI Reference
 
-### `run-feature.sh` — Feature Pipeline Runner
+### `cli.py feature` — Feature Pipeline Runner
 
 Main entry point. Drives the full feature development pipeline.
 
 ```bash
-./run-feature.sh run [.prizmkit/plans/feature-list.json]                # Run all features
-./run-feature.sh run <feature-id> [options]             # Run a single feature (F-NNN)
-./run-feature.sh status [.prizmkit/plans/feature-list.json]             # Show pipeline status
-./run-feature.sh reset                                  # Clear all state in state/
-./run-feature.sh test-cli                               # Test AI CLI detection
-./run-feature.sh help                                   # Show usage help
+python3 ./cli.py feature run [.prizmkit/plans/feature-list.json]                # Run all features
+python3 ./cli.py feature run <feature-id> [options]             # Run a single feature (F-NNN)
+python3 ./cli.py feature status [.prizmkit/plans/feature-list.json]             # Show pipeline status
+python3 ./cli.py reset feature                                  # Clear all state in state/
+python3 ./cli.py feature test-cli                               # Test AI CLI detection
+python3 ./cli.py feature help                                   # Show usage help
 ```
 
 **Single-feature options:**
@@ -60,28 +80,28 @@ Main entry point. Drives the full feature development pipeline.
 
 ```bash
 # Run all features
-./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 
 # Run a single feature
-./.prizmkit/dev-pipeline/run-feature.sh run F-007
+python3 ./.prizmkit/dev-pipeline/cli.py feature run F-007
 
 # Dry run — inspect the generated prompt without spawning a session
-./.prizmkit/dev-pipeline/run-feature.sh run F-007 --dry-run
+python3 ./.prizmkit/dev-pipeline/cli.py feature run F-007 --dry-run
 
 # Resume from Phase 6 (implementation)
-./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json --resume-phase 6
+python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json --resume-phase 6
 ```
 
 If `.prizmkit/plans/feature-list.json` path is omitted, defaults to `.prizmkit/plans/feature-list.json` in the project root.
 
 ---
 
-### `reset-feature.sh` — Reset & Retry Failed/Stuck Feature
+### `cli.py reset feature` — Reset & Retry Failed/Stuck Feature
 
 Resets a feature's state so it can be re-executed from scratch.
 
 ```bash
-./reset-feature.sh <feature-id> [--clean] [--run] [.prizmkit/plans/feature-list.json]
+python3 ./cli.py reset feature <feature-id> [--clean] [--run] [.prizmkit/plans/feature-list.json]
 ```
 
 | Flag | Description |
@@ -100,25 +120,25 @@ Resets a feature's state so it can be re-executed from scratch.
 **Examples:**
 
 ```bash
-./.prizmkit/dev-pipeline/reset-feature.sh F-007                    # Reset status only
-./.prizmkit/dev-pipeline/reset-feature.sh F-007 --clean            # Reset + delete artifacts
-./.prizmkit/dev-pipeline/reset-feature.sh F-007 --clean --run      # Reset + clean + retry
-./.prizmkit/dev-pipeline/reset-feature.sh F-007 --clean my-features.json
+python3 ./.prizmkit/dev-pipeline/cli.py reset feature F-007                    # Reset status only
+python3 ./.prizmkit/dev-pipeline/cli.py reset feature F-007 --clean            # Reset + delete artifacts
+python3 ./.prizmkit/dev-pipeline/cli.py reset feature F-007 --clean --run      # Reset + clean + retry
+python3 ./.prizmkit/dev-pipeline/cli.py reset feature F-007 --clean my-features.json
 ```
 
 ---
 
-### `launch-feature-daemon.sh` — Feature Pipeline Daemon
+### `cli.py daemon feature` — Feature Pipeline Daemon
 
-Manages `run-feature.sh` as a background daemon process with PID tracking and log consolidation. Designed for invocation from AI skill sessions.
+Manages `cli.py feature` as a background daemon process with PID tracking and log consolidation. Designed for invocation from AI skill sessions.
 
 ```bash
-./launch-feature-daemon.sh start [.prizmkit/plans/feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
-./launch-feature-daemon.sh stop
-./launch-feature-daemon.sh status
-./launch-feature-daemon.sh logs [--lines N] [--follow]
-./launch-feature-daemon.sh restart [.prizmkit/plans/feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
-./launch-feature-daemon.sh help
+python3 ./cli.py daemon feature start [.prizmkit/plans/feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
+python3 ./cli.py daemon feature stop
+python3 ./cli.py daemon feature status
+python3 ./cli.py daemon feature logs [--lines N] [--follow]
+python3 ./cli.py daemon feature restart [.prizmkit/plans/feature-list.json] [--mode <mode>] [--env "KEY=VAL ..."]
+python3 ./cli.py daemon feature help
 ```
 
 | Subcommand | Description |
@@ -134,7 +154,7 @@ Manages `run-feature.sh` as a background daemon process with PID tracking and lo
 **`--env` format:** Pass environment variables as a quoted string:
 
 ```bash
-./.prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json \
+python3 ./.prizmkit/dev-pipeline/cli.py daemon feature start .prizmkit/plans/feature-list.json \
   --mode standard \
   --env "MAX_RETRIES=5 MODEL=claude-sonnet-4.6"
 ```
@@ -161,34 +181,34 @@ Manages `run-feature.sh` as a background daemon process with PID tracking and lo
 
 ---
 
-### `run-bugfix.sh` — Bug-Fix Pipeline Runner
+### `cli.py bugfix` — Bug-Fix Pipeline Runner
 
-Equivalent to `run-feature.sh` but for the bug-fix pipeline.
+Equivalent to `cli.py feature` but for the bug-fix pipeline.
 
 ```bash
-./run-bugfix.sh run [.prizmkit/plans/bug-fix-list.json]         # Run all bugs
-./run-bugfix.sh run <bug-id> [options]           # Run single bug (B-NNN)
-./run-bugfix.sh status [.prizmkit/plans/bug-fix-list.json]       # Show status
-./run-bugfix.sh reset                            # Clear all bugfix state
-./run-bugfix.sh help
+python3 ./cli.py bugfix run [.prizmkit/plans/bug-fix-list.json]         # Run all bugs
+python3 ./cli.py bugfix run <bug-id> [options]           # Run single bug (B-NNN)
+python3 ./cli.py bugfix status [.prizmkit/plans/bug-fix-list.json]       # Show status
+python3 ./cli.py reset bugfix                            # Clear all bugfix state
+python3 ./cli.py bugfix help
 ```
 
-**Single-bug options:** `--dry-run` (same as `run-feature.sh`)
+**Single-bug options:** `--dry-run` (same as `cli.py feature`)
 
 Processes bugs by: **severity** (critical > high > medium > low) then **priority** (high > medium > low).
 
 ---
 
-### `launch-bugfix-daemon.sh` — Bug-Fix Pipeline Daemon
+### `cli.py daemon bugfix` — Bug-Fix Pipeline Daemon
 
-Identical interface to `launch-feature-daemon.sh` but manages `run-bugfix.sh` in background.
+Identical interface to `cli.py daemon feature` but manages `cli.py bugfix` in background.
 
 ```bash
-./launch-bugfix-daemon.sh start [.prizmkit/plans/bug-fix-list.json] [--env "KEY=VAL ..."]
-./launch-bugfix-daemon.sh stop
-./launch-bugfix-daemon.sh status
-./launch-bugfix-daemon.sh logs [--lines N] [--follow]
-./launch-bugfix-daemon.sh restart [.prizmkit/plans/bug-fix-list.json] [--env "KEY=VAL ..."]
+python3 ./cli.py daemon bugfix start [.prizmkit/plans/bug-fix-list.json] [--env "KEY=VAL ..."]
+python3 ./cli.py daemon bugfix stop
+python3 ./cli.py daemon bugfix status
+python3 ./cli.py daemon bugfix logs [--lines N] [--follow]
+python3 ./cli.py daemon bugfix restart [.prizmkit/plans/bug-fix-list.json] [--env "KEY=VAL ..."]
 ```
 
 Uses `.prizmkit/state/bugfix/` instead of `.prizmkit/state/features/`.
@@ -285,7 +305,7 @@ python3 scripts/generate-bootstrap-prompt.py \
 { "success": true, "output_path": "/absolute/path/prompt.md", "model": "claude-sonnet-4.6" }
 ```
 
-The `model` field is extracted from the feature's `"model"` field in .prizmkit/plans/feature-list.json (empty string if not specified). Used by `run-feature.sh` to set `--model` on the AI CLI.
+The `model` field is extracted from the feature's `"model"` field in .prizmkit/plans/feature-list.json (empty string if not specified). Used by `cli.py feature` to set `--model` on the AI CLI.
 
 **Conditional blocks resolved:**
 - `{{IF_RESUME}}` / `{{IF_FRESH_START}}` — Resume vs fresh start
@@ -435,7 +455,7 @@ python3 scripts/parse-stream-progress.py \
   --progress-file <path>
 ```
 
-**Runs as a background process** (spawned by `lib/heartbeat.sh`). Reads JSONL from session log, writes progress to `progress.json` (atomic writes).
+**Runs as a background process** (spawned by `prizmkit_runtime/heartbeat.py`). Reads JSONL from session log, writes progress to `progress.json` (atomic writes).
 
 **Phase detection (monotonic):** specify → plan → analyze → implement → code-review → retrospective → commit
 
@@ -470,9 +490,9 @@ Imported by all Python scripts. Provides:
 
 ---
 
-## Shell Libraries
+## Python Runtime Modules
 
-### `lib/common.sh` — CLI Detection & Shared Helpers
+### `prizmkit_runtime/config.py` — CLI Detection & Shared Helpers
 
 Sourced by daemon and runner scripts. Provides:
 
@@ -483,14 +503,14 @@ Sourced by daemon and runner scripts. Provides:
 
 Also exports: `log_info`, `log_warn`, `log_error`, `log_success` (with timestamps), and color constants.
 
-### `lib/branch.sh` — Git Branch Lifecycle
+### `prizmkit_runtime/gitops.py` — Git Branch Lifecycle
 
 | Function | Description |
 |----------|-------------|
 | `branch_create(project_root, branch_name, source_branch)` | Create & checkout feature branch. Reuses if exists. Returns 0/1. |
 | `branch_return(project_root, original_branch)` | Checkout back to original branch |
 
-### `lib/heartbeat.sh` — Heartbeat & Progress Monitoring
+### `prizmkit_runtime/heartbeat.py` — Heartbeat & Progress Monitoring
 
 | Function | Description |
 |----------|-------------|
@@ -508,38 +528,38 @@ Also exports: `log_info`, `log_warn`, `log_error`, `log_success` (with timestamp
 
 | Variable | Default | Used By | Description |
 |----------|---------|---------|-------------|
-| `MAX_RETRIES` | `3` | run-feature.sh | Max retry attempts per feature before marking as failed |
-| `PIPELINE_MODE` | (auto) | run-feature.sh, launch-feature-daemon.sh | Override mode for all features: `lite\|standard\|full` |
-| `ENABLE_CRITIC` | `false` | run-feature.sh, launch-feature-daemon.sh | Enable adversarial critic review: `true\|false` |
-| `DEV_BRANCH` | auto-generated | run-feature.sh | Custom git branch name (default: `dev/{feature-id}-{timestamp}`) |
-| `AUTO_PUSH` | `0` | run-feature.sh | Set to `1` to auto-push branch to remote after successful session |
+| `MAX_RETRIES` | `3` | cli.py feature | Max retry attempts per feature before marking as failed |
+| `PIPELINE_MODE` | (auto) | cli.py feature, cli.py daemon feature | Override mode for all features: `lite\|standard\|full` |
+| `ENABLE_CRITIC` | `false` | cli.py feature, cli.py daemon feature | Enable adversarial critic review: `true\|false` |
+| `DEV_BRANCH` | auto-generated | cli.py feature | Custom git branch name (default: `dev/{feature-id}-{timestamp}`) |
+| `AUTO_PUSH` | `0` | cli.py feature | Set to `1` to auto-push branch to remote after successful session |
 
 ### AI CLI Configuration
 
 | Variable | Default | Used By | Description |
 |----------|---------|---------|-------------|
-| `AI_CLI` | auto-detect | all shell scripts | AI CLI command name. Auto-detects `cbc`, `claude`, or `codex` |
-| `PRIZMKIT_PLATFORM` | auto-detect | all shell scripts | Platform hint for custom/wrapped AI CLI commands: `codebuddy`, `claude`, or `codex` |
-| `MODEL` | (none) | run-feature.sh, run-bugfix.sh | AI model fallback. Overridden by per-feature `model` field. See [Model Selection](#model-selection) |
-| `CODEBUDDY_CLI` | (deprecated) | all shell scripts | Legacy alias for `AI_CLI`. Prefer `AI_CLI` |
-| `VERBOSE` | `0` | run-feature.sh | Set to `1` to enable `--verbose` on AI CLI |
+| `AI_CLI` | auto-detect | Python runtime | AI CLI command name. Auto-detects `cbc`, `claude`, or `codex` |
+| `PRIZMKIT_PLATFORM` | auto-detect | Python runtime | Platform hint for custom/wrapped AI CLI commands: `codebuddy`, `claude`, or `codex` |
+| `MODEL` | (none) | cli.py feature, cli.py bugfix | AI model fallback. Overridden by per-feature `model` field. See [Model Selection](#model-selection) |
+| `CODEBUDDY_CLI` | (deprecated) | Python runtime | Legacy alias for `AI_CLI`. Prefer `AI_CLI` |
+| `VERBOSE` | `0` | cli.py feature | Set to `1` to enable `--verbose` on AI CLI |
 
 ### Monitoring & Logging
 
 | Variable | Default | Used By | Description |
 |----------|---------|---------|-------------|
-| `HEARTBEAT_INTERVAL` | `30` | run-feature.sh | Seconds between heartbeat log output |
-| `HEARTBEAT_STALE_THRESHOLD` | `600` | run-feature.sh | Seconds before a session is considered stale/stuck |
+| `HEARTBEAT_INTERVAL` | `30` | cli.py feature | Seconds between heartbeat log output |
+| `HEARTBEAT_STALE_THRESHOLD` | `600` | cli.py feature | Seconds before a session is considered stale/stuck |
 
 **Examples:**
 
 ```bash
 # All env vars in one invocation
 MAX_RETRIES=5 MODEL=claude-sonnet-4.6 VERBOSE=1 \
-  ./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+  python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 
 # Via daemon with --env
-./.prizmkit/dev-pipeline/launch-feature-daemon.sh start .prizmkit/plans/feature-list.json \
+python3 ./.prizmkit/dev-pipeline/cli.py daemon feature start .prizmkit/plans/feature-list.json \
   --mode standard \
   --env "MAX_RETRIES=5 AUTO_PUSH=1"
 ```
@@ -576,13 +596,13 @@ Specify a model for individual features in `.prizmkit/plans/feature-list.json`:
 
 ```bash
 # All features without a per-feature model use Sonnet
-MODEL=claude-sonnet-4.6 ./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+MODEL=claude-sonnet-4.6 python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 
 # Retry with Opus
-MODEL=claude-opus-4.6 ./.prizmkit/dev-pipeline/reset-feature.sh F-007 --clean --run
+MODEL=claude-opus-4.6 python3 ./.prizmkit/dev-pipeline/cli.py reset feature F-007 --clean --run
 
 # Test which model the CLI is using
-MODEL=claude-sonnet-4.6 ./.prizmkit/dev-pipeline/run-feature.sh test-cli
+MODEL=claude-sonnet-4.6 python3 ./.prizmkit/dev-pipeline/cli.py feature test-cli
 ```
 
 ### Dry-Run Model Verification
@@ -590,7 +610,7 @@ MODEL=claude-sonnet-4.6 ./.prizmkit/dev-pipeline/run-feature.sh test-cli
 Use `--dry-run` to verify which model will be used without spawning a session:
 
 ```bash
-./.prizmkit/dev-pipeline/run-feature.sh run F-017 --dry-run
+python3 ./.prizmkit/dev-pipeline/cli.py feature run F-017 --dry-run
 # Output includes: "Feature Model: claude-opus-4.6"
 ```
 
@@ -629,15 +649,15 @@ To permanently configure, create `.prizmkit/config.json`:
 Or override per-invocation:
 
 ```bash
-AI_CLI=claude ./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+AI_CLI=claude python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 ```
 
 ### Testing AI CLI (`test-cli`)
 
 ```bash
-./.prizmkit/dev-pipeline/run-feature.sh test-cli
-MODEL=claude-sonnet-4.6 ./.prizmkit/dev-pipeline/run-feature.sh test-cli
-AI_CLI=cbc ./.prizmkit/dev-pipeline/run-feature.sh test-cli
+python3 ./.prizmkit/dev-pipeline/cli.py feature test-cli
+MODEL=claude-sonnet-4.6 python3 ./.prizmkit/dev-pipeline/cli.py feature test-cli
+AI_CLI=cbc python3 ./.prizmkit/dev-pipeline/cli.py feature test-cli
 ```
 
 ---
@@ -647,7 +667,7 @@ AI_CLI=cbc ./.prizmkit/dev-pipeline/run-feature.sh test-cli
 ### Feature Pipeline Execution Flow
 
 ```
-run-feature.sh main loop
+cli.py feature run command
   |
   +- detect-stuck.py              # Check for stale/stuck sessions
   +- update-feature-status.py     # get_next: find next runnable feature
@@ -725,14 +745,14 @@ cat .prizmkit/state/features/F-003/sessions/F-003-*/logs/session.log | less
 ### Pause & Resume
 
 - **Ctrl+C** triggers graceful shutdown — current state is saved
-- **Re-running** `./run-feature.sh run` resumes from where it left off (completed features skipped)
-- Force resume from a phase: `./run-feature.sh run .prizmkit/plans/feature-list.json --resume-phase 6`
+- **Re-running** `python3 ./cli.py feature run` resumes from where it left off (completed features skipped)
+- Force resume from a phase: `python3 ./cli.py feature run .prizmkit/plans/feature-list.json --resume-phase 6`
 
 ### Manual Intervention
 
 ```bash
 # Check what failed
-./.prizmkit/dev-pipeline/run-feature.sh status .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py feature status .prizmkit/plans/feature-list.json
 
 # Review session logs
 cat .prizmkit/state/features/F-XXX/sessions/*/logs/session.log
@@ -750,7 +770,7 @@ python3 .prizmkit/dev-pipeline/scripts/update-feature-status.py \
   --feature-id F-XXX --action reset
 
 # Resume
-./.prizmkit/dev-pipeline/run-feature.sh run .prizmkit/plans/feature-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py feature run .prizmkit/plans/feature-list.json
 ```
 
 ---
@@ -764,17 +784,17 @@ The bug fix pipeline provides the same autonomous outer-loop as the feature pipe
 ```bash
 # 1. Generate bug fix list (via bug-planner skill)
 # 2. Run foreground
-./.prizmkit/dev-pipeline/run-bugfix.sh run .prizmkit/plans/bug-fix-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py bugfix run .prizmkit/plans/bug-fix-list.json
 # 3. Or as daemon
-./.prizmkit/dev-pipeline/launch-bugfix-daemon.sh start .prizmkit/plans/bug-fix-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py daemon bugfix start .prizmkit/plans/bug-fix-list.json
 # 4. Check progress
-./.prizmkit/dev-pipeline/run-bugfix.sh status .prizmkit/plans/bug-fix-list.json
+python3 ./.prizmkit/dev-pipeline/cli.py bugfix status .prizmkit/plans/bug-fix-list.json
 ```
 
 ### Bug Fix Execution Flow
 
 ```
-run-bugfix.sh main loop
+cli.py bugfix run command
   |
   +- update-bug-status.py          # get_next (severity -> priority order)
   +- generate-bugfix-prompt.py     # Build prompt from template
@@ -827,13 +847,13 @@ run-bugfix.sh main loop
 
 ```
 .prizmkit/dev-pipeline/
-+-- run-feature.sh                           # Main pipeline runner (features)
-+-- reset-feature.sh                 # Reset & retry failed feature
-+-- reset-feature.sh                 # Reset/clean feature for re-execution
-+-- launch-feature-daemon.sh                 # Background daemon for feature pipeline
-+-- run-bugfix.sh                    # Bug-fix pipeline runner
-+-- reset-bugfix.sh                     # Reset & retry failed bug
-+-- launch-bugfix-daemon.sh          # Background daemon for bugfix pipeline
++-- cli.py feature                           # Main pipeline runner (features)
++-- cli.py reset feature                 # Reset & retry failed feature
++-- cli.py reset feature                 # Reset/clean feature for re-execution
++-- cli.py daemon feature                 # Background daemon for feature pipeline
++-- cli.py bugfix                    # Bug-fix pipeline runner
++-- cli.py reset bugfix                     # Reset & retry failed bug
++-- cli.py daemon bugfix          # Background daemon for bugfix pipeline
 +-- README.md                        # This file
 +-- .gitignore                       # Ignores .prizmkit/state/, __pycache__/
 |
@@ -922,7 +942,7 @@ Check `set -e` interactions. All python invocations in the main loop should have
 Verify CLI is functional: `claude -p "test" --dangerously-skip-permissions`, `echo "test" | cbc --print -y`, or `echo "test" | codex --ask-for-approval never --sandbox danger-full-access exec --skip-git-repo-check -`
 
 ### "PIPELINE_BLOCKED" loops
-All remaining features have unmet dependencies. Use `./run-feature.sh status` to find the blocking feature, then reset or manually complete it.
+All remaining features have unmet dependencies. Use `python3 ./cli.py feature status` to find the blocking feature, then reset or manually complete it.
 
 ### Feature marked as "crashed"
 Session exited without `session-status.json`. Pipeline retries up to `MAX_RETRIES` times automatically.

package/bundled/dev-pipeline/assets/prizm-dev-team-integration.md

@@ -9,7 +9,7 @@ dev-pipeline drives the prizm-dev-team multi-agent team through an outer shell l
 ```
 dev-pipeline (outer loop)
     │
-    ├── run-feature.sh                    Shell runner — picks next feature, spawns CLI
+    ├── cli.py feature                    Python runtime CLI — picks next feature, spawns CLI
     ├── scripts/                  Python state management scripts
     ├── templates/bootstrap-prompt.md  Session prompt template
     │

package/bundled/dev-pipeline/cli.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+"""Thin entrypoint for the PrizmKit unified Python runtime CLI."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+def _bootstrap_import_path() -> None:
+    """Ensure direct script execution can import the runtime package."""
+    pipeline_root = Path(__file__).resolve().parent
+    pipeline_root_text = str(pipeline_root)
+    if pipeline_root_text not in sys.path:
+        sys.path.insert(0, pipeline_root_text)
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Run the unified runtime CLI and return its process exit code."""
+    _bootstrap_import_path()
+    from prizmkit_runtime.cli import main as runtime_main
+
+    return runtime_main(argv)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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

@@ -0,0 +1,13 @@
+"""Public contracts for the canonical PrizmKit Python runtime."""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+__runtime_contract__ = "canonical-python-cli"
+__runtime_status__ = "python-runtime-canonical"
+
+__all__ = [
+    "__runtime_contract__",
+    "__runtime_status__",
+    "__version__",
+]

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

@@ -0,0 +1,9 @@
+"""Module entrypoint for ``python -m prizmkit_runtime``."""
+
+from __future__ import annotations
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())