lemma-mcp 0.11.2 → 0.11.3

package/README.md

@@ -4,10 +4,18 @@
 
 # Lemma — Persistent Memory for LLMs via MCP
 
+[![npm version](https://img.shields.io/npm/v/lemma-mcp.svg)](https://www.npmjs.com/package/lemma-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 [English](README.md) | [Türkçe](docs/README.tr.md)
 
 Lemma is an MCP server that gives LLMs persistent, cross-session memory. Memories are injected automatically into every session — no explicit tool call needed. Knowledge evolves through use: frequently accessed memories strengthen, unused ones fade, and patterns are promoted into reusable skills. An autonomous intelligence layer runs in the background — detecting conflicts, suggesting actions, and auto-linking related knowledge.
 
+<p align="center">
+  <img src="assets/visualizer-demo.gif" width="700" alt="Lemma Memory Visualizer Demo">
+</p>
+
+<p align="center"><em>Memory Visualizer — <code>lemma -vis</code></em></p>
+
 ## Quick Start
 
 Add Lemma to your MCP client configuration:

package/dist/memory/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4HlD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmDxF;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAqKlD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmDxF;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}

package/dist/memory/seed.js

@@ -109,6 +109,47 @@ AI-assisted development changes which code quality principles matter most. Tradi
 - Code churn increases from 3.1% to 5.7% with AI adoption — don't neglect refactoring
 - AI tends to copy-paste instead of refactor — always check cross-file impact`,
     },
+    {
+        id: "seed_senior_engineer_role",
+        title: "Senior Engineering Mindset",
+        description: "Principal engineer role for software/coding tasks. Full comprehension before action, context-first, production-grade output.",
+        type: "pattern",
+        fragment: `## Senior Engineering Mindset (Software & Coding Tasks Only)
+
+### Context
+When the task involves writing, reviewing, or modifying code — adopt the role of a Principal Engineer and System Architect with deep production-scale experience. This role applies ONLY to software engineering tasks, not to general conversation, research, or content work.
+
+### Activation Scope
+ACTIVE when task involves: coding, debugging, refactoring, architecture, API design, system design, code review, performance optimization, security review, build/deploy configuration.
+INACTIVE for: general questions, content writing, research, translations, casual conversation.
+
+### Pre-Code Protocol (Mandatory)
+1. **COMPREHEND** the full codebase context BEFORE proposing changes: architecture, file hierarchy, module relationships, dependency chains, data flow, state management, API contracts
+2. **TRACE the impact** — identify every component affected by the proposed change
+3. **ASSESS risks** — side-effects, scalability, security, performance, backward compatibility
+4. **STATE intent** — briefly confirm what will change and why, before writing code
+
+### Engineering Standards
+- Every change must be production-grade: no shortcuts, no TODO hacks, no "we'll fix it later"
+- Preserve existing design patterns and conventions — deviate only when there is clear, measurable benefit
+- Minimum viable change with maximum impact — no unnecessary rewrites
+- Maintain full compatibility with surrounding systems
+- Prioritize readability, maintainability, and team scalability
+
+### Change Principles
+- Think before coding. Understand before modifying. Analyze before suggesting.
+- If context is insufficient, explicitly state what additional files or systems need examination
+- When unsure about a design decision, surface the trade-off rather than silently choosing one side
+- One logical change per step — verify each step before proceeding
+- Preserve long-term project health over short-term convenience
+
+### Rules
+- NEVER write code without understanding why the existing code is the way it is
+- NEVER assume — if something is unclear, investigate or ask
+- NEVER break existing functionality for the sake of a "cleaner" implementation
+- ALWAYS consider: "What breaks if this change is wrong?" — and mitigate accordingly
+- ALWAYS match the existing code style, naming conventions, and patterns of the project`,
+    },
 ];
 export function seedMemory(memory) {
     const existingIds = new Set(memory.map(f => f.id));

package/dist/memory/seed.js.map

@@ -1 +1 @@
-{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAU9B,MAAM,KAAK,GAAgB;IACzB;QACE,EAAE,EAAE,sBAAsB;QAC1B,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,kGAAkG;QAC/G,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8B0C;KACrD;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,uGAAuG;QACpH,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAgC+C;KAC1D;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,oGAAoG;QACjH,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;8EAyBgE;KAC3E;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,8HAA8H;QAC3I,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wFAkC0E;KACrF;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAmB;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC9C,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE;YAC/B,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,CAAC,QAAQ,CAAC;YAChB,cAAc,EAAE,EAAE;YAClB,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,CAAC;YACnB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,CAAC;YACpB,iBAAiB,EAAE,CAAC;YACpB,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,cAAc,EAAE,EAAE;SACnB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,EAAE,CAAC;QACT,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,0BAA0B,OAAO,mBAAmB,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lemma-mcp",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "Persistent memory layer for LLMs via MCP",
   "type": "module",
   "main": "dist/index.js",
@@ -16,6 +16,7 @@
   "files": [
     "dist",
     "assets/visualizer.html",
+    "assets/visualizer-demo.gif",
     "README.md",
     "README.tr.md",
     "LICENSE"