@remnic/core 10.0.14 → 10.0.16

package/dist/{tier-stats-RQM76XYY.js.map → tier-stats-C3IAMS4X.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/tier-stats.ts"],"sourcesContent":["/**\n * Operator-facing tier visibility (issue #686 PR 5/6).\n *\n * Two read-only surfaces:\n *\n *   - `summarizeTiers(storage)` — count memories by tier (hot vs cold)\n *     plus per-status breakdown so operators can see at a glance\n *     whether the lifecycle policy has actually demoted anything.\n *   - `explainTierForMemory(storage, id)` — show the value-score\n *     components and tier-transition decision for a single memory\n *     so an operator can reason about why a memory ended up where\n *     it did.\n *\n * Pure inspection — neither surface mutates anything.  The CLI wires\n * them as `remnic tier list` and `remnic tier explain <id>`.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile, PluginConfig } from \"../types.js\";\nimport { computeLifecycleValueInputs } from \"../lifecycle.js\";\nimport {\n  computeTierValueScore,\n  decideTierTransition,\n  type MemoryTier,\n  type TierRoutingPolicy,\n  type TierTransitionDecision,\n} from \"../tier-routing.js\";\nimport { resolveQmdCapabilities, resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport {\n  applyUtilityPromotionRuntimePolicy,\n  loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\n\nexport interface TierSummary {\n  /** Total memories scanned (all tiers, all statuses). */\n  total: number;\n  byTier: Record<MemoryTier, number>;\n  byStatus: Record<string, number>;\n  /** Memories with `status === \"forgotten\"` (issue #686 PR 4/6). */\n  forgottenCount: number;\n  /** Top contributors to the forgotten / archived buckets, by category. */\n  byCategory: Record<string, number>;\n}\n\nexport interface TierExplainResult {\n  id: string;\n  path: string;\n  currentTier: MemoryTier;\n  status: string;\n  category: string;\n  valueScore: number;\n  decision: TierTransitionDecision;\n  signals: {\n    confidence: number;\n    accessCount: number;\n    lastAccessed: string | null;\n    created: string;\n    updated: string;\n    importance: number;\n    feedback: number;\n  };\n}\n\ninterface TierVisibleMemory {\n  memory: MemoryFile;\n  tier: MemoryTier;\n}\n\nasync function readTierVisibleMemories(\n  storage: StorageManager,\n): Promise<TierVisibleMemory[]> {\n  const [hotMemories, coldMemories] = await Promise.all([\n    storage.readAllMemories(),\n    storage.readAllColdMemories(),\n  ]);\n  return [\n    ...hotMemories.map((memory) => ({ memory, tier: \"hot\" as const })),\n    ...coldMemories.map((memory) => ({ memory, tier: \"cold\" as const })),\n  ];\n}\n\nasync function tierRoutingPolicyFromConfig(\n  config: PluginConfig,\n): Promise<TierRoutingPolicy> {\n  const basePolicy: TierRoutingPolicy = {\n    enabled: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n  });\n  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nexport async function summarizeTiers(\n  storage: StorageManager,\n): Promise<TierSummary> {\n  const all = await readTierVisibleMemories(storage);\n  const summary: TierSummary = {\n    total: all.length,\n    byTier: { hot: 0, cold: 0 },\n    byStatus: {},\n    forgottenCount: 0,\n    byCategory: {},\n  };\n  for (const { memory: m, tier } of all) {\n    summary.byTier[tier] += 1;\n    const status: string = m.frontmatter.status ?? \"active\";\n    summary.byStatus[status] = (summary.byStatus[status] ?? 0) + 1;\n    // Compare via the widened `string` type so this module compiles\n    // both before and after PR 4/6 lands `\"forgotten\"` in MemoryStatus.\n    if (status === \"forgotten\") summary.forgottenCount += 1;\n    const cat = m.frontmatter.category ?? \"(uncategorized)\";\n    summary.byCategory[cat] = (summary.byCategory[cat] ?? 0) + 1;\n  }\n  return summary;\n}\n\nexport async function explainTierForMemory(\n  storage: StorageManager,\n  id: string,\n  config: PluginConfig,\n): Promise<TierExplainResult> {\n  const trimmed = typeof id === \"string\" ? id.trim() : \"\";\n  if (trimmed.length === 0) {\n    throw new Error(\"tier explain: memory id is required and must be non-empty\");\n  }\n  const all = await readTierVisibleMemories(storage);\n  const entry = all.find(({ memory: m }) => m.frontmatter.id === trimmed);\n  if (!entry) {\n    throw new Error(`tier explain: memory not found: ${trimmed}`);\n  }\n  const { memory, tier: currentTier } = entry;\n  const now = new Date();\n  const valueInputs = computeLifecycleValueInputs(memory, now);\n  const valueScore = computeTierValueScore(memory, now);\n  const policy = await tierRoutingPolicyFromConfig(config);\n  const decision = decideTierTransition(memory, currentTier, policy, now);\n  const fm = memory.frontmatter as unknown as Record<string, unknown>;\n  return {\n    id: trimmed,\n    path: memory.path,\n    currentTier,\n    status: typeof fm.status === \"string\" ? (fm.status as string) : \"active\",\n    category: typeof fm.category === \"string\" ? (fm.category as string) : \"\",\n    valueScore,\n    decision,\n    signals: {\n      confidence: valueInputs.confidence,\n      accessCount:\n        typeof fm.accessCount === \"number\" ? (fm.accessCount as number) : 0,\n      lastAccessed:\n        typeof fm.lastAccessed === \"string\" ? (fm.lastAccessed as string) : null,\n      created: typeof fm.created === \"string\" ? (fm.created as string) : \"\",\n      updated: typeof fm.updated === \"string\" ? (fm.updated as string) : \"\",\n      importance: valueInputs.importance,\n      feedback: valueInputs.feedback,\n    },\n  };\n}\n\n/**\n * Render a TierSummary as plain text for `remnic tier list` text mode.\n * Pure formatter — exposed so future surfaces (HTTP, MCP) can reuse.\n */\nexport function formatTierSummaryText(summary: TierSummary): string {\n  const lines: string[] = [];\n  lines.push(\"=== Memory Tier Distribution ===\");\n  lines.push(`Total memories: ${summary.total}`);\n  lines.push(\"\");\n  lines.push(\"Tier:\");\n  lines.push(`  hot:  ${summary.byTier.hot}`);\n  lines.push(`  cold: ${summary.byTier.cold}`);\n  lines.push(\"\");\n  lines.push(\"Status:\");\n  const statusEntries = Object.entries(summary.byStatus).sort(\n    (a, b) => b[1] - a[1] || a[0].localeCompare(b[0]),\n  );\n  for (const [status, count] of statusEntries) {\n    lines.push(`  ${status}: ${count}`);\n  }\n  lines.push(\"\");\n  lines.push(\"Top categories:\");\n  const categoryEntries = Object.entries(summary.byCategory)\n    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n    .slice(0, 8);\n  for (const [cat, count] of categoryEntries) {\n    lines.push(`  ${cat}: ${count}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Render a TierExplainResult as plain text for `remnic tier explain`.\n */\nexport function formatTierExplainText(explain: TierExplainResult): string {\n  const lines: string[] = [];\n  lines.push(`=== Tier Explain: ${explain.id} ===`);\n  lines.push(`path:          ${explain.path}`);\n  lines.push(`current tier:  ${explain.currentTier}`);\n  lines.push(`status:        ${explain.status}`);\n  lines.push(`category:      ${explain.category}`);\n  lines.push(`value score:   ${explain.valueScore.toFixed(3)}`);\n  lines.push(\"\");\n  lines.push(\"Tier-transition decision:\");\n  lines.push(`  next tier: ${explain.decision.nextTier}`);\n  lines.push(`  changed:   ${explain.decision.changed}`);\n  lines.push(`  reason:    ${explain.decision.reason}`);\n  lines.push(\"\");\n  lines.push(\"Signals:\");\n  lines.push(`  confidence:   ${explain.signals.confidence}`);\n  lines.push(`  accessCount:  ${explain.signals.accessCount}`);\n  lines.push(`  lastAccessed: ${explain.signals.lastAccessed ?? \"(never)\"}`);\n  lines.push(`  created:      ${explain.signals.created}`);\n  lines.push(`  updated:      ${explain.signals.updated}`);\n  lines.push(`  importance:   ${explain.signals.importance}`);\n  lines.push(`  feedback:     ${explain.signals.feedback}`);\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/maintenance/tier-stats.ts"],"sourcesContent":["/**\n * Operator-facing tier visibility (issue #686 PR 5/6).\n *\n * Two read-only surfaces:\n *\n *   - `summarizeTiers(storage)` — count memories by tier (hot vs cold)\n *     plus per-status breakdown so operators can see at a glance\n *     whether the lifecycle policy has actually demoted anything.\n *   - `explainTierForMemory(storage, id)` — show the value-score\n *     components and tier-transition decision for a single memory\n *     so an operator can reason about why a memory ended up where\n *     it did.\n *\n * Pure inspection — neither surface mutates anything.  The CLI wires\n * them as `remnic tier list` and `remnic tier explain <id>`.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile, PluginConfig } from \"../types.js\";\nimport { computeLifecycleValueInputs } from \"../lifecycle.js\";\nimport {\n  computeTierValueScore,\n  decideTierTransition,\n  type MemoryTier,\n  type TierRoutingPolicy,\n  type TierTransitionDecision,\n} from \"../tier-routing.js\";\nimport { resolveQmdCapabilities, resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport {\n  applyUtilityPromotionRuntimePolicy,\n  loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\n\nexport interface TierSummary {\n  /** Total memories scanned (all tiers, all statuses). */\n  total: number;\n  byTier: Record<MemoryTier, number>;\n  byStatus: Record<string, number>;\n  /** Memories with `status === \"forgotten\"` (issue #686 PR 4/6). */\n  forgottenCount: number;\n  /** Top contributors to the forgotten / archived buckets, by category. */\n  byCategory: Record<string, number>;\n}\n\nexport interface TierExplainResult {\n  id: string;\n  path: string;\n  currentTier: MemoryTier;\n  status: string;\n  category: string;\n  valueScore: number;\n  decision: TierTransitionDecision;\n  signals: {\n    confidence: number;\n    accessCount: number;\n    lastAccessed: string | null;\n    created: string;\n    updated: string;\n    importance: number;\n    feedback: number;\n  };\n}\n\ninterface TierVisibleMemory {\n  memory: MemoryFile;\n  tier: MemoryTier;\n}\n\nasync function readTierVisibleMemories(\n  storage: StorageManager,\n): Promise<TierVisibleMemory[]> {\n  const [hotMemories, coldMemories] = await Promise.all([\n    storage.readAllMemories(),\n    storage.readAllColdMemories(),\n  ]);\n  return [\n    ...hotMemories.map((memory) => ({ memory, tier: \"hot\" as const })),\n    ...coldMemories.map((memory) => ({ memory, tier: \"cold\" as const })),\n  ];\n}\n\nasync function tierRoutingPolicyFromConfig(\n  config: PluginConfig,\n): Promise<TierRoutingPolicy> {\n  const basePolicy: TierRoutingPolicy = {\n    enabled: resolveQmdCapabilities(config).qmdTierMigration,\n    demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n    demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n    promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n  };\n  const runtime = await loadUtilityRuntimeValues({\n    memoryDir: config.memoryDir,\n    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n  });\n  return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nexport async function summarizeTiers(\n  storage: StorageManager,\n): Promise<TierSummary> {\n  const all = await readTierVisibleMemories(storage);\n  const summary: TierSummary = {\n    total: all.length,\n    byTier: { hot: 0, cold: 0 },\n    byStatus: {},\n    forgottenCount: 0,\n    byCategory: {},\n  };\n  for (const { memory: m, tier } of all) {\n    summary.byTier[tier] += 1;\n    const status: string = m.frontmatter.status ?? \"active\";\n    summary.byStatus[status] = (summary.byStatus[status] ?? 0) + 1;\n    // Compare via the widened `string` type so this module compiles\n    // both before and after PR 4/6 lands `\"forgotten\"` in MemoryStatus.\n    if (status === \"forgotten\") summary.forgottenCount += 1;\n    const cat = m.frontmatter.category ?? \"(uncategorized)\";\n    summary.byCategory[cat] = (summary.byCategory[cat] ?? 0) + 1;\n  }\n  return summary;\n}\n\nexport async function explainTierForMemory(\n  storage: StorageManager,\n  id: string,\n  config: PluginConfig,\n): Promise<TierExplainResult> {\n  const trimmed = typeof id === \"string\" ? id.trim() : \"\";\n  if (trimmed.length === 0) {\n    throw new Error(\"tier explain: memory id is required and must be non-empty\");\n  }\n  const all = await readTierVisibleMemories(storage);\n  const entry = all.find(({ memory: m }) => m.frontmatter.id === trimmed);\n  if (!entry) {\n    throw new Error(`tier explain: memory not found: ${trimmed}`);\n  }\n  const { memory, tier: currentTier } = entry;\n  const now = new Date();\n  const valueInputs = computeLifecycleValueInputs(memory, now);\n  const valueScore = computeTierValueScore(memory, now);\n  const policy = await tierRoutingPolicyFromConfig(config);\n  const decision = decideTierTransition(memory, currentTier, policy, now);\n  const fm = memory.frontmatter as unknown as Record<string, unknown>;\n  return {\n    id: trimmed,\n    path: memory.path,\n    currentTier,\n    status: typeof fm.status === \"string\" ? (fm.status as string) : \"active\",\n    category: typeof fm.category === \"string\" ? (fm.category as string) : \"\",\n    valueScore,\n    decision,\n    signals: {\n      confidence: valueInputs.confidence,\n      accessCount:\n        typeof fm.accessCount === \"number\" ? (fm.accessCount as number) : 0,\n      lastAccessed:\n        typeof fm.lastAccessed === \"string\" ? (fm.lastAccessed as string) : null,\n      created: typeof fm.created === \"string\" ? (fm.created as string) : \"\",\n      updated: typeof fm.updated === \"string\" ? (fm.updated as string) : \"\",\n      importance: valueInputs.importance,\n      feedback: valueInputs.feedback,\n    },\n  };\n}\n\n/**\n * Render a TierSummary as plain text for `remnic tier list` text mode.\n * Pure formatter — exposed so future surfaces (HTTP, MCP) can reuse.\n */\nexport function formatTierSummaryText(summary: TierSummary): string {\n  const lines: string[] = [];\n  lines.push(\"=== Memory Tier Distribution ===\");\n  lines.push(`Total memories: ${summary.total}`);\n  lines.push(\"\");\n  lines.push(\"Tier:\");\n  lines.push(`  hot:  ${summary.byTier.hot}`);\n  lines.push(`  cold: ${summary.byTier.cold}`);\n  lines.push(\"\");\n  lines.push(\"Status:\");\n  const statusEntries = Object.entries(summary.byStatus).sort(\n    (a, b) => b[1] - a[1] || a[0].localeCompare(b[0]),\n  );\n  for (const [status, count] of statusEntries) {\n    lines.push(`  ${status}: ${count}`);\n  }\n  lines.push(\"\");\n  lines.push(\"Top categories:\");\n  const categoryEntries = Object.entries(summary.byCategory)\n    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n    .slice(0, 8);\n  for (const [cat, count] of categoryEntries) {\n    lines.push(`  ${cat}: ${count}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Render a TierExplainResult as plain text for `remnic tier explain`.\n */\nexport function formatTierExplainText(explain: TierExplainResult): string {\n  const lines: string[] = [];\n  lines.push(`=== Tier Explain: ${explain.id} ===`);\n  lines.push(`path:          ${explain.path}`);\n  lines.push(`current tier:  ${explain.currentTier}`);\n  lines.push(`status:        ${explain.status}`);\n  lines.push(`category:      ${explain.category}`);\n  lines.push(`value score:   ${explain.valueScore.toFixed(3)}`);\n  lines.push(\"\");\n  lines.push(\"Tier-transition decision:\");\n  lines.push(`  next tier: ${explain.decision.nextTier}`);\n  lines.push(`  changed:   ${explain.decision.changed}`);\n  lines.push(`  reason:    ${explain.decision.reason}`);\n  lines.push(\"\");\n  lines.push(\"Signals:\");\n  lines.push(`  confidence:   ${explain.signals.confidence}`);\n  lines.push(`  accessCount:  ${explain.signals.accessCount}`);\n  lines.push(`  lastAccessed: ${explain.signals.lastAccessed ?? \"(never)\"}`);\n  lines.push(`  created:      ${explain.signals.created}`);\n  lines.push(`  updated:      ${explain.signals.updated}`);\n  lines.push(`  importance:   ${explain.signals.importance}`);\n  lines.push(`  feedback:     ${explain.signals.feedback}`);\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"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"}

package/dist/transcript.js

@@ -1,10 +1,11 @@
 import {
   TranscriptManager,
   utcDayRange
-} from "./chunk-Q4E24IRR.js";
+} from "./chunk-HDN7IVIO.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-5Y43VGYB.js";
 import "./chunk-TOTT6S2V.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-LDPPTPO5.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";

package/dist/transfer/export-okf.js

@@ -4,24 +4,24 @@ import {
   exportOkfBundle,
   firstHeading,
   parseIncludeStatus
-} from "../chunk-N7KYEVLK.js";
+} from "../chunk-BK2BVLZW.js";
 import {
   OKF_EXPORT_VERSION
 } from "../chunk-4D2YH47Z.js";
 import "../chunk-D24OXEPB.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-PAZ35RJ4.js";
+import "../chunk-4SCZZ3U7.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-TRMJ6BYC.js";
 import "../chunk-V4JZCTMK.js";
-import "../chunk-N4C7QKOG.js";
-import "../chunk-O2IPAX26.js";
-import "../chunk-S7LWX2PQ.js";
-import "../chunk-T2YX56QI.js";
+import "../chunk-MWWAQXZ6.js";
+import "../chunk-RTTPBBAN.js";
+import "../chunk-655FVTCD.js";
+import "../chunk-GQJKVQJR.js";
 import "../chunk-CYEPCZN5.js";
-import "../chunk-T3FMRLWQ.js";
+import "../chunk-HFSPY26A.js";
 import "../chunk-7VO6E5UD.js";
-import "../chunk-4O6WRBGE.js";
+import "../chunk-KJXP6RUG.js";
 import "../chunk-VOKHZRHW.js";
 import "../chunk-GUMZC2BO.js";
 import "../chunk-TFA6HPOA.js";
@@ -29,6 +29,7 @@ import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
+import "../chunk-PPUNC7UX.js";
 import "../chunk-X3724WL4.js";
 import "../chunk-MRPOZBJC.js";
 import "../chunk-S2HLHAZ4.js";
@@ -107,6 +108,7 @@ import "../chunk-ZEFVK7XC.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";
 import "../chunk-BTTPKDIL.js";
+import "../chunk-QUIRIG2P.js";
 import "../chunk-LDPPTPO5.js";
 import "../chunk-MAAL6OZV.js";
 import "../chunk-A6XUJE5D.js";

package/dist/trust-zones.js

@@ -11,10 +11,11 @@ import {
   seedTrustZoneDemoDataset,
   summarizeTrustZonePromotionReadiness,
   validateTrustZoneRecord
-} from "./chunk-ROBHL3GL.js";
+} from "./chunk-JWX2Q6HS.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-B6O2YLUR.js";
+import "./chunk-2Z5DIDQD.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/utility-learner.js

@@ -3,11 +3,12 @@ import {
   learnUtilityPromotionWeights,
   readUtilityLearningSnapshot,
   resolveUtilityLearningStatePath
-} from "./chunk-W3K3HITK.js";
-import "./chunk-EBA5DA77.js";
+} from "./chunk-WLT6LTQP.js";
+import "./chunk-EOU6V4IN.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-B6O2YLUR.js";
+import "./chunk-2Z5DIDQD.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/utility-runtime.js

@@ -2,12 +2,13 @@ import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
-} from "./chunk-SWIKABKI.js";
-import "./chunk-W3K3HITK.js";
-import "./chunk-EBA5DA77.js";
+} from "./chunk-3Q3XD3NO.js";
+import "./chunk-WLT6LTQP.js";
+import "./chunk-EOU6V4IN.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-B6O2YLUR.js";
+import "./chunk-2Z5DIDQD.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/utility-telemetry.js

