prizmkit 1.1.191 → 1.1.192

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 (169) hide show
  1. package/bundled/VERSION.json +3 -3
  2. package/bundled/adapters/antigravity/skill-adapter.js +13 -4
  3. package/bundled/adapters/codex/skill-adapter.js +28 -8
  4. package/bundled/adapters/cursor/skill-adapter.js +13 -4
  5. package/bundled/adapters/pi/skill-adapter.js +28 -7
  6. package/bundled/dev-pipeline/.env.example +4 -12
  7. package/bundled/dev-pipeline/README.md +5 -10
  8. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +3 -6
  9. package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
  10. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
  11. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
  12. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
  13. package/bundled/dev-pipeline/prizmkit_runtime/config.py +24 -76
  14. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +125 -67
  15. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +77 -430
  16. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +93 -49
  17. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -3
  18. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
  19. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +36 -14
  20. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +206 -151
  21. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +2 -23
  22. package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +15 -134
  23. package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
  24. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +68 -83
  25. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
  26. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -29
  27. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
  28. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
  29. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +276 -217
  30. package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +124 -122
  31. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
  32. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +183 -130
  33. package/bundled/dev-pipeline/prizmkit_runtime/status.py +1 -3
  34. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2780 -0
  35. package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -101
  36. package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
  37. package/bundled/dev-pipeline/scripts/check-session-status.py +43 -19
  38. package/bundled/dev-pipeline/scripts/continuation.py +6 -4
  39. package/bundled/dev-pipeline/scripts/detect-stuck.py +28 -28
  40. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +7 -2
  41. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +7 -2
  42. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
  43. package/bundled/dev-pipeline/scripts/init-change-artifact.py +8 -2
  44. package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
  45. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2616
  46. package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
  47. package/bundled/dev-pipeline/scripts/prompt_framework.py +56 -9
  48. package/bundled/dev-pipeline/scripts/status_common.py +591 -0
  49. package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
  50. package/bundled/dev-pipeline/scripts/update-checkpoint.py +227 -65
  51. package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
  52. package/bundled/dev-pipeline/scripts/utils.py +5 -12
  53. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +4 -4
  54. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
  55. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +1 -1
  56. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
  57. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
  58. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  59. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
  60. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
  61. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
  62. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
  63. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
  64. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
  65. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
  66. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
  67. package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
  68. package/bundled/dev-pipeline/tests/_helpers.py +418 -0
  69. package/bundled/dev-pipeline/tests/conftest.py +45 -1
  70. package/bundled/dev-pipeline/tests/test_auto_skip.py +4 -69
  71. package/bundled/dev-pipeline/tests/test_checkpoint_state.py +126 -1
  72. package/bundled/dev-pipeline/tests/test_daemon_and_scripts.py +257 -0
  73. package/bundled/dev-pipeline/tests/test_e2e_pipeline_run.py +500 -0
  74. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +59 -117
  75. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +12 -10
  76. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +431 -3099
  77. package/bundled/dev-pipeline/tests/test_recovery_workflow.py +7 -8
  78. package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -1
  79. package/bundled/dev-pipeline/tests/test_reset_modes.py +15 -27
  80. package/bundled/dev-pipeline/tests/test_reset_preserve.py +54 -139
  81. package/bundled/dev-pipeline/tests/test_runner_bookkeeping.py +766 -0
  82. package/bundled/dev-pipeline/tests/test_runner_lifecycle.py +1257 -0
  83. package/bundled/dev-pipeline/tests/test_runtime_helper.py +97 -20
  84. package/bundled/dev-pipeline/tests/test_session_launch.py +1101 -0
  85. package/bundled/dev-pipeline/tests/test_stream_progress.py +585 -0
  86. package/bundled/dev-pipeline/tests/test_unified_cli.py +155 -2034
  87. package/bundled/dev-pipeline/tests/test_utils.py +3 -3
  88. package/bundled/skills/_metadata.json +9 -63
  89. package/bundled/skills/app-planner/SKILL.md +32 -303
  90. package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
  91. package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
  92. package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
  93. package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
  94. package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
  95. package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
  96. package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
  97. package/bundled/skills/bug-planner/SKILL.md +54 -435
  98. package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
  99. package/bundled/skills/bug-planner/references/input-formats.md +32 -0
  100. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
  101. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
  102. package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
  103. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
  104. package/bundled/skills/feature-planner/SKILL.md +60 -439
  105. package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
  106. package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
  107. package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
  108. package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
  109. package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
  110. package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
  111. package/bundled/skills/feature-workflow/SKILL.md +1 -2
  112. package/bundled/skills/prizmkit/SKILL.md +7 -1
  113. package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
  114. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
  115. package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
  116. package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
  117. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  118. package/bundled/skills/prizmkit-init/SKILL.md +24 -127
  119. package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
  120. package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
  121. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
  122. package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
  123. package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
  124. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
  125. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
  126. package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
  127. package/bundled/skills/prizmkit-test/SKILL.md +25 -133
  128. package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
  129. package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
  130. package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
  131. package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
  132. package/bundled/skills/recovery-workflow/SKILL.md +7 -7
  133. package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
  134. package/bundled/skills/recovery-workflow/references/detection.md +1 -3
  135. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
  136. package/bundled/templates/project-memory-template.md +1 -2
  137. package/package.json +1 -1
  138. package/src/scaffold.js +28 -7
  139. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
  140. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
  141. package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
  142. package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
  143. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
  144. package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
  145. package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
  146. package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
  147. package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
  148. package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
  149. package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
  150. package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
  151. package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
  152. package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
  153. package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
  154. package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
  155. package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
  156. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
  157. package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
  158. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
  159. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
  160. package/bundled/skills/refactor-planner/SKILL.md +0 -467
  161. package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
  162. package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
  163. package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
  164. package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
  165. package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
  166. package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
  167. package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
  168. package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
  169. package/bundled/skills/refactor-workflow/SKILL.md +0 -205
