create-yss-spec 2.1.5 → 2.1.6

package/template/.hermes/skills/yss-log/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-log Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-mybatis/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-mybatis Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-page-module-development/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-page-module-development Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.hermes/skills/yss-product-lifecycle/SKILL.md

@@ -33,6 +33,8 @@ YSS 仓库以本 skill 为直接入口，不机械嵌套调用 `ask-matt`。`ask
 - 安全 / 权限不设独立生命周期资料、专属门禁或 `not-applicable` 记录。只有需求或冻结资产明确要求改变认证、授权、租户隔离、敏感数据或合规行为时，才把该行为写入普通 Spec、API、架构、验收和测试 seam，并仅按实际 UI、API、Backend、Data、High-risk 影响触发既有门禁；普通 action 注册、沿用认证中间件、未变化的 `401` / `403`、一般字段、SQL / DDL / 迁移和上传 / 下载本身不触发安全 / 权限流程。
 - 有效 `yss-project.yaml` 存在时，`ask-matt` 和 `setup-matt-pocock-skills` 只能作为子流程；最终入口、仓库身份和模式裁决归本编排器。
 - `template-source` 命中产品 flow 时必须返回 `blocked`（`template-source-product-artifact-forbidden`），不得继续到产品资产或 Ticket 生成。
+- `template-source` 迁移共享工具或验证器前，先区分维护侧构建资产、实例分发面和实例运行资产；冻结公开入口、运行时前提、旧实现处置和跨仓消费者契约后，才可改写实现。
+- 替换自身验证门禁时，不得只用候选门禁自证；必须保留独立 baseline oracle 或同一 fixture 的双跑证据。涉及共享运行资产时，只有生成/同步实例、失败回滚和跨仓消费者的 fresh evidence 齐备，才能声明生态完成或可发布。
 - 文件存在不等于就绪。按内容、审查结论和上游新鲜度评估资产。
 - 父 Ticket/checkpoint 的状态只是索引；与真实资产冲突时，以权威资产为准并修复索引。
 - 上游变化按依赖图精准传播 `stale`；不要无条件重跑完整阶段。

package/template/.hermes/skills/yss-resilience4j/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-resilience4j Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-security-algorithm/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-security-algorithm Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-source-index/SKILL.md

@@ -24,7 +24,7 @@ Run:
 ```bash
 export YSS_SKILLS_ROOT="/path/to/.agents/skills"
 export YSS_SOURCE_ROOT="/path/to/yss-cloud-microservice"
-python3 "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.py"
+node "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.mjs"
 ```
 
 Backend-only refreshes may set `YSS_REFRESH_FRONTEND=false` to avoid unrelated frontend timestamp churn.
@@ -56,8 +56,8 @@ Before exact class/config/security guidance, compare the index `Source commit` w
 
 ## After Refresh
 
-Validate changed skills with:
+Validate the migrated Node helper with:
 
 ```bash