@@ -4,9 +4,10 @@ import {
   recordUtilityTelemetryEvent,
   resolveUtilityTelemetryDir,
   validateUtilityTelemetryEvent
-} from "./chunk-EBA5DA77.js";
+} from "./chunk-EOU6V4IN.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-B6O2YLUR.js";
+import "./chunk-2Z5DIDQD.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/utils/macos-replication-junk.d.ts

@@ -0,0 +1,32 @@
+/**
+ * macOS Finder metadata that arrives through Mac-to-Linux copies.
+ *
+ * AppleDouble sidecars are named `._` plus the real file's basename
+ * (`._project-notes.md` beside `project-notes.md`). Finder also writes
+ * `.DS_Store` into any directory it opens. Neither is a Remnic record.
+ * Directory scanners and replication must ignore them so they are never
+ * parsed as entities, memories, or sync objects.
+ *
+ * QMD's own indexer already drops every hidden path (`dot: false` plus a
+ * hidden-segment filter). Callers that build index inputs themselves still
+ * use this helper so the non-QMD scanners stay in parity.
+ */
+/** True for an AppleDouble sidecar or a Finder `.DS_Store` file. */
+export declare function isMacOsReplicationJunkBasename(basename: string): boolean;
+/** True when the final path segment is macOS replication junk. */
+export declare function isMacOsReplicationJunkRelativePath(relPath: string): boolean;
+/**
+ * Drop junk names from a directory listing. `ignored` is the count of
+ * names removed, so the caller can emit one summary warning.
+ */
+export declare function withoutMacOsReplicationJunk<T>(entries: readonly T[], basenameOf: (entry: T) => string): {
+    kept: T[];
+    ignored: number;
+};
+/**
+ * Emit at most one junk warning per directory and count. A later scan of
+ * the same directory (entity migration, then entity load) stays quiet
+ * instead of repeating the same summary.
+ */
+export declare function warnIgnoredMacOsReplicationJunk(directoryKey: string, count: number, warn: (message: string) => void): void;
+//# sourceMappingURL=macos-replication-junk.d.ts.map

