@remnic/core 9.69.75 → 9.69.76

package/dist/{chunk-I6Y6QKWF.js → chunk-XQSAPG34.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-5JMAGU26.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-6BFW7SGF.js";
+} from "./chunk-W5VYWOU3.js";
 import {
   isSemanticConsolidationLlmOperator
 } from "./chunk-G7D6GZ5J.js";
@@ -220,4 +220,4 @@ export {
   buildExtensionsBlockForConsolidation,
   materializeAfterSemanticConsolidation
 };
-//# sourceMappingURL=chunk-I6Y6QKWF.js.map
+//# sourceMappingURL=chunk-XQSAPG34.js.map

package/dist/{chunk-VIRTAUJO.js → chunk-Y37KZVUM.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-5HP5F2SQ.js";
+} from "./chunk-NC7OAEYY.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-IG747LRN.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-VIRTAUJO.js.map
+//# sourceMappingURL=chunk-Y37KZVUM.js.map

package/dist/{chunk-WDBKDYK2.js → chunk-YNNXM6FN.js}

@@ -19,7 +19,7 @@ import {
 import {
   exportOkfBundle,
   parseIncludeStatus
-} from "./chunk-GFD7TWAZ.js";
+} from "./chunk-AV5K5QH4.js";
 import {
   exportSqlite
 } from "./chunk-BV2TIZ4F.js";
@@ -58,7 +58,7 @@ import {
 } from "./chunk-IIFFC3RL.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-ODP62HIA.js";
+} from "./chunk-RQIETS2K.js";
 import {
   rebuildObservations
 } from "./chunk-DQTCGVFK.js";
@@ -73,13 +73,13 @@ import {
 } from "./chunk-HSSERO3E.js";
 import {
   lintOkfDir
-} from "./chunk-UJX4I26O.js";
+} from "./chunk-KOXUUJE3.js";
 import {
   runCompatChecks
 } from "./chunk-2524MOWK.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-YCYFXA6P.js";
+} from "./chunk-GN7YTM5I.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -93,15 +93,15 @@ import {
 } from "./chunk-OJP3N7UK.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-SA2JMMMS.js";
+} from "./chunk-UHKME3I7.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-25LKLNSJ.js";
+} from "./chunk-TYR4D4GH.js";
 import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-VXNWOHOR.js";
+} from "./chunk-N6TUO3O6.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -112,7 +112,7 @@ import {
 } from "./chunk-AM4T6CHX.js";
 import {
   parseXrayCliOptions
-} from "./chunk-GZBNEZIU.js";
+} from "./chunk-DBYAY6UW.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -134,7 +134,7 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-6JA22L5X.js";
+} from "./chunk-N25RPRSI.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -176,7 +176,7 @@ import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-LH6UP5SR.js";
+} from "./chunk-IV2CY3RE.js";
 import {
   buildConnectorRowsFromDefinitions,
   parseConnectorsListOptions,
@@ -197,7 +197,7 @@ import {
 } from "./chunk-6TBIWIAG.js";
 import {
   parseConfig
-} from "./chunk-GH5YSAAI.js";
+} from "./chunk-XLLRMUMH.js";
 import {
   applyManagedRegion,
   expandVaultTemplateTokens,
@@ -210,7 +210,7 @@ import {
 import {
   EngramAccessHttpServer,
   MeetingsInputError
-} from "./chunk-BXCZPPRO.js";
+} from "./chunk-P2FJ2KYJ.js";
 import {
   WearablesInputError
 } from "./chunk-V7IZKJI3.js";
@@ -220,10 +220,10 @@ import {
   loadChatSession,
   processChatMessage,
   sessionBelongsToPrincipal
-} from "./chunk-5LPDXYU3.js";
+} from "./chunk-J3NN2Q4Z.js";
 import {
   EngramAccessService
-} from "./chunk-OB2YI57R.js";
+} from "./chunk-5D6IMOW6.js";
 import {
   WorkStorage
 } from "./chunk-MPC7TYTZ.js";
@@ -240,30 +240,30 @@ import {
   parseRecallExplainFormat,
   renderRecallExplain,
   renderXray
-} from "./chunk-VEBYLZQQ.js";
+} from "./chunk-KN6CIN7I.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-HZDOLAZV.js";
+} from "./chunk-34R75BVF.js";
 import {
   getObjectiveStateStoreStatus
 } from "./chunk-HM7RHKS4.js";
 import {
   journalPath
-} from "./chunk-SB4ZWVKI.js";
+} from "./chunk-YPWOZ6ME.js";
 import {
   searchHarmonicRetrieval
-} from "./chunk-B6PY25JB.js";
+} from "./chunk-OIKX22FU.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-62AE2EUZ.js";
+} from "./chunk-JOAR32R6.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-5HP5F2SQ.js";
+} from "./chunk-NC7OAEYY.js";
 import {
   getCueAnchorStoreStatus
 } from "./chunk-BMWN7B3Y.js";
