flow-comet 1.6.3 → 1.6.4
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/scripts/comet-hook-guard.mjs +11 -13
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -18878
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
- package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
- package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
- package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
- package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
- package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
- package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
- package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -7559
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2476
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +5 -5
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +27 -2190
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
- package/README.md +52 -69
- package/package.json +3 -2
- package/scripts/dsh-bridge.mjs +2 -2
- package/scripts/lib/installer-cleanup.mjs +152 -0
- package/scripts/lib/installer-flowkit.mjs +119 -0
- package/scripts/lib/installer-hooks.mjs +363 -0
- package/scripts/lib/installer-loader.mjs +220 -0
- package/scripts/lib/installer-migrate.mjs +236 -0
- package/scripts/lib/installer-platforms.mjs +314 -0
- package/scripts/prepare-env.mjs +21 -1313
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
// 模板保真门禁(守卫模块):SUMMARY 模板保真(execute / subagent-execute 出口)、TASK 7 字段
|
|
2
|
+
// 完整性(plan 出口)、CHANGE/REQUIREMENT/DESIGN 模板保真(open / design 出口)。
|
|
3
|
+
//
|
|
4
|
+
// 判据骨架统一从 <runRoot>/flow-kit/templates/ 派生(模板缺失 → 内置骨架兜底,且不据此新增阻断);
|
|
5
|
+
// 段名归一委托 route-node 共享 heading 归一(单一权威)——不在本模块另写一份段名解析。
|
|
6
|
+
|
|
7
|
+
import { promises as fs } from 'fs';
|
|
8
|
+
import path from 'path';
|
|
9
|
+
import { EXECUTE_FAMILY_NODE_IDS, normalizeHeading } from '../route-node.mjs';
|
|
10
|
+
import { taskOpeningAttrs, taskBlocks as extractTaskBlocks } from '../task-parsing.mjs';
|
|
11
|
+
import { runRoot, fileExists } from './guard-state-io.mjs';
|
|
12
|
+
import { isNewChange, templateSectionPatterns } from './guard-routing.mjs';
|
|
13
|
+
import { TASK7_REQUIRED } from './task-graph.mjs';
|
|
14
|
+
|
|
15
|
+
// 段名归一化:委托 route-node 共享 heading 归一(单一权威)——去标题标记 / 尾部括号(如
|
|
16
|
+
// Why(为什么做)→ Why)/ 编号前缀(1. 决策清单 → 决策清单)/ 闭合 ATX,去首尾空白 + 小写。
|
|
17
|
+
function normalizeTemplateHeading(raw) {
|
|
18
|
+
return normalizeHeading(raw);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
// 提取文档全部 ^## 段(归一化后),供段序/缺段校验
|
|
22
|
+
function documentSectionHeadings(content) {
|
|
23
|
+
const out = [];
|
|
24
|
+
for (const m of String(content).matchAll(/^##\s+(.+)$/gmu)) {
|
|
25
|
+
out.push({ raw: m[1].trim(), norm: normalizeTemplateHeading(m[1]) });
|
|
26
|
+
}
|
|
27
|
+
return out;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
// 模板段序骨架:段名从 flow-kit/templates 派生(与段名校验同源,模板缺失 fallback 内置骨架)
|
|
31
|
+
const TEMPLATE_FIDELITY_FALLBACK_SKELETON = {
|
|
32
|
+
change: ['why', 'what', '视觉调性', '影响面', '范围排除', '验收线', '风险与未知'],
|
|
33
|
+
requirement: ['用户故事', '验收准则', '范围切分', '非功能性需求', '依赖与假设'],
|
|
34
|
+
design: ['技术栈选定', '既有架构对齐', '决策清单', '数据流', '关键状态机', 'adr 索引', '风险', '不在范围', '架构沉淀建议'],
|
|
35
|
+
// SUMMARY 模板缺失时的内置全骨架:十段(含条件段——条件段允许正文 N/A,但 H2 标题须在场)
|
|
36
|
+
summary: ['做了什么', '改动文件', 'verify 输出', '6 维自查', '数据库迁移', '越界检查', '破坏性变更', '决策与偏离', '是否触发新工作', '完成判定'],
|
|
37
|
+
};
|
|
38
|
+
|
|
39
|
+
async function templateSkeleton(key) {
|
|
40
|
+
const tpl = await templateSectionPatterns(); // 复用模板缓存(runRoot 内模板)
|
|
41
|
+
const src = tpl[key] ?? [];
|
|
42
|
+
if (src.length > 0) return src.map((s) => normalizeTemplateHeading(s.name));
|
|
43
|
+
return (TEMPLATE_FIDELITY_FALLBACK_SKELETON[key] ?? []).map((s) => normalizeTemplateHeading(s));
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// SUMMARY 全骨架来源:模板全部 H2 派生(derived=true);模板缺失/无 H2 → 内置十段兜底
|
|
47
|
+
// (derived=false——调用方据此保持渐进兼容,不新增硬阻断)
|
|
48
|
+
async function summaryTemplateSkeleton() {
|
|
49
|
+
const tpl = await templateSectionPatterns();
|
|
50
|
+
const derived = (tpl.summary ?? []).length > 0;
|
|
51
|
+
return { derived, sections: await templateSkeleton('summary') };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
// 段序校核(宽容):模板骨架段里「实际出现」的段须按模板先后出现;返回乱序描述(无则 null)
|
|
55
|
+
function templateOrderViolation(skeletons, headings) {
|
|
56
|
+
let last = -1;
|
|
57
|
+
for (const h of headings) {
|
|
58
|
+
const idx = skeletons.indexOf(h.norm);
|
|
59
|
+
if (idx === -1) continue;
|
|
60
|
+
if (idx < last) return h.raw;
|
|
61
|
+
last = idx;
|
|
62
|
+
}
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// M1 判据:SUMMARY 模板保真——标题 # SUMMARY: + 首部 4 字段 + 段序(含 flow-comet 增量 ## 自检方法)。
|
|
67
|
+
// 返回各维度缺口;调用方按新 BLOCK / 旧 WARN 渐进处置。
|
|
68
|
+
const SUMMARY_TEMPLATE_HEADER_FIELDS = [
|
|
69
|
+
{ label: 'Change ID', re: /\*\*\s*Change\s+ID\s*\*\*/i },
|
|
70
|
+
{ label: 'Task ID', re: /\*\*\s*Task\s+ID\s*\*\*/i },
|
|
71
|
+
{ label: '完成时间', re: /\*\*\s*完成时间\s*\*\*/ },
|
|
72
|
+
{ label: 'AI 角色', re: /\*\*\s*AI\s*角色\s*\*\*/ },
|
|
73
|
+
];
|
|
74
|
+
// 段序(含 flow-comet 增量段;越界检查在模板中位于 6 维自查 与 自检方法 之间)
|
|
75
|
+
const SUMMARY_ORDERED_SECTIONS = ['做了什么', '改动文件', 'verify 输出', '6 维自查', '越界检查', '自检方法']
|
|
76
|
+
.map(normalizeTemplateHeading);
|
|
77
|
+
|
|
78
|
+
function summaryTemplateFidelity(content) {
|
|
79
|
+
const text = String(content).replace(/\uFEFF/g, '');
|
|
80
|
+
const firstRealLine = (text.split('\n').find((l) => l.trim().length > 0) || '').trim();
|
|
81
|
+
const titleMissing = !/^#\s*summary\s*:/i.test(firstRealLine);
|
|
82
|
+
const headerRegion = text.split(/\n##\s/)[0];
|
|
83
|
+
const headerMissing = SUMMARY_TEMPLATE_HEADER_FIELDS
|
|
84
|
+
.filter((f) => !f.re.test(headerRegion))
|
|
85
|
+
.map((f) => f.label);
|
|
86
|
+
const headings = documentSectionHeadings(text);
|
|
87
|
+
const seen = new Set();
|
|
88
|
+
let last = -1;
|
|
89
|
+
let orderIssue = null;
|
|
90
|
+
for (const h of headings) {
|
|
91
|
+
const idx = SUMMARY_ORDERED_SECTIONS.indexOf(normalizeTemplateHeading(h.raw));
|
|
92
|
+
if (idx === -1) continue;
|
|
93
|
+
if (idx < last) { orderIssue = h.raw; break; }
|
|
94
|
+
last = idx;
|
|
95
|
+
seen.add(idx);
|
|
96
|
+
}
|
|
97
|
+
const missingSections = [];
|
|
98
|
+
for (let i = 0; i < SUMMARY_ORDERED_SECTIONS.length; i++) {
|
|
99
|
+
if (!seen.has(i)) missingSections.push(SUMMARY_ORDERED_SECTIONS[i]);
|
|
100
|
+
}
|
|
101
|
+
return { titleMissing, headerMissing, orderIssue, missingSections };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// 全骨架保真:骨架来自 SUMMARY 模板全部 H2;每段须存在(条件段内容可写 N/A,但须有 H2 标题),
|
|
105
|
+
// 实际出现的骨架段须按模板先后排列。## 自检方法 不进入骨架,单独校验:须位于 ## 越界检查 之后,
|
|
106
|
+
// 且只允许两种位置——紧随 ## 越界检查 之后(下一段即自检方法)或位于全文末尾(最后一个 H2)。
|
|
107
|
+
function summarySkeletonFidelity(content, skeleton) {
|
|
108
|
+
const text = String(content).replace(/\uFEFF/g, '');
|
|
109
|
+
const headings = documentSectionHeadings(text);
|
|
110
|
+
const seen = new Set();
|
|
111
|
+
for (const h of headings) {
|
|
112
|
+
const idx = skeleton.sections.indexOf(h.norm);
|
|
113
|
+
if (idx !== -1) seen.add(idx);
|
|
114
|
+
}
|
|
115
|
+
// 段序复用既有骨架校核(单一实现),段存在性单列——两者共用同一骨架
|
|
116
|
+
const orderIssue = templateOrderViolation(skeleton.sections, headings);
|
|
117
|
+
const missingSections = [];
|
|
118
|
+
for (let i = 0; i < skeleton.sections.length; i++) {
|
|
119
|
+
if (!seen.has(i)) missingSections.push(skeleton.sections[i]);
|
|
120
|
+
}
|
|
121
|
+
const selfHeading = normalizeTemplateHeading('自检方法');
|
|
122
|
+
const boundsHeading = normalizeTemplateHeading('越界检查');
|
|
123
|
+
const selfIdx = headings.findIndex((h) => h.norm === selfHeading);
|
|
124
|
+
const boundsIdx = headings.findIndex((h) => h.norm === boundsHeading);
|
|
125
|
+
let selfCheckIssue = null;
|
|
126
|
+
if (selfIdx === -1) {
|
|
127
|
+
selfCheckIssue = '缺 ## 自检方法 段(须位于 ## 越界检查 之后:文末或紧随越界检查两种合法位置)';
|
|
128
|
+
} else if (
|
|
129
|
+
boundsIdx === -1 ||
|
|
130
|
+
selfIdx < boundsIdx ||
|
|
131
|
+
(selfIdx !== headings.length - 1 && selfIdx !== boundsIdx + 1)
|
|
132
|
+
) {
|
|
133
|
+
selfCheckIssue = '## 自检方法 位置非法(须位于 ## 越界检查 之后:只允许文末或紧随越界检查两种位置)';
|
|
134
|
+
}
|
|
135
|
+
return { missingSections, orderIssue, selfCheckIssue };
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
// SUMMARY 模板保真出口门禁(execute / subagent-execute):每份 *-SUMMARY.md 校 ① 标题首行
|
|
139
|
+
// # SUMMARY: ② 首部 4 字段(Change ID/Task ID/完成时间/AI 角色)③ 段序(做了什么→改动文件→
|
|
140
|
+
// verify 输出→6 维自查→…→自检方法);宽容匹配(大小写/编号前缀/括号后缀)。④ 全骨架存在 +
|
|
141
|
+
// 模板序(骨架从 flow-kit/templates/SUMMARY.md 全部 H2 派生,条件段允许正文 N/A);## 自检方法
|
|
142
|
+
// 不在骨架内,单独要求且只允许「文末」「紧随越界检查」两种位置。新 change 任一缺失 → BLOCK
|
|
143
|
+
// (含缺失点 + 恢复指引);旧 change/归档批 → WARN 渐进;模板缺失(无权威骨架来源)→ 新规则只
|
|
144
|
+
// 告警不阻断,保持旧格式渐进。
|
|
145
|
+
export async function runSummaryTemplateFidelityGate({ node, state }) {
|
|
146
|
+
if (!EXECUTE_FAMILY_NODE_IDS.has(node.id)) return;
|
|
147
|
+
const summaryChangeDir = path.join(runRoot, '.specs', state.activeChange ?? '');
|
|
148
|
+
const summaryFiles = (await fs.readdir(summaryChangeDir).catch(() => [])).filter((f) => f.endsWith('-SUMMARY.md'));
|
|
149
|
+
const skeleton = await summaryTemplateSkeleton();
|
|
150
|
+
const hardIssues = [];
|
|
151
|
+
let skeletonGuidanceNeeded = false;
|
|
152
|
+
for (const f of summaryFiles) {
|
|
153
|
+
try {
|
|
154
|
+
const content = await fs.readFile(path.join(summaryChangeDir, f), 'utf8');
|
|
155
|
+
const fidelity = summaryTemplateFidelity(content);
|
|
156
|
+
const problems = [];
|
|
157
|
+
if (fidelity.titleMissing) {
|
|
158
|
+
problems.push('首行缺 `# SUMMARY: <Task>-<名>` 标题(大小写不敏感,标题可带括号说明后缀)');
|
|
159
|
+
}
|
|
160
|
+
if (fidelity.headerMissing.length > 0) {
|
|
161
|
+
problems.push('首部缺字段: ' + fidelity.headerMissing.join('、'));
|
|
162
|
+
}
|
|
163
|
+
if (fidelity.orderIssue) {
|
|
164
|
+
problems.push('段序乱(「' + fidelity.orderIssue.replace(/^##\s*/, '') +
|
|
165
|
+
'」偏离模板段序——应为 做了什么→改动文件→verify 输出→6 维自查→越界检查→自检方法)');
|
|
166
|
+
}
|
|
167
|
+
if (fidelity.missingSections.length > 0) {
|
|
168
|
+
problems.push('缺段: ' + fidelity.missingSections.join('、'));
|
|
169
|
+
}
|
|
170
|
+
if (problems.length > 0) {
|
|
171
|
+
if (isNewChange(state)) {
|
|
172
|
+
hardIssues.push(f + ' 模板保真校验失败: ' + problems.join('; '));
|
|
173
|
+
} else {
|
|
174
|
+
console.error('SUMMARY TEMPLATE WARN: ' + f + ' ' + problems.join('; ') +
|
|
175
|
+
'(旧 change/归档批渐进,不阻断;新 change 将强制)');
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
// ④ 全骨架保真:模板在场时新 change 缺段/乱序/自检位置非法 → BLOCK;
|
|
179
|
+
// 模板缺失时骨架来自内置兜底,不据此新增阻断(旧格式兼容)。
|
|
180
|
+
const skeletonFidelity = summarySkeletonFidelity(content, skeleton);
|
|
181
|
+
const skeletonProblems = [];
|
|
182
|
+
if (skeletonFidelity.missingSections.length > 0) {
|
|
183
|
+
skeletonProblems.push('缺段: ' + skeletonFidelity.missingSections.join('、'));
|
|
184
|
+
}
|
|
185
|
+
if (skeletonFidelity.orderIssue) {
|
|
186
|
+
skeletonProblems.push('段序乱(「' + skeletonFidelity.orderIssue.replace(/^##\s*/, '') +
|
|
187
|
+
'」偏离 flow-kit/templates/SUMMARY.md 的段序)');
|
|
188
|
+
}
|
|
189
|
+
if (skeletonFidelity.selfCheckIssue) {
|
|
190
|
+
skeletonProblems.push(skeletonFidelity.selfCheckIssue);
|
|
191
|
+
}
|
|
192
|
+
if (skeletonProblems.length > 0) {
|
|
193
|
+
if (isNewChange(state) && skeleton.derived) {
|
|
194
|
+
skeletonGuidanceNeeded = true;
|
|
195
|
+
hardIssues.push(f + ' SUMMARY 全骨架校验失败: ' + skeletonProblems.join('; '));
|
|
196
|
+
} else {
|
|
197
|
+
console.error('SUMMARY TEMPLATE WARN: ' + f + ' ' + skeletonProblems.join('; ') +
|
|
198
|
+
(skeleton.derived
|
|
199
|
+
? '(旧 change/归档批渐进,不阻断;新 change 将强制)'
|
|
200
|
+
: '(模板缺失,按内置骨架提示;不新增阻断)'));
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
} catch {}
|
|
204
|
+
}
|
|
205
|
+
if (hardIssues.length > 0) {
|
|
206
|
+
console.error('BLOCKED: SUMMARY 模板保真校验失败: ' + hardIssues.join('; '));
|
|
207
|
+
console.error('恢复: 对照 flow-kit/templates/SUMMARY.md 修正标题/首部/段序(含 flow-comet 增量 ## 自检方法 段)后重试 exit;新 change 强制模板保真');
|
|
208
|
+
if (skeletonGuidanceNeeded) {
|
|
209
|
+
console.error('恢复: 对照 flow-kit/templates/SUMMARY.md 补齐缺失段的 H2 标题(条件段内容可写 N/A)并按模板顺序排列;## 自检方法 只允许文末或紧随 ## 越界检查 之后两种位置');
|
|
210
|
+
}
|
|
211
|
+
process.exit(1);
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
// TASK 7 字段完整性门禁(plan 出口):每个 <task> 块须含
|
|
216
|
+
// name/read_files/write_files/action/verify/done/depends_on;缺任一 → 新 BLOCK / 旧 WARN。
|
|
217
|
+
// 开标签解析/整块提取沿用 task-parsing.mjs(属性序无关)。宽容:任务块采用旧式一字段形态
|
|
218
|
+
// (无 <name> 标记)的 TASK 视为旧格式 → 仅渐进 WARN(不误拦既有波次/路由回归载体);采用新
|
|
219
|
+
// 模板形态(含 <name>)则按 7 字段强校验。字段集从 `task-graph.mjs` 的单一权威常量取用(执行期
|
|
220
|
+
// `replan` 判据同源)——本模块不得再写一份字面集合,否则两侧会在规则演进时分叉。
|
|
221
|
+
export async function runTaskSevenFieldGate({ node, state }) {
|
|
222
|
+
if (node.id !== 'plan' || !state.activeChange) return;
|
|
223
|
+
const task7File = path.join(runRoot, '.specs', state.activeChange, 'TASK.md');
|
|
224
|
+
try {
|
|
225
|
+
const task7Blocks = extractTaskBlocks(await fs.readFile(task7File, 'utf8'));
|
|
226
|
+
const planNewFormat = task7Blocks.some((b) => /<name\b/i.test(b));
|
|
227
|
+
const broken = [];
|
|
228
|
+
for (const b of task7Blocks) {
|
|
229
|
+
const missing = TASK7_REQUIRED.filter((field) => !new RegExp('</?' + field + '\\b', 'i').test(b));
|
|
230
|
+
if (missing.length > 0) {
|
|
231
|
+
const idAttr = (taskOpeningAttrs(b) || {})?.id || '?';
|
|
232
|
+
broken.push((idAttr && idAttr !== '?' ? idAttr + ' ' : '') + '缺 ' + missing.join('/'));
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
if (broken.length > 0) {
|
|
236
|
+
if (planNewFormat) {
|
|
237
|
+
if (isNewChange(state)) {
|
|
238
|
+
// 文案的集合字符串**从判据常量派生**(不得在此再写一遍字面集合——第二处同口径表达会在
|
|
239
|
+
// 判据演进时静默落后于实现;构造方式不改变渲染结果)。
|
|
240
|
+
console.error('BLOCKED: TASK.md 任务缺 7 字段(' + TASK7_REQUIRED.join('/') + '): ' + broken.join('; '));
|
|
241
|
+
console.error('恢复: 对照 flow-kit/templates/TASK.md 补齐每个 <task> 的缺字段后重试 exit;新 change 强制任务块结构完整');
|
|
242
|
+
process.exit(1);
|
|
243
|
+
}
|
|
244
|
+
console.error('TASK-7FIELD WARN: TASK.md ' + broken.join('; ') + '(旧 change 渐进,不阻断;新 change 将强制补齐 7 字段)');
|
|
245
|
+
} else {
|
|
246
|
+
console.error('TASK-7FIELD WARN: TASK.md 任务为旧式一字段模板形态(' + broken.join('; ') +
|
|
247
|
+
')——建议按 flow-kit/templates/TASK.md 补全 7 字段(渐进不阻断)');
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
} catch {}
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
// 入口文档模板保真门禁(open / design 出口):标题与模板一致(# CHANGE: / # REQUIREMENT: /
|
|
254
|
+
// # DESIGN:,大小写不敏感、冒号可省)+ 段序按模板派生骨架宽容匹配(编号前缀/括号后缀兼容);
|
|
255
|
+
// 首部必要字段(Change ID)缺失 → 渐进 WARN。新 change 标题/段序失配 → BLOCK + 恢复指引;
|
|
256
|
+
// 旧 change/归档批 → WARN 渐进。
|
|
257
|
+
export async function runIntakeDocFidelityGate({ node, state }) {
|
|
258
|
+
if ((node.id !== 'open' && node.id !== 'design') || !state.activeChange) return;
|
|
259
|
+
const intakeDir = path.join(runRoot, '.specs', state.activeChange);
|
|
260
|
+
const skeletonsCache = {};
|
|
261
|
+
const hardProblems = [];
|
|
262
|
+
const softWarnings = [];
|
|
263
|
+
const checkIntakeDoc = async (file, key, label, titleRe) => {
|
|
264
|
+
const p = path.join(intakeDir, file);
|
|
265
|
+
if (!(await fileExists(p))) return; // 文件缺失由产物校验兜底
|
|
266
|
+
const text = await fs.readFile(p, 'utf8');
|
|
267
|
+
const firstLine = (text.replace(/\uFEFF/g, '').split('\n').find((l) => l.trim().length > 0) || '').trim();
|
|
268
|
+
if (!titleRe.test(firstLine)) {
|
|
269
|
+
hardProblems.push(file + ' 标题应以 # ' + label + ' 开头(如 `# ' + label + ': <标题>`,大小写不敏感、冒号可省)');
|
|
270
|
+
}
|
|
271
|
+
if (!skeletonsCache[key]) skeletonsCache[key] = await templateSkeleton(key);
|
|
272
|
+
const viol = templateOrderViolation(skeletonsCache[key], documentSectionHeadings(text));
|
|
273
|
+
if (viol) {
|
|
274
|
+
hardProblems.push(file + ' 段序乱(「' + String(viol).replace(/^##\s*/, '') + '」偏离 ' + label + ' 模板段序)');
|
|
275
|
+
}
|
|
276
|
+
const changeIdMissing = !/\*\*\s*Change\s+ID\s*\*\*/i.test(text.split(/\n##\s/)[0]);
|
|
277
|
+
const intakeMsg = file + ' 首部缺 Change ID 字段(' + label + ' 模板首部含 `- **Change ID**: <id>`)';
|
|
278
|
+
if (changeIdMissing) {
|
|
279
|
+
if (isNewChange(state)) hardProblems.push(intakeMsg);
|
|
280
|
+
else softWarnings.push(intakeMsg + '(渐进提示;新 change 将强制)');
|
|
281
|
+
}
|
|
282
|
+
};
|
|
283
|
+
if (node.id === 'open') {
|
|
284
|
+
await checkIntakeDoc('CHANGE.md', 'change', 'CHANGE', /^#\s*change\b/i);
|
|
285
|
+
await checkIntakeDoc('REQUIREMENT.md', 'requirement', 'REQUIREMENT', /^#\s*requirement\b/i);
|
|
286
|
+
} else {
|
|
287
|
+
// design:与既有校验一致的 target 选择(DESIGN.md 优先,DESIGN-lite 兜底)
|
|
288
|
+
const designFile = path.join(intakeDir, 'DESIGN.md');
|
|
289
|
+
const designLite = path.join(intakeDir, 'DESIGN-lite.md');
|
|
290
|
+
const chosen = (await fileExists(designFile)) ? 'DESIGN.md' : ((await fileExists(designLite)) ? 'DESIGN-lite.md' : null);
|
|
291
|
+
if (chosen) await checkIntakeDoc(chosen, 'design', 'DESIGN', /^#\s*design\b/i);
|
|
292
|
+
}
|
|
293
|
+
for (const w of softWarnings) console.error('INTAKE-DOC WARN: ' + w + '(渐进提示,不阻断;新 change 同)');
|
|
294
|
+
if (hardProblems.length > 0) {
|
|
295
|
+
if (isNewChange(state)) {
|
|
296
|
+
console.error('BLOCKED: 入口文档模板保真校验失败: ' + hardProblems.join('; '));
|
|
297
|
+
console.error('恢复: 对照 flow-kit/templates/{CHANGE,REQUIREMENT,DESIGN}.md 修正标题与段序后重试 exit;新 change 强制模板保真');
|
|
298
|
+
process.exit(1);
|
|
299
|
+
}
|
|
300
|
+
for (const h of hardProblems) console.error('INTAKE-DOC WARN: ' + h + '(旧 change/归档批渐进,不阻断;新 change 将强制)');
|
|
301
|
+
}
|
|
302
|
+
}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
// ui-design 适用性门控(前端判据 · 结构级,不做语义)。
|
|
2
|
+
//
|
|
3
|
+
// 协议 design 节点的 ui-design 绑定为 guarded,但它「仅前端」适用 ⇒ 出口自动补 required-skill
|
|
4
|
+
// 声明对该绑定失效(须真实 skill-load 声明),判据不成立(非前端)时按 advisory 处理并在出口输出
|
|
5
|
+
// 可见跳过行(不留假绿:跳过是显式记录,非静默省略)。
|
|
6
|
+
//
|
|
7
|
+
// 键控(enforcement 是这道门的单一表达处):门只在「协议登记了该绑定 ∧ enforcement === 'guarded'」
|
|
8
|
+
// 时存在——协议副本删掉绑定或把等级调回 advisory ⇒ 门不适用(留可见「门未启用」行,不静默消失),
|
|
9
|
+
// 相应路径逐字回到未登记绑定的原语义。门禁侧不持有第二份键表:登记表 APPLICABILITY_GATED_BINDINGS
|
|
10
|
+
// 按 `<nodeId>.<skill>` 键控,工件门与出口自动补写共用 applicabilityGatedBinding 查询。
|
|
11
|
+
//
|
|
12
|
+
// 判据必须结构性可判:CHANGE.md 的「视觉调性」段在场且段内不含**结构形态**的「不适用」标记 ⇒
|
|
13
|
+
// 前端;段缺席 / 段内以结构形态标注 ⇒ 非前端。段名基准从 flow-kit/templates/CHANGE.md 派生
|
|
14
|
+
// (与 open/design 出口的段名派生同源,模板缺失 → 内置骨架名),不做段名第二实现。
|
|
15
|
+
|
|
16
|
+
import { promises as fs } from 'fs';
|
|
17
|
+
import path from 'path';
|
|
18
|
+
import { runRoot, fileExists } from './guard-state-io.mjs';
|
|
19
|
+
import { isNewChange, templateSectionPatterns, TEMPLATE_FALLBACK_SECTION_PATTERNS } from './guard-routing.mjs';
|
|
20
|
+
|
|
21
|
+
export const UI_DESIGN_SKILL = 'flow-comet-ui-design';
|
|
22
|
+
const APPLICABILITY_GATED_BINDINGS = new Set(['design.' + UI_DESIGN_SKILL]);
|
|
23
|
+
const VISUAL_TONE_NOT_APPLICABLE = '不适用';
|
|
24
|
+
|
|
25
|
+
// 负向标记的结构约束(三种形态,共用同一词形边界)——裸子串会让「不适用于暗色主题」这类自然句子
|
|
26
|
+
// 关掉整道门(fail-open),故标记必须落在结构锚位且成词形边界:
|
|
27
|
+
// 形态 A 独立行:整行(去块引用 / 列表符 / 加粗)就是标记,可带括注理由与尾标点;
|
|
28
|
+
// 形态 B 行首:行以标记开头(如「不适用 —— CLI 工具,无用户可见界面。」);
|
|
29
|
+
// 形态 C 字段值位:`<适用性标签>: 不适用`——标签限本约定的短标签表(适用性 / 前端 / 视觉调性 …),
|
|
30
|
+
// 不通配任意字段名:`- 暗色主题:不适用` 这类「某子维度不适用」的字段不得关掉整道门。
|
|
31
|
+
// 词形边界 = 标记后为行尾 / 空白 / 标点 / 括注引号——「不适用于…」的「于」不是边界。
|
|
32
|
+
const TONE_MARKER_TAIL = String.raw`(?=$|[\s,。;、,;.::!!??…—()()【】「」『』“”"'])`;
|
|
33
|
+
const TONE_MARKER_LEAD = String.raw`^[>\s]*(?:[-*+]\s+)?(?:\*\*)?`;
|
|
34
|
+
const TONE_MARKER_FIELD_LABELS = '适用性|适用范围|是否前端|视觉调性|前端|界面|适用';
|
|
35
|
+
const TONE_MARKER_ALONE_LINE = new RegExp(TONE_MARKER_LEAD + VISUAL_TONE_NOT_APPLICABLE
|
|
36
|
+
+ String.raw`(?:\*\*)?(?:\s*[((][^))]*[))])?[。.;;,,]?\s*$`);
|
|
37
|
+
const TONE_MARKER_LINE_HEAD = new RegExp(TONE_MARKER_LEAD + VISUAL_TONE_NOT_APPLICABLE
|
|
38
|
+
+ String.raw`(?:\*\*)?` + TONE_MARKER_TAIL);
|
|
39
|
+
const TONE_MARKER_FIELD_VALUE = new RegExp(String.raw`(?:^|[\s|])(?:\*\*)?(?:`
|
|
40
|
+
+ TONE_MARKER_FIELD_LABELS + String.raw`)(?:\*\*)?\s*[::]\s*(?:\*\*)?`
|
|
41
|
+
+ VISUAL_TONE_NOT_APPLICABLE + String.raw`(?:\*\*)?` + TONE_MARKER_TAIL);
|
|
42
|
+
|
|
43
|
+
// 「视觉调性」段正文(段标题之后、下一个 H2 之前;段缺席 → null)
|
|
44
|
+
async function visualToneSectionBody(changeName) {
|
|
45
|
+
if (!changeName) return null;
|
|
46
|
+
let text;
|
|
47
|
+
try {
|
|
48
|
+
text = await fs.readFile(path.join(runRoot, '.specs', changeName, 'CHANGE.md'), 'utf8');
|
|
49
|
+
} catch {
|
|
50
|
+
return null;
|
|
51
|
+
}
|
|
52
|
+
const headingPattern = (await templateSectionPatterns())
|
|
53
|
+
.pick('change', ['视觉调性'], TEMPLATE_FALLBACK_SECTION_PATTERNS.changeVisualTone);
|
|
54
|
+
let body = null;
|
|
55
|
+
for (const line of String(text).replace(/\uFEFF/g, '').split(/\r?\n/)) {
|
|
56
|
+
if (/^##\s+/.test(line)) {
|
|
57
|
+
if (body !== null) break; // 到达下一个 H2 → 本段结束
|
|
58
|
+
if (headingPattern.test(line)) body = '';
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
if (body !== null) body += line + '\n';
|
|
62
|
+
}
|
|
63
|
+
return body;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// 段内负向标记命中(逐行判定——判据限段内):命中 → 返回命中行片段(去空白 + 超长截断),未命中
|
|
67
|
+
// → null。片段回显进出口的跳过行,跳过因此自证(不是「段内某处出现过什么字面」)。
|
|
68
|
+
function visualToneNotApplicableHit(body) {
|
|
69
|
+
for (const rawLine of String(body).split(/\r?\n/)) {
|
|
70
|
+
const line = rawLine.trim();
|
|
71
|
+
if (line === '') continue;
|
|
72
|
+
if (TONE_MARKER_ALONE_LINE.test(line)
|
|
73
|
+
|| TONE_MARKER_LINE_HEAD.test(line)
|
|
74
|
+
|| TONE_MARKER_FIELD_VALUE.test(line)) {
|
|
75
|
+
return line.length > 60 ? line.slice(0, 60) + '…' : line;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
return null;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
// 登记表查询(唯一键表,键形 `<nodeId>.<skill>`):该节点 + 技能是否受适用性门控
|
|
82
|
+
function isRegisteredApplicabilityBinding(node, skill) {
|
|
83
|
+
return APPLICABILITY_GATED_BINDINGS.has(node.id + '.' + skill);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
// 适用性门控绑定的单一查询:在场 ∧ enforcement === 'guarded' ∧ 登记在表 → 协议绑定;否则 null。
|
|
87
|
+
// 工件门、出口自动补写与缺声明恢复指引共用本查询——enforcement 是该门的单一表达处。
|
|
88
|
+
export function applicabilityGatedBinding(node, skill) {
|
|
89
|
+
if (!isRegisteredApplicabilityBinding(node, skill)) return null;
|
|
90
|
+
return (node.requiredSkillCalls ?? []).find((call) => call.skill === skill && call.enforcement === 'guarded') ?? null;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// 前端判据:{ applicable, reason }——applicable=true 表示本 change 判为前端项目
|
|
94
|
+
export async function frontendCriterion(changeName) {
|
|
95
|
+
const body = await visualToneSectionBody(changeName);
|
|
96
|
+
if (body === null) return { applicable: false, reason: '「视觉调性」段缺席(判非前端)' };
|
|
97
|
+
const hit = visualToneNotApplicableHit(body);
|
|
98
|
+
if (hit !== null) {
|
|
99
|
+
return { applicable: false, reason: '「视觉调性」段标注「不适用」(判非前端;命中片段: ' + hit + ')' };
|
|
100
|
+
}
|
|
101
|
+
return { applicable: true, reason: '「视觉调性」段在场且未标注「不适用」(判前端;无结构形态标记)' };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// design 出口 ui-design 工件门(按协议绑定键控:登记 ∧ 等级 = guarded ∧ 判据成立)——判据成立 ⇒
|
|
105
|
+
// 要求 UI-DESIGN.md 在场:新 change 缺件 BLOCKED + 恢复指引,旧 change WARN 渐进不阻断(不静默
|
|
106
|
+
// 放行);判据不成立(非前端)⇒ 可见跳过行(含命中片段)后照常放行;协议删掉该绑定或等级非
|
|
107
|
+
// guarded ⇒ 门未启用(同样可见输出),行为回到未登记绑定的原语义——闸门开关由协议表达。
|
|
108
|
+
export async function checkUiDesignArtifact(node, state) {
|
|
109
|
+
if (!state.activeChange || !isRegisteredApplicabilityBinding(node, UI_DESIGN_SKILL)) return;
|
|
110
|
+
if (!applicabilityGatedBinding(node, UI_DESIGN_SKILL)) {
|
|
111
|
+
const protocolState = (node.requiredSkillCalls ?? []).some((call) => call.skill === UI_DESIGN_SKILL)
|
|
112
|
+
? '协议 ' + node.id + ' 绑定等级 = advisory,非 guarded'
|
|
113
|
+
: '协议 ' + node.id + ' 节点未登记 ' + UI_DESIGN_SKILL + ' 绑定';
|
|
114
|
+
console.error('UI-DESIGN: 门未启用(' + protocolState + ')');
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
const frontend = await frontendCriterion(state.activeChange);
|
|
118
|
+
if (!frontend.applicable) {
|
|
119
|
+
console.error('UI-DESIGN: skipped(非前端)——' + frontend.reason + ',不要求 UI-DESIGN.md');
|
|
120
|
+
return;
|
|
121
|
+
}
|
|
122
|
+
const artifact = path.join(runRoot, '.specs', state.activeChange, 'UI-DESIGN.md');
|
|
123
|
+
if (await fileExists(artifact)) return;
|
|
124
|
+
const recovery = '补 .specs/' + state.activeChange + '/UI-DESIGN.md(加载 ' + UI_DESIGN_SKILL + ' 并按其协议产出 design token / 反 AI-slop 自检),'
|
|
125
|
+
+ '或在 .specs/' + state.activeChange + '/CHANGE.md 的「视觉调性」段以结构形态标注「不适用」(非前端项目)后重试 exit design';
|
|
126
|
+
if (isNewChange(state)) {
|
|
127
|
+
console.error('BLOCKED: design 出口缺 UI-DESIGN.md——' + frontend.reason + ',前端项目须产出 UI-DESIGN.md');
|
|
128
|
+
console.error('恢复: ' + recovery);
|
|
129
|
+
process.exit(1);
|
|
130
|
+
}
|
|
131
|
+
console.error('UI-DESIGN WARN: 缺 .specs/' + state.activeChange + '/UI-DESIGN.md——' + frontend.reason + '(旧 change 渐进不阻断;新 change 将强制)');
|
|
132
|
+
console.error('恢复: ' + recovery);
|
|
133
|
+
}
|