@@ -51,3 +51,35 @@ ALERT: Error rate spike: 500 errors/min on /api/login endpoint
51
51
  ```
52
52
 
53
53
  Extract: `error_source.type="monitoring_alert"`, `error_message`, `affected_modules`
54
+
55
+ ## Fresh-Session Task Contract Reference
56
+
57
+ Every new or changed bug is an executable contract for a fresh AI session that has never seen the planning conversation. Do not add new JSON fields, context objects, schema versions, or pipeline runtime structures. Use the existing fields correctly:
58
+
59
+ 1. **Self-contained contract**: `description` and `acceptance_criteria`, read together, MUST define the objective, current state and actual behavior, desired state and expected behavior, selected scope and decisions, severity rationale, constraints, non-goals, relevant integrations, edge cases, reproduction conditions, verification decisions, and completion evidence. Include the durable severity rationale in `description`. AI rewrite is allowed; dropping a confirmed item is not. There is no word-count or acceptance-criteria count upper limit.
60
+ 2. **Supplementary evidence only**: `user_context` is supplementary evidence only. Logs, stack traces, screenshots, and source excerpts may support diagnosis, but MUST NOT expand, replace, or contradict the contract. If `user_context` were removed, a fresh bug-fix session must still know what fails, where/when it fails, correct behavior, selected scope, and verification. Preserve substantive requirements and constraints in durable prose at matching detail.
61
+ 3. **Severity and verification are durable decisions**: Write complete severity rationale, selected scope, environment, reproduction path, verification type, and verification decisions by meaning; never store only an option label or conversational answer.
62
+ 4. **Clarify by impact, do not guess**: Clarify expected behavior, selected scope, applicability, and relative references when ambiguity changes the contract. Root cause, code location, and fix approach may stay explicitly labeled as evidence-backed hypotheses or unknowns (`do not force certainty or invent a fix`).
63
+ 5. **Bug isolation**: Keep one bug per task unless bugs share the same root cause or failing contract and the user confirms merging (never domain-merge unrelated bugs in the same module). Repeat shared environment or constraints only when global.
64
+
65
+ ### Artifact-Wide AI Readability & Normalization
66
+
67
+ - Every generated natural-language value (`project_description`, `global_context`, titles, descriptions, acceptance criteria, severity/priority rationale, `error_source`, environment, `user_context`, verification goals, comments, parentheticals) must be a standalone domain statement (machine IDs/enums/timestamps exempt).
68
+ - Never emit dialogue-role/chronology labels (`user said`, `user answered`, `original request`, `this round`, `previous discussion`, `as discussed earlier`, `用户本轮回答`, `如前面讨论`), planning question IDs, answer tokens, recommendation markers, checkpoint provenance, or raw internal answer-map entries.
69
+ - Never persist standalone option labels (`A`, `B`, `C`, `方案A`, `方案B`) or transcript annotations (`(original response: "...")`). Resolve relative statements (`上面`, `这个`, `按推荐走`, `同前`, `继续这样`, `用刚才的方案`, `same as above`, `go with your recommendation`) only when there is one provable antecedent; otherwise ask the user for clarification and never guess.
70
+ - Treat `所有问题都按你的推荐处理`, `全部按照推荐`, `use all recommendations`, and equivalent blanket recommendation approval as conversational authorization: apply concrete recommendations and omit the blanket approval token.
71
+ - Preserve rejected root-cause/fix alternatives only when they define necessary non-goals. Every retained code/config/interface/URL reference must be purpose-tagged (this applies to paths and URLs in structured evidence and `user_context`). Retain exact user wording only when it is independently intelligible and materially useful. Do not retain non-code planning-source paths such as `.agents/brainstorm/<note>.md`, uploaded-report paths, screenshot paths, or ad-hoc log paths (such as `logs/api-500.log`) in durable bug contracts—copy or normalize the task-relevant content into `description` and `acceptance_criteria` so the bug must not depend on that source file still existing. For large materials, preserve purpose and only task-relevant exact excerpts; embed complete large materials only when the execution session cannot access the source and all content is genuinely required.
72
+
73
+ ### Examples & Phase 4 Step Details
74
+
75
+ - Bad: `方案B`, `按推荐走`, `use option A`, `Selected decision: reject empty passwords (original response: "方案B")`, `全部按照推荐`, attaching complete logs/files while saying `fix this`.
76
+ - Good: `Selected decision: reject empty passwords in request validation with HTTP 400 and do not enter credential verification`; `src/auth/validation.ts — inspect empty-password handling`; inline relevant exception/correlation excerpts plus expected vs actual behavior.
77
+ - Multi-bug isolation: if `Bug A` is login empty-password crash and `Bug B` is CSV encoding loss with shared `Node 20`, keep each bug contract isolated to its own behavior and include `Node 20` on both without cross-contaminating Bug A and Bug B.
78
+ - **Step 1 (Adequacy scan)**: Ensure description states expected vs actual behavior, specific reproduction path and trigger action, evidenced code-location hint or explicit unknown/discovery target, and verification method (e.g., Bad: `"Login is broken"`; Good: `"/login returns 500 on empty password; expected 400; suspect src/api/auth.ts POST /api/auth/login"`).
79
+ - **Step 2 (Criteria specificity)**: Each criterion must pass headless autonomy without subjective phrasing (`"works correctly"`, `"performs better"`).
80
+ - **Step 3 (Cross-bug)**: One bug per task (merge only on shared root cause + confirmation), flag missing dependencies (`B-002` depends on `B-001`), flag broader symptom areas.
81
+ - **Step 4 (Review table)**: Present `${SKILL_DIR}/assets/bug-confirmation-template.md` §Completeness Review Template and resolve every `NEEDS_FIXES` item before Phase 5.
82
+
83
+ ## Bounded Existing-List Context (Hard Rule)
84
+
85
+ For append flows on `.prizmkit/plans/bug-fix-list.json`, NEVER read the complete existing list or NEVER perform default full-history keyword search. Inspect the five most recently appended `{id, description}` pairs from `context` only for material continuation, duplication, conflict, shared public contract, or real prerequisite (`Chronology, broad module overlap, shared technology, reusable implementation ideas, or similar wording alone do not establish relevance`; Add no historical content by default; incorporate only the minimum exact information whose omission would make scope, behavior, compatibility, acceptance criteria, or dependency ordering incorrect; no vague `related to B-123`; add an old ID to `dependencies` only when it is a real execution prerequisite). Use `show --id B-NNN` only for explicit old IDs or validation errors. Write additions-only `{ "bugs": [...] }` (required draft fields: `id`, `title`, `description`, `severity`, `error_source`, `verification_type`, `acceptance_criteria`; `status` defaults to `pending`) in `.prizmkit/plans/bug-fix-list.draft.json`, check `append --dry-run` (Do not ask for separate user approval merely to promote the draft into the final list), pass Local Generated-Plan Review, insert once, delete the draft immediately, and present the final written result. Conditions that must keep a draft live in `references/error-recovery.md`. Preserve unchanged historical bugs.
@@ -41,8 +41,6 @@ Default paths:
41
41
 
42
42
  Accept a user-specified bug-list path when provided. Read the plan directly to summarize IDs, severity, dependencies, and current statuses. If the plan is missing or malformed, report that a valid bug plan is required and stop without constructing a start command.
43
43
 
44
- Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite or runtime option fragments.
45
-
46
44
  ## Intent Routing
47
45
 
48
46
  | Intent | Output |
@@ -51,7 +49,7 @@ Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite
51
49
  | Check status | Daemon status and item-level status commands |
52
50
  | Show logs | Recent or follow-log command |
53
51
  | Stop | Daemon stop command plus optional status command |
54
- | Retry failed bug work | Preserve-runtime, standard, or clean reset plus a separate run command with safety disclosure |
52
+ | Retry failed bug work | State-only, preserve-runtime, fresh-checkout, or clean reset plus a separate run command with safety disclosure |
55
53
 
56
54
  Only the start intent uses the execution-mode and configuration rounds.
57
55
 
@@ -84,12 +82,12 @@ If Advanced config is Yes, load the advanced question set from `${SKILL_DIR}/ref
84
82
 