-python3 /path/to/skill-creator/scripts/quick_validate.py /path/to/.agents/skills/yss-source-index
+node --test "$YSS_SKILLS_ROOT/yss-source-index/scripts/refresh-yss-skill-index.test.mjs"
 ```

package/template/.hermes/skills/yss-source-index/scripts/refresh-yss-skill-index.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process";
+import { access, mkdir, readdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BACKEND = {"yss-cache":["yss-microservice-components/yss-component-cache-parent"],"yss-mybatis":["yss-microservice-components/yss-component-persistence"],"yss-dto":["yss-microservice-components/yss-component-dto"],"yss-audit-log":["yss-microservice-components/yss-component-audit-log"],"yss-excel-mvc":["yss-microservice-components/yss-component-excel-mvc","yss-microservice-components/yss-component-excel-starter"],"yss-distributed-id":["yss-microservice-components/yss-component-distributed-id","yss-microservice-components/yss-component-leaf"],"yss-jdbc":["yss-microservice-components/yss-component-jdbc"],"yss-dictionary":["yss-microservice-components/yss-component-dictionary-parent"],"yss-log":["yss-microservice-components/yss-component-log-starter"],"yss-resilience4j":["yss-microservice-components/yss-component-resilience4j-starter"],"yss-taskflow":["yss-microservice-components/yss-component-taskflow"],"yss-validation":["yss-microservice-components/yss-component-validation-engine-parent","yss-microservice-components/yss-component-validation-jsr303"],"yss-security-algorithm":["yss-microservice-components/yss-component-security-algorithm"],"yss-userinfo":["yss-microservice-components/yss-component-userinfo-starter"],"yss-variable":["yss-microservice-components/yss-component-variable"],"yss-exception":["yss-microservice-components/yss-component-exception"],"yss-valuation":["yss-microservice-components/yss-component-valuation"]};
+const FRONTEND={"yss-ui":["components","hooks","skills"],"yss-components":["components"],"yss-hook":["hooks"],"yss-page-module-development":["components","hooks","skills"],"yss-use-table-height":["hooks"],"yss-use-tree-height":["hooks"]};
+const URLS={components:"http://192.168.164.27:3200/components",hooks:"http://192.168.164.27:3200/hooks",skills:"http://192.168.164.27:3200/skills"};
+const KEYS=["Audit","Cache","Clear","Command","Configuration","Controller","DTO","Data","Enable","Excel","Handler","Interceptor","Jdbc","Mapper","Mybatis","Page","Properties","Query","Repository","Request","Response","Result","Update","Aspect","Leaf","Id","Dir","Dic","Dictionary","File","Upload","Log","Message","Mail","Liquibase","Circuit","Breaker","Sql","Tpl","Tag","Task","Flow","Report","Validation","Validator","Security","Crypto","User","Variable","Quality","Search","Similarity","Scheduler","Runner","Duck","Dynamic","Factory","Client","Feign","Gateway","Convertor","Adapter","Advice","Bridge","Route","Uploader","Sftp","Minio","Parser","Express","Rule","Template","Generator","Importer","Engine","Event","Submitter","Executor","Context","Status","Type","State"];
+const DOCS=new Set(["README.md","readme.md","HELP.md","TECHNICAL_DESIGN.md"]);
+const exists=async p=>{try{await access(p);return true}catch{return false}};
+async function walk(root){if(!await exists(root))return[];const out=[];for(const item of await readdir(root,{withFileTypes:true})){const p=path.join(root,item.name);if(item.isDirectory())out.push(...await walk(p));else if(item.isFile())out.push(p)}return out}
+const relative=(root,p)=>{const value=path.relative(root,p);return value&&!value.startsWith("..")?value:p};
+function state(root){try{const run=args=>execFileSync("git",["-C",root,...args],{encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim();return[run(["rev-parse","HEAD"]),run(["status","--porcelain"])?"dirty":"clean"]}catch{return["unavailable","unknown"]}}
+async function sourceRoot(){if(process.env.YSS_SOURCE_ROOT){const root=path.resolve(process.env.YSS_SOURCE_ROOT);if(await exists(path.join(root,"yss-microservice-components")))return root;throw new Error(`YSS_SOURCE_ROOT must point to the repository root containing \`yss-microservice-components\`: ${root}`)}const home=os.homedir(),candidates=[process.cwd(),...ancestors(process.cwd()),path.join(home,"Documents/yss-project/yss-cloud-microservice"),path.join(home,"Documents/yss-project"),path.join(home,"Projects/yss-cloud-microservice"),path.join(home,"Projects")];for(const base of [path.join(home,"Projects"),path.join(home,"Documents"),path.join(home,"Documents/yss-project")])if(await exists(base))for(const entry of await readdir(base,{withFileTypes:true}))if(entry.isDirectory())candidates.push(path.join(base,entry.name));for(const root of candidates)if(await exists(path.join(root,"yss-microservice-components")))return path.resolve(root);throw new Error("Could not find a YSS source repository containing `yss-microservice-components`. Export YSS_SOURCE_ROOT=/absolute/path/to/yss-cloud-microservice and rerun.")}
+function ancestors(start){const out=[];let current=path.resolve(start);while(path.dirname(current)!==current){current=path.dirname(current);out.push(current)}return out}
+async function files(bases){const out={docs:[],poms:[],java:[]};for(const base of bases)for(const p of await walk(base)){if(DOCS.has(path.basename(p)))out.docs.push(p);else if(path.basename(p)==="pom.xml")out.poms.push(p);else if(p.endsWith(".java")&&p.includes(`${path.sep}src${path.sep}main${path.sep}java${path.sep}`))out.java.push(p)}for(const a of Object.values(out))a.sort();return out}
+export async function refresh({skillsRoot,source,now=new Date().toISOString(),frontend=true}){const [commit,worktree]=state(source);for(const [skill,parts]of Object.entries(BACKEND)){const bases=parts.map(item=>path.join(source,item));const found=await files(bases);const java=found.java.filter(p=>KEYS.some(key=>path.basename(p,".java").includes(key))).slice(0,120);const list=(items,map,empty)=>items.length?items.map(map):[empty];const baseHints=await Promise.all(bases.map(async p=>`- \`${relative(source,p)}\` (${await exists(p)?"existed":"missing"} when indexed)`));const lines=[`# ${skill} Source Index`,``,`Generated: ${now}`,`Source commit: \`${commit}\``,`Source worktree: \`${worktree}\``,`Indexed source root: resolved at refresh time; set \`YSS_SOURCE_ROOT\` to reproduce or refresh.`,``,`This file is generated by \`yss-source-index/scripts/refresh-yss-skill-index.mjs\`. Do not hand-edit generated sections.`,``,`Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using \`YSS_SOURCE_ROOT\`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.`,``,`## Component Path Hints`,``,...baseHints,``,`## Documentation Files`,``,...list(found.docs,p=>`- \`${relative(source,p)}\``,"- No component documentation files found."),``,`## Maven Modules`,``,...list(found.poms,p=>`- \`${relative(source,path.dirname(p))}\``,"- No Maven modules found."),``,`## Key Java Entry Points`,``,...list(java,p=>`- \`${relative(source,p)}\``,"- No key Java entry points matched the configured name patterns."),``,`## Recommended Next Reads`,``,`- Start with the documentation files above when learning component usage.`,`- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.`,`- Prefer existing component extension points over rewriting framework logic in business modules.`,``];const target=path.join(skillsRoot,skill,"references","source-index.md");await mkdir(path.dirname(target),{recursive:true});await writeFile(target,lines.join("\n"),"utf8")}
+ if(frontend)for(const[skill,keys]of Object.entries(FRONTEND)){if(!await exists(path.join(skillsRoot,skill)))continue;const target=path.join(skillsRoot,skill,"references","frontend-docs.md");await mkdir(path.dirname(target),{recursive:true});await writeFile(target,[`# ${skill} Frontend Documentation`,``,`Generated: ${now}`,``,`Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.`,``,...keys.map(key=>`- ${key}: ${URLS[key]}`),``,`When documentation and local code differ, inspect the current project code before editing and prefer established local usage.`,``].join("\n"),"utf8")}
+ return{backend:Object.keys(BACKEND).length,frontend:frontend?Object.keys(FRONTEND).length:0}}
+async function main(){try{const script=path.dirname(fileURLToPath(import.meta.url));const result=await refresh({skillsRoot:path.resolve(process.env.YSS_SKILLS_ROOT||path.join(script,"../..")),source:await sourceRoot(),frontend:!["0","false","no"].includes((process.env.YSS_REFRESH_FRONTEND||"true").toLowerCase())});console.log(`Updated ${result.backend} backend indexes and ${result.frontend} frontend doc references.`)}catch(error){console.error(error.message);process.exitCode=1}}
+if(process.argv[1]===fileURLToPath(import.meta.url))await main();

