@remnic/core 1.0.0

package/dist/chunk-FYIYMQ5N.js

@@ -0,0 +1,221 @@
+import {
+  assertIsoRecordedAt,
+  assertSafePathSegment,
+  assertString,
+  isRecord,
+  optionalString,
+  optionalStringArray,
+  recordStoreDay,
+  validateStringRecord
+} from "./chunk-DGXUHMOV.js";
+import {
+  listJsonFiles,
+  readJsonFile
+} from "./chunk-LPSF4OQH.js";
+
+// src/commitment-ledger.ts
+import path from "path";
+import { mkdir, unlink, writeFile } from "fs/promises";
+function resolveCommitmentLedgerDir(memoryDir, overrideDir) {
+  if (typeof overrideDir === "string" && overrideDir.trim().length > 0) {
+    return overrideDir.trim();
+  }
+  return path.join(memoryDir, "state", "commitment-ledger");
+}
+function validateCommitmentLedgerEntry(raw) {
+  if (!isRecord(raw)) throw new Error("commitment ledger entry must be an object");
+  if (raw.schemaVersion !== 1) throw new Error("schemaVersion must be 1");
+  const source = assertString(raw.source, "source");
+  if (!["tool_result", "cli", "system", "manual"].includes(source)) {
+    throw new Error("source must be one of tool_result|cli|system|manual");
+  }
+  const kind = assertString(raw.kind, "kind");
+  if (!["promise", "follow_up", "deadline", "deliverable"].includes(kind)) {
+    throw new Error("kind must be one of promise|follow_up|deadline|deliverable");
+  }
+  const state = assertString(raw.state, "state");
+  if (!["open", "fulfilled", "cancelled", "expired"].includes(state)) {
+    throw new Error("state must be one of open|fulfilled|cancelled|expired");
+  }
+  const dueAt = optionalString(raw.dueAt);
+  if (dueAt !== void 0) {
+    assertIsoRecordedAt(dueAt, "dueAt");
+  }
+  const stateChangedAt = optionalString(raw.stateChangedAt);
+  if (stateChangedAt !== void 0) {
+    assertIsoRecordedAt(stateChangedAt, "stateChangedAt");
+  }
+  const resolvedAt = optionalString(raw.resolvedAt);
+  if (resolvedAt !== void 0) {
+    assertIsoRecordedAt(resolvedAt, "resolvedAt");
+  }
+  const normalizedStateChangedAt = stateChangedAt ?? (state === "open" ? void 0 : assertString(raw.recordedAt, "recordedAt"));
+  const normalizedResolvedAt = resolvedAt ?? (state === "open" ? void 0 : normalizedStateChangedAt);
+  return {
+    schemaVersion: 1,
+    entryId: assertSafePathSegment(assertString(raw.entryId, "entryId"), "entryId"),
+    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, "recordedAt")),
+    sessionKey: assertString(raw.sessionKey, "sessionKey"),
+    source,
+    kind,
+    state,
+    scope: assertString(raw.scope, "scope"),
+    summary: assertString(raw.summary, "summary"),
+    dueAt,
+    entityRefs: optionalStringArray(raw.entityRefs, "entityRefs"),
+    workProductEntryRefs: optionalStringArray(raw.workProductEntryRefs, "workProductEntryRefs"),
+    objectiveStateSnapshotRefs: optionalStringArray(raw.objectiveStateSnapshotRefs, "objectiveStateSnapshotRefs"),
+    tags: optionalStringArray(raw.tags, "tags"),
+    metadata: validateStringRecord(raw.metadata, "metadata"),
+    stateChangedAt: normalizedStateChangedAt,
+    resolvedAt: normalizedResolvedAt
+  };
+}
+async function recordCommitmentLedgerEntry(options) {
+  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);
+  const validated = validateCommitmentLedgerEntry(options.entry);
+  const day = recordStoreDay(validated.recordedAt);
+  const entriesDir = path.join(rootDir, "entries", day);
+  const filePath = path.join(entriesDir, `${validated.entryId}.json`);
+  await mkdir(entriesDir, { recursive: true });
+  await writeFile(filePath, JSON.stringify(validated, null, 2), "utf8");
+  return filePath;
+}
+async function readCommitmentLedgerEntries(options) {
+  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);
+  const files = await listJsonFiles(path.join(rootDir, "entries"));
+  const entries = [];
+  const entryFiles = [];
+  const invalidEntries = [];
+  for (const filePath of files) {
+    try {
+      const entry = validateCommitmentLedgerEntry(await readJsonFile(filePath));
+      entries.push(entry);
+      entryFiles.push({ entry, filePath });
+    } catch (error) {
+      invalidEntries.push({
+        path: filePath,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return { files, entries, entryFiles, invalidEntries };
+}
+function isResolvedState(state) {
+  return state === "fulfilled" || state === "cancelled" || state === "expired";
+}
+function isOverdueOpenEntry(entry, nowMs) {
+  return entry.state === "open" && typeof entry.dueAt === "string" && Date.parse(entry.dueAt) < nowMs;
+}
+function isStaleOpenEntry(entry, nowMs, staleDays) {
+  if (entry.state !== "open") return false;
+  if (typeof entry.dueAt === "string") return false;
+  const staleCutoff = nowMs - staleDays * 24 * 60 * 60 * 1e3;
+  return Date.parse(entry.recordedAt) < staleCutoff;
+}
+function isDecayEligibleResolvedEntry(entry, nowMs, decayDays) {
+  if (!isResolvedState(entry.state)) return false;
+  const reference = entry.resolvedAt ?? entry.stateChangedAt ?? entry.recordedAt;
+  const decayCutoff = nowMs - decayDays * 24 * 60 * 60 * 1e3;
+  return Date.parse(reference) < decayCutoff;
+}
+async function findCommitmentLedgerEntryById(options) {
+  const { entryFiles } = await readCommitmentLedgerEntries(options);
+  for (const candidate of entryFiles) {
+    if (candidate.entry.entryId === options.entryId || path.basename(candidate.filePath, ".json") === options.entryId) {
+      return candidate;
+    }
+  }
+  return null;
+}
+async function transitionCommitmentLedgerEntryState(options) {
+  const match = await findCommitmentLedgerEntryById(options);
+  if (!match) {
+    throw new Error(`commitment entry not found: ${options.entryId}`);
+  }
+  const changedAt = assertIsoRecordedAt(options.changedAt, "changedAt");
+  const nextState = options.nextState;
+  const nextEntry = {
+    ...match.entry,
+    state: nextState,
+    stateChangedAt: changedAt,
+    resolvedAt: isResolvedState(nextState) ? changedAt : void 0
+  };
+  await writeFile(match.filePath, JSON.stringify(validateCommitmentLedgerEntry(nextEntry), null, 2), "utf8");
+  return nextEntry;
+}
+async function applyCommitmentLedgerLifecycle(options) {
+  if (!options.enabled) {
+    return { transitionedToExpired: [], deletedResolved: [] };
+  }
+  const nowIso = assertIsoRecordedAt(options.now ?? (/* @__PURE__ */ new Date()).toISOString(), "now");
+  const nowMs = Date.parse(nowIso);
+  const { entryFiles } = await readCommitmentLedgerEntries(options);
+  const transitionedToExpired = [];
+  const deletedResolved = [];
+  for (const { entry, filePath } of entryFiles) {
+    if (isOverdueOpenEntry(entry, nowMs)) {
+      const updated = validateCommitmentLedgerEntry({
+        ...entry,
+        state: "expired",
+        stateChangedAt: nowIso,
+        resolvedAt: nowIso
+      });
+      await writeFile(filePath, JSON.stringify(updated, null, 2), "utf8");
+      transitionedToExpired.push(updated);
+      continue;
+    }
+    if (isDecayEligibleResolvedEntry(entry, nowMs, options.decayDays)) {
+      await unlink(filePath);
+      deletedResolved.push(entry);
+    }
+  }
+  return { transitionedToExpired, deletedResolved };
+}
+async function getCommitmentLedgerStatus(options) {
+  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);
+  const entriesDir = path.join(rootDir, "entries");
+  const { files, entries, invalidEntries } = await readCommitmentLedgerEntries(options);
+  entries.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));
+  const nowMs = Date.parse(assertIsoRecordedAt(options.now ?? (/* @__PURE__ */ new Date()).toISOString(), "now"));
+  const staleDays = Math.max(1, Math.floor(options.staleDays ?? 14));
+  const decayDays = Math.max(1, Math.floor(options.decayDays ?? 90));
+  const byKind = {};
+  const byState = {};
+  for (const entry of entries) {
+    byKind[entry.kind] = (byKind[entry.kind] ?? 0) + 1;
+    byState[entry.state] = (byState[entry.state] ?? 0) + 1;
+  }
+  return {
+    enabled: options.enabled,
+    rootDir,
+    entriesDir,
+    entries: {
+      total: files.length,
+      valid: entries.length,
+      invalid: invalidEntries.length,
+      byKind,
+      byState,
+      latestEntryId: entries[0]?.entryId,
+      latestRecordedAt: entries[0]?.recordedAt,
+      latestSessionKey: entries[0]?.sessionKey
+    },
+    latestEntry: entries[0],
+    invalidEntries,
+    lifecycle: options.lifecycleEnabled ? {
+      overdueOpen: entries.filter((entry) => isOverdueOpenEntry(entry, nowMs)).length,
+      staleOpen: entries.filter((entry) => isStaleOpenEntry(entry, nowMs, staleDays)).length,
+      decayEligibleResolved: entries.filter((entry) => isDecayEligibleResolvedEntry(entry, nowMs, decayDays)).length
+    } : void 0
+  };
+}
+
+export {
+  resolveCommitmentLedgerDir,
+  validateCommitmentLedgerEntry,
+  recordCommitmentLedgerEntry,
+  transitionCommitmentLedgerEntryState,
+  applyCommitmentLedgerLifecycle,
+  getCommitmentLedgerStatus
+};
+//# sourceMappingURL=chunk-FYIYMQ5N.js.map

