@agile-team/wl-skills-gate 0.0.0-stage → 0.9.0

package/CHANGELOG.md

@@ -0,0 +1,135 @@
+# 0.9.0 — 2026-10-15
+
+- 修复接入环境与依赖准备、候选Review上下文和索引、删除/暂存区修复恢复、真实阻断与必要环境关闭、消息隔离。
+- 补齐真实CI发现与可恢复调度、九维原件采集/补证/认证确认、授权前CI重新核验、OIDC处理页与投递恢复。
+- 补齐独立签发、前后端组合与API/数据库/顺序约束、单次部署授权、实际冒烟和显式故障恢复。
+- 重整README为接入、运行流程与文档入口，提供可复用的WL系列字标及Gate品牌资产。
+- 本地源码和独立tgz分别验收；业务仓库、远端权限/群/SSO与真实业务必测仍以现场回执确认。
+
+# 0.8.0 — 2026-10-15（本地交付候选，未发布）
+
+- Gate 收入版本化前后端接入资产和 onboard，识别实际项目、显示完整差异并绑定确认；quality-tools 明确为后端私有 Node 依赖目录。
+- 九维 Review 草稿、同口径修前修后对比、原始证据重算和逐维独立授权；正式签发及晋级强制要求 v2 记录，旧的仅身份/SHA批准不再放行。
+- 固定 GitLab/Jenkins API 只读采集、真实 SHA/ref/全部必需作业与精确工件校验；拒绝 WebHook 自报成功、allow_failure、缺项、取消/跳过旧报告和采集中漂移。
+- 飞书分类卡片、Review/构建/部署独立事实流共用签名台账与待发箱；构建成功、投递成功不会关闭质量问题。
+- 文档明确包内实现、项目实接、远端权限/身份/存储与业务复验的验收责任；本地候选不代表 registry 发布或生产已接通。
+
+# 0.7.0 — 2026-10-13（源码修订，未发布）
+
+- JUnit 多模块明确 files/reportDirs/requiredSuites，报告全集、必测计数、生产一次和终轮摘要验证；拒绝旧 XML、源码覆盖、解析损坏与后续篡改。
+- doctor 只读预检项目接线，Java 单测包装器明确模块/报告全集与依赖准备，补充前后端 GitLab 和 Jenkins 接线片段。
+- governance 最小中央签名事件台账、独立复核关闭、漏跑对账、自然分钟 SLA、消息摘要/认证跳转、飞书签名与企业微信投递；默认预览。并发租约、未知投递和死信显式失败。
+- 台账固定配置/公钥身份，动作和通知绑定当前 revision；拒绝过期卡片、输出路径别名与损坏台账。平台 API/SSO 查询、真实接线、服务和群投递仍须操作手册实测。
+- 同步 V3 三份文档职责与精选 code-scan-kit 规则已正式集成的定位；无需 AI API。
+
+# 0.6.1 — 2026-10-12
+
+- npm 发布访问策略改为 public；公开获取与使用授权分开，保留 UNLICENSED，不授予开源许可。
+- 新增独立 LICENSE：权利人为 AGILE TEAM，未经事先书面授权不得使用、复制、修改或再分发；授权申请通过仓库 Issues，不伪造或推定授权记录。
+- LICENSE 明确纳入 npm 包；README、当前手册与模板版本锁同步 0.6.1。保留 0.6.0 历史记录和标签，不修改业务解析、风险分级或门禁裁决代码。
+
+# 0.6.0 — 2026-10-12
+
+- 汇总 0.5.2 源码修订：共享工程包报告转换、Java XML 本轮一次生产、只读分页 inspect 与离线 cost；保留原 CLI/模块能力和平台权限边界。
+- Java 报告补齐 P3C/原引擎身份、原生优先级与成员签名；成员指纹防止同一行、同一说明的不同字段被合并。
+- Gate 单源风险表新增三项安全/正确性底线；locale 显式预警和 SpotBugs 四类上下文复核保留发现，不自动排除整类。
+- 严格 sourceRoots 支持多模块 main/test 实际文件定位；缺文件、歧义、符号链接和越界失败关闭。报告单独保留 parser 版本，未知外部工具版本不虚报验证。
+- 自测使用包内实际版本生成临时 rules.lock，避免发布升版后夹具仍锁旧版本。更新安装/迁移/版本冻结文档，去除 standalone npm 包中的工作区兄弟路径链接。
+- 发布准备保留现有 restricted/UNLICENSED 设置；包级与实际 tgz 自测可证明本地能力，不替代 registry、Git、平台权限与生产接线回执。
+
+# 0.5.2 — 2026-10-11～12（源码修订，未发布）
+
+- cmd-json 集中转换 Kit/UI/BD 原生完整 JSON，校验执行与覆盖证据、保留等级与质量底线；项目不再各自维护同类转换。
+- captureStdout 以文件描述符接收大报告，防止生产者立即退出导致管道 JSON 截断；仍拒绝旧文件、超限及无证据的非零退出。
+- java-xml 解析 Checkstyle/PMD/SpotBugs 原 XML，区分确定缺陷和治理提示；分析异常、依赖缺类、缺报告及生产失败返回 invalid。
+- Java XML 补齐显式 format=p3c、producer/原引擎版本/原生优先级类别rank/主类和方法字段签名；稳定成员context避免同一generic说明合并不同字段。本地parser版本单独归档，不假装外部工具已核验。
+- Gate 单源 Java 风险表保留原四底线，增加 HardCodedCryptoKey/InsecureCryptoIv/BrokenNullCheck 不可基线error；locale显式预警，SpotBugs四类表征/构造风险保留context-review warning及理由，不自动识别@Service并豁免整类。
+- 新增严格java-xml sourceRoots，按明确多模块main/test源目录探测真实文件；不存在、同名歧义、符号链接和越界失败关闭。旧合成parser夹具补真实源码文件，未降低运行时校验。
+- 同步当前接入文档：三档成本、Java 静态/单元/集成隔离、历史治理与预警；既有业务项目接入未自动升级，平台通知仍待验收。
+- Java XML 新增显式 producer 本轮一次生产：清除同组全部旧文件、完整报告检查与消费前哈希核验；下一轮重新生产，失败/缺报告不重试伪装成功。
+- 新增离线 cost：工件去重、项目/档位和检查分位耗时、生产次数及候选重复；可导入来源标明的宿主 usage，缺失不填零，缓存输入不重复计数。
+- 阻止 displayOnly、裁剪和未完成分页结果回流为门禁输入。
+- 增加只读 inspect：默认摘要、规则/等级/状态过滤、UTF-8 字节预算与绑定报告/筛选的分页游标；翻页只读工件，不重复扫描，过滤不改变原结论和全量计数。
+- 明确确定性脚本、AI 上下文与 Runner 成本分别统计；完整报告留存、按需读取，重复检查/告警由共享接线收敛，不削减 release 必测。增加 7 项视图预算、分页、防漂移、只读与 CLI 回归验证。
+
+# 0.5.1 — 2026-10-09
+
+- ESLint 全量显式 targets/args；保存实际覆盖清单，拒绝空扫描、全忽略与增量漏文件，兼容中文/空格及物理路径别名；检查参数禁止修复模式。
+- release 参数及证明核验均要求全量；已跟踪源码不因生成目录/报告排除而消失，报告目录防覆盖，路径与特殊文件失败关闭。
+- 保留适配器执行失败的原诊断；受控检查提前要求基线/豁免批准摘要，promote 全链传递；依赖准备留脱敏诊断。
+- 晋级以明确旧 HEAD 的 lease 拒绝最后时刻目标并发；仍核验候选父提交并只推进批准的快进。
+- 修复符号链接/HEAD 漂移失败关闭；安全恢复后重新扫描并清空尝试 fixed 结果，不完整恢复要求人工处理。
+- 93 单元 + 29 fixture + 17 集成通过；文档细化覆盖、漏跑、乱序/复发、恢复授权和修复发布准入。未发布 npm，真实平台接线仍待验收。
+
+# 0.5.0 — 2026-10-08
+
+- 将 unsigned 检查结果与独立 Ed25519 签发分离；强制核验项目、真实 SHA、档位、环境、批准摘要、公钥、签发身份、作业和时效。
+- 新增 manifest，发布证明绑定真实制品/配置摘要；部署验证读取实际字节。
+- promote 只生成候选和 bundle；promote-apply 以新 bare 仓库核验签名、非作者 Review、父提交与最新远端 HEAD 后更新。禁用旧 --push/--allow-any，失败也归档。
+- 质量底线不可基线/豁免；合并取最高风险，基线风险/发生数增长重新阻断，增量不标历史问题消失，拒绝自批例外。
+- JUnit 核验完整 XML、实际计数和必测，跳过/零用例阻断；清旧报告、修正非零退出契约，暂存/工作区不一致拒绝。
+- 修复计划 v2 绑定文件/报告/策略/HEAD，忽略报告任意命令，白名单外变更/命令失败/回归回滚，扫描通过仅进入待复验。
+- 新增 Code Quality 导出、共用 commit-message 验证；docs 随包发布，自测在临时目录执行，清理 fixture 生成报告。
+- 同步真实权限边界和 0.4 迁移说明；D1～D4 明确首期，平台查询、通知和双仓组合仍保留待接入。
+
+# Changelog
+
+## 0.4.0（2026-10-08）
+
+代码/逻辑/验证/报告四层全面闭环（平台接线与自动扫描脚本除外）：
+- 新适配器：`cmd-json`（任意命令输出统一 findings，工程包/扫描器通用入口）、`junit`（失败/错误=error、跳过=warning、零用例=error，正文 3.5/5.6）、`sarif`（SARIF v2.x 映射）；共用 finding-input 解析，无胶水重复。
+- eslint：`--base/--head` 增量（git diff 范围过滤）、`cache: true` 缓存参数；`command` 覆盖与 staged/增量范围同时出现直接 invalid。
+- `verify-artifact` 子命令（正文 13.3 C3）：证明结论/SHA/受控哈希/reportDigest 防篡改/eventId 关联/时效/报告内阻断问题复核，任一不符 exit 2。
+- `promote` 子命令（正文 5.2/13.2 B4 引擎件）：流向校验（dev-工号-模组→dev、相邻顺序晋级，跨级须 --allow-any 留痕）、临时 worktree 候选合并、候选上重跑门禁、目标 HEAD 并发复核、受控 push（非 force）、promotion-record 与候选证据归档。
+- 报告新增自包含 `quality-report.html`（与 Markdown 同口径）。
+- 验证闭环：新增 5 组 lib 单元测试（node:test）；`fix --apply` 集成用例（修复→复扫→closed→beforeArchive/changedFiles）；本地 bare 仓库集成测试 4 场景（晋级推进/违规拦截/流向拒绝/证据核对）；新适配器 fixture 25~27；self-test 全量 29 项。
+- 修复：run.js 适配器注册表补齐三个新工具（缺失时误报 invalid）。
+
+## 0.3.1（2026-10-07）
+
+二次深挖闭环（回归缺陷 + 零消费者断点）：
+- **修复 0.3.0 引入的回归**：模板 policy 移出 fast 档类型检查后 fast 变空 → pre-commit 必挂。模板/示例将 FE-ESLINT 恢复进 fast（配合 `--scope staged` 只查暂存区）；新增 fixture 24-fast-empty 固化"空档位即 invalid"语义（已实测复现回归并验证修复）。
+- **schema 从摆设变契约**：新增 `validate-report` 子命令按 schema 校验报告结构；self-test driver 对每个 case 的 summary 执行 schema 校验，报告与 schema 漂移从此有回归（实测通过/篡改两路径）。
+- attestation 补 `eventId`（成功与 failFast 两路径），证明与报告可关联。
+- hooks 模板：缺少 `scripts/quality/run.mjs` 薄入口时给出复制指引并 exit 2（原为晦涩的 cannot open）。
+- `--scope` 白名单校验（仅 staged），任意值不再静默无效。
+- `enforceWarnings` 布尔强转，json 变体传字符串 "false" 不再被当 true。
+- self-test 25 项全绿。
+
+## 0.3.0（2026-10-07）
+
+对照落地执行文档逐章核对后的冲突修复（A/B/C/D 四类 14 项，均附 fixture 或实证）：
+- blocker 豁免默认拒绝（`blockerWaivers: reject`，正文 3.4）：命中有效豁免仍阻断并标记 `waiverRejected`（fixture 20）。
+- `required: false` 必须登记 `naReason`（可选 `alternative`），缺失即 policy invalid（正文 3.6，fixture 17 强化）。
+- 模板 policy：类型检查移出 fast 档（10s 预算，附录 B.2 #3）；新增 `commitTypes`、`releaseRequires`、`blockerWaivers` 键。
+- 全零 `--base` SHA 拒绝（正文 13.2，fixture 21）。
+- commit-msg 钩子类型白名单改读 policy `commitTypes`，缺省回落内置表（收敛"第四套白名单"口径分裂，已实测 wip/feat 两路径）。
+- 新增 `--expect-policy-hash` / `--expect-rules-hash` 运行期摘要校验，不符即 invalid；docs/10 声明的"版本锁第三处咬合"落地（fixture 22 + 实测匹配/不匹配两路径）。
+- release 档最低检查集 `releaseRequires`，缺任一即 invalid（正文 3.1"不能关闭的条件"，fixture 23 + 满足路径实测）。
+- attestation 字段改名 `compareBaseSha/compareHeadSha`（消除与晋级语义的混淆），新增 expected/match 字段。
+- baseline 元数据（`generatedAt/ruleSetVersion/fileDigest`）进报告（正文 3.3）。
+- fix-report 新增 `changedFiles`（git status，排除门禁产物目录；已实测）；快照/自动回滚登记层级Ⅱ。
+- summary 新增 `run.eventId`（正文 7.2 幂等入库键）；finding 新增可选 `suggestion`（正文 4.2 修复建议，已实测进 markdown）。
+- 信任边界写入 docs/06/10：策略作者可执行任意命令，Runner 不得持特权凭据（正文 12.6）。
+- self-test 24 项全绿；driver 支持 per-case `profile/args`。
+
+## 0.2.0（2026-10-07）
+
+自审修复（缺陷均有实证复现）：
+- 指纹合并不再吞位置：同指纹多处命中保留 `occurrences` 行号清单，报告展示"行 10/20，共 2 处"；eslint 指纹改由 规则+文件+消息 决定。
+- yaml-lite：重复键直接报错（防配置静默漂移）；未加引号值支持行内 `#` 注释截断，`src/#x.vue` 类值不受影响。
+- 豁免记录按索引判定有效性，同 id（或同缺 id）记录不再连坐。
+- eslint 适配器：配置 `command` 覆盖时禁止 `--scope staged`（语义不明确即 invalid）。
+- fix --apply：复扫前把修复前 summary 归档为 `repair/summary-before-<planId>.json`；fix-report 新增 `failedCommands`。
+- 薄入口模板：包未安装时给出安装指引并 exit 2（原为原始 MODULE_NOT_FOUND、exit 1）。
+- self-test driver：FAIL 输出 stderr 尾部；支持 `occurrencesAtLeast` 断言；新增 fixture 13~19（未知工具/重复检查 id/缺 project/enforceWarnings/required=false 降级/多处命中/JSON 配置变体），共 20 项；fixture 产物加入 .gitignore。
+
+## 0.1.0（2026-10-07）
+
+- 首个骨架版本：run/collect/gate/fix 统一入口，三档 profile，统一退出码 0/1/2。
+- 失败关闭：配置缺失、工具缺失、报告损坏/缺失/结构错误、finding 缺字段、超时均判 invalid。
+- 稳定指纹（项目+规则+文件+结构特征）、有期限豁免、存量基线、到期回退、基线待复验移除。
+- 伪造结论防护：输入结果的 decision/status/passed 字段一律忽略，按 findings 重算。
+- 统一报告：quality-summary.json（schemaVersion=1 最小集）、quality-report.md、gate-attestation.json。
+- 13 个 fixture 自测（self-test）覆盖通过/阻断/invalid/豁免/基线/伪造/修复计划。
+- 模板：quality/ 配置、scripts/quality/run.mjs 薄入口、hooks（pre-commit/commit-msg/pre-push，含耗时打点）。

