@remnic/core 1.0.0

package/dist/chunk-Z5AAYHUC.js

@@ -0,0 +1,79 @@
+// src/tier-migration.ts
+import { appendFile, mkdir } from "fs/promises";
+import path from "path";
+var TierMigrationExecutor = class {
+  storage;
+  qmd;
+  hotCollection;
+  coldCollection;
+  autoEmbed;
+  journalPath;
+  constructor(options) {
+    this.storage = options.storage;
+    this.qmd = options.qmd;
+    this.hotCollection = options.hotCollection;
+    this.coldCollection = options.coldCollection;
+    this.autoEmbed = options.autoEmbed === true;
+    this.journalPath = options.journalPath ?? path.join(this.storage.dir, "state", "tier-migration-journal.jsonl");
+  }
+  async migrateMemory(request) {
+    const { memory, fromTier, toTier, reason } = request;
+    const targetPath = this.storage.buildTierMemoryPath(memory, toTier);
+    if (fromTier === toTier) {
+      const noChange = {
+        memoryId: memory.frontmatter.id,
+        fromTier,
+        toTier,
+        changed: false,
+        reason,
+        targetPath
+      };
+      await this.appendJournal(noChange);
+      return noChange;
+    }
+    const moved = await this.storage.migrateMemoryToTier(memory, toTier);
+    const result = {
+      memoryId: memory.frontmatter.id,
+      fromTier,
+      toTier,
+      changed: moved.changed,
+      reason,
+      targetPath: moved.targetPath
+    };
+    await this.appendJournal(result);
+    if (result.changed) {
+      const destinationCollection = this.collectionForTier(toTier);
+      const sourceCollection = this.collectionForTier(fromTier);
+      await this.qmd.updateCollection(destinationCollection);
+      if (this.autoEmbed) {
+        await this.qmd.embedCollection(destinationCollection);
+        if (sourceCollection !== destinationCollection) {
+          await this.qmd.embedCollection(sourceCollection);
+        }
+      }
+    }
+    return result;
+  }
+  collectionForTier(tier) {
+    return tier === "cold" ? this.coldCollection : this.hotCollection;
+  }
+  async appendJournal(result) {
+    const entry = {
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      memoryId: result.memoryId,
+      fromTier: result.fromTier,
+      toTier: result.toTier,
+      changed: result.changed,
+      reason: result.reason,
+      targetPath: result.targetPath
+    };
+    await mkdir(path.dirname(this.journalPath), { recursive: true });
+    await appendFile(this.journalPath, `${JSON.stringify(entry)}
+`, "utf-8");
+  }
+};
+
+export {
+  TierMigrationExecutor
+};
+//# sourceMappingURL=chunk-Z5AAYHUC.js.map