package/dist/chunk-FYIYMQ5N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commitment-ledger.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, unlink, writeFile } from \"node:fs/promises\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport {\n  assertIsoRecordedAt,\n  assertSafePathSegment,\n  assertString,\n  isRecord,\n  optionalString,\n  optionalStringArray,\n  recordStoreDay,\n  validateStringRecord,\n} from \"./store-contract.js\";\n\nexport type CommitmentLedgerSource = \"tool_result\" | \"cli\" | \"system\" | \"manual\";\nexport type CommitmentLedgerKind = \"promise\" | \"follow_up\" | \"deadline\" | \"deliverable\";\nexport type CommitmentLedgerState = \"open\" | \"fulfilled\" | \"cancelled\" | \"expired\";\n\nexport interface CommitmentLedgerEntry {\n  schemaVersion: 1;\n  entryId: string;\n  recordedAt: string;\n  sessionKey: string;\n  source: CommitmentLedgerSource;\n  kind: CommitmentLedgerKind;\n  state: CommitmentLedgerState;\n  scope: string;\n  summary: string;\n  dueAt?: string;\n  entityRefs?: string[];\n  workProductEntryRefs?: string[];\n  objectiveStateSnapshotRefs?: string[];\n  tags?: string[];\n  metadata?: Record<string, string>;\n  stateChangedAt?: string;\n  resolvedAt?: string;\n}\n\nexport interface CommitmentLedgerStatus {\n  enabled: boolean;\n  rootDir: string;\n  entriesDir: string;\n  entries: {\n    total: number;\n    valid: number;\n    invalid: number;\n    byKind: Partial<Record<CommitmentLedgerKind, number>>;\n    byState: Partial<Record<CommitmentLedgerState, number>>;\n    latestEntryId?: string;\n    latestRecordedAt?: string;\n    latestSessionKey?: string;\n  };\n  latestEntry?: CommitmentLedgerEntry;\n  invalidEntries: Array<{\n    path: string;\n    error: string;\n  }>;\n  lifecycle?: {\n    staleOpen: number;\n    overdueOpen: number;\n    decayEligibleResolved: number;\n  };\n}\n\nexport interface CommitmentLedgerLifecycleResult {\n  transitionedToExpired: CommitmentLedgerEntry[];\n  deletedResolved: CommitmentLedgerEntry[];\n}\n\nexport function resolveCommitmentLedgerDir(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\", \"commitment-ledger\");\n}\n\nexport function validateCommitmentLedgerEntry(raw: unknown): CommitmentLedgerEntry {\n  if (!isRecord(raw)) throw new Error(\"commitment ledger entry 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 (![\"tool_result\", \"cli\", \"system\", \"manual\"].includes(source)) {\n    throw new Error(\"source must be one of tool_result|cli|system|manual\");\n  }\n\n  const kind = assertString(raw.kind, \"kind\");\n  if (![\"promise\", \"follow_up\", \"deadline\", \"deliverable\"].includes(kind)) {\n    throw new Error(\"kind must be one of promise|follow_up|deadline|deliverable\");\n  }\n\n  const state = assertString(raw.state, \"state\");\n  if (![\"open\", \"fulfilled\", \"cancelled\", \"expired\"].includes(state)) {\n    throw new Error(\"state must be one of open|fulfilled|cancelled|expired\");\n  }\n\n  const dueAt = optionalString(raw.dueAt);\n  if (dueAt !== undefined) {\n    assertIsoRecordedAt(dueAt, \"dueAt\");\n  }\n\n  const stateChangedAt = optionalString(raw.stateChangedAt);\n  if (stateChangedAt !== undefined) {\n    assertIsoRecordedAt(stateChangedAt, \"stateChangedAt\");\n  }\n\n  const resolvedAt = optionalString(raw.resolvedAt);\n  if (resolvedAt !== undefined) {\n    assertIsoRecordedAt(resolvedAt, \"resolvedAt\");\n  }\n\n  const normalizedStateChangedAt = stateChangedAt ?? (state === \"open\" ? undefined : assertString(raw.recordedAt, \"recordedAt\"));\n  const normalizedResolvedAt = resolvedAt ?? (state === \"open\" ? undefined : normalizedStateChangedAt);\n\n  return {\n    schemaVersion: 1,\n    entryId: assertSafePathSegment(assertString(raw.entryId, \"entryId\"), \"entryId\"),\n    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, \"recordedAt\")),\n    sessionKey: assertString(raw.sessionKey, \"sessionKey\"),\n    source: source as CommitmentLedgerSource,\n    kind: kind as CommitmentLedgerKind,\n    state: state as CommitmentLedgerState,\n    scope: assertString(raw.scope, \"scope\"),\n    summary: assertString(raw.summary, \"summary\"),\n    dueAt,\n    entityRefs: optionalStringArray(raw.entityRefs, \"entityRefs\"),\n    workProductEntryRefs: optionalStringArray(raw.workProductEntryRefs, \"workProductEntryRefs\"),\n    objectiveStateSnapshotRefs: optionalStringArray(raw.objectiveStateSnapshotRefs, \"objectiveStateSnapshotRefs\"),\n    tags: optionalStringArray(raw.tags, \"tags\"),\n    metadata: validateStringRecord(raw.metadata, \"metadata\"),\n    stateChangedAt: normalizedStateChangedAt,\n    resolvedAt: normalizedResolvedAt,\n  };\n}\n\nexport async function recordCommitmentLedgerEntry(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n  entry: CommitmentLedgerEntry;\n}): Promise<string> {\n  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);\n  const validated = validateCommitmentLedgerEntry(options.entry);\n  const day = recordStoreDay(validated.recordedAt);\n  const entriesDir = path.join(rootDir, \"entries\", day);\n  const filePath = path.join(entriesDir, `${validated.entryId}.json`);\n  await mkdir(entriesDir, { recursive: true });\n  await writeFile(filePath, JSON.stringify(validated, null, 2), \"utf8\");\n  return filePath;\n}\n\nasync function readCommitmentLedgerEntries(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n}): Promise<{\n  files: string[];\n  entries: CommitmentLedgerEntry[];\n  entryFiles: Array<{ entry: CommitmentLedgerEntry; filePath: string }>;\n  invalidEntries: Array<{ path: string; error: string }>;\n}> {\n  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);\n  const files = await listJsonFiles(path.join(rootDir, \"entries\"));\n  const entries: CommitmentLedgerEntry[] = [];\n  const entryFiles: Array<{ entry: CommitmentLedgerEntry; filePath: string }> = [];\n  const invalidEntries: Array<{ path: string; error: string }> = [];\n  for (const filePath of files) {\n    try {\n      const entry = validateCommitmentLedgerEntry(await readJsonFile(filePath));\n      entries.push(entry);\n      entryFiles.push({ entry, filePath });\n    } catch (error) {\n      invalidEntries.push({\n        path: filePath,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return { files, entries, entryFiles, invalidEntries };\n}\n\nfunction isResolvedState(state: CommitmentLedgerState): boolean {\n  return state === \"fulfilled\" || state === \"cancelled\" || state === \"expired\";\n}\n\nfunction isOverdueOpenEntry(entry: CommitmentLedgerEntry, nowMs: number): boolean {\n  return entry.state === \"open\" && typeof entry.dueAt === \"string\" && Date.parse(entry.dueAt) < nowMs;\n}\n\nfunction isStaleOpenEntry(entry: CommitmentLedgerEntry, nowMs: number, staleDays: number): boolean {\n  if (entry.state !== \"open\") return false;\n  if (typeof entry.dueAt === \"string\") return false;\n  const staleCutoff = nowMs - staleDays * 24 * 60 * 60 * 1000;\n  return Date.parse(entry.recordedAt) < staleCutoff;\n}\n\nfunction isDecayEligibleResolvedEntry(entry: CommitmentLedgerEntry, nowMs: number, decayDays: number): boolean {\n  if (!isResolvedState(entry.state)) return false;\n  const reference = entry.resolvedAt ?? entry.stateChangedAt ?? entry.recordedAt;\n  const decayCutoff = nowMs - decayDays * 24 * 60 * 60 * 1000;\n  return Date.parse(reference) < decayCutoff;\n}\n\nasync function findCommitmentLedgerEntryById(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n  entryId: string;\n}): Promise<{ entry: CommitmentLedgerEntry; filePath: string } | null> {\n  const { entryFiles } = await readCommitmentLedgerEntries(options);\n  for (const candidate of entryFiles) {\n    if (candidate.entry.entryId === options.entryId || path.basename(candidate.filePath, \".json\") === options.entryId) {\n      return candidate;\n    }\n  }\n  return null;\n}\n\nexport async function transitionCommitmentLedgerEntryState(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n  entryId: string;\n  nextState: CommitmentLedgerState;\n  changedAt: string;\n}): Promise<CommitmentLedgerEntry> {\n  const match = await findCommitmentLedgerEntryById(options);\n  if (!match) {\n    throw new Error(`commitment entry not found: ${options.entryId}`);\n  }\n\n  const changedAt = assertIsoRecordedAt(options.changedAt, \"changedAt\");\n  const nextState = options.nextState;\n  const nextEntry: CommitmentLedgerEntry = {\n    ...match.entry,\n    state: nextState,\n    stateChangedAt: changedAt,\n    resolvedAt: isResolvedState(nextState) ? changedAt : undefined,\n  };\n\n  await writeFile(match.filePath, JSON.stringify(validateCommitmentLedgerEntry(nextEntry), null, 2), \"utf8\");\n  return nextEntry;\n}\n\nexport async function applyCommitmentLedgerLifecycle(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n  enabled: boolean;\n  decayDays: number;\n  now?: string;\n}): Promise<CommitmentLedgerLifecycleResult> {\n  if (!options.enabled) {\n    return { transitionedToExpired: [], deletedResolved: [] };\n  }\n\n  const nowIso = assertIsoRecordedAt(options.now ?? new Date().toISOString(), \"now\");\n  const nowMs = Date.parse(nowIso);\n  const { entryFiles } = await readCommitmentLedgerEntries(options);\n\n  const transitionedToExpired: CommitmentLedgerEntry[] = [];\n  const deletedResolved: CommitmentLedgerEntry[] = [];\n\n  for (const { entry, filePath } of entryFiles) {\n\n    if (isOverdueOpenEntry(entry, nowMs)) {\n      const updated = validateCommitmentLedgerEntry({\n        ...entry,\n        state: \"expired\",\n        stateChangedAt: nowIso,\n        resolvedAt: nowIso,\n      });\n      await writeFile(filePath, JSON.stringify(updated, null, 2), \"utf8\");\n      transitionedToExpired.push(updated);\n      continue;\n    }\n\n    if (isDecayEligibleResolvedEntry(entry, nowMs, options.decayDays)) {\n      await unlink(filePath);\n      deletedResolved.push(entry);\n    }\n  }\n\n  return { transitionedToExpired, deletedResolved };\n}\n\nexport async function getCommitmentLedgerStatus(options: {\n  memoryDir: string;\n  commitmentLedgerDir?: string;\n  enabled: boolean;\n  lifecycleEnabled?: boolean;\n  staleDays?: number;\n  decayDays?: number;\n  now?: string;\n}): Promise<CommitmentLedgerStatus> {\n  const rootDir = resolveCommitmentLedgerDir(options.memoryDir, options.commitmentLedgerDir);\n  const entriesDir = path.join(rootDir, \"entries\");\n  const { files, entries, invalidEntries } = await readCommitmentLedgerEntries(options);\n  entries.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));\n  const nowMs = Date.parse(assertIsoRecordedAt(options.now ?? new Date().toISOString(), \"now\"));\n  const staleDays = Math.max(1, Math.floor(options.staleDays ?? 14));\n  const decayDays = Math.max(1, Math.floor(options.decayDays ?? 90));\n\n  const byKind: Partial<Record<CommitmentLedgerKind, number>> = {};\n  const byState: Partial<Record<CommitmentLedgerState, number>> = {};\n  for (const entry of entries) {\n    byKind[entry.kind] = (byKind[entry.kind] ?? 0) + 1;\n    byState[entry.state] = (byState[entry.state] ?? 0) + 1;\n  }\n\n  return {\n    enabled: options.enabled,\n    rootDir,\n    entriesDir,\n    entries: {\n      total: files.length,\n      valid: entries.length,\n      invalid: invalidEntries.length,\n      byKind,\n      byState,\n      latestEntryId: entries[0]?.entryId,\n      latestRecordedAt: entries[0]?.recordedAt,\n      latestSessionKey: entries[0]?.sessionKey,\n    },\n    latestEntry: entries[0],\n    invalidEntries,\n    lifecycle: options.lifecycleEnabled\n      ? {\n          overdueOpen: entries.filter((entry) => isOverdueOpenEntry(entry, nowMs)).length,\n          staleOpen: entries.filter((entry) => isStaleOpenEntry(entry, nowMs, staleDays)).length,\n          decayEligibleResolved: entries.filter((entry) => isDecayEligibleResolvedEntry(entry, nowMs, decayDays)).length,\n        }\n      : undefined,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-G3AG3KZN.js

