@remnic/core 9.64.1 → 9.64.2

package/dist/{chunk-K547KS3X.js → chunk-ML3U4KPR.js}

@@ -1,10 +1,10 @@
+import {
+  scanMemoryDir
+} from "./chunk-W7IGLX4G.js";
 import {
   isSearchAborted,
   throwIfSearchAborted
 } from "./chunk-GUMZC2BO.js";
-import {
-  scanMemoryDir
-} from "./chunk-W7IGLX4G.js";
 import {
   reportSearchDegradation,
   resolveEnsureCollectionArgs
@@ -776,4 +776,4 @@ export {
   resolveOramaCollectionDbFilePath,
   OramaBackend
 };
-//# sourceMappingURL=chunk-K547KS3X.js.map
+//# sourceMappingURL=chunk-ML3U4KPR.js.map

package/dist/{chunk-HIEWDJ2O.js → chunk-MSTNSVXI.js}

@@ -4,6 +4,7 @@ var MCP_READ_ONLY_TOOL_SUFFIXES = {
   recall_explain: true,
   recall_tier_explain: true,
   recall_xray: true,
+  who_knows: true,
   briefing: true,
   wearables_status: true,
   transcript_day: true,
@@ -57,4 +58,4 @@ var MCP_READ_ONLY_TOOL_SUFFIXES = {
 export {
   MCP_READ_ONLY_TOOL_SUFFIXES
 };
-//# sourceMappingURL=chunk-HIEWDJ2O.js.map
+//# sourceMappingURL=chunk-MSTNSVXI.js.map

package/dist/chunk-MSTNSVXI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp-read-only-tools.ts"],"sourcesContent":["/**\n * Conservative allowlist of canonical MCP tool suffixes that are\n * unambiguously read-only. Tools in this set are tagged with\n * `annotations: { readOnlyHint: true }` so ChatGPT (and other MCP\n * clients that honor the hint) can skip per-call confirmation.\n *\n * The list is suffix-based so it covers both the `remnic.*` and\n * `engram.*` naming forms. Anything not on it stays unannotated:\n * uncertainty is resolved as \"might mutate\".\n *\n * Excluded by construction: anything that writes, runs a pipeline,\n * flushes, applies, records, imports, or destructively deletes.\n */\nexport const MCP_READ_ONLY_TOOL_SUFFIXES: Readonly<Record<string, true>> = {\n  recall: true,\n  recall_explain: true,\n  recall_tier_explain: true,\n  recall_xray: true,\n  who_knows: true,\n  briefing: true,\n  wearables_status: true,\n  transcript_day: true,\n  transcript_search: true,\n  transcript_memories: true,\n  meetings_list: true,\n  meetings_get: true,\n  action_confidence: true,\n  capsule_list: true,\n  procedural_stats: true,\n  memory_get: true,\n  memory_timeline: true,\n  entity_get: true,\n  review_queue_list: true,\n  lcm_search: true,\n  continuity_incident_list: true,\n  identity_anchor_get: true,\n  memory_identity: true,\n  memory_search: true,\n  external_wiki_search: true,\n  memory_profile: true,\n  memory_entities_list: true,\n  memory_questions: true,\n  memory_last_recall: true,\n  memory_intent_debug: true,\n  memory_qmd_debug: true,\n  memory_graph_explain: true,\n  graph_snapshot: true,\n  review_list: true,\n  profiling_report: true,\n  peer_list: true,\n  peer_get: true,\n  peer_profile_get: true,\n  console_state: true,\n  dreams_status: true,\n  codegraph_list_projects: true,\n  codegraph_index_status: true,\n  codegraph_search_graph: true,\n  codegraph_trace_path: true,\n  codegraph_detect_changes: true,\n  codegraph_query_graph: true,\n  codegraph_get_schema: true,\n  codegraph_get_snippet: true,\n  codegraph_get_architecture: true,\n  codegraph_search_code: true,\n  support_passport_memory_preview: true,\n  support_passport_cards_list: true,\n  support_passport_grants_list: true,\n};\n"],"mappings":";AAaO,IAAM,8BAA8D;AAAA,EACzE,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,aAAa;AAAA,EACb,WAAW;AAAA,EACX,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,qBAAqB;AAAA,EACrB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,YAAY;AAAA,EACZ,0BAA0B;AAAA,EAC1B,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,qBAAqB;AAAA,EACrB,kBAAkB;AAAA,EAClB,sBAAsB;AAAA,EACtB,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,kBAAkB;AAAA,EAClB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,eAAe;AAAA,EACf,yBAAyB;AAAA,EACzB,wBAAwB;AAAA,EACxB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,0BAA0B;AAAA,EAC1B,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,uBAAuB;AAAA,EACvB,4BAA4B;AAAA,EAC5B,uBAAuB;AAAA,EACvB,iCAAiC;AAAA,EACjC,6BAA6B;AAAA,EAC7B,8BAA8B;AAChC;","names":[]}

package/dist/{chunk-CI6YIT5S.js → chunk-NO7B6DRB.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-B7RWBZXW.js";
 import {
   StorageManager
-} from "./chunk-2RZCOG63.js";
+} from "./chunk-2QI2JBLQ.js";
 import {
   getCachedEpisodeMap,
   setCachedEpisodeMap
@@ -109,4 +109,4 @@ export {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
 };
-//# sourceMappingURL=chunk-CI6YIT5S.js.map
+//# sourceMappingURL=chunk-NO7B6DRB.js.map

package/dist/{chunk-Q3IRE6E4.js → chunk-ON2P3SHG.js}

@@ -1,7 +1,7 @@
 import {
   resolveDefaultNamespaceRoot,
   resolveNamespaceStorageRoot
-} from "./chunk-DRS3OX77.js";
+} from "./chunk-GVRLED7R.js";
 import {
   MutationSerializer,
   withHeldFileLock
@@ -1473,4 +1473,4 @@ export {
   isNamespaceKind,
   NamespaceCatalog
 };
-//# sourceMappingURL=chunk-Q3IRE6E4.js.map
+//# sourceMappingURL=chunk-ON2P3SHG.js.map

package/dist/{chunk-2Q4UAPLD.js → chunk-OQIRBGUU.js}

@@ -1,10 +1,10 @@
+import {
+  scanMemoryDir
+} from "./chunk-W7IGLX4G.js";
 import {
   isSearchAborted,
   throwIfSearchAborted
 } from "./chunk-GUMZC2BO.js";
-import {
-  scanMemoryDir
-} from "./chunk-W7IGLX4G.js";
 import {
   reportSearchDegradation,
   resolveEnsureCollectionArgs
@@ -508,4 +508,4 @@ function isMissingVectorProviderColumnError(err) {
 export {
   LanceDbBackend
 };
-//# sourceMappingURL=chunk-2Q4UAPLD.js.map
+//# sourceMappingURL=chunk-OQIRBGUU.js.map

package/dist/{chunk-WDFXRHOZ.js → chunk-PE76XIDM.js}

@@ -1,9 +1,9 @@
 import {
   hasMemoryData
-} from "./chunk-Q3IRE6E4.js";
+} from "./chunk-ON2P3SHG.js";
 import {
   resolveNamespaceStorageRoot
-} from "./chunk-DRS3OX77.js";
+} from "./chunk-GVRLED7R.js";
 import {
   getConfiguredNamespaces
 } from "./chunk-Q57GOHLF.js";
@@ -724,4 +724,4 @@ export {
   runNamespaceMaintenancePlan,
   runNamespaceMaintenanceBatchPlan
 };
-//# sourceMappingURL=chunk-WDFXRHOZ.js.map
+//# sourceMappingURL=chunk-PE76XIDM.js.map

package/dist/{chunk-MVIYRRVJ.js → chunk-PMVPCZJZ.js}

@@ -13,13 +13,13 @@ import {
   requestEntityCanonicalIdReconcile,
   withRawEntityPageMutation
 } from "./chunk-ZVPVTPGI.js";
-import {
-  decryptCapsuleFileInMemory,
-  isEncryptedCapsuleFile
-} from "./chunk-UVYI6VIX.js";
 import {
   parseExportBundle
 } from "./chunk-WEHSQBFR.js";
+import {
+  decryptCapsuleFileInMemory,
+  isEncryptedCapsuleFile
+} from "./chunk-X7Y7WX73.js";
 import {
   assertIsDirectoryNotSymlink,
   assertRealpathInsideRoot,
@@ -294,4 +294,4 @@ function mintForkId(capsuleId, originalId, now) {
 export {
   importCapsule
 };
-//# sourceMappingURL=chunk-MVIYRRVJ.js.map
+//# sourceMappingURL=chunk-PMVPCZJZ.js.map

package/dist/{chunk-VCNGVU62.js → chunk-PVIXAMWM.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-UYCIS6V5.js";
 import {
   StorageManager
-} from "./chunk-2RZCOG63.js";
+} from "./chunk-2QI2JBLQ.js";
 import {
   parseContinuityImprovementLoops
 } from "./chunk-LDXUBPMO.js";
@@ -1283,4 +1283,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-VCNGVU62.js.map
+//# sourceMappingURL=chunk-PVIXAMWM.js.map

package/dist/{chunk-QHNO6AND.js → chunk-RWLRKMZK.js}

@@ -4,7 +4,7 @@ import {
 import {
   computeCorpusWatermarks,
   resolveCorpusNamespaceRoots
-} from "./chunk-UWSETW6O.js";
+} from "./chunk-SB6YBB2V.js";
 
 // src/operator-doctor-corpus.ts
 var DIGEST_PREFIX_LENGTH = 12;
@@ -78,4 +78,4 @@ export {
   corpusWatermarksFromCheck,
   summarizeCorpusAndReplica
 };
-//# sourceMappingURL=chunk-QHNO6AND.js.map
+//# sourceMappingURL=chunk-RWLRKMZK.js.map

package/dist/{chunk-UWSETW6O.js → chunk-SB6YBB2V.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-ZGGTIBWN.js";
+} from "./chunk-CKZHKFY3.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-MZWSOLMT.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-UWSETW6O.js.map
+//# sourceMappingURL=chunk-SB6YBB2V.js.map

package/dist/{chunk-DTQ3OB7O.js → chunk-SHQFYZTD.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SOBJ6NEY.js";
 import {
   summarizeDisclosureTokens
-} from "./chunk-DLZBOEJY.js";
+} from "./chunk-IFK3PVM7.js";
 import {
   summarizeRetrievedMemoryProvenance
 } from "./chunk-I4WBNM3M.js";
@@ -606,4 +606,4 @@ export {
   renderRecallExplain,
   parseRecallExplainFormat
 };
-//# sourceMappingURL=chunk-DTQ3OB7O.js.map
+//# sourceMappingURL=chunk-SHQFYZTD.js.map

package/dist/chunk-TKI2WOL5.js

@@ -0,0 +1,256 @@
+import {
+  parseEntityFile
+} from "./chunk-2QI2JBLQ.js";
+import {
+  inferMemoryStatus
+} from "./chunk-7RJUVTVF.js";
+import {
+  EngramAccessInputError
+} from "./chunk-2Z24E5W2.js";
+
+// src/who-knows.ts
+var WHO_KNOWS_DEFAULT_LIMIT = 5;
+var WHO_KNOWS_MAX_LIMIT = 50;
+var WHO_KNOWS_MAX_EVIDENCE = 50;
+var WHO_KNOWS_AUTHORSHIP_BONUS = 1.5;
+async function loadWhoKnowsEntities(storage, entitySchemas) {
+  const entities = [];
+  for (const id of await storage.listEntityNames()) {
+    const raw = await storage.readEntity(id);
+    if (!raw) continue;
+    try {
+      const entity = parseEntityFile(raw, entitySchemas);
+      entities.push({ id, name: entity.name, aliases: entity.aliases });
+    } catch {
+    }
+  }
+  return entities;
+}
+function validateWhoKnowsInput(topic, limit) {
+  if (topic.trim().length === 0) {
+    throw new EngramAccessInputError("whoKnows: topic is required and must be non-empty");
+  }
+  if (!Number.isInteger(limit) || limit < 1 || limit > WHO_KNOWS_MAX_LIMIT) {
+    throw new EngramAccessInputError(
+      `whoKnows: limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`
+    );
+  }
+}
+var STOPWORDS = {
+  the: true,
+  a: true,
+  an: true,
+  of: true,
+  and: true,
+  or: true,
+  to: true,
+  in: true,
+  for: true,
+  on: true,
+  with: true,
+  is: true,
+  are: true,
+  was: true,
+  were: true,
+  who: true,
+  knows: true,
+  know: true,
+  about: true,
+  at: true,
+  by: true
+};
+function tokenizeTopic(topic) {
+  const tokens = topic.toLowerCase().split(/[^a-z0-9]+/).filter((token) => token.length >= 2 && STOPWORDS[token] !== true);
+  return [...new Set(tokens)];
+}
+var ATTRIBUTION_VERBS = "said|says|mentioned|noted|explained|recommended|suggested|proposed|wrote|asked|answered|demonstrated|designed|built|debugged|fixed";
+function escapeRegex(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function wordMatcher(term) {
+  return new RegExp(`\\b${escapeRegex(term.toLowerCase())}\\b`);
+}
+function computeWhoKnows(input) {
+  const topicTokens = tokenizeTopic(input.topic);
+  const byId = new Map(input.entities.map((entity) => [entity.id, entity]));
+  const mentionMatchers = [];
+  const authorshipMatchers = [];
+  for (const entity of input.entities) {
+    for (const term of [entity.name, ...entity.aliases]) {
+      const clean = term.trim().toLowerCase();
+      if (clean.length < 2) continue;
+      mentionMatchers.push({ entityId: entity.id, matcher: wordMatcher(clean) });
+      const possessive = clean.replace(/'/g, "");
+      authorshipMatchers.push({
+        entityId: entity.id,
+        matcher: new RegExp(
+          `\\b${escapeRegex(possessive)}(?:'s)?\\b[^.!?]{0,40}\\b(?:${ATTRIBUTION_VERBS})\\b`
+        )
+      });
+    }
+  }
+  const candidates = /* @__PURE__ */ new Map();
+  const credit = (entityId, memory, weight, authorship) => {
+    let candidate = candidates.get(entityId);
+    if (!candidate) {
+      candidate = {
+        entityId,
+        entityName: byId.get(entityId)?.name ?? null,
+        rawScore: 0,
+        evidence: [],
+        matchCount: 0,
+        authorshipCount: 0,
+        lastSeen: null
+      };
+      candidates.set(entityId, candidate);
+    }
+    candidate.rawScore += weight;
+    candidate.matchCount += 1;
+    candidate.authorshipCount += authorship ? 1 : 0;
+    const updated = memory.frontmatter.updated || memory.frontmatter.created;
+    if (updated && (!candidate.lastSeen || updated > candidate.lastSeen)) {
+      candidate.lastSeen = updated;
+    }
+    if (candidate.evidence.length < WHO_KNOWS_MAX_EVIDENCE) {
+      candidate.evidence.push({
+        id: memory.frontmatter.id,
+        path: memory.path,
+        updated: memory.frontmatter.updated || memory.frontmatter.created
+      });
+    }
+  };
+  for (const memory of input.memories) {
+    if (inferMemoryStatus(memory.frontmatter, memory.path) !== "active") continue;
+    const haystack = `${memory.content}
+${memory.frontmatter.tags.join(" ")}`.toLowerCase();
+    const matched = topicTokens.filter((token) => haystack.includes(token));
+    if (matched.length === 0) continue;
+    const coverage = matched.length / topicTokens.length;
+    const importance = memory.frontmatter.importance?.score ?? 0.5;
+    const confidence = memory.frontmatter.confidence ?? 0.5;
+    let weight = coverage * (0.5 + 0.5 * importance) * confidence;
+    const attributed = /* @__PURE__ */ new Set();
+    if (memory.frontmatter.entityRef) attributed.add(memory.frontmatter.entityRef);
+    for (const { entityId, matcher } of mentionMatchers) {
+      if (matcher.test(haystack)) attributed.add(entityId);
+    }
+    if (attributed.size === 0) continue;
+    const attributedAuthors = /* @__PURE__ */ new Set();
+    for (const { entityId, matcher } of authorshipMatchers) {
+      if (attributed.has(entityId) && matcher.test(haystack)) attributedAuthors.add(entityId);
+    }
+    for (const entityId of attributed) {
+      const authorship = attributedAuthors.has(entityId);
+      credit(entityId, memory, authorship ? weight * WHO_KNOWS_AUTHORSHIP_BONUS : weight, authorship);
+    }
+  }
+  const ranked = [...candidates.values()].sort((a, b) => {
+    if (b.rawScore !== a.rawScore) return b.rawScore - a.rawScore;
+    const aSeen = a.lastSeen ?? "";
+    const bSeen = b.lastSeen ?? "";
+    if (aSeen !== bSeen) return aSeen < bSeen ? 1 : -1;
+    return a.entityId < b.entityId ? -1 : a.entityId > b.entityId ? 1 : 0;
+  });
+  const top = ranked.slice(0, input.limit);
+  const maxScore = top.length > 0 ? top[0].rawScore : 0;
+  const results = top.map((candidate) => ({
+    entityId: candidate.entityId,
+    entityName: candidate.entityName,
+    score: maxScore > 0 ? Math.round(candidate.rawScore / maxScore * 1e4) / 1e4 : 0,
+    rationale: `${candidate.matchCount} matching memor${candidate.matchCount === 1 ? "y" : "ies"} (topic co-occurrence${candidate.authorshipCount > 0 ? `, ${candidate.authorshipCount} with direct attribution` : ""})${candidate.lastSeen ? `; latest ${candidate.lastSeen}` : ""}`,
+    evidenceCount: candidate.matchCount,
+    lastSeen: candidate.lastSeen,
+    evidence: candidate.evidence
+  }));
+  return { topic: input.topic, results };
+}
+var WHO_KNOWS_MCP_TOOLS = [
+  {
+    // Registered as `engram.who_knows`; `withToolAliases` emits the canonical
+    // `remnic.who_knows` alias automatically (dual-naming invariant).
+    name: "engram.who_knows",
+    description: "Rank people/entities by demonstrated expertise for a topic (issue #2057). Deterministic scoring over entity mentions, attribution, importance, and recency; each hit carries evidence refs (ids/paths/timestamps). Empty topic is a validation error; a topic with no evidence returns an empty list.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        topic: {
+          type: "string",
+          description: "Topic to rank expertise for. Required; non-empty."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: WHO_KNOWS_MAX_LIMIT,
+          description: `Maximum hits to return (default ${WHO_KNOWS_DEFAULT_LIMIT}, max ${WHO_KNOWS_MAX_LIMIT}).`
+        },
+        namespace: {
+          type: "string",
+          description: "Optional namespace. Enforced against the caller's principal the same way recall is."
+        }
+      },
+      required: ["topic"],
+      additionalProperties: false
+    }
+  }
+];
+async function handleWhoKnowsHttpQuery(deps) {
+  const topicParam = deps.getParam("topic");
+  if (topicParam === null || topicParam.trim().length === 0) {
+    return {
+      status: 400,
+      body: {
+        error: "missing_topic",
+        code: "missing_topic",
+        message: "topic search parameter is required and must be non-empty"
+      }
+    };
+  }
+  let limit;
+  const limitParam = deps.getParam("limit");
+  if (limitParam !== null && limitParam !== "") {
+    const parsed = Number(limitParam);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > WHO_KNOWS_MAX_LIMIT) {
+      return {
+        status: 400,
+        body: {
+          error: "invalid_limit",
+          code: "invalid_limit",
+          message: `limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`
+        }
+      };
+    }
+    limit = parsed;
+  }
+  const namespaceParam = deps.getParam("namespace");
+  const namespace = deps.resolveNamespace(namespaceParam && namespaceParam.length > 0 ? namespaceParam : void 0);
+  try {
+    return {
+      status: 200,
+      body: await deps.run({
+        topic: topicParam,
+        ...limit !== void 0 ? { limit } : {},
+        ...namespace !== void 0 ? { namespace } : {},
+        ...deps.principal ? { authenticatedPrincipal: deps.principal } : {}
+      })
+    };
+  } catch (err) {
+    if (err instanceof EngramAccessInputError) {
+      return { status: 400, body: { error: "invalid_request", code: "invalid_request", message: err.message } };
+    }
+    throw err;
+  }
+}
+
+export {
+  WHO_KNOWS_DEFAULT_LIMIT,
+  WHO_KNOWS_MAX_LIMIT,
+  WHO_KNOWS_MAX_EVIDENCE,
+  WHO_KNOWS_AUTHORSHIP_BONUS,
+  loadWhoKnowsEntities,
+  validateWhoKnowsInput,
+  tokenizeTopic,
+  computeWhoKnows,
+  WHO_KNOWS_MCP_TOOLS,
+  handleWhoKnowsHttpQuery
+};
+//# sourceMappingURL=chunk-TKI2WOL5.js.map

package/dist/chunk-TKI2WOL5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/who-knows.ts"],"sourcesContent":["/**\n * `who_knows` — rank entities by demonstrated expertise for a topic\n * (issue #2057).\n *\n * Deterministic scoring over existing entity + fact data. No LLM, no QMD:\n * a single pass over the namespace-scoped corpus (`readAllMemories`) plus\n * entity files. Signals:\n *\n * 1. Entity mentions co-occurring with topic tokens (entityRef + name/alias\n *    mention in matching memory content).\n * 2. Speaker/authorship attribution (\"Alice said/explained/…\") when present —\n *    small multiplicative bonus.\n * 3. Recency as a tie-break only (per the issue): newer evidence ranks higher\n *    when scores tie; entity id is the final stable key (total order).\n * 4. Existing importance + confidence frontmatter weight each evidence item.\n *\n * Pure functions live here so tests can exercise scoring without booting an\n * orchestrator; the access service supplies namespace-scoped data. MCP tool\n * definitions are exported for access-mcp.ts to spread into `tools/list`\n * (same pattern as `meetings/mcp-tools.ts`).\n */\n\nimport { EngramAccessInputError } from \"./access-errors.js\";\nimport type { McpTool } from \"./access-mcp.js\";\nimport { inferMemoryStatus } from \"./memory-lifecycle-ledger-utils.js\";\nimport { parseEntityFile } from \"./storage/entity-store.js\";\nimport type { MemoryFile, PluginConfig } from \"./types.js\";\n\n/** Default result count (issue #2057: \"small ranked list\"). */\nexport const WHO_KNOWS_DEFAULT_LIMIT = 5;\n/** Upper bound for `limit`. Rejects unbounded fan-out without silently clamping. */\nexport const WHO_KNOWS_MAX_LIMIT = 50;\n/** Evidence refs retained per hit. Independent of the result limit. */\nexport const WHO_KNOWS_MAX_EVIDENCE = 50;\n/** Multiplicative bonus for evidence with direct speaker attribution. */\nexport const WHO_KNOWS_AUTHORSHIP_BONUS = 1.5;\n\n/** Minimal storage surface `who_knows` needs — satisfied by `StorageManager`. */\nexport interface WhoKnowsStorage {\n  readAllMemories(): Promise<MemoryFile[]>;\n  listEntityNames(): Promise<string[]>;\n  readEntity(name: string): Promise<string>;\n}\n\n/** Flattened entity input for scoring. `id` is the entity key (file stem). */\nexport interface WhoKnowsEntity {\n  id: string;\n  name: string;\n  aliases: readonly string[];\n}\n\n/** Evidence reference — ids/paths/timestamps only, no raw content. */\nexport interface WhoKnowsEvidence {\n  id: string;\n  path: string;\n  updated: string;\n}\n\nexport interface WhoKnowsHit {\n  entityId: string;\n  entityName: string | null;\n  /** Normalized 0–1 relative to the top hit (top = 1). */\n  score: number;\n  rationale: string;\n  evidenceCount: number;\n  lastSeen: string | null;\n  evidence: WhoKnowsEvidence[];\n}\n\nexport interface WhoKnowsResult {\n  topic: string;\n  results: WhoKnowsHit[];\n}\n\n/** Load all entities for a namespace-scoped storage as scoring input. */\nexport async function loadWhoKnowsEntities(\n  storage: WhoKnowsStorage,\n  entitySchemas?: PluginConfig[\"entitySchemas\"],\n): Promise<WhoKnowsEntity[]> {\n  const entities: WhoKnowsEntity[] = [];\n  for (const id of await storage.listEntityNames()) {\n    const raw = await storage.readEntity(id);\n    if (!raw) continue;\n    try {\n      const entity = parseEntityFile(raw, entitySchemas);\n      entities.push({ id, name: entity.name, aliases: entity.aliases });\n    } catch {\n      // Unparseable entity files are skipped, not fatal — same tolerance as\n      // the entityList surface (a bad file must not break ranking).\n    }\n  }\n  return entities;\n}\n\n/** Validate topic + limit at every entrypoint. Shared by service/CLI/HTTP. */\nexport function validateWhoKnowsInput(topic: string, limit: number): void {\n  if (topic.trim().length === 0) {\n    throw new EngramAccessInputError(\"whoKnows: topic is required and must be non-empty\");\n  }\n  if (!Number.isInteger(limit) || limit < 1 || limit > WHO_KNOWS_MAX_LIMIT) {\n    throw new EngramAccessInputError(\n      `whoKnows: limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`,\n    );\n}\n}\nconst STOPWORDS: Record<string, true> = {\n  the: true, a: true, an: true, of: true, and: true, or: true, to: true, in: true, for: true,\n  on: true, with: true, is: true, are: true, was: true, were: true, who: true, knows: true,\n  know: true, about: true, at: true, by: true,\n};\n\n/** Lowercase alphanumeric topic tokens, stopwords dropped, deduplicated. */\nexport function tokenizeTopic(topic: string): string[] {\n  const tokens = topic\n    .toLowerCase()\n    .split(/[^a-z0-9]+/)\n    .filter((token) => token.length >= 2 && STOPWORDS[token] !== true);\n  return [...new Set(tokens)];\n}\n\nconst ATTRIBUTION_VERBS =\n  \"said|says|mentioned|noted|explained|recommended|suggested|proposed|wrote|asked|answered|demonstrated|designed|built|debugged|fixed\";\n\nfunction escapeRegex(text: string): string {\n  return text.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction wordMatcher(term: string): RegExp {\n  return new RegExp(`\\\\b${escapeRegex(term.toLowerCase())}\\\\b`);\n}\n\ninterface ScoredCandidate {\n  entityId: string;\n  entityName: string | null;\n  rawScore: number;\n  evidence: WhoKnowsEvidence[];\n  matchCount: number;\n  authorshipCount: number;\n  lastSeen: string | null;\n}\n\n/**\n * Deterministic ranking. Pure: same inputs → same output, total order via\n * (score desc, lastSeen desc, entityId asc) so ties never depend on scan\n * order (sort-stability rule).\n */\nexport function computeWhoKnows(input: {\n  topic: string;\n  limit: number;\n  memories: readonly MemoryFile[];\n  entities: readonly WhoKnowsEntity[];\n}): WhoKnowsResult {\n  const topicTokens = tokenizeTopic(input.topic);\n  const byId = new Map(input.entities.map((entity) => [entity.id, entity]));\n\n  // Multi-word names/aliases must match as phrases; single words as tokens.\n  const mentionMatchers: Array<{ entityId: string; matcher: RegExp }> = [];\n  const authorshipMatchers: Array<{ entityId: string; matcher: RegExp }> = [];\n  for (const entity of input.entities) {\n    for (const term of [entity.name, ...entity.aliases]) {\n      const clean = term.trim().toLowerCase();\n      if (clean.length < 2) continue;\n      mentionMatchers.push({ entityId: entity.id, matcher: wordMatcher(clean) });\n      const possessive = clean.replace(/'/g, \"\");\n      authorshipMatchers.push({\n        entityId: entity.id,\n        matcher: new RegExp(\n          `\\\\b${escapeRegex(possessive)}(?:'s)?\\\\b[^.!?]{0,40}\\\\b(?:${ATTRIBUTION_VERBS})\\\\b`,\n        ),\n      });\n    }\n  }\n\n  const candidates = new Map<string, ScoredCandidate>();\n  const credit = (entityId: string, memory: MemoryFile, weight: number, authorship: boolean): void => {\n    let candidate = candidates.get(entityId);\n    if (!candidate) {\n      candidate = {\n        entityId,\n        entityName: byId.get(entityId)?.name ?? null,\n        rawScore: 0,\n        evidence: [],\n        matchCount: 0,\n        authorshipCount: 0,\n        lastSeen: null,\n      };\n      candidates.set(entityId, candidate);\n    }\n    candidate.rawScore += weight;\n    candidate.matchCount += 1;\n    candidate.authorshipCount += authorship ? 1 : 0;\n    const updated = memory.frontmatter.updated || memory.frontmatter.created;\n    if (updated && (!candidate.lastSeen || updated > candidate.lastSeen)) {\n      candidate.lastSeen = updated;\n    }\n    if (candidate.evidence.length < WHO_KNOWS_MAX_EVIDENCE) {\n      candidate.evidence.push({\n        id: memory.frontmatter.id,\n        path: memory.path,\n        updated: memory.frontmatter.updated || memory.frontmatter.created,\n      });\n    }\n  };\n\n  for (const memory of input.memories) {\n    if (inferMemoryStatus(memory.frontmatter, memory.path) !== \"active\") continue;\n    const haystack = `${memory.content}\\n${memory.frontmatter.tags.join(\" \")}`.toLowerCase();\n    const matched = topicTokens.filter((token) => haystack.includes(token));\n    if (matched.length === 0) continue;\n    const coverage = matched.length / topicTokens.length;\n    const importance = memory.frontmatter.importance?.score ?? 0.5;\n    const confidence = memory.frontmatter.confidence ?? 0.5;\n    let weight = coverage * (0.5 + 0.5 * importance) * confidence;\n\n    const attributed = new Set<string>();\n    // entityRef counts even when the entity file is missing — the hit then\n    // carries the ref id with a null display name (missing-name case).\n    if (memory.frontmatter.entityRef) attributed.add(memory.frontmatter.entityRef);\n    for (const { entityId, matcher } of mentionMatchers) {\n      if (matcher.test(haystack)) attributed.add(entityId);\n    }\n    if (attributed.size === 0) continue;\n\n    // Attribution is per entity: \"Alice explained X with Bob\" credits only\n    // Alice with authorship — Bob is a co-mention, not the speaker.\n    const attributedAuthors = new Set<string>();\n    for (const { entityId, matcher } of authorshipMatchers) {\n      if (attributed.has(entityId) && matcher.test(haystack)) attributedAuthors.add(entityId);\n    }\n    for (const entityId of attributed) {\n      const authorship = attributedAuthors.has(entityId);\n      credit(entityId, memory, authorship ? weight * WHO_KNOWS_AUTHORSHIP_BONUS : weight, authorship);\n    }\n  }\n\n  const ranked = [...candidates.values()].sort((a, b) => {\n    if (b.rawScore !== a.rawScore) return b.rawScore - a.rawScore;\n    const aSeen = a.lastSeen ?? \"\";\n    const bSeen = b.lastSeen ?? \"\";\n    if (aSeen !== bSeen) return aSeen < bSeen ? 1 : -1;\n    return a.entityId < b.entityId ? -1 : a.entityId > b.entityId ? 1 : 0;\n  });\n  const top = ranked.slice(0, input.limit);\n  const maxScore = top.length > 0 ? top[0].rawScore : 0;\n  const results: WhoKnowsHit[] = top.map((candidate) => ({\n    entityId: candidate.entityId,\n    entityName: candidate.entityName,\n    score: maxScore > 0 ? Math.round((candidate.rawScore / maxScore) * 10000) / 10000 : 0,\n    rationale:\n      `${candidate.matchCount} matching memor${candidate.matchCount === 1 ? \"y\" : \"ies\"}` +\n      ` (topic co-occurrence${candidate.authorshipCount > 0 ? `, ${candidate.authorshipCount} with direct attribution` : \"\"})` +\n      `${candidate.lastSeen ? `; latest ${candidate.lastSeen}` : \"\"}`,\n    evidenceCount: candidate.matchCount,\n    lastSeen: candidate.lastSeen,\n    evidence: candidate.evidence,\n  }));\n\n  return { topic: input.topic, results };\n}\n\n// ---------------------------------------------------------------------------\n// MCP tool definition (spread into access-mcp.ts tools/list — see\n// MEETINGS_MCP_TOOLS precedent; the type-only import keeps this cycle-free).\n// ---------------------------------------------------------------------------\n\nexport const WHO_KNOWS_MCP_TOOLS: McpTool[] = [\n  {\n    // Registered as `engram.who_knows`; `withToolAliases` emits the canonical\n    // `remnic.who_knows` alias automatically (dual-naming invariant).\n    name: \"engram.who_knows\",\n    description:\n      \"Rank people/entities by demonstrated expertise for a topic (issue #2057). Deterministic scoring over entity mentions, attribution, importance, and recency; each hit carries evidence refs (ids/paths/timestamps). Empty topic is a validation error; a topic with no evidence returns an empty list.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        topic: {\n          type: \"string\",\n          description: \"Topic to rank expertise for. Required; non-empty.\",\n        },\n        limit: {\n          type: \"integer\",\n          minimum: 1,\n          maximum: WHO_KNOWS_MAX_LIMIT,\n          description: `Maximum hits to return (default ${WHO_KNOWS_DEFAULT_LIMIT}, max ${WHO_KNOWS_MAX_LIMIT}).`,\n        },\n        namespace: {\n          type: \"string\",\n          description:\n            \"Optional namespace. Enforced against the caller's principal the same way recall is.\",\n        },\n      },\n      required: [\"topic\"],\n      additionalProperties: false,\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// HTTP query handling (called from access-http.ts so the route stays thin —\n// that file is size-grandfathered).\n// ---------------------------------------------------------------------------\n\nexport interface WhoKnowsHttpOutcome {\n  status: number;\n  body: unknown;\n}\n\nexport async function handleWhoKnowsHttpQuery(deps: {\n  getParam: (name: string) => string | null;\n  resolveNamespace: (namespace: string | undefined) => string | undefined;\n  principal?: string;\n  run: (request: { topic: string; limit?: number; namespace?: string; authenticatedPrincipal?: string }) => Promise<WhoKnowsResult>;\n}): Promise<WhoKnowsHttpOutcome> {\n  const topicParam = deps.getParam(\"topic\");\n  if (topicParam === null || topicParam.trim().length === 0) {\n    return {\n      status: 400,\n      body: {\n        error: \"missing_topic\",\n        code: \"missing_topic\",\n        message: \"topic search parameter is required and must be non-empty\",\n      },\n    };\n  }\n  let limit: number | undefined;\n  const limitParam = deps.getParam(\"limit\");\n  if (limitParam !== null && limitParam !== \"\") {\n    const parsed = Number(limitParam);\n    if (!Number.isInteger(parsed) || parsed < 1 || parsed > WHO_KNOWS_MAX_LIMIT) {\n      return {\n        status: 400,\n        body: {\n          error: \"invalid_limit\",\n          code: \"invalid_limit\",\n          message: `limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`,\n        },\n      };\n    }\n    limit = parsed;\n  }\n  const namespaceParam = deps.getParam(\"namespace\");\n  // Always resolve (and allow-list check) the effective namespace, even when\n  // the param is omitted — the implicit default namespace is still a\n  // namespace every other GET route gates the same way.\n  const namespace = deps.resolveNamespace(namespaceParam && namespaceParam.length > 0 ? namespaceParam : undefined);\n  try {\n    return {\n      status: 200,\n      body: await deps.run({\n        topic: topicParam,\n        ...(limit !== undefined ? { limit } : {}),\n        ...(namespace !== undefined ? { namespace } : {}),\n        ...(deps.principal ? { authenticatedPrincipal: deps.principal } : {}),\n      }),\n    };\n  } catch (err) {\n    // Input validation (including namespace ACL) is a 400; backend faults\n    // bubble to the global handler so they return 500 and get logged.\n    if (err instanceof EngramAccessInputError) {\n      return { status: 400, body: { error: \"invalid_request\", code: \"invalid_request\", message: err.message } };\n    }\n    throw err;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TY35YQ6E.js

@@ -0,0 +1,77 @@
+import {
+  WHO_KNOWS_DEFAULT_LIMIT,
+  WHO_KNOWS_MAX_LIMIT,
+  validateWhoKnowsInput
+} from "./chunk-TKI2WOL5.js";
+
+// src/who-knows-cli.ts
+function extractWhoKnowsRawArgs(rest) {
+  const VALUE_FLAGS = { "--limit": true, "--namespace": true };
+  const positional = [];
+  const options = {};
+  for (let i = 0; i < rest.length; i++) {
+    const token = rest[i];
+    if (token.startsWith("--")) {
+      if (token === "--json") {
+        options.json = true;
+      } else if (VALUE_FLAGS[token]) {
+        const value = rest[i + 1];
+        if (value === void 0 || value.startsWith("--")) {
+          throw new Error(`who-knows: ${token} expects a value`);
+        }
+        options[token.slice(2)] = value;
+        i += 1;
+      } else {
+        throw new Error(`who-knows: unknown option ${token} (expected --limit, --namespace, or --json)`);
+      }
+    } else {
+      positional.push(token);
+    }
+  }
+  return { topic: positional.join(" ").trim(), options };
+}
+function parseWhoKnowsCliOptions(rawTopic, options) {
+  if (typeof rawTopic !== "string" || rawTopic.trim().length === 0) {
+    throw new Error("who-knows: topic is required and must be non-empty");
+  }
+  let limit = WHO_KNOWS_DEFAULT_LIMIT;
+  if (options.limit !== void 0) {
+    const parsed = typeof options.limit === "number" ? options.limit : Number(options.limit);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > WHO_KNOWS_MAX_LIMIT) {
+      throw new Error(`who-knows: --limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`);
+    }
+    limit = parsed;
+  }
+  const namespace = typeof options.namespace === "string" && options.namespace.trim().length > 0 ? options.namespace.trim() : void 0;
+  validateWhoKnowsInput(rawTopic, limit);
+  return { topic: rawTopic.trim(), limit, namespace, json: options.json === true };
+}
+function renderWhoKnowsJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+function renderWhoKnowsText(result) {
+  if (result.results.length === 0) {
+    return `who knows "${result.topic}": no evidence found`;
+  }
+  const lines = [`who knows "${result.topic}" (top ${result.results.length})`];
+  result.results.forEach((hit, index) => {
+    const name = hit.entityName || hit.entityId;
+    lines.push(`${index + 1}. ${name} [${hit.entityId}] \u2014 score ${hit.score.toFixed(4)} \u2014 ${hit.rationale}`);
+    for (const ref of hit.evidence) {
+      lines.push(`   - ${ref.id} (${ref.path}) updated ${ref.updated}`);
+    }
+  });
+  return lines.join("\n");
+}
+function renderWhoKnows(result, json) {
+  return json ? renderWhoKnowsJson(result) : renderWhoKnowsText(result);
+}
+
+export {
+  extractWhoKnowsRawArgs,
+  parseWhoKnowsCliOptions,
+  renderWhoKnowsJson,
+  renderWhoKnowsText,
+  renderWhoKnows
+};
+//# sourceMappingURL=chunk-TY35YQ6E.js.map

package/dist/chunk-TY35YQ6E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/who-knows-cli.ts"],"sourcesContent":["/**\n * Input-validation + rendering helpers for the `remnic who-knows` CLI\n * command (issue #2057). Extracted so validation paths can be unit-tested\n * without booting an orchestrator (same pattern as `recall-xray-cli.ts`).\n *\n * Rules 14 + 51: bare `--limit`, non-integer or out-of-range values, and an\n * empty topic throw listed-options errors — never silent defaults.\n */\n\nimport {\n  validateWhoKnowsInput,\n  WHO_KNOWS_DEFAULT_LIMIT,\n  WHO_KNOWS_MAX_LIMIT,\n  type WhoKnowsResult,\n} from \"./who-knows.js\";\n\nexport interface ParsedWhoKnowsCliOptions {\n  topic: string;\n  limit: number;\n  namespace?: string;\n  json: boolean;\n}\n\n/** Split raw argv into the positional topic and a flag bag. Value flags error when bare. */\nexport function extractWhoKnowsRawArgs(rest: string[]): {\n  topic: string;\n  options: Record<string, unknown>;\n} {\n  const VALUE_FLAGS: Record<string, true> = { \"--limit\": true, \"--namespace\": true };\n  const positional: string[] = [];\n  const options: Record<string, unknown> = {};\n  for (let i = 0; i < rest.length; i++) {\n    const token = rest[i];\n    if (token.startsWith(\"--\")) {\n      if (token === \"--json\") {\n        options.json = true;\n      } else if (VALUE_FLAGS[token]) {\n        const value = rest[i + 1];\n        if (value === undefined || value.startsWith(\"--\")) {\n          throw new Error(`who-knows: ${token} expects a value`);\n        }\n        options[token.slice(2)] = value;\n        i += 1;\n      } else {\n        throw new Error(`who-knows: unknown option ${token} (expected --limit, --namespace, or --json)`);\n      }\n    } else {\n      positional.push(token);\n    }\n  }\n  return { topic: positional.join(\" \").trim(), options };\n}\n\n/** Validate the full option bag. Throws listed-options errors for bad input. */\nexport function parseWhoKnowsCliOptions(rawTopic: unknown, options: Record<string, unknown>): ParsedWhoKnowsCliOptions {\n  if (typeof rawTopic !== \"string\" || rawTopic.trim().length === 0) {\n    throw new Error(\"who-knows: topic is required and must be non-empty\");\n  }\n  let limit = WHO_KNOWS_DEFAULT_LIMIT;\n  if (options.limit !== undefined) {\n    const parsed = typeof options.limit === \"number\" ? options.limit : Number(options.limit);\n    if (!Number.isInteger(parsed) || parsed < 1 || parsed > WHO_KNOWS_MAX_LIMIT) {\n      throw new Error(`who-knows: --limit expects an integer between 1 and ${WHO_KNOWS_MAX_LIMIT}`);\n    }\n    limit = parsed;\n  }\n  const namespace = typeof options.namespace === \"string\" && options.namespace.trim().length > 0\n    ? options.namespace.trim()\n    : undefined;\n  validateWhoKnowsInput(rawTopic, limit);\n  return { topic: rawTopic.trim(), limit, namespace, json: options.json === true };\n}\n\nexport function renderWhoKnowsJson(result: WhoKnowsResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\nexport function renderWhoKnowsText(result: WhoKnowsResult): string {\n  if (result.results.length === 0) {\n    return `who knows \"${result.topic}\": no evidence found`;\n  }\n  const lines = [`who knows \"${result.topic}\" (top ${result.results.length})`];\n  result.results.forEach((hit, index) => {\n    const name = hit.entityName || hit.entityId;\n    lines.push(`${index + 1}. ${name} [${hit.entityId}] — score ${hit.score.toFixed(4)} — ${hit.rationale}`);\n    for (const ref of hit.evidence) {\n      lines.push(`   - ${ref.id} (${ref.path}) updated ${ref.updated}`);\n    }\n  });\n  return lines.join(\"\\n\");\n}\n\nexport function renderWhoKnows(result: WhoKnowsResult, json: boolean): string {\n  return json ? renderWhoKnowsJson(result) : renderWhoKnowsText(result);\n}\n\n"],"mappings":";;;;;;;AAwBO,SAAS,uBAAuB,MAGrC;AACA,QAAM,cAAoC,EAAE,WAAW,MAAM,eAAe,KAAK;AACjF,QAAM,aAAuB,CAAC;AAC9B,QAAM,UAAmC,CAAC;AAC1C,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,UAAI,UAAU,UAAU;AACtB,gBAAQ,OAAO;AAAA,MACjB,WAAW,YAAY,KAAK,GAAG;AAC7B,cAAM,QAAQ,KAAK,IAAI,CAAC;AACxB,YAAI,UAAU,UAAa,MAAM,WAAW,IAAI,GAAG;AACjD,gBAAM,IAAI,MAAM,cAAc,KAAK,kBAAkB;AAAA,QACvD;AACA,gBAAQ,MAAM,MAAM,CAAC,CAAC,IAAI;AAC1B,aAAK;AAAA,MACP,OAAO;AACL,cAAM,IAAI,MAAM,6BAA6B,KAAK,6CAA6C;AAAA,MACjG;AAAA,IACF,OAAO;AACL,iBAAW,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AACA,SAAO,EAAE,OAAO,WAAW,KAAK,GAAG,EAAE,KAAK,GAAG,QAAQ;AACvD;AAGO,SAAS,wBAAwB,UAAmB,SAA4D;AACrH,MAAI,OAAO,aAAa,YAAY,SAAS,KAAK,EAAE,WAAW,GAAG;AAChE,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AACA,MAAI,QAAQ;AACZ,MAAI,QAAQ,UAAU,QAAW;AAC/B,UAAM,SAAS,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,OAAO,QAAQ,KAAK;AACvF,QAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,KAAK,SAAS,qBAAqB;AAC3E,YAAM,IAAI,MAAM,uDAAuD,mBAAmB,EAAE;AAAA,IAC9F;AACA,YAAQ;AAAA,EACV;AACA,QAAM,YAAY,OAAO,QAAQ,cAAc,YAAY,QAAQ,UAAU,KAAK,EAAE,SAAS,IACzF,QAAQ,UAAU,KAAK,IACvB;AACJ,wBAAsB,UAAU,KAAK;AACrC,SAAO,EAAE,OAAO,SAAS,KAAK,GAAG,OAAO,WAAW,MAAM,QAAQ,SAAS,KAAK;AACjF;AAEO,SAAS,mBAAmB,QAAgC;AACjE,SAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;AACvC;AAEO,SAAS,mBAAmB,QAAgC;AACjE,MAAI,OAAO,QAAQ,WAAW,GAAG;AAC/B,WAAO,cAAc,OAAO,KAAK;AAAA,EACnC;AACA,QAAM,QAAQ,CAAC,cAAc,OAAO,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAC3E,SAAO,QAAQ,QAAQ,CAAC,KAAK,UAAU;AACrC,UAAM,OAAO,IAAI,cAAc,IAAI;AACnC,UAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,KAAK,IAAI,QAAQ,kBAAa,IAAI,MAAM,QAAQ,CAAC,CAAC,WAAM,IAAI,SAAS,EAAE;AACvG,eAAW,OAAO,IAAI,UAAU;AAC9B,YAAM,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,IAAI,aAAa,IAAI,OAAO,EAAE;AAAA,IAClE;AAAA,EACF,CAAC;AACD,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,eAAe,QAAwB,MAAuB;AAC5E,SAAO,OAAO,mBAAmB,MAAM,IAAI,mBAAmB,MAAM;AACtE;","names":[]}

package/dist/{chunk-AL43367I.js → chunk-UMDZXW5J.js}

@@ -939,6 +939,27 @@ function parseLocationConfig(raw) {
   return { enabled, timezone, syncDays, retainCoordinates, sources };
 }
 
+// src/okf/config.ts
+var DEFAULT_OKF_CONFIG = Object.freeze({
+  conformanceEnabled: true,
+  sweepEnabled: false
+});
+function parseOkfConfig(raw) {
+  if (raw === void 0 || raw === null) return { ...DEFAULT_OKF_CONFIG };
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error(
+      `okf must be an object (got ${JSON.stringify(raw)}). Use okf: { conformanceEnabled: false } to opt out; omit the key for defaults.`
+    );
+  }
+  const record = raw;
+  const conformance = coerceBooleanLike(record.conformanceEnabled, "okf.conformanceEnabled");
+  const sweep = coerceBooleanLike(record.sweepEnabled, "okf.sweepEnabled");
+  return {
+    conformanceEnabled: conformance ?? DEFAULT_OKF_CONFIG.conformanceEnabled,
+    sweepEnabled: sweep ?? DEFAULT_OKF_CONFIG.sweepEnabled
+  };
+}
+
 // src/chat/chat-config.ts
 var DEFAULT_CHAT_CONFIG = {
   enabled: false,
@@ -2566,6 +2587,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     converge: parseConvergeConfig(cfg.converge),
     wearables,
     meetings,
+    okf: parseOkfConfig(cfg.okf),
     activity,
     location,
     provenance,
@@ -3994,4 +4016,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-AL43367I.js.map
+//# sourceMappingURL=chunk-UMDZXW5J.js.map