NAS PROMPT FOLDER

# NAS Markdown Folder Ingestion — Specification

## User Story

Als Nutzer möchte ich einen Ordner auf meinem NAS auswählen oder konfigurieren,
damit PromptVault Lite alle `.md`-Promptdateien darin einliest, bewertet und im Explorer anzeigt.

## Primary Source

Ein gemounteter NAS-Ordner mit Markdown-Dateien. Der Ordner wird vom Betriebssystem,
Proxmox-LXC oder Host als lokaler Pfad gemountet. PromptVault Lite liest diesen
gemounteten Ordner wie einen normalen lokalen Ordner.

## Supported MVP Sources

- Lokaler Ordner
- Gemounteter SMB/CIFS-Ordner
- Gemounteter NFS-Ordner
- Windows UNC-Pfad (sofern Tauri/OS Zugriff erlaubt)
- Später Docker/LXC-Mount unter /data/prompts

## File Scope

- `.md`-Dateien
- `.markdown`-Dateien (seit v1.6.1)
- Keine Binärdateien
- Keine versteckten Systemdateien
- Keine temporären Dateien (`*.tmp`, `~*`, `.*.swp`)
- Keine Dateien außerhalb des gewählten Root-Ordners

## Default Mode

- Read-only: PromptVault Lite liest nur Dateiinhalte
- Keine Schreiboperationen auf dem gemounteten NAS
- Kein Löschen, Verschieben oder Überschreiben von Markdown-Dateien

## Write Mode

Nicht Teil des MVP. Schreibzugriff wird in einem späteren Release geprüft.

## Acceptance Criteria

1. Nutzer kann einen lokalen/gemounteten Ordner über den nativen Dateidialog auswählen
2. Alle `.md`-Dateien im Ordner und Unterordnern werden rekursiv gefunden
3. Nicht-Markdown-Dateien werden ignoriert
4. Dateipfade werden normalisiert (Windows: Backslashes, UNC, Long Paths)
5. Prompt-Dateien werden im Explorer als File-Tree angezeigt
6. Ausgewählter Prompt-Inhalt wird im DetailsPanel geladen
7. Prompt-Analyse funktioniert auf geladene Markdown-Inhalte
8. Fehler bei nicht lesbarem NAS erzeugen einen verständlichen Fehler (kein Crash)
9. Leere Ordner erzeugen einen leeren Explorer (kein Fehler)
10. Fehler bei einzelnen unlesbaren Dateien werden gesammelt, aber brechen den Scan nicht ab

## Security Rules

1. Der ausgewählte Prompt-Root ist die harte Boundary
2. Keine Datei außerhalb dieses Roots wird gelesen
3. Path-Traversal mit `../` wird durch Canonicalize+Containment geblockt
4. Absolute Pfade außerhalb des Prompt-Roots werden geblockt
5. Symlink-Escape wird erkannt und blockiert
6. Null-Bytes im Pfad werden abgewiesen
7. Nicht lesbare Dateien erzeugen Warnungen, keinen Crash
8. Offline-NAS erzeugt verständliche Fehlermeldung
9. Keine NAS-Credentials werden geloggt
10. Keine Rohpfade unnötig in UI/Evidence-Logs veröffentlicht

## Error States

| Zustand                          | Verhalten                                                |
| -------------------------------- | -------------------------------------------------------- |
| Verzeichnis nicht vorhanden      | Fehler: "Verzeichnis existiert nicht: {path}"            |
| Pfad ist kein Verzeichnis        | Fehler: "Pfad ist kein Verzeichnis: {path}"              |
| Kanonischer Pfad nicht auflösbar | Fehler: "Konnte kanonischen Pfad nicht auflösen: {path}" |
| Einzelne Datei nicht lesbar      | Warnung geloggt, Scan wird fortgesetzt                   |
| Symlink außerhalb Vault          | Warnung geloggt, Datei übersprungen                      |
| Leerer Ordner                    | Erfolg mit 0 Prompts                                     |
| NAS offline / Mount getrennt     | Fehler: "Verzeichnis existiert nicht: {path}"            |
| Null-Byte im Pfad                | Fehler vor Scan-Beginn                                   |

## Platform Path Examples