@remnic/core 1.0.0

package/dist/chunk-3QKK7QOS.js

@@ -0,0 +1,154 @@
+import {
+  assertIsoRecordedAt,
+  assertSafePathSegment,
+  assertString,
+  isRecord,
+  optionalStringArray,
+  recordStoreDay,
+  validateStringRecord
+} from "./chunk-DGXUHMOV.js";
+import {
+  listJsonFiles,
+  readJsonFile
+} from "./chunk-LPSF4OQH.js";
+
+// src/utility-telemetry.ts
+import path from "path";
+import { mkdir, writeFile } from "fs/promises";
+function resolveUtilityTelemetryDir(memoryDir, overrideDir) {
+  if (typeof overrideDir === "string" && overrideDir.trim().length > 0) {
+    return overrideDir.trim();
+  }
+  return path.join(memoryDir, "state", "utility-telemetry");
+}
+function assertUtilityScore(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error("utilityScore must be a finite number");
+  }
+  if (value < -1 || value > 1) {
+    throw new Error("utilityScore must be between -1 and 1");
+  }
+  return value;
+}
+function validateUtilityTelemetryEvent(raw) {
+  if (!isRecord(raw)) throw new Error("utility telemetry event must be an object");
+  if (raw.schemaVersion !== 1) throw new Error("schemaVersion must be 1");
+  const source = assertString(raw.source, "source");
+  if (!["cli", "system", "benchmark", "tool_result"].includes(source)) {
+    throw new Error("source must be one of cli|system|benchmark|tool_result");
+  }
+  const target = assertString(raw.target, "target");
+  if (!["promotion", "ranking"].includes(target)) {
+    throw new Error("target must be one of promotion|ranking");
+  }
+  const decision = assertString(raw.decision, "decision");
+  if (!["promote", "demote", "hold", "boost", "suppress"].includes(decision)) {
+    throw new Error("decision must be one of promote|demote|hold|boost|suppress");
+  }
+  const outcome = assertString(raw.outcome, "outcome");
+  if (!["helpful", "neutral", "harmful"].includes(outcome)) {
+    throw new Error("outcome must be one of helpful|neutral|harmful");
+  }
+  return {
+    schemaVersion: 1,
+    eventId: assertSafePathSegment(assertString(raw.eventId, "eventId"), "eventId"),
+    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, "recordedAt")),
+    sessionKey: assertString(raw.sessionKey, "sessionKey"),
+    source,
+    target,
+    decision,
+    outcome,
+    utilityScore: assertUtilityScore(raw.utilityScore),
+    summary: assertString(raw.summary, "summary"),
+    memoryIds: optionalStringArray(raw.memoryIds, "memoryIds"),
+    entityRefs: optionalStringArray(raw.entityRefs, "entityRefs"),
+    tags: optionalStringArray(raw.tags, "tags"),
+    metadata: validateStringRecord(raw.metadata, "metadata")
+  };
+}
+async function recordUtilityTelemetryEvent(options) {
+  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);
+  const validated = validateUtilityTelemetryEvent(options.event);
+  const day = recordStoreDay(validated.recordedAt);
+  const eventsDir = path.join(rootDir, "events", day);
+  const filePath = path.join(eventsDir, `${validated.eventId}.json`);
+  await mkdir(eventsDir, { recursive: true });
+  await writeFile(filePath, JSON.stringify(validated, null, 2), "utf8");
+  return filePath;
+}
+async function readUtilityTelemetryEvents(options) {
+  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);
+  const files = await listJsonFiles(path.join(rootDir, "events"));
+  const events = [];
+  const invalidEvents = [];
+  for (const filePath of files) {
+    try {
+      events.push(validateUtilityTelemetryEvent(await readJsonFile(filePath)));
+    } catch (error) {
+      invalidEvents.push({
+        path: filePath,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return { files, events, invalidEvents };
+}
+async function getUtilityTelemetryStatus(options) {
+  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);
+  const eventsDir = path.join(rootDir, "events");
+  if (!options.enabled) {
+    return {
+      enabled: false,
+      promotionByOutcomeEnabled: options.promotionByOutcomeEnabled === true,
+      rootDir,
+      eventsDir,
+      events: {
+        total: 0,
+        valid: 0,
+        invalid: 0,
+        byTarget: {},
+        byDecision: {},
+        byOutcome: {}
+      },
+      invalidEvents: []
+    };
+  }
+  const { files, events, invalidEvents } = await readUtilityTelemetryEvents(options);
+  events.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));
+  const byTarget = {};
+  const byDecision = {};
+  const byOutcome = {};
+  for (const event of events) {
+    byTarget[event.target] = (byTarget[event.target] ?? 0) + 1;
+    byDecision[event.decision] = (byDecision[event.decision] ?? 0) + 1;
+    byOutcome[event.outcome] = (byOutcome[event.outcome] ?? 0) + 1;
+  }
+  return {
+    enabled: true,
+    promotionByOutcomeEnabled: options.promotionByOutcomeEnabled === true,
+    rootDir,
+    eventsDir,
+    events: {
+      total: files.length,
+      valid: events.length,
+      invalid: invalidEvents.length,
+      byTarget,
+      byDecision,
+      byOutcome,
+      latestEventId: events[0]?.eventId,
+      latestRecordedAt: events[0]?.recordedAt,
+      latestSessionKey: events[0]?.sessionKey
+    },
+    latestEvent: events[0],
+    invalidEvents
+  };
+}
+
+export {
+  resolveUtilityTelemetryDir,
+  validateUtilityTelemetryEvent,
+  recordUtilityTelemetryEvent,
+  readUtilityTelemetryEvents,
+  getUtilityTelemetryStatus
+};
+//# sourceMappingURL=chunk-3QKK7QOS.js.map

