v0.7.1: 盲点 23 闭环 (Actions/Module NPE root cause + fix-columndata + menu auto parent)

- form/create.ts: columnData 显式补 4 use*Permission 字段 (盲点 23 修)
- form/fix-columndata.ts: 新 10 子命令, 修老 form
- form/index.ts: 注册 fix-columndata
- menu/create.ts: 模式 A 不传 --pcParents 时自动 SelectorFilter 找根
- tests/unit/fix-columndata.test.ts: 3 个验证
- tests/e2e/p16-ui-real-crud.spec.ts: P0 #16 spec 部分 (1+2 待 tds_leave 修后 PASS)
- doc/v0.7.1-changelog.md: 详细变更
- doc/RESUME.md: v0.7.1 状态更新

基线: typecheck 0 错 + vitest 36/36 PASS + Playwright 21/21 PASS (无 regression)
新 baseline 阻塞: tds_leave 老 form 需用户手动跑 fix-columndata + menu create --formId
This commit is contained in:
ssw committed 2026-06-12 19:45:26 +08:00
1 parent c98ad4f425
commit 76a25f67dd
12 files changed
+696 -75

No files matched your search

+15 -2
View File
@@ -8,12 +8,25 @@ description: Use when working with JNPF platform form/menu/workflow creation, da
> **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目)
> **运行时**: Node 22 + tsx (启动 < 500ms)
> **入口**: `npx tsx $ccWorkDir/dacli/src/cli.ts <command>`(或 `cd $ccWorkDir/dacli && npx tsx src/cli.ts <command>`)
> **当前状态**: **v0.7 (2026-06-12) — 8 父命令 / 26+ 子命令 + form release endpoint 修 + dm create web 真路径 + AI 需求驱动闭环**
> **当前状态**: **v0.7.1 (2026-06-12) — 8 父命令 / 27 子命令 + form create columnData 补字段 + menu create 自动父菜单 + fix-columndata 工具**
> **目标**: **0 差错** (workSystem 85 + developSystem 29 baseline API + UI 全 0 错)
> **对照**: Java 版 `ssw-dacli` (已废弃归档) 见 `docs/dacli/ssw-dacli/`
---
## 🆕 v0.7.1 关键校准 (2026-06-12, AI 必读)
| 校准项 | 旧 (v0.7) | 新 (v0.7.1) | 影响 |
|--------|-----------|------------|------|
| **form create columnData 字段** | 缺 4 个 `use*Permission` (useBtnPermission/useColumnPermission/useFormPermission/useDataPermission) | 显式补 `false` | 后端 `VisualUtil.setPcPermission:139` 不再 NPE, Actions/Module 不再"System abnormality" |
| **dacli form fix-columndata** | 无 | 新增 `dacli form fix-columndata <id>` | 修老 form 的 columnData (v0.7 前漏字段的), PUT 回去, `--dry-run` 只看不改 |
| **menu create --formId 自动父菜单** | `--pcParents` 默认 `['0']` (tds 等应用无 id=0) → 报"找不到该上级" | 不传 `--pcParents` 时自动调 `/system/Menu/SelectorFilter/0?category=Web` 拉 Web 根菜单 (web `getMenuSelectorFilter` 同款) | 不传参也能跑, 修盲点 23 续 |
| **menu create Actions/Module 失败** | tds 报"System abnormality" → 退低级路径 (但 moduleId=null) | Actions/Module 真路径成功 (columnData 修了 + 父菜单自动找), 真正绑 moduleId, `/model/<enCode>` 真渲染 | 解锁 P0 #16 UI 真点击 CRUD |
详见 [doc/v0.7.1-changelog.md](../../../doc/v0.7.1-changelog.md) + [references/troubleshooting.md](references/troubleshooting.md) 错误 23.
---
## 🆕 v0.7 关键校准 (2026-06-12, AI 必读)
| 校准项 | 旧 (v0.6) | 新 (v0.7) | 影响 |
@@ -55,7 +68,7 @@ description: Use when working with JNPF platform form/menu/workflow creation, da
| 命令 | 端到端验证 | 子命令 | 备注 |
|------|------------|--------|------|
| `dacli login / status / switch-app` | ✅ | 3 顶层 | token 持久化 + dbLinkId 自动检测 |
| `dacli form` | ✅ | list/info/create/release/delete/export/import/clone/validate (9) | list 端点 v0.6 修, import 不建表 (#15 留) |
| `dacli form` | ✅ | list/info/create/release/delete/export/import/clone/validate/**fix-columndata** (10) | v0.7.1 修 columnData 缺字段, 加修老 form 工具 |
| `dacli dm` | ✅ | list/create/drop/fields (4) | 物理表 CRUD |
| `dacli dict` | ✅ | type-list/data-list (2) | 字典类型 + 数据 |
| `dacli menu` | ✅ | list/create/delete/**unrelease** (4) | create 改 web 真路径; unrelease 新加 |
@@ -441,3 +441,39 @@ dacli form create --type=1 --webType=2 --enCode=tds_leave --tables='[{
**反模式**: type=1 webType=2 期望 form create 自动用已有表 → 后端不会, 必须显式传.
---
### 错误 23: menu create (Actions/Module) 报 "System abnormality" (盲点 23 根因)
**症状** (v0.7.1 之前):
```json
{"code":400,"msg":"System abnormality"}
```
后端 `log_error.log` 实际是:
```
NullPointerException: Cannot invoke "java.lang.Boolean.booleanValue()"
because the return value of "ColumnDataModel.getUseBtnPermission()" is null
at jnpf.base.util.VisualUtil.setPcPermission(VisualUtil.java:139)
at jnpf.base.util.VisualUtil.getVisual(VisualUtil.java:104)
at jnpf.base.controller.VisualdevController.createModule(VisualdevController.java:696)
```
**根因**: v0.7.1 之前 `dacli form create` 写的 `columnData` JSON 缺 4 个 `use*Permission` 字段 (useBtnPermission/useColumnPermission/useFormPermission/useDataPermission), Jackson 反序列化为 `null`, 后端 `setPcPermission` 解 `.booleanValue()` NPE.
**修法**:
1. **新 form**: v0.7.1 起 `form create` 自动加 4 个 `use*Permission: false`, 不再触发.
2. **老 form**: 用 `dacli form fix-columndata <id>` 补 4 个字段:
```bash
dacli form fix-columndata 835168490678657989
# 干跑:
dacli form fix-columndata 835168490678657989 --dry-run
```
3. **menu create 也修了**: `dacli menu create --formId=X` 不传 `--pcParents` 时, 自动从 `/system/Menu/SelectorFilter/0?category=Web` 拉 Web 根菜单当父 (旧默认 "0" 在 tds 等应用下不存在, 报 "找不到该上级").
**症状 2 (v0.7.1 修了 columnData 后冒出来)**: `Actions/Module` 报 `"找不到该上级"`.
- 原因: `--pcParents` 默认 "0" 在很多应用下不存在
- 解: 不传 `--pcParents`, 让 dacli 自动发现 (见上修法 3)
**症状 3 (Actions/Module 全过但 form 页面报 "该表单已删除")**: form 和菜单虽绑定, 但物理表不在业务库.
- 解: 走 `#15 autoTable` 流程: `dacli form import x.json --autoTable` (默认 true)
+1
View File
@@ -6,6 +6,7 @@ screenshots/
test-results/
playwright-report/
.env.local
.pnpm-store
*.log
src/data/*.json
!src/data/.gitkeep
+7 -5
View File
@@ -4,9 +4,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## 项目定位
`dacli`(TS 版)是 JNPF 低代码平台的命令行工具,**当前主用 CLI**。Java 版(`boot/ssw-dacli/`,已废弃)源码归档在 `../docs/dacli/ssw-dacli/` 备查。本项目从 JNPF web 源码直接提取控件 schema + FieldBuilder,避免 53 个手写 builder 的维护成本。
`dacli`(TS 版)是 JNPF 低代码平台的命令行工具,**当前主用 CLI**。本项目从 JNPF web 源码直接提取控件 schema + FieldBuilder,避免 53 个手写 builder 的维护成本。
**核心目标**: 复刻 JNPF 官方示例 (workSystem 85 + developSystem 29 = **114 张 baseline**) 到 **API 0 错 + 浏览器 0 视觉差**。
**核心目标**: 复刻 JNPF 官方示例 (workSystem + developSystem ) 到 **API 0 错 + 浏览器 0 视觉差**。
** ../web/代码 和 官方示例 和 playwright 是 唯一可信源 **
详细设计: `doc/architecture.md` (6 个关键决策)、`doc/plan.md` (6 周路线)、`doc/v0.7-changelog.md` (最新校准)。
@@ -117,9 +118,10 @@ output (JSON / table / --ai-help markdown)
## 父项目约定
本项目从属于 `$ccWorkDir/`(含 JNPF 后端、前端、平台源码)。父项目规则:
- 凭据 `admin` / `123456`,JNPF API 入口 `http://127.0.0.1:30000`(容器内 `http://nginx/`)
- 凭据 `admin` / `123456`, 入口容器内 `http://nginx/` http://nginx/api代理到 `http://127.0.0.1:30000`/api
- 后端日志 $ccWorkDir/log/jnpf-java-boot/
- 表名 `snake_case` 无前缀,字段 `f_` 前缀(`f_version` 系统关键字禁用)
- 修改范围: 仅本项目文件 + `.claude/`;**禁止** 改 `jnpf/` `web/` `uniapp/`
- 父项目有 git hooks (auto-push),本项目 `dacli/` **无独立 git 仓库**(`.claude/.git` 只跟踪 `.claude/`)
- 修改范围: 仅本项目文件 + `.claude/`;**禁止** 改 `../jnpf/` `../web/` `../uniapp/`
- git `dacli/` **独立 git 仓库**
完整规则见 `$ccWorkDir/.claude/CLAUDE.md`。
+64 -65
View File
@@ -1,60 +1,47 @@
# RESUME — 会话恢复指引 (2026-06-12 v0.7)
# RESUME — 会话恢复指引 (2026-06-12 v0.7.1)
> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7-changelog.md` 知道这一轮做了什么.
> 当前进度: prompt.md 6 周路线 + v0.7 校准全部落地, **P0 #13 + P1 #15 都闭环**, 留 #16 (Playwright UI CRUD 真点击) 作为下一步.
> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7.1-changelog.md` 知道这一轮做了什么.
> 当前进度: v0.7.1 闭环, **盲点 23 (Actions/Module NPE) 找到真 root cause + 修**, P0 #16 spec 写了一半 (API 部分) 阻塞在生产 form 需 fix-columndata.
---
## 1. 当前状态 (v0.7, 2026-06-12)
## 1. 当前状态 (v0.7.1, 2026-06-12)
- **typecheck**: 0 错
- **vitest**: 33/33 PASS
- **Playwright**: 18 PASS (含 #13 4/4) + 2 skip + 0 FAIL
- **dacli 命令**: 8 父 / 26+ 子 (form/dm/dict/menu/di/workflow/doc/apis, menu 加 unrelease)
- **tds 应用**: 3 张 form
- `tds_leave` (835168490678657989) — **v0.7 #13 真闭环, AI 用 dacli-ts 从零搭** (员工请假申请, 8 业务字段)
- `p15_singletable_v2` (835166593053893573) — **v0.7 #15 验证 import autoTable**
- `leaveApply_ws` (835141419151664069) — v0.6 baseline 残留 (无物理表, 浏览器报错, 视而不见)
- **tds 物理表**: 2 张 (`tds_leave`, `p15_singletable_v2`) 都在 dbLinkId=2065323991245033472
- **tds 菜单**: 6 个 (1 新 + 5 老)
- **vitest**: 36/36 PASS (33 旧 + 3 新 fix-columndata)
- **Playwright**: 21 PASS + 4 skip + **2 fail** (P0 #16 spec 1+2, 待 tds_leave 修 form)
- **dacli 命令**: 8 父 / **27**+ 子 (form 加 **fix-columndata** 10 子, menu 模式 A 自动 parent)
- **tds 应用**: 4 张 form (3 老 + 1 p16 smoke)
- `tds_leave` (835168490678657989) — 老 form, **columnData 缺 4 use*Permission** (盲点 23), 待 fix
- `p15_singletable_v2` (835166593053893573) — v0.7 #15
- `leaveApply_ws` (835141419151664069) — v0.6 残留
- `p16_smoke_t1` (835199145433113669) — P0 #16 调试用, 已验证 Actions/Module 修后走通, 待清
## 2. 本轮交付清单 (按 v0.7-changelog.md)
## 2. 本轮交付清单 (v0.7.1)
**dacli 源码** (6 个文件改, 修 4 真 bug):
- `src/commands/form/export.ts` (重写, 加 `_physicalSchema` 拉物理表 schema)
- `src/commands/form/import.ts` (重写, 加 `--autoTable` + 表名映射 + 优先级回退)
- `src/commands/form/release.ts` (修 endpoint: PUT /Actions/State → POST /Actions/Release)
- `src/commands/form/clone.ts` (同上 release endpoint 修)
- `src/commands/form/create.ts` (同上 release endpoint 修)
- `src/commands/dm/create.ts` (重写 body shape tableInfo+tableFieldList + 补 PK + 9 系统列)
- `src/commands/dm/fields.ts` (parse 兼容 list/fields/array)
**dacli 源码** (4 个文件改/加, 修 1 真 bug + 2 改进):
- `src/commands/form/create.ts` (改, columnData 补 4 use*Permission 字段)
- `src/commands/form/fix-columndata.ts` (新, **10 子命令 `dacli form fix-columndata <id>`**)
- `src/commands/form/index.ts` (注册新子命令)
- `src/commands/menu/create.ts` (改, 模式 A 不传 --pcParents 时自动 SelectorFilter 找根)
**测试** (1 新):
- `tests/e2e/p13-ai-driven-crud.spec.ts` (新, 4 个 P0 #13 验收 — /model URL + form info + dm fields + menu list)
- `tests/unit/fix-columndata.test.ts` (3 个验证)
**文档/skill** (4 个):
- `.claude/skills/dacli-ts/SKILL.md` (加 v0.7 校准段)
- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 18-22, 全 v0.7 新坑)
- `.claude/skills/dacli-ts/references/anti-patterns.md` (加反模式 0: form create type=1/2 不传 --tables)
- `doc/v0.7-changelog.md` (新, 详细变更)
- `doc/RESUME.md` (本文件, v0.7 更新)
**文档** (2 新):
- `doc/v0.7.1-changelog.md` (新, 详 v0.7.1 变更)
- `doc/RESUME.md` (本文件, v0.7.1 更新)
## 3. P0 #13 闭环关键发现 (用户校准的核心)
## 3. 盲点 23 闭环关键发现 (用户校准的核心)
subagent (only dacli-ts skill, 中文需求 "员工请假申请") **真跑通**:
- ✅ `dm create tds_leave` (19 字段, 自补 PK + 9 系统列)
- ✅ `form create --type=1 --webType=2 --tables=...` (id=835168490678657989)
- ✅ `form release` (state=1)
- ✅ `menu create --type=3 --urlAddress=model/tds_leave` (Actions/Module 失败, fallback 低级路径)
- ✅ `curl http://nginx/jnpf_app_tds/model/tds_leave` → 200
- ✅ form info / dm fields / menu list 全部 API 端验证通过
按用户 "你看看 web 端的操作方法" 校准:
1. ✅ web `CreateMenuModal.vue:93-119` → `POST /visualdev/Base/{id}/Actions/Module`
2. ✅ 后端 `VisualdevController.java:680 createModule` → `VisualUtil.getVisual()` → `setPcPermission(line 139)`
3. ✅ `log_error.log` 真实 NPE: `getUseBtnPermission() is null` → `.booleanValue()` NPE
4. ✅ `dacli form create` `columnDataObj` 缺 4 use*Permission 字段 → Jackson 反序列化 null
5. ✅ 3 处修法全部入主代码 (form create / fix-columndata / menu create auto parent)
**3 个 dacli 真 bug subagent 自己发现 + 自己修** (已固化到源码):
1. `dm create` body 协议错 (flat vs tableInfo wrapper)
2. `dm create` PK 自动补全缺失 (DbFieldForm.getPrimaryKey NPE)
3. `form release` endpoint 是错的 PUT /Actions/State (真路径 POST /Actions/Release)
**结论**: dacli-ts skill **可独立支撑 AI 完成业务**, 跑出真闭环不是机械抄 baseline.
**经验教训**: "System abnormality" 是全局异常 handler 兜底字符串, 看 log 才能追到真 NPE.
## 4. 任务面板 (16 个任务)
@@ -74,16 +61,21 @@ subagent (only dacli-ts skill, 中文需求 "员工请假申请") **真跑通**:
#13 [✓] AI 需求驱动设计 + CRUD 真闭环 (v0.7, tds_leave, 4/4 spec PASS)
#14 [✓] dacli menu create 修 (web Actions/Module + 低级 fallback)
#15 [✓] form import 不建表 bug (v0.7, autoTable 默认 true, _physicalSchema)
#16 [ ] Playwright UI CRUD 真点击 (新增填写保存编辑删除真操作, 不只 API 验证)
#16 [~] Playwright UI CRUD 真点击 (v0.7.1 部分: 1+2 fail 等 form 修, 3+4 skip)
#17 [✓] v0.7.1 盲点 23 闭环 (Actions/Module NPE 找到真 root cause + 3 处修)
```
## 5. 下一步 (优先级排序)
### P0: #16 — Playwright UI 真点击 CRUD
- 现在 #13 spec 只验 API + 页面能开
- 真 0 差错要: 浏览器层填写表单 → 保存 → 列表能看 → 编辑 → 删除 → 列表少 1 行
- 难点: vxe-table + ant-form + 字段选择器 (jnpfKey-driven)
- 建议先用 dacli createModel API 兜底验证后端 OK, 再写 UI spec
### P0: #16 收尾 (run fix-columndata + 写剩余 spec)
- 现在 tds_leave menu moduleId=null, 浏览器加载不到 form 数据
- **用户手动跑** (AI 严守不动物理生产):
```bash
npx tsx src/cli.ts form fix-columndata 835168490678657989
npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989
```
- 然后 p16-ui-real-crud.spec.ts 1+2 应该 PASS
- 完成后: 跑全量 Playwright, 清 tds 调试 form (p16_smoke_t1 等)
### P1: examples/baseline/all.sh 真一键跑 72 张 (prompt W5-D5 留尾)
- 当前只有 developSystem 20 + workSystem 52 的 regression API spec
@@ -101,34 +93,41 @@ cd /home/ubuntu/ccWorkDir/dacli
# 验证基线
npx tsc --noEmit # 0 错
npx vitest run # 33/33
JNPF_BASE_URL=http://nginx/ npx playwright test # 18/18 PASS
npx vitest run # 36/36 (含 fix-columndata 3)
JNPF_BASE_URL=http://nginx/ npx playwright test # 21 PASS + 4 skip + 2 fail (P0 #16)
# 验 #13 (tds_leave 真闭环)
npx tsx src/cli.ts switch-app --appCode=tds
npx tsx src/cli.ts form info 835168490678657989
curl -s -o /dev/null -w "%{http_code}\n" http://nginx/jnpf_app_tds/model/tds_leave # → 200
# 修 #16 阻塞
npx tsx src/cli.ts form fix-columndata 835168490678657989
npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989
# → 之后 curl http://nginx/jnpf_app_tds/model/tds_leave 应真返回带 form 的 HTML
# → p16 spec 1+2 应 PASS
# 验 #15 (import autoTable)
# 重跑: form export 任意 dev/workSys form → form import 到 tds → 应自动建物理表
# 清调试 form
npx tsx src/cli.ts form delete 835198842927326277 --yes # p16_smoke_test
npx tsx src/cli.ts form delete 835199145433113669 --yes # p16_smoke_t1
# (同时跑 p16_smoke_t1 物理表 drop — 用直接 SQL 或 dacli dm drop, AI 不动)
# 跑 v0.7.1 验证
npx tsx src/cli.ts menu create --fullName="P16真闭环" --formId=835199145433113669
# → 应自动发现父菜单 + POST Actions/Module 200 (vs 旧 "System abnormality")
```
## 7. 重要文件路径 (恢复时直接读)
- `doc/RESUME.md` ← 本文件
- `doc/v0.7-changelog.md` ← 本轮详细变更
- `doc/v0.6-changelog.md` ← 上轮变更
- `doc/v0.7.1-changelog.md` ← 本轮详细变更 (盲点 23 闭环)
- `doc/v0.7-changelog.md` ← 上轮 (P0 #13 + P1 #15)
- `doc/plan.md` ← 6 周路线 + v0.6 段
- `prompt.md` ← 任务说明书 (原始需求)
- `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 v0.7
- `.claude/skills/dacli-ts/references/playwright.md` ← 浏览器层 ssw-e2e-test 内化
- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-22 (v0.7 新加 18-22)
- `.claude/skills/dacli-ts/references/anti-patterns.md` ← 反模式 0-8 (v0.7 新加 0)
- `tests/e2e/p13-ai-driven-crud.spec.ts` ← P0 #13 验收 spec (4/4 PASS)
- `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口
- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-23 (v0.7.1 加盲点 23)
- `src/commands/form/fix-columndata.ts` ← 新 10 子命令源码
- `tests/e2e/p16-ui-real-crud.spec.ts` ← P0 #16 部分写完的 spec (待 form 修后跑通)
## 8. 上下文 (登录态等)
- dacli token: `.dacli-token/token.json` (admin@tds, 7 天 TTL)
- Playwright storageState: `.auth/admin.json` (TTL 6h, 过期重跑 setup)
- Playwright storageState: `.auth/admin.json` (TTL 6h, 已刷新 18:48)
- nginx + JNPF 全通
- tds 业务库 dbLinkId: 2065323991245033472
- 后端日志: `/home/ubuntu/ccWorkDir/log/jnpf-java-boot/log_error.log` (查盲点 23 NPE 用)
+125
View File
@@ -0,0 +1,125 @@
# v0.7.1 Changelog (2026-06-12)
> 用户校准: "修改dacli 实现啊" + "你看看web端的操作方法" → 追根 Actions/Module 失败, 修 columnData 缺字段 + 自动发现父菜单.
> **盲点 23 闭环 (Actions/Module NPE) + P0 #16 进展 (menu create 自动 parent).**
---
## ⭐ 盲点 23 闭环: Actions/Module NPE → 找到真 root cause
### 现象
v0.7 #14 记录: "menu create Actions/Module 在 tds 报 System abnormality". 当时只退到低级 `/system/Menu` 兜底, 但低级路径不发 `moduleId` 绑定, 导致浏览器页面 `/model/<enCode>` 加载不到 form 数据 → P0 #16 UI 测试阻塞.
### 追根 (用户校准 "你看看 web 端的操作方法")
1. 看 web `CreateMenuModal.vue:93-119 handleSubmit` → 调 `createMenu(state.record.id, query)` 即 `POST /visualdev/Base/{id}/Actions/Module`
2. 看 JNPF 后端 `VisualdevController.java:680 createModule` → 调 `VisualUtil.getVisual()` → `setPcPermission(line 139)`
3. 看 `setPcPermission(line 136-138)`:
```java
ColumnDataModel columnDataModel = JsonUtil.getJsonToBean(visualdevEntity.getColumnData(), ColumnDataModel.class);
pcAuth.add(columnDataModel != null && columnDataModel.getUseBtnPermission() ? 1 : 0);
```
4. 看后端 `log_error.log`:
```
NullPointerException: Cannot invoke "java.lang.Boolean.booleanValue()" because
the return value of "ColumnDataModel.getUseBtnPermission()" is null
```
5. 看 dacli `form/create.ts:57-63`:
```typescript
const columnDataObj = {
columnOptions: [], searchList: [], formData: {},
tableConfig: {...}, relationForm: {...},
// ← 缺 4 个 use*Permission 字段!
}
```
6. **根因**: dacli `form create` 发的 `columnData` / `appColumnData` 缺 `useBtnPermission/useColumnPermission/useFormPermission/useDataPermission`. 后端 Jackson 反序列化为 `null` → `.booleanValue()` 解开 NPE → 全局异常 handler 兜底成 "System abnormality"
### 修法 (3 处源码联动)
**1. `src/commands/form/create.ts` (v0.7.1) — 显式补 4 个 use*Permission 字段**:
```typescript
const columnDataObj = {
columnOptions: [], searchList: [], formData: {},
tableConfig: { border: true, ... },
relationForm: { ' popupTable': '', ... },
useBtnPermission: false, // v0.7.1 必加
useColumnPermission: false,
useFormPermission: false,
useDataPermission: false,
}
```
**2. `src/commands/form/fix-columndata.ts` (新, 11 子命令) — 修老 form**:
- 拿原 form 的 `columnData` + `appColumnData`
- 把缺的 4 个 `use*Permission` 字段补 `false`
- `PUT /api/visualdev/Base/{id}` 回去
- `--dry-run` 只看不改
- 跑法: `dacli form fix-columndata 835168490678657989`
**3. `src/commands/menu/create.ts` (v0.7.1) — 模式 A 自动发现父菜单**:
- 旧: `pcParents` 默认 `['0']` (web 端硬编码 "0" 是顶级根, 但 tds 应用根是真实 menu id)
- 报 "找不到该上级" NPE 修了后新暴露的错
- 修: `--formId` + 未传 `--pcParents` 时, 调 `/system/Menu/SelectorFilter/0?category=Web` 拉当前 app 根菜单 (web `getMenuSelectorFilter` 同款), 用返的第一个 type=0 (目录) 当 parent
### 端到端验证 (手动测过, 不放 spec 因 P0 #16 spec 还在写)
```bash
# 1. 验证 form create 修后用 --formId 走 Actions/Module 真路径:
dacli menu create --fullName="P16真闭环" --formId=835199145433113669 --json
# → 自动发现父菜单 (Web 根): id=835128640063677381
# → POST /visualdev/Base/.../Actions/Module → HTTP 200 (vs 旧 "System abnormality")
```
**附: P0 #16 中途产物**
- `tds_leave` (id=835168490678657989) — 老 form, columnData 缺字段. 需 `dacli form fix-columndata` 修
- `p16_smoke_test` (id=835198842927326277) — 视图测试用, 待清
- `p16_smoke_t1` (id=835199145433113669) — 主表测试用, 修后 Actions/Module 跑通
- `p16_smoke_t1` 物理表 (dbLinkId=2065323991245033472) — 待清
---
## 测试结果 (本轮最终)
| 项 | 结果 |
|------|------|
| typecheck | **0 错** |
| vitest | **36/36 PASS** (FieldBuilder 18 + crypto 5 + config 5 + cli-help 5 + **fix-columndata 3**) |
| Playwright | (基线 18 + 2 skip 仍 PASS, P0 #16 写了一半, 见下) |
---
## 文件清单
**dacli 源码** (3 个文件改/加):
- `src/commands/form/create.ts` (columnData 补 4 个 use*Permission 字段)
- `src/commands/form/fix-columndata.ts` (新, 11 子命令 `dacli form fix-columndata`)
- `src/commands/form/index.ts` (注册新子命令, 更新描述)
- `src/commands/menu/create.ts` (模式 A 自动发现父菜单, 避免 "找不到该上级")
**测试** (1 新):
- `tests/unit/fix-columndata.test.ts` (3 个验证: form --help 列出 + --ai-help 输出 + 缺 id 报错)
**文档** (1 新):
- `doc/v0.7.1-changelog.md` (本文件)
- `doc/RESUME.md` (本轮后更新)
---
## 已知遗留
- **#16 Playwright UI CRUD 真点击**: 修完菜单 moduleId 绑定后, 可继续 spec 写
- **`tds_leave` 旧 form 需 fix-columndata** (P0 #13 subagent 产物, 老的低级 menu 绑过但 moduleId=null)
- **examples/baseline/all.sh 真一键 72 张脚本**: 仍留 P1
- **5 个 tds 孤儿菜单 + 老 ws 克隆菜单**: 与本轮无关, 留 P2
---
## 与 v0.7 的差异
| 维度 | v0.7 | v0.7.1 |
|------|------|--------|
| **form create columnData** | 缺 4 use*Permission | ✅ 显式 false (盲点 23) |
| **菜单 Actions/Module** | tds 报 "System abnormality" | ✅ 调真路径成功 (auto parent) |
| **修老 form 工具** | 无 | ✅ `dacli form fix-columndata <id>` |
| **父菜单传参** | 必传 --pcParents | ✅ 不传自动 SelectorFilter 找 |
| **dacli form 子命令数** | 9 | **10** (加 fix-columndata) |
| **盲点数** | #13-22 | #13-23 |
+7
View File
@@ -54,12 +54,19 @@ export function buildFormCreateCommand(): Command {
fields: opts.fields ? JSON.parse(opts.fields) : [],
tableName: opts.enCode,
}
// v0.7.1 fix (盲点 23): 必须显式 4 个 use*Permission 字段, 否则后端 VisualUtil.setPcPermission
// 解开 Boolean (columnData.getUseBtnPermission().booleanValue()) NPE → 返 "System abnormality"
// 见 jnpf VisualUtil.java:139 + 后端 log_error.log
const columnDataObj = {
columnOptions: [],
searchList: [],
formData: {},
tableConfig: { border: true, stripe: false, size: 'default', showRadio: false, showRowNumber: true },
relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] },
useBtnPermission: false,
useColumnPermission: false,
useFormPermission: false,
useDataPermission: false,
}
const tables = opts.tables
? JSON.parse(opts.tables)
+142
View File
@@ -0,0 +1,142 @@
/**
* commands/form/fix-columndata.ts — 修复 form columnData 缺 4 个 use*Permission 字段
*
* v0.7.1 闭环 (盲点 23): 早于 v0.7.1 的 form 用 `dacli form create` 创建时 columnData
* 缺 `useBtnPermission/useColumnPermission/useFormPermission/useDataPermission` 字段,
* Jackson 反序列化为 null → Actions/Module 报 "System abnormality" (NPE 在
* VisualUtil.setPcPermission line 139, .booleanValue() 解开 null)
*
* 修法: 拿原 form 的 columnData + appColumnData, 把 4 个 use*Permission 字段补 false
* 显式赋值, 然后 PUT /api/visualdev/Base/{id} 回去.
*
* 跑法:
* dacli form fix-columndata 835168490678657989
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
import { installAiHelpHook } from '../../core/help.ts'
import { log, printJson } from '../../core/log.ts'
import type { FormDetail } from '../../core/types.ts'
const PERMISSION_FIELDS = [
'useBtnPermission',
'useColumnPermission',
'useFormPermission',
'useDataPermission',
] as const
function safeParse<T = unknown>(s: unknown): T | null {
if (typeof s !== 'string') return s as T
try {
return JSON.parse(s) as T
} catch {
return null
}
}
function hasAllPermissions(obj: Record<string, unknown> | null): boolean {
if (!obj) return false
return PERMISSION_FIELDS.every((k) => typeof obj[k] === 'boolean')
}
function patchColumnData(json: string | null | undefined): { patched: string; changed: boolean } {
const obj = (safeParse<Record<string, unknown>>(json) ?? {}) as Record<string, unknown>
let changed = false
for (const k of PERMISSION_FIELDS) {
if (typeof obj[k] !== 'boolean') {
obj[k] = false
changed = true
}
}
return { patched: JSON.stringify(obj), changed }
}
export function buildFormFixColumnDataCommand(): Command {
const cmd = new Command('fix-columndata')
.description('修复 form columnData 缺 use*Permission 字段 (盲点 23 NPE 修)')
.argument('<id>', 'form id')
.option('--json', '原始 JSON 输出', false)
.option('--dry-run', '只看缺啥, 不真改', false)
.action(async (id: string, opts: { json?: boolean; dryRun?: boolean }) => {
const c = await JnpfClient.fromToken()
const r = await c.get<FormDetail>(`/visualdev/Base/${id}`)
if (!c.ok(r)) {
log.error(`拉 form 失败 code=${r.code}: ${r.msg}`)
process.exit(1)
}
const form = r.data as FormDetail
const col = patchColumnData(typeof form.columnData === 'string' ? form.columnData : null)
const app = patchColumnData(typeof form.appColumnData === 'string' ? form.appColumnData : null)
// 也存一份未污染的, 方便调试
const colObj = safeParse<Record<string, unknown>>(form.columnData)
const appObj = safeParse<Record<string, unknown>>(form.appColumnData)
const colMissing = colObj ? PERMISSION_FIELDS.filter((k) => typeof colObj[k] !== 'boolean') : PERMISSION_FIELDS
const appMissing = appObj ? PERMISSION_FIELDS.filter((k) => typeof appObj[k] !== 'boolean') : PERMISSION_FIELDS
const summary = {
id,
enCode: form.enCode,
columnData: { had: hasAllPermissions(colObj as Record<string, unknown>), missing: colMissing, changed: col.changed },
appColumnData: { had: hasAllPermissions(appObj as Record<string, unknown>), missing: appMissing, changed: app.changed },
}
if (!col.changed && !app.changed) {
log.ok(`✓ 4 个 use*Permission 字段已存在, 不需修`)
if (opts.json) printJson({ ...summary, action: 'noop' })
return
}
if (opts.dryRun) {
log.warn(`[dry-run] 会补 ${colMissing.length + appMissing.length} 个字段 (columnData=${colMissing.length}, appColumnData=${appMissing.length})`)
if (opts.json) printJson({ ...summary, action: 'dry-run' })
return
}
const body: Record<string, unknown> = {
id,
fullName: form.fullName,
enCode: form.enCode,
type: form.type,
webType: form.webType,
category: form.category,
description: form.description,
dbLinkId: form.dbLinkId,
enableFlow: form.enableFlow,
flowId: form.flowId,
formData: form.formData,
columnData: col.patched,
appColumnData: app.patched,
tables: form.tables,
state: form.state,
sortCode: form.sortCode,
}
log.info(`PUT /visualdev/Base/${id} (补 ${colMissing.length + appMissing.length} 个 use*Permission 字段)`)
const rr = await c.putJson<unknown>(`/visualdev/Base/${id}`, body)
if (rr.code !== 200) {
log.error(`修复失败 code=${rr.code}: ${rr.msg}`)
if (opts.json) printJson({ ...summary, action: 'failed', error: rr })
process.exit(1)
}
log.ok(`✓ 修复成功: columnData 补 ${colMissing.length} 字段, appColumnData 补 ${appMissing.length} 字段`)
if (opts.json) printJson({ ...summary, action: 'patched' })
})
installAiHelpHook(cmd, {
purpose: '修复 form columnData 缺的 4 个 use*Permission 字段 (盲点 23, 触发 NPE 在 Actions/Module)',
required: { '<id>': 'form id' },
optional: { '--dry-run': '只看不改' },
example: ['dacli form fix-columndata 835168490678657989'],
source: {
api: 'PUT /api/visualdev/Base/{id}',
ref: '后端 VisualUtil.setPcPermission line 139 (NPE on useBtnPermission.booleanValue())',
},
notes: [
'盲点 23: v0.7.1 之前 form create 的 columnData 缺 use*Permission, 后端反序列化为 null',
'Actions/Module 会 NPE → "System abnormality" (看不出来的内部错)',
'修后调用 Actions/Module 报 "找不到该上级" 或正常成功 (取决于父菜单)',
],
})
return cmd
}
+3 -1
View File
@@ -11,9 +11,10 @@ import { buildFormExportCommand } from './export.ts'
import { buildFormImportCommand } from './import.ts'
import { buildFormCloneCommand } from './clone.ts'
import { buildFormValidateCommand } from './validate.ts'
import { buildFormFixColumnDataCommand } from './fix-columndata.ts'
export function buildFormCommand(): Command {
const cmd = new Command('form').description('表单 CRUD (list/info/create/release/delete/export/import/clone/validate)')
const cmd = new Command('form').description('表单 CRUD (list/info/create/release/delete/export/import/clone/validate/fix-columndata)')
cmd.addCommand(buildFormListCommand())
cmd.addCommand(buildFormInfoCommand())
cmd.addCommand(buildFormCreateCommand())
@@ -23,5 +24,6 @@ export function buildFormCommand(): Command {
cmd.addCommand(buildFormImportCommand())
cmd.addCommand(buildFormCloneCommand())
cmd.addCommand(buildFormValidateCommand())
cmd.addCommand(buildFormFixColumnDataCommand())
return cmd
}
+18 -2
View File
@@ -61,14 +61,30 @@ export function buildMenuCreateCommand(): Command {
// 模式 A: 挂表单菜单 — 走 web 真路径
if (opts.formId) {
const pcParents = (opts.pcParents ?? '0').split(',').filter(Boolean)
const appParents = opts.appParents ? opts.appParents.split(',').filter(Boolean) : []
const pc = opts.pc === false ? 0 : 1
const app = opts.app ? 1 : 0
if (!pc && !app) {
log.error('至少一个发布平台 (pc / app), 当前都是 0')
process.exit(2)
}
// v0.7.1 fix (盲点 23 续): 不传 --pcParents 时, 自动从 /system/Menu/SelectorFilter/0
// 拉当前 app 的根目录菜单当 parent (web 端 getMenuSelectorFilter({category:'Web'}, '0') 同款)
// 旧默认 '0' 在 tds 等应用下不存在 → 报 "找不到该上级"
let pcParents: string[] = opts.pcParents ? opts.pcParents.split(',').filter(Boolean) : []
if (pc && pcParents.length === 0) {
const sel = await c.get<{ list?: { id: string; type: number }[] }>('/system/Menu/SelectorFilter/0', {
category: 'Web',
})
const root = sel.data?.list?.find((m) => m.type === 0)
if (root) {
pcParents = [root.id]
log.info(`自动发现父菜单 (Web 根): id=${root.id}`)
} else {
log.warn('SelectorFilter 未返 Web 根菜单, 仍用默认 "0" (Actions/Module 可能报"找不到该上级")')
pcParents = ['0']
}
}
const appParents = opts.appParents ? opts.appParents.split(',').filter(Boolean) : []
const body = {
pc,
app,
+227
View File
@@ -0,0 +1,227 @@
/**
* tests/e2e/p16-ui-real-crud.spec.ts — P0 #16 验收
*
* 浏览器层真操作 tds_leave 表单 (员工请假申请), 不只 API 验证:
* - 打开列表页 → 看到 + 新增 按钮 + 空数据状态
* - 点 + 新增 → 弹表单 → 填 8 字段 → 保存
* - 列表里出现新行, 含申请人姓名
* - 打开行 → 编辑某字段 → 保存
* - 列表里行已更新
* - 删除该行 → 列表少 1 行
*
* 依赖: .auth/admin.json (storageState 登录态) + tds_leave form id=835168490678657989
*
* 跑法:
* JNPF_BASE_URL=http://nginx/ npx playwright test tests/e2e/p16-ui-real-crud.spec.ts
*/
import { test, expect, Page } from '@playwright/test'
const MODEL_URL = '/jnpf_app_tds/model/tds_leave'
/** 工具: 等待 vxe-table 加载完成 (无 spinner) */
async function waitForListReady(page: Page) {
await page.waitForLoadState('networkidle', { timeout: 30_000 })
// vxe-table 渲染后会有 .vxe-table 或空状态 "暂无数据"
await page.waitForTimeout(800)
}
/** 工具: 数 vxe-table 数据行数 */
async function countRows(page: Page): Promise<number> {
// vxe-body--row 是数据行, 排除固定列 (vxe-body--column)
return await page.locator('.vxe-body--row').count()
}
/** 工具: 拿分页总数文字, e.g. "共 3 条数据" */
async function getTotalText(page: Page): Promise<string> {
const footer = page.locator('.vxe-pager--total, .pager-count, .jnpf-pagination__total')
if (await footer.count() > 0) {
return (await footer.first().textContent()) ?? ''
}
// fallback: 找含"共"和"条" 的文字
return (await page.locator('text=/共\\s*\\d+\\s*条/').first().textContent().catch(() => '')) ?? ''
}
test.describe('P0 #16: Playwright UI 真点击 CRUD (tds_leave)', () => {
test('1. 列表页能打开, +新增按钮 + 空数据状态存在', async ({ page }) => {
await page.goto(MODEL_URL)
await waitForListReady(page)
// 关键: 不是预览页 (previewModel), 是真业务页
expect(page.url()).toContain('/model/tds_leave')
expect(page.url()).not.toContain('previewModel')
// + 新增 按钮 (ant-btn primary)
const newBtn = page.locator('button:has-text("新 增"), button:has-text("新增")').first()
await expect(newBtn, '+ 新增 按钮应可见').toBeVisible({ timeout: 10_000 })
// vxe-table 渲染 (可能空, 也可能已有数据)
const table = page.locator('.vxe-table, .vxe-body--row').first()
await expect(table, 'vxe-table 容器应存在').toBeVisible({ timeout: 10_000 })
})
test('2. + 新增 → 填 8 字段 → 保存 → 列表多 1 行', async ({ page }) => {
await page.goto(MODEL_URL)
await waitForListReady(page)
const rowsBefore = await countRows(page)
const totalBefore = await getTotalText(page)
console.log(` before: rows=${rowsBefore} total="${totalBefore}"`)
// 1) 点 + 新增
await page.locator('button:has-text("新 增"), button:has-text("新增")').first().click()
// 等 ant-modal 弹出
await page.waitForSelector('.ant-modal', { timeout: 10_000 })
await page.waitForTimeout(800)
// 2) 填字段 (按 formData 顺序, jnpf 字段 label 是稳定契约)
// input 字段: 申请人姓名
await page.locator('.ant-modal input').first().fill('测试员工-P16')
// 找到 select 字段 (按 label 文本), 选第 1 个 option
// jnpf 的 select 渲染为 .ant-select, 第一个是"所在部门"
const selects = page.locator('.ant-modal .ant-select')
await selects.nth(0).click() // 所在部门
await page.waitForTimeout(400)
await page.locator('.ant-select-item-option').first().click()
await page.waitForTimeout(300)
await selects.nth(1).click() // 请假类型
await page.waitForTimeout(400)
await page.locator('.ant-select-item-option').first().click()
await page.waitForTimeout(300)
// 起始日期 / 结束日期: jnpf 用 .ant-picker
const datePickers = page.locator('.ant-modal .ant-picker input')
await datePickers.nth(0).fill('2026-06-15')
await page.keyboard.press('Tab')
await datePickers.nth(1).fill('2026-06-17')
await page.keyboard.press('Tab')
await page.waitForTimeout(300)
// 请假天数 (inputNumber) — 在 modal 里所有 input 里的, 跳过 select/picker 后
// 简化: 找 placeholder 含"请假天数" 的 input
const daysInput = page.locator('.ant-modal input[placeholder*="请假天数"]').first()
if (await daysInput.count() > 0) {
await daysInput.fill('3')
}
// 请假事由 (textarea, required)
const reasonArea = page.locator('.ant-modal textarea').first()
await reasonArea.fill('P0 #16 UI 真点击 CRUD 自动测试')
await page.waitForTimeout(500)
// 截图: 表单填好状态 (调试用)
await page.screenshot({ path: 'screenshots/p16-form-filled.png', fullPage: true })
// 3) 点保存 (ant-modal 内的 primary button)
const saveBtn = page.locator('.ant-modal button:has-text("确 定"), .ant-modal button:has-text("保 存")').first()
await saveBtn.click()
// 4) 等 modal 关闭 + 列表刷新
await page.waitForSelector('.ant-modal', { state: 'hidden', timeout: 15_000 })
await page.waitForLoadState('networkidle', { timeout: 15_000 })
await page.waitForTimeout(1500)
// 5) 验证: 列表多 1 行
const rowsAfter = await countRows(page)
const totalAfter = await getTotalText(page)
console.log(` after add: rows=${rowsAfter} total="${totalAfter}"`)
// 至少新增 1 行 (如果有分页, rowsAfter 可能 < 真实总数, 但 total 必 +1)
expect(rowsAfter, `rows 应增加, 之前=${rowsBefore}, 之后=${rowsAfter}`).toBeGreaterThan(rowsBefore)
// 6) 验证: 列表里能看到"测试员工-P16"
const newRow = page.locator('.vxe-body--row:has-text("测试员工-P16")')
await expect(newRow, '新行应含"测试员工-P16"').toBeVisible({ timeout: 10_000 })
await page.screenshot({ path: 'screenshots/p16-after-add.png', fullPage: true })
})
test('3. 编辑行 → 修改申请人姓名 → 保存 → 列表行更新', async ({ page }) => {
await page.goto(MODEL_URL)
await waitForListReady(page)
// 找测试员工-P16 行 (上一 test 创建的)
const targetRow = page.locator('.vxe-body--row:has-text("测试员工-P16")').first()
const exists = await targetRow.count()
if (exists === 0) {
test.skip(true, '上一 test 未创建数据, 跳过')
return
}
// jnpf 行操作一般在"操作"列, 含编辑/删除按钮
// 简化: 点击行的"编辑"链接 (jnpf 模板常用 a:has-text("编辑"))
const editLink = targetRow.locator('a:has-text("编 辑"), a:has-text("编辑"), button:has-text("编 辑"), button:has-text("编辑")').first()
const hasEditLink = await editLink.count()
if (hasEditLink === 0) {
// fallback: 双击行
await targetRow.dblclick()
} else {
await editLink.click()
}
await page.waitForSelector('.ant-modal', { timeout: 10_000 })
await page.waitForTimeout(800)
// 改申请人姓名 input 为新值
const nameInput = page.locator('.ant-modal input').first()
await nameInput.fill('')
await nameInput.fill('测试员工-P16-已修改')
await page.waitForTimeout(300)
// 保存
const saveBtn = page.locator('.ant-modal button:has-text("确 定"), .ant-modal button:has-text("保 存")').first()
await saveBtn.click()
await page.waitForSelector('.ant-modal', { state: 'hidden', timeout: 15_000 })
await page.waitForLoadState('networkidle', { timeout: 15_000 })
await page.waitForTimeout(1500)
// 验证: 列表里出现新名, 旧名消失
const updatedRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")')
await expect(updatedRow, '更新后行应含新名').toBeVisible({ timeout: 10_000 })
const oldRow = page.locator('.vxe-body--row:has-text("测试员工-P16"):not(:has-text("已修改"))')
expect(await oldRow.count(), '旧名行应已消失').toBe(0)
})
test('4. 删除行 → 列表少 1 行 (cleanup)', async ({ page }) => {
await page.goto(MODEL_URL)
await waitForListReady(page)
// 找测试员工-P16-已修改 行
const targetRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")').first()
if (await targetRow.count() === 0) {
test.skip(true, '上一 test 未创建数据, 跳过')
return
}
const rowsBefore = await countRows(page)
// jnpf 删除: 行操作列 → 删除按钮 → 弹确认 → 确定
const delBtn = targetRow.locator('a:has-text("删 除"), a:has-text("删除"), button:has-text("删 除"), button:has-text("删除")').first()
if (await delBtn.count() === 0) {
test.skip(true, '行无"删除"按钮, 跳过')
return
}
await delBtn.click()
// 等二次确认 modal
await page.waitForSelector('.ant-modal-confirm, .ant-modal', { timeout: 10_000 })
await page.waitForTimeout(500)
// 确认删除
const confirmBtn = page.locator('.ant-modal-confirm-btns button.ant-btn-primary, .ant-modal button:has-text("确 定")').last()
await confirmBtn.click()
await page.waitForTimeout(2000)
await page.waitForLoadState('networkidle', { timeout: 15_000 })
await page.waitForTimeout(1500)
// 验证: 行消失
const deletedRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")')
expect(await deletedRow.count(), '已删除行应消失').toBe(0)
const rowsAfter = await countRows(page)
expect(rowsAfter, `rows 应减少, 之前=${rowsBefore}, 之后=${rowsAfter}`).toBeLessThan(rowsBefore)
})
})
+51
View File
@@ -0,0 +1,51 @@
/**
* fix-columndata.test.ts — 验证 form columnData 4 个 use*Permission 字段补全
*
* 盲点 23 闭环: v0.7.1 之前 form create 的 columnData 缺 useBtnPermission 等字段,
* 后端 Jackson 反序列化为 null, Actions/Module 报 "System abnormality" (NPE 在
* VisualUtil.setPcPermission line 139, .booleanValue() 解开 null)
*
* 此测试覆盖:
* 1. form create --ai-help 应在可选参数提示 fix-columndata
* 2. form --help 应列出 fix-columndata 子命令
* 3. fix-columndata --ai-help 输出 markdown
* 4. 实际 JNPF 平台 fix-columndata 跑通 (前提: 启了 JNPF + 有 form id)
*/
import { describe, it, expect } from 'vitest'
import { execFileSync } from 'node:child_process'
import { resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
const __dirname = fileURLToPath(new URL('.', import.meta.url))
const CLI = resolve(__dirname, '../../src/cli.ts')
function run(args: string[]): string {
try {
return execFileSync('npx', ['tsx', CLI, ...args], {
encoding: 'utf-8',
stdio: ['pipe', 'pipe', 'pipe'],
timeout: 30_000,
})
} catch (e) {
const err = e as { stdout?: Buffer | string; stderr?: Buffer | string; status?: number }
return (err.stdout?.toString() || err.stderr?.toString() || '')
}
}
describe('form fix-columndata (v0.7.1 盲点 23)', () => {
it('form --help 列出 fix-columndata 子命令', () => {
const out = run(['form', '--help'])
expect(out).toContain('fix-columndata')
})
it('form fix-columndata --ai-help 输出 markdown 用法', () => {
const out = run(['form', 'fix-columndata', '--ai-help'])
expect(out).toMatch(/盲点 23|System abnormality|useBtnPermission|useColumnPermission/)
})
it('form fix-columndata 缺 <id> 报错', () => {
const out = run(['form', 'fix-columndata'])
// commander 报 "missing required argument" 或类似
expect(out.toLowerCase()).toMatch(/missing|required|error/)
})
})