prizmkit 1.1.190 → 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 (189) hide show
  1. package/bin/create-prizmkit.js +4 -4
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/adapters/antigravity/assets/prizmkit-hook.cjs +150 -0
  4. package/bundled/adapters/antigravity/hooks-adapter.js +195 -0
  5. package/bundled/adapters/antigravity/paths.js +14 -0
  6. package/bundled/adapters/antigravity/rules-adapter.js +54 -0
  7. package/bundled/adapters/antigravity/skill-adapter.js +38 -0
  8. package/bundled/adapters/codex/skill-adapter.js +28 -8
  9. package/bundled/adapters/cursor/skill-adapter.js +13 -4
  10. package/bundled/adapters/pi/skill-adapter.js +28 -7
  11. package/bundled/dev-pipeline/.env.example +4 -12
  12. package/bundled/dev-pipeline/README.md +21 -15
  13. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +3 -6
  14. package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
  15. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
  16. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
  17. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
  18. package/bundled/dev-pipeline/prizmkit_runtime/config.py +29 -70
  19. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +125 -67
  20. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +89 -442
  21. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +93 -49
  22. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -3
  23. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
  24. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +49 -18
  25. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +206 -151
  26. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +2 -23
  27. package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +15 -134
  28. package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
  29. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +68 -83
  30. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
  31. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -29
  32. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
  33. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
  34. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +282 -217
  35. package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +124 -122
  36. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
  37. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +369 -154
  38. package/bundled/dev-pipeline/prizmkit_runtime/status.py +3 -3
  39. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2780 -0
  40. package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -101
  41. package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
  42. package/bundled/dev-pipeline/scripts/check-session-status.py +43 -19
  43. package/bundled/dev-pipeline/scripts/continuation.py +6 -4
  44. package/bundled/dev-pipeline/scripts/detect-stuck.py +28 -28
  45. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +7 -2
  46. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +7 -2
  47. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
  48. package/bundled/dev-pipeline/scripts/init-change-artifact.py +8 -2
  49. package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
  50. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2328
  51. package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
  52. package/bundled/dev-pipeline/scripts/prompt_framework.py +56 -9
  53. package/bundled/dev-pipeline/scripts/status_common.py +591 -0
  54. package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
  55. package/bundled/dev-pipeline/scripts/update-checkpoint.py +227 -65
  56. package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
  57. package/bundled/dev-pipeline/scripts/utils.py +10 -15
  58. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +4 -4
  59. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
  60. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +1 -1
  61. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
  62. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
  63. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  64. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
  65. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
  66. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
  67. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
  68. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
  69. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
  70. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
  71. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
  72. package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
  73. package/bundled/dev-pipeline/tests/_helpers.py +418 -0
  74. package/bundled/dev-pipeline/tests/conftest.py +45 -1
  75. package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +1 -0
  76. package/bundled/dev-pipeline/tests/test_auto_skip.py +4 -69
  77. package/bundled/dev-pipeline/tests/test_checkpoint_state.py +126 -1
  78. package/bundled/dev-pipeline/tests/test_daemon_and_scripts.py +257 -0
  79. package/bundled/dev-pipeline/tests/test_e2e_pipeline_run.py +500 -0
  80. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +59 -117
  81. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +12 -10
  82. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +561 -3094
  83. package/bundled/dev-pipeline/tests/test_recovery_workflow.py +7 -8
  84. package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -1
  85. package/bundled/dev-pipeline/tests/test_reset_modes.py +15 -27
  86. package/bundled/dev-pipeline/tests/test_reset_preserve.py +54 -139
  87. package/bundled/dev-pipeline/tests/test_runner_bookkeeping.py +766 -0
  88. package/bundled/dev-pipeline/tests/test_runner_lifecycle.py +1257 -0
  89. package/bundled/dev-pipeline/tests/test_runtime_helper.py +97 -20
  90. package/bundled/dev-pipeline/tests/test_session_launch.py +1101 -0
  91. package/bundled/dev-pipeline/tests/test_stream_progress.py +585 -0
  92. package/bundled/dev-pipeline/tests/test_unified_cli.py +490 -2006
  93. package/bundled/dev-pipeline/tests/test_utils.py +3 -3
  94. package/bundled/rules/USAGE.md +1 -0
  95. package/bundled/skills/_metadata.json +9 -63
  96. package/bundled/skills/app-planner/SKILL.md +32 -303
  97. package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
  98. package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
  99. package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
  100. package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
  101. package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
  102. package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
  103. package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
  104. package/bundled/skills/bug-planner/SKILL.md +54 -435
  105. package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
  106. package/bundled/skills/bug-planner/references/input-formats.md +32 -0
  107. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
  108. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
  109. package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
  110. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
  111. package/bundled/skills/feature-planner/SKILL.md +60 -439
  112. package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
  113. package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
  114. package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
  115. package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
  116. package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
  117. package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
  118. package/bundled/skills/feature-workflow/SKILL.md +1 -2
  119. package/bundled/skills/prizmkit/SKILL.md +7 -1
  120. package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
  121. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
  122. package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
  123. package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
  124. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  125. package/bundled/skills/prizmkit-init/SKILL.md +25 -128
  126. package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
  127. package/bundled/skills/prizmkit-init/references/config-schema.md +2 -2
  128. package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
  129. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
  130. package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
  131. package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
  132. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
  133. package/bundled/skills/prizmkit-prizm-docs/assets/prizm-docs-format.md +1 -1
  134. package/bundled/skills/prizmkit-prizm-docs/references/op-init.md +1 -1
  135. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
  136. package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
  137. package/bundled/skills/prizmkit-test/SKILL.md +25 -133
  138. package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
  139. package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
  140. package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
  141. package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
  142. package/bundled/skills/recovery-workflow/SKILL.md +7 -7
  143. package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
  144. package/bundled/skills/recovery-workflow/references/detection.md +1 -3
  145. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
  146. package/bundled/templates/project-memory-template.md +1 -2
  147. package/package.json +1 -1
  148. package/src/ai-cli-launch.js +1 -1
  149. package/src/clean.js +40 -4
  150. package/src/config.js +64 -4
  151. package/src/detect-platform.js +10 -6
  152. package/src/external-skills.js +2 -2
  153. package/src/index.js +1 -0
  154. package/src/manifest.js +1 -1
  155. package/src/platforms.js +6 -2
  156. package/src/prompts.js +11 -3
  157. package/src/scaffold.js +87 -11
  158. package/src/upgrade.js +9 -3
  159. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
  160. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
  161. package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
  162. package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
  163. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
  164. package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
  165. package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
  166. package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
  167. package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
  168. package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
  169. package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
  170. package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
  171. package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
  172. package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
  173. package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
  174. package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
  175. package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
  176. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
  177. package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
  178. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
  179. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
  180. package/bundled/skills/refactor-planner/SKILL.md +0 -467
  181. package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
  182. package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
  183. package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
  184. package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
  185. package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
  186. package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
  187. package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
  188. package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
  189. package/bundled/skills/refactor-workflow/SKILL.md +0 -205
