create-yss-spec 3.3.8 → 3.4.3

package/template/docs/design/tokens/variables.css

@@ -1,52 +1,54 @@
 :root {
+  --yss-card-padding: 20px;
+  --yss-control-height: 32px;
   --yss-color-primary-control: #245bdb;
   --yss-color-primary-control-hover: #2f68eb;
   --yss-color-on-primary: #ffffff;
   --yss-control-height-compact: 28px;
   --yss-card-compact-padding: 16px;
   --brand-color-primary: #3371ff;
-  --brand-color-primary-bg: #d6e4ff;
-  --brand-color-primary-bg-hover: #adc6ff;
-  --brand-color-primary-border: #85a5ff;
-  --brand-color-primary-border-hover: #597ef7;
-  --brand-color-primary-hover: #4096ff;
-  --brand-color-primary-active: #0958d9;
-  --brand-color-primary-text: #002c8c;
+  --brand-color-primary-bg: #f0f7ff;
+  --brand-color-primary-bg-hover: #d6e8ff;
+  --brand-color-primary-border: #adceff;
+  --brand-color-primary-border-hover: #85b1ff;
+  --brand-color-primary-hover: #5c92ff;
+  --brand-color-primary-active: #2152d9;
+  --brand-color-primary-text: #3371ff;
   --brand-color-success: #52c41a;
   --brand-color-success-bg: #f6ffed;
   --brand-color-success-border: #b7eb8f;
-  --brand-color-success-hover: #73d13d;
+  --brand-color-success-hover: #95de64;
   --brand-color-success-active: #389e0d;
   --brand-color-warning: #faad14;
   --brand-color-warning-bg: #fffbe6;
   --brand-color-warning-border: #ffe58f;
-  --brand-color-warning-hover: #ffc53d;
+  --brand-color-warning-hover: #ffd666;
   --brand-color-warning-active: #d48806;
   --brand-color-error: #f5222d;
-  --brand-color-error-bg: #fff2f0;
-  --brand-color-error-border: #ffccc7;
+  --brand-color-error-bg: #fff1f0;
+  --brand-color-error-border: #ffa39e;
   --brand-color-error-hover: #ff4d4f;
   --brand-color-error-active: #cf1322;
   --brand-color-info: #3371ff;
-  --brand-color-info-bg: #e6f4ff;
-  --brand-color-info-border: #91caff;
+  --brand-color-info-bg: #f0f7ff;
+  --brand-color-info-border: #adceff;
   --brand-color-link: #3371ff;
-  --brand-color-link-hover: #4096ff;
-  --brand-color-link-active: #0958d9;
+  --brand-color-link-hover: #85b1ff;
+  --brand-color-link-active: #2152d9;
   --brand-color-text: rgba(0, 0, 0, 0.88);
   --brand-color-text-secondary: rgba(0, 0, 0, 0.65);
-  --brand-color-text-tertiary: #8c8c8c;
-  --brand-color-text-quaternary: #bfbfbf;
-  --brand-color-fill: #d9d9d9;
-  --brand-color-fill-secondary: #f0f0f0;
-  --brand-color-fill-tertiary: #f5f5f5;
-  --brand-color-fill-quaternary: #fafafa;
+  --brand-color-text-tertiary: rgba(0,0,0,0.45);
+  --brand-color-text-quaternary: rgba(0,0,0,0.25);
+  --brand-color-fill: rgba(0,0,0,0.15);
+  --brand-color-fill-secondary: rgba(0,0,0,0.06);
+  --brand-color-fill-tertiary: rgba(0,0,0,0.04);
+  --brand-color-fill-quaternary: rgba(0,0,0,0.02);
   --brand-color-bg-layout: #f0f2f5;
   --brand-color-bg-container: #ffffff;
   --brand-color-bg-elevated: #ffffff;
   --brand-color-border: #d9d9d9;
   --brand-color-border-secondary: #f0f0f0;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;
@@ -250,49 +252,49 @@
 }
 
 .dark {
-  --brand-color-primary: #3983dc;
-  --brand-color-primary-bg: #121e32;
-  --brand-color-primary-bg-hover: #152d4f;
-  --brand-color-primary-border: #213b5b;
-  --brand-color-primary-border-hover: #284f7e;
-  --brand-color-primary-hover: #61a1e8;
-  --brand-color-primary-active: #3169ad;
-  --brand-color-primary-text: #b5daf8;
-  --brand-color-success: #64b537;
-  --brand-color-success-bg: #192913;
-  --brand-color-success-border: #304d20;
-  --brand-color-success-hover: #87ca5c;
-  --brand-color-success-active: #518f2f;
-  --brand-color-warning: #dcaa37;
-  --brand-color-warning-bg: #312512;
-  --brand-color-warning-border: #5b4920;
-  --brand-color-warning-hover: #e8c35e;
-  --brand-color-warning-active: #ad872f;
-  --brand-color-error: #dc6966;
-  --brand-color-error-bg: #32191a;
-  --brand-color-error-border: #5b3231;
-  --brand-color-error-hover: #e89590;
-  --brand-color-error-active: #ad5553;
-  --brand-color-info: #3983dc;
-  --brand-color-info-bg: #121e32;
-  --brand-color-info-border: #213b5b;
-  --brand-color-link: #3983dc;
-  --brand-color-link-hover: #61a1e8;
-  --brand-color-link-active: #3169ad;
-  --brand-color-text: #dcdcdc;
-  --brand-color-text-secondary: #adadad;
-  --brand-color-text-tertiary: #7e7e7e;
-  --brand-color-text-quaternary: #4f4f4f;
-  --brand-color-fill: #3e3e3e;
-  --brand-color-fill-secondary: #303030;
-  --brand-color-fill-tertiary: #272727;
-  --brand-color-fill-quaternary: #1d1d1d;
-  --brand-color-bg-layout: #1d1d1d;
-  --brand-color-bg-container: #141414;
-  --brand-color-bg-elevated: #272727;
-  --brand-color-border: #3e3e3e;
-  --brand-color-border-secondary: #303030;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-color-primary: #3371ff;
+  --brand-color-primary-bg: #f0f7ff;
+  --brand-color-primary-bg-hover: #d6e8ff;
+  --brand-color-primary-border: #adceff;
+  --brand-color-primary-border-hover: #85b1ff;
+  --brand-color-primary-hover: #5c92ff;
+  --brand-color-primary-active: #2152d9;
+  --brand-color-primary-text: #3371ff;
+  --brand-color-success: #52c41a;
+  --brand-color-success-bg: #f6ffed;
+  --brand-color-success-border: #b7eb8f;
+  --brand-color-success-hover: #95de64;
+  --brand-color-success-active: #389e0d;
+  --brand-color-warning: #faad14;
+  --brand-color-warning-bg: #fffbe6;
+  --brand-color-warning-border: #ffe58f;
+  --brand-color-warning-hover: #ffd666;
+  --brand-color-warning-active: #d48806;
+  --brand-color-error: #f5222d;
+  --brand-color-error-bg: #fff1f0;
+  --brand-color-error-border: #ffa39e;
+  --brand-color-error-hover: #ff4d4f;
+  --brand-color-error-active: #cf1322;
+  --brand-color-info: #3371ff;
+  --brand-color-info-bg: #f0f7ff;
+  --brand-color-info-border: #adceff;
+  --brand-color-link: #3371ff;
+  --brand-color-link-hover: #85b1ff;
+  --brand-color-link-active: #2152d9;
+  --brand-color-text: rgba(0, 0, 0, 0.88);
+  --brand-color-text-secondary: rgba(0, 0, 0, 0.65);
+  --brand-color-text-tertiary: rgba(0,0,0,0.45);
+  --brand-color-text-quaternary: rgba(0,0,0,0.25);
+  --brand-color-fill: rgba(0,0,0,0.15);
+  --brand-color-fill-secondary: rgba(0,0,0,0.06);
+  --brand-color-fill-tertiary: rgba(0,0,0,0.04);
+  --brand-color-fill-quaternary: rgba(0,0,0,0.02);
+  --brand-color-bg-layout: #f0f2f5;
+  --brand-color-bg-container: #ffffff;
+  --brand-color-bg-elevated: #ffffff;
+  --brand-color-border: #d9d9d9;
+  --brand-color-border-secondary: #f0f0f0;
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;

package/template/docs/design/tokens/variables.dark.css

@@ -1,47 +1,47 @@
 :root {
-  --brand-color-primary: #3983dc;
-  --brand-color-primary-bg: #121e32;
-  --brand-color-primary-bg-hover: #152d4f;
-  --brand-color-primary-border: #213b5b;
-  --brand-color-primary-border-hover: #284f7e;
-  --brand-color-primary-hover: #61a1e8;
-  --brand-color-primary-active: #3169ad;
-  --brand-color-primary-text: #b5daf8;
-  --brand-color-success: #64b537;
-  --brand-color-success-bg: #192913;
-  --brand-color-success-border: #304d20;
-  --brand-color-success-hover: #87ca5c;
-  --brand-color-success-active: #518f2f;
-  --brand-color-warning: #dcaa37;
-  --brand-color-warning-bg: #312512;
-  --brand-color-warning-border: #5b4920;
-  --brand-color-warning-hover: #e8c35e;
-  --brand-color-warning-active: #ad872f;
-  --brand-color-error: #dc6966;
-  --brand-color-error-bg: #32191a;
-  --brand-color-error-border: #5b3231;
-  --brand-color-error-hover: #e89590;
-  --brand-color-error-active: #ad5553;
-  --brand-color-info: #3983dc;
-  --brand-color-info-bg: #121e32;
-  --brand-color-info-border: #213b5b;
-  --brand-color-link: #3983dc;
-  --brand-color-link-hover: #61a1e8;
-  --brand-color-link-active: #3169ad;
-  --brand-color-text: #dcdcdc;
-  --brand-color-text-secondary: #adadad;
-  --brand-color-text-tertiary: #7e7e7e;
-  --brand-color-text-quaternary: #4f4f4f;
-  --brand-color-fill: #3e3e3e;
-  --brand-color-fill-secondary: #303030;
-  --brand-color-fill-tertiary: #272727;
-  --brand-color-fill-quaternary: #1d1d1d;
-  --brand-color-bg-layout: #1d1d1d;
+  --brand-color-primary: #2e63dc;
+  --brand-color-primary-bg: #1d305b;
+  --brand-color-primary-bg-hover: #223e7e;
+  --brand-color-primary-border: #1d305b;
+  --brand-color-primary-border-hover: #223e7e;
+  --brand-color-primary-hover: #5585e8;
+  --brand-color-primary-active: #2850ad;
+  --brand-color-primary-text: #2e63dc;
+  --brand-color-success: #49aa19;
+  --brand-color-success-bg: #162312;
+  --brand-color-success-border: #274916;
+  --brand-color-success-hover: #306317;
+  --brand-color-success-active: #3c8618;
+  --brand-color-warning: #d89614;
+  --brand-color-warning-bg: #2b2111;
+  --brand-color-warning-border: #594214;
+  --brand-color-warning-hover: #7c5914;
+  --brand-color-warning-active: #aa7714;
+  --brand-color-error: #d32029;
+  --brand-color-error-bg: #2a1215;
+  --brand-color-error-border: #58181c;
+  --brand-color-error-hover: #e84749;
+  --brand-color-error-active: #a61d24;
+  --brand-color-info: #2e63dc;
+  --brand-color-info-bg: #14192c;
+  --brand-color-info-border: #1d305b;
+  --brand-color-link: #2e63dc;
+  --brand-color-link-hover: #223e7e;
+  --brand-color-link-active: #2850ad;
+  --brand-color-text: rgba(255,255,255,0.85);
+  --brand-color-text-secondary: rgba(255,255,255,0.65);
+  --brand-color-text-tertiary: rgba(255,255,255,0.45);
+  --brand-color-text-quaternary: rgba(255,255,255,0.25);
+  --brand-color-fill: rgba(255,255,255,0.18);
+  --brand-color-fill-secondary: rgba(255,255,255,0.12);
+  --brand-color-fill-tertiary: rgba(255,255,255,0.08);
+  --brand-color-fill-quaternary: rgba(255,255,255,0.04);
+  --brand-color-bg-layout: #000000;
   --brand-color-bg-container: #141414;
-  --brand-color-bg-elevated: #272727;
-  --brand-color-border: #3e3e3e;
+  --brand-color-bg-elevated: #1f1f1f;
+  --brand-color-border: #424242;
   --brand-color-border-secondary: #303030;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;

package/template/docs/engineering/backend-platforms.json

@@ -0,0 +1,174 @@
+{
+  "schema_version": 1,
+  "kind": "backend-platform-catalog",
+  "profiles": [
+    {
+      "id": "spring-boot-2.7-jdk8",
+      "spring_boot_version": "2.7.18",
+      "java_version": 8,
+      "framework_line": "5.3",
+      "tomcat_line": "9.0",
+      "servlet_version": "4.0",
+      "validation_namespace": "javax",
+      "validation_group": "javax.validation",
+      "validation_artifact": "validation-api",
+      "web_starter": "spring-boot-starter-web",
+      "web_test_starter": "spring-boot-starter-test",
+      "aop_starter": "spring-boot-starter-aop",
+      "mybatis_plus_starter": "mybatis-plus-boot-starter",
+      "springdoc_major": 1,
+      "jackson_major": 2,
+      "swagger_artifact": "swagger-annotations",
+      "versions": {
+        "mapstruct": "1.5.5.Final",
+        "lombok": "1.18.30",
+        "lombok_mapstruct_binding": "0.2.0",
+        "swagger": "2.2.22",
+        "archunit": "1.2.1",
+        "compiler": "3.11.0",
+        "enforcer": "3.5.0",
+        "surefire": "3.2.5"
+      },
+      "candidate_blockers": [
+        "YSS parent/BOM/starter combination and real Maven/startup evidence required"
+      ],
+      "spring_cloud_line": "2021.0",
+      "openfeign_line": "3.1"
+    },
+    {
+      "id": "spring-boot-3.5-jdk17",
+      "spring_boot_version": "3.5.16",
+      "java_version": 17,
+      "framework_line": "6.2",
+      "tomcat_line": "10.1",
+      "servlet_version": "6.0",
+      "validation_namespace": "jakarta",
+      "validation_group": "jakarta.validation",
+      "validation_artifact": "jakarta.validation-api",
+      "web_starter": "spring-boot-starter-web",
+      "web_test_starter": "spring-boot-starter-test",
+      "aop_starter": "spring-boot-starter-aop",
+      "mybatis_plus_starter": "mybatis-plus-spring-boot3-starter",
+      "springdoc_major": 2,
+      "jackson_major": 2,
+      "swagger_artifact": "swagger-annotations-jakarta",
+      "versions": {
+        "mapstruct": "1.6.3",
+        "lombok": "1.18.42",
+        "lombok_mapstruct_binding": "0.2.0",
+        "swagger": "2.2.22",
+        "archunit": "1.4.1",
+        "compiler": "3.14.1",
+        "enforcer": "3.5.0",
+        "surefire": "3.5.4"
+      },
+      "candidate_blockers": [
+        "YSS parent/BOM/starter combination and real Maven/startup evidence required"
+      ],
+      "spring_cloud_line": "2025.0",
+      "openfeign_line": "4.3"
+    },
+    {
+      "id": "spring-boot-3.5-jdk21",
+      "spring_boot_version": "3.5.16",
+      "java_version": 21,
+      "framework_line": "6.2",
+      "tomcat_line": "10.1",
+      "servlet_version": "6.0",
+      "validation_namespace": "jakarta",
+      "validation_group": "jakarta.validation",
+      "validation_artifact": "jakarta.validation-api",
+      "web_starter": "spring-boot-starter-web",
+      "web_test_starter": "spring-boot-starter-test",
+      "aop_starter": "spring-boot-starter-aop",
+      "mybatis_plus_starter": "mybatis-plus-spring-boot3-starter",
+      "springdoc_major": 2,
+      "jackson_major": 2,
+      "swagger_artifact": "swagger-annotations-jakarta",
+      "versions": {
+        "mapstruct": "1.6.3",
+        "lombok": "1.18.42",
+        "lombok_mapstruct_binding": "0.2.0",
+        "swagger": "2.2.22",
+        "archunit": "1.4.1",
+        "compiler": "3.14.1",
+        "enforcer": "3.5.0",
+        "surefire": "3.5.4"
+      },
+      "candidate_blockers": [
+        "YSS parent/BOM/starter combination and real Maven/startup evidence required"
+      ],
+      "spring_cloud_line": "2025.0",
+      "openfeign_line": "4.3"
+    },
+    {
+      "id": "spring-boot-4.1-jdk17",
+      "spring_boot_version": "4.1.1",
+      "java_version": 17,
+      "framework_line": "7.0",
+      "tomcat_line": "11.0",
+      "servlet_version": "6.1",
+      "validation_namespace": "jakarta",
+      "validation_group": "jakarta.validation",
+      "validation_artifact": "jakarta.validation-api",
+      "web_starter": "spring-boot-starter-webmvc",
+      "web_test_starter": "spring-boot-starter-webmvc-test",
+      "aop_starter": "spring-boot-starter-aspectj",
+      "mybatis_plus_starter": "mybatis-plus-spring-boot4-starter",
+      "springdoc_major": 3,
+      "jackson_major": 3,
+      "swagger_artifact": "swagger-annotations-jakarta",
+      "versions": {
+        "mapstruct": "1.6.3",
+        "lombok": "1.18.42",
+        "lombok_mapstruct_binding": "0.2.0",
+        "swagger": "2.2.22",
+        "archunit": "1.4.1",
+        "compiler": "3.14.1",
+        "enforcer": "3.5.0",
+        "surefire": "3.5.4"
+      },
+      "candidate_blockers": [
+        "YSS parent/BOM/starter combination and real Maven/startup evidence required"
+      ],
+      "spring_cloud_line": "2025.1",
+      "openfeign_line": "5.0",
+      "spring_cloud_minimum": "2025.1.2"
+    },
+    {
+      "id": "spring-boot-4.1-jdk21",
+      "spring_boot_version": "4.1.1",
+      "java_version": 21,
+      "framework_line": "7.0",
+      "tomcat_line": "11.0",
+      "servlet_version": "6.1",
+      "validation_namespace": "jakarta",
+      "validation_group": "jakarta.validation",
+      "validation_artifact": "jakarta.validation-api",
+      "web_starter": "spring-boot-starter-webmvc",
+      "web_test_starter": "spring-boot-starter-webmvc-test",
+      "aop_starter": "spring-boot-starter-aspectj",
+      "mybatis_plus_starter": "mybatis-plus-spring-boot4-starter",
+      "springdoc_major": 3,
+      "jackson_major": 3,
+      "swagger_artifact": "swagger-annotations-jakarta",
+      "versions": {
+        "mapstruct": "1.6.3",
+        "lombok": "1.18.42",
+        "lombok_mapstruct_binding": "0.2.0",
+        "swagger": "2.2.22",
+        "archunit": "1.4.1",
+        "compiler": "3.14.1",
+        "enforcer": "3.5.0",
+        "surefire": "3.5.4"
+      },
+      "candidate_blockers": [
+        "YSS parent/BOM/starter combination and real Maven/startup evidence required"
+      ],
+      "spring_cloud_line": "2025.1",
+      "openfeign_line": "5.0",
+      "spring_cloud_minimum": "2025.1.2"
+    }
+  ],
+  "compatibility": []
+}

package/template/docs/engineering/backend-platforms.md

@@ -0,0 +1,77 @@
+# 后端脚手架平台合同
+
+DDD 和 Layered MVC 共同消费 `backend-platforms.json`。平台定义是候选配方，`compatibility` 是维护者核验后的 YSS 组合清单；空清单表示尚无可开放组合，不表示官方框架不支持这些版本。
+
+## 用户选择
+
+运行 `scripts/backend-platforms` 展示 Boot 精确补丁、Java、YSS 父 POM/BOM、可选状态和阻塞原因。生命周期编排器将平台与架构放在同一次用户决定中。缺少选择时询问；已有批准且当前的选择只展示摘要并复用。独立子项目可继承或覆盖，也可一次确认明确列出的多个项目。同一 Maven Reactor 不混用平台。
+
+候选为 2.7.18 / Java 8、3.5.16 / Java 17 或 21、4.1.1 / Java 17 或 21。3.5 和 4.1 推荐 Java 17。新增补丁必须先通过组合验证，生成合同不接受 `x`、版本范围或 `latest`。
+
+## 配置与一致性
+
+Project Scaffold Contract v4 新增 `platform_configuration` v2，两个脚手架的新生成必须提供；前端及数据分析初始化器保持原边界。架构决策保存同一对象，参与原用户决定快照和 digest。Manifest 顶层及 `architecture_identity` 传递同一配置。
+
+| 字段 | 内容 |
+|---|---|
+| `schema_version` | `2`（v1 只读审计） |
+| `profile_id` | 如 `spring-boot-3.5-jdk17` |
+| `spring_boot_version` | 精确补丁，如 `3.5.16` |
+| `java_version` | 经选择的 `8`、`17` 或 `21` |
+| `parent` / `bom` | `group_id`、`artifact_id`、`version` |
+| `compatibility_id` | 清单组合 ID |
+| `compatibility_digest` | `platformRecipeDigest(profile, entry)`，排除证据列表、支持状态和展示提示 |
+
+配置可由 `platformBinding(profile, entry)` 机械构造；该函数不批准用户选择或开放支持。修改平台、YSS 坐标或依赖配方会使绑定失效；仅更新同配方证据不改变用户选择摘要。历史 Manifest 继续只读验证，不自动补字段或重写批准。仅继承架构不等于继承平台批准。
+
+## 依赖与验证
+
+Boot BOM 管理 Spring Framework/MVC、嵌入式容器、Servlet、Validation、Jackson 等依赖，Boot Plugin 与 Boot 精确版本相同。YSS 父 POM/BOM 仍由用户确认，解析结果冲突则阻断，不能依靠属性覆盖宣称兼容。清单记录构建工具、Lombok、MapStruct、Swagger、ArchUnit 的候选版本；YSS 组件源码不在脚手架步骤中改造。
+
+Boot 4 使用对应 MVC / MVC 测试 starter、Jackson 3 默认栈与新的模块结构；MyBatis-Plus 必须使用相应 Boot 分支。Web/Validation 的 Jakarta 迁移不替换 `javax.sql` 等 Java SE API。Feign 等可选能力须在兼容条目的 `capabilities` 内有验证记录。清单记录 Cloud 2021.0 / 2025.0 / 2025.1（Boot 4.1 至少 2025.1.2）及 OpenFeign 3.1 / 4.3 / 5.0 线；实际内部 BOM 必须解析到对应组合。测试覆盖 Validation、JSON、MyBatis 查询映射和适用的 Feign JSON Decoder。
+
+真实验证保存 Maven 实际 JDK、effective POM、每个模块的依赖树、固定三条 Wrapper 命令结果，以及显式 `scaffold-local` 打包启动结果。启动检查只绑定回环地址，通过启动日志与 HTTP 响应验证机械 Web 服务；测试内 Controller 通过随机端口覆盖 JSON POST 往返及非法参数 400，不编译进生产 Jar，并终止验证进程。H2 仅用于测试和显式本地 Profile，不绑定生产数据库。生成器不添加用户业务示例。
+
+## 维护候选与开放组合
+
+`scripts/verify-backend-platform-matrix --evidence-dir <目录> --inputs <输入.json>` 是维护入口；没有输入或环境时输出十组 `blocked` 及原因，不伪造 Maven 结果。输入结构：
+
+- `catalog_ref`：相对输入文件的候选清单；保留官方平台定义，补充实际待验证的 YSS 组合。
+- `java_homes`：以 `8`、`17`、`21` 为键的实际 JDK 根目录。
+- `combinations`：每项有 `profile_id`、`spring_boot_version`、`architecture_family`、`contract_ref`，合同须真实批准、当前且指向不存在的输出目录。
+
+兼容条目包含 `id`、`profile_id`、`spring_boot_version`、`parent`、`bom`、`status`、`capabilities` 和 `evidence`。未验证时使用 `candidate`。每条证据绑定架构、可读取报告的 `ref` 与原始字节 `digest`。报告须匹配 Boot、Java、父 POM/BOM，三条 Maven 命令真实成功，并通过依赖、Surefire 实际用例和启动检查；跳过测试不通过。报告的 `verified_capabilities` 逐架构覆盖所选能力。`evidence_artifacts` 绑定日志、effective POM、依赖树和 `platform-tests.xml` 的相对路径与字节摘要，缺失或漂移即阻断。
+
+候选工程始终标记 `platform_verification=candidate`，不能进入普通验证完成升级、业务生成或首切片验证。维护者将真实证据及相关日志保存为可分发的相对路径包，审阅全部适用能力后才可把对应组合登记为 `verified`。候选晋级或替换同配方证据不改变配置摘要；真正的依赖配方变化才重新确认。矩阵命令不自动修改兼容清单、不批准合同、不发布版本。
+
+`scripts/fixtures/backend-scaffold/` 下的合成合同仅测试机制，绝不作为兼容证据。标准生成 CLI 无候选参数或环境变量后门。
+
+## 官方依据
+
+- [Boot 2.7 系统要求](https://docs.spring.io/spring-boot/docs/2.7.18/reference/html/getting-started.html#getting-started.system-requirements)：Java 8 起，默认 Tomcat 9 / Servlet 4.0。
+- [Boot 3.5 系统要求](https://docs.spring.io/spring-boot/3.5/system-requirements.html)：Java 17 起，Spring Framework 6.2，默认 Tomcat 10.1 / Servlet 6.0。
+- [Boot 4.1.1 系统要求](https://docs.spring.io/spring-boot/system-requirements.html)：Java 17 起，Spring Framework 7.0，Tomcat 11 / Servlet 6.1。
+- [Boot 4 迁移说明](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide)：模块、starter、测试及 Jackson 变化。
+- [MyBatis-Plus 安装](https://baomidou.com/getting-started/install/)：Boot 2、3、4 的 starter 坐标。
+
+- [Spring Cloud 兼容矩阵](https://spring.io/projects/spring-cloud/)：发行列车、Boot 与 OpenFeign 版本对应。
+
+以上是候选配方依据，不替代内部 YSS 组合的实际验证。
+
+## 验证绑定与安全重试
+
+新生成使用平台配置 v2；Project Scaffold Contract 仍为 v4。v1 原始记录保留只读审计，不能原样用于新生成或新的支持认证。
+
+兼容证据同时绑定 recipe_digest、generator/verifier source_fingerprint 和 generated_tree_digest。模板、Wrapper、共享生成逻辑或验证逻辑改变时，旧证据不能开放新生成；源文件摘要不包括 Skill 说明文字。输入配方与验证记录分离不代表忽略证据，报告或日志缺失、漂移、失败仍阻断。
+
+版本行按 `(profile_id, spring_boot_version, java_version)` 唯一；同一版本线新增补丁时追加行，不覆盖旧行。多个补丁存在时不得只凭 profile_id 选第一个或最新版本；合同、组合条目和矩阵输入均带精确版本。原补丁的配方和批准不会因追加新补丁而变化。
+
+依赖核验以启动模块 compile/runtime 树为准，不用其他模块或 test/provided 依赖凑齐能力；从独立解析的所选 Boot BOM 获取精确托管版本进行比较，非 Boot 管理的内部兼容版本可通过组合 `components` 映射约束。随后检查实际可执行 Jar 的 BOOT-INF/lib。Maven effective-pom 的 artifact 参数及 dependency tree JSON 行为依据 [Maven Help Plugin](https://maven.apache.org/plugins/maven-help-plugin/effective-pom-mojo.html) 和 [Dependency Plugin](https://maven.apache.org/plugins/maven-dependency-plugin/tree-mojo.html)。
+
+首次生成成功而 Maven 验证失败时，使用原输入加 `--resume`。恢复前重新验证当前合同、架构决定与工程批准，并核对 Manifest、生成文件、文件清单和生成器/验证器摘要；任一漂移即阻断，绝不覆盖用户修改或再次生成。每次验证写入新的证据目录，旧日志保留。Surefire 报告必须来自本次命令执行，旧报告或跳过测试不能补足证据。发生源码或模板变化时，请使用新候选输出目录和对应合同，不通过恢复模式覆盖旧工程。
+
+空脚手架验证的证据目录必须位于生成工程外部，避免证据文件被误认为新增源码。首切片验证在批准的切片合同通过既有门禁后复用构建检查，但记录 `verification_scope=first-slice`；其证据不能用于开放平台组合，也不要求业务代码保持空脚手架摘要。
+
+兼容条目 `components` 按 `groupId:artifactId` → 精确版本记录实际引入的 MyBatis-Plus、Springdoc、Spring Cloud 与 YSS 运行时依赖；依赖树出现未登记组件或版本不符时阻断。独立 Boot BOM 管理的组件优先按 BOM 核验。
+
+Jar 核验拒绝未登记或版本不符的额外库；仅允许 Boot 对应版本的 jarmode 工具以及已选配方中的 provided Lombok 随包出现。原因是 [Boot repackage 默认包含 provided 依赖](https://docs.spring.io/spring-boot/maven-plugin/packaging.html)；这些打包例外不能补足必须存在于 compile/runtime 树的 Web、Servlet、JSON 等能力。

package/template/docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md

@@ -8,5 +8,6 @@ Matt Pocock Engineering Skills 提供轻量的澄清、实现、TDD、诊断和
 - Matt user-invoked 的 `grill-with-docs`、`to-spec`、`to-tickets` 和 `implement` 必须由用户显式启动，任何 skill 不得自动调用它们；YSS 生命周期只准备、校验和验收其结果。所有 Matt model-invoked skill 仍须遵守 `AGENTS.md` 的阶段、门禁和证据要求，并只能在生命周期允许的工作单元中调用。
 - `code-review` 保持唯一默认审查入口。YSS 适配把 Slice `required_skills`、`alibaba-java-code-style` 与命中的 `yss-ui` / `yss-domain` 等专项 skill 编译为 Standards 检查输入，并要求实现仓已有的 `pnpm` / `./mvnw` 机器检查；禁止再增加第二个通用审查 skill 或专用审查 Cloud 环境来代替这条接线。审查 finding 按编排合同分流：实现者修复后全轴复审，或合同 `stale` 后回 实现合同编译器；审查者不得写实现。
 - `template-source` 只执行模板维护流程，不生成具体产品 Spec、原型、OpenAPI 或垂直切片 Ticket。
+- `code-review` 的 YSS 人员适配：普通功能默认一个独立 Reviewer，分别完成 Standards、Spec 与适用 UI 检查；能力缺口、冲突、外部制度或用户指定时才拆分多审查者。保留检查轴和证据，不将上游并行 Agent 形式转成固定多人会签。
 - Matt 的 `research` 已适配为 canonical `yss-research`，旧名只作为 deprecated alias。YSS 版本提供 `technical-evidence` / `strategy-evidence` profile、`quick` / `evidence-audited` 模式、证据合同和确定性校验，同时保留上游 revision 与原始 hash 以便追溯。
 - Agent 完成工作单元后返回可核验的 evidence refs、变更资产、验证命令、残余风险和下一路由。

package/template/docs/process/delivery-preflight.md

@@ -55,7 +55,7 @@
 工程接入技能在既有 Java/Maven 跨仓接入前运行 `prepare`，补证后重跑。两个导出 CLI 已在外层、任何导出写入之前复验 `export`。v5 的既有 UI 战略导出与包含既有架构身份 v2 的后端导出必须提供 `--preflight-input`；旧路径可选，原批准规则仍独立有效。以下命令中的清单必须绑定对应源文件及其当前摘要：
 
 ```sh
-scripts/strategic-handoff export --source-root /governance/source --handoff docs/handoff.yaml --output /delivery/strategy-v1 --preflight-input /inputs/strategic-preflight.json
+scripts/strategic-handoff finalize --source-root /governance/source --handoff docs/handoff.yaml --preflight-input /inputs/strategic-preflight.json
 scripts/backend-delivery export --source-root /governance/backend --delivery docs/backend-delivery.yaml --output /delivery/backend-v1 --preflight-input /inputs/backend-preflight.json
 ```
 

package/template/docs/process/frontend-backend-delivery.md

@@ -6,7 +6,7 @@
 
 战略方维护业务规则、Spec、页面流程和视觉基线；后端维护 API 及后端交付；前端维护工程设计、页面和验收证据；统一管理方维护基线引用、跨仓切片与业务验收汇总。
 
-前端消费需求可在上游设计时提前反馈。Handoff v4/v5 导入后的 Frontend Strategic Preflight 可在后端交付前完成战略输入、Context、相应 UI 基线和源规则追踪核验，并允许起草前端工程设计与实现计划；它固定返回 `ready_for_agent: false`。仅当 Backend/API/Data 影响命中时，最终接收才等待后端交付；UI-only 路径使用有依据的 `backend-not-applicable`。Slice Contract 获准前均不得写代码。
+前端消费需求可在上游设计时提前反馈。新 Handoff v5 交付目录导入后生成 Import Receipt v3；历史裸 v4/v5 包继续生成 v2。Frontend Strategic Preflight 可在后端交付前完成战略输入、Context、相应 UI 基线和源规则追踪核验，并允许起草前端工程设计与实现计划；它固定返回 `ready_for_agent: false`。仅当 Backend/API/Data 影响命中时，最终接收才等待后端交付；UI-only 路径使用有依据的 `backend-not-applicable`。Slice Contract 获准前均不得写代码。
 
 ## 后端导出与前端导入
 
@@ -36,6 +36,7 @@ Handoff v4/v5 先生成 `frontend-strategic-preflight-draft.json`；补齐正式
 |---|---|---|---|
 | Handoff v3（历史） | 原历史路径 | Acceptance v1，要求后端交付 | `visual_case_ids` |
 | Handoff v4 | Preflight v1 | Acceptance v2 | `visual_case_ids` |
+| Handoff v5 delivery | Preflight v2 | Acceptance v3 | `ui_baseline_kind`、`ui_baseline_ref`、source delivery record |
 | Handoff v5 | Preflight v2 | Acceptance v3 | `baseline_case_ids` |
 
 v5 的预检和接收都声明 `ui_baseline_kind`，必须与战略包一致。原型分支继续原视觉/原型要求；既有 UI 分支使用 [existing-ui-baseline v1](existing-ui-baseline.md)，只允许无 UI/交互/状态/权限体验改动并已取得当前基线确认的工程。真实截图不得自行升级为原型批准。

package/template/docs/process/harness-process-tailoring.md

@@ -8,6 +8,14 @@
 
 ## 1. 判定顺序
 
+普通功能采用一个推进负责人和一个独立审查者，按主要风险选择专业能力；仅在能力缺口、专业结论冲突或项目外部制度要求时增加审查者。角色表的 `countersigners` 是候选能力，不是全员签字名单。无依赖的审查可并行；同一候选的相邻检查可一次审查并逐项记录，聚合验收引用已有结论。
+
+人工暂停由决定变化触发：业务范围、关键规则、验收标准、契约承诺、授权边界、风险接受、已采纳质量标准或对外承诺发生实质变化时，展示差异后重新决定。API、数据和跨仓影响仍触发适用专业检查，但技术载体本身不要求重复人工批准。授权清单明确覆盖的范围按生命周期用户决定协议延续；未知变化先补影响分析，不默认沿用。
+
+排版、措辞和派生内容调整也必须更新当前摘要、差异说明和验证证据；独立审查证明决定依据未变后可延续，不通过忽略字节差异或修改原回复实现复用。普通实现细化补受影响测试和审查。项目外部制度未确认时不能使用自动延续；已登记的客户、公司和审计强制审批按原要求执行。
+
+违反验收/契约/已采纳质量标准、关键验证失败和关键证据缺失均阻断。个人偏好、未来优化等非阻断建议记明理由与待办去向，不新增强制门禁；未解决的重要风险须用户接受，不能改成建议绕过。
+
 1. 先读取 `yss-project.yaml`，非法、缺失或不支持的身份直接进入迁移检查。
 2. 判断是否为模板源维护、项目实例小改动、中等变更或全新产品 / 模块。
 3. 判断 UI、API、数据、后端、前端、跨仓库和高风险影响。
@@ -31,7 +39,7 @@
 
 ## 5. 上下文、反证与质量基线裁剪
 
-- Slice Contract 的 `common.context_plan` 是实现上下文的唯一轻量计划：先读 `CONTEXT.md`、已批准 Spec、当前合同和适用 ADR / 工程基线，再按影响面按需加载 references；达到最小充分证据后停止扩展。缺失权威上下文只能 `blocked` 或 `reroute`。
+- Slice Contract 的 Context Plan（v2 `common.context_plan`，v3 `scope.context_plan`） 是实现上下文的唯一轻量计划：先读 `CONTEXT.md`、已批准 Spec、当前合同和适用 ADR / 工程基线，再按影响面按需加载 references；达到最小充分证据后停止扩展。缺失权威上下文只能 `blocked` 或 `reroute`。
 - `project-instance` 的所有生命周期工作单元在批准或 `next_route` 前必须生成并校验 `context_reconciliation`；它绑定根目录唯一 `CONTEXT.md`、结构化术语引用以及全文/引用集双摘要，是横切证据而不是新增 gate。`template-source` 维护只验证模板、schema、场景和分发投影，结果记录带原因的 `not-applicable`。
 - 质量标准在 `engineering-baseline` 中定义一次，以 `baseline_id` / `baseline_version` 被 Slice Contract、YSS Skill Execution Result、`code-review` 和发布检查复用；切片不得重定义同一标准。约束结果统一写入 `constraint_results`。
 - 只有命中高风险影响时才要求 Doubt-Driven 在途反证：API / 数据迁移、跨仓契约、发布回滚、实际改变的安全行为、生命周期或生成语义。反证写入现有决策 / 架构 / 契约 / 发布审查记录，不新增生命周期阶段；缺少反证、证据不足或残余风险未处理即阻断。

package/template/docs/process/lifecycle-artifact-map.md

@@ -26,10 +26,10 @@
 
 | 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 前置门禁 / 检查 | 必须留下的证据 |
 |---|---|---|---|---|---|
-| `gate.plan-approved` | Plan 批准 | `stage.plan` | Plan 结论进入 Spec；汇总战略检查后仅确认一次当前规划范围。 | `check.domain-strategy-approved`、`check.stage-decision-package-approved` | `evidence.approval-record` |
-| `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线。 | 无 | `evidence.approval-record` |
-| `gate.product-design-approved` | 产品设计批准 | `stage.product-design` | 存在产品设计影响；独立原型评审与交付物验证通过后确认最终原型。 | `check.prototype-reviewed`、`check.prototype-verified` | `evidence.prototype-confirmation` |
-| `gate.engineering-contract-approved` | 工程契约批准 | `stage.system-data-engineering` | 存在 API、架构或工程基线影响；完成适用专业审查后统一批准，有 API 影响时同时冻结当前 OpenAPI。 | `check.openapi-draft-reviewed`、`check.design-reviewed`、`check.architecture-reviewed`、`check.engineering-baseline-accepted`、`check.openapi-frozen` | `evidence.approval-record`、`evidence.fresh-verification` |
+| `gate.plan-approved` | Plan 批准 | `stage.plan` | Plan 结论进入 Spec；汇总战略检查，核验当前规划范围的原始批准或有效授权延续。 | `check.domain-strategy-approved`、`check.stage-decision-package-approved` | `evidence.approval-record` |
+| `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线；已授权范围内细化复用当前有效授权，实质变化重新决定。 | 无 | `evidence.approval-record` |
+| `gate.product-design-approved` | 产品设计批准 | `stage.product-design` | 存在产品设计影响；独立原型评审与交付物验证通过后核验原批准或授权延续，新增体验取舍由用户决定。 | `check.prototype-reviewed`、`check.prototype-verified` | `evidence.prototype-confirmation` |
+| `gate.engineering-contract-approved` | 工程契约批准 | `stage.system-data-engineering` | 存在 API、架构或工程基线影响；组合适用专业审查后统一批准并核验授权，有 API 影响时同时冻结当前 OpenAPI；范围内细化不重复请求用户确认。 | `check.openapi-draft-reviewed`、`check.design-reviewed`、`check.architecture-reviewed`、`check.engineering-baseline-accepted`、`check.openapi-frozen` | `evidence.approval-record`、`evidence.fresh-verification` |
 | `gate.slice-contract-approved` | 切片合同批准 | `stage.ticket-formalization` | 主控在已授权范围内批准已持久化且当前的垂直切片合同；不代替就绪计算。 | 无 | `evidence.contract-approval` |
 | `gate.delivery-accepted` | 交付验收 | `stage.verification-release-retrospective` | 实现交付验收；汇总独立审查、Fresh Verification 和回滚证据，不授予合并或发布权限。 | `check.frontend-implementation-verified` | `evidence.fresh-verification`、`evidence.checkpoint-and-rollback` |
 

package/template/docs/process/lifecycle-registry-baseline.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "registry_id": "yss.lifecycle",
-  "semantic_sha256": "38ec430630bbaee2c94f5d0d3dcd31f1d5481482b8cec52e44e983e4af6b638e",
+  "semantic_sha256": "6d994e65718fd614c03519fe72377206bba11f5bc77da7aed0e0f1cd792cee88",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",