dsh-harness-kit 0.1.5 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +30 -15
  2. package/README.zh-CN.md +29 -18
  3. package/client.js +108 -11
  4. package/docs/DETAIL.en.md +30 -10
  5. package/docs/DETAIL.md +15 -5
  6. package/kernel/advance.js +3 -3
  7. package/kernel/bindings.js +11 -6
  8. package/kernel/commands.js +257 -20
  9. package/kernel/local-files.js +175 -0
  10. package/kernel/metrics.js +280 -0
  11. package/kernel/panel.js +141 -7
  12. package/kernel/paths.js +62 -1
  13. package/kernel/setup.js +20 -19
  14. package/kernel/te.js +4 -4
  15. package/kernel/worktree.js +164 -20
  16. package/package.json +1 -1
  17. package/packs/ai-coding/agents/business-analyst.md +4 -4
  18. package/packs/ai-coding/agents/code-reviewer.md +6 -6
  19. package/packs/ai-coding/agents/developer.md +5 -5
  20. package/packs/ai-coding/agents/solution-architect.md +2 -2
  21. package/packs/ai-coding/assets/scripts/codebase_guide_init.py +70 -48
  22. package/packs/ai-coding/assets/scripts/harness_init.py +30 -11
  23. package/packs/ai-coding/assets/scripts/te_lease.py +106 -0
  24. package/packs/ai-coding/assets/scripts/update_board.py +30 -0
  25. package/packs/ai-coding/assets/scripts/verify.py +3 -3
  26. package/packs/ai-coding/assets/templates/dotnet/dotnet-multimodule/{app-CLAUDE.tmpl → app-AGENTS.tmpl} +5 -5
  27. package/packs/ai-coding/assets/templates/dotnet/dotnet-multimodule/{module-CLAUDE.tmpl → module-AGENTS.tmpl} +5 -5
  28. package/packs/ai-coding/assets/templates/dotnet/dotnet-multimodule/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  29. package/packs/ai-coding/assets/templates/java/maven/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  30. package/packs/ai-coding/assets/templates/java/maven-multimodule/{module-CLAUDE.tmpl → module-AGENTS.tmpl} +5 -5
  31. package/packs/ai-coding/assets/templates/java/maven-multimodule/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  32. package/packs/ai-coding/assets/templates/javascript/mobile-app/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  33. package/packs/ai-coding/assets/templates/javascript/uniapp/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  34. package/packs/ai-coding/assets/templates/javascript/vue-multimodule/{app-CLAUDE.tmpl → app-AGENTS.tmpl} +4 -4
  35. package/packs/ai-coding/assets/templates/javascript/vue-multimodule/{root-CLAUDE.tmpl → root-AGENTS.tmpl} +3 -3
  36. package/packs/ai-coding/flows/init.yml +7 -7
@@ -1,12 +1,12 @@
1
1
  ---
2
- description: 通用 Vue 前端 App 级 CLAUDE.md 生成指令
3
- target: services/{{SUB_PROJECT}}/apps/{{APP_NAME}}/CLAUDE.md
2
+ description: 通用 Vue 前端 App 级 AGENTS.md 生成指令
3
+ target: services/{{SUB_PROJECT}}/apps/{{APP_NAME}}/AGENTS.md
4
4
  variables:
5
5
  APP_PATH: "App 绝对路径"
6
6
  APP_NAME: "App 目录名"
7
7
  ---
8
8
 
9
- 请分析 `{{APP_PATH}}/` 下的代码,生成 App 级 CLAUDE.md。
9
+ 请分析 `{{APP_PATH}}/` 下的代码,生成 App 级 AGENTS.md。
10
10
 
11
11
  ## 必须包含的章节
12
12
 
@@ -33,4 +33,4 @@ variables:
33
33
  - 每个章节必须有实际内容,不得输出 TODO、待补充、留空
34
34
  - 只生成以上章节,不添加额外章节
35
35
  - 元信息块置于文件开头,键名逐字照抄(`职责` / `domain`,区分大小写),供机器检索
36
- - 不要添加整体 CLAUDE.md 文件头
36
+ - 不要添加整体 AGENTS.md 文件头
@@ -1,9 +1,9 @@
1
1
  ---
2
- description: 通用 Vue 前端根 CLAUDE.md 生成指令
3
- target: services/{{SUB_PROJECT}}/CLAUDE.md
2
+ description: 通用 Vue 前端根 AGENTS.md 生成指令
3
+ target: services/{{SUB_PROJECT}}/AGENTS.md
4
4
  ---
5
5
 
6
- 请分析 `services/{{SUB_PROJECT}}/` 下的工程结构(package.json、构建配置、目录布局),生成根级 CLAUDE.md。
6
+ 请分析 `services/{{SUB_PROJECT}}/` 下的工程结构(package.json、构建配置、目录布局),生成根级 AGENTS.md。
7
7
 
8
8
  ## 必须包含的章节
9
9
 
@@ -12,7 +12,7 @@ stages:
12
12
  - name: 展示计划
