@remnic/core 1.1.12 → 1.1.13

package/dist/chunk-PHK3HARR.js

@@ -0,0 +1,32 @@
+// src/connectors/coerce.ts
+function coerceBool(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const v = value.trim().toLowerCase();
+    if (["false", "0", "no", "off"].includes(v)) return false;
+    if (["true", "1", "yes", "on"].includes(v)) return true;
+  }
+  return void 0;
+}
+function coerceInstallExtension(value) {
+  return coerceBool(value);
+}
+function coerceNumber(value) {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : void 0;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) return void 0;
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return void 0;
+}
+
+export {
+  coerceBool,
+  coerceInstallExtension,
+  coerceNumber
+};
+//# sourceMappingURL=chunk-PHK3HARR.js.map

package/dist/chunk-PHK3HARR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/coerce.ts"],"sourcesContent":["/**\n * Shared boolean coercion helpers.\n *\n * Extracted from connectors/index.ts so that both config.ts and\n * connectors/index.ts can import them without creating a circular dependency.\n */\n\n/**\n * Generic boolean coercion: converts string representations of booleans\n * (e.g. from CLI `--config someFlag=false`) to proper boolean values.\n * Accepts the same truthy/falsy strings that common shells and env vars use.\n *\n * Returns `undefined` when the value is neither a boolean nor a recognised\n * string, so callers can fall back to a default.\n *\n * CLAUDE.md gotcha #36: String \"false\" is truthy in JavaScript.\n * CLAUDE.md gotcha #28: Coerce CLI values to expected types at input boundaries.\n */\nexport function coerceBool(value: unknown): boolean | undefined {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"string\") {\n    const v = value.trim().toLowerCase();\n    if ([\"false\", \"0\", \"no\", \"off\"].includes(v)) return false;\n    if ([\"true\", \"1\", \"yes\", \"on\"].includes(v)) return true;\n  }\n  return undefined;\n}\n\n/**\n * Coerce the `installExtension` config value from a string (e.g. from CLI\n * `--config installExtension=false`) to a proper boolean.\n *\n * Delegates to the generic `coerceBool` helper. Kept for backward compatibility.\n */\nexport function coerceInstallExtension(value: unknown): boolean | undefined {\n  return coerceBool(value);\n}\n\n/**\n * Generic numeric coercion: accepts a finite number or a string that\n * parses cleanly to one. Returns `undefined` otherwise so callers can\n * fall back to a default.\n *\n * Rules:\n * - number: returned as-is only if finite (NaN / ±Infinity → undefined).\n * - string: trimmed, parsed with `Number()`. Returns `undefined` on\n *   empty, NaN, or Infinity.\n *\n * CLAUDE.md gotcha #28: Coerce CLI values to expected types at input boundaries.\n */\nexport function coerceNumber(value: unknown): number | undefined {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : undefined;\n  }\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) return undefined;\n    const n = Number(trimmed);\n    return Number.isFinite(n) ? n : undefined;\n  }\n  return undefined;\n}\n"],"mappings":";AAkBO,SAAS,WAAW,OAAqC;AAC9D,MAAI,OAAO,UAAU,UAAW,QAAO;AACvC,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,IAAI,MAAM,KAAK,EAAE,YAAY;AACnC,QAAI,CAAC,SAAS,KAAK,MAAM,KAAK,EAAE,SAAS,CAAC,EAAG,QAAO;AACpD,QAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,EAAE,SAAS,CAAC,EAAG,QAAO;AAAA,EACrD;AACA,SAAO;AACT;AAQO,SAAS,uBAAuB,OAAqC;AAC1E,SAAO,WAAW,KAAK;AACzB;AAcO,SAAS,aAAa,OAAoC;AAC/D,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,UAAM,IAAI,OAAO,OAAO;AACxB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-PIRJPV5T.js