package/dist/utils/macos-replication-junk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-replication-junk.d.ts","sourceRoot":"","sources":["../../src/utils/macos-replication-junk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,oEAAoE;AACpE,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,kEAAkE;AAClE,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK3E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAC/B;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAWhC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,IAAI,CAMN"}

package/dist/utils/malformed-entity-record.d.ts

@@ -0,0 +1,24 @@
+/**
+ * No `# ` name. A named file whose type line is absent stays readable:
+ * `parseEntityFile` defaults the type to `other`.
+ */
+export declare function isUnnamedEntityRecord(content: string): boolean;
+/**
+ * Unnamed entity body that still has text. An empty body under frontmatter
+ * stays readable so a canonical filename can supply the type. A tab heading,
+ * a blank `# ` heading, or prose with no name does not.
+ */
+export declare function isPopulatedUnnamedEntityRecord(content: string): boolean;
+/**
+ * Unnamed file that still looks like an entity record (`#` or `**Type:**`).
+ * Direct filename recall keeps unstructured placeholders such as "content".
+ */
+export declare function isShapedUnnamedEntityRecord(content: string): boolean;
+/**
+ * Migration gate. Canonical ids are derived from name and type, and the
+ * old startup throw required an explicit `**Type:**` line. Files that
+ * only have a heading stay on disk and are not renamed. Listing does not
+ * use this predicate: `parseEntityFile` defaults a missing type to `other`.
+ */
+export declare function isMalformedEntityRecord(content: string): boolean;
+//# sourceMappingURL=malformed-entity-record.d.ts.map

