create-yss-spec 3.3.7 → 3.4.1

package/template/docs/process/schemas/api-contract-decision.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/api-contract-decision.schema.json",
+  "title": "YSS API Contract Decision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "decision_id", "decision_version", "status", "current_version", "impact", "assessment_ref", "assessment_digest", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "api-contract-decision" },
+    "decision_id": { "type": "string", "minLength": 1 },
+    "decision_version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+    "status": { "const": "approved" },
+    "current_version": { "const": true },
+    "impact": { "enum": ["required", "not-applicable"] },
+    "assessment_ref": { "type": "string", "minLength": 1 },
+    "assessment_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "reason": { "type": "string", "minLength": 1 },
+    "openapi": { "$ref": "#/$defs/versionedArtifact" },
+    "validation_record": { "$ref": "#/$defs/artifact" },
+    "draft_review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest", "result", "blocking_findings", "draft_ref", "draft_digest", "evidence_refs"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "result": { "const": "approved" },
+        "blocking_findings": { "type": "array", "maxItems": 0 },
+        "draft_ref": { "type": "string", "minLength": 1 },
+        "draft_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "freeze": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "frozen_at", "draft_ref", "draft_digest"],
+      "properties": {
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "frozen_at": { "type": "string", "format": "date-time" },
+        "draft_ref": { "type": "string", "minLength": 1 },
+        "draft_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  },
+  "allOf": [
+    { "if": { "properties": { "impact": { "const": "required" } } }, "then": { "required": ["openapi", "validation_record", "draft_review", "freeze"] } },
+    { "if": { "properties": { "impact": { "const": "not-applicable" } } }, "then": { "required": ["reason"], "not": { "anyOf": [{ "required": ["openapi"] }, { "required": ["validation_record"] }, { "required": ["draft_review"] }, { "required": ["freeze"] }] } } }
+  ],
+  "$defs": {
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "versionedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "ref", "version", "digest"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/backend-architecture-identity.schema.json

@@ -2,18 +2,115 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://yss.local/schemas/backend-architecture-identity.schema.json",
   "title": "后端架构身份",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["architecture_family", "architecture_profile", "generator_skill", "requested_capabilities", "resolved_modules", "contract_digest", "verification_database", "production_database"],
-  "properties": {
-    "architecture_family": {"enum": ["domain-driven", "layered-mvc"]},
-    "architecture_profile": {"enum": ["target-domain-model", "layered-mvc-service", "mvc-data-analysis-v1"]},
-    "generator_skill": {"type": "string", "minLength": 1},
-    "requested_capabilities": {"type": "array", "uniqueItems": true, "items": {"type": "string"}},
-    "resolved_modules": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string"}},
-    "contract_digest": {"type": "string", "pattern": "^(sha256:)?[a-f0-9]{64}$"},
-    "verification_database": {"const": "h2"},
-    "production_database": {"const": "not-bound"}
-  },
-  "description": "各 Manifest kind、工程基线、仓库登记、Slice/work unit/Execution Result 引用此 schema；具体 Profile/生成器/模块闭包由 yss-skill-registry.yaml 定义并由 backend-architecture.mjs 校验。"
+  "description": "旧生成式身份严格兼容；既有工程显式 existing-registration v2，必须以原始文件三方核验。",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "architecture_family",
+        "architecture_profile",
+        "generator_skill",
+        "requested_capabilities",
+        "resolved_modules",
+        "contract_digest",
+        "verification_database",
+        "production_database"
+      ],
+      "properties": {
+        "architecture_family": {
+          "enum": [
+            "domain-driven",
+            "layered-mvc"
+          ]
+        },
+        "architecture_profile": {
+          "enum": [
+            "target-domain-model",
+            "layered-mvc-service",
+            "mvc-data-analysis-v1"
+          ]
+        },
+        "generator_skill": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requested_capabilities": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "resolved_modules": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "contract_digest": {
+          "type": "string",
+          "pattern": "^(sha256:)?[a-f0-9]{64}$"
+        },
+        "verification_database": {
+          "const": "h2"
+        },
+        "production_database": {
+          "const": "not-bound"
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "source_kind",
+        "architecture_family",
+        "architecture_profile",
+        "repository_id",
+        "project_id",
+        "source_digest",
+        "build_units_digest"
+      ],
+      "properties": {
+        "schema_version": {
+          "const": 2
+        },
+        "source_kind": {
+          "const": "existing-registration"
+        },
+        "architecture_family": {
+          "enum": [
+            "domain-driven",
+            "layered-mvc"
+          ]
+        },
+        "architecture_profile": {
+          "enum": [
+            "existing-domain-driven-maven",
+            "existing-layered-mvc-maven"
+          ]
+        },
+        "repository_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "project_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "build_units_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    }
+  ]
 }

