@tiic-tech/openworkflow 0.1.0

package/schemas/product-design.schema.json

@@ -0,0 +1,356 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/product-design.schema.json",
+  "title": "OpenWorkflow Product Design Artifact",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "artifact_type",
+    "title",
+    "status",
+    "accepted_prototype_evidence",
+    "personas",
+    "journey_map",
+    "user_stories",
+    "feature_matrix",
+    "kano_classification",
+    "behavior_model",
+    "ux_states",
+    "scope",
+    "open_questions",
+    "conditional_packets",
+    "spec_readiness"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "design"
+    },
+    "artifact_type": {
+      "const": "product_design"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "accepted_prototype_evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "ref",
+          "decision_ref",
+          "accepted_outcome"
+        ],
+        "properties": {
+          "ref": {
+            "type": "string"
+          },
+          "decision_ref": {
+            "type": "string"
+          },
+          "accepted_outcome": {
+            "type": "string",
+            "enum": [
+              "continue",
+              "accepted"
+            ]
+          },
+          "notes": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "personas": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "goals",
+          "pain_points"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "goals": {
+            "$ref": "#/$defs/stringList"
+          },
+          "pain_points": {
+            "$ref": "#/$defs/stringList"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "journey_map": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "stage",
+          "user_goal",
+          "actions",
+          "system_response"
+        ],
+        "properties": {
+          "stage": {
+            "type": "string"
+          },
+          "user_goal": {
+            "type": "string"
+          },
+          "actions": {
+            "$ref": "#/$defs/stringList"
+          },
+          "system_response": {
+            "$ref": "#/$defs/stringList"
+          },
+          "risks": {
+            "$ref": "#/$defs/stringList"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "user_stories": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "persona",
+          "story",
+          "acceptance"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "persona": {
+            "type": "string"
+          },
+          "story": {
+            "type": "string"
+          },
+          "acceptance": {
+            "$ref": "#/$defs/stringList"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "feature_matrix": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "feature",
+          "priority",
+          "evidence_refs",
+          "included"
+        ],
+        "properties": {
+          "feature": {
+            "type": "string"
+          },
+          "priority": {
+            "type": "string"
+          },
+          "evidence_refs": {
+            "$ref": "#/$defs/stringList"
+          },
+          "included": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "kano_classification": {
+      "type": "object",
+      "required": [
+        "must_have",
+        "performance",
+        "delighters",
+        "indifferent",
+        "reverse"
+      ],
+      "properties": {
+        "must_have": {
+          "$ref": "#/$defs/stringList"
+        },
+        "performance": {
+          "$ref": "#/$defs/stringList"
+        },
+        "delighters": {
+          "$ref": "#/$defs/stringList"
+        },
+        "indifferent": {
+          "$ref": "#/$defs/stringList"
+        },
+        "reverse": {
+          "$ref": "#/$defs/stringList"
+        }
+      },
+      "additionalProperties": true
+    },
+    "behavior_model": {
+      "type": "object",
+      "required": [
+        "entities",
+        "states",
+        "transitions",
+        "rules"
+      ],
+      "properties": {
+        "entities": {
+          "$ref": "#/$defs/stringList"
+        },
+        "states": {
+          "$ref": "#/$defs/stringList"
+        },
+        "transitions": {
+          "$ref": "#/$defs/stringList"
+        },
+        "rules": {
+          "$ref": "#/$defs/stringList"
+        }
+      },
+      "additionalProperties": true
+    },
+    "ux_states": {
+      "type": "object",
+      "required": [
+        "empty",
+        "loading",
+        "success",
+        "error",
+        "edge_cases"
+      ],
+      "properties": {
+        "empty": {
+          "$ref": "#/$defs/stringList"
+        },
+        "loading": {
+          "$ref": "#/$defs/stringList"
+        },
+        "success": {
+          "$ref": "#/$defs/stringList"
+        },
+        "error": {
+          "$ref": "#/$defs/stringList"
+        },
+        "edge_cases": {
+          "$ref": "#/$defs/stringList"
+        }
+      },
+      "additionalProperties": true
+    },
+    "scope": {
+      "type": "object",
+      "required": [
+        "in",
+        "out",
+        "deferred"
+      ],
+      "properties": {
+        "in": {
+          "$ref": "#/$defs/stringList"
+        },
+        "out": {
+          "$ref": "#/$defs/stringList"
+        },
+        "deferred": {
+          "$ref": "#/$defs/stringList"
+        }
+      },
+      "additionalProperties": true
+    },
+    "open_questions": {
+      "$ref": "#/$defs/stringList"
+    },
+    "conditional_packets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "artifact_type",
+          "path",
+          "included",
+          "reason"
+        ],
+        "properties": {
+          "artifact_type": {
+            "type": "string",
+            "enum": [
+              "tech_spec",
+              "frontend_spec",
+              "backend_spec",
+              "api_contract",
+              "db_schema_model"
+            ]
+          },
+          "path": {
+            "type": "string"
+          },
+          "included": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "spec_readiness": {
+      "type": "object",
+      "required": [
+        "ready",
+        "blockers",
+        "next_command"
+      ],
+      "properties": {
+        "ready": {
+          "type": "boolean"
+        },
+        "blockers": {
+          "$ref": "#/$defs/stringList"
+        },
+        "next_command": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "stringList": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/prototype-evidence.schema.json

@@ -0,0 +1,325 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openworkflow.local/schemas/prototype-evidence.schema.json",
+  "title": "OpenWorkflow Prototype Evidence Artifact",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "contract_id",
+    "contract_type",
+    "artifact_type",
+    "title",
+    "status",
+    "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",
+    "result",
+    "handoff"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string"
+    },
+    "contract_id": {
+      "type": "string"
+    },
+    "contract_type": {
+      "const": "prototype"
+    },
+    "artifact_type": {
+      "const": "prototype_evidence"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    },
+    "validation_target": {
+      "type": "string"
+    },
+    "core_question": {
+      "type": "string"
+    },
+    "prototype_mode": {
+      "type": "string",
+      "enum": [
+        "visual",
+        "interaction",
+        "technical_feasibility",
+        "3d_material",
+        "workflow",
+        "data_logic"
+      ]
+    },
+    "reference_analysis": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "ref"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          },
+          "patterns": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "anti_patterns": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "visual_direction": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "summary": {
+          "type": "string"
+        },
+        "tokens": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "visual_concept_policy": {
+      "type": "object",
+      "required": [
+        "image_generation",
+        "skip_reason"
+      ],
+      "properties": {
+        "image_generation": {
+          "type": "string",
+          "enum": [
+            "generated",
+            "skipped_by_user",
+            "not_applicable"
+          ]
+        },
+        "skip_reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "concept_evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "ref"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "prototype_artifact": {
+      "type": "object",
+      "required": [
+        "path",
+        "type"
+      ],
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "run": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "implementation_evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "ref"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          }
+        },
+        "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
+      }
+    },
+    "verification": {
+      "type": "object",
+      "properties": {
+        "browser_checks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "screenshots": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "logs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "self_critique": {
+      "type": "object",
+      "required": [
+        "philosophy",
+        "hierarchy",
+        "execution",
+        "specificity",
+        "restraint",
+        "accessibility",
+        "responsive_behavior",
+        "repairs"
+      ],
+      "properties": {
+        "philosophy": {
+          "type": "string"
+        },
+        "hierarchy": {
+          "type": "string"
+        },
+        "execution": {
+          "type": "string"
+        },
+        "specificity": {
+          "type": "string"
+        },
+        "restraint": {
+          "type": "string"
+        },
+        "accessibility": {
+          "type": "string"
+        },
+        "responsive_behavior": {
+          "type": "string"
+        },
+        "repairs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "known_limits": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "result": {
+      "type": "string",
+      "enum": [
+        "pass",
+        "fail",
+        "unclear",
+        "not_reviewed"
+      ]
+    },
+    "handoff": {
+      "type": "object",
+      "required": [
+        "next_command"
+      ],
+      "properties": {
+        "next_command": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}