@mnemoai/core 1.1.0 → 1.1.1

package/{src/reflection-slices.ts → dist/src/reflection-slices.js}

@@ -1,45 +1,8 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
-export interface ReflectionSlices {
-  invariants: string[];
-  derived: string[];
-}
-
-export interface ReflectionMappedMemory {
-  text: string;
-  category: "preference" | "fact" | "decision";
-  heading: string;
-}
-
-export type ReflectionMappedKind = "user-model" | "agent-model" | "lesson" | "decision";
-
-export interface ReflectionMappedMemoryItem extends ReflectionMappedMemory {
-  mappedKind: ReflectionMappedKind;
-  ordinal: number;
-  groupSize: number;
-}
-
-export interface ReflectionSliceItem {
-  text: string;
-  itemKind: "invariant" | "derived";
-  section: "Invariants" | "Derived";
-  ordinal: number;
-  groupSize: number;
-}
-
-export interface ReflectionGovernanceEntry {
-  priority?: string;
-  status?: string;
-  area?: string;
-  summary: string;
-  details?: string;
-  suggestedAction?: string;
-}
-
-export function extractSectionMarkdown(markdown: string, heading: string): string {
+function extractSectionMarkdown(markdown, heading) {
   const lines = markdown.split(/\r?\n/);
   const headingNeedle = `## ${heading}`.toLowerCase();
   let inSection = false;
-  const collected: string[] = [];
+  const collected = [];
   for (const raw of lines) {
     const line = raw.trim();
     const lower = line.toLowerCase();
@@ -53,10 +16,9 @@ export function extractSectionMarkdown(markdown: string, heading: string): strin
   }
   return collected.join("\n").trim();
 }
-
-export function parseSectionBullets(markdown: string, heading: string): string[] {
+function parseSectionBullets(markdown, heading) {
   const lines = extractSectionMarkdown(markdown, heading).split(/\r?\n/);
-  const collected: string[] = [];
+  const collected = [];
   for (const raw of lines) {
     const line = raw.trim();
     if (line.startsWith("- ") || line.startsWith("* ")) {
@@ -66,8 +28,7 @@ export function parseSectionBullets(markdown: string, heading: string): string[]
   }
   return collected;
 }
-
-export function isPlaceholderReflectionSliceLine(line: string): boolean {
+function isPlaceholderReflectionSliceLine(line) {
   const normalized = line.replace(/\*\*/g, "").trim();
   if (!normalized) return true;
   if (/^\(none( captured)?\)$/i.test(normalized)) return true;
@@ -77,189 +38,152 @@ export function isPlaceholderReflectionSliceLine(line: string): boolean {
   if (/investigate why embedded reflection generation failed/i.test(normalized)) return true;
   return false;
 }
-
-export function normalizeReflectionSliceLine(line: string): string {
-  return line
-    .replace(/\*\*/g, "")
-    .replace(/^(invariants?|reflections?|derived)[:：]\s*/i, "")
-    .trim();
+function normalizeReflectionSliceLine(line) {
+  return line.replace(/\*\*/g, "").replace(/^(invariants?|reflections?|derived)[:：]\s*/i, "").trim();
 }
-
-export function sanitizeReflectionSliceLines(lines: string[]): string[] {
-  return lines
-    .map(normalizeReflectionSliceLine)
-    .filter((line) => !isPlaceholderReflectionSliceLine(line));
+function sanitizeReflectionSliceLines(lines) {
+  return lines.map(normalizeReflectionSliceLine).filter((line) => !isPlaceholderReflectionSliceLine(line));
 }
-
-function isInvariantRuleLike(line: string): boolean {
-  return /^(always|never|when\b|if\b|before\b|after\b|prefer\b|avoid\b|require\b|only\b|do not\b|must\b|should\b)/i.test(line) ||
-    /\b(must|should|never|always|prefer|avoid|required?)\b/i.test(line);
+function isInvariantRuleLike(line) {
+  return /^(always|never|when\b|if\b|before\b|after\b|prefer\b|avoid\b|require\b|only\b|do not\b|must\b|should\b)/i.test(line) || /\b(must|should|never|always|prefer|avoid|required?)\b/i.test(line);
 }
-
-function isDerivedDeltaLike(line: string): boolean {
-  return /^(this run|next run|going forward|follow-up|re-check|retest|verify|confirm|avoid repeating|adjust|change|update|retry|keep|watch)\b/i.test(line) ||
-    /\b(this run|next run|delta|change|adjust|retry|re-check|retest|verify|confirm|avoid repeating|follow-up)\b/i.test(line);
+function isDerivedDeltaLike(line) {
+  return /^(this run|next run|going forward|follow-up|re-check|retest|verify|confirm|avoid repeating|adjust|change|update|retry|keep|watch)\b/i.test(line) || /\b(this run|next run|delta|change|adjust|retry|re-check|retest|verify|confirm|avoid repeating|follow-up)\b/i.test(line);
 }
-
-function isOpenLoopAction(line: string): boolean {
+function isOpenLoopAction(line) {
   return /^(investigate|verify|confirm|re-check|retest|update|add|remove|fix|avoid|keep|watch|document)\b/i.test(line);
 }
-
-export function extractReflectionLessons(reflectionText: string): string[] {
+function extractReflectionLessons(reflectionText) {
   return sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, "Lessons & pitfalls (symptom / cause / fix / prevention)"));
 }
-
-export function extractReflectionLearningGovernanceCandidates(reflectionText: string): ReflectionGovernanceEntry[] {
+function extractReflectionLearningGovernanceCandidates(reflectionText) {
   const section = extractSectionMarkdown(reflectionText, "Learning governance candidates (.learnings / promotion / skill extraction)");
   if (!section) return [];
-
-  const entryBlocks = section
-    .split(/(?=^###\s+Entry\b)/gim)
-    .map((block) => block.trim())
-    .filter(Boolean);
-
-  const parsed = entryBlocks
-    .map(parseReflectionGovernanceEntry)
-    .filter((entry): entry is ReflectionGovernanceEntry => entry !== null);
-
+  const entryBlocks = section.split(/(?=^###\s+Entry\b)/gim).map((block) => block.trim()).filter(Boolean);
+  const parsed = entryBlocks.map(parseReflectionGovernanceEntry).filter((entry) => entry !== null);
   if (parsed.length > 0) return parsed;
-
   const fallbackBullets = sanitizeReflectionSliceLines(
     parseSectionBullets(reflectionText, "Learning governance candidates (.learnings / promotion / skill extraction)")
   );
   if (fallbackBullets.length === 0) return [];
-
   return [{
     priority: "medium",
     status: "pending",
     area: "config",
     summary: "Reflection learning governance candidates",
     details: fallbackBullets.map((line) => `- ${line}`).join("\n"),
-    suggestedAction: "Review the governance candidates, promote durable rules to AGENTS.md / SOUL.md / TOOLS.md when stable, and extract a skill if the pattern becomes reusable.",
+    suggestedAction: "Review the governance candidates, promote durable rules to AGENTS.md / SOUL.md / TOOLS.md when stable, and extract a skill if the pattern becomes reusable."
   }];
 }
-
-function parseReflectionGovernanceEntry(block: string): ReflectionGovernanceEntry | null {
+function parseReflectionGovernanceEntry(block) {
   const body = block.replace(/^###\s+Entry\b[^\n]*\n?/i, "").trim();
   if (!body) return null;
-
-  const readField = (label: string): string | undefined => {
+  const readField = (label) => {
     const match = body.match(new RegExp(`^\\*\\*${label}\\*\\*:\\s*(.+)$`, "im"));
     const value = match?.[1]?.trim();
-    return value ? value : undefined;
+    return value ? value : void 0;
   };
-
-  const readSection = (label: string): string | undefined => {
+  const readSection = (label) => {
     const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     const match = body.match(new RegExp(`^###\\s+${escaped}\\s*\\n([\\s\\S]*?)(?=^###\\s+|$)`, "im"));
     const value = match?.[1]?.trim();
-    return value ? value : undefined;
+    return value ? value : void 0;
   };
-
   const summary = readSection("Summary");
   if (!summary) return null;
-
   return {
     priority: readField("Priority"),
     status: readField("Status"),
     area: readField("Area"),
     summary,
     details: readSection("Details"),
-    suggestedAction: readSection("Suggested Action"),
+    suggestedAction: readSection("Suggested Action")
   };
 }
-
-export function extractReflectionMappedMemories(reflectionText: string): ReflectionMappedMemory[] {
+function extractReflectionMappedMemories(reflectionText) {
   return extractReflectionMappedMemoryItems(reflectionText).map(({ text, category, heading }) => ({ text, category, heading }));
 }
-
-export function extractReflectionMappedMemoryItems(reflectionText: string): ReflectionMappedMemoryItem[] {
-  const mappedSections: Array<{
-    heading: string;
-    category: "preference" | "fact" | "decision";
-    mappedKind: ReflectionMappedKind;
-  }> = [
+function extractReflectionMappedMemoryItems(reflectionText) {
+  const mappedSections = [
     {
       heading: "User model deltas (about the human)",
       category: "preference",
-      mappedKind: "user-model",
+      mappedKind: "user-model"
     },
     {
       heading: "Agent model deltas (about the assistant/system)",
       category: "preference",
-      mappedKind: "agent-model",
+      mappedKind: "agent-model"
     },
     {
       heading: "Lessons & pitfalls (symptom / cause / fix / prevention)",
       category: "fact",
-      mappedKind: "lesson",
+      mappedKind: "lesson"
     },
     {
       heading: "Decisions (durable)",
       category: "decision",
-      mappedKind: "decision",
-    },
+      mappedKind: "decision"
+    }
   ];
-
   return mappedSections.flatMap(({ heading, category, mappedKind }) => {
     const lines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, heading));
     const groupSize = lines.length;
     return lines.map((text, ordinal) => ({ text, category, heading, mappedKind, ordinal, groupSize }));
   });
 }
-
-export function extractReflectionSlices(reflectionText: string): ReflectionSlices {
+function extractReflectionSlices(reflectionText) {
   const invariantSection = parseSectionBullets(reflectionText, "Invariants");
   const derivedSection = parseSectionBullets(reflectionText, "Derived");
   const mergedSection = parseSectionBullets(reflectionText, "Invariants & Reflections");
-
   const invariantsPrimary = sanitizeReflectionSliceLines(invariantSection).filter(isInvariantRuleLike);
   const derivedPrimary = sanitizeReflectionSliceLines(derivedSection).filter(isDerivedDeltaLike);
-
   const invariantLinesLegacy = sanitizeReflectionSliceLines(
     mergedSection.filter((line) => /invariant|stable|policy|rule/i.test(line))
   ).filter(isInvariantRuleLike);
   const reflectionLinesLegacy = sanitizeReflectionSliceLines(
     mergedSection.filter((line) => /reflect|inherit|derive|change|apply/i.test(line))
   ).filter(isDerivedDeltaLike);
-  const openLoopLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, "Open loops / next actions"))
-    .filter(isOpenLoopAction)
-    .filter(isDerivedDeltaLike);
-  const durableDecisionLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, "Decisions (durable)"))
-    .filter(isInvariantRuleLike);
-
-  const invariants = invariantsPrimary.length > 0
-    ? invariantsPrimary
-    : (invariantLinesLegacy.length > 0 ? invariantLinesLegacy : durableDecisionLines);
-  const derived = derivedPrimary.length > 0
-    ? derivedPrimary
-    : [...reflectionLinesLegacy, ...openLoopLines];
-
+  const openLoopLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, "Open loops / next actions")).filter(isOpenLoopAction).filter(isDerivedDeltaLike);
+  const durableDecisionLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, "Decisions (durable)")).filter(isInvariantRuleLike);
+  const invariants = invariantsPrimary.length > 0 ? invariantsPrimary : invariantLinesLegacy.length > 0 ? invariantLinesLegacy : durableDecisionLines;
+  const derived = derivedPrimary.length > 0 ? derivedPrimary : [...reflectionLinesLegacy, ...openLoopLines];
   return {
     invariants: invariants.slice(0, 8),
-    derived: derived.slice(0, 10),
+    derived: derived.slice(0, 10)
   };
 }
-
-export function extractReflectionSliceItems(reflectionText: string): ReflectionSliceItem[] {
+function extractReflectionSliceItems(reflectionText) {
   const slices = extractReflectionSlices(reflectionText);
   const invariantGroupSize = slices.invariants.length;
   const derivedGroupSize = slices.derived.length;
-
   const invariantItems = slices.invariants.map((text, ordinal) => ({
     text,
-    itemKind: "invariant" as const,
-    section: "Invariants" as const,
+    itemKind: "invariant",
+    section: "Invariants",
     ordinal,
-    groupSize: invariantGroupSize,
+    groupSize: invariantGroupSize
   }));
   const derivedItems = slices.derived.map((text, ordinal) => ({
     text,
-    itemKind: "derived" as const,
-    section: "Derived" as const,
+    itemKind: "derived",
+    section: "Derived",
     ordinal,
-    groupSize: derivedGroupSize,
+    groupSize: derivedGroupSize
   }));
-
   return [...invariantItems, ...derivedItems];
 }
+export {
+  extractReflectionLearningGovernanceCandidates,
+  extractReflectionLessons,
+  extractReflectionMappedMemories,
+  extractReflectionMappedMemoryItems,
+  extractReflectionSliceItems,
+  extractReflectionSlices,
+  extractSectionMarkdown,
+  isPlaceholderReflectionSliceLine,
+  normalizeReflectionSliceLine,
+  parseSectionBullets,
+  sanitizeReflectionSliceLines
+};
+//# sourceMappingURL=reflection-slices.js.map

package/dist/src/reflection-slices.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-slices.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nexport interface ReflectionSlices {\n  invariants: string[];\n  derived: string[];\n}\n\nexport interface ReflectionMappedMemory {\n  text: string;\n  category: \"preference\" | \"fact\" | \"decision\";\n  heading: string;\n}\n\nexport type ReflectionMappedKind = \"user-model\" | \"agent-model\" | \"lesson\" | \"decision\";\n\nexport interface ReflectionMappedMemoryItem extends ReflectionMappedMemory {\n  mappedKind: ReflectionMappedKind;\n  ordinal: number;\n  groupSize: number;\n}\n\nexport interface ReflectionSliceItem {\n  text: string;\n  itemKind: \"invariant\" | \"derived\";\n  section: \"Invariants\" | \"Derived\";\n  ordinal: number;\n  groupSize: number;\n}\n\nexport interface ReflectionGovernanceEntry {\n  priority?: string;\n  status?: string;\n  area?: string;\n  summary: string;\n  details?: string;\n  suggestedAction?: string;\n}\n\nexport function extractSectionMarkdown(markdown: string, heading: string): string {\n  const lines = markdown.split(/\\r?\\n/);\n  const headingNeedle = `## ${heading}`.toLowerCase();\n  let inSection = false;\n  const collected: string[] = [];\n  for (const raw of lines) {\n    const line = raw.trim();\n    const lower = line.toLowerCase();\n    if (lower.startsWith(\"## \")) {\n      if (inSection && lower !== headingNeedle) break;\n      inSection = lower === headingNeedle;\n      continue;\n    }\n    if (!inSection) continue;\n    collected.push(raw);\n  }\n  return collected.join(\"\\n\").trim();\n}\n\nexport function parseSectionBullets(markdown: string, heading: string): string[] {\n  const lines = extractSectionMarkdown(markdown, heading).split(/\\r?\\n/);\n  const collected: string[] = [];\n  for (const raw of lines) {\n    const line = raw.trim();\n    if (line.startsWith(\"- \") || line.startsWith(\"* \")) {\n      const normalized = line.slice(2).trim();\n      if (normalized) collected.push(normalized);\n    }\n  }\n  return collected;\n}\n\nexport function isPlaceholderReflectionSliceLine(line: string): boolean {\n  const normalized = line.replace(/\\*\\*/g, \"\").trim();\n  if (!normalized) return true;\n  if (/^\\(none( captured)?\\)$/i.test(normalized)) return true;\n  if (/^(invariants?|reflections?|derived)[:\uFF1A]$/i.test(normalized)) return true;\n  if (/apply this session'?s deltas next run/i.test(normalized)) return true;\n  if (/apply this session'?s distilled changes next run/i.test(normalized)) return true;\n  if (/investigate why embedded reflection generation failed/i.test(normalized)) return true;\n  return false;\n}\n\nexport function normalizeReflectionSliceLine(line: string): string {\n  return line\n    .replace(/\\*\\*/g, \"\")\n    .replace(/^(invariants?|reflections?|derived)[:\uFF1A]\\s*/i, \"\")\n    .trim();\n}\n\nexport function sanitizeReflectionSliceLines(lines: string[]): string[] {\n  return lines\n    .map(normalizeReflectionSliceLine)\n    .filter((line) => !isPlaceholderReflectionSliceLine(line));\n}\n\nfunction isInvariantRuleLike(line: string): boolean {\n  return /^(always|never|when\\b|if\\b|before\\b|after\\b|prefer\\b|avoid\\b|require\\b|only\\b|do not\\b|must\\b|should\\b)/i.test(line) ||\n    /\\b(must|should|never|always|prefer|avoid|required?)\\b/i.test(line);\n}\n\nfunction isDerivedDeltaLike(line: string): boolean {\n  return /^(this run|next run|going forward|follow-up|re-check|retest|verify|confirm|avoid repeating|adjust|change|update|retry|keep|watch)\\b/i.test(line) ||\n    /\\b(this run|next run|delta|change|adjust|retry|re-check|retest|verify|confirm|avoid repeating|follow-up)\\b/i.test(line);\n}\n\nfunction isOpenLoopAction(line: string): boolean {\n  return /^(investigate|verify|confirm|re-check|retest|update|add|remove|fix|avoid|keep|watch|document)\\b/i.test(line);\n}\n\nexport function extractReflectionLessons(reflectionText: string): string[] {\n  return sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, \"Lessons & pitfalls (symptom / cause / fix / prevention)\"));\n}\n\nexport function extractReflectionLearningGovernanceCandidates(reflectionText: string): ReflectionGovernanceEntry[] {\n  const section = extractSectionMarkdown(reflectionText, \"Learning governance candidates (.learnings / promotion / skill extraction)\");\n  if (!section) return [];\n\n  const entryBlocks = section\n    .split(/(?=^###\\s+Entry\\b)/gim)\n    .map((block) => block.trim())\n    .filter(Boolean);\n\n  const parsed = entryBlocks\n    .map(parseReflectionGovernanceEntry)\n    .filter((entry): entry is ReflectionGovernanceEntry => entry !== null);\n\n  if (parsed.length > 0) return parsed;\n\n  const fallbackBullets = sanitizeReflectionSliceLines(\n    parseSectionBullets(reflectionText, \"Learning governance candidates (.learnings / promotion / skill extraction)\")\n  );\n  if (fallbackBullets.length === 0) return [];\n\n  return [{\n    priority: \"medium\",\n    status: \"pending\",\n    area: \"config\",\n    summary: \"Reflection learning governance candidates\",\n    details: fallbackBullets.map((line) => `- ${line}`).join(\"\\n\"),\n    suggestedAction: \"Review the governance candidates, promote durable rules to AGENTS.md / SOUL.md / TOOLS.md when stable, and extract a skill if the pattern becomes reusable.\",\n  }];\n}\n\nfunction parseReflectionGovernanceEntry(block: string): ReflectionGovernanceEntry | null {\n  const body = block.replace(/^###\\s+Entry\\b[^\\n]*\\n?/i, \"\").trim();\n  if (!body) return null;\n\n  const readField = (label: string): string | undefined => {\n    const match = body.match(new RegExp(`^\\\\*\\\\*${label}\\\\*\\\\*:\\\\s*(.+)$`, \"im\"));\n    const value = match?.[1]?.trim();\n    return value ? value : undefined;\n  };\n\n  const readSection = (label: string): string | undefined => {\n    const escaped = label.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const match = body.match(new RegExp(`^###\\\\s+${escaped}\\\\s*\\\\n([\\\\s\\\\S]*?)(?=^###\\\\s+|$)`, \"im\"));\n    const value = match?.[1]?.trim();\n    return value ? value : undefined;\n  };\n\n  const summary = readSection(\"Summary\");\n  if (!summary) return null;\n\n  return {\n    priority: readField(\"Priority\"),\n    status: readField(\"Status\"),\n    area: readField(\"Area\"),\n    summary,\n    details: readSection(\"Details\"),\n    suggestedAction: readSection(\"Suggested Action\"),\n  };\n}\n\nexport function extractReflectionMappedMemories(reflectionText: string): ReflectionMappedMemory[] {\n  return extractReflectionMappedMemoryItems(reflectionText).map(({ text, category, heading }) => ({ text, category, heading }));\n}\n\nexport function extractReflectionMappedMemoryItems(reflectionText: string): ReflectionMappedMemoryItem[] {\n  const mappedSections: Array<{\n    heading: string;\n    category: \"preference\" | \"fact\" | \"decision\";\n    mappedKind: ReflectionMappedKind;\n  }> = [\n    {\n      heading: \"User model deltas (about the human)\",\n      category: \"preference\",\n      mappedKind: \"user-model\",\n    },\n    {\n      heading: \"Agent model deltas (about the assistant/system)\",\n      category: \"preference\",\n      mappedKind: \"agent-model\",\n    },\n    {\n      heading: \"Lessons & pitfalls (symptom / cause / fix / prevention)\",\n      category: \"fact\",\n      mappedKind: \"lesson\",\n    },\n    {\n      heading: \"Decisions (durable)\",\n      category: \"decision\",\n      mappedKind: \"decision\",\n    },\n  ];\n\n  return mappedSections.flatMap(({ heading, category, mappedKind }) => {\n    const lines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, heading));\n    const groupSize = lines.length;\n    return lines.map((text, ordinal) => ({ text, category, heading, mappedKind, ordinal, groupSize }));\n  });\n}\n\nexport function extractReflectionSlices(reflectionText: string): ReflectionSlices {\n  const invariantSection = parseSectionBullets(reflectionText, \"Invariants\");\n  const derivedSection = parseSectionBullets(reflectionText, \"Derived\");\n  const mergedSection = parseSectionBullets(reflectionText, \"Invariants & Reflections\");\n\n  const invariantsPrimary = sanitizeReflectionSliceLines(invariantSection).filter(isInvariantRuleLike);\n  const derivedPrimary = sanitizeReflectionSliceLines(derivedSection).filter(isDerivedDeltaLike);\n\n  const invariantLinesLegacy = sanitizeReflectionSliceLines(\n    mergedSection.filter((line) => /invariant|stable|policy|rule/i.test(line))\n  ).filter(isInvariantRuleLike);\n  const reflectionLinesLegacy = sanitizeReflectionSliceLines(\n    mergedSection.filter((line) => /reflect|inherit|derive|change|apply/i.test(line))\n  ).filter(isDerivedDeltaLike);\n  const openLoopLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, \"Open loops / next actions\"))\n    .filter(isOpenLoopAction)\n    .filter(isDerivedDeltaLike);\n  const durableDecisionLines = sanitizeReflectionSliceLines(parseSectionBullets(reflectionText, \"Decisions (durable)\"))\n    .filter(isInvariantRuleLike);\n\n  const invariants = invariantsPrimary.length > 0\n    ? invariantsPrimary\n    : (invariantLinesLegacy.length > 0 ? invariantLinesLegacy : durableDecisionLines);\n  const derived = derivedPrimary.length > 0\n    ? derivedPrimary\n    : [...reflectionLinesLegacy, ...openLoopLines];\n\n  return {\n    invariants: invariants.slice(0, 8),\n    derived: derived.slice(0, 10),\n  };\n}\n\nexport function extractReflectionSliceItems(reflectionText: string): ReflectionSliceItem[] {\n  const slices = extractReflectionSlices(reflectionText);\n  const invariantGroupSize = slices.invariants.length;\n  const derivedGroupSize = slices.derived.length;\n\n  const invariantItems = slices.invariants.map((text, ordinal) => ({\n    text,\n    itemKind: \"invariant\" as const,\n    section: \"Invariants\" as const,\n    ordinal,\n    groupSize: invariantGroupSize,\n  }));\n  const derivedItems = slices.derived.map((text, ordinal) => ({\n    text,\n    itemKind: \"derived\" as const,\n    section: \"Derived\" as const,\n    ordinal,\n    groupSize: derivedGroupSize,\n  }));\n\n  return [...invariantItems, ...derivedItems];\n}\n"],
+  "mappings": "AAqCO,SAAS,uBAAuB,UAAkB,SAAyB;AAChF,QAAM,QAAQ,SAAS,MAAM,OAAO;AACpC,QAAM,gBAAgB,MAAM,OAAO,GAAG,YAAY;AAClD,MAAI,YAAY;AAChB,QAAM,YAAsB,CAAC;AAC7B,aAAW,OAAO,OAAO;AACvB,UAAM,OAAO,IAAI,KAAK;AACtB,UAAM,QAAQ,KAAK,YAAY;AAC/B,QAAI,MAAM,WAAW,KAAK,GAAG;AAC3B,UAAI,aAAa,UAAU,cAAe;AAC1C,kBAAY,UAAU;AACtB;AAAA,IACF;AACA,QAAI,CAAC,UAAW;AAChB,cAAU,KAAK,GAAG;AAAA,EACpB;AACA,SAAO,UAAU,KAAK,IAAI,EAAE,KAAK;AACnC;AAEO,SAAS,oBAAoB,UAAkB,SAA2B;AAC/E,QAAM,QAAQ,uBAAuB,UAAU,OAAO,EAAE,MAAM,OAAO;AACrE,QAAM,YAAsB,CAAC;AAC7B,aAAW,OAAO,OAAO;AACvB,UAAM,OAAO,IAAI,KAAK;AACtB,QAAI,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,IAAI,GAAG;AAClD,YAAM,aAAa,KAAK,MAAM,CAAC,EAAE,KAAK;AACtC,UAAI,WAAY,WAAU,KAAK,UAAU;AAAA,IAC3C;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,iCAAiC,MAAuB;AACtE,QAAM,aAAa,KAAK,QAAQ,SAAS,EAAE,EAAE,KAAK;AAClD,MAAI,CAAC,WAAY,QAAO;AACxB,MAAI,0BAA0B,KAAK,UAAU,EAAG,QAAO;AACvD,MAAI,4CAA4C,KAAK,UAAU,EAAG,QAAO;AACzE,MAAI,yCAAyC,KAAK,UAAU,EAAG,QAAO;AACtE,MAAI,oDAAoD,KAAK,UAAU,EAAG,QAAO;AACjF,MAAI,yDAAyD,KAAK,UAAU,EAAG,QAAO;AACtF,SAAO;AACT;AAEO,SAAS,6BAA6B,MAAsB;AACjE,SAAO,KACJ,QAAQ,SAAS,EAAE,EACnB,QAAQ,+CAA+C,EAAE,EACzD,KAAK;AACV;AAEO,SAAS,6BAA6B,OAA2B;AACtE,SAAO,MACJ,IAAI,4BAA4B,EAChC,OAAO,CAAC,SAAS,CAAC,iCAAiC,IAAI,CAAC;AAC7D;AAEA,SAAS,oBAAoB,MAAuB;AAClD,SAAO,2GAA2G,KAAK,IAAI,KACzH,yDAAyD,KAAK,IAAI;AACtE;AAEA,SAAS,mBAAmB,MAAuB;AACjD,SAAO,uIAAuI,KAAK,IAAI,KACrJ,8GAA8G,KAAK,IAAI;AAC3H;AAEA,SAAS,iBAAiB,MAAuB;AAC/C,SAAO,mGAAmG,KAAK,IAAI;AACrH;AAEO,SAAS,yBAAyB,gBAAkC;AACzE,SAAO,6BAA6B,oBAAoB,gBAAgB,yDAAyD,CAAC;AACpI;AAEO,SAAS,8CAA8C,gBAAqD;AACjH,QAAM,UAAU,uBAAuB,gBAAgB,4EAA4E;AACnI,MAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,QAAM,cAAc,QACjB,MAAM,uBAAuB,EAC7B,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;AAEjB,QAAM,SAAS,YACZ,IAAI,8BAA8B,EAClC,OAAO,CAAC,UAA8C,UAAU,IAAI;AAEvE,MAAI,OAAO,SAAS,EAAG,QAAO;AAE9B,QAAM,kBAAkB;AAAA,IACtB,oBAAoB,gBAAgB,4EAA4E;AAAA,EAClH;AACA,MAAI,gBAAgB,WAAW,EAAG,QAAO,CAAC;AAE1C,SAAO,CAAC;AAAA,IACN,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS,gBAAgB,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,EAAE,KAAK,IAAI;AAAA,IAC7D,iBAAiB;AAAA,EACnB,CAAC;AACH;AAEA,SAAS,+BAA+B,OAAiD;AACvF,QAAM,OAAO,MAAM,QAAQ,4BAA4B,EAAE,EAAE,KAAK;AAChE,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,YAAY,CAAC,UAAsC;AACvD,UAAM,QAAQ,KAAK,MAAM,IAAI,OAAO,UAAU,KAAK,oBAAoB,IAAI,CAAC;AAC5E,UAAM,QAAQ,QAAQ,CAAC,GAAG,KAAK;AAC/B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,QAAM,cAAc,CAAC,UAAsC;AACzD,UAAM,UAAU,MAAM,QAAQ,uBAAuB,MAAM;AAC3D,UAAM,QAAQ,KAAK,MAAM,IAAI,OAAO,WAAW,OAAO,qCAAqC,IAAI,CAAC;AAChG,UAAM,QAAQ,QAAQ,CAAC,GAAG,KAAK;AAC/B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAEA,QAAM,UAAU,YAAY,SAAS;AACrC,MAAI,CAAC,QAAS,QAAO;AAErB,SAAO;AAAA,IACL,UAAU,UAAU,UAAU;AAAA,IAC9B,QAAQ,UAAU,QAAQ;AAAA,IAC1B,MAAM,UAAU,MAAM;AAAA,IACtB;AAAA,IACA,SAAS,YAAY,SAAS;AAAA,IAC9B,iBAAiB,YAAY,kBAAkB;AAAA,EACjD;AACF;AAEO,SAAS,gCAAgC,gBAAkD;AAChG,SAAO,mCAAmC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,UAAU,QAAQ,OAAO,EAAE,MAAM,UAAU,QAAQ,EAAE;AAC9H;AAEO,SAAS,mCAAmC,gBAAsD;AACvG,QAAM,iBAID;AAAA,IACH;AAAA,MACE,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,IACA;AAAA,MACE,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,IACA;AAAA,MACE,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,IACA;AAAA,MACE,SAAS;AAAA,MACT,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,EACF;AAEA,SAAO,eAAe,QAAQ,CAAC,EAAE,SAAS,UAAU,WAAW,MAAM;AACnE,UAAM,QAAQ,6BAA6B,oBAAoB,gBAAgB,OAAO,CAAC;AACvF,UAAM,YAAY,MAAM;AACxB,WAAO,MAAM,IAAI,CAAC,MAAM,aAAa,EAAE,MAAM,UAAU,SAAS,YAAY,SAAS,UAAU,EAAE;AAAA,EACnG,CAAC;AACH;AAEO,SAAS,wBAAwB,gBAA0C;AAChF,QAAM,mBAAmB,oBAAoB,gBAAgB,YAAY;AACzE,QAAM,iBAAiB,oBAAoB,gBAAgB,SAAS;AACpE,QAAM,gBAAgB,oBAAoB,gBAAgB,0BAA0B;AAEpF,QAAM,oBAAoB,6BAA6B,gBAAgB,EAAE,OAAO,mBAAmB;AACnG,QAAM,iBAAiB,6BAA6B,cAAc,EAAE,OAAO,kBAAkB;AAE7F,QAAM,uBAAuB;AAAA,IAC3B,cAAc,OAAO,CAAC,SAAS,gCAAgC,KAAK,IAAI,CAAC;AAAA,EAC3E,EAAE,OAAO,mBAAmB;AAC5B,QAAM,wBAAwB;AAAA,IAC5B,cAAc,OAAO,CAAC,SAAS,uCAAuC,KAAK,IAAI,CAAC;AAAA,EAClF,EAAE,OAAO,kBAAkB;AAC3B,QAAM,gBAAgB,6BAA6B,oBAAoB,gBAAgB,2BAA2B,CAAC,EAChH,OAAO,gBAAgB,EACvB,OAAO,kBAAkB;AAC5B,QAAM,uBAAuB,6BAA6B,oBAAoB,gBAAgB,qBAAqB,CAAC,EACjH,OAAO,mBAAmB;AAE7B,QAAM,aAAa,kBAAkB,SAAS,IAC1C,oBACC,qBAAqB,SAAS,IAAI,uBAAuB;AAC9D,QAAM,UAAU,eAAe,SAAS,IACpC,iBACA,CAAC,GAAG,uBAAuB,GAAG,aAAa;AAE/C,SAAO;AAAA,IACL,YAAY,WAAW,MAAM,GAAG,CAAC;AAAA,IACjC,SAAS,QAAQ,MAAM,GAAG,EAAE;AAAA,EAC9B;AACF;AAEO,SAAS,4BAA4B,gBAA+C;AACzF,QAAM,SAAS,wBAAwB,cAAc;AACrD,QAAM,qBAAqB,OAAO,WAAW;AAC7C,QAAM,mBAAmB,OAAO,QAAQ;AAExC,QAAM,iBAAiB,OAAO,WAAW,IAAI,CAAC,MAAM,aAAa;AAAA,IAC/D;AAAA,IACA,UAAU;AAAA,IACV,SAAS;AAAA,IACT;AAAA,IACA,WAAW;AAAA,EACb,EAAE;AACF,QAAM,eAAe,OAAO,QAAQ,IAAI,CAAC,MAAM,aAAa;AAAA,IAC1D;AAAA,IACA,UAAU;AAAA,IACV,SAAS;AAAA,IACT;AAAA,IACA,WAAW;AAAA,EACb,EAAE;AAEF,SAAO,CAAC,GAAG,gBAAgB,GAAG,YAAY;AAC5C;",
+  "names": []
+}

package/dist/src/reflection-store.d.ts

@@ -0,0 +1,85 @@
+import type { MemoryEntry, MemorySearchResult } from "./store.js";
+import { type ReflectionSlices } from "./reflection-slices.js";
+export declare const REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS = 3;
+export declare const REFLECTION_DERIVE_LOGISTIC_K = 1.2;
+export declare const REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT = 0.35;
+export declare const DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS: number;
+export declare const DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS: number;
+type ReflectionStoreKind = "event" | "item-invariant" | "item-derived" | "combined-legacy";
+type ReflectionErrorSignalLike = {
+    signatureHash: string;
+};
+interface ReflectionStorePayload {
+    text: string;
+    metadata: Record<string, unknown>;
+    kind: ReflectionStoreKind;
+}
+interface BuildReflectionStorePayloadsParams {
+    reflectionText: string;
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    command: string;
+    scope: string;
+    toolErrorSignals: ReflectionErrorSignalLike[];
+    runAt: number;
+    usedFallback: boolean;
+    eventId?: string;
+    sourceReflectionPath?: string;
+    writeLegacyCombined?: boolean;
+}
+export declare function buildReflectionStorePayloads(params: BuildReflectionStorePayloadsParams): {
+    eventId: string;
+    slices: ReflectionSlices;
+    payloads: ReflectionStorePayload[];
+};
+interface ReflectionStoreDeps {
+    embedPassage: (text: string) => Promise<number[]>;
+    vectorSearch: (vector: number[], limit?: number, minScore?: number, scopeFilter?: string[]) => Promise<MemorySearchResult[]>;
+    store: (entry: Omit<MemoryEntry, "id" | "timestamp">) => Promise<MemoryEntry>;
+}
+interface StoreReflectionToLanceDBParams extends BuildReflectionStorePayloadsParams, ReflectionStoreDeps {
+    dedupeThreshold?: number;
+}
+export declare function storeReflectionToLanceDB(params: StoreReflectionToLanceDBParams): Promise<{
+    stored: boolean;
+    eventId: string;
+    slices: ReflectionSlices;
+    storedKinds: ReflectionStoreKind[];
+}>;
+export interface LoadReflectionSlicesParams {
+    entries: MemoryEntry[];
+    agentId: string;
+    now?: number;
+    deriveMaxAgeMs?: number;
+    invariantMaxAgeMs?: number;
+}
+export declare function loadAgentReflectionSlicesFromEntries(params: LoadReflectionSlicesParams): {
+    invariants: string[];
+    derived: string[];
+};
+export declare function computeDerivedLineQuality(nonPlaceholderLineCount: number): number;
+export interface LoadReflectionMappedRowsParams {
+    entries: MemoryEntry[];
+    agentId: string;
+    now?: number;
+    maxAgeMs?: number;
+    maxPerKind?: number;
+}
+export interface ReflectionMappedSlices {
+    userModel: string[];
+    agentModel: string[];
+    lesson: string[];
+    decision: string[];
+}
+export declare function loadReflectionMappedRowsFromEntries(params: LoadReflectionMappedRowsParams): ReflectionMappedSlices;
+export declare function getReflectionDerivedDecayDefaults(): {
+    midpointDays: number;
+    k: number;
+};
+export declare function getReflectionInvariantDecayDefaults(): {
+    midpointDays: number;
+    k: number;
+};
+export {};
+//# sourceMappingURL=reflection-store.d.ts.map

package/dist/src/reflection-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-store.d.ts","sourceRoot":"","sources":["../../src/reflection-store.ts"],"names":[],"mappings":"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"}