prizmkit 1.1.196 → 1.1.198

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 (108) hide show
  1. package/bin/create-prizmkit.js +1 -7
  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/claude/settings-adapter.js +3 -8
  7. package/bundled/adapters/codex/paths.js +0 -1
  8. package/bundled/adapters/codex/settings-adapter.js +1 -1
  9. package/bundled/adapters/cursor/assets/prizmkit-hook.cjs +1 -1
  10. package/bundled/adapters/cursor/rules-adapter.js +1 -13
  11. package/bundled/adapters/pi/paths.js +0 -1
  12. package/bundled/dev-pipeline/.env.example +2 -2
  13. package/bundled/dev-pipeline/README.md +6 -5
  14. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +2 -2
  15. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +15 -25
  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 +32 -26
  72. package/bundled/skills/feature-pipeline-launcher/SKILL.md +33 -25
  73. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +32 -26
  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 +47 -43
  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 +29 -48
  95. package/src/index.js +2 -9
  96. package/src/manifest.js +5 -9
  97. package/src/platforms.js +0 -14
  98. package/src/prompts.js +0 -13
  99. package/src/scaffold.js +100 -327
  100. package/src/upgrade.js +38 -42
  101. package/bundled/adapters/claude/rules-adapter.js +0 -25
  102. package/bundled/adapters/codebuddy/rules-adapter.js +0 -30
  103. package/bundled/adapters/codex/rules-adapter.js +0 -30
  104. package/bundled/adapters/pi/rules-adapter.js +0 -13
  105. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +0 -10
  106. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +0 -111
  107. package/bundled/skills/bug-planner/references/verification.md +0 -26
  108. package/bundled/skills/feature-planner/references/browser-interaction.md +0 -39
@@ -51,10 +51,6 @@ program
51
51
  .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
52
52
  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
53
53
  .option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
54
- .option('--pipeline', 'Install dev-pipeline (default: true)')
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
54
  .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
59
55
  .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
60
56
  .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
@@ -103,15 +99,13 @@ program
103
99
 
104
100
  program
105
101
  .command('config [directory]')
106
- .description('Reconfigure existing PrizmKit installation (change platform, AI CLI, pipeline)')
102
+ .description('Reconfigure existing PrizmKit installation (change platform, AI CLI)')
107
103
  .option('--platform <platform>', 'Target platform: codebuddy, claude, codex, pi, cursor, antigravity, comma-separated list, or all')
108
104
  .option('--runtime <runtime>', 'Runtime assets: python or auto; unix/windows are accepted as legacy aliases for python')
109
105
  .option('--skills <suite>', '[deprecated] Ignored; PrizmKit now always installs the full core skill suite')
110
106
  .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, codex, pi, agent, agy)')
111
107
  .option('--headless-prompt-arg <arg>', 'Prompt injection argv token for a custom AI CLI (e.g. -p or -i)')
112
108
  .option('--headless-extra-args <args>', 'Additional headless argv tokens for a custom AI CLI')
113
- .option('--pipeline', 'Enable dev-pipeline')
114
- .option('--no-pipeline', 'Disable dev-pipeline')
115
109
  .option('--non-interactive', 'Skip interactive prompts')
116
110
  .option('--dry-run', 'Show what would change without applying')
117
111
  .action(async (directory = '.', options) => {
@@ -1,5 +1,5 @@
1
1
  {
2
- "frameworkVersion": "1.1.196",
3
- "bundledAt": "2026-11-21T15:21:55.168Z",
4
- "bundledFrom": "f0c45c2"
2
+ "frameworkVersion": "1.1.198",
3
+ "bundledAt": "2026-11-22T04:55:25.219Z",
4
+ "bundledFrom": "46b197d"
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)
@@ -10,7 +10,7 @@ import path from 'path';
10
10
  /**
11
11
  * Generate Claude Code settings.json for a PrizmKit-enabled project.
12
12
  * @param {string} targetRoot - Target project root
13
- * @param {Object} options - { hooks: boolean, pipeline: boolean }
13
+ * @param {Object} options - { hooks: boolean }
14
14
  */
15
15
  export async function generateSettings(targetRoot, options = {}) {
16
16
  const settingsPath = path.join(targetRoot, '.claude', 'settings.json');
@@ -62,15 +62,10 @@ export async function generateSettings(targetRoot, options = {}) {
62
62
  'Bash(./*)',
63
63
  'Bash(bash *)',
64
64
  'Bash(sh *)',
65
+ 'Bash(./.prizmkit/dev-pipeline/*)',
66
+ 'Bash(python3 .prizmkit/dev-pipeline/*)',
65
67
  ];
66
68
 
67
- if (options.pipeline) {
68
- prizmkitPermissions.push(
69
- 'Bash(./.prizmkit/dev-pipeline/*)',
70
- 'Bash(python3 .prizmkit/dev-pipeline/*)',
71
- );
72
- }
73
-
74
69
  // Merge without duplicates
75
70
  for (const perm of prizmkitPermissions) {
76
71
  if (!existing.permissions.allow.includes(perm)) {
@@ -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
 
@@ -718,7 +719,7 @@ Feature bootstrap prompts use one canonical modular section composition for ever
718
719
 
719
720
  | Feature metadata | Normal prompt source | Execution guidance |
720
721
  |------------------|----------------------|--------------------|
721
- | `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 |
722
723
  | `estimated_complexity: medium` | `templates/sections/` canonical composition | Same complete guidance |
723
724
  | `estimated_complexity: high` / `critical` | `templates/sections/` canonical composition | Same complete guidance |
724
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