lemma-mcp 0.11.4 → 0.11.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/guides/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA+JzC,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6C/E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
1
+ {"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/guides/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA8NzC,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6C/E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
@@ -142,6 +142,68 @@ Improve code structure without changing behavior. Every step must be safe, verif
142
142
  - Behavior preservation is absolute — any behavior change, intentional or not, disqualifies it as refactoring
143
143
  - Stop when the code communicates intent clearly — don't refactor for aesthetic perfection`,
144
144
  },
145
+ {
146
+ guide: "html-output-strategy",
147
+ category: "content-formatting",
148
+ keywords: ["html", "markdown", "output", "format", "spec", "report", "diagram", "visualization", "görselleştirme", "rapor"],
149
+ contexts: ["format selection", "output quality", "information density", "visual clarity", "document sharing"],
150
+ learnings: [
151
+ "HTML is 2-4x more token-expensive than Markdown — only use when the visual payoff justifies it",
152
+ "Nobody reads 100+ line Markdown specs — HTML with visual structure gets actually reviewed",
153
+ "Self-contained HTML files (no CDN) are shareable via a single link — Markdown requires special viewers",
154
+ "Interactive HTML prototypes (sliders, buttons) enable two-way feedback loops with the LLM",
155
+ "When in doubt, default to Markdown — HTML should be an intentional choice, not the default",
156
+ ],
157
+ anti_patterns: [
158
+ "Generating HTML for every output regardless of complexity — wastes tokens and slows iteration",
159
+ "Using Markdown for 200+ line architectural specs — information density becomes unreadable",
160
+ "Adding JavaScript interactivity to documents meant for passive reading — over-engineering",
161
+ "External CDN dependencies in HTML files — breaks offline and reduces portability",
162
+ ],
163
+ known_pitfalls: [
164
+ "HTML diff noise in version control — use Markdown for git-tracked docs",
165
+ "Over-designing HTML output when the task just needs a quick answer",
166
+ "Forgetting to make HTML responsive — mobile viewing breaks without basic CSS",
167
+ ],
168
+ source_memories: ["seed_html_output_strategy"],
169
+ description: `## HTML vs Markdown Output Strategy — Context-Aware Format Selection
170
+
171
+ ### Mission
172
+ Select the optimal output format (HTML or Markdown) based on the task's purpose, audience, and longevity — maximizing readability and impact without wasting tokens.
173
+
174
+ ### Protocol
175
+
176
+ 1. **ASSESS the task:** Before generating output, ask three questions:
177
+ - Will this output be read again later or shared with others? (longevity)
178
+ - Does it benefit from visual structure (tables, diagrams, side-by-side comparisons)? (richness)
179
+ - Is the user going to interact with it or just consume it? (interactivity)
180
+
181
+ 2. **DECIDE the format:**
182
+
183
+ | Condition | Format | Reason |
184
+ |---|---|---|
185
+ | Short answer, quick task, code edit | Markdown | Speed, token efficiency |
186
+ | Long spec, plan, architecture doc | HTML | Readability, visual hierarchy |
187
+ | Diagram, flowchart, visualization needed | HTML | SVG, CSS layout |
188
+ | Side-by-side comparison (2+ approaches) | HTML | Grid/column layout |
189
+ | Report shared with team or stakeholders | HTML | Link-sharing, browser-rendered |
190
+ | Interactive prototype or parameter tuning | HTML | Sliders, buttons, live preview |
191
+ | Version-controlled documentation | Markdown | Clean git diffs |
192
+ - When in doubt → Markdown (default safe choice)
193
+
194
+ 3. **EXECUTE with quality:**
195
+ - If HTML: include basic responsive CSS, semantic structure, clean design. Single self-contained file.
196
+ - If Markdown: keep it concise, use headers/tables/code blocks properly.
197
+
198
+ 4. **COMMUNICATE the choice:** If switching to HTML for a non-obvious reason, briefly note why.
199
+
200
+ ### Rules
201
+ - NEVER default to HTML for every output — token cost is 2-4x higher
202
+ - NEVER use HTML for code edits, quick answers, or chat-style responses
203
+ - ALWAYS keep HTML files self-contained (no external CSS/JS CDN links)
204
+ - ALWAYS consider the user's implicit intent: "make a plan" → probably HTML, "fix this bug" → Markdown
205
+ - If the user explicitly requests a format → honor it, skip the decision framework`,
206
+ },
145
207
  ];