@@ -1,649 +0,0 @@
1
- #!/usr/bin/env python3
2
- """Generate a session-specific refactor bootstrap prompt from refactor-list.json.
3
-
4
- The default path uses modular prompt sections and orchestrator-direct execution.
5
- The legacy monolithic template is kept only for explicit --template compatibility.
6
- """
7
-
8
- import argparse
9
- import json
10
- import os
11
- import re
12
- import sys
13
-
14
- from continuation import add_continuation_args, append_continuation_handoff, is_continuation
15
- from prompt_framework import (
16
- browser_enabled_from_item,
17
- checkpoint_group,
18
- checkpoint_step,
19
- detect_dev_server_port,
20
- generate_checkpoint_from_sections,
21
- load_section,
22
- merge_checkpoint_state,
23
- pipeline_checkpoint_metadata,
24
- read_text_file,
25
- render_from_sections,
26
- replace_placeholders,
27
- route_pipeline_repair,
28
- validate_rendered,
29
- write_output,
30
- )
31
- from utils import enrich_global_context, helper_replacements, load_json_file, read_checkpoint_system_section, resolve_prompt_platform, setup_logging
32
-
33
-
34
- LOGGER = setup_logging("generate-refactor-prompt")
35
-
36
-
37
- def route_refactor_repair(stage_result, repair_scope=None, repair_round=0):
38
- """Map Refactor review/test outcomes to the shared safe route contract."""
39
- return route_pipeline_repair(stage_result, repair_scope, repair_round)
40
-
41
-
42
- def refactor_checkpoint_metadata(artifact_dir, stage="plan",
43
- status="pending", stage_result=None,
44
- repair_scope=None, repair_round=0,
45
- next_stage="prizmkit-implement",
46
- resume_from="prizmkit-implement"):
47
- """Build Refactor pipeline handoff metadata while preserving skill state."""
48
- return pipeline_checkpoint_metadata(
49
- artifact_dir,
50
- stage=stage,
51
- status=status,
52
- stage_result=stage_result,
53
- repair_scope=repair_scope,
54
- repair_round=repair_round,
55
- next_stage=next_stage,
56
- resume_from=resume_from,
57
- )
58
-
59
-
60
- REFACTOR_SECTION_TO_SKILL = {
61
- "refactor-phase-init": checkpoint_step("prizmkit-init", "Initialize", [".prizmkit/refactor/{slug}"]),
62
- "refactor-phase-plan": checkpoint_step(
63
- "prizmkit-plan", "Plan — Specification & Plan Generation",
64
- [".prizmkit/refactor/{slug}/spec.md", ".prizmkit/refactor/{slug}/plan.md"],
65
- ),
66
- "refactor-phase-implement": checkpoint_step(
67
- "prizmkit-implement", "Implement — Behavior-Preserving Refactoring",
68
- [".prizmkit/refactor/{slug}/plan.md"],
69
- ),
70
- "refactor-phase-review": checkpoint_step(
71
- "prizmkit-code-review", "Review — Code Review & Behavior Verification",
72
- [".prizmkit/refactor/{slug}/review-report.md"],
73
- ),
74
- "refactor-phase-test": checkpoint_step(
75
- "prizmkit-test", "Post-Review Test Gate",
76
- [
77
- ".prizmkit/refactor/{slug}/test-report.md",
78
- ".prizmkit/refactor/{slug}/test-result.json",
79
- ],
80
- ),
81
- "phase-browser": checkpoint_step("browser-verification", "Browser Verification", []),
82
- "refactor-phase-commit-report": checkpoint_group([
83
- ("refactor-report", "Generate Refactor Report", [".prizmkit/refactor/{slug}/refactor-report.md"]),
84
- ("completion-summary", "Completion Summary", [".prizmkit/refactor/{slug}/completion-summary.json"]),
85
- ]),
86
- "retrospective": checkpoint_step(
87
- "prizmkit-retrospective", "Retrospective",
88
- [".prizmkit/refactor/{slug}/retrospective-result.json"],
89
- ),
90
- "runtime-commit-handoff": checkpoint_step(
91
- "prizmkit-committer", "Runtime Commit Handoff",
92
- [".prizmkit/refactor/{slug}/runtime-commit-request.json"],
93
- ),
94
- }
95
-
96
- REFACTOR_SPLIT_STEPS = {}
97
-
98
-
99
- def parse_args():
100
- parser = argparse.ArgumentParser(
101
- description=(
102
- "Generate a session-specific refactor bootstrap prompt from "
103
- ".prizmkit/plans/refactor-list.json."
104
- )
105
- )
106
- parser.add_argument("--refactor-list", required=True, help="Path to .prizmkit/plans/refactor-list.json")
107
- parser.add_argument("--refactor-id", required=True, help="Refactor ID to generate prompt for (e.g. R-001)")
108
- parser.add_argument("--session-id", required=True, help="Session ID for this pipeline session")
109
- parser.add_argument("--run-id", required=True, help="Pipeline run ID")
110
- parser.add_argument("--retry-count", required=True, help="Current retry count")
111
- parser.add_argument("--resume-phase", required=True, help='Phase to resume from, or "null" for fresh start')
112
- parser.add_argument("--state-dir", default=None, help="State directory (default: .prizmkit/state/refactor)")
113
- parser.add_argument("--output", required=True, help="Output path for the rendered prompt")
114
- parser.add_argument("--project-root", default=None, help="AI-visible project root used for rendered prompt paths")
115
- parser.add_argument(
116
- "--no-checkpoint-write",
117
- action="store_true",
118
- help="Render and validate a preview without creating or updating checkpoint state",
119
- )
120
- parser.add_argument("--template", default=None, help="Custom legacy template path. Defaults to section assembly.")
121
- add_continuation_args(parser, "refactor")
122
- return parser.parse_args()
123
-
124
-
125
- def _parse_positive_int_env(name, default):
126
- """Parse a positive integer environment variable."""
127
- value = os.environ.get(name, str(default))
128
- try:
129
- parsed = int(value)
130
- except ValueError:
131
- raise ValueError("{} must be a positive integer".format(name))
132
- if parsed <= 0:
133
- raise ValueError("{} must be a positive integer".format(name))
134
- return parsed
135
-
136
-
137
- def find_refactor(refactors, refactor_id):
138
- """Find and return the refactor dict matching the given ID."""
139
- for refactor in refactors:
140
- if isinstance(refactor, dict) and refactor.get("id") == refactor_id:
141
- return refactor
142
- return None
143
-
144
-
145
- def format_acceptance_criteria(criteria):
146
- if not criteria:
147
- return "- (none specified)"
148
- return "\n".join("- {}".format(item) for item in criteria)
149
-
150
-
151
- def format_ac_checklist(criteria):
152
- if not criteria:
153
- return "- [ ] (no acceptance criteria specified)"
154
- return "\n".join("- [ ] {}".format(item) for item in criteria)
155
-
156
-
157
- def format_global_context(global_context, project_root=None):
158
- if project_root:
159
- enrich_global_context(global_context, project_root)
160
- if not global_context:
161
- return "- (none specified)"
162
- return "\n".join(
163
- "- **{}**: {}".format(key, value)
164
- for key, value in sorted(global_context.items())
165
- )
166
-
167
-
168
- def format_user_context(user_context):
169
- if not user_context or not isinstance(user_context, list):
170
- return ""
171
- items = [item for item in user_context if isinstance(item, str) and item.strip()]
172
- if not items:
173
- return ""
174
- lines = [
175
- "### User-Provided Context (HIGHEST PRIORITY)",
176
- "",
177
- "> The following materials were provided by the user. They take precedence over AI inference.",
178
- "",
179
- ]
180
- lines.extend("- {}".format(item) for item in items)
181
- return "\n".join(lines)
182
-
183
-
184
- def _format_scope_list(scope, key):
185
- if not scope or not isinstance(scope, dict):
186
- return "- (none specified)"
187
- items = scope.get(key, [])
188
- if not items:
189
- return "- (none specified)"
190
- return "\n".join("- `{}`".format(item) for item in items)
191
-
192
-
193
- def format_scope_files(scope):
194
- return _format_scope_list(scope, "files")
195
-
196
-
197
- def format_scope_modules(scope):
198
- return _format_scope_list(scope, "modules")
199
-
200
-
201
- def _test_path_list(value):
202
- if not isinstance(value, list):
203
- return []
204
- return [str(item) for item in value if str(item).strip()]
205
-
206
-
207
- def format_existing_tests(value):
208
- if isinstance(value, bool):
209
- coverage = "yes" if value else "no"
210
- return "- Coverage declared: {} (specific test paths not supplied)".format(coverage)
211
- tests = _test_path_list(value)
212
- if tests:
213
- return "\n".join("- `{}`".format(test) for test in tests)
214
- return "- (none specified)"
215
-
216
-
217
- def format_behavior_preservation(bp):
218
- if not bp or not isinstance(bp, dict):
219
- return "- (no behavior preservation details)"
220
- lines = ["- **Strategy**: {}".format(bp.get("strategy", "unknown"))]
221
- existing_tests = bp.get("existing_tests")
222
- if isinstance(existing_tests, bool):
223
- lines.append(
224
- "- **Existing Tests Cover Scope**: {}".format(
225
- "yes" if existing_tests else "no"
226
- )
227
- )
228
- else:
229
- tests = _test_path_list(existing_tests)
230
- if tests:
231
- lines.append("- **Existing Tests**:")
232
- lines.extend(" - `{}`".format(test) for test in tests)
233
- new_tests_needed = _test_path_list(bp.get("new_tests_needed"))
234
- if new_tests_needed:
235
- lines.append("- **New Tests Needed**:")
236
- lines.extend(" - {}".format(test) for test in new_tests_needed)
237
- if len(lines) == 1:
238
- lines.append("- (no additional details)")
239
- return "\n".join(lines)
240
-
241
-
242
- def format_dependencies(dependencies, refactors=None):
243
- if not dependencies or not isinstance(dependencies, list):
244
- return "- (none)"
245
- refactor_map = {}
246
- if refactors:
247
- for item in refactors:
248
- if isinstance(item, dict) and "id" in item:
249
- refactor_map[item["id"]] = item
250
- lines = []
251
- for dep in dependencies:
252
- dep_info = refactor_map.get(dep)
253
- if dep_info and dep_info.get("status") == "completed":
254
- header = "- **{}** — {} (completed)".format(dep, dep_info.get("title", "Untitled"))
255
- notes = dep_info.get("completion_notes", [])
256
- note_lines = [" - {}".format(n) for n in notes if isinstance(n, str) and n.strip()]
257
- if note_lines:
258
- header += "\n" + "\n".join(note_lines)
259
- lines.append(header)
260
- else:
261
- lines.append("- `{}`".format(dep))
262
- return "\n".join(lines)
263
-
264
-
265
- def get_prev_session_status(state_dir, refactor_id):
266
- if not state_dir:
267
- return "N/A (first run)"
268
- refactor_status_path = os.path.join(state_dir, refactor_id, "status.json")
269
- try:
270
- with open(refactor_status_path, "r", encoding="utf-8") as f:
271
- refactor_status = json.load(f)
272
- except (json.JSONDecodeError, IOError, OSError):
273
- return "N/A (first run)"
274
- last_session_id = refactor_status.get("last_session_id")
275
- if not last_session_id:
276
- return "N/A (first run)"
277
- session_status_path = os.path.join(state_dir, refactor_id, "sessions", last_session_id, "session-status.json")
278
- try:
279
- with open(session_status_path, "r", encoding="utf-8") as f:
280
- session_data = json.load(f)
281
- except (json.JSONDecodeError, IOError, OSError):
282
- return "N/A (previous session status file not found)"
283
- result = "{} (checkpoint: {}, last phase: {})".format(
284
- session_data.get("status", "unknown"),
285
- session_data.get("checkpoint_reached", "none"),
286
- session_data.get("current_phase", "unknown"),
287
- )
288
- errors = session_data.get("errors", [])
289
- if errors:
290
- result += " — errors: {}".format("; ".join(str(e) for e in errors))
291
- return result
292
-
293
-
294
- def resolve_project_root(script_dir):
295
- pipeline_dir = os.path.dirname(script_dir)
296
- pipeline_parent = os.path.dirname(pipeline_dir)
297
- if os.path.basename(pipeline_parent) == ".prizmkit":
298
- return os.path.abspath(os.path.dirname(pipeline_parent))
299
- return os.path.abspath(pipeline_parent)
300
-
301
-
302
- def _project_root_from_prizmkit_path(path):
303
- if not path:
304
- return ""
305
- current = os.path.abspath(path)
306
- if not os.path.isdir(current):
307
- current = os.path.dirname(current)
308
- while current and current != os.path.dirname(current):
309
- if os.path.basename(current) == ".prizmkit":
310
- return os.path.abspath(os.path.dirname(current))
311
- current = os.path.dirname(current)
312
- return ""
313
-
314
-
315
- def _args_project_root(args, script_dir):
316
- explicit = getattr(args, "project_root", None)
317
- if explicit:
318
- return os.path.abspath(explicit)
319
- plan_root = _project_root_from_prizmkit_path(getattr(args, "refactor_list", ""))
320
- if plan_root:
321
- return plan_root
322
- return resolve_project_root(script_dir)
323
-
324
-
325
- def build_replacements(args, refactor, refactors, global_context, script_dir):
326
- project_root = _args_project_root(args, script_dir)
327
- resolve_prompt_platform(project_root)
328
-
329
- scope = refactor.get("scope", {})
330
- bp = refactor.get("behavior_preservation", {})
331
- behavior_strategy = bp.get("strategy", "test-gate") if isinstance(bp, dict) else "test-gate"
332
- existing_tests = bp.get("existing_tests") if isinstance(bp, dict) else None
333
- new_tests_needed = _test_path_list(
334
- bp.get("new_tests_needed") if isinstance(bp, dict) else None
335
- )
336
- existing_tests_str = format_existing_tests(existing_tests)
337
- new_tests_str = "\n".join("- {}".format(test) for test in new_tests_needed) if new_tests_needed else "- (none specified)"
338
-
339
- browser_enabled, browser_tool, browser_verify_steps, browser_blocking = browser_enabled_from_item(refactor)
340
- dev_port = detect_dev_server_port(project_root)
341
- dev_url = "http://localhost:{}".format(dev_port) if dev_port.isdigit() else "<UNKNOWN_DETECT_FROM_PROJECT_CONFIG>"
342
-
343
- replacements = {
344
- "{{SESSION_LOG_PATH}}": os.path.join(".prizmkit", "state", "refactor", args.refactor_id, "sessions", args.session_id, "logs", "session.log"),
345
- "{{RUN_ID}}": args.run_id,
346
- "{{SESSION_ID}}": args.session_id,
347
- "{{REFACTOR_ID}}": args.refactor_id,
348
- "{{TASK_ID}}": args.refactor_id,
349
- "{{TASK_TITLE}}": refactor.get("title", ""),
350
- "{{REFACTOR_TITLE}}": refactor.get("title", ""),
351
- "{{REFACTOR_TYPE}}": refactor.get("type", "restructure"),
352
- "{{SCOPE_FILES}}": format_scope_files(scope),
353
- "{{SCOPE_MODULES}}": format_scope_modules(scope),
354
- "{{BEHAVIOR_STRATEGY}}": behavior_strategy,
355
- "{{BEHAVIOR_PRESERVATION}}": format_behavior_preservation(bp),
356
- "{{EXISTING_TESTS}}": existing_tests_str,
357
- "{{NEW_TESTS_NEEDED}}": new_tests_str,
358
- "{{PRIORITY}}": refactor.get("priority", "medium"),
359
- "{{COMPLEXITY}}": refactor.get("complexity", "medium"),
360
- "{{REFACTOR_DESCRIPTION}}": refactor.get("description", ""),
361
- "{{USER_CONTEXT}}": format_user_context(refactor.get("user_context", [])),
362
- "{{ACCEPTANCE_CRITERIA}}": format_acceptance_criteria(refactor.get("acceptance_criteria", [])),
363
- "{{AC_CHECKLIST}}": format_ac_checklist(refactor.get("acceptance_criteria", [])),
364
- "{{DEPENDENCIES}}": format_dependencies(refactor.get("dependencies", []), refactors),
365
- "{{GLOBAL_CONTEXT}}": format_global_context(global_context, project_root),
366
- "{{PROJECT_ROOT}}": project_root,
367
- "{{ARTIFACT_DIR}}": ".prizmkit/refactor/{}".format(args.refactor_id),
368
- "{{FAMILY_ARTIFACTS}}": "├── refactor-report.md\n├── completion-summary.json",
369
- "{{CHECKPOINT_PATH}}": os.path.join(".prizmkit", "refactor", args.refactor_id, "workflow-checkpoint.json"),
370
- "{{CHECKPOINT_SYSTEM}}": read_checkpoint_system_section(script_dir),
371
- "{{TIMESTAMP}}": "",
372
- "{{BROWSER_ENABLED}}": "true" if browser_enabled else "false",
373
- "{{BROWSER_TOOL}}": browser_tool,
374
- "{{BROWSER_VERIFY_STEPS}}": browser_verify_steps,
375
- "{{BROWSER_BLOCKING}}": "true" if browser_blocking else "false",
376
- "{{DEV_PORT}}": dev_port,
377
- "{{DEV_URL}}": dev_url,
378
- }
379
- replacements.update(helper_replacements(script_dir))
380
- return replacements
381
-
382
-
383
- def process_conditional_blocks(content, resume_phase, refactor):
384
- """Handle legacy conditional blocks based on resume_phase and browser_interaction."""
385
- is_resume = resume_phase != "null"
386
- if is_resume:
387
- content = re.sub(r"\{\{IF_FRESH_START\}\}.*?\{\{END_IF_FRESH_START\}\}\n?", "", content, flags=re.DOTALL)
388
- else:
389
- content = content.replace("{{IF_FRESH_START}}\n", "").replace("{{IF_FRESH_START}}", "")
390
- content = content.replace("{{END_IF_FRESH_START}}\n", "").replace("{{END_IF_FRESH_START}}", "")
391
-
392
- browser_enabled, browser_tool, _steps, _blocking = browser_enabled_from_item(refactor)
393
- browser_open = "{{IF_BROWSER_INTERACTION}}"
394
- browser_close = "{{END_IF_BROWSER_INTERACTION}}"
395
- if browser_enabled:
396
- content = content.replace(browser_open + "\n", "").replace(browser_open, "")
397
- content = content.replace(browser_close + "\n", "").replace(browser_close, "")
398
- else:
399
- content = re.sub(re.escape(browser_open) + r".*?" + re.escape(browser_close) + r"\n?", "", content, flags=re.DOTALL)
400
-
401
- active_variant = {"playwright-cli": "PLAYWRIGHT", "opencli": "OPENCLI", "auto": "AUTO"}.get(browser_tool, "AUTO")
402
- for variant in ("PLAYWRIGHT", "OPENCLI", "AUTO"):
403
- tool_open = "{{{{IF_BROWSER_TOOL_{}}}}}".format(variant)
404
- tool_close = "{{{{END_IF_BROWSER_TOOL_{}}}}}".format(variant)
405
- if variant == active_variant and browser_enabled:
406
- content = content.replace(tool_open + "\n", "").replace(tool_open, "")
407
- content = content.replace(tool_close + "\n", "").replace(tool_close, "")
408
- else:
409
- content = re.sub(re.escape(tool_open) + r".*?" + re.escape(tool_close) + r"\n?", "", content, flags=re.DOTALL)
410
- return content
411
-
412
-
413
- def render_template(template_content, replacements, resume_phase, refactor):
414
- return replace_placeholders(process_conditional_blocks(template_content, resume_phase, refactor), replacements)
415
-
416
-
417
- def _refactor_header():
418
- return (
419
- "# Dev-Pipeline Refactor Session Bootstrap — Canonical Guidance\n\n"
420
- "Use the active skills and runtime contracts for planning, implementation, "
421
- "review, behavior verification, retrospective, and runtime-owned commit execution.\n"
422
- )
423
-
424
-
425
- def assemble_refactor_sections(sections_dir, browser_enabled, browser_tool="auto"):
426
- sections = [
427
- ("header", _refactor_header()),
428
- ("refactor-session-context", load_section(sections_dir, "refactor-session-context.md")),
429
- ("mission", load_section(sections_dir, "refactor-mission.md")),
430
- ("refactor-task-contract", load_section(sections_dir, "refactor-task-contract.md")),
431
- ("context-budget-rules", load_section(sections_dir, "context-budget-rules.md")),
432
- ("artifact-manifest", load_section(sections_dir, "artifact-manifest.md")),
433
- ("checkpoint-system", load_section(sections_dir, "checkpoint-system.md")),
434
- ("execution-header", "---\n\n## Execution\n"),
435
- ("refactor-phase-init", load_section(sections_dir, "refactor-phase-init.md")),
436
- ("refactor-phase-plan", load_section(sections_dir, "refactor-phase-plan.md")),
437
- ]
438
- sections.extend([
439
- ("refactor-phase-implement", load_section(sections_dir, "refactor-phase-implement.md")),
440
- ("refactor-phase-review", load_section(sections_dir, "refactor-phase-review.md")),
441
- ])
442
- if browser_enabled:
443
- browser_section_file = {
444
- "playwright-cli": "phase-browser-verification.md",
445
- "opencli": "phase-browser-verification-opencli.md",
446
- }.get(browser_tool, "phase-browser-verification-auto.md")
447
- sections.append(("phase-browser", load_section(sections_dir, browser_section_file)))
448
- sections.extend([
449
- ("refactor-phase-test", load_section(sections_dir, "refactor-phase-test.md")),
450
- ("refactor-phase-commit-report", load_section(sections_dir, "refactor-phase-commit-report.md")),
451
- ("retrospective", load_section(sections_dir, "retrospective.md")),
452
- ("runtime-commit-handoff", load_section(sections_dir, "runtime-commit-handoff.md")),
453
- ("refactor-critical-paths", load_section(sections_dir, "refactor-critical-paths.md")),
454
- ("failure-capture", load_section(sections_dir, "failure-capture.md")),
455
- ("refactor-reminders", load_section(sections_dir, "refactor-reminders.md")),
456
- ])
457
- return sections
458
-
459
-
460
- def generate_refactor_checkpoint(
461
- refactor_id, session_id, sections=None, *, browser_enabled=False,
462
- ):
463
- if sections is None:
464
- sections = [
465
- ("refactor-phase-init", ""),
466
- ("refactor-phase-plan", ""),
467
- ("refactor-phase-implement", ""),
468
- ("refactor-phase-review", ""),
469
- ]
470
- if browser_enabled:
471
- sections.append(("phase-browser", ""))
472
- sections.extend([
473
- ("refactor-phase-test", ""),
474
- ("refactor-phase-commit-report", ""),
475
- ("retrospective", ""),
476
- ("runtime-commit-handoff", ""),
477
- ])
478
- return generate_checkpoint_from_sections(
479
- sections,
480
- REFACTOR_SECTION_TO_SKILL,
481
- "refactor-pipeline",
482
- refactor_id,
483
- refactor_id,
484
- session_id,
485
- split_steps=REFACTOR_SPLIT_STEPS,
486
- )
487
-
488
-
489
- def merge_refactor_checkpoint_state(existing, fresh, project_root):
490
- merged = merge_checkpoint_state(existing, fresh, project_root, logger=LOGGER)
491
- existing_state = existing.get("refactor_state")
492
- if isinstance(existing_state, dict):
493
- merged["refactor_state"] = existing_state
494
- return merged
495
-
496
-
497
- def emit_failure(message):
498
- print(json.dumps({"success": False, "error": message}, indent=2, ensure_ascii=False))
499
- sys.exit(1)
500
-
501
-
502
- def main():
503
- args = parse_args()
504
- script_dir = os.path.dirname(os.path.abspath(__file__))
505
- templates_dir = os.path.join(script_dir, "..", "templates")
506
- sections_dir = os.path.join(templates_dir, "sections")
507
-
508
- refactor_list_data, err = load_json_file(args.refactor_list)
509
- if err:
510
- emit_failure("Refactor list error: {}".format(err))
511
- refactors = refactor_list_data.get("refactors")
512
- if not isinstance(refactors, list):
513
- emit_failure("Refactor list does not contain a 'refactors' array")
514
- refactor = find_refactor(refactors, args.refactor_id)
515
- if refactor is None:
516
- emit_failure("Refactor '{}' not found in refactor list".format(args.refactor_id))
517
- global_context = refactor_list_data.get("global_context", {})
518
- if not isinstance(global_context, dict):
519
- global_context = {}
520
-
521
- replacements = build_replacements(args, refactor, refactors, global_context, script_dir)
522
- browser_enabled = replacements["{{BROWSER_ENABLED}}"] == "true"
523
-
524
- use_sections = os.path.isdir(sections_dir) and not args.template
525
- sections = []
526
- if use_sections:
527
- try:
528
- sections = assemble_refactor_sections(
529
- sections_dir, browser_enabled,
530
- browser_tool=replacements["{{BROWSER_TOOL}}"],
531
- )
532
- rendered = render_from_sections(sections, replacements)
533
- except FileNotFoundError as exc:
534
- emit_failure("Refactor section assembly failed: {}".format(exc))
535
-
536
- if not use_sections:
537
- if not args.template:
538
- emit_failure("Canonical Refactor prompt sections are unavailable")
539
- template_path = args.template
540
- template_content, err = read_text_file(template_path)
541
- if err:
542
- emit_failure("Template error: {}".format(err))
543
- rendered = render_template(template_content, replacements, args.resume_phase, refactor)
544
-
545
- is_valid, warnings, errors = validate_rendered(
546
- rendered,
547
- required_markers=[
548
- ("## Your Mission", "Mission section"),
549
- ("## Execution", "Execution section"),
550
- ("## Failure Capture", "Failure Capture Protocol"),
551
- ],
552
- logger=LOGGER,
553
- )
554
- if not is_valid:
555
- emit_failure("Rendered refactor prompt failed validation: {}".format("; ".join(errors)))
556
-
557
- err = write_output(args.output, rendered)
558
- if err:
559
- emit_failure(err)
560
-
561
- project_root = _args_project_root(args, script_dir)
562
- checkpoint_path = os.path.join(project_root, replacements["{{CHECKPOINT_PATH}}"])
563
- if not args.no_checkpoint_write:
564
- os.makedirs(os.path.dirname(checkpoint_path), exist_ok=True)
565
- checkpoint = generate_refactor_checkpoint(
566
- args.refactor_id,
567
- args.session_id,
568
- sections if use_sections else None,
569
- browser_enabled=browser_enabled,
570
- )
571
- if not any(step.get("skill") == "prizmkit-test" for step in checkpoint["steps"]):
572
- emit_failure("Refactor checkpoint is missing the mandatory prizmkit-test stage")
573
- checkpoint["refactor_state"] = refactor_checkpoint_metadata(
574
- replacements["{{ARTIFACT_DIR}}"],
575
- stage="plan",
576
- status="pending",
577
- stage_result=None,
578
- repair_scope=None,
579
- repair_round=0,
580
- next_stage="prizmkit-implement",
581
- resume_from="prizmkit-implement",
582
- )
583
-
584
- if not args.no_checkpoint_write and (args.resume_phase != "null" or is_continuation(args)) and os.path.exists(checkpoint_path):
585
- try:
586
- with open(checkpoint_path, "r", encoding="utf-8") as f:
587
- existing = json.load(f)
588
- checkpoint = merge_refactor_checkpoint_state(existing, checkpoint, project_root)
589
- LOGGER.info("Merged existing refactor checkpoint from %s", checkpoint_path)
590
- except (json.JSONDecodeError, KeyError) as exc:
591
- LOGGER.warning("Existing refactor checkpoint corrupted (%s) — generating fresh", exc)
592
-
593
- if not args.no_checkpoint_write:
594
- with open(checkpoint_path, "w", encoding="utf-8") as f:
595
- json.dump(checkpoint, f, indent=2, ensure_ascii=False)
596
- LOGGER.info("Wrote refactor checkpoint to %s", checkpoint_path)
597
-
598
- if is_continuation(args):
599
- rendered = append_continuation_handoff(
600
- rendered, args, project_root, args.task_type, args.refactor_id, args.refactor_id, checkpoint,
601
- )
602
- final_valid, final_warnings, final_errors = validate_rendered(
603
- rendered,
604
- required_markers=[
605
- ("## Your Mission", "Mission section"),
606
- ("## Execution", "Execution section"),
607
- ("## Failure Capture", "Failure Capture Protocol"),
608
- ],
609
- logger=LOGGER,
610
- )
611
- if not final_valid:
612
- emit_failure(
613
- "Rendered refactor continuation prompt failed validation: {}".format(
614
- "; ".join(final_errors)
615
- )
616
- )
617
- warnings.extend(final_warnings)
618
- errors.extend(final_errors)
619
- err = write_output(args.output, rendered)
620
- if err:
621
- emit_failure(err)
622
-
623
- output = {
624
- "success": True,
625
- "output_path": os.path.abspath(args.output),
626
- "checkpoint_path": "" if args.no_checkpoint_write else checkpoint_path,
627
- "model": refactor.get("model", ""),
628
- "render_mode": "sections" if use_sections else "legacy",
629
- "validation_warnings": len(warnings),
630
- "validation_errors": len(errors),
631
- "browser_enabled": replacements["{{BROWSER_ENABLED}}"] == "true",
632
- "browser_tool": replacements["{{BROWSER_TOOL}}"],
633
- }
634
- print(json.dumps(output, indent=2, ensure_ascii=False))
635
- sys.exit(0)
636
-
637
-
638
- if __name__ == "__main__":
639
- try:
640
- main()
641
- except KeyboardInterrupt:
642
- emit_failure("generate-refactor-prompt interrupted")
643
- except ValueError as exc:
644
- emit_failure(str(exc))
645
- except SystemExit:
646
- raise
647
- except Exception as exc:
648
- LOGGER.exception("Unhandled exception in generate-refactor-prompt")
649
- emit_failure("Unexpected error: {}".format(str(exc)))