package/dist/utils/malformed-entity-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"malformed-entity-record.d.ts","sourceRoot":"","sources":["../../src/utils/malformed-entity-record.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9D;AAWD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAcpE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGhE"}

package/dist/verified-recall.js

@@ -1,20 +1,20 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-EPJDSQHF.js";
+} from "./chunk-H5IUN433.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-PAZ35RJ4.js";
+import "./chunk-4SCZZ3U7.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-N4C7QKOG.js";
-import "./chunk-O2IPAX26.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
+import "./chunk-MWWAQXZ6.js";
+import "./chunk-RTTPBBAN.js";
+import "./chunk-655FVTCD.js";
+import "./chunk-GQJKVQJR.js";
 import "./chunk-CYEPCZN5.js";
-import "./chunk-T3FMRLWQ.js";
+import "./chunk-HFSPY26A.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-4O6WRBGE.js";
+import "./chunk-KJXP6RUG.js";
 import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -22,6 +22,7 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
+import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -100,6 +101,7 @@ import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
 import "./chunk-BTTPKDIL.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-LDPPTPO5.js";
 import "./chunk-MAAL6OZV.js";
 import "./chunk-A6XUJE5D.js";

package/dist/who-knows-cli.js

@@ -4,20 +4,20 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-5WCJLQTM.js";
-import "./chunk-4KY5GSMB.js";
-import "./chunk-PAZ35RJ4.js";
+} from "./chunk-F2772ATT.js";
+import "./chunk-4PDTVVSW.js";
+import "./chunk-4SCZZ3U7.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-N4C7QKOG.js";
-import "./chunk-O2IPAX26.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
+import "./chunk-MWWAQXZ6.js";
+import "./chunk-RTTPBBAN.js";
+import "./chunk-655FVTCD.js";
+import "./chunk-GQJKVQJR.js";
 import "./chunk-CYEPCZN5.js";
