@modusensus/dsh-mneme 0.10.1 → 0.12.0

package/src/choro-command.js

@@ -0,0 +1,104 @@
+// dsh-mneme/src/choro-command.js
+// /choro：仓库地志的只读回执（M3，spec §10）。
+//
+// 与 pipeline-command.js 的区别：那边持有状态（开窗 / 结账），这边**什么都不写**。
+// spec §2 D6 定的是「只手动触发，过期只提示」——重建、富化、切档位全都不在这条
+// 命令里，它只回答三个问题：当前仓库登记过地志吗？基线还一致吗？提纲长什么样？
+import { gitHead } from "./wiki/t0.js";
+import { renderChoroBlock } from "./wiki/inject.js";
+import { STR } from "./lang.js";
+
+export const CHORO_COMMAND = "choro";
+
+/** 短 sha：回执里只用于人眼比对，给全 40 位纯属噪音。 */
+function shortSha(sha) {
+  const text = String(sha ?? "").trim();
+  return text.length > 7 ? text.slice(0, 7) : text;
+}
+
+/** 生成时间只留日期（与注入块同口径：分钟级精度在这块文本里没有信息量）。 */
+function dateOnly(iso) {
+  const m = /^(\d{4}-\d{2}-\d{2})/.exec(String(iso ?? ""));
+  return m ? m[1] : String(iso ?? "");
+}
+
+/**
+ * 过期判定：地志落库时的 git 基线 vs 当前 HEAD。
+ *
+ * **只在这里做**——注入块是每轮都要渲染的热路径，fork 一次 git 在 Windows 上
+ * 几十毫秒起步（P29）。这里是用户主动敲的，付得起一次 rev-parse。
+ * 三种结局分开报：一致 / 不一致 / 读不到 git——不能把「读不到」说成「没过期」。
+ */
+function staleness(repo) {
+  const baseline = String(repo.git_baseline ?? "").trim();
+  const head = gitHead(repo.root_path);
+  if (!head) return { state: "no-git", baseline, head: null };
+  if (baseline && baseline === head) return { state: "fresh", baseline, head };
+  return { state: "stale", baseline, head };
+}
+
+/**
+ * 处理函数。返回 CommandResult 形状 { kind, text }——**只作 UI 回执，不进模型
+ * 上下文**（同 pipeline-command.js 的契约注释）；要模型看提纲，走开局注入那条路。
+ *
+ * @param {object} opts.choro createChoroQueries() 的产物
+ * @param {object} opts.config 合并后的配置
+ * @param {() => string} [opts.language]
+ */
+export function createChoroHandler({ choro, config, language = () => "zh" } = {}) {
+  return (invocation) => {
+    const lang = language() === "en" ? "en" : "zh";
+    const S = STR.choroCommandUsage[lang];
+    try {
+      // 闸只认 chorographyEnabled，不认注入档位：resolveInjectTier 在轻量档下也返回
+      // "off"，用它当闸会让 lightMode 的用户敲 /choro 时听到「没开，去设置里打开」
+      // ——而设置里明明是开着的（档位只管注入，不管这条命令能不能看提纲）。
+      if (!config || config.chorographyEnabled !== true) return { kind: "error", text: S.off };
+      const raw = invocation?.agent?.session?.header?.cwd ?? null;
+      const cwd = typeof raw === "string" ? raw.trim() : "";
+      if (!cwd) return { kind: "error", text: S.noCwd };
+      const repo = choro ? choro.repoByCwd(cwd) : null;
+      if (!repo) return { kind: "error", text: S.noRepo(cwd) };
+      const outline = choro.outline(repo.id);
+      if (!outline || outline.modules.length === 0) {
+        return { kind: "success", text: S.title(repo.name, 0, dateOnly(repo.updated_at)) + "\n" + S.empty };
+      }
+      const lines = [S.title(repo.name, outline.modules.length, dateOnly(outline.generatedAt))];
+      // 命令里的清单不设 light 的 6 行上限：人主动敲了命令就是要看全表。
+      // 但 full 档的字符上限仍由 renderChoroBlock 自己兜——回执是 UI 里一个文本框，
+      // 贴爆它同样是失败（上限不在这里判，两处各判一次迟早对不上）。
+      const block = renderChoroBlock(outline, "full", lang);
+      if (block) lines.push(block.split("\n").slice(1).join("\n"));
+      // 截断语要说「还剩几个」，不是「总共几个」：总表格行数减去真列出来的行数才是
+      // 读者没看到的量。传总数会让人以为「另有 38 个」而实际只漏了 3 个。
+      const listed = block ? block.split("\n").filter((line) => line.startsWith("- ")).length : 0;
+      const rest = Math.max(0, outline.modules.length - listed);
+      if (rest > 0) lines.push(S.truncated(rest));
+      const head = staleness(repo);
+      if (head.state === "fresh") lines.push(S.fresh(shortSha(head.head)));
+      else if (head.state === "stale") lines.push(S.stale(shortSha(head.baseline), shortSha(head.head)));
+      else lines.push(S.noGit);
+      lines.push(S.hint);
+      return { kind: "success", text: lines.filter(Boolean).join("\n") };
+    } catch (error) {
+      // 回执层永不抛进宿主（同 pipeline-command.js）：把原因写进文本就够了。
+      return { kind: "error", text: String(error?.message ?? error) };
+    }
+  };
+}
+
+/**
+ * 注册。返回 disposer 或 null（宿主没有命令注册表时静默返回 null，不抛）。
+ * 形状与 registerMoRunCommand 一致——两条内置命令只有「做什么」不同。
+ */
+export function registerChoroCommand({ ctx, choro, config, enabled, language = () => "zh" }) {
+  if (enabled !== true) return null;
+  if (typeof ctx?.commands?.register !== "function") return null;
+  const lang = language() === "en" ? "en" : "zh";
+  return ctx.commands.register({
+    name: CHORO_COMMAND,
+    description: STR.choroCommandDescription[lang],
+    input: { hint: STR.choroCommandInputHint[lang] },
+    handler: createChoroHandler({ choro, config, language })
+  });
+}