package/template/.hermes/skills/yss-source-index/scripts/refresh-yss-skill-index.test.mjs

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { refresh } from "./refresh-yss-skill-index.mjs";
+
+test("writes Node-labelled generated indexes", async () => {
+  const root=await mkdtemp(path.join(tmpdir(),"yss-index-")); const source=path.join(root,"source"); const skills=path.join(root,"skills");
+  await mkdir(path.join(source,"yss-microservice-components/yss-component-cache-parent/src/main/java/demo"),{recursive:true}); await writeFile(path.join(source,"yss-microservice-components/yss-component-cache-parent/src/main/java/demo/CacheConfiguration.java"),"class CacheConfiguration {}");
+  for(const name of ["yss-cache","yss-ui"])await mkdir(path.join(skills,name),{recursive:true});
+  await refresh({skillsRoot:skills,source,now:"2026-01-01T00:00:00Z"});
+  assert.match(await readFile(path.join(skills,"yss-cache/references/source-index.md"),"utf8"),/refresh-yss-skill-index\.mjs/);
+  assert.match(await readFile(path.join(skills,"yss-ui/references/frontend-docs.md"),"utf8"),/components/);
+});

package/template/.hermes/skills/yss-taskflow/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-taskflow Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-ui/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-ui Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.hermes/skills/yss-use-table-height/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-use-table-height Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.hermes/skills/yss-use-tree-height/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-use-tree-height Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
 

