npm - @tiic-tech/openworkflow - Versions diffs - 0.1.1 → 0.1.2 - Mend

@tiic-tech/openworkflow 0.1.1 → 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 (213) hide show

package/dist/adapters/codex/src/cleanCodexAdapter.js +4 -1
package/dist/adapters/codex/src/cleanCodexAdapter.js.map +1 -1
package/dist/adapters/codex/src/constants.d.ts +1 -0
package/dist/adapters/codex/src/constants.js +2 -0
package/dist/adapters/codex/src/constants.js.map +1 -0
package/dist/adapters/codex/src/generateCommands.js +14 -9
package/dist/adapters/codex/src/generateCommands.js.map +1 -1
package/dist/adapters/codex/src/generateSkills.js +13 -0
package/dist/adapters/codex/src/generateSkills.js.map +1 -1
package/dist/adapters/codex/src/generatedFiles.js +1 -1
package/dist/adapters/codex/src/manifest.js +11 -2
package/dist/adapters/codex/src/manifest.js.map +1 -1
package/dist/adapters/codex/src/templates.d.ts +0 -1
package/dist/adapters/codex/src/templates.js +0 -1
package/dist/adapters/codex/src/templates.js.map +1 -1
package/dist/adapters/src/registry.d.ts +20 -0
package/dist/adapters/src/registry.js +81 -0
package/dist/adapters/src/registry.js.map +1 -0
package/dist/cli/src/commands/brief.d.ts +46 -0
package/dist/cli/src/commands/brief.js +294 -0
package/dist/cli/src/commands/brief.js.map +1 -0
package/dist/cli/src/commands/check.d.ts +42 -0
package/dist/cli/src/commands/check.js +326 -0
package/dist/cli/src/commands/check.js.map +1 -0
package/dist/cli/src/commands/clean.js +46 -1
package/dist/cli/src/commands/clean.js.map +1 -1
package/dist/cli/src/commands/context.d.ts +1 -0
package/dist/cli/src/commands/context.js +471 -0
package/dist/cli/src/commands/context.js.map +1 -0
package/dist/cli/src/commands/doctor.js +122 -12
package/dist/cli/src/commands/doctor.js.map +1 -1
package/dist/cli/src/commands/draft.d.ts +1 -0
package/dist/cli/src/commands/draft.js +175 -0
package/dist/cli/src/commands/draft.js.map +1 -0
package/dist/cli/src/commands/gitAutomation.d.ts +1 -0
package/dist/cli/src/commands/gitAutomation.js +378 -0
package/dist/cli/src/commands/gitAutomation.js.map +1 -0
package/dist/cli/src/commands/handoff.d.ts +22 -0
package/dist/cli/src/commands/handoff.js +122 -0
package/dist/cli/src/commands/handoff.js.map +1 -0
package/dist/cli/src/commands/init.js +52 -1
package/dist/cli/src/commands/init.js.map +1 -1
package/dist/cli/src/commands/inspect.d.ts +23 -0
package/dist/cli/src/commands/inspect.js +157 -0
package/dist/cli/src/commands/inspect.js.map +1 -0
package/dist/cli/src/commands/register.d.ts +1 -0
package/dist/cli/src/commands/register.js +251 -0
package/dist/cli/src/commands/register.js.map +1 -0
package/dist/cli/src/commands/resume.d.ts +59 -0
package/dist/cli/src/commands/resume.js +280 -0
package/dist/cli/src/commands/resume.js.map +1 -0
package/dist/cli/src/commands/shared.js +6 -2
package/dist/cli/src/commands/shared.js.map +1 -1
package/dist/cli/src/commands/summaries.d.ts +1 -0
package/dist/cli/src/commands/summaries.js +77 -0
package/dist/cli/src/commands/summaries.js.map +1 -0
package/dist/cli/src/commands/summarize.d.ts +1 -0
package/dist/cli/src/commands/summarize.js +316 -0
package/dist/cli/src/commands/summarize.js.map +1 -0
package/dist/cli/src/commands/sync.js +135 -12
package/dist/cli/src/commands/sync.js.map +1 -1
package/dist/cli/src/commands/validate.js +25 -1
package/dist/cli/src/commands/validate.js.map +1 -1
package/dist/cli/src/dev/verifyAgentE2E.d.ts +2 -0
package/dist/cli/src/dev/verifyAgentE2E.js +391 -0
package/dist/cli/src/dev/verifyAgentE2E.js.map +1 -0
package/dist/cli/src/dev/verifyCleanCommand.js +213 -2
package/dist/cli/src/dev/verifyCleanCommand.js.map +1 -1
package/dist/cli/src/dev/verifyRuntimeSurface.js +4940 -54
package/dist/cli/src/dev/verifyRuntimeSurface.js.map +1 -1
package/dist/cli/src/dev/verifyWorkflowE2E.js +477 -45
package/dist/cli/src/dev/verifyWorkflowE2E.js.map +1 -1
package/dist/cli/src/index.js +184 -6
package/dist/cli/src/index.js.map +1 -1
package/dist/cli/src/report.d.ts +26 -0
package/dist/cli/src/report.js +17 -0
package/dist/cli/src/report.js.map +1 -0
package/dist/core/src/artifacts/readiness.d.ts +7 -0
package/dist/core/src/artifacts/readiness.js +240 -0
package/dist/core/src/artifacts/readiness.js.map +1 -0
package/dist/core/src/artifacts/registry.d.ts +9 -2
package/dist/core/src/artifacts/registry.js +687 -60
package/dist/core/src/artifacts/registry.js.map +1 -1
package/dist/core/src/commands/registry.js +1425 -146
package/dist/core/src/commands/registry.js.map +1 -1
package/dist/core/src/contracts/index.d.ts +1 -1
package/dist/core/src/fs/index.d.ts +24 -0
package/dist/core/src/fs/index.js +48 -1
package/dist/core/src/fs/index.js.map +1 -1
package/dist/core/src/git/autonomousSimulator.d.ts +46 -0
package/dist/core/src/git/autonomousSimulator.js +163 -0
package/dist/core/src/git/autonomousSimulator.js.map +1 -0
package/dist/core/src/git/branchIdentity.d.ts +19 -0
package/dist/core/src/git/branchIdentity.js +75 -0
package/dist/core/src/git/branchIdentity.js.map +1 -0
package/dist/core/src/git/draftPrPilot.d.ts +47 -0
package/dist/core/src/git/draftPrPilot.js +196 -0
package/dist/core/src/git/draftPrPilot.js.map +1 -0
package/dist/core/src/git/localEvidenceReader.d.ts +21 -0
package/dist/core/src/git/localEvidenceReader.js +142 -0
package/dist/core/src/git/localEvidenceReader.js.map +1 -0
package/dist/core/src/git/localGitAutomation.d.ts +68 -0
package/dist/core/src/git/localGitAutomation.js +470 -0
package/dist/core/src/git/localGitAutomation.js.map +1 -0
package/dist/core/src/git/mergeReadinessCheckpoint.d.ts +31 -0
package/dist/core/src/git/mergeReadinessCheckpoint.js +110 -0
package/dist/core/src/git/mergeReadinessCheckpoint.js.map +1 -0
package/dist/core/src/git/prReadySummary.d.ts +16 -0
package/dist/core/src/git/prReadySummary.js +144 -0
package/dist/core/src/git/prReadySummary.js.map +1 -0
package/dist/core/src/git/remoteReadonlyPlanner.d.ts +60 -0
package/dist/core/src/git/remoteReadonlyPlanner.js +223 -0
package/dist/core/src/git/remoteReadonlyPlanner.js.map +1 -0
package/dist/core/src/onboarding/agentsGuide.d.ts +32 -0
package/dist/core/src/onboarding/agentsGuide.js +164 -0
package/dist/core/src/onboarding/agentsGuide.js.map +1 -0
package/dist/core/src/validators/validateOpenWorkflow.js +1331 -15
package/dist/core/src/validators/validateOpenWorkflow.js.map +1 -1
package/dist/core/src/validators/validateRepositoryContracts.js +2321 -306
package/dist/core/src/validators/validateRepositoryContracts.js.map +1 -1
package/dist/core/src/workflow/cleanOpenWorkflow.d.ts +2 -0
package/dist/core/src/workflow/cleanOpenWorkflow.js +97 -8
package/dist/core/src/workflow/cleanOpenWorkflow.js.map +1 -1
package/dist/core/src/workflow/doctorOpenWorkflow.d.ts +7 -0
package/dist/core/src/workflow/doctorOpenWorkflow.js +26 -0
package/dist/core/src/workflow/doctorOpenWorkflow.js.map +1 -0
package/dist/core/src/workflow/initOpenWorkflow.d.ts +7 -0
package/dist/core/src/workflow/initOpenWorkflow.js +96 -8
package/dist/core/src/workflow/initOpenWorkflow.js.map +1 -1
package/dist/core/src/workflow/planningQueueResume.d.ts +105 -0
package/dist/core/src/workflow/planningQueueResume.js +596 -0
package/dist/core/src/workflow/planningQueueResume.js.map +1 -0
package/dist/core/src/workflow/readWorkflowConfig.d.ts +6 -0
package/dist/core/src/workflow/readWorkflowConfig.js +28 -0
package/dist/core/src/workflow/readWorkflowConfig.js.map +1 -0
package/dist/core/src/workflow/summaryHealth.d.ts +60 -0
package/dist/core/src/workflow/summaryHealth.js +713 -0
package/dist/core/src/workflow/summaryHealth.js.map +1 -0
package/dist/core/src/workflow/syncOpenWorkflow.d.ts +22 -0
package/dist/core/src/workflow/syncOpenWorkflow.js +235 -0
package/dist/core/src/workflow/syncOpenWorkflow.js.map +1 -0
package/package.json +2 -1
package/references/artifact-authoring-templates.md +14 -12
package/references/artifact-instruction-envelope.md +133 -0
package/references/coder-continuous-growth-loop.md +68 -0
package/references/gh-operation-governance.md +114 -0
package/references/git-automation-governance.md +324 -0
package/references/git-version-control-governance.md +227 -0
package/references/internal-coder-protocol.md +202 -0
package/references/issue-governance.md +115 -0
package/references/planning-artifact-contracts.md +595 -0
package/references/planning-skill-runtime-exposure.md +159 -0
package/references/proto-redesign-artifact-contracts.md +217 -0
package/references/proto2html-artifact-contracts.md +113 -0
package/references/skill-system-lifecycle.md +198 -0
package/references/validation-trust-domains.md +286 -0
package/references/workflow-blueprint-runtime-alignment.md +287 -0
package/schemas/atom-tasks.schema.json +101 -0
package/schemas/candidate-changes.schema.json +323 -0
package/schemas/current-state.schema.json +113 -0
package/schemas/html-prototype.schema.json +288 -0
package/schemas/openworkflow-contract.schema.json +9 -1
package/schemas/proto-prompt-pack.schema.json +1333 -0
package/schemas/prototype-evidence.schema.json +684 -142
package/schemas/selected-change.schema.json +104 -0
package/schemas/validation-target.schema.json +187 -1
package/schemas/validation.schema.json +187 -1
package/schemas/vision-session.schema.json +151 -0
package/skills/analyze-changes/SKILL.md +92 -0
package/skills/analyze-changes/agents/openai.yaml +4 -0
package/skills/analyze-changes/references/analysis-protocol.md +116 -0
package/skills/build-proto-prompt/SKILL.md +125 -0
package/skills/build-proto-prompt/references/output-boundary.md +54 -0
package/skills/build-proto-prompt/references/prompt-pack-compiler-protocol.md +80 -0
package/skills/build-prototype/SKILL.md +162 -38
package/skills/build-prototype/agents/openai.yaml +2 -2
package/skills/build-prototype/references/philosophy-engine.md +61 -0
package/skills/build-prototype/references/strategic-prompt-pack-protocol.md +365 -0
package/skills/build-prototype/references/vision2prompt/01_input_contract.md +84 -0
package/skills/build-prototype/references/vision2prompt/02_vision_decomposition.md +108 -0
package/skills/build-prototype/references/vision2prompt/03_strategy_hypothesis_generation.md +89 -0
package/skills/build-prototype/references/vision2prompt/04_product_system_extraction.md +78 -0
package/skills/build-prototype/references/vision2prompt/05_prototype_prompt_schema.md +189 -0
package/skills/build-prototype/references/vision2prompt/06_output_templates.md +125 -0
package/skills/build-prototype/references/vision2prompt/07_quality_rubric.md +171 -0
package/skills/build-validation/SKILL.md +136 -54
package/skills/build-validation/references/prototype-validation-target-rubric.md +35 -0
package/skills/build-validation/references/return-to-vision-gate.md +32 -0
package/skills/build-vision/SKILL.md +192 -0
package/skills/build-vision/references/proto-readiness-rubric.md +48 -0
package/skills/build-vision/references/vision-interview-protocol.md +48 -0
package/skills/coder/SKILL.md +204 -0
package/skills/decompose-to-changes/SKILL.md +176 -0
package/skills/decompose-to-changes/agents/openai.yaml +4 -0
package/skills/decompose-to-changes/references/decomposition-protocol.md +278 -0
package/skills/prompt2proto/SKILL.md +157 -0
package/skills/prompt2proto/agents/openai.yaml +4 -0
package/skills/prompt2proto/references/00_role_philosophy_engine.md +96 -0
package/skills/prompt2proto/references/01_input_contract.md +53 -0
package/skills/prompt2proto/references/02_prompt_pack_readiness.md +50 -0
package/skills/prompt2proto/references/03_visual_translation_workflow.md +64 -0
package/skills/prompt2proto/references/04_output_contract.md +67 -0
package/skills/prompt2proto/references/05_quality_rubric.md +46 -0
package/skills/proto2html/SKILL.md +136 -0
package/skills/proto2html/agents/openai.yaml +4 -0
package/skills/proto2html/references/proto2html-protocol.md +115 -0
package/skills/run-team/SKILL.md +4 -0
package/skills/select-change/SKILL.md +200 -0
package/skills/select-change/agents/openai.yaml +4 -0
package/skills/select-change/references/selection-protocol.md +281 -0
package/skills/tune-prototype/SKILL.md +121 -0
package/skills/tune-prototype/agents/openai.yaml +4 -0
package/skills/tune-prototype/references/refined-prompt-pack-protocol.md +161 -0

