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 und Changelog: Zeichnungen nach dem ersten Agent-Test

Kai-Jungsthoefel871b916a4fc4
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5ab0d1c..628cc12 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,7 @@ eigenen Abschnitt mit Datum und Git-Tag.
### Neu
-- Technische Zeichnungen: Der Agent beschreibt eine Zeichnung in `drawings/*.py` (`soma.drawing`) mit Ansichten, Schnitten, Einzelheiten, Maßen, Texten und Stückliste, `soma drawing build` schreibt PDF und DXF nach `output/drawings/` und ein Bild, mit dem der Agent sein Ergebnis prüft. Die Maße werden immer am Modell gemessen, eine Prüfung meldet Überschneidungen, Maße neben Kanten und getippte Zahlen. Dazu der Skill „Technical drawings“ mit den Regeln nach ISO (E76).
+- Technische Zeichnungen: Der Agent beschreibt eine Zeichnung in `drawings/*.py` (`soma.drawing`) mit Ansichten, Schnitten, Einzelheiten, Maßen, Texten und Stückliste, `soma drawing build` schreibt PDF und DXF nach `output/drawings/`, alle Blätter zusammen nach `output/drawings.pdf`, und ein Bild, mit dem der Agent sein Ergebnis prüft. Lange Teile lassen sich unterbrochen zeichnen, Schnitte auch mit geknicktem Schnittverlauf. Die Maße werden immer am Modell gemessen, eine Prüfung meldet Überschneidungen von Texten mit Kanten, Maßen und Stückliste, zu lange Einträge im Schriftfeld, Maße neben Kanten und getippte Zahlen. Dazu der Skill „Technical drawings“ mit den Regeln nach ISO (E76).
- Skill „Parametric models“, bei neuen Modellen immer an: Der Agent legt erst fest, was die Größe bestimmt und was beim Ändern stehen bleibt, gibt wenige unabhängige Werte als Parameter frei, leitet den Rest daraus ab und baut das Modell an den Grenzen jedes Bereichs zur Probe. Einstellbar sind die Höchstzahl der Parameter und der Umfang dieser Prüfung (E77).
### Geändert
diff --git a/PLAN.md b/PLAN.md
index 2cf9496..c4bd94d 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -469,13 +469,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
*Technische Zeichnungen (E76, Wunsch des Nutzers; Prüfungen in `app/test/drawing.mjs`):*
- **Grundidee:** Der Agent zeichnet selbst, soma liefert Werkzeuge statt automatischer Ansichten und Maße. Eine Zeichnung ist eine Python-Datei `drawings/*.py` mit `soma.drawing.Sheet`, mehrere Blätter je Datei möglich. Wie bei den Animationen bekommt sie das eben gebaute Modell als Modul `model`.
-- **Bausteine (`python/soma/drawing.py`):** Blatt A4 bis A0 oder frei, Rahmen und Mittenmarken nach ISO 5457, Schriftfeld nach ISO 7200 (Felder englisch oder deutsch, Symbol der Projektionsmethode 1 oder 3), beides abschaltbar. `view()` projiziert ein Bauteil, eine Gruppe, mehrere, alle oder eine eigene CadQuery-Form in eine der sechs Ansichten, iso oder eine beliebige Richtung, mit eigenem Maßstab, `origin`, `up`, verdeckten Kanten, Tangentenkanten und Stil „phantom“. `section()` schneidet an einer Ebene oder mit einem beliebigen Körper (Halbschnitt, Ausbruch) und schraffiert die Schnittflächen je Teil im Wechsel 45/135°, Teile in `unhatched` bleiben ungeschnitten, mit `parent` entsteht der Schnittverlauf mit Pfeilen und Buchstaben. `detail()` schneidet einen Kreis aus einer Ansicht und vergrößert ihn. Maße an Modellpunkten (`dim` waagerecht, senkrecht, schräg, `diameter`, `radius`, `angle`), Werte immer gemessen, `<>` für den Messwert im Text, Toleranzen. Dazu Mittellinien, Mittenkreuze, Hinweislinien, Texte, Tabellen und `sh.msp` für alles Weitere direkt mit ezdxf.
+- **Bausteine (`python/soma/drawing.py`):** Blatt A4 bis A0 oder frei, Rahmen und Mittenmarken nach ISO 5457, Schriftfeld nach ISO 7200 (Felder englisch oder deutsch, Symbol der Projektionsmethode 1 oder 3), beides abschaltbar. `view()` projiziert ein Bauteil, eine Gruppe, mehrere, alle oder eine eigene CadQuery-Form in eine der sechs Ansichten, iso oder eine beliebige Richtung, mit eigenem Maßstab, `origin`, `up`, verdeckten Kanten, Tangentenkanten und Stil „phantom“. `section()` schneidet an einer Ebene oder mit einem beliebigen Körper (Halbschnitt, Ausbruch) und schraffiert die Schnittflächen je Teil im Wechsel 45/135°, Teile in `unhatched` bleiben ungeschnitten, mit `parent` entsteht der Schnittverlauf mit Pfeilen und Buchstaben. `section(path=[...])` schneidet entlang eines geknickten Schnittverlaufs (Stufen- oder Halbschnitt) und zeichnet ihn mit dicken Enden und Knicken. Wo ein Schnitt nur von der Seite zu sehen ist (Stufe, Mitte des Halbschnitts, Rand eines Ausbruchs), fällt die Kante weg (ISO 128-44). `breaks=[(p1, p2)]` kürzt `view()` und `section()` um den Teil zwischen zwei Modellpunkten, mit Bruchlinien (schmale Zickzacklinie, 6 mm Lücke), Maße darüber zeigen die volle Länge. `detail()` schneidet einen Kreis aus einer Ansicht und vergrößert ihn. Ansichtstitel, Schnitt- und Einzelheitsbuchstaben lassen sich mit `label_at`, `letters_at` und `letter_at` verschieben. Maße an Modellpunkten (`dim` waagerecht, senkrecht, schräg, `diameter`, `radius`, `angle`), Werte immer gemessen, `<>` für den Messwert im Text, Toleranzen. Dazu Mittellinien, Mittenkreuze, Hinweislinien, Texte, Tabellen und `sh.msp` für alles Weitere direkt mit ezdxf.
- **Technik:** verdeckte Kanten mit `HLRBRep_Algo` aus OCP (Kanten bekommen danach 3D-Kurven, sonst stürzen die Booleschen Operationen der Einzelheit ab), Kanten als LINE, ARC, CIRCLE, ELLIPSE oder Polylinie, echte DIMENSION-Objekte mit `dimlfac`, Layer und Linienarten nach ISO 128. PDF und PNG entstehen aus derselben DXF über das Zeichenmodul von ezdxf mit matplotlib, keine neuen Pakete. Schrift DejaVu Sans (liegt matplotlib bei). Zwei Fehler von ezdxf umgangen: Das Ø wurde in jeder Schrift zum Fleck (Löcher in Zeichen über Verschachtelung gesucht, für Text jetzt mit der Füllregel der Schrift), und Schraffurlinien bekamen einen Zufallsversatz (fester Startwert).
- **Bytegleich:** Gleiche Zeichnung, gleiche Dateien (DXF mit festen Zeitstempeln und sortierten Klassen, PDF ohne Erstellungsdatum). Ein Neubau ohne Änderung ändert nichts im Verlauf. Das Datum im Schriftfeld ist der Tag des Baus, wenn der Agent keines angibt.
-- **Prüfung (meldet nur, E28):** Text außerhalb des Rahmens oder auf dem Schriftfeld, Ansichten übereinander, Texte und Maßzahlen übereinander, Texte auf Kanten, Maßpunkte auf keiner Kante (mit Hinweis auf gerundete Ecken) oder nur auf verdeckten, Durchmesser ohne passenden Kreis, getippte Zahlen, die vom Messwert abweichen, Text unter 2.5 mm, Maßstab nicht nach ISO 5455, leeres Blatt.
-- **Befehle:** `soma drawing build [Datei]` schreibt `output/drawings/<Name>.pdf` und `.dxf` (im Verlauf und in der ZIP wie `output/model.step`) und ein Bild `.soma/drawings/<Name>.png` mit 200 dpi (längste Seite höchstens 7000 px, nicht in Verlauf und ZIP). Fehler mit Datei und Zeile, Hinweise mit Zeile. `soma drawing list` mit „veraltet“, `soma drawing info` beschreibt Ansichten mit Lage auf dem Blatt, Kreise und Bögen je Ansicht und alle Maße mit Wert. PDF und DXF entfernter Blätter bleiben liegen, die Ausgabe nennt sie.
+- **Prüfung (meldet nur, E28):** Text außerhalb des Rahmens oder auf dem Schriftfeld, Ansichten übereinander, Texte und Maßzahlen übereinander, Texte auf Kanten, Maßpunkte auf keiner Kante (mit Hinweis auf gerundete Ecken) oder nur auf verdeckten, Durchmesser ohne passenden Kreis, getippte Zahlen, die vom Messwert abweichen, Text unter 2.5 mm, Maßstab nicht nach ISO 5455, leeres Blatt. Seit dem ersten Agent-Test auch Texte auf Maß-, Hinweis-, Mittel-, Bruch- und Schnittlinien, Ansichten, Texte und Hinweislinien auf einer Tabelle (Stückliste), Texte, die nicht in ihre Zelle oder ihr Feld im Schriftfeld passen. Texte zählen als gedrehte Rechtecke (schräge Maßzahlen meldeten vorher Kanten neben sich). Maße dürfen auf Mittenkreuzen und Mittellinien des Agenten enden (Positionen, die nicht im Modell sind). Meldungen zu Beschriftungen von soma nennen den Parameter zum Verschieben.
+- **Befehle:** `soma drawing build [Datei]` schreibt `output/drawings/<Name>.pdf` und `.dxf` (im Verlauf und in der ZIP wie `output/model.step`) und ein Bild `.soma/drawings/<Name>.png` mit 200 dpi (längste Seite höchstens 7000 px, nicht in Verlauf und ZIP). Fehler mit Datei und Zeile, Hinweise mit Zeile. `soma drawing list` mit „veraltet“, `soma drawing info` beschreibt Ansichten mit Lage auf dem Blatt, Kreise und Bögen je Ansicht und alle Maße mit Wert. PDF und DXF entfernter Blätter bleiben liegen, die Ausgabe nennt sie. Alle Blätter zusammen stehen in `output/drawings.pdf` (nach Datei, dann Reihenfolge darin), Blätter, die nicht neu gebaut wurden, kommen dafür aus ihrer DXF. Hat eine Zeichnung Fehler, bleibt diese Datei unverändert (sonst fehlte still ein Blatt), die Ausgabe sagt es.
+- **Erster Agent-Test (2026-10-09):** Rückmeldungen des Agenten, alle behoben: `num(130, 0)` ergab „13“, `diameter()` mit `text="Ø<> H7"` ergab „ØØ8“ (Ø und R vor `<>` werden jetzt nicht verdoppelt), der Text eines Durchmessers lag gegenüber von `angle` (jetzt wie beim Radius die Richtung von der Mitte zum Text), mehrzeiliger Text verlor Einrückungen und wurde fälschlich als 161 mm außerhalb gemeldet (ezdxf misst MTEXT mit Umbrüchen, die beim Zeichnen nicht entstehen, jetzt eine TEXT-Zeile je Zeile), ein zu langer Werkstoff im Schriftfeld, Positionsnummern auf der Stückliste und Beschriftungen auf Maßen wurden nicht gemeldet und Beschriftungen ließen sich nicht verschieben. Gewünscht und ergänzt: Bruchlinien, Schnittverlauf bei Stufenschnitten, eine Gesamt-PDF, Maße zu Positionen ohne Geometrie. Dabei gefunden: Wurde in einem Skript Text gemessen, bevor DejaVu Sans angemeldet war (etwa über `leader()`), blieb für den ganzen Lauf eine Ersatzschrift hängen, auch in der PDF. Die Schrift wird jetzt beim Anlegen des Blatts angemeldet.
- **Für den Agenten:** Skill „Technical drawings“ (`zeichnung.md`, Prüfen und Zeigen, bei Bedarf) mit Best Practices nach ISO 128, 129, 5455, 5456, 7200 und den Werkzeugen, Einstellungen Norm, Blattgröße, Allgemeintoleranz und Sprache. `AGENTS.md` nennt `drawings/` und den Befehl. Der Nutzer öffnet die PDF in der vorhandenen PDF-Ansicht und kann Seiten markieren.
-- **Grenzen:** Kein Agent-Test bisher. Text steht in der PDF als Pfad, „Zitat an Agent“ geht dort nicht. Keine automatische Stückliste (Daten muss der Agent zusammenstellen), keine Gewindedarstellung nach ISO 6410 (Normteile haben kein Gewinde), keine Rasterfelder am Rahmen, kein Eintrag im Umschalter des Viewers. Die Projektion großer Baugruppen ist ungetestet. Getestet unter Windows.
+- **Grenzen:** Ein Agent-Test (Claude Code, ein Blatt). Text steht in der PDF als Pfad, „Zitat an Agent“ geht dort nicht. Keine automatische Stückliste (Daten muss der Agent zusammenstellen), keine Gewindedarstellung nach ISO 6410 (Normteile haben kein Gewinde), keine Rasterfelder am Rahmen, kein Eintrag im Umschalter des Viewers. Gedrehte Schnitte (Schnittverlauf mit schrägem Abschnitt) werden nicht in die Ebene geklappt, ihre schrägen Flächen bleiben ohne Schraffur. Die Projektion großer Baugruppen ist ungetestet. Getestet unter Windows.
*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.
@@ -585,6 +586,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- Parameter (E74): Dateiname `parameters.json` im Projektordner (sichtbar im Dateibaum, im Editor nur lesbar, Umbenennen gesperrt, Löschen erlaubt und gleichbedeutend mit „Reset all“). Ohne Werte verschwindet die Datei, damit ein Modell wie die Vorlage bleibt. Ein Wert gleich dem im Code wird nicht gespeichert, folgt also späteren Änderungen des Agenten. Fehler im Aufruf von `param()` (Startwert außerhalb des Bereichs, Startwert nicht unter den `options`) brechen den Build ab, Werte des Nutzers außerhalb des Bereichs nicht. Der Agent soll `parameters.json` nur auf Wunsch ändern, und wenn er einen vom Nutzer gesetzten Wert neu festlegen soll, im Code ändern und den Eintrag entfernen. Abgeleitete Werte zum Ansehen (ƒx im Entwurf), Varianten (benannte Wertesätze) und ein Befehl für die Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch. Bis dahin beschreibt der Skill „Parametric models“ (E77) die Prüfung über eine Kopie des Projekts
- Skill „Parametric models“ (E77): Kennung `parametrik`, Kategorie Arbeitsweise mit `order` 3, ab Werk „Immer“ (jedes Modell hat Parameter), Einstellungen Höchstzahl der Parameter (15, wie „meist 3 bis 15“ in `AGENTS.md`) und Bereichsprüfung (`full`, `main`, `off`). Die Konstruktionsabsicht steht als Kommentar über den Parametern, nicht in `NOTES.md`. Bereichsprüfung über eine Kopie des Projekts statt über einen neuen Befehl
- Technische Zeichnungen (E76): PDF und DXF nach `output/drawings/` (Lieferdateien, deshalb im Verlauf und in der ZIP), das Bild für den Agenten nach `.soma/drawings/` (wie die Animationen nicht in Verlauf und ZIP). Ein Bild mit 200 dpi, längste Seite höchstens 7000 px. Schrift DejaVu Sans statt einer ISO-Schrift, weil sie überall mit matplotlib vorhanden ist. Schriftfeld mit festem Aufbau 180 mm breit, Felder Firma, Benennung, Gezeichnet, Datum (Standard heute), Zeichnungsnummer, Index, Werkstoff, Allgemeintoleranzen, Maßstab, Format, Projektion, Blatt. A4 hoch, A3 bis A0 quer. Verdeckte Kanten standardmäßig in den sechs Hauptansichten, nicht in iso und Schnitten. Schraffur 2.5 mm, Nachbarteile 45/135°, ab dem dritten Teil weiter. Skill-Kennung `zeichnung`, Kategorie „Check and present“ mit `order` 33, ab Werk „Bei Bedarf“, Einstellungen Norm (ISO/ASME), Blattgröße (A3), Allgemeintoleranz (ISO 2768-m) und Sprache (en). PDF und DXF entfernter Blätter bleiben liegen und werden nur genannt.
+- Zeichnungen nach dem ersten Agent-Test (E76): Die Gesamt-PDF heißt `output/drawings.pdf`, liegt neben dem Ordner der Blätter (kein Namenskonflikt mit einem Blatt), wird bei jedem Bau ohne Fehler geschrieben, auch bei nur einem Blatt, und hat keinen eigenen Befehl. `angle` bei `diameter()` meint jetzt die Richtung zum Text (vorher die von ezdxf, Text gegenüber). Ein Ø oder R vor `<>` wird bei `diameter()` und `radius()` still weggelassen statt gemeldet. Mehrzeiliger Text: erste Zeile bei `at`, die übrigen darunter (vorher wuchs der Block nach oben), Zeilenabstand 1.6 Schrifthöhen. Ein zu langer Eintrag im Schriftfeld wird nur gemeldet, nicht schmaler gesetzt. `label_at`, `letter_at` und `letters_at` meinen die Mitte des Texts, `letters_at` ordnet jeden Punkt dem näheren Ende zu. Lücke der Unterbrechung fest 6 mm, Bruchlinie als Zickzacklinie über die Kanten an der Bruchstelle plus 2 mm. Kanten von Schnittflächen, die nur von der Seite zu sehen sind, entfallen bei `path` und `region` immer
- `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)