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 +121 -0
- package/README.md +2 -1
- package/bin/knowmind.js +6 -2
- package/package.json +2 -1
- package/src/client.js +3 -3
- package/src/sync.js +10 -5
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: "
|
|
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
|
-
|
|
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.
|
|
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: "
|
|
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: "
|
|
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: "
|
|
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:
|
|
116
|
+
duplicate: isDuplicate,
|
|
114
117
|
};
|
|
115
|
-
// Manifest
|
|
116
|
-
//
|
|
117
|
-
|
|
118
|
-
|
|
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;
|