create-yss-spec 3.3.8 → 3.4.3

package/template/docs/process/lifecycle-registry.yaml

@@ -150,7 +150,7 @@ gates:
   - id: gate.plan-approved
     name: Plan 批准
     stage: stage.plan
-    trigger: Plan 结论进入 Spec；汇总战略检查后仅确认一次当前规划范围。
+    trigger: Plan 结论进入 Spec；汇总战略检查，核验当前规划范围的原始批准或有效授权延续。
     evidence:
       - evidence.approval-record
     requires_checks:
@@ -159,14 +159,14 @@ gates:
   - id: gate.spec-baseline-approved
     name: Spec 基线批准
     stage: stage.spec-architecture
-    trigger: 新功能、行为变化或范围扩大进入 Spec 基线。
+    trigger: 新功能、行为变化或范围扩大进入 Spec 基线；已授权范围内细化复用当前有效授权，实质变化重新决定。
     evidence:
       - evidence.approval-record
     requires_checks: []
   - id: gate.product-design-approved
     name: 产品设计批准
     stage: stage.product-design
-    trigger: 存在产品设计影响；独立原型评审与交付物验证通过后确认最终原型。
+    trigger: 存在产品设计影响；独立原型评审与交付物验证通过后核验原批准或授权延续，新增体验取舍由用户决定。
     evidence:
       - evidence.prototype-confirmation
     requires_checks:
@@ -175,7 +175,7 @@ gates:
   - id: gate.engineering-contract-approved
     name: 工程契约批准
     stage: stage.system-data-engineering
-    trigger: 存在 API、架构或工程基线影响；完成适用专业审查后统一批准，有 API 影响时同时冻结当前 OpenAPI。
+    trigger: 存在 API、架构或工程基线影响；组合适用专业审查后统一批准并核验授权，有 API 影响时同时冻结当前 OpenAPI；范围内细化不重复请求用户确认。
     evidence:
       - evidence.approval-record
       - evidence.fresh-verification
@@ -419,17 +419,17 @@ work_units:
     scope: project-instance
     input: Spec、原型、API/数据/工程影响面。
     output: OpenAPI、数据架构、按确认架构形成的 DDD / MVC 技术设计合同、工程基线、架构审查和 Slice 合同草案。
-    completion: 命中契约已冻结；无 API 影响有可读记录；命中技术设计影响时架构已确认、规则与场景承接无未解释冲突；工程基线通过。
+    completion: 命中契约已冻结；无 API 影响有可读记录；所有后端交付均有批准且当前的 Technical Design；数据影响为真时数据架构已批准，否则有可核验的不适用记录；架构、规则与场景承接无未解释冲突；gate.engineering-contract-approved 通过。
   - id: work-unit.implementation-repository-preparation
     name: 实现仓库准备
     scope: project-instance
-    input: 工程影响面、工程基线、逐项目用户决定、实现仓库位置；新建工程还需批准且当前的 Project Scaffold Contract。
-    output: 已有工程的 Repository Onboarding Result，或新工程的 Scaffold Manifest 与 Scaffold Verification；并汇总 Implementation Repository Preparation Result。
-    completion: 每个命中的交付面均为 existing-and-onboarded 或 initialized-and-verified，未命中的交付面有带原因的 not-applicable；聚合结果当前且证据可读。
+    input: 已完成的技术分析执行结果、Context reconciliation、战略交接消费结果、工程合同批准、工程影响面和实现仓库位置；新建后端还需批准且当前并绑定设计前置的 Project Scaffold Contract v4。
+    output: 已有工程的 Repository Onboarding Result，或新工程的 Scaffold Manifest v4 与 Scaffold Verification；并汇总 Implementation Repository Preparation Result v2。
+    completion: 每个后端项目均携带技术/数据设计门禁结果；新生成只接受 v4；历史 v3 仅在机械骨架未修改、设计补齐和恢复批准均通过时对账复用；检测到提前业务实现时保持 blocked。每个命中的交付面均为 existing-and-onboarded 或 initialized-and-verified，未命中的交付面有带原因的 not-applicable；聚合结果当前且证据可读。
   - id: work-unit.service-project-initialization
     name: 独立服务项目初始化
     scope: project-instance