@@ -0,0 +1,98 @@
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/search/remote-backend.ts
+var RemoteSearchBackend = class {
+  baseUrl;
+  apiKey;
+  timeoutMs;
+  available = false;
+  constructor(opts) {
+    let url = opts.baseUrl;
+    while (url.endsWith("/")) url = url.slice(0, -1);
+    this.baseUrl = url;
+    this.apiKey = opts.apiKey;
+    this.timeoutMs = opts.timeoutMs ?? 3e4;
+  }
+  async probe() {
+    try {
+      const res = await fetch(`${this.baseUrl}/health`, {
+        method: "GET",
+        headers: this.headers(),
+        signal: AbortSignal.timeout(this.timeoutMs)
+      });
+      this.available = res.ok;
+      return this.available;
+    } catch (err) {
+      log.debug(`RemoteSearchBackend probe failed: ${err}`);
+      this.available = false;
+      return false;
+    }
+  }
+  isAvailable() {
+    return this.available;
+  }
+  debugStatus() {
+    return `backend=remote available=${this.available} baseUrl=${this.baseUrl}`;
+  }
+  async search(query, collection, maxResults, _options, execution) {
+    return this.post("/search/deep", { query, collection, maxResults }, execution);
+  }
+  async searchGlobal(query, maxResults, execution) {
+    return this.post("/search/deep", { query, maxResults }, execution);
+  }
+  async bm25Search(query, collection, maxResults, execution) {
+    return this.post("/search/bm25", { query, collection, maxResults }, execution);
+  }
+  async vectorSearch(query, collection, maxResults, execution) {
+    return this.post("/search/vector", { query, collection, maxResults }, execution);
+  }
+  async hybridSearch(query, collection, maxResults, execution) {
+    return this.post("/search/hybrid", { query, collection, maxResults }, execution);
+  }
+  async update(_execution) {
+  }
+  async updateCollection(_collection, _execution) {
+  }
+  async embed() {
+  }
+  async embedCollection(_collection) {
+  }
+  async ensureCollection(_memoryDir) {
+    return "skipped";
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.apiKey) {
+      h["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    return h;
+  }
+  async post(endpoint, body, execution) {
+    if (!this.available) return [];
+    try {
+      const res = await fetch(`${this.baseUrl}${endpoint}`, {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify(body),
+        signal: execution?.signal ? AbortSignal.any([execution.signal, AbortSignal.timeout(this.timeoutMs)]) : AbortSignal.timeout(this.timeoutMs)
+      });
+      if (!res.ok) {
+        log.debug(`RemoteSearchBackend ${endpoint} returned ${res.status}`);
+        return [];
+      }
+      const data = await res.json();
+      if (!Array.isArray(data)) return [];
+      return data;
+    } catch (err) {
+      log.debug(`RemoteSearchBackend ${endpoint} failed: ${err}`);
+      return [];
+    }
+  }
+};
+
+export {
+  RemoteSearchBackend
+};
+//# sourceMappingURL=chunk-PIRJPV5T.js.map

package/dist/chunk-PIRJPV5T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/remote-backend.ts"],"sourcesContent":["import { log } from \"../logger.js\";\nimport type { SearchBackend, SearchExecutionOptions, SearchQueryOptions, SearchResult } from \"./port.js\";\n\nexport interface RemoteSearchBackendOptions {\n  baseUrl: string;\n  apiKey?: string;\n  timeoutMs?: number;\n}\n\n/**\n * HTTP REST search backend adapter.\n *\n * Delegates search to a remote service. Maintenance methods are no-ops\n * (remote backends manage their own indexing).\n */\nexport class RemoteSearchBackend implements SearchBackend {\n  private readonly baseUrl: string;\n  private readonly apiKey?: string;\n  private readonly timeoutMs: number;\n  private available = false;\n\n  constructor(opts: RemoteSearchBackendOptions) {\n    let url = opts.baseUrl;\n    while (url.endsWith(\"/\")) url = url.slice(0, -1);\n    this.baseUrl = url;\n    this.apiKey = opts.apiKey;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async probe(): Promise<boolean> {\n    try {\n      const res = await fetch(`${this.baseUrl}/health`, {\n        method: \"GET\",\n        headers: this.headers(),\n        signal: AbortSignal.timeout(this.timeoutMs),\n      });\n      this.available = res.ok;\n      return this.available;\n    } catch (err) {\n      log.debug(`RemoteSearchBackend probe failed: ${err}`);\n      this.available = false;\n      return false;\n    }\n  }\n\n  isAvailable(): boolean {\n    return this.available;\n  }\n\n  debugStatus(): string {\n    return `backend=remote available=${this.available} baseUrl=${this.baseUrl}`;\n  }\n\n  async search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    _options?: SearchQueryOptions,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]> {\n    return this.post(\"/search/deep\", { query, collection, maxResults }, execution);\n  }\n\n  async searchGlobal(query: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.post(\"/search/deep\", { query, maxResults }, execution);\n  }\n\n  async bm25Search(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.post(\"/search/bm25\", { query, collection, maxResults }, execution);\n  }\n\n  async vectorSearch(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.post(\"/search/vector\", { query, collection, maxResults }, execution);\n  }\n\n  async hybridSearch(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.post(\"/search/hybrid\", { query, collection, maxResults }, execution);\n  }\n\n  async update(_execution?: SearchExecutionOptions): Promise<void> {}\n  async updateCollection(_collection: string, _execution?: SearchExecutionOptions): Promise<void> {}\n  async embed(): Promise<void> {}\n  async embedCollection(_collection: string): Promise<void> {}\n\n  async ensureCollection(_memoryDir: string): Promise<\"skipped\"> {\n    return \"skipped\";\n  }\n\n  private headers(): Record<string, string> {\n    const h: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (this.apiKey) {\n      h[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    }\n    return h;\n  }\n\n  private async post(\n    endpoint: string,\n    body: Record<string, unknown>,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]> {\n    if (!this.available) return [];\n    try {\n      const res = await fetch(`${this.baseUrl}${endpoint}`, {\n        method: \"POST\",\n        headers: this.headers(),\n        body: JSON.stringify(body),\n        signal: execution?.signal\n          ? AbortSignal.any([execution.signal, AbortSignal.timeout(this.timeoutMs)])\n          : AbortSignal.timeout(this.timeoutMs),\n      });\n      if (!res.ok) {\n        log.debug(`RemoteSearchBackend ${endpoint} returned ${res.status}`);\n        return [];\n      }\n      const data = await res.json();\n      if (!Array.isArray(data)) return [];\n      return data as SearchResult[];\n    } catch (err) {\n      log.debug(`RemoteSearchBackend ${endpoint} failed: ${err}`);\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PK7H5L6Y.js

@@ -0,0 +1,159 @@
+import {
+  backupAndWriteRebuiltObservations,
+  toHourBucketIso
+} from "./chunk-LT3NLYSI.js";
+
+// src/maintenance/migrate-observations.ts
+import path from "path";
+import { readdir, readFile } from "fs/promises";
+function toNonNegativeInt(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  const normalized = Math.floor(value);
+  if (normalized < 0) return null;
+  return normalized;
+}
+function toHourIso(value) {
+  if (typeof value !== "string" || value.length === 0) return null;
+  return toHourBucketIso(value);
+}
+function toSessionKey(row) {
+  const candidates = [row.sessionKey, row.session, row.session_id, row.sessionId];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.length > 0) return candidate;
+  }
+  return null;
+}
+function toLegacyHour(row) {
+  const candidates = [row.hour, row.hourStart, row.timestamp, row.time];
+  for (const candidate of candidates) {
+    const hour = toHourIso(candidate);
+    if (hour) return hour;
+  }
+  return null;
+}
+function toCounts(row) {
+  const role = row.role === "user" || row.role === "assistant" ? row.role : null;
+  const explicitTurnCount = toNonNegativeInt(row.turnCount) ?? toNonNegativeInt(row.turns) ?? toNonNegativeInt(row.totalTurns);
+  const explicitUserTurns = toNonNegativeInt(row.userTurns) ?? toNonNegativeInt(row.user) ?? toNonNegativeInt(row.userCount);
+  const explicitAssistantTurns = toNonNegativeInt(row.assistantTurns) ?? toNonNegativeInt(row.assistant) ?? toNonNegativeInt(row.assistantCount);
+  let turnCount = explicitTurnCount ?? 0;
+  let userTurns = explicitUserTurns ?? 0;
+  let assistantTurns = explicitAssistantTurns ?? 0;
+  if (turnCount === 0 && userTurns === 0 && assistantTurns === 0 && role) {
+    turnCount = 1;
+    if (role === "user") userTurns = 1;
+    if (role === "assistant") assistantTurns = 1;
+  }
+  if (turnCount === 0 && (userTurns > 0 || assistantTurns > 0)) {
+    turnCount = userTurns + assistantTurns;
+  }
+  if (turnCount < userTurns + assistantTurns) {
+    turnCount = userTurns + assistantTurns;
+  }
+  if (turnCount === 0) return null;
+  return { turnCount, userTurns, assistantTurns };
+}
+async function listLegacyObservationFiles(root) {
+  let entries;
+  try {
+    entries = await readdir(root, { withFileTypes: true });
+  } catch (err) {
+    const code = err.code;
+    if (code && code === "ENOENT") return [];
+    throw err;
+  }
+  const files = entries.filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl")).map((entry) => entry.name).filter((name) => name !== "rebuilt-observations.jsonl").sort((a, b) => a.localeCompare(b));
+  return files;
+}
+async function migrateObservations(options) {
+  const dryRun = options.dryRun !== false;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const ledgerRoot = path.join(options.memoryDir, "state", "observation-ledger");
+  const outputPath = path.join(ledgerRoot, "rebuilt-observations.jsonl");
+  const legacyFiles = await listLegacyObservationFiles(ledgerRoot);
+  const sourceRelativePaths = legacyFiles.map((name) => path.join("state", "observation-ledger", name));
+  const byKey = /* @__PURE__ */ new Map();
+  let parsedRows = 0;
+  let malformedLines = 0;
+  for (const file of legacyFiles) {
+    const full = path.join(ledgerRoot, file);
+    const raw = await readFile(full, "utf-8");
+    for (const line of raw.split("\n")) {
+      if (!line.trim()) continue;
+      let parsed;
+      try {
+        const candidate = JSON.parse(line);
+        if (candidate == null || typeof candidate !== "object" || Array.isArray(candidate)) {
+          malformedLines += 1;
+          continue;
+        }
+        parsed = candidate;
+      } catch {
+        malformedLines += 1;
+        continue;
+      }
+      const sessionKey = toSessionKey(parsed);
+      const hour = toLegacyHour(parsed);
+      const counts = toCounts(parsed);
+      if (!sessionKey || !hour || !counts) {
+        malformedLines += 1;
+        continue;
+      }
+      const key = `${sessionKey}\0${hour}`;
+      const existing = byKey.get(key) ?? {
+        sessionKey,
+        hour,
+        turnCount: 0,
+        userTurns: 0,
+        assistantTurns: 0
+      };
+      existing.turnCount += counts.turnCount;
+      existing.userTurns += counts.userTurns;
+      existing.assistantTurns += counts.assistantTurns;
+      if (existing.turnCount < existing.userTurns + existing.assistantTurns) {
+        existing.turnCount = existing.userTurns + existing.assistantTurns;
+      }
+      byKey.set(key, existing);
+      parsedRows += 1;
+    }
+  }
+  const aggregates = Array.from(byKey.values()).sort((a, b) => {
+    if (a.sessionKey !== b.sessionKey) return a.sessionKey.localeCompare(b.sessionKey);
+    return a.hour.localeCompare(b.hour);
+  });
+  if (!dryRun && legacyFiles.length === 0) {
+    return {
+      dryRun,
+      scannedFiles: legacyFiles.length,
+      parsedRows,
+      malformedLines,
+      migratedRows: aggregates.length,
+      outputPath,
+      sourceRelativePaths
+    };
+  }
+  let backupPath;
+  if (!dryRun) {
+    backupPath = await backupAndWriteRebuiltObservations({
+      memoryDir: options.memoryDir,
+      outputPath,
+      rows: aggregates,
+      now
+    });
+  }
+  return {
+    dryRun,
+    scannedFiles: legacyFiles.length,
+    parsedRows,
+    malformedLines,
+    migratedRows: aggregates.length,
+    outputPath,
+    backupPath,
+    sourceRelativePaths
+  };
+}
+
+export {
+  migrateObservations
+};
+//# sourceMappingURL=chunk-PK7H5L6Y.js.map