package/src/config-keys.js

@@ -0,0 +1,144 @@
+// 配置键覆盖面的「唯一一份」描述（issue #386 第 7 条）。
+//
+// 为什么单独一个模块：面板上能改的键（settings.js 白名单）与 schema 里实际存在的
+// 键（config.js 的 Config）是两张表，它们从来没被摆在同一个地方对过。于是
+// 「用户能理解、但面板改不到」的键只能靠读源码 + 手数得到答案——issue #386 列了
+// 七组、维护者另外复述了一遍，每次都要重新数。
+//
+// 这里只做「算」：把 schema 声明的叶子键与白名单取交/差，回三份清单。它不读
+// 数据库、不碰 cfg 的实际值、**不返回任何键的值**——apiToken 这类敏感键的名字可以
+// 出现在「仅配置文件」清单里（那正是这条 issue 想让用户看见的东西），值一个字节
+// 都不出。判定口径住在 flagKeysFromSpec，api.js 的 featureSnapshot 用的也是它；
+// 谁要是另抄一份白名单，test/config-keys-routes.test.js 的静态锁直接转红。
+
+import { Config } from "./config.js";
+import { FEATURE_FLAG_SPEC } from "./settings.js";
+
+/**
+ * 白名单里的全部键（面板 PUT 能写、effective 会算的那些）。
+ *
+ * 顺序与 api.js 的 featureSnapshot 逐字对应：booleans → ints → numbers → strings
+ * → urls → enums。api.js 直接引这一份，不再自己拼一遍。
+ */
+export function flagKeysFromSpec() {
+  return [
+    ...FEATURE_FLAG_SPEC.booleans,
+    ...Object.keys(FEATURE_FLAG_SPEC.ints),
+    ...Object.keys(FEATURE_FLAG_SPEC.numbers),
+    ...FEATURE_FLAG_SPEC.strings,
+    ...FEATURE_FLAG_SPEC.urls,
+    ...Object.keys(FEATURE_FLAG_SPEC.enums)
+  ];
+}
+
+/**
+ * 把「已解析的配置对象」摊平成叶子键清单。
+ *
+ * 这份清单的含义是**「有默认值因此会出现在 effective 里的键」**，不是「schema 声明
+ * 了哪些键」——两者不等。`Config({})` 解析后 `apiToken` 根本不存在（`z.string()`
+ * 没有 `.default()`），若拿它当 schema 清单，最该被用户看见的那个键反而消失了
+ * （第一版就是这么错的，被 `config-keys returns key names but never the apiToken
+ * value` 那条用例抓住）。
+ *
+ * 数组当叶子（`sessionGateSessions` 是 `z.array`，面板没有编辑器，整条替换不算
+ * 「改一个值」）。
+ */
+export function defaultedLeafKeys(instance = Config({})) {
+  const out = [];
+  const walk = (node, prefix) => {
+    for (const key of Object.keys(node)) {
+      const value = node[key];
+      const path = prefix ? `${prefix}.${key}` : key;
+      if (value !== null && typeof value === "object" && !Array.isArray(value)) walk(value, path);
+      else out.push(path);
+    }
+  };
+  walk(instance, "");
+  return out;
+}
+
+/**
+ * schema **声明**的全部叶子键（含没有默认值的那些，比如 apiToken）。
+ *
+ * 直接走 schema 的 ref 图而不是解析结果：`Config.dict` 里每一项都是
+ * `{ uid, refs }`，真实节点在 `refs[uid]`。三种形状要分开处理：
+ *   - `object`：有 `dict`，递归进去；
+ *   - `dict`：键是开放的（`heatTypeDecay` 就是），只能靠 `meta.default` 的对象键
+ *     把已知的那几个名字还原出来；没有默认值就整条当一个叶子；
+ *   - 其它：叶子。
+ *
+ * 探针实测：声明叶子 196 个、解析结果 191 个、白名单 113 个。两边差的那五个是
+ * `dreamProvider` / `dreamModel` / `dreamReasoningEffort` / `apiToken` /
+ * `sleepReasoningEffort`——都只声明、没给默认值。
+ */
+export function schemaLeafKeys(schema = Config) {
+  const out = [];
+  const resolve = (node) => (node && node.refs && node.uid in node.refs ? node.refs[node.uid] : node);
+  const walk = (node, prefix) => {
+    const real = resolve(node);
+    if (!real) return;
+    if (real.type === "object" && real.dict) {
+      for (const key of Object.keys(real.dict)) walk(real.dict[key], prefix ? `${prefix}.${key}` : key);
+      return;
+    }
+    if (real.type === "dict") {
+      const def = real.meta && real.meta.default;
+      if (def && typeof def === "object" && !Array.isArray(def)) {
+        for (const key of Object.keys(def)) out.push(`${prefix}.${key}`);
+        return;
+      }
+    }
+    out.push(prefix);
+  };
+  if (schema && schema.dict) {
+    for (const key of Object.keys(schema.dict)) walk(schema.dict[key], key);
+  }
+  return out;
+}
+
+/**
+ * 三份清单 + 计数。#386 第 7 条要的答案全在这里。
+ *
+ * - `panelEditable`：schema 声明了、且白名单也登记了的键（面板能改）。
+ * - `fileOnly`：schema 声明了、面板改不到的键——issue 正文点名的那七组都在里面，
+ *   连同 `apiToken`、`memoryDir` 这类「知道它存在就够了」的键。
+ * - `undefaulted`：白名单登记了、schema 也有，**但没有 `.default()`**，所以
+ *   `effective` 里根本不会出现它。**这是本轮读码发现的一处真实不对称**：
+ *   `dreamProvider` / `dreamModel` 在 settings.js 的 STRINGS 表里，config.js 那边
+ *   只有 `z.string().description(...)` 而没有 `.default()`，于是面板有输入框、保存
+ *   也能存，但 `featureSnapshot()` 的 `configFlagValue` 取到 undefined 就不写进
+ *   effective（api.js 的 `if (value !== undefined)`）。列出来而不擅自补默认值：
+ *   补默认值会改变「未配置时到底用哪个模型」的既有行为，那是另一个决定。
+ *
+ * 三份互不相交，并集 = 白名单 ∪（声明里不在白名单的那批）——探针实测白名单
+ * 113 个全部都在声明里，所以并集就是声明的 196 个，一个不漏也不重复。
+ */
+export function describeConfigKeys() {
+  const declared = schemaLeafKeys();
+  const declaredSet = new Set(declared);
+  const defaulted = new Set(defaultedLeafKeys());
+  const flags = flagKeysFromSpec();
+  const flagSet = new Set(flags);
+
+  const panelEditable = [];
+  const undefaulted = [];
+  for (const key of flags) {
+    if (!declaredSet.has(key)) continue;
+    if (defaulted.has(key)) panelEditable.push(key);
+    else undefaulted.push(key);
+  }
+  const fileOnly = declared.filter((key) => !flagSet.has(key));
+
+  return {
+    counts: {
+      schemaLeaf: declared.length,
+      flag: flags.length,
+      panelEditable: panelEditable.length,
+      fileOnly: fileOnly.length,
+      undefaulted: undefaulted.length
+    },
+    panelEditable,
+    fileOnly,
+    undefaulted
+  };
+}

