@fenglimg/fabric-cli 2.2.0-rc.8 → 2.2.0

package/templates/hooks/knowledge-hint-narrow.cjs

@@ -75,11 +75,9 @@ const {
 } = require("node:fs");
 const { dirname, join } = require("node:path");
 
-// rc.35 TASK-06 (P0-10.b): summary-fallback. Substitutes opaque entries
-// (where description.summary === stable_id) with a snippet read from the
-// entry's .md `## Summary` section. Caches results in
-// `.fabric/.cache/summary-fallback.json` keyed by revision_hash.
-const { resolveOpaqueSummaries } = require("./lib/summary-fallback.cjs");
+// KT-GLD-0006: the rc.35 opaque-summary substitution (resolveOpaqueSummaries) is
+// retired — the write-time mechanical floor in extractKnowledge prevents
+// degenerate summaries at the source, so the narrow hook no longer band-aids them.
 // v2.0.0-rc.37 NEW-17: shared sidecar I/O for the plan-context-hint result
 // cache (skips a redundant CLI cold-start spawn when the same path-set is
 // re-edited within a session and the knowledge graph hasn't changed).
@@ -1492,21 +1490,10 @@ async function main(env, stdio) {
     }
 
     const summaryMaxLen = readSummaryMaxLen(cwd);
-    // rc.35 TASK-06 (P0-10.b): substitute opaque summaries before render.
-    // Same lib used by the broad hook — opaque entries seen from both call
-    // sites share a single .fabric/.cache/summary-fallback.json file.
-    // Best-effort — any failure leaves the original opaque summary intact.
-    let resolvedEntries = dedupDecision.filtered;
-    try {
-      resolvedEntries = resolveOpaqueSummaries(
-        dedupDecision.filtered,
-        cwd,
-        currentRevisionHash,
-      );
-    } catch {
-      // resolveOpaqueSummaries swallows its own errors; defensive catch.
-    }
-    const lines = renderSummary({ ...cliPayload, entries: resolvedEntries }, summaryMaxLen);
+    // KT-GLD-0006: the rc.35 opaque-summary runtime substitution is retired — the
+    // write-time mechanical floor in extractKnowledge prevents degenerate summaries
+    // at the source, so the narrow hook renders the description summary as-is.
+    const lines = renderSummary({ ...cliPayload, entries: dedupDecision.filtered }, summaryMaxLen);
     if (lines.length === 0) return;
 
     // v2.1.0-rc.1 P4 (F4/S63): store-aware hint — append the write-target store
