World's first open-source enterprise world model.
Rust agent-memorybitemporalgraphragknowledge-baseknowledge-graphllmontologypgvectorpostgresqlragrustself-hostedsemantic-searchtemporal-knowledge-graphworld-model
The reasoner's first job is finding contradictions, not deriving facts (#39)
WaylandYang05d70772000c
diff --git a/docs/decisions/0001-ontology-import-and-governance.md b/docs/decisions/0001-ontology-import-and-governance.mdindex ad945a24..232b4a53 100644--- a/docs/decisions/0001-ontology-import-and-governance.md+++ b/docs/decisions/0001-ontology-import-and-governance.md@@ -197,6 +197,30 @@ v2: http://acme.com/hr#Employee rdfs:label "Staff Member" → key = staff_membe**出路是换中间态**:延后到**表层谓词**而非延后到空——`(NVIDIA, "acquired", Mellanox)`,自由文本,可存,模型无需词表即可产出。第二遍带着完整句子和检索候选映射到本体关系,与类型消解同一套机器。domain/range 在这里作排序信号(主宾类型匹配的候选排名更高)。+三档处置与实体消解同源:高置信改写谓词(**必须追加而非原地改**——插入新行 + `supersedes`,与人工纠正同构,实体历史页直接可展示"先记成 related to,后精化成 builds");灰区进 Review;**没有像样候选就保持 `related_to`** 并把短语变成本体建议。最后一档是关键——**`related_to` 是诚实的含糊,猜错则是自信的错误**,而下游推理机会拿着错的具体关系去推导。++#### 但映射只是一半:更大的一半是撤掉逃生舱++> **修订记录**:本节原本只写"抽取产出表层谓词、再映射"。查证后发现**那只覆盖约一成**,得拆成两条腿。++实测(Industry Corpus):++```+ontology_misses 16 种谓词 / 38 次降级+related_to 事实 359 条+```++**只有约 38 条是降级来的,其余 321 条(89%)是模型自己挑的 `related_to`。** 因为它就在本体清单里,提示词把它当合法选项列了出去(`rel_pairs` 只过滤 `kind == "attribute"`)。模型读到说不清的关系时不会去造词,直接拿这个万能选项——**我们递了个逃生舱,它用了 321 次,而这个逃生舱销毁信息。**++(核对过其他来源:`mappings.rs` 写的是 `mapped_to` 不是 `related_to`;`record_miss` 在事实循环里每条一次,所以 38 是降级事实数的上界。)++所以两条腿:++1. **把 `related_to` 从提示词里撤掉**(保留在本体中当代码层兜底,但不列给模型)。这样模型要么用真关系、要么写出原文说法,**兜底发生在代码里而非模型脑子里,短语一定被记下**。改动就是 `rel_pairs` 加一个过滤,极便宜——但**必须先有 `surface_predicate` 列**,否则只是把信息从"变成 related_to"换成"变成 related_to 外加一次 miss 计数"。+2. **映射**(上文那套检索裁决)。++**存量修不回来**:现有 359 条没有 surface predicate,其中 321 条根本无原词可恢复。**只能靠重抽。** `Industry Corpus` 是基准语料,重抽是分内事;但这套逻辑若落到用户跑了半年的库上,必须明说"只对新抽取生效,存量要重建"。+**流水线已跑了三分之二**:`ontology_misses` 有活数据(`available_from ×9`、`scales_to ×5`、`runs_on ×4`、`collaborated_with ×4`),`extraction.rs:366-383` 已在接受词表外谓词并记录表层形式,缺的只有映射那一步。今天它只是给人看的报表,不是消解器的输入。**前置缺陷(需先修)**:降级有损——`f.predicate` 只进了 `record_miss` 的聚合,**事实上一字未留**,今天无法回答"哪些事实从 `available_from` 降级而来"。同"原文保真"原则:**先别扔,扔了不可逆**。@@ -235,6 +259,8 @@ v2: http://acme.com/hr#Employee rdfs:label "Staff Member" → key = staff_membe### P5 · 推理机(远期)+> **排期已由 [0002](0002-reasoning-engine.md) 取代**。本节列的"届时能消费什么"仍然成立,但顺序变了:0002 实测发现语料第一天就带 `part_of` 环(传递闭包在深度 5 起振荡不收敛),所以推理机的第一交付是**一致性检查**而非推导——同一套求值引擎反过来用,零风险,且现存 11 处矛盾立刻可查出。+`utopia-reason` 目前是 3 行空壳。它上线后能消费的,正是 P2 保留而未投影的那些公理:- `TransitiveProperty` → "NVIDIA 名下所有东西"(现在只能靠 hops 逐跳猜)diff --git a/docs/decisions/0002-reasoning-engine.md b/docs/decisions/0002-reasoning-engine.mdnew file mode 100644index 00000000..f3f844bc--- /dev/null+++ b/docs/decisions/0002-reasoning-engine.md@@ -0,0 +1,113 @@+# 0002 · 推理机++- **状态**:规划中 · `utopia-reason` 目前是 3 行占位+- **成文**:2026-08-28+- **相关**:[0001](0001-ontology-import-and-governance.md) 的 P5(该节保留原判断,本文取代其排期)++placeholder 里写着意图:*"Temporal Datalog interpreter for derived facts with explanations, plus the ontology axiom compiler."* 方向对。本文定的是**顺序**和**安全边界**。++---++## 核心判断:第一交付是一致性检查,不是推导++**推理机是缺陷放大器。** 在 `Industry Corpus`(28 篇公开新闻稿)上实测的底子:++| 指标 | 数值 | 含义 |+|---|---|---|+| `related_to` 占比 | **359 / 922 = 39%** | 近四成的边语义是空的(词表外谓词降级,见 0001 P3b) |+| `part_of` 事实 | 185 | 传递规则的第一个目标 |+| `part_of` 传递闭包 | 828(深度上限 10) | 4.5 倍膨胀,且**不收敛** |+| 闭包深度分布 | 1:185 2:181 3:141 4:45 5:52 6:40 7:52 8:40 9:52 10:40 | 深度 5 起振荡而非衰减 = **有环** |++环是真的,抽取错误造成:++```+Microsoft → FarmBeats for Students → Microsoft+FarmBeats for Students → National FFA Organization → FarmBeats for Students+```++「FarmBeats for Students 属于 Microsoft」是对的,反向那条是模型从"Microsoft 的 FarmBeats 项目"这类句式里抽反了。**语料第一天就带环**——环检测不是防御性编程,是开工前提。++在这个底子上开传递闭包,第一天就产出「Microsoft 属于 Microsoft」,而且**带证据链**——比没有更难收拾。++但同一套规则求值机器反过来用就是**一致性检查**:找环、找反对称违反、找 disjoint 违反。没有真值维护负担、没有爆炸风险、输出直接进现有的 `fact_conflicts` + Review UI。**先用检查把引擎建起来并把语料洗干净,再打开物化开关。**++现存可检出的矛盾(三个 KB 合计 11 处,全是真缺陷):`part_of` 双向环 2 处、任意谓词双向重复 9 对、自环 0(`extraction.rs:363` 已拦)。++---++## 三个架构前提++### 1. 派生事实没有证据位++`fact_evidence.chunk_id` 是 `NOT NULL`。派生事实没有分块——**它的证据是别的事实**。而 README 的承诺是 "Nothing enters the graph without evidence",所以这不是可选项。++```sql+CREATE TABLE fact_derivations (+ fact_id UUID NOT NULL REFERENCES facts(id) ON DELETE CASCADE,+ premise_fact_id UUID NOT NULL REFERENCES facts(id) ON DELETE CASCADE,+ rule_id UUID NOT NULL,+ seq SMALLINT NOT NULL,+ PRIMARY KEY (fact_id, premise_fact_id, seq)+);+```++这同时是 "with explanations" 的落点:**解释 = 前提集 + 规则**,递归展开成证明树,叶子才是真正的 chunk。`facts.derived_by_rule` 列在 `0004_graph.sql:71` 就留好了,至今零使用——它等的就是这个。++### 2. 派生事实绝不能闭合断言事实++`reconcile_new_fact`(`temporal.rs:49`)对 functional 谓词会自动闭合旧事实。派生事实若走同一条路,**一条错规则就能系统性闭掉人工断言的事实**——`part_of` 那个坑的十倍版,而且这次是自动化的。++硬性优先级 **asserted > derived**:++| 情形 | 处理 |+|---|---|+| 派生 vs 断言 | 派生**不落地**,记一条"规则与事实矛盾"信号 |+| 派生 vs 派生 | 规则集自相矛盾 → 进 Review,**不自动裁** |+| 断言 vs 断言 | 现有逻辑不变 |++这是 0001 判据 2「本体是引导不是执法」在推理层的同一条:**声明可能是错的,所以它不能驱动对既有数据的改写。**++### 3. 前提撤回时——双时态是最优解,不是负担++不能 UPDATE(append-only 是地基)。做法是置 `invalidated_at`,与拒绝一条事实**完全同构**。派生事实的记录轴上于是留下"我们曾据此推出,后来前提没了"。++真值维护在别的系统里是苦活(要么标记删除要么重算全量),在这个数据模型里是既有机制的自然延伸——**而且实体历史页面(PR #37)直接就能展示它**,不需要新 UI。++---++## 分步++### R0 · 一致性检查(不产生任何事实)++- 规则求值引擎:半朴素求值 + 环检测 + 深度上限+- 三类检查:**反对称违反**(`part_of` 双向)、**函数性违反**(漏网的)、**disjointWith 违反**(等 0001 P2 导入)+- 输出进 `fact_conflicts`,复用现有 Review UI,零新界面+- **立刻有货**:现存 11 处矛盾直接冒出来++价值在于:引擎的难点(规则表示、求值、终止)全部建成并验证,而风险面为零——它不写 `facts` 表。++### R1 · 物化推导(打开开关)++- `rules` 表 + `fact_derivations` 表+- 规则**只从本体公理编译**:`TransitiveProperty` / `SymmetricProperty` / `inverseOf` / `subPropertyOf`。不做用户自定义 DSL——那是另一个产品+- 优先级 asserted > derived,硬性+- 深度上限 + 环检测(实测必需)+- 派生事实在图上可视觉区分,且可整体过滤++### R2 · 解释++证明树 API + UI。展开到叶子(chunk)为止,中间节点是派生事实与规则。++### R3 · 增量维护++前提失效 → 派生失效。半朴素增量而非全量重算。放最后是因为前面三步都能靠"重算整个 KB"活着,而增量的正确性最难验。++---++## 开放问题++- **有效时间的交集语义**:前提 A `[2020,2023)`、前提 B `[2022,∞)` → 派生 `[2022,2023)`。属性事实的字面值宾语怎么参与?闭区间与开区间混合时的边界?+- **物化 vs 查询时求值的临界点**:实测 4.5 倍膨胀(185 → 828)。大语料上这个倍数会怎么变,什么规模该切换?+- **`related_to` 39% 是推理的前置障碍**:推理机面对的图有近四成的边语义是空的。这把 0001 P3b 的优先级顶了上来——**推理机的输入质量取决于它**。补充实测:359 条里只有约 38 条是词表外降级,**321 条是模型自己从提示词清单里挑的 `related_to`**——它就在本体里,被当合法选项列了出去。所以修法是两条腿:**先撤掉提示词里这个逃生舱**,再做映射。细节见 0001 P3b 的修订记录。+- **环该怎么处置**:检测出来只是第一步。自动拒绝哪一条?还是全部进 Review 让人判?倾向后者——两条都是模型抽的,没有先验理由信任其一。diff --git a/docs/decisions/README.md b/docs/decisions/README.mdindex eece36ad..bea0f6d9 100644--- a/docs/decisions/README.md+++ b/docs/decisions/README.md@@ -23,6 +23,7 @@| | 文档 | 状态 ||---|---|---|| 0001 | [本体导入与治理路线](0001-ontology-import-and-governance.md) | 进行中 · P0–P5 未开工 |+| 0002 | [推理机](0002-reasoning-engine.md) | 规划中 · 取代 0001 P5 的排期 |## 不放这里的东西