@remnic/core 9.69.33 → 9.69.35

package/dist/{chunk-N7RWREIQ.js → chunk-65RENJGB.js}

@@ -6,6 +6,9 @@ var VALID_CODEX_CLI_REASONING_EFFORTS = /* @__PURE__ */ new Set([
   "xhigh"
 ]);
 var processRunner;
+function isCodexCliFallbackRunnerRegistered() {
+  return processRunner !== void 0;
+}
 function setCodexCliFallbackRunnerForProcess(runner) {
   const previous = processRunner;
   processRunner = runner;
@@ -77,8 +80,10 @@ var __codexCliFallbackTestHooks = {
 };
 
 export {
+  isCodexCliFallbackRunnerRegistered,
   setCodexCliFallbackRunnerForProcess,
   callCodexCliFallback,
+  normalizeCodexCliTimeoutMs,
   __codexCliFallbackTestHooks
 };
-//# sourceMappingURL=chunk-N7RWREIQ.js.map
+//# sourceMappingURL=chunk-65RENJGB.js.map

package/dist/chunk-65RENJGB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli-fallback.ts"],"sourcesContent":["import type { CodexCliReasoningEffort } from \"./types.js\";\n\nexport interface CodexCliFallbackMessage {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface CodexCliFallbackConfig {\n  apiKey?: string | Record<string, unknown>;\n  executable?: unknown;\n  codexCliExecutable?: unknown;\n  reasoningEffort?: unknown;\n  codexCliReasoningEffort?: unknown;\n  retryOptions?: {\n    timeoutMs?: unknown;\n  };\n}\n\nexport interface CodexCliFallbackOptions {\n  timeoutMs?: number;\n  signal?: AbortSignal;\n}\n\nexport interface CodexCliFallbackResult {\n  content: string;\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    totalTokens?: number;\n  };\n}\n\nexport interface CodexCliFallbackRequest {\n  config: CodexCliFallbackConfig;\n  modelId: string;\n  messages: CodexCliFallbackMessage[];\n  options: CodexCliFallbackOptions;\n}\n\nexport type CodexCliFallbackRunner = (\n  request: CodexCliFallbackRequest,\n) => Promise<CodexCliFallbackResult>;\n\nconst VALID_CODEX_CLI_REASONING_EFFORTS = new Set<CodexCliReasoningEffort>([\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\nlet processRunner: CodexCliFallbackRunner | undefined;\n\n/**\n * True when a process-local Codex CLI transport is registered. Lets a default\n * runner (codex-subscription) register only when no host/benchmark runner has\n * claimed the seam, so explicit registrations always win.\n */\nexport function isCodexCliFallbackRunnerRegistered(): boolean {\n  return processRunner !== undefined;\n}\n\n/**\n * Registers the process-local Codex CLI transport. Core itself stays free of\n * child_process here; hosts and benchmark runtimes opt in, and the\n * codex-subscription module registers a subprocess runner on demand.\n */\nexport function setCodexCliFallbackRunnerForProcess(\n  runner: CodexCliFallbackRunner | undefined,\n): () => void {\n  const previous = processRunner;\n  processRunner = runner;\n  return () => {\n    processRunner = previous;\n  };\n}\n\nexport async function callCodexCliFallback(\n  config: CodexCliFallbackConfig,\n  modelId: string,\n  messages: CodexCliFallbackMessage[],\n  options: CodexCliFallbackOptions = {},\n): Promise<CodexCliFallbackResult> {\n  if (!processRunner) {\n    throw new Error(\n      'codex-cli fallback transport is not registered; install a runner with setCodexCliFallbackRunnerForProcess() before using api: \"codex-cli\"',\n    );\n  }\n\n  return await processRunner({\n    config: normalizeCodexCliFallbackConfig(config),\n    modelId: normalizeCodexCliModel(modelId),\n    messages,\n    options: normalizeCodexCliFallbackOptions(options),\n  });\n}\n\nfunction normalizeCodexCliFallbackConfig(\n  config: CodexCliFallbackConfig,\n): CodexCliFallbackConfig {\n  return {\n    ...config,\n    ...(config.executable !== undefined\n      ? { executable: normalizeOptionalString(config.executable, \"codex-cli executable\") }\n      : {}),\n    ...(config.codexCliExecutable !== undefined\n      ? { codexCliExecutable: normalizeOptionalString(config.codexCliExecutable, \"codex-cli executable\") }\n      : {}),\n    ...(config.reasoningEffort !== undefined\n      ? { reasoningEffort: normalizeCodexCliReasoningEffort(config.reasoningEffort) }\n      : {}),\n    ...(config.codexCliReasoningEffort !== undefined\n      ? { codexCliReasoningEffort: normalizeCodexCliReasoningEffort(config.codexCliReasoningEffort) }\n      : {}),\n    ...(config.retryOptions?.timeoutMs !== undefined\n      ? { retryOptions: { timeoutMs: normalizeCodexCliTimeoutMs(config.retryOptions.timeoutMs) } }\n      : {}),\n  };\n}\n\nfunction normalizeCodexCliFallbackOptions(\n  options: CodexCliFallbackOptions,\n): CodexCliFallbackOptions {\n  return {\n    ...(options.timeoutMs !== undefined\n      ? { timeoutMs: normalizeCodexCliTimeoutMs(options.timeoutMs) }\n      : {}),\n    ...(options.signal ? { signal: options.signal } : {}),\n  };\n}\n\nfunction normalizeOptionalString(value: unknown, label: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new Error(`${label} must be a non-empty string`);\n  }\n  return value.trim();\n}\n\nfunction normalizeCodexCliModel(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"codex-cli model must be a non-empty string\");\n  }\n  return trimmed;\n}\n\nfunction normalizeCodexCliReasoningEffort(value: unknown): CodexCliReasoningEffort {\n  if (typeof value !== \"string\") {\n    throw new Error(\"codex-cli reasoningEffort must be one of low, medium, high, xhigh\");\n  }\n  const normalized = value.trim().toLowerCase();\n  if (VALID_CODEX_CLI_REASONING_EFFORTS.has(normalized as CodexCliReasoningEffort)) {\n    return normalized as CodexCliReasoningEffort;\n  }\n  throw new Error(\"codex-cli reasoningEffort must be one of low, medium, high, xhigh\");\n}\n\nexport function normalizeCodexCliTimeoutMs(value: unknown): number {\n  const parsed = typeof value === \"number\"\n    ? value\n    : typeof value === \"string\" && value.trim().length > 0\n      ? Number(value)\n      : NaN;\n  if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(\"codex-cli timeoutMs must be a positive integer\");\n  }\n  return parsed;\n}\n\nexport const __codexCliFallbackTestHooks = {\n  setRunCodexCliForTest: setCodexCliFallbackRunnerForProcess,\n};\n"],"mappings":";AA2CA,IAAM,oCAAoC,oBAAI,IAA6B;AAAA,EACzE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAI;AAOG,SAAS,qCAA8C;AAC5D,SAAO,kBAAkB;AAC3B;AAOO,SAAS,oCACd,QACY;AACZ,QAAM,WAAW;AACjB,kBAAgB;AAChB,SAAO,MAAM;AACX,oBAAgB;AAAA,EAClB;AACF;AAEA,eAAsB,qBACpB,QACA,SACA,UACA,UAAmC,CAAC,GACH;AACjC,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO,MAAM,cAAc;AAAA,IACzB,QAAQ,gCAAgC,MAAM;AAAA,IAC9C,SAAS,uBAAuB,OAAO;AAAA,IACvC;AAAA,IACA,SAAS,iCAAiC,OAAO;AAAA,EACnD,CAAC;AACH;AAEA,SAAS,gCACP,QACwB;AACxB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAI,OAAO,eAAe,SACtB,EAAE,YAAY,wBAAwB,OAAO,YAAY,sBAAsB,EAAE,IACjF,CAAC;AAAA,IACL,GAAI,OAAO,uBAAuB,SAC9B,EAAE,oBAAoB,wBAAwB,OAAO,oBAAoB,sBAAsB,EAAE,IACjG,CAAC;AAAA,IACL,GAAI,OAAO,oBAAoB,SAC3B,EAAE,iBAAiB,iCAAiC,OAAO,eAAe,EAAE,IAC5E,CAAC;AAAA,IACL,GAAI,OAAO,4BAA4B,SACnC,EAAE,yBAAyB,iCAAiC,OAAO,uBAAuB,EAAE,IAC5F,CAAC;AAAA,IACL,GAAI,OAAO,cAAc,cAAc,SACnC,EAAE,cAAc,EAAE,WAAW,2BAA2B,OAAO,aAAa,SAAS,EAAE,EAAE,IACzF,CAAC;AAAA,EACP;AACF;AAEA,SAAS,iCACP,SACyB;AACzB,SAAO;AAAA,IACL,GAAI,QAAQ,cAAc,SACtB,EAAE,WAAW,2BAA2B,QAAQ,SAAS,EAAE,IAC3D,CAAC;AAAA,IACL,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,EACrD;AACF;AAEA,SAAS,wBAAwB,OAAgB,OAAuB;AACtE,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,IAAI,MAAM,GAAG,KAAK,6BAA6B;AAAA,EACvD;AACA,SAAO,MAAM,KAAK;AACpB;AAEA,SAAS,uBAAuB,OAAuB;AACrD,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO;AACT;AAEA,SAAS,iCAAiC,OAAyC;AACjF,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,QAAM,aAAa,MAAM,KAAK,EAAE,YAAY;AAC5C,MAAI,kCAAkC,IAAI,UAAqC,GAAG;AAChF,WAAO;AAAA,EACT;AACA,QAAM,IAAI,MAAM,mEAAmE;AACrF;AAEO,SAAS,2BAA2B,OAAwB;AACjE,QAAM,SAAS,OAAO,UAAU,WAC5B,QACA,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,IACjD,OAAO,KAAK,IACZ;AACN,MAAI,CAAC,OAAO,SAAS,MAAM,KAAK,CAAC,OAAO,UAAU,MAAM,KAAK,UAAU,GAAG;AACxE,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;AAEO,IAAM,8BAA8B;AAAA,EACzC,uBAAuB;AACzB;","names":[]}