-import "./chunk-T3FMRLWQ.js";
+import "./chunk-HFSPY26A.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-4O6WRBGE.js";
+import "./chunk-KJXP6RUG.js";
 import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -25,6 +25,7 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
+import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -104,6 +105,7 @@ import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
 import "./chunk-3MUKQQ7A.js";
 import "./chunk-BTTPKDIL.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-LDPPTPO5.js";
 import "./chunk-MAAL6OZV.js";
 import "./chunk-A6XUJE5D.js";

package/dist/who-knows.js

@@ -9,19 +9,19 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-4KY5GSMB.js";
-import "./chunk-PAZ35RJ4.js";
+} from "./chunk-4PDTVVSW.js";
+import "./chunk-4SCZZ3U7.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-N4C7QKOG.js";
-import "./chunk-O2IPAX26.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
+import "./chunk-MWWAQXZ6.js";
+import "./chunk-RTTPBBAN.js";
+import "./chunk-655FVTCD.js";
+import "./chunk-GQJKVQJR.js";
 import "./chunk-CYEPCZN5.js";
-import "./chunk-T3FMRLWQ.js";
+import "./chunk-HFSPY26A.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-4O6WRBGE.js";
+import "./chunk-KJXP6RUG.js";
 import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -29,6 +29,7 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
