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
Entscheidung E67, Plan, README und CLAUDE.md: Zusatzpakete
Kai-Jungsthoefel610e23ab62fa
diff --git a/CLAUDE.md b/CLAUDE.mdindex 7854953..0b238dc 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -14,11 +14,11 @@ 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` (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/` |+| `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`, `packages.ts` (Projektumgebung, E67), `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 |-| `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`, FEM in `fem.py`), `soma render` (`render.py`, über die App) |+| `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`, FEM in `fem.py`), `soma render` (`render.py`, über die App), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) || `prototype/phase0/` | Abgeschlossener technischer Prototyp mit `ERGEBNISSE.md`. Nur noch Referenz |Details: `app/README.md`.@@ -34,7 +34,7 @@ uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exnpm installnpm start # baut und startetnpm run typecheck-npm test # baut, dann alle Suiten (unit, smoke, versions, editor, measure, groups, section, explode, skills, fasteners, animation, fem) parallel über test/run-all.mjs (echte App, unsichtbares Fenster)+npm test # baut, dann alle Suiten (unit, smoke, versions, editor, measure, groups, section, explode, skills, fasteners, animation, fem, packages) parallel über test/run-all.mjs (echte App, unsichtbares Fenster)node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run build# soma direktdiff --git a/DECISIONS.md b/DECISIONS.mdindex b90451d..e7c26a3 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -69,3 +69,4 @@| 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 |+| 67 | Zusatzpakete | **Zusatzpakete sind der Sonderfall, und der Agent muss sich darum nicht kümmern: Braucht er ein Paket, installiert er es mit `pip install` und fertig.** Die Pakete selbst werden **nicht** mit dem Modell ausgeliefert (nicht in der ZIP), es wandert nur die Liste `requirements.txt` mit. | Präzisiert 25 (Wunsch des Nutzers). Anlass war die Frage, ob eine Umgebung je Modell die gespeicherten Modelle größer macht: nein, in der ZIP steht nur die Liste. Umsetzung in PLAN.md, Abschnitt 10 („Projektumgebung“). Abweichend vom Wortlaut von 25 pflegt nicht die App die Liste per `pip freeze`, sondern `soma build` trägt die Pakete ein, die das Modell importiert (Vorschlag, Abschnitt 11) |diff --git a/PLAN.md b/PLAN.mdindex 0f3a79c..ddeaca6 100644--- a/PLAN.md+++ b/PLAN.md@@ -59,7 +59,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner├── AGENTS.md app-verwaltet: Regeln, Konventionen, Skill-Liste, Git-Regeln, Befehle├── CLAUDE.md Verweis auf AGENTS.md (für Claude Code)├── NOTES.md Nutzer/Agent, wird nie überschrieben (Arbeitsname)-├── requirements.txt gepinnte Pakete, von der App aus `pip freeze` gepflegt+├── requirements.txt Zusatzpakete, die das Modell importiert, mit Version, von `soma build` gepflegt (E67)├── model.py fester Einstiegspunkt├── parts/ Bauteile (optional)├── inputs/ mitgebrachte Dateien (z. B. STEP), Drag-and-drop im Dateien-Tab@@ -73,6 +73,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner│ ├── 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)+│ ├── env/ Projektumgebung für Zusatzpakete (nicht in Git und ZIP, E67)│ ├── model.map.json und GLB-Cache (nicht in Git)└── .git/ .gitignore```@@ -83,7 +84,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/`, `renders/`, `.soma/anim/`, `.soma/results/` (entstehen aus dem Code neu, wandern aber mit der ZIP).+- **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) und die Projektumgebung `.soma/env/` (auch nicht in der ZIP, E67).- **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.@@ -108,7 +109,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt**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.-**Pakete (E25):** Die Basisumgebung bleibt unverändert. Jedes Projekt hat eine eigene Umgebung im Arbeitsordner (nicht in der ZIP), die die Basis sieht. Jedes Terminal startet mit **aktivierter Projektumgebung im PATH**, der Agent nutzt normales `pip`. Die App liest die Pakete per `pip freeze` aus und pflegt `requirements.txt`. Auf einem anderen Rechner wird die Umgebung daraus neu aufgebaut.+**Pakete (E25, E67):** Zusatzpakete sind der Sonderfall. Die Basisumgebung bleibt unverändert. Jedes Projekt hat eine eigene kleine Umgebung im Arbeitsordner (`.soma/env`, nicht in der ZIP), die die Basis mitbenutzt. Der Agent tippt nur `pip install <paket>`, die Terminals leiten pip dorthin. `soma build` trägt die Pakete, die das Modell importiert, in `requirements.txt` ein. Auf einem anderen Rechner installiert die App sie vor dem ersten Build. Umsetzung in Abschnitt 10.## 6. Agenten-Anbindung@@ -161,8 +162,9 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben| `model.py` fehlt, umbenannt oder verschoben | Kein Build | Einstiegspunkt in `project.json` wählbar, Hinweis || Agent exportiert selbst oder ohne Hilfsbibliothek | Kein Mapping/GLB | STEP-Fallback im Viewer, Hinweis || Mehrere oder anders benannte STEP-Dateien | Unklar, was angezeigt wird | Hauptausgabe in `project.json`, sonst Auswahlliste |-| Agent legt `.venv` an und installiert dort | Build findet Pakete nicht, `.venv` landet in ZIP/Git | `.venv`/`venv` immer ausschließen, Build-Fehler mit Hinweis auf die Projektumgebung |-| Agent nutzt anderes Python oder `pip --user` | Paketliste unvollständig | Abgleich beim Build, Warnung |+| Agent legt `.venv` an und installiert dort | Build findet Pakete nicht, `.venv` landet in ZIP/Git | **Umgesetzt:** `.venv`/`venv`/`env` nie in ZIP, Dateibaum und Watcher, der Projekt-Check meldet sie. `AGENTS.md` verbietet sie (E67) |+| Agent nutzt anderes Python oder `pip --user` | Paketliste unvollständig | **Umgesetzt (E67):** Jedes `pip` im Terminal installiert über `PIP_PYTHON` in die Projektumgebung, `--user` lehnt pip dort ab. Ein Python mit vollem Pfad am Terminal vorbei bleibt möglich, der Build scheitert dann am Import |+| Agent will ein Paket, das eine andere Version eines Basispakets braucht (z. B. `numpy<2`) | CadQuery oder OCP liefen nicht mehr | **Umgesetzt (E67):** Die Versionen der Basis sind in der `pip.ini` der Projektumgebung festgelegt, pip lehnt mit klarer Meldung ab || `AGENTS.md` verändert oder gelöscht | Regeln fehlen | Prüfsumme, im Check melden. Erneuerung nur beim Versions-Update (E36) || `.soma/` oder `project.json` gelöscht | ID und Einstellungen weg | Aus App-Daten bzw. ZIP wiederherstellen (siehe offene Punkte) || `.git` gelöscht, neu initialisiert, History umgeschrieben, anderer Branch | Zeitleiste kaputt | Zeitleiste tolerant aus `git log`, Bruch im Check melden |@@ -401,7 +403,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **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.+*Projektumgebung (E25, E67, Wunsch des Nutzers; Prüfungen in `app/test/packages.mjs`):*++- **Anlass:** Bisher landete `pip install` im Terminal nicht in einer Projektumgebung. Auf dem Entwicklungsrechner hatte die Basisumgebung (`venv-full`, mit uv angelegt) gar kein pip, `pip` im Terminal war das globale Python des Rechners.+- **Umgebung je Modell:** `soma env` (`python/soma/env.py`, von der App beim Öffnen gestartet, rund 0,5 s, danach nur, wenn sich die Basis ändert) legt `.soma/env` als venv ohne eigenes pip an, rund 0,6 MB. Eine `.pth`-Datei hängt die site-packages der Basis an, so sieht das Python der Umgebung CadQuery, soma und alle Basispakete, ohne sie zu kopieren. `soma-env.json` hält fest, zu welcher Basis sie gehört (Python, Pfade, Änderungszeit der site-packages). Eine andere Python-Version leert die Umgebung, die App installiert die Liste danach neu.+- **pip:** Die Terminals haben vorn im PATH die Umgebung (`python`), dahinter die Basis (`pip`, `soma`), und `PIP_PYTHON` zeigt auf das Python der Umgebung. Jedes `pip install`, auch `python -m pip`, installiert damit dorthin. Basispakete gelten als vorhanden (pip sieht sie über die `.pth`) und sind in der `pip.ini` der Umgebung über `base-constraints.txt` auf ihre Version festgelegt (als `file:`-URL, weil pip Pfade mit Leerzeichen dort trennen würde). Die Basisumgebung bekommt dafür pip (`requirements-phase0.txt`).+- **soma sieht die Pakete:** `soma` läuft mit dem Python der Basis, auch im vorgewärmten Prozess. Jeder Befehl mit `--project` hängt die site-packages der Projektumgebung hinten an den Suchpfad (`env.activate`), was die Basis hat, gilt also zuerst.+- **requirements.txt:** Nach einem erfolgreichen Build trägt `soma build` die Pakete der Projektumgebung ein, deren Module das Modell geladen hat, mit Version (Kopfzeilen auf Englisch für den Agenten). Ohne Zusatzpakete entsteht keine Datei. Was in der Liste steht, aber nicht installiert ist, bleibt stehen. Die Datei ändert sich nur, wenn sich ihr Inhalt ändert. Der Agent committet sie mit, weil er nach `soma build` committet.+- **Nachinstallieren:** Fehlen beim Öffnen oder nach „Wiederherstellen“ Pakete aus der Liste in der Umgebung (anderer Rechner, alter Stand), installiert die App sie mit pip der Umgebung. Pakete, die die Basis hat, überspringt sie. Builds warten so lange, die Statuszeile zeigt „Installiert Pakete …“ mit den Namen. Scheitert pip (kein Netz, Paket unbekannt), erscheint ein Hinweis mit den letzten Zeilen von pip, gebaut wird trotzdem.+- **Nicht in ZIP und Git:** `.soma/env` steht in der `.gitignore` der Vorlage, bei älteren Projekten in `.git/info/exclude` und bei den Zwischenergebnissen der App (`git.ts`), dazu in den Ausschlüssen der ZIP.++*Offen in Phase 1:* 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).@@ -415,6 +427,10 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- 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+- Projektumgebung (E67): Sie liegt im Arbeitsordner unter `.soma/env` (nicht in den App-Daten daneben), wandert also beim Sichern eines Arbeitsordners mit in `workspace-backups/`. Ist sie für eine andere Python-Version angelegt, leert `soma env` sie ohne Sicherung (die Pakete liefen dort nicht mehr)+- `requirements.txt` (E67) nennt nur Pakete, die das Modell beim Build importiert, nicht alles, was installiert ist (so passt die Liste auch nach „Wiederherstellen“ zum Stand). Pakete, die nur Animationen oder Auswertungen brauchen, fehlen darin. Ein Eintrag für ein Paket, das nicht installiert ist, bleibt stehen, auch wenn das Modell es nicht mehr braucht+- Nachinstallieren (E67) nur beim Öffnen und nach „Wiederherstellen“, nicht bei jeder Änderung der Liste. Pakete werden dabei nie entfernt. Ein Fehler erscheint als Hinweis (Toast), nicht im Projekt-Check+- `AGENTS.md` der Vorlage (E67) nennt `pip install`, verbietet eigene Umgebungen, `--user`, `uv` und ein anderes Python und sagt, was bei einem Versionskonflikt mit der Basis zu tun ist. Bestehende Projekte behalten ihre `AGENTS.md`, bis es die Erneuerung nach E36 gibt- Ä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)@@ -511,7 +527,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Build:** Auto-Build standardmäßig an oder aus, Statusanzeige, Fehlerpanel, Verhalten bei erneuter Änderung während des Builds (E20)- **Speichern/Öffnen:** mehrere Projekte parallel (bisher eines pro Fenster), Aufräumen alter Workspaces und Sicherungen, ZIP auf Netzlaufwerk (Speichern dorthin geht, Verhalten bei Verbindungsverlust ungetestet), ZIP-Größe bei langen Verläufen und vielen Markierungen (je Bild einige hundert KB) (E21)- **Git:** Einbettung und Updates des Git-Binaries (E31), Verhalten bei sehr langen Verläufen (die Leiste zeigt bisher bis zu 500 Stände), Umschreiben des Verlaufs durch den Agenten trotz Verbot (die Leiste bleibt tolerant, es gibt nur eine Meldung bei fehlendem Repository, losem HEAD oder anderem Branch)-- **Pakete:** Offline-Fall, Paketcache, Verhalten ohne Internet beim Öffnen (E25). Versionen fest pinnen (ein ungepinnter Install zieht inkompatible OCP- und multimethod-Versionen)+- **Pakete (E25, E67):** Ohne Internet scheitert das Nachinstallieren mit Hinweis, einen eigenen Paketcache gibt es nicht (pip nutzt seinen eigenen). `uv pip install` sieht die Basispakete nicht und ignoriert die `pip.ini`, es würde z. B. numpy doppelt installieren. Ein Panel „Pakete“ fehlt noch (die Liste steht in `requirements.txt`). Für die Auslieferung: Basisumgebung mit pip, eigenständiges Python statt venv (dann ginge auch `--system-site-packages` statt der `.pth`). Getestet nur unter Windows- **Plattformen:** Phase 0 lief nur unter Windows. Python-Bundling, Bibliothekspfade und Wheels auf macOS und Linux sind ungetestet (E2)- **Echte Fremddateien:** Herstellerplatinen und große Baugruppen mit Stückliste in Phase 1 testen- **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 machendiff --git a/app/README.md b/app/README.mdindex f44818f..69e635c 100644--- a/app/README.md+++ b/app/README.md@@ -5,7 +5,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.## Voraussetzungen- Node.js 22 oder neuer, Python 3.12 mit CadQuery (Basisumgebung), `soma` darin installiert.-- Entwicklung: die Umgebung aus Phase 0 (`prototype/phase0/setup_env.ps1`) und darin `uv pip install -e ../python`. Die App findet sie unter `%LOCALAPPDATA%\cadide-phase0\venv-full` oder über `SOMA_PYTHON`.+- Entwicklung: die Umgebung aus Phase 0 (`prototype/phase0/setup_env.ps1`, enthält seit E67 auch pip) und darin `uv pip install -e ../python`. Die App findet sie unter `%LOCALAPPDATA%\cadide-phase0\venv-full` oder über `SOMA_PYTHON`. Jedes Modell bekommt daneben eine kleine Projektumgebung unter `.soma/env` für Zusatzpakete (E67).- Hinter einem Proxy lädt Node den Electron-Download nur mit `NODE_USE_ENV_PROXY=1`:`NODE_USE_ENV_PROXY=1 node node_modules/electron/install.js` (falls `npm install` das Binary nicht geholt hat).@@ -26,8 +26,9 @@ npm run test:explode # Explosion: Demontage-Analyse (Richtung je Teil, Schraunpm 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, rotate/translate/moved, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (37 Prüfungen)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, ohne App Grenzwert mit Netzgenauigkeit, Teil vor Gruppe, Problemstellen, bessere Druckrichtung, kurze Schritte als eine Zeile, Modell nur einmal ausgeführt (52 Prüfungen)+npm run test:packages # Projektumgebung: klein, pip im Terminal installiert dorthin, Basispakete vorhanden und in der Version festgelegt, requirements.txt aus den Importen des Builds, nicht in Git und ZIP, alter Stand mit eigener Liste, anderer Rechner installiert vor dem Build, Paket ohne Quelle als Hinweis (26 Prüfungen, ohne Netz mit lokalen Wheels)node test/run-all.mjs fem # FEM: Kragbalken gegen die Formel, verschmolzene Teile mit Druck und Eigengewicht, Fehler (Lagerung, Bauteil, Selektor, kein fix, Code), Karte mit Lastfall und Überhöhung, Wert in Ausgangslage, soma render --result, veraltet nach Änderung der Studie, Neu berechnen, Beispiel des Skills (24 Prüfungen)-npm test # alle zwölf, vier gleichzeitig (test/run-all.mjs)+npm test # alle dreizehn, vier gleichzeitig (test/run-all.mjs)node test/run-all.mjs smoke editor # nur diese, nach npm run build```@@ -41,7 +42,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, 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/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, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `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,9 +50,9 @@ 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, `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) |+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `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)-Projektumgebung mit `pip freeze`, Paketliste, Hilfe und Optionen (die Knöpfe stehen schon ausgegraut da), Parameter-Panel (Entwurf in `design/ui-entwurf-2.html`, Bild 6), eigene Skills, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).+Panel „Pakete“, Hilfe und Optionen (die Knöpfe stehen schon ausgegraut da), Parameter-Panel (Entwurf in `design/ui-entwurf-2.html`, Bild 6), eigene Skills, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).