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 E75, Plan und Changelog: kleinere ZIP
Kai-Jungsthoefel176d7238f940
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c951018..f3ded35 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,10 @@ eigenen Abschnitt mit Datum und Git-Tag.## [Unveröffentlicht]+### Geändert++- Kleinere ZIP beim Speichern: Bilder und Videos aus `renders/` kommen nicht mehr mit, und die Versionsgeschichte wird vorher gepackt, sodass ähnliche Fassungen des Modells kaum zusätzlichen Platz brauchen. Am Modellmotor schrumpft der Verlauf von 81 auf 35 MB (E75).+## [0.2.0] - 2026-10-08Parameter für den Nutzer, die App auf Englisch, Start auf der Startseite und die Lizenz.diff --git a/DECISIONS.md b/DECISIONS.mdindex f859b44..4a715ce 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -77,3 +77,4 @@| 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 |+| 75 | Größe der ZIP | **`renders/` kommt nicht mehr in die ZIP** (im Verlauf schon seit E64 nicht). **Vor dem Schreiben der ZIP packt die App die Git-Objekte** (`git repack`), ähnliche Fassungen von `output/model.step` werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht | Wunsch des Nutzers nach Prüfung zweier ZIPs (Motor 153 MB, Hotwire 12.5 MB, Code jeweils unter 100 KB): „Ja wir lassen renders aus der git repack können wir auch machen wenn das keine probleme verursacht“. Verträgt sich mit E35, weil `repack` keine Historie umschreibt. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |diff --git a/PLAN.md b/PLAN.mdindex ad73b79..2c7fd1c 100644--- a/PLAN.md+++ b/PLAN.md@@ -68,7 +68,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner│ └── model.step Hauptergebnis mit allen Bauteilen, benannt, farbig├── exports/ Einzelexporte (Ort noch nicht festgelegt)├── animations/ Animationen in Python (optional, E58)-├── renders/ Bilder und Videos von soma render (nicht in Git, E58)+├── renders/ Bilder und Videos von soma render (nicht in Git und ZIP, E58, E75)├── .soma/│ ├── project.json ID, App-Version (`app_version`, zuletzt gespeichert mit, E68), api_version, Stufen der Skills, Hauptdatei│ ├── skills/ eingeschaltete Skills (Bei Bedarf, Immer) als Markdown@@ -448,6 +448,13 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **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.+*Kleinere ZIP (E75, Wunsch des Nutzers nach Prüfung zweier ZIPs; Prüfungen in `app/test/unit.mjs`):*++- **Anlass:** Motor 153 MB (vor E64 gespeichert: Analyseergebnisse im Ordner und im Verlauf), Hotwire 12.5 MB. Der Code macht in beiden unter 100 KB aus. Beim Hotwire waren 41 % Bilder aus `renders/`, der Rest `output/model.step` (14.8 MB) im Ordner und in jedem Commit. Git legt jede Fassung lose ab, nur mit zlib komprimiert, die ZIP kann sie nicht weiter verkleinern.+- **`renders/` nicht mehr in der ZIP** (im Verlauf schon seit E64 nicht). Die Bilder entstehen aus dem Code neu.+- **Packen vor der ZIP:** Nach dem Snapshot packt `GitRepo.pack()` die Objekte (`git repack -a -d --keep-unreachable -n`), ähnliche Fassungen werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht (E35), auch nicht Unerreichbares. Ohne lose Objekte passiert nichts. Scheitert es, kommt eine Warnung, und die ZIP wird trotzdem geschrieben. Verlauf am Motor 81 statt 35 MB (erstes Packen 8.9 s, danach 0.4 s), am Hotwire 5 statt 4 MB.+- **Grenzen:** Was ältere Projekte schon im Verlauf haben (Analyseergebnisse, Bilder), bleibt drin. Jeder Commit mit geändertem Modell legt weiter eine neue STEP-Fassung ab, gepackt nur kleiner. 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).@@ -462,7 +469,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, außer der letzte Build gilt noch (E66), dann wird er gezeigt. Beim Anlegen läuft vor dem Startcommit ein Build (im vorgewärmten Prozess unter 1 s)- 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`, 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+- 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/`), seit E75 keine Bilder und Videos aus `renders/`+- Packen vor der ZIP (E75): mit `--keep-unreachable`, also auch unerreichbare Objekte ins Pack statt löschen (etwa Blobs, die der Snapshot wieder aus dem Index nimmt, oder Reste nach `git gc` des Agenten). Gepackt wird bei jedem Speichern mit losen Objekten, ohne Schwelle wie bei `git gc --auto`. Ein Fehler beim Packen ist eine Warnung, gespeichert wird trotzdem- Versionsnummer (E68), Regeln zum Hochzählen: **bugfix** für Fehlerbehebungen ohne neue Funktion, **minor** für neue Funktionen, **major** für Änderungen, nach denen ältere Modelle oder Agenten-Anweisungen nicht mehr ohne Weiteres passen (z. B. eine neue `api_version`). Hochgezählt wird nur auf Wunsch des Nutzers, wie Commits. Bis zur ersten Auslieferung bleibt Major bei 0. Seit E70 mit `CHANGELOG.md` und einem Git-Tag je Version (`v0.1.0`)- Versionsnummer (E68) im Modell: nur „zuletzt gespeichert mit“ (`app_version`), nicht „angelegt mit“. Ein Modell aus einer älteren App bekommt die neue Nummer erst beim Speichern, nicht schon beim Öffnen (sonst wäre es gleich nach dem Öffnen ungespeichert). Eine neuere Nummer im Modell meldet nur der Projekt-Check, die App öffnet es trotzdem- Projektumgebung (E67): Sie liegt im Arbeitsordner unter `.soma/env` (nicht in den App-Daten daneben), wandert also beim Sichern eines Arbeitsordners mit in `workspace-backups/`. Ist sie für eine andere Python-Version angelegt, leert `soma env` sie ohne Sicherung (die Pakete liefen dort nicht mehr)@@ -566,7 +574,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **Lizenzen der Komponenten:** Hinweise und Texte aller mitgelieferten Teile (Git, Python-Pakete, gmsh, pdf.js, IBM Plex, Tabellen aus bd_warehouse) für den Installer sammeln. Die Lizenz von SOMA selbst ist entschieden (GPL-3.0, E71)- **Mittelbereich:** Tab-Umschaltung oder geteilte Ansicht zwischen Viewer und Sketch (E15)- **Build:** Auto-Build standardmäßig an oder aus, Statusanzeige, Fehlerpanel, Verhalten bei erneuter Änderung während des Builds (E20)-- **Speichern/Öffnen:** mehrere Projekte parallel (bisher eines pro Fenster), Aufräumen alter Workspaces und Sicherungen, ZIP auf Netzlaufwerk (Speichern dorthin geht, Verhalten bei Verbindungsverlust ungetestet), ZIP-Größe bei langen Verläufen und vielen Markierungen (je Bild einige hundert KB) (E21)+- **Speichern/Öffnen:** mehrere Projekte parallel (bisher eines pro Fenster), Aufräumen alter Workspaces und Sicherungen, ZIP auf Netzlaufwerk (Speichern dorthin geht, Verhalten bei Verbindungsverlust ungetestet), ZIP-Größe bei langen Verläufen (seit E75 gepackt, jede STEP-Fassung bleibt aber im Verlauf) und vielen Markierungen (je Bild einige hundert KB) (E21)- **Git:** Einbettung und Updates des Git-Binaries (E31), Verhalten bei sehr langen Verläufen (die Leiste zeigt bisher bis zu 500 Stände), Umschreiben des Verlaufs durch den Agenten trotz Verbot (die Leiste bleibt tolerant, es gibt nur eine Meldung bei fehlendem Repository, losem HEAD oder anderem Branch)- **Pakete (E25, E67):** Ohne Internet scheitert das Nachinstallieren mit Hinweis, einen eigenen Paketcache gibt es nicht (pip nutzt seinen eigenen). `uv pip install` sieht die Basispakete nicht und ignoriert die `pip.ini`, es würde z. B. numpy doppelt installieren. Ein Panel „Pakete“ fehlt noch (die Liste steht in `requirements.txt`). Für die Auslieferung: Basisumgebung mit pip, eigenständiges Python statt venv (dann ginge auch `--system-site-packages` statt der `.pth`). Getestet nur unter Windows- **Plattformen:** Phase 0 lief nur unter Windows. Python-Bundling, Bibliothekspfade und Wheels auf macOS und Linux sind ungetestet (E2)