prizmkit 1.1.195 → 1.1.197

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/bin/create-prizmkit.js +0 -2
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +1 -1
  4. package/bundled/adapters/antigravity/rules-adapter.js +1 -13
  5. package/bundled/adapters/claude/paths.js +0 -1
  6. package/bundled/adapters/codex/paths.js +0 -1
  7. package/bundled/adapters/codex/settings-adapter.js +1 -1
  8. package/bundled/adapters/cursor/assets/prizmkit-hook.cjs +1 -1
  9. package/bundled/adapters/cursor/rules-adapter.js +1 -13
  10. package/bundled/adapters/pi/paths.js +0 -1
  11. package/bundled/dev-pipeline/.env.example +2 -2
  12. package/bundled/dev-pipeline/README.md +9 -6
  13. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +2 -2
  14. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +15 -25
  15. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +31 -0
  16. package/bundled/dev-pipeline/prizmkit_runtime/iterate.py +1 -69
  17. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +1 -114
  18. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +2 -2
  19. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +78 -0
  20. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +4 -234
  21. package/bundled/dev-pipeline/prizmkit_runtime/status.py +0 -5
  22. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +9 -1
  23. package/bundled/dev-pipeline/scripts/feature_list_contract.py +0 -43
  24. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +15 -76
  25. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +9 -112
  26. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +0 -13
  27. package/bundled/dev-pipeline/scripts/init-pipeline.py +0 -1
  28. package/bundled/dev-pipeline/scripts/prompt_framework.py +0 -79
  29. package/bundled/dev-pipeline/scripts/status_common.py +150 -4
  30. package/bundled/dev-pipeline/scripts/update-bug-status.py +20 -2
  31. package/bundled/dev-pipeline/scripts/update-feature-status.py +20 -2
  32. package/bundled/dev-pipeline/scripts/utils.py +6 -0
  33. package/bundled/dev-pipeline/templates/bootstrap-prompt.md +4 -5
  34. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +5 -101
  35. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +0 -35
  36. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +4 -52
  37. package/bundled/dev-pipeline/templates/feature-list-schema.json +0 -25
  38. package/bundled/dev-pipeline/templates/iterate/evaluate-prompt.md +5 -16
  39. package/bundled/dev-pipeline/templates/iterate/evaluation-schema.json +1 -58
  40. package/bundled/dev-pipeline/templates/iterate/headless-plan-prompt.md +1 -12
  41. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +0 -1
  42. package/bundled/dev-pipeline/templates/sections/bugfix-phase-commit-report.md +0 -1
  43. package/bundled/dev-pipeline/templates/sections/bugfix-phase-diagnose-plan.md +2 -2
  44. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  45. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +1 -1
  46. package/bundled/dev-pipeline/templates/sections/bugfix-reminders.md +0 -2
  47. package/bundled/dev-pipeline/templates/sections/bugfix-session-context.md +0 -1
  48. package/bundled/dev-pipeline/templates/sections/bugfix-task-contract.md +0 -5
  49. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -2
  50. package/bundled/dev-pipeline/templates/sections/feature-completion-summary.md +1 -1
  51. package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +3 -3
  52. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +3 -3
  53. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +3 -3
  54. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +1 -1
  55. package/bundled/dev-pipeline/templates/sections/retrospective.md +3 -3
  56. package/bundled/dev-pipeline/templates/sections/runtime-commit-handoff.md +1 -1
  57. package/bundled/rules/USAGE.md +5 -19
  58. package/bundled/rules/general/coding-baseline.md +2 -2
  59. package/bundled/rules/prizm/prizm-progressive-loading.md +2 -1
  60. package/bundled/skills/_metadata.json +4 -4
  61. package/bundled/skills/app-planner/SKILL.md +1 -1
  62. package/bundled/skills/app-planner/references/generated-plan-review.md +1 -1
  63. package/bundled/skills/app-planner/references/rules-configuration.md +6 -7
  64. package/bundled/skills/app-planner/scripts/validate-rules-configuration.py +2 -20
  65. package/bundled/skills/bug-planner/SKILL.md +5 -6
  66. package/bundled/skills/bug-planner/assets/bug-confirmation-template.md +1 -1
  67. package/bundled/skills/bug-planner/references/input-formats.md +2 -2
  68. package/bundled/skills/bug-planner/references/schema-validation.md +0 -1
  69. package/bundled/skills/bug-planner/scripts/validate-bug-list.py +2 -9
  70. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +36 -25
  71. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +38 -31
  72. package/bundled/skills/feature-pipeline-launcher/SKILL.md +33 -25
  73. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +38 -31
  74. package/bundled/skills/feature-planner/SKILL.md +4 -10
  75. package/bundled/skills/feature-planner/references/completeness-review.md +2 -2
  76. package/bundled/skills/feature-planner/references/new-project-planning.md +0 -1
  77. package/bundled/skills/feature-planner/scripts/validate-and-generate.py +1 -25
  78. package/bundled/skills/iterate-pipeline-launcher/SKILL.md +53 -42
  79. package/bundled/skills/iterate-pipeline-launcher/references/configuration.md +52 -47
  80. package/bundled/skills/prizmkit-code-review/SKILL.md +1 -1
  81. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +2 -2
  82. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  83. package/bundled/skills/prizmkit-init/SKILL.md +6 -7
  84. package/bundled/skills/prizmkit-init/references/config-schema.md +5 -9
  85. package/bundled/skills/prizmkit-init/references/rules/layer-detection.md +1 -1
  86. package/bundled/skills/prizmkit-plan/SKILL.md +1 -1
  87. package/bundled/skills/prizmkit-retrospective/SKILL.md +3 -3
  88. package/bundled/skills/prizmkit-retrospective/references/rule-evolution-steps.md +11 -17
  89. package/bundled/skills/prizmkit-workflow/SKILL.md +6 -3
  90. package/bundled/skills/prizmkit-workflow/references/cold-start-rules.md +8 -7
  91. package/bundled/templates/project-memory-template.md +2 -1
  92. package/package.json +1 -1
  93. package/src/clean.js +29 -7
  94. package/src/config.js +13 -15
  95. package/src/index.js +1 -5
  96. package/src/manifest.js +3 -6
  97. package/src/platforms.js +0 -14
  98. package/src/scaffold.js +93 -313
  99. package/src/upgrade.js +32 -31
  100. package/bundled/adapters/claude/rules-adapter.js +0 -25
  101. package/bundled/adapters/codebuddy/rules-adapter.js +0 -30
  102. package/bundled/adapters/codex/rules-adapter.js +0 -30
  103. package/bundled/adapters/pi/rules-adapter.js +0 -13
  104. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +0 -10
  105. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +0 -111
  106. package/bundled/skills/bug-planner/references/verification.md +0 -26
  107. package/bundled/skills/feature-planner/references/browser-interaction.md +0 -39
