Jannik
f86c3bf8ce
- package.json mit Scripts (build, dev, test, init-vault, index, ingest, sync) - TypeScript-Config (tsconfig.json) + Vitest-Config - CLI-Entry (bin/mindomat.mjs + src/cli/index.ts) - Vault-Pfad-Discovery (1.2) mit CLI-Arg + Env-Var Fallback - 10 Unit-Tests fuer Vault-Pfad-Discovery (alle gruen) - Stubs fuer init-vault, index, ingest, sync (Placeholder, volle Implementierung in 1.3/1.5/2.3/1.8) - webapp/-Stubs (Phase 1.6 Vorbereitung) - README mit Install-Anleitung aktualisiert Smoke-Tests: - mindomat --version => mindomat 0.1.0 - mindomat --help => vollstaendige Hilfe - mindomat index => Fehler 'Vault-Pfad fehlt' (Exit 2) - mindomat index --vault => Stub-Aufruf (Exit 0)
Mind-o-Mat
Lokales Second-Brain-System für Obsidian-kompatible Markdown-Vaults. Besteht aus zwei Repos:
- Dieses Repo (
Mind-o-Mat) — die Code-Basis (Tool). Wird gebaut und über npm publiziert. - Vault-Repo (z. B.
Mind-o-Mat-Vault) — die Notizen. Wird mit dem Tool initialisiert und via gitea synchronisiert.
Status: Phase 1a in Arbeit. CLI-Skelett + Vault-Pfad-Discovery implementiert, andere Befehle sind Stubs. Siehe
10 Wiki/Plan.mdfür den vollständigen Plan.
Installation (Vault-User)
# Tool global installieren (einmalig)
npm install -g mindomat
# Vault initialisieren
mindomat init-vault C:\Pfad\Zu\Mein-Vault
cd C:\Pfad\Zu\Mein-Vault
git remote add origin https://git.example.com/Dein-Name/Mein-Vault.git
git push -u origin main
# QMD installieren (einmalig, ~2 GB Modelle)
npm install -g @tobilu/qmd
cd C:\Pfad\Zu\Mein-Vault
qmd collection add 00_Inbox --name inbox
qmd collection add 01_Daily --name daily
qmd collection add 10_Wiki --name wiki
qmd collection add 20_Projekte --name projekte
qmd embed
# Vault indizieren (erzeugt landkarte.json)
MINDOMAT_VAULT_PATH=C:\Pfad\Zu\Mein-Vault mindomat index
CLI-Referenz
mindomat --version # Version anzeigen
mindomat --help # Hilfe
mindomat init-vault <pfad> # Vault-Struktur erstellen
mindomat index --vault <pfad> # Vault indizieren
mindomat ingest --vault <pfad> # Inbox-Notizen verarbeiten
mindomat sync --vault <pfad> # gitea-Sync
Der Vault-Pfad wird in dieser Reihenfolge aufgelöst:
- CLI-Argument
--vault <pfad>(oder-v <pfad>) - Environment-Variable
MINDOMAT_VAULT_PATH - Fehler: klare Meldung
Entwicklung (Tool-Contributor)
git clone https://git.orfel.de/Jannik/Mind-o-Mat
cd Mind-o-Mat
npm install
npm run build # TypeScript kompilieren
npm test # Unit-Tests (Vitest)
npm run test:watch # Tests im Watch-Mode
Architektur
Siehe 10 Wiki/SPEC.md (Spezifikation) und 10 Wiki/Plan.md (20 Aufgaben, 5 Phasen).
5 Bausteine:
- Vault — Markdown-Dateien, Single Source of Truth (im Vault-Repo)
- Indexer — deterministisch, erzeugt
landkarte.json(im Tool) - QMD — lokale Hybridsuche, ~2 GB GGUF-Modelle (im Vault installiert)
- Wiki — Ingest pflegt Markdown-Seiten via Minimax-API
- Webapp/PWA — React + Cytoscape, Graph-Ansicht, Mobile-Editor
Lizenz
MIT