create-yss-spec 3.3.6 → 3.3.8

package/template/docs/process/schemas/strategic-feedback-adjudication.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/strategic-feedback-adjudication-v1.json",
+  "title": "YSS Strategic Feedback Adjudication v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "adjudication_id", "status", "feedback", "decision", "reason", "owner", "return_work_unit", "target_version", "evidence_refs", "decided_at"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "adjudication_id": {"type": "string", "pattern": "^feedback-adjudication\\.[a-z0-9][a-z0-9-]*$"},
+    "status": {"const": "approved"},
+    "feedback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest"],
+      "properties": {
+        "ref": {"type": "string", "minLength": 1},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+      }
+    },
+    "decision": {"enum": ["keep", "amend", "defer"]},
+    "reason": {"type": "string", "minLength": 1},
+    "owner": {"type": "string", "minLength": 1},
+    "return_work_unit": {"type": "string", "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$"},
+    "target_version": {"type": "string", "minLength": 1},
+    "risk": {"type": "string", "minLength": 1},
+    "verification_plan": {"type": "string", "minLength": 1},
+    "approval_ref": {"type": "string", "minLength": 1},
+    "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+    "decided_at": {"type": "string", "format": "date-time"}
+  },
+  "allOf": [
+    {
+      "if": {"properties": {"decision": {"enum": ["keep", "amend"]}}, "required": ["decision"]},
+      "then": {"required": ["approval_ref"]}
+    },
+    {
+      "if": {"properties": {"decision": {"const": "defer"}}, "required": ["decision"]},
+      "then": {"required": ["risk", "verification_plan"]}
+    }
+  ]
+}

package/template/docs/process/schemas/strategic-handoff-domain-strategy-v3.schema.json

