stackmem 1.0.9 → 1.0.11

package/dist/cli.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
 import { createInterface } from "node:readline/promises";
 import { analyzeCodebase } from "./ast-index.js";
 import { getDeviceId } from "./device.js";
-import { applyContextBudget, buildSummaryContent, clusterMemories, computeDecayScore, computeMemoryLinks, decideSaveAction, estimateTokens, indicatesFailedApproach, isAuthRelatedFile, isCodeFile, isQualityMessage, scoreMemoryRelevance, } from "./scoring.js";
+import { applyContextBudget, buildSummaryContent, clusterMemories, computeDecayScore, computeMemoryLinks, decideSaveAction, estimateTokens, extractEntities, indicatesFailedApproach, isAuthRelatedFile, isCodeFile, isQualityMessage, scoreMemoryRelevance, } from "./scoring.js";
 import { supabase } from "./storage.js";
 const CONTEXT_BUDGET_TOKENS = 2000;
 const COMPRESSION_THRESHOLD = 20;
@@ -32,6 +32,7 @@ function usage() {
   cm search [--project <name>] <query>
   cm resolve [project] <memory-id>
   cm delete [project] <memory-id>
+  cm inspect [project] <memory-id>
   cm compress [project]
   cm init <project> <path>
   cm context [--project <name>] <task>
@@ -88,6 +89,13 @@ function cmdHelp() {
   cm delete [project] <memory-id>
       Delete a memory and any memory_links referencing it.
 
+  cm inspect [project] <memory-id>
+      Show a rich view of a single memory: type, content, created
+      date, access count, decay score, and resolved status, plus
+      every linked memory (in either link direction) with its link
+      score, and any execution_log fixes whose problem or solution
+      shares a key entity with the memory's content.
+
   cm compress [project]
       Cluster related unresolved memories (needs 20+) and collapse
       clusters of 3 or more into a single summary memory.
@@ -496,6 +504,86 @@ async function cmdDelete(project, memoryId) {
         fail(`Failed to delete memory: ${error.message}`);
     console.log(`Deleted memory [${memoryId}]`);
 }
+// --- cm inspect ------------------------------------------------------------
+function formatDate(dateString) {
+    return new Date(dateString).toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+    });
+}
+async function cmdInspect(project, memoryId) {
+    const { data: memory, error } = await supabase
+        .from("memories")
+        .select("*")
+        .eq("project", project)
+        .eq("id", memoryId)
+        .single();
+    if (error || !memory)
+        fail(`Memory [${memoryId}] not found for "${project}".`);
+    const decayScore = computeDecayScore(new Date(memory.created_at), memory.access_count ?? 0);
+    const { data: links, error: linksError } = await supabase
+        .from("memory_links")
+        .select("source_id, target_id, score")
+        .or(`source_id.eq.${memoryId},target_id.eq.${memoryId}`);
+    if (linksError)
+        fail(`Failed to load memory links: ${linksError.message}`);
+    const linkedEntries = (links ?? []).map((link) => ({
+        linkedId: link.source_id === memoryId ? link.target_id : link.source_id,
+        score: link.score,
+    }));
+    let linkedMemories = [];
+    if (linkedEntries.length > 0) {
+        const linkedIds = linkedEntries.map((entry) => entry.linkedId);
+        const { data: linkedRows, error: linkedError } = await supabase
+            .from("memories")
+            .select("id, type, content, created_at")
+            .in("id", linkedIds);
+        if (linkedError)
+            fail(`Failed to load linked memories: ${linkedError.message}`);
+        const scoreById = new Map(linkedEntries.map((entry) => [entry.linkedId, entry.score]));
+        linkedMemories = (linkedRows ?? [])
+            .map((row) => ({ ...row, score: scoreById.get(row.id) ?? 0 }))
+            .sort((a, b) => b.score - a.score);
+    }
+    const entities = extractEntities(memory.content);
+    const { data: fixes, error: fixesError } = await supabase
+        .from("execution_log")
+        .select("problem, solution")
+        .eq("project", project);
+    if (fixesError)
+        fail(`Failed to load execution log: ${fixesError.message}`);
+    const relatedFixes = (fixes ?? []).filter((fix) => {
+        const fixEntities = extractEntities(`${fix.problem} ${fix.solution}`);
+        for (const entity of entities) {
+            if (fixEntities.has(entity))
+                return true;
+        }
+        return false;
+    });
+    const divider = "─".repeat(40);
+    console.log(divider);
+    console.log(`${memory.type.toUpperCase()} · accessed ${memory.access_count ?? 0}x · decay ${decayScore.toFixed(2)}`);
+    console.log(divider);
+    console.log(memory.content);
+    console.log("");
+    console.log(`Created: ${formatDate(memory.created_at)}`);
+    console.log(`Status:  ${memory.resolved ? "resolved" : "unresolved"}`);
+    console.log("");
+    console.log(`LINKED MEMORIES (${linkedMemories.length})`);
+    for (const linked of linkedMemories) {
+        console.log(`  └─ [score: ${linked.score.toFixed(2)}] ${linked.type.toUpperCase()}`);
+        console.log(`     ${linked.content}`);
+        console.log(`     ${formatDate(linked.created_at)}`);
+        console.log("");
+    }
+    if (relatedFixes.length > 0) {
+        console.log(`RELATED FIXES (${relatedFixes.length})`);
+        for (const fix of relatedFixes) {
+            console.log(`  └─ FIX: ${fix.problem} → ${fix.solution}`);
+        }
+    }
+}
 // --- cm init -------------------------------------------------------------
 // The hook logic lives in its own .mjs file (not directly in
 // .git/hooks/post-commit) so its module type is unambiguous — an