package/dist/chunk-3QKK7QOS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utility-telemetry.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport {\n  assertIsoRecordedAt,\n  assertSafePathSegment,\n  assertString,\n  isRecord,\n  optionalStringArray,\n  recordStoreDay,\n  validateStringRecord,\n} from \"./store-contract.js\";\n\nexport type UtilityTelemetrySource = \"cli\" | \"system\" | \"benchmark\" | \"tool_result\";\nexport type UtilityTelemetryTarget = \"promotion\" | \"ranking\";\nexport type UtilityTelemetryDecision = \"promote\" | \"demote\" | \"hold\" | \"boost\" | \"suppress\";\nexport type UtilityTelemetryOutcome = \"helpful\" | \"neutral\" | \"harmful\";\n\nexport interface UtilityTelemetryEvent {\n  schemaVersion: 1;\n  eventId: string;\n  recordedAt: string;\n  sessionKey: string;\n  source: UtilityTelemetrySource;\n  target: UtilityTelemetryTarget;\n  decision: UtilityTelemetryDecision;\n  outcome: UtilityTelemetryOutcome;\n  utilityScore: number;\n  summary: string;\n  memoryIds?: string[];\n  entityRefs?: string[];\n  tags?: string[];\n  metadata?: Record<string, string>;\n}\n\nexport interface UtilityTelemetryStatus {\n  enabled: boolean;\n  promotionByOutcomeEnabled: boolean;\n  rootDir: string;\n  eventsDir: string;\n  events: {\n    total: number;\n    valid: number;\n    invalid: number;\n    byTarget: Partial<Record<UtilityTelemetryTarget, number>>;\n    byDecision: Partial<Record<UtilityTelemetryDecision, number>>;\n    byOutcome: Partial<Record<UtilityTelemetryOutcome, number>>;\n    latestEventId?: string;\n    latestRecordedAt?: string;\n    latestSessionKey?: string;\n  };\n  latestEvent?: UtilityTelemetryEvent;\n  invalidEvents: Array<{\n    path: string;\n    error: string;\n  }>;\n}\n\nexport function resolveUtilityTelemetryDir(memoryDir: string, overrideDir?: string): string {\n  if (typeof overrideDir === \"string\" && overrideDir.trim().length > 0) {\n    return overrideDir.trim();\n  }\n  return path.join(memoryDir, \"state\", \"utility-telemetry\");\n}\n\nfunction assertUtilityScore(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\n    throw new Error(\"utilityScore must be a finite number\");\n  }\n  if (value < -1 || value > 1) {\n    throw new Error(\"utilityScore must be between -1 and 1\");\n  }\n  return value;\n}\n\nexport function validateUtilityTelemetryEvent(raw: unknown): UtilityTelemetryEvent {\n  if (!isRecord(raw)) throw new Error(\"utility telemetry event must be an object\");\n  if (raw.schemaVersion !== 1) throw new Error(\"schemaVersion must be 1\");\n\n  const source = assertString(raw.source, \"source\");\n  if (![\"cli\", \"system\", \"benchmark\", \"tool_result\"].includes(source)) {\n    throw new Error(\"source must be one of cli|system|benchmark|tool_result\");\n  }\n\n  const target = assertString(raw.target, \"target\");\n  if (![\"promotion\", \"ranking\"].includes(target)) {\n    throw new Error(\"target must be one of promotion|ranking\");\n  }\n\n  const decision = assertString(raw.decision, \"decision\");\n  if (![\"promote\", \"demote\", \"hold\", \"boost\", \"suppress\"].includes(decision)) {\n    throw new Error(\"decision must be one of promote|demote|hold|boost|suppress\");\n  }\n\n  const outcome = assertString(raw.outcome, \"outcome\");\n  if (![\"helpful\", \"neutral\", \"harmful\"].includes(outcome)) {\n    throw new Error(\"outcome must be one of helpful|neutral|harmful\");\n  }\n\n  return {\n    schemaVersion: 1,\n    eventId: assertSafePathSegment(assertString(raw.eventId, \"eventId\"), \"eventId\"),\n    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, \"recordedAt\")),\n    sessionKey: assertString(raw.sessionKey, \"sessionKey\"),\n    source: source as UtilityTelemetrySource,\n    target: target as UtilityTelemetryTarget,\n    decision: decision as UtilityTelemetryDecision,\n    outcome: outcome as UtilityTelemetryOutcome,\n    utilityScore: assertUtilityScore(raw.utilityScore),\n    summary: assertString(raw.summary, \"summary\"),\n    memoryIds: optionalStringArray(raw.memoryIds, \"memoryIds\"),\n    entityRefs: optionalStringArray(raw.entityRefs, \"entityRefs\"),\n    tags: optionalStringArray(raw.tags, \"tags\"),\n    metadata: validateStringRecord(raw.metadata, \"metadata\"),\n  };\n}\n\nexport async function recordUtilityTelemetryEvent(options: {\n  memoryDir: string;\n  utilityTelemetryDir?: string;\n  event: UtilityTelemetryEvent;\n}): Promise<string> {\n  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);\n  const validated = validateUtilityTelemetryEvent(options.event);\n  const day = recordStoreDay(validated.recordedAt);\n  const eventsDir = path.join(rootDir, \"events\", day);\n  const filePath = path.join(eventsDir, `${validated.eventId}.json`);\n  await mkdir(eventsDir, { recursive: true });\n  await writeFile(filePath, JSON.stringify(validated, null, 2), \"utf8\");\n  return filePath;\n}\n\nexport async function readUtilityTelemetryEvents(options: {\n  memoryDir: string;\n  utilityTelemetryDir?: string;\n}): Promise<{\n  files: string[];\n  events: UtilityTelemetryEvent[];\n  invalidEvents: Array<{ path: string; error: string }>;\n}> {\n  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);\n  const files = await listJsonFiles(path.join(rootDir, \"events\"));\n  const events: UtilityTelemetryEvent[] = [];\n  const invalidEvents: Array<{ path: string; error: string }> = [];\n  for (const filePath of files) {\n    try {\n      events.push(validateUtilityTelemetryEvent(await readJsonFile(filePath)));\n    } catch (error) {\n      invalidEvents.push({\n        path: filePath,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return { files, events, invalidEvents };\n}\n\nexport async function getUtilityTelemetryStatus(options: {\n  memoryDir: string;\n  utilityTelemetryDir?: string;\n  enabled: boolean;\n  promotionByOutcomeEnabled?: boolean;\n}): Promise<UtilityTelemetryStatus> {\n  const rootDir = resolveUtilityTelemetryDir(options.memoryDir, options.utilityTelemetryDir);\n  const eventsDir = path.join(rootDir, \"events\");\n  if (!options.enabled) {\n    return {\n      enabled: false,\n      promotionByOutcomeEnabled: options.promotionByOutcomeEnabled === true,\n      rootDir,\n      eventsDir,\n      events: {\n        total: 0,\n        valid: 0,\n        invalid: 0,\n        byTarget: {},\n        byDecision: {},\n        byOutcome: {},\n      },\n      invalidEvents: [],\n    };\n  }\n\n  const { files, events, invalidEvents } = await readUtilityTelemetryEvents(options);\n  events.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));\n\n  const byTarget: Partial<Record<UtilityTelemetryTarget, number>> = {};\n  const byDecision: Partial<Record<UtilityTelemetryDecision, number>> = {};\n  const byOutcome: Partial<Record<UtilityTelemetryOutcome, number>> = {};\n  for (const event of events) {\n    byTarget[event.target] = (byTarget[event.target] ?? 0) + 1;\n    byDecision[event.decision] = (byDecision[event.decision] ?? 0) + 1;\n    byOutcome[event.outcome] = (byOutcome[event.outcome] ?? 0) + 1;\n  }\n\n  return {\n    enabled: true,\n    promotionByOutcomeEnabled: options.promotionByOutcomeEnabled === true,\n    rootDir,\n    eventsDir,\n    events: {\n      total: files.length,\n      valid: events.length,\n      invalid: invalidEvents.length,\n      byTarget,\n      byDecision,\n      byOutcome,\n      latestEventId: events[0]?.eventId,\n      latestRecordedAt: events[0]?.recordedAt,\n      latestSessionKey: events[0]?.sessionKey,\n    },\n    latestEvent: events[0],\n    invalidEvents,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-3SLRNYNG.js