+import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -108,6 +109,7 @@ import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
 import "./chunk-3MUKQQ7A.js";
 import "./chunk-BTTPKDIL.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-LDPPTPO5.js";
 import "./chunk-MAAL6OZV.js";
 import "./chunk-A6XUJE5D.js";

package/dist/work-product-ledger.js

@@ -4,10 +4,11 @@ import {
   resolveWorkProductLedgerDir,
   searchWorkProductLedgerEntries,
   validateWorkProductLedgerEntry
-} from "./chunk-G7NYVKD6.js";
+} from "./chunk-B2NXOVZN.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-B6O2YLUR.js";
+import "./chunk-2Z5DIDQD.js";
+import "./chunk-QUIRIG2P.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "10.0.14",
+  "version": "10.0.16",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3347,7 +3347,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^10.0.14"
+    "@remnic/coding-graph": "^10.0.16"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/calibration.ts

@@ -19,6 +19,7 @@ import { resolveLocalLlmCapabilities } from "./capabilities.js";
 import { OUTPUT_LANGUAGE_POLICY } from "./extraction-prompt.js";
 import { FallbackLlmClient } from "./fallback-llm.js";
 import { listJsonFiles } from "./json-store.js";
+import { isMacOsReplicationJunkBasename } from "./utils/macos-replication-junk.js";
 import { LocalLlmClient } from "./local-llm.js";
 import { log } from "./logger.js";
 import { writeFileAtomically } from "./maintenance/atomic-file.js";
