Ablaufpläne (PAP)

findsl papgen erzeugt Programmablaufpläne (DIN-66001-nah) aus den Funktionen eines Moduls — eine Funktion, ein Diagramm. Das ist genau das Artefakt, das die Finanzverwaltung für die PAPs des BMF heute von Hand pflegt.

Der Befehl

findsl papgen <pfade...> -f <format> -o <ziel>

Option	Bedeutung
`<pfade...>`	Dateien, Verzeichnisse oder Glob-Muster (z. B. `"examples/*/.findsl"`)
`-f, --format`	`mermaid` (Markdown) oder `html` (self-contained, klickbare Links). Default: `mermaid`
`--detail`	`struktur` (Default) oder `voll`
`--params`	`symbole` (Parameter als Eingabe-Symbole, Default) oder `inline`
`--theme`	`default` / `neutral` / `dark` / `forest` (nur Mermaid; HTML folgt dem OS-Theme)
`--no-farben`	semantische Knoten-Färbung abschalten
`--ohne-intern`	interne (`_`-)Funktionen weglassen — nur die öffentliche API
`-o, --out`	Ausgabe-Basisname (ohne Endung; Default: `papgen`)

# Mermaid-Diagramme für alle EStG-Module
findsl papgen examples/est -o out/est-pap

# Self-contained HTML, nur öffentliche Funktionen
findsl papgen "examples/**/*.findsl" -f html --ohne-intern -o out/pap

Formate

Mermaid — Markdown mit Mermaid-Codeblöcken; einbettbar in andere Dokumente, versionierbar als Text.
HTML — eigenständige Datei mit klickbaren Verweisen (z. B. zwischen aufgerufenen Funktionen); folgt dem Hell/Dunkel-Modus des Systems.

Detailstufen

struktur — der Kontrollfluss (Verzweigungen, Zweige, Abbrüche) als Übersicht.
voll — zusätzlich die Ausdrücke in den Knoten.