@@ -0,0 +1,78 @@
+import {
+  clamp01
+} from "./chunk-QCCCQT3O.js";
+
+// src/retrieval.ts
+var DEFAULT_STOPWORDS = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "and",
+  "are",
+  "as",
+  "at",
+  "be",
+  "but",
+  "by",
+  "for",
+  "from",
+  "has",
+  "have",
+  "i",
+  "in",
+  "is",
+  "it",
+  "of",
+  "on",
+  "or",
+  "that",
+  "the",
+  "this",
+  "to",
+  "was",
+  "were",
+  "with"
+]);
+function tokenize(query, minTokenLen) {
+  return query.toLowerCase().split(/[^a-z0-9]+/g).map((t) => t.trim()).filter((t) => t.length >= minTokenLen).filter((t) => !DEFAULT_STOPWORDS.has(t));
+}
+function applyRuntimeRetrievalPolicy(base, runtime) {
+  const fromRuntime = runtime?.recencyWeight;
+  if (typeof fromRuntime !== "number") {
+    return { recencyWeight: clamp01(base.recencyWeight) };
+  }
+  return { recencyWeight: clamp01(fromRuntime) };
+}
+function expandQuery(query, options) {
+  const trimmed = query.trim();
+  if (!trimmed) return [query];
+  const maxQueries = Math.max(1, Math.min(20, options.maxQueries));
+  const tokens = tokenize(trimmed, options.minTokenLen);
+  const seen = /* @__PURE__ */ new Set();
+  const uniqTokens = [];
+  for (const t of tokens) {
+    if (seen.has(t)) continue;
+    seen.add(t);
+    uniqTokens.push(t);
+  }
+  const expansions = [query];
+  if (uniqTokens.length === 0) return expansions;
+  const top = uniqTokens.slice(0, 6);
+  const candidates = [
+    top.slice(0, 3).join(" "),
+    top.slice(0, 2).join(" "),
+    top[0],
+    top[1],
+    top[2]
+  ].filter(Boolean);
+  for (const c of candidates) {
+    if (expansions.length >= maxQueries) break;
+    if (c && !expansions.includes(c)) expansions.push(c);
+  }
+  return expansions.slice(0, maxQueries);
+}
+
+export {
+  applyRuntimeRetrievalPolicy,
+  expandQuery
+};
+//# sourceMappingURL=chunk-G3AG3KZN.js.map

