Commit Graph
11 Commits
Author SHA1 Message Date
ssw 0bb32d5ae2 auto(14b5ea1b9bd9): session end @ 2026-07-23T15:04:41 (+10f) 2026-07-23 15:04:41 +08:00
ssw a5c22b98d3 docs(0015): 源码 5 类遗留清单 (v2.2+ 实证 P0 已 done + P1-P6 待办)
基于 c637a58 wrapCommand 实证重建 (上次 86d9dac 因太早被 7cdc818 revert).

5 类遗留 (§2):
  - §2.1 P0 printCommandEnd 5c 样板 ✅ DONE (c637a58)
  - §2.2 P1 2 个已知 baseline 坑 (dm/drop + storage/info)
  - §2.3 P2 25+ 高严重度文件批量
  - §2.4 P3 18 个 _validate.ts 错误码 import 不一致
  - §2.5 P4 addOutputOptions 已加但 stdout 风格不统一
  - §2.6 P5 console.log + throw 统一 (4+h 大改)
  - §2.7 P6 350+ 裸 process.exit 跨 session 治理 (大坑)

决策依据 (§4):
  - P0 为什么 ROI 极高: 一行 helper = 30+ 行样板 + 单测 17 条已稳
  - P1 紧跟: 独立 1 文件修改, 风险极低
  - P3 不放 P1 前: 批量一致性调整 < 已知坑修复
  - P5/P6 大坑单独排期

README §引用: ADR 索引 0001-0015 系列, 版本加 v2.2+ wrapCommand.
2026-07-21 17:05:31 +08:00
ssw 1e2a271713 docs(README): ADR 索引更新 0010 → 0014
闭合本会话遗留集成:
- 历史决策段引用 `0001-0010 系列` → `0001-0014 系列`
- 加注 ADR 0014 app clear 覆盖 (用户指引找到最新决策)

配合 .claude 773cc98 (关卡 I 注册) + dacli f7bc8d5 (ADR 0014) 形成完整索引
2026-07-21 16:05:55 +08:00
ssw f7bc8d55d0 docs(0014-app-clear-docs-coverage): app clear docs 残留缺口决策记录
事实: docs/jxcj 实测 14 项残留 (8 MD + 4 子目录 + 设计说明)
      不被清理, 历史 DOC_HTML_FILES 只清 4 html

根因: docs/dacli/ssw-dacli/.../ClearAppCommand.java 用 DOC_HTML_FILES 白名单
      Dacli 也复用了同样限制, 漏了所有非 html 文件

修复 (P1-2d commit 60adaab): dacli 端加 --clean-docs flag (默认 false 保持向后兼容)
  true:  docs/{app}/ 整体打包成 FileTarget, 移到 history-bak/{ts}/files/docs/{app}/
  false: 历史行为 + DRY-RUN 警告提示残留项数 + 提示 --clean-docs

决策依据:
- docs/{app}/ 是 ssw-loop 关卡 A/B/C 强依赖 (design/testcase/summary/learnings/plan/debug + _assets 6+ MD)
- 默认不改, 用户显式加 --clean-docs 才真清, history-bak 保留可还原
- 与 P0-3 (2026-07-15) DB fallback 同模式: --no-relation-form-auto / --autoRelease 等 flag

已知 ssw-common 端点 bug (留下游路线 §1):
- DbClearServiceImpl.listBizTables 走 openConn(appCode, null) 把 jxcj 当独立 db
- 但 jxcj 在 PG 共享库 j62 schema=jxcj, 不是独立 db
- 修复需要改 Java 5-10 处 + Maven 编译 + JNPF 重启 (Java 无 devtools auto-reload)
- 风险: testspace 当前活跃测试会中断
- 跨项目路线, 不在 dacli 端实现

下游路线 (ADR §Downstream):
1. ssw-common 端点改进 (跨项目, 高优)
2. dacli 端 fallback 查询 (P1, 中优)
3. ssw-loop 关卡 check_clear_coverage.sh (P2, 低优)
4. dacli app history 子命令 (P3, 远期)

E2E 验证 (testspace 默认应用):
- DRY-RUN --clean-docs 显示 [MOVE] docs/testspace/ 整体打包
- 业务库 preview 列出 72 张表 (testspace schema=public 正常工作)
- jxcj schema=public 不识别业务表 (符合 ADR §已知风险)