package/template/.hermes/skills/yss-userinfo/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-userinfo Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-validation/references/source-index.md

@@ -1,17 +1,17 @@
 # yss-validation Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 
 ## Component Path Hints
 
-- `yss-microservice-components/yss-component-validation-engine-parent` (existed when indexed)
+- `yss-microservice-components/yss-component-validation-engine-parent` (missing when indexed)
 - `yss-microservice-components/yss-component-validation-jsr303` (existed when indexed)
 
 ## Documentation Files
@@ -20,30 +20,11 @@ Paths below are source path hints captured at refresh time. If they do not exist
 
 ## Maven Modules
 
-- `yss-microservice-components/yss-component-validation-engine-parent`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser`
 - `yss-microservice-components/yss-component-validation-jsr303`
 
 ## Key Java Entry Points
 
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/bean/Properties.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/enums/ExpressParserEnum.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractAndOrNotExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/AbstractLoopExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/base/ExpressParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/AndOrConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/CatchConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/ForConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/IfConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/NotConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/SwitchConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/ThenConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/WhenConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/el/WhileConditionParser.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/factory/ExpressParserFactory.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/generator/ExpressGenerator.java`
-- `yss-microservice-components/yss-component-validation-engine-parent/validation-el-parser/src/main/java/com/dogsong/liteflow/editor/parser/selector/ParserSelector.java`
+- No key Java entry points matched the configured name patterns.
 
 ## Recommended Next Reads
 

package/template/.hermes/skills/yss-valuation/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-valuation Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 

package/template/.hermes/skills/yss-variable/references/source-index.md

@@ -1,17 +1,17 @@
 # yss-variable Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 
 ## Component Path Hints
 
-- `yss-microservice-components/yss-component-variable` (existed when indexed)
+- `yss-microservice-components/yss-component-variable` (missing when indexed)
 
 ## Documentation Files
 
@@ -19,39 +19,11 @@ Paths below are source path hints captured at refresh time. If they do not exist
 
 ## Maven Modules
 
-- `yss-microservice-components/yss-component-variable`
+- No Maven modules found.
 
 ## Key Java Entry Points
 
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/AuthorWriteHandler.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/DataListener.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/ResultCode.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/YssApiResult.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/util/SqlWildcardTransformUtil.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VarNameSpaceController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VariableController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/PageDto.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/namespace/PageNameSpaceReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskStatusResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/Excel.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableDefinitionReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableFindPageReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableImportErrorResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableListResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/OperUserDo.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Task.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Variable.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/UserFlagEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/VarTypeEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VarNameSpaceMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VariableMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/VariableService.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/impl/VariableServiceImpl.java`
+- No key Java entry points matched the configured name patterns.
 
 ## Recommended Next Reads
 

package/template/.hermes/skills/yss-web-controller/SKILL.md

@@ -5,7 +5,7 @@ description: Use when generating or refactoring YSS Web Adapter Controllers, req
 
 # yss-web-controller
 
-这是一个 Web 适配层生成型 skill。优先复用脚本 `scripts/generate_controller.py` 和模板，不手写重复 CRUD。
+这是一个 Web 适配层生成型 skill。优先复用脚本 `scripts/generate_controller.mjs` 和模板，不手写重复 CRUD。
 
 ## 何时使用
 
@@ -23,14 +23,14 @@ description: Use when generating or refactoring YSS Web Adapter Controllers, req
 1. 先确认冻结 OpenAPI/no-impact record、Application Service 接口、metadata、基础包、模块名、领域 segment、domain/web 落盘目录。
 2. 涉及 DTO / VO / CMD / Query POJO 样板代码时，加载并遵守 `lombok`。
 3. 涉及 Domain / Application Result 到 VO / DTO 或 CMD / Query 到输入模型的转换时，加载并遵守 `mapstruct`。
-4. 运行 `scripts/generate_controller.py`。
+4. 运行 `node scripts/generate_controller.mjs`。
 5. 生成后检查路径、命名、返回值包装、Application Service 引用、`@Valid`、Lombok 注解和 MapStruct WebConvertor 是否对齐项目。
 6. 对复杂接口做少量手工修正，不在 skill 中承诺自动覆盖全部业务逻辑。
 
 ## 推荐命令
 
 ```bash
