flow-comet 1.6.4 → 1.7.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 (85) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +36 -6
  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/commit-discipline.md +1 -1
  6. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +29 -4
  7. package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
  8. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
  9. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +174 -0
  10. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +17 -95
  11. package/.flow-comet/skills/flow-comet/scripts/health.mjs +28 -4
  12. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +136 -19
  13. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +54 -18
  14. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +6 -6
  15. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
  16. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +25 -10
  17. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +4 -2
  18. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +21 -13
  19. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +163 -0
  20. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
  21. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +448 -0
  22. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +396 -27
  23. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1035 -172
  24. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +129 -98
  25. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
  26. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +797 -232
  27. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +91 -22
  28. package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +69 -13
  32. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +454 -135
  33. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +109 -13
  35. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
  36. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +149 -34
  37. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +79 -9
  38. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
  39. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +78 -8
  40. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
  41. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +167 -3
  42. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
  43. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +287 -0
  44. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1454 -16
  45. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
  46. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1205 -77
  47. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
  48. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +52 -11
  49. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
  50. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +9 -1
  51. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
  52. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +22 -6
  53. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
  54. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +18 -5
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +4100 -0
  56. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
  57. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +6 -5
  58. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +203 -4
  59. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
  60. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
  61. package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
  62. package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
  63. package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
  64. package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
  65. package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
  66. package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
  67. package/.flow-comet/skills/flow-comet-execute/SKILL.md +42 -15
  68. package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
  69. package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
  70. package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
  71. package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
  72. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
  73. package/.flow-comet/skills/flow-comet-plan/SKILL.md +21 -10
  74. package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
  75. package/.flow-comet/skills/flow-comet-review/SKILL.md +33 -18
  76. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
  77. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +44 -16
  78. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  79. package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
  80. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  81. package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
  82. package/README.md +3 -3
  83. package/package.json +1 -1
  84. package/scripts/dsh-bridge.mjs +2 -2
  85. package/scripts/lib/installer-flowkit.mjs +43 -3
@@ -5,6 +5,8 @@
5
5
  * 归属不可确认即跳过并给手动指引;clone / checkout 的失败**不抛错**——外网故障不得绑架安装器
6
6
  * 的其余职责(技能树、规则、hook 注入照常完成,进程照常 exit 0)。把这条链路独立成模块,是为
7
7
  * 了让「什么情况下会改动用户目录」只有一个落点可审——答案必须是「只有目标不存在时」。
8
+ * 降级态的统一口径是「未校验(模板缺失)」:获取点给怎么补(命令),进程结尾单独明示后果与
9
+ * 修复方法(两处分工见 FLOW_KIT_DEGRADED_NOTICE 上方的说明)。
8
10
  *
9
11
  * 依赖方向:本模块是叶子(只用 node 内置模块与 git 命令)。
10
12
  */
@@ -28,12 +30,47 @@ function gitErrorFirstLine(err) {
28
30
  return String(err && err.message ? err.message : err).split('\n')[0].trim();
29
31
  }
30
32
 
