@remnic/core 9.3.733 → 9.3.735

package/dist/schemas.d.ts

@@ -7,12 +7,12 @@ declare const MemoryActionEligibilityContextSchema: z.ZodObject<{
     importance: z.ZodNumber;
     source: z.ZodEnum<["extraction", "consolidation", "replay", "manual", "unknown"]>;
 }, "strict", z.ZodTypeAny, {
-    source: "manual" | "extraction" | "consolidation" | "replay" | "unknown";
+    source: "unknown" | "manual" | "extraction" | "consolidation" | "replay";
     confidence: number;
     lifecycleState: "active" | "archived" | "candidate" | "validated" | "stale";
     importance: number;
 }, {
-    source: "manual" | "extraction" | "consolidation" | "replay" | "unknown";
+    source: "unknown" | "manual" | "extraction" | "consolidation" | "replay";
     confidence: number;
     lifecycleState: "active" | "archived" | "candidate" | "validated" | "stale";
     importance: number;

package/dist/search/embed-helper.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from '../types-VkxElCHR.js';
+import { P as PluginConfig } from '../types-C7UCxpuO.js';
 import { HostEmbeddingProvider } from '../host-embedding-provider.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';

package/dist/search/embed-helper.js

@@ -1,9 +1,9 @@
 import {
   EmbedHelper
-} from "../chunk-H3MB3F62.js";
+} from "../chunk-AB2E5DCN.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-ESF7TRYJ.js";
+import "../chunk-JWDE7OVJ.js";
 import "../chunk-NU3CSQ4H.js";
 import "../chunk-PVGDJXVK.js";
 import "../chunk-PZ5AY32C.js";

package/dist/search/factory.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from '../types-VkxElCHR.js';
+import { P as PluginConfig } from '../types-C7UCxpuO.js';
 import { SearchBackend } from './port.js';
 import { F as FaissConversationIndexAdapter } from '../faiss-adapter-BHecI1fF.js';
 import { ConversationQmdRuntime, ConversationIndexBackend } from '../conversation-index/backend.js';

package/dist/search/factory.js

@@ -2,14 +2,14 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-HHNSLPX7.js";
+} from "../chunk-5BOQNB2K.js";
 import "../chunk-5CEJH5ZN.js";
 import "../chunk-WRFKZEO6.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-LQ6JI4VH.js";
 import "../chunk-SANZHXY2.js";
 import "../chunk-AER6MT24.js";
-import "../chunk-H3MB3F62.js";
+import "../chunk-AB2E5DCN.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-DCWIQFNA.js";
 import "../chunk-XBZQRZ6G.js";
@@ -19,11 +19,11 @@ import "../chunk-K43PI6DQ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-ESF7TRYJ.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-VS2IYZRU.js";
+import "../chunk-JWDE7OVJ.js";
 import "../chunk-JUC24CTX.js";
 import "../chunk-NU3CSQ4H.js";
 import "../chunk-PVGDJXVK.js";

package/dist/search/index.d.ts

@@ -7,7 +7,7 @@ export { OramaBackend } from './orama-backend.js';
 export { EmbedHelper } from './embed-helper.js';
 export { IndexableDocument, scanMemoryDir } from './document-scanner.js';
 export { createConversationIndexRuntime, createConversationSearchBackend, createSearchBackend } from './factory.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../host-embedding-provider.js';

package/dist/search/index.js

@@ -2,7 +2,7 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-HHNSLPX7.js";
+} from "../chunk-5BOQNB2K.js";
 import {
   LanceDbBackend
 } from "../chunk-5CEJH5ZN.js";
@@ -23,7 +23,7 @@ import {
 } from "../chunk-AER6MT24.js";
 import {
   EmbedHelper
-} from "../chunk-H3MB3F62.js";
+} from "../chunk-AB2E5DCN.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-DCWIQFNA.js";
 import "../chunk-XBZQRZ6G.js";
@@ -33,11 +33,11 @@ import "../chunk-K43PI6DQ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-ESF7TRYJ.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-VS2IYZRU.js";
+import "../chunk-JWDE7OVJ.js";
 import "../chunk-JUC24CTX.js";
 import "../chunk-NU3CSQ4H.js";
 import "../chunk-PVGDJXVK.js";

package/dist/search/lancedb-backend.d.ts

@@ -1,6 +1,6 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
 import { EmbedHelper } from './embed-helper.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../host-embedding-provider.js';

