knowmind 0.3.9 → 0.4.1

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,5 +1,52 @@
1
1
  # Knowmind CLI — Änderungen
2
2
 
3
+ ## 0.4.1 (2026-10-16)
4
+
5
+ - `knowmind search` zeigt bei Treffern aus Seiten im Open Knowledge Format die
6
+ Kennzeichen, die der Server vergibt, in eckigen Klammern hinter der
7
+ Bewertung (`score`): `stale`, wenn der Zeitpunkt erreicht ist, ab dem die
8
+ Seite als veraltet gilt; `unverified`, wenn keine Prüfung verzeichnet ist;
9
+ `superseded`, wenn die Seite als überholt markiert ist.
10
+ - `knowmind init` schreibt den knowmind-Hinweis für Codex (mit `--client codex`
11
+ oder wenn es Codex erkennt) jetzt in die `AGENTS.md` des Projekts, die Codex
12
+ als Anweisung für das Projekt liest. Fehlt die Datei, legt `init` sie an; vorhandener
13
+ Text bleibt stehen, und ein zweiter Lauf ersetzt den Block, statt einen
14
+ weiteren anzuhängen. Der Hinweis nennt knowmind als Quelle für
15
+ Entscheidungen und Wissen außerhalb des Codes und hält fest, dass Quellcode
16
+ und Tests maßgeblich bleiben.
17
+
18
+ ## 0.4.0 (2026-10-16)
19
+
20
+ **`knowmind sync` übernimmt Wissen im Open Knowledge Format**
21
+
22
+ - Liegt in einem Ordner Wissen im Open Knowledge Format (OKF 0.1 oder 0.2),
23
+ etwa im Ordner `openwiki/`, den OpenWiki in einem Repository anlegt, liest
24
+ `knowmind sync` den Kopf jeder Seite mit.
25
+ - Jeder Treffer der Suche trägt danach den Status der Seite (`status`, ohne
26
+ Angabe `stable`), die Vertrauensstufe nach OKF (`trust`: `unverified`,
27
+ `machine-confirmed` oder `human-reviewed`, also ungeprüft, maschinell
28
+ bestätigt oder von einem Menschen geprüft) und die Zahl der Quellen. Soweit
29
+ die Seite es angibt, kommen hinzu: wer oder was die Seite erzeugt hat
30
+ (`generated`), die letzten fünf Prüfungen (`verified`), der Zeitpunkt, ab dem
31
+ die Seite als veraltet gilt (`stale_after`), und die ersten zehn Quellen
32
+ (`sources`). Der vollständige Kopf bleibt Teil des Dokuments.
33
+ - Der Zeitpunkt der letzten inhaltlichen Änderung (`generated.at`, bei OKF 0.1
34
+ `timestamp`) gilt als Beginn der Gültigkeit. `knowmind_recall_at_time`
35
+ zeigt die Seite deshalb erst ab diesem Zeitpunkt.
36
+ - Belege unter `.claims/` werden gezählt, und knowmind vermerkt, ob sie zur
37
+ aktuellen Fassung der Seite gehören. Ändern sich nur die Belege, lädt
38
+ `knowmind sync` die Seite erneut hoch.
39
+ - In einem solchen Ordner übernimmt `knowmind sync` die Verzeichnislisten
40
+ `index.md` und die Verläufe `log.md` nicht als Dokumente, ebenso wenig den
41
+ Arbeitsauftrag `INSTRUCTIONS.md` an der Wurzel eines OpenWiki-Ordners.
42
+ - Erkannt wird ein solcher Ordner an `okf_version` in der `index.md` an seiner
43
+ Wurzel oder an den Verwaltungsdateien von OpenWiki. Findet `knowmind sync`
44
+ keine solche Kennung, behandelt es den angegebenen Ordner mit `--okf`
45
+ trotzdem als OKF-Bündel.
46
+ - Die mitgelieferte Werkzeugliste trägt den Stand des Servers vom 16. Oktober.
47
+ Die Beschreibung von `hops` bei `knowmind_recall_memories` sagt jetzt, dass
48
+ der Wert den Abruf derzeit nicht verändert.
49
+
3
50
  ## 0.3.9 (2026-10-10)
4
51
 
5
52
  **`knowmind sync` hält umbenannte Dateien zusammen**
package/README.md CHANGED
@@ -84,8 +84,27 @@ npx -y knowmind upload notes.md --title "Meeting notes 2026-05-12"
84
84
  npx -y knowmind stats
85
85
  npx -y knowmind health
86
86
  npx -y knowmind status --line # one-line status for your AI tool's statusline