146
208
  export function seedGuides(guides) {
147
209
  const existingNames = new Set(guides.map(g => g.guide.toLowerCase()));
@@ -172,7 +234,7 @@ export function seedGuides(guides) {
172
234
  enables: [],
173
235
  superseded_by: null,
174
236
  deprecated: false,
175
- source_memories: [],
237
+ source_memories: seed.source_memories || [],
176
238
  validated_by: [],
177
239
  };
178
240
  guides.push(guide);
@@ -1 +1 @@
1
- {"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/guides/seed.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/guides/seed.ts"],"names":[],"mappings":"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"}
@@ -1 +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;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"}
1
+ {"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuKlD,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"}
@@ -110,45 +110,46 @@ AI-assisted development changes which code quality principles matter most. Tradi
110
110
  - AI tends to copy-paste instead of refactor — always check cross-file impact`,
111
111
  },
112
112
  {
113
- id: "seed_senior_engineer_role",
114
- title: "Senior Engineering Mindset",
115
- description: "Principal engineer role for software/coding tasks. Full comprehension before action, context-first, production-grade output.",
113
+ id: "seed_html_output_strategy",
114
+ title: "HTML vs Markdown Output Strategy",
115
+ description: "Context-aware format selection: use HTML for complex specs/diagrams/reports, Markdown for quick answers/code edits. Default: Markdown.",
116
116
  type: "pattern",
117
- fragment: `## Senior Engineering Mindset (Software & Coding Tasks Only)
117
+ related_guides: ["html-output-strategy"],
118
+ fragment: `## HTML vs Markdown Output Strategy — Context-Aware Format Selection
118
119
 
119
120
  ### Context
120
- 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.
121
-
122
- ### Activation Scope
123
- ACTIVE when task involves: coding, debugging, refactoring, architecture, API design, system design, code review, performance optimization, security review, build/deploy configuration.
124
- INACTIVE for: general questions, content writing, research, translations, casual conversation.
125
-
126
- ### Pre-Code Protocol (Mandatory)
127
- 1. **COMPREHEND** the full codebase context BEFORE proposing changes: architecture, file hierarchy, module relationships, dependency chains, data flow, state management, API contracts
128
- 2. **TRACE the impact** identify every component affected by the proposed change
129
- 3. **ASSESS risks** side-effects, scalability, security, performance, backward compatibility
130
- 4. **STATE intent** — briefly confirm what will change and why, before writing code
131
-
132
- ### Engineering Standards
133
- - Every change must be production-grade: no shortcuts, no TODO hacks, no "we'll fix it later"
134
- - Preserve existing design patterns and conventions — deviate only when there is clear, measurable benefit
135
- - Minimum viable change with maximum impact no unnecessary rewrites
136
- - Maintain full compatibility with surrounding systems
137
- - Prioritize readability, maintainability, and team scalability
138
-
139
- ### Change Principles
140
- - Think before coding. Understand before modifying. Analyze before suggesting.
141
- - If context is insufficient, explicitly state what additional files or systems need examination
142
- - When unsure about a design decision, surface the trade-off rather than silently choosing one side
143
- - One logical change per step — verify each step before proceeding
144
- - Preserve long-term project health over short-term convenience
121
+ LLMs default to Markdown output, but HTML is significantly more effective for certain task types. This decision framework selects the optimal format based on task purpose, audience, and longevity maximizing readability without wasting tokens.
122
+
123
+ ### Decision Framework
124
+
125
+ **Use HTML when:**
126
+ - Long spec, plan, or architecture document (>100 lines of structured content)
127
+ - Diagram, flowchart, or visualization needed (SVG support)
128
+ - Side-by-side comparison of 2+ approaches (grid/column layout)
129
+ - Report or document shared with team/stakeholders (link-shareable, browser-rendered)
130
+ - Interactive prototype with sliders, buttons, or live preview
131
+ - The user will revisit this output later as reference
132
+
133
+ **Use Markdown when:**
134
+ - Quick answers, chat-style responses, code edits
135
+ - Task lists, meeting notes, short summaries
136
+ - Version-controlled docs (README, CHANGELOG)clean git diffs
137
+ - Rapid iteration / drafting phase
138
+ - Token efficiency matters (HTML costs 2-4x more tokens)
139
+
140
+ **Default: Markdown** — safe choice when uncertain.
145
141
 
146
142
  ### Rules
147
- - NEVER write code without understanding why the existing code is the way it is
148
- - NEVER assume if something is unclear, investigate or ask
149
- - NEVER break existing functionality for the sake of a "cleaner" implementation
150
- - ALWAYS consider: "What breaks if this change is wrong?"and mitigate accordingly
151
- - ALWAYS match the existing code style, naming conventions, and patterns of the project`,
143
+ - NEVER default to HTML for every output token cost is 2-4x higher
144
+ - NEVER use HTML for code edits, quick answers, or chat-style responses
145
+ - ALWAYS keep HTML files self-contained (no external CDN dependencies)
146
+ - If the user explicitly requests a format, honor itskip the framework
147
+ - When switching to HTML, briefly note why (e.g., "HTML format for visual comparison")
148
+
149
+ ### Anti-patterns
150
+ - Generating HTML for a 10-line summary (token waste)
151
+ - Using Markdown for a 200-line architectural spec (nobody reads dense Markdown)
152
+ - Adding interactivity when the user just wants to read (over-engineering)`,
152
153
  },
153
154
  ];
154
155
  export function seedMemory(memory) {
@@ -187,7 +188,7 @@ export function seedMemory(memory) {
187
188
  negative_feedback: 0,
188
189
  last_refined: null,
189
190
  type: seed.type,
190
- related_guides: [],
191
+ related_guides: seed.related_guides || [],
191
192
  };
192
193
  memory.push(fragment);
193
194
  seeded++;
@@ -1 +1 @@
1
- {"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/memory/seed.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lemma-mcp",
3
- "version": "0.11.4",
3
+ "version": "0.11.5",
4
4
  "description": "Persistent memory layer for LLMs via MCP",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",