Merge pull request #20: docs v0.9.5

Release v0.9.5 documentation, Spanish translations, and British English standardisation

Author: mgks

.gitignore

@@ -149,5 +149,6 @@ pnpm-lock.yaml
 .docmd/
 .docmd-search/
 _docmd-search/
+.threads/
 .vscode/
 local-tars/

docmd-assistant/de/configuration.md

@@ -23,6 +23,7 @@ interface AssistantOptions {
   maxTokens?: number;
   reasoning?: boolean | 'none' | 'low' | 'medium' | 'high';
   headers?: Record<string, string>;
+  contextWindow?: number;
 }
 ```
 
@@ -44,6 +45,7 @@ interface AssistantOptions {
 | `maxTokens` | `number` | Maximale Token pro Antwort | Anbieter-Standard |
 | `reasoning` | `boolean \| string` | Umschalten des erweiterten Reasoning-Modus (`false`, `'low'`, `'medium'`, `'high'`) | `false` |
 | `headers` | `Record<string, string>` | Benutzerdefinierte HTTP-Header für Relay-Anfragen | `{}` |
+| `contextWindow` | `number` | Maximale Zeichenanzahl des an das Modell übergebenen Dokumentationskontexts pro Turn. `0` = unbegrenzt (vollständiger Inhalt für höchste Wiedergabetreue). | `0` (unbegrenzt) |
 
 ::: callout tip "Standard-System-Prompt"
 Wenn kein `systemPrompt` angegeben ist, wendet die Engine einen Standard-Prompt an, der Regeln für die Assistentenidentität, bevorzugte Werkzeugaufrufe und klickbare Zitationslinks durchsetzt.

docmd-assistant/de/navigation.json

@@ -34,6 +34,14 @@
     "icon": "scroll",
     "collapsible": false,
     "children": [
+      {
+        "title": "v0.1.17",
+        "path": "/release-notes/0-1-17"
+      },
+      {
+        "title": "v0.1.16",
+        "path": "/release-notes/0-1-16"
+      },
       {
         "title": "v0.1.15",
         "path": "/release-notes/0-1-15"

docmd-assistant/de/release-notes/0-1-16.md

@@ -0,0 +1,42 @@
+---
+title: "Versionshinweise v0.1.16"
+description: "Versionshinweise für docmd-assistant v0.1.16 mit strukturierter Markdown-DOM-Extraktion, unbegrenztem Kontextfenster, Multi-Turn-Deduplizierung für Cloud-Analysen und Bereinigung von Anführungszeichen."
+---
+
+`docmd-assistant` v0.1.16 führt eine strukturierte Markdown-DOM-Extraktion für das Lesen von Dokumentationsseiten, eine unbegrenzte Kontextfenster-Übergabe für hochwertige Antworten, Deduplizierung von Multi-Turn-Abfragen in Cloud-Analysen und eine verfeinerte Abfragebereinigung ein.
+
+## Hauptfunktionen & Verbesserungen
+
+### Strukturierte Markdown-Inhaltsextraktion
+
+- **Erhaltung von Codeblöcken & Formatierung**: Der integrierte DOM-Seitenleser (`read_documentation_page`) wandelt HTML-Dokumente nun in sauberes, strukturiertes Markdown anstelle von flachem Text um. Codeblöcke mit Sprachbezeichnungen (`pre/code`), Überschriften (`#`–`######`), Aufzählungen (`-`) und Absatzabstände bleiben vollständig erhalten.
+- **Entfernung von Chrome- und Navigations-Elementen**: Nicht relevante Elemente (`nav`, `aside`, `header`, `footer`, `.toc`, `.sidebar`, `.docmd-ai-drawer` und `[aria-hidden="true"]`) werden vor der Extraktion gefiltert, sodass nur echter Dokumentationstext und Code an das LLM übergeben werden.
+
+### Unbegrenzte Kontextfenster-Übergabe (`contextWindow`)
+
+- **Hochwertige Dokumentensynthese**: Die bisherige Begrenzung auf 3.500 Zeichen in `read_documentation_page` wurde entfernt, sodass vollständige Referenzseiten, Konfigurationstabellen und Codebeispiele eingelesen werden können.
+- **Konfigurierbare Kontextgröße**: Neue Option `contextWindow` in `AssistantOptions` (Standardwert: `0` / unbegrenzt mit vollständiger Übergabe), die statische Zeichengrenzen ablöst und bei Bedarf Token-Optimierung ermöglicht.
+
+### Optimierung von Multi-Turn-Relay & Analysen
+
+- **Kennzeichnung von Tool-Aufrufen (`isToolFollowUp`)**: Folgeaufrufe innerhalb autonomer Multi-Turn-Schleifen übermitteln nun `isToolFollowUp: true`. Dadurch können Cloud-Relays und Analysedienste initiale Besucheranfragen von internen Tool-Zwischenschritten unterscheiden und doppelte Metrikeinträge vermeiden.
+- **Bereinigung von Abfragen**: Entfernt angehängte Suchkontext-Blöcke (`\n\n[Documentation Search Context...]`) aus `originalUserQuery` und eliminiert umschließende Anführungszeichen, wodurch verwaiste Anführungszeichen in Chat-Protokollen vermieden werden.
+
+## Behobene Probleme
+
+- **Doppelte Analyseprotokollierung**: Ein Problem wurde behoben, bei dem interne Tool-Ausführungsschritte (z. B. Suchen und anschließendes Seitenlesen) als wiederholte Benutzerabfragen erfasst wurden.
+- **Führendes Anführungszeichen-Artefakt (`"`)**: Behebt ein Problem bei der Bereinigung, durch das ein verwaistes Anführungszeichen vor Besucherfragen in Cloud-Protokollen verblieb.
+- **Codeblock-Verflachung**: Behebt den Verlust von Einrückungen und Zeilenumbrüchen beim Abrufen von Dokumentationsseiten über `read_documentation_page`.
+
+## Upgrade
+
+::: tabs
+== tab "npm" icon:package
+```bash
+npm install docmd-assistant@0.1.16
+```
+== tab "pnpm" icon:zap
+```bash
+pnpm add docmd-assistant@0.1.16
+```
+:::