package/dist/chunk-PK7H5L6Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/migrate-observations.ts"],"sourcesContent":["import path from \"node:path\";\nimport { readdir, readFile } from \"node:fs/promises\";\nimport {\n  backupAndWriteRebuiltObservations,\n  toHourBucketIso,\n} from \"./observation-ledger-utils.js\";\n\ninterface CanonicalObservationRow {\n  sessionKey: string;\n  hour: string;\n  turnCount: number;\n  userTurns: number;\n  assistantTurns: number;\n}\n\ntype JsonRecord = Record<string, unknown>;\n\nexport interface MigrateObservationsOptions {\n  memoryDir: string;\n  dryRun?: boolean;\n  now?: Date;\n}\n\nexport interface MigrateObservationsResult {\n  dryRun: boolean;\n  scannedFiles: number;\n  parsedRows: number;\n  malformedLines: number;\n  migratedRows: number;\n  outputPath: string;\n  backupPath?: string;\n  sourceRelativePaths: string[];\n}\n\nfunction toNonNegativeInt(value: unknown): number | null {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return null;\n  const normalized = Math.floor(value);\n  if (normalized < 0) return null;\n  return normalized;\n}\n\nfunction toHourIso(value: unknown): string | null {\n  if (typeof value !== \"string\" || value.length === 0) return null;\n  return toHourBucketIso(value);\n}\n\nfunction toSessionKey(row: JsonRecord): string | null {\n  const candidates = [row.sessionKey, row.session, row.session_id, row.sessionId];\n  for (const candidate of candidates) {\n    if (typeof candidate === \"string\" && candidate.length > 0) return candidate;\n  }\n  return null;\n}\n\nfunction toLegacyHour(row: JsonRecord): string | null {\n  const candidates = [row.hour, row.hourStart, row.timestamp, row.time];\n  for (const candidate of candidates) {\n    const hour = toHourIso(candidate);\n    if (hour) return hour;\n  }\n  return null;\n}\n\nfunction toCounts(row: JsonRecord): { turnCount: number; userTurns: number; assistantTurns: number } | null {\n  const role = row.role === \"user\" || row.role === \"assistant\" ? row.role : null;\n  const explicitTurnCount =\n    toNonNegativeInt(row.turnCount) ??\n    toNonNegativeInt(row.turns) ??\n    toNonNegativeInt(row.totalTurns);\n  const explicitUserTurns =\n    toNonNegativeInt(row.userTurns) ??\n    toNonNegativeInt(row.user) ??\n    toNonNegativeInt(row.userCount);\n  const explicitAssistantTurns =\n    toNonNegativeInt(row.assistantTurns) ??\n    toNonNegativeInt(row.assistant) ??\n    toNonNegativeInt(row.assistantCount);\n\n  let turnCount = explicitTurnCount ?? 0;\n  let userTurns = explicitUserTurns ?? 0;\n  let assistantTurns = explicitAssistantTurns ?? 0;\n\n  if (turnCount === 0 && userTurns === 0 && assistantTurns === 0 && role) {\n    turnCount = 1;\n    if (role === \"user\") userTurns = 1;\n    if (role === \"assistant\") assistantTurns = 1;\n  }\n\n  if (turnCount === 0 && (userTurns > 0 || assistantTurns > 0)) {\n    turnCount = userTurns + assistantTurns;\n  }\n  if (turnCount < userTurns + assistantTurns) {\n    turnCount = userTurns + assistantTurns;\n  }\n  if (turnCount === 0) return null;\n  return { turnCount, userTurns, assistantTurns };\n}\n\nasync function listLegacyObservationFiles(root: string): Promise<string[]> {\n  let entries: Array<{ name: string; isFile(): boolean }>;\n  try {\n    entries = (await readdir(root, { withFileTypes: true })) as Array<{\n      name: string;\n      isFile(): boolean;\n    }>;\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    if (code && code === \"ENOENT\") return [];\n    throw err;\n  }\n\n  const files = entries\n    .filter((entry) => entry.isFile() && entry.name.endsWith(\".jsonl\"))\n    .map((entry) => entry.name)\n    .filter((name) => name !== \"rebuilt-observations.jsonl\")\n    .sort((a, b) => a.localeCompare(b));\n  return files;\n}\n\nexport async function migrateObservations(\n  options: MigrateObservationsOptions,\n): Promise<MigrateObservationsResult> {\n  const dryRun = options.dryRun !== false;\n  const now = options.now ?? new Date();\n  const ledgerRoot = path.join(options.memoryDir, \"state\", \"observation-ledger\");\n  const outputPath = path.join(ledgerRoot, \"rebuilt-observations.jsonl\");\n  const legacyFiles = await listLegacyObservationFiles(ledgerRoot);\n  const sourceRelativePaths = legacyFiles.map((name) => path.join(\"state\", \"observation-ledger\", name));\n\n  const byKey = new Map<string, CanonicalObservationRow>();\n  let parsedRows = 0;\n  let malformedLines = 0;\n\n  for (const file of legacyFiles) {\n    const full = path.join(ledgerRoot, file);\n    const raw = await readFile(full, \"utf-8\");\n    for (const line of raw.split(\"\\n\")) {\n      if (!line.trim()) continue;\n      let parsed: JsonRecord;\n      try {\n        const candidate = JSON.parse(line);\n        if (candidate == null || typeof candidate !== \"object\" || Array.isArray(candidate)) {\n          malformedLines += 1;\n          continue;\n        }\n        parsed = candidate as JsonRecord;\n      } catch {\n        malformedLines += 1;\n        continue;\n      }\n\n      const sessionKey = toSessionKey(parsed);\n      const hour = toLegacyHour(parsed);\n      const counts = toCounts(parsed);\n      if (!sessionKey || !hour || !counts) {\n        malformedLines += 1;\n        continue;\n      }\n\n      const key = `${sessionKey}\\u0000${hour}`;\n      const existing = byKey.get(key) ?? {\n        sessionKey,\n        hour,\n        turnCount: 0,\n        userTurns: 0,\n        assistantTurns: 0,\n      };\n      existing.turnCount += counts.turnCount;\n      existing.userTurns += counts.userTurns;\n      existing.assistantTurns += counts.assistantTurns;\n      if (existing.turnCount < existing.userTurns + existing.assistantTurns) {\n        existing.turnCount = existing.userTurns + existing.assistantTurns;\n      }\n      byKey.set(key, existing);\n      parsedRows += 1;\n    }\n  }\n\n  const aggregates = Array.from(byKey.values()).sort((a, b) => {\n    if (a.sessionKey !== b.sessionKey) return a.sessionKey.localeCompare(b.sessionKey);\n    return a.hour.localeCompare(b.hour);\n  });\n\n  if (!dryRun && legacyFiles.length === 0) {\n    return {\n      dryRun,\n      scannedFiles: legacyFiles.length,\n      parsedRows,\n      malformedLines,\n      migratedRows: aggregates.length,\n      outputPath,\n      sourceRelativePaths,\n    };\n  }\n\n  let backupPath: string | undefined;\n  if (!dryRun) {\n    backupPath = await backupAndWriteRebuiltObservations({\n      memoryDir: options.memoryDir,\n      outputPath,\n      rows: aggregates,\n      now,\n    });\n  }\n\n  return {\n    dryRun,\n    scannedFiles: legacyFiles.length,\n    parsedRows,\n    malformedLines,\n    migratedRows: aggregates.length,\n    outputPath,\n    backupPath,\n    sourceRelativePaths,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PR5FBTFU.js