@@ -1564,7 +1551,7 @@ async function main(env, stdio) {
       const surfaceClient = detectClient();
       const fabricDir = join(cwd, FABRIC_DIR_REL);
       if (surfaceClient !== undefined && existsSync(fabricDir)) {
-        const renderedIds = resolvedEntries
+        const renderedIds = dedupDecision.filtered
           .map((e) => (e && typeof e.id === "string" ? e.id : null))
           .filter((x) => x !== null);
         const realSessionId =

package/templates/hooks/lib/banner-i18n.cjs

@@ -28,8 +28,9 @@
  *
  *   - STRINGS — exported for test introspection only (read-only by convention).
  *
- * Banner keys (11 total):
+ * Banner keys:
  *   Signal A (archive):     archiveLine1, archiveActivity, archiveCta
+ *   Archive backlog:        backlogLine1, backlogCta
  *   Signal B (review):      reviewLine1, reviewCta
  *   Signal C (import):      importLine1, importCta
  *   Signal D (maintenance): maintenanceLine1Never, maintenanceLine1Aged, maintenanceLine2
@@ -165,6 +166,23 @@ const STRINGS = {
     "zh-CN-hybrid": () => "   是否调 /fabric-archive 检查值得归档的决策/踩坑/复用?",
   },
 
+  // ---- Archive backlog (cross-session safety net, crack 2) ------------------
+  // Replaces the old global-24h archive timer: counts DEAD sessions (session
+  // ended / idle) carrying unarchived high-value work. Substring "${count}" is
+  // addressable for tests. params: { count: number }
+  backlogLine1: {
+    "zh-CN": (p) => `📋 Fabric: ${p.count} 个已结束的会话有未归档的高价值改动。`,
+    en: (p) => `📋 Fabric: ${p.count} ended session(s) carry unarchived high-value work.`,
+    "zh-CN-hybrid": (p) => `📋 Fabric: ${p.count} 个已结束的会话有未归档的高价值改动。`,
+  },
+
+  // params: {} — protected token /fabric-archive verbatim across all variants.
+  backlogCta: {
+    "zh-CN": () => "   是否调 /fabric-archive 跨会话补归档这些遗漏?",
+    en: () => "   Run /fabric-archive to sweep these missed sessions across the backlog?",
+    "zh-CN-hybrid": () => "   是否调 /fabric-archive 跨会话补归档这些遗漏?",
+  },
+
   // ---- Signal B: review -----------------------------------------------------
   // Source (zh-CN): fabric-hint.cjs:651  `📋 Fabric: 已积累 ${stats.count} 条待审核知识${ageSuffix}。`
   // params: { count, ageSuffix } — ageSuffix is " / 最早一条 N.N 天前" or "" (zh-CN only)

package/templates/hooks/lib/bindings-snapshot-reader.cjs

@@ -148,18 +148,19 @@ function liveKnowledgeStats(snapshot) {
     }
     return { pendingCount, canonicalCount, oldestPendingMtimeMs };
   }
-  // Backward-compatible fallback: snapshot predates knowledge_store_dirs.
-  const stats = snapshot.knowledge_stats;
-  if (stats && typeof stats === "object") {
-    return {
-      pendingCount: Number.isFinite(stats.pending_count) ? Math.floor(stats.pending_count) : 0,
-      canonicalCount: Number.isFinite(stats.canonical_count) ? Math.floor(stats.canonical_count) : 0,
-      oldestPendingMtimeMs:
-        Number.isFinite(stats.oldest_pending_mtime_ms) && stats.oldest_pending_mtime_ms > 0
-          ? stats.oldest_pending_mtime_ms
-          : null,
-    };
-  }
+  // #3 (GH issue): snapshot predates knowledge_store_dirs. The cached
+  // `knowledge_stats` projection is frozen at snapshot-write time and goes stale
+  // out-of-band (store grew via git pull / cross-workspace sync), so trusting it
+  // re-introduced exactly the false-nudge this whole field cures — observed a
+  // store with 61 live canonical entries whose cached count was frozen at 1,
+  // mis-firing the "knowledge sparse → /fabric-import" underseed nudge AND
+  // defeating the fabric-import `canonical > 50 → SKIP` guard. read_set carries
+  // no resolved store root either (alias/uuid only), so a live recount is
+  // impossible without re-resolution (which hooks must not do). Return null
+  // ("undeterminable") so callers SKIP the nudge rather than act on a stale
+  // count — old snapshots self-heal on the next install/sync/store-op (which
+  // regenerates the snapshot WITH knowledge_store_dirs). 宁可不弹也别误弹
+  // (KT-DEC-0007: hook = nudge, never a false-positive gate).
   return null;
 }
 

package/templates/skills/fabric/SKILL.md

@@ -17,15 +17,21 @@ description: Fabric 入口层路由 — 参考 maestro 的顺序协调方式，
 
 ## Intent Map
 
-| 用户意图 | 下游 skill |
+<!-- fabric:router-intent:begin -->
+<!-- 本块由 `fabric install` 从 7 个 leaf skill 的 description Triggers 子句生成。严禁手编;改 leaf description 后重跑 `fabric install`。 -->
+
+| 用户意图(leaf description Triggers) | 下游 skill |
 | --- | --- |