87
+ npx -y knowmind sync ./openwiki # pages in Open Knowledge Format keep their review data
87
88
  ```
88
89
 
90
+ ### Knowledge in Open Knowledge Format
91
+
92
+ `knowmind sync` reads folders in the Open Knowledge Format (OKF 0.1 and 0.2),
93
+ such as the `openwiki/` folder that OpenWiki creates in a repository.
94
+
95
+ Every search hit then carries the page's `status` (`stable` if the page sets
96
+ none), its trust tier as defined by OKF (`trust`: `unverified`,
97
+ `machine-confirmed` or `human-reviewed`) and how many sources it lists. If the
98
+ page provides them, the hit also carries who or what generated the page
99
+ (`generated`), its last five verifications (`verified`), the time after which
100
+ it counts as stale (`stale_after`) and its first ten sources (`sources`). The
101
+ full header stays part of the document.
102
+
103
+ Inside a bundle, directory listings (`index.md`) and logs (`log.md`) are not
104
+ imported. knowmind recognizes a bundle by `okf_version` in its root `index.md` or by the
105
+ files OpenWiki keeps there. If it finds neither, `--okf` treats the folder you
106
+ sync as a bundle.
107
+
89
108
  ## Available Tools
90
109
 
91
110
  Thirteen tools over MCP. Every one works against your own workspace; the server
package/bin/knowmind.js CHANGED
@@ -23,6 +23,7 @@ import {
23
23
  import { loadConfig, saveConfig, configPath, VERSION } from "../src/config.js";
24
24
  import { runStdioServer } from "../src/mcp-stdio.js";
25
25
  import { syncDirectory } from "../src/sync.js";
26
+ import { trefferKopf } from "../src/anzeige.js";
26
27
  import { runInit } from "../src/init.js";
27
28
  import { runInstall } from "../src/install.js";
28
29
  import { renderLine, renderFull, probe } from "../src/status.js";
@@ -52,7 +53,7 @@ Knowmind ${VERSION} — Das Gedächtnis für Ihre KI
52
53
  Befehle:
53
54
  knowmind login [--token kmt_TOKEN] [--api https://knowmind.de]
54
55
  Token speichern
55
- knowmind init [--client claude-code|cursor|auto] [--token kmt_TOKEN] [--api URL] [--dry-run]
56
+ knowmind init [--client claude-code|cursor|codex|auto] [--token kmt_TOKEN] [--api URL] [--dry-run]
56
57
  Automatische Gedächtnis-Pflege im KI-Client einrichten
57
58
  (Hooks/Regeln + Memory-First-Block). Idempotent.
58
59
  --token/--api legen die Config gleich mit an.
@@ -61,9 +62,12 @@ Befehle:
61
62
  Hybrid-Recall gegen den Tenant-Korpus
62
63
  knowmind upload <file> [--title "..."]
63
64
  Markdown-/Text-Datei indexieren (stdin: knowmind upload -)
64
- knowmind sync <dir> [--ext .md,.txt] [--verbose] [--title-from-content]
65
+ knowmind sync <dir> [--ext .md,.txt] [--verbose] [--title-from-content] [--okf]
65
66
  Ordner mit dem Korpus abgleichen. Idempotent über
66
67
  Content-Hash, Manifest in <dir>/.knowmind-manifest.json.
68
+ Seiten im Open Knowledge Format (z. B. openwiki/) behalten
69
+ Herkunft, Prüfstand und Verfallsdatum; --okf behandelt
70
+ den Ordner als Bündel, auch ohne okf_version.
67
71
  knowmind stats Memory- und Edge-Counter des Tenants
68
72
  knowmind health Health-Check der Plattform
69
73
  knowmind status [--line]
@@ -182,9 +186,7 @@ async function runSearch() {
182
186
  return;
183
187
  }
184
188
  for (const [i, hit] of result.hits.entries()) {
185
- const src = hit.metadata?.source_id ?? hit.chunk_id;
186
- const name = hit.metadata?.name ?? src;
187
- console.log(`\n#${i + 1} ${name} (score ${hit.score.toFixed(3)})`);
189
+ console.log(`\n${trefferKopf(hit, i)}`);
188
190
  console.log(" " + hit.content.slice(0, 280).replace(/\n/g, "\n "));
189
191
  }
190
192
  console.log(`\n${result.hits.length} Treffer in ${result.latency_ms} ms.`);
@@ -218,6 +220,7 @@ async function runSync() {
218
220
  extensions: extFlag ? extFlag.split(",").map((e) => (e.startsWith(".") ? e : `.${e}`)) : undefined,
219
221
  verbose: args.includes("--verbose"),
220
222
  titleFromContent: args.includes("--title-from-content"),
223
+ okf: args.includes("--okf"),
221
224
  };
222
225
  const result = await syncDirectory(dir, options);
223
226
  if (result.failed > 0) process.exitCode = 3;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "knowmind",
3
- "version": "0.3.9",
3
+ "version": "0.4.1",
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",
@@ -39,7 +39,8 @@
39
39
  "tools:abgleich": "node scripts/tools-abgleich.mjs"
40
40
  },
41
41
  "dependencies": {
42
- "@huggingface/transformers": "^3.5.0"
42
+ "@huggingface/transformers": "^3.5.0",
43
+ "yaml": "^2.9.1"
43
44
  },
