创建 Flow

Flow 创作把真实存在的 Tool Version 组合成可检查的有向图。Flow 不是本地脚本列表， 也不从本地猜测工具 ID；所有节点和版本都必须来自 fkit 的响应。

设计约束

• 先加载本次所需的精确命令文档，定义 source/input、文件组和最终输出。
• 每个节点引用真实的 Tool Version ID；只在 Flow 节点上记录参数覆盖，不修改来源 Tool。
• 对每个精确节点版本导出 config 与 summary，检查端口方向、必需输入和参数定义。
• 草稿使用 --flow-spec。必须提供 method：purpose、每个 node 恰好一次的有序步骤及 rationale、 至少一个 official 或 literature 来源。步骤顺序必须符合连接边的拓扑顺序。
• Flow connections 必须由来源文档或官方流程方法支持，不能只按文件扩展名连接。
• authoring registry 保存节点、边、来源 Tool 快照/hash 和 method 证据。

流程与确认

Flow 不需要本地镜像 build：drafted 后执行静态端口、输入、参数、DAG 和 method 检查并进入 tested。发布确认后以文本模式调用 fkit flow create <FLOW_NAME> --file <PATH>，不要附加 --json。只接受精确成功行 Created flow '<name>', flowId=<id>, version=<正整数>；随后立即只读调用 fkit flow list --keyword <FLOW_NAME> --limit 100 --json，按返回行的 Flow ID 和版本号各精确匹配一次， 并要求匹配版本含非空 flowVersionId。不得只按名称选行或重试创建；任何缺失、重复或格式错误都视为 未验证失败。保存解析出的真实 Flow/Version ID。注册确认后，将预期 FlowSpec 传给 fkit flow inspect 做 read-back 比较。sourceGraph 必须提供足够的服务端 节点、Tool Version、连接端点、端口和参数覆盖信息；字段缺失或端点不完整时验证失败，不能用本地 spec 代替服务端证据。method 只作本地创作证据，不作为后端 Flow 字段发送。

Handoff

只有 discoverability 与 Flow inspect 都通过时才进入 verified 和 handed_off。 handoff 记录 kind: flow、真实 ID、keyword 与验证时间；执行车道下次按 keyword 动态查询并重新 inspect，不读取创作工作区的临时状态。