prizmkit 1.1.191 → 1.1.193

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 (165) 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 +28 -44
  8. package/bundled/dev-pipeline/assets/feature-list-example.json +0 -1
  9. package/bundled/dev-pipeline/assets/skill-subagent-integration.md +6 -6
  10. package/bundled/dev-pipeline/prizmkit_runtime/atomic_io.py +48 -0
  11. package/bundled/dev-pipeline/prizmkit_runtime/checkpoint_state.py +66 -23
  12. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +10 -7
  13. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +2 -21
  14. package/bundled/dev-pipeline/prizmkit_runtime/config.py +48 -78
  15. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +127 -67
  16. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +158 -462
  17. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +102 -50
  18. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +1 -25
  19. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +0 -6
  20. package/bundled/dev-pipeline/prizmkit_runtime/platform_detection.py +47 -21
  21. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +217 -156
  22. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +39 -27
  23. package/bundled/dev-pipeline/prizmkit_runtime/reset_preserve.py +34 -174
  24. package/bundled/dev-pipeline/prizmkit_runtime/results.py +25 -0
  25. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +133 -110
  26. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +15 -5
  27. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +1 -95
  28. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +0 -2
  29. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +7 -2
  30. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +540 -262
  31. package/bundled/dev-pipeline/prizmkit_runtime/runtime_commit.py +175 -135
  32. package/bundled/dev-pipeline/prizmkit_runtime/runtime_helper.py +90 -9
  33. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +214 -133
  34. package/bundled/dev-pipeline/prizmkit_runtime/status.py +1 -3
  35. package/bundled/dev-pipeline/prizmkit_runtime/stream_progress.py +2783 -0
  36. package/bundled/dev-pipeline/prizmkit_runtime/task_checkout.py +27 -102
  37. package/bundled/dev-pipeline/prizmkit_runtime/test_result.py +58 -4
  38. package/bundled/dev-pipeline/scripts/check-session-status.py +56 -20
  39. package/bundled/dev-pipeline/scripts/continuation.py +8 -7
  40. package/bundled/dev-pipeline/scripts/detect-stuck.py +47 -33
  41. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +13 -16
  42. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +20 -10
  43. package/bundled/dev-pipeline/scripts/init-bugfix-pipeline.py +10 -7
  44. package/bundled/dev-pipeline/scripts/init-change-artifact.py +25 -4
  45. package/bundled/dev-pipeline/scripts/init-pipeline.py +14 -69
  46. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +31 -2616
  47. package/bundled/dev-pipeline/scripts/patch-completion-notes.py +4 -24
  48. package/bundled/dev-pipeline/scripts/prompt_framework.py +85 -20
  49. package/bundled/dev-pipeline/scripts/status_common.py +591 -0
  50. package/bundled/dev-pipeline/scripts/update-bug-status.py +85 -463
  51. package/bundled/dev-pipeline/scripts/update-checkpoint.py +254 -65
  52. package/bundled/dev-pipeline/scripts/update-feature-status.py +76 -509
  53. package/bundled/dev-pipeline/scripts/utils.py +5 -12
  54. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +5 -5
  55. package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +7 -0
  56. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +7 -7
  57. package/bundled/dev-pipeline/templates/sections/artifact-manifest.md +1 -1
  58. package/bundled/dev-pipeline/templates/sections/bugfix-phase-manual-verification.md +1 -1
  59. package/bundled/dev-pipeline/templates/sections/bugfix-phase-review.md +1 -1
  60. package/bundled/dev-pipeline/templates/sections/bugfix-phase-test.md +2 -1
  61. package/bundled/dev-pipeline/templates/sections/checkpoint-system.md +1 -1
  62. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-auto.md +1 -1
  63. package/bundled/dev-pipeline/templates/sections/phase-browser-verification-opencli.md +2 -2
  64. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +2 -2
  65. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -1
  66. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -1
  67. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +3 -6
  68. package/bundled/dev-pipeline/templates/session-status-schema.json +2 -5
  69. package/bundled/skills/_metadata.json +9 -63
  70. package/bundled/skills/app-planner/SKILL.md +32 -303
  71. package/bundled/skills/app-planner/references/app-design-guide.md +0 -4
  72. package/bundled/skills/app-planner/references/generated-plan-review.md +2 -1
  73. package/bundled/skills/app-planner/references/project-brief-guide.md +14 -0
  74. package/bundled/skills/app-planner/references/project-conventions-discovery.md +4 -6
  75. package/bundled/skills/app-planner/references/project-state-detection.md +2 -3
  76. package/bundled/skills/bug-fix-workflow/SKILL.md +1 -2
  77. package/bundled/skills/bug-fix-workflow/references/bug-diagnosis.md +4 -7
  78. package/bundled/skills/bug-planner/SKILL.md +54 -435
  79. package/bundled/skills/bug-planner/references/generated-plan-review.md +3 -2
  80. package/bundled/skills/bug-planner/references/input-formats.md +32 -0
  81. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +4 -6
  82. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +4 -28
  83. package/bundled/skills/feature-pipeline-launcher/SKILL.md +4 -6
  84. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +4 -28
  85. package/bundled/skills/feature-planner/SKILL.md +60 -439
  86. package/bundled/skills/feature-planner/assets/planning-guide.md +1 -1
  87. package/bundled/skills/feature-planner/references/completeness-review.md +34 -0
  88. package/bundled/skills/feature-planner/references/decomposition-patterns.md +2 -2
  89. package/bundled/skills/feature-planner/references/error-recovery.md +1 -1
  90. package/bundled/skills/feature-planner/references/generated-plan-review.md +3 -2
  91. package/bundled/skills/feature-planner/references/incremental-feature-planning.md +3 -1
  92. package/bundled/skills/feature-workflow/SKILL.md +1 -2
  93. package/bundled/skills/prizmkit/SKILL.md +7 -1
  94. package/bundled/skills/prizmkit-code-review/SKILL.md +14 -6
  95. package/bundled/skills/prizmkit-code-review/references/independent-code-review.md +7 -4
  96. package/bundled/skills/prizmkit-code-review/references/review-report-template.md +16 -0
  97. package/bundled/skills/prizmkit-code-review/scripts/render_review_report.py +58 -20
  98. package/bundled/skills/prizmkit-implement/SKILL.md +1 -1
  99. package/bundled/skills/prizmkit-init/SKILL.md +24 -127
  100. package/bundled/skills/prizmkit-init/assets/project-brief-template.md +3 -3
  101. package/bundled/skills/prizmkit-plan/SKILL.md +6 -8
  102. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +1 -1
  103. package/bundled/skills/prizmkit-plan/references/independent-plan-review.md +5 -2
  104. package/bundled/skills/prizmkit-plan/references/review-plan-spec-loop.md +6 -5
  105. package/bundled/skills/prizmkit-prizm-docs/SKILL.md +1 -13
  106. package/bundled/skills/prizmkit-prizm-docs/references/op-update.md +1 -1
  107. package/bundled/skills/prizmkit-retrospective/SKILL.md +6 -4
  108. package/bundled/skills/prizmkit-test/SKILL.md +25 -133
  109. package/bundled/skills/prizmkit-test/references/independent-test-review.md +5 -2
  110. package/bundled/skills/prizmkit-test/references/test-coverage-model.md +6 -0
  111. package/bundled/skills/prizmkit-workflow/SKILL.md +2 -3
  112. package/bundled/skills/prizmkit-workflow/references/workflow-state-protocol.md +4 -3
  113. package/bundled/skills/recovery-workflow/SKILL.md +7 -7
  114. package/bundled/skills/recovery-workflow/evals/evals.json +1 -1
  115. package/bundled/skills/recovery-workflow/references/detection.md +1 -3
  116. package/bundled/skills/recovery-workflow/scripts/detect-recovery-state.py +0 -6
  117. package/bundled/templates/project-memory-template.md +1 -2
  118. package/package.json +1 -1
  119. package/src/scaffold.js +28 -7
  120. package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +0 -53
  121. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +0 -649
  122. package/bundled/dev-pipeline/scripts/init-refactor-pipeline.py +0 -463
  123. package/bundled/dev-pipeline/scripts/update-refactor-status.py +0 -1512
  124. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +0 -240
  125. package/bundled/dev-pipeline/templates/refactor-list-schema.json +0 -266
  126. package/bundled/dev-pipeline/templates/sections/refactor-critical-paths.md +0 -15
  127. package/bundled/dev-pipeline/templates/sections/refactor-mission.md +0 -9
  128. package/bundled/dev-pipeline/templates/sections/refactor-phase-commit-report.md +0 -24
  129. package/bundled/dev-pipeline/templates/sections/refactor-phase-implement.md +0 -16
  130. package/bundled/dev-pipeline/templates/sections/refactor-phase-init.md +0 -9
  131. package/bundled/dev-pipeline/templates/sections/refactor-phase-plan.md +0 -22
  132. package/bundled/dev-pipeline/templates/sections/refactor-phase-review.md +0 -19
  133. package/bundled/dev-pipeline/templates/sections/refactor-phase-test.md +0 -24
  134. package/bundled/dev-pipeline/templates/sections/refactor-reminders.md +0 -12
  135. package/bundled/dev-pipeline/templates/sections/refactor-session-context.md +0 -6
  136. package/bundled/dev-pipeline/templates/sections/refactor-task-contract.md +0 -52
  137. package/bundled/dev-pipeline/tests/conftest.py +0 -29
  138. package/bundled/dev-pipeline/tests/live_ai_cli_log_smoke.py +0 -208
  139. package/bundled/dev-pipeline/tests/test_auto_skip.py +0 -1871
  140. package/bundled/dev-pipeline/tests/test_checkpoint_state.py +0 -1314
  141. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +0 -1712
  142. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +0 -627
  143. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +0 -478
  144. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +0 -5641
  145. package/bundled/dev-pipeline/tests/test_recovery_workflow.py +0 -322
  146. package/bundled/dev-pipeline/tests/test_repository_bootstrap.py +0 -252
  147. package/bundled/dev-pipeline/tests/test_reset_modes.py +0 -1208
  148. package/bundled/dev-pipeline/tests/test_reset_preserve.py +0 -957
  149. package/bundled/dev-pipeline/tests/test_runtime_commit.py +0 -1113
  150. package/bundled/dev-pipeline/tests/test_runtime_helper.py +0 -303
  151. package/bundled/dev-pipeline/tests/test_unified_cli.py +0 -5504
  152. package/bundled/dev-pipeline/tests/test_utils.py +0 -170
  153. package/bundled/skills/feature-planner/assets/evaluation-guide.md +0 -44
  154. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +0 -219
  155. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +0 -78
  156. package/bundled/skills/refactor-planner/SKILL.md +0 -467
  157. package/bundled/skills/refactor-planner/assets/planning-guide.md +0 -291
  158. package/bundled/skills/refactor-planner/references/behavior-preservation.md +0 -187
  159. package/bundled/skills/refactor-planner/references/error-recovery.md +0 -45
  160. package/bundled/skills/refactor-planner/references/fast-path.md +0 -59
  161. package/bundled/skills/refactor-planner/references/generated-plan-review.md +0 -107
  162. package/bundled/skills/refactor-planner/references/planning-phases.md +0 -172
  163. package/bundled/skills/refactor-planner/references/refactor-scoping-guide.md +0 -230
  164. package/bundled/skills/refactor-planner/scripts/validate-and-generate-refactor.py +0 -1120
  165. 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)))