@tiic-tech/openworkflow 0.1.0 → 0.1.2

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 (217) hide show
  1. package/README.md +10 -0
  2. package/dist/adapters/codex/src/cleanCodexAdapter.d.ts +7 -0
  3. package/dist/adapters/codex/src/cleanCodexAdapter.js +99 -0
  4. package/dist/adapters/codex/src/cleanCodexAdapter.js.map +1 -0
  5. package/dist/adapters/codex/src/constants.d.ts +1 -0
  6. package/dist/adapters/codex/src/constants.js +2 -0
  7. package/dist/adapters/codex/src/constants.js.map +1 -0
  8. package/dist/adapters/codex/src/generateCommands.js +14 -9
  9. package/dist/adapters/codex/src/generateCommands.js.map +1 -1
  10. package/dist/adapters/codex/src/generateSkills.js +13 -0
  11. package/dist/adapters/codex/src/generateSkills.js.map +1 -1
  12. package/dist/adapters/codex/src/generatedFiles.js +1 -1
  13. package/dist/adapters/codex/src/manifest.js +11 -2
  14. package/dist/adapters/codex/src/manifest.js.map +1 -1
  15. package/dist/adapters/codex/src/templates.d.ts +0 -1
  16. package/dist/adapters/codex/src/templates.js +0 -1
  17. package/dist/adapters/codex/src/templates.js.map +1 -1
  18. package/dist/adapters/src/registry.d.ts +20 -0
  19. package/dist/adapters/src/registry.js +81 -0
  20. package/dist/adapters/src/registry.js.map +1 -0
  21. package/dist/cli/src/commands/brief.d.ts +46 -0
  22. package/dist/cli/src/commands/brief.js +294 -0
  23. package/dist/cli/src/commands/brief.js.map +1 -0
  24. package/dist/cli/src/commands/check.d.ts +42 -0
  25. package/dist/cli/src/commands/check.js +326 -0
  26. package/dist/cli/src/commands/check.js.map +1 -0
  27. package/dist/cli/src/commands/clean.d.ts +1 -0
  28. package/dist/cli/src/commands/clean.js +98 -0
  29. package/dist/cli/src/commands/clean.js.map +1 -0
  30. package/dist/cli/src/commands/context.d.ts +1 -0
  31. package/dist/cli/src/commands/context.js +471 -0
  32. package/dist/cli/src/commands/context.js.map +1 -0
  33. package/dist/cli/src/commands/doctor.js +122 -12
  34. package/dist/cli/src/commands/doctor.js.map +1 -1
  35. package/dist/cli/src/commands/draft.d.ts +1 -0
  36. package/dist/cli/src/commands/draft.js +175 -0
  37. package/dist/cli/src/commands/draft.js.map +1 -0
  38. package/dist/cli/src/commands/gitAutomation.d.ts +1 -0
  39. package/dist/cli/src/commands/gitAutomation.js +378 -0
  40. package/dist/cli/src/commands/gitAutomation.js.map +1 -0
  41. package/dist/cli/src/commands/handoff.d.ts +22 -0
  42. package/dist/cli/src/commands/handoff.js +122 -0
  43. package/dist/cli/src/commands/handoff.js.map +1 -0
  44. package/dist/cli/src/commands/init.js +52 -1
  45. package/dist/cli/src/commands/init.js.map +1 -1
  46. package/dist/cli/src/commands/inspect.d.ts +23 -0
  47. package/dist/cli/src/commands/inspect.js +157 -0
  48. package/dist/cli/src/commands/inspect.js.map +1 -0
  49. package/dist/cli/src/commands/register.d.ts +1 -0
  50. package/dist/cli/src/commands/register.js +251 -0
  51. package/dist/cli/src/commands/register.js.map +1 -0
  52. package/dist/cli/src/commands/resume.d.ts +59 -0
  53. package/dist/cli/src/commands/resume.js +280 -0
  54. package/dist/cli/src/commands/resume.js.map +1 -0
  55. package/dist/cli/src/commands/shared.js +6 -2
  56. package/dist/cli/src/commands/shared.js.map +1 -1
  57. package/dist/cli/src/commands/summaries.d.ts +1 -0
  58. package/dist/cli/src/commands/summaries.js +77 -0
  59. package/dist/cli/src/commands/summaries.js.map +1 -0
  60. package/dist/cli/src/commands/summarize.d.ts +1 -0
  61. package/dist/cli/src/commands/summarize.js +316 -0
  62. package/dist/cli/src/commands/summarize.js.map +1 -0
  63. package/dist/cli/src/commands/sync.js +135 -12
  64. package/dist/cli/src/commands/sync.js.map +1 -1
  65. package/dist/cli/src/commands/validate.js +25 -1
  66. package/dist/cli/src/commands/validate.js.map +1 -1
  67. package/dist/cli/src/dev/verifyAgentE2E.d.ts +2 -0
  68. package/dist/cli/src/dev/verifyAgentE2E.js +391 -0
  69. package/dist/cli/src/dev/verifyAgentE2E.js.map +1 -0
  70. package/dist/cli/src/dev/verifyCleanCommand.d.ts +2 -0
  71. package/dist/cli/src/dev/verifyCleanCommand.js +338 -0
  72. package/dist/cli/src/dev/verifyCleanCommand.js.map +1 -0
  73. package/dist/cli/src/dev/verifyRuntimeSurface.js +4940 -54
  74. package/dist/cli/src/dev/verifyRuntimeSurface.js.map +1 -1
  75. package/dist/cli/src/dev/verifyWorkflowE2E.js +477 -45
  76. package/dist/cli/src/dev/verifyWorkflowE2E.js.map +1 -1
  77. package/dist/cli/src/index.js +189 -5
  78. package/dist/cli/src/index.js.map +1 -1
  79. package/dist/cli/src/report.d.ts +26 -0
  80. package/dist/cli/src/report.js +17 -0
  81. package/dist/cli/src/report.js.map +1 -0
  82. package/dist/core/src/artifacts/readiness.d.ts +7 -0
  83. package/dist/core/src/artifacts/readiness.js +240 -0
  84. package/dist/core/src/artifacts/readiness.js.map +1 -0
  85. package/dist/core/src/artifacts/registry.d.ts +9 -2
  86. package/dist/core/src/artifacts/registry.js +687 -60
  87. package/dist/core/src/artifacts/registry.js.map +1 -1
  88. package/dist/core/src/commands/registry.js +1425 -146
  89. package/dist/core/src/commands/registry.js.map +1 -1
  90. package/dist/core/src/contracts/index.d.ts +1 -1
  91. package/dist/core/src/fs/index.d.ts +24 -0
  92. package/dist/core/src/fs/index.js +48 -1
  93. package/dist/core/src/fs/index.js.map +1 -1
  94. package/dist/core/src/git/autonomousSimulator.d.ts +46 -0
  95. package/dist/core/src/git/autonomousSimulator.js +163 -0
  96. package/dist/core/src/git/autonomousSimulator.js.map +1 -0
  97. package/dist/core/src/git/branchIdentity.d.ts +19 -0
  98. package/dist/core/src/git/branchIdentity.js +75 -0
  99. package/dist/core/src/git/branchIdentity.js.map +1 -0
  100. package/dist/core/src/git/draftPrPilot.d.ts +47 -0
  101. package/dist/core/src/git/draftPrPilot.js +196 -0
  102. package/dist/core/src/git/draftPrPilot.js.map +1 -0
  103. package/dist/core/src/git/localEvidenceReader.d.ts +21 -0
  104. package/dist/core/src/git/localEvidenceReader.js +142 -0
  105. package/dist/core/src/git/localEvidenceReader.js.map +1 -0
  106. package/dist/core/src/git/localGitAutomation.d.ts +68 -0
  107. package/dist/core/src/git/localGitAutomation.js +470 -0
  108. package/dist/core/src/git/localGitAutomation.js.map +1 -0
  109. package/dist/core/src/git/mergeReadinessCheckpoint.d.ts +31 -0
  110. package/dist/core/src/git/mergeReadinessCheckpoint.js +110 -0
  111. package/dist/core/src/git/mergeReadinessCheckpoint.js.map +1 -0
  112. package/dist/core/src/git/prReadySummary.d.ts +16 -0
  113. package/dist/core/src/git/prReadySummary.js +144 -0
  114. package/dist/core/src/git/prReadySummary.js.map +1 -0
  115. package/dist/core/src/git/remoteReadonlyPlanner.d.ts +60 -0
  116. package/dist/core/src/git/remoteReadonlyPlanner.js +223 -0
  117. package/dist/core/src/git/remoteReadonlyPlanner.js.map +1 -0
  118. package/dist/core/src/onboarding/agentsGuide.d.ts +32 -0
  119. package/dist/core/src/onboarding/agentsGuide.js +164 -0
  120. package/dist/core/src/onboarding/agentsGuide.js.map +1 -0
  121. package/dist/core/src/validators/validateOpenWorkflow.js +1331 -15
  122. package/dist/core/src/validators/validateOpenWorkflow.js.map +1 -1
  123. package/dist/core/src/validators/validateRepositoryContracts.js +2327 -306
  124. package/dist/core/src/validators/validateRepositoryContracts.js.map +1 -1
  125. package/dist/core/src/workflow/cleanOpenWorkflow.d.ts +18 -0
  126. package/dist/core/src/workflow/cleanOpenWorkflow.js +124 -0
  127. package/dist/core/src/workflow/cleanOpenWorkflow.js.map +1 -0
  128. package/dist/core/src/workflow/doctorOpenWorkflow.d.ts +7 -0
  129. package/dist/core/src/workflow/doctorOpenWorkflow.js +26 -0
  130. package/dist/core/src/workflow/doctorOpenWorkflow.js.map +1 -0
  131. package/dist/core/src/workflow/initOpenWorkflow.d.ts +7 -0
  132. package/dist/core/src/workflow/initOpenWorkflow.js +96 -8
  133. package/dist/core/src/workflow/initOpenWorkflow.js.map +1 -1
  134. package/dist/core/src/workflow/planningQueueResume.d.ts +105 -0
  135. package/dist/core/src/workflow/planningQueueResume.js +596 -0
  136. package/dist/core/src/workflow/planningQueueResume.js.map +1 -0
  137. package/dist/core/src/workflow/readWorkflowConfig.d.ts +6 -0
  138. package/dist/core/src/workflow/readWorkflowConfig.js +28 -0
  139. package/dist/core/src/workflow/readWorkflowConfig.js.map +1 -0
  140. package/dist/core/src/workflow/summaryHealth.d.ts +60 -0
  141. package/dist/core/src/workflow/summaryHealth.js +713 -0
  142. package/dist/core/src/workflow/summaryHealth.js.map +1 -0
  143. package/dist/core/src/workflow/syncOpenWorkflow.d.ts +22 -0
  144. package/dist/core/src/workflow/syncOpenWorkflow.js +235 -0
  145. package/dist/core/src/workflow/syncOpenWorkflow.js.map +1 -0
  146. package/package.json +4 -2
  147. package/references/artifact-authoring-templates.md +14 -12
  148. package/references/artifact-instruction-envelope.md +133 -0
  149. package/references/coder-continuous-growth-loop.md +68 -0
  150. package/references/gh-operation-governance.md +114 -0
  151. package/references/git-automation-governance.md +324 -0
  152. package/references/git-version-control-governance.md +227 -0
  153. package/references/internal-coder-protocol.md +202 -0
  154. package/references/issue-governance.md +115 -0
  155. package/references/planning-artifact-contracts.md +595 -0
  156. package/references/planning-skill-runtime-exposure.md +159 -0
  157. package/references/proto-redesign-artifact-contracts.md +217 -0
  158. package/references/proto2html-artifact-contracts.md +113 -0
  159. package/references/skill-system-lifecycle.md +198 -0
  160. package/references/validation-trust-domains.md +286 -0
  161. package/references/workflow-blueprint-runtime-alignment.md +287 -0
  162. package/schemas/atom-tasks.schema.json +101 -0
  163. package/schemas/candidate-changes.schema.json +323 -0
  164. package/schemas/current-state.schema.json +113 -0
  165. package/schemas/html-prototype.schema.json +288 -0
  166. package/schemas/openworkflow-contract.schema.json +9 -1
  167. package/schemas/proto-prompt-pack.schema.json +1333 -0
  168. package/schemas/prototype-evidence.schema.json +684 -142
  169. package/schemas/selected-change.schema.json +104 -0
  170. package/schemas/validation-target.schema.json +187 -1
  171. package/schemas/validation.schema.json +187 -1
  172. package/schemas/vision-session.schema.json +151 -0
  173. package/skills/analyze-changes/SKILL.md +92 -0
  174. package/skills/analyze-changes/agents/openai.yaml +4 -0
  175. package/skills/analyze-changes/references/analysis-protocol.md +116 -0
  176. package/skills/build-proto-prompt/SKILL.md +125 -0
  177. package/skills/build-proto-prompt/references/output-boundary.md +54 -0
  178. package/skills/build-proto-prompt/references/prompt-pack-compiler-protocol.md +80 -0
  179. package/skills/build-prototype/SKILL.md +162 -38
  180. package/skills/build-prototype/agents/openai.yaml +2 -2
  181. package/skills/build-prototype/references/philosophy-engine.md +61 -0
  182. package/skills/build-prototype/references/strategic-prompt-pack-protocol.md +365 -0
  183. package/skills/build-prototype/references/vision2prompt/01_input_contract.md +84 -0
  184. package/skills/build-prototype/references/vision2prompt/02_vision_decomposition.md +108 -0
  185. package/skills/build-prototype/references/vision2prompt/03_strategy_hypothesis_generation.md +89 -0
  186. package/skills/build-prototype/references/vision2prompt/04_product_system_extraction.md +78 -0
  187. package/skills/build-prototype/references/vision2prompt/05_prototype_prompt_schema.md +189 -0
  188. package/skills/build-prototype/references/vision2prompt/06_output_templates.md +125 -0
  189. package/skills/build-prototype/references/vision2prompt/07_quality_rubric.md +171 -0
  190. package/skills/build-validation/SKILL.md +136 -54
  191. package/skills/build-validation/references/prototype-validation-target-rubric.md +35 -0
  192. package/skills/build-validation/references/return-to-vision-gate.md +32 -0
  193. package/skills/build-vision/SKILL.md +192 -0
  194. package/skills/build-vision/references/proto-readiness-rubric.md +48 -0
  195. package/skills/build-vision/references/vision-interview-protocol.md +48 -0
  196. package/skills/coder/SKILL.md +204 -0
  197. package/skills/decompose-to-changes/SKILL.md +176 -0
  198. package/skills/decompose-to-changes/agents/openai.yaml +4 -0
  199. package/skills/decompose-to-changes/references/decomposition-protocol.md +278 -0
  200. package/skills/prompt2proto/SKILL.md +157 -0
  201. package/skills/prompt2proto/agents/openai.yaml +4 -0
  202. package/skills/prompt2proto/references/00_role_philosophy_engine.md +96 -0
  203. package/skills/prompt2proto/references/01_input_contract.md +53 -0
  204. package/skills/prompt2proto/references/02_prompt_pack_readiness.md +50 -0
  205. package/skills/prompt2proto/references/03_visual_translation_workflow.md +64 -0
  206. package/skills/prompt2proto/references/04_output_contract.md +67 -0
  207. package/skills/prompt2proto/references/05_quality_rubric.md +46 -0
  208. package/skills/proto2html/SKILL.md +136 -0
  209. package/skills/proto2html/agents/openai.yaml +4 -0
  210. package/skills/proto2html/references/proto2html-protocol.md +115 -0
  211. package/skills/run-team/SKILL.md +4 -0
  212. package/skills/select-change/SKILL.md +200 -0
  213. package/skills/select-change/agents/openai.yaml +4 -0
  214. package/skills/select-change/references/selection-protocol.md +281 -0
  215. package/skills/tune-prototype/SKILL.md +121 -0
  216. package/skills/tune-prototype/agents/openai.yaml +4 -0
  217. package/skills/tune-prototype/references/refined-prompt-pack-protocol.md +161 -0
