flow-comet 1.6.1 → 1.6.2

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.
@@ -98,7 +98,7 @@ flow-kit 9 阶段工作流的 workflow-kernel 实现。保留 flow-kit 的全部
98
98
  | 节点 | Implementation | Required Calls | Enforcement |
99
99
  |------|---------------|----------------|-------------|
100
100
  | open | flow-comet-open | flow-comet-change, flow-comet-requirement | guarded |
101
- | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (advisory,不要求声明) | guarded |
101
+ | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (guarded,仅前端适用——前端须先 skill-load 建标记 + record 载荷带 `required-skill:design.flow-comet-ui-design`;非前端不加载不声明;旧 change 渐进 WARN) | guarded |
102
102
  | plan | flow-comet-plan | flow-comet-task | guarded |
103
103
  | execute | flow-comet-execute | flow-comet-dev | guarded |
104
104
  | subagent-execute | flow-comet-subagent-execute | flow-comet-dev (handoff) | handoff-guarded |
@@ -117,7 +117,9 @@ node .claude/skills/flow-comet/scripts/workflow-state.mjs skill-load <node> <ski
117
117
 
118
118
  > **跑声明命令 ≠ 加载**:声明只把“哪次会话加载了哪个 skill、按哪份协议工作”写进状态供 exit/record 核对;真正加载只有第 1 步的 Skill 工具能做到。协议的引用示例:execute / subagent-execute 节点加载 flow-comet-dev 时用 `--prompt flow-kit/prompts/4-dev.md`(DEV 阶段协议),交付物按 `flow-kit/templates/SUMMARY.md` 模板填写并补写 `## 自检方法` 段。
119
119
 
120
- 节点退出(exit)与证据记录(record)会核对声明标记。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。advisory 条目(如 flow-comet-ui-design,仅前端触发)不要求 skill-load 声明——record 只校验执行者实际声明的条目。
120
+ 节点退出(exit)与证据记录(record)会核对声明标记。声明如实记录执行者动作——加载了哪个 skill、按哪份协议工作——**不等于产出证明**;产出是否正确由产物结构校验与门禁把关。**技能加载前置门**:新 change 的 required 条目不再自动补写——handoff request / record 前必须已有本节点声明标记(先加载、再声明、后干活);声明标记自动补写仅对旧 change 兜底(按协议 requiredSkillCalls 代记,标记带 `auto: true`),手动声明仍推荐(如实记录加载动作与协议文件)。`flow-comet-ui-design` 与协议同等级(`guarded`)且**仅前端适用**:前端 change 须先加载并 `skill-load` 声明、record 载荷带 `required-skill:design.flow-comet-ui-design`(出口不再自动补写);非前端不加载不声明(出口输出可见的 `UI-DESIGN: skipped(非前端)`);旧 change 渐进,缺件仅 WARN。前端判据是**结构级**的:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**。段内其它位置顺带提到「不适用」不算标注,仍判前端。
121
+
122
+ > **侧命令**:`evolve`(架构沉淀同步)/ `health`(健康巡检)/ `context-scan`(上下文重扫)三条横向命令**不进 8 节点流程**——不路由、不 entry/exit、不写节点证据,一律由用户显式调用;触发词、命令面与落盘产物见主 `SKILL.md` 的「侧命令」小节(单一来源,本文不复述其命令表)。
121
123
 
122
124
  ## Guardrails And Evidence
123
125
 
@@ -1 +1 @@
1
- 1.6.1
1
+ 1.6.2
@@ -73,6 +73,34 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
73
73
  | "跳过 entry 直接 exit,反正没检查" | 新 change 未 entry 直接 exit → BLOCKED(进入检查不可跳过);旧 change WARN 渐进 |
74
74
  | "SUMMARY 不写,任务先标 done" | 新 change done 任务缺 SUMMARY → BLOCKED(产物完整性强制);旧 change WARN 渐进 |
75
75
  | "subagent-execute 阶段,我直接改源码更快" | 协调者禁令:subagent-execute 阶段主会话禁止写源码(hook 白名单只允许 .specs/,Write/Edit 与 Bash 写命令均物理拦截),必须 worktree 委托子代理 |
