dreative 0.5.1 → 0.5.3

package/skill/dreative/schemas/plan.schema.json

@@ -0,0 +1,309 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dreative.local/schemas/plan.schema.json",
+  "title": "Dreative Multi-Page Direct Design Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "request", "createdAt", "tier", "depth", "skills", "skillPolicy", "designRead", "pages", "preservationManifest", "decisionLedger"],
+  "properties": {
+    "version": { "const": 2 },
+    "doctrineVersion": { "const": 2 },
+    "request": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "tier": { "enum": ["solid", "premium", "expressive", "award"] },
+    "depth": { "enum": ["restyle", "relayout", "restructure", "reimagine"] },
+    "skills": { "$ref": "#/$defs/skillList" },
+    "skillPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "global", "routingApproved", "userAssignments"],
+      "properties": {
+        "mode": { "const": "hybrid" },
+        "global": { "$ref": "#/$defs/skillList" },
+        "routingApproved": { "const": true },
+        "userAssignments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["pageId", "skills"],
+            "properties": {
+              "pageId": { "type": "string", "minLength": 1 },
+              "skills": { "$ref": "#/$defs/treatmentList" }
+            }
+          }
+        }
+      }
+    },
+    "designRead": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["register", "concept", "signature"],
+      "properties": {
+        "register": { "type": "string", "minLength": 1 },
+        "concept": { "type": "string", "minLength": 1 },
+        "signature": { "type": "string", "minLength": 1 }
+      }
+    },
+    "implementationStartedAt": { "type": "string", "format": "date-time" },
+    "ruleExceptions": { "type": "array", "items": { "$ref": "#/$defs/ruleException" } },
+    "creativeStrategy": { "$ref": "#/$defs/creativeStrategy" },
+    "motionComplexityBudget": { "$ref": "#/$defs/motionComplexityBudget" },
+    "fontDecision": { "$ref": "#/$defs/fontDecision" },
+    "experimentalPlan": { "$ref": "#/$defs/experimentalPlan" },
+    "conceptExploration": { "$ref": "#/$defs/conceptExploration" },
+    "recipeAccess": { "type": "array", "items": { "$ref": "#/$defs/recipeAccess" } },
+    "pages": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/page" } },
+    "preservationManifest": { "type": "string", "minLength": 1 },
+    "decisionLedger": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "skill": { "enum": ["ux", "mobile", "refined", "motion", "interaction", "media", "3d", "immersive", "cinematic", "experimental"] },
+    "skillList": {
+      "type": "array",
+      "uniqueItems": true,
+      "allOf": [{ "contains": { "const": "ux" } }, { "contains": { "const": "mobile" } }],
+      "items": { "$ref": "#/$defs/skill" }
+    },
+    "treatmentList": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/skill" }
+    },
+    "status": { "enum": ["planned", "shipped", "fallback", "cut"] },
+    "ruleException": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ruleId", "decision", "declaredAt", "reason", "alternative", "successCriteria", "evidenceIds"],
+      "properties": {
+        "ruleId": { "type": "string", "minLength": 1 },
+        "decision": { "const": "substituted" },
+        "declaredAt": { "type": "string", "format": "date-time" },
+        "reason": { "type": "string", "minLength": 20 },
+        "alternative": { "type": "string", "minLength": 30 },
+        "successCriteria": { "type": "array", "minItems": 2, "items": { "type": "string", "minLength": 12 } },
+        "evidenceIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "creativeStrategy": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "mechanisms", "drivers"],
+          "properties": {
+            "path": { "const": "diversity" },
+            "mechanisms": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "drivers": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "signatureMechanism", "states", "secondaryMechanisms", "drivers"],
+          "properties": {
+            "path": { "const": "development" },
+            "signatureMechanism": { "type": "string", "minLength": 1 },
+            "states": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "type": "string", "minLength": 12 } },
+            "secondaryMechanisms": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "drivers": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+          }
+        }
+      ]
+    },
+    "motionComplexityBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["heroMoments", "calmSectionIds", "sharedLanguage", "deviceLimits", "progressiveEnhancement", "antiDefaultReview"],
+      "properties": {
+        "heroMoments": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["sectionId", "reason"],
+            "properties": {
+              "sectionId": { "type": "string", "minLength": 1 },
+              "reason": { "type": "string", "minLength": 20 }
+            }
+          }
+        },
+        "calmSectionIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "sharedLanguage": { "type": "string", "minLength": 20 },
+        "deviceLimits": { "type": "string", "minLength": 20 },
+        "progressiveEnhancement": { "type": "string", "minLength": 20 },
+        "antiDefaultReview": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["basicMotionAssessment", "compositionHandoff", "visualStateChange", "conceptSpecificity", "memorableMoment"],
+          "properties": {
+            "basicMotionAssessment": { "type": "string", "minLength": 20 },
+            "compositionHandoff": { "type": "string", "minLength": 20 },
+            "visualStateChange": { "type": "string", "minLength": 20 },
+            "conceptSpecificity": { "type": "string", "minLength": 20 },
+            "memorableMoment": { "type": "string", "minLength": 20 }
+          }
+        }
+      }
+    },
+    "fontDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["selected", "candidates", "recentDisplayFonts"],
+      "properties": {
+        "selected": { "type": "string", "minLength": 1 },
+        "candidates": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "reflex", "rationale"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "reflex": { "type": "boolean" },
+              "rationale": { "type": "string", "minLength": 12 }
+            }
+          }
+        },
+        "recentDisplayFonts": { "type": "array", "maxItems": 3, "items": { "type": "string" } },
+        "reasonKinds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": ["existing-brand", "design-system-metrics", "product-register", "supplied-reference", "language-coverage", "variable-font-capability", "performance", "physical-editorial-historical-reference"]
+          }
+        },
+        "justification": { "type": "string", "minLength": 20 },
+        "repeatJustification": { "type": "string", "minLength": 20 }
+      }
+    },
+    "experimentalPlan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["majorSectionIds", "candidates"],
+      "properties": {
+        "majorSectionIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "candidates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "sectionId", "idea", "selected"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "sectionId": { "type": "string", "minLength": 1 },
+              "idea": { "type": "string", "minLength": 20 },
+              "selected": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    },
+    "conceptExploration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["recordedAt", "concepts"],
+      "properties": {
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "concepts": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "concept", "brandConnection"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "concept": { "type": "string", "minLength": 20 },
+              "brandConnection": { "type": "string", "minLength": 20 }
+            }
+          }
+        }
+      }
+    },
+    "recipeAccess": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["file", "loadedAt", "purpose"],
+      "properties": {
+        "file": { "type": "string", "minLength": 1 },
+        "loadedAt": { "type": "string", "format": "date-time" },
+        "purpose": { "enum": ["feasibility", "implementation", "performance", "fallback", "concept-repair"] }
+      }
+    },
+    "asset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "purpose", "importance", "preparation", "status"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "purpose": { "type": "string", "minLength": 1 },
+        "importance": { "enum": ["supporting", "key"] },
+        "preparation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["decision", "derivatives", "rationale"],
+          "properties": {
+            "decision": { "enum": ["flat", "decompose", "variants", "sequence"] },
+            "derivatives": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "rationale": { "type": "string", "minLength": 12 }
+          }
+        },
+        "status": { "$ref": "#/$defs/status" },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    },
+    "section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "layoutFamily", "skills", "interactions", "mobile", "fallback", "verification", "assets", "status"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "layoutFamily": { "type": "string", "minLength": 1 },
+        "skills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/skill" } },
+        "interactions": { "type": "array", "items": { "type": "string" } },
+        "motionTreatment": { "$ref": "#/$defs/motionTreatment" },
+        "mobile": { "type": "string", "minLength": 1 },
+        "fallback": { "type": "string", "minLength": 1 },
+        "verification": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "assets": { "type": "array", "items": { "$ref": "#/$defs/asset" } },
+        "status": { "$ref": "#/$defs/status" },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    },
+    "motionTreatment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["class", "staticComposition", "startState", "endState", "changes", "pinnedElements", "handoff", "purpose", "mechanism", "mobile", "reducedMotion"],
+      "properties": {
+        "class": { "enum": ["none", "decorative", "structural", "transformational"] },
+        "staticComposition": { "type": "string", "minLength": 12 },
+        "startState": { "type": "string", "minLength": 12 },
+        "endState": { "type": "string", "minLength": 12 },
+        "changes": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "pinnedElements": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "handoff": { "type": "string", "minLength": 12 },
+        "purpose": { "type": "string", "minLength": 12 },
+        "mechanism": { "type": "string", "minLength": 12 },
+        "mobile": { "type": "string", "minLength": 12 },
+        "reducedMotion": { "type": "string", "minLength": 12 }
+      }
+    },
+    "page": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "skills", "sections"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "skills": { "$ref": "#/$defs/skillList" },
+        "sections": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/section" } }
+      }
+    }
+  }
+}