package/dist/search/meilisearch-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/search/noop-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/search/orama-backend.d.ts

@@ -1,6 +1,6 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
 import { EmbedHelper } from './embed-helper.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 import '../host-embedding-provider.js';

package/dist/search/port.d.ts

@@ -1,4 +1,4 @@
-import { Q as QmdSearchResult } from '../types-VkxElCHR.js';
+import { Q as QmdSearchResult } from '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/search/remote-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-VkxElCHR.js';
+import '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 

package/dist/{semantic-SLAa_prH.d.ts → semantic-DJR8_DMQ.d.ts}

@@ -68,4 +68,4 @@ type SemanticDedupDecision = {
  */
 declare function decideSemanticDedup(content: string, lookup: SemanticDedupLookup, options: SemanticDedupOptions): Promise<SemanticDedupDecision>;
 
-export { type SemanticDedupHit as S, type SemanticDedupLookup as a, type SemanticDedupDecision as b, type SemanticDedupOptions as c, decideSemanticDedup as d };
+export { type SemanticDedupLookup as S, type SemanticDedupHit as a, type SemanticDedupDecision as b, type SemanticDedupOptions as c, decideSemanticDedup as d };

package/dist/{semantic-consolidation-CstTvHPo.d.ts → semantic-consolidation-DKGbufYO.d.ts}

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as MemoryFile } from './types-VkxElCHR.js';
+import { P as PluginConfig, g as MemoryFile } from './types-C7UCxpuO.js';
 import { RolloutSummaryInput, MaterializeResult } from './connectors/codex-materialize.js';
 import { LoggerBackend } from './logger.js';
 import { SemanticConsolidationLlmOperator } from './consolidation-operator.js';

package/dist/semantic-consolidation.d.ts

@@ -1,6 +1,6 @@
-import './types-VkxElCHR.js';
+import './types-C7UCxpuO.js';
 import './connectors/codex-materialize.js';
