Commit Graph
15 Commits
Author SHA1 Message Date
sswandClaude b4dce306a0 revert: 删除 auto-gen anti-patterns.md 链路 (_anti_patterns.ts 保留给 --help Pitfalls) (2026-07-23)
撤回上一轮尝试 (commit 9e21fea 之前 '加 AP-* entry + 重生成 md' 意向未落 commit 但改了文件) 涉及的反模式 auto-gen 链路.

# 之前考虑
- _anti_patterns.ts 是 13 个命令 --help Pitfalls 段的 compile-time SSOT (installHelpHookWithPatterns → enrichHelp 自动注入)
- docs/anti-patterns.md 通过 gen-anti-patterns-md.sh 从 ts 生成, 用于人类/外部 AI 读

# 撤回原因
- 重生成时 4 个手动加的内容被覆盖丢失: AP-cross-business-info-leak + AP-cross-smartprops-missing-update + BS-新132 修订 + BS-新133 修订
- 根因: AntiPattern schema (1 行 wrong / 1-2 行 right / 1-2 句 rationale) 信息密度太低, 装不下 'mitigation 多步骤 + BS 修订 + jxcj M2 验证实验数据'
- 强行加进去违反 schema 精神, 不加进去就丢内容
- 两难说明: ts→md auto-gen 对反模式这种文档不合适 (schema 跟实际信息密度不匹配)

# 此 commit
1. 删除 docs/anti-patterns.md (304 行, 人类阅读目的)
2. 删除 scripts/gen-anti-patterns-md.sh (49 行, generator)
3. 删除 scripts/extract_anti_patterns.ts (20 行, extractor)
4. _anti_patterns.ts: 文件头注释 '由 TS 自动生成 md' → 'compile-time SSOT, 不再 auto-gen md'
5. ANTI_PATTERNS 撤回到 253 行纯净版 (撤上一轮加的 'form codegen' + 'cross' CommandKey + 3 个 entry)

# 保留
- _anti_patterns.ts 本身保留 (installHelpHookWithPatterns 仍依赖 enrichHelp 注入 AP-* 给 --help 输出)
- 实测: 'dacli form create --help' 仍输出 'Pitfalls (踩过的坑):' 段
- 13 个命令 (form create/info/update/delete, di create, app context, test run, workflow create, menu create, dm create, dict typeCreate) --help 仍自动含 AP-* 反模式

# 后续
- 4 个丢失内容 (AP-cross-business-info-leak + AP-cross-smartprops-missing-update + BS-新132/133 修订) 暂未沉淀, 后续如需可入 docs/{app}/jxcj/learnings.md (应用特定) 或 ssw-loop SKILL.md (通用元规则)
- 反模式新内容优先入 _anti_patterns.ts 走 --help 自动路径 (machine-readable 优势)

Co-Authored-By: Claude <[email protected]>
2026-07-23 15:37:40 +08:00
ssw a650cf6b04 test(dacli): final dogfood regression test — all 9 success criteria PASS 2026-07-17 12:51:50 +08:00
ssw 3f87c226c2 auto(bfc0cfa2c3a4): session end @ 2026-07-17T12:25:27 (+1f) 2026-07-17 12:25:27 +08:00
sswandClaude b37564171b ci(dacli): add check_no_dacli_ts_refs.sh CI gate
Co-Authored-By: Claude <[email protected]>
2026-07-17 12:24:56 +08:00
sswandClaude fc2282f259 chore: remove all dacli-ts references, rename to dacli
Co-Authored-By: Claude <[email protected]>
2026-07-17 12:20:48 +08:00
ssw 08787a6f94 feat(dacli): add check_clean_comments.sh script
- Detects violation comments in dacli/src/** (BS-*/R\d+/jxcj/v0.x+ patterns)
- Whitelists _anti_patterns.ts (must retain source references)
- Run: ./scripts/check_clean_comments.sh
- Finds 1709 current violations (to be cleaned in Task 3.5)
2026-07-17 12:05:37 +08:00
ssw 60432caef2 feat(dacli): add gen-anti-patterns-md.sh + first auto-generated anti-patterns markdown
- scripts/extract_anti_patterns.ts: extracts ANTI_PATTERNS from _anti_patterns.ts to stdout
- scripts/gen-anti-patterns-md.sh: bash wrapper with --check mode for CI
- docs/anti-patterns.md: auto-generated from 25 entries across 11 commands
2026-07-17 12:03:07 +08:00
ssw 508069be6c TC-B workflow 加 ensure-tc-b-todo.sh setup 脚本 (v0.21+ 运行时, 2026-07-14)
user 反馈: '是不是可以模拟办理数据' (option A: 一次性脚本 + setup 文档)

* scripts/ensure-tc-b-todo.sh 新增:
  - 查询 admin 当前待办数 (调 /workflow/operator/List/1, 镜像 web flowTodo L121)
  - ≥1 时: 提示跑 dacli test browser
  - =0 时: 给恢复指引 (testspace 切 / 其他 app 浏览器发起 / API 模拟未实现)
  - 双 app 实测: testspace 3 待办 (PASS 路径) + workSystem 0 待办 (给恢复指引)

* browser.ts help 文本加:
  - 示例: bash scripts/ensure-tc-b-todo.sh testspace
  - 0 待办时 check 1-3 PASS, check 4-7 正确识别无任务 (符合预期)
  - ≥1 待办时 7/7 PASS, 覆盖完整运行时