-    input: 逐项目批准的架构决策、schema v3 初始化合同、战略上下文交接及目标/skillUtils 写范围。
+    input: 逐项目批准的架构决策、Technical Design、Data Architecture Decision、工程合同批准、schema v4 初始化合同、战略上下文交接及目标/skillUtils 写范围。
     output: 独立 Git project-instance、锁定 skillUtils、唯一根 CONTEXT、架构身份、Manifest 和验证证据；父项目仅保留引用。
     completion: 当前合同与交接摘要一致，真实 Wrapper 三命令通过后仅 empty-scaffold-verified；首切片仍须独立批准和验证。
   - id: work-unit.ticket-decomposition

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

@@ -59,6 +59,97 @@
         },
         "production_database": {
           "const": "not-bound"
+        },
+        "platform_configuration": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "profile_id",
+            "spring_boot_version",
+            "java_version",
+            "parent",
+            "bom",
+            "compatibility_id",
+            "compatibility_digest"
+          ],
+          "properties": {
+            "schema_version": {
+              "enum": [
+                1,
+                2
+              ]
+            },
+            "profile_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "spring_boot_version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+\\.\\d+$"
+            },
+            "java_version": {
+              "enum": [
+                8,
+                17,
+                21
+              ]
+            },
+            "compatibility_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "compatibility_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "parent": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "group_id",
+                "artifact_id",
+                "version"
+              ],
+              "properties": {
+                "group_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "artifact_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "version": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                }
+              }
+            },
+            "bom": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "group_id",
+                "artifact_id",
+                "version"
+              ],
+              "properties": {
+                "group_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "artifact_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "version": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                }
+              }
+            }
+          }
         }
       }
     },

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/digital-human-task-package.schema.json

@@ -8,6 +8,7 @@
   "properties": {
     "plan_review_ref": { "type": "string", "minLength": 1 },
     "plan_user_decision_ref": { "type": "string", "minLength": 1 },
+    "plan_continuation_ref": { "type": "string", "minLength": 1 },
     "schema_version": { "const": 1 },
     "frontend_delivery": {
       "type": "object", "additionalProperties": false, "required": ["acceptance_ref"],
@@ -58,7 +59,7 @@
         "gate_refs": { "type": "array", "items": { "type": "string", "minLength": 1 } }
       }
     },
-    "user_decisions": { "type": "array", "items": { "type": "object", "required": ["boundary", "subject_ref", "scope", "user_decision_ref"], "properties": { "boundary": { "type": "string" }, "subject_ref": { "type": "string" }, "scope": { "type": "array", "minItems": 1, "items": { "type": "string" } }, "user_decision_ref": { "type": "string" } }, "additionalProperties": false } },
+    "user_decisions": { "type": "array", "items": { "type": "object", "required": ["boundary", "subject_ref", "scope"], "oneOf": [{"required": ["user_decision_ref"]}, {"required": ["continuation_ref"]}], "properties": { "boundary": { "type": "string" }, "subject_ref": { "type": "string" }, "scope": { "type": "array", "minItems": 1, "items": { "type": "string" } }, "user_decision_ref": { "type": "string", "minLength": 1 }, "continuation_ref": { "type": "string", "minLength": 1 } }, "additionalProperties": false } },
     "inputs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
     "allowed_read_paths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
     "objective": { "type": "string", "minLength": 1 },

package/template/docs/process/schemas/implementation-repository-preparation-result.schema.json