@@ -0,0 +1,233 @@
+import {
+  failOpenFaissHealth
+} from "./chunk-FJ43PRLT.js";
+import {
+  rebuildConversationChunksFailOpen,
+  upsertConversationChunksFailOpen
+} from "./chunk-LLQ2LLWF.js";
+import {
+  searchConversationIndex,
+  searchConversationIndexFaissFailOpen
+} from "./chunk-7DTASS5T.js";
+
+// src/conversation-index/backend.ts
+function createConversationIndexBackend(options) {
+  if (!options.enabled) return void 0;
+  const getQmd = options.getQmd ?? (() => options.qmd);
+  const getFaiss = options.getFaiss ?? (() => options.faiss);
+  if (options.backend === "faiss") {
+    return createFaissBackend(getFaiss);
+  }
+  return createQmdBackend(getQmd, options.collectionDir);
+}
+function createQmdBackend(getQmd, collectionDir) {
+  return {
+    kind: "qmd",
+    async initialize() {
+      const qmd = getQmd();
+      if (!qmd) {
+        return {
+          enabled: true,
+          logLevel: "warn",
+          message: "Conversation index QMD: not available search backend disabled or unsupported"
+        };
+      }
+      const available = await qmd.probe();
+      if (!available) {
+        return {
+          enabled: true,
+          logLevel: "warn",
+          message: `Conversation index QMD: not available ${qmd.debugStatus()}`
+        };
+      }
+      const collectionState = await qmd.ensureCollection(collectionDir);
+      if (collectionState === "missing") {
+        return {
+          enabled: false,
+          logLevel: "warn",
+          message: "Conversation index collection missing; disabling conversation semantic recall for this runtime"
+        };
+      }
+      if (collectionState === "unknown") {
+        return {
+          enabled: true,
+          logLevel: "warn",
+          message: "Conversation index collection check unavailable; keeping conversation semantic recall enabled for fail-open behavior"
+        };
+      }
+      if (collectionState === "skipped") {
+        return {
+          enabled: true,
+          logLevel: "debug",
+          message: "Conversation index collection check skipped in daemon-only mode"
+        };
+      }
+      return {
+        enabled: true,
+        logLevel: "info",
+        message: `Conversation index QMD: available ${qmd.debugStatus()}`
+      };
+    },
+    async search(query, maxResults) {
+      const qmd = getQmd();
+      if (!qmd || !qmd.isAvailable()) return [];
+      return searchConversationIndex(qmd, query, maxResults);
+    },
+    async update(_chunks, options) {
+      const qmd = getQmd();
+      if (!qmd || !qmd.isAvailable()) return { embedded: false };
+      await qmd.update();
+      if (options.embed) {
+        await qmd.embed();
+        return { embedded: true };
+      }
+      return { embedded: false };
+    },
+    async rebuild(_chunks, options) {
+      const qmd = getQmd();
+      if (!qmd || !qmd.isAvailable()) return { embedded: false, rebuilt: false };
+      await qmd.update();
+      if (options.embed) {
+        await qmd.embed();
+        return { embedded: true, rebuilt: true };
+      }
+      return { embedded: false, rebuilt: true };
+    },
+    async health() {
+      const qmd = getQmd();
+      let qmdAvailable = !!qmd?.isAvailable();
+      if (!qmdAvailable && qmd) {
+        try {
+          qmdAvailable = await qmd.probe();
+        } catch {
+          qmdAvailable = false;
+        }
+      }
+      return {
+        backend: "qmd",
+        status: qmdAvailable ? "ok" : "degraded",
+        qmdAvailable
+      };
+    },
+    async inspect() {
+      const qmd = getQmd();
+      let qmdAvailable = !!qmd?.isAvailable();
+      if (!qmdAvailable && qmd) {
+        try {
+          qmdAvailable = await qmd.probe();
+        } catch {
+          qmdAvailable = false;
+        }
+      }
+      return {
+        backend: "qmd",
+        status: qmdAvailable ? "ok" : "degraded",
+        available: qmdAvailable,
+        indexPath: collectionDir,
+        supportsIncrementalUpdate: true,
+        message: qmd ? void 0 : "Conversation index QMD runtime unavailable",
+        metadata: {
+          chunkCount: null,
+          qmdAvailable,
+          debugStatus: qmd?.debugStatus()
+        }
+      };
+    }
+  };
+}
+function createFaissBackend(getFaiss) {
+  return {
+    kind: "faiss",
+    async initialize() {
+      const health = await failOpenFaissHealth(getFaiss());
+      return health.status === "ok" ? {
+        enabled: true,
+        logLevel: "info",
+        message: `Conversation index FAISS: available (status=${health.status})`
+      } : {
+        enabled: true,
+        logLevel: "warn",
+        message: `Conversation index FAISS: degraded (${health.message ?? health.status})`
+      };
+    },
+    async search(query, maxResults) {
+      return searchConversationIndexFaissFailOpen(getFaiss(), query, maxResults);
+    },
+    async update(chunks, _options) {
+      await upsertConversationChunksFailOpen(getFaiss(), chunks);
+      return { embedded: false };
+    },
+    async rebuild(chunks, _options) {
+      const result = await rebuildConversationChunksFailOpen(getFaiss(), chunks);
+      return { embedded: false, rebuilt: result.skipped !== true };
+    },
+    async health() {
+      const faiss = await failOpenFaissHealth(getFaiss());
+      return {
+        backend: "faiss",
+        status: faiss.status === "ok" ? "ok" : "degraded",
+        message: faiss.message,
+        faiss
+      };
+    },
+    async inspect() {
+      const adapter = getFaiss();
+      if (!adapter) {
+        return {
+          backend: "faiss",
+          status: "degraded",
+          available: false,
+          indexPath: "",
+          supportsIncrementalUpdate: true,
+          message: "Conversation index FAISS runtime unavailable",
+          metadata: {
+            chunkCount: 0,
+            hasIndex: false,
+            hasMetadata: false,
+            hasManifest: false
+          }
+        };
+      }
+      try {
+        const inspection = await adapter.inspect();
+        return {
+          backend: "faiss",
+          status: inspection.status === "ok" ? "ok" : "degraded",
+          available: inspection.status === "ok",
+          indexPath: inspection.indexPath,
+          supportsIncrementalUpdate: true,
+          message: inspection.message,
+          metadata: {
+            chunkCount: inspection.metadata.chunkCount,
+            hasIndex: inspection.metadata.hasIndex,
+            hasMetadata: inspection.metadata.hasMetadata,
+            hasManifest: inspection.metadata.hasManifest,
+            manifest: inspection.manifest
+          }
+        };
+      } catch (err) {
+        const fallback = await failOpenFaissHealth(adapter);
+        return {
+          backend: "faiss",
+          status: "degraded",
+          available: false,
+          indexPath: fallback.indexPath,
+          supportsIncrementalUpdate: true,
+          message: fallback.message ?? String(err),
+          metadata: {
+            chunkCount: fallback.manifest?.chunkCount ?? 0,
+            hasIndex: false,
+            hasMetadata: false,
+            hasManifest: !!fallback.manifest,
+            manifest: fallback.manifest
+          }
+        };
+      }
+    }
+  };
+}
+
+export {
+  createConversationIndexBackend
+};
+//# sourceMappingURL=chunk-PR5FBTFU.js.map

