工程闭环
哪些由生成器实现,
哪些仍由你负责?
让领域知识、技术绑定与手写集成各归其位。编译声明,检查将生成的变化,测试行为,再从实现追溯回来源。
每个阶段都有明确职责
知识改在真源树中。审阅业务预期,通过项目实际的审阅流程记录人工批准。
验证检查结构与受支持语义,往返检查内容保留。二者都不能代替业务测试。
将声明编译为产物并构建可查询图谱。不手改这些派生的知识表示。
使用项目的显式技术绑定,先检查生成计划,再写入受支持行为与结构代码。
外部效果与剩余计算留在独立的手写实现区,依据已约定结果测试。
编译并执行相应测试,验证来源锚点与输出新鲜度。发现漂移,先调查再更新。
输入过期与输出字节变化是两回事:status-project 分别报告输入和已有生成文件的状态;generate-project --update --plan 给出将要执行的更新动作,不是文本 diff。反查行号要从匹配源码的 UTF-8 span 换算,不猜固定文件/行号。
问清一段实现从哪里来
来源锚点连接知识声明与生成位置。有用的答案包含身份、精度与新鲜度,而不只是一个看起来合理的文件名。
证明联系,不证明正确
锚点支持「此位置来自此声明」的判断。它不证明声明已获批准,也不证明程序的每行代码都正确。
区间与文件不是同一个答案
span 指明字节区间;file 只定位文件。ambiguous 或 unavailable 表示边界,不是允许猜行号。
先核对匹配字节
从 UTF-8 字节区间换算行号前,先核源码指纹与验证结果。没有配对代码位置的图谱快照,不能提供精确的代码跳转。
Counter 反查指南使用实际验证过的位置走通正反查询,并解释输入过期、输出漂移与更新。canonical 图、项目知识图和工作坊导出是不同表示,不能凭同名拼接身份。
Explorer 代码视图消费固定且经核验的公开快照,不使用本机路径。银行数据集已通过配对项目来源/回锚验证(F-30),不继承本页的历史运行通过记录。
Counter 命令速查 · 先完成指南中的准备
node "$TRUTHSRC_CLI" generate-project --project truthsrc.project.json --out generated --plan --format human node "$TRUTHSRC_CLI" generate-project --project truthsrc.project.json --out generated --format human node "$TRUTHSRC_CLI" query-project --project truthsrc.project.json --out generated --knowledge SetCount --format human node "$TRUTHSRC_CLI" verify-project --project truthsrc.project.json --out generated --format human
在拥有这项职责的层修改
生成受支持的已声明行为,手写剩余计算与宿主集成。真源树是唯一的知识编辑面,并不是项目里唯一可以编辑的文件。
受支持的有限 fold 尚不提供可复用纯函数定义/引用或函数级 BDD;DEF-21 单独登记此项设计,不放宽确定性回放、类型或版本准入。
领域声明
聚合、命令、事件以及受支持的守卫、绑定、状态折叠声明共同驱动生成。结构还包括 schema、端口与测试脚手架。只命名不变量,不会自动实现缺失规则。
技术绑定
绑定把已声明模型接到选定的实现 profile 与宿主契约。它应与业务政策分别审阅;生成产物不是编辑同一份知识的第二入口。
银行构建通过 unmanagedSourceDirectories 引入独立手写模块。文件系统边界使它不受正常再生成覆盖;这不保证任意输出路径或其他工具都无法覆盖文件。
saga 与 Monarch 在哪登场
两个引擎,两种职责——用真源声明,绝不混淆:
跨聚合一致性
一个 saga 原子声明参与者(聚合)、阶段(Try / Confirm / Cancel)和补偿。它编译成 saga IR 交给 saga-core——一个 Akka Typed、事件溯源的 TCC 协调器。银行树声明了 2 个 saga:现金付款(投资人出金 → 归集入金 → 订单确认)和独立退款。
流程编排
一个 pipeline 原子是有序的业务步骤队列;步骤执行切片(R16)。它编译成计划交给 monarch-core——一个可恢复的阶段队列引擎,支持基于游标的续跑,由 monarch-persistence 做日志持久化。银行树声明了 4 条流水线(现金付款、TA 提交、定投派发、独立退款)。
把它们分清的规则:saga 拥有事务边界;流水线拥有流程顺序。二者不可互换,真源树拒绝含混。
当前技术结果与独立验收边界
先走最小实用闭环
Counter 用 Node 练习创建、生成、查询、修改作者文件、更新与验证。不把它当作银行运行或 JVM 服务验收;指南会分别说明后续各层前置。