@@ -0,0 +1,26 @@
+import {
+  graphEdgeKey
+} from "./chunk-Y4Z4I6WK.js";
+
+// src/graph-dashboard-diff.ts
+function diffGraphSnapshots(previous, next) {
+  const prevNodeSet = new Set(previous.nodes.map((node) => node.id));
+  const nextNodeSet = new Set(next.nodes.map((node) => node.id));
+  const prevEdges = new Map(previous.edges.map((edge) => [graphEdgeKey(edge), edge]));
+  const nextEdges = new Map(next.edges.map((edge) => [graphEdgeKey(edge), edge]));
+  const addedNodes = [...nextNodeSet].filter((id) => !prevNodeSet.has(id)).sort((a, b) => a.localeCompare(b));
+  const removedNodes = [...prevNodeSet].filter((id) => !nextNodeSet.has(id)).sort((a, b) => a.localeCompare(b));
+  const addedEdges = [...nextEdges.entries()].filter(([key]) => !prevEdges.has(key)).map(([, edge]) => edge).sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
+  const removedEdges = [...prevEdges.entries()].filter(([key]) => !nextEdges.has(key)).map(([, edge]) => edge).sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
+  return {
+    addedNodes,
+    removedNodes,
+    addedEdges,
+    removedEdges
+  };
+}
+
+export {
+  diffGraphSnapshots
+};
+//# sourceMappingURL=chunk-3SLRNYNG.js.map