package/dist/chunk-G3AG3KZN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retrieval.ts"],"sourcesContent":["import { clamp01 } from \"./lifecycle.js\";\n\nexport interface QueryExpansionOptions {\n  maxQueries: number;\n  minTokenLen: number;\n}\n\nexport interface RuntimeRetrievalPolicy {\n  recencyWeight?: number;\n}\n\nconst DEFAULT_STOPWORDS = new Set([\n  \"a\",\n  \"an\",\n  \"and\",\n  \"are\",\n  \"as\",\n  \"at\",\n  \"be\",\n  \"but\",\n  \"by\",\n  \"for\",\n  \"from\",\n  \"has\",\n  \"have\",\n  \"i\",\n  \"in\",\n  \"is\",\n  \"it\",\n  \"of\",\n  \"on\",\n  \"or\",\n  \"that\",\n  \"the\",\n  \"this\",\n  \"to\",\n  \"was\",\n  \"were\",\n  \"with\",\n]);\n\nfunction tokenize(query: string, minTokenLen: number): string[] {\n  return query\n    .toLowerCase()\n    .split(/[^a-z0-9]+/g)\n    .map((t) => t.trim())\n    .filter((t) => t.length >= minTokenLen)\n    .filter((t) => !DEFAULT_STOPWORDS.has(t));\n}\n\nexport function applyRuntimeRetrievalPolicy(\n  base: { recencyWeight: number },\n  runtime: RuntimeRetrievalPolicy | null,\n): { recencyWeight: number } {\n  const fromRuntime = runtime?.recencyWeight;\n  if (typeof fromRuntime !== \"number\") {\n    return { recencyWeight: clamp01(base.recencyWeight) };\n  }\n  return { recencyWeight: clamp01(fromRuntime) };\n}\n\n/**\n * Cheap, deterministic query expansion.\n * Produces additional queries biased toward the most salient tokens in the input.\n */\nexport function expandQuery(\n  query: string,\n  options: QueryExpansionOptions,\n): string[] {\n  const trimmed = query.trim();\n  if (!trimmed) return [query];\n\n  const maxQueries = Math.max(1, Math.min(20, options.maxQueries));\n  const tokens = tokenize(trimmed, options.minTokenLen);\n\n  // Keep deterministic ordering: first-seen tokens win.\n  const seen = new Set<string>();\n  const uniqTokens: string[] = [];\n  for (const t of tokens) {\n    if (seen.has(t)) continue;\n    seen.add(t);\n    uniqTokens.push(t);\n  }\n\n  const expansions: string[] = [query];\n  if (uniqTokens.length === 0) return expansions;\n\n  const top = uniqTokens.slice(0, 6);\n\n  const candidates = [\n    top.slice(0, 3).join(\" \"),\n    top.slice(0, 2).join(\" \"),\n    top[0],\n    top[1],\n    top[2],\n  ].filter(Boolean) as string[];\n\n  for (const c of candidates) {\n    if (expansions.length >= maxQueries) break;\n    if (c && !expansions.includes(c)) expansions.push(c);\n  }\n\n  return expansions.slice(0, maxQueries);\n}\n"],"mappings":";;;;;AAWA,IAAM,oBAAoB,oBAAI,IAAI;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,SAAS,OAAe,aAA+B;AAC9D,SAAO,MACJ,YAAY,EACZ,MAAM,aAAa,EACnB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,CAAC,MAAM,EAAE,UAAU,WAAW,EACrC,OAAO,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC;AAC5C;AAEO,SAAS,4BACd,MACA,SAC2B;AAC3B,QAAM,cAAc,SAAS;AAC7B,MAAI,OAAO,gBAAgB,UAAU;AACnC,WAAO,EAAE,eAAe,QAAQ,KAAK,aAAa,EAAE;AAAA,EACtD;AACA,SAAO,EAAE,eAAe,QAAQ,WAAW,EAAE;AAC/C;AAMO,SAAS,YACd,OACA,SACU;AACV,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,QAAS,QAAO,CAAC,KAAK;AAE3B,QAAM,aAAa,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,QAAQ,UAAU,CAAC;AAC/D,QAAM,SAAS,SAAS,SAAS,QAAQ,WAAW;AAGpD,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,aAAuB,CAAC;AAC9B,aAAW,KAAK,QAAQ;AACtB,QAAI,KAAK,IAAI,CAAC,EAAG;AACjB,SAAK,IAAI,CAAC;AACV,eAAW,KAAK,CAAC;AAAA,EACnB;AAEA,QAAM,aAAuB,CAAC,KAAK;AACnC,MAAI,WAAW,WAAW,EAAG,QAAO;AAEpC,QAAM,MAAM,WAAW,MAAM,GAAG,CAAC;AAEjC,QAAM,aAAa;AAAA,IACjB,IAAI,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG;AAAA,IACxB,IAAI,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG;AAAA,IACxB,IAAI,CAAC;AAAA,IACL,IAAI,CAAC;AAAA,IACL,IAAI,CAAC;AAAA,EACP,EAAE,OAAO,OAAO;AAEhB,aAAW,KAAK,YAAY;AAC1B,QAAI,WAAW,UAAU,WAAY;AACrC,QAAI,KAAK,CAAC,WAAW,SAAS,CAAC,EAAG,YAAW,KAAK,CAAC;AAAA,EACrD;AAEA,SAAO,WAAW,MAAM,GAAG,UAAU;AACvC;","names":[]}

