refactor: make production gate impact only
Memind CI / Test, build, and release guards (push) Has been cancelled

This commit is contained in:
john
2026-07-28 01:13:28 +08:00
parent 864197162d
commit 7a381db132
14 changed files with 195 additions and 98 deletions
+18 -21
View File
@@ -2,14 +2,14 @@
> 适用目标:生产 `103` Portal runtime 及其共享链路。
> 规则状态:已确认为生产发布的强制验收规范。
> 当前实施状态:187 场景机器目录保留为完整回归资产;常规生产发布使用 16 项 Core Gate 加 Git diff 自动选择的影响域 Gate。关键共享路径、无法映射的运行时代码或高风险变更自动升级为完整 187 项 Gate。任何被选择但未实现、未执行或证据不完整的场景保持 `unknown` 并阻断发布。
> 当前实施状态:187 场景机器目录保留为回归审计资产;生产发布使用 16 项 Core Gate 加 Git diff 自动选择的影响域 Gate,不再自动执行完整 187 项。关键共享路径展开到预定义影响域;无法映射的运行时代码、无有效基线或不可重现的选择结果直接阻断发布。任何被选择但未实现、未执行或证据不完整的场景保持 `unknown` 并阻断发布。
## 1. 目标
本守门员将生产发布从“运行若干测试后人工判断”升级为绑定同一源码和同一产物的可审计硬闸门:
1. 只有完整、干净、可追溯的 `main` 可以成为候选版本。
2. 同一个 `main` commit 构建出的同一个 runtime artifact,必须完成 Core Gate 和影响选择器选出的全部场景;满足全量触发条件时执行完整 187 项。
2. 同一个 `main` commit 构建出的同一个 runtime artifact,必须完成 Core Gate 和影响选择器选出的全部场景;生产发布脚本不执行完整 187 项。
3. 结果必须满足 `failed=0``skipped=0``cleanup_failed=0`
4. 常规风险分层报告不要求为未选场景逐项填写 `not_applicable`;选择器必须记录 changed paths、影响域和选择证据,被选中的场景不能豁免。
5. 即使机器闸门全部通过,仍须取得用户针对“发布 103”动作本身的明确批准。
@@ -24,7 +24,7 @@
| Scenario family | 本文定义的一条业务或运行时场景;可包含多个参数化 case |
| Core Gate | 每次生产候选都必须执行的 16 项最小安全闭包 |
| Impact Gate | 根据线上 commit 到候选 commit 的 Git diff 自动选择的业务域场景 |
| Full Gate | 高风险、共享入口或影响范围不明时执行的完整 187 项回归 |
| Catalog audit | 人工或定期执行的完整 187 项回归资产,不是生产发布前置条件 |
| Deterministic case | 不依赖真实外部模型输出、可以稳定重复的单元或集成测试 |
| Live canary | 在隔离或预生产环境调用真实 LLM、图片、搜索等服务的最小验证 |
| `not_applicable` | 有完整影响证明并经审核后,确认本次发布不适用的场景状态 |
@@ -43,7 +43,6 @@
- Core Gate 和影响选择器选出的全部场景均为 `passed`
- 没有 `failed``skipped``blocked``unknown` 或未执行场景。
- 风险分层报告的 base commit、changed paths、影响域和 selected IDs 能够从 Git diff 重算且完全一致。
- 全量报告如果使用 `not_applicable`,所有记录均具有有效的影响评估和审核信息。
- 测试数据和临时资源清理完成。
- Gate report 未过期;默认有效期不超过 4 小时。
- 103 只读预检通过。
@@ -66,17 +65,17 @@ Core Gate 之外,选择器以当前 103 manifest 中的 `git_head` 为 base co
commit 的 changed paths,并按 `release-gate/impact.mjs` 的版本化规则选择业务域和依赖闭包。
正常风险分层报告中的被选场景必须真实执行,不能标记为 `not_applicable`
### 3.3 自动升级为 Full Gate
### 3.3 关键路径与阻断规则
以下情况必须执行完整 187 项
生产选择器不再升级为完整 187 项,按以下规则处理
- `server.mjs`、鉴权/会话基础设施、数据库 schema/migration、runtime 构建和生产启动脚本变化。
- 依赖清单或 lockfile、goosed/worker/代理、公共配置和发布闸门自身变化。
- 影响选择器无法映射任一运行时代码路径。
- 线上 base commit 不可用、不是候选祖先,或选择结果无法从 Git diff 重现。
- 上次灰度或生产发布失败,或明确要求完整回归
- `server.mjs`、鉴权/会话基础设施、数据库 schema/migration、runtime 构建、依赖、
goosed/worker/代理、公共配置和发布闸门自身变化时,展开到版本化规则声明的影响域
- 影响选择器无法映射任一运行时代码路径时直接失败,必须先提交映射与测试
- 线上 base commit 不可用、不是候选祖先,或选择结果无法从 Git diff 重现时直接失败
- 上次灰度或生产发布失败时先回滚并修复;新的候选重新执行 Core + Impact
### 3.4 Full Gate 中永远不可豁免的场景
### 3.4 回归目录中永远不可豁免的场景
下列场景不允许标记为 `not_applicable`
@@ -95,7 +94,7 @@ commit 的 changed paths,并按 `release-gate/impact.mjs` 的版本化规则
- `CFG-08` 模型配置兼容场景。
- `COMP-08``COMP-09`
### 3.5 Full Gate 中 `not_applicable` 的判定
### 3.5 人工目录审计中 `not_applicable` 的判定
只有同时满足以下条件,才允许将场景标记为 `not_applicable`
@@ -550,8 +549,8 @@ npm run verify:release-gate-report -- --artifact .runtime/portal
"expires_at": "<ISO-8601>",
"environment_fingerprint": "<sha256>",
"selection": {
"policy_version": 1,
"strategy": "core|impact|full",
"policy_version": 2,
"strategy": "core|impact",
"base_commit": "<103 stable sha>",
"catalog_total": 187,
"selected_total": 32,
@@ -585,7 +584,7 @@ passed = required = selected_total
failed = skipped = blocked = unknown = cleanup_failed = 0
```
完整 187 项报告如果存在合法 `not_applicable`,必须满足:
人工或定期目录审计如果存在合法 `not_applicable`,必须满足:
```text
passed + not_applicable = required
@@ -619,9 +618,8 @@ commit、artifact 和 Gate report,并完成备份、只读预检及人工批
4. 计算 artifact SHA256
5. 读取对应 Gate report;不存在或过期时自动读取 103 稳定 commit 并执行 Core + Impact Gate
6. 从 Git diff 重算并校验 base commit、changed paths、影响域、selected IDs、artifact、环境和有效期
7. 满足全量触发条件时确认报告覆盖完整 187 项
8. 执行 103 只读预检
9. 请求本次发布的明确人工批准,批准后才允许上传
7. 执行 103 只读预检
8. 请求本次发布的明确人工批准,批准后才允许上传
以下情况必须直接退出:
@@ -630,8 +628,7 @@ commit、artifact 和 Gate report,并完成备份、只读预检及人工批
- report 不存在、过期或解析失败
- commit 或 artifact SHA 不一致
- 任一被选场景失败、跳过、未知、未执行或清理失败
- 影响选择结果不可重现存在未处理路径,或应全量时报告不完整
- 全量报告中的豁免记录缺少审核信息
- 影响选择结果不可重现存在未映射路径
- 103 有活动任务且未完成排空
- 备份、磁盘空间、数据库锁或回滚预检失败
+2 -2
View File
@@ -51,8 +51,8 @@ LaunchAgent、Portal provider 同步和路由器依赖健康配置是否属于
## 发布入口
候选必须来自干净且等于 `origin/main` 的完整 `main`CI 成功,并具有与
`.runtime/portal` 完全一致、未过期且可从线上 base commit 重算选择结果的风险分层
Gate report;满足全量触发条件时报告必须覆盖完整 187 项
`.runtime/portal` 完全一致、未过期且可从线上 base commit 重算选择结果的 Core + Impact
Gate report。关键路径展开到预定义影响域;未映射路径或无效基线直接阻断
```bash
bash scripts/release-portal-canary-prod.sh --yes
+8 -8
View File
@@ -4,15 +4,15 @@
自动发布闸门采用 fail-closed 设计。机器目录从 `production-release-guardian.md` 加载并校验
187 个连续、唯一场景编号,但常规发布只执行 16 项核心场景和 Git diff 选择的影响域。
关键、共享或无法映射的运行时路径自动升级为完整 187 项;执行器不能把被选择但没有实现、
没有执行或没有证据的场景视为成功。
关键、共享路径展开到预定义影响域;无法映射的运行时路径直接阻断并要求先补映射。
生产发布不再自动执行完整 187 项,执行器不能把被选择但没有实现、没有执行或没有证据的场景视为成功。
已经实现:
- `release-gate/catalog.mjs`:187 场景机器目录和永远不可豁免清单。
- `release-gate/safety.mjs`:拒绝生产 IP、`*.tkmind.cn`、生产路径和生产关联环境变量。
- `release-gate/artifact.mjs`runtime 排序目录树 SHA256、依赖闭包和持久数据扫描。
- `release-gate/impact.mjs`Core Gate、changed-path 业务域映射、依赖闭包和全量触发规则。
- `release-gate/impact.mjs`Core Gate、changed-path 业务域映射、依赖闭包和未映射阻断规则。
- `release-gate/runner.mjs`:suite 执行、日志归档和失败关闭。
- `release-gate/report.mjs``report.json`、Markdown、JUnit、环境指纹及四小时有效期。
- `release-gate/regression-corpus.mjs`:脱敏生产回归 fixture 和 active manifest 校验。
@@ -67,10 +67,10 @@ node scripts/run-release-gate-impact.mjs --artifact .runtime/portal --deployed-c
它固定执行 16 项核心场景,再根据 `<103-stable-sha>..HEAD` 的 changed paths 选择业务域及
依赖闭包。`server.mjs`、鉴权/会话基础设施、schema/migration、依赖、runtime 构建、
生产启动/发布脚本Gate 自身或未映射运行时代码会自动选择完整 187 项。发布脚本在有效报告
生产启动/发布脚本Gate 自身会展开到预定义影响域;未映射运行时代码直接失败。发布脚本在有效报告
缺失或过期时自动执行该入口,不再要求人工先跑多个 mode 或逐项填写 129 条豁免。
离线 `--dry-run` 不连接 103;如需模拟风险分层,可设置
`MEMIND_RELEASE_BASE_COMMIT=<known-stable-sha>`未提供时安全退化为本地 Full Gate
`MEMIND_RELEASE_BASE_COMMIT=<known-stable-sha>`未提供有效基线时直接阻断
2026-07-26 本地补齐验证中,历史完整报告为 180/187 通过;`REL-01` 因当前仍在功能
分支且工作区不干净而失败。PAGE-01/02 与 DATA-01/02/03/04 的隔离栈现在使用后台
@@ -97,7 +97,7 @@ node scripts/run-release-gate-impact.mjs \
--deployed-commit <103-stable-sha>
```
高风险变更、选择器自身变化或定期回归运行完整闸门
人工或定期目录审计仍可运行完整闸门,但生产发布脚本不会调用它
```bash
npm run test:release-gate:all -- --artifact .runtime/portal
@@ -139,8 +139,8 @@ npm run verify:release-gate-report -- --artifact .runtime/portal
- 风险分层或完整闸门只为干净 `main` 的精确 commit + artifact 生成一次四小时有效报告;
发布脚本复用并校验这份报告,不重复跑慢场景。commit、artifact 或环境指纹变化后
证据立即失效并重新执行。
- 本地开发先跑相关确定性 suite普通发布候选执行 Core + Impact完整 187 项用于高风险
候选和定期回归。任何被选择但未执行、超时或缺证据项仍保持 `unknown/failed` 并阻断发布。
- 本地开发先跑相关确定性 suite生产候选固定执行 Core + Impact完整 187 项用于人工
或定期审计。任何被选择但未执行、超时或缺证据项仍保持 `unknown/failed` 并阻断发布。
报告出现以下任意状态都会返回非零:
+1 -1
View File
@@ -45,7 +45,7 @@ npm run check:mindspace-public-links
## 2. Portal runtime 发布唯一流程
生产发布守门员、风险分层或全量 Gate report 和本次明确人工批准全部满足后,首次生产动作只使用:
生产发布守门员、Core + Impact Gate report 和本次明确人工批准全部满足后,首次生产动作只使用:
```bash
bash scripts/release-portal-canary-prod.sh --yes