76
+ | "用户要健康检查 / 同步架构,我给他 init 一个新 change" | 三条侧命令(evolve / health / context-scan)**不进 8 节点流程**——它们不路由、不 entry/exit、不写节点证据;按下方「侧命令」小节的命令面直接执行即可 |
77
+
78
+ ## 侧命令(横向命令 · 不进 8 节点流程)
79
+
80
+ 随包分发的三条**侧命令**不属于 8 节点流程:不参与节点路由,不被 `entry` / `exit` 门禁校验,也不会在流程里自动触发——一律由用户**显式调用**,涉及写入的动作要**人工逐项确认**。**上游对应物(只读基准,不修改)**:`flow-kit/prompts/{A-evolve,M-health,I-intel-scan}.md`——三条命令均已按本仓语义**显式覆盖**上游表述。**以下上游语义不采用**:① 把三条命令当作流程内的节点或自动触发项(上游各自成篇、不声明与 8 节点的关系)→ 本仓一律**显式调用**:不路由、不 `entry` / `exit`、不写节点证据;② 把三条命令的语义细则抄进入口册(同一口径两处表达)→ 本仓只在入口留**指针**,细则以各自技能册的「覆盖声明」为单一表达。**冲突处以各自技能册的「覆盖声明」与引擎实现为准**。用户表达下列意图时,**不要** `init` 新 change、**不要** `entry` / `exit` 任何节点,直接加载对应技能并按其协议执行:
81
+
82
+ | 命令 | 触发词(用户怎么说) | 用途 | 落盘产物 | 技能 |
83
+ |------|---------------------|------|---------|---------|
84
+ | `evolve` | 同步架构 / 整理沉淀 / evolve / 同步 CONTEXT | 扫归档 change 设计文档的架构沉淀段(`§9`)→ 候选清单 → **逐项** review 后 patch 项目级文档 | `.specs/evolve/<日期>-EVOLVE.md` | `flow-comet-evolve` |
85
+ | `health` | 健康检查 / health / 体检 / 技术债扫描 / 巡检 / 代码库健康度 | 确定性收集器出一份体检报告(代码体检工具在场时并入其 4 维结果并标注来源,缺席则显式降级声明) | `.specs/health/<日期>-HEALTH.md` | `flow-comet-health` |
86
+ | `context-scan` | 重扫上下文 / 刷新 CONTEXT / context-scan | 重跑上下文探测 → 与上次基线逐项比对(新增 / 消失 / 变更)→ 更新扫描时间 | `.specs/context-scan/<日期>-SCAN.md` | 无独立技能,按下方命令面直接执行 |
87
+
88
+ 命令面(路径随安装平台替换——见「Scripts」小节的平台化说明;`--root` 缺省为当前目录):
89
+
90
+ ```bash
91
+ node .claude/skills/flow-comet/scripts/evolve.mjs scan [--root <项目根>]
92
+ node .claude/skills/flow-comet/scripts/evolve.mjs apply <候选 id> [<候选 id> ...] [--root <项目根>] [--scanner <执行工具>]
93
+ node .claude/skills/flow-comet/scripts/health.mjs [--root <项目根>] [--stdout]
94
+ node .claude/skills/flow-comet/scripts/context-scan.mjs [--root <项目根>] [--stdout]
95
+ ```
96
+
97
+ **共同边界**:
98
+
99
+ - **只读优先**:任何写入都要显式参数或显式确认;侧命令不改业务代码,也不改 hook 判定语义。
100
+ - **不进 change 生命周期**:不写 `currentNode` / `completedNodes` / 节点证据,不替代任何节点产出。`evolve` 落 `last_evolve_at`、`context-scan` 落 `last_intel_scan`,两者都是**项目级元数据**,不是流程进展。
101
+ - **人工确认不可跳过**:`evolve` 的候选必须逐条 review 后才 `apply`,禁止一次性整批写入;`health` 只出报告与建议,是否立项由用户决定,它自己不开 change。
102
+ - **到期提示**:`node .claude/skills/flow-comet/scripts/workflow-state.mjs status` 在 `last_evolve_at` 距今 > 60 天,或该时刻之后新增 ≥ 5 个带 `§9` 的归档 change 时,输出一行 `EVOLVE-DUE:`(含上次沉淀时间与「建议显式调用 evolve」指引);未达阈值**零输出**(从未跑过 evolve、无该字段的项目同样不提示)。提示只是提醒——不自动加载也不自动执行 `evolve`,是否同步由用户决定。
103
+ - **时间纪律(侧命令的产物与判断同一口径)**:人可见时间戳一律**本地时间 + 显式偏移**(`YYYY-MM-DDTHH:mm:ss±HH:mm`;生成走 `time-utils.mjs` 单一权威,禁裸 `new Date()` 拼接);时间**比较一律 `Date.parse` 差值**(兼容历史 `Z` 形态,禁字符串字典序、禁目测字形);**判活与判时以文件 mtime 或 git 时间为准,`date` 与代理注册表不作基准**(归档窗口另取归档目录名的日期前缀)。这三条已写入**验证阶梯**的「环境 / 过程纪律」条,侧命令的报告、基线与到期判定都按它执行。
76
104
 
