工程闭环

哪些由生成器实现,
哪些仍由你负责?

让领域知识、技术绑定与手写集成各归其位。编译声明,检查将生成的变化,测试行为,再从实现追溯回来源。

沿生命周期阅读 · 理解锚点精度 · 核对证据边界

01

每个阶段都有明确职责

01 · 编写先约定行为

知识改在真源树中。审阅业务预期,通过项目实际的审阅流程记录人工批准。

02 · 闸门验证真源

验证检查结构与受支持语义,往返检查内容保留。二者都不能代替业务测试。

03 · 编译派生产物与图谱

将声明编译为产物并构建可查询图谱。不手改这些派生的知识表示。

04 · 生成先预览,再写入

使用项目的显式技术绑定,先检查生成计划,再写入受支持行为与结构代码。

05 · 集成实现宿主职责

外部效果与剩余计算留在独立的手写实现区,依据已约定结果测试。

06 · 验证核对代码与出处

编译并执行相应测试,验证来源锚点与输出新鲜度。发现漂移,先调查再更新。

输入过期与输出字节变化是两回事:status-project 分别报告输入和已有生成文件的状态;generate-project --update --plan 给出将要执行的更新动作,不是文本 diff。反查行号要从匹配源码的 UTF-8 span 换算,不猜固定文件/行号。

银行生成证据记录 · 2026-11-11

验证 0 硬发现 F-01;157 个原子且往返逐字节一致 F-02;图谱 389 节点 / 413 边 F-03;235 个生成文件 F-04;0 编译错误 F-06;792 个已验证锚点 F-05。这些数字保留原采集日期;更新的服务验收单独陈述。

02

问清一段实现从哪里来

来源锚点连接知识声明与生成位置。有用的答案包含身份、精度与新鲜度,而不只是一个看起来合理的文件名。

出处

证明联系,不证明正确

锚点支持「此位置来自此声明」的判断。它不证明声明已获批准,也不证明程序的每行代码都正确。

精度

区间与文件不是同一个答案

span 指明字节区间;file 只定位文件。ambiguous 或 unavailable 表示边界,不是允许猜行号。

新鲜度

先核对匹配字节

从 UTF-8 字节区间换算行号前,先核源码指纹与验证结果。没有配对代码位置的图谱快照,不能提供精确的代码跳转。

Counter 反查指南使用实际验证过的位置走通正反查询,并解释输入过期、输出漂移与更新。canonical 图、项目知识图和工作坊导出是不同表示,不能凭同名拼接身份。

Explorer 代码视图消费固定且经核验的公开快照,不使用本机路径。银行数据集已通过配对项目来源/回锚验证(F-30),不继承本页的历史运行通过记录。

Counter 命令速查 · 先完成指南中的准备
在自己的 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
03

在拥有这项职责的层修改

生成受支持的已声明行为,手写剩余计算与宿主集成。真源树是唯一的知识编辑面,并不是项目里唯一可以编辑的文件。

受支持的有限 fold 尚不提供可复用纯函数定义/引用或函数级 BDD;DEF-21 单独登记此项设计,不放宽确定性回放、类型或版本准入。

真源与生成侧

领域声明

聚合、命令、事件以及受支持的守卫、绑定、状态折叠声明共同驱动生成。结构还包括 schema、端口与测试脚手架。只命名不变量,不会自动实现缺失规则。

显式输入

技术绑定

绑定把已声明模型接到选定的实现 profile 与宿主契约。它应与业务政策分别审阅;生成产物不是编辑同一份知识的第二入口。

手写实现区

宿主集成

mock TA 效果执行、JDBC 装配、恢复循环、读侧追赶与 HTTP 页面仍是显式实现。银行的 35 个手写文件记录为完整实现 F-08 · 2026-11-11。

银行构建通过 unmanagedSourceDirectories 引入独立手写模块。文件系统边界使它不受正常再生成覆盖;这不保证任意输出路径或其他工具都无法覆盖文件。

测试范围

树变了,生成文件被刷新;手写区不被覆盖。2026-11-11 的 23/23 是生成单元测试 F-07:手写生产源码随构建编译,不代表独立手写测试预期已验证。新技术候选的 actor 64 项、readside 47 项通过,保留固定业务预期;两组共享 23 项生成测试,不能相加当作互不重复用例 F-25。

04

saga 与 Monarch 在哪登场

两个引擎,两种职责——用真源声明,绝不混淆:

saga-core · TCC 事务

跨聚合一致性

一个 saga 原子声明参与者(聚合)、阶段(Try / Confirm / Cancel)和补偿。它编译成 saga IR 交给 saga-core——一个 Akka Typed、事件溯源的 TCC 协调器。银行树声明了 2 个 saga:现金付款(投资人出金 → 归集入金 → 订单确认)和独立退款。

monarch-core · 阶段队列

流程编排

一个 pipeline 原子是有序的业务步骤队列;步骤执行切片(R16)。它编译成计划交给 monarch-core——一个可恢复的阶段队列引擎,支持基于游标的续跑,由 monarch-persistence 做日志持久化。银行树声明了 4 条流水线(现金付款、TA 提交、定投派发、独立退款)。

把它们分清的规则:saga 拥有事务边界;流水线拥有流程顺序。二者不可互换,真源树拒绝含混。

05

当前技术结果与独立验收边界

新候选,不改写旧报告

2026-11-12,bank030-relocated-20261112-02 的 source / anchors / code / service 均通过并复核 F-24,包括真实数据库/HTTP 与自动浏览器观测 F-26。本轮新 SQL 重建 66.847 秒达到 readiness,未放宽 90 秒门限 F-27。范围是原生 Darwin x64 / JDK11、单 owner;输入未变,该 owner 的资源与租约已释放 F-28。详见脱敏范围与证据摘要。旧 P23/service02 失败保留为历史事实(DEF-06)。

仍须分别签收

独立服务体验仍未签收(DEF-07):session03 readiness 失败;清理占位不是通过,后续修补候选未执行。技术 HTTP/浏览器通过不关闭公开材料交付(DEF-15)或真人可用性(DEF-16)。家族观察(DEF-17)、retry/backoff/deadline 债务(DEF-18)、特定负控与额外 Node CI/typecheck(DEF-19)、旧离线包迁移(DEF-20)也不由银行 run 代签。

BDD/Gherkin 规格仍是未构建的衍生物(DEF-01)。正式工作坊验收还需要显式配对材料与分层环境前置;便捷生成路径不能代替。

06

先走最小实用闭环

Counter 用 Node 练习创建、生成、查询、修改作者文件、更新与验证。不把它当作银行运行或 JVM 服务验收;指南会分别说明后续各层前置。

下一步:亲手改一次。从动手指南开始。