* MEMORY 同步: tc-b-test-user-runtime-not-admin-design.md
  - 关键洞察: TC-B 选页面要选 user-context (flowTodo), 不是 entity-context (flowEngine)
  - 设计器/配置器 (onlineDev/*) 由 TC-C 静态分析 + TC-A API 覆盖, 浏览器层浪费
  - 运行时/业务页面 (workFlow/flowTodo 等) 才是 TC-B 应该验的

实测:
  bash scripts/ensure-tc-b-todo.sh testspace  → 3 待办, PASS 路径
  bash scripts/ensure-tc-b-todo.sh workSystem → 0 待办, 给恢复指引
  dacli test browser --module=workflow --appCode=testspace → 7/7 PASS, 11s
2026-07-14 16:18:47 +08:00
sswandClaude 7a78bdadea dacli(kb): Commander arg bug fix + seed 4 domains (commit 3c/3)
## Bug fix (11 files)
原代码用 new Command('search <query>'), Commander 把整串当 command name,
结果子命令名变成 "search <query>", 实际调用报 "unknown command 'search'"。
修正: new Command('search').argument('<query>', 'desc')。

受影响: show/search/audit/add/entry/update/remove/expire/renew/archive/deprecate (11 个)
未受影响: list/map/rebuild-fts/serve (无 arg), _init.ts (走 registerInit(program))
验证: npx tsx src/cli.ts kb search scanBasePackages → 2 results (BM25 + <mark>)

## Seed 4 domains (scripts/seed-kb.ts)
非交互 .ts 脚本, 直接调 _client.ts execute()/transaction(), 跳过 readline。
幂等: 重复运行会清掉旧数据 (DELETE 域级联 entries/source_files)。

4 域 ~54 条目 (按 plan §4.1 蒸馏):
  - dacli (14 entries, 9 sources) - CLI 命令/盲点/架构
  - jnpf (14 entries, 5 sources) - 平台机制/scanBasePackages/ServiceImpMarco
  - ssw-loop (14 entries, 8 sources) - 7 阶段/4 关卡/子代理派发
  - ssw-e2e-test (12 entries, 2 sources) - TC-A/B/C + webapi 复用

数据本身不入 git (DB 内容); 仅 scripts/seed-kb.ts 入库。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
2026-07-02 16:25:56 +08:00
ssw 700ad86fd6 auto(284e8d004cbb): session end @ 2026-06-30T16:45:06 (+2f) 2026-06-30 16:45:11 +08:00
sswandClaude a17fd0307d chore(v0.11): Phase 2 清理 - 删 scripts/extract-all.mjs (Phase 1 之前已删 data/*.json, 这是 snap 脚本)
docs/dacli/v0.11-mirror-refactor.md Phase 2 删除清单:
- data/field-schemas.json       ← v0.10 之前 commit 已删
- data/component-map.json       ← v0.10 之前 commit 已删
- data/l2-rules.json            ← v0.10 之前 commit 已删
- data/validation-rules.json    ← v0.10 之前 commit 已删
- scripts/extract-web-schema.py ← v0.10 之前 commit 已删
- scripts/extract-all.mjs       ← 本次删 (350 行 snapshot 提取脚本)

scripts/extract-all.mjs 用途: 从 web/.../componentMap.ts/formValidate.ts/R*.vue
正则提取到 dacli/data/*.json, 然后 FieldBuilder.ts read 这些 JSON.

v0.11+ 后:
- dacli/src/commands/form/_buildformdata.ts 直接 import web buildFormData
- dacli/data/buildformdata-contract.md 留文档
- 不再需要 snapshot 中间产物, 也不再需要 extract 脚本

package.json: 移除 'extract' script (tsx scripts/extract-all.mjs)

Co-Authored-By: Claude <[email protected]>
2026-06-25 12:27:49 +08:00
ssw f584aaf1bd chore: Task 9 清理 v0.10 旧模式
删除 (真正死的):
- data/form-type-rules.json: 被 buildFormData 内置规则替代
- scripts/extract-web-schema.py: 被 _buildformdata.ts 动态 import 替代

加 @deprecated 标记 (手动 --fields 路径仍依赖):
- src/commands/form/_simplify.ts (wrapSimplifiedFields 等)
- src/commands/form/_blindspots.ts (5 类 schema 完整性检查)
- src/commands/form/validate.ts (老 form 校验工具)
- src/commands/form/fixcolumndata.ts (老 form 修复工具)
- src/commands/_precheck.ts (dbLinkId/enCode 检查仍有用, 但 schema 部分已废)
- src/commands/_blindspot_guards.ts (BS-48/49/50 仍有用, BS-51/52/54 已废)

更新 .claude/skills/dacli-ts/SKILL.md:
- 顶部加 'v0.11+ 架构重大变化' 段 (buildFormData 直连 + 3 种输入方式)
- 三层防御体系降级为辅助 (BS-51/52/54 已由 buildFormData 解决)
- 列已删除/已废弃文件

注意:
- 手动 --fields 路径仍可用 (用户已习惯简化格式)
- 未来若都用 AI/JSON, _simplify 可彻底删
2026-06-25 11:45:49 +08:00
ssw 8a21b07119 feat(dacli): web/ 源码参照机制 + web-source-map.md (P0.3, 解决 AI 舍近求远根因 G) 2026-06-22 15:33:35 +08:00
ssw e5e215af36 W7-D4: 4 新 extractor (report/portal/bigdata-schemas + datasource-drivers 8 driver) 2026-06-12 21:09:04 +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