13
13
  actor: PM
14
14
  do:
15
- - 以表格向人展示每个子工程:类型、模板、L1 CLAUDE.md / L1.5 .harness/build.json / L2 docs/CODE_STANDARDS.md 各项状态(✅已存在跳过 / ♻️补齐缺失键 / ⬜待生成)、模块级 CLAUDE.md 的缺失清单
15
+ - 以表格向人展示每个子工程:类型、模板、L1 AGENTS.md(已有 CLAUDE.md 也算已存在,不生成缺少的)/ L1.5 .harness/build.json / L2 docs/CODE_STANDARDS.md 各项状态(✅已存在跳过 / ♻️补齐缺失键 / ⬜待生成)、模块级 AGENTS.md(已有 CLAUDE.md 也算已存在)的缺失清单
16
16
  - name: 生成确认
17
17
  actor: PM
18
18
  gate: 把计划交人确认(全部生成 / 逐项确认 / 取消),用 ask_user_question 工具;确认前不得写任何子工程文件
@@ -29,7 +29,7 @@ stages:
29
29
  gate: 补齐方案必须经人确认后才写盘;未经确认不得改 build.json
30
30
  do:
31
31
  - 目标:初始化完成后每个子工程都能真实编译和启动 —— build.json 的 compile / test / start / start-ok / start-timeout / start-port 必须是**可执行的工程事实**,不是模板占位
32
- - 对每个子工程先探索事实再提方案:读 package.json 的 scripts / pom.xml / build.gradle / *.csproj / README / 已有 CLAUDE.md,推断各键的具体命令、启动端口、启动成功的日志特征(start-ok 正则候选,如 `Started .* in [0-9.]+ seconds`、`Local:.*http`)
32
+ - 对每个子工程先探索事实再提方案:读 package.json 的 scripts / pom.xml / build.gradle / *.csproj / README / 已有 AGENTS.md 或 CLAUDE.md,推断各键的具体命令、启动端口、启动成功的日志特征(start-ok 正则候选,如 `Started .* in [0-9.]+ seconds`、`Local:.*http`)
33
33
  - 以表格向人展示每个子工程的补齐方案:键、推断值、推断依据(来源文件);用 ask_user_question 让人逐项确认 / 修改 / 跳过
34
34
  - 确认后写盘:用 python3 -c 读改 JSON,只覆盖人确认过的键,其余键原样保留;写完校验 JSON 合法
35
35
  - 工程事实也推不出的键保持空 = 未声明(后续验证如实报「未验证」),禁止拍脑袋编造
@@ -52,16 +52,16 @@ stages:
52
52
  do:
53
53
  - 对每个确认生成的子工程派发一个 subagent:自包含 prompt = 模板 .harness/templates/<模板目录>/CODE_STANDARDS.tmpl 全文 + 目标代码目录路径 + 输出路径 <子工程>/docs/CODE_STANDARDS.md
54
54
  - subagent 读代码后按模板章节据实生成,写盘后返回;等待返回再发下一个(串行,1-2 个很快)
55
- - 必须在 build.json 之后、root CLAUDE.md 之前完成
56
- - name: L1 根 CLAUDE.md
55
+ - 必须在 build.json 之后、root AGENTS.md 之前完成
56
+ - name: L1 根 AGENTS.md
57
57
  actor: PM
58
58
  do:
59
- - 对每个确认生成的子工程派发一个 subagent:模板 root-CLAUDE.tmpl 全文 + 目标代码目录 + 输出 <子工程>/CLAUDE.md
59
+ - 对每个确认生成的子工程派发一个 subagent:模板 root-AGENTS.tmpl(存量工作区若只有 root-CLAUDE.tmpl 则兼容) 全文 + 目标代码目录 + 输出 <子工程>/AGENTS.md;仅当 AGENTS.md 和 CLAUDE.md 都不存在时生成,已有任一则跳过
60
60
  - 「参考文档」段必须列 docs/CODE_STANDARDS.md —— 模板已写死该引用,不得按当前盘面自行判断"无参考文档"
61
- - name: 模块级 CLAUDE.md
61
+ - name: 模块级 AGENTS.md
62
62
  actor: PM
63
63
  do:
64
- - 按 plan 中缺失的模块清单派发 subagent(后端 module-CLAUDE.tmpl / 前端 app-CLAUDE.tmpl),每批最多 5 个并行,避免上下文爆炸
64
+ - 按 plan 中缺失的模块清单派发 subagent(后端 module-AGENTS.tmpl(旧 module-CLAUDE.tmpl 兼容) / 前端 app-AGENTS.tmpl(旧 app-CLAUDE.tmpl 兼容)),输出 <模块>/AGENTS.md;模块已有 AGENTS.md 或 CLAUDE.md 任一则跳过,每批最多 5 个并行,避免上下文爆炸
65
65
  - 每个 prompt 自包含:模板全文 + 模块路径 + 输出路径
66
66
  - name: CodeGraph 索引
67
67
  actor: PM