@kenz1117/dsh-engram 0.11.5 → 0.11.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.js CHANGED
@@ -11,7 +11,7 @@ import { createGzip, gunzip } from "node:zlib";
11
11
  import { promisify } from "node:util";
12
12
  import { AsyncLocalStorage } from "node:async_hooks";
13
13
  import { defineTool } from "@deepseek-ai/dsh-tools";
14
- //#region src/i18n/language.ts
14
+ // src/i18n/language.ts
15
15
  /**
16
16
  * Язык вывода — серверная половина плагина.
17
17
  *
@@ -177,8 +177,7 @@ function pickLanguage(setting, packaged) {
177
177
  if (packaged !== void 0 && BUILTIN_LANGUAGES.includes(packaged)) return packaged;
178
178
  return resolveLanguage("auto");
179
179
  }
180
- //#endregion
181
- //#region src/i18n/catalog/core.ts
180
+ // src/i18n/catalog/core.ts
182
181
  /**
183
182
  * Словарь: ядро плагина — профиль сессии, бюджет токенов, предложение экскурсии,
184
183
  * обоснование отбора, образцы памяти.
@@ -231,7 +230,7 @@ const zh$5 = {
231
230
  "core.warnHistoryBackfillFailed": "[dsh-engram] 历史回填失败:",
232
231
  "core.warnDisposeFinalFailed": "[dsh-engram] 会话结束的收尾处理异常(不影响对话):",
233
232
  "core.warnReflectFailed": "[dsh-engram] 会话结束的信念巩固异常({scope},不影响对话):",
234
- "core.warnReflectBatchDropped": "[dsh-engram] 信念巩固丢弃 {count} 条候选({reason};未被巩固、下次巩固继续取材)",
233
+ "core.warnReflectBatchDropped": "[dsh-engram] 信念巩固丢弃 {count} 条候选(输出预算/解析失败;未被巩固、下次巩固继续取材)",
235
234
  "core.warnDecayStartupFailed": "[dsh-engram] 启动衰减调度失败(跳过):",
236
235
  "core.warnDecayPeriodicFailed": "[dsh-engram] 周期衰减调度失败(跳过):",
237
236
  "core.warnConsolidationFailed": "[dsh-engram] 闭馆整理失败(不影响对话):",
@@ -288,7 +287,7 @@ const en$5 = {
288
287
  "core.warnHistoryBackfillFailed": "[dsh-engram] History backfill failed:",
289
288
  "core.warnDisposeFinalFailed": "[dsh-engram] Session-end finalisation threw (conversation unaffected):",
290
289
  "core.warnReflectFailed": "[dsh-engram] Belief consolidation at session end threw ({scope}, conversation unaffected):",
291
- "core.warnReflectBatchDropped": "[dsh-engram] Belief consolidation dropped {count} candidates ({reason}; not consolidated, will be picked up next consolidation)",
290
+ "core.warnReflectBatchDropped": "[dsh-engram] Belief consolidation dropped {count} candidates (output budget/parse failure; not consolidated, will be picked up next consolidation)",
292
291
  "core.warnDecayStartupFailed": "[dsh-engram] Startup decay scheduling failed (skipped):",
293
292
  "core.warnDecayPeriodicFailed": "[dsh-engram] Periodic decay scheduling failed (skipped):",
294
293
  "core.warnConsolidationFailed": "[dsh-engram] Closing-time consolidation failed (conversation unaffected):",
@@ -303,8 +302,7 @@ const en$5 = {
303
302
  "core.decayTargetProject": "project “{title}”",
304
303
  "core.backfillBusy": "A backfill job is already running; pause it or wait for it to finish first"
305
304
  };
306
- //#endregion
307
- //#region src/i18n/catalog/llm.ts
305
+ // src/i18n/catalog/llm.ts
308
306
  /**
309
307
  * Словарь: обращения к вспомогательной модели — извлечение, дистилляция,
310
308
  * консолидация убеждений, переписывание запроса.
@@ -379,8 +377,7 @@ const en$4 = {
379
377
  "llm.finishUnsupported": "dsh-engram: unsupported finish reason \"{kind}\"",
380
378
  "llm.emptyOutput": "the auxiliary call returned empty output"
381
379
  };
382
- //#endregion
383
- //#region src/i18n/catalog/misc.ts
380
+ // src/i18n/catalog/misc.ts
384
381
  /**
385
382
  * Словарь: HTTP-маршруты панели, экспорт-зеркало, предложения по обновлению,
386
383
  * проверка таблички-названия, настройки Jev.
@@ -499,8 +496,7 @@ const en$3 = {
499
496
  "tool.languageGuideDescription": "How to bring a new language into the memory palace: returns the instruction text (docs/agent-language-guide.ru.md, currently a Russian draft). Use it when the user's language is not zh/en: read it, then walk the user through registering the language, the dictionaries and the switch.",
500
497
  "tool.languageGuideMissing": "[dsh-engram] language guide file is missing: {file} — {error}"
501
498
  };
502
- //#endregion
503
- //#region src/i18n/catalog/store.ts
499
+ // src/i18n/catalog/store.ts
504
500
  /**
505
501
  * Словарь: хранилище, резервные копии, безопасность, привязка к проекту, эмбеддер.
506
502
  *
@@ -604,8 +600,7 @@ const en$2 = {
604
600
  "store.embedderRemoteEmpty": "embedding endpoint returned an empty vector",
605
601
  "store.budgetDropped": "({count} more not shown: narrow the query or lower the limit and retry)"
606
602
  };
607
- //#endregion
608
- //#region src/i18n/catalog/tool.ts
603
+ // src/i18n/catalog/tool.ts
609
604
  /**
610
605
  * Словарь: 23 инструмента `engram_*` — описания схем, тексты результатов и ошибки.
611
606
  *
@@ -1283,8 +1278,7 @@ const en$1 = {
1283
1278
  "tool.profileEditNoBlockToRollback": "engram_profile_edit: the {scope} store has no curated profile block, so there is nothing to roll back",
1284
1279
  "tool.profileEditRolledBack": "Wrote the content of v{from} as v{to} ({scope}; the version chain only grows, so further rollbacks are possible)."
1285
1280
  };
1286
- //#endregion
1287
- //#region src/i18n/messages.ts
1281
+ // src/i18n/messages.ts
1288
1282
  /**
1289
1283
  * Словарь служебных сообщений серверной половины.
1290
1284
  *
@@ -1411,8 +1405,7 @@ function messageIn(language, key, params) {
1411
1405
  function message(key, params) {
1412
1406
  return messageIn(current, key, params);
1413
1407
  }
1414
- //#endregion
1415
- //#region src/jev/stale.ts
1408
+ // src/jev/stale.ts
1416
1409
  /**
1417
1410
  * Поля Jev прежнего формата: ключ и адрес когда-то хранились у самого плагина
1418
1411
  * (`jev.apiKey`, `jev.baseUrl`). После переезда к провайдеру хоста они больше не
@@ -1458,8 +1451,7 @@ function noteLegacyJevFields(where, fields) {
1458
1451
  }));
1459
1452
  }
1460
1453
  }
1461
- //#endregion
1462
- //#region src/config.ts
1454
+ // src/config.ts
1463
1455
  /**
1464
1456
  * 插件 Config:所有部署可变项集中于此,禁止在实现里内嵌默认值。
1465
1457
  * @module @kenz1117/dsh-engram/config
@@ -1489,6 +1481,7 @@ const CONFIG_KEYS = /* @__PURE__ */ new Set([
1489
1481
  "reviewScheduling",
1490
1482
  "assessReminder",
1491
1483
  "palaceChangeWindowSec",
1484
+ "panelAccess",
1492
1485
  "historyBackfillDays",
1493
1486
  "historyBackfillMaxTurnsPerSession",
1494
1487
  "historyBackfillMaxTotalTurns",
@@ -1545,6 +1538,7 @@ const Config = z.object({
1545
1538
  queryRewrite: z.boolean(),
1546
1539
  autoSlot: z.boolean(),
1547
1540
  reviewScheduling: z.boolean(),
1541
+ panelAccess: z.string(),
1548
1542
  palaceChangeWindowSec: z.number().step(1).min(5).max(600),
1549
1543
  assessReminder: z.boolean(),
1550
1544
  historyBackfillDays: z.number().step(1).min(0).max(3650),
@@ -1592,13 +1586,14 @@ function readLanguageSetting(value) {
1592
1586
  * 显式 resolve 步骤:默认值只在唯一的此处落地,非法值 loud 失败。
1593
1587
  * @param config - cordis.yml 传入的未校验配置。
1594
1588
  * @returns 完整解析配置。
1595
- * @throws 未知键、ingest 档位非法、provider/model 只给其一、decay/预算/排序权重/历史回填规则越界时抛错。
1589
+ * @throws 未知键、ingest/reflect/panelAccess 档位非法、provider/model 只给其一、decay/预算/排序权重/历史回填规则越界时抛错。
1596
1590
  */
1597
1591
  function resolveConfig(config = {}) {
1598
1592
  for (const key of Object.keys(config)) if (!CONFIG_KEYS.has(key)) throw new Error(`dsh-engram: unknown config key "${key}"`);
1599
1593
  if (config.legacyMigration !== void 0 && config.legacyMigration !== "eager" && config.legacyMigration !== "conservative") throw new Error("dsh-engram: legacyMigration must be one of eager|conservative");
1600
1594
  if (config.ingest !== void 0 && !INGEST_MODES.has(config.ingest)) throw new Error(`dsh-engram: ingest must be one of off|light|eager, got "${String(config.ingest)}"`);
1601
1595
  if (config.reflect !== void 0 && !REFLECT_MODES.has(config.reflect)) throw new Error(`dsh-engram: reflect must be one of off|suggest|auto, got "${String(config.reflect)}"`);
1596
+ if (config.panelAccess !== void 0 && config.panelAccess !== "loopback" && config.panelAccess !== "lan") throw new Error(`dsh-engram: panelAccess must be one of loopback|lan, got "${String(config.panelAccess)}"`);
1602
1597
  const languageSetting = readLanguageSetting(config.language);
1603
1598
  if (languageSetting !== void 0 && languageSetting !== "auto" && !isLanguageCode(languageSetting)) throw new Error(`dsh-engram: language must be "auto" or a language code (zh, en, ru, fr, …), got "${String(languageSetting)}"`);
1604
1599
  if (config.profileTopN !== void 0 && (!Number.isInteger(config.profileTopN) || config.profileTopN < 1 || config.profileTopN > 64)) throw new Error("dsh-engram: profileTopN must be an integer in [1, 64]");
@@ -1690,6 +1685,7 @@ function resolveConfig(config = {}) {
1690
1685
  queryRewrite: config.queryRewrite ?? true,
1691
1686
  autoSlot: config.autoSlot ?? true,
1692
1687
  reviewScheduling: config.reviewScheduling ?? true,
1688
+ panelAccess: config.panelAccess ?? "loopback",
1693
1689
  palaceChangeWindowSec: config.palaceChangeWindowSec ?? 30,
1694
1690
  historyBackfill: {
1695
1691
  days: config.historyBackfillDays ?? 7,
@@ -1724,8 +1720,7 @@ function resolveConfig(config = {}) {
1724
1720
  }
1725
1721
  };
1726
1722
  }
1727
- //#endregion
1728
- //#region src/registry/root.ts
1723
+ // src/registry/root.ts
1729
1724
  /**
1730
1725
  * Корень пакета — общий для всех файлов, которые читаются с диска при работе:
1731
1726
  * словарей (`i18n/`) и реестров (`registry/`).
@@ -1750,8 +1745,7 @@ function packageRoot() {
1750
1745
  }
1751
1746
  return dir;
1752
1747
  }
1753
- //#endregion
1754
- //#region src/i18n/dictionary.ts
1748
+ // src/i18n/dictionary.ts
1755
1749
  /** Раскрытие экранированной последовательности. */
1756
1750
  const UNESCAPE = {
1757
1751
  "\\": "\\",
@@ -1895,8 +1889,7 @@ function parseDictionary(text, options) {
1895
1889
  seen
1896
1890
  };
1897
1891
  }
1898
- //#endregion
1899
- //#region src/i18n/dictionary-file.ts
1892
+ // src/i18n/dictionary-file.ts
1900
1893
  /**
1901
1894
  * Чтение словарей перевода с диска: сначала поставка, поверх неё — слой пользователя.
1902
1895
  *
@@ -2011,8 +2004,7 @@ function describeDictionaryProblems(problems, limit = 3) {
2011
2004
  const rest = problems.length - head.length;
2012
2005
  return rest > 0 ? `${head.join("; ")}; ещё ${rest}` : head.join("; ");
2013
2006
  }
2014
- //#endregion
2015
- //#region src/client/locales/en.ts
2007
+ // src/client/locales/en.ts
2016
2008
  /** 英文词典。整页采用「Memory Palace」语言:palace / room (kind group) / memory / placard / tour / curator / corridor。
2017
2009
  数据层英文枚举(status/kind/op)不在此映射,文案键保持稳定。 */
2018
2010
  const en = {
@@ -2345,6 +2337,12 @@ const en = {
2345
2337
  beliefEvidence: "{n} evidence",
2346
2338
  beliefEvidenceEmpty: "Evidence memories were purged; the belief is kept",
2347
2339
  beliefNone: "No consolidated beliefs yet; the butler induces them once memories accumulate",
2340
+ beliefRefute: "Refute",
2341
+ beliefRefuteConfirm: "Click again to refute",
2342
+ beliefRestore: "Restore",
2343
+ beliefRefuteDone: "Belief refuted",
2344
+ beliefRestoreDone: "Belief restored",
2345
+ beliefActionFailed: "Action failed: {msg}",
2348
2346
  entityKindAll: "All kinds",
2349
2347
  entityKindPerson: "People",
2350
2348
  entityKindProject: "Projects",
@@ -2580,8 +2578,7 @@ const en = {
2580
2578
  dictFillDone: "AI filled {n} cell(s)",
2581
2579
  dictFillFailed: "Could not fill with AI: {error}"
2582
2580
  };
2583
- //#endregion
2584
- //#region src/client/locales/ru.ts
2581
+ // src/client/locales/ru.ts
2585
2582
  /** Русский словарь. Метафора английского словаря сохранена: дворец (palace) / комната (kind-группа) /
2586
2583
  воспоминание (memory) / табличка (placard) / экскурсия (tour) / куратор (curator) / коридор (corridor).
2587
2584
  Английские перечисления слоя данных (status/kind/op) здесь не отображаются: ключи стабильны ради
@@ -2916,6 +2913,12 @@ const ru = {
2916
2913
  beliefEvidence: "{n} доказательство|{n} доказательства|{n} доказательств",
2917
2914
  beliefEvidenceEmpty: "Воспоминания-доказательства удалены; убеждение сохранено",
2918
2915
  beliefNone: "Консолидированных убеждений пока нет; куратор выводит их по мере накопления воспоминаний",
2916
+ beliefRefute: "Опровергнуть",
2917
+ beliefRefuteConfirm: "Нажми ещё раз для опровержения",
2918
+ beliefRestore: "Восстановить",
2919
+ beliefRefuteDone: "Убеждение опровергнуто",
2920
+ beliefRestoreDone: "Убеждение восстановлено",
2921
+ beliefActionFailed: "Не удалось выполнить: {msg}",
2919
2922
  entityKindAll: "Все виды",
2920
2923
  entityKindPerson: "Люди",
2921
2924
  entityKindProject: "Проекты",
@@ -3151,8 +3154,7 @@ const ru = {
3151
3154
  dictFillDone: "ИИ заполнил клеток: {n}",
3152
3155
  dictFillFailed: "Не удалось заполнить с помощью ИИ: {error}"
3153
3156
  };
3154
- //#endregion
3155
- //#region src/client/locales/zh.ts
3157
+ // src/client/locales/zh.ts
3156
3158
  /** 中文词典(宿主默认语言)。整页采用「记忆宫殿」语言:宫殿 / 房间(kind 分组)/ 记忆 / 铭牌 / 参观 / 管家 / 走廊。
3157
3159
  数据层英文枚举(status/kind/op)不在此映射,文案键保持稳定以保证编译约束。 */
3158
3160
  const zh = {
@@ -3485,6 +3487,12 @@ const zh = {
3485
3487
  beliefEvidence: "证据 {n} 条",
3486
3488
  beliefEvidenceEmpty: "证据记忆已被清理,信念保留",
3487
3489
  beliefNone: "还没有巩固出信念;管家会在记忆积累后自动归纳",
3490
+ beliefRefute: "作废",
3491
+ beliefRefuteConfirm: "再点一次确认作废",
3492
+ beliefRestore: "恢复",
3493
+ beliefRefuteDone: "已作废该信念",
3494
+ beliefRestoreDone: "已恢复该信念",
3495
+ beliefActionFailed: "执行失败:{msg}",
3488
3496
  entityKindAll: "全部类别",
3489
3497
  entityKindPerson: "人物",
3490
3498
  entityKindProject: "项目",
@@ -3720,8 +3728,7 @@ const zh = {
3720
3728
  dictFillDone: "AI 已填充 {n} 个单元格",
3721
3729
  dictFillFailed: "AI 填充失败:{error}"
3722
3730
  };
3723
- //#endregion
3724
- //#region src/i18n/dictionary-terms.ts
3731
+ // src/i18n/dictionary-terms.ts
3725
3732
  /**
3726
3733
  * Словарь как список терминов: что показывать в таблице правки и что стоит справа.
3727
3734
  *
@@ -3797,8 +3804,7 @@ function dictionaryBuiltin(set, language, left) {
3797
3804
  const key = panelByText.get(left);
3798
3805
  return key === void 0 ? void 0 : PANEL_PACKS[language]?.[key];
3799
3806
  }
3800
- //#endregion
3801
- //#region src/i18n/dictionary-edit.ts
3807
+ // src/i18n/dictionary-edit.ts
3802
3808
  /**
3803
3809
  * Правка словарей: что можно править, где это лежит и как записать.
3804
3810
  *
@@ -4134,8 +4140,7 @@ function splitFillBatch(terms, maxCount = 30, maxChars = FILL_BATCH_CHARS) {
4134
4140
  if (current.length > 0) chunks.push(current);
4135
4141
  return chunks;
4136
4142
  }
4137
- //#endregion
4138
- //#region src/types.ts
4143
+ // src/types.ts
4139
4144
  /** 从任意字符串铸造品牌化 id(存储层入库前调用)。 */
4140
4145
  function asMemoryId(raw) {
4141
4146
  return raw;
@@ -4168,8 +4173,7 @@ var EngramError = class extends Error {
4168
4173
  this.code = code;
4169
4174
  }
4170
4175
  };
4171
- //#endregion
4172
- //#region src/i18n/dictionary-ai.ts
4176
+ // src/i18n/dictionary-ai.ts
4173
4177
  /**
4174
4178
  * Язык в запросе: модель должна понимать, на какой язык переводить.
4175
4179
  * Имя английское — это метаязык инструкции, а не тот, на который переводим.
@@ -4436,8 +4440,7 @@ function fillBatch(terms) {
4436
4440
  }));
4437
4441
  return list;
4438
4442
  }
4439
- //#endregion
4440
- //#region src/registry/languages.ts
4443
+ // src/registry/languages.ts
4441
4444
  /**
4442
4445
  * Реестр языков: какие языки дворца плагин знает и откуда берёт их тексты.
4443
4446
  *
@@ -4547,8 +4550,7 @@ function parseLanguages(text) {
4547
4550
  issues
4548
4551
  };
4549
4552
  }
4550
- //#endregion
4551
- //#region src/registry/models.ts
4553
+ // src/registry/models.ts
4552
4554
  /** Способы сведения токенов, которые понимает разбор. */
4553
4555
  const POOLING_MODES = ["mean", "cls"];
4554
4556
  /** Виды весов, которые понимает разбор (множество transformers.js). */
@@ -4863,8 +4865,7 @@ function checkBindingModels(models, bindings) {
4863
4865
  });
4864
4866
  return issues;
4865
4867
  }
4866
- //#endregion
4867
- //#region src/registry/registry-file.ts
4868
+ // src/registry/registry-file.ts
4868
4869
  /**
4869
4870
  * Чтение реестров с диска: каталог моделей — только поставка, привязки —
4870
4871
  * поставка плюс слой пользователя.
@@ -5013,8 +5014,7 @@ function describeRegistryProblems(problems, limit = 3) {
5013
5014
  const rest = problems.length - head.length;
5014
5015
  return rest > 0 ? `${head.join("; ")}; ещё ${rest}` : head.join("; ");
5015
5016
  }
5016
- //#endregion
5017
- //#region src/i18n/palace-language.ts
5017
+ // src/i18n/palace-language.ts
5018
5018
  /**
5019
5019
  * Язык дворца: чистые правила определения — без обращения к сервисам и файлам.
5020
5020
  *
@@ -5162,8 +5162,7 @@ function decideLanguage(signals, options = {}) {
5162
5162
  }]
5163
5163
  };
5164
5164
  }
5165
- //#endregion
5166
- //#region src/language-signals.ts
5165
+ // src/language-signals.ts
5167
5166
  /**
5168
5167
  * Сбор сигналов для языка дворца: то, что можно прочитать у хоста и на машине.
5169
5168
  *
@@ -5213,8 +5212,7 @@ async function collectLanguageSignals(deps = {}) {
5213
5212
  machine
5214
5213
  };
5215
5214
  }
5216
- //#endregion
5217
- //#region src/settings-bridge.ts
5215
+ // src/settings-bridge.ts
5218
5216
  /**
5219
5217
  * Мост к хостовому сервису настроек: чтение preference интерфейса и запись языка дворца.
5220
5218
  *
@@ -5325,8 +5323,7 @@ async function writePalaceLanguageWithRetry(input) {
5325
5323
  }
5326
5324
  return reason;
5327
5325
  }
5328
- //#endregion
5329
- //#region src/i18n/patterns.ts
5326
+ // src/i18n/patterns.ts
5330
5327
  /**
5331
5328
  * Языкозависимые образцы распознавания ввода.
5332
5329
  *
@@ -5455,8 +5452,7 @@ function chitchatPatterns(language = messageLanguage()) {
5455
5452
  function noCapturePatterns(language = messageLanguage()) {
5456
5453
  return activePatternLanguages(language).map((lang) => NO_CAPTURE_RE[lang]).filter((pattern) => pattern !== void 0);
5457
5454
  }
5458
- //#endregion
5459
- //#region src/i18n/rooms.ts
5455
+ // src/i18n/rooms.ts
5460
5456
  /** Базовый идентификатор → имя. Ключи совпадают с KIND_ROOM_IDS из palace/slots.ts. */
5461
5457
  const BASE_LABELS = {
5462
5458
  zh: {
@@ -5521,8 +5517,7 @@ function resolveRoomInput(input) {
5521
5517
  }
5522
5518
  }
5523
5519
  }
5524
- //#endregion
5525
- //#region src/embedder/local.ts
5520
+ // src/embedder/local.ts
5526
5521
  /**
5527
5522
  * transformers.js 本地嵌入实现:离线推理,模型首次使用需联网下载到 cacheDir;
5528
5523
  * 之后完全离线,数据不出机。
@@ -5581,8 +5576,7 @@ async function createLocalEmbedder(cacheDir, remoteHost, spec) {
5581
5576
  throw new EngramError("EMBEDDER_DOWNLOAD_FAILED", message("store.embedderDownloadFailed"), { cause: error });
5582
5577
  }
5583
5578
  }
5584
- //#endregion
5585
- //#region src/embedder/remote.ts
5579
+ // src/embedder/remote.ts
5586
5580
  /**
5587
5581
  * OpenAI 兼容端点嵌入器:`POST {baseUrl}/embeddings`。
5588
5582
  *
@@ -5702,8 +5696,7 @@ async function createRemoteEmbedder(options) {
5702
5696
  close: async () => {}
5703
5697
  };
5704
5698
  }
5705
- //#endregion
5706
- //#region src/embedder/select.ts
5699
+ // src/embedder/select.ts
5707
5700
  /**
5708
5701
  * Свойства модели, которой нет в каталоге.
5709
5702
  *
@@ -5800,8 +5793,7 @@ function createEmbedder(config, registry, languageOverride) {
5800
5793
  if (spec === void 0) return Promise.reject(new EngramError("EMBEDDER_MODEL_UNRESOLVED", message("store.embedderModelUnresolved")));
5801
5794
  return createLocalEmbedder(config.modelCacheDir, config.hfEndpoint, spec);
5802
5795
  }
5803
- //#endregion
5804
- //#region src/llm/client.ts
5796
+ // src/llm/client.ts
5805
5797
  /**
5806
5798
  * 辅助 LLM 调用客户端:封装 ctx.llm.stream + BlockAssembler,路由从会话日志解析。
5807
5799
  * 遵守 model-visible ⟺ logged:每次辅助调用的完整请求由调用方 append 到会话日志。
@@ -5900,8 +5892,7 @@ async function streamText(ctx, params) {
5900
5892
  if (text.trim() === "") throw new EngramError("LLM_EMPTY_OUTPUT", message("llm.emptyOutput"));
5901
5893
  return text;
5902
5894
  }
5903
- //#endregion
5904
- //#region src/security/sanitize.ts
5895
+ // src/security/sanitize.ts
5905
5896
  /**
5906
5897
  * 提示注入防护协议:记忆召回内容包 <engram_memory_context> 标签并附使用警告,
5907
5898
  * 当前用户请求包 <current_user_request>;任何记忆正文入库前剥离这些协议标签,
@@ -6046,8 +6037,7 @@ function normalizeWhitespace(value) {
6046
6037
  function escapeRegExp(value) {
6047
6038
  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
6048
6039
  }
6049
- //#endregion
6050
- //#region src/security/redact.ts
6040
+ // src/security/redact.ts
6051
6041
  /**
6052
6042
  * 摄取脱敏:记忆入库前用正则清洗常见密钥凭据(API key、Bearer、AWS、GitHub
6053
6043
  * token、PEM 私钥、password/token 赋值),命中片段替换为 [REDACTED:<kind>],
@@ -6080,8 +6070,7 @@ function redactSecrets(text) {
6080
6070
  for (const { pattern, kind } of redactLabelPatterns()) cleaned = cleaned.replace(pattern, (_match, key) => `${key}=${redacted(kind)}`);
6081
6071
  return cleaned.replace(/(?<!\d)1[3-9]\d{9}(?!\d)/g, redacted("phone")).replace(/\b[1-9]\d{5}(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dXx]\b/g, redacted("id-number"));
6082
6072
  }
6083
- //#endregion
6084
- //#region src/security/recall.ts
6073
+ // src/security/recall.ts
6085
6074
  /** 召回类工具名单:输出含既有记忆正文、重新入库只会自我强化的工具。 */
6086
6075
  const RECALL_TOOL_NAMES = /* @__PURE__ */ new Set([
6087
6076
  "engram_search",
@@ -6147,8 +6136,7 @@ function omitRecallToolResults(events) {
6147
6136
  };
6148
6137
  });
6149
6138
  }
6150
- //#endregion
6151
- //#region src/jev/observe.ts
6139
+ // src/jev/observe.ts
6152
6140
  /** 缓冲容量:足够回看一次摄取批次,同时封顶内存占用。 */
6153
6141
  const CAPACITY = 50;
6154
6142
  const buffer = [];
@@ -6338,8 +6326,7 @@ async function applyMerge(store, decision, content) {
6338
6326
  if (record === void 0) throw new Error(message("store.mergeTargetMissing", { id: decision.into.id }));
6339
6327
  return record;
6340
6328
  }
6341
- //#endregion
6342
- //#region src/ingest/hook.ts
6329
+ // src/ingest/hook.ts
6343
6330
  /** 档位参数(协议内常量,非部署 tunables)。 */
6344
6331
  const MODE_LIMITS = {
6345
6332
  light: {
@@ -7095,8 +7082,7 @@ async function replayPendingIngests(deps) {
7095
7082
  kept
7096
7083
  };
7097
7084
  }
7098
- //#endregion
7099
- //#region src/ingest/history.ts
7085
+ // src/ingest/history.ts
7100
7086
  const DAY_MS$1 = 864e5;
7101
7087
  /** 估算时并发读取的会话数(读取是 IO,适度并发;摄取阶段始终串行)。 */
7102
7088
  const ESTIMATE_CONCURRENCY = 4;
@@ -7414,8 +7400,7 @@ async function runHistoryBackfill(deps, defaults, overrides, onProgress, signal)
7414
7400
  failures
7415
7401
  };
7416
7402
  }
7417
- //#endregion
7418
- //#region src/vec.ts
7403
+ // src/vec.ts
7419
7404
  /**
7420
7405
  * 向量相似度共享实现:store 检索与巩固聚类共用一份,替代历史上的两处复制。
7421
7406
  * @module @kenz1117/dsh-engram/vec
@@ -7459,8 +7444,7 @@ function cosine(a, b) {
7459
7444
  function isDimensionMismatch(error) {
7460
7445
  return error instanceof EngramError && error.code === "EMBEDDER_DIMENSION_MISMATCH";
7461
7446
  }
7462
- //#endregion
7463
- //#region src/consolidation/run.ts
7447
+ // src/consolidation/run.ts
7464
7448
  /** 单条整理动作(写入 op_log 的统一标记)。 */
7465
7449
  const CONSOLIDATION_OP = "consolidation";
7466
7450
  /** 默认参数。 */
@@ -7598,8 +7582,7 @@ async function runConsolidation(store, embedder, opts = {}) {
7598
7582
  } catch {}
7599
7583
  return report;
7600
7584
  }
7601
- //#endregion
7602
- //#region src/consolidation/reflect.ts
7585
+ // src/consolidation/reflect.ts
7603
7586
  /**
7604
7587
  * 信念巩固(Reflect):把尚未成为任何信念证据的原始记忆交辅助 LLM 巩固为一句话信念
7605
7588
  * (observation),并对被新证据波及的 stale 信念做新鲜度复核。
@@ -7910,8 +7893,7 @@ function requireCandidateIds(raw, candidateIds) {
7910
7893
  }
7911
7894
  return ids;
7912
7895
  }
7913
- //#endregion
7914
- //#region src/store/import.ts
7896
+ // src/store/import.ts
7915
7897
  const SCOPES = [
7916
7898
  "user",
7917
7899
  "project",
@@ -8174,8 +8156,7 @@ async function embedImportedRecords(store, embedder, importedIds) {
8174
8156
  }
8175
8157
  return embedded;
8176
8158
  }
8177
- //#endregion
8178
- //#region src/body-limits.ts
8159
+ // src/body-limits.ts
8179
8160
  /**
8180
8161
  * 回环 API 的 body 字节上限(服务端与面板共用一份数字)。
8181
8162
  *
@@ -8201,8 +8182,7 @@ function formatBytes(bytes) {
8201
8182
  if (bytes >= 1024) return `${String(Math.round(bytes / 1024))} KB`;
8202
8183
  return `${String(bytes)} B`;
8203
8184
  }
8204
- //#endregion
8205
- //#region src/http-body.ts
8185
+ // src/http-body.ts
8206
8186
  /**
8207
8187
  * 读取并解析 JSON body。
8208
8188
  *
@@ -8274,8 +8254,7 @@ async function readJsonBody(req, limit = BODY_LIMIT_BYTES) {
8274
8254
  body: parsed
8275
8255
  };
8276
8256
  }
8277
- //#endregion
8278
- //#region src/jev/client.ts
8257
+ // src/jev/client.ts
8279
8258
  /**
8280
8259
  * HTTP-клиент модели Jev (System One): задаёт пачке «Noul»-вопросов (да/нет) по
8281
8260
  * одному тексту состояния и получает вероятности. Формат запроса — JSON вида
@@ -8464,8 +8443,7 @@ async function testJevConnection(connection) {
8464
8443
  };
8465
8444
  }
8466
8445
  }
8467
- //#endregion
8468
- //#region src/jev/host.ts
8446
+ // src/jev/host.ts
8469
8447
  /**
8470
8448
  * Мост к хосту DSH: провайдеры, их модели и ключи живут в одном месте — у хоста.
8471
8449
  *
@@ -8747,8 +8725,7 @@ async function resolveJevConnection(ctx, providerId, model, timeoutMs, endpointO
8747
8725
  function pickJevModel(modelIds) {
8748
8726
  return modelIds.find((id) => /jev/i.test(id));
8749
8727
  }
8750
- //#endregion
8751
- //#region src/jev/runtime.ts
8728
+ // src/jev/runtime.ts
8752
8729
  /**
8753
8730
  * Настройки Jev, задаваемые из панели: сохраняются в `<dbDir>/jev-config.json` (0600)
8754
8731
  * и пофайлово перекрывают подконфигурацию `jev` из cordis.yml.
@@ -8924,8 +8901,7 @@ function resolveJevField(ctx, base, dbDir, routeProvider) {
8924
8901
  });
8925
8902
  } };
8926
8903
  }
8927
- //#endregion
8928
- //#region src/mirror/markdown.ts
8904
+ // src/mirror/markdown.ts
8929
8905
  /**
8930
8906
  * Markdown 镜像:把 SQLite 记忆库导出为可被 Obsidian / VS Code / git 直接漫游的
8931
8907
  * 文件树:按房间(kind)分目录,每条记忆一个 .md + frontmatter,附房间清单 _meta.json 与全宫殿入口 _index.md。
@@ -9126,8 +9102,7 @@ function buildShareManifest(data, now = Date.now()) {
9126
9102
  loans
9127
9103
  };
9128
9104
  }
9129
- //#endregion
9130
- //#region src/backup/tar-stream.ts
9105
+ // src/backup/tar-stream.ts
9131
9106
  /**
9132
9107
  * 极简 tar 流的写入与解包:UStar 格式(POSIX.1-1988),足够本插件「打包几个 .db + _meta.json」场景。
9133
9108
  * 文件名长度 ≤ 99 字节、文件 ≤ 8 GiB 已覆盖本插件的备份规模;超过则抛错。
@@ -9209,8 +9184,7 @@ async function extractTar(buffer, destDir) {
9209
9184
  } else offset += (BLOCK_SIZE - size % BLOCK_SIZE) % BLOCK_SIZE;
9210
9185
  }
9211
9186
  }
9212
- //#endregion
9213
- //#region src/backup/tar.ts
9187
+ // src/backup/tar.ts
9214
9188
  /**
9215
9189
  * 宫殿备份与恢复:把当前 user/project 两库的 .db + 元信息打包成单一 .tar.gz 文件;
9216
9190
  * 恢复时校验 tar 内的 _meta.json schema 版本并覆盖原库(恢复前自动备份现状为 .before-restore-<ts>)。
@@ -9432,8 +9406,7 @@ async function untarGz(archivePath, destDir) {
9432
9406
  const compressed = await readFileBuffer(archivePath);
9433
9407
  await extractTar(await gunzipAsync(compressed), destDir);
9434
9408
  }
9435
- //#endregion
9436
- //#region src/telemetry/aggregate.ts
9409
+ // src/telemetry/aggregate.ts
9437
9410
  /** 聚合窗口(默认 7 天,可由路由 query 覆盖)。 */
9438
9411
  const DEFAULT_WINDOW_DAYS = 7;
9439
9412
  /** 从单库 op_log 统计各 op 的计数(窗口内)——SQL GROUP BY,不物化明细行(审计 N1)。 */
@@ -9535,8 +9508,7 @@ async function aggregateTelemetry(openStore, windowDays = DEFAULT_WINDOW_DAYS, s
9535
9508
  }))
9536
9509
  };
9537
9510
  }
9538
- //#endregion
9539
- //#region src/tour-proposal.ts
9511
+ // src/tour-proposal.ts
9540
9512
  /**
9541
9513
  * 入殿导航:会话首轮时主动提议一条入门巡游路线。
9542
9514
  * 设计:取当前会话最近一轮 user/project 的高频 kind + importance × confidence 排序,
@@ -9573,8 +9545,7 @@ function buildTourProposal(scope, records, focusKind) {
9573
9545
  empty
9574
9546
  };
9575
9547
  }
9576
- //#endregion
9577
- //#region src/refurb.ts
9548
+ // src/refurb.ts
9578
9549
  /** 缺省参数。 */
9579
9550
  const DEFAULT_REFURB_OPTIONS = {
9580
9551
  minActive: 8,
@@ -9676,55 +9647,121 @@ function gatherRefurbSuggestions(records, language, options = DEFAULT_REFURB_OPT
9676
9647
  }
9677
9648
  return suggestions;
9678
9649
  }
9679
- //#endregion
9680
- //#region src/routes.ts
9650
+ // src/routes.ts
9681
9651
  /**
9682
9652
  * /engram 管理页与 /api/engram/* 数据接口的回环路由。
9683
- * 安全面:peer socket + Host 头必须为本机回环;写操作额外校验 Origin 与
9684
- * Content-Type(billing guardLoopback 同款三重防线)。下游插件不进宿主
9685
- * client 模块表,管理页为 host 直出的自包含单文件页。
9653
+ * 安全面:peer socket + Host 头校验(默认仅本机回环;panelAccess='lan' 放宽到私网,
9654
+ * 防线结构不变);写操作额外校验 Origin 与 Content-Type(billing guardLoopback
9655
+ * 同款三重防线)。下游插件不进宿主 client 模块表,管理页为 host 直出的自包含单文件页。
9686
9656
  * @module @kenz1117/dsh-engram/routes
9687
9657
  */
9688
- /** 回环 peer:IPv4 127/8、IPv6 ::1、IPv4-mapped IPv6。 */
9689
- function isLoopbackPeer(req) {
9658
+ /** 回环地址:IPv4 127/8、IPv6 ::1、IPv4-mapped IPv6。 */
9659
+ function isLoopbackAddress(address) {
9660
+ return address === "::1" || address.startsWith("127.") || address.startsWith("::ffff:127.");
9661
+ }
9662
+ /** RFC1918 私网 IPv4 字面量(10/8、172.16/12、192.168/16;每段 ≤255 才算字面量)。 */
9663
+ function isPrivateIPv4(address) {
9664
+ const match = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(address);
9665
+ if (match === null) return false;
9666
+ const [first, second] = [Number(match[1]), Number(match[2])];
9667
+ if ([
9668
+ first,
9669
+ second,
9670
+ Number(match[3]),
9671
+ Number(match[4])
9672
+ ].some((octet) => octet > 255)) return false;
9673
+ return first === 10 || first === 172 && second >= 16 && second <= 31 || first === 192 && second === 168;
9674
+ }
9675
+ /** IPv6 ULA fc00::/7(fc/fd 开头)与链路本地 fe80::/10(fe80-febf)。 */
9676
+ function isPrivateIPv6(address) {
9677
+ const lower = address.toLowerCase();
9678
+ return lower.startsWith("fc") || lower.startsWith("fd") || lower.startsWith("fe8") || lower.startsWith("fe9") || lower.startsWith("fea") || lower.startsWith("feb");
9679
+ }
9680
+ /** lan 模式的 peer 面:回环 + 私网(含 IPv4-mapped IPv6 去映射后判定)。 */
9681
+ function isAllowedPeer(req, lan) {
9690
9682
  const address = req.socket.remoteAddress;
9691
9683
  if (address === void 0) return false;
9692
- return address === "::1" || address.startsWith("127.") || address.startsWith("::ffff:127.");
9684
+ if (isLoopbackAddress(address)) return true;
9685
+ if (!lan) return false;
9686
+ const unMapped = address.startsWith("::ffff:") ? address.slice(7) : address;
9687
+ return isPrivateIPv4(unMapped) || isPrivateIPv6(unMapped);
9688
+ }
9689
+ /** Host 头去端口:IPv6 字面量按方括号取;其余在「末冒号后是纯数字端口」时才切。 */
9690
+ function hostNameOf(header) {
9691
+ if (header.startsWith("[")) {
9692
+ const end = header.indexOf("]");
9693
+ return end === -1 ? header.slice(1) : header.slice(1, end);
9694
+ }
9695
+ const colon = header.lastIndexOf(":");
9696
+ if (colon === -1) return header;
9697
+ const port = header.slice(colon + 1);
9698
+ return /^\d+$/.test(port) ? header.slice(0, colon) : header;
9699
+ }
9700
+ /** 回环 Host 名:localhost、::1、127/8 字面量。 */
9701
+ function isLoopbackHostName(name) {
9702
+ return name === "localhost" || name === "::1" || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(name);
9703
+ }
9704
+ /** IPv4 字面量(点分四段、每段 ≤255);与 peer 判定解耦——Host 只看字面性,不看私网段。 */
9705
+ function isIPv4Literal(name) {
9706
+ const match = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(name);
9707
+ if (match === null) return false;
9708
+ return [
9709
+ Number(match[1]),
9710
+ Number(match[2]),
9711
+ Number(match[3]),
9712
+ Number(match[4])
9713
+ ].every((octet) => octet <= 255);
9693
9714
  }
9694
- /** Host 头必须为回环字面量(防 DNS rebinding:拒绝 `127.0.0.1.attacker.com`)。 */
9695
- function isLoopbackHost(req) {
9715
+ /**
9716
+ * lan 模式的 Host 放宽面:字面 IPv4/IPv6、localhost、单标签主机名、`*.local`。
9717
+ * 多标签域名仍拒绝——防 DNS rebinding(`127.0.0.1.attacker.com` 解析回环的老把戏)。
9718
+ */
9719
+ function isLanHostName(name) {
9720
+ if (isLoopbackHostName(name)) return true;
9721
+ if (isIPv4Literal(name)) return true;
9722
+ if (name.includes(":")) return true;
9723
+ if (!name.includes(".")) return true;
9724
+ return name.toLowerCase().endsWith(".local");
9725
+ }
9726
+ /** Host 头校验:缺省放行(同旧版);loopback 模式要回环名,lan 模式再放行私网名字面量。 */
9727
+ function isAllowedHost(req, lan) {
9696
9728
  const host = req.headers.host;
9697
9729
  if (host === void 0 || host === "") return true;
9698
- const name = host.split(":")[0];
9699
- return name === "localhost" || name === "::1" || name !== void 0 && /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(name);
9730
+ const name = hostNameOf(host);
9731
+ return lan ? isLanHostName(name) : isLoopbackHostName(name);
9700
9732
  }
9701
- /** 写操作的 Origin 必须为回环(防跨站表单/fetch)。缺失视为放行,由 Content-Type 兜底。 */
9702
- function isLoopbackOrigin(origin) {
9733
+ /** 写操作的 Origin 校验(防跨站表单/fetch)。缺失视为放行,由 Content-Type 兜底。 */
9734
+ function isAllowedOrigin(origin, lan) {
9703
9735
  if (origin === void 0 || origin === "") return true;
9704
9736
  try {
9705
9737
  const host = new URL(origin).hostname;
9706
- return host === "localhost" || host === "::1" || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(host);
9738
+ return lan ? isLanHostName(host) : isLoopbackHostName(host);
9707
9739
  } catch {
9708
9740
  return false;
9709
9741
  }
9710
9742
  }
9743
+ /** 访问面拒绝时的说法:loopback 模式与 lan 模式各说各的边界,方便排障。 */
9744
+ function forbiddenReason(lan) {
9745
+ return lan ? "forbidden: loopback or private LAN only" : "forbidden: loopback only";
9746
+ }
9711
9747
  /**
9712
- * 回环守卫:仅放行回环 GET/POST 请求(peer + Host 同时校验)。
9748
+ * 访问面守卫:GET/POST + peer + Host 同时校验。
9749
+ * @param lan - 是否已开启局域网访问(config.panelAccess = 'lan')。
9713
9750
  * @returns 是否放行;false = 已拒绝并结束响应。
9714
9751
  */
9715
- function guardLoopback(req, res) {
9716
- if (!(req.method === "GET" || req.method === "POST") || !isLoopbackPeer(req) || !isLoopbackHost(req)) {
9752
+ function guardLoopback(req, res, lan = false) {
9753
+ if (!(req.method === "GET" || req.method === "POST") || !isAllowedPeer(req, lan) || !isAllowedHost(req, lan)) {
9717
9754
  res.writeHead(403, { "content-type": "application/json; charset=utf-8" });
9718
- res.end(JSON.stringify({ error: "forbidden: loopback only" }));
9755
+ res.end(JSON.stringify({ error: forbiddenReason(lan) }));
9719
9756
  return false;
9720
9757
  }
9721
9758
  return true;
9722
9759
  }
9723
- /** 写操作守卫:Origin 回环 + Content-Type JSON。 */
9724
- function guardWrite(req, res) {
9725
- if (!isLoopbackOrigin(req.headers.origin)) {
9760
+ /** 写操作守卫:Origin 访问面 + Content-Type JSON(导出仅供守卫单元测试,#49)。 */
9761
+ function guardWrite(req, res, lan) {
9762
+ if (!isAllowedOrigin(req.headers.origin, lan)) {
9726
9763
  res.writeHead(403, { "content-type": "application/json; charset=utf-8" });
9727
- res.end(JSON.stringify({ error: "forbidden: loopback only" }));
9764
+ res.end(JSON.stringify({ error: forbiddenReason(lan) }));
9728
9765
  return false;
9729
9766
  }
9730
9767
  if (!(req.headers["content-type"] ?? "").toLowerCase().includes("application/json")) {
@@ -9849,7 +9886,7 @@ function registerEngramRoutes(ctx, deps) {
9849
9886
  kind: "prefix",
9850
9887
  path: "/api/engram",
9851
9888
  handler: async (req, res) => {
9852
- if (!guardLoopback(req, res)) return;
9889
+ if (!guardLoopback(req, res, deps.panelAccess === "lan")) return;
9853
9890
  const url = new URL(req.url ?? "/", "http://127.0.0.1");
9854
9891
  const route = url.pathname.slice(12);
9855
9892
  const selectorRef = { value: url.searchParams.get("project") ?? void 0 };
@@ -9977,6 +10014,32 @@ function registerEngramRoutes(ctx, deps) {
9977
10014
  });
9978
10015
  return;
9979
10016
  }
10017
+ if (req.method === "POST" && route === "observation-status") {
10018
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10019
+ const body = await readBody(req, res, deps.language);
10020
+ if (body === null) return;
10021
+ adoptBodySelector(body);
10022
+ if (typeof body.id !== "string" || body.id === "") {
10023
+ json(res, 400, { error: "id required" });
10024
+ return;
10025
+ }
10026
+ const status = body.status;
10027
+ if (status !== "active" && status !== "refuted" && status !== "stale") {
10028
+ json(res, 400, { error: "status must be one of active|refuted|stale" });
10029
+ return;
10030
+ }
10031
+ const store = await storeFor(scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user"));
10032
+ const observation = status === "active" ? await store.confirmObservation(asObservationId(body.id)) : status === "refuted" ? await store.refuteObservation(asObservationId(body.id)) : await store.markObservationStale(asObservationId(body.id));
10033
+ if (observation === void 0) {
10034
+ json(res, 404, { error: "observation not found" });
10035
+ return;
10036
+ }
10037
+ json(res, 200, {
10038
+ ok: true,
10039
+ observation
10040
+ });
10041
+ return;
10042
+ }
9980
10043
  if (req.method === "GET" && route === "entities") {
9981
10044
  const scope = scopeOf$1(url.searchParams.get("scope"), "user");
9982
10045
  const kind = url.searchParams.get("kind");
@@ -10119,7 +10182,7 @@ function registerEngramRoutes(ctx, deps) {
10119
10182
  if (req.method === "GET" && route === "log-info" || req.method === "POST" && route === "log-clear") {
10120
10183
  const clear = req.method === "POST";
10121
10184
  if (clear) {
10122
- if (!guardWrite(req, res)) return;
10185
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10123
10186
  const body = await readBody(req, res, deps.language);
10124
10187
  if (body === null) return;
10125
10188
  adoptBodySelector(body);
@@ -10205,7 +10268,7 @@ function registerEngramRoutes(ctx, deps) {
10205
10268
  return;
10206
10269
  }
10207
10270
  if (req.method === "POST" && route === "review-answer") {
10208
- if (!guardWrite(req, res)) return;
10271
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10209
10272
  const body = await readBody(req, res, deps.language);
10210
10273
  if (body === null) return;
10211
10274
  if (typeof body.id !== "string" || body.id === "") {
@@ -10272,7 +10335,7 @@ function registerEngramRoutes(ctx, deps) {
10272
10335
  return;
10273
10336
  }
10274
10337
  if (req.method === "POST" && route === "import") {
10275
- if (!guardWrite(req, res)) return;
10338
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10276
10339
  const bodyResult = await readJsonBody(req, IMPORT_BODY_LIMIT_BYTES);
10277
10340
  if (!bodyResult.ok) {
10278
10341
  if (bodyResult.reason === "too-large") {
@@ -10529,7 +10592,7 @@ function registerEngramRoutes(ctx, deps) {
10529
10592
  return;
10530
10593
  }
10531
10594
  if (req.method === "POST" && route === "dictionary") {
10532
- if (!guardWrite(req, res)) return;
10595
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10533
10596
  const body = await readBody(req, res, deps.language);
10534
10597
  if (body === null) return;
10535
10598
  const set = body.set;
@@ -10544,7 +10607,7 @@ function registerEngramRoutes(ctx, deps) {
10544
10607
  return;
10545
10608
  }
10546
10609
  if (req.method === "POST" && route === "dictionary-create") {
10547
- if (!guardWrite(req, res)) return;
10610
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10548
10611
  const body = await readBody(req, res, deps.language);
10549
10612
  if (body === null) return;
10550
10613
  const language = languageOf(body.language);
@@ -10562,7 +10625,7 @@ function registerEngramRoutes(ctx, deps) {
10562
10625
  return;
10563
10626
  }
10564
10627
  if (req.method === "POST" && route === "dictionary-fill") {
10565
- if (!guardWrite(req, res)) return;
10628
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10566
10629
  const body = await readBody(req, res, deps.language);
10567
10630
  if (body === null) return;
10568
10631
  const set = body.set;
@@ -10578,17 +10641,17 @@ function registerEngramRoutes(ctx, deps) {
10578
10641
  return;
10579
10642
  }
10580
10643
  if (req.method === "POST" && route === "base-label") {
10581
- if (!guardWrite(req, res)) return;
10644
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10582
10645
  json(res, 200, await deps.writeBaseLabels());
10583
10646
  return;
10584
10647
  }
10585
10648
  if (req.method === "POST" && route === "base-convert") {
10586
- if (!guardWrite(req, res)) return;
10649
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10587
10650
  json(res, 200, await deps.convertBases());
10588
10651
  return;
10589
10652
  }
10590
10653
  if (req.method === "POST" && route === "palace-change/open") {
10591
- if (!guardWrite(req, res)) return;
10654
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10592
10655
  const language = await deps.palaceCurrentLanguage();
10593
10656
  const window = deps.palaceGuard.open(language, Date.now());
10594
10657
  json(res, 200, {
@@ -10601,7 +10664,7 @@ function registerEngramRoutes(ctx, deps) {
10601
10664
  return;
10602
10665
  }
10603
10666
  if (req.method === "POST" && route === "palace-change") {
10604
- if (!guardWrite(req, res)) return;
10667
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10605
10668
  const body = await readBody(req, res, deps.language);
10606
10669
  if (body === null) return;
10607
10670
  const verdict = deps.palaceGuard.check(typeof body.language === "string" ? body.language : "", Date.now(), deps.palaceChangeWindowSec);
@@ -10632,7 +10695,7 @@ function registerEngramRoutes(ctx, deps) {
10632
10695
  return;
10633
10696
  }
10634
10697
  if (req.method === "POST" && route === "palace-language") {
10635
- if (!guardWrite(req, res)) return;
10698
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10636
10699
  const body = await readBody(req, res, deps.language);
10637
10700
  if (body === null) return;
10638
10701
  const wanted = body.language;
@@ -10683,7 +10746,7 @@ function registerEngramRoutes(ctx, deps) {
10683
10746
  return;
10684
10747
  }
10685
10748
  if (req.method === "POST" && route === "history-backfill/start") {
10686
- if (!guardWrite(req, res)) return;
10749
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10687
10750
  const body = await readBody(req, res, deps.language);
10688
10751
  if (body === null) return;
10689
10752
  const started = deps.history.start(historyRulesOf(body));
@@ -10701,7 +10764,7 @@ function registerEngramRoutes(ctx, deps) {
10701
10764
  return;
10702
10765
  }
10703
10766
  if (req.method === "POST" && route === "history-backfill/cancel") {
10704
- if (!guardWrite(req, res)) return;
10767
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10705
10768
  deps.history.cancel();
10706
10769
  json(res, 200, {
10707
10770
  ok: true,
@@ -10718,7 +10781,7 @@ function registerEngramRoutes(ctx, deps) {
10718
10781
  return;
10719
10782
  }
10720
10783
  if (req.method === "POST" && route === "jev-config") {
10721
- if (!guardWrite(req, res)) return;
10784
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10722
10785
  const body = await readBody(req, res, deps.language);
10723
10786
  if (body === null) return;
10724
10787
  const parsed = parseJevPatch(loadJevOverride(deps.jev.dbDir), body);
@@ -10738,7 +10801,7 @@ function registerEngramRoutes(ctx, deps) {
10738
10801
  return;
10739
10802
  }
10740
10803
  if (req.method === "POST" && route === "jev-test") {
10741
- if (!guardWrite(req, res)) return;
10804
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10742
10805
  const body = await readBody(req, res, deps.language);
10743
10806
  if (body === null) return;
10744
10807
  const base = effectiveJevConfig(deps.jev.base, loadJevOverride(deps.jev.dbDir));
@@ -10773,7 +10836,7 @@ function registerEngramRoutes(ctx, deps) {
10773
10836
  return;
10774
10837
  }
10775
10838
  if (req.method === "POST" && route === "jev-models") {
10776
- if (!guardWrite(req, res)) return;
10839
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10777
10840
  const body = await readBody(req, res, deps.language);
10778
10841
  if (body === null) return;
10779
10842
  const provider = typeof body.provider === "string" ? body.provider.trim() : "";
@@ -10793,7 +10856,7 @@ function registerEngramRoutes(ctx, deps) {
10793
10856
  return;
10794
10857
  }
10795
10858
  if (req.method === "POST" && route === "consolidate") {
10796
- if (!guardWrite(req, res)) return;
10859
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10797
10860
  const body = await readBody(req, res, deps.language);
10798
10861
  if (body === null) return;
10799
10862
  adoptBodySelector(body);
@@ -10807,7 +10870,7 @@ function registerEngramRoutes(ctx, deps) {
10807
10870
  return;
10808
10871
  }
10809
10872
  if (req.method === "POST" && route === "backup") {
10810
- if (!guardWrite(req, res)) return;
10873
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10811
10874
  const result = await createBackup(deps.dbDir, deps.pluginVersion);
10812
10875
  json(res, 200, {
10813
10876
  archivePath: result.archivePath,
@@ -10818,7 +10881,7 @@ function registerEngramRoutes(ctx, deps) {
10818
10881
  return;
10819
10882
  }
10820
10883
  if (req.method === "POST" && route === "restore-backup") {
10821
- if (!guardWrite(req, res)) return;
10884
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10822
10885
  const body = await readBody(req, res, deps.language);
10823
10886
  if (body === null) return;
10824
10887
  if (typeof body.archivePath !== "string" || body.archivePath === "") {
@@ -10845,7 +10908,7 @@ function registerEngramRoutes(ctx, deps) {
10845
10908
  return;
10846
10909
  }
10847
10910
  if (req.method === "POST" && (route === "update" || route === "forget" || route === "restore")) {
10848
- if (!guardWrite(req, res)) return;
10911
+ if (!guardWrite(req, res, deps.panelAccess === "lan")) return;
10849
10912
  const body = await readBody(req, res, deps.language);
10850
10913
  if (body === null) return;
10851
10914
  if (typeof body.id !== "string" || body.id === "") {
@@ -10894,8 +10957,7 @@ function registerEngramRoutes(ctx, deps) {
10894
10957
  }
10895
10958
  }), "dsh-engram: api routes");
10896
10959
  }
10897
- //#endregion
10898
- //#region src/registry/base-state.ts
10960
+ // src/registry/base-state.ts
10899
10961
  /**
10900
10962
  * Состояние базы дворца: на чём она стоит и что с ней будет делать кнопка.
10901
10963
  *
@@ -11080,8 +11142,7 @@ function labelToStamp(input) {
11080
11142
  if (facts.rows === 0) return target.label;
11081
11143
  return judgeBase(input).action === "write-label" ? target.label : void 0;
11082
11144
  }
11083
- //#endregion
11084
- //#region src/registry/base-census.ts
11145
+ // src/registry/base-census.ts
11085
11146
  /**
11086
11147
  * Факты о базе дворца: что в ней лежит — только чтение.
11087
11148
  *
@@ -11386,8 +11447,7 @@ async function runVectorConvert(input) {
11386
11447
  failed
11387
11448
  };
11388
11449
  }
11389
- //#endregion
11390
- //#region src/registry/palace-guard.ts
11450
+ // src/registry/palace-guard.ts
11391
11451
  /**
11392
11452
  * Предохранитель смены языка дворца: состояние на сервере, а не в панели.
11393
11453
  *
@@ -11513,8 +11573,7 @@ var PalaceGuard = class {
11513
11573
  return Math.max(left, 0);
11514
11574
  }
11515
11575
  };
11516
- //#endregion
11517
- //#region src/registry/vector-schema.ts
11576
+ // src/registry/vector-schema.ts
11518
11577
  /**
11519
11578
  * Объявление схемы данных: какие таблицы несут векторы и по какому условию.
11520
11579
  *
@@ -11676,8 +11735,7 @@ function loadVectorSchema(sources) {
11676
11735
  problems
11677
11736
  };
11678
11737
  }
11679
- //#endregion
11680
- //#region src/project/identity.ts
11738
+ // src/project/identity.ts
11681
11739
  /**
11682
11740
  * 项目标识:git origin URL 归一化 → sha256 短哈希分库名;无 git 或无 origin 时
11683
11741
  * 回退完整 cwd 哈希。纯文件读(.git/config、worktree 的 gitdir/commondir
@@ -11874,8 +11932,7 @@ function migrationWarning(dbDir, identity, outcome) {
11874
11932
  }
11875
11933
  }
11876
11934
  }
11877
- //#endregion
11878
- //#region src/project/registry.ts
11935
+ // src/project/registry.ts
11879
11936
  /**
11880
11937
  * 项目宫殿清单:把 dsh 的工作区(`ctx.workspaceRegistry` 的注册表)与会话 cwd
11881
11938
  * 映射成记忆分库,供管理面板「切换/显示当前工作区」使用。
@@ -11987,8 +12044,7 @@ function assignSlot(kind, occupancy) {
11987
12044
  };
11988
12045
  }
11989
12046
  }
11990
- //#endregion
11991
- //#region src/review/sm2.ts
12047
+ // src/review/sm2.ts
11992
12048
  /** ease 系数下限(SM-2 标准值):低于此值记忆会陷入过密复习。 */
11993
12049
  const MIN_EASE = 1.3;
11994
12050
  const DAY_MS = 864e5;
@@ -12019,8 +12075,7 @@ function nextSchedule(grade, state, now) {
12019
12075
  reps
12020
12076
  };
12021
12077
  }
12022
- //#endregion
12023
- //#region src/i18n/dates.ts
12078
+ // src/i18n/dates.ts
12024
12079
  /** Относительные даты и дни недели по языкам. Числовые формы — общие, см. ниже. */
12025
12080
  const DATE_WORDS = {
12026
12081
  zh: [
@@ -12113,8 +12168,7 @@ function placardImprovementHint(score) {
12113
12168
  if (score >= .5) return null;
12114
12169
  return message("misc.placardImprovementHint");
12115
12170
  }
12116
- //#endregion
12117
- //#region src/store/sqlite.ts
12171
+ // src/store/sqlite.ts
12118
12172
  /**
12119
12173
  * EngramStore 的 node:sqlite 实现:节点表 + 边表 + FTS5(unicode61 + 中文 2-gram 预切词)
12120
12174
  * + 操作日志,单调 SCHEMA_VERSION,打开时校验、不兼容拒绝加载(不写兼容 shim)。
@@ -12629,6 +12683,8 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
12629
12683
  };
12630
12684
  const sqlImportEntityAliases = db.prepare("UPDATE entities SET aliases_json = ?, updated_at = ? WHERE id = ?");
12631
12685
  const sqlDecay = db.prepare(`UPDATE nodes SET status = 'archived'
12686
+ WHERE status = 'active' AND importance < ? AND last_accessed_at < ? AND next_review_at IS NULL`);
12687
+ const sqlDecayVictims = db.prepare(`SELECT id FROM nodes
12632
12688
  WHERE status = 'active' AND importance < ? AND last_accessed_at < ? AND next_review_at IS NULL`);
12633
12689
  const sqlScheduleReview = db.prepare(`UPDATE nodes
12634
12690
  SET next_review_at = ?, ease_factor = ?, interval_days = ?, review_reps = ?, last_accessed_at = ?
@@ -12696,8 +12752,52 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
12696
12752
  const sqlObservationSetStatus = db.prepare("UPDATE observations SET status = ?, updated_at = ?, last_validated_at = ? WHERE id = ?");
12697
12753
  const sqlObservationMarkStale = db.prepare("UPDATE observations SET status = 'stale' WHERE id = ?");
12698
12754
  const sqlObservationRefute = db.prepare("UPDATE observations SET status = 'refuted', updated_at = ? WHERE id = ?");
12755
+ const sqlObservationEvidenceHit = db.prepare(`SELECT id, sources_json FROM observations
12756
+ WHERE status IN ('active','stale') AND instr(sources_json, ?) > 0`);
12757
+ const sqlObservationDetachStale = db.prepare("UPDATE observations SET status = 'stale', sources_json = ?, proof_count = ? WHERE id = ?");
12699
12758
  const sqlObservationActiveVectors = db.prepare(`SELECT * FROM observations WHERE status != 'refuted' AND embedding IS NOT NULL AND LENGTH(embedding) % ${Float32Array.BYTES_PER_ELEMENT} = 0`);
12700
12759
  const sqlPurgeObservations = db.prepare("DELETE FROM observations");
12760
+ /**
12761
+ * 归档传播(#48 Fix A):源记忆死亡(forget/闭馆/supersede/蒸馏/衰减归档)时,把以它为
12762
+ * 证据的 active/stale 信念扣源——instr 带引号子串只是预筛,落库前对 JSON.parse 结果做
12763
+ * 精确成员过滤再去重。证据耗尽置 refuted(与 refuteObservation 同款:刷 updated_at,
12764
+ * last_validated_at 保留为上次成立时间);尚有余证置 stale 并重写 sources_json/proof_count
12765
+ * (不刷 updated_at,复核队列顺序语义不变)。refuted 是终态审计标记,不参与传播;
12766
+ * restore 也不调用本 helper:节点复活时信念保持既有状态,由下次复核确认回来。
12767
+ * 返回 { staled, refuted } 计数,调用方可忽略。
12768
+ */
12769
+ const detachArchivedEvidence = (nodeIds) => {
12770
+ const dead = [...new Set(nodeIds.map(String))].filter((nodeId) => nodeId !== "");
12771
+ let staled = 0;
12772
+ let refuted = 0;
12773
+ const processed = /* @__PURE__ */ new Set();
12774
+ for (const deadId of dead) {
12775
+ const hits = sqlObservationEvidenceHit.all(`"${deadId}"`);
12776
+ for (const hit of hits) {
12777
+ if (processed.has(hit.id)) continue;
12778
+ processed.add(hit.id);
12779
+ let sources;
12780
+ try {
12781
+ const parsed = JSON.parse(hit.sources_json);
12782
+ sources = Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
12783
+ } catch {
12784
+ sources = [];
12785
+ }
12786
+ const remaining = [...new Set(sources.filter((source) => !dead.includes(source)))];
12787
+ if (remaining.length === 0) {
12788
+ sqlObservationRefute.run(Date.now(), hit.id);
12789
+ refuted += 1;
12790
+ } else {
12791
+ sqlObservationDetachStale.run(JSON.stringify(remaining), remaining.length, hit.id);
12792
+ staled += 1;
12793
+ }
12794
+ }
12795
+ }
12796
+ return {
12797
+ staled,
12798
+ refuted
12799
+ };
12800
+ };
12701
12801
  /** FTS 道:按 scope 集合检索(占位符动态生成,scope 集合由调用方去重);rooms 非空时只查指定房间。 */
12702
12802
  const ftsSearch = (match, scopes, rooms) => {
12703
12803
  const placeholders = scopes.map(() => "?").join(",");
@@ -13194,6 +13294,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
13194
13294
  sqlRevisionInsert.run(input.id, old.content, old.kind, old.importance, at);
13195
13295
  sqlSetStatus.run("archived", at, input.id);
13196
13296
  sqlLog.run(at, "superseded", input.id, JSON.stringify({ supersededBy: id }));
13297
+ detachArchivedEvidence([input.id]);
13197
13298
  const imagery = input.imagery ?? jsonToImagery(old.imagery_json);
13198
13299
  const updateInput = {
13199
13300
  scope: input.scope,
@@ -13213,6 +13314,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
13213
13314
  if (getRow(id) === void 0) throw new EngramError("NOT_FOUND", message("store.entryNotFound", { id }));
13214
13315
  sqlSetStatus.run("forgotten", Date.now(), id);
13215
13316
  sqlLog.run(Date.now(), "forget", id, null);
13317
+ detachArchivedEvidence([id]);
13216
13318
  return rowToRecord(sqlGet.get(id));
13217
13319
  },
13218
13320
  async forgetWithTombstone(id, tombstone) {
@@ -13225,6 +13327,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
13225
13327
  };
13226
13328
  sqlSetStatus.run("forgotten", at, id);
13227
13329
  sqlLog.run(at, "forget", id, JSON.stringify({ tombstone: cleaned }));
13330
+ detachArchivedEvidence([id]);
13228
13331
  return rowToRecord(sqlGet.get(id));
13229
13332
  },
13230
13333
  async listForgottenWithTombs(limit) {
@@ -13652,9 +13755,13 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
13652
13755
  },
13653
13756
  async decay(options) {
13654
13757
  const cutoff = Date.now() - options.olderThanDays * 864e5;
13758
+ const victims = sqlDecayVictims.all(options.importanceBelow, cutoff).map((row) => row.id);
13655
13759
  const result = sqlDecay.run(options.importanceBelow, cutoff);
13656
13760
  const changed = Number(result.changes);
13657
- if (changed > 0) sqlLog.run(Date.now(), "decay", "BATCH", JSON.stringify({ archived: changed }));
13761
+ if (changed > 0) {
13762
+ sqlLog.run(Date.now(), "decay", "BATCH", JSON.stringify({ archived: changed }));
13763
+ detachArchivedEvidence(victims);
13764
+ }
13658
13765
  return changed;
13659
13766
  },
13660
13767
  async findContradictions(embedding, limit = 3) {
@@ -13743,6 +13850,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
13743
13850
  sqlSetStatus.run("archived", at, oldId);
13744
13851
  sqlEdgeUpsert.run(id, oldId, "supersedes", at);
13745
13852
  }
13853
+ detachArchivedEvidence(oldIds);
13746
13854
  });
13747
13855
  return rowToRecord(sqlGet.get(id));
13748
13856
  },
@@ -14021,8 +14129,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
14021
14129
  }
14022
14130
  };
14023
14131
  }
14024
- //#endregion
14025
- //#region src/flywheel/distill.ts
14132
+ // src/flywheel/distill.ts
14026
14133
  /**
14027
14134
  * 知识飞轮的蒸馏步骤:把同主题的记忆簇由辅助 LLM 合并提炼为更高层的
14028
14135
  * skill/fact,被合并条目归档并逐条建立 supersedes 链,新条目继承簇内
@@ -14197,8 +14304,7 @@ function mergeQueryResults(retrievals, limit, rrfConstant, minPerQuery) {
14197
14304
  const reserved = new Set(retrievals.flatMap((retrieval) => retrieval.hits.slice(0, perQueryKeep).map((hit) => hit.record.id)));
14198
14305
  return [...ranked.filter((entry) => reserved.has(entry.hit.record.id)), ...ranked.filter((entry) => !reserved.has(entry.hit.record.id))].slice(0, Math.max(0, limit)).map((entry) => entry.hit);
14199
14306
  }
14200
- //#endregion
14201
- //#region src/retrieve/budget.ts
14307
+ // src/retrieve/budget.ts
14202
14308
  /**
14203
14309
  * 召回输出的字符预算:单条与总量双重截断,控制记忆正文占用的模型上下文
14204
14310
  * (协议内定值,对齐同类记忆插件的单轮召回配额,非部署可变项)。
@@ -14408,8 +14514,7 @@ function assessEvidence(batch, request) {
14408
14514
  forced: claimed !== sufficient || strategy !== requestedStrategy || nextStrategy !== strategy
14409
14515
  };
14410
14516
  }
14411
- //#endregion
14412
- //#region src/tools/create.ts
14517
+ // src/tools/create.ts
14413
14518
  /**
14414
14519
  * 23 个 engram_ 工具的定义与执行器。工具 schema 保持窄参数;
14415
14520
  * scope 决定读写哪个分库;嵌入缺失时检索结果显式标记降级。
@@ -17270,8 +17375,7 @@ function renderTourNarrative(stops, query) {
17270
17375
  });
17271
17376
  return lines.join("\n");
17272
17377
  }
17273
- //#endregion
17274
- //#region src/selection-rationale.ts
17378
+ // src/selection-rationale.ts
17275
17379
  /**
17276
17380
  * 注入归因:把画像中每条记忆按启发式打标签(recent / bright / corridor-hit / strong-evidence),
17277
17381
  * 输出成 XML 注解块附加在画像文本前,让 agent 知道「为什么这条进了宫」。
@@ -17319,8 +17423,7 @@ function reasonsLabel(reasons) {
17319
17423
  };
17320
17424
  return reasons.map((r) => LABELS[r]).join(" / ");
17321
17425
  }
17322
- //#endregion
17323
- //#region src/token.ts
17426
+ // src/token.ts
17324
17427
  /**
17325
17428
  * token 估算:CJK 感知的上下文预算口径。
17326
17429
  *
@@ -17351,11 +17454,9 @@ function estimateTokens(text) {
17351
17454
  else narrow += 1;
17352
17455
  return Math.ceil(wide * WIDE_TOKENS_PER_CHAR + narrow / 4);
17353
17456
  }
17354
- //#endregion
17355
- //#region package.json
17356
- var version = "0.11.5";
17357
- //#endregion
17358
- //#region src/index.ts
17457
+ // package.json
17458
+ var version = "0.11.6";
17459
+ // src/index.ts
17359
17460
  /**
17360
17461
  * dsh-engram:DeepSeek Harness 跨会话长期记忆插件(host 半)。
17361
17462
  * 注册 23 个 engram_ 工具、会话开始注入画像(curated block 优先于派生画像)、
@@ -18761,6 +18862,7 @@ async function apply(ctx, config = {}) {
18761
18862
  dbDir: resolved.dbDir,
18762
18863
  pluginVersion: VERSION,
18763
18864
  language: resolved.language,
18865
+ panelAccess: resolved.panelAccess,
18764
18866
  registry: () => registryView,
18765
18867
  dictionaryLanguages: languagesWithDictionary,
18766
18868
  baseStates,
@@ -18902,6 +19004,7 @@ async function apply(ctx, config = {}) {
18902
19004
  confirmed: outcome.confirmed,
18903
19005
  refuted: outcome.refuted
18904
19006
  }));
19007
+ if (outcome.dropped > 0) console.warn(message("core.warnReflectBatchDropped", { count: outcome.dropped }));
18905
19008
  } catch (error) {
18906
19009
  console.warn(message("core.warnReflectFailed", { scope: target.scope }), error);
18907
19010
  }
@@ -18978,5 +19081,4 @@ async function apply(ctx, config = {}) {
18978
19081
  };
18979
19082
  }, "dsh-engram: consolidation timer");
18980
19083
  }
18981
- //#endregion
18982
19084
  export { CURATED_HEADER, Config, DEFAULT_ITEM_BUDGET, VERSION, apply, inject, name, renderProfile, renderProfileDetailed, renderProfileParts };