package/dist/{chunk-JTH2SE6B.js → chunk-6J6K3STG.js}

@@ -1,7 +1,7 @@
 import {
   buildStandup,
   parseStandupDate
-} from "./chunk-LTIZHLV7.js";
+} from "./chunk-JR6H5CYS.js";
 import {
   backfillMemoryStorage,
   runLocationBackfill,
@@ -9,22 +9,22 @@ import {
   runLocationDay,
   runLocationStatus,
   runLocationSync
-} from "./chunk-UUQG7HAD.js";
+} from "./chunk-HXSAWV3A.js";
 import {
   externalWikiSearchOperation
-} from "./chunk-EONF76DT.js";
-import {
-  memoryStoreRequestSchema
-} from "./chunk-JEIXTYVG.js";
+} from "./chunk-LYDJRF45.js";
 import {
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   defineOperation,
   isCodegraphToolName
-} from "./chunk-UGPUYIET.js";
+} from "./chunk-JHZCXUQI.js";
 import {
   CorrectionContractError
 } from "./chunk-QLK3SL7Q.js";
+import {
+  memoryStoreRequestSchema
+} from "./chunk-L2QLDZJC.js";
 import {
   serializeMutations,
   withHeldFileLock
@@ -1911,4 +1911,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-JTH2SE6B.js.map
+//# sourceMappingURL=chunk-6J6K3STG.js.map

package/dist/{chunk-H4VH5VIB.js → chunk-776GVKL7.js}

@@ -1,6 +1,6 @@
 import {
   runLocationSync
-} from "./chunk-UUQG7HAD.js";
+} from "./chunk-HXSAWV3A.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -58,4 +58,4 @@ export {
   LOCATION_SYNC_DEFAULT_INTERVAL_MS,
   startLocationAutoSync
 };
-//# sourceMappingURL=chunk-H4VH5VIB.js.map
+//# sourceMappingURL=chunk-776GVKL7.js.map

package/dist/{chunk-BUTCAMJM.js → chunk-A2YQL2FF.js}

