flow-comet 1.6.3 → 1.6.5

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 (106) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +21 -3
  3. package/.flow-comet/skills/flow-comet/reference/artifact-template-overlay.md +154 -0
  4. package/.flow-comet/skills/flow-comet/reference/artifact-templates.json +387 -0
  5. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +8 -2
  6. package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
  7. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +11 -13
  8. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  9. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +180 -6
  10. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +69 -18878
  11. package/.flow-comet/skills/flow-comet/scripts/health.mjs +29 -5
  12. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1053 -0
  13. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  14. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  15. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  16. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +817 -0
  20. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  21. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  22. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  23. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  24. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +618 -0
  25. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +154 -0
  26. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  27. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +406 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +756 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1235 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +384 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +714 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +204 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +179 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +714 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +123 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  47. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +249 -0
  48. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1505 -0
  49. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  50. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  51. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1248 -0
  52. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  53. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2493 -0
  54. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +214 -2
  55. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +976 -0
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1398 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1367 -0
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1492 -0
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  69. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2125 -0
  70. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
  71. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +59 -7559
  72. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  73. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +223 -2476
  74. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
  75. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
  76. package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
  77. package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
  78. package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
  79. package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
  80. package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
  81. package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
  82. package/.flow-comet/skills/flow-comet-execute/SKILL.md +13 -10
  83. package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
  84. package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
  85. package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
  86. package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
  87. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
  88. package/.flow-comet/skills/flow-comet-plan/SKILL.md +11 -7
  89. package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
  90. package/.flow-comet/skills/flow-comet-review/SKILL.md +15 -9
  91. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
  92. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +11 -8
  93. package/.flow-comet/skills/flow-comet-task/SKILL.md +1 -1
  94. package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
  95. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  96. package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
  97. package/README.md +52 -69
  98. package/package.json +3 -2
  99. package/scripts/dsh-bridge.mjs +2 -2
  100. package/scripts/lib/installer-cleanup.mjs +152 -0
  101. package/scripts/lib/installer-flowkit.mjs +159 -0
  102. package/scripts/lib/installer-hooks.mjs +363 -0
  103. package/scripts/lib/installer-loader.mjs +220 -0
  104. package/scripts/lib/installer-migrate.mjs +236 -0
  105. package/scripts/lib/installer-platforms.mjs +314 -0
  106. package/scripts/prepare-env.mjs +21 -1313
