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 E74, Plan, Changelog, CLAUDE.md und README: Parameter
Kai-Jungsthoefel78e4e2a5d13f
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f6b72a3..2e35586 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -11,6 +11,7 @@ eigenen Abschnitt mit Datum und Git-Tag.- Die App beginnt auf der Startseite. Ein neues Modell, das noch der Vorlage entspricht und nie gespeichert wurde, verschwindet beim Verlassen wieder. Andere Modelle lassen sich auf der Startseite entfernen, der Arbeitsordner kommt in den Papierkorb (E69).- README auf Englisch mit Bildern für die Startseite des Repos, dazu dieser Changelog (E70).- Lizenz: GPL-3.0 oder später, Text in `LICENSE` (E71). Die Modelle der Nutzer sind davon frei (`MODEL-EXCEPTION.md`, E72).+- Parameter: Der Agent gibt mit `param()` einzelne Werte frei, etwa Maße, Anzahlen, Optionen oder einen Winkel. Im neuen Panel „Parameters“ ändert man sie selbst, das Modell baut neu. Die eigenen Werte stehen in `parameters.json`, der Wert des Agenten bleibt im Code, und jedes Feld lässt sich auf ihn zurücksetzen. Werte außerhalb des Bereichs werden gemeldet und trotzdem gebaut. Die Vorlage für neue Modelle hat vier Parameter (E74).### Geändertdiff --git a/CLAUDE.md b/CLAUDE.mdindex f8ab221..fbe633b 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`, `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 |+| `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`, `params.ts` (Werte des Parameter-Panels, E74), `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`, `params.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 Parameter-Panel (umgesetzt mit E74, Werte des Nutzers getrennt vom Code) || `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), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) |+| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `param` (`params.py`, Werte für das Parameter-Panel, E74), `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, packages) 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, params, 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 b43e654..f859b44 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -76,3 +76,4 @@| 71 | Lizenz | **SOMA steht unter der GPL-3.0** (`GPL-3.0-or-later`, Text in `LICENSE`). Weiterentwicklungen, die jemand weitergibt, müssen offen bleiben, ein geschlossenes Produkt aus SOMA ist nicht möglich | Entscheidung des Nutzers nach Vergleich von MIT, Apache-2.0, MPL-2.0, GPL-3.0 und AGPL-3.0. Präzisiert 30 (dort war MIT oder Apache-2.0 naheliegend). Damit passt gmsh (GPL-2.0 oder später) ohne Weiteres in die Auslieferung. „oder später“ ist die Empfehlung der FSF und nicht ausdrücklich bestätigt. Offen: Lizenzhinweise der mitgelieferten Komponenten, Rechte an den Modellen der Nutzer (siehe PLAN.md Abschnitt 11) || 72 | Modelle der Nutzer | **Modelle gehören den Nutzern:** Eine zusätzliche Erlaubnis nach Abschnitt 7 der GPL (`MODEL-EXCEPTION.md`) erlaubt, Modelle (`model.py`, `parts/`, Animationen, Lastfälle, `inputs/`) frei zu lizenzieren, auch wenn sie `soma` importieren. Dasselbe gilt für die Dateien, die die App ins Modell kopiert (Vorlage, `AGENTS.md`, Skills), innerhalb eines Modellprojekts. SOMA selbst bleibt voll unter der GPL | Zustimmung des Nutzers zum Vorschlag aus E71. Erzeugte Dateien (STEP, STL, Bilder) betrifft die GPL ohnehin nicht, die Ausnahme sagt das ausdrücklich. Eigene Datei statt Zusatz in `LICENSE`, damit GitHub die GPL weiter erkennt. Text auf Englisch wie die GPL || 73 | App auf Englisch | **Die App ist komplett auf Englisch:** Oberfläche, Meldungen und Dialoge, Ausgaben und Fehlermeldungen von `soma`, Docstrings der öffentlichen API, Skills samt Titel, Beschreibung und Einstellungen, die Notizen an den Agenten (`[Markup: …]`, `[Selection: …]` …). Zahlen stehen mit Dezimalpunkt | Wunsch des Nutzers („Lass uns die App komplett auf englisch übersetzen“). Ersetzt die Sprachregel „Oberfläche deutsch“ (PLAN.md Abschnitt 11) und in E48 „Fehlermeldungen deutsch“. Auslegung (nicht ausdrücklich bestätigt): nur Englisch, keine Umschaltung. Deutsch bleiben Doku, Code-Kommentare, Commit-Nachrichten und Changelog. IDs und Dateinamen der Skills bleiben (`3d-druck.md`). Ältere Projekte (deutsche Commit-Betreffe und Trailer der App) werden weiter erkannt. Umsetzung in PLAN.md Abschnitt 10 |+| 74 | Parameter für den Nutzer | **Der Agent gibt mit `param()` im Code die Werte frei, die der Nutzer selbst ändern soll, nicht alle Konstanten** (etwa Kurbelwinkel des Modellmotors, Bauraum der CNC-Maschine). Die App zeigt sie im Parameter-Panel (Entwurf 2, Bild 6), Ändern baut neu. **Jedes Feld lässt sich auf den Wert des Agenten zurücksetzen** | Wunsch des Nutzers nach Brainstorming (Kommentare wie im OpenSCAD-Customizer, Funktionsaufruf, eigene Tabelle). Gewählt: Funktionsaufruf nach Vorbild Streamlit/Gradio. Wegen der Rücksetzung bleibt der Wert des Agenten im Code, die Werte des Nutzers stehen getrennt in `parameters.json`. Das ersetzt die Anmerkung im Entwurf, der Wert werde in den Code geschrieben. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |diff --git a/PLAN.md b/PLAN.mdindex 495eef6..ad73b79 100644--- a/PLAN.md+++ b/PLAN.md@@ -60,6 +60,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner├── CLAUDE.md Verweis auf AGENTS.md (für Claude Code)├── NOTES.md Nutzer/Agent, wird nie überschrieben (Arbeitsname)├── requirements.txt Zusatzpakete, die das Modell importiert, mit Version, von `soma build` gepflegt (E67)+├── parameters.json Werte des Nutzers aus dem Parameter-Panel, gelten vor denen aus param() im Code (E74)├── model.py fester Einstiegspunkt├── parts/ Bauteile (optional)├── inputs/ mitgebrachte Dateien (z. B. STEP), Drag-and-drop im Dateien-Tab@@ -84,7 +85,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) und die Projektumgebung `.soma/env/` (auch nicht in der ZIP, E67).+- **Getrackt:** Skripte, `inputs/`, `output/model.step`, `requirements.txt`, `parameters.json`, `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.@@ -97,6 +98,7 @@ 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`), Rolle `hardware` ein Zukaufteil (deckend, in der STEP bei seiner Gruppe, nicht in `--all`, E48) |+| `param(38.0, "Bohrung", min=30, max=42, unit="mm")` | Wert, den der Nutzer im Parameter-Panel ändern darf (E74). Liefert den Wert des Nutzers aus `parameters.json`, sonst den aus dem Code. Die Art folgt aus dem Wert (Zahl, ganze Zahl, Schalter, Text) oder `options=`, dazu `step`, `unit`, `group`, `help`. Fehler im Aufruf brechen den Build mit Zeile ab. `soma build` nennt die Werte des Nutzers und meldet Werte außerhalb des Bereichs, unpassende und solche ohne Parameter || `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) |@@ -121,7 +123,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt## 7. Oberfläche und Viewer-**Layout (E15, E38, E62, Entwurf in [design/ui-entwurf-2.html](design/ui-entwurf-2.html), Vorgänger [design/ui-entwurf.html](design/ui-entwurf.html)):** Das Modell ist die Hauptsache, der Viewer bekommt die größte Fläche. Von links nach rechts: eine schmale **Leiste** wählt, was die **Seitenleiste** zeigt (*Bauteile*, *Dateien*, *Skills*, eine Ansicht zur Zeit, später *Parameter*), daneben bei Bedarf der **Code** als eigene Spalte, dann der **Viewer** mit der **Verlaufsleiste** darunter, rechts der **Agent-Bereich** mit Tabs. **Schalter oben rechts** blenden Seitenleiste, Code und Agent unabhängig ein und aus (Strg 1, 2, 3). Im Viewer hat jeder Ort eine Frage: oben links der **Umschalter** „Modell ▾“ (was zu sehen ist: das Modell, eine Analyse, eine Animation oder ein Video), oben in der Mitte die **Werkzeuge** (Messen, Schnitt, Explosion, Markieren), oben rechts der **Ansichtswürfel** mit Einpassen, Standardansicht und Darstellung, unten links die **Karten** (Auswahl, Werkzeug, Ergebnis). „An Agent geben“ steht in der Karte, um die es geht, Bauteile und Dateien lassen sich auch ins Terminal ziehen. Die **Kopfzeile** zeigt Zustände: Modellname als Dokumentmenü, Speicherstand, Build-Anzeige mit Auto-Build, die Spalten-Schalter, dazu Exportieren und Speichern. Eine Startseite zeigt Modelle, erkannte Agenten und den Hinweis auf die Rechte des Agenten.+**Layout (E15, E38, E62, Entwurf in [design/ui-entwurf-2.html](design/ui-entwurf-2.html), Vorgänger [design/ui-entwurf.html](design/ui-entwurf.html)):** Das Modell ist die Hauptsache, der Viewer bekommt die größte Fläche. Von links nach rechts: eine schmale **Leiste** wählt, was die **Seitenleiste** zeigt (*Bauteile*, *Parameter* (E74), *Dateien*, *Skills*, eine Ansicht zur Zeit), daneben bei Bedarf der **Code** als eigene Spalte, dann der **Viewer** mit der **Verlaufsleiste** darunter, rechts der **Agent-Bereich** mit Tabs. **Schalter oben rechts** blenden Seitenleiste, Code und Agent unabhängig ein und aus (Strg 1, 2, 3). Im Viewer hat jeder Ort eine Frage: oben links der **Umschalter** „Modell ▾“ (was zu sehen ist: das Modell, eine Analyse, eine Animation oder ein Video), oben in der Mitte die **Werkzeuge** (Messen, Schnitt, Explosion, Markieren), oben rechts der **Ansichtswürfel** mit Einpassen, Standardansicht und Darstellung, unten links die **Karten** (Auswahl, Werkzeug, Ergebnis). „An Agent geben“ steht in der Karte, um die es geht, Bauteile und Dateien lassen sich auch ins Terminal ziehen. Die **Kopfzeile** zeigt Zustände: Modellname als Dokumentmenü, Speicherstand, Build-Anzeige mit Auto-Build, die Spalten-Schalter, dazu Exportieren und Speichern. Eine Startseite zeigt Modelle, erkannte Agenten und den Hinweis auf die Rechte des Agenten.**Viewer (E22, E33):**@@ -366,7 +368,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Übergabe an den Agenten:** Die Übergabeleiste entfällt. Ein Bauteil aus der Seitenleiste oder eine Datei aus dem Baum, ins Terminal gezogen, fügt denselben Verweis ein wie „An Agent geben“, beim Darüberziehen zeigt das Terminal einen Hinweis.- **Export mit Dateidialog (E63):** „Exportieren“ in der Karte des Bauteils öffnet das Formatmenü mit „Nur <Bauteil>“, danach der Speichern-Dialog. „Exportieren“ oben fragt bei „Alle Bauteile“ nach einem Ordner. `soma export --out` schreibt in einen leeren Ordner unter Temp (`--out` nimmt dafür auch absolute Pfade), die App kopiert und räumt auf. Schon vorhandene Dateien im Ordner ersetzt sie nur nach Rückfrage. Der zuletzt gewählte Ordner gilt beim nächsten Mal (`exportDir` im Projektzustand).- **Speichern:** Der Knopf zeigt sofort „Speichert …“ und nimmt keinen zweiten Auftrag an, bis Snapshot und ZIP fertig sind (der Nutzer sah beim Speichern lange keine Reaktion).-- **Noch nicht umgesetzt:** das Parameter-Panel (Entwurf Bild 6), es bekommt einen Eintrag in der Leiste, sobald es das gibt.+- **Parameter-Panel (Entwurf Bild 6):** seit E74 umgesetzt, siehe unten.- **Nachbesserungen nach der ersten Durchsicht des Nutzers:** Symbole vor den Kategorien der Skills (Weg, Schraubenschlüssel, Zirkel, Messuhr), im Umschalter steht bei den Analysen ihr Ordner `.soma/results/`, der Satz „Ergebnisse legt der Agent an …“ steht nur noch, wenn es keine gibt. Dazu die Punkte bei Explosion, Animation und Analyse oben.*Allgemeine Verbesserungen aus dem Agent-Test am Motor (E64, Wunsch des Nutzers; Prüfungen in `unit.mjs`, `fasteners.mjs`, `animation.mjs`):*@@ -435,6 +437,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Was in Projekte geschrieben wird:** Commit-Betreffe der App auf Englisch (`New model created`, `Automatic snapshot on save`, `Backup before restore`, `Restored version: …`), Trailer `Created-by: SOMA`, Markierungen als `markup-JJJJMMTT-HHMM.png`, Bilder von `soma render` als `renders/view-iso.png`, `result-<name>.png` und `<id>-sheet.png`, Standardname „New model“, Referenzteile in der STEP unter „Reference“, unbenannte Teile aus `import_assembly` als „Part“.- **Ältere Projekte:** Der Verlauf erkennt die deutschen Betreffe und den Trailer `Erstellt-von` weiter als Commits der App. Eine `.check.json` von `soma anim check` mit `Kollision` oder `zu nah` wird beim Lesen umgesetzt, deutsche Stufen im Skill-Kopf gelten weiter. Skill-Kopien in bestehenden Projekten haben noch den deutschen Kopf und gelten beim nächsten Umstellen als geändert, sie wandern dann in die Sicherung wie bei jedem Update eines Skills. Gespeicherte Ergebnisse von `soma analyze` behalten ihre deutschen Titel bis „Recalculate“.+*Parameter für den Nutzer (E74, Wunsch des Nutzers nach Brainstorming; Prüfungen in `app/test/params.mjs` und `unit.mjs`):*++- **Anlass:** Der Agent schreibt ein Skript mit festen Werten. Der Nutzer will einzelne davon selbst verstellen (Kurbelwinkel des Modellmotors, Bauraum einer CNC-Maschine), aber nicht alle Konstanten sehen.+- **Für den Agenten:** `BORE = param(38.0, "Cylinder bore", min=30, max=42, step=0.5, unit="mm", group="Crank train")` in `model.py` oder `parts/params.py`. Vorbild sind Streamlit, Gradio und ipywidgets (Funktionsaufruf mit Bereich), nicht die Kommentare des OpenSCAD-Customizers: Ein Aufruf läuft wirklich, Tippfehler brechen mit Datei und Zeile ab. Der Name kommt aus der Zuweisung (Syntaxbaum an der Stelle des Aufrufs), `name=` nur ohne Zuweisung. Dieselbe Stelle zweimal (eine Animation importiert das Modell) gibt denselben Wert, zwei Stellen mit demselben Namen sind ein Fehler.+- **Werte des Nutzers getrennt vom Code:** Der Wert des Agenten bleibt im Code, die des Nutzers stehen in `parameters.json` (`{"note": …, "values": {"BORE": 40}}`, in Git und ZIP). Nur so lässt sich jedes Feld auf den Wert des Agenten zurücksetzen (Wunsch des Nutzers). Der Entwurf sah vor, den Wert in den Code zu schreiben. `soma build` liest die Datei bei jedem Lauf (auch ohne App), `soma export`, Animationen und Auswertungen sehen so dieselben Werte.+- **Panel:** Eintrag „Parameters“ in der Leiste (Symbol Schieber, „Options“ bekommt das Zahnrad). Zeilen mit Name, Name im Code und Feld nach Art: Zahlenfeld mit Einheit, Stepper, Schalter, Auswahl, Textfeld. Gruppen wie im Code (ohne Gruppe zuerst), einklappbar. Aufgeklappt: Schieber (bei min und max, gebaut wird beim Loslassen), Erklärung, Wert im Code mit Bereich, Sprung in den Code, „Send to agent“ (`[Parameter: "Length" (LENGTH) = 100 mm, set in the app, code default 60 mm, model.py line 10]`). Abweichende Werte orange mit Knopf zum Zurücksetzen, unten „N changed“ mit „Reset all“.+- **Ändern:** Enter, Verlassen des Felds, Schalter, Auswahl oder Loslassen des Schiebers schreiben die Datei und bauen gleich, auch bei ausgeschaltetem Auto-Build (wie Strg+S im Editor, E39). Pfeiltasten und Stepper sammeln kurz. Ein Wert gleich dem im Code entfernt den Eintrag. Ändert der Agent die Datei, baut der Watcher wie bei Code.+- **Melden statt reparieren (E28):** Ein Wert außerhalb des Bereichs wird eingetragen und gebaut, die Zeile ist rot, `soma build` warnt. Unpassende Werte (2.5 für eine ganze Zahl) gelten nicht, die Zeile ist rot. Werte ohne Parameter stehen in einem eigenen Abschnitt mit „Remove“. Eine unlesbare `parameters.json` wird gemeldet und nie überschrieben. Scheitert der Build nach einer Änderung, bietet das Panel „Back to <Wert davor>“ und „Send to agent“, nimmt aber nichts selbst zurück. Scheitert er vor den Parametern (Syntaxfehler), bleibt die Liste des vorigen Builds mit Hinweis bedienbar.+- **Vorlage und Agent:** Die Vorlage macht LENGTH, WIDTH, HEIGHT und WALL zu Parametern (an allen Bereichsgrenzen gebaut). `AGENTS.md` (Regel 7) sagt, welche Werte Parameter werden (Hauptmaße, Anzahlen, Optionen, Stellungen, meist 3 bis 15), dass der Bereich über die ganze Spanne funktionieren soll und was mit `parameters.json` zu tun ist. Der Skill „Clean CadQuery modeling“ verweist darauf. Leerer Zustand mit „Ask the agent“.+- **Grenzen:** Jede Änderung baut das ganze Modell, auch eine reine Stellung wie ein Kurbelwinkel (bei großen Modellen Sekunden). 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.**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).@@ -537,6 +550,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Ladeanzeigen: Die Explosion deckt den Viewer während der Analyse ab (Klicks kämen sonst vor dem Ergebnis an), Abbrechen beendet sie. Messen zeigt seine Vorbereitung (Messdienst starten, Stand laden) nur in der eigenen Karte und lässt schon Klicks zu, deren Messung wartet. Den Stand lädt der Messdienst schon beim Einschalten des Messmodus und nach jedem neuen Build, solange er an ist. Zeitlimit dafür 10 Minuten statt 30 s- 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+- 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 eine Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch- `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)diff --git a/README.md b/README.mdindex 46eb66d..2234b69 100644--- a/README.md+++ b/README.md@@ -36,6 +36,7 @@ Any CLI agent that can read files and run commands works: Claude Code, OpenCode,- Builds on every change, errors point to file and line- Named parts, groups and sub-assemblies, STEP import of single parts and whole assemblies- Standard parts (ISO/DIN screws, nuts, washers, heat-set inserts) with matching holes and nut traps+- Parameters: the agent marks the values you may change (`param()`), you change them in a panel and can always reset them to the agent's value- Extra Python packages: the agent runs `pip install`, SOMA records them in `requirements.txt` and reinstalls them on another machine**Looking at the result**@@ -74,9 +75,10 @@ Overhang analysis of a 3D printed part. The agent ran `soma analyze` in the term```pythonimport cadquery as cq-from soma import add_part+from soma import add_part, param-LENGTH, WIDTH, HEIGHT, WALL = 60.0, 40.0, 25.0, 2.0+LENGTH = param(60.0, "Length", min=30, max=200, unit="mm") # adjustable in the app+WIDTH, HEIGHT, WALL = 40.0, 25.0, 2.0body = (cq.Workplane("XY")@@ -87,7 +89,7 @@ body = (add_part("Body", body, color=(0.25, 0.45, 0.75))```-`soma build` runs the file and writes `output/model.step` with every part named, plus the data for the viewer.+`soma build` runs the file and writes `output/model.step` with every part named, plus the data for the viewer. `param()` puts a value into the Parameters panel of the app.## Statusdiff --git a/app/README.md b/app/README.mdindex a3b33e6..89f88ad 100644--- a/app/README.md+++ b/app/README.md@@ -27,8 +27,9 @@ npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mitnpm 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)+npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in parameters.json statt im Code, Zurücksetzen einzeln und alle, Komma, Bereich (rot, trotzdem gebaut), Schieber, Sprung in den Code, An Agent geben, Typen (Stepper, Schalter, Auswahl, Text), Gruppen, unpassende Werte und Werte ohne Parameter, gescheiterter Build mit „Back to“, Syntaxfehler vor den Parametern, kaputte Datei, Snapshot und ZIP, leerer Zustand (40 Prüfungen)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 dreizehn, vier gleichzeitig (test/run-all.mjs)+npm test # alle vierzehn, vier gleichzeitig (test/run-all.mjs)node test/run-all.mjs smoke editor # nur diese, nach npm run build```@@ -42,17 +43,17 @@ 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, 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/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), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `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/` | 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), `params.ts` (Parameter in der Seitenleiste: Felder nach Art, Gruppen, Zurücksetzen auf den Wert aus dem Code, E74), `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) || `src/shared/` | `types.ts` Typen des IPC-Vertrags, `editable.ts` welche Dateien der Editor nur zeigt (gilt in Renderer und Hauptprozess) || `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, `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) |+| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.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)-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).+Panel „Pakete“, Hilfe und Optionen (die Knöpfe stehen schon ausgegraut da), Varianten und abgeleitete Werte im Parameter-Panel, eigene Skills, Auto-Start des Agenten, `soma check`, Bündelung von Python und Installer, macOS und Linux (nur Windows getestet).