@@ -1,7 +1,3 @@
-import {
-  STRUCTURED_ATTRIBUTE_LIMITS,
-  TAG_LIMITS
-} from "./chunk-3QQTXYZ6.js";
 import {
   activityDayWindow,
   isValidActivityDate
@@ -12,6 +8,10 @@ import {
 import {
   pathIsInside
 } from "./chunk-C7HJ3NEI.js";
+import {
+  STRUCTURED_ATTRIBUTE_LIMITS,
+  TAG_LIMITS
+} from "./chunk-LSLCFCCQ.js";
 import {
   isErrnoCode
 } from "./chunk-KNA3BXXL.js";
@@ -863,4 +863,4 @@ export {
   fillWearableConversationLocations,
   renderDayLocationContext
 };
-//# sourceMappingURL=chunk-BUTCAMJM.js.map
+//# sourceMappingURL=chunk-A2YQL2FF.js.map

package/dist/chunk-A5UQ52YQ.js

@@ -0,0 +1,211 @@
+import {
+  OKF_RESERVED_BASENAMES
+} from "./chunk-PCEYGOSL.js";
+import {
+  isActivityDigestPath,
+  isArtifactMemoryPath,
+  isLocationDayPath,
+  isMeetingRecordPath
+} from "./chunk-TLHNF6GA.js";
+import {
+  isExternalWikiCollectionName
+} from "./chunk-JV3C2MNQ.js";
+import {
+  isValidActivityDate
+} from "./chunk-353C5UNV.js";
+import {
+  ALL_CATEGORY_DIRS
+} from "./chunk-VS2IYZRU.js";
+
+// src/activity/journal.ts
+import { mkdirSync, statSync, writeFileSync } from "fs";
+import path from "path";
+var JOURNAL_DIR_NAME = "journal";
+var JOURNAL_DAY_TOPLEVEL = /^journal[\\/]\d{4}-\d{2}-\d{2}\.md$/i;
+var JOURNAL_DAY_ANYWHERE = /(?:^|[\\/])journal[\\/]\d{4}-\d{2}-\d{2}\.md$/i;
+function journalPath(memoryDir, date) {
+  if (!isValidActivityDate(date)) {
+    throw new RangeError(`Invalid journal date "${date}"; expected YYYY-MM-DD.`);
+  }
+  return path.join(memoryDir, JOURNAL_DIR_NAME, `${date}.md`);
+}
+function isJournalDayPath(filePath, memoryRoot) {
+  if (memoryRoot !== void 0 && memoryRoot.length > 0) {
+    const relative = path.relative(memoryRoot, path.resolve(memoryRoot, filePath));
+    return JOURNAL_DAY_TOPLEVEL.test(relative);
+  }
+  return JOURNAL_DAY_ANYWHERE.test(filePath);
+}
+function todayJournalDate(now = /* @__PURE__ */ new Date()) {
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function formatCardDuration(card) {
+  const start = Date.parse(card.startUtc);
+  const end = Date.parse(card.endUtc);
+  const minutes = Number.isFinite(start) && Number.isFinite(end) && end > start ? Math.round((end - start) / 6e4) : 0;
+  return `${minutes}m`;
+}
+function renderJournalSeed(date, cards) {
+  const ordered = [...cards].sort((left, right) => {
+    const byStart = left.startUtc.localeCompare(right.startUtc);
+    return byStart !== 0 ? byStart : left.title.localeCompare(right.title);
+  });
+  const glance = ordered.length === 0 ? ["_No cards._"] : ordered.map((card) => `- ${formatCardDuration(card)} ${card.title}`);
+  return [`# Journal \u2014 ${date}`, "", "## Day at a glance", "", ...glance, "", "## Notes", "", ""].join(
+    "\n"
+  );
+}
+function writeJournalFile(filePath, content, force) {
+  let exists = false;
+  try {
+    statSync(filePath);
+    exists = true;
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") throw err;
+  }
+  if (exists && !force) return false;
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  writeFileSync(filePath, content);
+  return true;
+}
+function seedJournal(input) {
+  const filePath = journalPath(input.memoryDir, input.date);
+  const wrote = writeJournalFile(
+    filePath,
+    renderJournalSeed(input.date, input.cards ?? []),
+    input.force === true
+  );
+  return { path: filePath, wrote };
+}
+
+// src/orchestration/generic-recall-paths.ts
+import path2 from "path";
+var CATEGORY_MEMORY_ROOTS = Object.fromEntries(
+  ALL_CATEGORY_DIRS.map((directory) => [directory, true])
+);
+var RESERVED_ARCHIVE_ROOTS = { archive: true, namespaces: true };
+function isQmdCollectionPrefix(prefix, collection, source) {
+  if (typeof collection !== "string" || collection.length === 0) return false;
+  if (prefix.startsWith(`${collection}--`)) return true;
+  if (prefix !== collection) return false;
+  if (source === "qmd") return true;
+  return !Object.hasOwn(CATEGORY_MEMORY_ROOTS, prefix) && !Object.hasOwn(RESERVED_ARCHIVE_ROOTS, prefix);
+}
+function normalizeQmdUriPath(relativePath, source) {
+  if (source !== "qmd" || !relativePath.startsWith("qmd://")) return relativePath;
+  try {
+    const parsed = new URL(relativePath);
+    if (parsed.protocol !== "qmd:" || !parsed.hostname) return relativePath;
+    const collection = decodeURIComponent(parsed.hostname);
+    const pathname = decodeURIComponent(parsed.pathname.replace(/^\/+/, ""));
+    return pathname ? `${collection}/${pathname}` : collection;
+  } catch {
+    return relativePath;
+  }
+}
+function stripQmdCollectionPrefix(relativePath, policy, source) {
+  const normalized = path2.posix.normalize(normalizeQmdUriPath(relativePath, source).replace(/\\/g, "/"));
+  const slashIndex = normalized.indexOf("/");
+  if (slashIndex <= 0 || slashIndex >= normalized.length - 1) return normalized;
+  const prefix = normalized.slice(0, slashIndex);
+  const matchesHotCollection = isQmdCollectionPrefix(prefix, policy.qmdCollection, source);
+  const matchesColdCollection = isQmdCollectionPrefix(prefix, policy.qmdColdCollection, source);
+  return matchesHotCollection || matchesColdCollection ? normalized.slice(slashIndex + 1) : normalized;
+}
+function isTopLevelArchivePath(filePath, policy = {}, source = "filesystem") {
+  const isAbsolutePath = path2.isAbsolute(filePath);
+  const relative = policy.memoryDir && isAbsolutePath ? path2.relative(policy.memoryDir, path2.resolve(filePath)) : filePath;
+  const normalized = !isAbsolutePath ? stripQmdCollectionPrefix(relative, policy, source) : relative;
+  return /^(?:archive|namespaces[\\/][^\\/]+[\\/]archive)(?:[\\/]|$)/i.test(normalized);
+}
+function isExternalWikiQmdPath(filePath, source) {
+  if (source !== "qmd") return false;
+  const normalized = normalizeQmdUriPath(filePath, source).replace(/\\/g, "/");
+  const slashIndex = normalized.indexOf("/");
+  const collection = slashIndex === -1 ? normalized : normalized.slice(0, slashIndex);
+  return isExternalWikiCollectionName(collection);
+}
+function isSearchExcludedPath(filePath, policy = {}, source = "filesystem") {
+  if (isExternalWikiQmdPath(filePath, source)) return true;
+  for (const candidate of collectionSpellings(filePath, policy, source)) {
+    if (isArtifactMemoryPath(candidate) || isNamespacedActivityDigestPath(candidate, policy.memoryDir) || isNamespacedLocationDayPath(candidate, policy.memoryDir) || isNamespacedJournalDayPath(candidate, policy.memoryDir) || isMeetingRecordPath(candidate)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isNamespacedActivityDigestPath(candidate, memoryDir) {
+  if (isActivityDigestPath(candidate, memoryDir)) return true;
+  if (memoryDir === void 0 || memoryDir.length === 0) return false;
+  const relative = path2.relative(memoryDir, path2.resolve(memoryDir, candidate));
+  const namespaced = /^namespaces[\\/]([^\\/]+)[\\/](.*)$/.exec(relative);
+  if (namespaced === null) return false;
+  return isActivityDigestPath(namespaced[2] ?? "", memoryDir);
+}
+function isNamespacedLocationDayPath(candidate, memoryDir) {
+  if (isLocationDayPath(candidate, memoryDir)) return true;
+  if (memoryDir === void 0 || memoryDir.length === 0) return false;
+  const relative = path2.relative(memoryDir, path2.resolve(memoryDir, candidate));
+  const namespaced = /^namespaces[\\/]([^\\/]+)[\\/](.*)$/.exec(relative);
+  if (namespaced === null) return false;
+  return isLocationDayPath(namespaced[2] ?? "", memoryDir);
+}
+function isNamespacedJournalDayPath(candidate, memoryDir) {
+  if (isJournalDayPath(candidate, memoryDir)) return true;
+  if (memoryDir === void 0 || memoryDir.length === 0) return false;
+  const relative = path2.relative(memoryDir, path2.resolve(memoryDir, candidate));
+  const namespaced = /^namespaces[\\/]([^\\/]+)[\\/](.*)$/.exec(relative);
+  if (namespaced === null) return false;
+  return isJournalDayPath(namespaced[2] ?? "", memoryDir);
+}
+function collectionSpellings(filePath, policy, source) {
+  if (path2.isAbsolute(filePath)) return [filePath];
+  if (source === "qmd" && filePath.startsWith("qmd://")) {
+    const normalized2 = path2.posix.normalize(normalizeQmdUriPath(filePath, source).replace(/\\/g, "/"));
+    const slashIndex2 = normalized2.indexOf("/");
+    return slashIndex2 <= 0 || slashIndex2 >= normalized2.length - 1 ? [normalized2] : [normalized2, normalized2.slice(slashIndex2 + 1)];
+  }
+  const normalized = path2.posix.normalize(
+    normalizeQmdUriPath(filePath, source).replace(/\\/g, "/")
+  );
+  const stripped = stripQmdCollectionPrefix(filePath, policy, source);
+  const spellings = [stripped];
+  if (stripped !== normalized) return spellings;
+  const slashIndex = stripped.indexOf("/");
+  if (slashIndex <= 0 || slashIndex >= stripped.length - 1) return spellings;
+  const prefix = stripped.slice(0, slashIndex);
+  const requested = policy.requestedCollection;
+  if (prefix !== requested && (Object.hasOwn(CATEGORY_MEMORY_ROOTS, prefix) || Object.hasOwn(RESERVED_ARCHIVE_ROOTS, prefix))) {
+    return spellings;
+  }
+  spellings.push(stripped.slice(slashIndex + 1));
+  return spellings;
+}
+function isGenericRecallExcludedPath(filePath, policy = {}, source = "filesystem") {
+  return isSearchExcludedPath(filePath, policy, source) || isTopLevelArchivePath(filePath, policy, source) || OKF_RESERVED_BASENAMES[path2.basename(filePath)] === true;
+}
+function filterRecallCandidates(candidates, options) {
+  const pathPolicy = options.pathPolicy ?? (options.memoryRoot === void 0 ? void 0 : { memoryDir: options.memoryRoot });
+  const scopedByNamespace = options.namespacesEnabled ? candidates.filter(
+    (r) => options.recallNamespaces.includes(r.namespace ?? options.resolveNamespace(r.path))
+  ) : candidates;
+  return scopedByNamespace.filter((r) => !isGenericRecallExcludedPath(r.path, pathPolicy, "qmd")).slice(0, Math.max(0, options.limit));
+}
+
+export {
+  JOURNAL_DIR_NAME,
+  journalPath,
+  isJournalDayPath,
+  todayJournalDate,
+  writeJournalFile,
+  seedJournal,
+  isTopLevelArchivePath,
+  isSearchExcludedPath,
+  isGenericRecallExcludedPath,
+  filterRecallCandidates
+};
+//# sourceMappingURL=chunk-A5UQ52YQ.js.map

package/dist/chunk-A5UQ52YQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/activity/journal.ts","../src/orchestration/generic-recall-paths.ts"],"sourcesContent":["/**\n * User-owned daily journal (issue #1984 PR1).\n *\n * Files live at `<memoryDir>/journal/<YYYY-MM-DD>.md` — inside the memory\n * directory but outside scan roots, same placement as activity digests.\n * Once written, Remnic never rewrites the file except `seed` with force.\n * All writes go through writeJournalFile, which stats first.\n */\nimport { mkdirSync, statSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport { isValidActivityDate } from \"./digest.js\";\n\nexport const JOURNAL_DIR_NAME = \"journal\";\n\n/** Minimal card shape the seed renderer needs. TimelineCard is assignable. */\nexport interface JournalSeedCard {\n  title: string;\n  startUtc: string;\n  endUtc: string;\n}\n\nexport interface SeedJournalInput {\n  memoryDir: string;\n  date: string;\n  cards?: readonly JournalSeedCard[];\n  force?: boolean;\n}\n\nexport interface SeedJournalResult {\n  path: string;\n  wrote: boolean;\n}\n\nconst JOURNAL_DAY_TOPLEVEL = /^journal[\\\\/]\\d{4}-\\d{2}-\\d{2}\\.md$/i;\nconst JOURNAL_DAY_ANYWHERE = /(?:^|[\\\\/])journal[\\\\/]\\d{4}-\\d{2}-\\d{2}\\.md$/i;\n\nexport function journalPath(memoryDir: string, date: string): string {\n  if (!isValidActivityDate(date)) {\n    throw new RangeError(`Invalid journal date \"${date}\"; expected YYYY-MM-DD.`);\n  }\n  return path.join(memoryDir, JOURNAL_DIR_NAME, `${date}.md`);\n}\n\n/**\n * Root-aware journal day-file check. With a memory root, only the top-level\n * `journal/<date>.md` matches so a nested `facts/journal/<date>.md` stays\n * recallable. Without a root, fall back to the day-file shape anywhere.\n */\nexport function isJournalDayPath(filePath: string, memoryRoot?: string): boolean {\n  if (memoryRoot !== undefined && memoryRoot.length > 0) {\n    const relative = path.relative(memoryRoot, path.resolve(memoryRoot, filePath));\n    return JOURNAL_DAY_TOPLEVEL.test(relative);\n  }\n  return JOURNAL_DAY_ANYWHERE.test(filePath);\n}\n\nexport function todayJournalDate(now: Date = new Date()): string {\n  const year = now.getFullYear();\n  const month = String(now.getMonth() + 1).padStart(2, \"0\");\n  const day = String(now.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\nfunction formatCardDuration(card: JournalSeedCard): string {\n  const start = Date.parse(card.startUtc);\n  const end = Date.parse(card.endUtc);\n  const minutes =\n    Number.isFinite(start) && Number.isFinite(end) && end > start\n      ? Math.round((end - start) / 60_000)\n      : 0;\n  return `${minutes}m`;\n}\n\nfunction renderJournalSeed(date: string, cards: readonly JournalSeedCard[]): string {\n  const ordered = [...cards].sort((left, right) => {\n    const byStart = left.startUtc.localeCompare(right.startUtc);\n    return byStart !== 0 ? byStart : left.title.localeCompare(right.title);\n  });\n  const glance =\n    ordered.length === 0\n      ? [\"_No cards._\"]\n      : ordered.map((card) => `- ${formatCardDuration(card)} ${card.title}`);\n  return [`# Journal — ${date}`, \"\", \"## Day at a glance\", \"\", ...glance, \"\", \"## Notes\", \"\", \"\"].join(\n    \"\\n\",\n  );\n}\n\n/** The only journal write. Stats first; existing files are a no-op unless force. */\nexport function writeJournalFile(filePath: string, content: string, force: boolean): boolean {\n  let exists = false;\n  try {\n    statSync(filePath);\n    exists = true;\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    if (code !== \"ENOENT\") throw err;\n  }\n  if (exists && !force) return false;\n  mkdirSync(path.dirname(filePath), { recursive: true });\n  writeFileSync(filePath, content);\n  return true;\n}\n\nexport function seedJournal(input: SeedJournalInput): SeedJournalResult {\n  const filePath = journalPath(input.memoryDir, input.date);\n  const wrote = writeJournalFile(\n    filePath,\n    renderJournalSeed(input.date, input.cards ?? []),\n    input.force === true,\n  );\n  return { path: filePath, wrote };\n}\n","import path from \"node:path\";\nimport type { QmdSearchResult } from \"../types.js\";\nimport { isExternalWikiCollectionName } from \"../external-wiki-guard.js\";\nexport { isExternalWikiCollectionName } from \"../external-wiki-guard.js\";\nimport { ALL_CATEGORY_DIRS } from \"../utils/category-dir.js\";\nimport {\n  isActivityDigestPath,\n  isArtifactMemoryPath,\n  isLocationDayPath,\n  isMeetingRecordPath,\n} from \"./orchestrator-helpers.js\";\nimport { isJournalDayPath } from \"../activity/journal.js\";\nimport { OKF_RESERVED_BASENAMES } from \"../okf/type-mapping.js\";\n\n\nexport interface GenericRecallPathPolicy {\n  readonly memoryDir?: string;\n  readonly qmdCollection?: string;\n  readonly qmdColdCollection?: string;\n  /**\n   * The collection THIS request named, when it named one. A caller may select\n   * a custom collection whose name is also a memory category, which the\n   * configured names alone cannot disambiguate.\n   */\n  readonly requestedCollection?: string;\n}\n\ntype GenericRecallPathSource = \"filesystem\" | \"qmd\";\n\nconst CATEGORY_MEMORY_ROOTS: Record<string, true> = Object.fromEntries(\n  ALL_CATEGORY_DIRS.map((directory) => [directory, true]),\n);\nconst RESERVED_ARCHIVE_ROOTS: Record<string, true> = { archive: true, namespaces: true };\n\nfunction isQmdCollectionPrefix(\n  prefix: string,\n  collection: string | undefined,\n  source: GenericRecallPathSource,\n): boolean {\n  if (typeof collection !== \"string\" || collection.length === 0) return false;\n  if (prefix.startsWith(`${collection}--`)) return true;\n  if (prefix !== collection) return false;\n  if (source === \"qmd\") return true;\n  return (\n    !Object.hasOwn(CATEGORY_MEMORY_ROOTS, prefix) &&\n    !Object.hasOwn(RESERVED_ARCHIVE_ROOTS, prefix)\n  );\n}\n\nfunction normalizeQmdUriPath(relativePath: string, source: GenericRecallPathSource): string {\n  if (source !== \"qmd\" || !relativePath.startsWith(\"qmd://\")) return relativePath;\n  try {\n    const parsed = new URL(relativePath);\n    if (parsed.protocol !== \"qmd:\" || !parsed.hostname) return relativePath;\n    const collection = decodeURIComponent(parsed.hostname);\n    const pathname = decodeURIComponent(parsed.pathname.replace(/^\\/+/, \"\"));\n    return pathname ? `${collection}/${pathname}` : collection;\n  } catch {\n    return relativePath;\n  }\n}\n\nfunction stripQmdCollectionPrefix(\n  relativePath: string,\n  policy: GenericRecallPathPolicy,\n  source: GenericRecallPathSource,\n): string {\n  const normalized = path.posix.normalize(normalizeQmdUriPath(relativePath, source).replace(/\\\\/g, \"/\"));\n  const slashIndex = normalized.indexOf(\"/\");\n  if (slashIndex <= 0 || slashIndex >= normalized.length - 1) return normalized;\n\n  const prefix = normalized.slice(0, slashIndex);\n  const matchesHotCollection = isQmdCollectionPrefix(prefix, policy.qmdCollection, source);\n  const matchesColdCollection = isQmdCollectionPrefix(prefix, policy.qmdColdCollection, source);\n  return matchesHotCollection || matchesColdCollection\n    ? normalized.slice(slashIndex + 1)\n    : normalized;\n}\n\nexport function isTopLevelArchivePath(\n  filePath: string,\n  policy: GenericRecallPathPolicy = {},\n  source: GenericRecallPathSource = \"filesystem\",\n): boolean {\n  const isAbsolutePath = path.isAbsolute(filePath);\n  const relative =\n    policy.memoryDir && isAbsolutePath\n      ? path.relative(policy.memoryDir, path.resolve(filePath))\n      : filePath;\n  const normalized = !isAbsolutePath\n    ? stripQmdCollectionPrefix(relative, policy, source)\n    : relative;\n  return /^(?:archive|namespaces[\\\\/][^\\\\/]+[\\\\/]archive)(?:[\\\\/]|$)/i.test(normalized);\n}\n\nfunction isExternalWikiQmdPath(\n  filePath: string,\n  source: GenericRecallPathSource,\n): boolean {\n  if (source !== \"qmd\") return false;\n  const normalized = normalizeQmdUriPath(filePath, source).replace(/\\\\/g, \"/\");\n  const slashIndex = normalized.indexOf(\"/\");\n  const collection = slashIndex === -1 ? normalized : normalized.slice(0, slashIndex);\n  return isExternalWikiCollectionName(collection);\n}\n\n/**\n * Paths an EXPLICIT ranked search must not return.\n *\n * Narrower than {@link isGenericRecallExcludedPath} on purpose. Recall\n * injection also drops archived memories because they are cold by definition,\n * but archive is explicitly reserved for \"explicit read or search surfaces\"\n * (docs/architecture/memory-lifecycle.md) — hiding it from `memory_search`\n * would remove the only way to find it. Everything else stays excluded: those\n * paths flow through their own dedicated surfaces, never a generic search.\n */\nexport function isSearchExcludedPath(\n  filePath: string,\n  policy: GenericRecallPathPolicy = {},\n  source: GenericRecallPathSource = \"filesystem\",\n): boolean {\n  if (isExternalWikiQmdPath(filePath, source)) return true;\n  // A QMD transport hands back collection-qualified paths\n  // (`qmd://<collection>/activity/<date>.md`, or `<collection>/activity/…`),\n  // and the collection is not always one this policy knows: a caller may name\n  // a custom one, and global search spans every collection. The activity\n  // predicate is ROOT-AWARE — it matches only the top-level\n  // `activity/<date>.md` so a nested ordinary memory stays recallable — so an\n  // un-stripped prefix reads as a nested path and the digest would be served.\n  //\n  // Both spellings are therefore tested. Widening is safe in this direction\n  // and only here: a leading segment is dropped ONLY to re-test the dedicated\n  // surface shapes, never to decide anything else, and a segment that names a\n  // memory CATEGORY (`facts/proj/activity/…`) is never treated as a\n  // collection, so ordinary nested memories stay searchable.\n  for (const candidate of collectionSpellings(filePath, policy, source)) {\n    if (\n      isArtifactMemoryPath(candidate) ||\n      isNamespacedActivityDigestPath(candidate, policy.memoryDir) ||\n      isNamespacedLocationDayPath(candidate, policy.memoryDir) ||\n      isNamespacedJournalDayPath(candidate, policy.memoryDir) ||\n      isMeetingRecordPath(candidate)\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * The activity check, applied against the NAMESPACE root a hit came from.\n *\n * `isActivityDigestPath` is root-aware — the digest must sit directly under\n * the root it is given — but a namespaced search rewrites hits to absolute\n * paths beneath `…/namespaces/<ns>/`, and only the global `memoryDir` is\n * available here. Measured against that root, a real digest at\n * `<memoryDir>/namespaces/team/activity/<date>.md` reads as nested and is\n * served. Re-measuring against the namespace's own root closes that.\n */\nfunction isNamespacedActivityDigestPath(candidate: string, memoryDir?: string): boolean {\n  if (isActivityDigestPath(candidate, memoryDir)) return true;\n  if (memoryDir === undefined || memoryDir.length === 0) return false;\n  const relative = path.relative(memoryDir, path.resolve(memoryDir, candidate));\n  const namespaced = /^namespaces[\\\\/]([^\\\\/]+)[\\\\/](.*)$/.exec(relative);\n  if (namespaced === null) return false;\n  return isActivityDigestPath(namespaced[2] ?? \"\", memoryDir);\n}\n\n/**\n * The location day-file check, applied against the NAMESPACE root a hit came\n * from — same rationale as `isNamespacedActivityDigestPath`: a namespaced\n * search rewrites hits to absolute paths beneath `…/namespaces/<ns>/`, so the\n * root-aware predicate is re-measured against the namespace's own root.\n */\nfunction isNamespacedLocationDayPath(candidate: string, memoryDir?: string): boolean {\n  if (isLocationDayPath(candidate, memoryDir)) return true;\n  if (memoryDir === undefined || memoryDir.length === 0) return false;\n  const relative = path.relative(memoryDir, path.resolve(memoryDir, candidate));\n  const namespaced = /^namespaces[\\\\/]([^\\\\/]+)[\\\\/](.*)$/.exec(relative);\n  if (namespaced === null) return false;\n  return isLocationDayPath(namespaced[2] ?? \"\", memoryDir);\n}\n\nfunction isNamespacedJournalDayPath(candidate: string, memoryDir?: string): boolean {\n  if (isJournalDayPath(candidate, memoryDir)) return true;\n  if (memoryDir === undefined || memoryDir.length === 0) return false;\n  const relative = path.relative(memoryDir, path.resolve(memoryDir, candidate));\n  const namespaced = /^namespaces[\\\\/]([^\\\\/]+)[\\\\/](.*)$/.exec(relative);\n  if (namespaced === null) return false;\n  return isJournalDayPath(namespaced[2] ?? \"\", memoryDir);\n}\n\n/** A path as given, plus its form with a leading COLLECTION segment removed. */\nfunction collectionSpellings(\n  filePath: string,\n  policy: GenericRecallPathPolicy,\n  source: GenericRecallPathSource,\n): string[] {\n  if (path.isAbsolute(filePath)) return [filePath];\n  // A `qmd://<collection>/<path>` URI states its collection UNAMBIGUOUSLY in\n  // the authority, so the leading segment of its normalized form is never a\n  // memory category — strip it outright rather than guessing.\n  if (source === \"qmd\" && filePath.startsWith(\"qmd://\")) {\n    const normalized = path.posix.normalize(normalizeQmdUriPath(filePath, source).replace(/\\\\/g, \"/\"));\n    const slashIndex = normalized.indexOf(\"/\");\n    return slashIndex <= 0 || slashIndex >= normalized.length - 1\n      ? [normalized]\n      : [normalized, normalized.slice(slashIndex + 1)];\n  }\n  const normalized = path.posix.normalize(\n    normalizeQmdUriPath(filePath, source).replace(/\\\\/g, \"/\"),\n  );\n  const stripped = stripQmdCollectionPrefix(filePath, policy, source);\n  const spellings = [stripped];\n  // If the AUTHORITATIVE strip already fired — the prefix matched a configured\n  // collection — stop. Removing a second segment would take a real directory\n  // with it: `memories/projects/activity/<date>.md` would become\n  // `activity/<date>.md` and an ordinary nested memory would read as a\n  // top-level digest, vanishing from search AND recall.\n  if (stripped !== normalized) return spellings;\n  const slashIndex = stripped.indexOf(\"/\");\n  if (slashIndex <= 0 || slashIndex >= stripped.length - 1) return spellings;\n  const prefix = stripped.slice(0, slashIndex);\n  // The CALLER's own collection is authoritative: a request for\n  // `collection: \"facts\"` means that segment is the collection, whatever it is\n  // also the name of. Otherwise a category-shaped prefix stays part of the\n  // path, so an ordinary `facts/proj/activity/<date>.md` memory is searchable.\n  const requested = policy.requestedCollection;\n  if (\n    prefix !== requested &&\n    (Object.hasOwn(CATEGORY_MEMORY_ROOTS, prefix) || Object.hasOwn(RESERVED_ARCHIVE_ROOTS, prefix))\n  ) {\n    return spellings;\n  }\n  spellings.push(stripped.slice(slashIndex + 1));\n  return spellings;\n}\n\nexport function isGenericRecallExcludedPath(\n  filePath: string,\n  policy: GenericRecallPathPolicy = {},\n  source: GenericRecallPathSource = \"filesystem\",\n): boolean {\n  return (\n    isSearchExcludedPath(filePath, policy, source) ||\n    isTopLevelArchivePath(filePath, policy, source) ||\n    OKF_RESERVED_BASENAMES[path.basename(filePath)] === true\n  );\n}\n\nexport function filterRecallCandidates(\n  candidates: QmdSearchResult[],\n  options: {\n    namespacesEnabled: boolean;\n    recallNamespaces: string[];\n    resolveNamespace: (path: string) => string;\n    limit: number;\n    pathPolicy?: GenericRecallPathPolicy;\n    memoryRoot?: string;\n  },\n): QmdSearchResult[] {\n  const pathPolicy =\n    options.pathPolicy ??\n    (options.memoryRoot === undefined ? undefined : { memoryDir: options.memoryRoot });\n  const scopedByNamespace = options.namespacesEnabled\n    ? candidates.filter((r) =>\n        options.recallNamespaces.includes(r.namespace ?? options.resolveNamespace(r.path)),\n      )\n    : candidates;\n  return scopedByNamespace\n    .filter((r) => !isGenericRecallExcludedPath(r.path, pathPolicy, \"qmd\"))\n    .slice(0, Math.max(0, options.limit));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAQA,SAAS,WAAW,UAAU,qBAAqB;AACnD,OAAO,UAAU;AAIV,IAAM,mBAAmB;AAqBhC,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAEtB,SAAS,YAAY,WAAmB,MAAsB;AACnE,MAAI,CAAC,oBAAoB,IAAI,GAAG;AAC9B,UAAM,IAAI,WAAW,yBAAyB,IAAI,yBAAyB;AAAA,EAC7E;AACA,SAAO,KAAK,KAAK,WAAW,kBAAkB,GAAG,IAAI,KAAK;AAC5D;AAOO,SAAS,iBAAiB,UAAkB,YAA8B;AAC/E,MAAI,eAAe,UAAa,WAAW,SAAS,GAAG;AACrD,UAAM,WAAW,KAAK,SAAS,YAAY,KAAK,QAAQ,YAAY,QAAQ,CAAC;AAC7E,WAAO,qBAAqB,KAAK,QAAQ;AAAA,EAC3C;AACA,SAAO,qBAAqB,KAAK,QAAQ;AAC3C;AAEO,SAAS,iBAAiB,MAAY,oBAAI,KAAK,GAAW;AAC/D,QAAM,OAAO,IAAI,YAAY;AAC7B,QAAM,QAAQ,OAAO,IAAI,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,MAAM,OAAO,IAAI,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;AACjD,SAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG;AAChC;AAEA,SAAS,mBAAmB,MAA+B;AACzD,QAAM,QAAQ,KAAK,MAAM,KAAK,QAAQ;AACtC,QAAM,MAAM,KAAK,MAAM,KAAK,MAAM;AAClC,QAAM,UACJ,OAAO,SAAS,KAAK,KAAK,OAAO,SAAS,GAAG,KAAK,MAAM,QACpD,KAAK,OAAO,MAAM,SAAS,GAAM,IACjC;AACN,SAAO,GAAG,OAAO;AACnB;AAEA,SAAS,kBAAkB,MAAc,OAA2C;AAClF,QAAM,UAAU,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,UAAU;AAC/C,UAAM,UAAU,KAAK,SAAS,cAAc,MAAM,QAAQ;AAC1D,WAAO,YAAY,IAAI,UAAU,KAAK,MAAM,cAAc,MAAM,KAAK;AAAA,EACvE,CAAC;AACD,QAAM,SACJ,QAAQ,WAAW,IACf,CAAC,aAAa,IACd,QAAQ,IAAI,CAAC,SAAS,KAAK,mBAAmB,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE;AACzE,SAAO,CAAC,oBAAe,IAAI,IAAI,IAAI,sBAAsB,IAAI,GAAG,QAAQ,IAAI,YAAY,IAAI,EAAE,EAAE;AAAA,IAC9F;AAAA,EACF;AACF;AAGO,SAAS,iBAAiB,UAAkB,SAAiB,OAAyB;AAC3F,MAAI,SAAS;AACb,MAAI;AACF,aAAS,QAAQ;AACjB,aAAS;AAAA,EACX,SAAS,KAAK;AACZ,UAAM,OAAQ,IAA8B;AAC5C,QAAI,SAAS,SAAU,OAAM;AAAA,EAC/B;AACA,MAAI,UAAU,CAAC,MAAO,QAAO;AAC7B,YAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACrD,gBAAc,UAAU,OAAO;AAC/B,SAAO;AACT;AAEO,SAAS,YAAY,OAA4C;AACtE,QAAM,WAAW,YAAY,MAAM,WAAW,MAAM,IAAI;AACxD,QAAM,QAAQ;AAAA,IACZ;AAAA,IACA,kBAAkB,MAAM,MAAM,MAAM,SAAS,CAAC,CAAC;AAAA,IAC/C,MAAM,UAAU;AAAA,EAClB;AACA,SAAO,EAAE,MAAM,UAAU,MAAM;AACjC;;;AChHA,OAAOA,WAAU;AA6BjB,IAAM,wBAA8C,OAAO;AAAA,EACzD,kBAAkB,IAAI,CAAC,cAAc,CAAC,WAAW,IAAI,CAAC;AACxD;AACA,IAAM,yBAA+C,EAAE,SAAS,MAAM,YAAY,KAAK;AAEvF,SAAS,sBACP,QACA,YACA,QACS;AACT,MAAI,OAAO,eAAe,YAAY,WAAW,WAAW,EAAG,QAAO;AACtE,MAAI,OAAO,WAAW,GAAG,UAAU,IAAI,EAAG,QAAO;AACjD,MAAI,WAAW,WAAY,QAAO;AAClC,MAAI,WAAW,MAAO,QAAO;AAC7B,SACE,CAAC,OAAO,OAAO,uBAAuB,MAAM,KAC5C,CAAC,OAAO,OAAO,wBAAwB,MAAM;AAEjD;AAEA,SAAS,oBAAoB,cAAsB,QAAyC;AAC1F,MAAI,WAAW,SAAS,CAAC,aAAa,WAAW,QAAQ,EAAG,QAAO;AACnE,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,YAAY;AACnC,QAAI,OAAO,aAAa,UAAU,CAAC,OAAO,SAAU,QAAO;AAC3D,UAAM,aAAa,mBAAmB,OAAO,QAAQ;AACrD,UAAM,WAAW,mBAAmB,OAAO,SAAS,QAAQ,QAAQ,EAAE,CAAC;AACvE,WAAO,WAAW,GAAG,UAAU,IAAI,QAAQ,KAAK;AAAA,EAClD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,yBACP,cACA,QACA,QACQ;AACR,QAAM,aAAaC,MAAK,MAAM,UAAU,oBAAoB,cAAc,MAAM,EAAE,QAAQ,OAAO,GAAG,CAAC;AACrG,QAAM,aAAa,WAAW,QAAQ,GAAG;AACzC,MAAI,cAAc,KAAK,cAAc,WAAW,SAAS,EAAG,QAAO;AAEnE,QAAM,SAAS,WAAW,MAAM,GAAG,UAAU;AAC7C,QAAM,uBAAuB,sBAAsB,QAAQ,OAAO,eAAe,MAAM;AACvF,QAAM,wBAAwB,sBAAsB,QAAQ,OAAO,mBAAmB,MAAM;AAC5F,SAAO,wBAAwB,wBAC3B,WAAW,MAAM,aAAa,CAAC,IAC/B;AACN;AAEO,SAAS,sBACd,UACA,SAAkC,CAAC,GACnC,SAAkC,cACzB;AACT,QAAM,iBAAiBA,MAAK,WAAW,QAAQ;AAC/C,QAAM,WACJ,OAAO,aAAa,iBAChBA,MAAK,SAAS,OAAO,WAAWA,MAAK,QAAQ,QAAQ,CAAC,IACtD;AACN,QAAM,aAAa,CAAC,iBAChB,yBAAyB,UAAU,QAAQ,MAAM,IACjD;AACJ,SAAO,8DAA8D,KAAK,UAAU;AACtF;AAEA,SAAS,sBACP,UACA,QACS;AACT,MAAI,WAAW,MAAO,QAAO;AAC7B,QAAM,aAAa,oBAAoB,UAAU,MAAM,EAAE,QAAQ,OAAO,GAAG;AAC3E,QAAM,aAAa,WAAW,QAAQ,GAAG;AACzC,QAAM,aAAa,eAAe,KAAK,aAAa,WAAW,MAAM,GAAG,UAAU;AAClF,SAAO,6BAA6B,UAAU;AAChD;AAYO,SAAS,qBACd,UACA,SAAkC,CAAC,GACnC,SAAkC,cACzB;AACT,MAAI,sBAAsB,UAAU,MAAM,EAAG,QAAO;AAcpD,aAAW,aAAa,oBAAoB,UAAU,QAAQ,MAAM,GAAG;AACrE,QACE,qBAAqB,SAAS,KAC9B,+BAA+B,WAAW,OAAO,SAAS,KAC1D,4BAA4B,WAAW,OAAO,SAAS,KACvD,2BAA2B,WAAW,OAAO,SAAS,KACtD,oBAAoB,SAAS,GAC7B;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAYA,SAAS,+BAA+B,WAAmB,WAA6B;AACtF,MAAI,qBAAqB,WAAW,SAAS,EAAG,QAAO;AACvD,MAAI,cAAc,UAAa,UAAU,WAAW,EAAG,QAAO;AAC9D,QAAM,WAAWA,MAAK,SAAS,WAAWA,MAAK,QAAQ,WAAW,SAAS,CAAC;AAC5E,QAAM,aAAa,sCAAsC,KAAK,QAAQ;AACtE,MAAI,eAAe,KAAM,QAAO;AAChC,SAAO,qBAAqB,WAAW,CAAC,KAAK,IAAI,SAAS;AAC5D;AAQA,SAAS,4BAA4B,WAAmB,WAA6B;AACnF,MAAI,kBAAkB,WAAW,SAAS,EAAG,QAAO;AACpD,MAAI,cAAc,UAAa,UAAU,WAAW,EAAG,QAAO;AAC9D,QAAM,WAAWA,MAAK,SAAS,WAAWA,MAAK,QAAQ,WAAW,SAAS,CAAC;AAC5E,QAAM,aAAa,sCAAsC,KAAK,QAAQ;AACtE,MAAI,eAAe,KAAM,QAAO;AAChC,SAAO,kBAAkB,WAAW,CAAC,KAAK,IAAI,SAAS;AACzD;AAEA,SAAS,2BAA2B,WAAmB,WAA6B;AAClF,MAAI,iBAAiB,WAAW,SAAS,EAAG,QAAO;AACnD,MAAI,cAAc,UAAa,UAAU,WAAW,EAAG,QAAO;AAC9D,QAAM,WAAWA,MAAK,SAAS,WAAWA,MAAK,QAAQ,WAAW,SAAS,CAAC;AAC5E,QAAM,aAAa,sCAAsC,KAAK,QAAQ;AACtE,MAAI,eAAe,KAAM,QAAO;AAChC,SAAO,iBAAiB,WAAW,CAAC,KAAK,IAAI,SAAS;AACxD;AAGA,SAAS,oBACP,UACA,QACA,QACU;AACV,MAAIA,MAAK,WAAW,QAAQ,EAAG,QAAO,CAAC,QAAQ;AAI/C,MAAI,WAAW,SAAS,SAAS,WAAW,QAAQ,GAAG;AACrD,UAAMC,cAAaD,MAAK,MAAM,UAAU,oBAAoB,UAAU,MAAM,EAAE,QAAQ,OAAO,GAAG,CAAC;AACjG,UAAME,cAAaD,YAAW,QAAQ,GAAG;AACzC,WAAOC,eAAc,KAAKA,eAAcD,YAAW,SAAS,IACxD,CAACA,WAAU,IACX,CAACA,aAAYA,YAAW,MAAMC,cAAa,CAAC,CAAC;AAAA,EACnD;AACA,QAAM,aAAaF,MAAK,MAAM;AAAA,IAC5B,oBAAoB,UAAU,MAAM,EAAE,QAAQ,OAAO,GAAG;AAAA,EAC1D;AACA,QAAM,WAAW,yBAAyB,UAAU,QAAQ,MAAM;AAClE,QAAM,YAAY,CAAC,QAAQ;AAM3B,MAAI,aAAa,WAAY,QAAO;AACpC,QAAM,aAAa,SAAS,QAAQ,GAAG;AACvC,MAAI,cAAc,KAAK,cAAc,SAAS,SAAS,EAAG,QAAO;AACjE,QAAM,SAAS,SAAS,MAAM,GAAG,UAAU;AAK3C,QAAM,YAAY,OAAO;AACzB,MACE,WAAW,cACV,OAAO,OAAO,uBAAuB,MAAM,KAAK,OAAO,OAAO,wBAAwB,MAAM,IAC7F;AACA,WAAO;AAAA,EACT;AACA,YAAU,KAAK,SAAS,MAAM,aAAa,CAAC,CAAC;AAC7C,SAAO;AACT;AAEO,SAAS,4BACd,UACA,SAAkC,CAAC,GACnC,SAAkC,cACzB;AACT,SACE,qBAAqB,UAAU,QAAQ,MAAM,KAC7C,sBAAsB,UAAU,QAAQ,MAAM,KAC9C,uBAAuBA,MAAK,SAAS,QAAQ,CAAC,MAAM;AAExD;AAEO,SAAS,uBACd,YACA,SAQmB;AACnB,QAAM,aACJ,QAAQ,eACP,QAAQ,eAAe,SAAY,SAAY,EAAE,WAAW,QAAQ,WAAW;AAClF,QAAM,oBAAoB,QAAQ,oBAC9B,WAAW;AAAA,IAAO,CAAC,MACjB,QAAQ,iBAAiB,SAAS,EAAE,aAAa,QAAQ,iBAAiB,EAAE,IAAI,CAAC;AAAA,EACnF,IACA;AACJ,SAAO,kBACJ,OAAO,CAAC,MAAM,CAAC,4BAA4B,EAAE,MAAM,YAAY,KAAK,CAAC,EACrE,MAAM,GAAG,KAAK,IAAI,GAAG,QAAQ,KAAK,CAAC;AACxC;","names":["path","path","normalized","slashIndex"]}

package/dist/{chunk-X2NFFBTO.js → chunk-A7GQBJP5.js}

@@ -1,3 +1,6 @@
+import {
+  LcmDag
+} from "./chunk-7N4KAIGN.js";
 import {
   LcmWorkQueue
 } from "./chunk-TPDBFYEG.js";
@@ -14,9 +17,6 @@ import {
 import {
   LcmArchive
 } from "./chunk-WVP2I6C5.js";
-import {
-  LcmDag
-} from "./chunk-7N4KAIGN.js";
 import {
   nativeBindingRecoveryHint
 } from "./chunk-LD72P4YS.js";
@@ -573,4 +573,4 @@ export {
   extractLcmConfig,
   LcmEngine
 };
-//# sourceMappingURL=chunk-X2NFFBTO.js.map
+//# sourceMappingURL=chunk-A7GQBJP5.js.map

package/dist/{chunk-CGC5UQCF.js → chunk-AKE4GGQ3.js}

@@ -1,6 +1,6 @@
 import {
   gatewayTaskChainOptions
-} from "./chunk-TLPZ6MKZ.js";
+} from "./chunk-YEN4TREG.js";
 
 // src/deep-recall-policy-llm.ts
 var DEEP_RECALL_POLICY_SYSTEM_PROMPT = "You are the retrieval policy for a long-term memory system. Given the question, the current working set of retrieved memories, and the frontier of anchor-linked candidates, choose exactly one action: REFINE (rewrite the query), EXPAND (follow named frontier nodes), or STOP. Respond with JSON only.";
@@ -47,4 +47,4 @@ export {
   DEEP_RECALL_POLICY_SYSTEM_PROMPT,
   callDeepRecallPolicyLlm
 };
-//# sourceMappingURL=chunk-CGC5UQCF.js.map
+//# sourceMappingURL=chunk-AKE4GGQ3.js.map

package/dist/{chunk-B325AGLK.js → chunk-AZSKROVQ.js}

@@ -3,7 +3,7 @@ import {
   getOperation,
   operationRequiresAuthorizedNamespace,
   operationUsesPrincipalNamespace
-} from "./chunk-UGPUYIET.js";
+} from "./chunk-JHZCXUQI.js";
 import {
   assertOperationAuthorizationAllowed
 } from "./chunk-MZWSOLMT.js";
@@ -60,4 +60,4 @@ export {
   authorizationProbeNamespaces,
   authorizationProbeRequiresPrincipalNamespace
 };
-//# sourceMappingURL=chunk-B325AGLK.js.map
+//# sourceMappingURL=chunk-AZSKROVQ.js.map

package/dist/{chunk-I5DZ3WGR.js → chunk-BJETIR53.js}

@@ -1,9 +1,9 @@
 import {
   NamespaceStorageRouter
-} from "./chunk-44T3Y7SZ.js";
+} from "./chunk-RUXPVSML.js";
 import {
   namespaceCollectionName
-} from "./chunk-J7HFPA6O.js";
+} from "./chunk-Y63ZFP4X.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-PCXDUHQH.js";
@@ -213,4 +213,4 @@ export {
   verifyNamespaces,
   runNamespaceMigration
 };
-//# sourceMappingURL=chunk-I5DZ3WGR.js.map
+//# sourceMappingURL=chunk-BJETIR53.js.map

package/dist/{chunk-JT3EB7ZL.js → chunk-BNGHPYZU.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-7CBKAQIG.js";
 import {
   gatewayTaskChainOptions
-} from "./chunk-TLPZ6MKZ.js";
-import {
-  extractJsonCandidates
-} from "./chunk-RGMVMVMF.js";
+} from "./chunk-YEN4TREG.js";
 import {
   normalizeProcedureSteps
 } from "./chunk-QDW3E4RD.js";
+import {
+  extractJsonCandidates
+} from "./chunk-RGMVMVMF.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -491,4 +491,4 @@ export {
   createVerdictCache,
   createDeferCountMap
 };
-//# sourceMappingURL=chunk-JT3EB7ZL.js.map
+//# sourceMappingURL=chunk-BNGHPYZU.js.map

package/dist/chunk-BRZWWUCJ.js

@@ -0,0 +1,13 @@
+import {
+  widenRecallStateViews
+} from "./chunk-VELCIWJZ.js";
+
+// src/recall-state-view-wire.ts
+function applyRecallStateViews(results, query, config, stateViewActive, asOfMs) {
+  return widenRecallStateViews(results, query, config, [], stateViewActive, asOfMs);
+}
+
+export {
+  applyRecallStateViews
+};
+//# sourceMappingURL=chunk-BRZWWUCJ.js.map

package/dist/{chunk-FYDW33ZB.js.map → chunk-BRZWWUCJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-state-view-wire.ts"],"sourcesContent":["/**\n * Recall inject seam for state views (issue #1952).\n *\n * Widening lives in recall-state-view-widen.ts. parseConfig cannot grow.\n * Operators set `recallStateViews` on the live PluginConfig extra field.\n * Default false is identity.\n */\n\nimport { widenRecallStateViews } from \"./recall-state-view-widen.js\";\nimport type { StateViewResult } from \"./recall-state-view.js\";\n\nexport function applyRecallStateViews<T extends StateViewResult>(\n  results: T[],\n  query: string,\n  config: unknown,\n): T[] {\n  return widenRecallStateViews(results, query, config);\n}\n"],"mappings":";;;;;AAWO,SAAS,sBACd,SACA,OACA,QACK;AACL,SAAO,sBAAsB,SAAS,OAAO,MAAM;AACrD;","names":[]}
+{"version":3,"sources":["../src/recall-state-view-wire.ts"],"sourcesContent":["/**\n * Recall inject seam for state views (issue #1952).\n *\n * Widening lives in recall-state-view-widen.ts. parseConfig cannot grow.\n * Operators set `recallStateViews` on the live PluginConfig extra field.\n * Default false is identity.\n */\n\nimport { widenRecallStateViews } from \"./recall-state-view-widen.js\";\nimport type { StateViewResult } from \"./recall-state-view.js\";\n\nexport function applyRecallStateViews<T extends StateViewResult>(\n  results: T[],\n  query: string,\n  config: unknown,\n  stateViewActive?: boolean,\n  asOfMs?: number,\n): T[] {\n  return widenRecallStateViews(results, query, config, [], stateViewActive, asOfMs);\n}\n"],"mappings":";;;;;AAWO,SAAS,sBACd,SACA,OACA,QACA,iBACA,QACK;AACL,SAAO,sBAAsB,SAAS,OAAO,QAAQ,CAAC,GAAG,iBAAiB,MAAM;AAClF;","names":[]}

package/dist/{chunk-3JVLGJCY.js → chunk-C6KRO3SU.js}

@@ -1,6 +1,6 @@
 import {
   getConfiguredNamespaces
-} from "./chunk-XU6OEECT.js";
+} from "./chunk-OQQXGYMX.js";
 import {
   drainPendingLifecycleForSyncOrThrow,
   drainPendingLifecycleLedgerForSync
@@ -181,4 +181,4 @@ export {
   offlineSyncStorageForSnapshot,
   drainPendingLifecycleForOfflineSync
 };
-//# sourceMappingURL=chunk-3JVLGJCY.js.map
+//# sourceMappingURL=chunk-C6KRO3SU.js.map

package/dist/{chunk-5NANRSCD.js → chunk-CNV2A557.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-HV7OY4DM.js";
+} from "./chunk-5VAF4ID4.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -10,12 +10,12 @@ import {
 import {
   extractJsonCandidates
 } from "./chunk-RGMVMVMF.js";
+import {
+  excludeSupportPassportPrivateMemories
+} from "./chunk-PWPIERBM.js";
 import {
   serializeMutations
 } from "./chunk-FFAZ2XFU.js";
-import {
-  excludeSupportPassportPrivateMemories
-} from "./chunk-EEOUMG3J.js";
 import {
   readEnvVar,
   resolveHomeDir
@@ -957,4 +957,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-5NANRSCD.js.map
+//# sourceMappingURL=chunk-CNV2A557.js.map

package/dist/{chunk-PBGVVDLY.js → chunk-DK4X5B6I.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-NB5BCFUY.js";
+} from "./chunk-WHHEPAO3.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-PBGVVDLY.js.map
+//# sourceMappingURL=chunk-DK4X5B6I.js.map

package/dist/{chunk-MFDTVQJX.js → chunk-DVOBLPSQ.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-62OKGIJA.js";
 import {
   parseActivityConfig
-} from "./chunk-5VCDKQWQ.js";
+} from "./chunk-5HYUUFMQ.js";
 import {
   parseLocationConfig
 } from "./chunk-I3H5LFOI.js";
@@ -18,7 +18,7 @@ import {
 } from "./chunk-Z3O53WZR.js";
 import {
   parseSubjectRuntimeConfig
-} from "./chunk-H3TKENU4.js";
+} from "./chunk-WIKO4SCR.js";
 import {
   cloneDefaultSessionObserverBands
 } from "./chunk-Z5LAYHGJ.js";
@@ -72,6 +72,9 @@ import {
 import {
   parseCodingKnowledgeConfig
 } from "./chunk-FEHIOYML.js";
+import {
+  parseRecallStateViews
+} from "./chunk-255PC37A.js";
 import {
   parseReplicaPeersConfig
 } from "./chunk-WNIUPHWV.js";
@@ -102,12 +105,12 @@ import {
 import {
   isActiveMemoryStatus
 } from "./chunk-7RJUVTVF.js";
-import {
-  sanitizeMemoryContent
-} from "./chunk-5GKPFL3S.js";
 import {
   parseOfflineSyncExcludes
 } from "./chunk-WQZZDN5M.js";
+import {
+  sanitizeMemoryContent
+} from "./chunk-5GKPFL3S.js";
 import {
   expandTildePath
 } from "./chunk-6KH5NLQS.js";
@@ -2177,6 +2180,13 @@ function parseAgentAccessPrincipal(raw) {
   }
   return readEnvVar("OPENCLAW_REMNIC_ACCESS_PRINCIPAL")?.trim() || readEnvVar("OPENCLAW_ENGRAM_ACCESS_PRINCIPAL")?.trim() || void 0;
 }
+function parseOptionalEnvName(raw, property) {
+  if (raw === void 0 || raw === null || raw === "") return void 0;
+  if (typeof raw !== "string" || !/^[A-Z_][A-Z0-9_]*$/.test(raw)) {
+    throw new Error(`${property} must name a conventional environment variable`);
+  }
+  return raw;
+}
 function resolveEnvVars(value) {
   const resolved = value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, envVar) => {
     const envValue = readEnvVar(envVar);
@@ -2763,6 +2773,7 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     "maintenance.namespaceLockStaleMs"
   );
   const { wikiMergeIntoRecall, qmdCollection, qmdColdCollection } = parseExternalWikiRecallGuard(cfg);
+  const localLlmApiKeyEnv = parseOptionalEnvName(cfg.localLlmApiKeyEnv, "localLlmApiKeyEnv");
   return {
     openaiApiKey: apiKey,
     openaiBaseUrl: baseUrl,
@@ -3059,6 +3070,9 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     // recall path keeps least-privileged behavior unless operators
     // explicitly opt in.
     recallDirectAnswerEnabled: coerceBool(cfg.recallDirectAnswerEnabled) ?? false,
+    // Recall state views (issue #1952). Default false; exact false/0/"false"
+    // disable (parseRecallStateViews → coerceBooleanLike).
+    recallStateViews: parseRecallStateViews(cfg.recallStateViews),
     // Disclosure auto-escalation (issue #677 PR 4/4).  Default `manual`
     // so pre-#677 callers see unchanged behavior.  Reject anything
     // outside the allow-list rather than silently defaulting (CLAUDE.md
@@ -3599,7 +3613,8 @@ function parseConfig(raw, rawOperatorConfig, runtimeSet) {
     // default: false
     localLlmUrl: typeof cfg.localLlmUrl === "string" && cfg.localLlmUrl.length > 0 ? cfg.localLlmUrl : "http://localhost:1234/v1",
     localLlmModel: typeof cfg.localLlmModel === "string" && cfg.localLlmModel.length > 0 ? cfg.localLlmModel : "local-model",
-    localLlmApiKey: typeof cfg.localLlmApiKey === "string" && cfg.localLlmApiKey.length > 0 ? resolveEnvVars(cfg.localLlmApiKey) : void 0,
+    localLlmApiKey: typeof cfg.localLlmApiKey === "string" && cfg.localLlmApiKey.length > 0 ? resolveEnvVars(cfg.localLlmApiKey) : localLlmApiKeyEnv === void 0 ? void 0 : readEnvVar(localLlmApiKeyEnv),
+    localLlmApiKeyEnv,
     localLlmHeaders: cfg.localLlmHeaders && typeof cfg.localLlmHeaders === "object" && !Array.isArray(cfg.localLlmHeaders) ? Object.fromEntries(
       Object.entries(cfg.localLlmHeaders).filter(([, value]) => typeof value === "string").map(([key, value]) => [key, String(value)])
     ) : void 0,
@@ -4792,4 +4807,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-MFDTVQJX.js.map
+//# sourceMappingURL=chunk-DVOBLPSQ.js.map