diff --git a/README.md b/README.md index eaf8588..55e367c 100644 --- a/README.md +++ b/README.md @@ -69,9 +69,9 @@ dacli --help # Step 3: 标准 commander 帮助 (含选项 + 描 | 30+ 错误码 (EXIST/VS/WF/SYS) | 后端 `jnpf/.../constant/MsgCode.java:50-783` | | 命名规范 (snake/camelCase/f_ 前缀) | `dacli/docs/decisions/0001-fk-relation-form-required.md` + `0002-form-create-ai-4-limitations.md` | | 找 web 源码位置 | 用 IDE 全局搜索 (`Cmd+Shift+F` / `grep -rn`) 找 `formData` / `flowNodes` / `columnList` | -| 命令评审历史 | `dacli/docs/cmd-review/` | -| 历史决策 | `dacli/docs/decisions/` (0001-0015 系列, 决策记录; ADR 0014 app clear + ADR 0015 源码遗留清单 + P0 wrapCommand 收口) | -| 历史漂移分析 | `dacli/docs/drift/` (round7/10 等修复记录) | +| 命令评审历史 | ⚠️ `dacli/docs/cmd-review/` 整体已归档 (2026-07-23) → `dacli/docs/archive/cmd-review-2026-07/` (25 文件历史快照) | +| 历史决策 | `dacli/docs/decisions/` (0001-0016 系列, 决策记录; ADR 0014 app clear + ADR 0015 源码遗留清单 + ADR 0016 eventhub blocker 设计) | +| 历史漂移分析 | ⚠️ `dacli/docs/drift/` round summary 整体已归档 (2026-07-23) → `dacli/docs/archive/drift-rounds-2026-07/` (20 round 历史快照); 顶层 drift/ 保留 README/USAGE/fetch-baseline.sh 基础设施 | | 跨项目教训 | `dacli/docs/尚数网基本开发规范v3.0.md` (公司规范) | | 反模式 | `dacli/docs/anti-patterns.md` (Web 组件 / 后端约束踩坑) | diff --git a/docs/archive/README.md b/docs/archive/README.md index 97ec325..d62861f 100644 --- a/docs/archive/README.md +++ b/docs/archive/README.md @@ -16,6 +16,37 @@ v3.0 升级时, 项目从 AIBridge Python + 19 个独立 skill 跃迁到 dacli T ## 归档清单 +### cmd-review-2026-07/ (25 文件, 2026-07-23 归档) + +2026-06-25 → 2026-06-30 一波生成的 22 个命令审计 + 2026-07-01 的 3 个 (app/bigscreen/bigscreen-components) + 2026-07-20 的 1 个 (kb-implementation-plan 实施计划), **全部已落地或基本已落地**, 整体迁移到本目录. + +| 性质 | 当前状态 | +|------|----------| +| 命令清单 / 选项 / 默认值 | ⚠️ **以 `dacli --help` 为准** (DacliHelp 注入 purpose/pitfalls/bestPractices/decisionTree, task 1.6+ 完整) | +| 决策理由 | ✅ 已沉淀到 `dacli/docs/decisions/0001-0016` 系列 ADR (权威) | +| 反模式 (踩坑) | ✅ 已沉淀到 `dacli/docs/anti-patterns.md` (auto-gen, `_anti_patterns.ts` 为单一权威源) | + +**为什么归档**: 顶层文件 AI 新会话易误读为"待办 P0". 典型过期例子 (历史快照): +- `doc.md` 标记 P0 缺 `dacli doc toc / search` → 2026-07 已实现 +- `form.md` P0 缺 `form update / addFields / rmFields` → form update/addFields/rmFields 已实现 +- `kb-implementation-plan.md` 是"实施计划"性质, 执行完后降级 + +### drift-rounds-2026-07/ (20 文件, 2026-07-23 归档) + +2026-07-11 → 2026-07-20 共 17 个 round summary (round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17) + 3 个日期归档 (2026-07-11/2026-07-12/2026-07-20 d0720-jxcj), **全部是"我们怎么修的"考古记录**, 修复完成即过期, 整体迁移到本目录. + +`dacli/docs/drift/` 保留 README.md / USAGE.md / fetch-baseline.sh 3 个基础设施文件. + +| 性质 | 当前状态 | +|------|----------| +| Round summary 内容 | ⚠️ 历史快照, 修复完成即过期, 不作操作指南 | +| 沉淀到决策 | ✅ 反模式 / 决策已沉淀到 `decisions/` 系列 ADR, 后续 `dacli --help` 注入 pitfalls | +| 沉淀到测试 | ✅ "0 漂移"测试留在 `dacli/tests/integration/drift/{module}-drift.spec.ts` (durable 资产) | + +### deprecated-v0.6-v0.8/ (25 文件, 2026-06-30 +2) + +v0.6 → v0.8 阶段的旧 dacli 架构文档 (AIBridge 前, 静态 JSON + extract 脚本时代). **原** `dacli/docs/doc/deprecated/`, v3.0+ 移到本目录. 2026-06-30 用户反馈"dacli/prompt.md + dacli/README.md 很多描述不对", 已从顶层移到此处. + ### v0.11-history/ (7 文件, ~130K) v0.10 → v0.11e+ 阶段的执行计划 / 体检报告, **已全部落地, 仅备查**. @@ -39,9 +70,7 @@ v0.10 → v0.11e+ 阶段的执行计划 / 体检报告, **已全部落地, 仅 | 审计结果 | ✅ 已全部并入 `.claude/skills/dacli/references/` (commands / errors / patterns / jnpf-design-rules / platform-mechanisms / form-data-model / web-source-map / playwright / anti-patterns / troubleshooting) | | 审计文件本身 | ⚠️ 历史快照, 审计时引用的命令数 / 实现细节可能已过时 | -### deprecated-v0.6-v0.8/ (25 文件, 2026-06-30 +2) - -v0.6 → v0.8 阶段的旧 dacli 架构文档 (AIBridge 前, 静态 JSON + extract 脚本时代). **原** `dacli/docs/doc/deprecated/`, v3.0+ 移到本目录. 2026-06-30 用户反馈"dacli/prompt.md + dacli/README.md 很多描述不对", 已从顶层移到此处. +## 当前 dacli/docs/ 结构 (v3.0+ 权威) | 文件类别 | 数量 | 性质 | |----------|------|------| @@ -64,27 +93,37 @@ v0.6 → v0.8 阶段的旧 dacli 架构文档 (AIBridge 前, 静态 JSON + extra ``` dacli/docs/ ├── 尚数网基本开发规范v3.0.md ← v3 主规范 (权威源, §一~§十九) -├── cmd-review/ ← 命令审计 (24 文件, 权威源, v3 §18 引用) -│ ├── _summary.md ← 23 父命令审计总结 -│ ├── app.md / dict.md / di.md ← 应用隔离相关审计 (含 BS-47 jxcj P1-5 修复) -│ └── ... (其余 21 命令) -├── web-patches/ ← web 端补丁 (MEMORY 强制保留) -│ └── .md ← 改 web 端必须存此 +├── decisions/ ← ADR 决策记录 (0001-0016, 权威源) +├── anti-patterns.md ← 反模式 (auto-gen, `_anti_patterns.ts` 单一权威源) +├── audit-2026-07-22.md ← ⚠️ 部分结论已误判, 见 audit-2026-07-23-deep §更正声明 +├── audit-2026-07-23-deep.md ← 深度审计 (架构层, 容器内实跑复核 +12 章节) +├── web-patches/ ← web 端基线改动存档 (MEMORY 强制保留) +├── cmd-review/ ← ⚠️ 2026-07-23 整体归档, 仅 README 指针, 看 archive/cmd-review-2026-07/ +├── drift/ ← Drift loop 基础设施 (README/USAGE/fetch-baseline.sh), round summary 已归档 └── archive/ ← 历史归档 (本目录, ⚠️ 不作操作指南) ├── README.md ← 本文件 + ├── cmd-review-2026-07/ ← 25 命令审计快照 (2026-06-30 ~ 2026-07-20) + ├── drift-rounds-2026-07/ ← 20 round summary (2026-07-11 ~ 2026-07-20) ├── v0.11-history/ ← v0.10 → v0.11e+ 阶段产物 (已落地) ├── skill-audit-2026-06/ ← skill 审计快照 (结果已并入 references/) - └── deprecated-v0.6-v0.8/ ← 旧 dacli 架构文档 (extract 脚本时代) + ├── deprecated-v0.6-v0.8/ ← 旧 dacli 架构文档 (extract 脚本时代) + └── dacli-ts/ ← 早期 SKILL 草稿 (已废弃) ``` ## AI 误读防御清单 新会话 AI 第一次进 `dacli/docs/` 时, **优先看**: 1. `尚数网基本开发规范v3.0.md` (主规范) -2. `cmd-review/app.md` / `cmd-review/dict.md` / `cmd-review/di.md` (应用隔离相关审计) -3. `cmd-review/_summary.md` (命令总览) +2. `decisions/0001-0016` 系列 ADR (决策记录) +3. `anti-patterns.md` (反模式索引) + +**当前权威 (不用进 cmd-review/)**: +- 命令用法 → `dacli --help` (含 DacliHelp 注入 pitfalls/bestPractices/decisionTree, task 1.6+ 完整) +- 命令评审历史 → `archive/cmd-review-2026-07/` (历史快照, 不再更新) +- Drift round 总结 → `archive/drift-rounds-2026-07/` (历史快照, 不再更新) **跳过不看**: +- `cmd-review/` 顶层 (已整体归档, 仅 README 指针, 自 2026-07-23 起不再更新) - `archive/` 任何文件 (除非用户明确要求查历史) - `doc/deprecated/` 任何文件 (已废弃) @@ -99,6 +138,7 @@ dacli/docs/ --- -**归档执行**: 2026-06-29 +**归档执行**: 2026-06-29 (首次), 2026-07-23 (cmd-review 25 + drift round 20 加批次) **作者**: Claude Code + dacli 团队 -**触发**: 用户反馈 "dacli/docs/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导" \ No newline at end of file +**触发 (2026-07-23)**: 用户反馈 "dacli help 体系 cmd-review 22 文件 + drift 13 round 意义不大, 也可归档" → 整体迁移到本目录 +**触发 (2026-06-29)**: 用户反馈 "dacli/docs/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导" \ No newline at end of file diff --git a/docs/decisions/0001-fk-relation-form-required.md b/docs/decisions/0001-fk-relation-form-required.md index dfdb0a7..bb6b13b 100644 --- a/docs/decisions/0001-fk-relation-form-required.md +++ b/docs/decisions/0001-fk-relation-form-required.md @@ -1,5 +1,7 @@ # 0001-fk-relation-form-required +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `drift/R17`, 已迁 `dacli/docs/archive/drift-rounds-2026-07/2026-07-15-round17-plan.md`. 路径仅溯源不变. + > **日期**: 2026-07-17 > **状态**: Accepted > **作者**: claude-code diff --git a/docs/decisions/0002-form-create-ai-4-limitations.md b/docs/decisions/0002-form-create-ai-4-limitations.md index 45598c3..65c33bb 100644 --- a/docs/decisions/0002-form-create-ai-4-limitations.md +++ b/docs/decisions/0002-form-create-ai-4-limitations.md @@ -1,5 +1,7 @@ # 0002-form-create-ai-4-limitations +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `drift/R17`, 已迁 `dacli/docs/archive/drift-rounds-2026-07/2026-07-15-round17-plan.md`. 路径仅溯源不变. + > **日期**: 2026-07-17 > **状态**: Accepted > **作者**: claude-code diff --git a/docs/decisions/0003-form-update-fields-no-alter-table.md b/docs/decisions/0003-form-update-fields-no-alter-table.md index 038436e..2054d19 100644 --- a/docs/decisions/0003-form-update-fields-no-alter-table.md +++ b/docs/decisions/0003-form-update-fields-no-alter-table.md @@ -1,5 +1,7 @@ # 0003-form-update-fields-no-alter-table +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `drift/R12`, 已迁 `dacli/docs/archive/drift-rounds-2026-07/2026-07-15-round12-*.md`. 路径仅溯源不变. + > **日期**: 2026-07-17 > **状态**: Accepted > **作者**: claude-code diff --git a/docs/decisions/0004-menu-create-type3-moduleid.md b/docs/decisions/0004-menu-create-type3-moduleid.md index 6b7797a..26a373d 100644 --- a/docs/decisions/0004-menu-create-type3-moduleid.md +++ b/docs/decisions/0004-menu-create-type3-moduleid.md @@ -1,5 +1,7 @@ # 0004-menu-create-type3-moduleid +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `drift/R5`, 已迁 `dacli/docs/archive/drift-rounds-2026-07/2026-07-14-round5-menu-workflow-summary.md`. 路径仅溯源不变. + > **日期**: 2026-07-17 > **状态**: Accepted > **作者**: claude-code diff --git a/docs/decisions/0011-dm-drop-data-blocked.md b/docs/decisions/0011-dm-drop-data-blocked.md index adf6fe7..1295570 100644 --- a/docs/decisions/0011-dm-drop-data-blocked.md +++ b/docs/decisions/0011-dm-drop-data-blocked.md @@ -1,5 +1,7 @@ # 0011-dm-drop-data-blocked +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `cmd-review/dm.md`, 已迁 `dacli/docs/archive/cmd-review-2026-07/dm.md`. 路径仅溯源不变. + > **日期**: 2026-07-20 > **状态**: Accepted > **作者**: claude-code (jxcj M2 重启实战) diff --git a/docs/decisions/0013-menu-create-currentuser-cache.md b/docs/decisions/0013-menu-create-currentuser-cache.md index a372988..c764e0e 100644 --- a/docs/decisions/0013-menu-create-currentuser-cache.md +++ b/docs/decisions/0013-menu-create-currentuser-cache.md @@ -1,5 +1,7 @@ # 0013-menu-create-currentuser-cache +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `cmd-review/menu.md`, 已迁 `dacli/docs/archive/cmd-review-2026-07/menu.md`. 路径仅溯源不变. + > **日期**: 2026-07-20 > **状态**: Accepted > **作者**: claude-code (jxcj M2 重启实战) diff --git a/docs/decisions/0015-source-leftovers.md b/docs/decisions/0015-source-leftovers.md index ede6a05..bb39577 100644 --- a/docs/decisions/0015-source-leftovers.md +++ b/docs/decisions/0015-source-leftovers.md @@ -1,5 +1,7 @@ # 0015 — 源码遗留清单 + 收口路线 (v2.2+, 2026-07-21) +> **⚠️ 引用归档说明 (2026-07-23)**: 本 ADR 引用 `cmd-review/scan-2026-07-21.md` (本就不在 cmd-review/, 是早期误引用; 整个 cmd-review/ 已整体归档). 扫描报告的实质内容已并入本 ADR §正文和当前 src 改动. + > **状态**: 接受 (Accepted, 2026-07-21). P0 + P3 已 done. > **作者**: 上次 session 起草被 revert (`7cdc818`), 本 session 重新建 — 实证部分 (P0 + P3 + 文件计数) 基于已 commit 的 `c637a58` / `715fcb9`. > **扫描报告**: `dacli/docs/cmd-review/scan-2026-07-21.md` 8 维度扫描 + 4 项新发现 (workflow shim / console.log 范围扩大 / form/create 13 process.exit / DacliError 实际无重复). diff --git a/docs/drift/README.md b/docs/drift/README.md index 3281268..0f59920 100644 --- a/docs/drift/README.md +++ b/docs/drift/README.md @@ -1,5 +1,7 @@ # dacli Drift Detection Loop +> **⚠️ 2026-07-23 部分归档**: 20 个 round summary(round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17 + 0720-jxcj + day summary)已迁 [`../archive/drift-rounds-2026-07/`](../archive/drift-rounds-2026-07/), 仅备查. 本目录保留 README/USAGE/fetch-baseline.sh 基础设施. + > **目的**:用 JNPF baseline(developSystem + workSystem)当 oracle,通过 /loop TDD 模式检测 dacli 重建行为漂移。 ## 工作流概览(5 个环节) @@ -107,4 +109,5 @@ cd $ccWorkDir/dacli && npx vitest run tests/integration/drift/{module}-drift.spe | 8 | `2026-07-14-round8-blindspot-solidify.md` | 盲点固化 9 个 | | 9 | `2026-07-14-round9-dict-di-drift-summary.md` | dict + di drift 11 类别 | | 10 | `2026-07-14-round10-drift-fix-summary.md` | BS-NCPF-400 + BS-drift-DI-1/2/3 | -| **11** | **`2026-07-14-round11-ai-user-workflow-blindspot.md`** | **本轮: --ai 错误分类 + user resetPwd + NCPF retry + LLM NPE + 2 已知不可修** | +| **11** | `archive/drift-rounds-2026-07/2026-07-14-round11-ai-user-workflow-blindspot.md` | 本轮: --ai 错误分类 + user resetPwd + NCPF retry + LLM NPE + 2 已知不可修 | +| 12+ | `archive/drift-rounds-2026-07/` (round 12-17) | 已闭环, **不再单独索引**, 看 archive 子目录 |