knowmind 0.1.18 → 0.1.19

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 ADDED
@@ -0,0 +1,121 @@
1
+ # Knowmind CLI — Änderungen
2
+
3
+ ## 0.1.19 (2026-06-10)
4
+
5
+ **CLI-Befehle repariert (search/stats/health/login)**
6
+ - `knowmind search`, `knowmind stats`, `knowmind health` und die Token-Verifikation in
7
+ `knowmind login` riefen noch die alten Punkt-Tool-Namen (`knowmind.recall`, `knowmind.stats`,
8
+ `knowmind.health`) auf — der Server kennt seit der MCP-Namensschema-Umstellung nur noch
9
+ Unterstrich-Namen (`knowmind_recall`, …). Alle direkten Tool-Calls umgestellt; der
10
+ `knowmind mcp`-Proxy war nicht betroffen (reicht seit 0.1.18 alles durch).
11
+
12
+ **Sync-Härtung**
13
+ - `knowmind sync` speichert das Manifest jetzt nach JEDEM erfolgreichen Upload statt in
14
+ 10er-Batches. Bricht der Prozess mitten im Lauf ab, gehen keine Manifest-Stände mehr
15
+ verloren — identischer Inhalt wurde sonst beim nächsten Lauf endlos re-POSTet.
16
+ - Server-Antwort `unchanged:true` (sha-identischer Inhalt, historisch `duplicate:true`)
17
+ wird in Manifest und Ausgabe sauber erkannt.
18
+
19
+ **Saubere Upload-Meldung**
20
+ - `knowmind upload` meldet bei unverändertem/dupliziertem Inhalt jetzt verständlich
21
+ „Unverändert/Duplikat …" statt `undefined Chunks (Provider undefined)`.
22
+
23
+ **Doku**
24
+ - README: Tool-Liste auf die 11 Server-Tools aktualisiert (`knowmind_list_recent` ergänzt);
25
+ `knowmind_upload_document` als Upsert-per-Titel beschrieben.
26
+
27
+ ## 0.1.18 (2026-06-09)
28
+
29
+ **MCP-stdio als reiner Server-Proxy**
30
+ - `knowmind mcp` hält keine lokalen Tool-Definitionen mehr: `tools/list`, `tools/call`,
31
+ `prompts/*` und alle weiteren Methoden werden 1:1 an den Remote-Endpoint
32
+ (`/api/mcp/v1`) durchgereicht. Tool-Namen, Schemas und Safety-Annotations kommen
33
+ direkt vom Server — eine Abweichung wie der Namens-Drift `knowmind.*` vs.
34
+ `knowmind_*` (machte 0.1.17 gegen den aktualisierten Endpoint unbrauchbar) ist
35
+ damit konstruktiv ausgeschlossen.
36
+ - `initialize` meldet die echte Paketversion; Notifications werden korrekt ignoriert.
37
+
38
+ ## 0.1.17 (2026-06-08)
39
+
40
+ **Rechts-Korrekturen (nach anwaltlicher Vorprüfung)**
41
+ - Datenresidenz-Aussage korrigiert: keine widersprüchliche Stadt-Angabe mehr, und der absolute
42
+ Satz „verlassen den deutschen Rechtsraum nicht" um den **Bring-your-own-Key-Vorbehalt** ergänzt
43
+ (bei eigenen US-Anbieter-Schlüsseln kann ein Drittlandtransfer stattfinden).
44
+ - **High-Risk-Ausschluss** ergänzt: knowmind ist nicht für selbstfahrende Fahrzeuge, kritische
45
+ Infrastruktur oder lebenserhaltende/medizinische Systeme bestimmt; Einsatz dort auf eigenes Risiko.
46
+
47
+ ## 0.1.16 (2026-06-08)
48
+
49
+ **Positionierung + rechtliche Absicherung**
50
+ - „Das Agentengehirn aus Deutschland" als Positionierung in README + npm/Registry-Beschreibung
51
+ (Server in Deutschland, Hetzner/Nürnberg).
52
+ - Volle **Apache-2.0-Lizenz** in `LICENSE` (vorher nur 17-Zeilen-Header-Stub ohne die bindenden
53
+ Abschnitte 7 Disclaimer of Warranty + 8 Limitation of Liability).
54
+ - **Haftung & Nutzung**-Abschnitt im README: „AS IS" ohne Gewährleistung, Bring-your-own-Token,
55
+ eigener Verbrauch/eigene Kosten, Verweis auf AGB/Datenschutz/AVV/Impressum von knowmind.de.
56
+
57
+ ## 0.1.15 (2026-06-08)
58
+
59
+ **Marken-Namensraum**
60
+ - Repo in die Organisation `Schubeler-Consulting` verschoben; MCP-Registry-Namespace
61
+ von `io.github.WhoSoEverM8/knowmind` auf `io.github.Schubeler-Consulting/knowmind`
62
+ (saubere, firmenkonforme Schreibweise). `mcpName`, `server.json` und `repository`
63
+ entsprechend angepasst.
64
+
65
+ ## 0.1.14 (2026-06-08)
66
+
67
+ **MCP-Registry-Namespace**
68
+ - `mcpName` auf die korrekte, case-sensitive Schreibweise `io.github.WhoSoEverM8/knowmind`
69
+ gesetzt (muss dem GitHub-Benutzernamen exakt entsprechen, sonst lehnt die offizielle
70
+ MCP-Registry den Publish mit 403 ab).
71
+
72
+ ## 0.1.13 (2026-06-08)
73
+
74
+ **Konsistenz**
75
+ - Der MCP-Server meldet im `initialize`-Handshake jetzt die echte Paketversion
76
+ (`serverInfo.version` = `VERSION` aus package.json) statt eines hartcodierten,
77
+ veralteten Werts. Damit sind npm-Version, Server-Selbstauskunft, Hermes-Pin und
78
+ das `server.json` der MCP-Registry identisch — eine Quelle der Wahrheit.
79
+
80
+ ## 0.1.12 (2026-06-08)
81
+
82
+ **MCP-Registry-Reife**
83
+ - `package.json` um `mcpName` (`io.github.whosoeverm8/knowmind`) und `repository`
84
+ ergänzt — Voraussetzung für die offizielle MCP-Registry
85
+ (registry.modelcontextprotocol.io) und damit für PulseMCP, Glama, die
86
+ GitHub-MCP-Registry (VS Code/Cursor) u. a.
87
+ - `server.json` (MCP-Registry-Manifest, Schema 2025-12-11) hinzugefügt.
88
+
89
+ **Sync-Korrektur (war 0.1.11, nie publiziert)**
90
+ - `knowmind sync` ignoriert jetzt reine Index-/Navigationsdateien (`MEMORY.md`).
91
+ Diese änderten sich bei jedem Memory-Write und legten beim Sync jedes Mal ein
92
+ NEUES Dokument an (kein Replace) — bis zu 24 Versionen / 1224 Chunks (~38 % des
93
+ Stores), die mit schwachen Einzeiler-Hooks die echten Detail-Dokumente aus dem
94
+ Recall verdrängten. Index-Dateien werden nicht mehr synchronisiert.
95
+
96
+ ## 0.1.10 (2026-05-22)
97
+
98
+ **Install-Sauberkeit**
99
+ - Deprecation-Warnung `boolean@3.2.0 is no longer supported` beim Install
100
+ beseitigt. Ursache war `onnxruntime-node → global-agent@3.0.0 → boolean`.
101
+ Per npm-`overrides` wird `global-agent@^4.1.3` erzwungen, das die
102
+ veraltete `boolean`/`roarr`-Kette nicht mehr braucht. `npm install -g
103
+ knowmind` läuft jetzt ohne Warnungen durch.
104
+
105
+ ## 0.1.9 (2026-05-22)
106
+
107
+ **Neuer Befehl**
108
+ - `knowmind sync <dir>` synchronisiert einen lokalen Ordner mit dem
109
+ Knowmind-Korpus. Idempotent über Content-Hash, Manifest in
110
+ `<dir>/.knowmind-manifest.json`. Wiederholte Aufrufe übertragen nur das
111
+ Delta. Optional `--ext .md,.txt`, `--verbose`, `--title-from-content`.
112
+
113
+ **Korrekturen**
114
+ - Upload-Fehlerpfad gehärtet: leere oder ungültige Server-Antworten werfen
115
+ jetzt eine sprechende Fehlermeldung statt eines kryptischen
116
+ „Unexpected end of JSON input" (siehe `src/client.js`).
117
+ - Sichtbare CLI-Hilfe enthält den neuen `sync`-Befehl.
118
+
119
+ **Bekannte Punkte**
120
+ - `--watch` für `sync` (Datei-Beobachter mit Live-Upload) ist vorgesehen,
121
+ aber noch nicht implementiert.
package/README.md CHANGED
@@ -105,11 +105,12 @@ identisch mit dem Remote-Connector (`https://knowmind.de/api/mcp/v1`).
105
105
  - `knowmind_recall` — Hybride Suche im Wissensspeicher des Mandanten
