stackmem 1.0.8 → 1.0.10

package/dist/cli.js

@@ -51,6 +51,9 @@ function usage() {
 function cmdHelp() {
     console.log(`cm — coding memory CLI
 
+  Works with Claude Code, Cursor, and Windsurf — 'cm init' writes the
+  CLAUDE.md, .cursorrules, and .windsurfrules files each tool reads.
+
   [project] is optional everywhere below if a .stackmem file exists in
   the current directory (written by 'cm init'). Otherwise pass it explicitly.
 
@@ -91,8 +94,11 @@ function cmdHelp() {
 
   cm init <project> <path>
       Install a git post-commit hook in the repo at <path>, register
-      the stackmem MCP server with Claude Code, write a CLAUDE.md and
-      .stackmem file, and seed initial memories from the project scan.
+      the stackmem MCP server with Claude Code, write a CLAUDE.md,
+      .cursorrules, .windsurfrules, and .stackmem file, and seed
+      initial memories from the project scan. .cursorrules and
+      .windsurfrules (for Cursor and Windsurf) are skipped if they
+      already exist.
 
   cm context [--project <name>] <task>
       Return only the top 5 memories most relevant to a specific
@@ -787,6 +793,43 @@ cm save ${project} <type> "<content>"
     nodeFs.writeFileSync(claudeMdPath, content, "utf-8");
     console.log("CLAUDE.md written.");
 }
+const EDITOR_RULES_CONTENT = `# stackmem
+
+At the start of every session, run:
+cm start
+
+and paste the output here before starting work.
+
+When you make a decision, discover a constraint,
+reject an approach, or make a discovery, save it:
+cm save <type> "<content>"
+
+Types: decision, rejection, constraint, discovery
+`;
+// Returns true if the file was written, false if it already existed
+// (and was skipped).
+function writeCursorRules(resolvedPath) {
+    const cursorRulesPath = nodePath.join(resolvedPath, ".cursorrules");
+    if (nodeFs.existsSync(cursorRulesPath)) {
+        console.log(".cursorrules already exists — skipping.");
+        return false;
+    }
+    nodeFs.writeFileSync(cursorRulesPath, EDITOR_RULES_CONTENT, "utf-8");
+    console.log(".cursorrules written.");
+    return true;
+}
+// Returns true if the file was written, false if it already existed
+// (and was skipped).
+function writeWindsurfRules(resolvedPath) {
+    const windsurfRulesPath = nodePath.join(resolvedPath, ".windsurfrules");
+    if (nodeFs.existsSync(windsurfRulesPath)) {
+        console.log(".windsurfrules already exists — skipping.");
+        return false;
+    }
+    nodeFs.writeFileSync(windsurfRulesPath, EDITOR_RULES_CONTENT, "utf-8");
+    console.log(".windsurfrules written.");
+    return true;
+}
 function writeProjectFile(project, resolvedPath) {
     const stackmemPath = nodePath.join(resolvedPath, STACKMEM_FILE);
     nodeFs.writeFileSync(stackmemPath, `${project}\n`, "utf-8");
@@ -797,6 +840,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 {
@@ -806,14 +857,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 {
@@ -828,14 +883,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);
@@ -869,6 +928,8 @@ async function cmdInit(project, targetPath) {
     console.log(`coding-memory hook installed for project ${project} at ${targetPath}`);
     registerMcpServer(DIST_INDEX_PATH);
     writeClaudeMd(project, resolvedPath);
+    const cursorRulesWritten = writeCursorRules(resolvedPath);
+    const windsurfRulesWritten = writeWindsurfRules(resolvedPath);
     const seededCount = await seedMemories(project, resolvedPath);
     console.log(`Seeded ${seededCount} initial memories from project scan.`);
     const backendOk = await verifyBackendConnection(project);
@@ -876,6 +937,8 @@ async function cmdInit(project, targetPath) {
     console.log("✓ Git hook installed");
     console.log("✓ MCP server registered");
     console.log("✓ CLAUDE.md written");
+    console.log(`✓ .cursorrules ${cursorRulesWritten ? "written" : "already exists"}`);
+    console.log(`✓ .windsurfrules ${windsurfRulesWritten ? "written" : "already exists"}`);
     console.log(`✓ Seeded ${seededCount} memories from project scan`);
     if (backendOk) {
         console.log("✓ Backend connection verified");

package/package.json

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

package/src/cli.ts

@@ -70,6 +70,9 @@ function usage(): never {
 function cmdHelp() {
   console.log(`cm — coding memory CLI
 
+  Works with Claude Code, Cursor, and Windsurf — 'cm init' writes the
+  CLAUDE.md, .cursorrules, and .windsurfrules files each tool reads.
+
   [project] is optional everywhere below if a .stackmem file exists in
   the current directory (written by 'cm init'). Otherwise pass it explicitly.
 
@@ -110,8 +113,11 @@ function cmdHelp() {
 
   cm init <project> <path>
       Install a git post-commit hook in the repo at <path>, register
-      the stackmem MCP server with Claude Code, write a CLAUDE.md and
-      .stackmem file, and seed initial memories from the project scan.
+      the stackmem MCP server with Claude Code, write a CLAUDE.md,
+      .cursorrules, .windsurfrules, and .stackmem file, and seed
+      initial memories from the project scan. .cursorrules and
+      .windsurfrules (for Cursor and Windsurf) are skipped if they
+      already exist.
 
   cm context [--project <name>] <task>
       Return only the top 5 memories most relevant to a specific
@@ -895,6 +901,50 @@ cm save ${project} <type> "<content>"
   console.log("CLAUDE.md written.");
 }
 
+const EDITOR_RULES_CONTENT = `# stackmem
+
+At the start of every session, run:
+cm start
+
+and paste the output here before starting work.
+
+When you make a decision, discover a constraint,
+reject an approach, or make a discovery, save it:
+cm save <type> "<content>"
+
+Types: decision, rejection, constraint, discovery
+`;
+
+// Returns true if the file was written, false if it already existed
+// (and was skipped).
+function writeCursorRules(resolvedPath: string): boolean {
+  const cursorRulesPath = nodePath.join(resolvedPath, ".cursorrules");
+
+  if (nodeFs.existsSync(cursorRulesPath)) {
+    console.log(".cursorrules already exists — skipping.");
+    return false;
+  }
+
+  nodeFs.writeFileSync(cursorRulesPath, EDITOR_RULES_CONTENT, "utf-8");
+  console.log(".cursorrules written.");
+  return true;
+}
+
+// Returns true if the file was written, false if it already existed
+// (and was skipped).
+function writeWindsurfRules(resolvedPath: string): boolean {
+  const windsurfRulesPath = nodePath.join(resolvedPath, ".windsurfrules");
+
+  if (nodeFs.existsSync(windsurfRulesPath)) {
+    console.log(".windsurfrules already exists — skipping.");
+    return false;
+  }
+
+  nodeFs.writeFileSync(windsurfRulesPath, EDITOR_RULES_CONTENT, "utf-8");
+  console.log(".windsurfrules written.");
+  return true;
+}
+
 function writeProjectFile(project: string, resolvedPath: string): void {
   const stackmemPath = nodePath.join(resolvedPath, STACKMEM_FILE);
   nodeFs.writeFileSync(stackmemPath, `${project}\n`, "utf-8");
@@ -907,6 +957,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 {
@@ -916,13 +976,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.
@@ -938,13 +1002,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++;
+      }
     }
   }
 
@@ -990,6 +1058,8 @@ async function cmdInit(project: string, targetPath: string) {
 
   registerMcpServer(DIST_INDEX_PATH);
   writeClaudeMd(project, resolvedPath);
+  const cursorRulesWritten = writeCursorRules(resolvedPath);
+  const windsurfRulesWritten = writeWindsurfRules(resolvedPath);
 
   const seededCount = await seedMemories(project, resolvedPath);
   console.log(`Seeded ${seededCount} initial memories from project scan.`);
@@ -1000,6 +1070,12 @@ async function cmdInit(project: string, targetPath: string) {
   console.log("✓ Git hook installed");
   console.log("✓ MCP server registered");
   console.log("✓ CLAUDE.md written");
+  console.log(
+    `✓ .cursorrules ${cursorRulesWritten ? "written" : "already exists"}`
+  );
+  console.log(
+    `✓ .windsurfrules ${windsurfRulesWritten ? "written" : "already exists"}`
+  );
   console.log(`✓ Seeded ${seededCount} memories from project scan`);
   if (backendOk) {
     console.log("✓ Backend connection verified");