Files
dacli/docs/cmd-review
sswandClaude cba74702f2 chore(docs): commit 上轮遗留文件 (归档指针 + 2 审计 + jxcj M2 字段修复脚本) (2026-07-23)
补提交上一轮 (commit 64fbb4a cmd-review/drift 归档 + 76c2937 broken ref reroute + b4dce30 auto-gen 撤回) 期间未落库的 4 个文件:

1. docs/cmd-review/README.md (30 行)
   - 上轮归档逻辑产出物, 指向 archive/cmd-review-2026-07/, 给新会话 AI 引路
   - 本应在 commit 64fbb4a (cmd-review 全归档) 一并提交, 但当时遗漏
   - 含归档原因 / 当前权威 (dacli <cmd> --help) / 历史快照定位指引

2. docs/audit-2026-07-22.md (192 → 196 行, 顶部加 deprecate 头)
   - macOS 上做的中立审计, 已知 3 条核心结论 (本机崩溃 / 硬编码路径 / B 关卡退化) 全部是环境错位误判
   - 顶部加 ⚠️ 头, 指向 audit-2026-07-23-deep §更正声明 + §12 容器内实跑复核
   - 仍成立部分: 硬编码 /home/ubuntu/...ccWorkDir (脆弱性), 双包管理器, wrapCommand 迁移不完整

3. docs/audit-2026-07-23-deep.md (292 行, 完整)
   - 深度审计 (架构层), 容器内 'docker exec jnpf-all-in-one' 复跑后更正前一版 3 条误判
   - 实测: tsc --noEmit 48 错 (src 内, 违反 README §232 铁律), vitest unit 20 失败 (集中在 blindspot_guards 漂移)
   - 主结论修订: ssw-loop 在 intended 环境里 '能驱动开发' (int 撤回初版 '仪式化' 措辞)
   - 但真正结构性盲点: 整套质量体系不跑 tsc/vitest → 48 类型错 + 20 失败与全绿关卡并存
   - 修订后 5 件优先事: (1) 补 tsc+vitest 进回路 (2) 修 48 src 类型错 (3) 修 blindspot 漂移 (4) 抽 getCcWorkDir() (5) 统一包管理器

4. docs/web-patches/jxcj-m2-field-fix.py (227 行)
   - jxcj M2 form schema 字段修正脚本 (webapi PUT fallback)
   - 背景: dacli form create --ai 重命名字段 + 丢失 dictType + 误判 userSelect, form update --fields 间歇报 'System abnormality'
   - 走 Python PUT 直接调 JNPF webapi 兜底修复 (跟 DACLI 数据建模路径平行)
   - 配套 web-patches/README.md 当前 Patches 状态表 (只列 .md, py 脚本独立)
   - 注: 该脚本不属于 jnpf/boot 基线改动, 是 dacli 之外的应用级修复脚本, 按 web-patches 规则不入归档

触发: 用户要求 '提交' untracked 3 文件, 顺手补 cmd-review/README.md 上轮遗漏.

Co-Authored-By: Claude <[email protected]>
2026-07-23 15:58:49 +08:00
..

dacli/docs/cmd-review/ — 命令审计 (已整体归档 2026-07-23)

⚠️ 2026-07-23 整体归档: 本目录 25 个命令审计文件已整体迁移到 ../archive/cmd-review-2026-07/, 仅备查.

不再更新 (2026-07-23 起): 各命令现状以 dacli <cmd> --help 为准, 包含命令清单 + Pitfalls / Best Practices / Decision Tree / Related Refs (task 1.6+ 后完整).

归档原因

cmd-review/ 2026-06-25 → 2026-06-30 一波生成 22 个命令审计, 内容是"现状清单 + 改/删/留建议". 短期任务 (M2 实战 2026-07-20) 后大部分建议已落地, 但档案还在顶层 → AI 新会话误读为"待办 P0".

典型过期例子 (历史快照):

  • doc.md P0 标记 "缺 dacli doc toc + dacli doc search" → 2026-07 已实现 (src/commands/doc/toc.ts + search.ts)
  • form.md §3.4 [NEW-CMD] "缺 dacli form update / addFields / rmFields / stats / diff" → form update/addFields/rmFields 已实现 (其它 P2 未实现)
  • kb-implementation-plan.md 是"实施计划"性质, 执行完后降级为归档

权威源迁移后

  • 命令清单/选项/默认值 → dacli <cmd> --help (包含 commander 默认 + DacliHelp 注入的 pitfalls/bestPractices/decisionTree)
  • 决策理由 → dacli/docs/decisions/0001-0016 系列 ADR (git-tracked, 权威)
  • 反模式 (踩坑) → dacli/docs/anti-patterns.md (auto-gen, 从 _anti_patterns.ts)
  • 跨模块架构变更 → dacli/docs/尚数网基本开发规范v3.0.md §四 应用隔离方案

历史快照定位

ls /home/ubuntu/ccWorkDir/dacli/docs/archive/cmd-review-2026-07/  # 25 文件, 2026-06-30 ~ 2026-07-20

含 25 个文件, 详见 archive/README.md §cmd-review-2026-07/ 段.