-| 记录/归档/以后记住/always/never/下次注意 | `fabric-archive` |
-| 审批 pending、批量 approve/reject/modify/revisit/defer | `fabric-review` |
-| 从 git log、docs 或历史材料冷启动导入知识 | `fabric-import` |
-| 创建、挂载、绑定、列出、切换 write store | `fabric-store` |
-| 多 store pull --rebase + push、同步冲突处理 | `fabric-sync` |
-| 知识库体检、淘汰陈旧条目、deprecate、rescue-before-delete | `fabric-audit` |
-| 发现 KB 条目关联、补 `related` 边、知识图谱连通性 | `fabric-connect` |
+| 以后/always/never/下次/记一下;wrong-turn-revert;decision-confirm;dismissal-reason;/fabric-archive | `fabric-archive` |
+| 审批/驳回/复审/重审/approve/reject/review pending | `fabric-review` |
+| 导入历史/bootstrap fabric/mine changelog/挖掘 commit | `fabric-import` |
+| 同步知识库/sync stores/fabric-sync/解决 store 冲突/rebase 冲突 | `fabric-sync` |
+| 创建 store/挂载 store/绑定知识库/store 列表/切换写库/set up knowledge store | `fabric-store` |
+| 审计知识库/清理陈旧知识/知识库体检/deprecate 条目/prune stale knowledge/知识库瘦身/淘汰旧决策 | `fabric-audit` |
+| 连接知识/找关联条目/建知识图谱/link related entries/补 related 边/知识库连通性 | `fabric-connect` |
+
+`S_CLASSIFY` 的 `task_type` 枚举:`archive | review | import | sync | store | audit | connect`
+<!-- fabric:router-intent:end -->
 
 ## State Machine
 
@@ -35,7 +41,7 @@ description: Fabric 入口层路由 — 参考 maestro 的顺序协调方式，
 
 ```json
 {
-  "task_type": "archive|review|import|store|sync|audit|connect",
+  "task_type": "<Intent Map task_type 枚举之一>",
   "scope": "project|store|entry|paths|null",
   "write_intent": true,
   "confidence": "high|medium|low"

package/templates/skills/fabric-archive/SKILL.md

@@ -65,6 +65,18 @@ The deterministic ledger scan now runs **server-side** — call `fab_archive_sca
 
 Then (LLM side, Boundary B): for each returned `session_id`, load `.fabric/.cache/session-digests/<session_id>.md`, concatenate into a `### Cross-session digest` block, and populate `source_sessions[]` + `session_context` for Phase 4. Cap at `archive_digest_max_sessions`. Missing digest files degrade silently.
 
+**Coverage transparency (crack 3 — cheap recall backstop).** BEFORE collecting candidates, surface the scan's watermark + drops to the user so a human can act as the recall detector and manually override (`--range <session_id>` to force a dropped session back in). This is the affordable substitute for the (deferred) periodic cold-eval miss-rate audit — show, don't hide, what the deterministic filter skipped:
+
+```
+📋 归档覆盖到 <covered_through_ts 转人类可读时间>。
+   纳入会话: <session_ids.length> 个。
+   跳过 <dropped.length> 个: <每个 {session_id 短码} (reason)>
+     reason 含义: user_dismissed=用户曾拒绝 / cooldown=12h 防抖内 / no_new_signal=自上次归档无新高价值活
+   若某个被跳过的会话其实有该归档的内容,显式 `fabric-archive --range <session_id>` 强制纳入。
+```
+
+Render `dropped` only when non-empty; render the watermark line always. en variant mirrors the same fields. Keep it ONE compact block — this is a backstop affordance, not a report.
+
 `Read ref/phase-1-cross-session.md` for the filter state machine + digest-stitch + graceful-degradation notes. The hand-rolled `tail -n 200` scan is retired — `fab_archive_scan` is the source of truth.
 
 Graceful degradation: missing digest cache → single-session fallback. Missing `session_archive_attempted` events (pre-rc.25) → legacy "scan everything since anchor" behaviour.
