🧰 文件重命名或移动让链路出错时,用它来修复链路。
内部维护,不是安全阶段
repair 不是线性流程中的第六个阶段。它的任务是保持追踪的一致性。
# 不需要任何输入:它总是修复整条链路
/lagune-repair
工作原理
detect 的每个发现项都是一个追踪项,由 plan、harden 和 verify 依次沿用,每个阶段都会处理它,并按名称再次报告它。这个名称在每个产物中都以完全相同的写法作为章节标题,是它贯穿始终的身份标识。
追踪中唯一会变动的内容,是追踪项指向的文件路径。这些路径不保存在其他任何地方,所以重命名或移动文件只会让这一处的关联断开,绝不会出现两份互相矛盾的副本。出现这种情况时,repair 会修正映射(.lagune/tracking.json),让身份标识在重命名后依然有效。它会读取产物和追踪映射,只为查明重命名文件的新路径才读取你的源代码,并且从不编写安全内容。
在同一轮中,它还会对照模板检查每个记忆产物,报告出现偏差的地方,并为每处偏差指明负责修复的阶段。
提示
- 它既不改动你的代码,也不改动文字产物,只处理追踪。
- 你很少需要手动运行它。某个阶段发现链路不一致时,会替你运行 repair,然后继续。
- 它维护的追踪保存在
.lagune/tracking.json中,这是内部状态,不要手动编辑。