package/src/config.js

@@ -130,6 +130,15 @@ export const Config = z.object({
   // 关闭时行为与之前完全一致。
   codingRetrospect: z.boolean().default(false),
   // 编码任务识别词表（读取侧门控用）：命中即视为编码类任务，编码记忆才注入。
+  // 后一组是「工程协作动作」词：合并/开 PR/看 CI/发版/验收/冲突/分支/
+  // issue 这类话在原词表里一个都不命中，于是被判成非编码任务，编码记忆
+  // 整类被 codingGate 滤掉——生产日志里这类 query 占非编码调用的 17.1~17.8%。
+  // 只加中文：isCodingTask 是纯子串匹配，英文短词（pr/ci/commit）会命中
+  // prompt / GitHub CLI 路径这类文本，无词边界时误命中率达 57.9%。
+  // 「评审」与「审评」并列保留，不是笔误：她真实说「等审评」「看CI和审评」
+  // （非编码池内审评 9 条 / 717 次，评审 5 条 / 421 次，审评反而更多），
+  // 同义不同形，子串匹配必须两套都放，删掉任一个都会漏掉一类真实说法。
+  // 刻意不加的：事务（唯一命中是政治学「公共事务」简答）、依赖包（依赖已在表内）。
   codingKeywords: z.array(z.string()).default([
     "代码", "编码", "写一个", "写个", "实现", "函数", "方法", "类",
     "接口", "bug", "调试", "报错", "错误", "异常", "堆栈", "脚本",
@@ -138,7 +147,12 @@ export const Config = z.object({
     "测试", "单测", "修复", "补丁", "依赖", "npm", "pip",
     "命令行", "shell", "配置", "配置文件", "yaml", "json",
     "插件", "开发", "编译", "构建", "部署", "git", "commit",
-    "review", "前端", "后端", "页面", "组件", "dsh", "memos"
+    "review", "前端", "后端", "页面", "组件", "dsh", "memos",
+    "提交", "合并", "分支", "冲突", "验收", "审查", "评审", "审评", "发版",
+    "仓库", "回滚", "推送", "拉取", "变基", "上线", "打包", "迁移",
+    "字段", "鉴权", "超时", "并发", "闪退", "白屏", "端口", "进程",
+    "守护", "定时任务", "索引", "缓存", "死锁", "内存泄漏", "日志",
+    "版本号", "环境变量"
   ]),
   // 编码记忆注入加权系数：编码任务时对 rejected_solution/pitfall/constraint
   // 记忆的 importance 乘以该系数排序，让编码记忆在编码场景更靠前。
@@ -696,6 +710,10 @@ export const Config = z.object({
   //       injection sort re-ranks by importance * quality_score/100 (degraded)
   //   score < 30 → archived + tagged low_quality (still explicitly searchable)
   // Meta-memory markers, near-duplicates and repetitive filler lose points.
+  // "Repetitive" is trigram repetition > 0.7 (this change). The shipped v0.7.12
+  // measure was unique-chars/total, which decays with length: it flagged 94% of
+  // 800-2000 char memories and 100% of longer ones, i.e. long Chinese prose was
+  // punished for being long. Threshold rationale lives in quality-filter.js.
   memoryQualityFilter: z.object({
     enabled: z.boolean().default(true),
     archiveThreshold: z.natural().min(1).max(100).default(30),
@@ -888,6 +906,30 @@ export const Config = z.object({
   // 「用户开关 > 轻量预设 > bundle」，同 continuityRescueEnabled / distillRecords.enabled）。
   organizeEnabled: z.boolean().default(false),
 
+  // chorography（仓库地志，spec: docs/specs/2026-11-04-chorography-design.md）的
+  // 暴露闸（opt-in，默认关）：管模型侧三个只读工具（choro_search / read_page /
+  // module_map）、面板浏览页，以及 M3 的开局注入。工具描述常驻模型上下文 = 新增
+  // 成本，按仓库纪律 opt-in；默认关=工具不存在、面板页空态、注入块不渲染，行为与
+  // 0.10.1 逐字节一致。
+  //
+  // 本键仍**不进 LIGHT_MODE_OFF**，但理由收窄成一句：它是「是否启用这个子系统」，
+  // 不是「每轮付多少」。轻量档要付的是下面那条 chorographyInject（把档位压成
+  // off）——两层分开，用户才能在轻量档里保留工具、只关掉每轮那块文本。
+  chorographyEnabled: z.boolean().default(false),
+
+  // 开局注入档位（M3，spec §7）：off / light / full，默认 light。
+  // light ≤8 行（模块名 + 文件数 + 页状态 + 页路径，按「还有 N 个」明说截断）；
+  // full 列全部模块；off 不注入但工具照旧可用。
+  // 为什么是枚举而不是布尔：spec 原文就是三档，「开了但只给 6 行」与「全给」是两种
+  // 用法，布尔键表达不了；跟随 chorographyEnabled 隐式开又会丢掉「留工具、去文本」
+  // 这个组合。
+  // 为什么写作 z.union([z.const(...)]) 而不是 z.enum：与 summarizeDedupeMode 同款，
+  // 全仓枚举键统一这一种写法（z.enum 的报错文案与既有键不一致）。
+  // 轻量档**不进 LIGHT_MODE_OFF**：那张表对平铺键一律赋 false，枚举键进去会得到与
+  // schema 不符的 false，而 false !== "off" 时注入照样渲染——静默失效比不关更糟。
+  // 轻量档的压制改在消费侧（src/wiki/inject.js 的 resolveInjectTier 判 lightMode）。
+  chorographyInject: z.union([z.const("off"), z.const("light"), z.const("full")]).default("light"),
+
   // --- scope: v0.8.0 A1 存储层（issue #17）--------------------------------
   // 总开关默认关：关闭时写入不标注 scope、去重维持 (type, title) 现状，行为
   // 逐字节不变。开启后**两条写入路径都自动盖章**（*_scope_source='auto'）：
@@ -994,6 +1036,19 @@ export const Config = z.object({
   // preInjectGate.enabled 的定性）；是预设不是强制，用户显式勾选仍然赢。
   profileExtractEnabled: z.boolean().default(false),
 
+  // 「Agent 眼中的你」自动事实（2026-11-06，对标 ChatGPT 记忆 / DS Bot 每 bot 的
+  // MEMORY.md）：dream 巩固轮成功后按会话身份分卡增量维护一份逐条事实清单，
+  // 注入在手填画像之后（src/user-settings.js 的渲染顺序），面板可手动触发与逐条
+  // 修正（POST /api/dsh-mneme/profile-facts/*）。与 profileExtractEnabled 的三层
+  // 理由同源：① 自动轮是 dream 级别的 LLM 调用 + 读上百行记忆，不该在没人要求时
+  // 挂在面上；② 产物每帧注入，编造的代价不对称（维护 prompt 的三段硬约束与
+  // profileExtract 同源）；③ 它**不写** user_settings——手填画像神圣（#497 口径
+  // 不变），事实住独立的 profile_facts 表，可被人在面板上逐条修正。
+  // 进 LIGHT_MODE_OFF：自动维护轮与低资源档互斥（同 organizeEnabled 的定性）；
+  // 是预设不是强制，用户显式勾选仍然赢。注入段本身极轻（几十行文本），不额外
+  // 占用轻量档预算的考量见键注释末句。
+  profileFactsEnabled: z.boolean().default(false),
+
   // #539 逐会话无痕：总开关默认关，保持旧用户行为；子代理选择器默认开，但总开关
   // 未开时不生效。手动名单是精确的 session id 匹配。
   sessionGateEnabled: z.boolean().default(false),
@@ -1035,6 +1090,10 @@ const LIGHT_MODE_OFF = [
   // 要求 agent 拿住上一轮的 run_id 再回来，弱模型漏这一环就是一次被拒的调用；
   // 预设关、不剥夺显式开启的权利（合并顺序同 continuityRescueEnabled）。
   "organizeEnabled",
+  // 轻量档不开画像事实自动维护轮（2026-11-06）：dream 后的逐卡 LLM 调用 + 读上百行
+  // 记忆，与低资源档互斥（同 organizeEnabled 的定性）。注入段本身是几十行常驻文本，
+  // 关掉自动轮不省注入成本、省的是维护调用——这正是该进这张表的路径。
+  "profileFactsEnabled",
   // 轻量模式不开热计算（heat 属于重型增强；关掉后 sleep 降级也退回纯时间分层）。
   "heatEnabled",
   // 轻量模式不开注入前判定（#380：LLM-per-turn 附加路径，每帧注入多一次池级

package/src/document.js

@@ -276,8 +276,9 @@ export function createDocumentRegistrar({ store, config, embedQuery, pushContent
       }
       // #275 拍板 5（#230 验收口径的补丁）：升格吸收的 evidence 行随之退出活跃面——
       // 一次吸收 20 条，库里就是「21 行不是 1 行」。四条口径：①与本行同一事务（要么
-      // 都成、要么都不成）；②pinned（constraint / preference，即 #249 的逐字保真池）
-      // 永不自动归档——升格不能绕过它；③自有生命周期的类型（document / summary，见
+      // 都成、要么都不成）；②pinned 永不自动归档——升格不能绕过它，而 pinned 有**两个**
+      // 判据：显式钉住的行（pinned_memories，#593 起为唯一正源）与 #249 的逐字保真池
+      // 类型（constraint / preference）；③自有生命周期的类型（document / summary，见
       // ABSORB_EXEMPT_TYPES）不吸收，吸收的是原子条；④只翻标志位、内容与审计全留
       // （可恢复），opt-out 走 archiveEvidence。
       // pinnedTypes 拿不到就不做这一步：宁可少做，也不能把保真池当普通行收走。
@@ -294,7 +295,12 @@ export function createDocumentRegistrar({ store, config, embedQuery, pushContent
           const row = store.getById(id);
           if (!row || row.archived || row.forgotten) continue;
           if (isImportedRow(row)) { evidenceSkipped += 1; continue; }
-          if (pinnedTypes.has(row.type) || ABSORB_EXEMPT_TYPES.has(row.type)) continue;
+          // #593：显式 pin（pinned_memories）与类型保真池是**两个**判据。上一版只问
+          // pinnedTypes.has(row.type)，等于把「被钉住的 pattern / decision」当普通行
+          // 收走——用户钉过的东西在文档升格时被静默归档，正是「钉着 ≠ 会注入」的
+          // 反面：这里连「钉着」都没保住。store.isPinned 缺席时退回类型口径（旧行为）。
+          const explicitlyPinned = typeof store.isPinned === "function" && store.isPinned(row.id);
+          if (explicitlyPinned || pinnedTypes.has(row.type) || ABSORB_EXEMPT_TYPES.has(row.type)) continue;
           store.setArchived(id, true);
           evidenceArchived += 1;
         }

package/src/dream/clustering.js

@@ -1,7 +1,12 @@
 // Cosine similarity of two equal-length numeric vectors. Returns 0 for empty
 // or mismatched-length inputs, and for zero-norm vectors (numerically stable).
+// Accepts typed arrays (Float32Array) as well as plain arrays: store.js caches
+// vectors as Float32Array and `Array.isArray` is false for typed arrays — guarding
+// on it alone would silently score every cached vector as 0.
+const isVec = (v) => Array.isArray(v) || (ArrayBuffer.isView(v) && !(v instanceof DataView));
+
 export function cosineSimilarity(a, b) {
-  if (!Array.isArray(a) || !Array.isArray(b) || a.length === 0 || a.length !== b.length) return 0;
+  if (!isVec(a) || !isVec(b) || a.length === 0 || a.length !== b.length) return 0;
   let dot = 0, na = 0, nb = 0;
   for (let i = 0; i < a.length; i++) {
     dot += a[i] * b[i];

package/src/index.js

@@ -21,7 +21,15 @@ import { createApi } from "./api.js";
 import { createStandaloneApi } from "./api-standalone.js";
 // #275 存储生命周期第一批：无损回收（手动入口，不挂启动路径）。
 import { createMaintenance } from "./maintenance.js";
+import { createChoroQueries } from "./wiki/queries.js";
+// chorography M3：开局注入块与 /choro 只读回执。两者都只吃 queries 读侧，不写任何东西。
+import { createChoroInject } from "./wiki/inject.js";
+import { registerChoroCommand } from "./choro-command.js";
+// 收尾档：面板重建按钮走 runChoroT0（P34；T1 不上 HTTP）。
+import { runChoroT0 } from "./wiki/t0.js";
 import { createSettings } from "./settings.js";
+// 「Agent 眼中的你」自动事实（2026-11-06）：逐卡事实清单 + dream 后自动维护轮。
+import { createProfileFacts } from "./profile-facts.js";
 import { createCommandManager } from "./commands.js";
 import { createExecutionRecorder } from "./pipeline-runner.js";
 import { registerMoRunCommand } from "./pipeline-command.js";
@@ -152,7 +160,10 @@ export function createEntityStreamAdapter({ llm, agentDefaultModel, logger, serv
             return undefined;
           }
         }
-        writeAudit("success", null);
+        // 第三参必须显式传进去：writeAudit 的形参默认值 [] 是给"没有 id 可归因"
+        // 留的，省略第三参等于宣称"这条成功与任何记忆无关"——实测活库 6256 条
+        // success 行 100% 空数组，正是这个省略造成的。#405 只修了 error 半边。
+        writeAudit("success", null, relatedMemoryIds);
         return text;
       })().catch((err) => {
         logger?.warn?.(`[dsh-mneme] entity extraction llm stream failed: ${String(err)}`);
@@ -430,6 +441,13 @@ export const apply = (ctx, config) => {
     }
   }
 
+  // 「Agent 眼中的你」自动事实（2026-11-06，opt-in：profileFactsEnabled）：dream 巩固
+  // 轮成功后的逐卡维护 + 面板手动轮（api.js）+ 注入事实段（factsProvider 传注入器与
+  // 预览路由）。装配与开关无关——闸在消费侧（注入渲染 / 自动轮判空 / 路由 409），
+  // 与 profileExtractor 同款：503 只该指装配缺失，不该被读成「用户没开」。
+  // 位置必须在 dream 调度器之前：onRun 的 fire-and-forget 收尾要引用它。
+  const profileFacts = createProfileFacts({ ctx, service, store, config: cfg, logger: ctx.logger });
+
   // Dream scheduler: automatic consolidation + summary runs, triggered by
   // store growth. Writes through the service fire the dream hook, which asks
   // the scheduler to (re)schedule a run once absolute and since-last-run
@@ -479,7 +497,26 @@ export const apply = (ctx, config) => {
           metadata: JSON.stringify({ count, chars })
         });
       },
-      onRun: () => (dream ? dream.runDream(ctx, service, cfg) : Promise.resolve({ ok: true, skipped: true }))
+      onRun: () => {
+        const run = dream
+          ? dream.runDream(ctx, service, cfg)
+          : Promise.resolve({ ok: true, skipped: true });
+        // 画像事实自动维护：挂在巩固轮之后 fire-and-forget。刻意不并进 onRun 的
+        // promise——profileFacts 的失败不能被计入 dream 的失败退避
+        // （autoDreamFailureBackoff 的口径是巩固轮自身）；逐卡经 service.enqueue
+        // 串行，不与 sleep/下一轮巩固抢模型。单卡失败只 warn，账本已有 failed 回执。
+        run.then(async (rep) => {
+          if (cfg.profileFactsEnabled !== true || (rep && rep.ok === false)) return;
+          for (const key of profileFacts.autoPassCandidates()) {
+            try {
+              await service.enqueue(() => profileFacts.runFor(key, { trigger: "auto" }));
+            } catch (error) {
+              ctx.logger?.warn?.(`[dsh-mneme] profile-facts auto pass failed for card "${key || "default"}": ${error?.message ?? error}`);
+            }
+          }
+        }).catch(() => { /* dream 自身失败走调度器退避，这里不做第二遍日志 */ });
+        return run;
+      }
     });
     service.setDreamHook(() => dream.maybeSchedule(service));
   }
@@ -560,8 +597,26 @@ export const apply = (ctx, config) => {
   // a torn-down context.
   disposers.push(() => semantic.dispose());   // #118 重试计时器 + boot 回填计时器(搬入 semantic.js 后由它自持)
 
+  // chorography M3：地志提纲折进 memory context（不新开 context——宿主侧同 order 无
+  // 兜底排序，多一块就多一份拼装抖动；spec §7 也要求「合并成一次拼装」）。档位由
+  // chorographyInject 决定，off / 未匹配到仓库 / 渲染失败一律返回空串，宿主会过滤
+  // 掉空文本，整块消失且不占位。
+  //
+  // 预算是 0：注入块只在 memory context 里多几行，本身不做检索、不 fork git——
+  // 真过期判定留给 /choro（P29）。所以这里不需要额外的「热路径」闸，chorographyEnabled
+  // 与 chorographyInject 两个开关在 resolveInjectTier 里已经判完。
+  const choroInject = createChoroInject({
+    choro: createChoroQueries({ store }),
+    config: cfg,
+    logger: ctx.logger,
+    language: () => langOf(cfg)
+  });
+  disposers.push(() => choroInject.dispose());
+
   ctx.inject(["systemPrompt"], (promptCtx) => {
-    if (cfg.autoInject) disposers.push(createInjector(promptCtx, service, settings, cfg, preInjectGate, sessionGate));
+    if (cfg.autoInject) {
+      disposers.push(createInjector(promptCtx, service, settings, cfg, preInjectGate, sessionGate, choroInject, profileFacts.factsProvider));
+    }
   });
 
   // #249 N3：压缩边缘双落点。触发靠宿主自己落的压缩事件（订阅 + pre-step 追加），
@@ -572,9 +627,27 @@ export const apply = (ctx, config) => {
   }
 
   ctx.inject(["tools"], (toolsCtx) => {
-    disposers.push(createTools(toolsCtx, service, cfg, embedder, sessionGate));
+    // choro（M1）：只读查询对象，chorographyEnabled 关着时工具压根不注册（闸在
+    // createTools 的 hiddenTools，与 organizeEnabled 同款反向语义）。
+    disposers.push(createTools(toolsCtx, service, cfg, embedder, sessionGate, createChoroQueries({ store })));
   });
 
+  // chorography M3：/choro 只读回执。与 /mo-run 同形（ctx.commands.register），
+  // 但这里**不持有任何状态**、不写盘、不重建——spec §2 D6「只手动触发，过期只提示」
+  // 决定了这条命令只能看，不能改。位置必须在 disposers 声明之后（同 actionNudge 的
+  // TDZ 注释），否则插件加载时会直接抛 ReferenceError。
+  if (cfg.chorographyEnabled === true) {
+    const disposeChoro = registerChoroCommand({
+      ctx,
+      choro: createChoroQueries({ store }),
+      config: cfg,
+      enabled: true,
+      language: () => langOf(cfg)
+    });
+    if (disposeChoro) disposers.push(disposeChoro);
+    else ctx.logger?.info?.("[dsh-mneme] chorographyEnabled=true 但宿主没有命令注册表，/choro 未注册");
+  }
+
   const summarizer = createSummarizer(ctx, service, cfg, {}, sessionGate);
   disposers.push(summarizer.dispose);
 
@@ -599,11 +672,20 @@ export const apply = (ctx, config) => {
     // 本模块一次都不会被调用）。这样「没启用」与「没装配」在 HTTP 面上是两个可区分的
     // 答案（503 unavailable 只该出现在旧宿主/装配缺失上，不该被读成「用户没开」）。
     const extractProfileDraft = createProfileExtractor({ ctx, service, config: cfg, logger: ctx.logger });
+    // chorography 读侧（M1）：与 service 刻意分开——所有权模型相反（spec §3）。
+    // 闸在路由/工具两层（关着 409 / 不注册），queries 本体装配与开关无关。
+    // 收尾档：choro 对象加两件 host 侧能力——embedder（向量惰性物化，P37）与
+    // runT0Apply（面板重建按钮的写路径，P34；T1 不上 HTTP，CLI 仍是它的入口）。
+    const choro = {
+      ...createChoroQueries({ store }),
+      embedder,
+      runT0Apply: ({ repoRoot }) => runChoroT0({ repoRoot, store, apply: true }),
+    };
     const api = createApi(ctx, service, settings, commands ?? {
       add: () => { throw new Error("commands unavailable"); },
       remove: () => false,
       list: () => []
-    }, embedder, { vectorIndex, reranker }, cfg.apiToken, cfg, maintenance, extractProfileDraft);
+    }, embedder, { vectorIndex, reranker }, cfg.apiToken, cfg, maintenance, extractProfileDraft, choro, profileFacts);
     disposers.push(api.dispose);
   }
 

package/src/inject.js

@@ -93,7 +93,7 @@ function extractRounds(ctx, maxRounds) {
   }
 }
 
-export function createInjector(ctx, service, settings, config, gate = null, sessionGate = null) {
+export function createInjector(ctx, service, settings, config, gate = null, sessionGate = null, choroInject = null, factsInject = null) {
   const language = langOf(config);
   const baseMaxItems = config.maxInjectedItems ?? 5;
   const threshold = config.importanceThreshold ?? 3;
@@ -331,7 +331,9 @@ export function createInjector(ctx, service, settings, config, gate = null, sess
   // 一致（老用户零变化）。personaStrictAddressing 打开时，「有身份但没建卡」与
   // 「卡被显式关掉」都不注入人格——default 只兜「这一帧解析不到身份」的会话。
   function renderUserSettings(ctx) {
-    return renderUserSettingsBlock({ settings, config, agentId: sessionAgentId(ctx) }).text;
+    // factsInject 是 profile-facts 域的读口（index.js 接线，面板预览路由传同一份）：
+    // 开关与事实有无的判定都在 renderUserSettingsBlock 内部，「关」等于零读数。
+    return renderUserSettingsBlock({ settings, config, agentId: sessionAgentId(ctx), factsProvider: factsInject }).text;
   }
 
   // #249 能力说明的系统提示段。order 150 = 插件指引段的既有惯例
@@ -405,9 +407,19 @@ export function createInjector(ctx, service, settings, config, gate = null, sess
         // #333（issue #34 恢复）：时间前缀只在会话首轮出现（per-session 闩锁），
         // 排在整个记忆块的最前——模型先知道「今天几号」，再看热上下文与长期记忆。
         const timePrefix = renderTimePrefix(ctx);
-        // 拼接次序：时间 → 热上下文 → 长期记忆（三者都可能为空，逐级判空拼接）。
+        // M3 仓库地志（chorography）：只注标题级提纲，档位 off/light/full。
+        // cwd 用 scope.workspace_scope——那是全仓唯一的 cwd 口径（registry 反查，
+        // header.cwd 兜底），另读一份就是两张皮且重犯 #487 的 Proxy 陷阱（P27）。
+        // 取不到 cwd / 仓库没登记 / 渲染失败一律空串：本块在热路径上，不能抛。
+        const choroText = choroInject && typeof choroInject.text === "function"
+          ? choroInject.text(scope?.workspace_scope ?? null)
+          : "";
+        // 拼接次序：时间 → 地志 → 热上下文 → 长期记忆（四者都可能为空，逐级判空）。
+        // 地志排在热上下文之前：它是「这个仓库由哪些模块组成」的稳定背景，
+        // 而热上下文是「刚才聊到哪」，越靠近正文越晚——稳定的在前，易变的在后。
         const withHot = !hotText ? body : body ? `${hotText}\n\n${body}` : hotText;
-        const finalBody = !timePrefix ? withHot : withHot ? `${timePrefix}\n\n${withHot}` : timePrefix;
+        const withChoro = !choroText ? withHot : withHot ? `${choroText}\n\n${withHot}` : choroText;
+        const finalBody = !timePrefix ? withChoro : withChoro ? `${timePrefix}\n\n${withChoro}` : timePrefix;
         // Issue #179：旁路缓存一帧——面板「注入预览」卡据此展示构成与体积。
         // chars 为条目内容的截断后近似值（与 render 同一函数计长），totalChars
         // 是本次实际返回块的精确长度。maxItems 反映自适应收缩后的生效值。
@@ -424,6 +436,8 @@ export function createInjector(ctx, service, settings, config, gate = null, sess
           // 「注入预览」卡据此展示判定是否生效与标记数。
           gate: gateFrame ? { state: gateFrame.state, nFlagged: gateFrame.flaggedIds ? gateFrame.flaggedIds.size : null, judged: gateFrame.judged ?? null } : null,
           hotChars: hotText.length,
+          // M3：地志块实际占的字符数（0 = 本帧没注入），面板据此区分「关」与「没匹配到仓库」。
+          choroChars: choroText.length,
           entries: candidates.map((m) => ({
             id: m.id,
             type: m.type,