Commit Graph
21 Commits
Author SHA1 Message Date
ClaudeandClaude 216a02f7f1 fix(dacli): BS-56/BS-42/enableFlow/JNPF 4 步法修复 (v0.11h+, 2026-06-28)
按 CLAUDE.md §2.7.1 4 步法修 4 个 dacli 盲点:

1. BS-56 增强: enCode 禁下划线 — 错误信息明确 + 自动建议别名
   - 新增 src/commands/_encode_validator.ts (统一 ENCODE_REGEXP/FULLNAME_REGEXP + validateEnCode + suggestEnCode)
   - form/dict/menu/role 4 个 _validate.ts 切换到共享 helper
   - 错误从'只能输入英文、数字和小数点且小数点不能放在首尾'升级为
     'BS-56: enCode 只能含英文/数字/小数点, 不能含下划线/连字符/中文. 当前 enCode=X 非法. 建议改成: --enCode=Y (自动去下划线/连字符)'

2. BS-42 升级: dm 系统列冲突清晰提示
   - 加 groupMap 给每个系统列别称 (f_description=描述, f_create_user=创建人 ID 等)
   - 消息包含改名建议 (f_desc/f_remark/f_brief/f_summary) 和 code='BS-42'

3. enableFlow 兜底: BS-EFLOW-NOWF guard
   - 在 _blindspot_guards.ts 加新 guard (WARN 级)
   - enableFlow=1 但 workflow list=0 时给明确警告
   - AppContext 加 workflowList 字段, loadAppContext 调 /workflow/Engine/list 收集
   - types.ts/client.ts/context.ts 全链路补 workflowList

4. JNPF 自检: 新增 core/_health_check.ts
   - app init/status 前置 HEAD baseUrl/ 健康检查 (3s timeout)
   - 不通时给 nohup 重启指引
   - JSON 输出 health: {ok, status, error, durationMs}, 不通时退出码 1

验证 (workSystem/jxcj1 PASS):
- BS-56 form/dict/menu 3 命令输出新格式错误 + 别名建议
- BS-42 dm create f_description 输出 BS-42 清晰信息
- JNPF 自检输出 '✓ JNPF 可达: http://nginx/api/ (status=200, 27ms)'

文件 (16 改 + 2 新增):
- src/commands/_encode_validator.ts (新增)
- src/core/_health_check.ts (新增)
- src/core/types.ts (workflowList)
- src/core/client.ts (resolveDbLinkId 兜底)
- src/commands/_blindspot_guards.ts (BS-EFLOW-NOWF)
- src/commands/app/context.ts (tryFetchWorkflows)
- src/commands/app/init.ts (前置健康检查)
- src/commands/app/status.ts (前置健康检查 + JSON 输出)
- src/commands/form/_validate.ts (共享 ENCODE_REGEXP)
- src/commands/dm/_validate.ts (BS-42 升级)
- src/commands/dict/_validate.ts (共享 + BS-56 增强)
- src/commands/menu/_validate.ts (共享 + BS-56 增强)
- src/commands/role/_validate.ts (共享 + BS-56 增强)
- src/commands/form/codegen.ts (workflowList 兜底)
- tests/unit/{blindspot_guards,bs54_guard,dbLinkId,verify_option}.test.ts (workflowList 兜底)

不违反红线:
- ❌ 不动 web/uniapp/jnpf 源码 (CLAUDE.md §15)
- ❌ 不绕过 dacli
- ✅ 一轮一提交 (CLAUDE.md §14)
- ✅ npx tsc --noEmit 在改动文件无新错

Co-Authored-By: Claude <[email protected]>
2026-06-28 23:50:58 +08:00
ssw 5d44324da4 fix(verify): v0.11f B-12 runVerify 跳过不存在的 verify-form.ts
**问题**: dacli/src/core/verify-runner.ts:107 spawn npx tsx dacli/tests/e2e/verify-form.ts
   此文件 git log 验证从未存在 (历史误引用), spawn 立刻 ERR_MODULE_NOT_FOUND
   旧实现: resolve({ok:false}) → form create --verify=block 硬阻塞
   新实现: existsSync(verifyScript) 失败 → resolve({ok:true, steps:[{status:'skip'}]}) 让流程继续

**验证**: tds_conn_v5 form create + autoRelease + verify=warn 完整跑通 (不再硬阻塞)

**附加清理**: 删除 verify-runner.ts 顶部未使用的 currentBaseUrl import (残留)
2026-06-27 13:13:43 +08:00
ssw f90d877a47 fix(app-context): UX 改进 - base_system 缺失时明确提示 + 重建命令 (Phase E)
之前 app context/status/login 在 appCode 不存在时返间接错误
('未登录' / '无权限' / '400/403' / 'System abnormality'),
用户不知道 app 已被 dacli app clear 删除, 浪费 debug 时间.

