auto(14b5ea1b9bd9): session end @ 2026-07-23T15:04:41 (+10f)
This commit is contained in:
1 parent
64fbb4ac0a
commit
0bb32d5ae2
10 files changed
+75
-18
No files matched your search
@@ -69,9 +69,9 @@ dacli <cmd> --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 组件 / 后端约束踩坑) |
|
||||
|
||||
|
||||
+54
-14
@@ -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 <cmd> --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 <cmd> --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 强制保留)
|
||||
│ └── <comp>.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 <cmd> --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/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"
|
||||
**触发 (2026-07-23)**: 用户反馈 "dacli help 体系 cmd-review 22 文件 + drift 13 round 意义不大, 也可归档" → 整体迁移到本目录
|
||||
**触发 (2026-06-29)**: 用户反馈 "dacli/docs/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 重启实战)
|
||||
|
||||
@@ -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 重启实战)
|
||||
|
||||
@@ -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 实际无重复).
|
||||
|
||||
@@ -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 子目录 |
|
||||
Reference in new issue
Block a user