77
105
  ## Workflow Nodes
78
106
 
@@ -94,7 +122,7 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
94
122
  | 节点 | Implementation | Required Calls | Enforcement |
95
123
  |------|---------------|----------------|-------------|
96
124
  | open | flow-comet-open | flow-comet-change, flow-comet-requirement | guarded |
97
- | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (advisory,不要求声明) | guarded |
125
+ | design | flow-comet-design | flow-comet-design, flow-comet-ui-design (guarded,仅前端适用——前端须先 skill-load 声明) | guarded |
98
126
  | plan | flow-comet-plan | flow-comet-task | guarded |
99
127
  | execute | flow-comet-execute | flow-comet-dev | guarded |
100
128
  | subagent-execute | flow-comet-subagent-execute | flow-comet-dev (handoff) | handoff-guarded |
@@ -104,6 +132,8 @@ description: "Use when the user wants the flow-comet managed workflow for flow-k
104
132
 
105
133
  **新 change 严格模式**:`init` 创建的 change 标记为"新"(`newChange: true`)——新 change 下全部内容级检查强制 BLOCKED(处置标记/缓存证据/波次散文/越权委托/SUMMARY 完整性/进入证据等);旧 change(历史遗留,无标记)保持渐进 WARN。执行者可通过 `status` 确认当前 change 的新旧。
106
134
 
135
+ > **design 行绑定的前端适用性**:`flow-comet-ui-design` 与协议一致为 `guarded`,但只对**前端 change** 适用——前端项目须先用 Skill 工具加载该技能,再运行 `skill-load design flow-comet-ui-design --prompt flow-kit/prompts/2a-ui-design.md` 建标记,并在 record 载荷带 `required-skill:design.flow-comet-ui-design`(design 出口不再自动补写该条目,缺工件或缺声明即 BLOCKED 并给出恢复路径);非前端项目不加载、不声明,出口打印可见的 `UI-DESIGN: skipped(非前端)` 后放行;旧 change 保持渐进,缺件仅 WARN。前端判据是**结构级**的:`CHANGE.md` 的「视觉调性」段在场,且段内的「不适用」标记成**结构形态**——该标记**独立行**、居**行首**(可带列表符号 / 引用 / 加粗),或写在适用性类标签(`适用性` / `适用范围` / `是否前端` / `视觉调性` / `前端` / `界面` / `适用`)的**字段值位**;标记之后须成**词形边界**(紧跟空白、标点或行尾),命中即回显**命中片段**自证。段内其它位置顺带提到「不适用」(如「不适用于暗色主题」)不算标注,仍判前端。
136
+
107
137
  **节点技能两层加载模型(入口层 · 双步硬规则)**:路由到节点后,以下两步**都不可跳过**:
108
138
 
109
139
  1. **用 Skill 工具加载该节点的 Implementation 技能**(见下方 Skill Bindings 表 Implementation 列,如 execute → flow-comet-execute)。**不得跳过**——只读取 SKILL.md 文件不叫加载;真正让该 skill 的指令生效的是 Skill 工具把它注入本次会话。
@@ -77,7 +77,7 @@
77
77
  "skill": "flow-comet-ui-design",
78
78
  "operation": "require",
79
79
  "scope": "main",
80
- "enforcement": "advisory",
80
+ "enforcement": "guarded",
81
81
  "reason": "UI-DESIGN(仅前端)"
82
82
  }
83
83
  ],
@@ -3,9 +3,13 @@
3
3
  // 探测项目上下文状态 → 判决 A~F → 提示/静默;--init-context 全量生成 .specs/CONTEXT.md