31
- /** 手动获取指引(clone/checkout 失败或目录非上游克隆时打印——含上游 URL 与目标路径;不抛错) */
33
+ /**
34
+ * 手动获取指引(clone/checkout 失败或目录非上游克隆时打印——含上游 URL 与目标路径;不抛错):
35
+ * 这里只负责「怎么补」,用户可见的结论(影响 / 原因 / 修复方法)留到进程结尾单独明示——
36
+ * 获取段在平台摘要之前执行,结论留在这一段里会被后面的平台清单与摘要顶出视野。
37
+ */
32
38
  function printFlowKitManualGuide(target) {
33
39
  const flowKitDir = path.join(target, 'flow-kit');
34
40
  console.warn(`[flow-comet] 手动获取指引: git clone ${FLOW_KIT_UPSTREAM_URL} "${flowKitDir}"`);
35
41
  console.warn(`[flow-comet] 然后锁定快照: git -C "${flowKitDir}" checkout --detach ${FLOW_KIT_LOCKED_COMMIT.slice(0, FLOW_KIT_SHORT_SHA_LEN)}`);
36
- console.warn('[flow-comet] 未获取 flow-kit 时技能协议引用悬空、guard 段名基准退化为内置 fallback——其余安装职责不受影响。');
42
+ console.warn('[flow-comet] 后果: 模板校验将不可用——各节点出口输出「未校验(模板缺失)」而不比对模板段形;技能册的模板引用同时悬空。其余安装职责不受影响。');
43
+ }
44
+
45
+ /**
46
+ * 安装结尾的降级结论(未校验(模板缺失)):影响 / 原因 / 修复方法三行,挂在进程结尾打印。
47
+ * 与获取点的手动指引分工:那里给命令(现在就能照做),这里给结论(安装结束时的状态与后果)。
48
+ * 只有真的拿不到模板时才挂(获取成功、HEAD 只读失败但目录在场都不挂——模板仍在磁盘上,
49
+ * 结构校验照常可用)。调用契约:只由 prepare-env CLI 进程调用——结尾提示挂在 process 'exit'
50
+ * 上,若将来被库内导入复用,提示会跟着宿主进程退出一起打印(不可断言、会污染输出)。
51
+ * 修复行的措辞约束:`flow-kit/` 已存在但归属无法确认时,重跑会落回同一条跳过分支(安装器绝不
52
+ * 改动已有目录)——所以「重跑」只在移走/处理该目录或按手动步骤补齐之后才是修复,不能单说重跑。
53
+ */
54
+ const FLOW_KIT_DEGRADED_NOTICE = [
55
+ '[flow-comet] 提醒: 本次安装未获取 flow-kit 模板——产出物不会做模板校验。',
56
+ '[flow-comet] 影响: 各节点出口输出「未校验(模板缺失)」而不拦缺段 / 乱序 / 空段(结构校验不可用)。',
57
+ '[flow-comet] 原因: flow-kit/templates 未就位(自动获取失败,或同名目录归属无法确认已跳过——安装器绝不改动已有目录)。',
58
+ '[flow-comet] 修复: 先移走或处理现有 flow-kit/ 目录,或按上方手动获取指引补齐,再重跑本安装器。',
59
+ ].join('\n') + '\n';
60
+
61
+ let flowKitDegradedNoticeScheduled = false;
62
+
63
+ /** 挂一次结尾结论(重复调用幂等;退出阶段只能用同步写——console 在 exit 阶段不保证刷出) */
64
+ function scheduleFlowKitDegradedNotice() {
65
+ if (flowKitDegradedNoticeScheduled) return;
66
+ flowKitDegradedNoticeScheduled = true;
67
+ process.once('exit', () => {
68
+ try {
69
+ fs.writeSync(2, FLOW_KIT_DEGRADED_NOTICE);
70
+ } catch {
71
+ // 结尾提示是尽力而为:写不出去也不得改变退出码(exit 0 / 非破坏契约的底线)
72
+ }
73
+ });
37
74
  }
38
75
 
39
76
  /**
@@ -60,7 +97,8 @@ function flowKitOriginStatus(flowKitDir) {
60
97
  * 路径 2 已存在且 .git 存在且 origin 匹配上游 → 只读 rev-parse HEAD 并输出与锁定点差异影响,绝不改动;
61
98
  * 路径 3 已存在但不满足归属判定 → 摘要"非上游克隆,已跳过"+ 手动指引,不改动;
62
99
  * 路径 4 clone/checkout 任一失败 → 警告 + 手动获取指引,**不抛错**(D5——外网故障不得绑架安装器
63
- * 其余职责,进程照常 exit 0);各平台 purge 清单永不包含 flow-kit(D6,见 PLATFORMS 表头注释)。
100
+ * 其余职责,进程照常 exit 0);3、4 两条降级路径都在安装结尾补一句「未校验(模板缺失)」
101
+ * 的影响 / 原因 / 修复方法;各平台 purge 清单永不包含 flow-kit(D6,见 PLATFORMS 表头注释)。
64
102
  */
65
103
  export function ensureFlowKit(target) {
66
104
  const flowKitDir = path.join(target, 'flow-kit');
@@ -81,6 +119,7 @@ export function ensureFlowKit(target) {
81
119
  // 路径 4:clone/checkout 任一失败 → WARN + 手动指引,不抛错
82
120
  console.warn(`[flow-comet] 警告: flow-kit 自动获取失败(${gitErrorFirstLine(err)})`);
83
121
  printFlowKitManualGuide(target);
122
+ scheduleFlowKitDegradedNotice();
84
123
  }
85
124
  return;
86
125
  }
@@ -94,6 +133,7 @@ export function ensureFlowKit(target) {
94
133
  }
95
134
  console.log('[flow-comet] 目录存在但非上游克隆,已跳过');
96
135
  printFlowKitManualGuide(target);
136
+ scheduleFlowKitDegradedNotice();
97
137
  return;
98
138
  }
99
139
  // 路径 2:上游克隆 → 只读检测并输出差异影响(D4——绝不 fetch/checkout 改动用户克隆)