README 路径速查表加 "--clean-docs 行为" 行, 指向 0014-ADR
2026-07-21 15:47:19 +08:00
ssw 3d4002f6cc auto(bfc0cfa2c3a4): session end @ 2026-07-21T12:22:16 (+15f) 2026-07-21 12:22:16 +08:00
ssw a949cfadd1 auto(bfc0cfa2c3a4): session end @ 2026-07-21T09:47:17 (+5f) 2026-07-21 09:47:17 +08:00
ssw 84b5e39c2e auto(bfc0cfa2c3a4): session end @ 2026-07-21T08:54:25 (+1f) 2026-07-21 08:54:25 +08:00
sswandClaude 9f0473563a chore(dacli): add README 5 大铁律速查 + workflow output filter helper
文件:
- README.md (新增): dacli 基本原则速查, 5 大铁律 (web 源码权威 / 不写 LLM prompt /
  镜像架构 0 漂移 / dacli form 信息完整 / 不绕过 dacli), 跨 app 通用
- src/commands/workflow/_output.ts (新增): workflow 命令输出过滤 helper
  复用 dacli form 的输出过滤模式 (log.setQuiet + --verbose + --json +
  完成后 '详情: dacli log last' 提示)

清理: 解决 2026-07-20 提醒的 'git 改动没切过来' 问题,
  把今日 (2026-07-20) untracked 的 2 个文件 commit 进来

stash@{0} (707c3fb 'ssw-h5dev-flow v0.9 lint + dispatch 协议固化') 不动, 等其他 session 处理

Co-Authored-By: Claude <[email protected]>
2026-07-20 20:26:33 +08:00
ssw 20b0e62312 feat(docs): 归档过期顶层入口文档 prompt.md + README.md (v3.0+) (archive)
- 移除顶层 dacli/prompt.md (v0.7.1 任务说明书, 8 父命令 / 27 子命令口径, 已全过期)
- 移除顶层 dacli/README.md (v0.7 项目入口, 误把 Java 版当生产, 结论与 v3.0 相反)
- 移到 docs/archive/deprecated-v0.6-v0.8/ 加版本后缀 (.v0.7.md / .v0.7.1.md), 避免与目录索引 README.md 同名覆盖
- 更新 docs/archive/README.md (外层索引): 文件数 23→25, 新增'项目入口文档'分类
- 更新 docs/archive/deprecated-v0.6-v0.8/README.md (内层索引): 新增'项目入口文档 (v0.7-v0.7.1, 已被 v3.0 规范替代)'段, 引用 v3.0 主规范 + dacli-ts SKILL.md 作为新权威源
- 不动其它预先存在的变更 (scripts/seed-tds-baseline.ts / snap-menu-page.mjs / .DS_Store)

权威源: ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md (v3.0+, 2026-06-29) + ccWorkDir/.claude/skills/dacli-ts/SKILL.md

测试: PASS (纯 doc move, 无 src/commands/* 改动, 不触发 CI 关卡 G)
2026-06-30 15:16:06 +08:00
ssw ccd9c8d124 chore(v0.11+): Phase 4 历史残留清理 - 删 v0.10 静态快照 + 更新 README/prompt
清理:
1. 删除 data/web-derived-schemas.json (v0.10 静态快照, v0.11+ webapi 自动同步无需保留)
2. README.md: 移除 extract-all.mjs / extractors 引用, 加 v0.11+ webapi 段, 修正 .claude/skills/dacli-ts 路径 → ../.claude/skills/dacli-ts
3. prompt.md: 移除 extract-all.mjs 引用 (3 处), 改写 v0.8 '提取 JSON' 段为 v0.11+ 'webapi 自动同步'

未清理项 (按 plan §13 保留):
- src/data/*.json (component-map/field-schemas/validation-rules/form_type_rules 等 9 个 JSON) — 仍被 FieldBuilder.ts 加载, 有 3 个 unit 测试覆盖
- src/commands/_precheck.ts / _blindspot_guards.ts / form/_simplify.ts / form/_blindspots.ts / form/validate.ts / form/fixcolumndata.ts — 上一个 commit 已移除 LEGACY 误标头, 这些文件仍实际使用
- doc/v0.x-changelog.md 等 11 个版本历史 — 合法历史归档, 保留

Phase 4 完成度: A (盲点表整合) + B (deprecated 误标清理) + C (已删资源引用清理) + E (dacli 自有 schema 保留) + G (architecture.md 已 v0.11+ 更新) - 全部 PASS
未做: D (22 条盲点表整合到 _blindspot_guards.ts 单一权威) - 后续 P1 任务
2026-06-25 16:11:41 +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