package/schemas/candidate-changes.schema.json ADDED
@@ -0,0 +1,323 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openworkflow.local/schemas/candidate-changes.schema.json",
4
+ "title": "OpenWorkflow Candidate Changes",
5
+ "type": "object",
6
+ "required": [
7
+ "schema_version",
8
+ "contract_id",
9
+ "contract_type",
10
+ "planning_artifact_type",
11
+ "plan_id",
12
+ "title",
13
+ "status",
14
+ "source",
15
+ "queue_policy",
16
+ "selection_policy",
17
+ "changes"
18
+ ],
19
+ "properties": {
20
+ "schema_version": {
21
+ "type": "string"
22
+ },
23
+ "contract_id": {
24
+ "type": "string"
25
+ },
26
+ "contract_type": {
27
+ "const": "planning"
28
+ },
29
+ "planning_artifact_type": {
30
+ "const": "candidate_changes"
31
+ },
32
+ "plan_id": {
33
+ "type": "string"
34
+ },
35
+ "title": {
36
+ "type": "string"
37
+ },
38
+ "status": {
39
+ "type": "string",
40
+ "enum": [
41
+ "draft",
42
+ "active",
43
+ "completed",
44
+ "superseded",
45
+ "archived"
46
+ ]
47
+ },
48
+ "source": {
49
+ "type": "object"
50
+ },
51
+ "queue_policy": {
52
+ "type": "object",
53
+ "properties": {
54
+ "branch_boundary": {
55
+ "type": "string"
56
+ },
57
+ "source_of_truth": {
58
+ "type": "string"
59
+ },
60
+ "readable_view": {
61
+ "type": "string"
62
+ },
63
+ "id_policy": {
64
+ "type": "string"
65
+ },
66
+ "selected_change_commit_gate": {
67
+ "enum": [
68
+ "strict",
69
+ "migration"
70
+ ]
71
+ }
72
+ },
73
+ "additionalProperties": true
74
+ },
75
+ "selection_policy": {
76
+ "type": "object"
77
+ },
78
+ "scope_control": {
79
+ "type": "object",
80
+ "properties": {
81
+ "current_boundary": {
82
+ "type": "string"
83
+ },
84
+ "boundary_type": {
85
+ "type": "string"
86
+ },
87
+ "in_scope_rule": {
88
+ "type": "string"
89
+ },
90
+ "out_of_scope_rule": {
91
+ "type": "string"
92
+ },
93
+ "deferred_features": {
94
+ "type": "array",
95
+ "items": {
96
+ "type": "object",
97
+ "required": [
98
+ "title",
99
+ "reason"
100
+ ],
101
+ "properties": {
102
+ "title": {
103
+ "type": "string"
104
+ },
105
+ "reason": {
106
+ "type": "string"
107
+ },
108
+ "suggested_plan_id": {
109
+ "type": "string"
110
+ }
111
+ },
112
+ "additionalProperties": true
113
+ }
114
+ }
115
+ },
116
+ "additionalProperties": true
117
+ },
118
+ "next_recommended_candidate_id": {
119
+ "type": [
120
+ "string",
121
+ "null"
122
+ ]
123
+ },
124
+ "changes": {
125
+ "type": "array",
126
+ "items": {
127
+ "type": "object",
128
+ "required": [
129
+ "id",
130
+ "status",
131
+ "title",
132
+ "purpose",
133
+ "scope",
134
+ "owned_paths",
135
+ "dependencies",
136
+ "unlocks",
137
+ "risk",
138
+ "size",
139
+ "validation",
140
+ "acceptance"
141
+ ],
142
+ "properties": {
143
+ "id": {
144
+ "type": "string",
145
+ "pattern": "^[A-Z][A-Z0-9]*[0-9]{3}$"
146
+ },
147
+ "status": {
148
+ "type": "string",
149
+ "enum": [
150
+ "candidate",
151
+ "ready",
152
+ "selected",
153
+ "in_progress",
154
+ "done",
155
+ "blocked",
156
+ "deferred",
157
+ "superseded"
158
+ ]
159
+ },
160
+ "title": {
161
+ "type": "string"
162
+ },
163
+ "purpose": {
164
+ "type": "string"
165
+ },
166
+ "scope": {
167
+ "type": "object",
168
+ "required": [
169
+ "includes",
170
+ "excludes"
171
+ ]
172
+ },
173
+ "owned_paths": {
174
+ "type": "array",
175
+ "items": {
176
+ "type": "string"
177
+ }
178
+ },
179
+ "dependencies": {
180
+ "type": "array",
181
+ "items": {
182
+ "type": "string"
183
+ }
184
+ },
185
+ "unlocks": {
186
+ "type": "array",
187
+ "items": {
188
+ "type": "string"
189
+ }
190
+ },
191
+ "risk": {
192
+ "type": "string"
193
+ },
194
+ "size": {
195
+ "type": "string"
196
+ },
197
+ "validation": {
198
+ "type": "array",
199
+ "items": {
200
+ "type": "string"
201
+ }
202
+ },
203
+ "acceptance": {
204
+ "type": "array",
205
+ "items": {
206
+ "type": "string"
207
+ }
208
+ },
209
+ "selection": {
210
+ "type": "object"
211
+ },
212
+ "completion": {
213
+ "type": "object",
214
+ "properties": {
215
+ "completed_by_change_id": {
216
+ "type": "string"
217
+ },
218
+ "completed_at": {
219
+ "type": "string"
220
+ },
221
+ "implementation_changed_files": {
222
+ "type": "boolean"
223
+ },
224
+ "commit_not_required_reason": {
225
+ "type": "string"
226
+ },
227
+ "local_commit_evidence": {
228
+ "type": "string"
229
+ },
230
+ "local_commit_evidence_path": {
231
+ "type": "string"
232
+ },
233
+ "evidence": {
234
+ "type": "array",
235
+ "items": {
236
+ "type": "string"
237
+ }
238
+ },
239
+ "validation": {
240
+ "type": "array",
241
+ "items": {
242
+ "type": "string"
243
+ }
244
+ }
245
+ },
246
+ "additionalProperties": true
247
+ }
248
+ },
249
+ "additionalProperties": true
250
+ }
251
+ },
252
+ "operations": {
253
+ "type": "array",
254
+ "items": {
255
+ "type": "object",
256
+ "required": [
257
+ "operation_id",
258
+ "operation_type",
259
+ "target_candidate_ids",
260
+ "actor",
261
+ "reason",
262
+ "changed_at"
263
+ ],
264
+ "properties": {
265
+ "operation_id": {
266
+ "type": "string",
267
+ "pattern": "^OP[0-9]{3}$"
268
+ },
269
+ "operation_type": {
270
+ "type": "string",
271
+ "enum": [
272
+ "query",
273
+ "add",
274
+ "update",
275
+ "status_change",
276
+ "split",
277
+ "merge",
278
+ "priority_change",
279
+ "select",
280
+ "complete",
281
+ "remove"
282
+ ]
283
+ },
284
+ "target_candidate_ids": {
285
+ "type": "array",
286
+ "items": {
287
+ "type": "string"
288
+ }
289
+ },
290
+ "actor": {
291
+ "type": "string"
292
+ },
293
+ "reason": {
294
+ "type": "string"
295
+ },
296
+ "changed_at": {
297
+ "type": "string"
298
+ },
299
+ "before_status": {
300
+ "type": [
301
+ "string",
302
+ "null"
303
+ ]
304
+ },
305
+ "after_status": {
306
+ "type": [
307
+ "string",
308
+ "null"
309
+ ]
310
+ },
311
+ "evidence": {
312
+ "type": "array",
313
+ "items": {
314
+ "type": "string"
315
+ }
316
+ }
317
+ },
318
+ "additionalProperties": true
319
+ }
320
+ }
321
+ },
322
+ "additionalProperties": true
323
+ }
package/schemas/current-state.schema.json ADDED
@@ -0,0 +1,113 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openworkflow.local/schemas/current-state.schema.json",
4
+ "title": "OpenWorkflow Current State",
5
+ "type": "object",
6
+ "required": [
7
+ "schema_version",
8
+ "contract_id",
9
+ "contract_type",
10
+ "title",
11
+ "status",
12
+ "active_stage",
13
+ "last_decision",
14
+ "next_command",
15
+ "blocked_by",
16
+ "read_this_first"
17
+ ],
18
+ "properties": {
19
+ "schema_version": {
20
+ "type": "string"
21
+ },
22
+ "contract_id": {
23
+ "const": "workflow:current-state"
24
+ },
25
+ "contract_type": {
26
+ "const": "workflow"
27
+ },
28
+ "title": {
29
+ "type": "string"
30
+ },
31
+ "status": {
32
+ "type": "string"
33
+ },
34
+ "active_stage": {
35
+ "type": "string"
36
+ },
37
+ "current_vision": {
38
+ "type": [
39
+ "string",
40
+ "null"
41
+ ]
42
+ },
43
+ "current_validation": {
44
+ "type": [
45
+ "string",
46
+ "null"
47
+ ]
48
+ },
49
+ "current_prototype": {
50
+ "type": [
51
+ "string",
52
+ "null"
53
+ ]
54
+ },
55
+ "current_decision": {
56
+ "type": [
57
+ "string",
58
+ "null"
59
+ ]
60
+ },
61
+ "current_design": {
62
+ "type": [
63
+ "string",
64
+ "null"
65
+ ]
66
+ },
67
+ "current_spec": {
68
+ "type": [
69
+ "string",
70
+ "null"
71
+ ]
72
+ },
73
+ "current_change": {
74
+ "type": [
75
+ "string",
76
+ "null"
77
+ ]
78
+ },
79
+ "current_run": {
80
+ "type": [
81
+ "string",
82
+ "null"
83
+ ]
84
+ },
85
+ "last_decision": {
86
+ "type": "object",
87
+ "required": [
88
+ "outcome",
89
+ "path"
90
+ ],
91
+ "additionalProperties": true
92
+ },
93
+ "next_command": {
94
+ "type": [
95
+ "string",
96
+ "null"
97
+ ]
98
+ },
99
+ "blocked_by": {
100
+ "type": "array",
101
+ "items": {
102
+ "type": "string"
103
+ }
104
+ },
105
+ "read_this_first": {
106
+ "type": "array",
107
+ "items": {
108
+ "type": "string"
109
+ }
110
+ }
111
+ },
112
+ "additionalProperties": true
113
+ }
package/schemas/html-prototype.schema.json ADDED
@@ -0,0 +1,288 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openworkflow.local/schemas/html-prototype.schema.json",
4
+ "title": "OpenWorkflow HTML Prototype Artifact",
5
+ "type": "object",
6
+ "required": [
7
+ "schema_version",
8
+ "contract_id",
9
+ "contract_type",
10
+ "artifact_type",
11
+ "title",
12
+ "status",
13
+ "source_prototype",
14
+ "benchmark",
15
+ "reconstruction_scope",
16
+ "html_artifact",
17
+ "render_targets",
18
+ "fidelity",
19
+ "known_limits",
20
+ "result",
21
+ "handoff"
22
+ ],
23
+ "properties": {
24
+ "schema_version": {
25
+ "type": "string"
26
+ },
27
+ "contract_id": {
28
+ "type": "string"
29
+ },
30
+ "contract_type": {
31
+ "const": "html_prototype"
32
+ },
33
+ "artifact_type": {
34
+ "const": "html_prototype"
35
+ },
36
+ "title": {
37
+ "type": "string"
38
+ },
39
+ "status": {
40
+ "type": "string",
41
+ "enum": [
42
+ "draft",
43
+ "active",
44
+ "reviewed",
45
+ "accepted",
46
+ "superseded",
47
+ "archived"
48
+ ]
49
+ },
50
+ "source_prototype": {
51
+ "type": "object",
52
+ "required": [
53
+ "evidence_ref",
54
+ "accepted_decision_ref"
55
+ ],
56
+ "properties": {
57
+ "evidence_ref": {
58
+ "type": "string"
59
+ },
60
+ "prompt_pack_ref": {
61
+ "type": [
62
+ "string",
63
+ "null"
64
+ ]
65
+ },
66
+ "accepted_decision_ref": {
67
+ "type": [
68
+ "string",
69
+ "null"
70
+ ]
71
+ },
72
+ "notes": {
73
+ "type": "array",
74
+ "items": {
75
+ "type": "string"
76
+ }
77
+ }
78
+ },
79
+ "additionalProperties": true
80
+ },
81
+ "benchmark": {
82
+ "type": "object",
83
+ "required": [
84
+ "kind",
85
+ "refs"
86
+ ],
87
+ "properties": {
88
+ "kind": {
89
+ "type": "string",
90
+ "enum": [
91
+ "benchmark_image",
92
+ "image_set",
93
+ "screen_group"
94
+ ]
95
+ },
96
+ "refs": {
97
+ "type": "array",
98
+ "items": {
99
+ "type": "string"
100
+ }
101
+ },
102
+ "selected_ref": {
103
+ "type": [
104
+ "string",
105
+ "null"
106
+ ]
107
+ },
108
+ "acceptance_notes": {
109
+ "type": "array",
110
+ "items": {
111
+ "type": "string"
112
+ }
113
+ }
114
+ },
115
+ "additionalProperties": true
116
+ },
117
+ "reconstruction_scope": {
118
+ "type": "object",
119
+ "required": [
120
+ "include",
121
+ "exclude"
122
+ ],
123
+ "properties": {
124
+ "include": {
125
+ "type": "array",
126
+ "items": {
127
+ "type": "string"
128
+ }
129
+ },
130
+ "exclude": {
131
+ "type": "array",
132
+ "items": {
133
+ "type": "string"
134
+ }
135
+ }
136
+ },
137
+ "additionalProperties": true
138
+ },
139
+ "html_artifact": {
140
+ "type": "object",
141
+ "required": [
142
+ "path",
143
+ "type",
144
+ "entrypoint"
145
+ ],
146
+ "properties": {
147
+ "path": {
148
+ "type": "string"
149
+ },
150
+ "type": {
151
+ "const": "single_file_html"
152
+ },
153
+ "entrypoint": {
154
+ "type": "string"
155
+ }
156
+ },
157
+ "additionalProperties": true
158
+ },
159
+ "render_targets": {
160
+ "type": "array",
161
+ "items": {
162
+ "type": "object",
163
+ "required": [
164
+ "target_id",
165
+ "width",
166
+ "height"
167
+ ],
168
+ "properties": {
169
+ "target_id": {
170
+ "type": "string"
171
+ },
172
+ "width": {
173
+ "type": "number"
174
+ },
175
+ "height": {
176
+ "type": "number"
177
+ },
178
+ "device": {
179
+ "type": "string"
180
+ }
181
+ },
182
+ "additionalProperties": true
183
+ }
184
+ },
185
+ "fidelity": {
186
+ "type": "object",
187
+ "required": [
188
+ "benchmark_refs",
189
+ "screenshot_refs",
190
+ "matched_elements",
191
+ "gaps"
192
+ ],
193
+ "properties": {
194
+ "benchmark_refs": {
195
+ "type": "array",
196
+ "items": {
197
+ "type": "string"
198
+ }
199
+ },
200
+ "screenshot_refs": {
201
+ "type": "array",
202
+ "items": {
203
+ "type": "string"
204
+ }
205
+ },
206
+ "matched_elements": {
207
+ "type": "array",
208
+ "items": {
209
+ "type": "string"
210
+ }
211
+ },
212
+ "gaps": {
213
+ "type": "array",
214
+ "items": {
215
+ "type": "object",
216
+ "required": [
217
+ "gap_id",
218
+ "severity",
219
+ "description"
220
+ ],
221
+ "properties": {
222
+ "gap_id": {
223
+ "type": "string"
224
+ },
225
+ "severity": {
226
+ "type": "string",
227
+ "enum": [
228
+ "low",
229
+ "medium",
230
+ "high",
231
+ "blocking"
232
+ ]
233
+ },
234
+ "description": {
235
+ "type": "string"
236
+ },
237
+ "disposition": {
238
+ "type": "string"
239
+ }
240
+ },
241
+ "additionalProperties": true
242
+ }
243
+ },
244
+ "browser_checks": {
245
+ "type": "array",
246
+ "items": {
247
+ "type": "string"
248
+ }
249
+ }
250
+ },
251
+ "additionalProperties": true
252
+ },
253
+ "implementation_notes": {
254
+ "type": "array",
255
+ "items": {
256
+ "type": "string"
257
+ }
258
+ },
259
+ "known_limits": {
260
+ "type": "array",
261
+ "items": {
262
+ "type": "string"
263
+ }
264
+ },
265
+ "result": {
266
+ "type": "string",
267
+ "enum": [
268
+ "accepted",
269
+ "needs_reconstruction",
270
+ "return_to_tune",
271
+ "blocked"
272
+ ]
273
+ },
274
+ "handoff": {
275
+ "type": "object",
276
+ "required": [
277
+ "next_command"
278
+ ],
279
+ "properties": {
280
+ "next_command": {
281
+ "type": "string"
282
+ }
283
+ },
284
+ "additionalProperties": true
285
+ }
286
+ },
287
+ "additionalProperties": true
288
+ }