@@ -0,0 +1,216 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/strategic-handoff-domain-strategy-v3.json",
+  "title": "YSS 业务边界与规则设计",
+  "type": "object",
+  "required": ["schema_version", "domain_strategy_id", "domain_version", "status", "contexts", "subdomains", "relationships", "scenarios", "concept_candidates", "invariants", "context_snapshot", "downstream_mapping", "evidence_refs", "approval"],
+  "properties": {
+    "traceability_version": {"const": 1},
+    "rule_catalog": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["rule_id", "statement", "responsible_context", "status"], "properties": {"rule_id": {"type": "string", "pattern": "^rule\\.[a-z0-9][a-z0-9-]*$"}, "statement": {"type": "string", "minLength": 1}, "responsible_context": {"type": "string", "minLength": 1}, "status": {"const": "confirmed"}, "evidence_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}}, "minItems": 1},
+    "schema_version": {"const": 3},
+    "domain_strategy_id": {"type": "string", "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"},
+    "domain_version": {"type": "string", "pattern": "^v[0-9]+$"},
+    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
+    "contexts": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/context"}},
+    "subdomains": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/subdomain"}},
+    "relationships": {"type": "array", "items": {"$ref": "#/$defs/relationship"}},
+    "scenarios": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/scenario"}},
+    "concept_candidates": {"type": "array", "items": {"$ref": "#/$defs/concept"}},
+    "invariants": {"type": "array", "items": {"$ref": "#/$defs/invariant"}},
+    "context_snapshot": {"$ref": "#/$defs/contextSnapshot"},
+    "downstream_mapping": {"type": "array"},
+    "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"],
+      "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": {
+      "type": "object",
+      "required": ["context_id", "name", "responsibilities", "non_responsibilities", "subdomain_type", "owner", "status"],
+      "properties": {
+        "context_id": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "name": {"type": "string", "minLength": 1},
+        "responsibilities": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+        "non_responsibilities": {"type": "array", "items": {"type": "string", "minLength": 1}},
+        "subdomain_type": {"enum": ["Core Domain", "Supporting Subdomain", "Generic Subdomain"]},
+        "owner": {"type": "string", "minLength": 1},
+        "status": {"enum": ["candidate", "confirmed", "stale"]}
+      }
+    },
+    "subdomain": {
+      "type": "object",
+      "required": ["subdomain_id", "name", "type", "rationale", "evidence_refs"],
+      "properties": {
+        "subdomain_id": {"type": "string", "pattern": "^subdomain\\.[a-z0-9][a-z0-9-]*$"},
+        "name": {"type": "string", "minLength": 1},
+        "type": {"enum": ["Core Domain", "Supporting Subdomain", "Generic Subdomain"]},
+        "rationale": {"type": "string", "minLength": 1},
+        "evidence_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
+      }
+    },
+    "relationship": {
+      "type": "object",
+      "required": ["relationship_id", "from_context", "to_context", "relationship_pattern", "semantic_upstream", "semantic_downstream", "business_authority", "model_change_impact", "transport_direction", "translation_responsibility", "direction_explanation"],
+      "properties": {
+        "relationship_id": {"type": "string", "pattern": "^relationship\\.[a-z0-9][a-z0-9-]*$"},
+        "from_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "to_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "relationship_pattern": {"enum": ["Partnership", "Customer/Supplier", "Conformist", "Anti-Corruption Layer", "Open Host Service", "Published Language", "Shared Kernel", "Separate Ways"]},
+        "semantic_upstream": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "semantic_downstream": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "business_authority": {"type": "string", "minLength": 1},
+        "model_change_impact": {"type": "string", "minLength": 1},
+        "transport_direction": {"type": "string", "minLength": 1},
+        "translation_responsibility": {"type": "string", "minLength": 1},
+        "direction_explanation": {"type": "string", "minLength": 1}
+      }
+    },
+    "scenario": {
+      "type": "object",
+      "required": ["scenario_id", "actor", "preconditions", "commands", "rules", "events", "failure_results", "responsible_context", "consumers", "status"],
+      "properties": {
+        "rule_refs": {"type": "array", "items": {"type": "string", "minLength": 1}, "minItems": 1},
+        "critical": {"type": "boolean"},
+        "success_results": {"type": "array", "items": {"type": "string", "minLength": 1}, "minItems": 1},
+        "scenario_id": {"type": "string", "pattern": "^scenario\\.[a-z0-9][a-z0-9-]*$"},
+        "actor": {"type": "string", "minLength": 1},
+        "preconditions": {"type": "array", "items": {"type": "string"}},
+        "commands": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "rules": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "events": {"type": "array", "items": {"type": "string"}},
+        "failure_results": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "responsible_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "consumers": {"type": "array", "items": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"}},
+        "status": {"enum": ["candidate", "confirmed", "stale"]}
+      }
+    },
+    "concept": {
+      "type": "object",
+      "required": ["concept_id", "name", "context_id", "identity_features", "lifecycle", "confidence", "status"],
+      "properties": {
+        "concept_id": {"type": "string", "pattern": "^domain-concept\\.[a-z0-9][a-z0-9-]*$"},
+        "name": {"type": "string", "minLength": 1},
+        "context_id": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "identity_features": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "lifecycle": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "invariant_refs": {"type": "array", "items": {"type": "string"}},
+        "possible_tactical_role": {"type": "string"},
+        "confidence": {"enum": ["low", "medium", "high"]},
+        "status": {"enum": ["candidate", "confirmed", "stale"]}
+      }
+    },
+    "invariant": {
+      "type": "object",
+      "required": ["invariant_id", "statement", "responsible_context", "scenario_refs", "verification_method"],
+      "properties": {
+        "rule_ref": {"type": "string", "minLength": 1},
+        "invariant_id": {"type": "string", "pattern": "^invariant\\.[a-z0-9][a-z0-9-]*$"},
+        "statement": {"type": "string", "minLength": 1},
+        "responsible_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
+        "scenario_refs": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "verification_method": {"type": "string", "minLength": 1}
+      }
+    },
+    "mapping": {
+      "type": "object",
+      "required": ["domain_change", "impacts", "propagation", "reapproval_condition"],
+      "properties": {
+        "domain_change": {"type": "string", "minLength": 1},
+        "impacts": {"type": "array", "minItems": 1, "items": {"type": "string"}},
+        "propagation": {"enum": ["direct", "transitive", "stale"]},
+        "reapproval_condition": {"type": "string", "minLength": 1}
+      }
+    },
+    "mappingV3": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mapping_id", "source_refs", "consumer_capability", "impacts", "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"]},
+        "impacts": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+        "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"],
+      "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]+$"}
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {"properties": {"schema_version": {"const": 3}}, "required": ["schema_version"]},
+      "then": {
+        "required": ["traceability_version", "rule_catalog"],
+        "properties": {
+          "traceability_version": {"const": 1},
+          "rule_catalog": {
+            "items": {
+              "required": ["evidence_refs"],
+              "properties": {
+                "evidence_refs": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": {"type": "string", "minLength": 1}
+                }
+              }
+            }
+          },
+          "scenarios": {
+            "items": {
+              "required": ["rule_refs", "critical", "success_results", "evidence_refs"],
+              "properties": {
+                "evidence_refs": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": {"type": "string", "minLength": 1}
+                }
+              }
+            }
+          },
+          "invariants": {
+            "items": {
+              "required": ["rule_ref", "evidence_refs"],
+              "properties": {
+                "evidence_refs": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": {"type": "string", "minLength": 1}
+                }
+              }
+            }
+          },
+          "downstream_mapping": {"items": {"$ref": "#/$defs/mappingV3"}}
+        }
+      },
+      "else": {
+        "properties": {
+          "downstream_mapping": {"items": {"$ref": "#/$defs/mapping"}}
+        }
+      }
+    }
+  ]
+}

