create-yss-spec 3.5.6 → 3.5.9

package/template/.template-spec/process/schemas/strategic-handoff-stage-decision-package-v3.schema.json

@@ -3,144 +3,617 @@
   "$id": "https://yss.local/schemas/strategic-handoff-stage-decision-package-v3.json",
   "title": "YSS Stage Decision Package",
   "type": "object",
-  "required": ["schema_version", "stage_decision_id", "package_version", "status", "problem_statement", "target_users", "mvp", "non_goals", "success_criteria", "test_seams", "confirmed_decisions", "assumptions", "constraints", "unresolved_items", "context_snapshot", "domain_strategy_ref", "impact_assessment", "downstream_mapping", "evidence_refs", "approval"],
+  "required": [
+    "schema_version",
+    "stage_decision_id",
+    "package_version",
+    "status",
+    "problem_statement",
+    "target_users",
+    "mvp",
+    "non_goals",
+    "success_criteria",
+    "test_seams",
+    "confirmed_decisions",
+    "assumptions",
+    "constraints",
+    "unresolved_items",
+    "context_snapshot",
+    "domain_strategy_ref",
+    "impact_assessment",
+    "downstream_mapping",
+    "evidence_refs",
+    "approval"
+  ],
   "properties": {
-    "schema_version": {"const": 3},
-    "stage_decision_id": {"type": "string", "pattern": "^stage-decision\\.[a-z0-9][a-z0-9-]*$"},
-    "package_version": {"type": "string", "pattern": "^v[0-9]+$"},
-    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
-    "problem_statement": {"type": "string", "minLength": 1},
-    "target_users": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "mvp": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}},
-    "success_criteria": {"type": "array", "minItems": 1},
-    "test_seams": {"type": "array", "minItems": 1},
-    "confirmed_decisions": {"type": "array", "minItems": 1},
-    "assumptions": {"type": "array"},
-    "constraints": {"type": "array"},
-    "unresolved_items": {"type": "array", "items": {"$ref": "#/$defs/unresolved"}},
-    "context_snapshot": {"$ref": "#/$defs/contextSnapshot"},
-    "domain_strategy_ref": {"$ref": "#/$defs/domainRef"},
-    "impact_assessment": {"$ref": "#/$defs/impact"},
-    "downstream_mapping": {"type": "array", "minItems": 1},
-    "evidence_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "approval": {"$ref": "#/$defs/approval"}
+    "schema_version": {
+      "const": 3
+    },
+    "stage_decision_id": {
+      "type": "string",
+      "pattern": "^stage-decision\\.[a-z0-9][a-z0-9-]*$"
+    },
+    "package_version": {
+      "type": "string",
+      "pattern": "^v[0-9]+$"
+    },
+    "status": {
+      "enum": [
+        "draft",
+        "ready-for-human",
+        "approved",
+        "stale",
+        "blocked"
+      ]
+    },
+    "problem_statement": {
+      "type": "string",
+      "minLength": 1
+    },
+    "target_users": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "mvp": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "non_goals": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "success_criteria": {
+      "type": "array",
+      "minItems": 1
+    },
+    "test_seams": {
+      "type": "array",
+      "minItems": 1
+    },
+    "confirmed_decisions": {
+      "type": "array",
+      "minItems": 1
+    },
+    "assumptions": {
+      "type": "array"
+    },
+    "constraints": {
+      "type": "array"
+    },
+    "unresolved_items": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/unresolved"
+      }
+    },
+    "context_snapshot": {
+      "$ref": "#/$defs/contextSnapshot"
+    },
+    "domain_strategy_ref": {
+      "$ref": "#/$defs/domainRef"
+    },
+    "impact_assessment": {
+      "$ref": "#/$defs/impact"
+    },
+    "downstream_mapping": {
+      "type": "array",
+      "minItems": 1
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "approval": {
+      "$ref": "#/$defs/approval"
+    }
   },
   "$defs": {
     "contextSnapshot": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["context_ref", "context_schema_version", "document_digest", "referenced_terms_digest", "term_refs"],
+      "required": [
+        "context_ref",
+        "context_schema_version",
+        "document_digest",
+        "referenced_terms_digest",
+        "term_refs"
+      ],
       "properties": {
-        "context_ref": {"const": "CONTEXT.md"},
-        "context_schema_version": {"const": 1},
-        "document_digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
-        "referenced_terms_digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
-        "term_refs": {"type": "array", "items": {"type": "string", "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"}, "uniqueItems": true}
+        "context_ref": {
+          "const": "CONTEXT.md"
+        },
+        "context_schema_version": {
+          "const": 1
+        },
+        "document_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "referenced_terms_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "term_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"
+          },
+          "uniqueItems": true
+        }
       }
     },
     "unresolved": {
       "type": "object",
-      "required": ["item", "type", "owner", "next_action", "target_version"],
+      "required": [
+        "item",
+        "type",
+        "owner",
+        "next_action",
+        "target_version"
+      ],
       "properties": {
-        "item": {"type": "string", "minLength": 1},
-        "type": {"enum": ["blocker", "deferred"]},
-        "owner": {"type": "string", "minLength": 1},
-        "next_action": {"type": "string", "minLength": 1},
-        "target_version": {"type": "string", "minLength": 1}
+        "item": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "enum": [
+            "blocker",
+            "deferred"
+          ]
+        },
+        "owner": {
+          "type": "string",
+          "minLength": 1
+        },
+        "next_action": {
+          "type": "string",
+          "minLength": 1
+        },
+        "target_version": {
+          "type": "string",
+          "minLength": 1
+        }
       }
     },
     "domainRef": {
       "type": "object",
-      "required": ["domain_strategy_id", "domain_version", "digest", "status", "persisted_ref"],
+      "required": [
+        "domain_strategy_id",
+        "domain_version",
+        "digest",
+        "status",
+        "persisted_ref"
+      ],
       "properties": {
-        "domain_strategy_id": {"type": "string", "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"},
-        "domain_version": {"type": "string", "pattern": "^v[0-9]+$"},
-        "digest": {"type": "string", "minLength": 1},
-        "status": {"enum": ["approved", "stale", "blocked"]},
-        "persisted_ref": {"type": "string", "minLength": 1}
+        "domain_strategy_id": {
+          "type": "string",
+          "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "domain_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "enum": [
+            "approved",
+            "stale",
+            "blocked"
+          ]
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approval_context": {
+          "type": "object",
+          "required": [
+            "subject_ref",
+            "approval_scope",
+            "basis",
+            "drafter_principal_ref"
+          ],
+          "properties": {
+            "subject_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "subject_digest": {
+              "type": "string",
+              "pattern": "^(sha256:)?[a-f0-9]{64}$"
+            },
+            "approval_scope": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "basis": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "required": [
+                  "ref",
+                  "digest"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^(sha256:)?[a-f0-9]{64}$"
+                  }
+                }
+              }
+            },
+            "drafter_principal_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review_package": {
+              "type": "boolean"
+            }
+          }
+        }
       }
     },
     "impact": {
       "type": "object",
-      "required": ["ui", "api", "data", "backend", "frontend", "cross_repo", "high_risk"],
+      "required": [
+        "ui",
+        "api",
+        "data",
+        "backend",
+        "frontend",
+        "cross_repo",
+        "high_risk"
+      ],
       "properties": {
-        "ui": {"type": "boolean"},
-        "api": {"type": "boolean"},
-        "data": {"type": "boolean"},
-        "backend": {"type": "boolean"},
-        "frontend": {"type": "boolean"},
-        "cross_repo": {"type": "boolean"},
-        "high_risk": {"type": "boolean"}
+        "ui": {
+          "type": "boolean"
+        },
+        "api": {
+          "type": "boolean"
+        },
+        "data": {
+          "type": "boolean"
+        },
+        "backend": {
+          "type": "boolean"
+        },
+        "frontend": {
+          "type": "boolean"
+        },
+        "cross_repo": {
+          "type": "boolean"
+        },
+        "high_risk": {
+          "type": "boolean"
+        }
       }
     },
     "mapping": {
       "type": "object",
-      "required": ["domain_change", "consumer", "propagation", "reapproval_condition"],
+      "required": [
+        "domain_change",
+        "consumer",
+        "propagation",
+        "reapproval_condition"
+      ],
       "properties": {
-        "domain_change": {"type": "string", "minLength": 1},
-        "consumer": {"type": "string", "minLength": 1},
-        "propagation": {"enum": ["direct", "transitive", "not-applicable", "stale"]},
-        "reapproval_condition": {"type": "string", "minLength": 1}
+        "domain_change": {
+          "type": "string",
+          "minLength": 1
+        },
+        "consumer": {
+          "type": "string",
+          "minLength": 1
+        },
+        "propagation": {
+          "enum": [
+            "direct",
+            "transitive",
+            "not-applicable",
+            "stale"
+          ]
+        },
+        "reapproval_condition": {
+          "type": "string",
+          "minLength": 1
+        }
       }
     },
     "recordV3": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "statement", "evidence_refs"],
