typescript-strict-patterns

用途：确保 CIA 平台中 TypeScript 组件（CI/CD 工具、MCP 服务器、构建脚本、静态站点生成器、配置解析器）的类型安全开发，适用于以 Java/Maven 为主的项目中的 TypeScript 部分。不适用于 Vaadin UI（Java，改用 vaadin-component-design）与后端服务逻辑（用 Java/Spring 模式）。 主要能力：推荐 tsconfig.json 开启 strict、noUncheckedIndexedAccess、noImplicitOverride、noPropertyAccessFromIndexSignature、exactOptionalPropertyTypes 等严格选项；使用判别联合与类型守卫表达政治数据实体；用 readonly 与只读映射类型构建不可变数据结构；用类型守卫在运行时校验外部数据；用品牌类型区分 PersonId、CommitteeId 等领域标识；用 Result 类型安全处理错误。安全上强调运行时校验外部数据（类型在运行时被擦除）、以 unknown 替代 any、插值前清洗输入、不轻信 as 断言、添加依赖前执行 npm audit。 使用方式：将严格配置写入 tsconfig.json，配合脚本 build（tsc --project tsconfig.json）、typecheck（tsc --noEmit）、lint、test；CI 中可运行 npx tsc --noEmit --strict 做类型检查。 限制：仅覆盖类型层面的约定，不含运行时框架或部署说明；具体平台适配与完整依赖清单资料未提供。