# Modul: Analysis

> **Pfad:** `src/analysis/`  
> **Zielgruppe:** Entwickler, Architekten

---

## Übersicht

Das Analysis-Modul enthält die Chain Inspector-Logik, Template Matching, Scoring und Findings-Erzeugung.

---

## Komponenten

| Datei | Beschreibung |
|-------|--------------|
| `chainInspector.ts` | Haupt-Analyse-Engine |
| `templateMatching.ts` | Template Matching, Scoring, Backtracking |
| `graphIndex.ts` | Graph-Indexierung, Edge-Erfassung |
| `sectionContext.ts` | Section-Context-Handling |
| `severityPolicy.ts` | Severity-Policy für Findings |

---

## Scoring-Logik (Template Matching)

### scoreAssignment

Die Funktion `scoreAssignment` bewertet jede Slot-Zuordnung:

| Komponente | Punkte |
|------------|--------|
| Jeder zugewiesene Slot | +2 |
| Intra-Note-Bonus (alle Slots in derselben Note) | +5 |
| Erfüllter Link (mit erlaubter Edge-Role) | +10 |
| Fehlender Link (wenn `required_links: true`) | -5 |
| Falsche Role (wenn `required_links: true`) | -5 |

### Link-Validierung

- **findEdgeBetween:** Sucht Edge zwischen zwei Nodes (file:heading)
- **headingsMatch:** Vergleicht Überschriften (normalisiert über `normalizeHeadingForMatch`)
- **Role-Mapping:** Edge-Typ → Role via `chain_roles.yaml`

### Profile-Auflösung

1. **Settings:** `templateMatchingProfile` (`discovery` | `decisioning`)
2. **Template:** `template.matching.required_links`
3. **Defaults:** `defaults.matching.required_links`

---

## Template-Matching-Profile

| Profil | required_links | min_slots_filled_for_gap_findings | min_score_for_gap_findings |
|--------|----------------|-----------------------------------|----------------------------|
| `discovery` | false | 2 | 8 |
| `decisioning` | true | 3 | 18 |

Profile werden in `chain_templates.yaml` unter `defaults.profiles` definiert.

---

## Confidence-Berechnung

| Confidence | Bedingung |
|------------|-----------|
| `confirmed` | slotsComplete AND linksComplete AND mind. eine causal-ish Role |
| `plausible` | slotsComplete, aber (nicht linksComplete ODER keine causal-ish Role) |
| `weak` | nicht slotsComplete |

**causal-ish Roles:** `["causal", "influences", "enables_constraints"]` (konfigurierbar in `chain_templates.yaml`)

---

## Analysis Policies

Datei: `analysis_policies.yaml` (Pfad via Settings `analysisPoliciesPath`)

```yaml
version: 1
profiles:
  discovery:
    severities:
      missing_link_constraints: info
      weak_chain_roles: info
      unmapped_edge_types: info
      missing_slot_*: info
  decisioning:
    severities:
      missing_link_constraints: warn
      weak_chain_roles: info
      unmapped_edge_types: warn
      missing_slot_*: warn
```

---

## Abhängigkeiten

- **Dictionary:** Chain Roles, Chain Templates
- **Graph:** Graph Index, Traversal
- **Parser:** Edge-Extraktion
- **Unresolved Link:** `headingsMatch`, `normalizeHeadingForMatch`

---

## Siehe auch

- [02_concepts/03_chain_identification_and_matching](../02_concepts/03_chain_identification_and_matching.md)
- [06_Konfigurationsdateien_Referenz](../06_Konfigurationsdateien_Referenz.md) – chain_templates, chain_roles, analysis_policies