@tiic-tech/openworkflow 0.1.0 → 0.1.2

package/schemas/prototype-evidence.schema.json

@@ -13,18 +13,21 @@
     "validation_target",
     "core_question",
     "prototype_mode",
-    "reference_analysis",
-    "visual_direction",
-    "visual_concept_policy",
-    "concept_evidence",
-    "prototype_artifact",
-    "run",
-    "implementation_evidence",
-    "observations",
-    "evidence",
-    "verification",
-    "self_critique",
-    "known_limits",
+    "prompt_pack_type",
+    "validation_input",
+    "source",
+    "internal_pipeline",
+    "preflight_quality_gate",
+    "direction_count_policy",
+    "normalized_input",
+    "strategic_core",
+    "directions",
+    "build_recommendation",
+    "prompt_text_manifest",
+    "post_validate",
+    "image_generation",
+    "negative_constraints",
+    "review_plan",
     "result",
     "handoff"
   ],
@@ -48,251 +51,790 @@
       "type": "string"
     },
     "validation_target": {
-      "type": "string"
+      "type": [
+        "string",
+        "null"
+      ]
     },
     "core_question": {
       "type": "string"
     },
     "prototype_mode": {
+      "const": "image_prompt_pack"
+    },
+    "prompt_pack_type": {
       "type": "string",
       "enum": [
-        "visual",
-        "interaction",
-        "technical_feasibility",
-        "3d_material",
-        "workflow",
-        "data_logic"
+        "strategic_proto_prompt_pack",
+        "refined_proto_prompt_pack",
+        "proto_review_evidence"
       ]
     },