package/dist/chunk-3SLRNYNG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-dashboard-diff.ts"],"sourcesContent":["import type { GraphEdge } from \"./graph.js\";\nimport { graphEdgeKey } from \"./graph-dashboard-key.js\";\nimport type { GraphSnapshot } from \"./graph-dashboard-parser.js\";\n\nexport interface GraphPatch {\n  addedNodes: string[];\n  removedNodes: string[];\n  addedEdges: GraphEdge[];\n  removedEdges: GraphEdge[];\n}\n\nexport function diffGraphSnapshots(previous: GraphSnapshot, next: GraphSnapshot): GraphPatch {\n  const prevNodeSet = new Set(previous.nodes.map((node) => node.id));\n  const nextNodeSet = new Set(next.nodes.map((node) => node.id));\n  const prevEdges = new Map(previous.edges.map((edge) => [graphEdgeKey(edge), edge]));\n  const nextEdges = new Map(next.edges.map((edge) => [graphEdgeKey(edge), edge]));\n\n  const addedNodes = [...nextNodeSet].filter((id) => !prevNodeSet.has(id)).sort((a, b) => a.localeCompare(b));\n  const removedNodes = [...prevNodeSet].filter((id) => !nextNodeSet.has(id)).sort((a, b) => a.localeCompare(b));\n  const addedEdges = [...nextEdges.entries()]\n    .filter(([key]) => !prevEdges.has(key))\n    .map(([, edge]) => edge)\n    .sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));\n  const removedEdges = [...prevEdges.entries()]\n    .filter(([key]) => !nextEdges.has(key))\n    .map(([, edge]) => edge)\n    .sort((a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));\n\n  return {\n    addedNodes,\n    removedNodes,\n    addedEdges,\n    removedEdges,\n  };\n}\n"],"mappings":";;;;;AAWO,SAAS,mBAAmB,UAAyB,MAAiC;AAC3F,QAAM,cAAc,IAAI,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;AACjE,QAAM,cAAc,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;AAC7D,QAAM,YAAY,IAAI,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,CAAC;AAClF,QAAM,YAAY,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,GAAG,IAAI,CAAC,CAAC;AAE9E,QAAM,aAAa,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC1G,QAAM,eAAe,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC5G,QAAM,aAAa,CAAC,GAAG,UAAU,QAAQ,CAAC,EACvC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,EACrC,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,IAAI,EACtB,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC;AAC1G,QAAM,eAAe,CAAC,GAAG,UAAU,QAAQ,CAAC,EACzC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,EACrC,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,IAAI,EACtB,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC;AAE1G,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-4A24LIM2.js

@@ -0,0 +1,68 @@
+import {
+  clamp01,
+  computeLifecycleValueInputs,
+  daysSince
+} from "./chunk-QCCCQT3O.js";
+
+// src/tier-routing.ts
+function computeTierValueScore(memory, now, signals) {
+  const fm = memory.frontmatter;
+  const inputs = computeLifecycleValueInputs(memory, now, signals);
+  const correctionBoost = fm.category === "correction" ? 0.08 : 0;
+  const confirmedBoost = fm.verificationState === "user_confirmed" ? 0.05 : 0;
+  const score = inputs.confidence * 0.24 + inputs.access * 0.26 + inputs.recency * 0.2 + inputs.importance * 0.2 + inputs.feedback * 0.1 + correctionBoost + confirmedBoost - inputs.disputedPenalty * 0.5;
+  return clamp01(score);
+}
+function decideTierTransition(memory, currentTier, policy, now, signals) {
+  const valueScore = computeTierValueScore(memory, now, signals);
+  if (!policy.enabled) {
+    return {
+      currentTier,
+      nextTier: currentTier,
+      valueScore,
+      changed: false,
+      reason: "tier_migration_disabled"
+    };
+  }
+  if (currentTier === "hot") {
+    const ageDays = daysSince(memory.frontmatter.updated ?? memory.frontmatter.created, now.getTime());
+    if (ageDays >= policy.demotionMinAgeDays && valueScore <= policy.demotionValueThreshold) {
+      return {
+        currentTier,
+        nextTier: "cold",
+        valueScore,
+        changed: true,
+        reason: "value_below_demotion_threshold"
+      };
+    }
+    return {
+      currentTier,
+      nextTier: currentTier,
+      valueScore,
+      changed: false,
+      reason: ageDays < policy.demotionMinAgeDays ? "demotion_min_age_not_met" : "value_above_demotion_threshold"
+    };
+  }
+  if (valueScore >= policy.promotionValueThreshold) {
+    return {
+      currentTier,
+      nextTier: "hot",
+      valueScore,
+      changed: true,
+      reason: "value_above_promotion_threshold"
+    };
+  }
+  return {
+    currentTier,
+    nextTier: currentTier,
+    valueScore,
+    changed: false,
+    reason: "value_below_promotion_threshold"
+  };
+}
+
+export {
+  computeTierValueScore,
+  decideTierTransition
+};
+//# sourceMappingURL=chunk-4A24LIM2.js.map