85
83
  ### Step 4: Build command fragments
86
84
 
87
- Map confirmed choices to environment variables using `${SKILL_DIR}/references/configuration.md`.
85
+ Read `${SKILL_DIR}/references/configuration.md` if not already loaded during Advanced config, and map confirmed choices to environment variables.
88
86
 
89
87
  Return this prerequisite-check command separately from the pipeline command:
90
88
 
91
89
  ```bash
92
- command -v python3 >/dev/null && command -v git >/dev/null && test -f .prizmkit/dev-pipeline/cli.py && python3 -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)'
90
+ python3 ./.prizmkit/dev-pipeline/cli.py diagnostics version && git --version
93
91
  ```
94
92
 
95
93
  Also include the configured AI CLI check fragment from the reference. These are returned commands, not checks performed by this skill.
@@ -153,7 +151,7 @@ Optionally include the daemon status command for the user to run afterward. Do n
153
151
 
154
152
  Reset never starts execution and rejects `--run`. Every reset command must select exactly one mode: `--state-only`, `--fresh-checkout`, `--clean`, or `--preserve-runtime`. Always return reset and run as separate commands.
155
153
 
156
- State-only recovery resets selected failed/skipped/needs-info roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped bug includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout performs the former standard reset, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
154
+ State-only recovery resets selected failed/skipped/needs-info roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped bug includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout resets task state, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
157
155
 