package/template/docs/process/schemas/strategic-handoff-export-v2.schema.json

@@ -0,0 +1,378 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/strategic-handoff-export-v2.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "approvals",
+    "additional_files",
+    "reference_map",
+    "ui_baseline_kind"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 2
+    },
+    "approvals": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "domain_strategy_ref",
+        "stage_decision_package_ref",
+        "spec_ref",
+        "business_ticket_set_ref",
+        "handoff"
+      ],
+      "properties": {
+        "domain_strategy_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "stage_decision_package_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "spec_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "prototype_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "visual_baseline_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "business_ticket_set_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "handoff": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "enum": [
+                "canonical-json",
+                "sha256-bytes",
+                "visual-baseline"
+              ]
+            }
+          }
+        },
+        "existing_ui_baseline_ref": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "record_ref",
+            "gate_id",
+            "digest_kind"
+          ],
+          "properties": {
+            "record_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "gate_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "digest_kind": {
+              "const": "sha256-bytes"
+            }
+          }
+        }
+      }
+    },
+    "additional_files": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "minItems": 0
+    },
+    "reference_map": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "prototype": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "profile",
+        "preview_root",
+        "entry_ref",
+        "verification_ref",
+        "verification_digest"
+      ],
+      "properties": {
+        "profile": {
+          "enum": [
+            "H1",
+            "H2"
+          ]
+        },
+        "preview_root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "entry_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "verification_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "lock_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "verification_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "source_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "profile": {
+                "const": "H2"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "source_root",
+              "lock_ref",
+              "source_digest"
+            ]
+          }
+        }
+      ]
+    },
+    "ui_baseline_kind": {
+      "enum": [
+        "prototype",
+        "existing-ui-baseline"
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "ui_baseline_kind": {
+            "const": "prototype"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "prototype"
+        ],
+        "properties": {
+          "approvals": {
+            "required": [
+              "prototype_ref",
+              "visual_baseline_ref"
+            ],
+            "not": {
+              "required": [
+                "existing_ui_baseline_ref"
+              ]
+            }
+          }
+        }
+      },
+      "else": {
+        "not": {
+          "required": [
+            "prototype"
+          ]
+        },
+        "properties": {
+          "approvals": {
+            "required": [
+              "existing_ui_baseline_ref"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "prototype_ref"
+                  ]
+                },
+                {
+                  "required": [
+                    "visual_baseline_ref"
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/template/docs/process/schemas/strategic-handoff-import-receipt.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/strategic-handoff-import-receipt-v2.json",
+  "title": "YSS Strategic Handoff Import Receipt v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "bundle_id", "version", "bundle_digest", "package_ref", "target_context_digest", "target_profile_id", "selected_consumer_capabilities", "routes", "status"],
+  "properties": {
+    "schema_version": {"const": 2},
+    "bundle_id": {"type": "string", "pattern": "^strategic-design-handoff\\.[a-z0-9][a-z0-9-]*$"},
+    "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+    "bundle_digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "package_ref": {"type": "string", "minLength": 1},
+    "target_context_digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "target_profile_id": {"type": "string", "minLength": 1},
+    "selected_consumer_capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {"enum": ["backend-technical-design", "frontend-engineering-design", "delivery-coordination"]}
+    },
+    "routes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["route_id", "capability", "activation", "artifact_refs"],
+        "properties": {
+          "route_id": {"type": "string", "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"},
+          "capability": {"enum": ["backend-technical-design", "frontend-engineering-design", "delivery-coordination"]},
+          "activation": {"enum": ["required", "optional", "not-applicable"]},
+          "artifact_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+        }
+      }
+    },
+    "status": {"const": "pending-context-reconciliation"}
+  }
+}