package/LICENSE

@@ -0,0 +1,18 @@
+授权声明 / Authorization Notice
+
+Copyright (c) 2026 AGILE TEAM. All rights reserved.
+权利人：AGILE TEAM。保留所有权利。
+
+本软件及其随附的源码、文档、模板和其他资料采用 UNLICENSED 授权状态。
+未经权利人 AGILE TEAM 事先书面授权，不得使用、复制、修改或再分发本软件及其随附资料。
+公开仓库、公开 npm 包或其他公开获取渠道不授予使用、复制、修改或再分发授权。
+取得书面授权后，仅可在该书面授权明确约定的范围内使用；公开获取不构成授权记录。
+
+如需申请授权，请通过仓库 Issues 联系权利人：
+https://github.com/ChenyCHENYU/wl-skills-gate/issues
+
+This software and its accompanying source code, documentation, templates and other materials are UNLICENSED.
+Prior written authorization from the rights holder, AGILE TEAM, is required to use, copy, modify or redistribute them.
+Availability through a public repository, public npm package or any other public channel does not grant such authorization.
+Any authorized use is limited to the scope expressly stated in that prior written authorization.
+To request authorization, contact the rights holder through the repository Issues linked above.

package/README.md

@@ -1,3 +1,114 @@
-# Temporary Holding Version
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ChenyCHENYU/wl-skills-gate/v0.9.0/assets/wl-gate-logo-dark.svg" />
+    <img src="https://raw.githubusercontent.com/ChenyCHENYU/wl-skills-gate/v0.9.0/assets/wl-gate-logo.svg" width="920" alt="WL Gate — Automated quality workflow" />
+  </picture>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <strong>从提交检查到复验关闭的质量工程执行包</strong><br />
+  自动接入 · 脚本修复与复扫 · 九维 Review · 构建发布门禁
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@agile-team/wl-skills-gate"><img src="https://img.shields.io/npm/v/@agile-team/wl-skills-gate?color=0D9488&label=npm" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/Node.js-%E2%89%A522.12-172B43" alt="Node.js 22.12 or later" />
+  <img src="https://img.shields.io/badge/runtime_dependencies-0-0D9488" alt="Zero runtime dependencies" />
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-authorization_required-64748B" alt="Authorization required" /></a>
+</p>
+
+<p align="center">
+  <a href="#三步接入"><strong>快速接入</strong></a> ·
+  <a href="#接入后怎么运行">运行流程</a> ·
+  <a href="#wl-系列怎么配合">包与目录</a> ·
+  <a href="./templates/ci">CI 模板</a> ·
+  <a href="./docs/README.md">完整文档</a> ·
+  <a href="./CHANGELOG.md">更新记录</a>
+</p>
+
+---
+
+## Gate 做什么
+
+Gate 把项目检查器、Git Hook、CI、Review 与处置记录接成同一条流程。开发者正常提交代码即可触发检查，技术经理和运维统一维护规则、必测、权限与通知。
+
+| 需要解决的事 | Gate 的处理方式 |
+| --- | --- |
+| 问题到构建时才暴露 | 提交、推送阶段自动检查；CI 再做完整核验 |
+| 修复依赖反复问 AI | 先展示问题和修复计划，确认后执行批准脚本，自动复扫 |
+| Review 只有一张扫描结果 | 汇总九维证据、代码差异和修前修后变化，由非作者逐维确认 |
+| 构建成功就被当作闭环 | 分别记录检查、Review、构建、部署和复验；满足关闭条件才结项 |
+
+**九维范围：** 提交 · 分支 · 编码 · UI 与交互 · Code Review · 测试 · 扫描门禁 · CI/CD · 工程治理。
+
+## 三步接入
+
+准备 **Node.js ≥22.12**，并使用项目固定的包管理器、检查器及 Java 工具链。以下命令由接入维护者执行一次；安装源可替换为团队批准的镜像。
+
+**1. 预览。** 在实际 Git 项目上识别技术栈，查看文件差异、固定依赖、Hook、检查范围和阻断项。
+
+```bash
+npx --yes @agile-team/wl-skills-gate@0.9.0 onboard \
+  --root /path/to/project --complete --registry https://registry.npmjs.org
+```
+
+**2. 确认执行。** 审核预览后，使用本次返回的 `planHash` 应用同一计划。
+
+```bash
+npx --yes @agile-team/wl-skills-gate@0.9.0 onboard \
+  --root /path/to/project --complete --registry https://registry.npmjs.org \
+  --apply --plan-hash "<本次 planHash>" --confirm
+```
+
+接入任务按计划安装依赖、同步适用规则、配置 Hook，并验证真实检查和报告。失败保留阶段回执，修正后续跑。
+
+**3. 验证效果。** 查看首份报告及 Hook 正反例，再接入下表的 CI 与中央服务。日常提交、推送自动检查，开发者不用输入扫描命令。
+
+| 项目 | 工具装在哪里 | 业务构建 |
+| --- | --- | --- |
+| PC Vue 前端，如 `wl-ui-produce` | 现有 `package.json` / `node_modules` | 沿用原前端构建 |
+| Java/Maven 后端，如 `wl-produce` | 独立的 `quality-tools/` 目录 | 沿用 Maven，Node 工具不进入 jar |
+
+内置后端配套针对 `wl-produce` PL 模块；其他 Maven 项目先批准自己的模块与必测配套。移动端、UniApp 不套用 PC 配套。完整步骤见 [项目接入](./docs/17-onboarding.md)。
+
+## 接入后怎么运行
+
+| 环节 | 自动执行 | 人员操作与结果 |
+| --- | --- | --- |
+| 提交 / 推送 | Hook 执行快速或标准检查，生成报告 | 有阻断先处理，保留项目已有提交约定 |
+| 修复 / 复扫 | 按批准计划执行脚本，核对变更范围并复扫 | 确认后修复；查看新问题、剩余项与真实差异 |
+| 九维 Review | 收集 Git、CI、测试及责任证据，生成待确认记录 | 非作者补充实际 UI / 影响 / 外部测试材料，再逐维确认 |
+| 合并 / 发布 | 核验候选 SHA、正式 Review、制品、环境和发布组合 | 合并、部署和恢复分别授权；冒烟由独立验证人确认 |
+| 通知 / 关闭 | 分类推送，漏跑与超时对账，失败重试并留证 | 主备认领，按必要环境复验后关闭；复发重新打开 |
+
+**项目接入与远端接线分别验收。** 运维配置受保护分支、必需作业、固定 Runner 和独立凭据；中央服务连接真实 CI、SSO、证据存储与飞书群。可直接使用包内 [CI 模板](./templates/ci) 和 [中央配置](./templates/platform/README.md)。
+
+检查退出码：`0` 通过、`1` 阻断、`2` 执行或证据无效。扫描通过、消息送达和人工补证都不会自动清除必需测试失败或批准发布。
+
+## wl 系列怎么配合
+
+| 名称 | 职责 |
+| --- | --- |
+| **Gate** | 统一接入、执行检查、裁决、修复复扫、证据与处置流程 |
+| **Kit** | PC Vue 管理端编码与工程约定 |
+| **UI** | PC 管理端 UI、样式与交互检查 |
+| **BD** | Java 后端规范、规则资产及检查能力 |
+| `quality-tools/` | Java 仓库的 Node 工具目录，里面安装 Gate / BD；不是另一个包 |
+
+Gate 复用项目已有 ESLint、类型检查、Maven、JUnit 及适用规则包，统一报告与裁决。检查、修复、归档和通知由脚本执行，Gate 不调用大模型 API。按需查看报告可用 [`inspect`](./docs/14-low-token-execution.md)，无需重复扫描。
+
+## 文档入口
+
+| 要做什么 | 从这里开始 |
+| --- | --- |
+| 项目接入、Hook 与首扫 | [接入指南](./docs/17-onboarding.md) · [项目与运维集成](./docs/16-project-ci-integration.md) |
+| 配置检查器、范围与等级 | [配置](./docs/02-config.md) · [适配器](./docs/05-adapters.md) · [Java 报告](./docs/15-java-report-triage.md) |
+| CI、SSO、飞书与处置 | [可信 CI 来源](./docs/18-ci-source.md) · [中央接线](./templates/platform/README.md) |
+| 九维证据与正式 Review | [Review 契约](./docs/19-nine-dimension-review.md) |
+| 验证、升级与排障 | [完整索引](./docs/README.md) · [自测与环境验收](./docs/09-selftest-coverage.md) · [更新记录](./CHANGELOG.md) |
+
+## 开发与授权
+
+仓库验证使用 `npm test`，包含单元、规则场景及本地 Git / 签名 / 制品集成测试。发布前对固定 tgz 独立安装并复验。
+
+[WL 系列标识](./assets/wl-mark.svg)与[品牌配色](./assets/brand-tokens.json)随包交付，后续 wl 包可复用同一字标并区分模块色。使用授权见 [LICENSE](./LICENSE)；npm 公开可下载不等于开源授权，授权申请通过[仓库 Issues](https://github.com/ChenyCHENYU/wl-skills-gate/issues)。

package/assets/brand-tokens.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": 1,
+  "series": "WL Engineering",
+  "product": "WL Gate",
+  "tagline": "Automated quality workflow",
+  "mark": {
+    "file": "wl-mark.svg",
+    "viewBox": "0 0 128 128",
+    "color": "currentColor",
+    "minimumSizePx": 32,
+    "clearSpaceViewBoxUnits": 16,
+    "construction": "Geometric W and L, open gate frame, check node. Keep the same paths across the WL series."
+  },
+  "banner": {
+    "viewBox": "0 0 920 220",
+    "light": "wl-gate-logo.svg",
+    "dark": "wl-gate-logo-dark.svg",
+    "cornerRadius": 28
+  },
+  "palette": {
+    "navy": "#102E46",
+    "navyDeep": "#0B2034",
+    "navySurface": "#173B59",
+    "mint": "#49D9BA",
+    "mintAccessibleOnLight": "#159D82",
+    "paper": "#F7FAFC",
+    "mist": "#EEF6F8",
+    "textLight": "#F2F8FC",
+    "textMutedLight": "#537083",
+    "textMutedDark": "#9EBDC9"
+  },
+  "typography": {
+    "family": "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif",
+    "productSize": 66,
+    "productWeight": 750,
+    "seriesSize": 14,
+    "seriesTracking": 3.8,
+    "taglineSize": 20
+  },
+  "extension": {
+    "shared": ["WL monogram paths", "banner geometry", "typographic hierarchy", "navy base"],
+    "perProduct": ["product name", "tagline", "accent color"],
+    "examples": ["WL Kit", "WL UI", "WL BD"]
+  }
+}