现在:
- app context --json 加 systemExists + error 字段, 缺失时退出码 2
- app context (人读) 输出明确 'appCode=X 不存在 + 重建命令'
- app status 默认检测 base_system (--no-check-system 跳过),
  缺失时退出码 1 + 重建命令
- app login 成功后立即验证 system, 缺失时清除 token + 视为登录失败
  + 退出码 1 + 提示重建 (修复盲点: '✓ 登录成功' 但 token 无用)

抽 _check_system.ts 共享 helper (checkSystemExists + format*),
init.ts 的 checkSystemExists 已迁过去 (B-2 后续可重构).

tsds 9 bug 复盘 2026-06-27 (B-2 用户反馈)
2026-06-27 10:23:10 +08:00
ssw 2e81214506 auto(09213057c521): session end @ 2026-06-27T10:17:27 (+6f) 2026-06-27 10:17:27 +08:00
ssw 7a148af1f4 v0.11+ Phase J: 抹去 dacli/src 残留干扰 (3 文件)
彻底清理 dacli/src/ 与新架构冲突的引用:

- src/core/client.ts: 删 'form clone 已存在表单' 修复建议
- src/commands/form/create.ts: 删 'AI 黄金法则: 99% 应先 clone 再改' 误导
- src/commands/_blindspot_guards.ts:
  - 删 BS-13 整段 (--fields path 守卫, v0.11+ 已删, 永远不触发)
  - 删 BS-60 整段 (__vModel__ 空字符串守卫, 仅 --fields path 触发, 死代码)
  - 删 2 处 wrapSimplifiedFields 注释 (函数已删, 留干扰)

16 guard 保留: BS-1/4/5/7/8/12/14/37/38/39/41/42/43/44/45/46/47/48/49/50/51 (BS-50 限 menu create)

回滚: git revert HEAD
2026-06-26 12:22:50 +08:00
ssw 72f03797c2 v0.11+ Phase H: 删 form clone (6 文件) - 用户要求, 减 API 表面
dacli form clone 已删除, 复制 form 改用 dacli form export + form import. v0.11+ --ai-json 路径是默认新设计方法.

改动:
- 删除 src/commands/form/clone.ts (整个命令)
- src/commands/form/index.ts: 删 import + addCommand
- src/commands/_precheck.ts: BS-49 三选一去 form clone
- src/commands/_blindspot_guards.ts: BS-49 fix 去 form clone / 删 BS-40 (form clone 跨应用) / BS-51 fix 改用 form info
- src/commands/form/update.ts: BS-49 建议去 form clone
- src/core/client.ts: 2 处 form clone 修复建议去 form clone

验证: 0 src/ typecheck errors, form clone → 'unknown command', form --help 12 子命令 (无 clone)
回滚: git revert HEAD
2026-06-26 12:02:22 +08:00
ssw 6d7fb68f2c feat(diagnose): L3 diagnoseError 加 System abnormality 规则 (BS-触发器空串)
**触发条件**: CodePreview 返 'System abnormality' (后端 FormMarco.vm:1226 StringIndexOutOfBoundsException)

**根因**: form formData.fields[].__config__.trigger = '' (空字符串)
  - PublicMacro/FormMarco.vm:1226 对 '' 调 substring(0,1) 抛错
  - 仅 state=1 (发布态) 触发, state=2 (草稿) 不触发 (没走发布代码生成路径)
  - 历史 form (老 dacli/老 web 设计器) 易中招, 新 form FieldBuilder.ts:215-223 已正确设

**修复指引 (诊断输出)**:
  1. 查后端日志: log/jnpf-java-boot/log_error.log | grep FormMarco
  2. 一次性 PATCH (Python 脚本步骤 a/b/c/d)
  3. web UI 打开 form 设计器保存一次, JNPF 自动补 trigger
  ⚠ state=1 vs state=2 触发差异提示

**调用方**:
  - codegen.ts CodePreview 失败分支调 diagnoseError 打印
  - 客户端无法直接看后端堆栈, 规则放宽到 'System abnormality' (高频根因)

**验证**:
  - TS compile clean
  - jxcj_team (state=1 + 8/8 trigger='') 跑 codegen → 完整诊断输出 (修复步骤)
  - jxcj_team (state=2 + 8/8 trigger='') 跑 codegen → 成功 (绕开 bug)
  - 修后 jxcj_team (state=1 + 0/8 trigger='') 跑 codegen → 成功
