peaks-loop 4.2.1 → 4.2.2

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.2"
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.2",
11
11
  "author": {
12
12
  "name": "SquabbyZ"
13
13
  },
package/CHANGELOG.md CHANGED
@@ -1,5 +1,62 @@
1
1
  # Changelog
2
2
 
3
+ ## 4.2.2 — 2026-11-19(`peaks mut` 在全局安装下能启动了)
4
+
5
+ **版本级别**:**patch**(一个缺陷修复;无门禁阈值放宽,无 schema 变更,无 API 变化)。
6
+
7
+ **一句话:补上一个谁都没声明的依赖,让装好的 `peaks` 能跑变异测试。**
8
+
9
+ ### 1. `peaks mut` 在全局安装下必然失败
10
+
11
+ 全局安装的 `peaks`(4.2.1)对**任何带 `tsconfig.json` 的项目**都跑不了 `peaks mut`:
12
+
13
+ ```
14
+ code: MUT_TOOLCHAIN_UNAVAILABLE
15
+ message: Stryker invocation failed: Cannot find package 'typescript' imported from
16
+ .../node_modules/peaks-loop/node_modules/@stryker-mutator/core/dist/src/sandbox/ts-config-preprocessor.js
17
+ ```
18
+
19
+ 根因不是我们忘了装,而是**三层都没声明**:`@stryker-mutator/core@9.6.1` 在
20
+ `dist/src/sandbox/ts-config-preprocessor.js` 第 45 行和第 85 行 `await import('typescript')`,
21
+ 而它自己的 `dependencies` / `peerDependencies`(`{}`)/ `optionalDependencies` **一处都没有**
22
+ typescript。把 core、instrumenter、api、util 四个包的 dist 全扫一遍,**只有这一处**是「裸导入但未声明」。
23
+ 那个 preprocessor 在 `inPlace` 为假且目标项目有 tsconfig 时必定执行——也就是几乎所有真实的 TS 项目。
24
+
25
+ 而 4.1.25 那次只把 `@stryker-mutator/core` 和 `vitest-runner` 放进了
26
+ `packages/peaks-loop-mut` 的 `dependencies`,**没带 typescript**。Node 从**导入文件**所在目录向上解析,
27
+ 于是项目内安装时「碰巧」找到消费者自己的 typescript;全局安装向上走到全局 prefix,**什么也没有**,
28
+ 与目标项目装没装无关。
29
+
30
+ 实测(全局 peaks-loop 4.2.1 安装):
31
+
32
+ | 探针 | 结果 |
33
+ |---|---|
34
+ | `<global>/node_modules/typescript/package.json` | 缺失 |
35
+ | 从 core 的 sandbox 目录 `require.resolve('typescript')` | `MODULE_NOT_FOUND` |
36
+ | 同一探针跑在本仓 | 解析到 5.9.3 |
37
+
38
+ **修复**:`typescript` 成为 `packages/peaks-loop-mut` 的运行时依赖,`^5.9.3`——与根
39
+ devDependency 同一个 major,两侧清单仍然一致,本仓自己的 `tsc` 不受影响。
40
+ 守卫测试从「两个 stryker 包」扩展成一组 `{ name, rootReason }` 条目,typescript 成为第三条,
41
+ 每条的红灯文案各自指向真正的解析方(stryker 插件由本仓的 `stryker.conf.js` 解析,typescript 由本仓的
42
+ `tsc` 解析),并新增两条变异臂证明新条款**会**红。
43
+
44
+ **代价,写在明面上:typescript 解包后 23 MB,现在跟着每一次安装走**,无论用不用变异测试。
45
+ 这是一个明确的取舍(2026-11-19 维护者决定),另外两条路都被否掉:声明为可选 peer 依赖只会让全局安装
46
+ **仍然不可用**、只是报错更清楚;绕过 tsconfig 预处理能省体积,但会让沙箱内 `extends` 与
47
+ project-reference 的路径不再被重写,反而破坏依赖它们的消费者。
48
+
49
+ ### 2. 更正 4.2.1 里对此的措辞
50
+
51
+ 4.2.1 的「已知未修」写的是「用项目本地命令可绕过,且全局安装本就不宜跑变异测试」。
52
+ **前一句是假的**:本地安装能用,是因为消费者项目自己恰好有 typescript,不是因为本地安装是一种受支持的形态。
53
+ 这是一处**缺失的声明**,不是一种使用姿势的限制。原文保留在 4.2.1 段里,在此更正。
54
+
55
+ **验证**:守卫 15/15 绿;把 typescript 挪回 `devDependencies` 后同一文件 **4/15 红**并点名清单、
56
+ 包名与原因,还原后复绿;`tsc --noEmit` exit 0;`tests/unit/release` 101 passed。
57
+ **本切片不能宣称的事**:发布后的 tarball 能否在全局解析 typescript,在工作树里无法证明——
58
+ 那是 `npm pack` 产物的事。该验证放在发布环节,用装好的产物跑同一个解析探针。
59
+
3
60
  ## 4.2.1 — 2026-11-17(auto-compact 真正接上恢复;project-scan 不再冻结)
4
61
 
5
62
  **版本级别**:**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.2",
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.69",
137
+ "peaks-loop-mut": "0.1.83",
138
+ "peaks-loop-shared": "0.0.118",
139
+ "peaks-loop-workspace-runtime": "0.0.3",
140
+ "peaks-loop-shared-channel": "0.0.86"
141
141
  },
142
142
  "devDependencies": {
143
143
  "@changesets/cli": "2.31.1",