create-yss-spec 3.4.5 → 3.4.6

package/template/.agents/skills/yss-cache/scripts/check-skill-freshness.sh

@@ -6,26 +6,25 @@ skill_dir=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
 locate_source() {
   if [ "$#" -gt 0 ] && [ -n "$1" ]; then
     if [ -d "$1/yss-microservice-components/yss-component-cache-parent" ]; then
-      echo "$1"
+      (CDPATH= cd -- "$1" && pwd)
       return 0
     fi
-    return 1
   fi
-  if [ -n "${YSS_SOURCE_ROOT:-}" ] && [ -d "$YSS_SOURCE_ROOT/yss-microservice-components/yss-component-cache-parent" ]; then
-    echo "$YSS_SOURCE_ROOT"
-    return 0
-  fi
-  for candidate in "$PWD" "$PWD/.." "$HOME/Projects/yss-cloud-microservice" "$HOME/Documents/yss-project/yss-cloud-microservice"; do
-    if [ -d "$candidate/yss-microservice-components/yss-component-cache-parent" ]; then
-      (CDPATH= cd -- "$candidate" && pwd)
-      return 0
-    fi
-  done
   return 1
 }
 
-source_root=$(locate_source "${1:-}") || {
-  echo "ERROR: cannot locate yss-component-cache-parent; pass source root or set YSS_SOURCE_ROOT" >&2
+platform_line=${1:-}
+if [ "$platform_line" != "boot2-java8" ] && [ "$platform_line" != "boot3-java17" ]; then
+  echo "usage: check-skill-freshness.sh <boot2-java8|boot3-java17> [source-root]" >&2
+  exit 2
+fi
+
+configured_root=""
+if [ "$platform_line" = "boot2-java8" ]; then configured_root=${YSS_SOURCE_ROOT_BOOT2_JAVA8:-}; fi
+if [ "$platform_line" = "boot3-java17" ]; then configured_root=${YSS_SOURCE_ROOT_BOOT3_JAVA17:-}; fi
+
+source_root=$(locate_source "${2:-$configured_root}") || {
+  echo "ERROR: cannot locate yss-component-cache-parent for $platform_line; pass its source root or set the generation-specific environment variable" >&2
   exit 2
 }
 
@@ -33,9 +32,15 @@ parent="$source_root/yss-microservice-components/yss-component-cache-parent"
 annotation="$parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/ClearCache.java"
 properties="$parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheProperties.java"
 connection="$parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisConnFactoryConfig.java"
-index="$skill_dir/references/source-index.md"
+index="$skill_dir/references/source-index.$platform_line.md"
 fail=0
 
+node "$skill_dir/../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs" \
+  --skill yss-cache \
+  --platform-line "$platform_line" \
+  --source-root "$source_root" \
+  --skills-root "$skill_dir/.." || exit 1
+
 require_text() {
   file=$1
   pattern=$2

package/template/.agents/skills/yss-ddd-scaffold-generator/SKILL.md

@@ -96,7 +96,7 @@ node scripts/run_first_slice_verification.mjs \
 - Harness 内多项目布局必须使用 `apps/backend/<project>/`；`apps/backend/` 只能是生成器的父容器，`app/backend/`、`app/frontend/` 及其子路径一律拒绝。`git-submodule` gitlink、空挂载点、detached HEAD 工作树不得覆盖生成，即使传入 `--force` 也不得当成普通目录，且不得走「请显式传入 `--force`」普通目录覆盖 / rename 路径。`--output-dir` 指向 detached HEAD 子仓时不得 mkdir、staging 或生成工程。先 `git submodule update --init` 并在子仓附加分支工作树内生成。生成器必须先调用 `gitSubmoduleScaffoldViolation`，再在 exists / `--force` / rename 之前调用 `refuseGitlinkAsRegularDirectory`。
 - 不要在 skill 里硬编码用户业务字段或真实连接信息。
 - 生成后要检查依赖关系是否仍符合分层约束。
-- 生成时的静态依赖由技能注册表与 实现合同编译器 共同约束为 `yss-backend-scaffold-parent`、`alibaba-java-code-style`。生成后必须回到 实现合同编译器，并按批准切片加载 `yss-domain`、`yss-application`、`yss-repository`、`yss-mybatis`、`yss-web-controller`、`yss-dto`、`yss-exception`、`yss-validation`、`mapstruct`、`lombok`、`alibaba-java-code-style` 等实际命中的行为 skill。
+- 生成时的工程基线由本 skill 的 `references/engineering-baseline.md` 持有并绑定摘要；它不是独立 Skill。生成后必须回到 实现合同编译器，并按批准切片加载 `yss-domain`、`yss-application`、`yss-repository`、`yss-mybatis`、`yss-web-controller`、`yss-dto`、`yss-exception`、`yss-validation`、`mapstruct`、`lombok`、`alibaba-java-code-style` 等实际命中的行为 skill。
 - 验证数据库固定 H2，生产数据库 `not-bound`；后续存储接入按批准的切片合同执行。
 - 生成后的后端工程必须使用项目根目录 `./mvnw ...` 执行构建、测试、运行和 CI 验证；不得在 README、实施记录、Ticket、Review 或 Release 中默认写裸 `mvn ...`。既有仓库确实无法使用 wrapper 时，必须记录受控例外。
 - 原型确认后，`scaffold_status=required` 才能进入本 skill；本 skill 的生成边界是工程结构、POM、配置、Wrapper 和机械模板，不是业务实现。
@@ -122,7 +122,7 @@ node scripts/run_first_slice_verification.mjs \
 - 受控验证器：`scripts/run_scaffold_verification.mjs`
 - 首切片验证器：`scripts/run_first_slice_verification.mjs`
 - 模板目录：`assets/templates/`
-- Parent 工程约束使用已登记的 `references/yss-backend-scaffold-parent/`；生成后的分层实现路由见 `references/layer-skill-routing.md`
+- Parent 工程约束使用内部 `references/engineering-baseline.md`；生成后的分层实现路由见 `references/layer-skill-routing.md`。历史 `yss-backend-scaffold-parent` 仅保留迁移提示，不进入新合同。
 
 ## 阶段 7 合同
 

package/template/.agents/skills/yss-ddd-scaffold-generator/references/engineering-baseline.md

@@ -0,0 +1,53 @@
+# YSS DDD Scaffold Engineering Baseline
+
+本文件只定义脚手架工程基线和路由，不复制 Domain、Application、Repository、Web 的实现细则。
+
+## 当前可验证 Profile
+
+- Architecture: `target-domain-model`
+- Persistence: `mybatis-plus`
+- Verification database: `h2`; production database: `not-bound`
+- Platform: approved `platform_configuration` v2 from the shared backend platform catalog
+- Validation namespace: derived from that platform (`javax` for Boot 2.7; `jakarta` for Boot 3.5/4.1)
+- DTO placement: `web`
+- Repository: `yss-internal`
+
+未具备独立 fixture、受控合同和真实验证证据的组合统一为 `unsupported`。旧架构不存在可选 Profile，也不能作为回退。
+
+## 模块与依赖方向
+
+```text
+domain <- application <- web
+   ^            ^
+   |            |
+infrastructure-+
+        ^
+     bootstrap
+```
+
+- `domain`：纯 Java 领域模型、领域服务、领域事件、Domain Gateway；不得依赖 YSS DTO/Exception、Web Validation、Jackson、Swagger、MyBatis。
+- `application`：用例编排、Command / Query / Result、事务边界、Application Query Port；可以依赖 Domain 和必要的 YSS result wrapper。
+- `infrastructure`：实现 Domain Gateway / Application Query Port，拥有 PO、Mapper、持久化转换器；依赖 Domain 与 Application。
+- `adapter/web`：拥有 HTTP DTO、Controller、异常翻译、WebConvertor；只依赖 Application。
+- `bootstrap`：装配与启动，不放业务逻辑。
+
+依赖方向由 Maven Reactor、Maven Enforcer 与 ArchUnit 共同约束。MapStruct 统一使用 Spring component model，父 POM 配置 annotation processor、Lombok 与 `lombok-mapstruct-binding`。
+
+## 生成与验证
+
+- 输入是批准、持久化且当前的服务级 scaffold contract schema v4，身份为 `scaffold_request_id`，并绑定已确认的 `architecture_family=domain-driven` 架构决策、Technical Design、Data Architecture Decision v1 与真实工程合同批准；不使用 `slice_id`。历史 Manifest v2/v3 仅供验证器只读兼容。
+- 生成器严格 initialize-only：目标工程目录必须不存在，`--force`、旧项目迁移和当前模板升级均为 `unsupported`。
+- Maven 内部仓库通过命名 profile `yss-internal` 与环境变量注入；共享模板不写内部 URL 或凭据。
+- Wrapper 必须带 checksum；DEBUG 和 MyBatis stdout SQL 只允许在 `application-local.yml`。
+- `./mvnw validate`、`./mvnw test`、`./mvnw package` 全部成功只得到 `empty-scaffold-verified`。
+- 只有批准且版本当前的 golden first slice 真实组合 Domain/Application/Infrastructure/Web、通过下游 skill tree drift 校验与根 Wrapper，才能由 `run_first_slice_verification.mjs` 写入 `first-slice-verified`。
+
+## 下游权威技能
+
+- Domain：`yss-domain`
+- Application：`yss-application`
+- Persistence：`yss-repository` + `yss-mybatis`
+- Web：`yss-web-controller` + `yss-dto` + `yss-exception`
+- 横切实现约束：`yss-validation` + `mapstruct` + `lombok` + `alibaba-java-code-style`
+
+业务代码必须回到 `yss-implementation-contract-compiler`，消费批准且版本当前的 Slice Implementation Contract，并采用 `behavior-tdd`；脚手架只生成机械工程资产。

package/template/.agents/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md

@@ -1,58 +1,12 @@
 ---
 name: yss-backend-scaffold-parent
-description: YSS DDD scaffold Engineering Baseline entry for profile, module, dependency, build, and downstream-skill routing checks.
+description: 迁移历史 DDD scaffold parent 引用到 yss-ddd-scaffold-generator 的内部工程基线。
 ---
 
-# YSS DDD Scaffold Engineering Baseline
+# YSS Backend Scaffold Parent（Deprecated）
 
-本文件只定义脚手架工程基线和路由，不复制 Domain、Application、Repository、Web 的实现细则。
+本入口处于 `migration-only`，不再作为独立 Skill、capability、Recipe 或 typed dependency。DDD 工程基线由 `yss-ddd-scaffold-generator/references/engineering-baseline.md` 持有，并由生成器和首切片验证器绑定摘要。
 
-## 当前可验证 Profile
+发现旧合同、任务包或 Manifest 仍把 `yss-backend-scaffold-parent` 当作 Skill 时返回 `skill-deprecated`，将合同标记为 `stale` 后重新编译。不得静默替换、继承旧批准或自动设置 `ready-for-agent`。
 
-- Architecture: `target-domain-model`
-- Persistence: `mybatis-plus`
-- Verification database: `h2`; production database: `not-bound`
-- Platform: approved `platform_configuration` v2 from the shared backend platform catalog
-- Validation namespace: derived from that platform (`javax` for Boot 2.7; `jakarta` for Boot 3.5/4.1)
-- DTO placement: `web`
-- Repository: `yss-internal`
-
-未具备独立 fixture、受控合同和真实验证证据的组合统一为 `unsupported`。旧架构不存在可选 Profile，也不能作为回退。
-
-## 模块与依赖方向
-
-```text
-domain <- application <- web
-   ^            ^
-   |            |
-infrastructure-+
-        ^
-     bootstrap
-```
-
-- `domain`：纯 Java 领域模型、领域服务、领域事件、Domain Gateway；不得依赖 YSS DTO/Exception、Web Validation、Jackson、Swagger、MyBatis。
-- `application`：用例编排、Command / Query / Result、事务边界、Application Query Port；可以依赖 Domain 和必要的 YSS result wrapper。
-- `infrastructure`：实现 Domain Gateway / Application Query Port，拥有 PO、Mapper、持久化转换器；依赖 Domain 与 Application。
-- `adapter/web`：拥有 HTTP DTO、Controller、异常翻译、WebConvertor；只依赖 Application。
-- `bootstrap`：装配与启动，不放业务逻辑。
-
-依赖方向由 Maven Reactor、Maven Enforcer 与 ArchUnit 共同约束。MapStruct 统一使用 Spring component model，父 POM 配置 annotation processor、Lombok 与 `lombok-mapstruct-binding`。
-
-## 生成与验证
-
-- 输入是批准、持久化且当前的服务级 scaffold contract schema v4，身份为 `scaffold_request_id`，并绑定已确认的 `architecture_family=domain-driven` 架构决策、Technical Design、Data Architecture Decision v1 与真实工程合同批准；不使用 `slice_id`。历史 Manifest v2/v3 仅供验证器只读兼容。
-- 生成器严格 initialize-only：目标工程目录必须不存在，`--force`、旧项目迁移和当前模板升级均为 `unsupported`。
-- Maven 内部仓库通过命名 profile `yss-internal` 与环境变量注入；共享模板不写内部 URL 或凭据。
-- Wrapper 必须带 checksum；DEBUG 和 MyBatis stdout SQL 只允许在 `application-local.yml`。
-- `./mvnw validate`、`./mvnw test`、`./mvnw package` 全部成功只得到 `empty-scaffold-verified`。
-- 只有批准且版本当前的 golden first slice 真实组合 Domain/Application/Infrastructure/Web、通过下游 skill tree drift 校验与根 Wrapper，才能由 `run_first_slice_verification.mjs` 写入 `first-slice-verified`。
-
-## 下游权威技能
-
-- Domain：`yss-domain`
-- Application：`yss-application`
-- Persistence：`yss-repository` + `yss-mybatis`
-- Web：`yss-web-controller` + `yss-dto` + `yss-exception`
-- 横切实现约束：`yss-validation` + `mapstruct` + `lombok` + `alibaba-java-code-style`
-
-业务代码必须回到 `yss-implementation-contract-compiler`，消费批准且版本当前的 Slice Implementation Contract，并采用 `behavior-tdd`；脚手架只生成机械工程资产。
+历史 Manifest 中的 `readiness.contracts.scaffold_parent` 只允许验证器只读恢复；新 Manifest 写入 `readiness.contracts.engineering_baseline`。引用归零后删除本迁移壳，不建立 alias。

package/template/.agents/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/agents/openai.yaml

@@ -1,5 +1,5 @@
 version: 1
 interface:
-  display_name: "YSS Scaffold Parent"
-  short_description: "YSS 后端脚手架父工程、依赖与公共约定实践落地规范"
-  default_prompt: "Use $yss-backend-scaffold-parent to set up the parent project and shared conventions for a YSS backend scaffold."
+  display_name: "YSS Scaffold Parent Migration"
+  short_description: "迁移已退役的 DDD 父基线入口"
+  default_prompt: "Return skill-deprecated and migrate the historical $yss-backend-scaffold-parent reference to the internal yss-ddd-scaffold-generator engineering baseline without inheriting approval."

package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/first-slice-verification.test.mjs

@@ -34,7 +34,7 @@ async function readiness() {
   return {
     downstream_skills: downstreamSkills,
     contracts: {
-      scaffold_parent: await digest(".agents/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md"),
+      engineering_baseline: await digest(".agents/skills/yss-ddd-scaffold-generator/references/engineering-baseline.md"),
       compiler_contract: await digest(".agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml")
     },
     architecture_ruleset: "b".repeat(64)

package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/generate_scaffold.mjs

@@ -369,9 +369,9 @@ export class ScaffoldGenerator {
       const skillRoot = path.join(REPOSITORY_ROOT, ".agents", "skills", skill);
       downstream[skill] = await isFile(path.join(skillRoot, "SKILL.md")) ? await treeDigest(skillRoot) : "unavailable";
     }
-    const scaffoldParent = path.join(SKILL_ROOT, "references", "yss-backend-scaffold-parent", "SKILL.md");
+    const engineeringBaseline = path.join(SKILL_ROOT, "references", "engineering-baseline.md");
     const compilerContract = path.join(REPOSITORY_ROOT, ".agents", "skills", "yss-implementation-contract-compiler", "references", "compiler-contract.yaml");
-    const manifest = { source_fingerprint: platformSourceFingerprint(contract.architecture_family), generated_tree_digest: generatedTreeDigest(this.projectRoot, { ownership: { generated_files: generatedFiles } }), platform_verification: this.platformOptions.candidate === true ? "candidate" : "verified", platform_configuration: contract.platform_configuration, schema_version: 4, kind: "backend-scaffold", architecture_profile: contract.architecture_profile, architecture_identity: scaffoldArchitectureIdentity(contract, this.contractDigest), contract_id: this.options.contractId, contract_version: this.options.contractVersion, scaffold_request_id: contract.scaffold_request_id, architecture_family: contract.architecture_family, generator_skill: contract.generator_skill, decision_id: contract.decision_id, decision_digest: contract.decision_digest, module_profile: contract.module_profile, design_prerequisites: this.designPrerequisites, approval_ref: this.options.approvalRef, compiler_draft_ref: this.options.compilerDraftRef, persisted_ref: this.options.persistedRef, contract_file_ref: this.contractFile, contract_digest: this.contractDigest, lifecycle_approval_ref: contract.lifecycle_approval_ref, current_version: contract.current_version, approver: contract.approval.approver, allowed_write_paths: contract.allowed_write_paths, expected_evidence_files: contract.expected_evidence_files, project_name: this.projectName, base_package: this.basePackage, bootstrap_main_class: `${this.basePackage}.${this.applicationClassName}`, bootstrap_main_source: this.bootstrapMainSource, maven_coordinates: this.mavenCoordinates, maven_coordinates_source: this.mavenCoordinatesSource, profiles: this.profiles, generation_mode: "controlled-generation", completion_level: "generated", generator: { id: "yss-ddd-scaffold-generator", template_digest: await treeDigest(path.join(SKILL_ROOT, "assets")) }, ownership: { generated_files: generatedFiles, user_owned_globs: ["**/src/main/java/**", "**/src/test/java/**", "db/**"] }, readiness: { downstream_skills: downstream, contracts: { scaffold_parent: sha256(await readFile(scaffoldParent)), compiler_contract: sha256(await readFile(compilerContract)) }, architecture_ruleset: sha256(await readFile(path.join(this.javaTemplateDir, "architecture-rules-test.java.template"))) }, generation_policy: { mode: "initialize-only", existing_target: "unsupported", old_project_migration: "unsupported", template_upgrade: "unsupported" }, verification_commands: COMMANDS, generated_at: isoNow() };
+    const manifest = { source_fingerprint: platformSourceFingerprint(contract.architecture_family), generated_tree_digest: generatedTreeDigest(this.projectRoot, { ownership: { generated_files: generatedFiles } }), platform_verification: this.platformOptions.candidate === true ? "candidate" : "verified", platform_configuration: contract.platform_configuration, schema_version: 4, kind: "backend-scaffold", architecture_profile: contract.architecture_profile, architecture_identity: scaffoldArchitectureIdentity(contract, this.contractDigest), contract_id: this.options.contractId, contract_version: this.options.contractVersion, scaffold_request_id: contract.scaffold_request_id, architecture_family: contract.architecture_family, generator_skill: contract.generator_skill, decision_id: contract.decision_id, decision_digest: contract.decision_digest, module_profile: contract.module_profile, design_prerequisites: this.designPrerequisites, approval_ref: this.options.approvalRef, compiler_draft_ref: this.options.compilerDraftRef, persisted_ref: this.options.persistedRef, contract_file_ref: this.contractFile, contract_digest: this.contractDigest, lifecycle_approval_ref: contract.lifecycle_approval_ref, current_version: contract.current_version, approver: contract.approval.approver, allowed_write_paths: contract.allowed_write_paths, expected_evidence_files: contract.expected_evidence_files, project_name: this.projectName, base_package: this.basePackage, bootstrap_main_class: `${this.basePackage}.${this.applicationClassName}`, bootstrap_main_source: this.bootstrapMainSource, maven_coordinates: this.mavenCoordinates, maven_coordinates_source: this.mavenCoordinatesSource, profiles: this.profiles, generation_mode: "controlled-generation", completion_level: "generated", generator: { id: "yss-ddd-scaffold-generator", template_digest: await treeDigest(path.join(SKILL_ROOT, "assets")) }, ownership: { generated_files: generatedFiles, user_owned_globs: ["**/src/main/java/**", "**/src/test/java/**", "db/**"] }, readiness: { downstream_skills: downstream, contracts: { engineering_baseline: sha256(await readFile(engineeringBaseline)), compiler_contract: sha256(await readFile(compilerContract)) }, architecture_ruleset: sha256(await readFile(path.join(this.javaTemplateDir, "architecture-rules-test.java.template"))) }, generation_policy: { mode: "initialize-only", existing_target: "unsupported", old_project_migration: "unsupported", template_upgrade: "unsupported" }, verification_commands: COMMANDS, generated_at: isoNow() };
     await writeText(path.join(this.projectRoot, ".yss", "scaffold-generation.json"), `${JSON.stringify(manifest, null, 2)}\n`); console.log("  ✓ .yss/scaffold-generation.json");
   }
   async copyWrapperFiles() {

package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/run_first_slice_verification.mjs

@@ -97,13 +97,12 @@ async function downstreamDrift(manifest, requiredSkills = REQUIRED_SKILLS) {
   }
   const contracts = manifest.readiness?.contracts ?? {};
   const contractFiles = {
-    scaffold_parent: path.join(REPOSITORY_ROOT, ".agents", "skills", "yss-ddd-scaffold-generator", "references", "yss-backend-scaffold-parent", "SKILL.md"),
     compiler_contract: path.join(REPOSITORY_ROOT, ".agents", "skills", "yss-implementation-contract-compiler", "references", "compiler-contract.yaml")
   };
   if (manifest.architecture_family === "layered-mvc") {
-    delete contractFiles.scaffold_parent;
     contractFiles.architecture_profiles = path.join(REPOSITORY_ROOT, "docs/agents/backend-architecture-profiles.md");
-  }
+  } else if (contracts.engineering_baseline) contractFiles.engineering_baseline = path.join(REPOSITORY_ROOT, ".agents", "skills", "yss-ddd-scaffold-generator", "references", "engineering-baseline.md");
+  else contractFiles.scaffold_parent = path.join(REPOSITORY_ROOT, ".agents", "skills", "yss-ddd-scaffold-generator", "references", "yss-backend-scaffold-parent", "SKILL.md");
   for (const [name, target] of Object.entries(contractFiles)) {
     const expected = contracts[name];
     if (typeof expected !== "string" || !/^[a-f0-9]{64}$/.test(expected)) {

package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs

@@ -54,7 +54,7 @@ function validateManifest(manifest) {
       assertArchitectureAgreement(manifest.architecture_identity, { manifest_fields: scaffoldArchitectureIdentity(manifest, manifest.contract_digest) });
     }
     const supportedArchitecture = manifest.architecture_family === "domain-driven" && manifest.generator_skill === "yss-ddd-scaffold-generator" && manifest.profiles.architecture === "target-domain-model"
-      || manifest.architecture_family === "layered-mvc" && ["yss-layered-mvc-scaffold-generator", "yss-mvc-data-analysis-project-initializer"].includes(manifest.generator_skill) && manifest.profiles.architecture === "layered-mvc";
+      || manifest.architecture_family === "layered-mvc" && manifest.generator_skill === "yss-layered-mvc-scaffold-generator" && manifest.profiles.architecture === "layered-mvc";
     if (!supportedArchitecture || manifest.module_profile?.resolution_version !== 1 || !Array.isArray(manifest.module_profile?.resolved_modules)) throw new Error("Manifest v3/v4 的架构族、生成器、Profile 或模块闭包不一致");
     if (manifest.schema_version === 4 && (!manifest.design_prerequisites?.technical_design || !manifest.design_prerequisites?.data_architecture_decision || !manifest.design_prerequisites?.engineering_contract_approval_ref)) throw new Error("Manifest v4 缺少设计门禁绑定");
   } else if (manifest.profiles.architecture !== "target-domain-model") throw new Error("历史 Manifest v2 只读兼容仅支持 target-domain-model");

package/template/.agents/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs

@@ -149,7 +149,7 @@ async function prepareVerifierProject(project, manifest = targetManifest()) {
   await writeFile(path.join(project, ".yss", "scaffold-generation.json"), `${JSON.stringify(manifest)}\n`);
 }
 
-test("生成批准的服务级 target profile 骨架，并写入带设计门禁的 Manifest v4", async (t) => { const data = await fixture(); t.after(() => rm(data.root, { recursive: true, force: true })); const result = await command(data.args); assert.equal(result.code, 0, result.stderr); const project = path.join(data.output, "demo-service"); const manifest = JSON.parse(await readFile(path.join(project, ".yss/scaffold-generation.json"), "utf8")); assert.equal(manifest.schema_version, 4); assert.equal(manifest.architecture_family, "domain-driven"); assert.equal(manifest.generator_skill, "yss-ddd-scaffold-generator"); assert.equal(manifest.decision_id, "scaffold-decision.demo-service"); assert.equal(manifest.scaffold_request_id, "scaffold-request-1"); assert.equal(manifest.slice_id, undefined); assert.equal(manifest.completion_level, "generated"); assert.equal(manifest.profiles.architecture, "target-domain-model"); assert.deepEqual(manifest.design_prerequisites, { ...data.contract.design_prerequisites, data_architecture_decision: { ...data.contract.design_prerequisites.data_architecture_decision, impact: "not-applicable" } }); assert.deepEqual(manifest.generation_policy, { mode: "initialize-only", existing_target: "unsupported", old_project_migration: "unsupported", template_upgrade: "unsupported" }); assert.match(manifest.generator.template_digest, /^[a-f0-9]{64}$/); assert.match(manifest.contract_digest, /^[a-f0-9]{64}$/); assert.ok(manifest.ownership.generated_files.length > 8); assert.ok(manifest.ownership.generated_files.every((item) => item.owner === "generator" && /^[a-f0-9]{64}$/.test(item.sha256))); assert.equal(manifest.generation_mode, "controlled-generation"); assert.deepEqual(manifest.verification_commands, ["./mvnw validate", "./mvnw test", "./mvnw package"]); assert.equal(manifest.bootstrap_main_class, "com.yss.demo.DemoServiceApplication"); assert.equal(manifest.bootstrap_main_source, "demo-service-bootstrap/src/main/java/com/yss/demo/DemoServiceApplication.java"); assert.match(await readFile(path.join(project, manifest.bootstrap_main_source), "utf8"), /class DemoServiceApplication/); assert.match(await readFile(path.join(project, "pom.xml"), "utf8"), /demo-service/); assert.equal(manifest.readiness.downstream_skills["yss-domain"], await treeDigest(path.resolve(scripts, "../../yss-domain"))); assert.match(manifest.readiness.contracts.scaffold_parent, /^[a-f0-9]{64}$/); assert.match(manifest.readiness.contracts.compiler_contract, /^[a-f0-9]{64}$/); });
+test("生成批准的服务级 target profile 骨架，并写入带设计门禁的 Manifest v4", async (t) => { const data = await fixture(); t.after(() => rm(data.root, { recursive: true, force: true })); const result = await command(data.args); assert.equal(result.code, 0, result.stderr); const project = path.join(data.output, "demo-service"); const manifest = JSON.parse(await readFile(path.join(project, ".yss/scaffold-generation.json"), "utf8")); assert.equal(manifest.schema_version, 4); assert.equal(manifest.architecture_family, "domain-driven"); assert.equal(manifest.generator_skill, "yss-ddd-scaffold-generator"); assert.equal(manifest.decision_id, "scaffold-decision.demo-service"); assert.equal(manifest.scaffold_request_id, "scaffold-request-1"); assert.equal(manifest.slice_id, undefined); assert.equal(manifest.completion_level, "generated"); assert.equal(manifest.profiles.architecture, "target-domain-model"); assert.deepEqual(manifest.design_prerequisites, { ...data.contract.design_prerequisites, data_architecture_decision: { ...data.contract.design_prerequisites.data_architecture_decision, impact: "not-applicable" } }); assert.deepEqual(manifest.generation_policy, { mode: "initialize-only", existing_target: "unsupported", old_project_migration: "unsupported", template_upgrade: "unsupported" }); assert.match(manifest.generator.template_digest, /^[a-f0-9]{64}$/); assert.match(manifest.contract_digest, /^[a-f0-9]{64}$/); assert.ok(manifest.ownership.generated_files.length > 8); assert.ok(manifest.ownership.generated_files.every((item) => item.owner === "generator" && /^[a-f0-9]{64}$/.test(item.sha256))); assert.equal(manifest.generation_mode, "controlled-generation"); assert.deepEqual(manifest.verification_commands, ["./mvnw validate", "./mvnw test", "./mvnw package"]); assert.equal(manifest.bootstrap_main_class, "com.yss.demo.DemoServiceApplication"); assert.equal(manifest.bootstrap_main_source, "demo-service-bootstrap/src/main/java/com/yss/demo/DemoServiceApplication.java"); assert.match(await readFile(path.join(project, manifest.bootstrap_main_source), "utf8"), /class DemoServiceApplication/); assert.match(await readFile(path.join(project, "pom.xml"), "utf8"), /demo-service/); assert.equal(manifest.readiness.downstream_skills["yss-domain"], await treeDigest(path.resolve(scripts, "../../yss-domain"))); assert.match(manifest.readiness.contracts.engineering_baseline, /^[a-f0-9]{64}$/); assert.match(manifest.readiness.contracts.compiler_contract, /^[a-f0-9]{64}$/); });
 
 test("数据影响为 required 时绑定数据架构后可生成 DDD 后端", async (t) => {
   const data = await fixture({ dataImpact: "required" });

package/template/.agents/skills/yss-distributed-id/SKILL.md

@@ -67,3 +67,7 @@ description: "接入或排查 YSS 分布式 ID：Leaf、CosId、号段、雪花
 - 拦截器与自动注入：`assets/AutoIdInterceptor.java`
 - 启用注解：`assets/EnableDistributedId.java`
 - Leaf 配置相关：`assets/LeafConf.java`
+
+## 平台与源码门禁
+
+接入、修改、代码生成或给出精确类名/配置前，读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md)，从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`，并以 `--skill yss-distributed-id --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号，或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`；不得回退另一代索引，也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续，但不得据此宣称跨 Boot/JDK 兼容。

package/template/.agents/skills/yss-distributed-id/references/source-index.boot2-java8.md

@@ -0,0 +1,102 @@
+# yss-distributed-id Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot2-java8`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `a3be2b2e33dca4545782e2b31894aaa00d0305cd`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-distributed-id`: `ac54e61f980cfea3e0a574b0559b5fc6a6ccb9f6`
+Component tree `yss-microservice-components/yss-component-leaf`: `8d2e4a0e6244edcbe6f4ee736b6b5d6f3bd10462`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT2_JAVA8` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-distributed-id` (existed when indexed)
+- `yss-microservice-components/yss-component-leaf` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-distributed-id/readme.md`
+- `yss-microservice-components/yss-component-leaf/README.md`
+- `yss-microservice-components/yss-component-leaf/TECHNICAL_DESIGN.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-distributed-id/pom.xml` — GAV `com.yss.cloud:yss-component-distributed-id:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/pom.xml` — GAV `com.yss.cloud:yss-component-leaf:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-feign:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-grpc-lib:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-grpc:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-rest:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:2.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `1.8`.
+- Inherited Spring Boot signals: `2.7.18`.
+- Namespace source signals: `javax.*` in 11 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 4 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedId.java` — `sha256:b5d2c455ae8ed874ef1c38a0de9b78f92c3e26746a27e5552b4f91e29714d221`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedImportSelector.java` — `sha256:612e6d105996705e5ee368bf960f9c60abc5bae67070ba3b3f81203ccc1c75f6`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/ApplicationContextHelper.java` — `sha256:42e0eb8ceca2c668b528cbe71f637be7f49213c33232920aea6b49c3f458a271`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SegmentContextHelper.java` — `sha256:0b4b89c9e9c47ae66a1f9c034aed8314f38943096b352dd8410c33b88a3dfd61`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SnowflakeContextHelper.java` — `sha256:c582d0d70a0a1ac364d14f32d2e1fb6fbf082249e6f81a21db30a930d4d098e8`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdInjectionModeGuard.java` — `sha256:66e5f36d6541c7b9484f45eb9edd52b82fac67363fb67e43d1542ec57a3855c1`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdProperties.java` — `sha256:7f897277084c285dc0da7a29a50ea6f768130588371379478171317cd079f58a`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafConf.java` — `sha256:daf2b2275315853f935aa208600954762fc78a60833270ca4485ed093838f835`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDataSourceConfiguration.java` — `sha256:1c178fbaedc3f8e208c524111a0453d7a2d849602214b878e5e90de84b96d3c5`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDatabaseType.java` — `sha256:d2abc8043adeebd78cdb903e0d5f92f590535b678d66c49c0d67e753f5597a3a`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafSegmentProperties.java` — `sha256:6258a6c245b16435a074bac58b611afc8b72ed5a28a06f8721ab0eca68478c56`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/MissingTagPolicy.java` — `sha256:3a11f9d495782ee7635a0fc11072e623da0423969c554485b917dbacd1465740`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/SnowflakeProperties.java` — `sha256:2950793334c15bbce18df2b8adc56c68b831f482acce8abe6f492e84639a6fca`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdErrorCode.java` — `sha256:8a53ef6f433c1795edb04dbb461ebb3e4a5b095cfdec35575fa66ed32da4db61`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdException.java` — `sha256:8972158d5c1837de9846b23d0682c4665dd7ccc6ba0ecfd600435a67defaf4c3`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafServerException.java` — `sha256:da32dc4ddff2a62bed44e97e2786c673315914006e992468f550986d855c4176`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/health/LeafSegmentHealth.java` — `sha256:d193ab669c34310eb9c9effbfcf2bb0de338d61b23b8378834767e2d230594a1`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/PropertyFactory.java` — `sha256:e7753cfb9348e0aa5e0fefa35a35f8da79a7e1a91186ad730ce327ea2570f8e2`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Result.java` — `sha256:cdeac0dc2aa0eeceaead71a1c9e24bb3c4ff8bf561f4631b6341e9527fb50f89`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Status.java` — `sha256:d9d404e6d1365107319088f0ec9134e17007ef520b9eebd3187e3fba38255530`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/dao/IDAllocMapper.java` — `sha256:9e70ab20d7426f8b034e1a732a91ad407aae6fc6e569b31e2ccd152dbb6f0f22`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/model/LeafAlloc.java` — `sha256:4bcd56bece377f15742f2992ac885f11dd17507255ebbd9c71d86bbe84d36e5b`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentity.java` — `sha256:d616299dc0417773a2e0066586fc8cfd09f163f9d6cd3db32be59314bd8d1595`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentityResolver.java` — `sha256:d4526129ec46ff98cb5f65e9739d14ed74a4286767e03f9a9f103f4e82848361`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/metrics/LeafSegmentMetrics.java` — `sha256:384a14d41d36993e905355ece4c18ccf6ed95ae82b553b5f4abe3f3484dd1d96`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/AutoIdInterceptor.java` — `sha256:00dd96d6c417c51b67caf1327299e8ed6df48000a1e84657567f87b7081f62b2`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/DistributedIdIdentifierGenerator.java` — `sha256:115120256be8d81fe1ab784b1ffa01c848fc9f8ebdacb3a2bbe9ecd4407e1556`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java` — `sha256:4296d8a97c65fc6c8a8c7b291b2131ecaf005ca926f37dada5cef69bc11aad87`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/context/RestGenIdContextHelper.java` — `sha256:a4dfe39cdc9c878e4453097ba20280759836aabb896748b89b49a0fdf134e7f5`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/feign/YssIdGenFeign.java` — `sha256:899b1eaf778b08379617fe55d768239bd262737ea04a69d4309c40344802613c`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/mybatis/FeignAutoIdInterceptor.java` — `sha256:9b1f9a0e67a810aeed7d4b83df551a091ba43bdecbe66a94b0219d2ab1835643`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdRequest.java` — `sha256:fd34127effa2d9bb050965970bf8f8f287c5d2b307f729a7e8748d6aa4ec3758`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdRequestOrBuilder.java` — `sha256:2461652786b1361680df213ac1834bde55f5acfd678c97215ec4a829c9e1f3ac`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdResponse.java` — `sha256:5391e7d495482142686655fd61d39f40f00296791cf462c505cdd115c96b1d77`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/GenerateUniqueIdResponseOrBuilder.java` — `sha256:996f71a4a23461aabb667b8993df8c123f153dad479defef6766295273fbffef`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/IdGenType.java` — `sha256:64f814384fc035157836f4378aa8f374cc3a16ae739e38cfa3f6b691647ba850`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/UniqueIdProto.java` — `sha256:3b5b48aeabe85aa6728f92f56d891f896043b6d45e669429c16842138d755224`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/grpc/protobuf/UniqueIdServiceGrpc.java` — `sha256:afdf6bec97a31e5dfa131cfb4311c9c6bbe0d9bf2cbeff8eb415a307f831a692`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/leaf/context/GrpcClientService.java` — `sha256:e00151ad4524471a1806175a12aec6f6fd531a0014f47231de3cd863fb210de9`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc-lib/src/main/java/com/yss/cloud/leaf/context/GrpcGenIdContextHelper.java` — `sha256:a8e333c0719eb2195300accfedb425ae038d831da067936500830f173f9977bd`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java` — `sha256:4500e6a0683e157e706883220d747fad486b6cb9a1d0e14d2f5af46369205b46`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-grpc/src/main/java/com/yss/cloud/leaf/service/UniqueIdService.java` — `sha256:b3d43c01c0e0d619f935482d74df80230db65415b9a423c0c94417c9e5f44e24`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/conf/YssLeafRestConfiguration.java` — `sha256:963bca50c347ede15b7d6a499f463804834ec03733c3aa0a5f880c2587823888`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/IdGenController.java` — `sha256:9402efdba8c3e1bc7eef0a2f476abf82538f6e1fbe6106d2790238625f29f86b`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/LeafIdRestResponseFactory.java` — `sha256:582e20e26730a28289c8013a127b9233ab1a1b7832b7aeaab9dae5eb3a974595`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSegmentHealthIndicator.java` — `sha256:5fcdb06f0bf598d3a39f752b7c1632c9a3d766279d179c84ca5414222e349c23`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSnowflakeHealthIndicator.java` — `sha256:ae6863606aeaab444648eb70c5f0d11806d1ae8ec3391d538eba5c48279bc15f`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT2_JAVA8`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot2-java8 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-distributed-id/references/source-index.boot3-java17.md

@@ -0,0 +1,90 @@
+# yss-distributed-id Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot3-java17`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `5041c41fbe96c25821bbc15f688c0521b8c97a3d`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-distributed-id`: `5293a06ff3cd454cb50175d3a49af2023e8cafaa`
+Component tree `yss-microservice-components/yss-component-leaf`: `b8d273f3bd031ef4d362bd9c02648414e469211f`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT3_JAVA17` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-distributed-id` (existed when indexed)
+- `yss-microservice-components/yss-component-leaf` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-distributed-id/readme.md`
+- `yss-microservice-components/yss-component-leaf/README.md`
+- `yss-microservice-components/yss-component-leaf/TECHNICAL_DESIGN.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-distributed-id/pom.xml` — GAV `com.yss.cloud:yss-component-distributed-id:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/pom.xml` — GAV `com.yss.cloud:yss-component-leaf:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-feign:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/pom.xml` — GAV `com.yss.cloud:yss-cloud-leaf-rest:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-leaf:3.1.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `17`.
+- Inherited Spring Boot signals: `3.5.16`.
+- Namespace source signals: `javax.*` in 3 main Java files; `jakarta.*` in 6 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 3 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedId.java` — `sha256:68ae8f0db23a84a4a8314b1ec66b974212c30e4522453e55739f269b3c8a977e`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/EnableDistributedImportSelector.java` — `sha256:5a4af9da1614ac82540a03cf0eae6ff361738d1b10a1b4336fdeef5ee545c6a3`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/id/DistributedIdGenerator.java` — `sha256:76d5f585b7a73435968be19d7d1e96fb36b87f3ebb062d771cbf6c05b03e9f45`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/ApplicationContextHelper.java` — `sha256:6f11dbad0f445687c8cb53b05573b2495678713003eb6bc8bf84902aad4e88a0`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SegmentContextHelper.java` — `sha256:bc88eedcec63a593b770b9acfd7e8e27d230e91ccfd46b1a21f7772111f118f4`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/SnowflakeContextHelper.java` — `sha256:cdb301faa39ca777a25b812e7b6100fae78f8914950620202e299f3b720c10dd`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdInjectionModeGuard.java` — `sha256:2964d8f08ce82c8e73a200f001ace45ce6969de3a8fe592654e7d8851b6b9eb5`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/DistributedIdProperties.java` — `sha256:6b3b5bc9aad62c053b9c9f98ad42ccab988c2763e33634feded4b201c57bb88f`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafConf.java` — `sha256:daf2b2275315853f935aa208600954762fc78a60833270ca4485ed093838f835`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDataSourceConfiguration.java` — `sha256:4876c09cc8ef6b4247f5f5e484d33f62e0317ea096bcfc8110fed39e19d1fcc2`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafDatabaseType.java` — `sha256:d2abc8043adeebd78cdb903e0d5f92f590535b678d66c49c0d67e753f5597a3a`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/LeafSegmentProperties.java` — `sha256:6258a6c245b16435a074bac58b611afc8b72ed5a28a06f8721ab0eca68478c56`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/MissingTagPolicy.java` — `sha256:3a11f9d495782ee7635a0fc11072e623da0423969c554485b917dbacd1465740`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/config/SnowflakeProperties.java` — `sha256:2950793334c15bbce18df2b8adc56c68b831f482acce8abe6f492e84639a6fca`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdErrorCode.java` — `sha256:8a53ef6f433c1795edb04dbb461ebb3e4a5b095cfdec35575fa66ed32da4db61`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafIdException.java` — `sha256:8972158d5c1837de9846b23d0682c4665dd7ccc6ba0ecfd600435a67defaf4c3`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/exception/LeafServerException.java` — `sha256:da32dc4ddff2a62bed44e97e2786c673315914006e992468f550986d855c4176`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/health/LeafSegmentHealth.java` — `sha256:d193ab669c34310eb9c9effbfcf2bb0de338d61b23b8378834767e2d230594a1`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/PropertyFactory.java` — `sha256:e7753cfb9348e0aa5e0fefa35a35f8da79a7e1a91186ad730ce327ea2570f8e2`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Result.java` — `sha256:cdeac0dc2aa0eeceaead71a1c9e24bb3c4ff8bf561f4631b6341e9527fb50f89`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/common/Status.java` — `sha256:d9d404e6d1365107319088f0ec9134e17007ef520b9eebd3187e3fba38255530`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/dao/IDAllocMapper.java` — `sha256:9e70ab20d7426f8b034e1a732a91ad407aae6fc6e569b31e2ccd152dbb6f0f22`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/segment/model/LeafAlloc.java` — `sha256:4bcd56bece377f15742f2992ac885f11dd17507255ebbd9c71d86bbe84d36e5b`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentity.java` — `sha256:d616299dc0417773a2e0066586fc8cfd09f163f9d6cd3db32be59314bd8d1595`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/inf/leaf/snowflake/SnowflakeNodeIdentityResolver.java` — `sha256:d4526129ec46ff98cb5f65e9739d14ed74a4286767e03f9a9f103f4e82848361`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/metrics/LeafSegmentMetrics.java` — `sha256:384a14d41d36993e905355ece4c18ccf6ed95ae82b553b5f4abe3f3484dd1d96`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/AutoIdInterceptor.java` — `sha256:77291b4ac85b47a57c923be3b4f553ced461cbf0afe9e8aecd799b3ef47155fc`
+- `yss-microservice-components/yss-component-distributed-id/src/main/java/com/yss/cloud/sankuai/mybatis/DistributedIdIdentifierGenerator.java` — `sha256:01316bb9c650c0b5d14b8b209bc17afc1802b65045df9371e4ffd196821ad582`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/conf/YssCloudLeafAutoConfiguration.java` — `sha256:4296d8a97c65fc6c8a8c7b291b2131ecaf005ca926f37dada5cef69bc11aad87`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/context/RestGenIdContextHelper.java` — `sha256:0fe5b875c8c1024220ebff5fa21e85ab240b95376fd4963170ab4e7aad2b7cdb`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/feign/YssIdGenFeign.java` — `sha256:899b1eaf778b08379617fe55d768239bd262737ea04a69d4309c40344802613c`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-feign/src/main/java/com/yss/cloud/leaf/mybatis/FeignAutoIdInterceptor.java` — `sha256:799fd6d4d3364ff7434bbde21330001388a4fc1ae1924ecea5bdb624dd008c49`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/conf/YssLeafRestConfiguration.java` — `sha256:963bca50c347ede15b7d6a499f463804834ec03733c3aa0a5f880c2587823888`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/IdGenController.java` — `sha256:9402efdba8c3e1bc7eef0a2f476abf82538f6e1fbe6106d2790238625f29f86b`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/controller/LeafIdRestResponseFactory.java` — `sha256:582e20e26730a28289c8013a127b9233ab1a1b7832b7aeaab9dae5eb3a974595`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSegmentHealthIndicator.java` — `sha256:5fcdb06f0bf598d3a39f752b7c1632c9a3d766279d179c84ca5414222e349c23`
+- `yss-microservice-components/yss-component-leaf/yss-cloud-leaf-rest/src/main/java/com/yss/cloud/leaf/health/LeafSnowflakeHealthIndicator.java` — `sha256:ae6863606aeaab444648eb70c5f0d11806d1ae8ec3391d538eba5c48279bc15f`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT3_JAVA17`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot3-java17 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.