package/template/docs/process/schemas/data-architecture-decision.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/data-architecture-decision.schema.json",
+  "title": "YSS Data Architecture Decision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "decision_id", "decision_version", "status", "current_version", "impact", "assessment_ref", "assessment_digest", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "data-architecture-decision" },
+    "decision_id": { "type": "string", "pattern": "^data-architecture\\.[a-z0-9][a-z0-9-]*$" },
+    "decision_version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+    "status": { "const": "approved" },
+    "current_version": { "const": true },
+    "impact": { "enum": ["required", "not-applicable"] },
+    "assessment_ref": { "type": "string", "minLength": 1 },
+    "assessment_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "data_architecture_ref": { "type": "string", "minLength": 1 },
+    "data_architecture_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "review_evidence_refs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "reason": { "type": "string", "minLength": 1 },
+    "evidence_refs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "impact": { "const": "required" } }, "required": ["impact"] },
+      "then": { "required": ["data_architecture_ref", "data_architecture_digest", "review_evidence_refs"], "not": { "required": ["reason"] } }
+    },
+    {
+      "if": { "properties": { "impact": { "const": "not-applicable" } }, "required": ["impact"] },
+      "then": { "required": ["reason"], "not": { "anyOf": [{ "required": ["data_architecture_ref"] }, { "required": ["data_architecture_digest"] }, { "required": ["review_evidence_refs"] }] } }
+    }
+  ]
+}

package/template/docs/process/schemas/delivery-preflight-input.schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "scope"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "governance_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "planned_initialization": {
+      "type": "boolean"
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repository_id",
+        "project_id",
+        "slice_id",
+        "operation_ids"
+      ],
+      "properties": {
+        "repository_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "project_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "slice_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "operation_ids": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "ui_mode": {
+          "enum": [
+            "existing-baseline",
+            "prototype",
+            "not-applicable"
+          ]
+        },
+        "ui_not_applicable_reason": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "architecture_identity": {
+      "type": "object"
+    },
+    "architecture_bindings": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "engineering_baseline": {
+          "$ref": "#/$defs/binding"
+        },
+        "repository_registration": {
+          "$ref": "#/$defs/binding"
+        },
+        "manifest": {
+          "$ref": "#/$defs/binding"
+        }
+      }
+    },
+    "assets": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "openapi": {
+          "$ref": "#/$defs/binding"
+        },
+        "technical_design": {
+          "$ref": "#/$defs/binding"
+        },
+        "slice_contract": {
+          "$ref": "#/$defs/binding"
+        },
+        "ui_baseline": {
+          "$ref": "#/$defs/binding"
+        },
+        "build": {
+          "$ref": "#/$defs/binding"
+        },
+        "deployment": {
+          "$ref": "#/$defs/binding"
+        },
+        "strategic_handoff": {
+          "$ref": "#/$defs/binding"
+        },
+        "backend_delivery": {
+          "$ref": "#/$defs/binding"
+        },
+        "local_authorization": {
+          "$ref": "#/$defs/binding"
+        },
+        "build_artifact": {
+          "$ref": "#/$defs/binding"
+        }
+      }
+    },
+    "delivery_kind": {
+      "enum": [
+        "complete",
+        "strategic-handoff",
+        "backend-delivery"
+      ]
+    }
+  },
+  "$defs": {
+    "binding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "digest"
+      ],
+      "properties": {
+        "ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approval_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/delivery-preflight-result.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "result",
+    "exit_code",
+    "stage",
+    "checks"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "result": {
+      "enum": [
+        "ready",
+        "blocked",
+        "invalid-input"
+      ]
+    },
+    "exit_code": {
+      "enum": [
+        0,
+        1,
+        2
+      ]
+    },
+    "stage": {
+      "enum": [
+        "prepare",
+        "build",
+        "export",
+        "accept",
+        null
+      ]
+    },
+    "checks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "code",
+          "status",
+          "owner",
+          "source",
+          "evidence",
+          "blocking_stages",
+          "recovery",
+          "message"
+        ],
+        "properties": {
+          "code": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "enum": [
+              "ready",
+              "missing",
+              "conflict",
+              "stale",
+              "unsupported",
+              "pending",
+              "not-applicable"
+            ]
+          },
+          "owner": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "blocking_stages": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "enum": [
+                "prepare",
+                "build",
+                "export",
+                "accept"
+              ]
+            }
+          },
+          "recovery": {
+            "type": "string",
+            "minLength": 1
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "result": {
+            "const": "ready"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "exit_code": {
+            "const": 0
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "result": {
+            "const": "blocked"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "exit_code": {
+            "const": 1
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "result": {
+            "const": "invalid-input"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "exit_code": {
+            "const": 2
+          }
+        }
+      }
+    }
+  ]
+}

package/template/docs/process/schemas/digital-human-task-package.schema.json

@@ -42,7 +42,7 @@
       "properties": {
         "kind": { "enum": ["lifecycle-work-unit", "slice-implementation", "template-maintenance"] },
         "contract_id": { "type": "string", "minLength": 1 },
-        "contract_version": { "type": "integer", "minimum": 1 },
+        "contract_version": { "oneOf": [{ "type": "integer", "minimum": 1 }, { "type": "string", "minLength": 1, "pattern": "\\S" }] },
         "status": { "enum": ["issued", "stale", "blocked"] },
         "contract_ref": { "type": "string", "minLength": 1 },
         "lifecycle_ref": { "type": "string", "minLength": 1 },