Skip to content

Commit 6aed44f

Browse files
committed
docs(mcode-trajectory-studio): record the CI-measured compatibility rows
Adds what the first green CI run measured for the two moving release lines (22.23.2 / SQLite 3.51.3 and 24.20.0 / SQLite 3.53.4), and states why those two are not pinned in the README table while the boundary versions are. Also trims the macOS/Windows bullet to the fact plus the three test-side platform assumptions the first non-Linux run found, rather than narrating the run.
1 parent 8956287 commit 6aed44f

2 files changed

Lines changed: 17 additions & 10 deletions

File tree

‎plugins/weekbin/mcode-trajectory-studio/README.md‎

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -217,16 +217,20 @@ silently, and `--doctor` prints the path that was actually opened on this machin
217217
No platform-specific handling is needed: paths go through `node:path`, the home directory resolves
218218
from `HOME` or `USERPROFILE`, `git` is invoked with `execFile` and an argument array rather than
219219
a shell, and the SQLite driver is Node's built-in `node:sqlite`. Node.js 22.13.0+ is required on
220-
every platform. The first CI run on those runners was also the first time the suite had ever been
221-
run off Linux, and it found three platform assumptions in the *tests* — a temp path compared
222-
before canonicalization, a POSIX-only path assertion, and a temp directory removed while SQLite
223-
still held it open. All three were test bugs rather than Plugin bugs, and all three are fixed.
220+
every platform. Worth noting for anyone reading the test suite: its first run off Linux found
221+
three platform assumptions, all of them in the tests rather than the Plugin — a temporary path
222+
compared before canonicalization (`/var` on macOS, a short `RUNNER~1` path on Windows), a
223+
POSIX-only assertion about a resolved data directory, and a temporary directory removed while
224+
SQLite still held the file open (`EBUSY` on Windows, harmless on POSIX).
224225
- The Node matrix above was measured by running the Plugin's own suite on each release, not inferred
225226
from release notes. The suite result tracks it exactly: **115 pass / 0 fail** on 22.19.0, 22.21.1,
226227
24.0.0, 24.16.0 and 24.19.0, and **114 pass / 0 fail / 1 skipped** on 22.13.0, 22.15.0, 23.4.0 and
227228
23.11.0 — the single skip being the FTS5 search test, which reports itself as skipped rather than
228229
failing. That is why the floor and the FTS5 boundary are stated as two separate numbers.
229-
`compat-matrix` in CI re-checks that table on every change to this Plugin.
230+
`compat-matrix` in CI re-checks the pinned rows on every change to this Plugin and also
231+
exercises the moving `22.x` and `24.x` lines, which are not pinned here because they resolve
232+
to a new release several times a year (they were 22.23.2 / SQLite 3.51.3 and 24.20.0 /
233+
SQLite 3.53.4 the last time this row was checked).
230234
- `git` is optional. It is used only to group sessions by repository; without it, grouping falls
231235
back to workspace paths.
232236

‎plugins/weekbin/mcode-trajectory-studio/README.zh-CN.md‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -188,15 +188,18 @@ warning 显式报告而不是静默通过;`--doctor` 会打印本机实际打
188188
- **macOS 与 Windows** —— 完整套件在 CI 的 `windows-latest` 与 `macos-latest` 上运行,本插件
189189
每次改动都跑,因此这句话是「一直为真」而不是「曾经为真一次」。代码无需任何平台相关处理:路径
190190
统一走 `node:path`,主目录取 `HOME` 或 `USERPROFILE`,`git` 以 `execFile` + 参数数组调用而非
191-
shell,SQLite 驱动是 Node 内置的 `node:sqlite`。三个平台都要求 Node.js 22.13.0+。首次在这些
192-
runner 上跑 CI,也是这套测试第一次离开 Linux 运行,结果在**测试**里查出三处平台假设——临时路径
193-
未规范化就参与比较、一处只在 POSIX 成立路径断言、以及在 SQLite 仍持有句柄时删除临时目录。三者
194-
都是测试自身的缺陷而非插件缺陷,均已修复。
191+
shell,SQLite 驱动是 Node 内置的 `node:sqlite`。三个平台都要求 Node.js 22.13.0+。给读测试的人
192+
提一句:这套测试第一次离开 Linux 运行时查出三处平台假设,全部在**测试**而非插件里——临时路径未
193+
规范化就参与比较(macOS 的 `/var`、Windows 的短名 `RUNNER~1`)、一处只在 POSIX 成立的
194+
「已解析数据目录」断言、以及在 SQLite 仍持有文件句柄时删除临时目录(Windows 上 `EBUSY`,
195+
POSIX 上无影响)。
195196
- 上面的 Node 矩阵是在每个版本上**实跑插件自身测试套件**测出来的,不是从发布说明推断的。
196197
套件结果与之完全吻合:22.19.0 / 22.21.1 / 24.0.0 / 24.16.0 / 24.19.0 上 **115 通过 / 0 失败**;
197198
22.13.0 / 22.15.0 / 23.4.0 / 23.11.0 上 **114 通过 / 0 失败 / 1 跳过**——那一条跳过正是 FTS5
198199
检索测试,它会自我标记为跳过而不是失败。这正是把「下限」与「FTS5 边界」分两个数字申明的原因。
199-
CI 的 `compat-matrix` 会在本插件每次改动时重新核对这张表。
200+
CI 的 `compat-matrix` 会在本插件每次改动时重新核对上面这些固定版本,并额外覆盖会移动的
201+
`22.x` / `24.x` 线——它们每年会解析到若干次新版本,因此不在此表内固定(最近一次核对时分别是
202+
22.23.2 / SQLite 3.51.3 与 24.20.0 / SQLite 3.53.4)。
200203
- `git` 是可选的。它仅用于按仓库分组会话;没有它时,分组回退为按工作区路径。
201204

202205
### 测试证据

0 commit comments

Comments
 (0)