package/dist/chunk-Z5AAYHUC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tier-migration.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { MemoryFile } from \"./types.js\";\nimport { StorageManager } from \"./storage.js\";\nimport type { MemoryTier } from \"./tier-routing.js\";\nimport type { SearchBackend } from \"./search/port.js\";\n\nexport type { MemoryTier } from \"./tier-routing.js\";\n\nexport interface TierMigrationRequest {\n  memory: MemoryFile;\n  fromTier: MemoryTier;\n  toTier: MemoryTier;\n  reason: string;\n}\n\nexport interface TierMigrationResult {\n  memoryId: string;\n  fromTier: MemoryTier;\n  toTier: MemoryTier;\n  changed: boolean;\n  reason: string;\n  targetPath: string;\n}\n\nexport interface TierMigrationExecutorOptions {\n  storage: StorageManager;\n  qmd: SearchBackend;\n  hotCollection: string;\n  coldCollection: string;\n  autoEmbed?: boolean;\n  journalPath?: string;\n}\n\ntype TierMigrationJournalEntry = {\n  ts: string;\n  memoryId: string;\n  fromTier: MemoryTier;\n  toTier: MemoryTier;\n  changed: boolean;\n  reason: string;\n  targetPath: string;\n};\n\nexport class TierMigrationExecutor {\n  private readonly storage: StorageManager;\n  private readonly qmd: SearchBackend;\n  private readonly hotCollection: string;\n  private readonly coldCollection: string;\n  private readonly autoEmbed: boolean;\n  private readonly journalPath: string;\n\n  constructor(options: TierMigrationExecutorOptions) {\n    this.storage = options.storage;\n    this.qmd = options.qmd;\n    this.hotCollection = options.hotCollection;\n    this.coldCollection = options.coldCollection;\n    this.autoEmbed = options.autoEmbed === true;\n    this.journalPath = options.journalPath ?? path.join(this.storage.dir, \"state\", \"tier-migration-journal.jsonl\");\n  }\n\n  async migrateMemory(request: TierMigrationRequest): Promise<TierMigrationResult> {\n    const { memory, fromTier, toTier, reason } = request;\n    const targetPath = this.storage.buildTierMemoryPath(memory, toTier);\n\n    if (fromTier === toTier) {\n      const noChange: TierMigrationResult = {\n        memoryId: memory.frontmatter.id,\n        fromTier,\n        toTier,\n        changed: false,\n        reason,\n        targetPath,\n      };\n      await this.appendJournal(noChange);\n      return noChange;\n    }\n\n    const moved = await this.storage.migrateMemoryToTier(memory, toTier);\n    const result: TierMigrationResult = {\n      memoryId: memory.frontmatter.id,\n      fromTier,\n      toTier,\n      changed: moved.changed,\n      reason,\n      targetPath: moved.targetPath,\n    };\n\n    await this.appendJournal(result);\n\n    if (result.changed) {\n      const destinationCollection = this.collectionForTier(toTier);\n      const sourceCollection = this.collectionForTier(fromTier);\n      // QMD update is effectively global in current CLI versions. One update call is enough.\n      await this.qmd.updateCollection(destinationCollection);\n      if (this.autoEmbed) {\n        await this.qmd.embedCollection(destinationCollection);\n        if (sourceCollection !== destinationCollection) {\n          await this.qmd.embedCollection(sourceCollection);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  private collectionForTier(tier: MemoryTier): string {\n    return tier === \"cold\" ? this.coldCollection : this.hotCollection;\n  }\n\n  private async appendJournal(result: TierMigrationResult): Promise<void> {\n    const entry: TierMigrationJournalEntry = {\n      ts: new Date().toISOString(),\n      memoryId: result.memoryId,\n      fromTier: result.fromTier,\n      toTier: result.toTier,\n      changed: result.changed,\n      reason: result.reason,\n      targetPath: result.targetPath,\n    };\n    await mkdir(path.dirname(this.journalPath), { recursive: true });\n    await appendFile(this.journalPath, `${JSON.stringify(entry)}\\n`, \"utf-8\");\n  }\n}\n"],"mappings":";AAAA,SAAS,YAAY,aAAa;AAClC,OAAO,UAAU;AA2CV,IAAM,wBAAN,MAA4B;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAuC;AACjD,SAAK,UAAU,QAAQ;AACvB,SAAK,MAAM,QAAQ;AACnB,SAAK,gBAAgB,QAAQ;AAC7B,SAAK,iBAAiB,QAAQ;AAC9B,SAAK,YAAY,QAAQ,cAAc;AACvC,SAAK,cAAc,QAAQ,eAAe,KAAK,KAAK,KAAK,QAAQ,KAAK,SAAS,8BAA8B;AAAA,EAC/G;AAAA,EAEA,MAAM,cAAc,SAA6D;AAC/E,UAAM,EAAE,QAAQ,UAAU,QAAQ,OAAO,IAAI;AAC7C,UAAM,aAAa,KAAK,QAAQ,oBAAoB,QAAQ,MAAM;AAElE,QAAI,aAAa,QAAQ;AACvB,YAAM,WAAgC;AAAA,QACpC,UAAU,OAAO,YAAY;AAAA,QAC7B;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA;AAAA,MACF;AACA,YAAM,KAAK,cAAc,QAAQ;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,QAAQ,MAAM,KAAK,QAAQ,oBAAoB,QAAQ,MAAM;AACnE,UAAM,SAA8B;AAAA,MAClC,UAAU,OAAO,YAAY;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,SAAS,MAAM;AAAA,MACf;AAAA,MACA,YAAY,MAAM;AAAA,IACpB;AAEA,UAAM,KAAK,cAAc,MAAM;AAE/B,QAAI,OAAO,SAAS;AAClB,YAAM,wBAAwB,KAAK,kBAAkB,MAAM;AAC3D,YAAM,mBAAmB,KAAK,kBAAkB,QAAQ;AAExD,YAAM,KAAK,IAAI,iBAAiB,qBAAqB;AACrD,UAAI,KAAK,WAAW;AAClB,cAAM,KAAK,IAAI,gBAAgB,qBAAqB;AACpD,YAAI,qBAAqB,uBAAuB;AAC9C,gBAAM,KAAK,IAAI,gBAAgB,gBAAgB;AAAA,QACjD;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,kBAAkB,MAA0B;AAClD,WAAO,SAAS,SAAS,KAAK,iBAAiB,KAAK;AAAA,EACtD;AAAA,EAEA,MAAc,cAAc,QAA4C;AACtE,UAAM,QAAmC;AAAA,MACvC,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC3B,UAAU,OAAO;AAAA,MACjB,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,IACrB;AACA,UAAM,MAAM,KAAK,QAAQ,KAAK,WAAW,GAAG,EAAE,WAAW,KAAK,CAAC;AAC/D,UAAM,WAAW,KAAK,aAAa,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,GAAM,OAAO;AAAA,EAC1E;AACF;","names":[]}