-python3 scripts/generate_controller.py \
+node scripts/generate_controller.mjs \
   --metadata-file /path/metadata.json \
   --base-package com.yss.demo \
   --module-name demo \
@@ -63,7 +63,7 @@ python3 scripts/generate_controller.py \
 
 ## 按需读取
 
-- 生成脚本：`scripts/generate_controller.py`
+- 生成脚本：`scripts/generate_controller.mjs`
 - Controller 模板：`assets/templates/Controller.java.template`
 - Convertor 模板：`assets/templates/WebConvertor.java.template`
 - POJO 样板代码：`lombok`

package/template/.hermes/skills/yss-web-controller/scripts/generate_controller.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const TYPE_MAPPING = { bigint: "Long", int: "Integer", integer: "Integer", smallint: "Integer", tinyint: "Integer", number: "Long", numeric: "BigDecimal", decimal: "BigDecimal", float: "Float", double: "Double", real: "Float", varchar: "String", varchar2: "String", nvarchar2: "String", char: "String", nchar: "String", text: "String", clob: "String", nclob: "String", date: "LocalDateTime", datetime: "LocalDateTime", timestamp: "LocalDateTime", "timestamp with time zone": "LocalDateTime", boolean: "Boolean", bool: "Boolean", bit: "Boolean", json: "String", jsonb: "String", uuid: "String" };
+const required = ["metadata-file", "base-package", "module-name", "domain-segment"];
+const valued = new Set([...required, "output-dir", "domain-project-dir", "web-project-dir", "domain-output-dir", "web-output-dir", "author", "application-service-package", "validation-namespace"]);
+
+function usage() {
+  return "Usage: node generate_controller.mjs --metadata-file FILE --base-package PACKAGE --module-name NAME --domain-segment SEGMENT [--output-dir DIR] [--domain-project-dir DIR] [--web-project-dir DIR] [--domain-output-dir DIR] [--web-output-dir DIR] [--author NAME] [--force] [--application-service-package PACKAGE] [--validation-namespace javax|jakarta]";
+}
+export function parseArgs(argv) {
+  const args = { "output-dir": "./output", author: "System", "validation-namespace": "javax", force: false };
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--help" || token === "-h") return { help: true };
+    if (token === "--force") { args.force = true; continue; }
+    if (!token.startsWith("--") || !valued.has(token.slice(2))) throw new Error(`unrecognized argument: ${token}`);
+    const value = argv[++index];
+    if (!value || value.startsWith("--")) throw new Error(`argument ${token} requires a value`);
+    args[token.slice(2)] = value;
+  }
+  for (const key of required) if (!args[key]) throw new Error(`the following arguments are required: --${key}`);
+  if (!new Set(["javax", "jakarta"]).has(args["validation-namespace"])) throw new Error("--validation-namespace must be javax or jakarta");
+  return args;
+}
+const pascal = (value) => value.toLowerCase().split("_").map((part) => part ? part[0].toUpperCase() + part.slice(1) : "").join("");
+const lowerCamel = (value) => { const output = pascal(value); return output ? output[0].toLowerCase() + output.slice(1) : ""; };
+const kebab = (value) => value.toLowerCase().replaceAll("_", "-");
+const packagePath = (value) => value.replaceAll(".", path.sep);
+const ensureSubdir = (root, name) => path.basename(path.normalize(root)) === name ? root : path.join(root, name);
+const javaType = (sqlType = "") => TYPE_MAPPING[sqlType.toLowerCase().split("(")[0]] || "String";
+
+function fields(columns, { skipPk = false, command = false, skipAudit = true } = {}) {
+  const audit = new Set(["create_time", "update_time", "create_by", "update_by", "deleted", "version"]);
+  return columns.filter((column) => !(skipPk && column.primary) && !(skipAudit && audit.has(String(column.name).toLowerCase()))).map((column) => {
+    const type = javaType(column.sql_type);
+    const name = lowerCamel(column.name);
+    const comment = column.comment || "";
+    const documentation = comment ? `    /**\n     * ${comment}\n     */\n` : "";
+    const validation = command && !column.nullable ? `    @${type === "String" ? "NotBlank" : "NotNull"}(message = \"${comment || name}不能为空\")\n` : "";
+    return `${documentation}${validation}    private ${type} ${name};`;
+  }).join("\n\n");
+}
+function render(template, context) { return template.replace(/\$(?:\{([A-Za-z_][A-Za-z0-9_]*)\}|([A-Za-z_][A-Za-z0-9_]*))/g, (_, braced, plain) => { const key = braced || plain; if (!(key in context)) throw new Error(`missing template field: ${key}`); return context[key]; }); }
+async function exists(target) { try { await access(target); return true; } catch { return false; } }
+
+export async function generate(args, logger = console) {
+  if (!await exists(args["metadata-file"])) throw new Error(`Metadata file not found: ${args["metadata-file"]}`);
+  let metadata;
+  try { metadata = JSON.parse(await readFile(args["metadata-file"], "utf8")); } catch (error) { throw new Error(`Error reading metadata file: ${error.message}`); }
+  const tables = metadata.tables || [];
+  if (!tables.length) { logger.warn("Warning: No tables found in metadata."); return []; }
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const templatesDir = path.resolve(scriptDir, "../assets/templates");
+  const template = async (name) => { const target = path.join(templatesDir, name); if (!await exists(target)) throw new Error(`Template not found: ${target}`); return readFile(target, "utf8"); };
+  const templates = Object.fromEntries(await Promise.all(["Controller.java.template", "WebConvertor.java.template", "domain/vo/VO.java.template", "domain/dto/cmd/AddCmd.java.template", "domain/dto/cmd/UpdateCmd.java.template", "domain/dto/query/PageQuery.java.template"].map(async (name) => [name, await template(name)])));
+  const basePath = packagePath(args["base-package"]);
+  const domainBase = args["domain-output-dir"] || (args["domain-project-dir"] ? path.join(args["domain-project-dir"], "src", "main", "java", basePath) : path.join(args["output-dir"], basePath));
+  const webBase = args["web-output-dir"] || (args["web-project-dir"] ? path.join(args["web-project-dir"], "src", "main", "java", basePath) : path.join(args["output-dir"], basePath));
+  const domainRoot = ensureSubdir(domainBase, "client");
+  const webRoot = ensureSubdir(webBase, "rest");
+  const written = [];
+  const write = async (target, contents) => { await mkdir(path.dirname(target), { recursive: true }); if (!await exists(target) || args.force) { await writeFile(target, contents, "utf8"); logger.log(`Generated: ${target}`); written.push(target); } else logger.log(`Skipped (exists): ${target}`); };
+  for (const table of tables) {
+    const domainClass = pascal(table.table_name); const domainVar = lowerCamel(table.table_name); const domainDesc = String(table.table_comment || domainClass).trim().replaceAll("\n", " ");
+    const applicationPackage = args["application-service-package"] || `${args["base-package"]}.application.service`;
+    const context = { base_package: args["base-package"], module_name: args["module-name"], domain_class: domainClass, domain_var: domainVar, domain_desc: domainDesc, domain_url_path: kebab(table.table_name), domain_pkg_name: args["domain-segment"], author: args.author, dto_imports: [`import ${args["base-package"]}.client.dto.cmd.${domainClass}AddCmd;`, `import ${args["base-package"]}.client.dto.cmd.${domainClass}UpdateCmd;`, `import ${args["base-package"]}.client.dto.query.${domainClass}PageQuery;`, `import ${args["base-package"]}.client.vo.${domainClass}VO;`].join("\n"), application_service_import: `import ${applicationPackage}.${domainClass}Service;`, domain_import: `import ${args["base-package"]}.domain.${args["domain-segment"]}.model.${domainClass};`, web_convertor_import: `import ${args["base-package"]}.rest.convertor.${domainClass}WebConvertor;`, web_convertor_class: `${domainClass}WebConvertor`, application_service_field: `private final ${domainClass}Service ${domainVar}Service;`, query_call: `${domainVar}Service.page(query)`, detail_call: `${domainVar}Service.detail(id)`, add_call: `${domainVar}Service.add(cmd)`, update_call: `${domainVar}Service.update(cmd)`, delete_call: `${domainVar}Service.delete(id)`, vo_class: `${domainClass}VO`, add_cmd_class: `${domainClass}AddCmd`, update_cmd_class: `${domainClass}UpdateCmd`, query_class: `${domainClass}PageQuery`, validation_namespace: args["validation-namespace"] };
+    await write(path.join(webRoot, `${domainClass}Controller.java`), render(templates["Controller.java.template"], context));
+    await write(path.join(webRoot, "convertor", `${domainClass}WebConvertor.java`), render(templates["WebConvertor.java.template"], context));
+    for (const [templateName, target, declaration] of [["domain/vo/VO.java.template", path.join(domainRoot, "vo", `${domainClass}VO.java`), fields(table.columns || [], { skipAudit: false })], ["domain/dto/cmd/AddCmd.java.template", path.join(domainRoot, "dto/cmd", `${domainClass}AddCmd.java`), fields(table.columns || [], { skipPk: true, command: true })], ["domain/dto/cmd/UpdateCmd.java.template", path.join(domainRoot, "dto/cmd", `${domainClass}UpdateCmd.java`), fields(table.columns || [], { command: true })], ["domain/dto/query/PageQuery.java.template", path.join(domainRoot, "dto/query", `${domainClass}PageQuery.java`), fields(table.columns || [])]]) await write(target, render(templates[templateName], { ...context, field_declarations: declaration }));
+  }
+  return written;
+}
+async function main() { try { const args = parseArgs(process.argv.slice(2)); if (args.help) { console.log(usage()); return; } await generate(args); } catch (error) { console.error(`Error: ${error.message}`); process.exitCode = 1; } }
+if (process.argv[1] === fileURLToPath(import.meta.url)) await main();

