用途:为 TanStack DB 的子系统编写独立的 oracle 测试。先明确"法则"——让其他人在不阅读生产代码的情况下也能预测观察结果,重点在于确定承诺了什么、对谁、在何种条件下、何时生效。
主要能力:使用可执行模型承载契约;借助 instrument library 处理实质性不确定;通过 Law discovery 分离既有契约、当前行为观察与拟议设计;用 Tension scan 处理义务冲突;用 Law restructuring 重组重叠或概念有误的法则;用 Mutant gap hunt 设计语义改动并分类存活变体,检测"绿色但可能接受错误实现"的 oracle。
使用方式:阅读 oracle 指南、术语表、覆盖图中相关 owner 与 limits,遵循 AGENTS.md 中的子系统阅读要求。修改既有模型时,先为区分用例写下旧预测与拟议预测,再做对抗性审查。构建可执行证据需包含合法历史、生产入口点、公共观察以及能拒绝合理错误设计的比较。改动仓库覆盖时同步更新 owner 与覆盖图。
适用场景:新 oracle 覆盖、法则设计请求、模型变更、覆盖范围调整。
限制:保持契约开放的自由度(调度、表示、实现选择)。反例可能指向生产、模型、历史语法、观察检查点或拟议法则,需先定位再修复;便利的编码或更强的断言不等于更好的契约表述。权威未定的提案可在草稿模型中探索,不得静默转为产品预期。资料未提供具体命令、代码示例与定价信息。