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.
- 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/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 +180 -6
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +69 -18878
- package/.flow-comet/skills/flow-comet/scripts/health.mjs +29 -5
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1053 -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 +817 -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 +618 -0
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +154 -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-artifact-skeleton.mjs +406 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +756 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +1235 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +384 -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 +714 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +204 -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 +179 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +714 -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 +123 -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 +249 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1505 -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 +1248 -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 +2493 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +214 -2
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +72 -1123
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +976 -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 +1398 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1367 -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 +1492 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2125 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +1 -1
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +59 -7559
- package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +223 -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-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 +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 +159 -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
|
@@ -99,7 +99,7 @@ export async function inspectWorkflowPathSegments(
|
|
|
99
99
|
}
|
|
100
100
|
|
|
101
101
|
// 兼容既有消费方(readWorkflowProtectedFile / comet-hook-guard):受保护读取使用同一段
|
|
102
|
-
//
|
|
102
|
+
// 扫描权威;这里是委托而非第二份实现(单一权威)。
|
|
103
103
|
export async function inspectWorkflowProtectedPath(
|
|
104
104
|
projectRoot,
|
|
105
105
|
target,
|
|
@@ -326,7 +326,7 @@ export function validateProtocolSchema(protocol) {
|
|
|
326
326
|
if (!Array.isArray(protocol.nodes) || protocol.nodes.length === 0) {
|
|
327
327
|
throw new Error('workflow protocol nodes must be a non-empty array');
|
|
328
328
|
}
|
|
329
|
-
//
|
|
329
|
+
// nodes 元素结构校验——空对象/缺 id 的 node 会在
|
|
330
330
|
// determineNode 等消费方崩溃,校验层应 fail-closed 提前拦截
|
|
331
331
|
for (const node of protocol.nodes) {
|
|
332
332
|
if (!node || typeof node !== 'object' || Array.isArray(node)) {
|
|
@@ -341,6 +341,13 @@ export function validateProtocolSchema(protocol) {
|
|
|
341
341
|
if (node.requiredSkillCalls !== undefined && !Array.isArray(node.requiredSkillCalls)) {
|
|
342
342
|
throw new Error('workflow protocol node.requiredSkillCalls must be an array');
|
|
343
343
|
}
|
|
344
|
+
// 可选字段 templates(节点 → 产出物模板 basename 清单):缺省 = 该节点不声明模板。
|
|
345
|
+
// 只校验形态(非空字符串数组),集合语义由加载链按 C3/C12 判定——schema 不持有节点映射。
|
|
346
|
+
if (node.templates !== undefined
|
|
347
|
+
&& (!Array.isArray(node.templates)
|
|
348
|
+
|| node.templates.some((name) => typeof name !== 'string' || name.trim() === ''))) {
|
|
349
|
+
throw new Error('workflow protocol node.templates must be an array of non-empty strings');
|
|
350
|
+
}
|
|
344
351
|
}
|
|
345
352
|
if (Object.prototype.hasOwnProperty.call(protocol, 'writeWhitelist')) {
|
|
346
353
|
checkWriteWhitelistShape(protocol.writeWhitelist);
|
|
@@ -397,3 +404,208 @@ export const SKILL_PROTOCOL_FILES = {
|
|
|
397
404
|
'flow-comet-review': ['6-review.md'],
|
|
398
405
|
'flow-comet-integration': ['7-integration.md'],
|
|
399
406
|
};
|
|
407
|
+
|
|
408
|
+
// ---------- 产出物模板:节点级声明(加载链的单一语义来源) ----------
|
|
409
|
+
//
|
|
410
|
+
// 内置节点的产出物模板映射 = C3 的唯一权威表达处。required = 节点级必需模板;optional 表达「条件模板」
|
|
411
|
+
// (design 的 UI-DESIGN 仅前端 change 适用)。前端判定不在本模块:入口打印的条件行由 guard-uidesign
|
|
412
|
+
// 的 frontendCriterion 决定,避免在协议层写第二份前端判据。
|
|
413
|
+
//
|
|
414
|
+
// 与 reference/artifact-templates.json 的关系:登记表是「模板内容骨架」的权威(file / 段形 / 指纹),
|
|
415
|
+
// 本表只表达「哪个节点该声明哪些模板」(加载链面);两者用同一模板基名键相交。
|
|
416
|
+
export const NODE_ARTIFACT_TEMPLATES = {
|
|
417
|
+
open: { required: ['CHANGE', 'REQUIREMENT'] },
|
|
418
|
+
design: { required: ['DESIGN'], optional: ['UI-DESIGN'] },
|
|
419
|
+
plan: { required: ['TASK'] },
|
|
420
|
+
execute: { required: ['SUMMARY'] },
|
|
421
|
+
'subagent-execute': { required: ['SUMMARY'] },
|
|
422
|
+
review: { required: ['REVIEW', 'TEST'] },
|
|
423
|
+
verify: { required: [] },
|
|
424
|
+
archive: { required: [] },
|
|
425
|
+
};
|
|
426
|
+
|
|
427
|
+
// 模板文件根(指针行的相对根)——模板文件本身的绝对位置由登记表的 file 字段承载,这里只拼声明名。
|
|
428
|
+
export const TEMPLATE_ROOT = 'flow-kit/templates';
|
|
429
|
+
|
|
430
|
+
// 模板名归一:去空白与尾随 .md(声明允许 `DESIGN` / `DESIGN.md` 两种写法);大小写保留书写者原样,
|
|
431
|
+
// 比较一律走 templateKeyOf 的小写键(登记表键大写,手写声明常常小写)。
|
|
432
|
+
export function normalizeTemplateName(value) {
|
|
433
|
+
return String(value ?? '').trim().replace(/\.md$/i, '');
|
|
434
|
+
}
|
|
435
|
+
|
|
436
|
+
export function templateKeyOf(value) {
|
|
437
|
+
return normalizeTemplateName(value).toLowerCase();
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
// 逗号分隔的模板清单(`--templates CHANGE.md,REQUIREMENT.md`;单模板可省略逗号)→ 去重保序数组。
|
|
441
|
+
export function parseTemplateList(value) {
|
|
442
|
+
const names = [];
|
|
443
|
+
const seen = new Set();
|
|
444
|
+
for (const raw of String(value ?? '').split(',')) {
|
|
445
|
+
const name = normalizeTemplateName(raw);
|
|
446
|
+
if (name === '') continue;
|
|
447
|
+
const key = templateKeyOf(name);
|
|
448
|
+
if (seen.has(key)) continue;
|
|
449
|
+
seen.add(key);
|
|
450
|
+
names.push(name);
|
|
451
|
+
}
|
|
452
|
+
return names;
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
// --templates 原始参数收集:支持 `--templates a,b` 与 `--templates=a,b`,可重复出现(累加去重)。
|
|
456
|
+
// 后随参数是另一个选项(以 -- 开头)时不把它当成模板名(fail-closed 地当作「空清单」)。
|
|
457
|
+
// 返回 { provided, values }:provided 区分「未传该参数」与「传了空清单」——前者对内置节点是缺失声明。
|
|
458
|
+
export function findTemplatesArg(cliArgs) {
|
|
459
|
+
let provided = false;
|
|
460
|
+
const names = [];
|
|
461
|
+
const collect = (raw) => {
|
|
462
|
+
provided = true;
|
|
463
|
+
for (const name of parseTemplateList(raw)) {
|
|
464
|
+
if (!names.some((existing) => templateKeyOf(existing) === templateKeyOf(name))) names.push(name);
|
|
465
|
+
}
|
|
466
|
+
};
|
|
467
|
+
for (let index = 0; index < (cliArgs ?? []).length; index++) {
|
|
468
|
+
const arg = cliArgs[index];
|
|
469
|
+
if (arg === '--templates') {
|
|
470
|
+
const next = cliArgs[index + 1];
|
|
471
|
+
const hasValue = typeof next === 'string' && !next.startsWith('--');
|
|
472
|
+
collect(hasValue ? next : '');
|
|
473
|
+
if (hasValue) index += 1;
|
|
474
|
+
continue;
|
|
475
|
+
}
|
|
476
|
+
if (typeof arg === 'string' && arg.startsWith('--templates=')) {
|
|
477
|
+
collect(arg.slice('--templates='.length));
|
|
478
|
+
}
|
|
479
|
+
}
|
|
480
|
+
return { provided, values: names };
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
// 节点 → 模板声明。内置节点取引擎映射(协议副本删掉 node.templates 也不失效——内置节点不依赖协议
|
|
484
|
+
// 自称);自定义协议节点取协议里的 node.templates(ADR-002 特化层:未声明 = 零模板)。
|
|
485
|
+
export function nodeTemplateDeclaration(node) {
|
|
486
|
+
if (!node || typeof node !== 'object') return { source: 'none', required: [], optional: [] };
|
|
487
|
+
const builtin = NODE_ARTIFACT_TEMPLATES[node.id];
|
|
488
|
+
if (builtin) {
|
|
489
|
+
return { source: 'builtin', required: [...builtin.required], optional: [...(builtin.optional ?? [])] };
|
|
490
|
+
}
|
|
491
|
+
const declared = Array.isArray(node.templates)
|
|
492
|
+
? node.templates.filter((name) => typeof name === 'string' && name.trim() !== '').map(normalizeTemplateName)
|
|
493
|
+
: [];
|
|
494
|
+
return declared.length > 0
|
|
495
|
+
? { source: 'protocol', required: declared, optional: [] }
|
|
496
|
+
: { source: 'none', required: [], optional: [] };
|
|
497
|
+
}
|
|
498
|
+
|
|
499
|
+
// 声明集合比对(C11):required ⊆ declared ⊆ required ∪ optional。返回 { missing, extra }——两者
|
|
500
|
+
// 皆空即通过。extra 覆盖「多写」与「错名」(都不在允许集合里)。
|
|
501
|
+
export function templateDeclarationProblems(declaration, declared) {
|
|
502
|
+
const required = new Map(declaration.required.map((name) => [templateKeyOf(name), name]));
|
|
503
|
+
const allowed = new Set([
|
|
504
|
+
...required.keys(),
|
|
505
|
+
...(declaration.optional ?? []).map((name) => templateKeyOf(name)),
|
|
506
|
+
]);
|
|
507
|
+
const seen = new Map((declared ?? []).map((name) => [templateKeyOf(name), name]));
|
|
508
|
+
const missing = [...required].filter(([key]) => !seen.has(key)).map(([, name]) => name);
|
|
509
|
+
const extra = [...seen].filter(([key]) => !allowed.has(key)).map(([, name]) => name);
|
|
510
|
+
return { missing, extra };
|
|
511
|
+
}
|
|
512
|
+
|
|
513
|
+
// 声明清单 → 易读形态(报文用;空清单写「零模板」——比空字符串诚实)。
|
|
514
|
+
export function describeTemplateList(names) {
|
|
515
|
+
return Array.isArray(names) && names.length > 0 ? names.join('、') : '零模板';
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
// 模板基名 → 指针路径(`DESIGN` → `flow-kit/templates/DESIGN.md`)。
|
|
519
|
+
export function templatePointerPath(name) {
|
|
520
|
+
return TEMPLATE_ROOT + '/' + normalizeTemplateName(name) + '.md';
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
// 重新声明的命令指引(skill-load 校验失败与 record 声明核对两处共用):两处本说的是同一件事
|
|
524
|
+
// 「怎么重新声明」——各拼一份必然分叉(命令形态改一次要改两地方)。零模板节点不拼 --templates
|
|
525
|
+
// (省略即空集,与 C11 的「可省略」一致);无 skill 名的场景用 <skill> 占位。
|
|
526
|
+
// --prompt 一并拼上:模板与提示词是同一次声明的两面,而 skill-load 重跑会**覆写**同一标记——
|
|
527
|
+
// 只补 --templates 的指引会把 protocol 写成 null,下一次 exit 反被判「缺协议声明标记」(恢复步骤
|
|
528
|
+
// 自己弄坏协议声明)。路径取该节点的首个内置协议文件,与入口的 READ PROMPT 同源;自定义节点没有
|
|
529
|
+
// 内置映射(协议自己也声明提示词路径)→ 不拼,不编造路径也不打占位符。
|
|
530
|
+
export function templateDeclareCommand(declaration, { nodeId, skillName } = {}) {
|
|
531
|
+
const skill = typeof skillName === 'string' && skillName !== '' ? skillName : '<skill>';
|
|
532
|
+
const flag = declaration.required.length > 0
|
|
533
|
+
? ' --templates ' + declaration.required.map((name) => name + '.md').join(',')
|
|
534
|
+
: '';
|
|
535
|
+
const promptFile = (NODE_PROTOCOL_FILES[nodeId] ?? [])[0];
|
|
536
|
+
const promptFlag = typeof promptFile === 'string' ? ' --prompt ' + promptPointerPath(promptFile) : '';
|
|
537
|
+
return 'workflow-state.mjs skill-load ' + nodeId + ' ' + skill + flag + promptFlag;
|
|
538
|
+
}
|
|
539
|
+
|
|
540
|
+
// 指针行(入口与 explain 共用:同一判据一份实现,两处输出措辞一致)。
|
|
541
|
+
// label:内置入口用 `READ TEMPLATE`,现问通道用 `TEMPLATE`;conditional=true 时追出条件模板行。
|
|
542
|
+
export function templatePointerLines(declaration, options = {}) {
|
|
543
|
+
const label = typeof options.label === 'string' && options.label !== '' ? options.label : 'TEMPLATE';
|
|
544
|
+
const lines = declaration.required.map((name) => label + ': ' + templatePointerPath(name));
|
|
545
|
+
if (options.conditional === true) {
|
|
546
|
+
for (const name of declaration.optional ?? []) {
|
|
547
|
+
lines.push(label + '(条件模板): ' + templatePointerPath(name) + '(仅前端 change)');
|
|
548
|
+
}
|
|
549
|
+
}
|
|
550
|
+
return lines;
|
|
551
|
+
}
|
|
552
|
+
|
|
553
|
+
// ---------- 节点协议提示词:加载链的另一半 ----------
|
|
554
|
+
//
|
|
555
|
+
// 与模板并列的两条权威:提示词(flow-kit/prompts/)是**步骤权威**——这一步怎么做、交代什么;
|
|
556
|
+
// 模板(flow-kit/templates/)是**段形权威**——产出长什么样。两者都在 entry 打印、都由 skill-load
|
|
557
|
+
// 声明,缺一即未完成加载。
|
|
558
|
+
//
|
|
559
|
+
// 路径根与映射各只有一处:映射复用既有的 NODE_PROTOCOL_FILES(出口协议声明校验与 M5 自动补声明
|
|
560
|
+
// 共用),本段只提供指针形态与声明一致性判据,不复制映射表。
|
|
561
|
+
|
|
562
|
+
export const PROMPT_ROOT = 'flow-kit/prompts';
|
|
563
|
+
|
|
564
|
+
// 条件提示词(与条件模板同构):只对特定技能适用的协议文件——必读清单之外的协议面成员,参与声明
|
|
565
|
+
// 一致性判据;入口按前端判据追出(非前端不打印)。目前唯一的条件件是 design 节点的 UI-DESIGN 阶段:
|
|
566
|
+
// 前端 change 才加载 flow-comet-ui-design 并声明 `2a-ui-design.md`。
|
|
567
|
+
export const NODE_CONDITIONAL_PROMPTS = {
|
|
568
|
+
design: ['2a-ui-design.md'],
|
|
569
|
+
};
|
|
570
|
+
|
|
571
|
+
// 节点 → 上游协议提示文件(仅内置节点有 vendored 提示词)。自定义协议节点由 compose 只组合已装技能,
|
|
572
|
+
// 提示词路径仍由 skill-load --prompt 显式声明——不在协议里编造一份(与模板的 C12 语义同构)。
|
|
573
|
+
export function nodePromptFiles(node) {
|
|
574
|
+
if (!node || typeof node !== 'object') return [];
|
|
575
|
+
const files = NODE_PROTOCOL_FILES[node.id];
|
|
576
|
+
return Array.isArray(files) ? [...files] : [];
|
|
577
|
+
}
|
|
578
|
+
|
|
579
|
+
// 提示词文件 → 指针路径(`2-design.md` → `flow-kit/prompts/2-design.md`)。
|
|
580
|
+
export function promptPointerPath(file) {
|
|
581
|
+
return PROMPT_ROOT + '/' + file;
|
|
582
|
+
}
|
|
583
|
+
|
|
584
|
+
// 入口指针行:一行一个协议文件(open / review 这类多文件节点各一行)。零提示词节点返回空数组——
|
|
585
|
+
// 与零模板节点同语义(不打印,也不编造路径)。
|
|
586
|
+
// conditional=true 时追出条件提示词行(与 templatePointerLines 的条件行同形:同一前端判据、同一措辞
|
|
587
|
+
// 形态);非前端 change 上条件文件只是「不适用」,不是缺件,故不打印。
|
|
588
|
+
export function promptPointerLines(node, options = {}) {
|
|
589
|
+
const lines = nodePromptFiles(node).map((file) => 'READ PROMPT: ' + promptPointerPath(file));
|
|
590
|
+
if (options.conditional === true) {
|
|
591
|
+
for (const file of NODE_CONDITIONAL_PROMPTS[node?.id] ?? []) {
|
|
592
|
+
lines.push('READ PROMPT(条件提示词): ' + promptPointerPath(file) + '(仅前端 change)');
|
|
593
|
+
}
|
|
594
|
+
}
|
|
595
|
+
return lines;
|
|
596
|
+
}
|
|
597
|
+
|
|
598
|
+
// 声明一致性判据(入口侧):skill-load 声明的 --prompt 必须落在该节点的协议面内——
|
|
599
|
+
// 节点协议文件 ∪ 该节点的条件提示词。返回 null(通过)或 { declared, expected };expected 供报文
|
|
600
|
+
// 给出可照抄的路径。未声明(null / 空串)不在此判——缺失由出口「缺协议声明标记」门负责,
|
|
601
|
+
// 本判据只判「声明了但声明错」这一形态。
|
|
602
|
+
export function promptDeclarationConflict({ node, declaredProtocol } = {}) {
|
|
603
|
+
const nodeFiles = nodePromptFiles(node);
|
|
604
|
+
if (nodeFiles.length === 0) return null;
|
|
605
|
+
const declared = typeof declaredProtocol === 'string'
|
|
606
|
+
? (declaredProtocol.replaceAll('\\', '/').split('/').filter((part) => part !== '').pop() ?? '')
|
|
607
|
+
: '';
|
|
608
|
+
if (declared === '') return null;
|
|
609
|
+
const expected = [...nodeFiles, ...(NODE_CONDITIONAL_PROMPTS[node?.id] ?? [])];
|
|
610
|
+
return expected.includes(declared) ? null : { declared, expected };
|
|
611
|
+
}
|