package/dist/chunk-GJR6D6KC.js

@@ -0,0 +1,61 @@
+import {
+  log
+} from "./chunk-KWBU5S5U.js";
+
+// src/negative.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+var NegativeExampleStore = class {
+  statePath;
+  state = {};
+  constructor(memoryDir) {
+    this.statePath = path.join(memoryDir, "state", "negative_examples.json");
+  }
+  async load() {
+    try {
+      const raw = await readFile(this.statePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (parsed && typeof parsed === "object") this.state = parsed;
+    } catch {
+      this.state = {};
+    }
+  }
+  /**
+   * Record that a memory was retrieved but not useful for the user.
+   * This should be lightweight and never block agent execution.
+   */
+  async recordNotUseful(memoryIds, note) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    for (const memoryId of memoryIds) {
+      const existing = this.state[memoryId] ?? { notUseful: 0, lastUpdatedAt: now };
+      const next = {
+        notUseful: existing.notUseful + 1,
+        lastUpdatedAt: now,
+        notes: note ? [...(existing.notes ?? []).slice(-19), note] : existing.notes
+      };
+      this.state[memoryId] = next;
+    }
+    try {
+      await mkdir(path.dirname(this.statePath), { recursive: true });
+      await writeFile(this.statePath, JSON.stringify(this.state, null, 2), "utf-8");
+    } catch (err) {
+      log.debug(`negative example store write failed: ${err}`);
+    }
+  }
+  /**
+   * Convert negative examples into a small score penalty.
+   * Intended as a soft bias, not a hard filter.
+   */
+  penalty(memoryId, opts) {
+    const entry = this.state[memoryId];
+    if (!entry) return 0;
+    const hits = Math.min(10, entry.notUseful);
+    const raw = hits * opts.perHit;
+    return Math.min(opts.cap, raw);
+  }
+};
+
+export {
+  NegativeExampleStore
+};
+//# sourceMappingURL=chunk-GJR6D6KC.js.map