package/skill/dreative/schemas/verify.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dreative.local/schemas/verify.schema.json",
+  "title": "Dreative Verification Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "generatedAt", "evidence"],
+  "properties": {
+    "version": { "const": 1 },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "criterion", "status", "evidence", "proof"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "criterion": { "type": "string", "minLength": 1 },
+          "status": { "enum": ["pass", "fail", "not-applicable"] },
+          "evidence": { "type": "string", "minLength": 1 },
+          "timelineState": {
+            "enum": ["initial", "early", "mid-transition", "final", "handoff", "pinned-midpoint", "pinned-exit", "mobile", "reduced-motion"]
+          },
+          "proof": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["timestamp"],
+            "properties": {
+              "timestamp": { "type": "string", "format": "date-time" },
+              "artifactPath": { "type": "string", "minLength": 1 },
+              "viewport": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["width", "height"],
+                "properties": {
+                  "width": { "type": "number", "exclusiveMinimum": 0 },
+                  "height": { "type": "number", "exclusiveMinimum": 0 },
+                  "dpr": { "type": "number", "exclusiveMinimum": 0 }
+                }
+              },
+              "command": { "type": "string", "minLength": 1 },
+              "exitCode": { "type": "integer" },
+              "consoleErrorCount": { "type": "integer", "minimum": 0 },
+              "testedUrl": { "type": "string", "minLength": 1 },
+              "averageFps": { "type": "number", "exclusiveMinimum": 0 },
+              "maxFrameTimeMs": { "type": "number", "minimum": 0 },
+              "playwrightTestId": { "type": "string", "minLength": 1 }
+            },
+            "anyOf": [
+              { "required": ["artifactPath"] },
+              { "required": ["command", "exitCode"] },
+              { "required": ["consoleErrorCount"] },
+              { "required": ["testedUrl"] },
+              { "required": ["averageFps"] },
+              { "required": ["maxFrameTimeMs"] },
+              { "required": ["playwrightTestId"] }
+            ]
+          }
+        }
+      }
+    },
+    "refinement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["inspectedAt", "findings", "changes", "evidenceIds"],
+      "properties": {
+        "inspectedAt": { "type": "string", "format": "date-time" },
+        "findings": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "changes": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "evidenceIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
+    }
+  }
+}