-export { C as ConsolidationCluster, O as OperatorAwareConsolidationResult, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, c as buildOperatorAwareConsolidationPrompt, e as chooseConsolidationOperator, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, g as parseOperatorAwareConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-CstTvHPo.js';
+export { C as ConsolidationCluster, O as OperatorAwareConsolidationResult, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, c as buildOperatorAwareConsolidationPrompt, e as chooseConsolidationOperator, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, g as parseOperatorAwareConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-DKGbufYO.js';
 export { CONSOLIDATION_OPERATORS, ConsolidationOperator, SemanticConsolidationLlmOperator, isConsolidationOperator, isSemanticConsolidationLlmOperator, isValidDerivedFromEntry } from './consolidation-operator.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';

package/dist/semantic-rule-verifier.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from './types-VkxElCHR.js';
+import { g as MemoryFile } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/session-observer-bands.d.ts

@@ -1,4 +1,4 @@
-import { S as SessionObserverBandConfig } from './types-VkxElCHR.js';
+import { S as SessionObserverBandConfig } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/session-observer-state.d.ts

@@ -1,4 +1,4 @@
-import { S as SessionObserverBandConfig } from './types-VkxElCHR.js';
+import { S as SessionObserverBandConfig } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/shared-context/manager.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { P as PluginConfig } from '../types-VkxElCHR.js';
+import { P as PluginConfig } from '../types-C7UCxpuO.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';
 
@@ -18,9 +18,9 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     evidenceWindowEnd: z.ZodOptional<z.ZodString>;
     refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
+    date: string;
     decision: "rejected" | "approved" | "approved_with_feedback";
     reason: string;
-    date: string;
     agent: string;
     workflow?: string | undefined;
     tags?: string[] | undefined;
@@ -32,9 +32,9 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     evidenceWindowStart?: string | undefined;
     evidenceWindowEnd?: string | undefined;
 }, {
+    date: string;
     decision: "rejected" | "approved" | "approved_with_feedback";
     reason: string;
-    date: string;
     agent: string;
     workflow?: string | undefined;
     tags?: string[] | undefined;

package/dist/signal.d.ts

@@ -1,4 +1,4 @@
-import { al as SignalScanResult } from './types-VkxElCHR.js';
+import { al as SignalScanResult } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/storage.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, f as MemoryStatus, M as MemoryCategory, a9 as ImportanceScore, ap as MemoryLink, k as MemoryFrontmatter, F as FaithfulnessFrontmatter, ai as ProvenanceSource, g as MemoryFile, $ as EntityStructuredSection, aq as BufferState, ar as MetaState, W as MemoryActionEvent, m as MemoryLifecycleEvent, z as BufferSurpriseEvent, B as BehaviorSignalEvent, X as CompressionGuidelineOptimizerState, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, a4 as ContinuityIncidentCloseInput, a6 as ContinuityImprovementLoop, a8 as ContinuityLoopUpsertInput, a7 as ContinuityLoopReviewInput, as as FileHygieneConfig, at as EntityRelationship, au as EntityActivityEntry, E as EntityFile, av as AccessTrackingEntry, l as MemoryProjectionCurrentState, aw as MemorySummary, an as TopicScore } from './types-VkxElCHR.js';
+import { P as PluginConfig, f as MemoryStatus, M as MemoryCategory, a9 as ImportanceScore, ap as MemoryLink, k as MemoryFrontmatter, F as FaithfulnessFrontmatter, ai as ProvenanceSource, g as MemoryFile, a2 as EntityStructuredSection, aq as BufferState, ar as MetaState, Z as MemoryActionEvent, m as MemoryLifecycleEvent, K as BufferSurpriseEvent, B as BehaviorSignalEvent, _ as CompressionGuidelineOptimizerState, a5 as ContinuityIncidentOpenInput, a3 as ContinuityIncidentRecord, a4 as ContinuityIncidentCloseInput, a6 as ContinuityImprovementLoop, a8 as ContinuityLoopUpsertInput, a7 as ContinuityLoopReviewInput, as as FileHygieneConfig, at as EntityRelationship, au as EntityActivityEntry, E as EntityFile, av as AccessTrackingEntry, l as MemoryProjectionCurrentState, aw as MemorySummary, an as TopicScore } from './types-C7UCxpuO.js';
 import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
 import { ProjectedMemoryBrowseOptions, ProjectedMemoryBrowsePage, readProjectedGovernanceRecord } from './memory-projection-store.js';

package/dist/summarizer.d.ts

@@ -1,5 +1,5 @@
 import { ModelRegistry } from './model-registry.js';
-import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-VkxElCHR.js';
+import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-C7UCxpuO.js';
 import { TranscriptManager } from './transcript.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';

package/dist/summarizer.js

@@ -1,9 +1,9 @@
 import {
   HourlySummarizer
-} from "./chunk-DKT3X5C3.js";
+} from "./chunk-HFXZIF3V.js";
 import "./chunk-3FAMU5TX.js";
 import "./chunk-PWFWCGOO.js";
-import "./chunk-24D66MMN.js";
+import "./chunk-IX4L7E5G.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-O75CRYGF.js";
@@ -14,6 +14,7 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
+import "./chunk-JWDE7OVJ.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";

package/dist/summary-snapshot.d.ts

@@ -1,4 +1,4 @@
-import { H as HourlySummary } from './types-VkxElCHR.js';
+import { H as HourlySummary } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/temporal-supersession.d.ts

@@ -1,4 +1,4 @@
-import { k as MemoryFrontmatter } from './types-VkxElCHR.js';
+import { k as MemoryFrontmatter } from './types-C7UCxpuO.js';
 import { StorageManager } from './storage.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';

package/dist/temporal-validity.d.ts

@@ -1,4 +1,4 @@
-import { k as MemoryFrontmatter } from './types-VkxElCHR.js';
+import { k as MemoryFrontmatter } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/threading.d.ts

@@ -1,4 +1,4 @@
-import { u as BufferTurn, am as ConversationThread } from './types-VkxElCHR.js';
+import { u as BufferTurn, am as ConversationThread } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/tier-migration.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from './types-VkxElCHR.js';
+import { g as MemoryFile } from './types-C7UCxpuO.js';
 import { StorageManager } from './storage.js';
 import { MemoryTier } from './tier-routing.js';
 import { SearchBackend } from './search/port.js';

package/dist/tier-routing.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from './types-VkxElCHR.js';
+import { g as MemoryFile } from './types-C7UCxpuO.js';
 import { LifecycleSignals } from './lifecycle.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';

package/dist/{tier-stats-3LYQ3VV5.js → tier-stats-KPDIISG7.js}

@@ -11,6 +11,10 @@ import "./chunk-TERNBNJB.js";
 import {
   computeLifecycleValueInputs
 } from "./chunk-TBBDFYXW.js";
