Implementation Plan: Pascal/Delphi in CodeGraph

0) Prämissen

CodeGraph extrahiert Nodes und Edges über tree-sitter und language-spezifische Queries (.scm).
Danach folgt Reference Resolution (Calls → Definitionen, imports → Dateien, inheritance, framework patterns).

1) Parser / Grammar

Empfohlen: tree-sitter-pascal (unterstützt Delphi + FreePascal).

Tasks:

Dependency hinzufügen (wie bei bestehenden Sprachen).
Language-Loader/Registry erweitern: languageId = "pascal" (oder "delphi", aber konsistent).

2) File-Erkennung

Extensions (MVP):

.pas (Units)
.dpr (Program)
.dpk (Package)
.lpr (Lazarus Program)

Optional:

.inc (Include-Fragmente) – erst später oder nur, wenn Parser tolerant genug ist.

3) Queries (MVP)

3.1 Nodes

Extrahiere mindestens:

Unit/Program/Package Name
Klassen / Interfaces / Records
Procedures/Functions
Methoden (class/instance)

3.2 Edges

Extrahiere mindestens:

uses (import/dependency)
extends (Basisklasse)
implements (Interface-Implementierungen)
calls (Identifier + optional Qualifier)

4) Reference Resolution (MVP)

4.1 Unit-Auflösung (`uses`)

Index-Phase: Map UnitName -> fileId (aus Units/Programs/Packages)
Resolution: Bei uses Foo, Bar; Edges auf Ziel-Units setzen.
Spezialfälle (später): Foo in 'path\Foo.pas' (DPR/DPK), Namespaces (System.SysUtils).

4.2 Call-Auflösung (best effort)

Extraktion: callName, optional qualifier (Obj.DoIt, TMyClass.DoIt)
Heuristik-Reihenfolge:
1. lokale Procs/Funcs in der gleichen Unit
2. Methoden in der gleichen Klasse
3. Units aus uses
4. globaler Fallback nach Name

5) Tests

Fixtures aus fixtures/ in die Test-Suite aufnehmen
Assertions:
- Node-Anzahl + zentrale Namen
- uses-Edges
- extends/implements-Edges
- einfache Call-Edges

6) Definition of Done

codegraph index indexiert Delphi/ Pascal-Dateien ohne Crash
codegraph_search findet Klassen/Methoden
codegraph_callers/callees liefert sinnvolle Ergebnisse für einfache Fälle
uses-Graph stimmt (Unit-Abhängigkeiten)