@dpesch/mantisbt-mcp-server 1.8.3 → 1.9.0

package/dist/tools/notes.js

@@ -12,7 +12,7 @@ export function registerNoteTools(server, client) {
     // ---------------------------------------------------------------------------
     server.registerTool('list_notes', {
         title: 'List Issue Notes',
-        description: 'List all notes (comments) attached to a MantisBT issue.',
+        description: 'List all notes (comments) attached to a MantisBT issue. Note: get_issue already includes notes in its response — use list_notes only when you need notes without fetching the full issue.',
         inputSchema: z.object({
             issue_id: z.coerce.number().int().positive().describe('Numeric issue ID'),
         }),

package/docs/cookbook.de.md

@@ -145,7 +145,7 @@ Gibt die auf der eigenen MantisBT-Instanz konfigurierten Enum-Werte zurück. Vor
 }
 ```
 
-> **Hinweis:** Die von `get_issue_enums()` zurückgegebenen Namen können lokalisiert sein. `create_issue` und `update_issue` erwarten für `severity` und `priority` **kanonische englische Namen** (z.B. `minor`, `major`, `normal`) — bei Unsicherheit das `canonical_name`-Feld in der Antwort prüfen.
+> **Hinweis:** Auf lokalisierten Instanzen liefert `get_issue_enums()` im Feld `name` den lokalisierten Begriff und optional im Feld `canonical_name` den englischen Originalnamen. `create_issue` akzeptiert **beides** — sowohl den kanonischen englischen Namen (z.B. `minor`) als auch den lokalisierten Namen (z.B. `Unschönheit`). Der Server löst den Wert automatisch auf.
 
 ---
 
@@ -347,6 +347,8 @@ Gibt nur Issues mit einem bestimmten Status zurück. Der Filter wird clientseiti
 }
 ```
 
+> **Hinweis:** Kanonische Statusnamen (z.B. `"new"`, `"resolved"`) werden zur numerischen ID aufgelöst und per `issue.status.id` gefiltert — funktioniert auch auf lokalisierten Installationen, bei denen die API übersetzte Statusnamen zurückgibt. Direkt übergebene lokalisierte Namen (z.B. `"Neu"`) werden als Fallback über den Namen abgeglichen. Das Kürzel `"open"` (alle Status mit id < 80) steht unabhängig von der Installationssprache immer zur Verfügung.
+
 > **Hinweis:** Bei großen Projekten mit vielen Issues stattdessen einen vorgespeicherten MantisBT-Filter über `filter_id` verwenden — die clientseitige Filterung durchsucht nur die ersten 500 Issues (10 Seiten × 50).
 
 ---
@@ -456,8 +458,8 @@ Legt ein neues Issue in MantisBT an.
 - `project_id` — numerische Projekt-ID
 - `category` — Kategoriename als Zeichenkette
 - `description` — _(optional)_ ausführliche Beschreibung
-- `priority` — _(optional)_ kanonischer englischer Prioritätsname: `none`, `low`, `normal`, `high`, `urgent`, `immediate` — lokalisierte Bezeichnungen über `get_issue_enums()` ermitteln
-- `severity` — _(optional)_ kanonischer englischer Schweregrad-Name: `feature`, `trivial`, `text`, `tweak`, `minor`, `major`, `crash`, `block`; Standard ist `"minor"` — lokalisierte Bezeichnungen über `get_issue_enums()` ermitteln
+- `priority` — _(optional)_ Priorität: kanonischer englischer Name (`none`, `low`, `normal`, `high`, `urgent`, `immediate`) oder lokalisierter Begriff. Standard: `"normal"`. Alle verfügbaren Werte über `get_issue_enums()` ermitteln.
+- `severity` — _(optional)_ Schweregrad: kanonischer englischer Name (`feature`, `trivial`, `text`, `tweak`, `minor`, `major`, `crash`, `block`) oder lokalisierter Begriff. Standard: `"minor"`. Alle verfügbaren Werte über `get_issue_enums()` ermitteln.
 - `handler` — _(optional)_ Benutzername des Bearbeiters (wird automatisch in eine ID aufgelöst)
 - `handler_id` — _(optional)_ numerische Benutzer-ID des Bearbeiters (Alternative zu `handler`)
 
@@ -500,11 +502,11 @@ Legt ein neues Issue in MantisBT an.
 
 **Fehler: unbekannter Schweregrad oder unbekannte Priorität**
 
-Wird ein nicht erkannter Name für `severity` oder `priority` übergeben, gibt der Server einen Fehler zurück, der die gültigen Werte auflistet:
+Der Server prüft zuerst kanonische englische Namen und fällt dann auf einen Live-`get_issue_enums`-Lookup zurück. Ein Fehler wird nur zurückgegeben, wenn der Wert weder kanonisch noch lokalisiert erkannt wird:
 
-> Error: Invalid severity "schwerer Fehler". Valid canonical names: feature, trivial, text, tweak, minor, major, crash, block. Call get_issue_enums to see localized labels.
+> Error: Invalid severity "xyz". Valid canonical names: feature, trivial, text, tweak, minor, major, crash, block. Call get_issue_enums to see localized labels.
 
-Mit `get_issue_enums` lassen sich die kanonischen Namen ermitteln, die `create_issue` akzeptiert.
+Mit `get_issue_enums` lassen sich alle akzeptierten Werte ermitteln — sowohl kanonische als auch lokalisierte Namen funktionieren.
 
 ---
 
@@ -519,6 +521,8 @@ Löst ein Issue auf und schließt es. **Immer beide Felder** `status` und `resol
 - `fields.status` — Status-Objekt mit Name
 - `fields.resolution` — Auflösungs-Objekt mit ID
 
+> **Hinweis:** Alle Enum-Felder (`status`, `priority`, `severity`, `resolution`, `reproducibility`) akzeptieren kanonische englische Namen, lokalisierte Namen oder numerische IDs. Der Server löst Namen automatisch zu IDs auf — dadurch ist die Übergabe sprachunabhängig.
+
 **Request:**
 
 ```json
@@ -1246,6 +1250,7 @@ Findet Issues, die einem natürlichsprachigen Suchbegriff semantisch ähnlich si
 **Parameter:**
 - `query` — Suchanfrage in natürlicher Sprache
 - `top_n` — _(optional)_ Anzahl zurückzugebender Ergebnisse; Standard 10
+- `highlight` — _(optional)_ bei `true` werden keyword-basierte Ausschnitte je Ergebnis ergänzt; Standard `false`
 
 **Request:**
 
@@ -1280,6 +1285,7 @@ Reichert Suchergebnisse mit bestimmten Feldern aus MantisBT an. Ohne `select` we
 - `query` — Suchanfrage in natürlicher Sprache
 - `top_n` — _(optional)_ Anzahl der Ergebnisse
 - `select` — kommagetrennte Feldnamen, die für jedes Ergebnis abgerufen werden
+- `highlight` — _(optional)_ bei `true` werden keyword-basierte Ausschnitte je Ergebnis ergänzt; Standard `false`
 
 **Request:**
 
@@ -1310,6 +1316,57 @@ Reichert Suchergebnisse mit bestimmten Feldern aus MantisBT an. Ohne `select` we
 
 ---
 
+### Suche mit Keyword-Highlights
+
+Zeigt, welcher Teil eines Issues mit der Suchanfrage übereinstimmt. Jedes Ergebnis, das lexikalisch mit der Anfrage übereinstimmt, erhält ein `highlights`-Feld mit fett hervorgehobenen Ausschnitten. Highlights sind keyword-basiert (lexikalisch), nicht semantisch — Ergebnisse ohne lexikalische Übereinstimmung haben kein `highlights`-Feld.
+
+**Tool:** `search_issues`
+
+**Parameter:**
+- `query` — Suchanfrage in natürlicher Sprache
+- `top_n` — _(optional)_ Anzahl der Ergebnisse; Standard 10
+- `highlight` — auf `true` setzen, um Highlights zu aktivieren
+
+**Request:**
+
+```json
+{
+  "query": "Login-Fehler nach Passwort-Reset",
+  "top_n": 5,
+  "highlight": true
+}
+```
+
+**Response:**
+
+```json
+[
+  {
+    "id": 1042,
+    "score": 0.91,
+    "highlights": {
+      "summary": "**Login**-Button reagiert nach **Passwort**-**Reset** auf Mobile Safari nicht",
+      "description": "…Benutzer tippt auf **Login** und es passiert nichts. Reproduzierbar nach einem **Passwort**-**Reset**-Vorgang…"
+    }
+  },
+  {
+    "id": 987,
+    "score": 0.84,
+    "highlights": {
+      "summary": "**Login** schlägt mit 401 fehl — Token ungültig"
+    }
+  },
+  {
+    "id": 1015,
+    "score": 0.79
+  }
+]
+```
+
+> **Hinweis:** Nur Ergebnisse mit mindestens einer Keyword-Übereinstimmung in `summary` oder `description` erhalten ein `highlights`-Feld. Der `description`-Ausschnitt umfasst ca. 300 Zeichen, zentriert um den ersten Treffer. Wenn zusätzlich `select` gesetzt ist und `summary` oder `description` enthält, werden die Highlights aus den abgerufenen Feldern generiert; andernfalls stammen sie aus den indizierten Metadaten.
+
+---
+
 ## Projekte & Kategorien
 
 ### Projektkategorien auflisten
@@ -1635,7 +1692,7 @@ Gibt eine kombinierte Ansicht eines einzelnen Projekts zurück: Projektfelder so
 
 ### Issue-Enum-Werte lesen
 
-Gibt gültige ID/Name-Paare für alle Issue-Enum-Felder zurück (Severity, Priority, Status, Resolution, Reproducibility). Vor `create_issue` oder `update_issue` verwenden, um kanonische englische Namen nachzuschlagen.
+Gibt gültige ID/Name-Paare für alle Issue-Enum-Felder zurück (Severity, Priority, Status, Resolution, Reproducibility). Bei `create_issue` werden sowohl kanonische englische Namen als auch lokalisierte `name`/`label`-Werte akzeptiert — diese Ressource hilft, alle verfügbaren Werte zu ermitteln.
 
 **Ressource-URI:** `mantis://enums`
 

package/docs/cookbook.md

@@ -145,7 +145,7 @@ Returns the enum values configured on your specific MantisBT instance. Use this
 }
 ```
 
-> **Note:** The names returned by `get_issue_enums()` may be localized. `create_issue` and `update_issue` require **canonical English names** for `severity` and `priority` (e.g. `minor`, `major`, `normal`) — look at the `canonical_name` field in the response if you are unsure.
+> **Note:** On localized installations, `get_issue_enums()` returns a `name` in the local language and an optional `canonical_name` with the English original. `create_issue` accepts **both** — pass either the canonical English name (e.g. `minor`) or the localized name (e.g. `Unschönheit`). The server resolves the value automatically.
 
 ---
 
@@ -347,6 +347,8 @@ Returns only issues with a specific status. The filter is applied client-side
 }
 ```
 
+> **Note:** Canonical status names (e.g. `"new"`, `"resolved"`) are resolved to their numeric ID and matched by `issue.status.id` — this works correctly even on localized installations where the API returns translated status names. Localized names passed directly (e.g. `"Neu"`) are matched by name as a fallback. The `"open"` shorthand (all statuses with id < 80) is always available regardless of installation language.
+
 > **Note:** For large projects with many issues, use a pre-saved MantisBT filter via `filter_id` instead — client-side filtering only scans the first 500 issues (10 pages × 50).
 
 ---
@@ -456,8 +458,8 @@ Creates a new issue in MantisBT.
 - `project_id` — numeric project ID
 - `category` — category name string
 - `description` — _(optional)_ detailed description
-- `priority` — _(optional)_ canonical English priority name: `none`, `low`, `normal`, `high`, `urgent`, `immediate` — call `get_issue_enums()` to see localized labels
-- `severity` — _(optional)_ canonical English severity name: `feature`, `trivial`, `text`, `tweak`, `minor`, `major`, `crash`, `block`; default is `"minor"` — call `get_issue_enums()` to see localized labels
+- `priority` — _(optional)_ priority: canonical English name (`none`, `low`, `normal`, `high`, `urgent`, `immediate`) or localized label. Default: `"normal"`. Use `get_issue_enums()` to see all available values.
+- `severity` — _(optional)_ severity: canonical English name (`feature`, `trivial`, `text`, `tweak`, `minor`, `major`, `crash`, `block`) or localized label. Default: `"minor"`. Use `get_issue_enums()` to see all available values.
 - `handler` — _(optional)_ assignee username (resolved to ID automatically)
 - `handler_id` — _(optional)_ assignee numeric user ID (alternative to `handler`)
 
@@ -500,11 +502,11 @@ Creates a new issue in MantisBT.
 
 **Error: unknown severity or priority**
 
-If an unrecognized name is passed for `severity` or `priority`, the server returns an error listing valid values:
+The server first checks canonical English names, then falls back to a live `get_issue_enums` lookup. An error is only returned if the value matches neither:
 
-> Error: Invalid severity "schwerer Fehler". Valid canonical names: feature, trivial, text, tweak, minor, major, crash, block. Call get_issue_enums to see localized labels.
+> Error: Invalid severity "xyz". Valid canonical names: feature, trivial, text, tweak, minor, major, crash, block. Call get_issue_enums to see localized labels.
 
-Use `get_issue_enums` to discover the canonical names accepted by `create_issue`.
+Use `get_issue_enums` to discover all accepted values — both canonical and localized names work.
 
 ---
 
@@ -519,6 +521,8 @@ Resolves and closes an issue. Always set **both** `status` and `resolution` —
 - `fields.status` — status object with name
 - `fields.resolution` — resolution object with id
 
+> **Note:** All enum fields (`status`, `priority`, `severity`, `resolution`, `reproducibility`) accept the canonical English name, a localized name, or a numeric `id`. The server resolves names to IDs automatically — IDs are always sent to the API, ensuring language-independence.
+
 **Request:**
 
 ```json
@@ -1246,6 +1250,7 @@ Finds issues semantically similar to a natural language query. Returns issue IDs
 **Parameters:**
 - `query` — natural language search query
 - `top_n` — _(optional)_ number of results to return; default 10
+- `highlight` — _(optional)_ when `true`, adds keyword-matched excerpts to each result; default `false`
 
 **Request:**
 
@@ -1280,6 +1285,7 @@ Enriches search results with specific fields fetched from MantisBT. Without `sel
 - `query` — natural language search query
 - `top_n` — _(optional)_ number of results
 - `select` — comma-separated field names to fetch for each result
+- `highlight` — _(optional)_ when `true`, adds keyword-matched excerpts to each result; default `false`
 
 **Request:**
 
@@ -1310,6 +1316,57 @@ Enriches search results with specific fields fetched from MantisBT. Without `sel
 
 ---
 
+### Search with keyword highlights
+
+Shows which part of an issue matched the search query. Each result that has keyword overlap with the query receives a `highlights` field with bold-marked excerpts. Highlights are keyword-based (lexical), not semantic — results with no lexical overlap will not have a `highlights` field.
+
+**Tool:** `search_issues`
+
+**Parameters:**
+- `query` — natural language search query
+- `top_n` — _(optional)_ number of results; default 10
+- `highlight` — set to `true` to enable highlights
+
+**Request:**
+
+```json
+{
+  "query": "login error after password reset",
+  "top_n": 5,
+  "highlight": true
+}
+```
+
+**Response:**
+
+```json
+[
+  {
+    "id": 1042,
+    "score": 0.91,
+    "highlights": {
+      "summary": "**Login** button unresponsive after **password** **reset** on mobile Safari",
+      "description": "…user taps **login** and nothing happens. Reproducible after a **password** **reset** flow…"
+    }
+  },
+  {
+    "id": 987,
+    "score": 0.84,
+    "highlights": {
+      "summary": "**Login** fails with 401 — token invalidated"
+    }
+  },
+  {
+    "id": 1015,
+    "score": 0.79
+  }
+]
+```
+
+> **Note:** Only results with at least one keyword match in `summary` or `description` receive a `highlights` field. The `description` excerpt is approximately 300 characters, centred around the first match. When `select` is also set and includes `summary` or `description`, highlights are generated from the fetched fields; otherwise they come from the indexed metadata.
+
+---
+
 ## Projects & Categories
 
 ### List project categories
@@ -1635,7 +1692,7 @@ Returns a combined view of a single project: its fields plus all members, versio
 
 ### Read issue enum values
 
-Returns valid ID/name pairs for all issue enum fields (severity, priority, status, resolution, reproducibility). Use this to look up canonical English names before calling `create_issue` or `update_issue`.
+Returns valid ID/name pairs for all issue enum fields (severity, priority, status, resolution, reproducibility). For `create_issue`, both the canonical English name and the localized `name`/`label` are accepted — this resource helps discover all available values.
 
 **Resource URI:** `mantis://enums`
 

package/docs/examples.de.md

@@ -155,6 +155,18 @@ Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzel
 
 ---
 
+### Keyword-Highlights
+
+> »Suche nach Login-Fehlern und zeige mir, welche Stelle im Ticket relevant ist.«
+
+> »Finde Issues zum Passwort-Reset-Ablauf und hebe die passenden Stellen hervor, damit ich die Ergebnisse schnell überfliegen kann.«
+
+> »Suche nach 'Rechnungsexport' und markiere die relevanten Ausschnitte in Titel und Beschreibung.«
+
+Exakte Parameter und Response-Shape: [Cookbook — Suche mit Keyword-Highlights](cookbook.de.md#suche-mit-keyword-highlights).
+
+---
+
 ### Unscharfe / terminologieunabhängige Suche
 
 > »Finde Issues zu 'doppelten Einträgen' — sie könnten auch als 'zweimal angezeigt', 'doppelte Datensätze' oder 'Phantom-Zeilen' beschrieben sein.«

package/docs/examples.md

@@ -155,6 +155,18 @@ Semantic search understands the *meaning* of your question — not just keywords
 
 ---
 
+### Keyword highlights
+
+> "Search for login errors and show me which part of each ticket is relevant."
+
+> "Find issues about the password reset flow and highlight the matching passages so I can quickly scan the results."
+
+> "Search for 'invoice export' and highlight the relevant excerpts in summary and description."
+
+For exact parameters and response shape, see the [Cookbook — Search with keyword highlights](cookbook.md#search-with-keyword-highlights).
+
+---
+
 ### Fuzzy / terminology-independent search
 
 > "Find issues about 'duplicate entries' — they might also be described as 'shown twice', 'double records', or 'phantom rows'."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpesch/mantisbt-mcp-server",
-  "version": "1.8.3",
+  "version": "1.9.0",
   "mcpName": "io.github.dpesch/mantisbt-mcp-server",
   "description": "MCP server for MantisBT REST API – read and manage bug tracker issues",
   "author": "Dominik Pesch",

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.dpesch/mantisbt-mcp-server",
   "title": "MantisBT MCP Server",
   "description": "MantisBT MCP server – manage issues, notes, files, tags, and relationships. With semantic search.",
-  "version": "1.8.3",
+  "version": "1.9.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@dpesch/mantisbt-mcp-server",
-      "version": "1.8.3",
+      "version": "1.9.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/tests/fixtures/get_issue.json

@@ -58,6 +58,28 @@
       "sticky": false,
       "created_at": "2026-03-16T15:40:38+01:00",
       "updated_at": "2026-03-16T15:40:38+01:00",
+      "notes": [
+        {
+          "id": 1001,
+          "reporter": { "id": 51, "name": "user_1" },
+          "text": "First note on this issue.",
+          "view_state": { "id": 10, "name": "public", "label": "öffentlich" },
+          "attachments": [],
+          "type": "note",
+          "created_at": "2026-03-16T16:00:00+01:00",
+          "updated_at": "2026-03-16T16:00:00+01:00"
+        },
+        {
+          "id": 1002,
+          "reporter": { "id": 51, "name": "user_1" },
+          "text": "Second note on this issue.",
+          "view_state": { "id": 10, "name": "public", "label": "öffentlich" },
+          "attachments": [],
+          "type": "note",
+          "created_at": "2026-03-16T17:00:00+01:00",
+          "updated_at": "2026-03-16T17:00:00+01:00"
+        }
+      ],
       "history": [
         {
           "created_at": "2026-03-16T15:40:38+01:00",

package/tests/helpers/search-mocks.ts

@@ -12,10 +12,29 @@ export const MOCK_VECTOR = Array(384).fill(0.1) as number[];
 // makeMockStore
 // ---------------------------------------------------------------------------
 
-export function makeMockStore(options?: { lastSyncedAt?: string | null; itemCount?: number; lastKnownTotal?: number | null }): VectorStore {
+export interface MockStoreItem {
+  id: number;
+  score?: number;
+  updated_at?: string;
+}
+
+export function makeMockStore(options?: {
+  lastSyncedAt?: string | null;
+  itemCount?: number;
+  lastKnownTotal?: number | null;
+  items?: MockStoreItem[];
+}): VectorStore {
   const lastSyncedAt = options?.lastSyncedAt ?? null;
+  const seedItems = options?.items ?? null;
   const addedItems: VectorStoreItem[] = [];
-  let count = options?.itemCount ?? 0;
+  const itemMap = new Map<number, VectorStoreItem>(
+    (seedItems ?? []).map(i => [i.id, {
+      id: i.id,
+      vector: MOCK_VECTOR,
+      metadata: { summary: `Issue ${i.id}`, updated_at: i.updated_at },
+    }])
+  );
+  let count = options?.itemCount ?? seedItems?.length ?? 0;
 
   return {
     add: vi.fn(async (item: VectorStoreItem) => {
@@ -28,12 +47,16 @@ export function makeMockStore(options?: { lastSyncedAt?: string | null; itemCoun
       }
       count += items.length;
     }),
-    search: vi.fn(async (_vec: number[], topN: number) =>
-      Array.from({ length: Math.min(topN, count) }, (_, i) => ({
+    search: vi.fn(async (_vec: number[], topN: number) => {
+      if (seedItems) {
+        return seedItems.slice(0, topN).map(i => ({ id: i.id, score: i.score ?? 0.9 }));
+      }
+      return Array.from({ length: Math.min(topN, count) }, (_, i) => ({
         id: i + 1,
         score: 1 - i * 0.1,
-      }))
-    ),
+      }));
+    }),
+    getItem: vi.fn(async (id: number) => itemMap.get(id) ?? null),
     delete: vi.fn(async () => {}),
     count: vi.fn(async () => count),
     clear: vi.fn(async () => {

package/tests/search/highlight.test.ts

@@ -0,0 +1,129 @@
+import { describe, it, expect } from 'vitest';
+import { extractTerms, highlightText, extractSnippet } from '../../src/search/highlight.js';
+
+// ---------------------------------------------------------------------------
+// extractTerms
+// ---------------------------------------------------------------------------
+
+describe('extractTerms', () => {
+  it('splits by whitespace and returns terms of length >= 3', () => {
+    expect(extractTerms('login error')).toEqual(['login', 'error']);
+  });
+
+  it('filters out terms shorter than 3 characters', () => {
+    expect(extractTerms('a db login')).toEqual(['login']);
+  });
+
+  it('deduplicates terms case-insensitively', () => {
+    const terms = extractTerms('Login login LOGIN');
+    expect(terms).toHaveLength(1);
+    expect(terms[0]!.toLowerCase()).toBe('login');
+  });
+
+  it('sorts longest terms first to prevent partial-match overlap', () => {
+    const terms = extractTerms('err error errors');
+    expect(terms[0]).toBe('errors');
+    expect(terms[1]).toBe('error');
+  });
+
+  it('returns empty array for empty query', () => {
+    expect(extractTerms('')).toEqual([]);
+  });
+
+  it('returns empty array when all terms are too short', () => {
+    expect(extractTerms('a ab')).toEqual([]);
+  });
+
+  it('trims whitespace', () => {
+    expect(extractTerms('  login  error  ')).toEqual(['login', 'error']);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// highlightText
+// ---------------------------------------------------------------------------
+
+describe('highlightText', () => {
+  it('wraps a matching term in **bold**', () => {
+    expect(highlightText('Login failed', ['login'])).toBe('**Login** failed');
+  });
+
+  it('is case-insensitive', () => {
+    expect(highlightText('CRASH on startup', ['crash'])).toBe('**CRASH** on startup');
+  });
+
+  it('highlights multiple terms', () => {
+    const result = highlightText('Login error occurred', ['login', 'error']);
+    expect(result).toBe('**Login** **error** occurred');
+  });
+
+  it('returns original text when no terms match', () => {
+    expect(highlightText('Something unrelated', ['crash'])).toBe('Something unrelated');
+  });
+
+  it('returns original text when terms array is empty', () => {
+    expect(highlightText('Login failed', [])).toBe('Login failed');
+  });
+
+  it('does not match term as substring within a word (word-boundary-aware)', () => {
+    // "or" should NOT match inside "error"
+    expect(highlightText('error occurred', ['or'])).toBe('error occurred');
+  });
+
+  it('escapes special regex characters in terms', () => {
+    // Term with special regex chars should not throw
+    expect(() => highlightText('test (foo)', ['(foo)'])).not.toThrow();
+  });
+
+  it('highlights all occurrences of a term', () => {
+    const result = highlightText('login and login again', ['login']);
+    expect(result).toBe('**login** and **login** again');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// extractSnippet
+// ---------------------------------------------------------------------------
+
+describe('extractSnippet', () => {
+  it('returns full text highlighted when text is short', () => {
+    const text = 'Login error on startup';
+    const result = extractSnippet(text, ['login']);
+    expect(result).toBe('**Login** error on startup');
+  });
+
+  it('returns first ~300 chars around the first match for long text', () => {
+    const prefix = 'x'.repeat(200);
+    const text = `${prefix} login error ${' unrelated text'.repeat(30)}`;
+    const result = extractSnippet(text, ['login']);
+    expect(result).toContain('**login**');
+    expect(result.length).toBeLessThanOrEqual(350); // snippet + some overhead
+  });
+
+  it('centers snippet around first match', () => {
+    const padding = 'word '.repeat(60); // ~300 chars before the match
+    const text = `${padding}crash happens here ${'and more text '.repeat(30)}`;
+    const result = extractSnippet(text, ['crash']);
+    expect(result).toContain('**crash**');
+  });
+
+  it('returns first 300 chars (no highlight) when no term matches', () => {
+    const text = 'a'.repeat(600);
+    const result = extractSnippet(text, ['nomatch']);
+    expect(result).toBe('a'.repeat(300) + '…');
+  });
+
+  it('returns full text (no truncation) when text is shorter than 300 chars and no match', () => {
+    const text = 'Short text with no match';
+    const result = extractSnippet(text, ['nomatch']);
+    expect(result).toBe(text);
+  });
+
+  it('respects custom contextChars parameter', () => {
+    const padding = 'x'.repeat(100);
+    const text = `${padding} crash ${padding}`;
+    const result = extractSnippet(text, ['crash'], 50);
+    expect(result).toContain('**crash**');
+    expect(result.length).toBeLessThanOrEqual(150);
+  });
+});