Skip to content

armgit / SOMA

Public Imported from GitHub
0

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

Plan, README und CLAUDE.md: paralleler Testlauf, Strg+V im Terminal

Kai-Jungsthoefel3bfb74c8cd33
diff --git a/CLAUDE.md b/CLAUDE.md
index 7a463c6..16991bb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,7 +34,8 @@ uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.ex
npm install
npm start # baut und startet
npm run typecheck
-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)
+npm test # baut, dann alle Suiten (unit, smoke, versions, editor, measure, groups, section, explode, skills, fasteners, animation) 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 direkt
"$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/soma.exe" build --project <ordner>
@@ -65,7 +66,7 @@ npm test # baut, dann test:unit, test:smoke, test:versions, test:
- **Netzlaufwerke:** Liegt das Repo auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht (schwarzes Fenster, `launch-failed` Code 18). Electron läuft deshalb aus einer lokalen Kopie (`app/scripts/electron-local.mjs`). Nie `node_modules/electron/dist/electron.exe` direkt starten. Die Python-Umgebung liegt lokal unter `%LOCALAPPDATA%\cadide-phase0\venv-full`.
- **Proxy:** Node-Downloads (Electron-Binary, dugite) brauchen `NODE_USE_ENV_PROXY=1`.
-- **Ports:** Feste Ports können von anderen Programmen belegt sein. Eigene Ports: 8791 (Phase 0), 9333 (Tests).
+- **Ports:** Feste Ports können von anderen Programmen belegt sein. Eigene Ports: 8791 (Phase 0), 9333 (Tests einzeln ohne `SOMA_TEST_PORT`; `run-all.mjs` holt freie Ports). Laufen mehrere Sessions gleichzeitig, braucht jede eigene Ports, und Testprozesse nur die eigenen beenden.
- Prozesse nur gezielt beenden (Pfad des Repos oder `soma-dev` in der Kommandozeile), nie pauschal alle `electron.exe` oder `node.exe`.
## Stolpersteine beim Bearbeiten
diff --git a/PLAN.md b/PLAN.md
index e8498a8..e6e0058 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -462,6 +462,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- 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, E57, E59): Start bei 50 % des Schiebers mit einer Lücke von 5 % der Modelldiagonale, bei 100 % dreifach, mindestens eine halbe Lücke je Teil. Das größte Teil bleibt stehen. Strahltest mit Punkten 1 ‰ der Diagonale (mindestens 0,1 mm) unter der Oberfläche, Berührung unter 0,4 % (mindestens 0,5 mm), etwa 600 Punkte je Teil. Gruppen aus `group=` zählen nicht mehr. Referenzen bleiben stehen und zählen nicht mit, ausgeblendete Teile zählen mit (sonst spränge die Explosion beim Ausblenden). Wege sind anfangs an und zeigen den eigenen Weg ab dem Elternteil. Messen und Explosion schließen sich aus, ebenso Animation und Explosion.
+- Terminal: Strg+V fügt den Text der Zwischenablage selbst ein (bracketed paste), sonst kam bei OpenCode nichts an. Ohne Text (Bild) geht `^V` an das Programm weiter
+- `npm test` läuft über `test/run-all.mjs` mit vier Suiten gleichzeitig und freien Ports (5,5 bis 7 statt 8,5 Minuten, die Animation bestimmt die Dauer und wird unter Last 2 bis 3 Mal langsamer), Watchdog dann 15 Minuten. `soma` lädt cadquery erst in Befehlen, die es brauchen (`soma --version` 0,7 statt 4,4 s)
- Rolle `reference` und ihre Standardwerte (E34)
- Hinweis beim ersten Start, dass der Agent mit den Rechten des Nutzers läuft (E29)
diff --git a/app/README.md b/app/README.md
index 0e597fe..35ad2e1 100644
--- a/app/README.md
+++ b/app/README.md
@@ -26,9 +26,12 @@ npm run test:explode # Explosion: Demontage-Analyse (Richtung je Teil, Schrau
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, 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 test # alle elf
+npm test # alle elf, vier gleichzeitig (test/run-all.mjs)
+node test/run-all.mjs smoke editor # nur diese, nach npm run build
```
+`npm test` startet die Suiten parallel über `test/run-all.mjs`, längste zuerst. Jede bekommt einen freien Port vom System (`SOMA_TEST_PORT`), damit sich parallele Läufe nicht gegenseitig die App fernsteuern, und gibt ihre Ausgabe am Stück aus, sobald sie fertig ist. Am Ende steht eine Übersicht mit Dauer und Prüfungen je Suite. `SOMA_TEST_JOBS=1` lässt sie nacheinander laufen, `SOMA_TEST_WATCHDOG_S` setzt den Watchdog je Suite (im Runner 900 s, sonst 360 s), `SOMA_TEST_TIMES=1` schreibt vor jede Prüfung die Sekunden seit Start. Eine einzelne Testdatei direkt (`node test/smoke.mjs`) nimmt Port 9333, wenn `SOMA_TEST_PORT` nicht gesetzt ist.
+
`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.
**Windows und Netzlaufwerk:** Liegt `node_modules` auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht (`launch-failed`, Code 18, schwarzes Fenster). `npm start` und der Test nutzen deshalb automatisch eine lokale Kopie von Electron unter `%LOCALAPPDATA%\soma-dev\` (`scripts/electron-local.mjs`, einmalig rund 370 MB). Die App selbst darf auf dem Netzlaufwerk liegen. Eine installierte App muss lokal liegen, sonst zeigt sie eine Fehlermeldung.