+      "required": [
+        "id",
+        "statement",
+        "evidence_refs"
+      ],
       "properties": {
-        "id": {"type": "string", "pattern": "^(success-criterion|test-seam|decision|assumption|constraint)\\.[a-z0-9][a-z0-9-]*$"},
-        "statement": {"type": "string", "minLength": 1},
-        "source_refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"}},
-        "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
-        "status": {"enum": ["confirmed", "candidate", "stale"]}
+        "id": {
+          "type": "string",
+          "pattern": "^(success-criterion|test-seam|decision|assumption|constraint)\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "statement": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_refs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"
+          }
+        },
+        "evidence_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "status": {
+          "enum": [
+            "confirmed",
+            "candidate",
+            "stale"
+          ]
+        }
       }
     },
     "mappingV3": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["mapping_id", "source_refs", "consumer_capability", "propagation", "reapproval_condition", "evidence_refs"],
+      "required": [
+        "mapping_id",
+        "source_refs",
+        "consumer_capability",
+        "propagation",
+        "reapproval_condition",
+        "evidence_refs"
+      ],
       "properties": {
-        "mapping_id": {"type": "string", "pattern": "^mapping\\.[a-z0-9][a-z0-9-]*$"},
-        "source_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"}},
-        "consumer_capability": {"enum": ["backend-technical-design", "frontend-engineering-design", "delivery-coordination"]},
-        "propagation": {"enum": ["direct", "transitive", "not-applicable", "stale"]},
-        "reapproval_condition": {"type": "string", "minLength": 1},
-        "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+        "mapping_id": {
+          "type": "string",
+          "pattern": "^mapping\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "source_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^(rule|scenario|invariant)\\.[a-z0-9][a-z0-9-]*$"
+          }
+        },
+        "consumer_capability": {
+          "enum": [
+            "backend-technical-design",
+            "frontend-engineering-design",
+            "delivery-coordination"
+          ]
+        },
+        "propagation": {
+          "enum": [
+            "direct",
+            "transitive",
+            "not-applicable",
+            "stale"
+          ]
+        },
+        "reapproval_condition": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
       }
     },
     "approval": {
       "type": "object",
-      "required": ["approval_ref", "approver", "persisted_ref", "current_version"],
+      "required": [
+        "approval_ref",
+        "approver",
+        "persisted_ref",
+        "current_version"
+      ],
       "properties": {
-        "approval_ref": {"type": "string", "minLength": 1},
-        "approver": {"type": "string", "minLength": 1},
-        "persisted_ref": {"type": "string", "minLength": 1},
-        "current_version": {"type": "string", "pattern": "^v[0-9]+$"}
+        "approval_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approver": {
+          "type": "string",
+          "minLength": 1
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "current_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        },
+        "approval_context": {
+          "type": "object",
+          "required": [
+            "subject_ref",
+            "approval_scope",
+            "basis",
+            "drafter_principal_ref"
+          ],
+          "properties": {
+            "subject_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "subject_digest": {
+              "type": "string",
+              "pattern": "^(sha256:)?[a-f0-9]{64}$"
+            },
+            "approval_scope": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "basis": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "required": [
+                  "ref",
+                  "digest"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^(sha256:)?[a-f0-9]{64}$"
+                  }
+                }
+              }
+            },
+            "drafter_principal_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review_package": {
+              "type": "boolean"
+            }
+          }
+        }
       }
     }
   },
   "allOf": [
     {
-      "if": {"properties": {"schema_version": {"const": 3}}, "required": ["schema_version"]},
+      "if": {
+        "properties": {
+          "schema_version": {
+            "const": 3
+          }
+        },
+        "required": [
+          "schema_version"
+        ]
+      },
       "then": {
         "properties": {
-          "success_criteria": {"items": {"$ref": "#/$defs/recordV3"}},
-          "test_seams": {"items": {"$ref": "#/$defs/recordV3"}},
-          "confirmed_decisions": {"items": {"$ref": "#/$defs/recordV3"}},
-          "assumptions": {"items": {"$ref": "#/$defs/recordV3"}},
-          "constraints": {"items": {"$ref": "#/$defs/recordV3"}},
-          "downstream_mapping": {"items": {"$ref": "#/$defs/mappingV3"}}
+          "success_criteria": {
+            "items": {
+              "$ref": "#/$defs/recordV3"
+            }
+          },
+          "test_seams": {
+            "items": {
+              "$ref": "#/$defs/recordV3"
+            }
+          },
+          "confirmed_decisions": {
+            "items": {
+              "$ref": "#/$defs/recordV3"
+            }
+          },
+          "assumptions": {
+            "items": {
+              "$ref": "#/$defs/recordV3"
+            }
+          },
+          "constraints": {
+            "items": {
+              "$ref": "#/$defs/recordV3"
+            }
+          },
+          "downstream_mapping": {
+            "items": {
+              "$ref": "#/$defs/mappingV3"
+            }
+          }
         }
       },
       "else": {
         "properties": {
-          "success_criteria": {"items": {"type": "string", "minLength": 1}},
-          "test_seams": {"items": {"type": "string", "minLength": 1}},
-          "confirmed_decisions": {"items": {"type": "string", "minLength": 1}},
-          "assumptions": {"items": {"type": "string", "minLength": 1}},
-          "constraints": {"items": {"type": "string", "minLength": 1}},
-          "downstream_mapping": {"items": {"$ref": "#/$defs/mapping"}}
+          "success_criteria": {
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "test_seams": {
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "confirmed_decisions": {
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "assumptions": {
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "constraints": {
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "downstream_mapping": {
+            "items": {
+              "$ref": "#/$defs/mapping"
+            }
+          }
         }
       }
     }