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
@@ -3,15 +3,16 @@
3
3
  //
4
4
  // 报告分层:
5
5
  // · 确定性层:文件 / 结构可判项——项目上下文段与格式、经验条目编号连续性、技术债表项数、
6
- // 可选工具在场判定、版本历史统计。每项都带计数与判据;同一冻结树两次运行逐字节一致。
6
+ // 可选工具在场判定、版本历史统计、架构文档结构(`.specs/ARCHITECTURE.md`,可选工件)。
7
+ // 每项都带计数与判据;同一冻结树两次运行逐字节一致。
7
8
  // · 增补层:代码体检工具(brooks-lint)在场时,由 agent 执行其 4 维体检并把结果并入同一份
8
9
  // 报告、标注来源;脚本不执行 agent 技能,缺省保留占位而不伪造结论。
9
10
  // · 降级声明:可选外部工具不在场时显式声明原因。判据只锚「确定性层完整 + 降级声明可见」——
10
11
  // 环境缺可选工具不构成失败(这些工具是可选项,不是依赖)。
11
12
  //
12
13
  // 只读边界:
13
- // · 读:.specs/CONTEXT.md、.specs/LESSONS.md、.specs/health/*.md(基线)、git 历史、
14
- // 可选工具的在场探测(文件 / 路径判定);
14
+ // · 读:.specs/CONTEXT.md、.specs/LESSONS.md、.specs/ARCHITECTURE.md(结构检查,可选)、
15
+ // .specs/health/*.md(基线)、git 历史、可选工具的在场探测(文件 / 路径判定);
15
16
  // · 写:仅一份报告 .specs/health/<日期>-HEALTH.md;`--stdout` 时把报告正文原样打到标准输出;
16
17
  // · 标准输出另**恒**输出 `HEALTH:` 审计行(报告路径 / 日期 / 增补层在场 / 基线)——不带
17
18
  // `--stdout` 时只有审计行(报告正文不回流);
@@ -38,7 +39,7 @@ import os from 'os';
38
39
  import path from 'path';
39
40
  import { fileURLToPath } from 'url';
40
41
  import { validateContext } from './context-init.mjs';
41
- import { parseSideCommandArgs, relativeLabel } from './evolve.mjs';
42
+ import { collectArchitectureStructure, parseSideCommandArgs, relativeLabel } from './evolve.mjs';
42
43
  import { archiveDateFromName, formatLocalDate, formatLocalTimestamp } from './time-utils.mjs';
43
44
 
44
45
  const SELF_FILE = fileURLToPath(import.meta.url);
@@ -418,7 +419,7 @@ function renderDebtSection(push, debt) {
418
419
  }
419
420
  push('- 判据:段内表格数据行计数(排除表头与分隔行);段边界 = 下一个同级或更高级标题,或分隔线');
420
421
  // 复现命令的段级与段终点都**按判据动态取**:段级 = 文档里真实命中的标题层级(判据的层级区间是
421
- // 二~四级);段终点 = 同级或更高级标题,或分隔线。此前用 `sed` 的单终点 `/^---/` 表达不了「同级或
422
+ // 二~四级);段终点 = 同级或更高级标题,或分隔线。单终点 `/^---/` 的写法表达不了「同级或
422
423
  // 更高级标题」——段以标题(而非分隔线)收尾时会把下一段的表格一并数进来,命令与判据各说一套。
423
424
  // 段缺席 = 没有可取的层级,退回该区间的上界。两种情况都给出能复现本次读数的命令。
424
425
  const bound = debt.exists ? String(debt.level) : '4';
@@ -468,6 +469,26 @@ function renderGitSection(push, git) {
468
469
  push('');
469
470
  }
470
471
 
472
+ // 确定性层 6:架构文档结构(C19 / AC-20③)——只读报告,不阻断:结构问题不影响退出码,也不写状态。
473
+ // 判据实现与 evolve 的「结构问题」段**同源**(evolve.mjs 的 collectArchitectureStructure):两处各写
474
+ // 一套段形比对必然分叉(同一判据两份实现的老账)。
475
+ function renderArchitectureSection(push, architecture, selfDisplay, options) {
476
+ push('### 6 · 架构文档结构(' + architecture.display + ' · 只读)', '');
477
+ push('- 文件:`' + architecture.display + '`(' + (architecture.exists ? '在场' : '缺失') + ')');
478
+ if (!architecture.exists) {
479
+ push('- 检查:跳过——' + architecture.note);
480
+ } else if (!architecture.checked) {
481
+ push('- 检查:未校验(' + architecture.note + ')');
482
+ } else {
483
+ push('- 结构问题(' + architecture.problems.length + '):' + (architecture.problems.length === 0 ? '无' : ''));
484
+ for (const problem of architecture.problems) push(' - ' + problem);
485
+ }
486
+ push('- 判据:' + (architecture.basis
487
+ ?? '8 个 H2 段 + §3 的 `### ADR-<数字>` 条目字段键(骨架来自 flow-kit/templates/ARCHITECTURE.md)')
488
+ + ';只读报告,不阻断、不写状态');
489
+ push('- 复现命令:`node ' + selfDisplay + ' --root ' + options.rootDisplay + ' --stdout`', '');
490
+ }
491
+
471
492
  function renderSupplementSection(push, brooks) {
472
493
  push('## 增补层(代码体检工具的 4 维结果 · 可选)', '');
473
494
  push('- **在场判定**:' + (brooks.present ? '在场' : '不在场——下列探测面逐项未命中(未安装 / 未加载)'));
@@ -555,6 +576,7 @@ function renderReport(input) {
555
576
  renderDebtSection(push, input.debt);
556
577
  renderRedundancySection(push, input.redundancy, input.options, input.selfDisplay);
557
578
  renderGitSection(push, input.git);
579
+ renderArchitectureSection(push, input.architecture, input.selfDisplay, input.options);
558
580
  renderSupplementSection(push, input.brooks);
559
581
  renderDegradationSection(push, input.redundancy, input.brooks);
560
582
  renderSnapshotSection(push, input.snapshot);
@@ -627,6 +649,7 @@ async function main(argv) {
627
649
  const context = await collectContext(options.root);
628
650
  const lessons = collectLessons(lessonsText);
629
651
  const debt = collectDebt(contextText);
652
+ const architecture = await collectArchitectureStructure(options.root);
630
653
  const redundancy = await collectRedundancy(options.root);
631
654
  const git = collectGit(options.root);
632
655
  const brooks = await collectBrooks(options.root);
@@ -642,6 +665,7 @@ async function main(argv) {
642
665
  context,
643
666
  lessons,
644
667
  debt,
668
+ architecture,
645
669
  redundancy,
646
670
  git,
647
671
  brooks,