4
4
  // 由 workflow-state.mjs init 分支调用;独立模块便于 guard-self-test 集成测试。
5
5
  // 文案为公开描述性中文(无未公开概念)。
6
+ //
7
+ // 本模块同时是「项目上下文」判定的单一来源:独立重扫命令 context-scan.mjs 复用同一组导出
8
+ // (探测 / 判决 / 结构校验 / 生成指引 / 结构提取),不复制第二份实现——同一判据两份实现必然分叉。
6
9
 
7
10
  import { promises as fs } from 'fs';
8
11
  import path from 'path';
12
+ import { EVOLVE_METADATA_SECTION, EVOLVE_METADATA_FIELDS } from './state-schema.mjs';
9
13
 
10
14
  // 既有 AI 上下文文档探测清单(与 flow-kit 入场判定同源:AGENTS/CLAUDE/Cursor/Windsurf/Copilot/Cline)
11
15
  const AI_DOC_CANDIDATES = [
@@ -166,6 +170,10 @@ async function contextSections(runRoot) {
166
170
  return derived ?? CONTEXT_SECTIONS_FALLBACK;
167
171
  }
168
172
 
173
+ // `## evolve 元数据` 第三字段的**旧别名**:并行协作期两条产出线各自定名时留下的双写容差,全库
174
+ // 无任何生产者,故已从通过判据移除(取值单形 = state-schema 的 EVOLVE_METADATA_FIELDS)。本常量
175
+ // 只用于**提示**:既有文档带该别名时,报错文案点名它并给出应写字段,让格式问题可见且可改写。
176
+ const EVOLVE_DEPRECATED_SUGGESTION_FIELD = '下次同步建议';
169
177
  // 模板关键格式检查(flow-kit/templates/CONTEXT.md 基准——段存在时校验其内格式,确定性检查)
170
178
  const CONTEXT_FORMAT_CHECKS = [
171
179
  {
@@ -193,6 +201,25 @@ const CONTEXT_FORMAT_CHECKS = [
193
201
  passes: (t) => t.includes('**last_intel_scan**') && t.includes('**scanner**') && t.includes('**下次重扫建议**'),
194
202
  hint: '模板字段 last_intel_scan / scanner / 下次重扫建议',
195
203
  },
204
+ {
205
+ // evolve 段是**可选段**:没跑过架构沉淀的项目不补段(缺席不报),跑过的项目段内三字段必须齐——
206
+ // 「跑过一次但字段写残」正是最需要拦的半成品(段在场却少字段,元数据双落点会静默失真)。
207
+ // 段名与三字段名都取自 state-schema.mjs 的单一常量集(写方 evolve.mjs 同源),本处不再写字面量。
208
+ name: EVOLVE_METADATA_SECTION + '三字段',
209
+ // 三字段判定**限定在段内**(sectionBody 切片):全文 includes 会被别处的同名字段蒙混过关——
210
+ // 例如 intel-scan 段有 `**scanner**` 而 evolve 段少这一个字段,全文判定照样放行。
211
+ applies: (t) => sectionBody(t, '## ' + EVOLVE_METADATA_SECTION) !== null,
212
+ // 通过判据是**单形**的:取值只认常量集(写方真实产出的三个字段名)。旧的协作期容差别名
213
+ // (`下次同步建议`)没有任何生产者,已从判据中移除——容纳它就是「校验集合 ⊃ 生产集合」,
214
+ // 写残的段会被静默放行。带旧别名的既有文档由下方 hint 给出可见的改写指引,不是静默失败。
215
+ passes: (t) => {
216
+ const segment = sectionBody(t, '## ' + EVOLVE_METADATA_SECTION) ?? '';
217
+ return EVOLVE_METADATA_FIELDS.every((field) => segment.includes('**' + field + '**'));
218
+ },
219
+ hint: '字段 ' + EVOLVE_METADATA_FIELDS.join(' / ') + ';与 intel-scan 段同构'
220
+ + '(旧别名「' + EVOLVE_DEPRECATED_SUGGESTION_FIELD + '」不再接受,请改写为「'
221
+ + EVOLVE_METADATA_FIELDS[2] + '」)',
222
+ },
196
223
  {
197
224
  name: '域语言表格表头',
198
225
  applies: (t) => t.includes('## 域语言'),
@@ -223,11 +250,14 @@ function normalizeSectionName(name) {
223
250
  // · 反引号围栏的信息串不得含反引号(否则是行内代码而非围栏)
224
251
  // · 闭栏须与开栏同字符、长度不短于开栏、其后仅余空白;不同字符的围栏互不闭合
225
252
  // · 围栏内的行(含 `## 标题`)一律不计入结构判定
226
- function stripFencedCodeBlocks(text) {
253
+ function stripFencedCodeBlocksMapped(text) {
254
+ const rawLines = String(text ?? '').split('\n');
227
255
  const kept = [];
256
+ const rawLineIndex = []; // 结构行 → 原文行号(写回元数据字段时据此精确定位,不另写一份围栏规则)
228
257
  let fenceChar = null;
229
258
  let fenceLength = 0;
230
- for (const line of String(text ?? '').split('\n')) {
259
+ for (let i = 0; i < rawLines.length; i++) {
260
+ const line = rawLines[i];
231
261
  const fence = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
232
262
  if (fenceChar === null) {
233
263
  if (fence && !(fence[1][0] === '`' && fence[2].includes('`'))) {
@@ -236,6 +266,7 @@ function stripFencedCodeBlocks(text) {
236
266
  continue;
237
267
  }
238
268
  kept.push(line);
269
+ rawLineIndex.push(i);
239
270
  continue;
240
271
  }
241
272
  if (
@@ -248,7 +279,11 @@ function stripFencedCodeBlocks(text) {
248
279
  fenceLength = 0;
249
280
  }
250
281
  }
251
- return kept.join('\n');
282
+ return { text: kept.join('\n'), rawLineIndex };
283
+ }
284
+
285
+ function stripFencedCodeBlocks(text) {
286
+ return stripFencedCodeBlocksMapped(text).text;
252
287
  }
253
288
 
254
289
  // 文档标题集合(ATX 标题行:行首 #~###### + 空白 + 标题文本;正文文本不参与)。
@@ -261,6 +296,30 @@ function headingSet(text) {
261
296
  return set;
262
297
  }
263
298
 
299
+ // 二级段标题在场判定 + 段体切片(与 headingSet 同一标题语法,但要求**恰好二级**)。
300
+ // 格式检查的「段在场」与「段内字段」都用它们:正文里提到段名(例如术语表的定义列写
301
+ // `## evolve 元数据`)不得算段在场——可选段的「缺席不报」语义完全依赖这一点;字段判定限定段内,
302
+ // 否则别处的同名标签会替缺失字段蒙混过关。必填段的同名检查沿用历史 includes 写法(缺段另有
303
+ // missingSections 兜底,报道面不变),故两条检查的在场判据措辞不同是刻意的,不是漏改。
304
+ function sectionBody(body, headingName) {
305
+ const wanted = normalizeSectionName(headingName);
306
+ const kept = [];
307
+ let inSection = false;
308
+ for (const line of String(body ?? '').split('\n')) {
309
+ const heading = /^(#{1,6})[ \t]+(.+?)[ \t]*$/.exec(line);
310
+ if (heading) {
311
+ const level = heading[1].length;
312
+ if (inSection && level <= 2) break; // 到下一个同级或更高级标题即段结束
313
+ if (!inSection && level === 2 && normalizeSectionName(heading[2]) === wanted) {
314
+ inSection = true;
315
+ continue;
316
+ }
317
+ }
318
+ if (inSection) kept.push(line);
319
+ }
320
+ return inSection ? kept.join('\n') : null;
321
+ }
322
+
264
323
  // 校验 .specs/CONTEXT.md 7 段结构 + 模板关键格式;文件缺失 = 全缺。返回
265
324
  // { missingSections, formatIssues, template }(missingSections 与 formatIssues 皆空 = 通过)。
266
325
  // 段存在判定 = **精确标题匹配**(标题名归一后相等):全文 includes 会把段名变体
@@ -286,6 +345,73 @@ export async function validateContext(runRoot) {
286
345
  return { missingSections, formatIssues, template: await probeTemplate(runRoot) };
287
346
  }
288
347
 
348
+ // 抽象索引段名(模板段名归一后的形态:`## 既有抽象索引(…)` → `既有抽象索引`)
349
+ const ABSTRACTION_SECTION = '既有抽象索引';
350
+ // 元数据段名特征:段名以「元数据」结尾(`intel-scan 元数据` / `evolve 元数据` 同构)
351
+ const METADATA_SECTION_SUFFIX = '元数据';
352
+ // 元数据字段条目形态:`- **字段**: 值`(值可带括号说明,替换时只换首个取值词元)
353
+ const METADATA_FIELD_LINE = /^\s*-\s*\*\*([^*]+)\*\*\s*[::]\s*(.*)$/;
354
+ // 表格分隔行(`|---|---|`)不是内容条目
355
+ const TABLE_SEPARATOR_LINE = /^\|[\s:|-]+\|$/;
356
+
357
+ // 抽象索引段内的一行是否算「条目」:忽略空行 / 引用块(说明性导语)/ 表格分隔行;
358
+ // 其余行原样收录(压缩行内空白)——条目的**取值**即快照比对对象,不做语义归一。
359
+ function abstractionItem(line) {
360
+ const text = String(line ?? '').trim();
361
+ if (text === '' || text.startsWith('>')) return null;
362
+ if (TABLE_SEPARATOR_LINE.test(text)) return null;
363
+ return text.replace(/\s+/g, ' ');
364
+ }
365
+
366
+ // CONTEXT 结构提取(独立重扫命令复用 · 与 validateContext 共用同一份结构知识):
367
+ // 围栏剥离 + 段名归一 + 标题判定都在本模块唯一表达——结构判定若在第二个模块重写,
368
+ // 两处对「哪一行算结构」的口径必然分叉(同一判据两份实现)。本函数只做**提取**,不做判决。
369
+ // 返回:
370
+ // · sections —— 归一后的段名清单(文档序,含非基准段;用于「段新增 / 段消失」比对)
371
+ // · abstractionIndex —— { '<子段名>': ['<条目行>', …] }(`## 既有抽象索引` 段内;未分组条目归 '(未分组)')
372
+ // · metadata —— { '<段名>': { '<字段>': { value, lineIndex } } }(段名以「元数据」结尾的段;
373
+ // lineIndex = 该字段行在**原文**中的行号,写回时据此精确替换,不重写整段)
374
+ export function extractContextStructure(text) {
375
+ const { text: body, rawLineIndex } = stripFencedCodeBlocksMapped(text);
376
+ const lines = body.split('\n');
377
+ const sections = [];
378
+ const abstractionIndex = {};
379
+ const metadata = {};
380
+ let section = null;
381
+ let group = '(未分组)';
382
+ for (let i = 0; i < lines.length; i++) {
383
+ const line = lines[i];
384
+ const heading = /^(#{1,6})[ \t]+(.+?)[ \t]*$/.exec(line);
385
+ if (heading) {
386
+ const name = normalizeSectionName(heading[2]);
387
+ if (heading[1].length === 2) {
388
+ section = name;
389
+ group = '(未分组)';
390
+ sections.push(name);
391
+ continue;
392
+ }
393
+ if (heading[1].length === 3 && section === ABSTRACTION_SECTION) {
394
+ group = name;
395
+ continue;
396
+ }
397
+ }
398
+ if (section === ABSTRACTION_SECTION) {
399
+ const item = abstractionItem(line);
400
+ if (item !== null) {
401
+ if (!abstractionIndex[group]) abstractionIndex[group] = [];
402
+ abstractionIndex[group].push(item);
403
+ }
404
+ continue;
405
+ }
406
+ if (section !== null && section.endsWith(METADATA_SECTION_SUFFIX)) {
407
+ if (!metadata[section]) metadata[section] = {};
408
+ const field = METADATA_FIELD_LINE.exec(line);
409
+ if (field) metadata[section][field[1].trim()] = { value: field[2].trim(), lineIndex: rawLineIndex[i] };
410
+ }
411
+ }
412
+ return { sections, abstractionIndex, metadata };
413
+ }
414
+
289
415
  // 生成指引(--init-context 时 CONTEXT 缺失或不满足模板时输出)——生成由 agent 全量阅读执行:
290
416
  // 读取既有文档(含既有 CONTEXT 的累积术语/决策)并整合(出处标注 `来自 <doc>:<line>`),
291
417
  // 探测代码技术栈/抽象索引,**对照 flow-kit/templates/CONTEXT.md 模板**产出 7 段;既有文档零写入。