@@ -0,0 +1,314 @@
1
+ /**
2
+ * installer-platforms.mjs — 平台描述符表 + 生成物部署原语(prepare-env 的逻辑层模块)
3
+ *
4
+ * 为什么这三段同处一个模块:平台描述符(各平台的安装位置、路径替换、hook/rules 注入、purge
5
+ * 与覆盖清单)与「整树复制 / 平台路径替换」是同一件事的两半——描述符的 installRules 直接调用
6
+ * 复制原语,入口主流程也用它铺技能树。放在一处既避免「描述符 → 入口 → 描述符」的循环 import,
7
+ * 也让「复制语义只有一份实现」成为结构事实。
8
+ *
9
+ * 仓库根与权威源常量(REPO_ROOT / BUNDLE_DRAFTS)也定在这里:描述符表在模块加载期就需要它们
10
+ * (dsh 的桥接 loader 源路径、各平台 rules 源目录),而依赖方向是单向的(入口 → lib),常量
11
+ * 只能落在 lib 一侧——入口与其余模块一律 import 本模块,不各自推导(同一事实不写两份)。
12
+ *
13
+ * 依赖方向:本模块依赖 installer-hooks(配置注入)与 installer-loader(loader 版本比对 /
14
+ * cordis patch);反向依赖不存在。
15
+ */
16
+ import fs from 'node:fs';
17
+ import path from 'node:path';
18
+ import { fileURLToPath } from 'node:url';
19
+
20
+ import {
21
+ MANAGED_AGENTS_END,
22
+ MANAGED_AGENTS_START,
23
+ injectCodexConfig,
24
+ injectCodexHook,
25
+ injectManagedRules,
26
+ injectSettingsHook,
27
+ removeManagedCodexHooks,
28
+ resolveDshHome,
29
+ } from './installer-hooks.mjs';
30
+ import {
31
+ injectDshCordisPatch,
32
+ removeDshCordisPatch,
33
+ reportLoaderVersionTransition,
34
+ stripManagedBlock,
35
+ } from './installer-loader.mjs';
36
+
37
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
38
+ export const REPO_ROOT = path.resolve(__dirname, '..', '..');
39
+ // 权威源根(含 skills/ 与 rules/——目录结构与安装副本 .claude/ 对称:<根>/skills/flow-comet/)
40
+ export const BUNDLE_DRAFTS = path.join(REPO_ROOT, '.flow-comet');
41
+ // rules 源目录:三个平台的 rules 注入(.claude/rules 整树复制 / AGENTS.md 托管区内联)共用同一取值
42
+ const RULES_SRC = path.join(BUNDLE_DRAFTS, 'rules');
43
+ // ---------- 平台描述符表(单一来源——新增平台 = 描述符条目 + 安装/清理函数,main 零改动) ----------
44
+ // D6:flow-kit 永不纳入清理域——下述各平台 purge 清单均不含 <target>/flow-kit/(含 --purge --yes);
45
+ // 它不是本安装器的生成物域(ADR-008),由安装器首次创建的 flow-kit 残留属预期。
46
+
47
+ export const PLATFORMS = {
48
+ 'claude-code': {
49
+ label: 'Claude Code',
50
+ // 技能安装根(相对 target;与权威源 .claude 形态一致——零路径替换)
51
+ skillRoot: (target) => path.join(target, '.claude', 'skills'),
52
+ // 平台路径替换表(from 正则 → to):claude-code 为空 = 权威源即目标形态
53
+ pathReplacements: [],
54
+ // hook 注入:settings.local.json 读-合并-写(保留既有字段;matcher Write|Edit)
55
+ installHooks(target, stats) {
56
+ const claudeDir = path.join(target, '.claude');
57
+ fs.mkdirSync(claudeDir, { recursive: true });
58
+ stats.dirs++;
59
+ const settings = injectSettingsHook(claudeDir);
60
+ const injected = !!(settings.hooks && settings.hooks.PreToolUse);
61
+ stats.files++;
62
+ console.log(`[flow-comet] settings.local.json ${injected ? '注入完成(保留既有字段)' : '已生成'}`);
63
+ },
64
+ // rules 注入:.claude/rules/ 整树复制(自动加载 markdown 指令)
65
+ installRules(target, stats) {
66
+ if (fs.existsSync(RULES_SRC)) {
67
+ copyTree(RULES_SRC, path.join(target, '.claude', 'rules'), stats);
68
+ }
69
+ },
70
+ // purge 清理:整删 .claude/(CC 的 .claude 即 flow-comet 生成物域);返回删除清单供打印
71
+ purge(target) {
72
+ const claudeDir = path.join(target, '.claude');
73
+ const removed = [];
74
+ if (fs.existsSync(claudeDir)) {
75
+ for (const entry of fs.readdirSync(claudeDir)) {
76
+ removed.push(path.join(claudeDir, entry));
77
+ }
78
+ fs.rmSync(claudeDir, { recursive: true, force: true });
79
+ }
80
+ return removed;
81
+ },
82
+ // 覆盖清单描述(默认非破坏:只覆盖生成物)
83
+ overwriteDescription(target) {
84
+ return [
85
+ path.join(target, '.claude', 'rules'),
86
+ path.join(target, '.claude', 'settings.local.json') + '(注入方式:保留既有字段,仅更新 hooks.PreToolUse)',
87
+ ];
88
+ },
89
+ },
90
+ 'codex': {
91
+ label: 'Codex',
92
+ // 技能安装根:Codex 自动发现位置($CWD/.agents/skills/ 最高优先)
93
+ skillRoot: (target) => path.join(target, '.agents', 'skills'),
94
+ // SKILL/GUIDANCE 命令路径平台化替换(权威源保持 .claude 形态,安装时替换)
95
+ pathReplacements: [
96
+ { from: /\.claude\/skills\/flow-comet\/scripts\//g, to: '.agents/skills/flow-comet/scripts/' },
97
+ ],
98
+ // hook 注入:.codex/hooks.json(顶层 hooks 包裹层 + matcher *)+ config.toml features 启用
99
+ installHooks(target, stats) {
100
+ const codexDir = path.join(target, '.codex');
101
+ injectCodexHook(codexDir, target);
102
+ injectCodexConfig(codexDir);
103
+ stats.files += 2;
104
+ console.log('[flow-comet] .codex/hooks.json + config.toml 注入完成(hooks 启用,保留既有字段)');
105
+ },
106
+ // rules 注入:AGENTS.md 托管区内联(Codex 指令唯一自动加载路径;.codex/rules/ 是命令批准规则目录,不混用;
107
+ // 注入函数与托管区标记 codex/dsh 共用——任一平台卸载可清,另一平台重装恢复)
108
+ installRules(target, stats) {
109
+ if (injectManagedRules(target, stats, RULES_SRC)) {
110
+ console.log('[flow-comet] AGENTS.md 托管区注入完成(保留托管区外用户内容)');
111
+ }
112
+ },
113
+ // purge 清理:只清 flow-comet 技能(.agents/ 为多工具共享位置——非 flow-comet 条目保留)
114
+ // + .codex/hooks.json 托管条目(保留用户条目)+ AGENTS.md 托管区(保留文件本身)
115
+ purge(target) {
116
+ const removed = [];
117
+ const agentsSkillsDir = path.join(target, '.agents', 'skills');
118
+ if (fs.existsSync(agentsSkillsDir)) {
119
+ for (const entry of fs.readdirSync(agentsSkillsDir)) {
120
+ if (!/^flow-comet/.test(entry)) continue;
121
+ const managed = path.join(agentsSkillsDir, entry);
122
+ removed.push(managed);
123
+ fs.rmSync(managed, { recursive: true, force: true });
124
+ }
125
+ }
126
+ const hooksPath = path.join(target, '.codex', 'hooks.json');
127
+ if (fs.existsSync(hooksPath)) {
128
+ removed.push(hooksPath + '(移除托管 hook 条目,保留用户条目)');
129
+ // 移除托管条目(重建流程随后重新注入新托管条目——purge = 移除旧生成物后重建)
130
+ removeManagedCodexHooks(path.join(target, '.codex'));
131
+ }
132
+ const agentsPath = path.join(target, 'AGENTS.md');
133
+ if (fs.existsSync(agentsPath)) {
134
+ const content = fs.readFileSync(agentsPath, 'utf8');
135
+ if (content.includes(MANAGED_AGENTS_START)) {
136
+ removed.push(agentsPath + '(托管区)');
137
+ const stripped = stripManagedBlock(content, MANAGED_AGENTS_START, MANAGED_AGENTS_END);
138
+ fs.writeFileSync(agentsPath, stripped.trim() + '\n', 'utf8');
139
+ }
140
+ }
141
+ return removed;
142
+ },
143
+ // 覆盖清单描述(默认非破坏:只覆盖生成物)
144
+ overwriteDescription(target) {
145
+ return [
146
+ path.join(target, 'AGENTS.md') + '(托管区注入:保留托管区外用户内容)',
147
+ path.join(target, '.codex', 'hooks.json') + '(注入方式:保留既有字段,仅更新托管 hook 条目)',
148
+ path.join(target, '.codex', 'config.toml') + '(注入方式:补 [features] hooks 启用键)',
149
+ ];
150
+ },
151
+ },
152
+ 'dsh': {
153
+ label: 'DeepSeek Harness',
154
+ // 技能安装根:dsh 项目级 skill 发现(rank 100 自动发现,免重启;未安装该目录的项目不可见该 skill)
155
+ skillRoot: (target) => path.join(target, '.dsh', 'skills'),
156
+ // SKILL/GUIDANCE 命令路径平台化替换(权威源保持 .claude 形态,安装时替换)
157
+ pathReplacements: [
158
+ { from: /\.claude\/skills\/flow-comet\/scripts\//g, to: '.dsh/skills/flow-comet/scripts/' },
159
+ ],
160
+ // hook 注入:全局挂载桥接 loader($DSH_HOME/plugins/ 复制 + cordis.patch.yml 托管块——
161
+ // 所有 profile 生效;$DSH_HOME 解析 = 显式 DSH_HOME > ~/.dsh)
162
+ installHooks(target, stats) {
163
+ const dshHome = resolveDshHome();
164
+ const pluginsDir = path.join(dshHome, 'plugins');
165
+ const loaderSrc = path.join(REPO_ROOT, 'scripts', 'dsh-bridge.mjs');
166
+ const loaderDst = path.join(pluginsDir, 'dsh-flow-comet-bridge.mjs');
167
+ if (fs.existsSync(loaderSrc)) {
168
+ fs.mkdirSync(pluginsDir, { recursive: true });
169
+ // 覆盖前版本比对明示(版本戳标记契约):输出首次安装/升级/降级/版本一致之一;
170
+ // 任一侧提取失败只告警不中断——覆盖照常执行(幂等语义不变)
171
+ reportLoaderVersionTransition(loaderSrc, loaderDst);
172
+ fs.copyFileSync(loaderSrc, loaderDst);
173
+ stats.files++;
174
+ console.log('[flow-comet] 桥接 loader 已复制到 $DSH_HOME/plugins/dsh-flow-comet-bridge.mjs');
175
+ injectDshCordisPatch(dshHome, loaderDst);
176
+ stats.files++;
177
+ console.log('[flow-comet] $DSH_HOME/cordis.patch.yml 托管块注入完成(读-合并-写,保留既有块)');
178
+ } else {
179
+ // 容错:scripts/dsh-bridge.mjs 由并行任务新建——源缺失时 WARN 跳过 loader 复制
180
+ // **并跳过 cordis.patch.yml 托管块注入**(避免注入指向不存在文件的 file:// 引用,
181
+ // 导致 dsh 每次启动尝试加载不存在的插件);仍完成其余安装
182
+ // (AGENTS.md 托管区 / skills 复制照常)
183
+ console.warn(
184
+ '[flow-comet] 警告: scripts/dsh-bridge.mjs 不存在——跳过 loader 复制与 cordis.patch.yml 托管块注入' +
185
+ '(dsh 桥接拦截暂不生效,待源文件就位后重跑 prepare-env)'
186
+ );
187
+ }
188
+ },
189
+ // rules 注入:AGENTS.md 托管区(与 codex 共用注入函数与托管区标记——任一平台卸载可清)
190
+ installRules(target, stats) {
191
+ if (injectManagedRules(target, stats, RULES_SRC)) {
192
+ console.log('[flow-comet] AGENTS.md 托管区注入完成(保留托管区外用户内容)');
193
+ }
194
+ },
195
+ // purge 清理:项目级 .dsh/skills 下全部 flow-comet* 技能(.dsh/skills 为 dsh 技能位置——
196
+ // 非 flow-comet 条目保留,与 codex purge 同语义)+ 空 .dsh 目录 + AGENTS.md 托管区
197
+ // (保留文件与用户内容)+ $DSH_HOME/cordis.patch.yml 托管块 + plugins/ loader
198
+ // (写 home 的敏感面——purge 需 --yes 显式确认)
199
+ purge(target) {
200
+ const removed = [];
201
+ const dshSkillsDir = path.join(target, '.dsh', 'skills');
202
+ if (fs.existsSync(dshSkillsDir)) {
203
+ for (const entry of fs.readdirSync(dshSkillsDir)) {
204
+ if (!/^flow-comet/.test(entry)) continue;
205
+ const managed = path.join(dshSkillsDir, entry);
206
+ removed.push(managed);
207
+ fs.rmSync(managed, { recursive: true, force: true });
208
+ }
209
+ }
210
+ // 空目录清理:仅删空目录(skills 下无剩余条目 / .dsh 下无其它内容时)——有内容则保留
211
+ if (fs.existsSync(dshSkillsDir) && fs.readdirSync(dshSkillsDir).length === 0) {
212
+ fs.rmdirSync(dshSkillsDir);
213
+ removed.push(dshSkillsDir);
214
+ }
215
+ const dshDir = path.join(target, '.dsh');
216
+ if (fs.existsSync(dshDir) && fs.readdirSync(dshDir).length === 0) {
217
+ fs.rmdirSync(dshDir);
218
+ removed.push(dshDir);
219
+ }
220
+ const agentsPath = path.join(target, 'AGENTS.md');
221
+ if (fs.existsSync(agentsPath)) {
222
+ const content = fs.readFileSync(agentsPath, 'utf8');
223
+ if (content.includes(MANAGED_AGENTS_START)) {
224
+ removed.push(agentsPath + '(托管区)');
225
+ const stripped = stripManagedBlock(content, MANAGED_AGENTS_START, MANAGED_AGENTS_END);
226
+ fs.writeFileSync(agentsPath, stripped.trim() + '\n', 'utf8');
227
+ }
228
+ }
229
+ // home patch 托管块移除 + loader 删除($DSH_HOME——写 home 的敏感面)
230
+ const dshHome = resolveDshHome();
231
+ for (const entry of removeDshCordisPatch(dshHome)) {
232
+ removed.push(entry);
233
+ }
234
+ const loaderPath = path.join(dshHome, 'plugins', 'dsh-flow-comet-bridge.mjs');
235
+ if (fs.existsSync(loaderPath)) {
236
+ removed.push(loaderPath + '($DSH_HOME/plugins/ loader)');
237
+ fs.rmSync(loaderPath, { force: true });
238
+ // 全局挂载语义警示:loader 位于 $DSH_HOME(所有 profile / 所有项目共享)——
239
+ // 任一项目 purge 都会连带移除,其它已安装 flow-comet 的项目将静默失去拦截
240
+ console.warn(
241
+ '[flow-comet] 全局桥接 loader 被移除,其它已安装 flow-comet 的项目将停止拦截' +
242
+ '($DSH_HOME 全局挂载——如需恢复请重跑 prepare-env --platform dsh)'
243
+ );
244
+ }
245
+ return removed;
246
+ },
247
+ // 覆盖清单描述(默认非破坏:只覆盖生成物;声明写 home 的敏感面)
248
+ overwriteDescription(target) {
249
+ return [
250
+ path.join(target, 'AGENTS.md') + '(托管区注入:保留托管区外用户内容)',
251
+ path.join(resolveDshHome(), 'cordis.patch.yml') + '(托管块注入:保留 dsh-skin 等既有块)',
252
+ path.join(resolveDshHome(), 'plugins', 'dsh-flow-comet-bridge.mjs') + '($DSH_HOME 全局挂载——安装器写 home 目录的敏感面)',
253
+ ];
254
+ },
255
+ },
256
+ };
257
+ // ---------- 文件工具 ----------
258
+
259
+ /** 递归收集 srcDir 下所有目录与文件的绝对路径 */
260
+ function collect(srcDir) {
261
+ const dirs = [];
262
+ const files = [];
263
+ (function walk(dir) {
264
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
265
+ const abs = path.join(dir, entry.name);
266
+ if (entry.isDirectory()) {
267
+ dirs.push(abs);
268
+ walk(abs);
269
+ } else if (entry.isFile()) {
270
+ files.push(abs);
271
+ }
272
+ }
273
+ })(srcDir);
274
+ return { dirs, files };
275
+ }
276
+
277
+ /** 整树复制 srcDir → dstRoot(保持相对结构),计数写入 stats */
278
+ export function copyTree(srcDir, dstRoot, stats) {
279
+ fs.mkdirSync(dstRoot, { recursive: true });
280
+ stats.dirs++;
281
+ const { dirs, files } = collect(srcDir);
282
+ for (const d of dirs) {
283
+ fs.mkdirSync(path.join(dstRoot, path.relative(srcDir, d)), { recursive: true });
284
+ stats.dirs++;
285
+ }
286
+ for (const f of files) {
287
+ fs.copyFileSync(f, path.join(dstRoot, path.relative(srcDir, f)));
288
+ stats.files++;
289
+ }
290
+ }
291
+
292
+ /**
293
+ * 平台路径替换:对复制后的技能包内全部 .md 文件(SKILL/GUIDANCE/reference)做命令路径替换。
294
+ * 权威源保持 .claude 形态;claude-code 平台替换表为空(零改动,可复现性 diff 不变)。
295
+ * 幂等:同平台重复安装替换结果一致。
296
+ */
297
+ export function applyPathReplacements(root, replacements) {
298
+ if (!replacements || replacements.length === 0) return 0;
299
+ let replaced = 0;
300
+ const { files } = collect(root);
301
+ for (const f of files) {
302
+ if (!f.endsWith('.md')) continue;
303
+ let content = fs.readFileSync(f, 'utf8');
304
+ const original = content;
305
+ for (const { from, to } of replacements) {
306
+ content = content.replace(from, to);
307
+ }
308
+ if (content !== original) {
309
+ fs.writeFileSync(f, content, 'utf8');
310
+ replaced++;
311
+ }
312
+ }
313
+ return replaced;
314
+ }