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

Entscheidung E64, Plan und README: allgemeine Verbesserungen aus dem Agent-Test

Kai-Jungsthoefel788b3c4fcc48
diff --git a/DECISIONS.md b/DECISIONS.md
index d65e3ac..9defcc7 100644
--- a/DECISIONS.md
+++ b/DECISIONS.md
@@ -64,3 +64,4 @@
| 59 | Explosion mit Demontage-Analyse | **Die Explosion zerlegt das Modell so, wie man es auseinanderbauen würde**: Jedes Teil kommt in der Richtung heraus, in der es frei ist, in der Reihenfolge des Auseinanderbaus, und wandert mit dem Teil, an dem es hängt. Teile, die sich gegenseitig sperren, kommen als Baugruppe heraus und werden danach in sich zerlegt. Weiterhin per Skript ohne KI | Ersetzt die Regel aus 57 (eine Achse für alles, Gruppen als Block). Auslegung (nicht ausdrücklich bestätigt): Strahltest auf den Netzen im Viewer mit `three-mesh-bvh`, Kandidaten ±X/±Y/±Z und Achsen der Normteile, Normteile dürfen entlang ihrer Achse durch ihr Gewinde, die Richtungswahl der Karte gilt nur noch als Vorzug |
| 60 | Explosion: schräge Richtungen, Schritt für Schritt | **Teile können auch schräg herauskommen**, entlang der Achsen ihrer Zylinder oder der Normalen ihrer großen Flächen, und **die Explosion lässt sich Schritt für Schritt abspielen**, in der Reihenfolge des Auseinanderbaus, die auch an den Agenten gehen kann | Ergänzt 59 (dort als Schritte B und C vorgeschlagen). Auslegung (nicht ausdrücklich bestätigt): Der Mesher schreibt Normale und Achse in die Flächendaten, eine schräge Richtung nur für das Teil, zu dessen Form sie gehört, höchstens 12 zusätzliche, ein Schritt dauert 0,7 s, der Schieber beendet das Abspielen |
| 61 | Explosion ohne Richtungsknöpfe | **Die Knöpfe Auto/X/Y/Z der Explosion entfallen** | Seit der Demontage-Analyse (59, 60) wirkten sie nur noch als Vorzug bei Gleichstand. Die Vorzugsachse bestimmt die App selbst (Achse der meisten Normteile, sonst die, entlang der Teile aufeinanderliegen, sonst Z) |
+| 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 |
diff --git a/PLAN.md b/PLAN.md
index f553a00..8bd47b0 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -339,7 +339,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **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.
+- **Prüfen:** `soma anim info` beschreibt den Ablauf als Text mit Zeiten. `soma anim check` prüft im Abstand von 0,1 s bewegte Teile gegen alle anderen: Überschneidung und Mindestabstand (`--gap`). Seit E64 auf den Dreiecksnetzen, Berührung und Spiel aus der Lage im Modell gelten als gewollt (siehe unten).
- **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.
@@ -350,6 +350,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **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.
+*Allgemeine Verbesserungen aus dem Agent-Test am Motor (E64, Wunsch des Nutzers; Prüfungen in `unit.mjs`, `fasteners.mjs`, `animation.mjs`):*
+
+- **Anlass:** Ein Agent baute einen druckbaren Einzylindermotor, animierte und prüfte ihn. Die Analyse fand zwei echte Fehler, Mechanismen waren umständlich, `soma anim check` lief über 25 Minuten. Der Nutzer wollte keine Lösungen nur für dieses Beispiel und keine neuen Begriffe für den Agenten.
+- **Analyse:** Werte innerhalb der Netzgenauigkeit am Grenzwert (Winkel ±0,5°, Längen ± Netztoleranz) zählen als genau am Grenzwert, nicht kritisch, die Zusammenfassung nennt ihre Fläche (vorher waren 3,7 von 4,1 cm² eines 45°-Dachs „kritisch“). Ein Bauteil geht vor einer gleichnamigen Gruppe, wie in `soma.anim`, `"Gruppe/"` meint die Gruppe, mit Hinweis. Je Teil bis zu drei Problemstellen mit Fläche, Ausdehnung und Lage, gleichartige (Zahnspitzen, symmetrische Stellen) in einer Zeile. Beim Überhang ein Hinweis, wenn eine andere Achse deutlich weniger hat („mit --up -y nur 0.40 cm²“). Ein Strahl, der durch eine Ecke des Netzes rutscht, wird zweimal leicht gekippt wiederholt (Fehlalarm „offene Fläche“). Die Unterteilung halbiert nur noch die längste Kante, die Ergebnisse am Motor schrumpften von 69 auf 33 MB.
+- **Kollisionsprüfung:** Der genaue Abstand der B-Rep-Körper (BRepExtrema) brauchte bei Zahnrädern 2,4 s je Paar und Zeitpunkt. Jetzt vorzeichenbehaftete Abstände der Ecken der unterteilten Netze (VTK), vorgefiltert über einen k-d-Baum, nur fragliche Berührungen mit Schnittmenge der B-Rep-Körper. Am Motor 64 s statt über 25 Minuten. Berührung und Spiel aus der Lage im Modell gelten als gewollt, gemeldet wird nur, was in der Bewegung schlechter wird (tieferes Eindringen, engeres Spiel). Endlagen nur von Bewegungen ab 0,5 s zusätzlich, nicht jede Grenze vieler kurzer Schritte. `vtkCollisionDetectionFilter` zusammen mit `vtkImplicitPolyDataDistance` stürzte gelegentlich ab (Zugriffsverletzung, VTK 9.6) und ist deshalb nicht im Einsatz.
+- **Animation:** Die Animationsdatei bekommt das eben ausgeführte Modell als Modul `model`, `from model import ...` baut es nicht noch einmal. `soma anim info` fasst lückenlose kurze Schritte desselben Gelenks zusammen („Kurbelwelle: 0 -> 720 Grad (60 Schritte)“, am Motor 60 statt 1750 Zeilen). Gekoppelte Bewegungen bleiben eine Schleife mit `play()`, der Skill sagt, dass das in Ordnung ist.
+- **Fortschritt:** Lange Befehle (`soma anim check`, `soma analyze`) melden nach 5 s im Fehlerkanal den Stand mit geschätzter Restzeit, höchstens alle 15 s.
+- **Normteile:** `rotate()`, `translate()` und `moved()` wie bei CadQuery-Formen liefern eine bewegte Kopie mit Bezeichnung und Bohrungen. Vorher legte der Agent jede Schraube für eine andere Stellung neu an.
+- **Doku:** eine Regel für Maße: oben in `model.py`, mit `parts/` in `parts/params.py` (`AGENTS.md`, Skills „CadQuery“, „Toleranzen“, „3D-Druck“ sagten vorher nur `model.py`).
+- **Speichern:** Snapshot und ZIP nehmen `.soma/anim/` und `.soma/results/` nicht mehr mit, der Verlauf auch `renders/` nicht. Ältere Projekte bekommen die Einträge beim Öffnen in `.git/info/exclude` (gilt auch für Commits des Agenten, die `.gitignore` bleibt unberührt), der nächste Snapshot nimmt schon committete Zwischenergebnisse aus dem Index. Bereits gepackte Dateien (Git-Objekte, Bilder, Videos) legt die ZIP nur ab. Am Motor: ZIP 95 statt 154 MB, Packen 0,7 statt 5,2 s, dazu entfiel das Einchecken von bis zu 214 MB je Snapshot. Der Knopf zeigt sofort „Speichert …“ (E62).
+
*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).
@@ -363,7 +374,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- 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“)
- 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`
+- 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
@@ -423,6 +435,10 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- 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
+- Analyse (E64): genau am Grenzwert heißt ±0,5° bzw. ± Netztoleranz. Bis zu drei Problemstellen je Teil, gleichartig bei 15 % gleicher Fläche und Ausdehnung. Hinweis auf eine andere Druckrichtung, wenn sie höchstens halb so viel und mindestens 10 mm² weniger Überhang hat
+- Kollisionsprüfung (E64): genau auf die doppelte Netztoleranz, gemessen an den Ecken der auf 1 % der Modelldiagonale unterteilten Netze. Eine Kollision ganz ohne eingedrungene Ecke (dünne Platte quer durch eine Welle, schmaler als die Unterteilung) bleibt unentdeckt. Gleiche Relativlagen werden nur einmal gerechnet
+- `soma anim info` (E64): ab drei lückenlosen Schritten unter 0,5 s desselben Gelenks eine Zeile, Untertitel, Pausen und lange Bewegungen trennen
+- Fortschritt (E64) erst nach 5 s, höchstens alle 15 s, im Fehlerkanal
- 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.
@@ -452,7 +468,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?
+- **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? Zurückgestellt (E64): gekoppelte Gelenke (ein Wert treibt mehrere Gelenke, wie `ValueTracker` in manim) sowie Zahnräder, Lager und Federn als Bausteine, bis Mechanik öfter vorkommt. Analyseergebnisse sind noch rund 30 MB je Auswertung (drei eigene Ecken mit Normale je Dreieck), kleiner, wenn der Viewer flache Normalen selbst rechnet
## 12. Größte Risiken
diff --git a/app/README.md b/app/README.md
index bcced53..9842a03 100644
--- a/app/README.md
+++ b/app/README.md
@@ -15,7 +15,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.
npm install
npm start # baut und startet
npm 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 (47 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 (51 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)
@@ -24,8 +24,8 @@ npm run test:groups # Gruppen: eigene und importierte (STEP-Baugruppe), Baum
npm run test:section # Schnitt: X/Y/Z und an Fläche, Eingabe der Lage, Seite wechseln, gefüllte und schraffierte Schnittfläche, Klicks durch den Schnitt, Wandstärke an der Kontur messen, neuer Build (26 Prüfungen)
npm run test:explode # Explosion: Demontage-Analyse (Richtung je Teil, Schrauben durch ihr Kernloch, Stift schräg aus seiner Bohrung, Baugruppe mit eingeschlossener Mutter, Elternteile), gleiche Lücke, Reihenfolge bei 100 %, Abspielen Schritt für Schritt, Reihenfolge an den Agenten, Auswahl in Einbaulage, Messen setzt zusammen, Schnitt dazu, neuer Build (39 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 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 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
```
@@ -45,7 +45,7 @@ npm test # alle elf
| `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`, `render.py` Auftrag an die App für `soma render`, `gltf.py` GLB-Schreiber) |
+| `../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, `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)