peaks-loop 4.2.1 → 4.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "metadata": {
3
3
  "pluginRoot": ".",
4
- "version": "4.2.1"
4
+ "version": "4.2.3"
5
5
  },
6
6
  "plugins": [
7
7
  {
8
8
  "name": "peaks-loop",
9
9
  "description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
10
- "version": "4.2.1",
10
+ "version": "4.2.3",
11
11
  "author": {
12
12
  "name": "SquabbyZ"
13
13
  },
package/CHANGELOG.md CHANGED
@@ -1,5 +1,124 @@
1
1
  # Changelog
2
2
 
3
+ ## 4.2.3 — 2026-11-19(变异基线从 19.1% 提到 80.5%,首次过阈值)
4
+
5
+ **版本级别**:**patch**(只加测试,无源码行为变化;无门禁阈值放宽,无 schema 变更)。
6
+
7
+ **一句话:`peaks mut` 的达标线第一次真的过了——而且过的方式是把「测试根本跑不进沙箱」这个根因修掉,不是堆断言。**
8
+
9
+ ### 1. 为什么基线只有 19.1%:不是断言弱,是测试根本没被执行
10
+
11
+ `peaks mut run` 的默认 `mut:run` 只喂了 **1 个**测试文件,492 个变异体里 **265 个是 NoCoverage**——从未被执行过。
12
+
13
+ 但把更多测试接进去也解决不了:这四个被变异模块的现有测试**全部**调用 `withTmpWorkspacePerTest()`,它会 `process.chdir()`;而 Stryker 的 vitest-runner 在 `createVitest` 里**硬编码** `pool: 'threads'`,worker 里 chdir 直接抛异常,整轮变异在 dry run 阶段就中止:
14
+
15
+ ```
16
+ DryRunExecutor One or more tests failed in the initial test run:
17
+ process.chdir() is not supported in workers
18
+ ```
19
+
20
+ 实测:`pipeline-verify-qa-phase.ts` 有 `type-tables-are-authoritative.test.ts` 提供的 **100% 语句覆盖**,变异击杀率仍是 **0%**。覆盖率与击杀率在这里是两件事。
21
+
22
+ **解法是写不依赖 cwd 的测试**:六组新文件全部通过 `ProgramIO` 录制器和字面量参数驱动纯导出函数——无临时目录、无 chdir、无文件系统。
23
+
24
+ ### 2. 各文件战果
25
+
26
+ | 文件 | 起点 | 终点 |
27
+ |---|---|---|
28
+ | `cli-helpers.ts` | 62.5% | **98.0%** |
29
+ | `path-safety.ts` | 43.9% | **80.2%** |
30
+ | `verdict-aggregate-command.ts` | 53.8% | **75.9%** |
31
+ | `pipeline-verify-qa-phase.ts` | 0% | **52.2%** |
32
+ | **合计** | **19.1%** (94/492) | **80.5%** (396/492) |
33
+
34
+ ### 3. 最后四个击杀都是真实的断言缺口
35
+
36
+ 不是为了过线凑数:
37
+
38
+ - `printInvalidConfigLayer` 的补救文案原先只用 `toContain`——看不出「替换后子串仍在」的变异。改为精确断言。
39
+ - `verdict.aggregate` 的 `command` 字段**从未被断言**——下游读取器靠它路由,字面量一直以 `""` 存活。
40
+ - **karpathy envelope 的 ternary 从未被证明到达聚合器**——`sources.karpathy === 'present'` 只证明文件被*读到*。用 `gateAction: block` 的 fixture 现在强制出 `block` verdict,而三个必需源都在场时任何单个叶子判定都产生不了它。
41
+ - `printResult` 的 **TEXT 分支**在守卫路径上从未执行——其他所有臂都传了 `--json`。
42
+
43
+ ### 4. 剩下 84 个存活体 + 12 个不可跑,逐个手工验证过
44
+
45
+ **三个确实被测试杀掉,但报告记 Survived**(vitest-runner 的归因缺陷):
46
+
47
+ | 变异体 | 手工应用到工作树后 |
48
+ |---|---|
49
+ | `isControlCodePoint → () => undefined` | 3 个测试红 |
50
+ | `isArtifactRepoSegment` 正则去掉 `^` 锚 | 1 个测试红 |
51
+ | `QA_EVIDENCE_GATES[0] = {}` | 模块导入即抛 |
52
+
53
+ **两个确认等价**:`if (!path || !artifactRoot)` 弱化为 `&&` 后整个测试文件仍全绿(`normalizeArtifactPath('')` 依然不产生前导斜杠);`path-safety` 的 `://` 子句被段循环覆盖。
54
+
55
+ **12 个 unaccounted** 是 CompileError / RuntimeError 一类,任何测试都杀不掉。
56
+
57
+ **没有为等价变异体写断言。** 那样做是对测试的谎报,宁可停在 80.5% 并写清原因。
58
+
59
+ ### 5. 顺带修掉的三类自身债务
60
+
61
+ 新测试第一次 push 被闸口拦下,三类问题都是我们引入的:孤儿 import 与多余类型断言(12 条 lint)、27 处 BDD 三连注释不合规(必须是回调块**最前面的三条连续注释**)、以及 `gate-baseline.json` 缺文件行。全部在源头修复,未抑制。
62
+
63
+ **验证**:153 文件 / 1484 测试绿;`tsc --noEmit` exit 0;prettier 与 eslint(项目自身配置)干净;baseline `shadow unchanged (773/261)` 零新增 lint 债务;`peaks mut run` exit 0。
64
+
65
+ ## 4.2.2 — 2026-11-19(`peaks mut` 在全局安装下能启动了)
66
+
67
+ **版本级别**:**patch**(一个缺陷修复;无门禁阈值放宽,无 schema 变更,无 API 变化)。
68
+
69
+ **一句话:补上一个谁都没声明的依赖,让装好的 `peaks` 能跑变异测试。**
70
+
71
+ ### 1. `peaks mut` 在全局安装下必然失败
72
+
73
+ 全局安装的 `peaks`(4.2.1)对**任何带 `tsconfig.json` 的项目**都跑不了 `peaks mut`:
74
+
75
+ ```
76
+ code: MUT_TOOLCHAIN_UNAVAILABLE
77
+ message: Stryker invocation failed: Cannot find package 'typescript' imported from
78
+ .../node_modules/peaks-loop/node_modules/@stryker-mutator/core/dist/src/sandbox/ts-config-preprocessor.js
79
+ ```
80
+
81
+ 根因不是我们忘了装,而是**三层都没声明**:`@stryker-mutator/core@9.6.1` 在
82
+ `dist/src/sandbox/ts-config-preprocessor.js` 第 45 行和第 85 行 `await import('typescript')`,
83
+ 而它自己的 `dependencies` / `peerDependencies`(`{}`)/ `optionalDependencies` **一处都没有**
84
+ typescript。把 core、instrumenter、api、util 四个包的 dist 全扫一遍,**只有这一处**是「裸导入但未声明」。
85
+ 那个 preprocessor 在 `inPlace` 为假且目标项目有 tsconfig 时必定执行——也就是几乎所有真实的 TS 项目。
86
+
87
+ 而 4.1.25 那次只把 `@stryker-mutator/core` 和 `vitest-runner` 放进了
88
+ `packages/peaks-loop-mut` 的 `dependencies`,**没带 typescript**。Node 从**导入文件**所在目录向上解析,
89
+ 于是项目内安装时「碰巧」找到消费者自己的 typescript;全局安装向上走到全局 prefix,**什么也没有**,
90
+ 与目标项目装没装无关。
91
+
92
+ 实测(全局 peaks-loop 4.2.1 安装):
93
+
94
+ | 探针 | 结果 |
95
+ |---|---|
96
+ | `<global>/node_modules/typescript/package.json` | 缺失 |
97
+ | 从 core 的 sandbox 目录 `require.resolve('typescript')` | `MODULE_NOT_FOUND` |
98
+ | 同一探针跑在本仓 | 解析到 5.9.3 |
99
+
100
+ **修复**:`typescript` 成为 `packages/peaks-loop-mut` 的运行时依赖,`^5.9.3`——与根
101
+ devDependency 同一个 major,两侧清单仍然一致,本仓自己的 `tsc` 不受影响。
102
+ 守卫测试从「两个 stryker 包」扩展成一组 `{ name, rootReason }` 条目,typescript 成为第三条,
103
+ 每条的红灯文案各自指向真正的解析方(stryker 插件由本仓的 `stryker.conf.js` 解析,typescript 由本仓的
104
+ `tsc` 解析),并新增两条变异臂证明新条款**会**红。
105
+
106
+ **代价,写在明面上:typescript 解包后 23 MB,现在跟着每一次安装走**,无论用不用变异测试。
107
+ 这是一个明确的取舍(2026-11-19 维护者决定),另外两条路都被否掉:声明为可选 peer 依赖只会让全局安装
108
+ **仍然不可用**、只是报错更清楚;绕过 tsconfig 预处理能省体积,但会让沙箱内 `extends` 与
109
+ project-reference 的路径不再被重写,反而破坏依赖它们的消费者。
110
+
111
+ ### 2. 更正 4.2.1 里对此的措辞
112
+
113
+ 4.2.1 的「已知未修」写的是「用项目本地命令可绕过,且全局安装本就不宜跑变异测试」。
114
+ **前一句是假的**:本地安装能用,是因为消费者项目自己恰好有 typescript,不是因为本地安装是一种受支持的形态。
115
+ 这是一处**缺失的声明**,不是一种使用姿势的限制。原文保留在 4.2.1 段里,在此更正。
116
+
117
+ **验证**:守卫 15/15 绿;把 typescript 挪回 `devDependencies` 后同一文件 **4/15 红**并点名清单、
118
+ 包名与原因,还原后复绿;`tsc --noEmit` exit 0;`tests/unit/release` 101 passed。
119
+ **本切片不能宣称的事**:发布后的 tarball 能否在全局解析 typescript,在工作树里无法证明——
120
+ 那是 `npm pack` 产物的事。该验证放在发布环节,用装好的产物跑同一个解析探针。
121
+
3
122
  ## 4.2.1 — 2026-11-17(auto-compact 真正接上恢复;project-scan 不再冻结)
4
123
 
5
124
  **版本级别**:**patch**(三个缺陷修复 + 一个 MCP 工具;无门禁阈值放宽,无 schema 变更)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "peaks-loop",
3
- "version": "4.2.1",
3
+ "version": "4.2.3",
4
4
  "description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
5
5
  "author": "SquabbyZ",
6
6
  "keywords": [
@@ -133,11 +133,11 @@
133
133
  "picomatch": "4.0.7",
134
134
  "yaml": "^2.9.1",
135
135
  "zod": "^4.6.7",
136
- "peaks-loop-internal-runtime": "0.0.68",
137
- "peaks-loop-mut": "0.1.82",
138
- "peaks-loop-shared": "0.0.117",
139
- "peaks-loop-shared-channel": "0.0.85",
140
- "peaks-loop-workspace-runtime": "0.0.2"
136
+ "peaks-loop-internal-runtime": "0.0.70",
137
+ "peaks-loop-mut": "0.1.84",
138
+ "peaks-loop-shared": "0.0.119",
139
+ "peaks-loop-shared-channel": "0.0.87",
140
+ "peaks-loop-workspace-runtime": "0.0.4"
141
141
  },
142
142
  "devDependencies": {
143
143
  "@changesets/cli": "2.31.1",