flow-comet 1.6.4 → 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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +21 -3
- package/.flow-comet/skills/flow-comet/reference/artifact-template-overlay.md +154 -0
- package/.flow-comet/skills/flow-comet/reference/artifact-templates.json +387 -0
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +8 -2
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +22 -0
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +174 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +3 -1
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +28 -4
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +41 -18
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +16 -16
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +9 -7
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +17 -13
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +154 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +406 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +206 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +458 -60
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +38 -58
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +642 -230
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +85 -14
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +43 -5
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +15 -1
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +18 -1
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +60 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +73 -9
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +21 -1
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +9 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +212 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +15 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +20 -10
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +4 -1
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +13 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2125 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +6 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +74 -2
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-change/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-design/SKILL.md +15 -8
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +1 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +13 -10
- package/.flow-comet/skills/flow-comet-health/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +14 -4
- package/.flow-comet/skills/flow-comet-open/SKILL.md +11 -9
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +11 -7
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-review/SKILL.md +15 -9
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +13 -3
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +11 -8
- package/.flow-comet/skills/flow-comet-task/SKILL.md +1 -1
- package/.flow-comet/skills/flow-comet-test/SKILL.md +6 -2
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +12 -8
- package/README.md +3 -3
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/lib/installer-flowkit.mjs +43 -3
|
@@ -11,6 +11,7 @@ import { inspectWorkflowProtectedPath } from '../protocol-utils.mjs';
|
|
|
11
11
|
import { taskOpeningAttrs } from '../task-parsing.mjs';
|
|
12
12
|
import { resolveNextNode, normalizeHeading, FIX_SECTION_TITLE_FALLBACK } from '../route-node.mjs';
|
|
13
13
|
import { runRoot, fileExists, workflowRelativeSegments } from './guard-state-io.mjs';
|
|
14
|
+
import { SUMMARY_REQUIRED_SECTIONS, buildSkeleton } from './guard-artifact-skeleton.mjs';
|
|
14
15
|
|
|
15
16
|
// 新旧 change 区分——init 写入的 newChange: true = 新 change(严格,不依赖 entry——防系统性
|
|
16
17
|
// 跳 entry 绕过);缺失/非 true(旧 change)= 渐进 WARN 兼容。
|
|
@@ -18,12 +19,8 @@ export function isNewChange(state) {
|
|
|
18
19
|
return state.newChange === true;
|
|
19
20
|
}
|
|
20
21
|
|
|
21
|
-
// flow-kit SUMMARY 模板必填段(正则匹配,大小写不敏感 +
|
|
22
|
-
|
|
23
|
-
{ regex: /##\s*verify\s*输出/i, label: '## verify 输出' },
|
|
24
|
-
{ regex: /##\s*6\s*维自查/i, label: '## 6 维自查' },
|
|
25
|
-
{ regex: /##\s*(越界检查|边界检查)/i, label: '## 越界检查' },
|
|
26
|
-
];
|
|
22
|
+
// flow-kit SUMMARY 模板必填段(正则匹配,大小写不敏感 + 变体兼容)——清单唯一来源是骨架模块,
|
|
23
|
+
// 此处只取用(本模块不再自持第二份段名清单)。
|
|
27
24
|
|
|
28
25
|
// 校验 change 目录下每份 *-SUMMARY.md 含 SUMMARY 模板的三个必填段。用正则(大小写不敏感 +
|
|
29
26
|
// 变体兼容)——避免现有 SUMMARY 格式漂移导致误 BLOCKED。
|
|
@@ -303,68 +300,51 @@ export async function findSkillLoadsDir(root, changeName) {
|
|
|
303
300
|
return null;
|
|
304
301
|
}
|
|
305
302
|
|
|
306
|
-
//
|
|
307
|
-
//
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
//
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
.replace(/[((][^))\n]*[))]\s*$/u, '') // 去尾部括号内容:Why(为什么做)→ Why
|
|
324
|
-
.replace(/^\d+(?:\.\d+)?\.?\s*/u, '') // 去编号前缀:1. 决策清单 → 决策清单
|
|
325
|
-
.trim();
|
|
326
|
-
const escaped = escapeRegExp(body || name);
|
|
327
|
-
return new RegExp(
|
|
328
|
-
'^##\\s*(?:\\d+(?:\\.\\d+)?\\.?\\s*)?' + escaped + '\\s*(?:[((][^\\n))]*[))])?\\s*$',
|
|
329
|
-
'im',
|
|
330
|
-
);
|
|
331
|
-
}
|
|
332
|
-
|
|
333
|
-
// 读取模板全部段名生成模式列表(模块级缓存,避免每次 exit 重复读文件);pick 按关键词选段,找不到 → fallback
|
|
334
|
-
export async function templateSectionPatterns() {
|
|
335
|
-
if (templateSectionPatternsCacheRoot === runRoot && templateSectionPatternsCache) {
|
|
336
|
-
return templateSectionPatternsCache;
|
|
337
|
-
}
|
|
338
|
-
const templateDir = path.join(runRoot, 'flow-kit', 'templates');
|
|
303
|
+
// 段名校验基准从模板自动派生——骨架计算统一委托 lib/guard-artifact-skeleton.mjs(单一实现:读
|
|
304
|
+
// <runRoot>/flow-kit/templates/<DOC>.md + reference/artifact-templates.json,按 runRoot 缓存;段名
|
|
305
|
+
// 归一复用 route-node 的 normalizeHeading)。本模块只把骨架投影成既有消费方要的 { name, regex } 形态
|
|
306
|
+
// ——不自持模板读取,也不另写一份段名派生。模板整份缺失 → 该键的空数组(pick 据此跳过,见下)。
|
|
307
|
+
//
|
|
308
|
+
// 「模板缺席时的段名回退清单」唯一来源同样在骨架模块(段名清单单一来源):此处只转出既有导出面,不另存字面
|
|
309
|
+
// 清单——消费方(含 lib/guard-uidesign.mjs)的取用路径因此不变。
|
|
310
|
+
export { TEMPLATE_FALLBACK_SECTION_PATTERNS } from './guard-artifact-skeleton.mjs';
|
|
311
|
+
|
|
312
|
+
// 模板段名 → 宽松匹配正则:实现随段名归一移到骨架模块(单一出处),此处转出保持既有导出面。
|
|
313
|
+
export { headingPattern as templateSectionPattern } from './guard-artifact-skeleton.mjs';
|
|
314
|
+
|
|
315
|
+
// 读取模板全部段名生成模式列表:键形(change / requirement / design / summary)与 tpl[key] 的
|
|
316
|
+
// { name, regex } 数组形态、pick 的按关键词选段语义一律保持既有——只把数据源换成骨架模块(缓存与
|
|
317
|
+
// 模板读取归它一处负责,本模块不再自持 runRoot 键控的第二份缓存)。opts.runRoot 与骨架同一出入口
|
|
318
|
+
// (缺省用运行上下文根;场景可指向夹具根)。
|
|
319
|
+
export async function templateSectionPatterns(opts = {}) {
|
|
339
320
|
const result = { change: [], requirement: [], design: [], summary: [] };
|
|
340
|
-
for (const
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
design: 'DESIGN.md',
|
|
344
|
-
summary: 'SUMMARY.md',
|
|
345
|
-
})) {
|
|
346
|
-
const templateFile = path.join(templateDir, fileName);
|
|
347
|
-
if (await fileExists(templateFile)) {
|
|
348
|
-
try {
|
|
349
|
-
const text = await fs.readFile(templateFile, 'utf8');
|
|
350
|
-
for (const match of text.matchAll(/^##\s+(.+)$/gmu)) {
|
|
351
|
-
const sectionName = match[1].trim();
|
|
352
|
-
result[key].push({ name: sectionName, regex: templateSectionPattern(sectionName) });
|
|
353
|
-
}
|
|
354
|
-
} catch {}
|
|
355
|
-
}
|
|
321
|
+
for (const key of Object.keys(result)) {
|
|
322
|
+
const skeleton = await buildSkeleton(key, opts);
|
|
323
|
+
result[key] = skeleton.sections.map((section) => ({ name: section.name, regex: section.pattern }));
|
|
356
324
|
}
|
|
325
|
+
// 命名段选取:模板整份缺席(sections 为空)⇒ **跳过**,不回落段名兜底正则(C9:模板整份缺失时
|
|
326
|
+
// 模板派生判据全部跳过,fallback 只在「模板在场但某个具体段名缺失」时生效)。既有消费方里有闭包
|
|
327
|
+
// 外直接 `.test` 的调用点(「视觉调性」段读取),返回 null 会把「跳过」退化成 TypeError 崩溃——
|
|
328
|
+
// 未校验变成失败,同样不是 C9 的「跳过」,故返回可判别的跳过判据(见 TEMPLATE_SECTION_SKIP)。
|
|
357
329
|
result.pick = (key, keywords, fallback) => {
|
|
358
|
-
|
|
330
|
+
const sections = result[key] ?? [];
|
|
331
|
+
if (sections.length === 0) return TEMPLATE_SECTION_SKIP;
|
|
332
|
+
for (const section of sections) {
|
|
359
333
|
if (keywords.some((keyword) => section.name.includes(keyword))) return section.regex;
|
|
360
334
|
}
|
|
361
335
|
return fallback;
|
|
362
336
|
};
|
|
363
|
-
templateSectionPatternsCache = result;
|
|
364
|
-
templateSectionPatternsCacheRoot = runRoot;
|
|
365
337
|
return result;
|
|
366
338
|
}
|
|
367
339
|
|
|
340
|
+
// 「跳过」判据的唯一形态:`.test` 恒真(消费方形态即 `pattern.test(text)` ⇒ 该段检查不生效),
|
|
341
|
+
// `skip` 标记让调用方与场景能区分「跳过」与「判据通过」。整份模板缺席时的跳过可见性由产出物结构
|
|
342
|
+
// 门禁的「未校验(模板缺失)」行承担,pick 不再重复打印(同一事实两处措辞会先漂移)。
|
|
343
|
+
export const TEMPLATE_SECTION_SKIP = Object.freeze({
|
|
344
|
+
skip: true,
|
|
345
|
+
test: () => true,
|
|
346
|
+
});
|
|
347
|
+
|
|
368
348
|
// Fix 段标题从 <runRoot>/flow-kit/templates/TASK.md 派生(单一模板源 + 模块级缓存 + runRoot 键控):
|
|
369
349
|
// 扫描模板全部 H2,用 route-node 共享 heading 归一(单一权威,含闭合 ATX)识别 Fix 段标题;无匹配
|
|
370
350
|
// (模板缺失 / 读取失败 / 无 Fix 段)返回 undefined,由回程分类器的内置 fallback 常量兜底。标题只
|