package/assets/wl-gate-logo-dark.svg

@@ -0,0 +1,38 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 920 220" role="img" aria-labelledby="wl-gate-dark-title wl-gate-dark-desc">
+  <title id="wl-gate-dark-title">WL Gate — WL Engineering</title>
+  <desc id="wl-gate-dark-desc">WL Gate. Automated quality workflow. An open gate frames a geometric WL monogram and a mint check node, on a deep blue background.</desc>
+  <defs>
+    <linearGradient id="wl-gate-dark-background" x1="0" y1="0" x2="920" y2="220" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#0B2034"/>
+      <stop offset="1" stop-color="#102D43"/>
+    </linearGradient>
+    <linearGradient id="wl-gate-dark-tile" x1="34" y1="30" x2="194" y2="190" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#1B405B"/>
+      <stop offset="1" stop-color="#102B42"/>
+    </linearGradient>
+  </defs>
+  <rect width="920" height="220" rx="28" fill="url(#wl-gate-dark-background)"/>
+  <rect x=".75" y=".75" width="918.5" height="218.5" rx="27.25" fill="none" stroke="#9CC9D8" stroke-opacity=".12" stroke-width="1.5"/>
+  <rect x="34" y="30" width="160" height="160" rx="36" fill="url(#wl-gate-dark-tile)"/>
+  <rect x="34.75" y="30.75" width="158.5" height="158.5" rx="35.25" fill="none" stroke="#91C4D7" stroke-opacity=".16" stroke-width="1.5"/>
+  <g transform="translate(50 46)" fill="none" stroke-linecap="round" stroke-linejoin="round">
+    <g stroke="#F2F8FC">
+      <path d="M18 106V22h92v19M18 106h60" stroke-width="9"/>
+      <path d="m31 50 10 37 13-25 13 25 10-37M90 50v37h18" stroke-width="8"/>
+    </g>
+    <circle cx="105" cy="105" r="17" stroke="#49D9BA" stroke-width="7"/>
+    <path d="m97 105 5 5 11-12" stroke="#49D9BA" stroke-width="6"/>
+  </g>
+  <g font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <text x="246" y="63" fill="#88B5C5" font-size="14" font-weight="700" letter-spacing="3.8">WL ENGINEERING</text>
+    <text x="242" y="132" fill="#F2F8FC" font-size="66" font-weight="750" letter-spacing="-2.4">WL Gate</text>
+    <text x="246" y="174" fill="#9EBDC9" font-size="20" font-weight="450" letter-spacing=".2">Automated quality workflow</text>
+  </g>
+  <g fill="none" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M739 110h95" stroke="#33596C" stroke-width="2"/>
+    <circle cx="739" cy="110" r="6" fill="#102D43" stroke="#6A96A8" stroke-width="2"/>
+    <circle cx="786" cy="110" r="6" fill="#102D43" stroke="#6A96A8" stroke-width="2"/>
+    <circle cx="841" cy="110" r="17" fill="#153F45" stroke="#49D9BA" stroke-width="2"/>
+    <path d="m834 110 5 5 9-10" stroke="#49D9BA" stroke-width="2.5"/>
+  </g>
+</svg>