@@ -93,6 +105,8 @@ Pre-PASS HARD gate (rc.37 NEW-4): per candidate, run `fab_review action="search"
 
 For each candidate, propose **type** ∈ {model, decision, guideline, pitfall, process}, **layer** ∈ {team, personal} via the verbatim heuristic below, **slug** (kebab-case 2-5 words, 20-40 chars, unique within type+layer bucket), **summary** (1-2 sentences).
 
+> **Self-sufficiency standard — guideline / model summaries (KT-GLD-0001/0006).** These two types land in the SessionStart **ALWAYS-ACTIVE** sink as a single INDEX line with NO body injected — so the summary IS the operative rule the agent acts on. Author it as a self-contained imperative that states the thesis (the *what* + the operative *so-what*), e.g. `改源码前先读 bootstrap+compiler config;scripts 为 init 主执行边界`. A topic label that only points at the body (`Code style guidelines`, `Scope model`) is NOT acceptable here — the reader can't act on it without a fetch, breaking the always-active contract. decision/pitfall/process summaries are exempt (they surface as `must_read_if` triggers, deliberately pointers). Do NOT self-judge sufficiency in this phase (curse-of-knowledge rubber-stamps — KT-GLD-0006); authoring to the standard is the write-time floor, the zero-context cold-eval at review time is the real gate.
+
 #### Layer Classification Heuristic (verbatim, contract-locked)
 
 > - **强 team**: 引用本项目代码、团队共识用语（"we decided"）、fabric-import 路径产物、业务领域、绑定本项目代码的 pitfall

package/templates/skills/fabric-review/SKILL.md

@@ -119,6 +119,15 @@ DO NOT AskUserQuestion "is this a duplicate?" — LLM already judged. User only
 
 `Read ref/semantic-check.md` for full procedure + 三类判断的细化定义.
 
+## Summary Self-Sufficiency Gate (guideline / model only — KT-GLD-0006)
+
+Guideline/model entries surface in the SessionStart **ALWAYS-ACTIVE** sink as a body-less INDEX line, so an opaque summary (`Code style guidelines`) leaks in as an unactionable "rule". Before approving/promoting a **guideline or model** (only these two types — decision/pitfall/process surface as `must_read_if` triggers and are exempt), run the summary through the **zero-context cold-eval judge**, never your own judgment:
+
+- The reviewing agent self-judging sufficiency is curse-of-knowledge — it back-fills from context it already has and rubber-stamps pointers (KT-GLD-0006). The withheld-body cold eval is the whole point.
+- Build the batch with `summary-cold-eval.ts#buildColdEvalBatch` (rubric = `COLD_EVAL_RUBRIC`, candidates = the guideline/model summaries) and hand it to an **offline** judge via `maestro delegate` (zero-context, batched — NOT on the hot path). The judge returns `ColdEvalVerdict[]`.
+- For each `self_sufficient=false` verdict: surface `⚠ Summary not act-on-able (cold-eval); suggested: <suggested_summary>` and route to `modify-content` (summary rewrite, stable_id preserved) — do NOT approve as-is. `self_sufficient=true` → no action.
+- This is a nudge, not a hard block (KT-DEC-0007): the user may still approve over a failed verdict, but the flag must be shown.
+
 ## Narrowing Imported Entries & Modify Sub-Flow
 
 `modify` is the only action that mutates frontmatter or stable_id. Two paths:

package/templates/hooks/lib/summary-fallback.cjs

