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: Normteile (E48)
Kai-Jungsthoefelc8d6a6324251
diff --git a/CLAUDE.md b/CLAUDE.mdindex e042430..f7946db 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -17,7 +17,7 @@ Eine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten| `app/` | Electron-App. `src/main/` Hauptprozess (`projects.ts` Speichern/Öffnen/Verlauf/Export, `git.ts`, `zip.ts`, `build.ts`, `measure.ts`, `skills.ts`, `workspace.ts`, `terminals.ts`, `files.ts`), `src/preload/`, `src/renderer/` (`main.ts` Verdrahtung, `viewer.ts`, `viewcube.ts`, `sectiontool.ts`, `skills.ts`, `markup.ts`, `measuretool.ts`, `parts.ts`, `code.ts`, `filetree.ts`, `versions.ts`, `terminals.ts`, `ui.ts`, `icons.ts`), `src/shared/types.ts` (IPC-Vertrag), `src/shared/editable.ts`, `resources/template/` (Vorlage für Nutzerprojekte inkl. `AGENTS.md`), `resources/skills/` (mitgelieferte Skills), `resources/icon.*` (App-Icon, erzeugt mit `scripts/make-icon.py`), `test/` || `design/ui-entwurf.html` | Freigegebener Oberflächenentwurf (E38), im Browser öffnen. Maßstab für Aufbau, Farben und Texte der Oberfläche || `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |-| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=`), `import_step`, `import_assembly`, `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`) |+| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`) || `prototype/phase0/` | Abgeschlossener technischer Prototyp mit `ERGEBNISSE.md`. Nur noch Referenz |Details: `app/README.md`.@@ -33,7 +33,7 @@ uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exnpm installnpm start # baut und startetnpm run typecheck-npm test # baut, dann test:unit, test:smoke, test:versions, test:editor, test:measure, test:groups, test:section und test:skills (echte App, unsichtbares Fenster)+npm test # baut, dann test:unit, test:smoke, test:versions, test:editor, test:measure, test:groups, test:section, test:skills und test:fasteners (echte App, unsichtbares Fenster)# soma direkt"$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/soma.exe" build --project <ordner>diff --git a/DECISIONS.md b/DECISIONS.mdindex 6abb5c2..5fb1735 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -51,3 +51,4 @@| 45 | Skills: Inhalte | **Mitgeliefert wird ein Satz allgemeiner Skills in drei Gruppen.** Arbeitsweise: Konstruktionsablauf, Sauber modellieren (CadQuery). Fertigungsverfahren: 3D-Druck FDM, 3D-Druck Harz und Pulver, CNC-Fräsen und Drehen, Laserschneiden, Blech. Konstruktionswissen: Toleranzen und Passungen, Verbindungen, Normteile, Festigkeit und Steifigkeit, Baugruppen und Bewegung. **Anwendungs-Skills** (Gehäusebau, Halterungen, Griffe …) werden vorerst nicht ausgebaut. Die Skills sind **kurz und knapp**, damit auch kleinere Modelle sie befolgen | Präzisiert 17. Gehäusebau bleibt, wie er ist. Auslegung (nicht ausdrücklich bestätigt): Werte sind Richtwerte, jeder Wert steht möglichst nur in einem Skill, ein Verfahrens-Skill geht den allgemeinen Toleranzen vor || 46 | Skills: Kategorien und Standard | **Jeder Skill nennt seine Kategorie**, das Panel zeigt die Skills unter Überschriften (Arbeitsweise, Fertigungsverfahren, Konstruktionswissen, Anwendungen). **Ob ein Skill bei neuen Modellen eingeschaltet ist, lässt sich einstellen** | Präzisiert 17 und 45. Auslegung (nicht ausdrücklich bestätigt): Der Kopf des Skills gibt den Standard vor (`default: on`, ab Werk Konstruktionsablauf und Sauber modellieren), der Nutzer stellt ihn je Skill für die ganze App um. Gilt nur für neu angelegte Modelle, Einstellungswerte gehören nicht dazu || 47 | Skills: Gehäusebau | **Der Skill „Gehäusebau“ wird nicht mehr mitgeliefert** | Ersetzt den Teil von 45, nach dem er bleibt. Anwendungs-Skills gibt es damit vorerst keine. Projekte, die ihn eingeschaltet haben, behalten ihre Kopie (gilt weiter, die Karte meldet, dass die App ihn nicht mitbringt) |+| 48 | Normteile | **Eigene Bibliothek `soma.fasteners`** für Schrauben, Muttern, Scheiben und Gewindeeinsätze, gebaut auf den **Maßtabellen von bd_warehouse** (Apache 2.0), **ohne Gewinde**. Der Agent soll sie **leicht positionieren** können. **Neue Rolle `hardware` (Zukaufteil):** deckend, in der STEP bei ihrer Gruppe, von `soma export --all` übersprungen. **Die Anleitung für den Agenten steht im Skill „Normteile“, nicht in `AGENTS.md`, und der Skill ist bei neuen Modellen an.** Danach sollen Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile folgen | Ergänzt 34 (Rollen) und 46: Ab Werk an sind damit Konstruktionsablauf, Sauber modellieren und Normteile. Auslegung (nicht ausdrücklich bestätigt): Lage über den Auflagepunkt `at` und die Richtung ins Material, `sunk` für versenkte Köpfe, `on=` sucht die Auflage. Nur Normlängen, Sonderlängen ausdrücklich. Normteile sind ohne Angabe `hardware`. Die Tabellen liegen unverändert in `python/soma/data/fasteners/`, der Code ist eigener |diff --git a/PLAN.md b/PLAN.mdindex f530297..8a36fc6 100644--- a/PLAN.md+++ b/PLAN.md@@ -92,7 +92,8 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt| Baustein | Aufgabe ||---|---|-| `add_part("Deckel", obj, role=...)` | Bauteil registrieren (verbindlich, E10). Merkt sich Datei und Zeile, schreibt Namen und Farbe in den STEP-Baum, Positionen und Anzeigename in `model.map.json`. **Namen in der STEP nur ASCII** (Umlaute werden umgeschrieben, sonst zerstört der Export sie), Namen müssen eindeutig sein. Rolle `reference` ist eine Markierung (halbtransparent, eigener Ast, nicht in `--all`) |+| `add_part("Deckel", obj, role=...)` | Bauteil registrieren (verbindlich, E10). Merkt sich Datei und Zeile, schreibt Namen und Farbe in den STEP-Baum, Positionen und Anzeigename in `model.map.json`. **Namen in der STEP nur ASCII** (Umlaute werden umgeschrieben, sonst zerstört der Export sie), Namen müssen eindeutig sein. Rolle `reference` ist eine Markierung (halbtransparent, eigener Ast, nicht in `--all`), Rolle `hardware` ein Zukaufteil (deckend, in der STEP bei seiner Gruppe, nicht in `--all`, E48) |+| `soma.fasteners` | Normteile (E48): `Screw`, `Nut`, `Washer`, `HeatSetInsert` ohne Gewinde, mit Maßen aus den Tabellen von bd_warehouse, Lage über Auflagepunkt und Richtung, passende Bohrungen als Werkzeuge für `cut()` || `soma build` | Baut STEP, GLB und Mapping in einem Lauf. Gemeinsam für App und Agent. Führt vorab einen kurzen Check aus und gibt Warnungen mit aus (E20) || `soma check` | Prüft die Projektstruktur und **meldet nur**, mit konkreten Handlungshinweisen, auch maschinenlesbar. Kein `--fix`. Der Agent repariert nach eigenem Ermessen (E28) || `soma export <Bauteil\|--all> --format …` | Einzelexport auf Basis der registrierten Bauteile, auch per Kontextmenü im Tree. Formate (in Phase 0 geprüft): STEP, STL, 3MF, AMF, BREP, IGES, OBJ, VRML, GLB/GLTF. 2D: DXF (Schnitt), SVG (Projektion) (E34) |@@ -272,7 +273,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Schalten oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz.- **Ansehen:** Die Kopie öffnet sich im Code-Panel, nur lesbar („Kopie eines Skills“).- **Kategorien (E46, Wunsch des Nutzers):** `category` im Kopf ordnet einen Skill unter eine Überschrift im Panel: Arbeitsweise, Fertigungsverfahren, Konstruktionswissen. Eine Kategorie steht dort, wo ihr erster Skill laut `order` steht, Skills ohne Kategorie (etwa aus einer neueren App) unter „Weitere“ am Ende.-- **Skills für neue Modelle (E46, Wunsch des Nutzers):** `default: on` im Kopf schaltet einen Skill bei neuen Modellen ein, mitgeliefert für Konstruktionsablauf und Sauber modellieren. Im aufgeklappten Skill stellt der Schalter „Bei neuen Modellen einschalten“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Die Karte sagt „Bei neuen Modellen an“. Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.+- **Skills für neue Modelle (E46, Wunsch des Nutzers):** `default: on` im Kopf schaltet einen Skill bei neuen Modellen ein, mitgeliefert für Konstruktionsablauf, Sauber modellieren und Normteile (E48, Wunsch des Nutzers). Im aufgeklappten Skill stellt der Schalter „Bei neuen Modellen einschalten“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Die Karte sagt „Bei neuen Modellen an“. Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.- **Robustheit (E28):** Nichts wird still ersetzt: Weicht die Kopie im Projekt von der mitgelieferten Fassung ab (vom Agenten geändert, ältere App), meldet die Karte das, und vor dem Überschreiben oder Entfernen kommt sie nach `workspace-backups/<id>-skills/`. Fehlt die Datei eines aktiven Skills, nennt das die Karte und der Projekt-Check, angelegt wird nichts. Fehlt `AGENTS.md`, geht der Skill trotzdem an, mit Warnung, die Datei wird nicht neu erzeugt. Nennt `AGENTS.md` einen aktiven Skill nicht (etwa nach dem Zurückholen einer alten Fassung), steht das in der Karte. Skills, die nur im Projekt liegen (aus einer neueren App), bleiben gültig.*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 2), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.@@ -288,15 +289,25 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben| Blech | Biegungen als Rundungen innen R und außen R + T, Schenkel, Abstände, Freistiche, Abwicklungslänge | Material, Dicke, Innenradius, K-Faktor || Toleranzen und Passungen | gekürzt: Der Laser-Teil und seine Einstellung wanderten zum Laserschneiden, die Kopfdurchmesser zu den Normteilen. Ein aktiver Verfahrens-Skill geht vor | Fertigung, Durchgangslöcher, Mindestabstand || Verbindungen | Schrauben (Einschraubtiefe, Randabstand, Werkzeug, Längen), Schnapphaken, Scharniere, Stifte, Magnete, Kleben | Bevorzugte Schraube |-| Normteile | Maße von Schrauben, Muttern, Scheiben, Kugellagern, Stiften, Profilen, Mutternfalle mit `polygon()` | keine |+| Normteile | Schrauben, Muttern, Scheiben und Einsätze über `soma.fasteners` (E48), Mutternfallen mit `trap()`, Maße von Kugellagern, Stiften, Profilen | keine || Festigkeit und Steifigkeit | Gestaltungsregeln, Biegebalken als Überschlag, Werkstoffwerte, Gewicht | Sicherheitsfaktor || Baugruppen und Bewegung | gemeinsame Bezüge, Schnittstellen einmal definiert, Montierbarkeit, bewegte Teile über den Weg prüfen, Stückliste | Mindestabstand bewegter Teile |Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung).+*Normteile (E48, Wunsch des Nutzers; 35 Prüfungen in `app/test/fasteners.mjs`):*++- **Bibliothek `soma.fasteners`:** Schrauben ISO 4762, ISO 7380, ISO 10642, ISO 4017, ISO 4014, DIN 931 und ISO 4026, Muttern ISO 4032, ISO 4033, ISO 4035 und DIN 557, Scheiben ISO 7089, ISO 7091 und ISO 7093, Gewindeeinsätze von ruthex (Standard), CNC Kitchen, McMaster-Carr, Hilitchi und AE-SamZhihui. Vereinfacht ohne Gewinde: Köpfe mit Innensechskant, Sechskant mit 30°-Fase, Schaft mit Fase am Ende. Die Maße kommen aus 13 CSV-Tabellen von bd_warehouse, unverändert in `python/soma/data/fasteners/` mit Lizenz und Herkunftsvermerk (`QUELLE.md`). Gleiche Teile werden einmal gebaut und nur verschoben, 60 Schrauben brauchen deutlich unter einer Sekunde.+- **Lage:** `at` ist der Punkt auf der Achse, an dem das Teil aufliegt (Kopfunterseite, Stirnseite von Mutter und Scheibe, Oberseite bei Senkschraube, Gewindestift und Einsatz). `direction` zeigt von dort ins Material, Standard `-Z`. `at` darf auch eine `cq.Location` oder eine Workplane auf einer Fläche sein, dann gilt deren Normale. `on=teil` sucht die Auflage selbst (Schnitt der Geraden mit dem Teil). `sunk=True` versenkt bündig, `sunk=0.5` tiefer, `angle` dreht um die Achse. `seat`, `outer`, `tip` und `point(d)` sind Punkte auf der Achse, so stapelt der Agent Scheibe und Mutter am anderen Ende.+- **Bohrungen als Werkzeuge für `cut()`:** `clearance_hole(fit, depth, oversize, recess)` nach ISO 273 (fein, mittel, grob), bei versenktem Kopf mit Senkung (Kopf plus Spiel des Lochs), bei Senkschrauben mit 90°-Kegel. `tap_hole()` ist das Kernloch, `HeatSetInsert.hole()` die Bohrung nach der Tabelle, 1 mm tiefer als der Einsatz. `Nut.trap(clearance, slot, slot_length)` ist die Tasche für Sechskant- und Vierkantmuttern, mit Schlitz zum seitlichen Einschieben, so breit wie die Mutter quer zum Schlitz. Alle Werkzeuge ragen 1 mm über die Oberfläche, damit `cut()` keine deckungsgleichen Flächen bekommt.+- **Längen:** nur Normlängen der Tabelle (`lengths()`, `pick_length(min, max)`), sonst ein Fehler mit der Liste. Sonderlängen mit `check_length=False`.+- **Rolle `hardware`:** `add_part` gibt Normteilen ohne Angabe diese Rolle und ihre Farbe (Stahlgrau, Einsätze Messing). Sie stehen deckend bei den eigenen Teilen im Bauteilbaum, die Auswahl zeigt „(Zukaufteil)“, in `output/model.step` stehen sie bei ihrer Gruppe. `soma export --all` überspringt sie und sagt das, einzeln lassen sie sich exportieren. Die App brauchte dafür nur den Zusatz in der Auswahl.+- **Fehler erklärt (Abschnitt 9):** unbekannte Norm mit Liste, alte DIN-Namen mit dem ISO-Nachfolger, fehlende Größe mit den vorhandenen, fehlender Punkt, Gerade ohne Treffer, mehrdeutiger Einsatz. Für die M10-Einsätze nennt die Tabelle als Bohrer „M14“, größer als der Einsatz: `soma` lehnt sie ab, statt eine unbrauchbare Bohrung zu liefern.+- **Für den Agenten (Wunsch des Nutzers):** Die Anleitung steht im Skill „Normteile“, nicht in `AGENTS.md`. Der Skill ist bei neuen Modellen an. Er enthält Beispiel, Lage, Normen, Längen, Mutternfallen, Rolle. Seine Schraubentabelle ist entfallen (nur eine Quelle für die Maße). Der Test führt den Codeblock des Skills aus. „Verbindungen“ nennt `pick_length()`.+*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:** Versions-Schieber, `soma check` und Projekt-Check, MCP-Server. **Später:** Volumen/Gewicht, Versionsvergleich, Explosionsansicht, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).+**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, Explosionsansicht, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).## 11. Offene Punkte@@ -339,11 +350,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Skill-Inhalte (E45): Namen und Kennungen der neuen Skills, die Namen der Kategorien (E46), Skills ohne Einstellungen (Sauber modellieren, Normteile). Querverweise nur allgemein („ein aktiver Verfahrens-Skill“), weil jede Kombination möglich ist- Skills, Laser und Blech: `soma export --format dxf` schneidet das Teil in halber Höhe parallel zu XY. Stehende Platten und Abwicklungen bekommen deshalb einen Schalter `FLAT` in `model.py`, der sie flach auf XY registriert. Ein Export, der die Platte selbst flach legt, wäre bequemer (offen)- Skills, Toleranzen: Die Einstellung „Spiel für Laserteile“ ist entfallen (jetzt „Schnittbreite“ im Laser-Skill). In `project.json` gespeicherte alte Werte werden still übergangen, wie jede unbekannte Einstellung-- Skills für neue Modelle (E46): ab Werk an sind nur die beiden Skills der Arbeitsweise. Die Vorgabe gilt für die ganze App (nicht je Nutzerprofil oder Projektvorlage), nur für „Neu“ und den ersten Start, nicht für geöffnete ZIPs. Einstellungswerte gehören nicht dazu, neue Modelle starten mit den Standardwerten. Der Schalter steht im aufgeklappten Skill, eine Übersicht aller Vorgaben gibt es nicht+- Skills für neue Modelle (E46): ab Werk an sind die beiden Skills der Arbeitsweise und die Normteile (E48). Die Vorgabe gilt für die ganze App (nicht je Nutzerprofil oder Projektvorlage), nur für „Neu“ und den ersten Start, nicht für geöffnete ZIPs. Einstellungswerte gehören nicht dazu, neue Modelle starten mit den Standardwerten. Der Schalter steht im aufgeklappten Skill, eine Übersicht aller Vorgaben gibt es nicht- Skills, 3D-Druck: Die Überhangsuche im Skill prüft nur ebene Flächen. Gekrümmte Flächen (waagerechte Bohrungen, Rundungen unten) prüft der Agent im Viewer- Skills: Die Kopie im Projekt bleibt beim Update der App, wie sie ist (gilt für das Modell, wandert mit). Aus- und Einschalten übernimmt die neue Fassung, die alte kommt in die Sicherung. Einen eigenen Knopf „Aktualisieren“ gibt es nicht- Skills: Nach dem Schalten fügt die App nichts von selbst in die Eingabe des Agenten ein, nur auf „An Agent geben“- Skill-Einstellungen: nur Zahlen mit Bereich und Auswahllisten, kein freier Text. Einstellbar nur mitgelieferte Skills (nur sie haben den Text mit Platzhaltern). Die Werte gelten je Modell, es gibt keine App-weiten Vorgaben (etwa „mein Drucker“). Welche Werte es gibt und ihre Bereiche sind Entwürfe+- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen deutsch. Lage über Auflagepunkt und Richtung ins Material. Senkung = Kopf plus Spiel des gewählten Durchgangslochs, Tiefe genau die Kopfhöhe (nicht DIN 974, der Skill „Toleranzen“ nennt für Zylinderköpfe etwas größere Senkungen, mit `recess=` einstellbar). Kernloch aus der Spalte „Soft“ (Regelwerte). Einsätze: Standard ruthex, Bohrung 1 mm tiefer als der Einsatz. Farben Stahlgrau und Messing+- Normteile: Alte DIN-Namen (DIN 912, DIN 933 …) sind ein Fehler mit Hinweis auf die ISO-Norm, weil manche Maße abweichen. Nur Regelgewinde. Muttern haben eine Bohrung im Nenndurchmesser (sie berühren den Schaft, überschneiden ihn nicht). Ein Einsatz ist dicker als seine Bohrung, Kollisionsprüfungen mit seinem Teil lässt der Agent aus (steht im Skill „Normteile“)+- Rolle `hardware` (E48): Zukaufteile haben keinen eigenen Abschnitt im Bauteilbaum, sie unterscheiden sich durch Farbe und den Zusatz „(Zukaufteil)“ in der Auswahl. `soma export --all` nennt die Zahl der übersprungenen Teile- 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.mdindex 37513e0..9e88e17 100644--- a/app/README.md+++ b/app/README.md@@ -23,7 +23,8 @@ npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebennpm 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)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:skills # Skills: Panel, Ein-/Ausschalten (Kopie, project.json, AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, An Agent geben, Sicherung geänderter Kopien, fehlende Dateien nur gemeldet, Snapshot und ZIP, Kategorien, Skills für neue Modelle (41 Prüfungen)-npm test # alle acht+npm run test:fasteners # Normteile: Maße aus den Tabellen, Lage (at, direction, on, sunk), Bohrungen und Mutternfallen ohne Überschneidung, Einsätze, Fehlermeldungen, Rolle hardware, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (35 Prüfungen)+npm test # alle neun````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.@@ -41,7 +42,7 @@ npm test # alle acht| `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` (englisch, für `AGENTS.md`), `order`, `default: on` (bei neuen Modellen an) 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) |+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`) || `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `skills.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)