package/assets/wl-gate-logo.svg

@@ -0,0 +1,37 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 920 220" role="img" aria-labelledby="wl-gate-title wl-gate-desc">
+  <title id="wl-gate-title">WL Gate — WL Engineering</title>
+  <desc id="wl-gate-desc">WL Gate. Automated quality workflow. An open gate frames a geometric WL monogram and a mint check node.</desc>
+  <defs>
+    <linearGradient id="wl-gate-background" x1="0" y1="0" x2="920" y2="220" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#F7FAFC"/>
+      <stop offset="1" stop-color="#EEF6F8"/>
+    </linearGradient>
+    <linearGradient id="wl-gate-tile" x1="34" y1="30" x2="194" y2="190" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#173B59"/>
+      <stop offset="1" stop-color="#0C233A"/>
+    </linearGradient>
+  </defs>
+  <rect width="920" height="220" rx="28" fill="url(#wl-gate-background)"/>
+  <rect x=".75" y=".75" width="918.5" height="218.5" rx="27.25" fill="none" stroke="#173B59" stroke-opacity=".08" stroke-width="1.5"/>
+  <rect x="34" y="30" width="160" height="160" rx="36" fill="url(#wl-gate-tile)"/>
+  <g transform="translate(50 46)" fill="none" stroke-linecap="round" stroke-linejoin="round">
+    <g stroke="#F2F8FC">
+      <path d="M18 106V22h92v19M18 106h60" stroke-width="9"/>
+      <path d="m31 50 10 37 13-25 13 25 10-37M90 50v37h18" stroke-width="8"/>
+    </g>
+    <circle cx="105" cy="105" r="17" stroke="#49D9BA" stroke-width="7"/>
+    <path d="m97 105 5 5 11-12" stroke="#49D9BA" stroke-width="6"/>
+  </g>
+  <g font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <text x="246" y="63" fill="#3B6A80" font-size="14" font-weight="700" letter-spacing="3.8">WL ENGINEERING</text>
+    <text x="242" y="132" fill="#102E46" font-size="66" font-weight="750" letter-spacing="-2.4">WL Gate</text>
+    <text x="246" y="174" fill="#537083" font-size="20" font-weight="450" letter-spacing=".2">Automated quality workflow</text>
+  </g>
+  <g fill="none" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M739 110h95" stroke="#B9CFD6" stroke-width="2"/>
+    <circle cx="739" cy="110" r="6" fill="#F2F8FA" stroke="#7296A5" stroke-width="2"/>
+    <circle cx="786" cy="110" r="6" fill="#F2F8FA" stroke="#7296A5" stroke-width="2"/>
+    <circle cx="841" cy="110" r="17" fill="#E0F5EE" stroke="#159D82" stroke-width="2"/>
+    <path d="m834 110 5 5 9-10" stroke="#159D82" stroke-width="2.5"/>
+  </g>
+</svg>

package/assets/wl-mark.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none" role="img" aria-labelledby="wl-mark-title wl-mark-desc">
+  <title id="wl-mark-title">WL</title>
+  <desc id="wl-mark-desc">The WL Engineering monogram: geometric W and L inside an open gate, completed by a check node.</desc>
+  <g stroke="currentColor" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M18 106V22h92v19" stroke-width="9"/>
+    <path d="m31 50 10 37 13-25 13 25 10-37M90 50v37h18" stroke-width="8"/>
+    <path d="M18 106h60" stroke-width="9"/>
+    <circle cx="105" cy="105" r="17" stroke-width="7"/>
+    <path d="m97 105 5 5 11-12" stroke-width="6"/>
+  </g>
+</svg>