knowmind 0.3.5 → 0.3.6

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.
package/CHANGELOG.md CHANGED
@@ -1,260 +1,273 @@
1
- # Knowmind CLI — Änderungen
2
-
3
- ## 0.3.2 (2026-08-04)
4
-
5
- **`knowmind install`: zwei neue Ziele, ein Befehl richtet alles ein**
6
- - `knowmind install gemini` trägt knowmind in Googles Gemini CLI ein
7
- (`~/.gemini/settings.json`).
8
- - `knowmind install codex` trägt knowmind in die Codex CLI ein
9
- (`~/.codex/config.toml`) — bestehende Einträge und fremde Server bleiben
10
- unangetastet, der Befehl ist beliebig wiederholbar.
11
- - Mit `--token` endet die Ausgabe jetzt mit „<Werkzeug> neu starten — fertig."
12
- statt weiterer Hinweise: nach dem Befehl ist nichts mehr zu tun.
13
-
14
- ## 0.3.1 (2026-07-17)
15
-
16
- - Unter Windows laufen alle Hintergrundaufrufe (Statusline-Ping, Config-Schutz)
17
- jetzt ohne aufblitzende Konsolenfenster.
18
- - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
19
-
20
- ## 0.3.0 (2026-07-16)
21
-
22
- **`knowmind status`: Sitzungs-Zähler + sichtbares Flackern**
23
- - Die Statusline zeigt jetzt, wie viele Erinnerungen in der laufenden Sitzung
24
- abgerufen wurden — als eigenes, farblich hervorgehobenes Lebenszeichen.
25
- - Die grüne LED flackert bei Aktivität jetzt sichtbar: `knowmind init --client
26
- claude-code` richtet die Statusleiste mit periodischem Neuzeichnen ein
27
- (Claude Code ab v2.1.97). Ohne das rendert Claude Code die Statusleiste nur
28
- bei Ereignissen, sodass eine Animation nicht sichtbar würde.
29
-
30
- ## 0.2.0 (2026-07-16)
31
-
32
- **Neu: `knowmind status` — sichtbares Lebenszeichen des Gedächtnisses**
33
- - `knowmind status` zeigt einen kurzen Erreichbarkeits-Report (erreichbar,
34
- Anzahl Erinnerungen und Beziehungen, Antwortzeit).
35
- - `knowmind status --line` gibt eine einzeilige Statusline für Ihr KI-Werkzeug
36
- aus: ruhig grün, wenn erreichbar; grünes Flackern wie eine Festplatten-LED,
37
- während knowmind arbeitet; rot bei Ausfall (mit Selbst-Erholung). Die Anzeige
38
- blockiert nie — Erreichbarkeit und Zahl werden gecacht, im Hintergrund
39
- aufgefrischt.
40
- - `knowmind init --client claude-code` bindet die Statusline automatisch ein.
41
- Eine bereits vorhandene eigene Statusline bleibt unangetastet.
42
-
43
- ## 0.1.29 (2026-07-16)
44
-
45
- - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
46
-
47
- ## 0.1.28 (2026-07-16)
48
-
49
- - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
50
-
51
- ## 0.1.27 (2026-07-16)
52
-
53
- - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
54
-
55
- ## 0.1.25 (2026-06-23)
56
-
57
- **Geführtes Onboarding nach `install`/`init`**
58
- - `install` und `init` zeigen nach der Eintragung einen klaren Abschluss-Schritt:
59
- Liegt kein API-Token vor, wird deutlich auf Konto + Token hingewiesen — der
60
- häufigste Stolperstein, denn ohne Token bleibt die MCP-Konfig wirkungslos. Mit
61
- Token: kurze Bestätigung, dass alles startklar ist.
62
- - `init` akzeptiert jetzt `--token kmt_…` und `--api URL` (konsistent zu `install`)
63
- und legt die Config gleich mit an, damit die erzeugten Hooks sofort funktionieren,
64
- statt ohne Token still ins Leere zu laufen.
65
-
66
- ## 0.1.23 (2026-06-20)
67
-
68
- **Neuer Befehl `knowmind install <ide>`**
69
- - Trägt knowmind als MCP-Server in die richtige Config-Datei einer IDE ein.
70
- - Unterstützt drei Schema-Familien: `mcpServers` (Cursor, Windsurf, Antigravity,
71
- Claude Desktop, Claude Code-Projekt), `servers`+`inputs` (VS Code) und
72
- `context_servers` (Zed); JetBrains und Claude-Code-User-Scope geben ein
73
- Snippet bzw. den `claude mcp add`-Befehl aus.
74
- - Flags: `--project`, `--print`, `--dry-run`, `--token`, `--api`.
75
- - Token wird per Default nie im Klartext geschrieben (Env-/Input-Referenz oder
76
- Platzhalter mit Warnung); Schreibvorgänge sind ein idempotenter JSON-Merge,
77
- der vorhandene Fremd-Server erhält.
78
-
79
- ## 0.1.22 (2026-06-11)
80
-
81
- **Discovery-Modus ohne Token (Introspection-fähig)**
82
- - Ist KEIN Token konfiguriert, beantwortet `knowmind mcp` jetzt `initialize`,
83
- `tools/list` und `prompts/list` über die ÖFFENTLICHE Server-Discovery
84
- (`GET /api/mcp/v1` — liefert Name, Version und alle Tool-Definitionen ohne
85
- Auth). Vorher schlugen ohne Token ALLE Requests inkl. `initialize` mit
86
- `-32001` fehl — Verzeichnis-Crawler (z. B. Glama) konnten den Server nicht
87
- inspizieren.
88
- - `tools/call` verlangt weiterhin einen Token und verweist klar auf
89
- `knowmind login`. Ein konfigurierter, aber ungültiger Token führt unverändert
90
- zum harten Verbindungsfehler (kein falsches „connected ✓").
91
- - Neu: `Dockerfile` im Repo (node:20-alpine, `knowmind mcp` als Entrypoint) —
92
- für Container-basierte Inspection/Nutzung.
93
-
94
- ## 0.1.21 (2026-06-10)
95
-
96
- **Bugfix: `knowmind init`-Recall-Hook funktioniert jetzt auf Windows**
97
- - Der von `knowmind init --client claude-code` erzeugte Recall-Hook rief die Plattform
98
- bisher über einen Subprozess auf (`spawnSync("npx.cmd", …)`). Auf Windows mit Node
99
- ≥ 18.20.2/20.12/21.6/22 wirft das `EINVAL` (Node-Härtung CVE-2024-27980 gegen das
100
- direkte Spawnen von `.cmd`/`.bat` ohne Shell) — der Hook feuerte dort nie. Gefunden im
101
- echten Claude-Code-Realtest.
102
- - Fix: Der Hook ruft die Plattform jetzt per **direktem HTTPS-Call** (`fetch` gegen
103
- `/api/mcp/v1`, `tools/call knowmind_recall`) auf — kein Subprozess, kein npx-Kaltstart
104
- (Timeout 6 s, schneller), und **keine Command-Injection** mehr, weil die Nutzer-Frage
105
- als JSON-Body statt als Shell-Argument übergeben wird. Token/apiUrl aus ENV oder
106
- `~/.knowmind/config.json`. Treffer werden lesbar verdichtet ausgegeben (Titel + Score +
107
- Auszug). Weiterhin fail-open (jeder Fehler/kein Token → exit 0). SSE- und Plain-JSON-
108
- Antworten werden robust geparst.
109
-
110
- ## 0.1.20 (2026-06-10)
111
-
112
- **MCP-`instructions` erreichen jetzt den Client (initialize wird durchgereicht)**
113
- - `knowmind mcp` beantwortete `initialize` bisher lokal und unterschlug damit das
114
- serverseitige `instructions`-Feld. Der Proxy fragt `initialize` nun beim Server an und
115
- übernimmt `serverInfo` (Name/Version aus zentraler Quelle), `capabilities` und
116
- `instructions` aus der Server-Antwort. Damit liest jeder MCP-Client beim Verbinden die
117
- Memory-First-Betriebsanweisung des Servers — der client-übergreifende Pflege-Hebel
118
- OHNE manuelles Setup. Bei Server-Fehler/Offline fällt der Proxy auf den lokalen Default
119
- zurück (Proxy-Charakter + Offline-Robustheit bleiben).
120
- - Serverseitig (knowmind.de) liefert das `initialize`-Result jetzt ein `instructions`-Feld
121
- (Recall-First + proaktives Speichern) sowie `serverInfo.version` aus einer einzigen Quelle.
122
-
123
- **Neuer Befehl: `knowmind init` — automatische Gedächtnis-Pflege einrichten**
124
- - `knowmind init [--client claude-code|cursor|auto] [--dry-run]` richtet die
125
- Memory-First-Automatik im KI-Client des Nutzers ein, ohne manuelles Hook-Gefrickel.
126
- Client wird am Projekt-/Home-Verzeichnis erkannt (`.claude/`, `.cursor/`, `~/.codex/`)
127
- oder explizit gewählt.
128
- - **Claude Code:** schreibt projektlokale Hooks (`UserPromptSubmit` → `knowmind_recall`
129
- vor jeder Frage; `Stop` → Capture-Reminder, der an `knowmind_store_memory` erinnert,
130
- wenn die Runde Sicherungswürdiges enthielt) + einen Memory-First-Block in `./CLAUDE.md`.
131
- Die Hooks reden gegen die Plattform (`npx knowmind search` / die MCP-Tools), nicht
132
- gegen lokale `.md`-Dateien.
133
- - **Cursor:** schreibt `.cursor/rules/knowmind.mdc` (Memory-First-Regel, `alwaysApply`).
134
- - **Claude Desktop / Codex / generisch:** kein Hook-Mechanismus — zeigt den
135
- Memory-First-Text zum manuellen Einfügen und benennt die Grenze (nur
136
- MCP-instructions + MCP-prompts wirken, keine harte Erzwingung).
137
- - **Idempotent & nicht-destruktiv:** marker-/befehls-basierte Ersetzung
138
- (`<!-- BEGIN/END knowmind -->`); zweiter Lauf erzeugt keine Duplikate, fremde Dateien
139
- und Hooks bleiben unangetastet. `--dry-run` zeigt jede Aktion ohne zu schreiben.
140
- - Tests in `src/init.test.js` (Idempotenz, Client-Erkennung, dry-run, Marker-Upsert).
141
-
142
- ## 0.1.19 (2026-06-10)
143
-
144
- **CLI-Befehle repariert (search/stats/health/login)**
145
- - `knowmind search`, `knowmind stats`, `knowmind health` und die Token-Verifikation in
146
- `knowmind login` riefen noch die alten Punkt-Tool-Namen (`knowmind.recall`, `knowmind.stats`,
147
- `knowmind.health`) auf — der Server kennt seit der MCP-Namensschema-Umstellung nur noch
148
- Unterstrich-Namen (`knowmind_recall`, …). Alle direkten Tool-Calls umgestellt; der
149
- `knowmind mcp`-Proxy war nicht betroffen (reicht seit 0.1.18 alles durch).
150
-
151
- **Sync-Härtung**
152
- - `knowmind sync` speichert das Manifest jetzt nach JEDEM erfolgreichen Upload statt in
153
- 10er-Batches. Bricht der Prozess mitten im Lauf ab, gehen keine Manifest-Stände mehr
154
- verloren — identischer Inhalt wurde sonst beim nächsten Lauf endlos re-POSTet.
155
- - Server-Antwort `unchanged:true` (sha-identischer Inhalt, historisch `duplicate:true`)
156
- wird in Manifest und Ausgabe sauber erkannt.
157
-
158
- **Saubere Upload-Meldung**
159
- - `knowmind upload` meldet bei unverändertem/dupliziertem Inhalt jetzt verständlich
160
- „Unverändert/Duplikat …" statt `undefined Chunks (Provider undefined)`.
161
-
162
- **Doku**
163
- - README: Tool-Liste auf die 11 Server-Tools aktualisiert (`knowmind_list_recent` ergänzt);
164
- `knowmind_upload_document` als Upsert-per-Titel beschrieben.
165
-
166
- ## 0.1.18 (2026-06-09)
167
-
168
- **MCP-stdio als reiner Server-Proxy**
169
- - `knowmind mcp` hält keine lokalen Tool-Definitionen mehr: `tools/list`, `tools/call`,
170
- `prompts/*` und alle weiteren Methoden werden 1:1 an den Remote-Endpoint
171
- (`/api/mcp/v1`) durchgereicht. Tool-Namen, Schemas und Safety-Annotations kommen
172
- direkt vom Server — eine Abweichung wie der Namens-Drift `knowmind.*` vs.
173
- `knowmind_*` (machte 0.1.17 gegen den aktualisierten Endpoint unbrauchbar) ist
174
- damit konstruktiv ausgeschlossen.
175
- - `initialize` meldet die echte Paketversion; Notifications werden korrekt ignoriert.
176
-
177
- ## 0.1.17 (2026-06-08)
178
-
179
- **Rechts-Korrekturen (nach anwaltlicher Vorprüfung)**
180
- - Datenresidenz-Aussage korrigiert: keine widersprüchliche Stadt-Angabe mehr, und der absolute
181
- Satz „verlassen den deutschen Rechtsraum nicht" um den **Bring-your-own-Key-Vorbehalt** ergänzt
182
- (bei eigenen US-Anbieter-Schlüsseln kann ein Drittlandtransfer stattfinden).
183
- - **High-Risk-Ausschluss** ergänzt: knowmind ist nicht für selbstfahrende Fahrzeuge, kritische
184
- Infrastruktur oder lebenserhaltende/medizinische Systeme bestimmt; Einsatz dort auf eigenes Risiko.
185
-
186
- ## 0.1.16 (2026-06-08)
187
-
188
- **Positionierung + rechtliche Absicherung**
189
- - „Das Agentengehirn aus Deutschland" als Positionierung in README + npm/Registry-Beschreibung
190
- (Server in Deutschland, Hetzner/Nürnberg).
191
- - Volle **Apache-2.0-Lizenz** in `LICENSE` (vorher nur 17-Zeilen-Header-Stub ohne die bindenden
192
- Abschnitte 7 Disclaimer of Warranty + 8 Limitation of Liability).
193
- - **Haftung & Nutzung**-Abschnitt im README: „AS IS" ohne Gewährleistung, Bring-your-own-Token,
194
- eigener Verbrauch/eigene Kosten, Verweis auf AGB/Datenschutz/AVV/Impressum von knowmind.de.
195
-
196
- ## 0.1.15 (2026-06-08)
197
-
198
- **Marken-Namensraum**
199
- - Repo in die Organisation `Schubeler-Consulting` verschoben; MCP-Registry-Namespace
200
- von `io.github.WhoSoEverM8/knowmind` auf `io.github.Schubeler-Consulting/knowmind`
201
- (saubere, firmenkonforme Schreibweise). `mcpName`, `server.json` und `repository`
202
- entsprechend angepasst.
203
-
204
- ## 0.1.14 (2026-06-08)
205
-
206
- **MCP-Registry-Namespace**
207
- - `mcpName` auf die korrekte, case-sensitive Schreibweise `io.github.WhoSoEverM8/knowmind`
208
- gesetzt (muss dem GitHub-Benutzernamen exakt entsprechen, sonst lehnt die offizielle
209
- MCP-Registry den Publish mit 403 ab).
210
-
211
- ## 0.1.13 (2026-06-08)
212
-
213
- **Konsistenz**
214
- - Der MCP-Server meldet im `initialize`-Handshake jetzt die echte Paketversion
215
- (`serverInfo.version` = `VERSION` aus package.json) statt eines hartcodierten,
216
- veralteten Werts. Damit sind npm-Version, Server-Selbstauskunft, Hermes-Pin und
217
- das `server.json` der MCP-Registry identisch — eine Quelle der Wahrheit.
218
-
219
- ## 0.1.12 (2026-06-08)
220
-
221
- **MCP-Registry-Reife**
222
- - `package.json` um `mcpName` (`io.github.whosoeverm8/knowmind`) und `repository`
223
- ergänzt — Voraussetzung für die offizielle MCP-Registry
224
- (registry.modelcontextprotocol.io) und damit für PulseMCP, Glama, die
225
- GitHub-MCP-Registry (VS Code/Cursor) u. a.
226
- - `server.json` (MCP-Registry-Manifest, Schema 2025-12-11) hinzugefügt.
227
-
228
- **Sync-Korrektur (war 0.1.11, nie publiziert)**
229
- - `knowmind sync` ignoriert jetzt reine Index-/Navigationsdateien (`MEMORY.md`).
230
- Diese änderten sich bei jedem Memory-Write und legten beim Sync jedes Mal ein
231
- NEUES Dokument an (kein Replace) — bis zu 24 Versionen / 1224 Chunks (~38 % des
232
- Stores), die mit schwachen Einzeiler-Hooks die echten Detail-Dokumente aus dem
233
- Recall verdrängten. Index-Dateien werden nicht mehr synchronisiert.
234
-
235
- ## 0.1.10 (2026-05-22)
236
-
237
- **Install-Sauberkeit**
238
- - Deprecation-Warnung `boolean@3.2.0 is no longer supported` beim Install
239
- beseitigt. Ursache war `onnxruntime-node → global-agent@3.0.0 → boolean`.
240
- Per npm-`overrides` wird `global-agent@^4.1.3` erzwungen, das die
241
- veraltete `boolean`/`roarr`-Kette nicht mehr braucht. `npm install -g
242
- knowmind` läuft jetzt ohne Warnungen durch.
243
-
244
- ## 0.1.9 (2026-05-22)
245
-
246
- **Neuer Befehl**
247
- - `knowmind sync <dir>` synchronisiert einen lokalen Ordner mit dem
248
- Knowmind-Korpus. Idempotent über Content-Hash, Manifest in
249
- `<dir>/.knowmind-manifest.json`. Wiederholte Aufrufe übertragen nur das
250
- Delta. Optional `--ext .md,.txt`, `--verbose`, `--title-from-content`.
251
-
252
- **Korrekturen**
253
- - Upload-Fehlerpfad gehärtet: leere oder ungültige Server-Antworten werfen
254
- jetzt eine sprechende Fehlermeldung statt eines kryptischen
255
- „Unexpected end of JSON input" (siehe `src/client.js`).
256
- - Sichtbare CLI-Hilfe enthält den neuen `sync`-Befehl.
257
-
258
- **Bekannte Punkte**
259
- - `--watch` für `sync` (Datei-Beobachter mit Live-Upload) ist vorgesehen,
260
- aber noch nicht implementiert.
1
+ # Knowmind CLI — Änderungen
2
+
3
+ ## 0.3.6 (2026-09-07)
4
+
5
+ **Die Werkzeugliste steht auch ohne Netz zur Verfügung**
6
+ - `tools/list` beantwortete der Server bisher ausschließlich über die
7
+ öffentliche Discovery auf knowmind.de. War der Weg dorthin versperrt — eine
8
+ Sandbox ohne Netz, ein Verzeichnis-Crawler hinter einer Firewall —, bekam der
9
+ Aufrufer einen Fehler und sah kein einziges Werkzeug. Das Paket bringt die
10
+ Liste jetzt mit und nutzt sie, wenn die Discovery nicht antwortet; ein
11
+ Hinweis auf der Fehlerausgabe nennt den Stand.
12
+ - `npm run tools:abgleich` vergleicht die mitgelieferte Liste mit der
13
+ Discovery und schlägt an, sobald beide auseinanderlaufen.
14
+ - Verbesserungen der Stabilität.
15
+
16
+ ## 0.3.2 (2026-08-04)
17
+
18
+ **`knowmind install`: zwei neue Ziele, ein Befehl richtet alles ein**
19
+ - `knowmind install gemini` trägt knowmind in Googles Gemini CLI ein
20
+ (`~/.gemini/settings.json`).
21
+ - `knowmind install codex` trägt knowmind in die Codex CLI ein
22
+ (`~/.codex/config.toml`) — bestehende Einträge und fremde Server bleiben
23
+ unangetastet, der Befehl ist beliebig wiederholbar.
24
+ - Mit `--token` endet die Ausgabe jetzt mit „<Werkzeug> neu starten — fertig."
25
+ statt weiterer Hinweise: nach dem Befehl ist nichts mehr zu tun.
26
+
27
+ ## 0.3.1 (2026-07-17)
28
+
29
+ - Unter Windows laufen alle Hintergrundaufrufe (Statusline-Ping, Config-Schutz)
30
+ jetzt ohne aufblitzende Konsolenfenster.
31
+ - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
32
+
33
+ ## 0.3.0 (2026-07-16)
34
+
35
+ **`knowmind status`: Sitzungs-Zähler + sichtbares Flackern**
36
+ - Die Statusline zeigt jetzt, wie viele Erinnerungen in der laufenden Sitzung
37
+ abgerufen wurden — als eigenes, farblich hervorgehobenes Lebenszeichen.
38
+ - Die grüne LED flackert bei Aktivität jetzt sichtbar: `knowmind init --client
39
+ claude-code` richtet die Statusleiste mit periodischem Neuzeichnen ein
40
+ (Claude Code ab v2.1.97). Ohne das rendert Claude Code die Statusleiste nur
41
+ bei Ereignissen, sodass eine Animation nicht sichtbar würde.
42
+
43
+ ## 0.2.0 (2026-07-16)
44
+
45
+ **Neu: `knowmind status` — sichtbares Lebenszeichen des Gedächtnisses**
46
+ - `knowmind status` zeigt einen kurzen Erreichbarkeits-Report (erreichbar,
47
+ Anzahl Erinnerungen und Beziehungen, Antwortzeit).
48
+ - `knowmind status --line` gibt eine einzeilige Statusline für Ihr KI-Werkzeug
49
+ aus: ruhig grün, wenn erreichbar; grünes Flackern wie eine Festplatten-LED,
50
+ während knowmind arbeitet; rot bei Ausfall (mit Selbst-Erholung). Die Anzeige
51
+ blockiert nie — Erreichbarkeit und Zahl werden gecacht, im Hintergrund
52
+ aufgefrischt.
53
+ - `knowmind init --client claude-code` bindet die Statusline automatisch ein.
54
+ Eine bereits vorhandene eigene Statusline bleibt unangetastet.
55
+
56
+ ## 0.1.29 (2026-07-16)
57
+
58
+ - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
59
+
60
+ ## 0.1.28 (2026-07-16)
61
+
62
+ - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
63
+
64
+ ## 0.1.27 (2026-07-16)
65
+
66
+ - Verbesserungen der Stabilität und allgemeine Fehlerbehebungen.
67
+
68
+ ## 0.1.25 (2026-06-23)
69
+
70
+ **Geführtes Onboarding nach `install`/`init`**
71
+ - `install` und `init` zeigen nach der Eintragung einen klaren Abschluss-Schritt:
72
+ Liegt kein API-Token vor, wird deutlich auf Konto + Token hingewiesen — der
73
+ häufigste Stolperstein, denn ohne Token bleibt die MCP-Konfig wirkungslos. Mit
74
+ Token: kurze Bestätigung, dass alles startklar ist.
75
+ - `init` akzeptiert jetzt `--token kmt_…` und `--api URL` (konsistent zu `install`)
76
+ und legt die Config gleich mit an, damit die erzeugten Hooks sofort funktionieren,
77
+ statt ohne Token still ins Leere zu laufen.
78
+
79
+ ## 0.1.23 (2026-06-20)
80
+
81
+ **Neuer Befehl `knowmind install <ide>`**
82
+ - Trägt knowmind als MCP-Server in die richtige Config-Datei einer IDE ein.
83
+ - Unterstützt drei Schema-Familien: `mcpServers` (Cursor, Windsurf, Antigravity,
84
+ Claude Desktop, Claude Code-Projekt), `servers`+`inputs` (VS Code) und
85
+ `context_servers` (Zed); JetBrains und Claude-Code-User-Scope geben ein
86
+ Snippet bzw. den `claude mcp add`-Befehl aus.
87
+ - Flags: `--project`, `--print`, `--dry-run`, `--token`, `--api`.
88
+ - Token wird per Default nie im Klartext geschrieben (Env-/Input-Referenz oder
89
+ Platzhalter mit Warnung); Schreibvorgänge sind ein idempotenter JSON-Merge,
90
+ der vorhandene Fremd-Server erhält.
91
+
92
+ ## 0.1.22 (2026-06-11)
93
+
94
+ **Discovery-Modus ohne Token (Introspection-fähig)**
95
+ - Ist KEIN Token konfiguriert, beantwortet `knowmind mcp` jetzt `initialize`,
96
+ `tools/list` und `prompts/list` über die ÖFFENTLICHE Server-Discovery
97
+ (`GET /api/mcp/v1` — liefert Name, Version und alle Tool-Definitionen ohne
98
+ Auth). Vorher schlugen ohne Token ALLE Requests inkl. `initialize` mit
99
+ `-32001` fehl — Verzeichnis-Crawler (z. B. Glama) konnten den Server nicht
100
+ inspizieren.
101
+ - `tools/call` verlangt weiterhin einen Token und verweist klar auf
102
+ `knowmind login`. Ein konfigurierter, aber ungültiger Token führt unverändert
103
+ zum harten Verbindungsfehler (kein falsches „connected ✓").
104
+ - Neu: `Dockerfile` im Repo (node:20-alpine, `knowmind mcp` als Entrypoint) —
105
+ für Container-basierte Inspection/Nutzung.
106
+
107
+ ## 0.1.21 (2026-06-10)
108
+
109
+ **Bugfix: `knowmind init`-Recall-Hook funktioniert jetzt auf Windows**
110
+ - Der von `knowmind init --client claude-code` erzeugte Recall-Hook rief die Plattform
111
+ bisher über einen Subprozess auf (`spawnSync("npx.cmd", …)`). Auf Windows mit Node
112
+ ≥ 18.20.2/20.12/21.6/22 wirft das `EINVAL` (Node-Härtung CVE-2024-27980 gegen das
113
+ direkte Spawnen von `.cmd`/`.bat` ohne Shell) — der Hook feuerte dort nie. Gefunden im
114
+ echten Claude-Code-Realtest.
115
+ - Fix: Der Hook ruft die Plattform jetzt per **direktem HTTPS-Call** (`fetch` gegen
116
+ `/api/mcp/v1`, `tools/call knowmind_recall`) auf — kein Subprozess, kein npx-Kaltstart
117
+ (Timeout 6 s, schneller), und **keine Command-Injection** mehr, weil die Nutzer-Frage
118
+ als JSON-Body statt als Shell-Argument übergeben wird. Token/apiUrl aus ENV oder
119
+ `~/.knowmind/config.json`. Treffer werden lesbar verdichtet ausgegeben (Titel + Score +
120
+ Auszug). Weiterhin fail-open (jeder Fehler/kein Token → exit 0). SSE- und Plain-JSON-
121
+ Antworten werden robust geparst.
122
+
123
+ ## 0.1.20 (2026-06-10)
124
+
125
+ **MCP-`instructions` erreichen jetzt den Client (initialize wird durchgereicht)**
126
+ - `knowmind mcp` beantwortete `initialize` bisher lokal und unterschlug damit das
127
+ serverseitige `instructions`-Feld. Der Proxy fragt `initialize` nun beim Server an und
128
+ übernimmt `serverInfo` (Name/Version aus zentraler Quelle), `capabilities` und
129
+ `instructions` aus der Server-Antwort. Damit liest jeder MCP-Client beim Verbinden die
130
+ Memory-First-Betriebsanweisung des Servers — der client-übergreifende Pflege-Hebel
131
+ OHNE manuelles Setup. Bei Server-Fehler/Offline fällt der Proxy auf den lokalen Default
132
+ zurück (Proxy-Charakter + Offline-Robustheit bleiben).
133
+ - Serverseitig (knowmind.de) liefert das `initialize`-Result jetzt ein `instructions`-Feld
134
+ (Recall-First + proaktives Speichern) sowie `serverInfo.version` aus einer einzigen Quelle.
135
+
136
+ **Neuer Befehl: `knowmind init` — automatische Gedächtnis-Pflege einrichten**
137
+ - `knowmind init [--client claude-code|cursor|auto] [--dry-run]` richtet die
138
+ Memory-First-Automatik im KI-Client des Nutzers ein, ohne manuelles Hook-Gefrickel.
139
+ Client wird am Projekt-/Home-Verzeichnis erkannt (`.claude/`, `.cursor/`, `~/.codex/`)
140
+ oder explizit gewählt.
141
+ - **Claude Code:** schreibt projektlokale Hooks (`UserPromptSubmit` → `knowmind_recall`
142
+ vor jeder Frage; `Stop` → Capture-Reminder, der an `knowmind_store_memory` erinnert,
143
+ wenn die Runde Sicherungswürdiges enthielt) + einen Memory-First-Block in `./CLAUDE.md`.
144
+ Die Hooks reden gegen die Plattform (`npx knowmind search` / die MCP-Tools), nicht
145
+ gegen lokale `.md`-Dateien.
146
+ - **Cursor:** schreibt `.cursor/rules/knowmind.mdc` (Memory-First-Regel, `alwaysApply`).
147
+ - **Claude Desktop / Codex / generisch:** kein Hook-Mechanismus — zeigt den
148
+ Memory-First-Text zum manuellen Einfügen und benennt die Grenze (nur
149
+ MCP-instructions + MCP-prompts wirken, keine harte Erzwingung).
150
+ - **Idempotent & nicht-destruktiv:** marker-/befehls-basierte Ersetzung
151
+ (`<!-- BEGIN/END knowmind -->`); zweiter Lauf erzeugt keine Duplikate, fremde Dateien
152
+ und Hooks bleiben unangetastet. `--dry-run` zeigt jede Aktion ohne zu schreiben.
153
+ - Tests in `src/init.test.js` (Idempotenz, Client-Erkennung, dry-run, Marker-Upsert).
154
+
155
+ ## 0.1.19 (2026-06-10)
156
+
157
+ **CLI-Befehle repariert (search/stats/health/login)**
158
+ - `knowmind search`, `knowmind stats`, `knowmind health` und die Token-Verifikation in
159
+ `knowmind login` riefen noch die alten Punkt-Tool-Namen (`knowmind.recall`, `knowmind.stats`,
160
+ `knowmind.health`) auf — der Server kennt seit der MCP-Namensschema-Umstellung nur noch
161
+ Unterstrich-Namen (`knowmind_recall`, …). Alle direkten Tool-Calls umgestellt; der
162
+ `knowmind mcp`-Proxy war nicht betroffen (reicht seit 0.1.18 alles durch).
163
+
164
+ **Sync-Härtung**
165
+ - `knowmind sync` speichert das Manifest jetzt nach JEDEM erfolgreichen Upload statt in
166
+ 10er-Batches. Bricht der Prozess mitten im Lauf ab, gehen keine Manifest-Stände mehr
167
+ verloren — identischer Inhalt wurde sonst beim nächsten Lauf endlos re-POSTet.
168
+ - Server-Antwort `unchanged:true` (sha-identischer Inhalt, historisch `duplicate:true`)
169
+ wird in Manifest und Ausgabe sauber erkannt.
170
+
171
+ **Saubere Upload-Meldung**
172
+ - `knowmind upload` meldet bei unverändertem/dupliziertem Inhalt jetzt verständlich
173
+ „Unverändert/Duplikat …" statt `undefined Chunks (Provider undefined)`.
174
+
175
+ **Doku**
176
+ - README: Tool-Liste auf die 11 Server-Tools aktualisiert (`knowmind_list_recent` ergänzt);
177
+ `knowmind_upload_document` als Upsert-per-Titel beschrieben.
178
+
179
+ ## 0.1.18 (2026-06-09)
180
+
181
+ **MCP-stdio als reiner Server-Proxy**
182
+ - `knowmind mcp` hält keine lokalen Tool-Definitionen mehr: `tools/list`, `tools/call`,
183
+ `prompts/*` und alle weiteren Methoden werden 1:1 an den Remote-Endpoint
184
+ (`/api/mcp/v1`) durchgereicht. Tool-Namen, Schemas und Safety-Annotations kommen
185
+ direkt vom Server — eine Abweichung wie der Namens-Drift `knowmind.*` vs.
186
+ `knowmind_*` (machte 0.1.17 gegen den aktualisierten Endpoint unbrauchbar) ist
187
+ damit konstruktiv ausgeschlossen.
188
+ - `initialize` meldet die echte Paketversion; Notifications werden korrekt ignoriert.
189
+
190
+ ## 0.1.17 (2026-06-08)
191
+
192
+ **Rechts-Korrekturen (nach anwaltlicher Vorprüfung)**
193
+ - Datenresidenz-Aussage korrigiert: keine widersprüchliche Stadt-Angabe mehr, und der absolute
194
+ Satz „verlassen den deutschen Rechtsraum nicht" um den **Bring-your-own-Key-Vorbehalt** ergänzt
195
+ (bei eigenen US-Anbieter-Schlüsseln kann ein Drittlandtransfer stattfinden).
196
+ - **High-Risk-Ausschluss** ergänzt: knowmind ist nicht für selbstfahrende Fahrzeuge, kritische
197
+ Infrastruktur oder lebenserhaltende/medizinische Systeme bestimmt; Einsatz dort auf eigenes Risiko.
198
+
199
+ ## 0.1.16 (2026-06-08)
200
+
201
+ **Positionierung + rechtliche Absicherung**
202
+ - „Das Agentengehirn aus Deutschland" als Positionierung in README + npm/Registry-Beschreibung
203
+ (Server in Deutschland, Hetzner/Nürnberg).
204
+ - Volle **Apache-2.0-Lizenz** in `LICENSE` (vorher nur 17-Zeilen-Header-Stub ohne die bindenden
205
+ Abschnitte 7 Disclaimer of Warranty + 8 Limitation of Liability).
206
+ - **Haftung & Nutzung**-Abschnitt im README: „AS IS" ohne Gewährleistung, Bring-your-own-Token,
207
+ eigener Verbrauch/eigene Kosten, Verweis auf AGB/Datenschutz/AVV/Impressum von knowmind.de.
208
+
209
+ ## 0.1.15 (2026-06-08)
210
+
211
+ **Marken-Namensraum**
212
+ - Repo in die Organisation `Schubeler-Consulting` verschoben; MCP-Registry-Namespace
213
+ von `io.github.WhoSoEverM8/knowmind` auf `io.github.Schubeler-Consulting/knowmind`
214
+ (saubere, firmenkonforme Schreibweise). `mcpName`, `server.json` und `repository`
215
+ entsprechend angepasst.
216
+
217
+ ## 0.1.14 (2026-06-08)
218
+
219
+ **MCP-Registry-Namespace**
220
+ - `mcpName` auf die korrekte, case-sensitive Schreibweise `io.github.WhoSoEverM8/knowmind`
221
+ gesetzt (muss dem GitHub-Benutzernamen exakt entsprechen, sonst lehnt die offizielle
222
+ MCP-Registry den Publish mit 403 ab).
223
+
224
+ ## 0.1.13 (2026-06-08)
225
+
226
+ **Konsistenz**
227
+ - Der MCP-Server meldet im `initialize`-Handshake jetzt die echte Paketversion
228
+ (`serverInfo.version` = `VERSION` aus package.json) statt eines hartcodierten,
229
+ veralteten Werts. Damit sind npm-Version, Server-Selbstauskunft, Hermes-Pin und
230
+ das `server.json` der MCP-Registry identisch — eine Quelle der Wahrheit.
231
+
232
+ ## 0.1.12 (2026-06-08)
233
+
234
+ **MCP-Registry-Reife**
235
+ - `package.json` um `mcpName` (`io.github.whosoeverm8/knowmind`) und `repository`
236
+ ergänzt — Voraussetzung für die offizielle MCP-Registry
237
+ (registry.modelcontextprotocol.io) und damit für PulseMCP, Glama, die
238
+ GitHub-MCP-Registry (VS Code/Cursor) u. a.
239
+ - `server.json` (MCP-Registry-Manifest, Schema 2025-12-11) hinzugefügt.
240
+
241
+ **Sync-Korrektur (war 0.1.11, nie publiziert)**
242
+ - `knowmind sync` ignoriert jetzt reine Index-/Navigationsdateien (`MEMORY.md`).
243
+ Diese änderten sich bei jedem Memory-Write und legten beim Sync jedes Mal ein
244
+ NEUES Dokument an (kein Replace) — bis zu 24 Versionen / 1224 Chunks (~38 % des
245
+ Stores), die mit schwachen Einzeiler-Hooks die echten Detail-Dokumente aus dem
246
+ Recall verdrängten. Index-Dateien werden nicht mehr synchronisiert.
247
+
248
+ ## 0.1.10 (2026-05-22)
249
+
250
+ **Install-Sauberkeit**
251
+ - Deprecation-Warnung `boolean@3.2.0 is no longer supported` beim Install
252
+ beseitigt. Ursache war `onnxruntime-node → global-agent@3.0.0 → boolean`.
253
+ Per npm-`overrides` wird `global-agent@^4.1.3` erzwungen, das die
254
+ veraltete `boolean`/`roarr`-Kette nicht mehr braucht. `npm install -g
255
+ knowmind` läuft jetzt ohne Warnungen durch.
256
+
257
+ ## 0.1.9 (2026-05-22)
258
+
259
+ **Neuer Befehl**
260
+ - `knowmind sync <dir>` synchronisiert einen lokalen Ordner mit dem
261
+ Knowmind-Korpus. Idempotent über Content-Hash, Manifest in
262
+ `<dir>/.knowmind-manifest.json`. Wiederholte Aufrufe übertragen nur das
263
+ Delta. Optional `--ext .md,.txt`, `--verbose`, `--title-from-content`.
264
+
265
+ **Korrekturen**
266
+ - Upload-Fehlerpfad gehärtet: leere oder ungültige Server-Antworten werfen
267
+ jetzt eine sprechende Fehlermeldung statt eines kryptischen
268
+ „Unexpected end of JSON input" (siehe `src/client.js`).
269
+ - Sichtbare CLI-Hilfe enthält den neuen `sync`-Befehl.
270
+
271
+ **Bekannte Punkte**
272
+ - `--watch` für `sync` (Datei-Beobachter mit Live-Upload) ist vorgesehen,
273
+ aber noch nicht implementiert.