package/schemas/candidate-changes.schema.json ADDED Viewed

@@ -0,0 +1,323 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/candidate-changes.schema.json",
+  "title": "OpenWorkflow Candidate Changes",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "planning_artifact_type",
+    "plan_id",
+    "title",
+    "status",
+    "source",
+    "queue_policy",
+    "selection_policy",
+    "changes"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "planning"
+    },
+    "planning_artifact_type": {
+      "const": "candidate_changes"
+    },
+    "plan_id": {
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "active",
+        "completed",
+        "superseded",
+        "archived"
+      ]
+    },
+    "source": {
+      "type": "object"
+    },
+    "queue_policy": {
+      "type": "object",
+      "properties": {
+        "branch_boundary": {
+          "type": "string"
+        },
+        "source_of_truth": {
+          "type": "string"
+        },
+        "readable_view": {
+          "type": "string"
+        },
+        "id_policy": {
+          "type": "string"
+        },
+        "selected_change_commit_gate": {
+          "enum": [
+            "strict",
+            "migration"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "selection_policy": {
+      "type": "object"
+    },
+    "scope_control": {
+      "type": "object",
+      "properties": {
+        "current_boundary": {
+          "type": "string"
+        },
+        "boundary_type": {
+          "type": "string"
+        },
+        "in_scope_rule": {
+          "type": "string"
+        },
+        "out_of_scope_rule": {
+          "type": "string"
+        },
+        "deferred_features": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "title",
+              "reason"
+            ],
+            "properties": {
+              "title": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "suggested_plan_id": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "next_recommended_candidate_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "title",
+          "purpose",
+          "scope",
+          "owned_paths",
+          "dependencies",
+          "unlocks",
+          "risk",
+          "size",
+          "validation",
+          "acceptance"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Z][A-Z0-9]*[0-9]{3}$"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "candidate",
+              "ready",
+              "selected",
+              "in_progress",
+              "done",
+              "blocked",
+              "deferred",
+              "superseded"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "purpose": {
+            "type": "string"
+          },
+          "scope": {
+            "type": "object",
+            "required": [
+              "includes",
+              "excludes"
+            ]
+          },
+          "owned_paths": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "dependencies": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "unlocks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "risk": {
+            "type": "string"
+          },
+          "size": {
+            "type": "string"
+          },
+          "validation": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "acceptance": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "selection": {
+            "type": "object"
+          },
+          "completion": {
+            "type": "object",
+            "properties": {
+              "completed_by_change_id": {
+                "type": "string"
+              },
+              "completed_at": {
+                "type": "string"
+              },
+              "implementation_changed_files": {
+                "type": "boolean"
+              },
+              "commit_not_required_reason": {
+                "type": "string"
+              },
+              "local_commit_evidence": {
+                "type": "string"
+              },
+              "local_commit_evidence_path": {
+                "type": "string"
+              },
+              "evidence": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "validation": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "operation_id",
+          "operation_type",
+          "target_candidate_ids",
+          "actor",
+          "reason",
+          "changed_at"
+        ],
+        "properties": {
+          "operation_id": {
+            "type": "string",
+            "pattern": "^OP[0-9]{3}$"
+          },
+          "operation_type": {
+            "type": "string",
+            "enum": [
+              "query",
+              "add",
+              "update",
+              "status_change",
+              "split",
+              "merge",
+              "priority_change",
+              "select",
+              "complete",
+              "remove"
+            ]
+          },
+          "target_candidate_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "actor": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "changed_at": {
+            "type": "string"
+          },
+          "before_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "after_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/current-state.schema.json ADDED Viewed

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/current-state.schema.json",
+  "title": "OpenWorkflow Current State",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "title",
+    "status",
+    "active_stage",
+    "last_decision",
+    "next_command",
+    "blocked_by",
+    "read_this_first"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "const": "workflow:current-state"
+    },
+    "contract_type": {
+      "const": "workflow"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "active_stage": {
+      "type": "string"
+    },
+    "current_vision": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_validation": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_prototype": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_decision": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_design": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_spec": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_change": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "current_run": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "last_decision": {
+      "type": "object",
+      "required": [
+        "outcome",
+        "path"
+      ],
+      "additionalProperties": true
+    },
+    "next_command": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "blocked_by": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "read_this_first": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/html-prototype.schema.json ADDED Viewed

@@ -0,0 +1,288 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/html-prototype.schema.json",
+  "title": "OpenWorkflow HTML Prototype Artifact",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "artifact_type",
+    "title",
+    "status",
+    "source_prototype",
+    "benchmark",
+    "reconstruction_scope",
+    "html_artifact",
+    "render_targets",
+    "fidelity",
+    "known_limits",
+    "result",
+    "handoff"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "html_prototype"
+    },
+    "artifact_type": {
+      "const": "html_prototype"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "active",
+        "reviewed",
+        "accepted",
+        "superseded",
+        "archived"
+      ]
+    },
+    "source_prototype": {
+      "type": "object",
+      "required": [
+        "evidence_ref",
+        "accepted_decision_ref"
+      ],
+      "properties": {
+        "evidence_ref": {
+          "type": "string"
+        },
+        "prompt_pack_ref": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "accepted_decision_ref": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "benchmark": {
+      "type": "object",
+      "required": [
+        "kind",
+        "refs"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "benchmark_image",
+            "image_set",
+            "screen_group"
+          ]
+        },
+        "refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "selected_ref": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "acceptance_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "reconstruction_scope": {
+      "type": "object",
+      "required": [
+        "include",
+        "exclude"
+      ],
+      "properties": {
+        "include": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "exclude": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "html_artifact": {
+      "type": "object",
+      "required": [
+        "path",
+        "type",
+        "entrypoint"
+      ],
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "type": {
+          "const": "single_file_html"
+        },
+        "entrypoint": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "render_targets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "target_id",
+          "width",
+          "height"
+        ],
+        "properties": {
+          "target_id": {
+            "type": "string"
+          },
+          "width": {
+            "type": "number"
+          },
+          "height": {
+            "type": "number"
+          },
+          "device": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "fidelity": {
+      "type": "object",
+      "required": [
+        "benchmark_refs",
+        "screenshot_refs",
+        "matched_elements",
+        "gaps"
+      ],
+      "properties": {
+        "benchmark_refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "screenshot_refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "matched_elements": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "gaps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "gap_id",
+              "severity",
+              "description"
+            ],
+            "properties": {
+              "gap_id": {
+                "type": "string"
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "low",
+                  "medium",
+                  "high",
+                  "blocking"
+                ]
+              },
+              "description": {
+                "type": "string"
+              },
+              "disposition": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "browser_checks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "implementation_notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "known_limits": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "result": {
+      "type": "string",
+      "enum": [
+        "accepted",
+        "needs_reconstruction",
+        "return_to_tune",
+        "blocked"
+      ]
+    },
+    "handoff": {
+      "type": "object",
+      "required": [
+        "next_command"
+      ],
+      "properties": {
+        "next_command": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}