create-yss-spec 3.4.10 → 3.5.2

package/template/.pi/skills/yss-distributed-id/assets/AutoIdInterceptor.java

@@ -1,246 +0,0 @@
-package com.yss.cloud.sankuai.mybatis;
-
-import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
-import com.yss.cloud.exception.BizException;
-import com.yss.cloud.sankuai.CosidSegmentContextHelper;
-import com.yss.cloud.sankuai.GenerationTypeSeq;
-import com.yss.cloud.sankuai.SegmentContextHelper;
-import com.yss.cloud.sankuai.SnowflakeContextHelper;
-import lombok.extern.slf4j.Slf4j;
-import org.apache.commons.lang3.StringUtils;
-import org.apache.ibatis.binding.BindingException;
-import org.apache.ibatis.binding.MapperMethod;
-import org.apache.ibatis.executor.statement.StatementHandler;
-import org.apache.ibatis.mapping.BoundSql;
-import org.apache.ibatis.plugin.Interceptor;
-import org.apache.ibatis.plugin.Intercepts;
-import org.apache.ibatis.plugin.Invocation;
-import org.apache.ibatis.plugin.Signature;
-import org.springframework.util.ObjectUtils;
-import org.springframework.util.ReflectionUtils;
-
-import javax.persistence.Entity;
-import javax.persistence.GeneratedValue;
-import javax.persistence.Table;
-import java.lang.reflect.Field;
-import java.sql.Connection;
-import java.util.*;
-
-@Intercepts(
-    {
-        @Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})
-    }
-)
-@Slf4j
-public class AutoIdInterceptor implements Interceptor {
-
-    @Override
-    public Object intercept(Invocation invocation) throws Throwable {
-        StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
-        BoundSql boundSql = statementHandler.getBoundSql();
-        String boundSqlStr = boundSql.getSql();
-        if (StringUtils.startsWithIgnoreCase(StringUtils.trim(boundSqlStr),"INSERT")){
-            processInsertStatement(statementHandler);
-        }
-
-        return invocation.proceed();
-    }
-
-    /**
-     * 1.处理插入的情况
-     *
-     * @apiNote 1.处理新增insert
-     * @param statementHandler 句柄
-     */
-    private void processInsertStatement(StatementHandler statementHandler) {
-        BoundSql boundSql = statementHandler.getBoundSql();
-        Object parameterObject = boundSql.getParameterObject();
-
-        if (parameterObject != null) {
-            processParameterObject(parameterObject);
-        }
-    }
-
-    /**
-     * 处理参数对象
-     *
-     * @apiNote 2.处理参数对象 mapper->entityList,plus->param1
-     * @param parameterObject 参数对象
-     */
-    private void processParameterObject(Object parameterObject) {
-        if (parameterObject instanceof MapperMethod.ParamMap<?>){
-            // 获取批量实体对象，若为空则为single 参数对象
-            Object entityList = null;
-            try {
-                entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("entityList");
-            }catch (BindingException e){
-                log.warn("non entityList. info -> {}",e.getLocalizedMessage());
-            }
-            // 兼容mybatis默认参数 集合的场景
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("collection");
-                }catch (BindingException e){
-                    log.warn("non entityList & non collection. info -> {}",e.getLocalizedMessage());
-                }
-            }
-            // 兼容mybatis默认参数 数组的场景
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("array");
-                }catch (BindingException e){
-                    log.warn("non entityList & non collection & non array. info -> {}",e.getLocalizedMessage());
-                }
-            }
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("param1");
-                }catch (BindingException e){
-                    log.error("non param1. info -> {}",e.getLocalizedMessage());
-                    throw new BizException("FeignAutoIdInterceptor run error");
-                }
-            }
-            if (entityList instanceof List) {
-                // 批量插入
-                List<?> el = (List<?>) entityList;
-                for (Object entity : el) {
-                    processEntity(entity);
-                }
-            } else  if (entityList.getClass().isArray()) {
-                // 批量插入
-                Object[] array = (Object[]) entityList;
-                for (Object entity : array) {
-                    processEntity(entity);
-                }
-            }else {
-                // 单独插入
-                processEntity(entityList);
-            }
-        } else {
-            // 单独插入
-            processEntity(parameterObject);
-        }
-    }
-
-    /**
-     * 3.处理对象实体
-     *
-     * @apiNote 3.处理对象实体
-     * @param entity 对象实体
-     */
-    private void processEntity(Object entity) {
-        Class<?> entityClass = entity.getClass();
-        if (isEntityClass(entityClass)) {
-            autoIdSet(entity);
-        }
-    }
-
-    /**
-     * 4.自动为实体设置id
-     *
-     * @apiNote 4.自动为实体设置id
-     * @param entity 对象实体
-     */
-    private void autoIdSet(Object entity) {
-        Class<?> entityClass = entity.getClass();
-        List<Field> fields = getAllFields(entityClass);
-        for (Field field : fields) {
-
-            if (field.isAnnotationPresent(GeneratedValue.class)||
-                    field.isAnnotationPresent(TableId.class)) {
-                processGeneratedValue(entity, field);
-            }
-        }
-    }
-
-    /**
-     * 5.设置id字段
-     *
-     * @param entity 实体对象
-     * @param field id字段
-     */
-    private void processGeneratedValue(Object entity, Field field) {
-        String genIdType = getGenIdType(field);
-
-        String tableName = getTableName(entity);
-
-        if (Objects.nonNull(genIdType)&&
-                Objects.nonNull(SegmentContextHelper.LeafConf())&&
-                SegmentContextHelper.LeafConf().isLeafSegmentEnable()&&
-                (genIdType.equals(GenerationTypeSeq.SEGMENT) || genIdType.equals(IdType.AUTO.name()) || genIdType.equals(IdType.ASSIGN_ID.name()))) {
-            long idValue = SegmentContextHelper.nextId(tableName);
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType)&&
-                Objects.nonNull(SnowflakeContextHelper.LeafConf())&&
-                SnowflakeContextHelper.LeafConf().isLeafSnowflakeEnable()
-                &&genIdType.equals(GenerationTypeSeq.SNOWFLAKE) ) {
-            long idValue = SnowflakeContextHelper.nextId();
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType)&&
-                (genIdType.equals(GenerationTypeSeq.UUID)|| genIdType.equals(IdType.ASSIGN_UUID.name()))) {
-            String idValue = UUID.randomUUID().toString();
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType) &&
-                genIdType.equals(GenerationTypeSeq.COSID_SEGMENT)) {
-            long idValue = CosidSegmentContextHelper.nextId(tableName);
-            setFieldValue(entity, field, idValue);
-        }
-    }
-
-    private void setFieldValue(Object entity, Field field, Object value) {
-        field.setAccessible(true);
-        // 如果value为null,则ID生成服务不可用,使用默认规则替代;有值则覆盖
-        if(!Objects.isNull(value)) {
-            if (field.getType() == String.class) {
-                ReflectionUtils.setField(field,entity,String.valueOf(value));
-            } else if (field.getType() == Integer.class) {
-                ReflectionUtils.setField(field,entity,Integer.valueOf(String.valueOf(value)));
-            } else {
-                ReflectionUtils.setField(field,entity,value);
-            }
-        }
-    }
-
-    private boolean isEntityClass(Class<?> clazz) {
-        return clazz.isAnnotationPresent(Entity.class)||clazz.isAnnotationPresent(TableName.class);
-    }
-
-    private String getTableName(Object entity){
-        Table table = entity.getClass().getAnnotation(Table.class);
-        if (Objects.nonNull(table)){
-            return table.name();
-        }
-
-        TableName tableName = entity.getClass().getAnnotation(TableName.class);
-
-        if (Objects.nonNull(tableName)){
-            return tableName.value();
-        }
-
-        return null;
-    }
-    private static List<Field> getAllFields(Class<?> clazz) {
-        List<Field> fields = new ArrayList<>();
-        while (clazz != null) {
-            Collections.addAll(fields, clazz.getDeclaredFields());
-            clazz = clazz.getSuperclass();
-        }
-        return fields;
-    }
-    private String getGenIdType(Field field){
-        GeneratedValue generatedValueAnnotation = field.getAnnotation(GeneratedValue.class);
-
-        if (Objects.nonNull(generatedValueAnnotation)){
-           return generatedValueAnnotation.generator();
-        }
-
-        TableId tableId = field.getAnnotation(TableId.class);
-
-        if (Objects.nonNull(tableId)){
-            return tableId.type().name();
-        }
-        return null;
-    }
-}