@@ -53,8 +53,6 @@ program
53
53
  .option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
54
54
  .option('--pipeline', 'Install dev-pipeline (default: true)')
55
55
  .option('--no-pipeline', 'Disable dev-pipeline')
56
- .option('--playwright-cli', 'Install playwright-cli browser tool (default: true)')
57
- .option('--no-playwright-cli', 'Disable playwright-cli installation')
58
56
  .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
59
57
  .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
60
58
  .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
@@ -1,5 +1,5 @@
1
1
  {
2
- "frameworkVersion": "1.1.195",
3
- "bundledAt": "2026-11-21T14:44:32.676Z",
4
- "bundledFrom": "5ea9436"
2
+ "frameworkVersion": "1.1.197",
3
+ "bundledAt": "2026-11-21T18:42:24.720Z",
4
+ "bundledFrom": "bfdaef1"
5
5
  }
@@ -65,7 +65,7 @@ function sessionStart(input) {
65
65
  const projectRoot = resolveProjectRoot(input);
66
66
  if (fs.existsSync(path.join(projectRoot, '.prizmkit', 'prizm-docs', 'root.prizm'))) {
67
67
  return systemMessageResponse(
68
- 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .agents/plugins/prizmkit/skills and Rules in .agents/plugins/prizmkit/rules.',
68
+ 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .agents/plugins/prizmkit/skills and Rules in .prizmkit/rules/builtin and .prizmkit/rules.',
69
69
  );
70
70
  }
71
71
  return systemMessageResponse(
@@ -22,18 +22,6 @@ export function convertToAntigravityRule(markdown, fallbackDescription) {
22
22
  return buildMarkdown(ruleFrontmatter, body);
23
23
  }
24
24
 
25
- export async function installRules(targetRoot, ruleFiles) {
26
- const rulesDir = path.join(targetRoot, RULES_DIR);
27
- mkdirSync(rulesDir, { recursive: true });
28
- for (const rule of ruleFiles) {
29
- const baseName = path.basename(rule.name);
30
- await writeFile(
31
- path.join(rulesDir, `${baseName}.md`),
32
- convertToAntigravityRule(rule.content, rule.name),
33
- );
34
- }
35
- }
36
-
37
25
  export async function installFrameworkGuidance(targetRoot, templateContent) {
38
26
  const rulesDir = path.join(targetRoot, RULES_DIR);
39
27
  mkdirSync(rulesDir, { recursive: true });
@@ -44,7 +32,7 @@ Antigravity discovers project Skills from \`${SKILLS_DIR}/\`. Invoke them with \
44
32
 
45
33
  - Start with \`/prizmkit\` to see all available PrizmKit skills.
46
34
  - Skill assets and references live inside each \`${SKILLS_DIR}/<skill>/\` directory.
47
- - PrizmKit behavioral rules live in \`${RULES_DIR}/\`; read the relevant Rule before commit, documentation, or context-loading work.
35
+ - PrizmKit built-in rules live in \`.prizmkit/rules/builtin/\` (\`coding-baseline.md\`, \`cohesive-modeling.md\`, and \`prizm-*.md\`); read the relevant rules before planning, implementation, code review, commit, documentation, or context-loading work.
48
36
  `,
49
37
  );
50
38
  await writeFile(
@@ -9,7 +9,6 @@ export const CLI_COMMAND = 'claude';
9
9
  export const COMMANDS_DIR = '.claude/commands';
10
10
  export const AGENTS_DIR = '.claude/agents';
11
11
  export const SETTINGS_FILE = '.claude/settings.json';
12
- export const RULES_DIR = '.claude/rules';
13
12
  export const MCP_CONFIG_FILE = '.mcp.json';
14
13
 
15
14
  // Global paths (relative to home directory)
@@ -8,7 +8,6 @@ export const CLI_COMMAND = 'codex';
8
8
  // Project-level paths (relative to project root)
9
9
  export const SKILLS_DIR = '.agents/skills';
10
10
  export const AGENTS_DIR = '.codex/agents';
11
- export const RULES_DIR = '.agents/rules';
12
11
  export const SETTINGS_FILE = '.codex/config.toml';
13
12
  export const PROJECT_MEMORY_FILE = 'AGENTS.md';
14
13
 
@@ -14,7 +14,7 @@ export async function generateSettings(targetRoot) {
14
14
 
15
15
  const configToml = `# Generated by PrizmKit for Codex CLI project configuration.
16
16
  # Keep project guidance in AGENTS.md; repository skills in .agents/skills/;
17
- # PrizmKit behavioral rules live in .agents/rules/; native Codex subagents live in .codex/agents/.
17
+ # PrizmKit built-in rules live in .prizmkit/rules/builtin/; native Codex subagents live in .codex/agents/.
18
18
 
19
19
  project_doc_fallback_filenames = ["CLAUDE.md", "CODEBUDDY.md"]
20
20
 
@@ -23,7 +23,7 @@ function writeOutput(value) {
23
23
  function sessionStart() {
24
24
  if (fs.existsSync('.prizmkit/prizm-docs/root.prizm')) {
25
25
  return {
26
- additional_context: 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .cursor/skills and Rules in .cursor/rules.',
26
+ additional_context: 'PrizmKit: read exact .prizmkit/prizm-docs/root.prizm first, then load only relevant pointed module documents. Use the project Skills in .cursor/skills and Rules in .prizmkit/rules/builtin and .prizmkit/rules.',
27
27
  };
28
28
  }
29
29
  return {
@@ -17,18 +17,6 @@ export function convertToMdc(markdown, fallbackDescription) {
17
17
  );
18
18
  }
19
19
 
20
- export async function installRules(targetRoot, ruleFiles) {
21
- const rulesDir = path.join(targetRoot, '.cursor', 'rules');
22
- mkdirSync(rulesDir, { recursive: true });
23
- for (const rule of ruleFiles) {
24
- const baseName = path.basename(rule.name);
25
- await writeFile(
26
- path.join(rulesDir, `${baseName}.mdc`),
27
- convertToMdc(rule.content, rule.name),
28
- );
29
- }
30
- }
31
-
32
20
  export async function installFrameworkGuidance(targetRoot, templateContent) {
33
21
  const rulesDir = path.join(targetRoot, '.cursor', 'rules');
34
22
  mkdirSync(rulesDir, { recursive: true });
@@ -39,7 +27,7 @@ Cursor discovers project Agent Skills from \`.cursor/skills/\`. Invoke them with
39
27
 
40
28
  - Start with \`/prizmkit\` to see all available PrizmKit skills.
41
29
  - Skill assets and references live inside each \`.cursor/skills/<skill>/\` directory.
42
- - PrizmKit behavioral rules live in \`.cursor/rules/\`; read the relevant Rule before commit, documentation, or context-loading work.
30
+ - PrizmKit built-in rules live in \`.prizmkit/rules/builtin/\` (\`coding-baseline.md\`, \`cohesive-modeling.md\`, and \`prizm-*.md\`); read the relevant rules before planning, implementation, code review, commit, documentation, or context-loading work.
43
31
  `,
44
32
  );
45
33
  await writeFile(
@@ -2,7 +2,6 @@
2
2
  export const PLATFORM_ID = 'pi';
3
3
  export const CLI_COMMAND = 'pi';
4
4
  export const SKILLS_DIR = '.pi/skills';
5
- export const RULES_DIR = '.pi/rules';
6
5
  export const SETTINGS_FILE = '.pi/settings.json';
7
6
  export const PROJECT_MEMORY_FILE = '.pi/APPEND_SYSTEM.md';
8
7
  export const SKILL_DEFINITION_FILE = 'SKILL.md';
@@ -20,8 +20,8 @@
20
20
 
21
21
  # ─── Pipeline Execution ──────────────────────────────────────────────
22
22
  # MAX_RETRIES=3 # Max retry attempts per task before marking failed
23
- # STOP_ON_FAILURE=0 # Stop pipeline immediately on first failed task (1=on, 0=continue)
24
- # VERBOSE=1 # Verbose logging (1=on, 0=off)
23
+ # STOP_ON_FAILURE=1 # Stop pipeline immediately on first failed task (1=on (default), 0=continue)
24
+ # VERBOSE=0 # Verbose logging (0=off (default), 1=on)
25
25
 
26
26
  # ─── Branch Management ────────────────────────────────────────────────
27
27
  # AUTO_PUSH=0 # Auto-push to remote after successful task (0=off, 1=on)
@@ -263,7 +263,7 @@ python3 scripts/init-bugfix-pipeline.py \
263
263
  --state-dir <path>
264
264
  ```
265
265
 
266
- **Validation:** Schema `dev-pipeline-bug-fix-list-v1`, required fields per bug: `id` (B-NNN), `title`, `description`, `severity` (critical|high|medium|low), `error_source`, `verification_type`, `acceptance_criteria`, `status`.
266
+ **Validation:** Schema `dev-pipeline-bug-fix-list-v1`, required fields per bug: `id` (B-NNN), `title`, `description`, `severity` (critical|high|medium|low), `error_source`, `acceptance_criteria`, `status`.
267
267
 
268
268
  ---
269
269
 
@@ -338,7 +338,7 @@ python3 scripts/generate-bugfix-prompt.py \
338
338
  [--template <path>]
339
339
  ```
340
340
 
341
- Resolves `{{BUG_ID}}`, `{{BUG_TITLE}}`, `{{SEVERITY}}`, `{{VERIFICATION_TYPE}}`, `{{ERROR_SOURCE}}`, etc.
341
+ Resolves `{{BUG_ID}}`, `{{BUG_TITLE}}`, `{{SEVERITY}}`, `{{ERROR_SOURCE}}`, etc.
342
342
 
343
343
  ---
344
344
 
@@ -468,7 +468,7 @@ python3 scripts/parse-stream-progress.py \
468
468
 
469
469
  **Runs as a background process** (spawned by `prizmkit_runtime/heartbeat.py`). Reads JSONL from session log, writes progress to `progress.json` (atomic writes).
470
470
 
471
- **Phase detection (monotonic):** specify → plan → analyze → implement → code-review → retrospective → commit
471
+ **Phase detection (monotonic):** plan → implement → code-review → test → summary → retrospective → commit
472
472
 
473
473
  **Output (progress.json):**
474
474
 
@@ -528,7 +528,8 @@ Provides `load_runtime_config()`, `load_env_file()`, and `resolve_ai_client()`.
528
528
 
529
529
  | Variable | Default | Used By | Description |
530
530
  |----------|---------|---------|-------------|
531
- | `MAX_RETRIES` | `3` | cli.py run feature | Max retry attempts per feature before marking as failed |
531
+ | `MAX_RETRIES` | `3` | cli.py run feature, cli.py run bugfix | Max retry attempts per task before marking as failed |
532
+ | `STOP_ON_FAILURE` | `1` | cli.py run feature, cli.py run bugfix | Stop pipeline immediately on first failed task (`1`=on default; set `0` to continue to other eligible tasks) |
532
533
  | `DEV_BRANCH` | auto-generated | cli.py run feature | Custom git branch name (default: `dev/{feature-id}-{timestamp}`) |
533
534
  | `AUTO_PUSH` | `0` | cli.py run feature | Set to `1` to auto-push branch to remote after successful session |
534
535
 
@@ -660,6 +661,8 @@ AI_CLI=agent python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
660
661
  AI_CLI=agy python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
661
662
  ```
662
663
 
664
+ `diagnostics ai-cli` emits structured resolution and capability fields (`detected_cli`, `platform`, `source`, `runtime_mode`, `model_arg_supported`, `effort_flag_mode` as `flag` | `config` | `none` | `custom_ignored`, `supported_effort_values`, and `cli_available`, plus optional `model` and `note` lines). It exits non-zero when no AI CLI can be resolved (`detected_cli: (not found)`), and reports `cli_available: false` with a diagnostic `note:` when an explicitly configured CLI executable is not found on `PATH`.
665
+
663
666
  ### Cursor Agent native headless contract
664
667
 
665
668
  Install Cursor Agent separately (`curl https://cursor.com/install -fsS | bash` on macOS/Linux/WSL, or `irm 'https://cursor.com/install?win32=true' | iex` in native Windows PowerShell). Verify and authenticate with `agent --version`, `agent login`, and `agent status`; update with `agent update`. Because `agent` is a generic executable name, PATH fallback verifies Cursor identity and the required help flags before selecting it.
@@ -670,7 +673,7 @@ For a Pipeline session, PrizmKit runs:
670
673
  agent --print --force --trust --output-format stream-json [--model <model>]
671
674
  ```
672
675
 
673
- The complete coordinator Prompt is sent through stdin and the active task checkout is the process `cwd`. PrizmKit does not pass Cursor `--worktree`, does not disable Cursor sandbox policy, and does not create or modify `.cursor/cli.json`; user and enterprise deny policy continues to apply. Authentication is inherited from `agent login` or `CURSOR_API_KEY`, never serialized into PrizmKit config, argv, or logs. Cursor exposes no documented effort parameter, so `PRIZMKIT_EFFORT` must remain unset for `AI_CLI=agent`; a non-empty value fails with an actionable diagnostic.
676
+ The complete coordinator Prompt is sent through stdin and the active task checkout is the process `cwd`. PrizmKit does not pass Cursor `--worktree`, does not disable Cursor sandbox policy, and does not create or modify `.cursor/cli.json`; user and enterprise deny policy continues to apply. Authentication is inherited from `agent login` or `CURSOR_API_KEY`, never serialized into PrizmKit config, argv, or logs. Cursor exposes no documented effort parameter, so `PRIZMKIT_EFFORT` must remain unset for `AI_CLI=agent` (a non-empty value fails with an actionable diagnostic); instead, Cursor supports parameterized `--model` identifiers such as `MODEL='claude-opus-4-8[context=1m,effort=high,fast=false]'`.
674
677
 
675
678
  ### Antigravity CLI native headless contract
676
679
 
@@ -716,7 +719,7 @@ Feature bootstrap prompts use one canonical modular section composition for ever
716
719
 
717
720
  | Feature metadata | Normal prompt source | Execution guidance |
718
721
  |------------------|----------------------|--------------------|
719
- | `estimated_complexity: low` | `templates/sections/` canonical composition | Plan → implement → review → configured verification → test → report → retrospective → Runtime commit handoff |
722
+ | `estimated_complexity: low` | `templates/sections/` canonical composition | Plan → implement → review → test → report → retrospective → Runtime commit handoff |
720
723
  | `estimated_complexity: medium` | `templates/sections/` canonical composition | Same complete guidance |
721
724
  | `estimated_complexity: high` / `critical` | `templates/sections/` canonical composition | Same complete guidance |
722
725
 
@@ -25,7 +25,7 @@ dev-pipeline (outer loop)
25
25
  +-- Mandatory local plan/spec review, then optional strict-gated independent Plan review
26
26
  +-- Implement through /prizmkit-implement
27
27
  +-- Mandatory Main-Agent code review, then optional strict-gated independent Code review
28
- +-- Scoped test gate and browser attempt
28
+ +-- Scoped test gate (/prizmkit-test)
29
29
  +-- Retrospective & commit (orchestrator)
30
30
  ```
31
31
 
@@ -68,7 +68,7 @@ Located at `.prizmkit/dev-pipeline/scripts/`:
68
68
  | `parse-stream-progress.py` | Parse AI CLI output stream for progress tracking |
69
69
  | `update-checkpoint.py` | Validate and atomically update `workflow-checkpoint.json` steps and semantic state |
70
70
  | `patch-completion-notes.py` | Patch completion notes onto plan items |
71
- | `prizmkit-runtime-helper.py` | Helper CLI for platform/port/process/checkpoint text checks |
71
+ | `prizmkit-runtime-helper.py` | Helper CLI for artifact, source-file, text, and review-verdict checks |
72
72
  | `utils.py` | Shared utility functions for pipeline scripts |
73
73
 
74
74
  ## Session Lifecycle
@@ -135,6 +135,14 @@ class CheckpointStep:
135
135
  """Return a compact human label for cursor summaries."""
136
136
  return f"{self.id} ({self.skill})"
137
137
 
138
+ @property
139
+ def display_status(self) -> str:
140
+ """Return a human-readable step status with step name and optional stage_result."""
141
+ title = self.name or self.skill
142
+ if self.stage_result:
143
+ return f"{self.id} [{title}]: {self.status} ({self.stage_result})"
144
+ return f"{self.id} [{title}]: {self.status}"
145
+
138
146
 
139
147
  @dataclass(frozen=True)
140
148
  class SemanticCheckpoint:
@@ -416,6 +424,12 @@ def read_checkpoint_cursor(path: str | Path | None) -> int | None:
416
424
  return load_checkpoint_state(path).cursor
417
425
 
418
426
 
427
+ def read_checkpoint_step_display(path: str | Path | None) -> tuple[int | None, str]:
428
+ """Read both the numeric cursor and user-facing step name from a valid checkpoint."""
429
+ state = load_checkpoint_state(path)
430
+ return state.cursor, state.current_step_name
431
+
432
+
419
433
  def checkpoint_cursor(checkpoint: Mapping[str, Any] | None) -> dict[str, object]:
420
434
  """Summarize checkpoint step groups and the first active cursor."""
421
435
  state = validate_checkpoint_data(checkpoint or {}, exists=checkpoint is not None)
@@ -628,8 +642,6 @@ def _derive_semantic_state(
628
642
  _required_sequence_error(steps, required)
629
643
  if required else "unsupported workflow family"
630
644
  )
631
- if not canonical_sequence_error:
632
- canonical_sequence_error = _configured_verification_sequence_error(steps)
633
645
  legacy_required = LEGACY_FAMILY_REQUIRED_STAGES.get(workflow_type)
634
646
  legacy_sequence_valid = bool(
635
647
  canonical_sequence_error
@@ -727,11 +739,6 @@ def _derive_semantic_state(
727
739
  and plan_step.status == "completed"
728
740
  and plan_step.stage_result == "PLAN_READY"
729
741
  )
730
- configured_manual_valid = all(
731
- step.status == "completed"
732
- for step in steps
733
- if step.skill == "manual-verification"
734
- )
735
742
  implementation_valid = bool(
736
743
  implement_step
737
744
  and implement_step.status == "completed"
@@ -784,7 +791,7 @@ def _derive_semantic_state(
784
791
  and _required_step_artifacts_valid(committer_step, checkpoint_path, project_root)
785
792
  )
786
793
  commit_ready = (
787
- canonical_sequence_valid and plan_valid and configured_manual_valid
794
+ canonical_sequence_valid and plan_valid
788
795
  and all_precommit_completed and implementation_valid and review_valid
789
796
  and test_result_valid and retrospective_valid and artifacts_valid
790
797
  and commit_request_valid and terminal_status is None
@@ -871,23 +878,6 @@ def _required_sequence_error(
871
878
  return ""
872
879
 
873
880
 
874
- def _configured_verification_sequence_error(
875
- steps: tuple[CheckpointStep, ...],
876
- ) -> str:
877
- """Require configured Browser/Manual checks between Review and Test."""
878
- review = _single_step(steps, "prizmkit-code-review")
879
- test = _single_step(steps, "prizmkit-test")
880
- if review is None or test is None:
881
- return ""
882
- for skill in ("browser-verification", "manual-verification"):
883
- matches = [step for step in steps if step.skill == skill]
884
- if len(matches) > 1:
885
- return f"Expected at most one configured stage {skill}"
886
- if matches and not (review.index < matches[0].index < test.index):
887
- return f"Configured stage {skill} must run after review and before test"
888
- return ""
889
-
890
-
891
881
  def _single_step(steps: tuple[CheckpointStep, ...], skill: str) -> CheckpointStep | None:
892
882
  matches = [step for step in steps if step.skill == skill]
893
883
  return matches[0] if len(matches) == 1 else None
@@ -2,7 +2,10 @@
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
+ import os
6
+ import shutil
5
7
  from dataclasses import dataclass
8
+ from pathlib import Path
6
9
 
7
10
  from .compat import MIN_PYTHON
8
11
  from .interoperability import UTILITY_ENTRYPOINTS, describe_existing_entrypoint
@@ -303,6 +306,26 @@ def diagnostics_version() -> CommandResult:
303
306
  )
304
307
 
305
308
 
309
+ def _is_cli_executable_available(
310
+ command: str | None,
311
+ path_entries: tuple[Path, ...] | None,
312
+ ) -> bool:
313
+ """Return whether the resolved AI CLI executable exists and is runnable."""
314
+ if not command:
315
+ return False
316
+ if os.sep in command or (os.altsep and os.altsep in command):
317
+ candidate = Path(command)
318
+ if os.name == "nt":
319
+ return candidate.is_file()
320
+ return candidate.is_file() and os.access(command, os.X_OK)
321
+ search_path = (
322
+ os.pathsep.join(str(entry) for entry in path_entries)
323
+ if path_entries is not None
324
+ else os.environ.get("PATH", "")
325
+ )
326
+ return shutil.which(command, path=search_path) is not None
327
+
328
+
306
329
  def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
307
330
  """Report the family-neutral AI CLI resolution used by runtime commands."""
308
331
  from .config import ai_cli_capabilities, load_runtime_config
@@ -316,6 +339,9 @@ def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
316
339
  if capabilities.supported_effort_values
317
340
  else "none"
318
341
  )
342
+ env_obj = getattr(config, "environment", None)
343
+ path_entries = getattr(env_obj, "path_entries", None)
344
+ cli_available = _is_cli_executable_available(config.ai_client.command, path_entries)
319
345
  details = [
320
346
  f"detected_cli: {cli}",
321
347
  f"platform: {config.ai_client.platform or 'unresolved'}",
@@ -324,10 +350,15 @@ def diagnostics_ai_cli(paths: RuntimePaths | None = None) -> CommandResult:
324
350
  f"model_arg_supported: {'true' if capabilities.model_arg_supported else 'false'}",
325
351
  f"effort_flag_mode: {capabilities.effort_flag_mode}",
326
352
  f"supported_effort_values: {supported_efforts}",
353
+ f"cli_available: {'true' if cli_available else 'false'}",
327
354
  ]
328
355
  if config.model:
329
356
  details.append(f"model: {config.model}")
330
357
  details.extend(f"note: {note}" for note in config.ai_client.notes)
358
+ if config.ai_client.command and not cli_available:
359
+ details.append(
360
+ f"note: Resolved AI CLI '{cli}' was not found on PATH; install it or adjust PATH/AI_CLI before launching."
361
+ )
331
362
  return CommandResult(
332
363
  0 if config.ai_client.command else 1,
333
364
  "Python runtime AI CLI diagnostics",