pi-goosedump 0.12.28 → 0.12.30

package/dist/index.ts

@@ -316,29 +316,43 @@ function isStringArray(value) {
   return Array.isArray(value) && value.every((item) => typeof item === "string");
 }
 function isMemorySource(value) {
-  return isRecord(value) && typeof value.provider === "string" && typeof value.session_id === "string" && typeof value.entry_id === "string" && typeof value.role === "string" && typeof value.observed_at === "number" && typeof value.project === "string" && typeof value.source_path === "string" && (value.content_hash === undefined || typeof value.content_hash === "string");
+  return isRecord(value) && typeof value.citation_id === "string" && typeof value.provider === "string" && typeof value.session_id === "string" && typeof value.entry_id === "string" && typeof value.role === "string" && typeof value.observed_at === "number" && typeof value.project === "string" && typeof value.source_path === "string" && typeof value.snippet === "string" && (value.content_hash === undefined || typeof value.content_hash === "string");
+}
+function isMemoryMatchReason(value) {
+  return isRecord(value) && typeof value.detail === "string" && ["lexical", "entity", "relation", "vector", "history"].includes(value.kind);
+}
+function isMemoryRelationship(value) {
+  return isRecord(value) && ["outgoing", "incoming"].includes(value.direction) && ["duplicates", "supports", "revises", "contradicts"].includes(value.kind) && typeof value.claim_id === "string" && typeof value.display_id === "string" && ["fact", "decision", "preference", "procedure", "lesson"].includes(value.memory_type) && typeof value.text === "string" && ["active", "superseded"].includes(value.status) && typeof value.rationale === "string";
 }
 function parseMemoryHits(output) {
   const value = JSON.parse(output);
   if (!Array.isArray(value))
     throw new Error("goosedump memory recall returned invalid JSON");
-  return value.filter((item) => isRecord(item) && typeof item.id === "string" && typeof item.display_id === "string" && typeof item.text === "string" && isStringArray(item.keywords) && typeof item.score === "number" && typeof item.project === "string" && (item.valid_from === null || typeof item.valid_from === "number") && (item.valid_until === null || typeof item.valid_until === "number") && (item.status === undefined || item.status === "active" || item.status === "superseded") && (item.superseded_by === undefined || item.superseded_by === null || typeof item.superseded_by === "string") && (item.related_by === undefined || Array.isArray(item.related_by) && item.related_by.every((entity) => isRecord(entity) && typeof entity.kind === "string" && typeof entity.value === "string")) && ["fact", "decision", "preference", "procedure", "lesson"].includes(item.memory_type) && Array.isArray(item.sources) && item.sources.every(isMemorySource));
+  return value.filter((item) => isRecord(item) && typeof item.id === "string" && typeof item.display_id === "string" && typeof item.text === "string" && isStringArray(item.keywords) && typeof item.score === "number" && typeof item.project === "string" && (item.valid_from === null || typeof item.valid_from === "number") && (item.valid_until === null || typeof item.valid_until === "number") && (item.status === undefined || item.status === "active" || item.status === "superseded") && (item.superseded_by === undefined || item.superseded_by === null || typeof item.superseded_by === "string") && (item.related_by === undefined || Array.isArray(item.related_by) && item.related_by.every((entity) => isRecord(entity) && typeof entity.kind === "string" && typeof entity.value === "string")) && Array.isArray(item.relationships) && item.relationships.every(isMemoryRelationship) && Array.isArray(item.match_reasons) && item.match_reasons.every(isMemoryMatchReason) && ["fact", "decision", "preference", "procedure", "lesson"].includes(item.memory_type) && Array.isArray(item.evidence) && item.evidence.every(isMemorySource));
 }
 function formatMemorySource(source) {
   const observed = new Date(source.observed_at).toISOString();
   const revision = source.content_hash ? `; revision ${source.content_hash.slice(0, 12)}` : "";
-  return `${source.provider}:${source.session_id}/${source.entry_id} ` + `(${source.role}; observed ${observed}${revision}) · ${source.source_path}`;
+  const snippet = source.snippet.trim() ? `
+    ${source.snippet.trim()}` : "";
+  return `[${source.citation_id}] ${source.provider}:${source.session_id}/${source.entry_id} ` + `(${source.role}; observed ${observed}${revision}) · ${source.source_path}${snippet}`;
 }
 function formatMemoryHit(hit, maxBytes) {
   const keywords = hit.keywords.length > 0 ? ` · keywords: ${hit.keywords.join(", ")}` : "";
   const status = hit.status ?? "active";
-  const sourcesText = hit.sources.map(formatMemorySource).join(`
+  const evidenceText = hit.evidence.map(formatMemorySource).join(`
   `);
+  const reasonsText = hit.match_reasons.map((reason) => `${reason.kind}: ${reason.detail}`).join("; ");
   const validSpan = hit.valid_from !== null && hit.valid_until !== null ? `${new Date(hit.valid_from).toISOString()} → ${new Date(hit.valid_until).toISOString()}` : hit.valid_from !== null ? `from ${new Date(hit.valid_from).toISOString()}` : hit.valid_until !== null ? `until ${new Date(hit.valid_until).toISOString()}` : "always valid";
   const related = hit.related_by && hit.related_by.length > 0 ? ` · related by: ${hit.related_by.map((entity) => `${entity.kind}:${entity.value}`).join(", ")}` : "";
+  const relationships = hit.relationships.length > 0 ? `Relationships:
+  ${hit.relationships.map((relationship) => `[${relationship.display_id}] ${relationship.direction} ${relationship.kind} ` + `(${relationship.status}): ${relationship.text} — ${relationship.rationale}`).join(`
+  `)}
+` : "";
   const provenance = `[${hit.display_id}] ${hit.memory_type} (${status}; score ${hit.score.toFixed(3)}; ${validSpan}; project ${hit.project})${keywords}${related}
-` + `Sources:
-  ${sourcesText}
+` + `Match: ${reasonsText}
+` + relationships + `Evidence:
+  ${evidenceText}
 `;
   const full = `${provenance}${hit.text}`;
   if (Buffer.byteLength(full) <= maxBytes)
@@ -491,7 +505,7 @@ async function goosedumpRecall(query, options = {}, signal, executablePath) {
   return { hits: parseMemoryHits(output.stdout), warning: output.stderr.trim() };
 }
 async function goosedumpMemoryRemember(target, signal, executablePath) {
-  const output = await runGoosedumpAsync(["memory", "remember", target, "--json"], signal, executablePath);
+  const output = await runGoosedumpAsync(["memory", "learn", target, "--json"], signal, executablePath);
   return output.stdout.trim();
 }
 async function goosedumpMemoryForget(target, signal, executablePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goosedump",
-  "version": "0.12.28",
+  "version": "0.12.30",
   "description": "Pi extension for goosedump session search, durable memory, and compaction",
   "keywords": [
     "compaction",
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.82.1",
-    "@jarkkojs/goosedump": "^0.12.28",
+    "@jarkkojs/goosedump": "^0.12.30",
     "@sinclair/typebox": "^0.34.49"
   },
   "devDependencies": {