106
106
  - `knowmind_recall_at_time` — Recall mit Zeitfilter (bi-temporal)
107
107
  - `knowmind_store_memory` — Neue Erinnerung anlegen (Titel + Inhalt)
108
- - `knowmind_upload_document` — Längeren Text als Dokument ingestieren
108
+ - `knowmind_upload_document` — Längeren Text als Dokument ingestieren (Upsert-per-Titel: gleicher Titel ersetzt die alte Version)
109
109
  - `knowmind_update_fact` — Fakt bi-temporal aktualisieren (Historie bleibt)
110
110
  - `knowmind_link` — Typisierte Beziehung anlegen (Inverse wird automatisch gesetzt)
111
111
  - `knowmind_unlink` — Beziehung wieder entfernen (samt Inverse)
112
112
  - `knowmind_list_relations` — Beziehungen einer Erinnerung auflisten
113
+ - `knowmind_list_recent` — Zuletzt angelegte Dokumente/Memories des Mandanten auflisten, sortiert nach Anlagedatum absteigend
113
114
  - `knowmind_stats` — Statistik über gespeicherte Erinnerungen und Beziehungen
114
115
  - `knowmind_health` — Verfügbarkeits-Status der Plattform
115
116
 
package/bin/knowmind.js CHANGED
@@ -93,7 +93,7 @@ async function runLogin() {
93
93
  jsonrpc: "2.0",
94
94
  id: 1,
95
95
  method: "tools/call",
96
- params: { name: "knowmind.health", arguments: {} },
96
+ params: { name: "knowmind_health", arguments: {} },
97
97
  }),