package/dist/chunk-4A24LIM2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tier-routing.ts"],"sourcesContent":["import type { MemoryFile } from \"./types.js\";\nimport {\n  clamp01,\n  computeLifecycleValueInputs,\n  daysSince,\n  type LifecycleSignals,\n} from \"./lifecycle.js\";\n\nexport type MemoryTier = \"hot\" | \"cold\";\n\nexport interface TierRoutingPolicy {\n  enabled: boolean;\n  demotionMinAgeDays: number;\n  demotionValueThreshold: number;\n  promotionValueThreshold: number;\n}\n\nexport interface TierTransitionDecision {\n  currentTier: MemoryTier;\n  nextTier: MemoryTier;\n  valueScore: number;\n  changed: boolean;\n  reason: string;\n}\n\nexport function computeTierValueScore(\n  memory: Pick<MemoryFile, \"frontmatter\">,\n  now: Date,\n  signals?: LifecycleSignals,\n): number {\n  const fm = memory.frontmatter;\n  const inputs = computeLifecycleValueInputs(memory, now, signals);\n  const correctionBoost = fm.category === \"correction\" ? 0.08 : 0;\n  const confirmedBoost = fm.verificationState === \"user_confirmed\" ? 0.05 : 0;\n\n  const score = (inputs.confidence * 0.24)\n    + (inputs.access * 0.26)\n    + (inputs.recency * 0.2)\n    + (inputs.importance * 0.2)\n    + (inputs.feedback * 0.1)\n    + correctionBoost\n    + confirmedBoost\n    - (inputs.disputedPenalty * 0.5);\n\n  return clamp01(score);\n}\n\nexport function decideTierTransition(\n  memory: Pick<MemoryFile, \"frontmatter\">,\n  currentTier: MemoryTier,\n  policy: TierRoutingPolicy,\n  now: Date,\n  signals?: LifecycleSignals,\n): TierTransitionDecision {\n  const valueScore = computeTierValueScore(memory, now, signals);\n  if (!policy.enabled) {\n    return {\n      currentTier,\n      nextTier: currentTier,\n      valueScore,\n      changed: false,\n      reason: \"tier_migration_disabled\",\n    };\n  }\n\n  if (currentTier === \"hot\") {\n    const ageDays = daysSince(memory.frontmatter.updated ?? memory.frontmatter.created, now.getTime());\n    if (ageDays >= policy.demotionMinAgeDays && valueScore <= policy.demotionValueThreshold) {\n      return {\n        currentTier,\n        nextTier: \"cold\",\n        valueScore,\n        changed: true,\n        reason: \"value_below_demotion_threshold\",\n      };\n    }\n    return {\n      currentTier,\n      nextTier: currentTier,\n      valueScore,\n      changed: false,\n      reason: ageDays < policy.demotionMinAgeDays ? \"demotion_min_age_not_met\" : \"value_above_demotion_threshold\",\n    };\n  }\n\n  if (valueScore >= policy.promotionValueThreshold) {\n    return {\n      currentTier,\n      nextTier: \"hot\",\n      valueScore,\n      changed: true,\n      reason: \"value_above_promotion_threshold\",\n    };\n  }\n  return {\n    currentTier,\n    nextTier: currentTier,\n    valueScore,\n    changed: false,\n    reason: \"value_below_promotion_threshold\",\n  };\n}\n"],"mappings":";;;;;;;AAyBO,SAAS,sBACd,QACA,KACA,SACQ;AACR,QAAM,KAAK,OAAO;AAClB,QAAM,SAAS,4BAA4B,QAAQ,KAAK,OAAO;AAC/D,QAAM,kBAAkB,GAAG,aAAa,eAAe,OAAO;AAC9D,QAAM,iBAAiB,GAAG,sBAAsB,mBAAmB,OAAO;AAE1E,QAAM,QAAS,OAAO,aAAa,OAC9B,OAAO,SAAS,OAChB,OAAO,UAAU,MACjB,OAAO,aAAa,MACpB,OAAO,WAAW,MACnB,kBACA,iBACC,OAAO,kBAAkB;AAE9B,SAAO,QAAQ,KAAK;AACtB;AAEO,SAAS,qBACd,QACA,aACA,QACA,KACA,SACwB;AACxB,QAAM,aAAa,sBAAsB,QAAQ,KAAK,OAAO;AAC7D,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO;AAAA,MACL;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,IACV;AAAA,EACF;AAEA,MAAI,gBAAgB,OAAO;AACzB,UAAM,UAAU,UAAU,OAAO,YAAY,WAAW,OAAO,YAAY,SAAS,IAAI,QAAQ,CAAC;AACjG,QAAI,WAAW,OAAO,sBAAsB,cAAc,OAAO,wBAAwB;AACvF,aAAO;AAAA,QACL;AAAA,QACA,UAAU;AAAA,QACV;AAAA,QACA,SAAS;AAAA,QACT,QAAQ;AAAA,MACV;AAAA,IACF;AACA,WAAO;AAAA,MACL;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA,SAAS;AAAA,MACT,QAAQ,UAAU,OAAO,qBAAqB,6BAA6B;AAAA,IAC7E;AAAA,EACF;AAEA,MAAI,cAAc,OAAO,yBAAyB;AAChD,WAAO;AAAA,MACL;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,IACV;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AACF;","names":[]}