@@ -840,6 +928,14 @@ function writeProjectFile(project, resolvedPath) {
 // non-interactive). Returns how many memories were actually saved.
 async function seedMemories(project, resolvedPath) {
     let seededCount = 0;
+    const { data: existingRows, error: existingError } = await supabase
+        .from("memories")
+        .select("id, content")
+        .eq("project", project)
+        .eq("resolved", false);
+    if (existingError)
+        fail(`Failed to load memories: ${existingError.message}`);
+    const existingMemories = existingRows ?? [];
     const packageJsonPath = nodePath.join(resolvedPath, "package.json");
     if (nodeFs.existsSync(packageJsonPath)) {
         try {
@@ -849,14 +945,18 @@ async function seedMemories(project, resolvedPath) {
                 ...Object.keys(pkg.devDependencies ?? {}),
             ];
             if (depNames.length > 0) {
-                const { error } = await supabase.from("memories").insert({
-                    project,
-                    type: "discovery",
-                    content: `tech stack: ${depNames.join(", ")}`,
-                    device_id: getDeviceId(),
-                });
-                if (!error)
-                    seededCount++;
+                const content = `tech stack: ${depNames.join(", ")}`;
+                const decision = decideSaveAction(content, existingMemories);
+                if (decision.action !== "duplicate") {
+                    const { error } = await supabase.from("memories").insert({
+                        project,
+                        type: "discovery",
+                        content,
+                        device_id: getDeviceId(),
+                    });
+                    if (!error)
+                        seededCount++;
+                }
             }
         }
         catch {
@@ -871,14 +971,18 @@ async function seedMemories(project, resolvedPath) {
             .filter((line) => /^[A-Z_]+=/.test(line))
             .map((line) => line.split("=")[0]);
         if (varNames.length > 0) {
-            const { error } = await supabase.from("memories").insert({
-                project,
-                type: "constraint",
-                content: `required env vars: ${varNames.join(", ")}`,
-                device_id: getDeviceId(),
-            });
-            if (!error)
-                seededCount++;
+            const content = `required env vars: ${varNames.join(", ")}`;
+            const decision = decideSaveAction(content, existingMemories);
+            if (decision.action !== "duplicate") {
+                const { error } = await supabase.from("memories").insert({
+                    project,
+                    type: "constraint",
+                    content,
+                    device_id: getDeviceId(),
+                });
+                if (!error)
+                    seededCount++;
+            }
         }
     }
     analyzeCodebase(resolvedPath);
@@ -1402,6 +1506,15 @@ async function main() {
             await cmdDelete(project, memoryId);
             break;
         }
+        case "inspect": {
+            const split = splitOptionalProject(args, 1);
+            if (!split)
+                usage();
+            const project = requireProject(split.project);
+            const [memoryId] = split.rest;
+            await cmdInspect(project, memoryId);
+            break;
+        }
         case "compress": {
             const split = splitOptionalProject(args, 0);
             if (!split)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackmem",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "",
   "main": "index.js",
   "type": "module",

package/src/cli.ts

@@ -14,6 +14,7 @@ import {
   computeMemoryLinks,
   decideSaveAction,
   estimateTokens,
+  extractEntities,
   indicatesFailedApproach,
   isAuthRelatedFile,
   isCodeFile,
@@ -50,6 +51,7 @@ function usage(): never {
   cm search [--project <name>] <query>
   cm resolve [project] <memory-id>
   cm delete [project] <memory-id>
+  cm inspect [project] <memory-id>
   cm compress [project]
   cm init <project> <path>
   cm context [--project <name>] <task>
@@ -107,6 +109,13 @@ function cmdHelp() {
   cm delete [project] <memory-id>
       Delete a memory and any memory_links referencing it.
 
+  cm inspect [project] <memory-id>
+      Show a rich view of a single memory: type, content, created
+      date, access count, decay score, and resolved status, plus
+      every linked memory (in either link direction) with its link
+      score, and any execution_log fixes whose problem or solution
+      shares a key entity with the memory's content.
+
   cm compress [project]
       Cluster related unresolved memories (needs 20+) and collapse
       clusters of 3 or more into a single summary memory.
@@ -593,6 +602,107 @@ async function cmdDelete(project: string, memoryId: string) {
   console.log(`Deleted memory [${memoryId}]`);
 }
 
+// --- cm inspect ------------------------------------------------------------
+
+function formatDate(dateString: string): string {
+  return new Date(dateString).toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+  });
+}
+
+async function cmdInspect(project: string, memoryId: string) {
+  const { data: memory, error } = await supabase
+    .from("memories")
+    .select("*")
+    .eq("project", project)
+    .eq("id", memoryId)
+    .single();
+
+  if (error || !memory) fail(`Memory [${memoryId}] not found for "${project}".`);
+
+  const decayScore = computeDecayScore(new Date(memory.created_at), memory.access_count ?? 0);
+
+  const { data: links, error: linksError } = await supabase
+    .from("memory_links")
+    .select("source_id, target_id, score")
+    .or(`source_id.eq.${memoryId},target_id.eq.${memoryId}`);
+
+  if (linksError) fail(`Failed to load memory links: ${linksError.message}`);
+
+  const linkedEntries = (links ?? []).map((link) => ({
+    linkedId: link.source_id === memoryId ? link.target_id : link.source_id,
+    score: link.score,
+  }));
+
+  let linkedMemories: Array<{
+    id: string;
+    type: string;
+    content: string;
+    created_at: string;
+    score: number;
+  }> = [];
+
+  if (linkedEntries.length > 0) {
+    const linkedIds = linkedEntries.map((entry) => entry.linkedId);
+    const { data: linkedRows, error: linkedError } = await supabase
+      .from("memories")
+      .select("id, type, content, created_at")
+      .in("id", linkedIds);
+
+    if (linkedError) fail(`Failed to load linked memories: ${linkedError.message}`);
+
+    const scoreById = new Map(linkedEntries.map((entry) => [entry.linkedId, entry.score]));
+    linkedMemories = (linkedRows ?? [])
+      .map((row) => ({ ...row, score: scoreById.get(row.id) ?? 0 }))
+      .sort((a, b) => b.score - a.score);
+  }
+
+  const entities = extractEntities(memory.content);
+  const { data: fixes, error: fixesError } = await supabase
+    .from("execution_log")
+    .select("problem, solution")
+    .eq("project", project);
+
+  if (fixesError) fail(`Failed to load execution log: ${fixesError.message}`);
+
+  const relatedFixes = (fixes ?? []).filter((fix) => {
+    const fixEntities = extractEntities(`${fix.problem} ${fix.solution}`);
+    for (const entity of entities) {
+      if (fixEntities.has(entity)) return true;
+    }
+    return false;
+  });
+
+  const divider = "─".repeat(40);
+  console.log(divider);
+  console.log(
+    `${memory.type.toUpperCase()} · accessed ${memory.access_count ?? 0}x · decay ${decayScore.toFixed(2)}`
+  );
+  console.log(divider);
+  console.log(memory.content);
+  console.log("");
+  console.log(`Created: ${formatDate(memory.created_at)}`);
+  console.log(`Status:  ${memory.resolved ? "resolved" : "unresolved"}`);
+  console.log("");
+
+  console.log(`LINKED MEMORIES (${linkedMemories.length})`);
+  for (const linked of linkedMemories) {
+    console.log(`  └─ [score: ${linked.score.toFixed(2)}] ${linked.type.toUpperCase()}`);
+    console.log(`     ${linked.content}`);
+    console.log(`     ${formatDate(linked.created_at)}`);
+    console.log("");
+  }
+
+  if (relatedFixes.length > 0) {
+    console.log(`RELATED FIXES (${relatedFixes.length})`);
+    for (const fix of relatedFixes) {
+      console.log(`  └─ FIX: ${fix.problem} → ${fix.solution}`);
+    }
+  }
+}
+
 // --- cm init -------------------------------------------------------------
 
 // The hook logic lives in its own .mjs file (not directly in
@@ -957,6 +1067,16 @@ function writeProjectFile(project: string, resolvedPath: string): void {
 async function seedMemories(project: string, resolvedPath: string): Promise<number> {
   let seededCount = 0;
 
+  const { data: existingRows, error: existingError } = await supabase
+    .from("memories")
+    .select("id, content")
+    .eq("project", project)
+    .eq("resolved", false);
+
+  if (existingError) fail(`Failed to load memories: ${existingError.message}`);
+
+  const existingMemories = existingRows ?? [];
+
   const packageJsonPath = nodePath.join(resolvedPath, "package.json");
   if (nodeFs.existsSync(packageJsonPath)) {
     try {
@@ -966,13 +1086,17 @@ async function seedMemories(project: string, resolvedPath: string): Promise<numb
         ...Object.keys(pkg.devDependencies ?? {}),
       ];
       if (depNames.length > 0) {
-        const { error } = await supabase.from("memories").insert({
-          project,
-          type: "discovery",
-          content: `tech stack: ${depNames.join(", ")}`,
-          device_id: getDeviceId(),
-        });
-        if (!error) seededCount++;
+        const content = `tech stack: ${depNames.join(", ")}`;
+        const decision = decideSaveAction(content, existingMemories);
+        if (decision.action !== "duplicate") {
+          const { error } = await supabase.from("memories").insert({
+            project,
+            type: "discovery",
+            content,
+            device_id: getDeviceId(),
+          });
+          if (!error) seededCount++;
+        }
       }
     } catch {
       // Malformed package.json — skip the tech-stack memory.
@@ -988,13 +1112,17 @@ async function seedMemories(project: string, resolvedPath: string): Promise<numb
       .map((line) => line.split("=")[0]);
 
     if (varNames.length > 0) {
-      const { error } = await supabase.from("memories").insert({
-        project,
-        type: "constraint",
-        content: `required env vars: ${varNames.join(", ")}`,
-        device_id: getDeviceId(),
-      });
-      if (!error) seededCount++;
+      const content = `required env vars: ${varNames.join(", ")}`;
+      const decision = decideSaveAction(content, existingMemories);
+      if (decision.action !== "duplicate") {
+        const { error } = await supabase.from("memories").insert({
+          project,
+          type: "constraint",
+          content,
+          device_id: getDeviceId(),
+        });
+        if (!error) seededCount++;
+      }
     }
   }
 
@@ -1582,6 +1710,14 @@ async function main() {
       await cmdDelete(project, memoryId);
       break;
     }
+    case "inspect": {
+      const split = splitOptionalProject(args, 1);
+      if (!split) usage();
+      const project = requireProject(split.project);
+      const [memoryId] = split.rest;
+      await cmdInspect(project, memoryId);
+      break;
+    }
     case "compress": {
       const split = splitOptionalProject(args, 0);
       if (!split) usage();