@@ -195,7 +196,7 @@ async function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[
     for (const day of dayDirs) {
       const dayPath = path.join(factsDir, day);
       const dayFiles = (await readdir(dayPath))
-        .filter((f: string) => f.startsWith("correction-") && f.endsWith(".md"))
+        .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.startsWith("correction-") && f.endsWith(".md"))
         .map((f: string) => path.join(dayPath, f));
       files.push(...dayFiles);
     }
@@ -207,7 +208,7 @@ async function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[
   try {
     const { readdir } = await import("node:fs/promises");
     const corrFiles = (await readdir(correctionsDir))
-      .filter((f: string) => f.endsWith(".md"))
+      .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.endsWith(".md"))
       .map((f: string) => path.join(correctionsDir, f));
     files.push(...corrFiles);
   } catch {

package/src/cli.ts

@@ -13,6 +13,7 @@ import { ThreadingManager } from "./threading.js";
 import { bumpMemoryCorpusVersionForDir } from "./memory-corpus-version.js";
 import { utcDayRange } from "./transcript.js";
 import { padEndDisplay, truncateGraphemeSafe } from "./whitespace.js";
+import { isMacOsReplicationJunkBasename } from "./utils/macos-replication-junk.js";
 import { runWearablesCliCommand } from "./wearables/cli.js";
 import { registerMeetingsCommands } from "./cli/meetings-commands.js"; import { registerDeepRecallCommands } from "./cli/deep-recall-commands.js"; import { registerRecallNavigationCommands } from "./cli/recall-navigation-commands.js"; import { registerMemoryBrowseCommands } from "./cli/memory-browse-commands.js";
 import { registerExportOkfCommand, registerOkfCommands } from "./cli/okf-commands.js";
@@ -3334,7 +3335,6 @@ export async function resolveMemoryDirForNamespace(
   }
   return candidate;
 }