158
156
  Use `AskUserQuestion` before constructing retry commands:
159
157
 
@@ -4,39 +4,15 @@ Use this reference only to translate confirmed user choices into command fragmen
4
4
 
5
5
  ## Configured AI CLI Prerequisite Command
6
6
 
7
- Runtime AI CLI selection is config-driven. Resolve the executable in this order:
7
+ Runtime AI CLI selection is resolved by the canonical runtime across `AI_CLI`, `.prizmkit/config.json` (`ai_cli`), and installed host configuration in the exact order used by `cli.py run`.
8
8
 
9
- 1. `AI_CLI` environment variable.
10
- 2. `.prizmkit/config.json` `ai_cli`.
11
- 3. `claude` only when neither is configured.
12
-
13
- Return this check command as part of start-command preparation:
9
+ Return this cross-platform check command as part of start-command preparation:
14
10
 
15
11
  ```bash
16
- AI_CLI="$(
17
- python3 - <<'PY'
18
- import json, os, shlex
19
- from pathlib import Path
20
- cli = os.environ.get("AI_CLI", "").strip()
21
- if not cli:
22
- path = Path(".prizmkit/config.json")
23
- if path.is_file():
24
- try:
25
- cli = str(json.loads(path.read_text(encoding="utf-8")).get("ai_cli") or "").strip()
26
- except (OSError, json.JSONDecodeError):
27
- cli = ""
28
- cli = cli or "claude"
29
- try:
30
- print(shlex.split(cli)[0])
31
- except ValueError:
32
- print(cli.split()[0] if cli.split() else "claude")
33
- PY
34
- )"
35
- printf 'Configured AI CLI: %s\n' "$AI_CLI"
36
- command -v "$AI_CLI" >/dev/null
12
+ python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
37
13
  ```