@@ -1,38 +1,94 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://yss.example/schemas/implementation-repository-preparation-result.schema.json",
-  "title": "Implementation Repository Preparation Result",
+  "title": "Implementation Repository Preparation Result v2",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "kind", "result", "current_version", "projects", "evidence_refs"],
   "properties": {
-    "schema_version": { "const": 1 },
+    "schema_version": { "const": 2 },
     "kind": { "const": "implementation-repository-preparation-result" },
     "result": { "const": "completed" },
     "current_version": { "const": true },
-    "projects": {
-      "type": "array",
-      "minItems": 2,
-      "items": {
-        "type": "object",
-        "required": ["project_id", "delivery_role", "status"],
-        "properties": {
-          "project_id": { "type": "string", "minLength": 1 },
-          "delivery_role": { "enum": ["backend", "frontend"] },
-          "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
-          "reason": { "type": "string" },
-          "repository_ref": { "type": "string" },
-          "project_root": { "type": "string" },
-          "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
-          "onboarding_result": { "type": "object" },
-          "scaffold_contract": { "type": "object" },
-          "scaffold_manifest_ref": { "type": "string" },
-          "scaffold_verification": { "type": "object" },
-          "template_available": { "type": "boolean" },
-          "architecture_family": { "type": "string" }
-        }
+    "projects": { "type": "array", "minItems": 2, "items": { "$ref": "#/$defs/project" } },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "$defs": {
+    "artifactBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "version", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "impact": { "enum": ["required", "not-applicable"] }
       }
     },
-    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+    "designPrerequisites": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["technical_design", "data_architecture_decision", "api_contract_decision", "engineering_contract_approval_ref"],
+      "properties": {
+        "technical_design": { "$ref": "#/$defs/artifactBinding" },
+        "data_architecture_decision": { "$ref": "#/$defs/artifactBinding" },
+        "api_contract_decision": { "$ref": "#/$defs/artifactBinding" },
+        "engineering_contract_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "legacyReconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "status", "manifest_ref", "manifest_digest", "ownership_check_ref", "ownership_state", "premature_implementation", "recovery_approval_ref"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "status": { "const": "approved" },
+        "manifest_ref": { "type": "string", "minLength": 1 },
+        "manifest_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "ownership_check_ref": { "type": "string", "minLength": 1 },
+        "ownership_state": { "const": "unchanged-mechanical-scaffold" },
+        "premature_implementation": { "const": false },
+        "recovery_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "delivery_role", "status"],
+      "properties": {
+        "project_id": { "type": "string", "minLength": 1 },
+        "delivery_role": { "enum": ["backend", "frontend"] },
+        "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
+        "reason": { "type": "string", "minLength": 1 },
+        "repository_ref": { "type": "string", "minLength": 1 },
+        "project_root": { "type": "string", "minLength": 1 },
+        "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
+        "onboarding_result": { "type": "object" },
+        "scaffold_contract": {
+          "type": "object",
+          "required": ["schema_version", "status", "persisted", "current_version"],
+          "properties": {
+            "schema_version": { "enum": [3, 4] },
+            "status": { "const": "approved" },
+            "persisted": { "const": true },
+            "current_version": { "const": true }
+          }
+        },
+        "scaffold_manifest_ref": { "type": "string", "minLength": 1 },
+        "scaffold_verification": { "type": "object" },
+        "template_available": { "type": "boolean" },
+        "architecture_family": { "type": "string", "minLength": 1 },
+        "design_prerequisites": { "$ref": "#/$defs/designPrerequisites" },
+        "legacy_reconciliation": { "$ref": "#/$defs/legacyReconciliation" }
+      },
+      "allOf": [
+        { "if": { "properties": { "status": { "const": "not-applicable" } }, "required": ["status"] }, "then": { "required": ["reason"] } },
+        { "if": { "properties": { "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["status"] }, "then": { "required": ["repository_ref", "project_root", "repository_scope"] } },
+        { "if": { "properties": { "status": { "const": "existing-and-onboarded" } }, "required": ["status"] }, "then": { "required": ["onboarding_result"] } },
+        { "if": { "properties": { "status": { "const": "initialized-and-verified" } }, "required": ["status"] }, "then": { "required": ["scaffold_contract", "scaffold_manifest_ref", "scaffold_verification"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["delivery_role", "status"] }, "then": { "required": ["architecture_family", "design_prerequisites"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "const": "initialized-and-verified" }, "scaffold_contract": { "properties": { "schema_version": { "const": 3 } }, "required": ["schema_version"] } }, "required": ["delivery_role", "status", "scaffold_contract"] }, "then": { "required": ["legacy_reconciliation"] } }
+      ]
+    }
   }
 }

package/template/docs/process/schemas/lifecycle-checkpoint.schema.json

@@ -22,6 +22,10 @@
     "rollback"
   ],
   "properties": {
+    "plan_continuation_ref": {
+      "type": "string",
+      "minLength": 1
+    },
     "plan_review_ref": {
       "type": "string",
       "minLength": 1