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
@@ -1,463 +0,0 @@
1
- #!/usr/bin/env python3
2
- """Initialize the refactor pipeline state directory from a .prizmkit/plans/refactor-list.json file.
3
-
4
- Validates the refactor list schema, sorts by priority/complexity, checks for
5
- circular dependencies, and creates the state directory structure with pipeline
6
- and per-refactor status files.
7
-
8
- Usage:
9
- python3 init-refactor-pipeline.py --refactor-list <path> --state-dir <path>
10
- """
11
-
12
- import argparse
13
- import json
14
- import os
15
- import re
16
- import sys
17
- from datetime import datetime, timezone
18
-
19
- from utils import load_json_file, stable_topological_order
20
-
21
-
22
- EXPECTED_SCHEMA = "dev-pipeline-refactor-list-v1"
23
- REFACTOR_ID_PATTERN = re.compile(r"^R-\d{3}$")
24
- ALLOWED_LIST_FIELDS = {
25
- "$schema", "project_name", "project_description", "created_at",
26
- "created_by", "refactors", "global_context",
27
- }
28
- ALLOWED_GLOBAL_CONTEXT_FIELDS = {
29
- "tech_stack", "language", "runtime", "frontend_framework",
30
- "frontend_styling", "backend_framework", "database", "orm",
31
- "testing_strategy", "bundler", "project_type", "ci_pipeline",
32
- }
33
-
34
- REQUIRED_REFACTOR_FIELDS = [
35
- "id",
36
- "title",
37
- "description",
38
- "scope",
39
- "type",
40
- "priority",
41
- "complexity",
42
- "behavior_preservation",
43
- "acceptance_criteria",
44
- "dependencies",
45
- "status",
46
- ]
47
- ALLOWED_REFACTOR_FIELDS = set(REQUIRED_REFACTOR_FIELDS) | {
48
- "estimated_lines",
49
- "completion_notes",
50
- "user_context",
51
- "browser_interaction",
52
- "model",
53
- }
54
-
55
- VALID_TYPES = ["extract", "rename", "restructure", "simplify", "decouple", "migrate"]
56
- VALID_PRIORITIES = ["critical", "high", "medium", "low"]
57
- VALID_COMPLEXITIES = ["low", "medium", "high"]
58
- VALID_STATUSES = [
59
- "pending", "in_progress", "completed", "failed", "skipped", "auto_skipped",
60
- ]
61
- TERMINAL_STATUSES = {"completed", "failed", "skipped", "auto_skipped"}
62
- VALID_BEHAVIOR_STRATEGIES = ["test-gate", "snapshot", "manual"]
63
-
64
-
65
- def parse_args():
66
- parser = argparse.ArgumentParser(
67
- description="Initialize refactor pipeline state from a .prizmkit/plans/refactor-list.json file."
68
- )
69
- parser.add_argument(
70
- "--refactor-list",
71
- required=True,
72
- help="Path to the .prizmkit/plans/refactor-list.json file",
73
- )
74
- parser.add_argument(
75
- "--state-dir",
76
- required=True,
77
- help="Path to the state directory (default: .prizmkit/state/refactor)",
78
- )
79
- return parser.parse_args()
80
-
81
-
82
- def load_refactor_list(path):
83
- """Load and return the parsed JSON from the refactor list file."""
84
- data, err = load_json_file(path)
85
- if err:
86
- return None, [err]
87
- return data, []
88
-
89
-
90
- def validate_schema(data):
91
- """Validate the top-level schema and structure of the refactor list."""
92
- errors = []
93
-
94
- unknown_root = set(data) - ALLOWED_LIST_FIELDS
95
- if unknown_root:
96
- errors.append("Refactor list has unknown fields: {}".format(
97
- ", ".join(sorted(unknown_root))
98
- ))
99
-
100
- # Check $schema
101
- schema = data.get("$schema")
102
- if schema != EXPECTED_SCHEMA:
103
- errors.append(
104
- "Invalid $schema: expected '{}', got '{}'".format(EXPECTED_SCHEMA, schema)
105
- )
106
-
107
- # Check project_name
108
- if "project_name" not in data:
109
- errors.append("Missing required field: project_name")
110
- elif not isinstance(data["project_name"], str) or not data["project_name"].strip():
111
- errors.append("project_name must be a non-empty string")
112
-
113
- global_context = data.get("global_context")
114
- if global_context is not None:
115
- if not isinstance(global_context, dict):
116
- errors.append("global_context must be an object")
117
- else:
118
- unknown_context = set(global_context) - ALLOWED_GLOBAL_CONTEXT_FIELDS
119
- if unknown_context:
120
- errors.append("global_context has unknown fields: {}".format(
121
- ", ".join(sorted(unknown_context))
122
- ))
123
-
124
- # Check refactors array
125
- if "refactors" not in data:
126
- errors.append("Missing required field: refactors")
127
- elif not isinstance(data["refactors"], list):
128
- errors.append("refactors must be an array")
129
- elif len(data["refactors"]) == 0:
130
- errors.append("refactors array must contain at least one refactor")
131
-
132
- return errors
133
-
134
-
135
- def validate_refactors(refactors):
136
- """Validate each refactor object in the list."""
137
- errors = []
138
- seen_ids = set()
139
-
140
- for i, refactor in enumerate(refactors):
141
- if not isinstance(refactor, dict):
142
- errors.append("Refactor at index {} is not an object".format(i))
143
- continue
144
-
145
- # Check required fields
146
- for field in REQUIRED_REFACTOR_FIELDS:
147
- if field not in refactor:
148
- errors.append(
149
- "Refactor at index {} missing required field: {}".format(i, field)
150
- )
151
-
152
- unknown = set(refactor) - ALLOWED_REFACTOR_FIELDS
153
- if unknown:
154
- errors.append(
155
- "Refactor at index {} has unknown fields: {}".format(
156
- i, ", ".join(sorted(unknown))
157
- )
158
- )
159
-
160
- # Validate refactor ID format
161
- rid = refactor.get("id")
162
- if rid is not None:
163
- if not isinstance(rid, str) or not REFACTOR_ID_PATTERN.match(rid):
164
- errors.append(
165
- "Refactor at index {} has invalid id '{}' "
166
- "(must match R-NNN pattern)".format(i, rid)
167
- )
168
- elif rid in seen_ids:
169
- errors.append("Duplicate refactor id: {}".format(rid))
170
- else:
171
- seen_ids.add(rid)
172
-
173
- # Validate type
174
- rtype = refactor.get("type")
175
- if rtype is not None and rtype not in VALID_TYPES:
176
- errors.append(
177
- "Refactor '{}' has invalid type '{}' "
178
- "(must be one of {})".format(
179
- rid or "index {}".format(i), rtype, VALID_TYPES
180
- )
181
- )
182
-
183
- # Validate priority
184
- priority = refactor.get("priority")
185
- if priority is not None and priority not in VALID_PRIORITIES:
186
- errors.append(
187
- "Refactor '{}' has invalid priority '{}' "
188
- "(must be one of {})".format(
189
- rid or "index {}".format(i), priority, VALID_PRIORITIES
190
- )
191
- )
192
-
193
- # Validate complexity
194
- complexity = refactor.get("complexity")
195
- if complexity is not None and complexity not in VALID_COMPLEXITIES:
196
- errors.append(
197
- "Refactor '{}' has invalid complexity '{}' "
198
- "(must be one of {})".format(
199
- rid or "index {}".format(i), complexity, VALID_COMPLEXITIES
200
- )
201
- )
202
-
203
- # Validate status
204
- status = refactor.get("status")
205
- if status is not None and status not in VALID_STATUSES:
206
- errors.append(
207
- "Refactor '{}' has invalid status '{}' "
208
- "(must be one of {})".format(
209
- rid or "index {}".format(i), status, VALID_STATUSES
210
- )
211
- )
212
-
213
- # Validate scope is an object
214
- scope = refactor.get("scope")
215
- if scope is not None:
216
- if not isinstance(scope, dict):
217
- errors.append(
218
- "Refactor '{}' scope must be an object".format(
219
- rid or "index {}".format(i)
220
- )
221
- )
222
-
223
- # Validate behavior_preservation
224
- bp = refactor.get("behavior_preservation")
225
- if bp is not None:
226
- if not isinstance(bp, dict):
227
- errors.append(
228
- "Refactor '{}' behavior_preservation must be an object".format(
229
- rid or "index {}".format(i)
230
- )
231
- )
232
- else:
233
- strategy = bp.get("strategy")
234
- if strategy is not None and strategy not in VALID_BEHAVIOR_STRATEGIES:
235
- errors.append(
236
- "Refactor '{}' behavior_preservation.strategy '{}' "
237
- "must be one of {}".format(
238
- rid or "index {}".format(i), strategy, VALID_BEHAVIOR_STRATEGIES
239
- )
240
- )
241
-
242
- # Validate acceptance_criteria is a list
243
- ac = refactor.get("acceptance_criteria")
244
- if ac is not None and not isinstance(ac, list):
245
- errors.append(
246
- "Refactor '{}' acceptance_criteria must be an array".format(
247
- rid or "index {}".format(i)
248
- )
249
- )
250
-
251
- # Validate dependencies is a list
252
- deps = refactor.get("dependencies")
253
- if deps is not None and not isinstance(deps, list):
254
- errors.append(
255
- "Refactor '{}' dependencies must be an array".format(
256
- rid or "index {}".format(i)
257
- )
258
- )
259
- elif isinstance(deps, list):
260
- for dep in deps:
261
- if not isinstance(dep, str) or not REFACTOR_ID_PATTERN.match(dep):
262
- errors.append(
263
- "Refactor '{}' has invalid dependency '{}' "
264
- "(must match R-NNN pattern)".format(
265
- rid or "index {}".format(i), dep
266
- )
267
- )
268
- elif dep == rid:
269
- errors.append(
270
- "Refactor '{}' cannot depend on itself".format(
271
- rid or "index {}".format(i)
272
- )
273
- )
274
-
275
- topo_errors = stable_topological_order(
276
- refactors,
277
- id_key="id",
278
- dependencies_key="dependencies",
279
- item_label="Refactor",
280
- )[1]
281
- errors.extend(topo_errors)
282
-
283
- return errors, seen_ids
284
-
285
-
286
- def check_circular_dependencies(refactors):
287
- """Check for circular dependencies among refactors. Returns list of error strings."""
288
- errors = []
289
-
290
- # Build adjacency map: id -> list of dependency ids
291
- dep_map = {}
292
- valid_ids = set()
293
- for refactor in refactors:
294
- if not isinstance(refactor, dict):
295
- continue
296
- rid = refactor.get("id")
297
- if not rid:
298
- continue
299
- valid_ids.add(rid)
300
- deps = refactor.get("dependencies", [])
301
- if isinstance(deps, list):
302
- dep_map[rid] = [d for d in deps if isinstance(d, str)]
303
- else:
304
- dep_map[rid] = []
305
-
306
- # Check that all dependency references point to valid IDs
307
- for rid, deps in dep_map.items():
308
- for dep_id in deps:
309
- if dep_id not in valid_ids:
310
- errors.append(
311
- "Refactor '{}' depends on '{}' which does not exist".format(rid, dep_id)
312
- )
313
-
314
- # DFS cycle detection
315
- WHITE, GRAY, BLACK = 0, 1, 2
316
- color = {rid: WHITE for rid in valid_ids}
317
-
318
- def dfs(node, path):
319
- color[node] = GRAY
320
- path.append(node)
321
- for neighbor in dep_map.get(node, []):
322
- if neighbor not in color:
323
- continue
324
- if color[neighbor] == GRAY:
325
- # Found a cycle
326
- cycle_start = path.index(neighbor)
327
- cycle = path[cycle_start:] + [neighbor]
328
- errors.append(
329
- "Circular dependency detected: {}".format(" -> ".join(cycle))
330
- )
331
- return
332
- if color[neighbor] == WHITE:
333
- dfs(neighbor, path)
334
- path.pop()
335
- color[node] = BLACK
336
-
337
- for rid in valid_ids:
338
- if color[rid] == WHITE:
339
- dfs(rid, [])
340
-
341
- return errors
342
-
343
-
344
- def create_state_directory(state_dir, refactor_list_path, refactors):
345
- """Create the state directory structure with pipeline.json and per-refactor status files."""
346
- abs_state_dir = os.path.abspath(state_dir)
347
- abs_refactor_list_path = os.path.abspath(refactor_list_path)
348
- # Store as relative path from state_dir so pipeline.json is portable across machines
349
- rel_refactor_list_path = os.path.relpath(abs_refactor_list_path, abs_state_dir)
350
- refactors_dir = abs_state_dir
351
-
352
- now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
353
- run_id = "refactor-run-" + datetime.now(timezone.utc).strftime("%Y%m%d%H%M%S")
354
-
355
- # Create top-level state directory
356
- os.makedirs(abs_state_dir, exist_ok=True)
357
- os.makedirs(refactors_dir, exist_ok=True)
358
-
359
- # Count refactors already in terminal status at init time
360
- completed_count = sum(
361
- 1 for r in refactors
362
- if isinstance(r, dict) and r.get("status") in TERMINAL_STATUSES
363
- )
364
-
365
- # Write pipeline.json
366
- pipeline_state = {
367
- "run_id": run_id,
368
- "pipeline_type": "refactor",
369
- "status": "initialized",
370
- "refactor_list_path": rel_refactor_list_path,
371
- "created_at": now,
372
- "total_refactors": len(refactors),
373
- "completed_refactors": completed_count,
374
- }
375
- pipeline_path = os.path.join(abs_state_dir, "pipeline.json")
376
- with open(pipeline_path, "w", encoding="utf-8") as f:
377
- json.dump(pipeline_state, f, indent=2, ensure_ascii=False)
378
- f.write("\n")
379
-
380
- # Write per-refactor status.json and create sessions directory
381
- for refactor in refactors:
382
- if not isinstance(refactor, dict):
383
- continue
384
- rid = refactor.get("id")
385
- if rid is None:
386
- continue
387
-
388
- refactor_dir = os.path.join(refactors_dir, rid)
389
- sessions_dir = os.path.join(refactor_dir, "sessions")
390
- os.makedirs(sessions_dir, exist_ok=True)
391
-
392
- refactor_status = {
393
- "refactor_id": rid,
394
- "retry_count": 0,
395
- "max_retries": 3,
396
- "sessions": [],
397
- "last_session_id": None,
398
- "resume_from_phase": None,
399
- "created_at": now,
400
- "updated_at": now,
401
- }
402
- status_path = os.path.join(refactor_dir, "status.json")
403
- with open(status_path, "w", encoding="utf-8") as f:
404
- json.dump(refactor_status, f, indent=2, ensure_ascii=False)
405
- f.write("\n")
406
-
407
- return abs_state_dir
408
-
409
-
410
- def main():
411
- args = parse_args()
412
-
413
- # Load refactor list
414
- data, load_errors = load_refactor_list(args.refactor_list)
415
- if load_errors:
416
- output = {"valid": False, "errors": load_errors}
417
- print(json.dumps(output, indent=2, ensure_ascii=False))
418
- sys.exit(1)
419
-
420
- # Validate schema
421
- schema_errors = validate_schema(data)
422
- if schema_errors:
423
- output = {"valid": False, "errors": schema_errors}
424
- print(json.dumps(output, indent=2, ensure_ascii=False))
425
- sys.exit(1)
426
-
427
- # Validate refactors
428
- refactors = data["refactors"]
429
- refactor_errors, refactor_ids = validate_refactors(refactors)
430
- if refactor_errors:
431
- output = {"valid": False, "errors": refactor_errors}
432
- print(json.dumps(output, indent=2, ensure_ascii=False))
433
- sys.exit(1)
434
-
435
- # Check for circular dependencies
436
- dep_errors = check_circular_dependencies(refactors)
437
- if dep_errors:
438
- output = {"valid": False, "errors": dep_errors}
439
- print(json.dumps(output, indent=2, ensure_ascii=False))
440
- sys.exit(1)
441
-
442
- # Create state directory
443
- try:
444
- abs_state_dir = create_state_directory(
445
- args.state_dir, args.refactor_list, refactors
446
- )
447
- except (IOError, OSError) as e:
448
- output = {"valid": False, "errors": ["Failed to create state directory: {}".format(str(e))]}
449
- print(json.dumps(output, indent=2, ensure_ascii=False))
450
- sys.exit(1)
451
-
452
- # Success output
453
- output = {
454
- "valid": True,
455
- "refactors_count": len(refactors),
456
- "state_dir": abs_state_dir,
457
- }
458
- print(json.dumps(output, indent=2, ensure_ascii=False))
459
- sys.exit(0)
460
-
461
-
462
- if __name__ == "__main__":
463
- main()