docmd-assistant/de/release-notes/0-1-17.md

@@ -0,0 +1,46 @@
+---
+title: "Versionshinweise v0.1.17"
+description: "Versionshinweise für docmd-assistant v0.1.17 mit universellem seitenunabhängigem System-Prompt, Versions- und Projekt-gefilterter Suche, Token-Ökonomie-DOM-Inhaltsbegrenzung und Netzwerkfehlertoleranz."
+---
+
+`docmd-assistant` v0.1.17 macht die Assistant-Engine vollständig universell und seitenunabhängig, führt gezielte Versions- und Teilprojekt-Suchfilter ein, integriert eine Token-sparende Inhaltsbegrenzung für umfangreiche Dokumentationsseiten, stärkt die Grenzen des Kontextfensters und verbessert die Netzwerkfehlertoleranz.
+
+## Hauptfunktionen & Verbesserungen
+
+### Universeller & seitenunabhängiger System-Prompt
+
+- **Authentische Wissensfindung**: Ersetzt fest codierte Konfigurationsannahmen durch einen universellen, seitenunabhängigen Prompt. Anstatt vorgegebene Konfigurationsschemata vorauszusetzen, ermittelt und begründet der Assistent seine Antworten dynamisch über die verfügbaren Tools (`search_documentation`, `read_documentation_page`). Dies gewährleistet ein natürliches Zusammenspiel mit jeder Dokumentationsseite, jedem Entwickler-Blog oder technischen Leitfaden.
+- **Konsistente Identität**: Bewahrt die Kernidentität des „docmd assistant“ als professioneller KI-Guide, der Fragen präzise anhand des dokumentierten Inhalts beantwortet.
+
+### Versions- & Projekt-gefilterte Dokumentationssuche
+
+- **Gezielte Versionsfilterung**: Die Parameterstruktur von `search_documentation` wurde um optionale Filter für `version` (z. B. `"0.9.0"`, `"0.8.0"`, `"latest"`) und `project` erweitert, sodass Dokumentationen mit mehreren Versionen oder Teilprojekten gezielt durchsucht werden können.
+- **Weitergabe an benutzerdefinierte Suchfunktionen**: An `createStandardTools` übergebene benutzerdefinierte Such-Handler erhalten nun die Argumente `(query, project, version)` zur feingliedrigen Indexabfrage.
+
+### Intelligente Inhaltsbegrenzung & Kontextfenster-Absicherung
+
+- **DOM-Leser Token-Ökonomie**: In `read_documentation_page` wurde eine Obergrenze von 8.000 Zeichen mit einem klaren Fortsetzungshinweis (`...[content capped for token economy]`) eingeführt. Dies schützt das Token-Budget vor übergroßen API-Spezifikationen, während relevanter Erklärungstext und Codebeispiele erhalten bleiben.
+- **Kontextfenster-Mindestgrenze**: Eine Mindestgrenze von 1.000 Zeichen für die Option `contextWindow` verhindert, dass fehlerhafte oder zu kleine Werte versehentlich den abgerufenen Dokumentationskontext leeren.
+
+### Fehlertolerante Netzwerkverarbeitung
+
+- **Verständliche Netzwerk-Fehlermeldungen**: Fängt Browser-Verbindungsfehler auf niedriger Ebene (`Failed to fetch`, `Load failed`) sowohl im Streaming- als auch im Standardmodus ab und liefert klare, handlungsorientierte Diagnosen.
+- **Saubere Abbruchbehandlung**: Verarbeitet abgebrochene Anfragen und `AbortError` sauber, ohne Protokolle mit unnötigen Fehlern zu überfluten.
+
+## Behobene Probleme
+
+- **Universeller Abruf**: Behebt ein Problem, bei dem starre Konfigurationsvorgaben im Standard-Prompt dazu führten, dass der Assistent von `docmd.config.json`-Strukturen ausging, anstatt die tatsächliche Konfiguration der jeweiligen Seite abzurufen.
+- **Präzision bei Versionsanfragen**: Behebt ein Problem, durch das versionierte Abfragen (z. B. nach historischen Release Notes) den Suchbereich nicht gezielt auf eine bestimmte Version einschränken konnten.
+
+## Upgrade
+
+::: tabs
+== tab "npm" icon:package
+```bash
+npm install docmd-assistant@0.1.17
+```
+== tab "pnpm" icon:zap
+```bash
+pnpm add docmd-assistant@0.1.17
+```
+:::