package/template/.pi/skills/yss-distributed-id/assets/EnableDistributedId.java

@@ -1,25 +0,0 @@
-package com.yss.cloud;
-
-import com.yss.cloud.sankuai.config.LeafConf;
-import com.yss.cloud.sankuai.config.LeafDataSourceConfiguration;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
-import org.springframework.context.annotation.Import;
-
-import java.lang.annotation.*;
-
-@Target({ElementType.TYPE})
-@Retention(RetentionPolicy.RUNTIME)
-@Documented
-@Inherited
-@Import({LeafDataSourceConfiguration.class, EnableDistributedImportSelector.class})
-@EnableConfigurationProperties(LeafConf.class)
-public @interface EnableDistributedId {
-  /**
-   * 默认自动装载leaf配置，设置默认启用状态
-   */
-  boolean autoRegister() default true;
-  /**
-   * 是否启用cosid模式
-   */
-  boolean cosid() default false;
-}

package/template/.pi/skills/yss-distributed-id/assets/LeafConf.java

@@ -1,36 +0,0 @@
-package com.yss.cloud.sankuai.config;
-
-import org.springframework.boot.context.properties.ConfigurationProperties;
-
-@ConfigurationProperties(prefix = "spring.leaf", ignoreInvalidFields = true)
-public class LeafConf {
-  private boolean leafSegmentEnable;
-  private boolean leafSnowflakeEnable;
-
-  public boolean isLeafSegmentEnable() {
-    return leafSegmentEnable;
-  }
-
-  public void setLeafSegmentEnable(boolean leafSegmentEnable) {
-    this.leafSegmentEnable = leafSegmentEnable;
-  }
-
-  public boolean isLeafSnowflakeEnable() {
-    return leafSnowflakeEnable;
-  }
-
-  public void setLeafSnowflakeEnable(boolean leafSnowflakeEnable) {
-    this.leafSnowflakeEnable = leafSnowflakeEnable;
-  }
-
-  @Override
-  public String toString() {
-    return "LeafConf{"
-        + "leafSegmentEnable="
-        + leafSegmentEnable
-        + ", leafSnowflakeEnable="
-        + leafSnowflakeEnable
-        + ", leafSnowflakePort="
-        + '}';
-  }
-}