44
45
  "overrides": {
45
46
  "global-agent": "^4.1.3"
package/src/anzeige.js ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Kopfzeile eines Treffers für `knowmind search`.
3
+ *
4
+ * Treffer aus Seiten im Open Knowledge Format tragen seit dem Serverstand vom
5
+ * 16.10.2026 `metadata.review_flags`: `stale` (Verfallszeitpunkt erreicht),
6
+ * `unverified` (keine Prüfung verzeichnet), `superseded` (überholt). Die
7
+ * Kopfzeile zeigt sie in eckigen Klammern; ohne Kennzeichen bleibt sie wie
8
+ * bisher.
9
+ */
10
+ export function trefferKopf(hit, i) {
11
+ const src = hit.metadata?.source_id ?? hit.chunk_id;
12
+ const name = hit.metadata?.name ?? src;
13
+ const kennzeichen = Array.isArray(hit.metadata?.review_flags) && hit.metadata.review_flags.length
14
+ ? ` [${hit.metadata.review_flags.join(", ")}]`
15
+ : "";
16
+ return `#${i + 1} ${name} (score ${hit.score.toFixed(3)})${kennzeichen}`;
17
+ }
package/src/client.js CHANGED
@@ -121,6 +121,9 @@ export async function uploadDocument(title, content, opts = {}) {
121
121
  // Quelldatei relativ zum Ordner: Der Server findet darüber die Fassung
122
122
  // derselben Datei, auch wenn sich der Titel geändert hat.
123
123
  if (opts.sourcePath) body.sourcePath = opts.sourcePath;
124
+ // Herkunft und Prüfstand einer OKF-Seite (okf.js): stehen danach an jedem
125
+ // Abschnitt, auch wenn der Server die Abschnitte selbst bildet.
126
+ if (opts.metadata) body.metadata = opts.metadata;
124
127
 
125
128
  const r = await fetch(`${apiUrl}/api/documents`, {
126
129
  method: "POST",
package/src/init.js CHANGED
@@ -69,6 +69,42 @@ function memoryFirstBlock() {
69
69
  ].join("\n");
70
70
  }
71
71
 
72
+ // ─── Hinweis in AGENTS.md (Codex und andere Agenten, seit 0.4.1) ─────
73
+ // AGENTS.md liest ein Agent bei jeder Aufgabe. Der Block macht knowmind
74
+ // deshalb zum Kontext auf Bedarf, nicht zur Pflichtlektüre, und hält fest,
75
+ // dass Quellcode und Tests maßgeblich bleiben (Muster: der verwaltete Block
76
+ // von OpenWiki, Abgleich 16.10.2026).
77
+ function agentsBlock() {
78
+ return [
79
+ BEGIN,
80
+ "## knowmind",
81
+ "",
82
+ "Dieses Projekt ist mit **knowmind** verbunden, dem Gedächtnis für Entscheidungen,",
83
+ "Absprachen und Projektwissen (MCP-Server mit `knowmind_recall_memories` und",
84
+ "`knowmind_store_memory`).",
85
+ "",
86
+ "- Frag knowmind, wenn eine Aufgabe von früheren Entscheidungen, Absprachen oder",
87
+ " Wissen außerhalb des Codes abhängt oder wenn der Nutzer danach fragt. Was der",
88
+ " Code allein beantwortet, braucht keinen Abruf.",
89
+ "- Quellcode und Tests sind maßgeblich. Ein Treffer aus knowmind ist ein Hinweis,",
90
+ " den du am Code prüfst, bevor du dich auf ihn stützt.",
91
+ "- An Treffern aus Seiten im Open Knowledge Format sagt `review_flags`, ob ein",
92
+ " Treffer veraltet (`stale`), ungeprüft (`unverified`) oder überholt",
93
+ " (`superseded`) ist, auch mehreres zugleich. Eine leere Liste heißt: nichts",
94
+ " davon trifft zu.",
95
+ "- Halte Entscheidungen und Ergebnisse, die über diese Sitzung hinaus gelten, mit",
96
+ " `knowmind_store_memory` fest. Zwischenstände und Wegwerfversuche gehören nicht",
97
+ " hinein.",
98
+ END,
99
+ ].join("\n");
100
+ }
101
+
102
+ function planAgents(cwd) {
103
+ const pfad = join(cwd, "AGENTS.md");
104
+ const md = upsertMarkedBlock(pfad, agentsBlock());
105
+ return [{ label: "AGENTS.md (knowmind-Hinweis)", path: pfad, action: md.action, content: md.content }];
106
+ }
107
+
72
108
  // ─── Generischer Hinweis-Text (manuell einfügbar) ────────────────────
73
109
  function manualSnippet() {
74
110
  return memoryFirstBlock();
@@ -727,14 +763,12 @@ export async function runInit({ client = "auto", dryRun = false, cwd = process.c
727
763
  for (const t of targets) {
728
764
  if (t === "claude-code") allActions.push(...planClaudeCode(cwd));
729
765
  else if (t === "cursor") allActions.push(...planCursor(cwd));
766
+ // Codex liest AGENTS.md im Projekt (seit 0.4.1 schreibt init den Block
767
+ // dort hinein; bis 0.4.0 zeigte es ihn nur an).
768
+ else if (t === "codex") allActions.push(...planAgents(cwd));
730
769
  else {
731
- // generic / claude-desktop / codex und alles ohne Hook-Mechanismus.
732
- const heading =
733
- t === "codex"
734
- ? "Codex CLI:"
735
- : t === "claude-desktop"
736
- ? "Claude Desktop:"
737
- : "Generischer Client:";
770
+ // generic / claude-desktop und alles ohne Hook-Mechanismus.
771
+ const heading = t === "claude-desktop" ? "Claude Desktop:" : "Generischer Client:";
738
772
  lines.push(heading);
739
773
  lines.push(" Dieser Client kennt keinen Hook-Mechanismus, der die Pflege HART erzwingt.");
740
774
  lines.push(" Es wirken automatisch: die MCP-instructions (werden beim Verbinden gelesen)");
@@ -826,6 +860,7 @@ export const _internals = {
826
860
  ensureClaudeHookEntry,
827
861
  detectClients,
828
862
  memoryFirstBlock,
863
+ agentsBlock,
829
864
  BEGIN,
830
865
  END,
831
866
  };
package/src/okf.js ADDED
@@ -0,0 +1,186 @@
1
+ /**
2
+ * Bündel im Open Knowledge Format (OKF 0.1 und 0.2) für `knowmind sync`.
3
+ *
4
+ * Ein OKF-Bündel ist ein Ordner mit Markdown-Seiten, deren YAML-Kopf sagt,
5
+ * woher eine Seite stammt (`sources`), wer sie geschrieben und wer sie geprüft
6
+ * hat (`generated`, `verified`), ob sie noch gilt (`status`, `stale_after`).
7
+ * So schreibt etwa OpenWiki das Verzeichnis openwiki/ eines Repos, dazu unter
8
+ * `.claims/` je Seite die belegten Aussagen. Spezifikation:
9
+ * https://github.com/GoogleCloudPlatform/open-knowledge-format
10
+ * (SPEC.md, Version 0.2).
11
+ *
12
+ * Dieses Modul erkennt ein Bündel und bildet den Kopf einer Seite auf die
13
+ * Angaben ab, die knowmind an jedem Abschnitt des Dokuments führt:
14
+ *
15
+ * - `metadata.okf`: Typ, Status, Vertrauensstufe (§5.3), Prüfungen,
16
+ * Erzeugung, Verfallsdatum, die ersten Quellen und der Stand der Belege.
17
+ * Kurz gehalten, weil die Angaben an jedem Treffer des Abrufs stehen und
18
+ * damit im Kontext des Agenten landen; den vollständigen Kopf trägt das
19
+ * Dokument selbst.
20
+ * - `metadata.valid_from`: der Zeitpunkt der letzten inhaltlichen Änderung
21
+ * (`generated.at`, bei OKF 0.1 `timestamp`). Der Abruf zu einem Zeitpunkt
22
+ * wertet ihn aus.
23
+ */
24
+ import { existsSync, readFileSync } from "node:fs";
25
+ import { join } from "node:path";
26
+ import { createHash } from "node:crypto";
27
+ import { parse } from "yaml";
28
+
29
+ /** Dateien mit festgelegter Bedeutung (§3.1): Verzeichnisliste und Verlauf, keine Seiten. */
30
+ export const RESERVIERT = new Set(["index.md", "log.md"]);
31
+
32
+ const HOECHSTZAHL_QUELLEN = 10;
33
+ const HOECHSTZAHL_VERIFIZIERT = 5;
34
+
35
+ /** YAML-Kopf einer Markdown-Datei als Objekt, sonst null. */
36
+ export function kopfLesen(inhalt) {
37
+ const m = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(inhalt);
38
+ if (!m) return null;
39
+ try {
40
+ const daten = parse(m[1]);
41
+ return daten && typeof daten === "object" && !Array.isArray(daten) ? daten : null;
42
+ } catch {
43
+ return null;
44
+ }
45
+ }
46
+
47
+ /**
48
+ * Ist `ordner` die Wurzel eines Bündels? Ein Bündel nennt seine Fassung im
49
+ * Kopf der `index.md` an der Wurzel (`okf_version`, §12). OpenWiki-Verzeichnisse
50
+ * erkennt man zusätzlich an `.last-update.json` und `.page-manifest.json`.
51
+ * Rückgabe `{ version, openwiki }` oder null.
52
+ */
53
+ export function buendelWurzel(ordner) {
54
+ const index = join(ordner, "index.md");
55
+ let version = null;
56
+ if (existsSync(index)) {
57
+ const kopf = kopfLesen(readFileSync(index, "utf-8"));
58
+ if (kopf?.okf_version != null) version = String(kopf.okf_version);
59
+ }
60
+ const openwiki = existsSync(join(ordner, ".last-update.json")) && existsSync(join(ordner, ".page-manifest.json"));
61
+ if (!version && !openwiki) return null;
62
+ return { version: version ?? "unbekannt", openwiki };
63
+ }
64
+
65
+ /** Zeitpunkt als ISO 8601 in UTC, sonst null. */
66
+ export function zeitpunkt(wert) {
67
+ if (wert == null || wert === "") return null;
68
+ const ms = wert instanceof Date ? wert.getTime() : Date.parse(String(wert));
69
+ return Number.isNaN(ms) ? null : new Date(ms).toISOString();
70
+ }
71
+
72
+ /** `verified` als Liste (§5.2: eine einzelne Angabe zählt als Liste mit einem Eintrag). */
73
+ export function verifiziert(verified) {
74
+ if (verified == null) return [];
75
+ const liste = Array.isArray(verified) ? verified : [verified];
76
+ return liste
77
+ .filter((v) => v && typeof v === "object" && typeof v.by === "string" && v.by.trim())
78
+ .map((v) => ({ by: v.by.trim(), at: zeitpunkt(v.at) }));
79
+ }
80
+
81
+ /** Vertrauensstufe nach §5.3: ungeprüft, maschinell bestätigt, von einem Menschen geprüft. */
82
+ export function vertrauensstufe(liste) {
83
+ if (liste.length === 0) return "unverified";
84
+ return liste.some((v) => v.by.startsWith("human:")) ? "human-reviewed" : "machine-confirmed";
85
+ }
86
+
87
+ /** Prüfsumme der Seite in der Schreibweise von OpenWiki (`pageVersion`). */
88
+ export function seitenFassung(inhalt) {
89
+ return "sha256:" + createHash("sha256").update(inhalt, "utf-8").digest("hex");
90
+ }
91
+
92
+ /**
93
+ * Belege einer Seite aus `.claims/<Seite>.json` (OpenWiki). Rückgabe
94
+ * `{ roh, daten }` oder null; `roh` geht in die Änderungserkennung ein, damit
95
+ * neue Belege zu einer unveränderten Seite ankommen.
96
+ */
97
+ export function belegeLesen(wurzel, konzept) {
98
+ const pfad = join(wurzel, ".claims", `${konzept}.json`);
99
+ if (!existsSync(pfad)) return null;
100
+ const roh = readFileSync(pfad, "utf-8");
101
+ try {
102
+ return { roh, daten: JSON.parse(roh) };
103
+ } catch {
104
+ return { roh, daten: null };
105
+ }
106
+ }
107
+
108
+ /**
109
+ * Commit, den OpenWiki für eine Seite dokumentiert hat (`.page-manifest.json`,
110
+ * Schlüssel ist der Pfad ab Repo-Wurzel). Sonst null.
111
+ */
112
+ export function seitenCommit(seiten, rel) {
113
+ if (!seiten || typeof seiten !== "object") return null;
114
+ for (const [pfad, eintrag] of Object.entries(seiten)) {
115
+ if ((pfad === rel || pfad.endsWith("/" + rel)) && typeof eintrag?.gitHead === "string") return eintrag.gitHead;
116
+ }
117
+ return null;
118
+ }
119
+
120
+ /** Die Seitenliste aus `.page-manifest.json` eines OpenWiki-Verzeichnisses, sonst null. */
121
+ export function seitenListeLesen(wurzel) {
122
+ const pfad = join(wurzel, ".page-manifest.json");
123
+ if (!existsSync(pfad)) return null;
124
+ try {
125
+ return JSON.parse(readFileSync(pfad, "utf-8"))?.pages ?? null;
126
+ } catch {
127
+ return null;
128
+ }
129
+ }
130
+
131
+ function belegStand(belege, inhalt) {
132
+ if (!belege) return null;
133
+ const d = belege.daten;
134
+ if (!d || !Array.isArray(d.claims)) return { count: 0, readable: false };
135
+ const erste = verifiziert(d.verification)[0];
136
+ return {
137
+ count: d.claims.length,
138
+ // Gehören die Belege zu genau dieser Fassung der Seite? Wenn nicht, hat
139
+ // jemand die Seite nach der letzten Prüfung geändert.
140
+ page_version_current: typeof d.pageVersion === "string" ? d.pageVersion === seitenFassung(inhalt) : null,
141
+ ...(erste ? { verified_by: erste.by, verified_at: erste.at } : {}),
142
+ };
143
+ }
144
+
145
+ /**
146
+ * Bildet den Kopf einer Seite auf `metadata` für den Upload ab. Ohne `type`
147
+ * im Kopf ist die Datei keine OKF-Seite (§4.1) und bekommt nichts.
148
+ */
149
+ export function okfAngaben({ kopf, inhalt, konzept, version, belege = null, commit = null }) {
150
+ if (!kopf || typeof kopf.type !== "string" || !kopf.type.trim()) return null;
151
+ const liste = verifiziert(kopf.verified);
152
+ const quellen = Array.isArray(kopf.sources)
153
+ ? kopf.sources.filter((q) => q && typeof q === "object" && q.resource != null)
154
+ : [];
155
+ const erzeugt =
156
+ kopf.generated && typeof kopf.generated === "object"
157
+ ? { by: kopf.generated.by != null ? String(kopf.generated.by) : null, at: zeitpunkt(kopf.generated.at) }
158
+ : null;
159
+ const status = ["draft", "stable", "deprecated"].includes(kopf.status) ? kopf.status : "stable";
160
+ const okf = {
161
+ version,
162
+ concept: konzept,
163
+ type: kopf.type.trim(),
164
+ status,
165
+ trust: vertrauensstufe(liste),
166
+ ...(liste.length ? { verified: liste.slice(-HOECHSTZAHL_VERIFIZIERT) } : {}),
167
+ ...(erzeugt ? { generated: erzeugt } : {}),
168
+ ...(zeitpunkt(kopf.stale_after) ? { stale_after: zeitpunkt(kopf.stale_after) } : {}),
169
+ ...(typeof kopf.resource === "string" ? { resource: kopf.resource } : {}),
170
+ ...(commit ? { git_head: commit } : {}),
171
+ sources_total: quellen.length,
172
+ ...(quellen.length
173
+ ? {
174
+ sources: quellen.slice(0, HOECHSTZAHL_QUELLEN).map((q) => ({
175
+ resource: String(q.resource),
176
+ ...(q.author != null ? { author: String(q.author) } : {}),
177
+ ...(zeitpunkt(q.last_modified) ? { last_modified: zeitpunkt(q.last_modified) } : {}),
178
+ })),
179
+ }
180
+ : {}),
181
+ };
182
+ const stand = belegStand(belege, inhalt);
183
+ if (stand) okf.claims = stand;
184
+ const gueltigAb = erzeugt?.at ?? zeitpunkt(kopf.timestamp);
185
+ return { okf, ...(gueltigAb ? { valid_from: gueltigAb } : {}) };
186
+ }
package/src/sync.js CHANGED
@@ -11,9 +11,12 @@
11
11
  * und das Manifest aktualisiert.
12
12
  */
13
13
  import { readFileSync, readdirSync, statSync, writeFileSync, existsSync } from "node:fs";
14
- import { join, relative, basename, extname } from "node:path";
14
+ import { join, relative, basename, extname, dirname } from "node:path";
15
15
  import { createHash, randomUUID } from "node:crypto";
16
16
  import { uploadDocument } from "./client.js";
17
+ import {
18
+ RESERVIERT, buendelWurzel, kopfLesen, belegeLesen, okfAngaben, seitenCommit, seitenListeLesen,
19
+ } from "./okf.js";
17
20
 
18
21
  const DEFAULT_EXTENSIONS = [".md", ".markdown", ".txt"];
19
22
  const MANIFEST_NAME = ".knowmind-manifest.json";
@@ -91,6 +94,59 @@ export function quellpfad(manifest, rel) {
91
94
  return `${manifest.quelle}/${rel}`;
92
95
  }
93
96
 
97
+ /**
98
+ * Findet zu einer Datei das OKF-Bündel, in dem sie liegt: den nächsten Ordner
99
+ * zwischen Datei und Sync-Wurzel, der ein Bündel ist (`okf.js`). Mit `--okf`
100
+ * gilt die Sync-Wurzel selbst als Bündel, auch ohne `okf_version`.
101
+ */
102
+ export function buendelFinder(wurzel, erzwungen = false) {
103
+ const merker = new Map();
104
+ const ansehen = (ordner) => {
105
+ if (!merker.has(ordner)) {
106
+ const b = buendelWurzel(ordner);
107
+ merker.set(ordner, b ? { wurzel: ordner, ...b } : null);
108
+ }
109
+ return merker.get(ordner);
110
+ };
111
+ return (datei) => {
112
+ let ordner = dirname(datei);
113
+ for (;;) {
114
+ const b = ansehen(ordner);
115
+ if (b) return b;
116
+ const abstand = relative(wurzel, ordner);
117
+ if (abstand === "" || abstand.startsWith("..")) break;
118
+ const oben = dirname(ordner);
119
+ if (oben === ordner) break;
120
+ ordner = oben;
121
+ }
122
+ return erzwungen ? { wurzel, version: "unbekannt", openwiki: false } : null;
123
+ };
124
+ }
125
+
126
+ /**
127
+ * Was `knowmind sync` mit einer Datei in einem OKF-Bündel tut: auslassen
128
+ * (Verzeichnisliste, Verlauf, Arbeitsauftrag von OpenWiki) oder hochladen,
129
+ * dann mit den Angaben aus ihrem Kopf und ihren Belegen.
130
+ */
131
+ export function okfSeite(bundle, datei, inhalt) {
132
+ const rel = relative(bundle.wurzel, datei).replace(/\\/g, "/");
133
+ if (RESERVIERT.has(basename(datei))) return { auslassen: "Verzeichnisliste oder Verlauf" };
134
+ // Der Arbeitsauftrag an den Schreibagenten von OpenWiki ist keine Seite.
135
+ if (bundle.openwiki && rel === "INSTRUCTIONS.md") return { auslassen: "Arbeitsauftrag von OpenWiki" };
136
+ const konzept = rel.replace(/\.md$/i, "");
137
+ const kopf = kopfLesen(inhalt);
138
+ const belege = belegeLesen(bundle.wurzel, konzept);
139
+ if (bundle.openwiki && bundle.seiten === undefined) bundle.seiten = seitenListeLesen(bundle.wurzel);
140
+ const commit = seitenCommit(bundle.seiten, rel);
141
+ const angaben = okfAngaben({ kopf, inhalt, konzept, version: bundle.version, belege, commit });
142
+ return {
143
+ angaben,
144
+ titel: angaben && typeof kopf?.title === "string" && kopf.title.trim() ? kopf.title.trim() : null,
145
+ // Ändern sich nur die Belege, muss die Seite trotzdem neu hinaus.
146
+ belegeRoh: belege?.roh ?? "",
147
+ };
148
+ }
149
+
94
150
  function deriveTitle(content, filePath) {
95
151
  const m = content.match(/^#\s+(.+)$/m);
96
152
  if (m) return m[1].trim();
@@ -113,10 +169,13 @@ export async function syncDirectory(dir, options = {}) {
113
169
 
114
170
  const files = [...walk(dir, exts)].sort();
115
171
  const total = files.length;
172
+ const buendelVon = buendelFinder(dir, Boolean(options.okf));
116
173
  let scanned = 0;
117
174
  let uploaded = 0;
118
175
  let skipped = 0;
119
176
  let failed = 0;
177
+ let okfSeiten = 0;
178
+ let ausgelassen = 0;
120
179
  const failures = [];
121
180
 
122
181
  console.log(`Knowmind sync: ${total} Dateien in ${dir}`);
@@ -126,7 +185,15 @@ export async function syncDirectory(dir, options = {}) {
126
185
  const rel = relative(dir, file).replace(/\\/g, "/");
127
186
  if (basename(file) === MANIFEST_NAME) continue;
128
187
  const content = readFileSync(file, "utf-8");
129
- const hash = sha256(content);
188
+ const bundle = buendelVon(file);
189
+ const seite = bundle ? okfSeite(bundle, file, content) : null;
190
+ if (seite?.auslassen) {
191
+ ausgelassen += 1;
192
+ if (options.verbose) console.log(` omit ${rel} (${seite.auslassen})`);
193
+ continue;
194
+ }
195
+ if (seite?.angaben) okfSeiten += 1;
196
+ const hash = seite?.angaben ? sha256(content + "\0" + seite.belegeRoh) : sha256(content);
130
197
  const name = frontmatterName(content);
131
198
  let known = manifest.files[rel];
132
199
  let umbenanntVon = null;
@@ -146,11 +213,14 @@ export async function syncDirectory(dir, options = {}) {
146
213
  continue;
147
214
  }
148
215
 
149
- const title = options.titleFromContent ? deriveTitle(content, file) : basename(file, extname(file));
216
+ const title = options.titleFromContent
217
+ ? deriveTitle(content, file)
218
+ : seite?.titel ?? basename(file, extname(file));
150
219
  try {
151
220
  const result = await uploadDocument(title, content, {
152
221
  replaceDocumentId: known?.documentId ?? undefined,
153
222
  sourcePath: quellpfad(manifest, rel),
223
+ ...(seite?.angaben ? { metadata: seite.angaben } : {}),
154
224
  });
155
225
  uploaded += 1;
156
226
  // Server antwortet bei sha-identischem Inhalt mit unchanged:true
@@ -180,10 +250,12 @@ export async function syncDirectory(dir, options = {}) {
180
250
 
181
251
  saveManifest(manifestPath, manifest);
182
252
  console.log(`\nFertig: ${uploaded} hochgeladen, ${skipped} unverändert, ${failed} fehlerhaft.`);
253
+ if (okfSeiten || ausgelassen) {
254
+ console.log(`OKF: ${okfSeiten} Seiten mit Herkunft und Prüfstand, ${ausgelassen} Verzeichnislisten und Verläufe ausgelassen.`);
255
+ }
183
256
  if (failed > 0) {
184
257
  console.log(`Fehler-Übersicht (max 10):`);
185
258
  failures.slice(0, 10).forEach((f) => console.log(` ${f.file}: ${f.error}`));
186
- return { uploaded, skipped, failed, failures };
187
259
  }
188
- return { uploaded, skipped, failed, failures };
260
+ return { uploaded, skipped, failed, failures, okfSeiten, ausgelassen };
189
261
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "_hinweis": "Rückfall für tools/list, wenn die Discovery nicht erreichbar ist. Erzeugt aus https://knowmind.de/api/mcp/v1. Abgleich: npm run tools:abgleich",
3
- "stand": "2026-10-10",
3
+ "stand": "2026-10-16",
4
4
  "quelle": "https://knowmind.de/api/mcp/v1",
5
5
  "protocolVersion": "2025-06-18",
6
6
  "tools": [
@@ -13,7 +13,7 @@
13
13
  "idempotentHint": true,
14
14
  "openWorldHint": false
15
15
  },
16
- "description": "Retrieve relevant knowledge before answering anything that benefits from prior context - decisions, preferences, project state, people, deadlines, past conversations. Hybrid recall (BM25 + pgvector + graph hops) over the tenant corpus; returns the top-k memory chunks, each with a relevance score and source reference. Suitable whenever earlier context would improve the answer; use knowmind_recall_at_time when you need what was valid at a past point in time. Read scope suffices.",
16
+ "description": "Retrieve relevant knowledge before answering anything that benefits from prior context - decisions, preferences, project state, people, deadlines, past conversations. Hybrid recall (BM25 + pgvector + knowledge graph) over the tenant corpus; returns the top-k memory chunks, each with a relevance score and source reference. Suitable whenever earlier context would improve the answer; use knowmind_recall_at_time when you need what was valid at a past point in time. Passages from pages in Open Knowledge Format carry metadata.review_flags: stale once stale_after is reached, unverified when no verification is recorded, superseded when the page's status is deprecated or superseded; an empty list means none applies. Read scope suffices.",
17
17
  "inputSchema": {
18
18
  "type": "object",
19
19
  "properties": {
@@ -33,7 +33,7 @@
33
33
  "minimum": 0,
34
34
  "maximum": 3,
35
35
  "default": 2,
36
- "description": "Graph expansion depth over typed relations (0-3, default 2); 0 = text/vector only, no graph."
36
+ "description": "Accepted for compatibility (0-3, default 2); currently has no effect on recall."
37
37
  }
38
38
  },
39
39
  "required": [
@@ -290,7 +290,7 @@
290
290
  "idempotentHint": true,
291
291
  "openWorldHint": false
292
292
  },
293
- "description": "Time-travel recall: return only memories that were valid at a given instant (valid_from <= as_of <= valid_to, or still open). Answers 'what did the agent know on March 14?'. Use instead of knowmind_recall when the point in time matters; otherwise use knowmind_recall for the current truth. Read scope suffices.",
293
+ "description": "Time-travel recall: return only memories that were valid at a given instant (valid_from <= as_of <= valid_to, or still open). Answers 'what did the agent know on March 14?'. Use instead of knowmind_recall when the point in time matters; otherwise use knowmind_recall for the current truth. Passages from pages in Open Knowledge Format carry metadata.review_flags (stale, unverified, superseded); stale is judged against as_of. Read scope suffices.",
294
294
  "inputSchema": {
295
295
  "type": "object",
296
296
  "properties": {
@@ -551,7 +551,7 @@
551
551
  "idempotentHint": true,
552
552
  "openWorldHint": false
553
553
  },
554
- "description": "DEPRECATED, removed on 2027-03-31: use knowmind_recall_memories. This name keeps answering unchanged until then. Retrieve relevant knowledge before answering anything that benefits from prior context - decisions, preferences, project state, people, deadlines, past conversations. Hybrid recall (BM25 + pgvector + graph hops) over the tenant corpus; returns the top-k memory chunks, each with a relevance score and source reference. Suitable whenever earlier context would improve the answer; use knowmind_recall_at_time when you need what was valid at a past point in time. Read scope suffices.",
554
+ "description": "DEPRECATED, removed on 2027-03-31: use knowmind_recall_memories. This name keeps answering unchanged until then. Retrieve relevant knowledge before answering anything that benefits from prior context - decisions, preferences, project state, people, deadlines, past conversations. Hybrid recall (BM25 + pgvector + knowledge graph) over the tenant corpus; returns the top-k memory chunks, each with a relevance score and source reference. Suitable whenever earlier context would improve the answer; use knowmind_recall_at_time when you need what was valid at a past point in time. Passages from pages in Open Knowledge Format carry metadata.review_flags: stale once stale_after is reached, unverified when no verification is recorded, superseded when the page's status is deprecated or superseded; an empty list means none applies. Read scope suffices.",
555
555
  "inputSchema": {
556
556
  "type": "object",
557
557
  "properties": {
@@ -571,7 +571,7 @@
571
571
  "minimum": 0,
572
572
  "maximum": 3,
573
573
  "default": 2,
574
- "description": "Graph expansion depth over typed relations (0-3, default 2); 0 = text/vector only, no graph."
574
+ "description": "Accepted for compatibility (0-3, default 2); currently has no effect on recall."
575
575
  }
576
576
  },
577
577
  "required": [