-    "reference_analysis": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "kind",
-          "ref"
-        ],
-        "properties": {
-          "kind": {
+    "validation_input": {
+      "type": "object",
+      "required": [
+        "mode",
+        "refs"
+      ],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "validation_present",
+            "agent_auto_generated"
+          ]
+        },
+        "refs": {
+          "type": "array",
+          "items": {
             "type": "string"
-          },
-          "ref": {
+          }
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "source": {
+      "type": "object",
+      "properties": {
+        "refs": {
+          "type": "array",
+          "items": {
             "type": "string"
-          },
-          "patterns": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "anti_patterns": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
           }
         },
-        "additionalProperties": true
-      }
+        "target_tool": {
+          "type": "string"
+        },
+        "output_language": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "preflight_quality_gate": {
+      "type": "object",
+      "required": [
+        "vision_status",
+        "validation_status",
+        "can_proceed",
+        "blockers",
+        "next_command_when_blocked"
+      ],
+      "additionalProperties": true
     },
-    "visual_direction": {
+    "internal_pipeline": {
       "type": "object",
+      "required": [
+        "orchestrator_command",
+        "user_visible_command",
+        "current_stage",
+        "stages"
+      ],
+      "additionalProperties": true
+    },
+    "direction_count_policy": {
+      "type": "object",
+      "required": [
+        "requested_count",
+        "resolved_count",
+        "source",
+        "ask_user_question_required"
+      ],
+      "additionalProperties": true
+    },
+    "normalized_input": {
+      "type": "object",
+      "required": [
+        "product_domain",
+        "primary_user",
+        "usage_context",
+        "current_alternative",
+        "core_pain",
+        "desired_behavior_change",
+        "strongest_success_signal",
+        "core_differentiator",
+        "emotional_value",
+        "functional_value",
+        "trust_requirements",
+        "privacy_requirements",
+        "non_goals",
+        "future_opportunities",
+        "validation_target"
+      ],
+      "additionalProperties": true
+    },
+    "strategic_core": {
+      "type": "object",
+      "required": [
+        "target_user",
+        "behavior_change",
+        "mechanism",
+        "differentiator",
+        "boundary_conditions",
+        "central_uncertainty"
+      ],
+      "additionalProperties": true
+    },
+    "product_experience_model": {
+      "type": "object",
+      "required": [
+        "product_archetype",
+        "primary_canvas",
+        "information_architecture",
+        "domain_object_model",
+        "primary_task_loop",
+        "interaction_state_model",
+        "data_realism_requirements",
+        "visual_language",
+        "anti_generic_constraints"
+      ],
       "properties": {
-        "source": {
-          "type": [
-            "string",
-            "null"
-          ]
+        "product_archetype": {
+          "type": "string"
         },
-        "summary": {
+        "primary_canvas": {
           "type": "string"
         },
-        "tokens": {
-          "type": "object",
-          "additionalProperties": {
+        "information_architecture": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "domain_object_model": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "primary_task_loop": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "interaction_state_model": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "data_realism_requirements": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "visual_language": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "anti_generic_constraints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "category_quality_bar": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "prototype_system_contract": {
+      "type": "object",
+      "required": [
+        "stable_app_shell",
+        "navigation_taxonomy",
+        "data_vocabulary",
+        "domain_object_anatomy",
+        "object_detail_anatomy",
+        "action_bar_contract",
+        "audit_trust_pattern",
+        "copy_tone",
+        "allowed_screen_deltas"
+      ],
+      "properties": {
+        "stable_app_shell": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "navigation_taxonomy": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "data_vocabulary": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "domain_object_anatomy": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "object_detail_anatomy": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "action_bar_contract": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "audit_trust_pattern": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "copy_tone": {
+          "type": "string"
+        },
+        "allowed_screen_deltas": {
+          "type": "array",
+          "items": {
             "type": "string"
           }
         }
       },
       "additionalProperties": true
     },
-    "visual_concept_policy": {
+    "prototype_reality_gate": {
       "type": "object",
       "required": [
-        "image_generation",
-        "skip_reason"
+        "status",
+        "trigger",
+        "required_when_prompt_text_ready",
+        "dimensions",
+        "failures",
+        "outcome_notes",
+        "repair_route"
       ],
       "properties": {
-        "image_generation": {
+        "status": {
           "type": "string",
           "enum": [
-            "generated",
-            "skipped_by_user",
-            "not_applicable"
+            "pending",
+            "pass",
+            "fail"
           ]
         },
-        "skip_reason": {
-          "type": [
-            "string",
-            "null"
+        "trigger": {
+          "const": "before_image_generation"
+        },
+        "required_when_prompt_text_ready": {
+          "type": "boolean"
+        },
+        "dimensions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "product_category_fit",
+              "primary_canvas_fit",
+              "domain_object_realism",
+              "task_loop_completeness",
+              "interaction_state_coverage",
+              "data_realism",
+              "anti_generic_constraints"
+            ]
+          }
+        },
+        "failures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "outcome_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "repair_route": {
+          "const": "/ow:vision2prompt"
+        }
+      },
+      "additionalProperties": true
+    },
+    "prompt_pack_integrity_gate": {
+      "type": "object",
+      "required": [
+        "status",
+        "trigger",
+        "required_when_prompt_text_ready",
+        "dimensions",
+        "failures",
+        "outcome_notes",
+        "repair_route"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "pass",
+            "fail"
           ]
+        },
+        "trigger": {
+          "const": "before_image_generation"
+        },
+        "required_when_prompt_text_ready": {
+          "type": "boolean"
+        },
+        "dimensions": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "direction_count_matches",
+              "prompt_text_refs_resolve",
+              "generated_image_refs_resolve"
+            ]
+          }
+        },
+        "failures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "outcome_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "repair_route": {
+          "const": "/ow:vision2prompt"
         }
       },
       "additionalProperties": true
     },
-    "concept_evidence": {
+    "directions": {
       "type": "array",
       "items": {
         "type": "object",
         "required": [
-          "kind",
-          "ref"
+          "direction_id",
+          "name",
+          "strategic_hypothesis",
+          "validates",
+          "main_risk",
+          "distinctness_rationale",
+          "prototype_prompt",
+          "screen_prompts"
         ],
-        "properties": {
-          "kind": {
-            "type": "string"
-          },
-          "ref": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
         "additionalProperties": true
       }
     },
-    "prototype_artifact": {
+    "build_recommendation": {
       "type": "object",
       "required": [
-        "path",
-        "type"
+        "first_direction_id",
+        "why_first",
+        "success_signals",
+        "failure_signals",
+        "next_test_if_it_works"
+      ],
+      "additionalProperties": true
+    },
+    "tune_input": {
+      "type": "object",
+      "required": [
+        "baseline_source_type",
+        "baseline_refs",
+        "tune_request",
+        "regeneration_scope"
+      ],
+      "additionalProperties": true
+    },
+    "baseline_resolution": {
+      "type": "object",
+      "required": [
+        "latest_approved_baseline_group_id",
+        "latest_approved_baseline_ref",
+        "baseline_lineage",
+        "resolution_rule",
+        "stale_source_guard"
       ],
       "properties": {
-        "path": {
+        "latest_approved_baseline_group_id": {
           "type": "string"
         },
-        "type": {
+        "latest_approved_baseline_ref": {
+          "type": "string"
+        },
+        "baseline_lineage": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resolution_rule": {
+          "type": "string"
+        },
+        "stale_source_guard": {
           "type": "string"
         }
       },
       "additionalProperties": true
     },
-    "run": {
+    "carry_forward": {
       "type": "object",
+      "required": [
+        "locked_screens",
+        "locked_elements",
+        "preserved_improvements",
+        "explicit_unlocks",
+        "cumulative_drift_guard"
+      ],
+      "properties": {
+        "locked_screens": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "locked_elements": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "preserved_improvements": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "explicit_unlocks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "cumulative_drift_guard": {
+          "type": "string"
+        }
+      },
       "additionalProperties": true
     },
-    "implementation_evidence": {
+    "baseline_audit": {
       "type": "array",
       "items": {
         "type": "object",
         "required": [
-          "kind",
-          "ref"
+          "source_screen_id",
+          "screen_name",
+          "journey_stage",
+          "user_goal",
+          "system_state",
+          "components",
+          "must_preserve"
         ],
-        "properties": {
-          "kind": {
+        "additionalProperties": true
+      }
+    },
+    "product_system": {
+      "type": "object",
+      "required": [
+        "product_thesis",
+        "primary_loop",
+        "component_vocabulary",
+        "copywriting_style",
+        "trust_and_boundary_system",
+        "stable_constants",
+        "adaptable_variables"
+      ],
+      "additionalProperties": true
+    },
+    "delta_rules": {
+      "type": "object",
+      "properties": {
+        "must_inherit": {
+          "type": "array",
+          "items": {
             "type": "string"
-          },
-          "ref": {
+          }
+        },
+        "must_add": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "must_remove": {
+          "type": "array",
+          "items": {
             "type": "string"
           }
         },
+        "flexible_change": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "screen_delta_matrix": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "target_screen_id",
+          "source_screen_ids",
+          "preserve",
+          "add",
+          "remove",
+          "transform",
+          "flexible",
+          "acceptance_criteria"
+        ],
         "additionalProperties": true
       }
     },
-    "observations": {
+    "screen_manifest": {
       "type": "array",
       "items": {
-        "type": "string"
+        "type": "object",
+        "required": [
+          "target_screen_id",
+          "source_screen_ids",
+          "screen_name",
+          "generation_scope"
+        ],
+        "additionalProperties": true
       }
     },
-    "evidence": {
+    "global_design_prompt": {
+      "type": "string"
+    },
+    "screen_prompts": {
       "type": "array",
       "items": {
         "type": "object",
         "required": [
-          "kind",
-          "ref"
+          "prompt_id",
+          "target_screen_id",
+          "source_screen_ids",
+          "screen_name",
+          "image_role",
+          "prompt",
+          "negative_prompt",
+          "acceptance_criteria"
         ],
-        "properties": {
-          "kind": {
-            "type": "string"
-          },
-          "ref": {
-            "type": "string"
-          }
-        },
         "additionalProperties": true
       }
     },
-    "verification": {
+    "generation_order": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "acceptance_checklist": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "prompt_text_manifest": {
       "type": "object",
+      "required": [
+        "status",
+        "directions_ready",
+        "direction_count",
+        "prompt_text_refs"
+      ],
       "properties": {
-        "browser_checks": {
+        "paragraph_quality_status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "pass",
+            "fail"
+          ]
+        },
+        "paragraph_quality_dimensions": {
           "type": "array",
           "items": {
             "type": "string"
           }
+        }
+      },
+      "additionalProperties": true
+    },
+    "post_validate": {
+      "type": "object",
+      "required": [
+        "status",
+        "trigger",
+        "required_when_direction_count_gte",
+        "skip_when_resolved_count",
+        "threshold_policy",
+        "fingerprint_dimensions",
+        "comparisons",
+        "failures",
+        "outcome_notes",
+        "repair_route"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "pending",
+            "pass",
+            "fail",
+            "skipped"
+          ]
+        },
+        "trigger": {
+          "const": "after_prompt_assets_ready"
+        },
+        "required_when_direction_count_gte": {
+          "type": "number",
+          "minimum": 2
+        },
+        "skip_when_resolved_count": {
+          "type": "number",
+          "const": 1
         },
-        "screenshots": {
+        "threshold_policy": {
+          "type": "object",
+          "required": [
+            "method",
+            "max_pairwise_similarity",
+            "comparison"
+          ],
+          "additionalProperties": true
+        },
+        "fingerprint_dimensions": {
           "type": "array",
           "items": {
             "type": "string"
           }
         },
-        "logs": {
+        "comparisons": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "failures": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "outcome_notes": {
           "type": "array",
           "items": {
             "type": "string"
           }
+        },
+        "repair_route": {
+          "const": "/ow:vision2prompt"
         }
       },
       "additionalProperties": true
     },
-    "self_critique": {
+    "image_generation": {
       "type": "object",
       "required": [
-        "philosophy",
-        "hierarchy",
-        "execution",
-        "specificity",
-        "restraint",
-        "accessibility",
-        "responsive_behavior",
-        "repairs"
+        "status",
+        "batch_strategy",
+        "generated_images",
+        "collection_notes"
       ],
       "properties": {
-        "philosophy": {
-          "type": "string"
-        },
-        "hierarchy": {
-          "type": "string"
-        },
-        "execution": {
-          "type": "string"
-        },
-        "specificity": {
-          "type": "string"
-        },
-        "restraint": {
-          "type": "string"
-        },
-        "accessibility": {
-          "type": "string"
-        },
-        "responsive_behavior": {
-          "type": "string"
-        },
-        "repairs": {
+        "generated_images": {
           "type": "array",
           "items": {
-            "type": "string"
+            "type": "object",
+            "required": [
+              "image_id",
+              "direction_id",
+              "prompt_id",
+              "screen_name",
+              "path",
+              "metadata"
+            ],
+            "additionalProperties": true
           }
         }
       },
       "additionalProperties": true
     },
+    "negative_constraints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "review_plan": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "observations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "ref"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "generated_images": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
     "known_limits": {
       "type": "array",
       "items": {