@@ -303,14 +303,14 @@ import {
 } from "./chunk-VZBW6CDG.js";
 import {
   meetingIdDate
-} from "./chunk-ZPED47SP.js";
+} from "./chunk-6RBUAPQT.js";
 import {
   isValidTranscriptDate
 } from "./chunk-UHVXE24Y.js";
 import {
   OKF_RESERVED_BASENAMES,
   okfTypeForCategory
-} from "./chunk-PCEYGOSL.js";
+} from "./chunk-FAT6HY7N.js";
 import {
   normalizeProjectionPreview
 } from "./chunk-SCU65EZI.js";
@@ -344,17 +344,17 @@ import {
   isArchivedMemoryPath,
   toMemoryPathRel
 } from "./chunk-7RJUVTVF.js";
-import {
-  writeFileAtomically
-} from "./chunk-AW4QUFQF.js";
 import {
   assertPathInsideRoot,
   pathIsInside
 } from "./chunk-C7HJ3NEI.js";
+import {
+  writeFileAtomically
+} from "./chunk-AW4QUFQF.js";
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-F5O6WEDO.js";
+} from "./chunk-PWF4JXKD.js";
 import {
   isSupportPassportPrivateMemory
 } from "./chunk-PWPIERBM.js";
@@ -10131,4 +10131,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-WDBKDYK2.js.map
+//# sourceMappingURL=chunk-YNNXM6FN.js.map

package/dist/{chunk-SB4ZWVKI.js → chunk-YPWOZ6ME.js}

@@ -1,6 +1,3 @@
-import {
-  DIRECTORY_SIDECAR_BASENAME
-} from "./chunk-U3NBO4IX.js";
 import {
   isActivityDigestPath,
   isArtifactMemoryPath,
@@ -11,8 +8,9 @@ import {
   isExternalWikiCollectionName
 } from "./chunk-JV3C2MNQ.js";
 import {
+  DIRECTORY_SIDECAR_BASENAME,
   OKF_RESERVED_BASENAMES
-} from "./chunk-PCEYGOSL.js";
+} from "./chunk-FAT6HY7N.js";
 import {
   isValidActivityDate
 } from "./chunk-353C5UNV.js";
@@ -213,4 +211,4 @@ export {
   isGenericRecallExcludedPath,
   filterRecallCandidates
 };
-//# sourceMappingURL=chunk-SB4ZWVKI.js.map
+//# sourceMappingURL=chunk-YPWOZ6ME.js.map

package/dist/{chunk-SB4ZWVKI.js.map → chunk-YPWOZ6ME.js.map}

@@ -1 +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 { DIRECTORY_SIDECAR_BASENAME } from \"../directory-sidecars.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    // Derived per-directory sidecars (#2977): recall-excluded like OKF index\n    // files, still searchable. Basename-only, the same accepted tradeoff.\n    path.basename(filePath) === DIRECTORY_SIDECAR_BASENAME\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":"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","names":["path","path","normalized","slashIndex"]}
+{"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 { DIRECTORY_SIDECAR_BASENAME } from \"../directory-sidecars.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    // Derived per-directory sidecars (#2977): recall-excluded like OKF index\n    // files, still searchable. Basename-only, the same accepted tradeoff.\n    path.basename(filePath) === DIRECTORY_SIDECAR_BASENAME\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":"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","names":["path","path","normalized","slashIndex"]}

package/dist/{chunk-KPSJA45G.js → chunk-YYI5DZAQ.js}

@@ -1,6 +1,6 @@
 import {
   parseEntityFile
-} from "./chunk-ZPED47SP.js";
+} from "./chunk-6RBUAPQT.js";
 import {
   inferMemoryStatus
 } from "./chunk-7RJUVTVF.js";
@@ -253,4 +253,4 @@ export {
   WHO_KNOWS_MCP_TOOLS,
   handleWhoKnowsHttpQuery
 };
-//# sourceMappingURL=chunk-KPSJA45G.js.map
+//# sourceMappingURL=chunk-YYI5DZAQ.js.map