package/template/.hermes/skills/yss-web-controller/scripts/generate_controller.test.mjs

@@ -0,0 +1,19 @@
+import assert from "node:assert/strict";
+import { mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { generate, parseArgs } from "./generate_controller.mjs";
+
+test("generates application-service controller with requested validation profile", async () => {
+  const root = await mkdtemp(path.join(tmpdir(), "yss-controller-"));
+  const metadata = path.join(root, "metadata.json");
+  await writeFile(metadata, JSON.stringify({ tables: [{ table_name: "quality_rule", table_comment: "质量规则", columns: [{ name: "id", sql_type: "bigint", primary: true, nullable: false }, { name: "rule_name", sql_type: "varchar(64)", nullable: false }] }] }));
+  await generate(parseArgs(["--metadata-file", metadata, "--base-package", "com.yss.demo", "--module-name", "demo", "--domain-segment", "quality", "--output-dir", path.join(root, "out"), "--application-service-package", "com.yss.demo.application.service", "--validation-namespace", "jakarta"]), { log() {}, warn() {} });
+  const controller = await readFile(path.join(root, "out", "com", "yss", "demo", "rest", "QualityRuleController.java"), "utf8");
+  assert.match(controller, /import com\.yss\.demo\.application\.service\.QualityRuleService;/);
+  assert.match(controller, /import jakarta\.validation\.Valid;/);
+  assert.doesNotMatch(controller, /Gateway/);
+});
+
+test("rejects missing required CLI arguments", () => assert.throws(() => parseArgs(["--module-name", "demo"]), /required/));

package/template/.nvmrc

@@ -0,0 +1 @@
+22

package/template/.pi/skills/yss-audit-log/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-audit-log Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 
@@ -30,6 +30,7 @@ Paths below are source path hints captured at refresh time. If they do not exist
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditLogAspect.java`
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/EnableAuditLogImportSelector.java`
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/UUIDGenerator.java`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/feign/YssDmSystemManageFeign.java`
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditPublishService.java`
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditSubscriber.java`
 - `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogPrintSubscriberImpl.java`

package/template/.pi/skills/yss-cache/references/source-index.md

@@ -1,11 +1,11 @@
 # yss-cache Source Index
 
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
+Generated: 2026-08-17T12:03:37.436Z
+Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
 Source worktree: `dirty`
 Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
 
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
 
 Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
 
@@ -29,6 +29,7 @@ Paths below are source path hints captured at refresh time. If they do not exist
 
 ## Key Java Entry Points
 
+- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter/src/main/java/com/yss/cloud/cache/CacheAutoConfiguration.java`
 - `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineManagerConfig.java`
 - `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineResolver.java`
 - `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CaffeineCacheBackendProvider.java`

package/template/.pi/skills/yss-components/references/frontend-docs.md

@@ -1,6 +1,6 @@
 # yss-components Frontend Documentation
 
-Generated: 2026-06-29T16:11:14+00:00
+Generated: 2026-08-17T12:03:37.436Z
 
 Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.