Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice
TypeScript 3d-modeling3d-printing3d-printing-toolsagentagentic-aiai-cadcadcadqueryclaude-codecodexelectronfemllmmacdmakeropencodeparametric-designpythonsteptext-to-cad
Plan: Animation, Analyse, Bilder und Videos (E58), README und CLAUDE.md nachgezogen
Kai-Jungsthoefel63e71502dcd2
diff --git a/CLAUDE.md b/CLAUDE.mdindex d6d5e83..86e6873 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -14,10 +14,10 @@ Eine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten| Pfad | Inhalt ||---|---|-| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts`, `measure.ts`, `skills.ts`, `workspace.ts`, `terminals.ts`, `files.ts`), `src/preload/`, `src/renderer/` (`main.ts` Verdrahtung, `viewer.ts`, `viewcube.ts`, `sectiontool.ts`, `explodetool.ts`, `skills.ts`, `markup.ts`, `measuretool.ts`, `parts.ts`, `code.ts`, `markdown.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `ui.ts`, `icons.ts`), `src/shared/types.ts` (IPC-Vertrag), `src/shared/editable.ts`, `resources/template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `resources/skills/` (mitgelieferte Skills), `resources/icon.*` (App-Icon, erzeugt mit `scripts/make-icon.py`), `test/` |+| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts`, `measure.ts`, `skills.ts`, `workspace.ts`, `terminals.ts`, `files.ts`, `bridge.ts` Verbindung für `soma render`, `render.ts` Render-Fenster, `animations.ts`), `src/preload/`, `src/renderer/` (`main.ts` Verdrahtung, `viewer.ts`, `viewcube.ts`, `sectiontool.ts`, `explodetool.ts`, `skills.ts`, `markup.ts`, `measuretool.ts`, `parts.ts`, `code.ts`, `markdown.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `ui.ts`, `icons.ts`, für Animation und Analyse `animtool.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `videoview.ts`, `render.ts`/`render.html` im Render-Fenster), `src/shared/types.ts` (IPC-Vertrag), `src/shared/editable.ts`, `resources/template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `resources/skills/` (mitgelieferte Skills), `resources/icon.*` (App-Icon, erzeugt mit `scripts/make-icon.py`), `test/` || `design/ui-entwurf.html` | Freigegebener Oberflächenentwurf (E38), im Browser öffnen. Maßstab für Aufbau, Farben und Texte der Oberfläche || `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |-| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`) |+| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`), `soma anim` (`anim.py`, `animrun.py`), `soma analyze` (`analysis.py`), `soma render` (`render.py`, über die App) || `prototype/phase0/` | Abgeschlossener technischer Prototyp mit `ERGEBNISSE.md`. Nur noch Referenz |Details: `app/README.md`.@@ -33,7 +33,7 @@ uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exnpm installnpm start # baut und startetnpm run typecheck-npm test # baut, dann test:unit, test:smoke, test:versions, test:editor, test:measure, test:groups, test:section, test:explode, test:skills und test:fasteners (echte App, unsichtbares Fenster)+npm test # baut, dann test:unit, test:smoke, test:versions, test:editor, test:measure, test:groups, test:section, test:explode, test:skills, test:fasteners und test:animation (echte App, unsichtbares Fenster)# soma direkt"$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/soma.exe" build --project <ordner>diff --git a/PLAN.md b/PLAN.mdindex 5604893..a55b114 100644--- a/PLAN.md+++ b/PLAN.md@@ -66,10 +66,13 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner├── output/│ └── model.step Hauptergebnis mit allen Bauteilen, benannt, farbig├── exports/ Einzelexporte (Ort noch nicht festgelegt)+├── animations/ Animationen in Python (optional, E58)+├── renders/ Bilder und Videos von soma render (nicht in Git, E58)├── .soma/│ ├── project.json ID, App-/Framework-Version, api_version, Stufen der Skills, Hauptdatei│ ├── skills/ eingeschaltete Skills (Bei Bedarf, Immer) als Markdown│ ├── feedback/ Screenshots und Skizzen (nicht in Git)+│ ├── anim/, results/ gebaute Animationen und Ergebnisse von soma analyze (nicht in Git, E58)│ ├── model.map.json und GLB-Cache (nicht in Git)└── .git/ .gitignore```@@ -80,7 +83,7 @@ Einfacher Fall: alles steht in `model.py`. Bei wachsender Komplexität lagert de- Jedes Projekt bekommt ein Git-Repo, das in der ZIP mitwandert. Das Git-Binary wird mitgeliefert (E31).- Der **Agent committet selbst** nach sinnvollen Iterationen (Anweisung in `AGENTS.md`). Beim Speichern legt die App verbliebene Änderungen als **Auto-Snapshot** an.-- **Getrackt:** Skripte, `inputs/`, `output/model.step`, `requirements.txt`, `project.json`, `skills/`. **Nicht getrackt:** GLB-Cache, Mapping, `feedback/`.+- **Getrackt:** Skripte, `inputs/`, `output/model.step`, `requirements.txt`, `project.json`, `skills/`. **Nicht getrackt:** GLB-Cache, Mapping, `feedback/`, `renders/`, `.soma/anim/`, `.soma/results/` (entstehen aus dem Code neu, wandern aber mit der ZIP).- **Umsetzung und Befund:** Die App nutzt das mitgelieferte Git (dugite, Git 2.53, rund 115 MB) und stellt es auch den Terminals vorn im PATH bereit. **STEP-Dateien sind nicht byte-stabil** (jeder Build ändert den Zeitstempel, manchmal die Reihenfolge einzelner Zeilen). Deshalb zählt `output/` nicht als ungespeicherte Änderung, wird aber mitcommittet, damit alte Stände als Vorschau anzeigbar bleiben. Der Startcommit entsteht nach einem ersten Build und enthält bereits eine STEP.- **Versions-Schieber:** Leiste unter dem Viewer, Commits als Punkte, letzter Punkt ist der aktuelle Arbeitsstand. Alte Stände sind **Vorschau** (STEP per `git show`, Arbeitsordner bleibt unberührt). Der Knopf **„Stand wiederherstellen"** kopiert die Dateien und legt einen **neuen Commit** an. Es gibt keinen Checkout oder Reset und keine Branches.@@ -97,6 +100,10 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt| `soma build` | Baut STEP, GLB und Mapping in einem Lauf. Gemeinsam für App und Agent. Führt vorab einen kurzen Check aus und gibt Warnungen mit aus (E20) || `soma check` | Prüft die Projektstruktur und **meldet nur**, mit konkreten Handlungshinweisen, auch maschinenlesbar. Kein `--fix`. Der Agent repariert nach eigenem Ermessen (E28) || `soma export <Bauteil\|--all> --format …` | Einzelexport auf Basis der registrierten Bauteile, auch per Kontextmenü im Tree. Formate (in Phase 0 geprüft): STEP, STL, 3MF, AMF, BREP, IGES, OBJ, VRML, GLB/GLTF. 2D: DXF (Schnitt), SVG (Projektion) (E34) |+| `soma.anim` | Animationen in `animations/*.py` (E58): `Animation("Name")`, Gelenke `hinge`, `slider`, `part`, Zeitleiste `play`, `wait`, `title`, Kamera `set`, `move`, `orbit`, `zoom`, Texte `caption`, `label`, Zustände `highlight`, `hide`, `show`, `ghost` |+| `soma anim build \| list \| info \| check` | Animationen bauen (glTF nach `.soma/anim/`), auflisten, als Text beschreiben, auf Überschneidung und Mindestabstand prüfen (E58) |+| `soma analyze overhang \| thickness \| clearance` | Wert an jeder Stelle der Oberfläche, Zusammenfassung je Bauteil, Ergebnis nach `.soma/results/` (E58) |+| `soma render` | Bild, Übersicht oder Video über die App nach `renders/` (E58). Nur in den Terminals der App |**Bauen (E20):** Auto-Build bei Änderung von `model.py` und `parts/` (Hintergrund, Debounce, abbrechbar). Er ist **abschaltbar**, weil große Modelle sonst die App bremsen. Dann baut der Nutzer per Knopf oder der Agent per Befehl.@@ -108,6 +115,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt- **`AGENTS.md` (E18):** Ganz app-verwaltet, Notizen stehen getrennt in `NOTES.md`. Beim Öffnen eines Projekts mit älterer Regelversion wird sie erneuert, dem Nutzer angezeigt und als Commit gesichert (E36). Der Verweis auf die Notizen steht ganz oben.- **Skills (E17, E55):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), je Modell in drei Stufen: Aus, Bei Bedarf (der Agent liest sie, wenn das Thema aufkommt) und Immer. Eingeschaltete Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`, „Bei Bedarf“ mit Anlass. Zunächst nur mitgelieferte, eigene Nutzer-Skills später.- **Rückmeldung an den Agenten (E11):** Markierungen (Viewer-Bild oder leere Fläche mit Zeichnung) landen als PNG in `.soma/feedback/`, Auswahlen (Bauteilname, Datei, Zeilen, Fläche) und Build-Fehler gehen als Text. Die App fügt Pfad oder Text in die Eingabezeile des Terminals ein, der Nutzer schickt selbst ab. Später kommt ein MCP-Server der App dazu.+- **Bilder und Videos für den Agenten (E58):** `soma render` schickt den Auftrag über eine lokale Verbindung an die App (HTTP nur auf 127.0.0.1, freier Port, Schlüssel je App-Start, beides als `SOMA_APP` und `SOMA_APP_TOKEN` in den Terminals der App). Ein unsichtbares Fenster rendert mit demselben Viewer, der Agent öffnet die PNG-Dateien. Videos kann er nicht ansehen, zu jedem Video entsteht deshalb eine Übersicht mit Standbildern und Zeiten. Dieselbe Verbindung kann später den MCP-Server tragen.## 7. Oberfläche und Viewer@@ -125,6 +133,8 @@ Der Viewer zeigt auch **beliebige weitere STEP-Dateien** im Basismodus, ohne Map**2D-Sketching (E16):** Nur Bild-Markup ohne Maßhaltigkeit auf Viewer-Screenshots und leerer Fläche (Freihand, Formen, Pfeile, Text). Ergebnis ist ein PNG. Kein Constraint-Sketcher. Umgesetzt in Phase 1, Schritt 4 (Abschnitt 10).+**Animation, Analyse und Video (E58):** Werkzeuge „Animation“ und „Analyse“ im Viewer, Videos spielen über dem Viewer. Umgesetzt, siehe Abschnitt 10.+## 8. Umgebung, Auslieferung, Lizenz- **Eine Variante „alles drin"** mit mitgeliefertem Python, CadQuery und Git (E31, E32). Kein Bring-your-own.@@ -278,16 +288,16 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*-- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 12 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten). Der Inhalt ist für den Agenten auf Englisch, Titel, Beschreibung und Themen für die Oberfläche auf Deutsch (im Kopf der Datei). Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.+- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 14 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu). Der Inhalt ist für den Agenten auf Englisch, Titel, Beschreibung und Themen für die Oberfläche auf Deutsch (im Kopf der Datei). Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.- **Stufen (E55, Wunsch des Nutzers):** Jeder Skill steht je Modell auf **Aus**, **Bei Bedarf** oder **Immer** (Umschalter mit drei Feldern in der Karte, „Immer“ hebt die Karte orange hervor, „Aus“ nimmt sie zurück). Bei Bedarf und Immer kopieren den Skill nach `.soma/skills/<id>.md`, tragen ihn in `project.json` ein (`skills` für Immer wie bisher, `skills_on_demand` für Bei Bedarf, auch in der App-Kopie, E27) und listen ihn im Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Der Abschnitt hat zwei Listen: „Always follow“ (vor jeder Änderung lesen und befolgen) und „Read when relevant“ (je Skill der Anlass aus dem neuen Kopffeld `when`, etwa „Read when the parts will be 3D printed on a filament printer (FDM)“, nicht alle vorab lesen). Die Kopie eines Skills „Bei Bedarf“ hat unter der Überschrift einen Hinweis: dem Skill folgen, solange das Thema gilt, das in `NOTES.md` unter `## Requirements` festhalten (sonst weiß eine spätere Sitzung nichts davon), die Werte sind Standardwerte der App (vom Nutzer eingestellte nennt er mit Namen), also nennen oder nachfragen, und in der App lässt er sich auf „Immer“ stellen. **Aus** entfernt Kopie und Eintrag. Jedes Umstellen zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP. Ein Wechsel zwischen Bei Bedarf und Immer schreibt die Kopie neu, eine unveränderte ohne Sicherung.- **Einstellungen (Wunsch des Nutzers):** Ein Skill erklärt im Kopf Variablen, etwa `var overhang: 45 | ° | Max. Überhangwinkel | 10..85` (Standard, Einheit, Bezeichnung, Bereich) oder eine Auswahl `var material: PLA | | Material | PLA, PETG, ABS, ASA, TPU` (Einträge auch als `wert=Anzeige`). Im Text stehen Platzhalter wie `{{overhang}}`. Im Panel stehen die Einstellungen im aufgeklappten Skill: Zahlenfelder (Komma oder Punkt, Enter übernimmt, Escape verwirft) und Auswahllisten, geänderte Werte orange mit Knopf „zurück auf den Standard“, darunter in der Karte „Eingestellt: …“. Die App prüft jeden Wert (Bereich, Auswahl) und lehnt Falsches mit Grund ab. Gespeichert werden nur abweichende Werte, in `project.json` unter `skill_settings`, auch für ausgeschaltete Skills (sie gelten beim Einschalten). Die Kopie im Projekt enthält die eingesetzten Werte, im Text und im Kopf, der Agent liest also konkrete Zahlen. Eine Änderung schreibt die Kopie eines eingeschalteten Skills neu, eine von Hand geänderte Kopie kommt vorher in die Sicherung. Welche Einstellungen die mitgelieferten Skills haben, steht unten. Ein Skill ohne Einstellungen ist erlaubt.- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Umstellen oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz. Den Knopf gibt es bei Bedarf und Immer, bei Bedarf heißt er: jetzt anwenden.- **Ansehen:** Die Kopie öffnet sich im Code-Panel, nur lesbar („Kopie eines Skills“).-- **Kategorien (E46, Wunsch des Nutzers):** `category` im Kopf ordnet einen Skill unter eine Überschrift im Panel: Arbeitsweise, Fertigungsverfahren, Konstruktionswissen. Eine Kategorie steht dort, wo ihr erster Skill laut `order` steht, Skills ohne Kategorie (etwa aus einer neueren App) unter „Weitere“ am Ende.+- **Kategorien (E46, Wunsch des Nutzers):** `category` im Kopf ordnet einen Skill unter eine Überschrift im Panel: Arbeitsweise, Fertigungsverfahren, Konstruktionswissen, Prüfen und Zeigen (E58). Eine Kategorie steht dort, wo ihr erster Skill laut `order` steht, Skills ohne Kategorie (etwa aus einer neueren App) unter „Weitere“ am Ende.- **Skills für neue Modelle (E46, E55, Wunsch des Nutzers):** `default:` im Kopf gibt die Stufe bei neuen Modellen vor (`always`, `on-demand` oder `off`, ohne Angabe Bei Bedarf). Mitgeliefert: Immer für Konstruktionsablauf, Sauber modellieren und Normteile (E48), alle übrigen Bei Bedarf. Im aufgeklappten Skill stellt die Auswahl „Stufe bei neuen Modellen“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`, Einträge von vor E55 mit an/aus gelten als Immer/Bei Bedarf). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Weicht die Vorgabe von „Bei Bedarf“ ab, nennt die Karte sie („Bei neuen Modellen: Immer“). Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.- **Robustheit (E28):** Nichts wird still ersetzt: Weicht die Kopie im Projekt von der mitgelieferten Fassung ab (vom Agenten geändert, ältere App), meldet die Karte das, und vor dem Überschreiben oder Entfernen kommt sie nach `workspace-backups/<id>-skills/`. Fehlt die Datei eines eingeschalteten Skills, nennt das die Karte und der Projekt-Check, angelegt wird nichts. Fehlt `AGENTS.md`, wird der Skill trotzdem umgestellt, mit Warnung, die Datei wird nicht neu erzeugt. Nennt `AGENTS.md` einen eingeschalteten Skill nicht oder unter der anderen Stufe (etwa nach dem Zurückholen einer alten Fassung), steht das in der Karte. Skills, die nur im Projekt liegen (aus einer neueren App), bleiben gültig.-*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 2), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.+*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 2), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24), Prüfen und Zeigen (30 bis 31). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.| Skill | Inhalt | Einstellungen ||---|---|---|@@ -302,7 +312,9 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben| Verbindungen | Schrauben (Einschraubtiefe, Randabstand, Werkzeug, Längen), Schnapphaken, Scharniere, Stifte, Magnete, Kleben | Bevorzugte Schraube || Normteile | Schrauben, Muttern, Scheiben und Einsätze über `soma.fasteners` (E48), Mutternfallen mit `trap()`, Maße von Kugellagern, Stiften, Profilen | keine || Festigkeit und Steifigkeit | Gestaltungsregeln, Biegebalken als Überschlag, Werkstoffwerte, Gewicht | Sicherheitsfaktor |-| Baugruppen und Bewegung | gemeinsame Bezüge, Schnittstellen einmal definiert, Montierbarkeit, bewegte Teile über den Weg prüfen, Stückliste | Mindestabstand bewegter Teile |+| Baugruppen und Bewegung | gemeinsame Bezüge, Schnittstellen einmal definiert, Montierbarkeit, bewegte Teile über den Weg prüfen (für mehrere Schritte über eine Animation und `soma anim check`), Stückliste | Mindestabstand bewegter Teile |+| Analyse (E58) | `soma analyze` für Überhang, Wandstärke und Spalt, Grenzwerte aus den anderen Skills, Bild mit `soma render --result`, Grenzen der Auswertung | keine |+| Animation und Video (E58) | Aufbau einer Datei in `animations/`, Gelenke, Zeitleiste, Kamera, Texte, prüfen mit `soma anim info` und `check`, ansehen als Übersicht, Video nur auf Wunsch | keine |Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung).@@ -316,6 +328,21 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Fehler erklärt (Abschnitt 9):** unbekannte Norm mit Liste, alte DIN-Namen mit dem ISO-Nachfolger, fehlende Größe mit den vorhandenen, fehlender Punkt, Gerade ohne Treffer, mehrdeutiger Einsatz. Für die M10-Einsätze nennt die Tabelle als Bohrer „M14“, größer als der Einsatz: `soma` lehnt sie ab, statt eine unbrauchbare Bohrung zu liefern.- **Für den Agenten (Wunsch des Nutzers):** Die Anleitung steht im Skill „Normteile“, nicht in `AGENTS.md`. Der Skill ist bei neuen Modellen an. Er enthält Beispiel, Lage, Normen, Längen, Mutternfallen, Rolle. Seine Schraubentabelle ist entfallen (nur eine Quelle für die Maße). Der Test führt den Codeblock des Skills aus. „Verbindungen“ nennt `pick_length()`.+*Animation, Analyse, Bilder und Videos (E58, Wunsch des Nutzers; 46 Prüfungen in `app/test/animation.mjs`, 1 Einheitentest):*++- **Grundidee:** Eine Animation ist eine Beschreibung, kein Video. Der Agent schreibt sie in Python in `animations/*.py` mit `soma.anim`: Zeitleiste wie in manim (`play`, `wait`, `run_time`), Drehachsen durch zwei Punkte wie `cq rotate()`, Lagen als `cq.Location`. `soma anim build` führt das Modell aus, dann die Datei (`from model import …` geht, `add_part` bleibt dabei wirkungslos), tastet mit 30 Bildern je Sekunde ab und schreibt eine glTF-Animation nach `.soma/anim/<id>.glb` (je bewegtem Bauteil ein Knoten, Kamera und Zielpunkt, Texte und Zustände in den extras) und `.soma/anim/index.json`. Fehler stehen mit Datei und Zeile im Index.+- **Gelenke, Kamera, Texte:** `hinge` (Drehachse), `slider` (Richtung), `part` (freie Lage), Gelenke auf Gelenken mit `parent=`, ein Gelenk je Teil. Die Kamera kennt die Ansichten des Viewers, `fit` passt Teile über die ganze Bewegung ein, `orbit` kreist um Z, `zoom`. Titelkarten, Untertitel (zum Video auch als WebVTT) und Beschriftungen, die mit ihrem Bauteil wandern. Gemalt werden die Texte auf einer 2D-Fläche über dem Bild, im Viewer wie im Video gleich.+- **Prüfen:** `soma anim info` beschreibt den Ablauf als Text mit Zeiten. `soma anim check` prüft im Abstand von 0,1 s und an den Grenzen jedes Schritts bewegte Teile gegen alle anderen: Überschneidung (Volumen, nur wenn sich die Hüllquader berühren) und Mindestabstand (`--gap`). Berührungen, die schon in der Lage im Modell bestehen, sind gekennzeichnet.+- **Im Viewer:** „Animation“ öffnet unten links die Karte: Auswahl, Abspielen (Leertaste), Schieber, Tempo, Schleife, „Kamera folgen“, „Video erzeugen“, „An Agent geben“ (`[Animation: "Name" (animations/x.py) bei 1.50 s]`). Die Teile bewegen sich im echten Modell, Schnitt und Auswahl gehen weiter, der angeklickte Punkt geht in Einbaulage an den Agenten, eine Markierung nennt Animation und Zeit. Messen, Explosion, Animation und Analyse schließen sich aus.+- **Bauen im Hintergrund:** Ändert sich eine Datei in `animations/`, baut die App sie neu (mit Auto-Build, entprellt, eine nach der anderen), das Modell baut dafür nicht. Ist eine Animation älter als der Code, baut die Karte sie beim Öffnen neu.+- **soma render:** über die App (Abschnitt 6). Standbild (`--view`, `--size`, `--out`), Zeitpunkt einer Animation (`--at`), Übersicht mit Standbildern und Zeiten (`--sheet 3x3`), Video (`--video`: MP4 mit H.264, 1280 x 720, 30 Bilder je Sekunde, dazu WebVTT und Übersicht), Ergebnis einer Analyse mit Legende (`--result`). Ausgabe nach `renders/`. Die App wartet vorher auf einen laufenden Build und sagt, wenn der letzte fehlschlug oder der Code neuer ist. Kodiert wird mit WebCodecs im Render-Fenster, verpackt mit mediabunny (MPL-2.0). Ein Video von 8 s braucht rund 15 s.+- **Video in der App:** Klick auf ein Video im Dateibaum spielt es über dem Viewer (Bild vor und zurück, Schieber, Leertaste). „Zeit an Agent“ fügt `[Video: renders/x.mp4 bei 00:03.20]` ein, „Markieren“ öffnet das Standbild auf der Zeichenfläche, die Notiz nennt Video und Zeitstempel.+- **Analyse:** `soma analyze overhang` (Winkel nach unten zeigender Flächen zur Senkrechten, Flächen auf dem Druckbett ausgenommen), `thickness` (Strahl von der Oberfläche nach innen bis zur Gegenseite), `clearance` (Spalt entlang der Flächennormalen bis zum nächsten anderen Teil, negativ bei Überschneidung, Berührung innerhalb der doppelten Netztoleranz gilt als 0 und ist nicht kritisch). Das Netz wird dafür unterteilt (Kanten bis 1 % der Modelldiagonale, mindestens 0,2 mm), ein Wert je Dreieck, Strahltests mit VTK aus der Basisumgebung. Ergebnis: `.soma/results/<name>.glb` mit dem Attribut `_VALUE` und den Metadaten (Größe, Einheit, Grenzwert, Spanne, Zusammenfassung, Befehl).+- **Analyse im Viewer:** „Analyse“ zeigt das gewählte Ergebnis farbig statt des Modells: Rot kritisch, Gelb nahe am Grenzwert, Grün unkritisch, weit davon Grau, Berührung Blaugrau. Legende und Zusammenfassung je Bauteil in der Karte, der Wert unter dem Zeiger, ein Klick merkt die Stelle für „An Agent geben“. Ist der Code neuer, steht das da, „Neu berechnen“ wiederholt die Auswertung mit ihren Angaben.+- **Für den Agenten:** zwei neue Skills „Analyse“ und „Animation und Video“ (Kategorie „Prüfen und Zeigen“, Bei Bedarf). `AGENTS.md` nennt `animations/`, `renders/`, `soma render` (Bild, um die eigene Arbeit anzusehen), `soma analyze`, `soma anim` und die neuen Notizen. „3D-Druck“ und „Baugruppen“ verweisen auf die Befehle. Das Beispiel im Skill baut der Test so, wie es dasteht.+- **Am Testmodell:** Überhang der Konsole 3,64 cm² (90°), Lasche mit 1 mm unter 1,2 mm, Stift mit 0,2 mm Spalt kritisch, Störer mit 2 mm Überschneidung, der aufliegende Deckel nur als Berührung. Eine Auswertung dauert hier unter 2 s.+- **Grenzen:** Videos ohne Ton. Die Kollisionsprüfung sieht nur ihre Zeitpunkte. Keine Spannungen (FEM) und keine Strömung (CFD), sie kämen als weitere Auswertungen auf demselben Weg. Getestet unter Windows.+*Offen in Phase 1:* Projektumgebung mit `pip freeze` und `requirements.txt` (bisher landet `pip install` noch in der gemeinsamen Basisumgebung), Auto-Start des Agenten ohne Resume, Agent-Test mit weiteren Agenten und längeren Sitzungen, Bündelung von Python und Installer, macOS und Linux.**Danach:** Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile (E48, Wunsch des Nutzers), Versions-Schieber, `soma check` und Projekt-Check, MCP-Server, zweite Stufe der Explosionsansicht (Demontage-Analyse, E56). **Später:** Volumen/Gewicht, Versionsvergleich, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).@@ -383,6 +410,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen deutsch. Lage über Auflagepunkt und Richtung ins Material. Senkung = Kopf plus Spiel des gewählten Durchgangslochs, Tiefe genau die Kopfhöhe (nicht DIN 974, der Skill „Toleranzen“ nennt für Zylinderköpfe etwas größere Senkungen, mit `recess=` einstellbar). Kernloch aus der Spalte „Soft“ (Regelwerte). Einsätze: Standard ruthex, Bohrung 1 mm tiefer als der Einsatz. Farben Stahlgrau und Messing- Normteile: Alte DIN-Namen (DIN 912, DIN 933 …) sind ein Fehler mit Hinweis auf die ISO-Norm, weil manche Maße abweichen. Nur Regelgewinde. Muttern haben eine Bohrung im Nenndurchmesser (sie berühren den Schaft, überschneiden ihn nicht). Ein Einsatz ist dicker als seine Bohrung, Kollisionsprüfungen mit seinem Teil lässt der Agent aus (steht im Skill „Normteile“)- Rolle `hardware` (E48): Zukaufteile haben keinen eigenen Abschnitt im Bauteilbaum, sie unterscheiden sich durch Farbe und den Zusatz „(Zukaufteil)“ in der Auswahl. `soma export --all` nennt die Zahl der übersprungenen Teile+- Animation, Ablage (E58): beliebig viele Animationen je Datei in `animations/`, Namen im Projekt eindeutig, Kennung aus dem Namen (ASCII). Gebaute Animationen in `.soma/anim/`, Ergebnisse in `.soma/results/`, Bilder und Videos in `renders/`, alle drei nicht in Git (sie entstehen neu), aber in der ZIP. `soma render` ersetzt Dateien gleichen Namens in `renders/`+- Animation, Format: glTF mit abgetasteten Lagen (30 je Sekunde) statt Schlüsselbildern, damit Drehungen um eine Achse genau bleiben. Die Kamera ist ein glTF-Knoten mit eigenem Zielpunkt, Bildwinkel fest 35° wie im Viewer+- Animation, Schnittstelle: Winkel in Grad mit Rechte-Hand-Regel um `p2 - p1`, Übergang „smooth“ (kubisch) als Standard. `title()` nimmt sich Zeit, `caption()` gilt bis zum nächsten Untertitel. Ohne Kamera gilt die Standardansicht, über die ganze Bewegung eingepasst+- Hervorhebung in Animationen: Die Flächenfarbe wird nach Orange gezogen (Auswahl), reines Leuchten färbte blaue Teile violett (Vorschau). Im Viewer stehen Untertitel über der Karte der Animation, im Video unten+- Render: unsichtbares Fenster, eine Minute nach dem letzten Auftrag geschlossen. Standbild 1280 x 800, Übersicht 3 x 3 Bilder zu 480 x 300, Video 1280 x 720 mit 30 Bildern je Sekunde (`--size`, `--fps`). Ohne H.264 auf dem Rechner wird es VP9 im MP4, mit Hinweis. Die Verbindung nimmt nur Aufträge für das offene Modell an+- Analyse: drei Auswertungen mit den Grenzwerten 45°, 1,2 mm und 0,5 mm (wie in den Skills), ohne `--parts` nur eigene Teile, beim Abstand zählen alle anderen als Gegenstück. Farben aus den Statusfarben. „Veraltet“ heißt: irgendein Quelltext ist neuer, nicht unbedingt das ausgewertete Teil+- Vorschau eines alten Stands beendet Animation und Analyse (beide gehören zum aktuellen Code)+- Abhängigkeit mediabunny (MPL-2.0, Dateien unverändert, E30) für MP4- Explosionsansicht (E56): Start bei 50 % des Schiebers. Bei 100 % rücken Teile um das Doppelte, Gruppen um das 3,2-Fache des Abstands ihrer Mitte zur Mitte darüber. Referenzen bleiben stehen und zählen für die Mitten nicht mit, ausgeblendete Teile zählen mit (sonst spränge die Explosion beim Ausblenden). Wege sind anfangs an. Messen und Explosion schließen sich aus, statt im auseinandergezogenen Modell zu messen- Rolle `reference` und ihre Standardwerte (E34)@@ -410,6 +445,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Auswahlen des Agenten:** Flächen-IDs gelten nur pro Build, Verweise brauchen Bauteilname plus Geometrieangabe- **Inhalte** von `AGENTS.md` und den Skills, mit einem echten Agenten zu testen. Vor allem (E55): Liest ein Agent einen Skill „Bei Bedarf“ von selbst, wenn das Gespräch das Thema wechselt (etwa „jetzt für den 3D-Druck“), und hält er das in `NOTES.md` fest? Mit Claude Code und einem kleineren Modell prüfen- **Projekt-Check:** Umfang und Spezifikation, Abdeckung aller Störfälle+- **Animation und Analyse (E58):** Montage Schritt für Schritt aus der Demontage-Analyse der Explosion (E59) als Animation erzeugen? FEM und CFD als weitere Auswertungen (Werkzeug wählen, Pakete erst mit der Projektumgebung, E25). Längere Videos (heute ganz im Speicher), Ton. Agent-Test: Liest ein Agent die Skills und öffnet er die Bilder von `soma render` von selbst?## 12. Größte Risikendiff --git a/app/README.md b/app/README.mdindex 232bf34..8d79b7b 100644--- a/app/README.md+++ b/app/README.md@@ -1,6 +1,6 @@# SOMA: Desktop-App-Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Plan: [../PLAN.md](../PLAN.md). Stand: **Phase 1, Schritte 1 bis 5** (Gerüst, Git und ZIP, Oberfläche nach dem Entwurf in [../design/ui-entwurf.html](../design/ui-entwurf.html), Markierung, Editor), dazu Messen, Gruppen, Schnitt und Skills.+Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Plan: [../PLAN.md](../PLAN.md). Stand: **Phase 1, Schritte 1 bis 5** (Gerüst, Git und ZIP, Oberfläche nach dem Entwurf in [../design/ui-entwurf.html](../design/ui-entwurf.html), Markierung, Editor), dazu Messen, Gruppen, Schnitt, Skills, Animation, Analyse sowie Bilder und Videos über `soma render`.## Voraussetzungen@@ -15,7 +15,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.npm installnpm start # baut und startetnpm run typecheck-npm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md (46 Prüfungen)+npm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md, Animationsdateien bauen nicht das Modell (47 Prüfungen)npm run test:smoke # echte App, unsichtbar: Projekt, Viewer, Auswahl, Panels, Terminal, Übergabe an den Agenten, Markierung (Zeichnen, Linie, Raster, Auswählen, Verschieben, Drehen, Skalieren, Farben, Bild aus dem Dateibaum), Dateibaum (Markierungen, Menü, Anlegen, Umbenennen, Papierkorb), Auto-Build, Fehlerfall, Export, Ansichtswürfel und Drehpunkt (79 Prüfungen)npm run test:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle (53 Prüfungen)npm run test:editor # Editor: Höhe und Scrollen, Speichern nur auf Wunsch mit genau einem Build (nur bei Python und inputs/), Änderungen des Agenten, Konflikte mit Sicherung, Nur lesen, CRLF, Rückfragen bei Modellwechsel und Reiter schließen, Markdown als Dokument (37 Prüfungen)@@ -25,7 +25,8 @@ npm run test:section # Schnitt: X/Y/Z und an Fläche, Eingabe der Lage, Seitenpm run test:explode # Explosion: Richtungen aus Gruppen und Achsen der Normteile, Schieber, Wege, Auswahl in Einbaulage, Hervorhebung wandert mit, Messen setzt zusammen, Schnitt dazu, neuer Build (20 Prüfungen)npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mit oder ohne Hinweis, project.json, zwei Listen in AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, An Agent geben, Sicherung geänderter Kopien, fehlende Dateien und falsche Listen nur gemeldet, Snapshot und ZIP, Kategorien, Stufen für neue Modelle (47 Prüfungen)npm run test:fasteners # Normteile: Maße aus den Tabellen, Lage (at, direction, on, sunk), Bohrungen und Mutternfallen ohne Überschneidung, Einsätze, Fehlermeldungen, Rolle hardware, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (35 Prüfungen)-npm test # alle neun+npm run test:animation # Animation, Analyse, soma render und Video: Bauen über den Watcher, Ablauf als Text, Kollisionsprüfung, Fehler mit Ort, Abspielen im Viewer (Lage, Hervorhebung, Kamera), Ausschluss mit Explosion und Messen, Verbindung mit Schlüssel, Bild, Übersicht, MP4 mit WebVTT, Video abspielen und Standbild markieren, Überhang, Wandstärke, Abstand mit Anzeige und Neu berechnen, Beispiel des Skills (46 Prüfungen)+npm test # alle elf````SMOKE_VISIBLE=1` zeigt das Fenster. `SMOKE_VISIBLE=offscreen` zeigt es weit außerhalb des Bildschirms ohne Fokus, dann sind Screenshots (`test/versions.png`) frisch. Ein unsichtbares Fenster zeichnet nicht neu, seine Screenshots sind veraltet, die DOM-Prüfungen sind davon nicht betroffen. Mit `SMOKE_VISIBLE=offscreen` und zusätzlich `SMOKE_SHOTS=1` legt der Smoke-Test Bilder der wichtigsten Zustände in `test/shots/` ab (Arbeitsbereich, Code, Dateien, Fehler, Startseite, Agent eingeklappt, Markieren mit Textfeld, leerer Fläche, Auswahl und Farbmenü, dazu das gespeicherte Bild, wie der Agent es sieht), zum Prüfen von Änderungen an der Oberfläche.@@ -36,15 +37,16 @@ npm test # alle neun| Pfad | Inhalt ||---|---|-| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, `soma` und `git` im PATH), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts` |-| `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort) |+| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, `soma` und `git` im PATH), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) |+| `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort), `render-preload.ts` für das Render-Fenster || `src/renderer/` | Oberfläche: `main.ts` (Verdrahtung: Kopfzeile, Menüs, Auswahl, Übergabe an den Agenten, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Schnittebene mit gefüllter Schnittfläche und Kontur, verschobene Bauteile der Explosion mit Wegen, Vorschaubild, Bild für die Markierung), `viewcube.ts` (Ansichtswürfel in 3D), `sectiontool.ts` (Schnitt: Karte, Ebene, Text für den Agenten), `explodetool.ts` (Explosion: Richtungen je Bauteil, Karte, Text für den Agenten), `skills.ts` (Panel „Skills“), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `parts.ts` (Bauteilkarte als Baum mit Gruppen, Auge und Transparenz), `code.ts` (Code-Panel mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `markdown.ts` (Markdown als Dokument: Tokens von `marked` direkt als DOM, ohne `innerHTML`), `filetree.ts` (Dateien-Panel), `versions.ts` (Verlaufsleiste), `terminals.ts` (xterm.js, Tabs, Einklappen, Einfügen), `ui.ts` (Menüs, Meldungen, Helfer), `icons.ts` (Symbole), `style.css` (Farben mit fester Bedeutung, siehe Kopf der Datei) |+| `src/renderer/` (E58) | `animdata.ts` (Animation aus der glTF-Datei auswerten), `animtool.ts` (Karte „Animation“), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Karte „Analyse“), `videoview.ts` (Video-Player mit Standbild markieren), `render.html` und `render.ts` (unsichtbares Render-Fenster: Bild, Übersicht, MP4 mit WebCodecs und mediabunny) || `src/shared/` | `types.ts` Typen des IPC-Vertrags, `editable.ts` welche Dateien der Editor nur zeigt (gilt in Renderer und Hauptprozess) || `resources/template/` | Vorlage für neue Projekte: `model.py`, `AGENTS.md`, `CLAUDE.md`, `NOTES.md`, `.gitignore` || `resources/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (deutsch, Oberfläche), `name` und `when` (englisch, für `AGENTS.md`: Name und Anlass), `order`, `default:` (Stufe bei neuen Modellen: `always`, `on-demand` oder `off`) und optional Einstellungen als `var name: Standard \| Einheit \| Bezeichnung \| 10..85` oder `\| a, b=Anzeige`, darunter die Regeln für den Agenten auf Englisch mit Platzhaltern `{{name}}` || `resources/icon.*` | App-Icon (E44) für Fenster und Taskleiste: `icon.svg` als Vorlage, `icon.ico` (16 bis 256 px) und `icon.png`. Neu erzeugen mit `python scripts/make-icon.py` (braucht Edge und Pillow, kleine Größen bekommen einen dickeren Strich) |-| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`) |-| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `fasteners.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `render.py` Auftrag an die App für `soma render`, `gltf.py` GLB-Schreiber) |+| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `fasteners.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |## Noch nicht enthalten (siehe PLAN.md, Abschnitt 10)