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, Entscheidungen, README und CLAUDE.md: Wartezeiten (E66)
Kai-Jungsthoefel11d41f9f33c4
diff --git a/CLAUDE.md b/CLAUDE.mdindex 13f6ac6..7854953 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -14,7 +14,7 @@ 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`, `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`, `busy.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/` |+| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts` (mit vorgewärmtem Python-Prozess), `previews.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`, `busy.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-2.html` | Freigegebener Oberflächenentwurf 2 „Aufgeräumt“ (E62), im Browser öffnen, Pfeiltasten blättern. Maßstab für Aufbau, Farben und Texte der Oberfläche. Bild 6 ist das geplante Parameter-Panel || `design/ui-entwurf.html` | Erster Oberflächenentwurf (E38), Farben und Bausteine gelten weiter, der Aufbau ist durch Entwurf 2 ersetzt || `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |diff --git a/DECISIONS.md b/DECISIONS.mdindex a5f127a..b90451d 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -68,3 +68,4 @@| 63 | Export mit Dateidialog | **Exportieren fragt nach dem Ziel:** ein Bauteil per Speichern-Dialog in eine Datei, alle Bauteile per Ordnerauswahl (je Bauteil eine Datei). **Die Karte eines angeklickten Bauteils bekommt einen Knopf „Exportieren“.** Die App schreibt nicht mehr nach `exports/` im Projekt | Ergänzt E34 (dort Ausgabe nach `exports/`). `soma export --out` geht für die App in einen leeren Ordner unter Temp, kopiert wird danach. Vorhandene Dateien im Ordner ersetzt die App nur nach Rückfrage, beim Einzelexport fragt der Speichern-Dialog selbst. `soma export` im Terminal schreibt weiter nach `exports/` || 64 | Verbesserungen aus Agent-Tests allgemein | **Rückmeldungen aus einem Agent-Test sind Beispiele: Verbessert wird, was in jedem Projekt hilft, ohne neue Begriffe für den Agenten.** Umgesetzt: Analyse rechnet am Grenzwert mit der Netzgenauigkeit, ein Bauteil geht vor einer gleichnamigen Gruppe, Problemstellen mit Größe und Lage, Hinweis auf eine bessere Druckrichtung. `soma anim check` rechnet auf den Dreiecksnetzen, Berührung und Spiel aus dem Modell gelten als gewollt. Lange Befehle zeigen den Fortschritt. Animationen führen das Modell nicht noch einmal aus, `soma anim info` fasst Schleifen zusammen. Normteile haben `rotate()`, `translate()` und `moved()` wie CadQuery-Formen. Eine Regel für Maße (`parts/params.py`). Zwischenergebnisse kommen nicht in Verlauf und ZIP, auch in älteren Projekten. **Zurückgestellt:** gekoppelte Gelenke, Zahnräder, Lager, Federn | Anlass: Agent-Test am Einzylindermotor (2026-10-06), `anim check` lief dort über 25 Minuten. Dazu der Wunsch des Nutzers, das langsame Speichern zu beheben: Ergebnisse von `soma analyze` (bis 70 MB je Auswertung) landeten in Snapshot und ZIP || 65 | FEM als Auswertung | **Festigkeit mit der Finite-Elemente-Methode kommt als weitere Auswertung `soma analyze fem <studie.py>` auf dem Weg von E58.** Der Agent beschreibt den Lastfall in `analyses/*.py` (Werkstoff, `fix`, `force`, `pressure`, `gravity`, Flächen per CadQuery-Selektor oder Punkt), die App zeigt den Sicherheitsfaktor farbig, die Verformung überhöht und den Lastfall. **Die nötigen Pakete (gmsh, pyamg) kommen in die Basisumgebung** | Vorschlag nach der Frage des Nutzers, Umsetzung und Paketwahl vom Nutzer so gegeben („die Pakete nehmen wir mit rein“). Auslegung (nicht ausdrücklich bestätigt): linear-elastisch, quadratische Tetraeder aus gmsh, eigene Steifigkeitsrechnung in numpy statt scikit-fem (rund 20-mal schneller), gelöst mit pyamg, mehrere Teile fest verbunden, gedruckte Kunststoffe mit der Festigkeit quer zu den Schichten, Prüfungen (Lagerung, Gleichgewicht, gröberes Netz, Spitzen an Einspannung und Kanten) als Hinweise. Umsetzung in PLAN.md Abschnitt 10 |+| 66 | Wartezeiten bei Öffnen, Zeitleiste und neuem Modell | **Was schon gebaut ist, wird nicht neu gebaut:** Beim Öffnen zeigt die App den letzten Build, solange er noch gilt (nichts geändert seit seinem Start). **Ein vorgewärmter Python-Prozess für die ganze App** statt einem je Projekt, schon ab dem Start, für Builds, Vorschauen und alle übrigen Aufträge. **Der Build eines sauberen Arbeitsordners wird die Vorschau des letzten Commits**, ein Sprung in der Zeitleiste muss dann nicht neu vernetzen. Nach „Wiederherstellen“ bleibt der wiederhergestellte Stand zu sehen, bis der Build fertig ist | Vom Nutzer gewählt aus einer Liste von Vorschlägen nach der Messung am Hotwire-Modell (Punkte 1 und 2: „jop“). Der Build selbst (Mesher, Reihenfolge der Ausgaben, Hinweise im Skill) ist zurückgestellt, siehe PLAN.md Abschnitt 11. Umsetzung in PLAN.md Abschnitt 10 |diff --git a/PLAN.md b/PLAN.mdindex 11f1188..0f3a79c 100644--- a/PLAN.md+++ b/PLAN.md@@ -38,7 +38,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner```- **Desktop:** Electron, TypeScript (E23). Editor: CodeMirror 6 (Phase 1, Schritt 5).-- **Python-Dienst:** Pro Projekt ein langlebiger Prozess für die App (schnelle Messungen, Modell im Speicher). Der Build-Befehl des Agenten läuft zusätzlich als eigenständiger Einmal-Prozess und funktioniert auch ohne App (E24). **Umgesetzt für das Messen** (`soma serve`), gebaut wird weiter im Einmal-Prozess. Damit der Start von Python und der Import von cadquery (rund 3 bis 4 s) nicht bei jedem Build anfallen, hält die App einen vorgewärmten `soma build --wait` bereit, der erst auf eine Startzeile hin baut. Jeder Build bleibt ein frischer Prozess, ein warmer Build dauert rund 0,5 s statt 4 bis 5 s.+- **Python-Dienst:** Pro Projekt ein langlebiger Prozess für die App (schnelle Messungen, Modell im Speicher). Der Build-Befehl des Agenten läuft zusätzlich als eigenständiger Einmal-Prozess und funktioniert auch ohne App (E24). **Umgesetzt für das Messen** (`soma serve`), gebaut wird weiter im Einmal-Prozess. Damit der Start von Python und der Import von cadquery (rund 3 bis 4 s) nicht bei jedem Build anfallen, hält die App einen vorgewärmten `soma warm` bereit, einen für die ganze App und schon ab dem Start (E66). Was er tun soll (Build, Vorschau eines alten Standes, Export, Animation, Auswertung), erfährt er erst mit einer Auftragszeile. Jeder Auftrag bleibt ein frischer Prozess, ein warmer Build dauert rund 0,5 s statt 4 bis 5 s.- **CAD-Framework:** **CadQuery**, fest (E12). OpenSCAD ist ausgeschlossen (kein STEP, kein B-Rep).- **Viewer:** three.js zeigt ein GLB, das nach jedem Build aus der STEP-Datei erzeugt wird (Bauteilnamen, Farben, Flächen- und Kanten-IDs). Exakte Messwerte (Radius, Flächenabstand) fragt die App beim Python-Dienst ab. Es gibt keinen zweiten CAD-Kern im Frontend (E9).@@ -390,6 +390,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Pakete:** gmsh 4.15 (GPL 2 oder später) und pyamg 5.3 (MIT) in der Basisumgebung, gepinnt in `prototype/phase0/requirements-phase0.txt`. scikit-fem war kurz installiert und ist wieder entfernt. gmsh läuft nur im Python-Prozess von `soma`, nicht in der App. Ob die Auslieferung einer Basisumgebung mit gmsh zur Lizenz der App passt, ist offen (Abschnitt 11).- **Grenzen:** linear-elastisch, kein Kontakt, kein Gleiten, kein Knicken, keine Vorspannung von Schrauben, keine Ermüdung. Teile sind verschmolzen, nicht gefügt. Werkstoffe gleichmäßig (keine Schichtrichtung, kein Infill, kein Holzfaserverlauf). Werte nur an der Oberfläche. Getestet unter Windows.+*Wartezeiten (E66, Wunsch des Nutzers; Prüfungen in `app/test/versions.mjs` und `unit.mjs`):*++- **Anlass:** Beim Hotwire-Modell (294 Bauteile, davon 164 Normteile, rund 158 000 Dreiecke) dauerten Öffnen, Zurückspringen in der Zeitleiste und ein neues Modell zu lange. Gemessen: Python und cadquery starten 3 s, `model.py` 4,5 s, STEP 1,3 s, Netz, GLB und Geometrie zum Messen 4 s. Öffnen baute immer neu und ohne vorgewärmten Prozess (rund 13 s leerer Viewer), ein alter Stand las die STEP-Datei wieder ein und vernetzte neu (rund 10 s je Stand), ein neues Modell startete Python zweimal kalt (rund 8 s).+- **Öffnen ohne Neubau:** Gilt der letzte Build noch, zeigt die App ihn sofort. Er gilt, wenn `.soma/build.json` erfolgreich ist, die Fassung der Ausgaben trägt (`format`, `OUTPUT_FORMAT` in `build.py` und `build.ts`), GLB, Mapping und die Geometrie zum Messen da sind und keine Datei, deren Änderung bei offener App einen Build auslöst (`.py` überall, `inputs/`), neuer ist als der **Start** des Builds. Sonst wird gebaut wie bisher. Die Statusleiste nennt die Zeit des übernommenen Builds.+- **Ein vorgewärmter Python-Prozess für die ganze App** (`soma warm`, `build.ts`): schon beim Start der App, unabhängig vom Projekt, in einem leeren Startordner (`python-start` in den App-Daten, kein Projektordner, den Windows festhielte). Builds und alle `runSoma`-Aufrufe (Vorschau, Export, Animationen, Auswertungen, der Build beim Anlegen) nehmen ihn, danach wärmt der nächste vor. `soma build --wait` entfällt.+- **Vorschau-Cache für die Zeitleiste:** Ist der Arbeitsordner sauber (alles wie im letzten Commit) und gilt der Build, zeigt er genau diesen Commit. Dann legt die App ihn als dessen Vorschau ab (`previews.ts`), ausgelöst von neuen Commits (auch des Agenten) und fertigen Builds. Das Mapping verliert dabei die Code-Verweise (in der Vorschau zeigt der Editor den aktuellen Code), Rollen und Gruppen bleiben. Ändert sich etwas während des Kopierens oder ist die GLB unvollständig, wird verworfen. Stände ohne Cache entstehen wie bisher aus der STEP-Datei, dann im vorgewärmten Prozess.+- **Wiederherstellen:** Die Vorschau bleibt stehen, bis der Build danach fertig ist. Vorher sprang die Ansicht so lange auf den vorherigen Build zurück.+- **Neues Modell:** Der Build vor dem Startcommit läuft im vorgewärmten Prozess, beim Öffnen wird nicht noch einmal gebaut. Der Startcommit wird gleich zur Vorschau.+- **Gemessen mit Hotwire in der App:** Öffnen bzw. App-Start bis zum sichtbaren Modell 1,9 s (vorher rund 13 s), Sprung zu einem Stand im Cache 0,3 s (vorher rund 10 s), ein Stand ohne Cache 8,5 s, neues Modell 3,6 s (vorher rund 8 s, der Rest ist vor allem Git auf dem Netzlaufwerk). Der Build selbst ist unverändert (rund 10 s).+- **Testwerkzeug:** `taskkill /T` lässt den ganzen Baum stehen, wenn ein Kind sich nicht beenden lässt (Hilfsprozesse von node-pty beim Schließen eines Terminals), und unter Last braucht der Hauptprozess bis zu 40 s, bis er weg ist. Ein Neustart mit denselben App-Daten fand dann kein Fenster (Debug-Port noch belegt). `harness.mjs` beendet in dem Fall Kinder und Hauptprozess einzeln, wartet auf das Ende und vor dem Start auf einen freien Port.+*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. **Später:** Volumen/Gewicht, Versionsvergleich, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).@@ -400,14 +411,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- `AGENTS.md` und die Kommentare der Vorlage sind **auf Englisch** (Agenten befolgen englische Anweisungen zuverlässiger), die Oberfläche ist deutsch- App-Daten liegen unter Windows in `%LOCALAPPDATA%\soma`, nicht im Roaming-Profil (Arbeitsordner und Caches gehören nicht ins Netz)-- Beim Öffnen eines Projekts wird sofort gebaut, damit der Viewer nicht leer ist. Beim Anlegen läuft vor dem Startcommit ein Build (rund 2 s Wartezeit bei „Neu“)+- Beim Öffnen eines Projekts wird sofort gebaut, damit der Viewer nicht leer ist, außer der letzte Build gilt noch (E66), dann wird er gezeigt. Beim Anlegen läuft vor dem Startcommit ein Build (im vorgewärmten Prozess unter 1 s)- Der Modellname folgt dem Dateinamen der ZIP- Speichern baut vorher neu, wenn der Quelltext neuer ist als das letzte Ergebnis, und wartet auf laufende Builds- Die ZIP enthält `.git` und Feedback-Bilder, aber weder Umgebungen noch GLB-Cache, Mapping und `build.json`, seit E64 auch keine gebauten Animationen und Analyseergebnisse (`.soma/anim/`, `.soma/results/`). Bilder und Videos aus `renders/` bleiben in der ZIP, aber nicht im Verlauf- Ältere Projekte (vor E58) bekommen die Zwischenergebnisse beim Öffnen in `.git/info/exclude`, der nächste Snapshot der App nimmt schon committete aus dem Index (die Dateien bleiben). Das ändert den Verlauf vorwärts, ohne Rückfrage (wie bisher bei `.soma/geometry/`)- Ohne `.git` gibt es **keinen** Knopf „Verlauf neu anlegen“, nur die Meldung (sonst widerspricht es E28). Offene Frage: Für Nicht-Programmierer wäre ein ausdrücklicher Knopf freundlicher- Änderung während eines Builds: laufenden Build fertig laufen lassen, danach genau ein weiterer (statt abbrechen und neu starten)-- Vorgewärmter Build-Prozess: pro offenem Projekt läuft ein zusätzlicher Python-Prozess mit geladenem cadquery (Speicher gegen rund 3,5 s je Build). Er wird beim Start eines Builds für den nächsten angelegt und beendet sich, wenn die App ihn verwirft oder abstürzt (stdin geschlossen). Nach dem Ergebnis beendet sich `soma build` sofort (`os._exit`), das Aufräumen von OCP und vtk kostete knapp 1 s+- Öffnen ohne Neubau (E66): Ob der letzte Build noch gilt, entscheiden die Zeitstempel der Dateien gegen den Start des Builds, nicht ihr Inhalt. Eine Änderung der soma-Bibliothek selbst fällt nur über `OUTPUT_FORMAT` auf, das von Hand erhöht wird, wenn sich die Ausgaben ändern. Ein fehlgeschlagener letzter Build wird beim Öffnen wiederholt (damit der Fehler frisch dasteht)+- Vorschau-Cache (E66): Vorschauen aus einem Build zeigen echte Rollen (Referenz halbtransparent, Zukaufteile), solche aus der STEP-Datei den Basismodus. Code-Verweise fehlen in beiden. Der Cache in den App-Daten (`previews/`) wird nie aufgeräumt+- Nach „Wiederherstellen“ bleibt die Vorschau bis zum Ende des folgenden Builds stehen, auch wenn er fehlschlägt (dann mit Fehlerkarte über dem wiederhergestellten Stand)+- Vorgewärmter Python-Prozess (E66): einer für die ganze App läuft ständig mit geladenem cadquery (Speicher gegen rund 3 s je Auftrag), schon ab dem Start. Er wird bei jeder Entnahme für den nächsten angelegt und beendet sich, wenn die App ihn verwirft oder abstürzt (stdin geschlossen). Nach dem Ergebnis beendet sich `soma build` sofort (`os._exit`), das Aufräumen von OCP und vtk kostete knapp 1 s- Angezeigt wird nur die Gesamtdauer eines Builds vom Start bis zum Ergebnis, nicht mehr die Summe der Teilzeiten (die zeigte 0,1 s, obwohl man 4 s wartete). `soma build` im Terminal meldet ebenfalls die Gesamtzeit- Oberfläche (E38): Funktionen, die noch fehlen (inzwischen nur noch Pakete, Hilfe, Optionen), stehen schon ausgegraut mit Hinweis da. Nur dunkles Farbschema. Das „⋯“-Menü aus dem Entwurf entfällt (alles steht im Dokumentmenü)- Dateien, die man irgendwo ins Fenster zieht, landen in `inputs/` (Electron würde sie sonst als Seite öffnen). Bei gleichem Namen „name (2).ext“@@ -503,6 +517,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Netzlaufwerke (Windows):** Liegt das Programm auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht. Die installierte App muss lokal liegen, Fehlermeldung ist vorhanden. Klären, wie der Installer damit umgeht und ob Firmenrechner mit umgeleiteten Profilen Probleme machen- **Updates:** Regeln für alte und neuere `api_version`, Auto-Update der App, Signierung (E36)- **Format** von `model.map.json` (Entwurf `version 0` aus Phase 0 steht) und der Ausgabe von `soma check`+- **Vorschau-Cache (E66):** wächst unbegrenzt (Hotwire rund 13 MB je Stand), es gibt kein Aufräumen. Vorschlag: älteste Stände je Projekt über einer Grenze löschen, sie entstehen bei Bedarf neu+- **Weitere Beschleunigung (gemessen, nicht umgesetzt, E66):** Der Mesher liest jede Form einzeln aus, auch gleiche: Die 164 Normteile im Hotwire sind nur 17 verschiedene Formen (rund 1,5 s zu sparen). Das Auslesen in Python dauert rund 3 s gegen 0,6 s Vernetzung in OCC, über VTK aus CadQuery wären es rund 1,2 s für alles (größerer Umbau, Flächen- und Kanten-IDs fürs Messen). GLB erst schreiben und melden, STEP und Geometrie danach (1,9 s früher im Viewer). Hinweise im Skill „CadQuery“: Bohrungen in einem `cut` abziehen (20 Bohrungen 0,15 statt 0,75 s), gleiche Teile mit `.moved()` platzieren statt neu bauen (auch Netz und STEP profitieren). Weniger Git-Aufrufe beim Anlegen und Wiederherstellen (je rund 0,15 s auf dem Netzlaufwerk). Den Messdienst aus dem vorgewärmten Prozess starten- **Toleranz des Meshers:** Feste 0,05 mm passt für kleine Teile, große brauchen eine an der Größe orientierte Toleranz (siehe Leistungsmessung)- **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üfendiff --git a/app/README.md b/app/README.mdindex 3a02028..f44818f 100644--- a/app/README.md+++ b/app/README.md@@ -15,9 +15,9 @@ 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, Animationsdateien bauen nicht das Modell, Zwischenergebnisse nicht in Verlauf und ZIP auch in älteren Projekten (51 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, Zwischenergebnisse nicht in Verlauf und ZIP auch in älteren Projekten, gilt der letzte Build noch, Build als Vorschau eines Commits (63 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:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build (60 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)npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebenen, zweier Bohrungen, zweier Punkte, Punkt zur Ebene, Verdecktes, neuer Build, Vorschau (21 Prüfungen)npm run test:groups # Gruppen: eigene und importierte (STEP-Baugruppe), Baum, Aus-/Einblenden und Transparenz je Gruppe, Klick durch transparente Teile, Ausgabe-STEP (17 Prüfungen)@@ -41,7 +41,7 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build| 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`, 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/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, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen), `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 mit Spalten-Schaltern, Seitenleiste und Code-Spalte, Umschalter oben links im Viewer, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Schnittebene mit gefüllter Schnittfläche und Kontur, verschobene Bauteile der Explosion mit Wegen, Strahltest der Demontage-Analyse mit BVH aus `three-mesh-bvh`, 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: Demontage-Analyse mit Baugruppen und schrägen Richtungen, Elternteile, Lage, Abspielen Schritt für Schritt, Karte, Texte für den Agenten), `busy.ts` (Ladeanzeige über dem Viewer mit Fortschritt und Abbrechen, für die Analyse der Explosion), `skills.ts` (Skills in der Seitenleiste: Zeilen mit Stufen-Schalter, Karte daneben mit Einstellungen), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `parts.ts` (Bauteilbaum in der Seitenleiste mit Gruppen, Auge und Transparenz, Zeilen lassen sich ins Terminal ziehen), `code.ts` (Code-Spalte 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` (Dateibaum in der Seitenleiste, offene Datei hervorgehoben), `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“, gewählt im Umschalter oben links), `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) |@@ -49,7 +49,7 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build| `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/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) |+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `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`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) || `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)