Skip to content

Commit 66a88c5

Browse files
committed
fix(dream): 冲突账本处置留痕、取代链单向门与回执口径 (#650 评审)
评审 #650 时核出四类问题,逐条修在 enforce 档的处置路径上: 取代链是只进不出的单向门。supersededIds 原先只查 superseded_by 非空,继任者被归档后旧行仍被判为「已有新版本」,明明活着却永久从 注入里摘掉。改为 JOIN 继任者并要求 archived=0 且 forgotten=0,继任 者退场即自动恢复旧行可见性。 同一指向的取代链每轮重放都会被算成一次新变更。supersedeChain 现在 先读当前指向,已指向同一继任者直接返回 false,不刷新 superseded_at ——否则挂账时长被反复抹平,t3Chained 也会虚增。 dream 路径不跑分诊记账,却直接调 setConflictLedgerStatus。账本没有 该行时 UPDATE 命中 0 行,函数返回 false 而调用方全部丢弃返回值, 处置成功却零留痕。改为处置前先 saveConflictLedgerEntry,让后面的 状态推进落在真实存在的行上;T1 与 T3 四条成功分支都补齐。 回执口径割裂。sleep 侧 enforce 分支的返回体没有 applied,dream 侧 ledgerApplied 只进 noChange 不进 applied,于是库真被改动、回执仍报 0——与 #619 同族的「改了库读成 0」。两侧都按真实处置数计。 一并修的还有:dream 侧 triagePair 补传 dupMinSimilarity(与 sleep 侧判据一致,否则同一对在两侧可能落到不同 tier);配置注释与 docs/CONFIGURATION.md 去掉「T3/T4 在后续 PR」的过期说法;账本四态 注明 differentiated 与 zombied 是预留位、当前零写入路径。 测试:新增 4 条回归(取代链不是单向门 / 同一指向重放是 no-op / enforce 相位与整轮回执同口径 / dream 路径处置前落账本),全量 3359 tests、3358 pass、0 fail、1 skipped,check-sync 121 文件一致。 四条修复各做过一次反向变异验证,去掉修复即由对应用例捕获。
1 parent f09e169 commit 66a88c5

10 files changed

Lines changed: 189 additions & 20 deletions

File tree

‎dsh-mneme/docs/CONFIGURATION.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -269,7 +269,7 @@
269269
| `conflictFreezeMaxPending` | `100` | 冻结队列上限(≤1000) | — |
270270
| `conflictAutoResolveEnabled` | `false` | 相似度极高的**同 scope** 重复对自动裁决(保留新条、归档旧条),不进人工队列 | opt-in。会归档记忆,所以默认关;跨 scope 对永不自动(归属是用户的决定,#170)。用 supersede 而非 conflict:注记写在被归档侧,幸存记忆正文不动 |
271271
| `conflictAutoResolveMinSimilarity` | `0.95` | 自动裁决的相似度门槛(0.85–1) | 实测 live 库 345 条有相似度的历史行里 ≥0.95 只占 5.8%、≥0.94 占 8.1%——这一档减的是峰值,不是把队列清零。低于 0.85 就不是「重复」而是「相似」,不该自动归档任何一条 |
272-
| `conflictLedgerMode` | `off` | 冲突分诊账本档位(`off` / `shadow` / `enforce`) | beta(#641)。`shadow` = 每轮巩固对冲突候选对做确定性分诊(近重复/跨作用域/演进/真矛盾四档,判据见 `src/dream/triage.js`)并落 `conflict_ledger` 账本,**冻结/LLM 路径零变化**——先测一周真实分布再切档。`enforce` = 确定性处置:近重复对走信息量优先 supersede(败者归档、胜者正文不动),其余档只记账——不停车、不送 LLM、不归档,人审队列消失。与 `conflictFreezeEnabled` 同开时 freeze 让位(降级 + warn,#616 父子绑定不继承)。T3 取代链与 T4 检索时消解在后续 PR。不进 lightMode 强制关闭清单:shadow 只多一张 bookkeeping 表的写入,enforce 零 LLM 调用(同 `actionPipelineEnabled` 的定性) |
272+
| `conflictLedgerMode` | `off` | 冲突分诊账本档位(`off` / `shadow` / `enforce`) | beta(#641)。`shadow` = 每轮巩固对冲突候选对做确定性分诊(近重复/跨作用域/演进/真矛盾四档,判据见 `src/dream/triage.js`)并落 `conflict_ledger` 账本,**冻结/LLM 路径零变化**——先测一周真实分布再切档。`enforce` = 确定性处置:近重复对走信息量优先 supersede(败者归档、胜者正文不动),跨作用域重复与真矛盾只记账(不停车、不送 LLM、不动正文),时序演进落取代链(旧行 `superseded_by`/`superseded_at` 指向新行,两行都留着、正文都不动,检索侧降权),人审队列消失。与 `conflictFreezeEnabled` 同开时 freeze 让位(降级 + warn,#616 父子绑定不继承)。不进 lightMode 强制关闭清单:shadow 只多一张 bookkeeping 表的写入,enforce 零 LLM 调用(同 `actionPipelineEnabled` 的定性) |
273273
| `conflictLedgerDupMinSimilarity` | `0.9` | 分诊 T1(近重复)档的相似度下限(0.85–1) | 检测阈值(0.85)与自动档(0.95)之间的空带由它接管:真实库 788 对的相似度回声集中在 0.85–0.93,恰好是自动档开了也接不住的那段 |
274274

275275
## 实体

‎dsh-mneme/lib/config.js‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -606,11 +606,12 @@ export const Config = z.object({
606606
// freeze/LLM 路径零变化——beta 实验的测量期:shadow 一周拿真实分诊
607607
// 分布,验证是否复现 46/20/5/27。
608608
// "enforce" 确定性处置:T1(dup)走信息量优先 supersede(supersedeInfoFirstPair,
609-
// 败者归档、胜者正文不动、可追溯注记在被归档侧);T2/T3/T4 记账即
610-
// 处置——不停车、不送 LLM、不归档。人审队列与 LLM 裁决都不再消费
611-
// 冲突候选;与 conflictFreezeEnabled 同开时 freeze 让位(降级 shadow
612-
// + warn,#616 父子绑定不继承)。T3 的取代链与 T4 的检索时消解是
613-
// 后续 PR,enforce 先把人审摘出去。
609+
// 败者归档、胜者正文不动、可追溯注记在被归档侧);T2(跨作用域重复)
610+
// 与 T4(真矛盾)只记账——不停车、不送 LLM、不动正文;T3(时序演进)
611+
// 落取代链:旧行 superseded_by/superseded_at 指向新行,两行都留着、
612+
// 正文都不动,检索侧按降权处理。人审队列与 LLM 裁决都不再消费冲突
613+
// 候选;与 conflictFreezeEnabled 同开时 freeze 让位(降级 shadow
614+
// + warn,#616 父子绑定不继承)。
614615
//
615616
// 判据唯一实现在 src/dream/triage.js;处置共享实现在 decisions.js 的
616617
// supersedeInfoFirstPair。每个档位的行为都真实存在——#616 的「假成功」教训

‎dsh-mneme/lib/dream.js‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1545,7 +1545,13 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15451545
const b = snapshot.get(d.loser);
15461546
if (!a || !b) continue;
15471547
try {
1548-
const verdict = triagePair(a, b, pairSimilarity.get(similarityKey(d.winner, d.loser)));
1548+
// 判据必须与 sleep 侧同源(#650 评审):sleep enforce 传的是
1549+
// config.conflictLedgerDupMinSimilarity,这里不传就会退回 triage.js 的
1550+
// 死默认 0.9 —— 用户把阈值调高/调低后,同一对在两条路径上可能分到不同
1551+
// tier(一侧判 dup 去归档,另一侧判 conflict 只记账)。
1552+
const verdict = triagePair(a, b, pairSimilarity.get(similarityKey(d.winner, d.loser)), {
1553+
dupMinSimilarity: config.conflictLedgerDupMinSimilarity
1554+
});
15491555
if (verdict.tier === "dup") {
15501556
const res = supersedeInfoFirstPair({ a, b }, service, logger, config);
15511557
if (res.applied) {
@@ -1555,6 +1561,11 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15551561
// 本 helper 独立落地的,不在 applyList 里,必须显式补进维护清单
15561562
// (否则索引里留一行已归档记忆的向量,「清得掉才检索得到」失衡)。
15571563
ledgerVectorFixups.push({ action: "supersede", winner: res.winnerId, loser: res.loserId });
1564+
// 先落观察行再推进状态(#650 评审):dream 路径不像 sleep 那样先跑
1565+
// recordLedgerTriage,账本里可能根本没有这一对;此处若直接 UPDATE,
1566+
// 命中 0 行、changes=0 被静默丢弃,于是「处置成功」与「账本有记录」
1567+
// 长期背离。upsert 一次拿到确定的行,状态推进才有落点。
1568+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
15581569
service.setConflictLedgerStatus(a.id, b.id, "superseded");
15591570
try {
15601571
service.saveConflictReviewed?.({ run_id: runId, memory_a: a.id, memory_b: b.id, outcome: "supersede", judged_at: new Date().toISOString() });
@@ -1574,6 +1585,7 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15741585
try {
15751586
if (service.supersedeChain(older.id, newer.id)) {
15761587
t3Chained += 1;
1588+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
15771589
service.setConflictLedgerStatus(a.id, b.id, "superseded");
15781590
} else {
15791591
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
@@ -1846,7 +1858,10 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
18461858
return finish({
18471859
ok: okResult,
18481860
status,
1849-
applied,
1861+
// ledgerApplied 是 ledger enforce 档下 T1 supersede 的独立产出,不在 applyList
1862+
// 里(#650 评审)。只把它算进 noChange 会让 receipt 与 dream_runs.applied 仍
1863+
// 报 0:库真被改了,回执说没改——#619 同族假成功。计入 applied 才是唯一口径。
1864+
applied: applied + ledgerApplied,
18501865
decisions: auditDecisions,
18511866
outcome,
18521867
conflicts,

‎dsh-mneme/lib/dream/sleep.js‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -447,6 +447,9 @@ async function phaseConflicts(ctx, service, config, logger, runId, semantic = nu
447447
try {
448448
if (service.supersedeChain(older.id, newer.id)) {
449449
t3Chained += 1;
450+
// 先落观察行再推进状态(#650 评审):enforce 档下 recordLedgerTriage 只会
451+
// 把这一对写成 open,UPDATE 于此才有行可命中;顺序反了就是静默落空。
452+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: p.a.id, memory_b: p.b.id, tier: verdict.tier, similarity: p.similarity, signals: verdict.signals });
450453
service.setConflictLedgerStatus(p.a.id, p.b.id, "superseded");
451454
}
452455
} catch (error) {
@@ -467,7 +470,9 @@ async function phaseConflicts(ctx, service, config, logger, runId, semantic = nu
467470
t1VectorFixups.push({ action: "supersede", winner: res.winnerId, loser: res.loserId });
468471
try {
469472
// 账本状态推进 + 机器台账照记(与自动档同款 outcome 口径)——自动处置
470-
// 也要能事后回答「这一对什么时候、被谁判的」。
473+
// 也要能事后回答「这一对什么时候、被谁判的」。先落观察行(#650 评审):
474+
// 这一对未必已在账本里,直接 UPDATE 会命中 0 行而静默失记。
475+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: p.a.id, memory_b: p.b.id, tier: verdict.tier, similarity: p.similarity, signals: verdict.signals });
471476
service.setConflictLedgerStatus(p.a.id, p.b.id, "superseded");
472477
service.saveConflictReviewed?.({ run_id: runId, memory_a: p.a.id, memory_b: p.b.id, outcome: "supersede", judged_at: new Date().toISOString() });
473478
} catch (error) {
@@ -498,6 +503,10 @@ async function phaseConflicts(ctx, service, config, logger, runId, semantic = nu
498503
pairs: selected.length,
499504
batches: 0,
500505
ledgerSkipped,
506+
// applied 是整轮回执的唯一写库口径(runSleep 的 totalApplied 只认这个键)。
507+
// 缺了它,本档真实发生的 T1 归档与 T3 落链在 receipt / dream_runs.applied
508+
// 里全是 0 ——「本相位说改了、整轮说没改」(#650 评审,#619 同族)。
509+
applied: t1Resolved + t3Chained,
501510
enforced: { t1Resolved, t1Failed, t3Chained },
502511
...(ledgerTriage ? { ledgerTriage } : {})
503512
};

‎dsh-mneme/lib/store.js‎

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4083,6 +4083,9 @@ export function createStore(path) {
40834083

40844084
// --- conflict triage ledger(issue #641,shadow 档)-----------------------
40854085

4086+
// 四态里 superseded(已被取代)与 open 有写入点;differentiated(人审判为不同事、
4087+
// 不必再问)与 zombied(两条都已退场、无从消解)是预留位,当前没有任何代码路径
4088+
// 会写它们——留着是为了状态机与面板筛选口径完整,别当成「已实现但没数据」。
40864089
const LEDGER_STATUSES = new Set(["open", "superseded", "differentiated", "zombied"]);
40874090
const LEDGER_TIERS = new Set(["dup", "cross-scope-dup", "evolution", "conflict"]);
40884091

@@ -4135,8 +4138,17 @@ export function createStore(path) {
41354138
* 可同步;bump updated_at 反而会误导「已审过」的宽松代理判定)。已归档/
41364139
* 已遗忘的行不落链(它们已经退场,再标注是给幽灵记账);重复写同一指向
41374140
* 是无害的幂等 no-op,换指向以最后一次为准。
4141+
*
4142+
* 幂等守卫(#650 评审):上面那句「无害的 no-op」只对指向成立——superseded_at
4143+
* 每次都会刷成新的 nowIso(),返回值又按 changes > 0 判,于是同一对每轮都报
4144+
* 「刚处理过」:t3Chained 虚增,取代时刻被改写成最近一次巩固的时间(挂账时长
4145+
* 一类指标随之失真)。先读当前指向,已指向同一 winner 就直接返回 false 且不
4146+
* 写库,只有首次落链或换指向才真正落笔。
41384147
*/
41394148
function supersedeChain(loserId, winnerId) {
4149+
const current = db.prepare("SELECT superseded_by FROM memories WHERE id = ?").get(loserId);
4150+
// 行不存在 / 已指向同一继任者:no-op,不刷时间戳、不计入变更数。
4151+
if (!current || current.superseded_by === winnerId) return false;
41404152
const res = db.prepare(
41414153
"UPDATE memories SET superseded_by = ?, superseded_at = ? WHERE id = ? AND archived = 0 AND forgotten = 0"
41424154
).run(winnerId, nowIso(), loserId);
@@ -4146,9 +4158,22 @@ export function createStore(path) {
41464158
/**
41474159
* 已被取代行的 id 清单(issue #641,T3 检索侧降权用)。走部分索引,未落链
41484160
* 的库上是空查询。返回数组而非 Set——集合语义由调用方决定。
4161+
*
4162+
* 只认「继任者仍活着」的旧行(#650 评审):链是一次性写下的指向,而继任者
4163+
* 之后仍可能被归档/遗忘/删除。若只判 superseded_by IS NOT NULL,那种情况下
4164+
* 旧行会被当成「已有新版本」从注入里摘掉,可它自己明明是活的、且它指向的
4165+
* 那条已经退场——数据在库里却永远不再出现,是一种沉默的不可逆失效。JOIN 到
4166+
* 继任者上要求 archived=0 且 forgotten=0,继任者退场即自动恢复旧行可见性。
41494167
*/
41504168
function supersededIds() {
4151-
return db.prepare("SELECT id FROM memories WHERE superseded_by IS NOT NULL").all().map((r) => r.id);
4169+
return db.prepare(
4170+
`SELECT m.id AS id
4171+
FROM memories m
4172+
JOIN memories w ON w.id = m.superseded_by
4173+
WHERE m.superseded_by IS NOT NULL
4174+
AND w.archived = 0
4175+
AND w.forgotten = 0`
4176+
).all().map((r) => r.id);
41524177
}
41534178

41544179
/**

‎dsh-mneme/src/config.js‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -606,11 +606,12 @@ export const Config = z.object({
606606
// freeze/LLM 路径零变化——beta 实验的测量期:shadow 一周拿真实分诊
607607
// 分布,验证是否复现 46/20/5/27。
608608
// "enforce" 确定性处置:T1(dup)走信息量优先 supersede(supersedeInfoFirstPair,
609-
// 败者归档、胜者正文不动、可追溯注记在被归档侧);T2/T3/T4 记账即
610-
// 处置——不停车、不送 LLM、不归档。人审队列与 LLM 裁决都不再消费
611-
// 冲突候选;与 conflictFreezeEnabled 同开时 freeze 让位(降级 shadow
612-
// + warn,#616 父子绑定不继承)。T3 的取代链与 T4 的检索时消解是
613-
// 后续 PR,enforce 先把人审摘出去。
609+
// 败者归档、胜者正文不动、可追溯注记在被归档侧);T2(跨作用域重复)
610+
// 与 T4(真矛盾)只记账——不停车、不送 LLM、不动正文;T3(时序演进)
611+
// 落取代链:旧行 superseded_by/superseded_at 指向新行,两行都留着、
612+
// 正文都不动,检索侧按降权处理。人审队列与 LLM 裁决都不再消费冲突
613+
// 候选;与 conflictFreezeEnabled 同开时 freeze 让位(降级 shadow
614+
// + warn,#616 父子绑定不继承)。
614615
//
615616
// 判据唯一实现在 src/dream/triage.js;处置共享实现在 decisions.js 的
616617
// supersedeInfoFirstPair。每个档位的行为都真实存在——#616 的「假成功」教训

‎dsh-mneme/src/dream.js‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1545,7 +1545,13 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15451545
const b = snapshot.get(d.loser);
15461546
if (!a || !b) continue;
15471547
try {
1548-
const verdict = triagePair(a, b, pairSimilarity.get(similarityKey(d.winner, d.loser)));
1548+
// 判据必须与 sleep 侧同源(#650 评审):sleep enforce 传的是
1549+
// config.conflictLedgerDupMinSimilarity,这里不传就会退回 triage.js 的
1550+
// 死默认 0.9 —— 用户把阈值调高/调低后,同一对在两条路径上可能分到不同
1551+
// tier(一侧判 dup 去归档,另一侧判 conflict 只记账)。
1552+
const verdict = triagePair(a, b, pairSimilarity.get(similarityKey(d.winner, d.loser)), {
1553+
dupMinSimilarity: config.conflictLedgerDupMinSimilarity
1554+
});
15491555
if (verdict.tier === "dup") {
15501556
const res = supersedeInfoFirstPair({ a, b }, service, logger, config);
15511557
if (res.applied) {
@@ -1555,6 +1561,11 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15551561
// 本 helper 独立落地的,不在 applyList 里,必须显式补进维护清单
15561562
// (否则索引里留一行已归档记忆的向量,「清得掉才检索得到」失衡)。
15571563
ledgerVectorFixups.push({ action: "supersede", winner: res.winnerId, loser: res.loserId });
1564+
// 先落观察行再推进状态(#650 评审):dream 路径不像 sleep 那样先跑
1565+
// recordLedgerTriage,账本里可能根本没有这一对;此处若直接 UPDATE,
1566+
// 命中 0 行、changes=0 被静默丢弃,于是「处置成功」与「账本有记录」
1567+
// 长期背离。upsert 一次拿到确定的行,状态推进才有落点。
1568+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
15581569
service.setConflictLedgerStatus(a.id, b.id, "superseded");
15591570
try {
15601571
service.saveConflictReviewed?.({ run_id: runId, memory_a: a.id, memory_b: b.id, outcome: "supersede", judged_at: new Date().toISOString() });
@@ -1574,6 +1585,7 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
15741585
try {
15751586
if (service.supersedeChain(older.id, newer.id)) {
15761587
t3Chained += 1;
1588+
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
15771589
service.setConflictLedgerStatus(a.id, b.id, "superseded");
15781590
} else {
15791591
service.saveConflictLedgerEntry({ run_id: runId, memory_a: a.id, memory_b: b.id, tier: verdict.tier, similarity: verdict.signals.similarity, signals: verdict.signals });
@@ -1846,7 +1858,10 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
18461858
return finish({
18471859
ok: okResult,
18481860
status,
1849-
applied,
1861+
// ledgerApplied 是 ledger enforce 档下 T1 supersede 的独立产出,不在 applyList
1862+
// 里(#650 评审)。只把它算进 noChange 会让 receipt 与 dream_runs.applied 仍
1863+
// 报 0:库真被改了,回执说没改——#619 同族假成功。计入 applied 才是唯一口径。
1864+
applied: applied + ledgerApplied,
18501865
decisions: auditDecisions,
18511866
outcome,
18521867
conflicts,

0 commit comments

Comments
 (0)