knowmind 0.3.6 → 0.3.8

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