# HANDBUCH — Mindnet Obsidian Plugin (MVP 1.0)

## 1) Installation / Deployment (Neu aus Gitea)
Dieses Kapitel beschreibt den Prozess, wenn du das Plugin komplett neu aus Gitea holst und in Obsidian bereitstellst.

### 1.1 Voraussetzungen
- Windows (Entwicklung) + Obsidian Desktop
- Node.js installiert (CLI verfügbar)
  - Falls PowerShell `npm` blockiert: `npm.cmd` nutzen
- Git Zugriff auf dein Gitea Repo

### 1.2 Repo klonen
Beispiel:
1) Ordner wählen (z.B. `C:\Dev\cursor\mindnet_obsidian`)
2) Repo klonen:
   - `git clone <gitea-url> mindnet_obsidian`
3) In den Ordner wechseln:
   - `cd mindnet_obsidian`

### 1.3 Dependencies installieren
Wenn PowerShell npm-scripts blockiert:
- nutze `npm.cmd install`

Standard:
- `npm install`

### 1.4 Build
- `npm run build`

Erwartetes Ergebnis:
- Plugin-Bundle (typischerweise `main.js`) wird erzeugt (abhängig von eurer Build-Konfiguration).

### 1.5 Deployment in einen Obsidian Vault (Dev)
Zielpfad:
- `<vault>/.obsidian/plugins/<plugin-id>/`

Schritte:
1) Im Vault sicherstellen:
   - `.obsidian/plugins/` existiert
2) Plugin-Ordner anlegen:
   - `.obsidian/plugins/mindnet-causal-assistant/`
3) Deployment (Copy):
   - `manifest.json` → plugin folder
   - `main.js` → plugin folder
   - optional `styles.css` → plugin folder

Wenn ihr ein Script habt (empfohlen):
- `powershell -ExecutionPolicy Bypass -File scripts\deploy-local.ps1`

### 1.6 Plugin aktivieren
Obsidian:
- Settings → Community Plugins
- “Restricted mode” aus
- Plugin aktivieren

### 1.7 Typische Fehlerbilder
- “Plugin lädt nicht”:
  - Obsidian neustarten
  - Plugin disable/enable
  - prüfen, ob `main.js` im Plugin-Ordner aktuell ist
- Keine Logs:
  - DevTools öffnen: `Ctrl+Shift+I`
  - Console Filter zurücksetzen

---

## 2) Konfiguration (Pfad-Settings)
### 2.1 Vocabulary
- `edge_vocabulary path` (z.B. `_system/dictionary/edge_vocabulary.md`)
- Live reload bei Dateiänderung (debounced)

### 2.2 Graph Schema
- `graph_schema path` (z.B. `_system/dictionary/graph_schema.md`)
- Wird für Empfehlungen (typical/prohibited) verwendet

### 2.3 Interview Config
- `interview_config path` (z.B. `_system/dictionary/interview_config.yaml`)
- Profiles definieren Note-Type, Defaults, Steps, Loop-Layouts

---

## 3) Workflows

### 3.1 Note erstellen
- Command: “Create note from profile”
- Profil wählen
- Titel setzen
- Folder wählen (oder default)
- Note wird erstellt und geöffnet

### 3.2 Interview durchführen
- Wizard startet automatisch (wenn aktiviert) oder manuell per Command
- Steps ausfüllen (Loops/Nested Loops möglich)
- Review → Apply & Finish
- Output wird geschrieben

### 3.3 Semantic Mapping (Edger)
**Manuell:**
- Command: “Build semantic mapping blocks (by section)”

**Automatisch (post-run):**
- Nach Interview Finish wird der Edger ausgeführt (falls im Profil aktiviert)

Output:
- pro Section ein Mapping-Block am Ende der Section:
  - Wrapper callout (Default: abstract)
  - gruppiert nach Edge-Typ
  - Gruppen getrennt durch Leerzeile

### 3.4 Unresolved Link → Interview
- Klick auf `[[Neue Note]]`
- In Reading View: Plugin übernimmt Flow
- In Editing View: Obsidian kann Note sofort erzeugen → Plugin “adoptiert” und startet Mindnet Flow

---

## 4) Entwicklung (Dev-Workflow)
### 4.1 Build + Deploy lokal
- `npm run build`
- `scripts\deploy-local.ps1` ausführen (falls vorhanden)
- Obsidian: Plugin reload (disable/enable)

### 4.2 Tests
- `npm run test`

---

## 5) Troubleshooting
- Wizard startet nicht:
  - Prüfe settings `autoStart...`
  - DevTools Console auf Fehler prüfen
- Edger schreibt Blöcke an falscher Stelle:
  - Prüfe Heading Parsing + Section detection
  - Prüfe, ob Wrapper Block korrekt erkannt/ersetzt wird
- Schema Empfehlungen fehlen:
  - Prüfe graph_schema path
  - Prüfe schema loader stats/logging

---

# CHANGELOG (optional)
- v1.0.0: MVP 1.0 Feature Freeze