package/dist/chunk-6HZ6AO2P.js

@@ -0,0 +1,164 @@
+// src/recall-query-policy.ts
+var DEFAULT_STOPWORDS = /* @__PURE__ */ new Set([
+  "the",
+  "and",
+  "for",
+  "with",
+  "from",
+  "that",
+  "this",
+  "your",
+  "you",
+  "are",
+  "was",
+  "were",
+  "have",
+  "has",
+  "had",
+  "not",
+  "but",
+  "its",
+  "into",
+  "only",
+  "use",
+  "run",
+  "then",
+  "when",
+  "what",
+  "where",
+  "which",
+  "will",
+  "would",
+  "should",
+  "could",
+  "goal",
+  "output",
+  "format",
+  "rules",
+  "section",
+  "sections",
+  "skip",
+  "today",
+  "yesterday",
+  "return",
+  "summary",
+  "plain",
+  "text",
+  "before",
+  "after",
+  "time",
+  "date",
+  "daily",
+  "cron",
+  "agent",
+  "mode",
+  "data",
+  "gathering",
+  "context"
+]);
+function collapseWhitespace(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function stripFilesystemLikePaths(text) {
+  return text.replace(/(?:^|\s)(~\/[^\s)]+)(?=\s|$)/g, " ").replace(/(?:^|\s)(\/[A-Za-z0-9._\-\/]+)(?=\s|$)/g, " ").replace(/(?:^|\s)([A-Za-z]:\\[^\s)]+)(?=\s|$)/g, " ");
+}
+function isBulletOrNumberedLine(line) {
+  if (line.startsWith("-") || line.startsWith("*")) {
+    return true;
+  }
+  let i = 0;
+  while (i < line.length) {
+    const code = line.charCodeAt(i);
+    if (code < 48 || code > 57) {
+      break;
+    }
+    i += 1;
+  }
+  return i > 0 && i < line.length && line.charAt(i) === ".";
+}
+function scoreInstructionHeavyShape(prompt) {
+  const lines = prompt.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+  const lineCount = lines.length;
+  if (lineCount === 0) return 0;
+  const headingLineCount = lines.filter(
+    (line) => /^(goal|output format|tone rules|grounding rules|data gathering|date computation|crm context|follow-up|social|current time|return)\b/i.test(
+      line
+    ) || /^[A-Z][A-Z\s/-]{4,}:$/.test(line)
+  ).length;
+  const bulletLineCount = lines.filter((line) => isBulletOrNumberedLine(line)).length;
+  const longLineCount = lines.filter((line) => line.length >= 180).length;
+  const hasPathDensity = (prompt.match(/(?:~\/|\/Users\/|[A-Za-z]:\\)/g)?.length ?? 0) >= 2;
+  const hasImperativeDensity = (prompt.match(/\b(run|extract|read|parse|determine|include|omit|skip)\b/gi)?.length ?? 0) >= 8;
+  let score = 0;
+  if (lineCount >= 24) score += 2;
+  if (headingLineCount >= 4) score += 2;
+  if (bulletLineCount >= 8) score += 1;
+  if (longLineCount >= 3) score += 1;
+  if (hasPathDensity) score += 1;
+  if (hasImperativeDensity) score += 1;
+  return score;
+}
+function classifyRecallPromptShape(prompt) {
+  const score = scoreInstructionHeavyShape(prompt);
+  return score >= 5 ? "instruction_heavy" : "standard";
+}
+function tokenizeForCompactQuery(text) {
+  const raw = text.toLowerCase().replace(/[^a-z0-9\s:_-]+/g, " ").split(/\s+/).filter((token) => token.length >= 3);
+  const deduped = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const token of raw) {
+    if (DEFAULT_STOPWORDS.has(token)) continue;
+    if (seen.has(token)) continue;
+    seen.add(token);
+    deduped.push(token);
+  }
+  return deduped;
+}
+function buildInstructionHeavyQuery(prompt, tokenCap, maxChars) {
+  const cleaned = stripFilesystemLikePaths(prompt);
+  const tokens = tokenizeForCompactQuery(cleaned).slice(0, Math.max(8, tokenCap));
+  const joined = tokens.join(" ");
+  const compact = collapseWhitespace(joined);
+  if (compact.length <= maxChars) return compact;
+  return compact.slice(0, maxChars).trim();
+}
+function clampInstructionHeavyTokenCap(value) {
+  if (!Number.isFinite(value)) return 8;
+  return Math.max(8, Math.round(value));
+}
+function buildStandardQuery(prompt, maxChars) {
+  const trimmed = collapseWhitespace(prompt);
+  if (trimmed.length <= maxChars) return trimmed;
+  return trimmed.slice(0, maxChars).trim();
+}
+function buildRecallQueryPolicy(prompt, sessionKey, cfg) {
+  const normalizedPrompt = collapseWhitespace(prompt);
+  const isCron = (sessionKey ?? "").includes(":cron:");
+  if (!cfg.cronRecallPolicyEnabled || !isCron) {
+    return {
+      promptShape: "standard",
+      retrievalQuery: prompt,
+      skipConversationRecall: false,
+      retrievalBudgetMode: "full"
+    };
+  }
+  const promptShape = classifyRecallPromptShape(prompt);
+  const maxChars = Math.max(120, cfg.cronRecallNormalizedQueryMaxChars);
+  const tokenCap = clampInstructionHeavyTokenCap(cfg.cronRecallInstructionHeavyTokenCap);
+  const retrievalQuery = promptShape === "instruction_heavy" ? buildInstructionHeavyQuery(prompt, tokenCap, maxChars) : buildStandardQuery(prompt, maxChars);
+  const skipConversationRecall = cfg.cronConversationRecallMode === "never" ? true : cfg.cronConversationRecallMode === "always" ? false : promptShape === "instruction_heavy";
+  const retrievalBudgetMode = promptShape === "instruction_heavy" ? "minimal" : "full";
+  return {
+    promptShape,
+    retrievalQuery: retrievalQuery.length > 0 ? retrievalQuery : normalizedPrompt.slice(0, maxChars),
+    skipConversationRecall,
+    retrievalBudgetMode
+  };
+}
+
+export {
+  classifyRecallPromptShape,
+  clampInstructionHeavyTokenCap,
+  buildRecallQueryPolicy
+};
+//# sourceMappingURL=chunk-6HZ6AO2P.js.map