2026-06-23 12:01:04 +08:00
ssw 254f56bafa auto(09213057c521): session end @ 2026-06-23T09:03:29 (+10f) 2026-06-23 09:03:30 +08:00
sswandClaude 13a3b209d4 v0.11: 修复 OnlineDev Create/Update 400 System abnormality
根因: JNPF 后端 VisualdevModelDataCrForm.data 是 String 字段,
controller line 527 调 JsonUtil.stringToMap(data) 转 Map, 当 data 为 null 时
map.get(vModel) 抛 NPE → 'Cannot invoke "Map.get(Object)" because "map" is null'.

web 行为 (CustomForm.vue:78):
  state.dataForm.data = JSON.stringify(formData)
  createModel(modelId, state.dataForm)

dacli 之前直接 c.postJson('/visualdev/OnlineDev/{modelId}', payload) 发原始对象,
后端 data 字段为 null, NPE, 返 400 'System abnormality'.

修复: core/client.ts 加 2 个 wrapper 方法 (postJsonOnlineDevCreate / putJsonOnlineDevUpdate),
内部包成 { data: JSON.stringify(payload) }. 现有 postJson/putJson 不动, 向后兼容.

实测: jxcj app / jxcj_competition_info (id=838880598830350405)
  Create 200 New created successfully (新 id=838902476441649221)
  Update 200 update success
  Delete 200 Delete successfully

单测 4/4 PASS (create 包装 / 空 payload / update 包装 / postJson 不包装回归)

应用: docs/jxcj 后续 CRUD TC 可直接用新 wrapper.

Co-Authored-By: Claude <[email protected]>
2026-06-23 00:41:27 +08:00
sswandClaude 5a40afbb2e v0.11: 修复 BS-48 dbLinkId=default 别名解析
根因: dacli create 命令把 --dbLinkId=default 当字面量传给后端 URL
(/system/DataModel/default/Table), 后端查 dbLinkEntity=null 抛 NPE.
BS-48 guard 旧判定 !id || id==='0' || id==='', 不拦截 'default' 字符串.

web 行为参照: formDesign Form.vue 选 '默认' 自动用当前 app 业务库,
不应暴露 'default' 字面量到 URL.

修复:
- 新增 core/dbLinkId.ts: resolveDbLinkId() 统一别名解析
  (空/default/DEFAULT/主库/业务库 → token.dbLinkId)
- core/client.ts: JnpfClient.resolveDbLinkId() 委托给 core util
- 7 个 create 命令迁移到 c.resolveDbLinkId() 入口
  (dm create/drop/fields/list + form create/codegen/import)
- _blindspot_guards.ts BS-48: 增加 /^default$/i.test 拦截

实测:
- dacli dm create --dbLinkId=default → URL 走 2068901937849257984, 建表成功
- 单测 14/14 (dbLinkId) + 38/38 (blindspot_guards, 1 预存 BS-51 失败无关)
- TS 编译 src/ 0 差错

应用影响: docs/jxcj/design-jnpf.html 56 个 dm/form 命令全部用
--dbLinkId=default, 现在可直接 dispatch 不需改 design.

Co-Authored-By: Claude <[email protected]>
2026-06-22 21:51:25 +08:00
ssw ac2d5ab4ff feat(dacli): client.diagnoseError() 主动诊断 + callWithDiagnosis 包装 (P0.2)
把 JNPF 模糊错误 (Database exception / Encoding cannot be repeated /
Table not exists / Duplicate column name 'f_description' 等) 翻译成
具体可能原因 + 修复建议, 解决 ai-error-analysis §C 同报错 10 种根因.

设计:
- recordRequestContext: postJson/putJson 自动记录 body.enCode/table/tableName
- diagnoseError(msg, ctx): 纯函数, 6 类规则, 覆盖 80% 常见模糊错误
- callWithDiagnosis(fn, ctx): 包装方法, catch 时 log.warn 打诊断后 rethrow
- form/dm create 已接入 (上一轮 P1.2 已 wiring, 此轮补 client 端实现)

衔接 P0.1 (loadAppContext) + P1.2 (pre-check): 不重复拉取, 不阻断主流程
(context 加载失败时 callWithDiagnosis 仍 rethrow, 不吞错)
2026-06-22 15:56:54 +08:00
ssw 7d630d374d feat(dacli): 新增 app context 命令 (P0.1, ai-error-analysis 对策) 2026-06-22 15:27:41 +08:00
sswandClaude bc06112504 dacli apis/doc v0.7.1: 缓存从 in-memory Map 切到 SQLite (跨 process 持久化)
抽自 docs/dacli/ssw-dacli/SqliteCacheService.java + ApiService.java + DocService.java
(PG 用户建议改 SQLite, 更优: 无外部依赖, 单文件 ~/.dacli/cache.db, 跟 Java 对齐)