package/template/docs/agents/archify-integration.md

@@ -1,19 +0,0 @@
-# Archify 集成合同
-
-本仓消费 [`tt-a1i/archify`](https://github.com/tt-a1i/archify) `v2.16.0`，固定 revision `199360cc6687a7857b54dd188d4922b09e466a4b`，许可证为 MIT。`.agents/skills/archify` 是完整上游包加 YSS 最小适配；`skills-lock.json` 分别记录未经适配的 `upstreamHash` 与当前 `effectiveHash`。
-
-## 路由
-
-- `archify` 是 `specialist`，默认不主动发现。只有用户或当前技术分析、Tactical Design、架构审查合同明确要求架构、工作流、时序、数据流、生命周期、Mermaid 美化或 Before/After 图示时才调用。
-- 图只从 Spec、ADR、OpenAPI、Tactical Design Contract、Slice Implementation Contract 和代码证据派生，不替代任何事实源、合同、评审或会签。
-- 不加入 `yss-public-skills.json`。YSS 模板分发锁定的上游包，但不把它重新发布为 YSS 自有公共 Skill。
-
-## 交付与网络边界
-
-- YSS 仓库不得运行 Archify 的 `scripts/check-update.mjs`。升级只通过 `maintaining-skills`、固定 revision、来源哈希和 fresh verification 完成。
-- 稳定交付必须使用 `.agents/skills/archify/scripts/yss-safe-deliver.mjs`。`project-instance` 只允许 `docs/architecture/diagrams/<diagram-id>/`；`template-source` 只允许 `.template-source/evidence/maintenance/diagrams/<diagram-id>/`；临时探索只允许系统临时目录。
-- 稳定资产固定为 `<diagram-id>.archify.json`、`<diagram-id>.html`、`<diagram-id>.receipt.json`。安全启动器拒绝非 HTML 输出、目录逃逸、符号链接逃逸、无关文件覆盖和 `--open`。
-
-## 更新检查
-
-升级时在临时目录读取上游固定 commit，验证 License、版本、完整目录 `upstreamHash`、YSS 适配差异、安全启动器测试、投影、锁文件、注册表和受影响调用方；不得从浮动 `main` 直接覆盖 canonical 内容。

package/template/docs/agents/yss-plugin-dependency-contract.md

@@ -1,45 +0,0 @@
-# YSS 插件依赖契约
-
-## 目的
-
-YSS Codex 插件可以随插件包提供角色 Harness skill，但不拥有目标项目的共享 skill。共享 skill 的权威内容仍是目标项目的 `.agents/skills`，投影、来源和 hash 由目标项目的 `skills-lock.json` 与 `docs/agents/yss-skill-registry.yaml` 管理。
-
-插件依赖文件位于插件根目录 `.yss-plugin/dependencies.yaml`，用于声明插件需要的角色契约，而不是复制 `core_skills` 清单。
-
-```yaml
-schema_version: 1
-plugin: yss-backend-harness
-requires:
-  - role_id: role.backend-engineer
-    registry: docs/agents/digital-human-roles.yaml
-    minimum_contract_version: 1
-```
-
-## 校验规则
-
-1. 插件导入时只校验 `dependencies.yaml` 的结构、插件名和 `schema_version`。
-2. 插件调用前必须校验目标项目 `yss-project.yaml`，且 `repository_mode` 合法。
-3. 目标项目必须存在依赖声明中的角色，且 `contract_version` 不低于 `minimum_contract_version`。
-4. 角色的 `core_skills` 由目标项目的 `digital-human-roles.yaml` 动态解析；插件不得维护第二份清单。
-5. 共享 skill 必须通过 `yss-skill-registry.yaml`、`skills-lock.json` 和目标 Agent projection 校验。
-6. 缺少角色、版本不兼容、skill 缺失、来源或 hash 漂移、投影不完整时，插件必须返回 `blocked`，不得降级执行。
-7. 插件不得自动写入 `.agents/skills`、`skills-lock.json` 或任何 Agent projection；修复应回路由到目标项目维护流程。
-
-## 运行时结果
-
-依赖不满足时至少返回：
-
-```yaml
-status: blocked
-blocking_signals: [missing-role]
-diagnostics:
-  plugin: yss-backend-harness
-  required_role: role.backend-engineer
-  next_route: install-or-sync-target-project-skills
-```
-
-`blocking_signals` 可使用 `repository-identity-invalid`、`missing-role`、`incompatible-contract-version`、`missing-skill`、`skill-source-drift`、`skill-hash-drift` 和 `skill-projection-incomplete`。
-
-## 版本策略
-
-依赖文件 schema 只保证同一主版本向后兼容。插件的 `minimum_contract_version` 是硬门槛；`tested_with` 等兼容性信息只能作为提示，不能替代目标项目的契约版本校验。

package/template/docs/design/design-system-sync.yaml

@@ -1,13 +0,0 @@
-schema_version: 1
-design_system_sync:
-  baseline: yss-spec-project-template
-  baseline_version: alpha
-  baseline_commit: 36af9ac3895162cefc5da8889af8141c2dfce2cd
-  baseline_sha256: e84a6c175840efe9663a2d0aba37f5635c053f47452bb146d1025d65665b1bec
-  baseline_state: worktree
-  synchronized_sections:
-    - Colors
-    - Typography
-    - Layout
-    - Shapes
-    - Components

package/template/docs/design/facts/antdv-next/1.5.2/cli-help.txt

@@ -1,38 +0,0 @@
-
-@antdv-next/cli v0.0.0-beta.5
-─────────────────────────────
-
-CLI tool for querying antdv-next knowledge and analyzing antdv-next usage in projects (@antdv-next/cli v0.0.0-beta.5)
-
-USAGE @antdv-next/cli [OPTIONS] init|bug|bug-cli|changelog|demo|design.md|doc|doctor|env|info|lint|list|mcp|migrate|semantic|setup|token|upgrade|usage|check
-
-OPTIONS
-
-                    -c, --cwd=<cwd>    Current working directory (Default: /Users/zhudaoming/Projects/yss-spec-project-template)
-                        --ver=<ver>    Target antdv-next version (e.g. 1.0.0) (Default: )
-  -f, --format=<text|markdown|json>    Output format (Default: text)
-
-COMMANDS
-
-       init    Initialize a fresh project
-        bug    Report a bug to the antdv-next repository
-    bug-cli    Report a bug to the @antdv-next/cli repository
-  changelog    Compare component API differences between versions
-       demo    Get demo source code for a component
-  design.md    Output the antd design-language document (design.md) for AI design tools
-        doc    Output the full API documentation for a component in markdown
-     doctor    Diagnose project-level antd configuration issues
-        env    Collect antdv-related environment information for bug reporting
-       info    Query component API: props, type definitions, default values
-       lint    Check antdv-next usage against best practices
-       list    List all components with bilingual names, descriptions, and first-supported version
-        mcp    Start MCP server for AI assistant integration
-    migrate    Version migration guide with optional auto-fix
-   semantic    Query the semantic customization structure of a component
-      setup    Set up Ant Design MCP/Skill for AI agents or GitHub Actions
-      token    Query Design Tokens (global or component-level)
-    upgrade    Upgrade the CLI to the latest version
-      usage    Scan project for antdv-next component usage statistics
-      check    Test item version
-
-Use @antdv-next/cli <command> --help for more information about a command.