package/dist/chunk-6HZ6AO2P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-query-policy.ts"],"sourcesContent":["export type RecallPromptShape = \"standard\" | \"instruction_heavy\";\nexport type CronConversationRecallMode = \"auto\" | \"always\" | \"never\";\nexport type RecallBudgetMode = \"full\" | \"minimal\";\n\nexport interface RecallQueryPolicyConfig {\n  cronRecallPolicyEnabled: boolean;\n  cronRecallNormalizedQueryMaxChars: number;\n  cronRecallInstructionHeavyTokenCap: number;\n  cronConversationRecallMode: CronConversationRecallMode;\n}\n\nexport interface RecallQueryPolicyResult {\n  promptShape: RecallPromptShape;\n  retrievalQuery: string;\n  skipConversationRecall: boolean;\n  retrievalBudgetMode: RecallBudgetMode;\n}\n\nconst DEFAULT_STOPWORDS = new Set([\n  \"the\",\n  \"and\",\n  \"for\",\n  \"with\",\n  \"from\",\n  \"that\",\n  \"this\",\n  \"your\",\n  \"you\",\n  \"are\",\n  \"was\",\n  \"were\",\n  \"have\",\n  \"has\",\n  \"had\",\n  \"not\",\n  \"but\",\n  \"its\",\n  \"into\",\n  \"only\",\n  \"use\",\n  \"run\",\n  \"then\",\n  \"when\",\n  \"what\",\n  \"where\",\n  \"which\",\n  \"will\",\n  \"would\",\n  \"should\",\n  \"could\",\n  \"goal\",\n  \"output\",\n  \"format\",\n  \"rules\",\n  \"section\",\n  \"sections\",\n  \"skip\",\n  \"today\",\n  \"yesterday\",\n  \"return\",\n  \"summary\",\n  \"plain\",\n  \"text\",\n  \"before\",\n  \"after\",\n  \"time\",\n  \"date\",\n  \"daily\",\n  \"cron\",\n  \"agent\",\n  \"mode\",\n  \"data\",\n  \"gathering\",\n  \"context\",\n]);\n\nfunction collapseWhitespace(text: string): string {\n  return text.replace(/\\s+/g, \" \").trim();\n}\n\nfunction stripFilesystemLikePaths(text: string): string {\n  return text\n    .replace(/(?:^|\\s)(~\\/[^\\s)]+)(?=\\s|$)/g, \" \")\n    .replace(/(?:^|\\s)(\\/[A-Za-z0-9._\\-\\/]+)(?=\\s|$)/g, \" \")\n    .replace(/(?:^|\\s)([A-Za-z]:\\\\[^\\s)]+)(?=\\s|$)/g, \" \");\n}\n\nfunction isBulletOrNumberedLine(line: string): boolean {\n  if (line.startsWith(\"-\") || line.startsWith(\"*\")) {\n    return true;\n  }\n\n  let i = 0;\n  while (i < line.length) {\n    const code = line.charCodeAt(i);\n    if (code < 48 || code > 57) {\n      break;\n    }\n    i += 1;\n  }\n  return i > 0 && i < line.length && line.charAt(i) === \".\";\n}\n\nfunction scoreInstructionHeavyShape(prompt: string): number {\n  const lines = prompt\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n  const lineCount = lines.length;\n  if (lineCount === 0) return 0;\n\n  const headingLineCount = lines.filter(\n    (line) =>\n      /^(goal|output format|tone rules|grounding rules|data gathering|date computation|crm context|follow-up|social|current time|return)\\b/i.test(\n        line,\n      ) || /^[A-Z][A-Z\\s/-]{4,}:$/.test(line),\n  ).length;\n  const bulletLineCount = lines.filter((line) => isBulletOrNumberedLine(line)).length;\n  const longLineCount = lines.filter((line) => line.length >= 180).length;\n  const hasPathDensity =\n    (prompt.match(/(?:~\\/|\\/Users\\/|[A-Za-z]:\\\\)/g)?.length ?? 0) >= 2;\n  const hasImperativeDensity =\n    (prompt.match(/\\b(run|extract|read|parse|determine|include|omit|skip)\\b/gi)?.length ?? 0) >=\n    8;\n\n  let score = 0;\n  if (lineCount >= 24) score += 2;\n  if (headingLineCount >= 4) score += 2;\n  if (bulletLineCount >= 8) score += 1;\n  if (longLineCount >= 3) score += 1;\n  if (hasPathDensity) score += 1;\n  if (hasImperativeDensity) score += 1;\n  return score;\n}\n\nexport function classifyRecallPromptShape(prompt: string): RecallPromptShape {\n  const score = scoreInstructionHeavyShape(prompt);\n  return score >= 5 ? \"instruction_heavy\" : \"standard\";\n}\n\nfunction tokenizeForCompactQuery(text: string): string[] {\n  const raw = text\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s:_-]+/g, \" \")\n    .split(/\\s+/)\n    .filter((token) => token.length >= 3);\n  const deduped: string[] = [];\n  const seen = new Set<string>();\n  for (const token of raw) {\n    if (DEFAULT_STOPWORDS.has(token)) continue;\n    if (seen.has(token)) continue;\n    seen.add(token);\n    deduped.push(token);\n  }\n  return deduped;\n}\n\nfunction buildInstructionHeavyQuery(\n  prompt: string,\n  tokenCap: number,\n  maxChars: number,\n): string {\n  const cleaned = stripFilesystemLikePaths(prompt);\n  const tokens = tokenizeForCompactQuery(cleaned).slice(0, Math.max(8, tokenCap));\n  const joined = tokens.join(\" \");\n  const compact = collapseWhitespace(joined);\n  if (compact.length <= maxChars) return compact;\n  return compact.slice(0, maxChars).trim();\n}\n\nexport function clampInstructionHeavyTokenCap(value: number): number {\n  if (!Number.isFinite(value)) return 8;\n  return Math.max(8, Math.round(value));\n}\n\nfunction buildStandardQuery(prompt: string, maxChars: number): string {\n  const trimmed = collapseWhitespace(prompt);\n  if (trimmed.length <= maxChars) return trimmed;\n  return trimmed.slice(0, maxChars).trim();\n}\n\nexport function buildRecallQueryPolicy(\n  prompt: string,\n  sessionKey: string | undefined,\n  cfg: RecallQueryPolicyConfig,\n): RecallQueryPolicyResult {\n  const normalizedPrompt = collapseWhitespace(prompt);\n  const isCron = (sessionKey ?? \"\").includes(\":cron:\");\n  if (!cfg.cronRecallPolicyEnabled || !isCron) {\n    return {\n      promptShape: \"standard\",\n      retrievalQuery: prompt,\n      skipConversationRecall: false,\n      retrievalBudgetMode: \"full\",\n    };\n  }\n\n  const promptShape = classifyRecallPromptShape(prompt);\n  const maxChars = Math.max(120, cfg.cronRecallNormalizedQueryMaxChars);\n  const tokenCap = clampInstructionHeavyTokenCap(cfg.cronRecallInstructionHeavyTokenCap);\n  const retrievalQuery =\n    promptShape === \"instruction_heavy\"\n      ? buildInstructionHeavyQuery(prompt, tokenCap, maxChars)\n      : buildStandardQuery(prompt, maxChars);\n\n  const skipConversationRecall =\n    cfg.cronConversationRecallMode === \"never\"\n      ? true\n      : cfg.cronConversationRecallMode === \"always\"\n      ? false\n      : promptShape === \"instruction_heavy\";\n\n  const retrievalBudgetMode = promptShape === \"instruction_heavy\" ? \"minimal\" : \"full\";\n\n  return {\n    promptShape,\n    retrievalQuery: retrievalQuery.length > 0 ? retrievalQuery : normalizedPrompt.slice(0, maxChars),\n    skipConversationRecall,\n    retrievalBudgetMode,\n  };\n}\n"],"mappings":"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","names":[]}