@@ -1,273 +0,0 @@
-/**
- * rc.35 TASK-06 (P0-10.b) — summary-fallback library.
- *
- * Resolves opaque hint entries (where `entry.summary === entry.id` so the
- * AI sees no information beyond the id) by reading the entry's markdown file
- * from mounted store `knowledge/<type>/<id>--<slug>.md`, extracting the first
- * paragraph under `## Summary`, and substituting that text into the entry
- * before the hook renders it.
- *
- * Caching: results are stored in `.fabric/.cache/summary-fallback.json`
- * keyed by the current `revision_hash` returned by plan-context-hint. The
- * cache is wiped wholesale when the revision changes (cheap invariant —
- * any meta rev bump implies entry text MAY have moved). Per-process call
- * also benefits from in-memory dedup since the same opaque id may appear
- * across narrow + broad paths.
- *
- * Design contract:
- *   - Never throw. ANY failure (cache read, fs scan, file read) degrades
- *     to a no-op — the original opaque summary is left untouched. Hooks
- *     must remain best-effort.
- *   - Idempotent over identical inputs. Two calls in succession with the
- *     same revision_hash + entries set produce zero disk reads on the
- *     second call.
- *
- * Public API (module.exports):
- *   resolveOpaqueSummaries(entries, projectRoot, revisionHash) — returns
- *     a NEW array of entries with `summary` substituted for opaque cases.
- *     Original `entry.id` is preserved verbatim.
- *
- *   _extractFirstSummaryParagraph(md) — pure helper, exposed for testing.
- *
- *   _readCache / _writeCache — exposed for testing.
- */
-
-const { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } = require("node:fs");
-const { homedir } = require("node:os");
-const { join } = require("node:path");
-
-const CACHE_DIR_REL = ".fabric/.cache";
-const CACHE_FILE_REL = ".fabric/.cache/summary-fallback.json";
-const GLOBAL_CONFIG_FILE = "fabric-global.json";
-const PROJECT_CONFIG_REL = ".fabric/fabric-config.json";
-const SUMMARY_MAX_LEN = 80;
-const KNOWLEDGE_TYPE_DIRS = ["decisions", "pitfalls", "guidelines", "models", "processes"];
-
-function _isOpaque(entry) {
-  if (!entry || typeof entry.id !== "string" || typeof entry.summary !== "string") {
-    return false;
-  }
-  return entry.summary.trim() === entry.id.trim();
-}
-
-/**
- * Pure helper: extract the first paragraph under a `## Summary` heading.
- *
- *   - `## Summary` is case-insensitive but level-sensitive (only H2).
- *   - First paragraph = lines until blank line or next heading.
- *   - Collapses whitespace + trims; returns `""` if no summary section or
- *     the section is empty.
- */
-function _extractFirstSummaryParagraph(md) {
-  if (typeof md !== "string" || md.length === 0) return "";
-  const lines = md.split(/\r?\n/);
-  let i = 0;
-  while (i < lines.length) {
-    if (/^##\s+summary\s*$/i.test(lines[i].trim())) {
-      i += 1;
-      break;
-    }
-    i += 1;
-  }
-  if (i >= lines.length) return "";
-  // Skip blank lines after the heading
-  while (i < lines.length && lines[i].trim().length === 0) i += 1;
-  // Collect until the next blank line or next heading
-  const buf = [];
-  while (i < lines.length) {
-    const line = lines[i];
-    if (line.trim().length === 0) break;
-    if (/^#{1,6}\s/.test(line.trim())) break;
-    buf.push(line.trim());
-    i += 1;
-  }
-  const flat = buf.join(" ").replace(/\s+/g, " ").trim();
-  if (flat.length === 0) return "";
-  if (flat.length <= SUMMARY_MAX_LEN) return flat;
-  return `${flat.slice(0, SUMMARY_MAX_LEN - 1)}…`;
-}
-
-function _readCache(projectRoot) {
-  const cachePath = join(projectRoot, CACHE_FILE_REL);
-  if (!existsSync(cachePath)) return null;
-  try {
-    const raw = readFileSync(cachePath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed === "object" && typeof parsed.revision === "string" && parsed.summaries && typeof parsed.summaries === "object") {
-      return parsed;
-    }
-  } catch {
-    // ignore — caller treats null as no-cache
-  }
-  return null;
-}
-
-function _writeCache(projectRoot, payload) {
-  try {
-    const cacheDir = join(projectRoot, CACHE_DIR_REL);
-    if (!existsSync(cacheDir)) mkdirSync(cacheDir, { recursive: true });
-    const cachePath = join(projectRoot, CACHE_FILE_REL);
-    writeFileSync(cachePath, JSON.stringify(payload), "utf8");
-  } catch {
-    // Best-effort — failing to persist cache is not an error
-  }
-}
-
-/**
- * Return mounted store directories in the project's read-set
- * (`required_stores` plus implicit personal). This hook helper is deliberately
- * tiny and best-effort: malformed config degrades to an empty read-set rather
- * than throwing during a shell hook.
- */
-function _readJson(path) {
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-function _globalRoot() {
-  return join(process.env.FABRIC_HOME || homedir(), ".fabric");
-}
-
-function _storeDir(globalRoot, store) {
-  return join(globalRoot, "stores", store.mount_name || store.store_uuid);
-}
-
-function _readSetStoreDirs(projectRoot) {
-  const globalRoot = _globalRoot();
-  const global = _readJson(join(globalRoot, GLOBAL_CONFIG_FILE));
-  if (!global || !Array.isArray(global.stores)) return [];
-  const project = _readJson(join(projectRoot, PROJECT_CONFIG_REL)) || {};
-  const required = Array.isArray(project.required_stores) ? project.required_stores : [];
-  const stores = [];
-
-  for (const req of required) {
-    if (!req || typeof req.id !== "string") continue;
-    const matched = global.stores.find(
-      (store) => store && !store.personal && (store.alias === req.id || store.store_uuid === req.id),
-    );
-    if (matched) stores.push(matched);
-  }
-
-  const personal = global.stores.find((store) => store && store.personal);
-  if (personal) stores.push(personal);
-
-  return stores.map((store) => ({
-    alias: typeof store.alias === "string" ? store.alias : "",
-    dir: _storeDir(globalRoot, store),
-  }));
-}
-
-function _splitQualifiedId(id) {
-  const idx = typeof id === "string" ? id.indexOf(":") : -1;
-  if (idx <= 0) return { alias: "", stableId: id };
-  return { alias: id.slice(0, idx), stableId: id.slice(idx + 1) };
-}
-
-/**
- * Scan mounted store `knowledge/<type>/` for the canonical `<id>--<slug>.md`
- * matching `stableId`. Tries the most likely type-dir first based on the
- * entry's `type` hint, then falls back to scanning all canonical type
- * directories. Returns the absolute path or null.
- *
- * The id→file mapping is unique by construction (stable_id is allocated
- * once per file), so the first match wins.
- */
-function _findEntryFile(projectRoot, stableId, typeHint) {
-  const parsedId = _splitQualifiedId(stableId);
-  const storeDirs = _readSetStoreDirs(projectRoot).filter(
-    (store) => parsedId.alias.length === 0 || store.alias === parsedId.alias,
-  );
-  if (storeDirs.length === 0) return null;
-  const tryOrder = [];
-  if (typeof typeHint === "string" && typeHint.length > 0) {
-    // Accept both singular and plural hints — find the plural form.
-    const lower = typeHint.toLowerCase();
-    const plural = KNOWLEDGE_TYPE_DIRS.find((d) => d === lower || d.startsWith(lower));
-    if (plural) tryOrder.push(plural);
-  }
-  for (const t of KNOWLEDGE_TYPE_DIRS) {
-    if (!tryOrder.includes(t)) tryOrder.push(t);
-  }
-  const prefix = `${parsedId.stableId}--`;
-  for (const store of storeDirs) {
-    const baseDir = join(store.dir, "knowledge");
-    if (!existsSync(baseDir)) continue;
-    for (const t of tryOrder) {
-      const typeDir = join(baseDir, t);
-      if (!existsSync(typeDir)) continue;
-      let files;
-      try {
-        files = readdirSync(typeDir);
-      } catch {
-        continue;
-      }
-      for (const f of files) {
-        if (f.startsWith(prefix) && f.endsWith(".md")) {
-          return join(typeDir, f);
-        }
-      }
-    }
-  }
-  return null;
-}
-
-function _resolveOne(projectRoot, entry) {
-  const filePath = _findEntryFile(projectRoot, entry.id, entry.type);
-  if (filePath === null) return "";
-  let md;
-  try {
-    md = readFileSync(filePath, "utf8");
-  } catch {
-    return "";
-  }
-  return _extractFirstSummaryParagraph(md);
-}
-
-/**
- * Main API. Returns a new array of entries with `summary` swapped for
- * the extracted fallback wherever the original summary was opaque AND
- * the fallback extraction yielded a non-empty string. Non-opaque entries
- * pass through unchanged.
- */
-function resolveOpaqueSummaries(entries, projectRoot, revisionHash) {
-  if (!Array.isArray(entries) || entries.length === 0) return entries;
-  const cache = _readCache(projectRoot);
-  const cachedSummaries = cache && cache.revision === revisionHash && cache.summaries ? cache.summaries : {};
-  const nextCacheSummaries = { ...cachedSummaries };
-  let cacheChanged = cache === null || cache.revision !== revisionHash;
-  const result = entries.map((entry) => {
-    if (!_isOpaque(entry)) return entry;
-    const id = entry.id;
-    let fallback;
-    if (Object.prototype.hasOwnProperty.call(cachedSummaries, id)) {
-      fallback = cachedSummaries[id];
-    } else {
-      fallback = _resolveOne(projectRoot, entry);
-      nextCacheSummaries[id] = fallback;
-      cacheChanged = true;
-    }
-    if (typeof fallback === "string" && fallback.length > 0) {
-      return { ...entry, summary: fallback };
-    }
-    return entry;
-  });
-  if (cacheChanged) {
-    _writeCache(projectRoot, { revision: revisionHash, summaries: nextCacheSummaries });
-  }
-  return result;
-}
-
-module.exports = {
-  resolveOpaqueSummaries,
-  _extractFirstSummaryParagraph,
-  _readCache,
-  _writeCache,
-  _findEntryFile,
-  _readSetStoreDirs,
-  _isOpaque,
-  SUMMARY_MAX_LEN,
-  KNOWLEDGE_TYPE_DIRS,
-};