-
 /**
  * Walk every recall category directory under `memoryDir` recursively and invoke
  * `visit` for every `*.md` file. The directory set is `RECALL_FALLBACK_DIRS`
@@ -3392,6 +3392,7 @@ async function walkMemoryMarkdownFiles(
     for (const entry of entries) {
       if (entry.isSymbolicLink()) continue; // never follow symlinked entries
       const entryName = typeof entry.name === "string" ? entry.name : entry.name.toString("utf-8");
+      if (isMacOsReplicationJunkBasename(entryName)) continue;
       const fullPath = path.join(dir, entryName);
       try {
         assertPathInsideRoot(memoryRootReal, await realpath(fullPath), fullPath);
@@ -3412,7 +3413,6 @@ async function walkMemoryMarkdownFiles(
     await walk(root);
   }
 }
-
 /**
  * List absolute paths of every `*.md` file under each recall category directory
  * of `memoryDir` (facts/, corrections/, decisions/, ...; see

package/src/consolidation-provenance-check.ts

@@ -30,6 +30,7 @@ import {
 // lock-step with the doctor scan.
 import { sidecarKey } from "./page-versioning.js";
 import { RECALL_FALLBACK_DIRS } from "./utils/category-dir.js";
+import { isMacOsReplicationJunkBasename } from "./utils/macos-replication-junk.js";
 
 /**
  * Regex to spot a `derived_via: <value>` line in the raw YAML frontmatter
@@ -549,6 +550,7 @@ async function* walkMarkdownFiles(root: string, memoryDir: string): AsyncGenerat
     return;
   }
   for (const entry of entries) {
+    if (isMacOsReplicationJunkBasename(entry.name)) continue;
     const full = path.join(root, entry.name);
     if (entry.isSymbolicLink()) continue;
     if (entry.isDirectory()) {

package/src/correction/correction-planner.ts

@@ -26,6 +26,7 @@ import { readFile, readdir, unlink } from "node:fs/promises";
 import path from "node:path";
 import { throwIfAborted } from "../abort-error.js";
 import { writeFileAtomically } from "../maintenance/atomic-file.js";
+import { isMacOsReplicationJunkBasename } from "../utils/macos-replication-junk.js";
 import { serializeMutations } from "../utils/serialize-mutations.js";
 import {
   CORRECTION_TEXT_MAX,
@@ -576,7 +577,7 @@ export class CorrectionPlanner {
     }
     const plans: CorrectionPlan[] = [];
     for (const f of files) {
-      if (!f.endsWith(".json")) continue;
+      if (isMacOsReplicationJunkBasename(f) || !f.endsWith(".json")) continue;
       let plan: CorrectionPlan | null = null;
       try {
         plan = await this.loadPlan(namespace, f.replace(/\.json$/, ""));
@@ -702,7 +703,7 @@ export class CorrectionPlanner {
     }
     const recovered: string[] = [];
     for (const f of files) {
-      if (!f.endsWith(".json")) continue;
+      if (isMacOsReplicationJunkBasename(f) || !f.endsWith(".json")) continue;
       const planId = f.replace(/\.json$/, "");
       let plan: CorrectionPlan | null;
       try {

package/src/json-store.ts

@@ -14,6 +14,7 @@ import {
 } from "node:fs/promises";
 import path from "node:path";
 import { isErrnoCode } from "./utils/errno.js";
+import { isMacOsReplicationJunkBasename } from "./utils/macos-replication-junk.js";
 
 async function listJsonFilesStrictInner(dir: string, allowMissingDirectory: boolean): Promise<string[]> {
   let entries: Dirent[];
@@ -25,6 +26,7 @@ async function listJsonFilesStrictInner(dir: string, allowMissingDirectory: bool
   }
   const out: string[] = [];
   for (const entry of entries) {
+    if (isMacOsReplicationJunkBasename(entry.name)) continue;
     const fullPath = path.join(dir, entry.name);
     if (entry.isDirectory()) {
       out.push(...(await listJsonFilesStrictInner(fullPath, false)));
@@ -55,6 +57,7 @@ export async function listNamedFiles(dir: string, fileName: string): Promise<str
     const entries = await readdir(dir, { withFileTypes: true });
     const out: string[] = [];
     for (const entry of entries) {
+      if (isMacOsReplicationJunkBasename(entry.name)) continue;
       const fullPath = path.join(dir, entry.name);
       if (entry.isDirectory()) {
         out.push(...(await listNamedFiles(fullPath, fileName)));