docmd-assistant/de/tools.md

@@ -119,5 +119,6 @@ Wenn kein benutzerdefinierter Callback angegeben ist, greift `search_documentati
 Wenn Suchergebnis-Snippets nicht ausreichen, ruft der Assistent automatisch `read_documentation_page({ path })` auf:
 
 1. **Benutzerdefinierter Reader-Callback (`customReader`)**: Falls vorhanden, delegiert die Engine das Abrufen der Seite an Ihren benutzerdefinierten Loader.
-2. **DOM-Parser-Fallback**: Falls kein Callback vorhanden ist, lädt das Werkzeug `window.location.origin + path` via `fetch()` und extrahiert Text aus `<main>`, `<article>` oder `[role="main"]` via `DOMParser()`.
-3. **Zitations-Links**: Der zurückgegebene Seiteninhalt wird in den Kontext integriert, sodass das Modell klickbare Markdown-Links `[Seitentitel](path)` in seiner Antwort generieren kann.
+2. **Strukturierter DOM-Parser-Fallback**: Falls kein benutzerdefinierter Callback angegeben ist, lädt das Werkzeug `window.location.origin + path` via `fetch()` und wandelt den `<main>`, `<article>` oder `[role="main"]` Container in strukturiertes Markdown um. Codeblöcke mit Sprachauszeichnung (`pre/code`), Überschriften (`#`) und Listen (`-`) bleiben erhalten, während Chrome- und Navigationselemente (`nav`, `aside`, `.toc`, `.sidebar`, `.docmd-ai-drawer`) gefiltert werden.
+3. **Unbegrenzte Kontextübergabe**: Seiten werden vollständig ohne Zeichenbegrenzung übergeben, sodass umfangreiche Konfigurationstabellen und Codebeispiele das Modell intakt erreichen.
+4. **Zitations-Links**: Der zurückgegebene Seiteninhalt wird in den Kontext integriert, sodass das Modell klickbare Markdown-Links `[Seitentitel](path)` in seiner Antwort generieren kann.

docmd-assistant/en/configuration.md