38
14
 
39
- Do not claim the configured executable exists until the user supplies successful command output.
15
+ `diagnostics ai-cli` reports the resolved CLI, source, and runtime mode, and exits non-zero if no configured AI CLI executable is available. Do not claim the configured executable exists until the user supplies successful command output.
40
16
 
41
17
  ## Base Configuration Mapping
42
18
 
@@ -42,8 +42,6 @@ Default paths:
42
42
 
43
43
  Accept a user-specified feature-list path when provided. Read the plan directly to summarize IDs, titles, dependencies, and current statuses. If the plan is missing or malformed, report that a valid feature plan is required and stop without constructing a start command.
44
44
 
45
- Read `${SKILL_DIR}/references/configuration.md` before constructing prerequisite or runtime option fragments.
46
-
47
45
  ## Intent Routing
48
46
 
49
47
  Classify the request before asking configuration questions:
@@ -54,7 +52,7 @@ Classify the request before asking configuration questions:
54
52
  | Check status | Daemon status and item-level status commands |
55
53
  | Show logs | Recent or follow-log command |
56
54
  | Stop | Daemon stop command plus optional status command |
57
- | Retry failed feature work | Preserve-runtime, standard, or clean reset plus a separate run command with safety disclosure |
55
+ | Retry failed feature work | State-only, preserve-runtime, fresh-checkout, or clean reset plus a separate run command with safety disclosure |
58
56
 
59
57
  Only the start intent uses the execution-mode and configuration rounds.
60
58
 
@@ -88,12 +86,12 @@ If Advanced config is Yes, load the advanced question set from `${SKILL_DIR}/ref
88
86
 
89
87
  ### Step 4: Build command fragments
90
88
 
91
- Map confirmed choices to environment variables using `${SKILL_DIR}/references/configuration.md`.
89
+ Read `${SKILL_DIR}/references/configuration.md` if not already loaded during Advanced config, and map confirmed choices to environment variables.
92
90
 
93
91
  Build the prerequisite-check command separately from the pipeline command so the user can inspect each action:
94
92
 
95
93
  ```bash
