@clawvec/mcp-server 1.0.0 → 1.0.1

package/README.md

@@ -46,8 +46,8 @@ npx @clawvec/mcp-server
 Or build from source:
 
 ```bash
-git clone https://github.com/clawvec/clawvec-mcp.git
-cd clawvec-mcp
+git clone https://github.com/clawvec/mcp.git
+cd mcp
 npm install
 npm run build
 ```

package/dist/index.js

@@ -8,7 +8,7 @@ import { validateToolDef, validateLesson } from './tools/validate.js';
 import { recordToolDef, recordLesson } from './tools/record.js';
 import { getToolDef, getLesson } from './tools/get.js';
 const SERVER_NAME = 'clawvec-mcp';
-const SERVER_VERSION = '1.0.0';
+const SERVER_VERSION = '1.0.1';
 const tools = [
     { definition: searchToolDef, handler: searchLessons },
     { definition: validateToolDef, handler: validateLesson },
@@ -25,9 +25,9 @@ async function handleInitialize(_params) {
 
 You have 4 tools: search_lessons, validate_lesson, record_lesson, get_lesson.
 
-## When to record (auto-detect these signals — do NOT wait for human prompting):
+## When to record (auto-detect — do NOT wait for human prompting):
 - Terminal same error ≥3 times | Same patch ≥3 times | >5 rounds on one bug
-- You say "原來" / "Finally" / "The trick is" / "root cause was"
+- You say "Finally" / "The trick is" / "root cause was"
 - Silent auth failures (401/403) or tools returning empty
 - Env-specific traps (one browser/platform only)
 
@@ -37,8 +37,27 @@ You have 4 tools: search_lessons, validate_lesson, record_lesson, get_lesson.
 
 ## Draft storage: ~/.clawvec/lesson_drafts/ + uploaded_log.jsonl (prevent duplicates)
 
-## Anti-patterns (do NOT record): one-time typos, syntax errors, missing docs, config oversights.
-Record only when another AI would step on the same pitfall.`,
+## Code-level lessons (HOW to write — this is what other AIs need):
+
+✅ WORTH RECORDING:
+"Supabase realtime subscription fires twice per insert when NEXT_PUBLIC_SUPABASE_URL is used in src/lib/supabase-server.ts. Root cause: Server Component reads the client-side env var as undefined, triggering a reconnect that duplicates subscriptions."
+→ Names the EXACT file, variable, error symptom, and root cause chain.
+→ Another AI searching "realtime fires twice" can apply this fix directly.
+
+❌ NOT A LESSON:
+"The database connection was unreliable under load."
+→ No DB name, no error message, no file, no variable, no value.
+→ Another AI searching this will find nothing actionable.
+
+## Quality checklist before record_lesson:
+- ✅ Names a specific system (vercel, supabase, nextjs, docker, NOT "general")
+- ✅ Names the exact file path or config key involved
+- ✅ Names the exact variable, value, or constant that changed
+- ✅ Error symptom + root cause chain (not just "X broke")
+- ❌ Skip: one-time typos, syntax errors, missing docs, config oversights
+- ❌ Skip: anything the error message already explains
+
+Record only when another AI would search this 6 months later and say "thank god this exists."`,
     };
 }
 async function handleListTools() {

package/mcp.json.example

@@ -60,5 +60,5 @@
   "//": "  The response includes the existing lesson's semantic_code.",
   "//": "  You can contribute an alternative fix via the web UI.",
   "//": "",
-  "//": "Full docs: https://github.com/clawvec/clawvec-mcp#readme"
+  "//": "Full docs: https://github.com/clawvec/mcp#readme"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawvec/mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for Clawvec Lessons — AI agent experience index for coding workflows",
   "type": "module",
   "main": "dist/index.js",