@@ -23,6 +23,7 @@ interface AssistantOptions {
   maxTokens?: number;
   reasoning?: boolean | 'none' | 'low' | 'medium' | 'high';
   headers?: Record<string, string>;
+  contextWindow?: number;
 }
 ```
 
@@ -44,6 +45,7 @@ interface AssistantOptions {
 | `maxTokens` | `number` | Maximum tokens returned per response turn | Provider default |
 | `reasoning` | `boolean \| string` | Toggle extended reasoning mode (`false`, `'low'`, `'medium'`, `'high'`) | `false` |
 | `headers` | `Record<string, string>` | Custom HTTP headers sent with relay requests | `{}` |
+| `contextWindow` | `number` | Maximum characters of retrieved documentation context passed to the model per turn. `0` = uncapped (full content delivered for highest response fidelity). | `0` (uncapped) |
 
 ::: callout tip "Default System Prompt"
 If no `systemPrompt` is provided, the engine applies a default prompt that enforces docmd assistant identity rules, search-first tool calling, concise Markdown output, and clickable citation links.

docmd-assistant/en/navigation.json

@@ -34,6 +34,14 @@
     "icon": "scroll",
     "collapsible": false,
     "children": [
+      {
+        "title": "v0.1.17",
+        "path": "/release-notes/0-1-17"
+      },
+      {
+        "title": "v0.1.16",
+        "path": "/release-notes/0-1-16"
+      },
       {
         "title": "v0.1.15",
         "path": "/release-notes/0-1-15"

docmd-assistant/en/release-notes/0-1-10.md

@@ -1,9 +1,9 @@
 ---
 title: "Release Notes v0.1.10"
-description: "Release notes for docmd-assistant v0.1.10 featuring autonomous tool loops with live streaming, tool argument normalization, concurrency locking, and status badges."
+description: "Release notes for docmd-assistant v0.1.10 featuring autonomous tool loops with live streaming, tool argument normalisation, concurrency locking, and status badges."
 ---
 
-`docmd-assistant` v0.1.10 introduces multi-turn autonomous tool execution loops with real-time streaming capabilities, robust tool argument normalization, and concurrency locks to prevent state race conditions.
+`docmd-assistant` v0.1.10 introduces multi-turn autonomous tool execution loops with real-time streaming capabilities, robust tool argument normalisation, and concurrency locks to prevent state race conditions.
 
 ## Key Features & Enhancements
 
@@ -12,9 +12,9 @@ description: "Release notes for docmd-assistant v0.1.10 featuring autonomous too
 - **Multi-Turn Tool Execution**: Implemented multi-turn execution loops across both direct `aiplug` and custom relay modes, allowing the engine to run registered tools (e.g. documentation search) and feed results back to the LLM automatically.
 - **Real-Time Stream Support**: Enabled `sendMessageStream` and streaming relay adapters to support tool-driven responses with real-time status callbacks.
 
-### Robust Tool Argument Normalization
+### Robust Tool Argument Normalisation
 
-- **Flexible Parsing**: Standardized parsing of tool arguments to handle varied model outputs—supporting raw JSON strings, nested `arguments`/`input` objects, and direct parameter key-value pairs seamlessly.
+- **Flexible Parsing**: Standardised parsing of tool arguments to handle varied model outputs—supporting raw JSON strings, nested `arguments`/`input` objects, and direct parameter key-value pairs seamlessly.
 - **Resilient Error Handling**: Wrapped tool execution in safety boundaries to return structured error messages back to the model without crashing the conversation loop.
 
 ### Concurrency Protection & UI Status Events

docmd-assistant/en/release-notes/0-1-11.md

@@ -1,13 +1,13 @@
 ---
 title: "Release Notes v0.1.11"
-description: "Release notes for docmd-assistant v0.1.11 featuring multi-turn autonomous tool loop stabilization, query context preservation, non-SSE HTTP stream fallback, and keyword search optimizations."
+description: "Release notes for docmd-assistant v0.1.11 featuring multi-turn autonomous tool loop stabilisation, query context preservation, non-SSE HTTP stream fallback, and keyword search optimisations."
 ---
 
 `docmd-assistant` v0.1.11 brings critical stability and reliability enhancements to the multi-turn autonomous tool execution loop, context-grounded response synthesis, non-streaming JSON fallback parsing, and keyword-first search decomposing.
 
 ## Key Features & Enhancements
 
-### Multi-Turn Autonomous Tool Loop Stabilization
+### Multi-Turn Autonomous Tool Loop Stabilisation
 
 The relay streaming and standard HTTP execution loops (`runRelayStreamLoop` and `runRelayLoop`) have been re-architected for deterministic multi-turn tool execution:
 
@@ -24,9 +24,9 @@ Eliminated intermittent "No response returned" errors when interacting with serv
 
 ### Keyword-First Search Query Decomposition
 
-- Refined system prompt guidance and tool calling instructions to decompose natural language queries into targeted, high-precision search keywords (e.g., `"install"`, `"config"`, `"cli"`) to maximize match accuracy on static site documentation indexes.
+- Refined system prompt guidance and tool calling instructions to decompose natural language queries into targeted, high-precision search keywords (e.g., `"install"`, `"config"`, `"cli"`) to maximise match accuracy on static site documentation indexes.
 
-### Enhanced Output Sanitizer Recovery
+### Enhanced Output Sanitiser Recovery
 
 - Hardened `cleanAssistantReply` and `parseAssistantOutput` to gracefully recover text if the model generates reasoning blocks (`<think>`) without separate markdown content, preventing empty bubbles from reaching the chat UI.