96
- command -v python3 >/dev/null && command -v git >/dev/null && test -f .prizmkit/dev-pipeline/cli.py && python3 -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)'
94
+ python3 ./.prizmkit/dev-pipeline/cli.py diagnostics version && git --version
97
95
  ```
98
96
 
99
97
  Also include the configured AI CLI check fragment from the reference. These are returned commands, not checks performed by this skill.
@@ -171,7 +169,7 @@ Optionally include the daemon status command for the user to run afterward. Do n
171
169
 
172
170
  Reset never starts execution and rejects `--run`. Every reset command must select exactly one mode: `--state-only`, `--fresh-checkout`, `--clean`, or `--preserve-runtime`. Always return reset and run as separate commands.
173
171
 
174
- State-only recovery resets selected failed/skipped roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped feature includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout performs the former standard reset, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
172
+ State-only recovery resets selected failed/skipped roots and only causal `auto_skipped` descendants whose complete blocker set is recovered. It resets retry/session/continuation state but never changes checkout identity, branches, worktrees, source changes, checkpoints, or artifact files. Selecting an auto-skipped feature includes all of its transitive blocking roots; `--all` recovers all eligible chains. Fresh-checkout resets task state, can discard uncommitted changes on the active task branch, and records a new checkout boundary. Clean additionally deletes the task branch and clears task history/artifacts. Preserve-runtime scans the whole list for failed roots, retains runtime history and valid checkout/WIP, and alone may replace a missing branch from the recorded base and rewind implementation-and-later checkpoints. Never hide these effects behind the word “retry.”
175
173
 
176
174
  Use `AskUserQuestion` before constructing retry commands:
177
175
 
@@ -4,39 +4,15 @@ Use this reference only to translate confirmed user choices into command fragmen
4
4
 
5
5
  ## Configured AI CLI Prerequisite Command
6
6
 
7
- Runtime AI CLI selection is config-driven. Resolve the executable in this order:
7
+ Runtime AI CLI selection is resolved by the canonical runtime across `AI_CLI`, `.prizmkit/config.json` (`ai_cli`), and installed host configuration in the exact order used by `cli.py run`.
8
8
 
9
- 1. `AI_CLI` environment variable.
10
- 2. `.prizmkit/config.json` `ai_cli`.
11
- 3. `claude` only when neither is configured.
12
-
13
- Return this check command as part of start-command preparation:
9
+ Return this cross-platform check command as part of start-command preparation:
14
10
 
15
11
  ```bash
16
- AI_CLI="$(
17
- python3 - <<'PY'
18
- import json, os, shlex
19
- from pathlib import Path
20
- cli = os.environ.get("AI_CLI", "").strip()
21
- if not cli:
22
- path = Path(".prizmkit/config.json")
23
- if path.is_file():
24
- try:
25
- cli = str(json.loads(path.read_text(encoding="utf-8")).get("ai_cli") or "").strip()
26
- except (OSError, json.JSONDecodeError):
27
- cli = ""
28
- cli = cli or "claude"
29
- try:
30
- print(shlex.split(cli)[0])
31
- except ValueError:
32
- print(cli.split()[0] if cli.split() else "claude")
33
- PY
34
- )"
35
- printf 'Configured AI CLI: %s\n' "$AI_CLI"
36
- command -v "$AI_CLI" >/dev/null
12
+ python3 ./.prizmkit/dev-pipeline/cli.py diagnostics ai-cli
37
13
  ```
38
14
 
39
- Do not claim the configured executable exists until the user supplies successful command output.
15
+ `diagnostics ai-cli` reports the resolved CLI, source, and runtime mode, and exits non-zero if no configured AI CLI executable is available. Do not claim the configured executable exists until the user supplies successful command output.
40
16
 
41
17
  ## Base Configuration Mapping
42
18