新增:
- src/core/sqlite_cache.ts (TS 版 SqliteCacheService, 110 行):
  - better-sqlite3 (WAL 模式, sync API 比 async 快)
  - 公开: get/set/del/delByPattern/clearAll/stats/resetDbFile
  - 自动目录创建 ~/.dacli/, 启动时清过期项
  - 进程退出自动 close (SIGINT/SIGTERM 处理)
  - 路径可配: $DACLI_CACHE_DIR/cache.db

升级:
- apis/_cache.ts: in-memory Map → SQLite (12h TTL)
  - prefix: dacli:apidoc: (openapi/index/loaded/pid)
  - 跨 process 命中 (之前每次 npx tsx 都重拉 /v3/api-docs)
  - PID 失效检测用 'process.pid + 启动分钟' 兜底 (Node 跨平台 jps 不可靠)
- doc/_parser.ts: in-memory Map → SQLite (mtime 缓存)
  - prefix: dacli:doc: (mtime:{hash}/raw:{hash}/section:{hash}:{id})
  - 7 天 TTL, mtime 一致直接命中
  - section 索引/listSections 走 SQLite LIKE 查询
- package.json: better-sqlite3 从 optionalDependencies 升到 dependencies
  (跨平台 native binding, rebuild 自动)

实战验证:
- 第一次 dacli apis info: 拉 /v3/api-docs (1MB) 写 SQLite
- 第二次 dacli apis status: loaded=true source=sqlite pathCount=846
- 跨 process 持久化: ~/.dacli/cache.db 1.2MB, 7 rows
- 之前 in-memory 每次 npx tsx 都重拉, 现在零延迟命中

Co-Authored-By: Claude <[email protected]>
2026-06-21 18:50:19 +08:00
sswandClaude 85039be6f8 fix(verify-runner): ESM 兼容 checkDeps playwright 检测 (Phase 3 接入发现)
Phase 3 接入 _browser_verify 后跑 form create --verify=warn, checkDeps
返 playwright=false. 原代码用 require.resolve('playwright', { paths: [...] })
在 ESM (tsx) 上下文里 require 未定义, require.resolve 抛错被 catch 吞掉.

改用 fs.existsSync 探测 /dacli/node_modules/playwright/package.json.
简单, 跨 CJS/ESM 都工作.

Co-Authored-By: Claude <[email protected]>
2026-06-16 16:08:48 +08:00
sswandClaude c5d34142eb feat(verify-runner): archiveScreenshots() 归档到 docs/{app}/verification/
Co-Authored-By: Claude <[email protected]>
2026-06-16 11:49:43 +08:00
sswandClaude 2f562fcc5c feat(verify-runner): runVerify() spawn 子进程 + JSON 解析 + 单测
Co-Authored-By: Claude <[email protected]>
2026-06-16 11:39:21 +08:00
sswandClaude 654c454d00 feat(verify-runner): 依赖检测 checkDeps() + 单测
Co-Authored-By: Claude <[email protected]>
2026-06-16 11:32:03 +08:00
ssw 67e41a40fa feat(user): 新增 online-kick 命令 (admin/self 强制下线) 2026-06-15 10:17:55 +08:00
ssw 0fbc478e16 auto(6f177c177d02): session end @ 2026-06-14T08:04:54 (+27f) 2026-06-14 08:05:16 +08:00
ssw 37ed017742 W8-D1: datasource 端到端 (oracleExtend 修 NPE + AES 密码加密 + id 反查) + 单测 9 个 + baseline.sh 端到端 PASS 2026-06-12 22:00:34 +08:00
ssw c98ad4f425 init: TS 版 dacli v0.7 baseline (8 父命令/26+ 子命令, 0.4MB, .claude/skills/dacli-ts)
参考 boot/ 仓库结构初始化, 同步到 gitea:3000/ssw/dacli (private).

包括:
- src/  8 父命令 (form/menu/dm/dict/di/apis/doc/workflow + login/status) + core (client/crypto/help/log/types/config)
- src/schema/ FieldBuilder (从 JNPF web 源码提取, 避免 53 个手写 builder)
- tests/ vitest 单元 + playwright E2E (含 workSystem/developSystem baseline regression)
- scripts/ extract-all.mjs (从 jnpf-web 源码生成 schema) + seed-tds-baseline.ts
- doc/  architecture/plan/api/extractors/baseline/RESUME/help-system + v0.6/v0.7 changelog
- .claude/skills/dacli-ts/  Claude 集成 skill (SKILL.md + 5 references + 7 examples + 3 baseline)
- CLAUDE.md (项目说明) + README.md + prompt.md (开发任务说明书)
- 配置文件: package.json/lock, tsconfig, vitest.config, playwright.config
2026-06-12 18:26:39 +08:00