package/dist/chunk-GJR6D6KC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/negative.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\n\nexport interface NegativeExampleEntry {\n  notUseful: number;\n  lastUpdatedAt: string;\n  notes?: string[];\n}\n\ntype NegativeState = Record<string, NegativeExampleEntry>;\n\nexport class NegativeExampleStore {\n  private readonly statePath: string;\n  private state: NegativeState = {};\n\n  constructor(memoryDir: string) {\n    this.statePath = path.join(memoryDir, \"state\", \"negative_examples.json\");\n  }\n\n  async load(): Promise<void> {\n    try {\n      const raw = await readFile(this.statePath, \"utf-8\");\n      const parsed = JSON.parse(raw) as NegativeState;\n      if (parsed && typeof parsed === \"object\") this.state = parsed;\n    } catch {\n      this.state = {};\n    }\n  }\n\n  /**\n   * Record that a memory was retrieved but not useful for the user.\n   * This should be lightweight and never block agent execution.\n   */\n  async recordNotUseful(memoryIds: string[], note?: string): Promise<void> {\n    const now = new Date().toISOString();\n\n    for (const memoryId of memoryIds) {\n      const existing = this.state[memoryId] ?? { notUseful: 0, lastUpdatedAt: now };\n      const next: NegativeExampleEntry = {\n        notUseful: existing.notUseful + 1,\n        lastUpdatedAt: now,\n        notes: note\n          ? [...(existing.notes ?? []).slice(-19), note]\n          : existing.notes,\n      };\n      this.state[memoryId] = next;\n    }\n\n    try {\n      await mkdir(path.dirname(this.statePath), { recursive: true });\n      await writeFile(this.statePath, JSON.stringify(this.state, null, 2), \"utf-8\");\n    } catch (err) {\n      log.debug(`negative example store write failed: ${err}`);\n    }\n  }\n\n  /**\n   * Convert negative examples into a small score penalty.\n   * Intended as a soft bias, not a hard filter.\n   */\n  penalty(memoryId: string, opts: { perHit: number; cap: number }): number {\n    const entry = this.state[memoryId];\n    if (!entry) return 0;\n\n    // Cap effect to avoid runaway ranking distortion.\n    const hits = Math.min(10, entry.notUseful);\n    const raw = hits * opts.perHit;\n    return Math.min(opts.cap, raw);\n  }\n}\n\n"],"mappings":";;;;;AAAA,SAAS,OAAO,UAAU,iBAAiB;AAC3C,OAAO,UAAU;AAWV,IAAM,uBAAN,MAA2B;AAAA,EACf;AAAA,EACT,QAAuB,CAAC;AAAA,EAEhC,YAAY,WAAmB;AAC7B,SAAK,YAAY,KAAK,KAAK,WAAW,SAAS,wBAAwB;AAAA,EACzE;AAAA,EAEA,MAAM,OAAsB;AAC1B,QAAI;AACF,YAAM,MAAM,MAAM,SAAS,KAAK,WAAW,OAAO;AAClD,YAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,UAAI,UAAU,OAAO,WAAW,SAAU,MAAK,QAAQ;AAAA,IACzD,QAAQ;AACN,WAAK,QAAQ,CAAC;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAAgB,WAAqB,MAA8B;AACvE,UAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEnC,eAAW,YAAY,WAAW;AAChC,YAAM,WAAW,KAAK,MAAM,QAAQ,KAAK,EAAE,WAAW,GAAG,eAAe,IAAI;AAC5E,YAAM,OAA6B;AAAA,QACjC,WAAW,SAAS,YAAY;AAAA,QAChC,eAAe;AAAA,QACf,OAAO,OACH,CAAC,IAAI,SAAS,SAAS,CAAC,GAAG,MAAM,GAAG,GAAG,IAAI,IAC3C,SAAS;AAAA,MACf;AACA,WAAK,MAAM,QAAQ,IAAI;AAAA,IACzB;AAEA,QAAI;AACF,YAAM,MAAM,KAAK,QAAQ,KAAK,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAC7D,YAAM,UAAU,KAAK,WAAW,KAAK,UAAU,KAAK,OAAO,MAAM,CAAC,GAAG,OAAO;AAAA,IAC9E,SAAS,KAAK;AACZ,UAAI,MAAM,wCAAwC,GAAG,EAAE;AAAA,IACzD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,UAAkB,MAA+C;AACvE,UAAM,QAAQ,KAAK,MAAM,QAAQ;AACjC,QAAI,CAAC,MAAO,QAAO;AAGnB,UAAM,OAAO,KAAK,IAAI,IAAI,MAAM,SAAS;AACzC,UAAM,MAAM,OAAO,KAAK;AACxB,WAAO,KAAK,IAAI,KAAK,KAAK,GAAG;AAAA,EAC/B;AACF;","names":[]}