package/dist/chunk-Z5LAYHGJ.js

@@ -0,0 +1,15 @@
+// src/session-observer-bands.ts
+var DEFAULT_SESSION_OBSERVER_BANDS = [
+  { maxBytes: 5e4, triggerDeltaBytes: 4800, triggerDeltaTokens: 1200 },
+  { maxBytes: 2e5, triggerDeltaBytes: 9600, triggerDeltaTokens: 2400 },
+  { maxBytes: 1e9, triggerDeltaBytes: 19200, triggerDeltaTokens: 4800 }
+];
+function cloneDefaultSessionObserverBands() {
+  return DEFAULT_SESSION_OBSERVER_BANDS.map((band) => ({ ...band }));
+}
+
+export {
+  DEFAULT_SESSION_OBSERVER_BANDS,
+  cloneDefaultSessionObserverBands
+};
+//# sourceMappingURL=chunk-Z5LAYHGJ.js.map

package/dist/chunk-Z5LAYHGJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-observer-bands.ts"],"sourcesContent":["import type { SessionObserverBandConfig } from \"./types.js\";\n\nexport const DEFAULT_SESSION_OBSERVER_BANDS: SessionObserverBandConfig[] = [\n  { maxBytes: 50_000, triggerDeltaBytes: 4_800, triggerDeltaTokens: 1_200 },\n  { maxBytes: 200_000, triggerDeltaBytes: 9_600, triggerDeltaTokens: 2_400 },\n  { maxBytes: 1_000_000_000, triggerDeltaBytes: 19_200, triggerDeltaTokens: 4_800 },\n];\n\nexport function cloneDefaultSessionObserverBands(): SessionObserverBandConfig[] {\n  return DEFAULT_SESSION_OBSERVER_BANDS.map((band) => ({ ...band }));\n}\n"],"mappings":";AAEO,IAAM,iCAA8D;AAAA,EACzE,EAAE,UAAU,KAAQ,mBAAmB,MAAO,oBAAoB,KAAM;AAAA,EACxE,EAAE,UAAU,KAAS,mBAAmB,MAAO,oBAAoB,KAAM;AAAA,EACzE,EAAE,UAAU,KAAe,mBAAmB,OAAQ,oBAAoB,KAAM;AAClF;AAEO,SAAS,mCAAgE;AAC9E,SAAO,+BAA+B,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE;AACnE;","names":[]}