Enhance UI and functionality for Chain Workbench and related features
- Introduced a wide two-column layout for the Chain Workbench modal, improving user experience and accessibility. - Added new styles for workbench components, including headers, filters, and main containers, to enhance visual organization. - Updated chain templates to allow for multiple distinct matches per template, improving flexibility in template matching. - Enhanced documentation to clarify the new settings and commands related to the Chain Workbench and edge detection features. - Implemented logging for better tracking of missing configurations, ensuring users are informed about any loading issues.
This commit is contained in:
1 parent
c044d6e8db
commit
725adb5302
47 files changed
+4161
-646
No files matched your search
@@ -45,7 +45,19 @@ Das **Mindnet Causal Assistant** Plugin ist ein Authoring-Tool für Obsidian, da
|
||||
2. Stellen Sie sicher, dass "Restricted mode" ausgeschaltet ist
|
||||
3. Aktivieren Sie das Plugin "Mindnet Causal Assistant"
|
||||
|
||||
### 2. Erste Konfiguration
|
||||
### 2. Einstellungen finden
|
||||
|
||||
Die Plugin-Einstellungen erscheinen **nicht** unter „Community Plugins“ selbst, sondern wenn Sie **auf den Namen des Plugins** klicken:
|
||||
|
||||
1. **Einstellungen** öffnen (Zahnrad links unten oder **Settings**)
|
||||
2. In der **linken Leiste** **Community-Plugins** auswählen (falls nötig)
|
||||
3. In der Liste der installierten Plugins **auf „Mindnet Causal Assistant“ klicken**
|
||||
→ rechts erscheinen dann alle Einstellungen (Dictionary, Chain Inspector, Interview, etc.)
|
||||
|
||||
**Schnellzugriff:** Command Palette (`Ctrl+P` / `Cmd+P`) → **„Mindnet: Einstellungen öffnen“**
|
||||
Damit öffnen sich die Einstellungen; ggf. in der linken Leiste einmal auf „Mindnet Causal Assistant“ klicken.
|
||||
|
||||
### 3. Erste Konfiguration
|
||||
|
||||
Das Plugin benötigt Konfigurationsdateien im Vault. Diese sollten bereits vorhanden sein (siehe Administratorhandbuch). Standardpfade:
|
||||
|
||||
@@ -55,7 +67,7 @@ Das Plugin benötigt Konfigurationsdateien im Vault. Diese sollten bereits vorha
|
||||
- `_system/dictionary/chain_roles.yaml` - Chain-Rollen-Mapping
|
||||
- `_system/dictionary/chain_templates.yaml` - Chain-Templates
|
||||
|
||||
### 3. Erste Note erstellen
|
||||
### 4. Erste Note erstellen
|
||||
|
||||
1. Öffnen Sie den Command Palette (`Ctrl+P` / `Cmd+P`)
|
||||
2. Wählen Sie **"Mindnet: Create note from profile"**
|
||||
|
||||
@@ -781,7 +781,7 @@ npm run build
|
||||
|
||||
**Windows (PowerShell):**
|
||||
```bash
|
||||
npm run deploy:local
|
||||
npm.cmd run build:deploy
|
||||
# oder
|
||||
powershell -ExecutionPolicy Bypass -File scripts/deploy-local.ps1
|
||||
```
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# LASTENHEFT: WP-26 Integration im Obsidian Plugin
|
||||
|
||||
**Version:** 1.0
|
||||
**Datum:** 25. Januar 2026
|
||||
**Status:** Entwurf zur Review
|
||||
**Version:** 1.1
|
||||
**Datum:** 28. Januar 2026
|
||||
**Status:** Entwurf zur Review (aktualisiert: Commands, Edge-Überarbeitung, Interview Edge-Typen pro Sektion)
|
||||
**Projekt:** mindnet_obsidian (Obsidian Community Plugin)
|
||||
**Basis:** Backend WP-26 v1.3 (Section Types & Intra-Note-Edges)
|
||||
|
||||
@@ -84,11 +84,36 @@ Dieses Lastenheft definiert die vollständigen Anforderungen für die Integratio
|
||||
- Wizard-State muss Section-Types unterstützen
|
||||
- Section-Key-Resolver muss Block-IDs berücksichtigen
|
||||
|
||||
#### 2.1.4 Chain Workbench (`src/workbench/`)
|
||||
#### 2.1.4 Kausal-Funktionen (Chain Inspector, Chain Workbench)
|
||||
|
||||
**Überblick:** Die „Kausal-Funktionen“ bestehen aus (1) **Interview-Wizard** (geführte Erstellung von Notes mit kausal/argumentativen Strukturen), (2) **Chain Inspector** (Kausal-Analyse: Template-Matching, Findings wie `no_causal_roles`, `missing_link`), (3) **Chain Workbench** (UI für Findings, TODOs, Fix-Actions). Bis ca. Version 0.6.x waren diese ohne **Sektionsunterstützung mit unterschiedlichen Typen** (Section-Types); ab WP-26 wird Section-Type-basiertes Chain-Matching ergänzt (FA-PL-08).
|
||||
|
||||
**Aktuelle Funktionen / Module:**
|
||||
- `src/analysis/chainInspector.ts`: Analysiert kausale Ketten, Template-Matching, Findings (u. a. `no_causal_roles`, `weak_chain_roles`)
|
||||
- `src/workbench/`: `todoGenerator.ts`, `workbenchBuilder.ts`, `statusCalculator.ts`, `ChainWorkbenchModal.ts`
|
||||
- `src/commands/inspectChainsCommand.ts`: Command „Inspect Chains (Current Section)“
|
||||
- `src/commands/chainWorkbenchCommand.ts`: Command „Chain Workbench (Current Section)“
|
||||
- `src/commands/vaultTriageScanCommand.ts`: Command „Scan Vault for Chain Gaps“
|
||||
- Dictionary: `chain_roles.yaml` (Edge-Typen → kausale Rollen), `chain_templates.yaml` (Kettenmuster)
|
||||
|
||||
**Warum die Module „nicht aktiv“ erscheinen können:**
|
||||
|
||||
1. **Commands nur bei geöffneter Markdown-Datei:**
|
||||
„Inspect Chains“ und „Chain Workbench“ sind mit **editorCallback** registriert. In Obsidian erscheinen sie in der Befehlspalette nur, wenn eine **Markdown-Datei im Editor aktiv** ist. Ohne geöffnete Note sind sie ausgegraut bzw. nicht auffindbar – analog zu „Edge-Type ändern“ (siehe FA-PL-12a).
|
||||
|
||||
2. **Fehlende oder falsche Dictionary-Pfade:**
|
||||
Wenn `chain_roles.yaml` oder `chain_templates.yaml` am konfigurierten Pfad (Standard: `_system/dictionary/`) fehlen oder nicht lesbar sind, liefern die Loader `data === null`. Die Commands brechen **nicht** ab; Chain Inspector und Workbench laufen dann ohne Template-Matching und ohne kausale Rollen-Erkennung. Es erscheint **kein** expliziter Hinweis (z. B. „Chain Roles nicht geladen“). Das Ergebnis wirkt leer oder „inaktiv“.
|
||||
|
||||
3. **Sichtbarkeit in der Befehlspalette:**
|
||||
Ohne Hinweis in der Doku suchen Nutzer ggf. nach „Kausal“ oder „Wizard“; die registrierten Namen sind „Inspect Chains“ und „Chain Workbench“. Ein Eintrag im Lastenheft / Benutzerhandbuch verbessert die Auffindbarkeit.
|
||||
|
||||
**Lastenheft-Referenz:** Chain Workbench mit Section-Types ist in **FA-PL-08** beschrieben. Die allgemeine Sichtbarkeit von Commands (inkl. Kausal/Chain) ist in **FA-PL-12 / FA-PL-12a** adressiert.
|
||||
|
||||
#### 2.1.5 Chain Workbench – Module (`src/workbench/`)
|
||||
|
||||
**Aktuelle Funktionen:**
|
||||
- `todoGenerator.ts`: Generiert TODOs basierend auf Chain-Templates
|
||||
- `chainInspector.ts`: Analysiert Chains und findet Gaps
|
||||
- `chainInspector.ts` (in `src/analysis/`): Analysiert Chains und findet Gaps
|
||||
- `types.ts`: TypeScript-Interfaces für Workbench
|
||||
|
||||
**WP-26 Relevanz:**
|
||||
@@ -96,7 +121,7 @@ Dieses Lastenheft definiert die vollständigen Anforderungen für die Integratio
|
||||
- Gap-Detection muss Intra-Note-Edges erkennen
|
||||
- Template-Matching muss effective types verwenden
|
||||
|
||||
#### 2.1.5 UI (`src/ui/`)
|
||||
#### 2.1.6 UI (`src/ui/`)
|
||||
|
||||
**Aktuelle Funktionen:**
|
||||
- `EdgeTypeChooserModal.ts`: Modal zur Edge-Type-Auswahl
|
||||
@@ -109,7 +134,7 @@ Dieses Lastenheft definiert die vollständigen Anforderungen für die Integratio
|
||||
- Link-Prompt muss Block-ID-Generierung unterstützen
|
||||
- Interview-Wizard muss Section-Type-Auswahl ermöglichen
|
||||
|
||||
#### 2.1.6 Lint (`src/lint/`)
|
||||
#### 2.1.7 Lint (`src/lint/`)
|
||||
|
||||
**Aktuelle Funktionen:**
|
||||
- `LintEngine.ts`: Haupt-Lint-Engine
|
||||
@@ -120,7 +145,7 @@ Dieses Lastenheft definiert die vollständigen Anforderungen für die Integratio
|
||||
- Validierung von Block-IDs
|
||||
- Validierung von Intra-Note-Edges
|
||||
|
||||
#### 2.1.7 Schema (`src/schema/`)
|
||||
#### 2.1.8 Schema (`src/schema/`)
|
||||
|
||||
**Aktuelle Funktionen:**
|
||||
- `GraphSchemaLoader.ts`: Lädt `graph_schema.md`
|
||||
@@ -566,39 +591,103 @@ export interface SectionTypeLintRule {
|
||||
|
||||
### 3.5 Phase 5: Commands
|
||||
|
||||
#### FA-PL-12: Neue Commands
|
||||
#### FA-PL-12: Commands für WP-26 und Edge-Überarbeitung
|
||||
|
||||
**Anforderung:** Neue Commands für WP-26 Features.
|
||||
**Anforderung:** Commands für WP-26 Features und für die Edge-Überarbeitung in bestehenden Noten müssen in der Befehlspalette auffindbar und nutzbar sein.
|
||||
|
||||
**Betroffene Dateien:**
|
||||
- `src/main.ts` (erweitern)
|
||||
|
||||
**Neue Commands:**
|
||||
1. **"Mindnet: Add Section Type"**
|
||||
- Öffnet Section-Type-Modal
|
||||
- Fügt `[!section]` Callout ein
|
||||
**Bereits implementierte Commands (Stand: Jan 2026):**
|
||||
|
||||
2. **"Mindnet: Add Block ID to Heading"**
|
||||
- Generiert Block-ID für aktuelles Heading
|
||||
- Fügt `^block-id` zu Heading hinzu
|
||||
| Command-ID | Name (Befehlspalette) | Kontext | Modul / Funktion |
|
||||
|------------|------------------------|---------|-------------------|
|
||||
| `mindnet-change-edge-type` | Mindnet: Edge-Type ändern | **editorCallback** – nur bei geöffneter MD-Datei | `edgeTypeSelector.ts`: Einzellink, Auswahl, ganze Note, neuer Link |
|
||||
| `mindnet-build-semantic-mappings` | Mindnet: Build semantic mapping blocks (by section) | **editorCallback** – nur bei geöffneter MD-Datei | `semanticMappingBuilder.ts`: Mapping-Blöcke pro Sektion bauen/überarbeiten |
|
||||
| `mindnet-fix-findings` | Mindnet: Fix Findings (Current Section) | **editorCallback** | `fixFindingsCommand.ts`: fehlende Links einfügen, Kandidaten-Edges bestätigen |
|
||||
|
||||
3. **"Mindnet: Insert Intra-Note Edge"**
|
||||
- Öffnet Edge-Type-Chooser mit Section-Type-Support
|
||||
- Erstellt Intra-Note-Link mit Block-Reference
|
||||
**Hinweis:** Commands mit `editorCallback` erscheinen in Obsidian nur, wenn eine Markdown-Datei im Editor aktiv ist. Ohne geöffnete Note sind sie in der Befehlspalette ausgegraut bzw. nicht ausführbar. Das kann dazu führen, dass Nutzer sie „nicht als Befehle abrufbar“ erleben, wenn sie z. B. in Einstellungen oder im Graph sind.
|
||||
|
||||
4. **"Mindnet: Validate Section Types"**
|
||||
- Führt Section-Type-Lint-Regeln aus
|
||||
- Zeigt Findings in Console
|
||||
**Offene / geplante Commands (Lastenheft):**
|
||||
1. **"Mindnet: Add Section Type"** (noch nicht umgesetzt)
|
||||
- Öffnet Section-Type-Modal, fügt `[!section]` Callout ein
|
||||
|
||||
2. **"Mindnet: Add Block ID to Heading"** (noch nicht umgesetzt)
|
||||
- Generiert Block-ID für aktuelles Heading, fügt `^block-id` hinzu
|
||||
|
||||
3. **"Mindnet: Insert Intra-Note Edge"** (noch nicht umgesetzt)
|
||||
- Edge-Type-Chooser mit Section-Type-Support, Intra-Note-Link mit Block-Reference
|
||||
|
||||
4. **"Mindnet: Validate Section Types"** (noch nicht umgesetzt)
|
||||
- Section-Type-Lint-Regeln ausführen, Findings in Console
|
||||
|
||||
**Neue Anforderung (FA-PL-12a): Sichtbarkeit der Edge-Commands**
|
||||
- Die Befehle **Edge-Type ändern** und **Build semantic mapping blocks** sollen für Nutzer klar auffindbar sein.
|
||||
- Option A: Beibehalten von `editorCallback` und in der Dokumentation (z. B. Benutzerhandbuch) festhalten: „Eine Markdown-Note muss geöffnet sein.“
|
||||
- Option B: Zusätzlich einen Command ohne Editor (z. B. `callback`) anbieten, der prüft, ob eine MD-Datei aktiv ist, und ggf. eine Notice ausgibt („Bitte zuerst eine Markdown-Datei öffnen“), damit der Befehl immer in der Palette erscheint.
|
||||
|
||||
**Kompatibilität:**
|
||||
- Bestehende Commands bleiben unverändert
|
||||
- Neue Commands sind zusätzlich
|
||||
- Neue/angepasste Commands sind zusätzlich oder klären die Nutzung
|
||||
|
||||
---
|
||||
|
||||
### 3.6 Phase 6: Dictionary-Integration
|
||||
#### Edge-Überarbeitung in bestehenden Noten (bereits implementiert)
|
||||
|
||||
#### FA-PL-13: Types-Loader
|
||||
Die folgenden **Module** unterstützen das Überarbeiten und Verbinden von Edges in bestehenden Noten. Sie sind über die oben genannten Commands erreichbar (jeweils bei geöffneter Markdown-Datei):
|
||||
|
||||
| Modul | Funktion | Aufruf |
|
||||
|-------|----------|--------|
|
||||
| `src/mapping/edgeTypeSelector.ts` | Kantentyp für einen Link, mehrere Links oder ganze Note setzen; neuer Link mit Kantentyp | Command „Mindnet: Edge-Type ändern“ |
|
||||
| `src/mapping/semanticMappingBuilder.ts` | Pro Sektion Semantic-Mapping-Blöcke bauen/überarbeiten, Links mit Kantentypen versehen | Command „Mindnet: Build semantic mapping blocks (by section)“ |
|
||||
| `src/mapping/updateMappingBlocks.ts` | `[[rel:type\|link]]` in Content finden, in Mapping-Blöcke übernehmen | Wird vom Edge-Type-Selector nach Änderung aufgerufen |
|
||||
| `src/commands/fixFindingsCommand.ts` | Fehlende Links einfügen, Kandidaten-Edges in explizite Edges übernehmen | Command „Mindnet: Fix Findings (Current Section)“ |
|
||||
|
||||
Ohne geöffnete Markdown-Datei erscheinen „Edge-Type ändern“ und „Build semantic mapping blocks“ in der Befehlspalette ausgegraut (siehe FA-PL-12a).
|
||||
|
||||
---
|
||||
|
||||
### 3.6 Erweiterung: Edge-Typen pro Sektion im Interview (implementiert, Jan 2026)
|
||||
|
||||
Die folgende Erweiterung wurde umgesetzt und hat Auswirkungen auf Parsing, Renderer und Mapping.
|
||||
|
||||
#### FA-PL-14: Section-Edges und Note-Edges im Interview
|
||||
|
||||
**Anforderung:** Im Interview-Wizard sollen Section-zu-Section- und Note-Edges (inkl. Abschnitts-Links `Note#Abschnitt`) konfigurierbar sein und im gerenderten Markdown korrekt erscheinen.
|
||||
|
||||
**Umsetzung (Kernkomponenten):**
|
||||
|
||||
1. **SectionEdgesOverviewModal** (`src/ui/SectionEdgesOverviewModal.ts`)
|
||||
- Zeigt am Ende des Interviews alle Section-Edges und Note-Edges.
|
||||
- Erlaubt Anpassung der Edge-Typen; Note-Ziele werden als vollständiger Link (z. B. `Note#Abschnitt`) gespeichert.
|
||||
- Liefert `sectionEdges` und `noteEdges` an den Wizard.
|
||||
|
||||
2. **LinkTargetPickerModal** (`src/ui/LinkTargetPickerModal.ts`)
|
||||
- Nach Auswahl einer Note (Entity Picker) kann gewählt werden: ganze Note oder konkreter Abschnitt (`Note#Abschnitt`).
|
||||
- Der gewählte Link wird in Inline-Micro-Edging und in den Übersichts-Dialog übernommen.
|
||||
|
||||
3. **Renderer** (`src/interview/renderer.ts`)
|
||||
- `RenderOptions.noteEdges`: Map von Block-ID → (toNote bzw. `Note#Abschnitt` → edgeType).
|
||||
- Note-Edges werden pro Sektion als `>> [!edge] type` und `>> [[Note#Abschnitt]]` im Semantic-Mapping-Block ausgegeben.
|
||||
- `buildAbstractWrapper` akzeptiert beliebige Wikilinks `[[…]]`, nicht nur `[[#^block-id]]`.
|
||||
|
||||
4. **Links mit Abschnitt erhalten**
|
||||
- **parseRelLinks.ts:** `linkBasename` behält `#Abschnitt`; Ersetzung erfolgt als `[[Note#Abschnitt]]`; Edge-Map verwendet vollen Link als Key.
|
||||
- **sectionParser.ts (extractWikilinks):** Links behalten `#Abschnitt` (kein Strip mehr); `section.links` enthält z. B. `Note#Abschnitt`.
|
||||
- **semanticMappingBuilder.ts / updateMappingBlocks.ts:** Beim Mergen wird der passende Section-Link (mit `#`) als Key verwendet; Mapping-Blöcke schreiben `>> [[Note#Abschnitt]]`.
|
||||
|
||||
**Auswirkungen:**
|
||||
- Bestehende Notes ohne `#Abschnitt` bleiben unverändert.
|
||||
- Chain Workbench, Graph-Index und Backend können `Note#Abschnitt`-Links nutzen, sofern sie diese Form unterstützen.
|
||||
- Lint/Validierung: optional prüfen, dass Abschnitts-Links konsistent sind.
|
||||
|
||||
**Dokumentation:** Siehe auch `docs/WP26_Plugin_Interface_Specification.md` (Abschnitt Interview, Edge-per-Section, Note#Abschnitt).
|
||||
|
||||
---
|
||||
|
||||
### 3.7 Phase 6: Dictionary-Integration
|
||||
|
||||
#### FA-PL-13: Types-Loader (wie bisher)
|
||||
|
||||
**Anforderung:** Laden und Validierung von `types.yaml`.
|
||||
|
||||
@@ -851,16 +940,31 @@ export interface WP26FeatureFlags {
|
||||
- FA-PL-11: Schema-Validierung für Intra-Note-Edges
|
||||
|
||||
### Phase 5: Commands
|
||||
- FA-PL-12: Neue Commands
|
||||
- FA-PL-12: Commands für WP-26 und Edge-Überarbeitung (Stand: implementierte vs. geplante Commands)
|
||||
- FA-PL-12a: Sichtbarkeit Edge-Commands (optional: ohne Editor-Kontext auffindbar machen)
|
||||
|
||||
### Phase 6: Dictionary-Integration
|
||||
- FA-PL-13: Types-Loader
|
||||
|
||||
### Erweiterung (implementiert)
|
||||
- FA-PL-14: Section-Edges und Note-Edges im Interview (inkl. Note#Abschnitt)
|
||||
|
||||
---
|
||||
|
||||
## 8. Risiken und Mitigation
|
||||
## 8. Nächste Schritte (Empfehlung)
|
||||
|
||||
### 8.1 Risiken
|
||||
1. **Commands auffindbar machen:** FA-PL-12a umsetzen (Dokumentation und/oder zusätzlichen Command ohne editorCallback), damit „Edge-Type ändern“ und „Build semantic mapping blocks“ in der Befehlspalette zuverlässig gefunden werden.
|
||||
2. **Kausal-Funktionen sichtbar machen:** „Inspect Chains“ und „Chain Workbench“ nutzen editorCallback und erscheinen nur bei geöffneter MD-Datei (siehe Abschnitt 2.1.4). Optionen: (a) Im Benutzerhandbuch festhalten: „Eine Markdown-Note muss geöffnet sein.“ (b) Zusätzlich Commands ohne editorCallback anbieten, die bei fehlender Datei einen Hinweis anzeigen, damit die Befehle in der Palette sichtbar bleiben.
|
||||
3. **Hinweis bei fehlenden Chain-Dictionaries:** Wenn `chain_roles.yaml` oder `chain_templates.yaml` nicht geladen werden können, soll vor Ausführung von Inspect Chains / Chain Workbench ein **Notice** erscheinen (z. B. „Chain Roles nicht geladen. Bitte Pfad in den Einstellungen prüfen.“), damit Nutzer nicht mit leerer oder reduzierter Analyse dastehen.
|
||||
4. **Geplante Commands (FA-PL-12):** Priorisierung von „Add Section Type“, „Add Block ID to Heading“, „Insert Intra-Note Edge“, „Validate Section Types“ gemäß Nutzerbedarf.
|
||||
5. **Interview-Edge-Erweiterung (FA-PL-14):** Abnahme mit Backend (Note#Abschnitt in Links/Mapping-Blöcken); ggf. Lint-Regel für konsistente Abschnitts-Links.
|
||||
6. **WP26-Spezifikation:** Implementierungsstand in `WP26_Plugin_Interface_Specification.md` fortlaufend anpassen (siehe dort Abschnitt 9 / 10).
|
||||
|
||||
---
|
||||
|
||||
## 9. Risiken und Mitigation
|
||||
|
||||
### 9.1 Risiken
|
||||
|
||||
| Risiko | Wahrscheinlichkeit | Impact | Mitigation |
|
||||
|--------|-------------------|--------|------------|
|
||||
@@ -871,9 +975,9 @@ export interface WP26FeatureFlags {
|
||||
|
||||
---
|
||||
|
||||
## 9. Erfolgskriterien
|
||||
## 10. Erfolgskriterien
|
||||
|
||||
### 9.1 Funktionale Kriterien
|
||||
### 10.1 Funktionale Kriterien
|
||||
|
||||
- ✅ Alle bestehenden Funktionen funktionieren unverändert
|
||||
- ✅ Section-Types werden korrekt erkannt und geparst
|
||||
@@ -882,7 +986,7 @@ export interface WP26FeatureFlags {
|
||||
- ✅ UI-Komponenten unterstützen Section-Types
|
||||
- ✅ Lint-Regeln validieren Section-Types
|
||||
|
||||
### 9.2 Qualitätskriterien
|
||||
### 10.2 Qualitätskriterien
|
||||
|
||||
- ✅ Keine Breaking Changes
|
||||
- ✅ Vollständige Abwärtskompatibilität
|
||||
@@ -891,18 +995,23 @@ export interface WP26FeatureFlags {
|
||||
|
||||
---
|
||||
|
||||
## 10. Anhänge
|
||||
## 11. Anhänge
|
||||
|
||||
### 10.1 Referenzen
|
||||
### 11.1 Referenzen
|
||||
|
||||
- Backend Lastenheft: `docs/06_Roadmap/06_LH_Section_Types_Intra_Note_Edges.md` (v1.3)
|
||||
- Backend Plugin Interface: `docs/WP26_Plugin_Interface_Specification.md`
|
||||
- Backend Implementation Checklist: `docs/WP26_Implementation_Checklist.md`
|
||||
|
||||
### 10.2 Glossar
|
||||
### 11.2 Glossar
|
||||
|
||||
Siehe Backend Lastenheft Kapitel 1.3.
|
||||
|
||||
### 11.3 Chain Inspector & Chain Workbench (detailliert)
|
||||
|
||||
- **Lastenheft Chain Inspector & Chain Workbench:** `docs/09_Chain_Inspector_Workbench_Lastenheft.md` – vollständige fachliche und technische Anforderungen (effective_type, Findings, Todos, Commands).
|
||||
- **Umsetzungsplan Chain Inspector & Chain Workbench:** `docs/09_Chain_Inspector_Workbench_Umsetzungsplan.md` – detaillierte Phasen, Tasks und offene Punkte aus früheren Implementierungsplänen (Section-Type-Integration, Findings-Integration, FA-PL-08).
|
||||
|
||||
---
|
||||
|
||||
**Ende des Lastenhefts**
|
||||
@@ -0,0 +1,250 @@
|
||||
# LASTENHEFT: Chain Inspector & Chain Workbench
|
||||
|
||||
**Version:** 1.0
|
||||
**Datum:** 28. Januar 2026
|
||||
**Status:** Entwurf
|
||||
**Projekt:** mindnet_obsidian (Obsidian Community Plugin)
|
||||
**Bezug:** WP-26 Integration (06_LH_WP26_Plugin_Integration.md), FA-PL-08; Chain Inspector v0.4.x / v0.4.2; Chain Workbench Findings Integration (10_Workbench_Findings_Integration.md)
|
||||
|
||||
---
|
||||
|
||||
## 1. Einleitung
|
||||
|
||||
### 1.1 Zweck
|
||||
|
||||
Dieses Lastenheft definiert die **vollständigen fachlichen und technischen Anforderungen** für die Kausal-Funktionen **Chain Inspector** und **Chain Workbench** im mindnet_obsidian Plugin. Es umfasst:
|
||||
|
||||
- Die Integration der **Section-Type-Logik** (effective_type) in Chain-Analyse und Workbench (FA-PL-08).
|
||||
- Die Anforderungen aus den früheren Implementierungsberichten (Chain Inspector v0.0–v0.4.2, Chain Workbench 0.5.x).
|
||||
- Offene Punkte aus dem Vorschlag **Workbench Findings Integration** (Findings → Todos, Actions).
|
||||
- Commands, Sichtbarkeit, Dictionary-Abhängigkeiten und UX.
|
||||
|
||||
### 1.2 Geltungsbereich
|
||||
|
||||
- **Chain Inspector:** Analyse kausaler Ketten um die aktuelle Section (Template-Matching, Findings, Rollen, Gaps).
|
||||
- **Chain Workbench:** UI für Findings, Template-Matches, TODOs und Fix-Actions.
|
||||
- **Section-Types:** Explizite Typen pro Abschnitt (`[!section] type`), Fallback auf Note-Type; Verwendung als `effective_type` in Chain-Matching.
|
||||
|
||||
### 1.3 Abhängigkeiten
|
||||
|
||||
- **Backend:** WP-26 (Section Types & Intra-Note-Edges).
|
||||
- **Plugin:** Section-Type-Callout-Parsing (FA-PL-01), Block-ID-Extraktion (FA-PL-02), Types-Loader (FA-PL-13).
|
||||
- **Dictionary:** `chain_roles.yaml`, `chain_templates.yaml`, `edge_vocabulary.md`, optional `types.yaml`, `graph_schema.md`.
|
||||
|
||||
---
|
||||
|
||||
## 2. Begriffe und Definitionen
|
||||
|
||||
| Begriff | Definition |
|
||||
|--------|------------|
|
||||
| **Effective Type** | Für einen Knoten (Section/Note): `sectionType \|\| noteType`. Wird für Template-Slot-Matching und Gap-Detection verwendet. |
|
||||
| **Section-Type** | Explizit per `> [!section] type` definierter Typ eines Abschnitts. |
|
||||
| **Note-Type** | Aus Frontmatter `type:` der Note. |
|
||||
| **Template Match** | Zuweisung von Candidate-Nodes zu Template-Slots unter Berücksichtigung von `allowed_node_types` und `allowed_edge_roles`. |
|
||||
| **Finding** | Ein vom Chain Inspector erzeugtes Analyseergebnis (z. B. `no_causal_roles`, `missing_link`, `dangling_target`). |
|
||||
| **Workbench Todo** | Aus Finding oder Template-Match abgeleitete konkrete Aufgabe mit Priorität und optionalen Actions. |
|
||||
|
||||
---
|
||||
|
||||
## 3. Chain Inspector – Anforderungen
|
||||
|
||||
### 3.1 Kernfunktion
|
||||
|
||||
- **Eingabe:** Aktuelle Datei + aktuelle Section (Cursor-Position / Heading).
|
||||
- **Ausgabe:** `ChainInspectorReport` mit Nachbarn, Pfaden, Findings, Template-Matches, Analyse-Meta, Templates-Source, optional Template-Matching-Profile.
|
||||
|
||||
### 3.2 Effective Type (Section-Type-Integration)
|
||||
|
||||
**LH-CI-01: Effective Type pro Knoten**
|
||||
|
||||
- Für jeden **Knoten** (file + heading) muss ein **effective_type** ermittelt werden.
|
||||
- **Regel:** `effectiveType = sectionType || noteType`.
|
||||
- **sectionType:** Aus geparster Note: Section, die durch `heading` identifiziert wird, enthält ein `[!section] type` Callout → dieser Typ.
|
||||
- **noteType:** Aus Frontmatter `type:` der zugehörigen Datei.
|
||||
- **Fallback:** Wenn weder Section-Type noch Note-Type vorhanden: `"unknown"`.
|
||||
|
||||
**Betroffene Stellen:**
|
||||
|
||||
- `src/analysis/templateMatching.ts`: Aktuell wird nur `extractNoteType(content)` pro Datei verwendet; für Section-Knoten (mit heading) muss pro Section der Section-Type aus dem geparsten Dokument gelesen werden.
|
||||
- `src/analysis/chainInspector.ts`: Report und Findings müssen effective_type unterstützen (z. B. in SlotAssignments oder Meta).
|
||||
- `src/mapping/sectionParser.ts`: Muss `[!section]` erkennen und `sectionType` in `NoteSection` liefern (vgl. FA-PL-01); aktuell fehlt `sectionType` in `NoteSection`.
|
||||
|
||||
### 3.3 Template-Matching mit Section-Types
|
||||
|
||||
**LH-CI-02: Slot-Matching mit effective_type**
|
||||
|
||||
- Beim Zuordnen von Candidate-Nodes zu Template-Slots gilt: **Slot-Constraint** `allowed_node_types` wird gegen **effective_type** des Knotens geprüft (nicht nur gegen noteType).
|
||||
- Bestehende Logik in `nodeMatchesSlot(node, slot)` muss mit `node.effectiveType` (oder äquivalent) arbeiten.
|
||||
|
||||
**LH-CI-03: Provenance**
|
||||
|
||||
- Im Report soll erkennbar sein, ob ein Slot-Type aus Section-Type oder Note-Type stammt (optional: `typeSource: "section" | "note" | "unknown"` pro Slot-Zuordnung).
|
||||
|
||||
### 3.4 Findings
|
||||
|
||||
**LH-CI-04: Bestehende Finding-Codes**
|
||||
|
||||
- Folgende Finding-Codes müssen unterstützt und dokumentiert sein:
|
||||
- `dangling_target`, `dangling_target_heading`
|
||||
- `only_candidates`, `missing_edges`, `no_causal_roles`, `one_sided_connectivity`
|
||||
- `missing_slot_<slotId>`, `weak_chain_roles`
|
||||
- Optional: `slot_type_mismatch` (v0.4 Report: bisher nicht implementiert, da Matching Mismatches verhindert).
|
||||
|
||||
**LH-CI-05: Findings mit Section-Type-Kontext**
|
||||
|
||||
- Findings können optional `effectiveType` der betroffenen Section bzw. des Knotens enthalten (für bessere Workbench-Todos und Fix-Actions).
|
||||
|
||||
### 3.5 Gap-Detection und Section-Types
|
||||
|
||||
**LH-CI-06: Fehlende Section-Types als Gap**
|
||||
|
||||
- Wenn ein Template einen Slot mit z. B. `allowed_node_types: ["experience"]` vorsieht und die aktuelle Section keinen Section-Type hat, aber der Note-Type z. B. "concept" ist, soll dies als Gap/Finding behandelbar sein (z. B. „Section-Type setzen oder Note-Type anpassen“).
|
||||
- Konkret: Gap-Detection soll erkennen, wenn **effective_type** nicht zu den erlaubten Slot-Types passt, und ggf. ein Finding/Todo vorschlagen (z. B. „Add Section Type experience“).
|
||||
|
||||
### 3.6 Dictionary-Abhängigkeiten
|
||||
|
||||
**LH-CI-07: Verhalten bei fehlenden Dictionaries**
|
||||
|
||||
- Wenn `chain_roles.yaml` oder `chain_templates.yaml` nicht geladen werden können:
|
||||
- Es soll eine **Notice** angezeigt werden (z. B. „Chain Roles nicht geladen. Bitte Pfad in den Einstellungen prüfen.“) und der Command **abbrechen** (kein stilles Weiterlaufen mit reduzierter Funktionalität).
|
||||
- Implementierungsstand: In `main.ts` wurde bereits eine Prüfung und Notice eingebaut; im Lastenheft wird dies als verbindlich festgehalten.
|
||||
|
||||
### 3.7 Commands und Sichtbarkeit
|
||||
|
||||
**LH-CI-08: Command „Mindnet: Inspect Chains (Current Section)“**
|
||||
|
||||
- **ID:** `mindnet-inspect-chains`.
|
||||
- **Kontext:** editorCallback (nur bei geöffneter Markdown-Datei).
|
||||
- **Verhalten:** Führt Chain Inspector aus, gibt Report in Console aus (oder vergleichbar).
|
||||
- **Optional (FA-PL-12a):** Zusätzlicher Command ohne editorCallback, der bei fehlender Datei eine Notice anzeigt, damit der Befehl in der Palette sichtbar bleibt.
|
||||
|
||||
---
|
||||
|
||||
## 4. Chain Workbench – Anforderungen
|
||||
|
||||
### 4.1 Kernfunktion
|
||||
|
||||
- **Eingabe:** Wie Chain Inspector (aktuelle Datei + Section) plus geladene Chain-Templates, Chain-Roles, Edge-Vocabulary.
|
||||
- **Ausgabe:** Workbench-Model mit **Matches** (Template-Matches inkl. Status/Todos) und **globalTodos** (aus Findings).
|
||||
|
||||
### 4.2 Section-Type in Workbench-Model
|
||||
|
||||
**LH-CW-01: WorkbenchMatch mit Section-Types**
|
||||
|
||||
- Jeder Match soll optional **effective_type** (oder Section-Type) pro zugewiesenem Slot führen (für Anzeige und für Todo-Vorschläge).
|
||||
- Vgl. WP26-Spezifikation: `sectionTypes?: Map<string, string>`.
|
||||
|
||||
**LH-CW-02: Todos mit Section-Type-Kontext**
|
||||
|
||||
- Missing-Link- und Missing-Slot-Todos sollen **fromSectionType** / **toSectionType** (bzw. effective_type) enthalten, damit Edge-Type-Vorschläge aus `graph_schema.md` korrekt berechnet werden können.
|
||||
|
||||
### 4.3 Findings → Todos (Workbench Findings Integration)
|
||||
|
||||
**LH-CW-03: Generierung von Todos aus Findings**
|
||||
|
||||
- Die in **10_Workbench_Findings_Integration.md** beschriebene Funktion **generateFindingsTodos()** soll umgesetzt werden:
|
||||
- Eingabe: `Finding[]`, `IndexedEdge[]`, Kontext `{ file, heading }`.
|
||||
- Ausgabe: `WorkbenchTodoUnion[]` (u. a. `DanglingTargetTodo`, `OnlyCandidatesTodo`, `NoCausalRolesTodo`, `MissingEdgesTodo`, `OneSidedConnectivityTodo`).
|
||||
- **Todo-Typen** sind in `src/workbench/types.ts` bereits definiert (`dangling_target`, `only_candidates`, `no_causal_roles`, etc.); die **Generierung** aus Findings und die **Integration** in `buildWorkbenchModel()` sind umzusetzen.
|
||||
|
||||
**LH-CW-04: Integration in buildWorkbenchModel**
|
||||
|
||||
- `buildWorkbenchModel()` soll neben Template-Match-basierten Todos auch **globalTodos** aus `report.findings` erzeugen (über `generateFindingsTodos()`).
|
||||
- **WorkbenchModel** soll `globalTodos?: WorkbenchTodoUnion[]` enthalten.
|
||||
|
||||
**LH-CW-05: UI-Anzeige**
|
||||
|
||||
- Im Chain Workbench Modal sollen **Section-Level Issues** (aus Findings) getrennt von **Template-Match-Todos** angezeigt werden (z. B. zuerst „Section-Level Issues“, dann „Template Matches“).
|
||||
|
||||
### 4.4 TODO-Generator und Section-Types
|
||||
|
||||
**LH-CW-06: Section-Type-Vorschläge**
|
||||
|
||||
- Der TODO-Generator soll bei fehlendem oder unpassendem Section-Type Vorschläge liefern (z. B. „Add Section Type: experience“), vgl. FA-PL-08.
|
||||
|
||||
### 4.5 Fix-Actions
|
||||
|
||||
**LH-CW-07: Bestehende Fix-Actions**
|
||||
|
||||
- Die in Chain Inspector v0.3 und im Fix-Findings-Command implementierten Actions bleiben erhalten und erweiterbar:
|
||||
- `dangling_target`: Create Missing Note, Retarget Link
|
||||
- `dangling_target_heading`: Create Missing Heading, Retarget
|
||||
- `only_candidates`: Promote Candidates, Create Explicit Edges
|
||||
- **Optional:** Actions für `no_causal_roles` (z. B. „Edge-Type ändern“) und `missing_edges` („Add edges to section“) wie in 10_Workbench_Findings_Integration.md skizziert.
|
||||
|
||||
### 4.6 Command und Sichtbarkeit
|
||||
|
||||
**LH-CW-08: Command „Mindnet: Chain Workbench (Current Section)“**
|
||||
|
||||
- **ID:** `mindnet-chain-workbench`.
|
||||
- **Kontext:** editorCallback.
|
||||
- **Verhalten:** Öffnet Chain Workbench Modal mit aktuellem Report/Model.
|
||||
- **Optional (FA-PL-12a):** Zusätzlicher Command ohne Editor, mit Notice bei fehlender Datei.
|
||||
|
||||
### 4.7 Scan Chain Gaps
|
||||
|
||||
**LH-CW-09: Command „Mindnet: Scan Vault for Chain Gaps“**
|
||||
|
||||
- Soll ebenfalls Notice auslösen, wenn Chain-Dictionaries fehlen; Section-Type-Logik soll bei Vault-Scan berücksichtigt werden (effective_type pro Section), sofern technisch eingebaut.
|
||||
|
||||
---
|
||||
|
||||
## 5. Abhängigkeiten von Parser und Mapping
|
||||
|
||||
### 5.1 Section-Parser (FA-PL-01)
|
||||
|
||||
- **NoteSection** muss erweitert werden um:
|
||||
- `sectionType: string | null` (aus `[!section] type`).
|
||||
- `blockId: string | null` (aus Heading `^block-id`).
|
||||
- Ohne diese Erweiterung kann Chain Inspector **keinen** Section-Type pro Section nutzen; dann bleibt nur Note-Type (bisheriges Verhalten).
|
||||
|
||||
### 5.2 Graph-Index
|
||||
|
||||
- **buildNoteIndex** nutzt `splitIntoSections`; sobald `NoteSection.sectionType` existiert, muss der Graph-Index oder eine nachgelagerte Schicht (z. B. templateMatching) pro Section den Section-Type aus den geparsten Sections auslesen und an Candidate-Nodes weitergeben.
|
||||
|
||||
### 5.3 Types-Loader (FA-PL-13)
|
||||
|
||||
- Optional: Validierung von Section-Types gegen `types.yaml` (z. B. Lint oder Hinweis im Workbench).
|
||||
|
||||
---
|
||||
|
||||
## 6. Nichtfunktionale Anforderungen
|
||||
|
||||
### 6.1 Performance
|
||||
|
||||
- Template-Matching: Max. 30 Candidate-Nodes, Backtracking für typisch ≤ 5 Slots; Top-K Matches begrenzt (z. B. 3).
|
||||
- Keine Blockierung der UI; bei großen Reports ggf. asynchron oder mit Fortschrittsanzeige.
|
||||
|
||||
### 6.2 Abwärtskompatibilität
|
||||
|
||||
- Notes **ohne** Section-Types funktionieren unverändert: effective_type = noteType.
|
||||
- Bestehende Chain-Templates und Chain-Roles bleiben gültig.
|
||||
|
||||
### 6.3 Dokumentation
|
||||
|
||||
- Benutzerhandbuch: Erklärung, dass „Inspect Chains“ und „Chain Workbench“ nur bei **geöffneter Markdown-Datei** in der Befehlspalette verfügbar sind.
|
||||
- Dokumentation der Finding-Codes und Todo-Typen (z. B. in diesem Lastenheft oder im Konzeptdokument 03_chain_identification_and_matching.md).
|
||||
|
||||
---
|
||||
|
||||
## 7. Erfolgskriterien (Zusammenfassung)
|
||||
|
||||
- **Chain Inspector:** Verwendet effective_type (Section-Type oder Note-Type) für Template-Matching und Gap-Detection; Findings inkl. Section-Type-Kontext wo sinnvoll; Notice bei fehlenden Dictionaries.
|
||||
- **Chain Workbench:** Zeigt Template-Matches und Section-Level-Todos (aus Findings); Todos enthalten Section-Type-Information für Edge-Vorschläge; Fix-Actions für die definierten Finding-Typen.
|
||||
- **Section-Type-Integration:** Section-Parser liefert sectionType; Template-Matching und Workbench nutzen effective_type durchgängig.
|
||||
- **Offene Punkte aus Findings-Integration:** generateFindingsTodos umgesetzt, in buildWorkbenchModel integriert, UI für globalTodos; Priorisierung/Deduplizierung wie in Umsetzungsplan geregelt.
|
||||
|
||||
---
|
||||
|
||||
## 8. Referenzen
|
||||
|
||||
- **06_LH_WP26_Plugin_Integration.md** – FA-PL-08, FA-PL-12, FA-PL-12a, FA-PL-14
|
||||
- **WP26_Plugin_Interface_Specification.md** – Abschnitte 3.4, 8.2
|
||||
- **10_Workbench_Findings_Integration.md** – Findings → Todos, Todo-Typen, Phasen
|
||||
- **CHAIN_INSPECTOR_V04_REPORT.md**, **CHAIN_INSPECTOR_V042_REPORT.md** – Template Matching, Profiles
|
||||
- **02_concepts/03_chain_identification_and_matching.md** – Konzepte
|
||||
- **08_Testing_Chain_Workbench.md** – Testanleitung
|
||||
|
||||
---
|
||||
|
||||
**Ende des Lastenhefts**
|
||||
@@ -0,0 +1,199 @@
|
||||
# Umsetzungsplan: Chain Inspector & Chain Workbench (Section-Type-Integration)
|
||||
|
||||
**Version:** 1.0
|
||||
**Datum:** 28. Januar 2026
|
||||
**Status:** Entwurf
|
||||
**Bezug:** 09_Chain_Inspector_Workbench_Lastenheft.md, 06_LH_WP26_Plugin_Integration.md (FA-PL-08), 10_Workbench_Findings_Integration.md, CHAIN_INSPECTOR_V0x_REPORTs
|
||||
|
||||
---
|
||||
|
||||
## 1. Übersicht
|
||||
|
||||
Dieser Umsetzungsplan beschreibt die **detaillierte Implementierungsreihenfolge** für:
|
||||
|
||||
1. **Section-Type-Integration** in Chain Inspector und Chain Workbench (FA-PL-08, Lastenheft 09).
|
||||
2. **Offene Punkte** aus früheren Implementierungsplänen (Findings Integration, Chain Inspector Reports, Lastenheft „Nächste Schritte“).
|
||||
|
||||
Die Phasen bauen aufeinander auf; Abhängigkeiten sind explizit genannt.
|
||||
|
||||
---
|
||||
|
||||
## 2. Offene Punkte aus früheren Plänen (Konsolidiert)
|
||||
|
||||
### 2.1 Aus 10_Workbench_Findings_Integration.md
|
||||
|
||||
| Offener Punkt | Beschreibung | Integration in Umsetzungsplan |
|
||||
|---------------|--------------|-------------------------------|
|
||||
| **Findings → Todos** | Workbench nutzt aktuell nur Template-Matches, nicht Findings (dangling_target, no_causal_roles, etc.). | Phase 4: generateFindingsTodos, buildWorkbenchModel, UI. |
|
||||
| **Todo-Typen** | DanglingTargetTodo, OnlyCandidatesTodo, NoCausalRolesTodo, MissingEdgesTodo, OneSidedConnectivityTodo. | Types bereits in workbench/types.ts; Generierung in Phase 4. |
|
||||
| **Priorität Findings vs. Template** | Sollen Findings-Todos höhere Priorität haben? | Entscheidung: Section-Level Issues zuerst anzeigen (LH-CW-05). |
|
||||
| **Duplikate** | Vermeidung von Duplikaten (z. B. dangling_target vs. missing_link). | Phase 4: Deduplizierung nach Kontext (file, heading, finding.code). |
|
||||
| **Filterung** | Filter nach Severity (z. B. nur Errors). | Optional: Phase 5 oder später. |
|
||||
| **Actions** | create_missing_note, retarget_link, promote_all_candidates, change_edge_type, etc. | Teilweise in Fix-Findings-Command (v0.3); no_causal_roles/missing_edges optional Phase 5. |
|
||||
|
||||
### 2.2 Aus CHAIN_INSPECTOR Reports (v0.4, v0.4.2)
|
||||
|
||||
| Offener Punkt | Beschreibung | Integration |
|
||||
|---------------|--------------|-------------|
|
||||
| **Top-K Limit** | Nur Top-1 Match pro Template (K=1). | Optional: K konfigurierbar (z. B. 3) – bereits maxTemplateMatches in Options. |
|
||||
| **Node-Limit** | Max 30 Candidate-Nodes. | Unverändert; Sicherheit. |
|
||||
| **slot_type_mismatch** | Finding nicht implementiert. | Optional: Phase 3 oder später; aktuell Matching verhindert Mismatches. |
|
||||
| **Node-Type = Note-Type** | Template-Matching nutzt nur Frontmatter type. | Phase 1–2: effective_type (Section-Type \|\| Note-Type). |
|
||||
| **Profile (discovery/decisioning)** | Bereits in v0.4.2. | Unverändert; Section-Type-Integration ergänzt. |
|
||||
|
||||
### 2.3 Aus 06_LH_WP26_Plugin_Integration.md (Nächste Schritte)
|
||||
|
||||
| Offener Punkt | Beschreibung | Integration |
|
||||
|---------------|--------------|-------------|
|
||||
| **Commands sichtbar** | Inspect Chains / Chain Workbench nur bei geöffneter MD-Datei. | Optional: Phase 5 – zusätzliche Commands ohne editorCallback mit Notice. |
|
||||
| **Notice bei fehlenden Dictionaries** | Chain Roles/Templates nicht geladen → Notice + Abbruch. | Bereits umgesetzt in main.ts; in Lastenheft 09 verbindlich (LH-CI-07). |
|
||||
| **FA-PL-08** | Chain Workbench mit Section-Types. | Phase 1–3: effective_type durchgängig. |
|
||||
|
||||
### 2.4 Aus WP26_Plugin_Interface_Specification.md
|
||||
|
||||
| Offener Punkt | Beschreibung | Integration |
|
||||
|---------------|--------------|-------------|
|
||||
| **Section-Type in Chain-Matching** | WorkbenchMatch.sectionTypes, MissingLinkTodo.fromSectionType/toSectionType. | Phase 2 (Template-Matching), Phase 4 (Todos). |
|
||||
| **Intra-Note-Edge-Erkennung** | detectIntraNoteEdges für bessere Chain-Analyse. | Optional: Phase 3 oder später; abhängig von FA-PL-03/Graph-Index. |
|
||||
|
||||
---
|
||||
|
||||
## 3. Voraussetzungen (Vorbedingungen)
|
||||
|
||||
- **FA-PL-01 (Section-Type-Callout-Parsing):** `[!section]` muss im Section-Parser erkannt und als `sectionType` in `NoteSection` gespeichert werden.
|
||||
- **Aktueller Stand:** `NoteSection` in `sectionParser.ts` hat **kein** Feld `sectionType` bzw. `blockId`. Diese Erweiterung ist **Voraussetzung** für effective_type in Chain Inspector.
|
||||
- **FA-PL-02 (Block-ID):** Optional für bessere Referenzierung; nicht zwingend für effective_type.
|
||||
- **FA-PL-13 (Types-Loader):** Optional für Validierung von Section-Types.
|
||||
|
||||
Ohne FA-PL-01 (Section-Parser mit sectionType) kann Phase 1 nur mit **Note-Type** (bisherig) arbeiten; effective_type wird dann erst nach Implementierung von FA-PL-01 wirksam.
|
||||
|
||||
---
|
||||
|
||||
## 4. Phase 1: Section-Parser und effective_type-Grundlage
|
||||
|
||||
**Ziel:** Section-Type in der Codebasis verfügbar machen und in Template-Matching als effective_type nutzen.
|
||||
|
||||
### 4.1 Tasks
|
||||
|
||||
| Nr | Task | Beschreibung | Dateien | Abhängigkeit |
|
||||
|----|------|--------------|---------|---------------|
|
||||
| 1.1 | **NoteSection um sectionType und blockId erweitern** | Interface `NoteSection` um `sectionType: string \| null` und `blockId: string \| null` erweitern; in `splitIntoSections` befüllen. | `src/mapping/sectionParser.ts` | – |
|
||||
| 1.2 | **Parsing von [!section] Callout** | In `splitIntoSections` pro Section nach Zeile mit `> [!section] <type>` suchen (Regex z. B. `/^\s*>\s*\[!section\]\s*(\w+)/i`), Typ extrahieren und in `sectionType` speichern. | `src/mapping/sectionParser.ts` | 1.1 |
|
||||
| 1.3 | **Parsing von Block-ID in Headings** | In Headings Muster `^#{1,6}\s+.+\s+\^([a-zA-Z0-9_-]+)$` erkennen, Block-ID in `blockId` speichern. | `src/mapping/sectionParser.ts` | 1.1 |
|
||||
| 1.4 | **Graph-Index: Sections mit sectionType bereitstellen** | `buildNoteIndex` oder eine neue Hilfsfunktion muss Sections inkl. sectionType an Aufrufer liefern (z. B. als Map `file:heading → sectionType` oder erweiterte SectionNode-Struktur). | `src/analysis/graphIndex.ts`, ggf. `chainInspector.ts` | 1.2 |
|
||||
| 1.5 | **effective_type-Funktion** | Hilfsfunktion `getEffectiveType(file, heading, sectionsWithType, noteTypeByFile): string` – liefert sectionType für (file, heading) falls vorhanden, sonst noteType, sonst "unknown". | `src/analysis/templateMatching.ts` oder neues Modul | 1.4 |
|
||||
|
||||
**Ergebnis Phase 1:** Section-Parser liefert sectionType; effective_type ist pro (file, heading) berechenbar.
|
||||
|
||||
---
|
||||
|
||||
## 5. Phase 2: Chain Inspector – effective_type im Template-Matching
|
||||
|
||||
**Ziel:** Template-Matching und Findings nutzen effective_type statt nur noteType.
|
||||
|
||||
### 5.1 Tasks
|
||||
|
||||
| Nr | Task | Beschreibung | Dateien | Abhängigkeit |
|
||||
|----|------|--------------|---------|---------------|
|
||||
| 2.1 | **CandidateNode um effectiveType erweitern** | Interface `CandidateNode` um `effectiveType: string` erweitern (oder `noteType` durch effective_type ersetzen, falls Abwärtskompatibilität gewahrt wird: zusätzliches Feld). | `src/analysis/templateMatching.ts` | Phase 1 |
|
||||
| 2.2 | **buildCandidateNodes: effective_type setzen** | Beim Aufbau der Candidate-Nodes für jeden Knoten (file, heading) effective_type ermitteln: Section-Type aus geparsten Sections (file muss gelesen, in Sections zerlegt werden; sectionType für passende Section verwenden), sonst noteType aus Frontmatter. | `src/analysis/templateMatching.ts` | 1.5, 2.1 |
|
||||
| 2.3 | **nodeMatchesSlot mit effectiveType** | Slot-Constraint `allowed_node_types` gegen `node.effectiveType` prüfen (bereits konzeptionell; sicherstellen, dass das genutzte Feld effectiveType ist). | `src/analysis/templateMatching.ts` | 2.2 |
|
||||
| 2.4 | **TemplateMatch / Report: typeSource optional** | In SlotAssignments optional `typeSource?: "section" \| "note" \| "unknown"` pro Slot für Provenance. | `src/analysis/chainInspector.ts`, `templateMatching.ts` | 2.2 |
|
||||
| 2.5 | **Gap-Detection: fehlender Section-Type** | Wenn Slot z. B. "experience" erwartet, aber effective_type "unknown" oder nicht in allowed_node_types: Finding oder Todo-Vorschlag „Add Section Type“ / „Set section type to experience“. | `src/analysis/chainInspector.ts`, ggf. `todoGenerator.ts` | 2.3 |
|
||||
|
||||
**Ergebnis Phase 2:** Chain Inspector verwendet effective_type durchgängig; Gap-Detection kann fehlende Section-Types melden.
|
||||
|
||||
---
|
||||
|
||||
## 6. Phase 3: Chain Workbench – Section-Type in Model und Todos
|
||||
|
||||
**Ziel:** Workbench-Model und Todo-Typen enthalten Section-Type-Information; Edge-Vorschläge können section-type-basiert erfolgen.
|
||||
|
||||
### 6.1 Tasks
|
||||
|
||||
| Nr | Task | Beschreibung | Dateien | Abhängigkeit |
|
||||
|----|------|--------------|---------|---------------|
|
||||
| 3.1 | **WorkbenchMatch: sectionTypes / effectiveType pro Slot** | WorkbenchMatch (oder TemplateMatch) um optionale Map Slot-ID → effective_type erweitern; beim Aufbau aus TemplateMatch befüllen. | `src/workbench/types.ts`, `workbenchBuilder.ts` | Phase 2 |
|
||||
| 3.2 | **MissingLinkTodo / MissingSlotTodo: fromSectionType, toSectionType** | Todos um optionale Felder `fromSectionType`, `toSectionType` (bzw. effective_type) erweitern; in todoGenerator aus SlotAssignments/effective_type füllen. | `src/workbench/types.ts`, `todoGenerator.ts` | 2.4, 3.1 |
|
||||
| 3.3 | **Edge-Type-Vorschläge aus graph_schema** | Wenn fromSectionType und toSectionType vorhanden: `getTopologyInfo(sourceType, targetType)` aus Schema aufrufen und suggestedEdgeTypes daraus ableiten. | `src/workbench/todoGenerator.ts`, `schemaHelper.ts` | 3.2 |
|
||||
| 3.4 | **Section-Type-Todo „Add Section Type“** | Neuer Todo-Typ oder Erweiterung: Vorschlag „Add Section Type: experience“ bei Gap (vgl. LH-CW-06). | `src/workbench/todoGenerator.ts`, `types.ts` | 2.5, 3.1 |
|
||||
|
||||
**Ergebnis Phase 3:** Workbench zeigt Section-Type-Information in Matches und Todos; Edge-Vorschläge nutzen Section-Types wo vorhanden.
|
||||
|
||||
---
|
||||
|
||||
## 7. Phase 4: Findings-Integration (Workbench Findings Integration)
|
||||
|
||||
**Ziel:** Findings aus Chain Inspector werden in Workbench als globalTodos angezeigt; keine Duplikate mit Template-Todos.
|
||||
|
||||
### 7.1 Tasks
|
||||
|
||||
| Nr | Task | Beschreibung | Dateien | Abhängigkeit |
|
||||
|----|------|--------------|---------|---------------|
|
||||
| 4.1 | **generateFindingsTodos implementieren** | Funktion wie in 10_Workbench_Findings_Integration.md: Findings (dangling_target, dangling_target_heading, only_candidates, missing_edges, no_causal_roles, one_sided_connectivity) in WorkbenchTodoUnion übersetzen. | `src/workbench/todoGenerator.ts` | – |
|
||||
| 4.2 | **buildWorkbenchModel: globalTodos** | Nach Verarbeitung der Template-Matches: `report.findings` an generateFindingsTodos übergeben; Ergebnis in `model.globalTodos` speichern. | `src/workbench/workbenchBuilder.ts` | 4.1 |
|
||||
| 4.3 | **WorkbenchModel.globalTodos** | Interface `WorkbenchModel` um `globalTodos?: WorkbenchTodoUnion[]` erweitern (falls noch nicht vorhanden). | `src/workbench/types.ts` | 4.2 |
|
||||
| 4.4 | **Deduplizierung** | Wenn ein Finding und ein Template-Todo dasselbe Problem beschreiben (z. B. dangling_target vs. missing_link für dieselbe Datei/Section): nur eines anzeigen (z. B. Findings-Todo priorisieren oder Template-Todo). | `src/workbench/workbenchBuilder.ts` | 4.2 |
|
||||
| 4.5 | **ChainWorkbenchModal: Section-Level Issues** | UI: Abschnitt „Section-Level Issues“ (oder „Findings“) mit globalTodos oberhalb der Template-Matches rendern. | `src/workbench/ChainWorkbenchModal.ts` (bzw. wo das Modal lebt) | 4.3 |
|
||||
| 4.6 | **Findings mit effective_type** | Optional: In generateFindingsTodos Kontext (file, heading) nutzen und effective_type in Todo-Beschreibung oder -Metadaten aufnehmen. | `src/workbench/todoGenerator.ts` | Phase 2 |
|
||||
|
||||
**Ergebnis Phase 4:** Workbench zeigt Section-Level Issues aus Findings; Konsistenz mit Chain Inspector; klare Trennung Findings vs. Template-Matches.
|
||||
|
||||
---
|
||||
|
||||
## 8. Phase 5: UX, Commands, Optionale Erweiterungen
|
||||
|
||||
**Ziel:** Sichtbarkeit der Commands, optionale Filter/Actions, Dokumentation.
|
||||
|
||||
### 8.1 Tasks
|
||||
|
||||
| Nr | Task | Beschreibung | Dateien | Abhängigkeit |
|
||||
|----|------|--------------|---------|---------------|
|
||||
| 5.1 | **Commands ohne Editor (optional)** | Zusätzliche Commands „Mindnet: Inspect Chains“ / „Mindnet: Chain Workbench“ ohne editorCallback; bei Aufruf ohne geöffnete MD-Datei: Notice „Bitte zuerst eine Markdown-Datei öffnen.“ (FA-PL-12a). | `src/main.ts` | – |
|
||||
| 5.2 | **Notice bei fehlenden Dictionaries (Bestätigung)** | Sicherstellen, dass Inspect Chains und Chain Workbench bei fehlenden chain_roles/chain_templates mit Notice abbrechen (bereits in main.ts; nur prüfen). | `src/main.ts` | – |
|
||||
| 5.3 | **Benutzerhandbuch** | Kurzabschnitt: „Inspect Chains“ und „Chain Workbench“ sind nur bei geöffneter Markdown-Datei in der Befehlspalette verfügbar; bei fehlenden Dictionary-Dateien erscheint ein Hinweis. | docs (z. B. 01_Benutzerhandbuch.md) | – |
|
||||
| 5.4 | **Filter nach Severity (optional)** | Im Workbench Modal Filter „Nur Errors“ / „Errors und Warnings“ für globalTodos. | `src/workbench/ChainWorkbenchModal.ts` | 4.5 |
|
||||
| 5.5 | **Actions für no_causal_roles / missing_edges (optional)** | Fix-Actions „Edge-Type ändern“ für no_causal_roles, „Add edges to section“ für missing_edges (vgl. 10_Workbench_Findings_Integration.md Phase 5). | `src/commands/fixFindingsCommand.ts`, Workbench UI | 4.1 |
|
||||
| 5.6 | **slot_type_mismatch Finding (optional)** | Falls gewünscht: Finding ausgeben, wenn zugewiesener Node effective_type hat, der nicht in allowed_node_types liegt (aktuell verhindert Matching das). | `src/analysis/chainInspector.ts` oder templateMatching | Phase 2 |
|
||||
| 5.7 | **Intra-Note-Edges in Chain-Analyse (optional)** | detectIntraNoteEdges nutzen, um Chains innerhalb einer Note zu erkennen (WP26-Spec). | `src/analysis/chainInspector.ts`, graphIndex | FA-PL-03 |
|
||||
|
||||
**Ergebnis Phase 5:** Bessere Auffindbarkeit der Commands, dokumentiertes Verhalten, optionale Erweiterungen umsetzbar.
|
||||
|
||||
---
|
||||
|
||||
## 9. Abhängigkeitsgraph (Kurz)
|
||||
|
||||
```
|
||||
Phase 1 (Section-Parser, effective_type-Grundlage)
|
||||
→ Phase 2 (Chain Inspector effective_type)
|
||||
→ Phase 3 (Workbench Model/Todos Section-Type)
|
||||
→ Phase 4 (Findings → globalTodos) [4.1–4.3 unabhängig von Phase 2/3; 4.4–4.6 nutzen Kontext]
|
||||
→ Phase 5 (UX, Commands, Optionen)
|
||||
```
|
||||
|
||||
- **Phase 4.1–4.3** können parallel zu Phase 1–2 begonnen werden (Findings → Todos ohne Section-Type).
|
||||
- **Phase 4.4–4.6** (Deduplizierung, UI, effective_type in Findings) profitieren von Phase 2/3.
|
||||
|
||||
---
|
||||
|
||||
## 10. Test- und Abnahmepunkte
|
||||
|
||||
- **Phase 1:** Unit-Tests sectionParser (sectionType, blockId); Integration: buildNoteIndex liefert sectionType-Info.
|
||||
- **Phase 2:** Unit-Tests templateMatching (nodeMatchesSlot mit effectiveType); Integration: Inspect Chains Report mit effective_type in SlotAssignments.
|
||||
- **Phase 3:** Workbench zeigt fromSectionType/toSectionType in Todos; Edge-Vorschläge aus Schema.
|
||||
- **Phase 4:** Workbench zeigt globalTodos aus Findings; keine Doppelung mit Template-Todos; UI „Section-Level Issues“.
|
||||
- **Phase 5:** Commands ohne Editor zeigen Notice; Doku aktualisiert.
|
||||
|
||||
---
|
||||
|
||||
## 11. Referenzen
|
||||
|
||||
- **09_Chain_Inspector_Workbench_Lastenheft.md** – Alle Anforderungen (LH-CI-xx, LH-CW-xx).
|
||||
- **06_LH_WP26_Plugin_Integration.md** – FA-PL-01, FA-PL-08, FA-PL-12a.
|
||||
- **10_Workbench_Findings_Integration.md** – generateFindingsTodos, Todo-Typen, Phasen.
|
||||
- **CHAIN_INSPECTOR_V04_REPORT.md**, **CHAIN_INSPECTOR_V042_REPORT.md** – Template Matching, Profiles.
|
||||
- **WP26_Plugin_Interface_Specification.md** – Section-Type in Chain Workbench.
|
||||
|
||||
---
|
||||
|
||||
**Ende des Umsetzungsplans**
|
||||
@@ -0,0 +1,214 @@
|
||||
# Manuelle Testanleitung: Section-Type & Chain Inspector / Chain Workbench
|
||||
|
||||
**Version:** 1.0
|
||||
**Datum:** Januar 2026
|
||||
**Ziel:** Die implementierten Funktionen (Section-Parser mit `sectionType`/`blockId`, effective_type im Chain Inspector und Chain Workbench) manuell in Obsidian prüfen.
|
||||
|
||||
---
|
||||
|
||||
## 1. Voraussetzungen
|
||||
|
||||
- **Obsidian** mit aktiviertem Plugin **Mindnet Causal Assistant**
|
||||
- **Dictionary-Dateien** im Vault (z. B. unter `Dictionary/`):
|
||||
- `chain_templates.yaml`
|
||||
- `chain_roles.yaml`
|
||||
- `edge_vocabulary.md`
|
||||
- **Wichtig:** Die Commands **„Mindnet: Inspect Chains (Current Section)“** und **„Mindnet: Chain Workbench (Current Section)“** sind nur sichtbar, wenn eine **Markdown-Datei im Editor geöffnet** ist (editorCallback).
|
||||
|
||||
---
|
||||
|
||||
## 2. Automatische Tests ausführen (Empfehlung vor manuellen Tests)
|
||||
|
||||
```bash
|
||||
cd c:\Dev\cursor\mindnet_obsidian
|
||||
npm run build
|
||||
npx vitest run src/tests/mapping/sectionParser.test.ts src/tests/analysis/templateMatching.effectiveType.test.ts src/tests/analysis/templateMatching.test.ts src/tests/analysis/chainInspector.test.ts src/tests/workbench/todoGenerator.test.ts --reporter=verbose
|
||||
```
|
||||
|
||||
Erwartung: Alle genannten Test-Suites bestehen.
|
||||
|
||||
---
|
||||
|
||||
## 3. Manuelle Tests
|
||||
|
||||
### 3.1 Section-Parser: `[!section]` und Block-ID
|
||||
|
||||
**Ziel:** Prüfen, dass `> [!section] type` und `^block-id` in Überschriften vom Parser erkannt werden (Grundlage für effective_type; direkte Anzeige im UI nur indirekt über Chain Inspector/Workbench).
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. **Neue Testnote anlegen** (z. B. `Test Section Type.md`):
|
||||
|
||||
```markdown
|
||||
---
|
||||
type: concept
|
||||
---
|
||||
|
||||
## Kontext
|
||||
|
||||
> [!section] experience
|
||||
|
||||
Inhalt dieser Section. Der Section-Type ist "experience".
|
||||
|
||||
## Reflexion ^ref
|
||||
|
||||
> [!section] insight
|
||||
|
||||
Inhalt. Block-ID dieser Section ist "ref".
|
||||
```
|
||||
|
||||
2. **Speichern** und Note schließen/neu öffnen (optional, um Caching auszuschließen).
|
||||
|
||||
3. **Verifizierung:**
|
||||
- Chain Inspector/Workbench nutzen diese Section-Types (siehe 3.3 und 3.4).
|
||||
- Optional: In der **Developer Console** (Strg+Shift+I / Cmd+Option+I) nach Fehlern beim Parsing suchen; es sollten keine Fehler durch ungültige Callouts auftreten.
|
||||
|
||||
4. **Randfälle prüfen (optional):**
|
||||
- **Block-ID mit Bindestrichen/Unterstrichen:** z. B. `## Titel ^my-block_01` → sollte fehlerfrei bleiben.
|
||||
- **Zwei `[!section]` in einer Section:** Der **letzte** gesetzte Typ gilt („last wins“).
|
||||
|
||||
---
|
||||
|
||||
### 3.2 Section-Type überschreibt Note-Type (effective_type)
|
||||
|
||||
**Ziel:** Sicherstellen, dass für eine Section mit `[!section] experience` der Typ **experience** für Chain-Matching verwendet wird, auch wenn das Frontmatter `type: concept` hat.
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. **Note anlegen** `EffectiveType Test.md`:
|
||||
|
||||
```markdown
|
||||
---
|
||||
type: concept
|
||||
---
|
||||
|
||||
## Erlebnis
|
||||
|
||||
> [!section] experience
|
||||
|
||||
Dieser Abschnitt soll für Trigger-Slots als "experience" zählen.
|
||||
|
||||
> [!edge] wirkt_auf
|
||||
> [[Eine andere Note#Abschnitt]]
|
||||
```
|
||||
|
||||
2. **Zielnote** (z. B. `Eine andere Note.md`) mit Section „Abschnitt“ und ggf. weiterem Inhalt/Edges anlegen, sodass eine Kette entstehen kann.
|
||||
|
||||
3. **Cursor** in die Section **„Erlebnis“** von `EffectiveType Test.md` setzen.
|
||||
|
||||
4. **Command ausführen:** **Mindnet: Inspect Chains (Current Section)** (Strg+P / Cmd+P → „Inspect Chains“ eingeben).
|
||||
|
||||
5. **Developer Console öffnen** (Strg+Shift+I / Cmd+Option+I) und den **Chain Inspector Report** ansehen.
|
||||
|
||||
6. **Erwartung:**
|
||||
- In `templateMatches` erscheint für die aktuelle Section (z. B. als „trigger“) der Typ **experience** (nicht „concept“) in den Slot-Zuordnungen (`noteType`/effective_type).
|
||||
- Wenn kein Template-Match gefunden wird (z. B. fehlende Kette), reicht die Prüfung: Beim nächsten Test mit vollständiger Kette (3.3) muss der Trigger-Slot mit „experience“ gefüllt sein.
|
||||
|
||||
---
|
||||
|
||||
### 3.3 Chain Inspector: Inspect Chains (Current Section)
|
||||
|
||||
**Ziel:** Vollständigen Ablauf von „Inspect Chains“ prüfen und Template-Matches inkl. effective_type prüfen.
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. **Test-Vault mit kausaler Kette vorbereiten:**
|
||||
- **Note A** (z. B. Trigger): eine Section mit `> [!section] experience` (oder Frontmatter `type: experience`) und Edge zu Note B.
|
||||
- **Note B** (Transformation): Section mit `type: insight` bzw. `[!section] insight`, Edge zu Note C.
|
||||
- **Note C** (Outcome): Section mit `type: decision` bzw. `[!section] decision`.
|
||||
|
||||
2. **Note A** im Editor öffnen, Cursor in die Section mit den ausgehenden Edges setzen.
|
||||
|
||||
3. **Command:** **Mindnet: Inspect Chains (Current Section)** ausführen.
|
||||
|
||||
4. **In der Developer Console prüfen:**
|
||||
- Ob ein **Report** mit `templateMatches` erscheint.
|
||||
- Ob ein Template (z. B. `trigger_transformation_outcome`) gematcht wird.
|
||||
- Ob in `slotAssignments` die Slots (z. B. trigger, transformation, outcome) mit den erwarteten Dateien/Sections und **Typen** (experience, insight, decision) gefüllt sind.
|
||||
- Ob **Findings** (z. B. `missing_slot_*`, `weak_chain_roles`) plausibel sind.
|
||||
|
||||
5. **Erwartung:**
|
||||
- Keine Fehlermeldung; Report enthält `context`, `neighbors`, `templateMatches`, ggf. `findings`.
|
||||
- Wenn Section-Type gesetzt ist, erscheint dieser Typ in der Slot-Zuordnung (nicht nur der Note-Type).
|
||||
|
||||
---
|
||||
|
||||
### 3.4 Chain Workbench: Chain Workbench (Current Section)
|
||||
|
||||
**Ziel:** Chain Workbench öffnen und Anzeige von Matches/TODOs prüfen.
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. **Gleiche Test-Situation** wie in 3.3 (Note A mit Section geöffnet, Cursor in der Section).
|
||||
|
||||
2. **Command:** **Mindnet: Chain Workbench (Current Section)** ausführen.
|
||||
|
||||
3. **Modal prüfen:**
|
||||
- **Template Matches** werden angezeigt (z. B. „trigger_transformation_outcome“).
|
||||
- **Status** der Matches (complete / near_complete / partial / weak) ist lesbar.
|
||||
- **TODOs** (z. B. missing_slot, missing_link) erscheinen, falls die Kette unvollständig ist.
|
||||
- Kein Absturz, keine leere Anzeige ohne Hinweis.
|
||||
|
||||
4. **Erwartung:**
|
||||
- Workbench öffnet sich; Matches und TODOs sind konsistent mit dem Chain Inspector Report.
|
||||
|
||||
---
|
||||
|
||||
### 3.5 Fehlende Dictionary-Dateien (Notice)
|
||||
|
||||
**Ziel:** Prüfen, dass bei fehlenden Chain-Dictionaries ein **Notice** erscheint und der Command abbricht.
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. In den **Plugin-Einstellungen** einen **ungültigen Pfad** für **Chain Roles** oder **Chain Templates** eintragen (z. B. `Dictionary/chain_roles_nicht_vorhanden.yaml`).
|
||||
|
||||
2. Eine Markdown-Note öffnen und **Mindnet: Inspect Chains (Current Section)** ausführen.
|
||||
|
||||
3. **Erwartung:**
|
||||
- Ein **Notice** erscheint (z. B. „Chain Roles nicht geladen“ oder „Chain Templates nicht geladen“).
|
||||
- Kein stilles Weiterlaufen mit leerem oder irreführendem Report.
|
||||
|
||||
4. **Pfad wieder auf eine gültige Datei setzen** und erneut testen; Report soll wieder normal erscheinen.
|
||||
|
||||
---
|
||||
|
||||
### 3.6 Sichtbarkeit der Commands (editorCallback)
|
||||
|
||||
**Ziel:** Bestätigen, dass Inspect Chains und Chain Workbench nur bei geöffneter MD-Datei verfügbar sind.
|
||||
|
||||
**Schritte:**
|
||||
|
||||
1. **Alle Markdown-Editor-Tabs schließen** (oder in einen nicht-Markdown-Tab wechseln, z. B. Einstellungen).
|
||||
|
||||
2. **Befehlspalette** öffnen (Strg+P / Cmd+P) und nach „Inspect“ oder „Chain“ suchen.
|
||||
|
||||
3. **Erwartung:**
|
||||
- „Mindnet: Inspect Chains (Current Section)“ und „Mindnet: Chain Workbench (Current Section)“ sind **ausgegraut** oder nicht auswählbar.
|
||||
|
||||
4. **Eine Markdown-Note öffnen.**
|
||||
|
||||
5. **Befehlspalette** erneut öffnen und dieselben Befehle suchen.
|
||||
|
||||
6. **Erwartung:**
|
||||
- Die Befehle sind **aktiv** und auswählbar.
|
||||
|
||||
---
|
||||
|
||||
## 4. Kurz-Checkliste (Manuell)
|
||||
|
||||
| Nr | Test | Erwartung |
|
||||
|----|------|-----------|
|
||||
| 1 | Section-Parser: Note mit `[!section]` und `^block-id` | Keine Fehler; Chain-Features nutzen effective_type. |
|
||||
| 2 | effective_type: Section-Type überschreibt Note-Type | Im Report erscheint Section-Type (z. B. experience) in Slot-Zuordnung. |
|
||||
| 3 | Inspect Chains ausführen | Report in Console mit templateMatches und ggf. findings. |
|
||||
| 4 | Chain Workbench öffnen | Modal mit Matches und TODOs. |
|
||||
| 5 | Ungültiger Dictionary-Pfad | Notice, kein stiller Abbruch. |
|
||||
| 6 | Commands ohne geöffnete MD-Datei | Befehle ausgegraut. |
|
||||
|
||||
---
|
||||
|
||||
## 5. Referenzen
|
||||
|
||||
- **Automatische Tests:** `src/tests/mapping/sectionParser.test.ts`, `src/tests/analysis/templateMatching.effectiveType.test.ts`
|
||||
- **Chain Workbench Testing:** `docs/08_Testing_Chain_Workbench.md`
|
||||
- **Lastenheft Chain Inspector & Workbench:** `docs/09_Chain_Inspector_Workbench_Lastenheft.md`
|
||||
@@ -0,0 +1,113 @@
|
||||
# Bewertung & Empfehlung: Überschrift vs. Block-Link (Heading-Match)
|
||||
|
||||
**Datum:** Januar 2026
|
||||
**Kontext:** Exaktes Heading-Matching in Inspect Chains / Chain Workbench vs. Obsidian-Standard und Interview-Assistent.
|
||||
|
||||
---
|
||||
|
||||
## 1. Obsidian-Standard (Dokumentation & beobachtetes Verhalten)
|
||||
|
||||
### 1.1 Drei relevante Link-Formen (bei Überschrift mit Block-ID)
|
||||
|
||||
Bei einer Zeile `## Überschrift ^Block` in der Zieldatei:
|
||||
|
||||
| Link | Verhalten beim Klick |
|
||||
|------|----------------------|
|
||||
| **`[[Titel#Überschrift Block]]`** (ohne `^`) | Obsidian **erzeugt diese Form**, wenn man manuell per UI auf die Überschrift verlinkt – das Zeichen `^` wird **immer entfernt**. Springt auf die Überschrift, **highlighted den kompletten Text unter der Überschrift**. |
|
||||
| **`[[Titel#Überschrift]]`** (nur Text, ohne „ Block“) | Springt **in die Note, aber nicht auf die Überschrift**. Entspricht dem aktuellen Interview-Assistenten. |
|
||||
| **`[[Titel#^Block]]`** (Block-Link) | Springt auf die Überschrift, **highlighted nur die Überschrift selbst** (nicht den Abschnitt darunter). Funktioniert auch, wenn man `^` manuell einträgt (Obsidian entfernt `^` nur bei UI-erzeugten Links). |
|
||||
|
||||
### 1.2 Beobachtetes Verhalten
|
||||
|
||||
- **Obsidian entfernt bei UI-Links das `^`:** Ein manuell gesetzter Wikilink auf eine Überschrift mit Block-ID wird zu `[[Titel#Überschrift Block]]` (mit Leerzeichen, ohne Caret).
|
||||
- **Drei Schreibweisen bezeichnen dieselbe Sektion:** `Überschrift`, `Überschrift ^Block` (im Quelldokument), `Überschrift Block` (in Obsidian-Links). Für Matching müssen alle drei als dieselbe Sektion gelten.
|
||||
|
||||
---
|
||||
|
||||
## 2. Aktuelles Verhalten im Plugin
|
||||
|
||||
### 2.1 Section-Parser & Graph-Index
|
||||
|
||||
- **sectionParser:** Speichert `heading` als **vollständige Zeile** nach den `#`, also z. B. `"Überschrift ^block"` (inkl. Block-ID).
|
||||
- **graphIndex `parseTarget`:**
|
||||
- Bei `[[Datei#X]]`: `target.heading = X` (exakt der Teil nach `#`).
|
||||
- Bei `[[#^block-id]]`: Auflösung über Sektionen → `heading = section.heading` (ebenfalls voller Text, inkl. ` ^block`).
|
||||
- **Section-Nodes:** Werden aus `section.heading` gebaut → ebenfalls voller Text (z. B. `"Überschrift ^block"`).
|
||||
|
||||
### 2.2 Interview-Assistent (LinkTargetPicker + renderNoteEdges)
|
||||
|
||||
- **getHeadingsWithSectionTypes** (targetTypeResolver): Liest Überschriften per **eigenem Regex** und **entfernt** den Block-Teil: `(.+?)(?:\s+\^[\w-]+)?\s*$` → `match[2]` ist nur der Text (z. B. `"Überschrift"`).
|
||||
- **LinkTargetPicker:** Setzt `linkTarget = basename + "#" + h.heading` → es wird **nur** `[[Note#Überschrift]]` erzeugt (ohne „ Block“ / ` ^block`).
|
||||
- **renderNoteEdges:** Schreibt `[[${toNote}]]`; `toNote` ist bereits `"Note"` oder `"Note#Überschrift"`.
|
||||
|
||||
**Fazit:** Der Interview-Assistent erzeugt `[[Note#Überschrift]]`. In Obsidian springt dieser Link **in die Note, aber nicht auf die Überschrift** (siehe Abschnitt 1). Obsidian-typisches Springen auf die Überschrift (inkl. Highlight des Abschnitts) liefert nur `[[Titel#Überschrift Block]]` (UI-erzeugt, ohne `^`).
|
||||
|
||||
### 2.3 Inspect Chains & Chain Workbench
|
||||
|
||||
- **chainInspector** vergleicht überall **strikt:**
|
||||
`edge.target.heading === context.heading` und
|
||||
`edge.source.sectionHeading === context.heading`.
|
||||
- **dangling_target_heading:** Prüfung gegen `metadataCache.getFileCache(...).headings` mit
|
||||
`h.heading === targetHeading` (ebenfalls exakt).
|
||||
- **Chain Workbench** nutzt dieselben Konzepte (context/assignment mit `heading`); keine Normalisierung.
|
||||
|
||||
**Folge:** Sobald eine Seite `"Überschrift ^block"` und ein Link `[[Titel#Überschrift]]` vorkommt (oder umgekehrt), stimmen die Strings nicht überein → kein Match, ggf. falscher `dangling_target_heading`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Bewertung
|
||||
|
||||
| Aspekt | Bewertung |
|
||||
|--------|-----------|
|
||||
| **Obsidian (UI)** | Beim manuellen Verlinken auf eine Überschrift mit Block-ID: Link wird zu `[[Titel#Überschrift Block]]` (ohne `^`). Klick springt auf Überschrift und highlighted den Abschnitt. |
|
||||
| **Interview-Assistent** | Erzeugt `[[Note#Überschrift]]`. In Obsidian springt der Link **nicht** auf die Überschrift (nur in die Note). Besseres Spring-Verhalten hätte `[[Note#Überschrift Block]]` (Obsidian-Stil) oder `[[Note#^Block]]`. |
|
||||
| **Inspect Chains / Workbench** | Exaktes Match ist zu streng: „Überschrift“, „Überschrift ^Block“, „Überschrift Block“ bezeichnen dieselbe Sektion. |
|
||||
| **Risiko** | Ohne Normalisierung matchen diese drei Schreibweisen nicht; falsche Findings / fehlende Zuordnung. |
|
||||
|
||||
---
|
||||
|
||||
## 4. Empfehlung
|
||||
|
||||
### 4.1 Eine Baustelle zuerst (keine Überladung)
|
||||
|
||||
Um nicht zu viele Änderungen gleichzeitig zu öffnen:
|
||||
|
||||
- **Nur eine Baustelle:** **Normalisierung in Inspect Chains & Chain Workbench** (zentrale Normalisierungsfunktion + alle Heading-Vergleiche und `dangling_target_heading` auf normalisierte Form umstellen).
|
||||
- **Interview-Assistent vorerst unverändert:** Weiter `[[Note#Überschrift]]` ausgeben. Eine spätere, **optionale** Anpassung (z. B. Ausgabe `[[Note#Überschrift Block]]` im Obsidian-Stil, damit der Klick auf die Überschrift springt) kann separat erfolgen.
|
||||
|
||||
### 4.2 Normalisierungsregel (für Vergleiche)
|
||||
|
||||
Drei Schreibweisen sollen als **dieselbe Sektion** gelten:
|
||||
|
||||
- `Überschrift` (Interview, reiner Text)
|
||||
- `Überschrift ^Block` (Quelldokument / sectionParser)
|
||||
- `Überschrift Block` (Obsidian-UI-Link, ohne `^`)
|
||||
|
||||
**Kanonische Form für Vergleiche:**
|
||||
|
||||
1. Am Ende **Block-Suffix mit Caret** entfernen: `\s+\^[a-zA-Z0-9_-]+$` → z. B. `"Überschrift ^Block"` → `"Überschrift"`.
|
||||
2. Danach **ein einzelnes Wort am Ende** (nur Buchstaben, Zahlen, Bindestrich, Unterstrich) optional entfernen: `\s+[a-zA-Z0-9_-]+$` → z. B. `"Überschrift Block"` → `"Überschrift"`.
|
||||
|
||||
So werden alle drei Varianten auf `"Überschrift"` abgebildet. **Randfall:** Eine Überschrift, die wirklich „X Y“ heißt (ohne Block-ID), würde ebenfalls zu „X“ normalisiert und könnte mit „X“ matchen; in der Praxis selten. Die Funktion **nur** für Vergleiche/Prüfungen nutzen, nicht für Anzeige oder gespeicherte Links.
|
||||
|
||||
### 4.3 Konkrete Maßnahmen (nur diese eine Baustelle)
|
||||
|
||||
1. **Eine zentrale Normalisierungsfunktion** (z. B. in `linkHelpers` oder eigenem Modul): Eingabe = Überschrift-String, Ausgabe = kanonische Form wie oben.
|
||||
|
||||
2. **Inspect Chains (chainInspector):** Alle Vergleiche mit `heading` / `sectionHeading` auf die **normalisierte** Form umstellen; bei **dangling_target_heading** `targetHeading` und Cache-Headings vor dem Vergleich normalisieren.
|
||||
|
||||
3. **Chain Workbench:** Dieselbe Normalisierung überall, wo Headings verglichen werden.
|
||||
|
||||
4. **graphIndex / Interview:** Keine Änderung in dieser Baustelle.
|
||||
|
||||
### 4.4 Optional später (separate Baustelle)
|
||||
|
||||
- **Interview-Assistent:** Wenn gewünscht, Links so erzeugen, dass Obsidian auf die Überschrift springt: z. B. `[[Note#Überschrift Block]]` (Block-Teil ohne `^`, wie Obsidian-UI) statt `[[Note#Überschrift]]`. Dann würde der Klick auf den vom Assistenten gesetzten Link dasselbe tun wie bei manuell gesetzten Links.
|
||||
|
||||
---
|
||||
|
||||
## 5. Kurzfassung
|
||||
|
||||
- **Obsidian (beobachtet):** Manueller Link auf Überschrift mit Block-ID → `[[Titel#Überschrift Block]]` (ohne `^`). Klick springt auf Überschrift und highlighted den Abschnitt. `[[Titel#Überschrift]]` springt nur in die Note, nicht auf die Überschrift. `[[Titel#^Block]]` highlighted nur die Überschrift.
|
||||
- **Eine Baustelle:** Nur **Normalisierung in Inspect Chains & Chain Workbench** umsetzen (zentrale Funktion: Block-Suffix mit `^` und ggf. ein trailinges Wort entfernen; alle Heading-Vergleiche und `dangling_target_heading` auf diese Form umstellen). Interview-Assistent und graphIndex in dieser Runde **nicht** anfassen.
|
||||
- **Optional später:** Interview-Assistent so anpassen, dass er z. B. `[[Note#Überschrift Block]]` erzeugt (Obsidian-Stil), damit der Klick auf den Link auf die Überschrift springt.
|
||||
@@ -1,8 +1,8 @@
|
||||
# WP-26 Plugin-Schnittstellenspezifikation
|
||||
|
||||
**Version:** 1.0
|
||||
**Datum:** 25. Januar 2026
|
||||
**Status:** Implementierungsleitfaden für mindnet_obsidian Plugin
|
||||
**Version:** 1.1
|
||||
**Datum:** 28. Januar 2026
|
||||
**Status:** Implementierungsleitfaden für mindnet_obsidian Plugin (aktualisiert: Interview Edge-per-Section, Note#Abschnitt, Commands)
|
||||
**Basis:** Lastenheft WP-26 v1.3 (Section Types & Intra-Note-Edges)
|
||||
|
||||
---
|
||||
@@ -239,10 +239,34 @@ Text der Reflexion...
|
||||
}
|
||||
```
|
||||
|
||||
**Implementierung:**
|
||||
- Erweitere Interview-Steps um Section-Type-Optionen
|
||||
- Generiere automatisch Block-IDs basierend auf Step-Keys
|
||||
- Füge `[!section]` Callouts automatisch ein, wenn `sectionType` definiert ist
|
||||
**Implementierung:** (umgesetzt)
|
||||
- Interview-Steps um Section-Type-Optionen erweitert
|
||||
- Block-IDs automatisch aus Step-Keys generiert
|
||||
- `[!section]` Callouts werden eingefügt, wenn `sectionType` definiert ist
|
||||
|
||||
#### 3.3.2 Edge-Typen pro Sektion und Note-Edges (implementiert, Jan 2026)
|
||||
|
||||
**Betroffene Dateien:**
|
||||
- `src/ui/SectionEdgesOverviewModal.ts`
|
||||
- `src/ui/LinkTargetPickerModal.ts`
|
||||
- `src/ui/InterviewWizardModal.ts`
|
||||
- `src/interview/renderer.ts`
|
||||
- `src/parser/parseRelLinks.ts`
|
||||
- `src/mapping/sectionParser.ts`
|
||||
- `src/mapping/semanticMappingBuilder.ts`
|
||||
- `src/mapping/updateMappingBlocks.ts`
|
||||
|
||||
**Umsetzung:**
|
||||
|
||||
1. **SectionEdgesOverviewModal:** Am Ende des Interviews werden alle Section-Edges und Note-Edges angezeigt; Edge-Typen können angepasst werden. Note-Ziele werden als vollständiger Link (z. B. `Note#Abschnitt`) gespeichert.
|
||||
|
||||
2. **LinkTargetPickerModal:** Nach Auswahl einer Note im Entity Picker kann gewählt werden: ganze Note oder konkreter Abschnitt (`Note#Abschnitt`). Der gewählte Link wird in Inline-Micro-Edging und in den Übersichts-Dialog übernommen.
|
||||
|
||||
3. **Renderer:** `RenderOptions.noteEdges` (Map von Block-ID → toNote/`Note#Abschnitt` → edgeType). Note-Edges werden pro Sektion als `>> [!edge] type` und `>> [[Note#Abschnitt]]` im Semantic-Mapping-Block ausgegeben.
|
||||
|
||||
4. **Links mit Abschnitt:** `parseRelLinks` und `sectionParser.extractWikilinks` behalten `#Abschnitt`; Mapping-Blöcke und Text-Links schreiben `[[Note#Abschnitt]]` bzw. `[[rel:type|Note#Abschnitt]]`.
|
||||
|
||||
**Backend-Konformität:** Edge-Callouts unterstützen `[[Target#Section]]` (vgl. Abschnitt 2.2). Das Plugin erzeugt und erhält diese Form konsistent.
|
||||
|
||||
---
|
||||
|
||||
@@ -499,11 +523,23 @@ interface SectionTypeModalProps {
|
||||
|
||||
## 6. Commands
|
||||
|
||||
### 6.1 Neue Commands
|
||||
### 6.1 Bereits implementierte Commands (Stand: Jan 2026)
|
||||
|
||||
#### 6.1.1 "Add Section Type"
|
||||
| Command-ID | Name | Kontext | Beschreibung |
|
||||
|------------|------|---------|--------------|
|
||||
| `mindnet-change-edge-type` | Mindnet: Edge-Type ändern | **editorCallback** (nur bei geöffneter MD-Datei) | Kantentyp für Einzellink, Auswahl oder ganze Note setzen; neuer Link mit Kantentyp. Modul: `edgeTypeSelector.ts`. |
|
||||
| `mindnet-build-semantic-mappings` | Mindnet: Build semantic mapping blocks (by section) | **editorCallback** | Pro Sektion Semantic-Mapping-Blöcke bauen/überarbeiten. Modul: `semanticMappingBuilder.ts`. Bei Cursor in Link / Auswahl wird stattdessen Edge-Type-Selector genutzt. |
|
||||
| `mindnet-fix-findings` | Mindnet: Fix Findings (Current Section) | **editorCallback** | Fehlende Links einfügen, Kandidaten-Edges bestätigen. Modul: `fixFindingsCommand.ts`. |
|
||||
|
||||
**Command-ID:** `mindnet:add-section-type`
|
||||
**Hinweis:** `editorCallback`-Commands erscheinen in der Befehlspalette nur, wenn eine Markdown-Datei im Editor aktiv ist. Ohne geöffnete Note sind sie ausgegraut. Siehe Lastenheft FA-PL-12a (Sichtbarkeit).
|
||||
|
||||
---
|
||||
|
||||
### 6.2 Geplante / noch nicht umgesetzte Commands
|
||||
|
||||
#### 6.2.1 "Add Section Type"
|
||||
|
||||
**Command-ID (geplant):** `mindnet:add-section-type`
|
||||
|
||||
**Funktionalität:**
|
||||
- Fügt `[!section]` Callout zur aktuellen Section hinzu
|
||||
@@ -512,9 +548,9 @@ interface SectionTypeModalProps {
|
||||
|
||||
---
|
||||
|
||||
#### 6.1.2 "Add Block ID to Heading"
|
||||
#### 6.2.2 "Add Block ID to Heading"
|
||||
|
||||
**Command-ID:** `mindnet:add-block-id`
|
||||
**Command-ID (geplant):** `mindnet:add-block-id`
|
||||
|
||||
**Funktionalität:**
|
||||
- Fügt Block-ID zur aktuellen Überschrift hinzu
|
||||
@@ -523,9 +559,9 @@ interface SectionTypeModalProps {
|
||||
|
||||
---
|
||||
|
||||
#### 6.1.3 "Insert Intra-Note Edge"
|
||||
#### 6.2.3 "Insert Intra-Note Edge"
|
||||
|
||||
**Command-ID:** `mindnet:insert-intra-note-edge`
|
||||
**Command-ID (geplant):** `mindnet:insert-intra-note-edge`
|
||||
|
||||
**Funktionalität:**
|
||||
- Fügt `[!edge]` Callout mit Block-Reference hinzu
|
||||
@@ -534,9 +570,9 @@ interface SectionTypeModalProps {
|
||||
|
||||
---
|
||||
|
||||
### 6.2 Erweiterte Commands
|
||||
### 6.3 Erweiterte Commands (Interview, Workbench)
|
||||
|
||||
#### 6.2.1 Chain Workbench
|
||||
#### 6.3.1 Chain Workbench
|
||||
|
||||
**Betroffene Dateien:**
|
||||
- `src/commands/chainWorkbenchCommand.ts`
|
||||
@@ -548,7 +584,7 @@ interface SectionTypeModalProps {
|
||||
|
||||
---
|
||||
|
||||
#### 6.2.2 Interview Wizard
|
||||
#### 6.3.2 Interview Wizard
|
||||
|
||||
**Betroffene Dateien:**
|
||||
- `src/interview/renderer.ts`
|
||||
@@ -791,7 +827,12 @@ export interface GraphSchema {
|
||||
|
||||
**Ende der Spezifikation**
|
||||
|
||||
**Implementierungsstand (Kurz, Jan 2026):**
|
||||
- Phase 1–3: Kern-Parsing, UI, Interview (inkl. Edge-per-Section, Note#Abschnitt) weitgehend umgesetzt.
|
||||
- Commands: „Edge-Type ändern“, „Build semantic mapping blocks“, „Fix Findings“ implementiert (editorCallback); „Add Section Type“, „Add Block ID“, „Insert Intra-Note Edge“ noch offen.
|
||||
- Details: Lastenheft `06_LH_WP26_Plugin_Integration.md` (FA-PL-12, FA-PL-14, Abschnitt 8 Nächste Schritte).
|
||||
|
||||
**Nächste Schritte:**
|
||||
1. Review der Spezifikation
|
||||
2. Priorisierung der Implementierungsphasen
|
||||
3. Start mit Phase 1 (Grundlagen)
|
||||
1. FA-PL-12a: Sichtbarkeit der Edge-Commands (Dokumentation und/oder Command ohne editorCallback).
|
||||
2. Geplante Commands (Add Section Type, Add Block ID, Insert Intra-Note Edge) priorisieren.
|
||||
3. Abnahme Note#Abschnitt mit Backend; ggf. Lint für konsistente Abschnitts-Links.
|
||||
@@ -0,0 +1,36 @@
|
||||
/*
|
||||
* Unauffällige Formatierung für > [!section] type (Mindnet)
|
||||
* Inhalt in .obsidian/snippets/mindnet.css einfügen und Snippet aktivieren.
|
||||
*/
|
||||
|
||||
/* [!section] – möglichst unauffällig: kein Kasten, kein Stift, wie ein kleines Label */
|
||||
.callout[data-callout="section"] {
|
||||
--callout-color: 128, 128, 128;
|
||||
--callout-icon: none;
|
||||
border: none;
|
||||
border-left: 1px solid rgba(var(--callout-color), 0.25);
|
||||
background-color: transparent;
|
||||
padding: 0.1em 0 0.1em 0.5em;
|
||||
margin: 0.25em 0;
|
||||
box-shadow: none;
|
||||
}
|
||||
|
||||
.callout[data-callout="section"] .callout-title {
|
||||
background-color: transparent;
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
.callout[data-callout="section"] .callout-icon {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.callout[data-callout="section"] .callout-title-inner {
|
||||
font-size: 0.85em;
|
||||
font-weight: 500;
|
||||
color: var(--text-muted);
|
||||
opacity: 0.9;
|
||||
}
|
||||
|
||||
.callout[data-callout="section"] .callout-content {
|
||||
display: none;
|
||||
}
|
||||
Reference in new issue
Block a user