98
98
  }).catch((e) => ({ ok: false, _netError: e.message }));
99
99
  if (r._netError) {
@@ -144,7 +144,11 @@ async function runUpload() {
144
144
  title = title ?? basename(path);
145
145
  }
146
146
  const data = await uploadDocument(title, content);
147
- console.log(`Indexiert: ${data.chunksWritten} Chunks (Provider ${data.embeddingProvider}).`);
147
+ if (data.unchanged || data.duplicate) {
148
+ console.log(`Unverändert/Duplikat: Inhalt liegt bereits indexiert vor (Doc ${data.id ?? "?"}).`);
149
+ } else {
150
+ console.log(`Indexiert: ${data.chunksWritten} Chunks (Provider ${data.embeddingProvider}).`);
151
+ }
148
152
  }
149
153
 
150
154
  async function runSync() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "knowmind",
3
- "version": "0.1.18",
3
+ "version": "0.1.19",
4
4
  "mcpName": "io.github.Schubeler-Consulting/knowmind",
5
5
  "description": "Knowmind — das Agentengehirn aus Deutschland: CLI + MCP-Server (Langzeitgedächtnis & Wissensgraph für Ihre KI, Server in Deutschland).",
6
6
  "type": "module",
@@ -29,6 +29,7 @@
29
29
  "bin",
30
30
  "src",
31
31
  "README.md",
32
+ "CHANGELOG.md",
32
33
  "LICENSE"
33
34
  ],
34
35
  "scripts": {
package/src/client.js CHANGED
@@ -29,7 +29,7 @@ async function rpc(method, params, options = {}) {
29
29
 
30
30
  export async function recall(query, { k = 5, hops = 2 } = {}) {
31
31
  const res = await rpc("tools/call", {
32
- name: "knowmind.recall",
32
+ name: "knowmind_recall",
33
33
  arguments: { query, k, hops },
34
34
  });
35
35
  // MCP-Antwort: { content: [{ type: "text", text: "<JSON>" }] }
@@ -39,12 +39,12 @@ export async function recall(query, { k = 5, hops = 2 } = {}) {
39
39
  }
40
40
 
41
41
  export async function stats() {
42
- const res = await rpc("tools/call", { name: "knowmind.stats", arguments: {} });
42
+ const res = await rpc("tools/call", { name: "knowmind_stats", arguments: {} });
43
43
  return JSON.parse(res.content?.[0]?.text ?? "{}");
44
44
  }
45
45
 
46
46
  export async function health() {
47
- const res = await rpc("tools/call", { name: "knowmind.health", arguments: {} });
47
+ const res = await rpc("tools/call", { name: "knowmind_health", arguments: {} });
48
48
  return JSON.parse(res.content?.[0]?.text ?? "{}");
49
49
  }
50
50
 
package/src/sync.js CHANGED
@@ -106,16 +106,21 @@ export async function syncDirectory(dir, options = {}) {
106
106
  try {
107
107
  const result = await uploadDocument(title, content);
108
108
  uploaded += 1;
109
+ // Server antwortet bei sha-identischem Inhalt mit unchanged:true
110
+ // (historisch duplicate:true) — beide Felder akzeptieren.
111
+ const isDuplicate = Boolean(result.unchanged ?? result.duplicate);
109
112
  manifest.files[rel] = {
110
113
  sha256: hash,
111
114
  documentId: result.id ?? null,
112
115
  lastSync: new Date().toISOString(),
113
- duplicate: Boolean(result.duplicate),
116
+ duplicate: isDuplicate,
114
117
  };
115
- // Manifest regelmäßig zwischenspeichern, damit ein Abbruch mid-run
116
- // nicht alle Fortschritte verliert.
117
- if (uploaded % 10 === 0) saveManifest(manifestPath, manifest);
118
- const flag = result.duplicate ? "dup " : "new ";
118
+ // Manifest nach JEDEM erfolgreichen Upload speichern (2026-06-10):
119
+ // Der Stop-Hook killt den Sync nach 120 s — mit 10er-Batches gingen
120
+ // Manifest-Stände verloren und identischer Inhalt wurde endlos
121
+ // re-POSTet (Ursache der Ingest-500-Schleife 26.–27.05.).
122
+ saveManifest(manifestPath, manifest);
123
+ const flag = isDuplicate ? "dup " : "new ";
119
124
  process.stdout.write(` [${scanned}/${total}] ${flag} ${rel}\n`);
120
125
  } catch (e) {
121
126
  failed += 1;