+import {
+  resolveQmdCapabilities,
+  resolveUtilityLearningCapabilities
+} from "./chunk-JWDE7OVJ.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
 import "./chunk-PZ5AY32C.js";
@@ -28,15 +32,15 @@ async function readTierVisibleMemories(storage) {
 }
 async function tierRoutingPolicyFromConfig(config) {
   const basePolicy = {
-    enabled: config.qmdTierMigrationEnabled,
+    enabled: resolveQmdCapabilities(config).qmdTierMigration,
     demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,
     demotionValueThreshold: config.qmdTierDemotionValueThreshold,
     promotionValueThreshold: config.qmdTierPromotionValueThreshold
   };
   const runtime = await loadUtilityRuntimeValues({
     memoryDir: config.memoryDir,
-    memoryUtilityLearningEnabled: config.memoryUtilityLearningEnabled,
-    promotionByOutcomeEnabled: config.promotionByOutcomeEnabled
+    memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,
+    promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome
   });
   return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);
 }
@@ -149,4 +153,4 @@ export {
   formatTierSummaryText,
   summarizeTiers
 };
-//# sourceMappingURL=tier-stats-3LYQ3VV5.js.map
+//# sourceMappingURL=tier-stats-KPDIISG7.js.map

package/dist/tier-stats-KPDIISG7.js.map

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;;AAoEA,eAAe,wBACb,SAC8B;AAC9B,QAAM,CAAC,aAAa,YAAY,IAAI,MAAM,QAAQ,IAAI;AAAA,IACpD,QAAQ,gBAAgB;AAAA,IACxB,QAAQ,oBAAoB;AAAA,EAC9B,CAAC;AACD,SAAO;AAAA,IACL,GAAG,YAAY,IAAI,CAAC,YAAY,EAAE,QAAQ,MAAM,MAAe,EAAE;AAAA,IACjE,GAAG,aAAa,IAAI,CAAC,YAAY,EAAE,QAAQ,MAAM,OAAgB,EAAE;AAAA,EACrE;AACF;AAEA,eAAe,4BACb,QAC4B;AAC5B,QAAM,aAAgC;AAAA,IACpC,SAAS,uBAAuB,MAAM,EAAE;AAAA,IACxC,oBAAoB,OAAO;AAAA,IAC3B,wBAAwB,OAAO;AAAA,IAC/B,yBAAyB,OAAO;AAAA,EAClC;AACA,QAAM,UAAU,MAAM,yBAAyB;AAAA,IAC7C,WAAW,OAAO;AAAA,IAClB,8BAA8B,mCAAmC,MAAM,EAAE;AAAA,IACzE,2BAA2B,mCAAmC,MAAM,EAAE;AAAA,EACxE,CAAC;AACD,SAAO,mCAAmC,YAAY,OAAO;AAC/D;AAEA,eAAsB,eACpB,SACsB;AACtB,QAAM,MAAM,MAAM,wBAAwB,OAAO;AACjD,QAAM,UAAuB;AAAA,IAC3B,OAAO,IAAI;AAAA,IACX,QAAQ,EAAE,KAAK,GAAG,MAAM,EAAE;AAAA,IAC1B,UAAU,CAAC;AAAA,IACX,gBAAgB;AAAA,IAChB,YAAY,CAAC;AAAA,EACf;AACA,aAAW,EAAE,QAAQ,GAAG,KAAK,KAAK,KAAK;AACrC,YAAQ,OAAO,IAAI,KAAK;AACxB,UAAM,SAAiB,EAAE,YAAY,UAAU;AAC/C,YAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,KAAK,KAAK;AAG7D,QAAI,WAAW,YAAa,SAAQ,kBAAkB;AACtD,UAAM,MAAM,EAAE,YAAY,YAAY;AACtC,YAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,GAAG,KAAK,KAAK;AAAA,EAC7D;AACA,SAAO;AACT;AAEA,eAAsB,qBACpB,SACA,IACA,QAC4B;AAC5B,QAAM,UAAU,OAAO,OAAO,WAAW,GAAG,KAAK,IAAI;AACrD,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,QAAM,MAAM,MAAM,wBAAwB,OAAO;AACjD,QAAM,QAAQ,IAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,OAAO,OAAO;AACtE,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,mCAAmC,OAAO,EAAE;AAAA,EAC9D;AACA,QAAM,EAAE,QAAQ,MAAM,YAAY,IAAI;AACtC,QAAM,MAAM,oBAAI,KAAK;AACrB,QAAM,cAAc,4BAA4B,QAAQ,GAAG;AAC3D,QAAM,aAAa,sBAAsB,QAAQ,GAAG;AACpD,QAAM,SAAS,MAAM,4BAA4B,MAAM;AACvD,QAAM,WAAW,qBAAqB,QAAQ,aAAa,QAAQ,GAAG;AACtE,QAAM,KAAK,OAAO;AAClB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,OAAO;AAAA,IACb;AAAA,IACA,QAAQ,OAAO,GAAG,WAAW,WAAY,GAAG,SAAoB;AAAA,IAChE,UAAU,OAAO,GAAG,aAAa,WAAY,GAAG,WAAsB;AAAA,IACtE;AAAA,IACA;AAAA,IACA,SAAS;AAAA,MACP,YAAY,YAAY;AAAA,MACxB,aACE,OAAO,GAAG,gBAAgB,WAAY,GAAG,cAAyB;AAAA,MACpE,cACE,OAAO,GAAG,iBAAiB,WAAY,GAAG,eAA0B;AAAA,MACtE,SAAS,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAAA,MACnE,SAAS,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAAA,MACnE,YAAY,YAAY;AAAA,MACxB,UAAU,YAAY;AAAA,IACxB;AAAA,EACF;AACF;AAMO,SAAS,sBAAsB,SAA8B;AAClE,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,kCAAkC;AAC7C,QAAM,KAAK,mBAAmB,QAAQ,KAAK,EAAE;AAC7C,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,OAAO;AAClB,QAAM,KAAK,WAAW,QAAQ,OAAO,GAAG,EAAE;AAC1C,QAAM,KAAK,WAAW,QAAQ,OAAO,IAAI,EAAE;AAC3C,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,SAAS;AACpB,QAAM,gBAAgB,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AAAA,IACrD,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;AAAA,EAClD;AACA,aAAW,CAAC,QAAQ,KAAK,KAAK,eAAe;AAC3C,UAAM,KAAK,KAAK,MAAM,KAAK,KAAK,EAAE;AAAA,EACpC;AACA,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,iBAAiB;AAC5B,QAAM,kBAAkB,OAAO,QAAQ,QAAQ,UAAU,EACtD,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EACtD,MAAM,GAAG,CAAC;AACb,aAAW,CAAC,KAAK,KAAK,KAAK,iBAAiB;AAC1C,UAAM,KAAK,KAAK,GAAG,KAAK,KAAK,EAAE;AAAA,EACjC;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAKO,SAAS,sBAAsB,SAAoC;AACxE,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,qBAAqB,QAAQ,EAAE,MAAM;AAChD,QAAM,KAAK,kBAAkB,QAAQ,IAAI,EAAE;AAC3C,QAAM,KAAK,kBAAkB,QAAQ,WAAW,EAAE;AAClD,QAAM,KAAK,kBAAkB,QAAQ,MAAM,EAAE;AAC7C,QAAM,KAAK,kBAAkB,QAAQ,QAAQ,EAAE;AAC/C,QAAM,KAAK,kBAAkB,QAAQ,WAAW,QAAQ,CAAC,CAAC,EAAE;AAC5D,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,2BAA2B;AACtC,QAAM,KAAK,gBAAgB,QAAQ,SAAS,QAAQ,EAAE;AACtD,QAAM,KAAK,gBAAgB,QAAQ,SAAS,OAAO,EAAE;AACrD,QAAM,KAAK,gBAAgB,QAAQ,SAAS,MAAM,EAAE;AACpD,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,UAAU;AACrB,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,UAAU,EAAE;AAC1D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,WAAW,EAAE;AAC3D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,gBAAgB,SAAS,EAAE;AACzE,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AACvD,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AACvD,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,UAAU,EAAE;AAC1D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,QAAQ,EAAE;AACxD,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/topics.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile, an as TopicScore } from './types-VkxElCHR.js';
+import { g as MemoryFile, an as TopicScore } from './types-C7UCxpuO.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/transcript.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, T as TranscriptEntry, v as Checkpoint } from './types-VkxElCHR.js';
+import { P as PluginConfig, T as TranscriptEntry, v as Checkpoint } from './types-C7UCxpuO.js';
 import { SessionIntegrityReport } from './session-integrity.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';