package/dist/chunk-PR5FBTFU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/conversation-index/backend.ts"],"sourcesContent":["import type { SearchBackend, SearchExecutionOptions } from \"../search/port.js\";\nimport type { ConversationChunk } from \"./chunker.js\";\nimport { failOpenFaissHealth, type FaissConversationIndexAdapter } from \"./faiss-adapter.js\";\nimport {\n  rebuildConversationChunksFailOpen,\n  upsertConversationChunksFailOpen,\n} from \"./indexer.js\";\nimport { searchConversationIndex, searchConversationIndexFaissFailOpen, type ConversationSearchResult } from \"./search.js\";\n\ntype CollectionState = \"missing\" | \"unknown\" | \"present\" | \"skipped\";\n\nexport interface ConversationQmdRuntime extends SearchBackend {\n  isAvailable(): boolean;\n  probe(): Promise<boolean>;\n  ensureCollection(baseDir: string): Promise<CollectionState>;\n  update(execution?: SearchExecutionOptions): Promise<void>;\n  updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  embed(): Promise<void>;\n  debugStatus(): string;\n}\n\nexport interface ConversationIndexBackendHealth {\n  backend: \"qmd\" | \"faiss\";\n  status: \"ok\" | \"degraded\" | \"disabled\";\n  message?: string;\n  qmdAvailable?: boolean;\n  faiss?: {\n    ok: boolean;\n    status: \"ok\" | \"degraded\" | \"error\";\n    indexPath: string;\n    message?: string;\n    manifest?: {\n      version: number;\n      modelId: string;\n      normalizedModelId: string;\n      dimension: number;\n      chunkCount: number;\n      updatedAt: string;\n      lastSuccessfulRebuildAt: string;\n    };\n  };\n}\n\nexport interface ConversationIndexBackendInspection {\n  backend: \"qmd\" | \"faiss\";\n  status: \"ok\" | \"degraded\" | \"disabled\";\n  available: boolean;\n  indexPath: string;\n  supportsIncrementalUpdate: boolean;\n  message?: string;\n  metadata: {\n    chunkCount: number | null;\n    qmdAvailable?: boolean;\n    debugStatus?: string;\n    hasIndex?: boolean;\n    hasMetadata?: boolean;\n    hasManifest?: boolean;\n    manifest?: {\n      version: number;\n      modelId: string;\n      normalizedModelId: string;\n      dimension: number;\n      chunkCount: number;\n      updatedAt: string;\n      lastSuccessfulRebuildAt: string;\n    };\n  };\n}\n\nexport interface ConversationIndexBackendInitResult {\n  enabled: boolean;\n  logLevel: \"info\" | \"warn\" | \"debug\";\n  message: string;\n}\n\nexport interface ConversationIndexBackend {\n  readonly kind: \"qmd\" | \"faiss\";\n  initialize(): Promise<ConversationIndexBackendInitResult>;\n  search(query: string, maxResults: number): Promise<ConversationSearchResult[]>;\n  update(chunks: ConversationChunk[], options: { embed: boolean }): Promise<{ embedded: boolean }>;\n  rebuild(chunks: ConversationChunk[], options: { embed: boolean }): Promise<{ embedded: boolean; rebuilt: boolean }>;\n  health(): Promise<ConversationIndexBackendHealth>;\n  inspect(): Promise<ConversationIndexBackendInspection>;\n}\n\nexport function createConversationIndexBackend(options: {\n  enabled: boolean;\n  backend: \"qmd\" | \"faiss\";\n  getQmd?: () => ConversationQmdRuntime | undefined;\n  getFaiss?: () => FaissConversationIndexAdapter | undefined;\n  qmd?: ConversationQmdRuntime;\n  faiss?: FaissConversationIndexAdapter;\n  collectionDir: string;\n}): ConversationIndexBackend | undefined {\n  if (!options.enabled) return undefined;\n  const getQmd = options.getQmd ?? (() => options.qmd);\n  const getFaiss = options.getFaiss ?? (() => options.faiss);\n  if (options.backend === \"faiss\") {\n    return createFaissBackend(getFaiss);\n  }\n  return createQmdBackend(getQmd, options.collectionDir);\n}\n\nfunction createQmdBackend(\n  getQmd: () => ConversationQmdRuntime | undefined,\n  collectionDir: string,\n): ConversationIndexBackend {\n  return {\n    kind: \"qmd\",\n    async initialize() {\n      const qmd = getQmd();\n      if (!qmd) {\n        return {\n          enabled: true,\n          logLevel: \"warn\",\n          message: \"Conversation index QMD: not available search backend disabled or unsupported\",\n        };\n      }\n\n      const available = await qmd.probe();\n      if (!available) {\n        return {\n          enabled: true,\n          logLevel: \"warn\",\n          message: `Conversation index QMD: not available ${qmd.debugStatus()}`,\n        };\n      }\n\n      const collectionState = await qmd.ensureCollection(collectionDir);\n      if (collectionState === \"missing\") {\n        return {\n          enabled: false,\n          logLevel: \"warn\",\n          message: \"Conversation index collection missing; disabling conversation semantic recall for this runtime\",\n        };\n      }\n      if (collectionState === \"unknown\") {\n        return {\n          enabled: true,\n          logLevel: \"warn\",\n          message: \"Conversation index collection check unavailable; keeping conversation semantic recall enabled for fail-open behavior\",\n        };\n      }\n      if (collectionState === \"skipped\") {\n        return {\n          enabled: true,\n          logLevel: \"debug\",\n          message: \"Conversation index collection check skipped in daemon-only mode\",\n        };\n      }\n\n      return {\n        enabled: true,\n        logLevel: \"info\",\n        message: `Conversation index QMD: available ${qmd.debugStatus()}`,\n      };\n    },\n    async search(query: string, maxResults: number) {\n      const qmd = getQmd();\n      if (!qmd || !qmd.isAvailable()) return [];\n      return searchConversationIndex(qmd, query, maxResults);\n    },\n    async update(_chunks: ConversationChunk[], options: { embed: boolean }) {\n      const qmd = getQmd();\n      if (!qmd || !qmd.isAvailable()) return { embedded: false };\n      await qmd.update();\n      if (options.embed) {\n        await qmd.embed();\n        return { embedded: true };\n      }\n      return { embedded: false };\n    },\n    async rebuild(_chunks: ConversationChunk[], options: { embed: boolean }) {\n      const qmd = getQmd();\n      if (!qmd || !qmd.isAvailable()) return { embedded: false, rebuilt: false };\n      await qmd.update();\n      if (options.embed) {\n        await qmd.embed();\n        return { embedded: true, rebuilt: true };\n      }\n      return { embedded: false, rebuilt: true };\n    },\n    async health() {\n      const qmd = getQmd();\n      let qmdAvailable = !!qmd?.isAvailable();\n      if (!qmdAvailable && qmd) {\n        try {\n          qmdAvailable = await qmd.probe();\n        } catch {\n          qmdAvailable = false;\n        }\n      }\n\n      return {\n        backend: \"qmd\",\n        status: qmdAvailable ? \"ok\" : \"degraded\",\n        qmdAvailable,\n      };\n    },\n    async inspect() {\n      const qmd = getQmd();\n      let qmdAvailable = !!qmd?.isAvailable();\n      if (!qmdAvailable && qmd) {\n        try {\n          qmdAvailable = await qmd.probe();\n        } catch {\n          qmdAvailable = false;\n        }\n      }\n\n      return {\n        backend: \"qmd\",\n        status: qmdAvailable ? \"ok\" : \"degraded\",\n        available: qmdAvailable,\n        indexPath: collectionDir,\n        supportsIncrementalUpdate: true,\n        message: qmd ? undefined : \"Conversation index QMD runtime unavailable\",\n        metadata: {\n          chunkCount: null,\n          qmdAvailable,\n          debugStatus: qmd?.debugStatus(),\n        },\n      };\n    },\n  };\n}\n\nfunction createFaissBackend(\n  getFaiss: () => FaissConversationIndexAdapter | undefined,\n): ConversationIndexBackend {\n  return {\n    kind: \"faiss\",\n    async initialize() {\n      const health = await failOpenFaissHealth(getFaiss());\n      return health.status === \"ok\"\n        ? {\n            enabled: true,\n            logLevel: \"info\",\n            message: `Conversation index FAISS: available (status=${health.status})`,\n          }\n        : {\n            enabled: true,\n            logLevel: \"warn\",\n            message: `Conversation index FAISS: degraded (${health.message ?? health.status})`,\n          };\n    },\n    async search(query: string, maxResults: number) {\n      return searchConversationIndexFaissFailOpen(getFaiss(), query, maxResults);\n    },\n    async update(chunks: ConversationChunk[], _options: { embed: boolean }) {\n      await upsertConversationChunksFailOpen(getFaiss(), chunks);\n      return { embedded: false };\n    },\n    async rebuild(chunks: ConversationChunk[], _options: { embed: boolean }) {\n      const result = await rebuildConversationChunksFailOpen(getFaiss(), chunks);\n      return { embedded: false, rebuilt: result.skipped !== true };\n    },\n    async health() {\n      const faiss = await failOpenFaissHealth(getFaiss());\n      return {\n        backend: \"faiss\",\n        status: faiss.status === \"ok\" ? \"ok\" : \"degraded\",\n        message: faiss.message,\n        faiss,\n      };\n    },\n    async inspect() {\n      const adapter = getFaiss();\n      if (!adapter) {\n        return {\n          backend: \"faiss\",\n          status: \"degraded\",\n          available: false,\n          indexPath: \"\",\n          supportsIncrementalUpdate: true,\n          message: \"Conversation index FAISS runtime unavailable\",\n          metadata: {\n            chunkCount: 0,\n            hasIndex: false,\n            hasMetadata: false,\n            hasManifest: false,\n          },\n        };\n      }\n\n      try {\n        const inspection = await adapter.inspect();\n        return {\n          backend: \"faiss\",\n          status: inspection.status === \"ok\" ? \"ok\" : \"degraded\",\n          available: inspection.status === \"ok\",\n          indexPath: inspection.indexPath,\n          supportsIncrementalUpdate: true,\n          message: inspection.message,\n          metadata: {\n            chunkCount: inspection.metadata.chunkCount,\n            hasIndex: inspection.metadata.hasIndex,\n            hasMetadata: inspection.metadata.hasMetadata,\n            hasManifest: inspection.metadata.hasManifest,\n            manifest: inspection.manifest,\n          },\n        };\n      } catch (err) {\n        const fallback = await failOpenFaissHealth(adapter);\n        return {\n          backend: \"faiss\",\n          status: \"degraded\",\n          available: false,\n          indexPath: fallback.indexPath,\n          supportsIncrementalUpdate: true,\n          message: fallback.message ?? String(err),\n          metadata: {\n            chunkCount: fallback.manifest?.chunkCount ?? 0,\n            hasIndex: false,\n            hasMetadata: false,\n            hasManifest: !!fallback.manifest,\n            manifest: fallback.manifest,\n          },\n        };\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}