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 E68, Plan, README und CLAUDE.md: Versionsnummer

Kai-Jungsthoefel7f75300f7cf7
diff --git a/CLAUDE.md b/CLAUDE.md
index 0b238dc..0e2e93c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -84,3 +84,4 @@ node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run bu
- Der Nutzer spricht Deutsch. Ist eine Entscheidung wirklich seine, eine einzelne Frage stellen.
- Im Prototyp erst die volle, funktionierende Variante, nicht früh optimieren (E37).
- Commits nur auf Wunsch, thematisch aufgeteilt (z. B. `python/`, `app/`, Doku), mit deutscher Nachricht.
+- **Versionsnummer (E68):** Major.minor.bugfix, eine für App und `soma`, steht in `app/package.json` und `python/soma/__init__.py` (beide gleich ändern, `npm run test:unit` prüft es). Hochzählen nur auf Wunsch des Nutzers: bugfix für Fehlerbehebungen, minor für neue Funktionen, major für Änderungen, die ältere Modelle oder Agenten-Anweisungen brechen.
diff --git a/DECISIONS.md b/DECISIONS.md
index e7c26a3..ae13f4c 100644
--- a/DECISIONS.md
+++ b/DECISIONS.md
@@ -70,3 +70,4 @@
| 65 | FEM als Auswertung | **Festigkeit mit der Finite-Elemente-Methode kommt als weitere Auswertung `soma analyze fem <studie.py>` auf dem Weg von E58.** Der Agent beschreibt den Lastfall in `analyses/*.py` (Werkstoff, `fix`, `force`, `pressure`, `gravity`, Flächen per CadQuery-Selektor oder Punkt), die App zeigt den Sicherheitsfaktor farbig, die Verformung überhöht und den Lastfall. **Die nötigen Pakete (gmsh, pyamg) kommen in die Basisumgebung** | Vorschlag nach der Frage des Nutzers, Umsetzung und Paketwahl vom Nutzer so gegeben („die Pakete nehmen wir mit rein“). Auslegung (nicht ausdrücklich bestätigt): linear-elastisch, quadratische Tetraeder aus gmsh, eigene Steifigkeitsrechnung in numpy statt scikit-fem (rund 20-mal schneller), gelöst mit pyamg, mehrere Teile fest verbunden, gedruckte Kunststoffe mit der Festigkeit quer zu den Schichten, Prüfungen (Lagerung, Gleichgewicht, gröberes Netz, Spitzen an Einspannung und Kanten) als Hinweise. Umsetzung in PLAN.md Abschnitt 10 |
| 66 | Wartezeiten bei Öffnen, Zeitleiste und neuem Modell | **Was schon gebaut ist, wird nicht neu gebaut:** Beim Öffnen zeigt die App den letzten Build, solange er noch gilt (nichts geändert seit seinem Start). **Ein vorgewärmter Python-Prozess für die ganze App** statt einem je Projekt, schon ab dem Start, für Builds, Vorschauen und alle übrigen Aufträge. **Der Build eines sauberen Arbeitsordners wird die Vorschau des letzten Commits**, ein Sprung in der Zeitleiste muss dann nicht neu vernetzen. Nach „Wiederherstellen“ bleibt der wiederhergestellte Stand zu sehen, bis der Build fertig ist | Vom Nutzer gewählt aus einer Liste von Vorschlägen nach der Messung am Hotwire-Modell (Punkte 1 und 2: „jop“). Der Build selbst (Mesher, Reihenfolge der Ausgaben, Hinweise im Skill) ist zurückgestellt, siehe PLAN.md Abschnitt 11. Umsetzung in PLAN.md Abschnitt 10 |
| 67 | Zusatzpakete | **Zusatzpakete sind der Sonderfall, und der Agent muss sich darum nicht kümmern: Braucht er ein Paket, installiert er es mit `pip install` und fertig.** Die Pakete selbst werden **nicht** mit dem Modell ausgeliefert (nicht in der ZIP), es wandert nur die Liste `requirements.txt` mit. | Präzisiert 25 (Wunsch des Nutzers). Anlass war die Frage, ob eine Umgebung je Modell die gespeicherten Modelle größer macht: nein, in der ZIP steht nur die Liste. Umsetzung in PLAN.md, Abschnitt 10 („Projektumgebung“). Abweichend vom Wortlaut von 25 pflegt nicht die App die Liste per `pip freeze`, sondern `soma build` trägt die Pakete ein, die das Modell importiert (Vorschlag, Abschnitt 11) |
+| 68 | Versionsnummer | **SOMA bekommt Versionsnummern im Format Major.minor.bugfix, Start bei 0.1.0.** Die Nummer gilt für SOMA selbst, eine für App und Hilfsbibliothek `soma` zusammen | Wunsch des Nutzers. Auf Rückfrage: nicht für die Modelle der Nutzer. Umsetzung und Regeln zum Hochzählen (Vorschlag) in PLAN.md, Abschnitte 10 und 11 |
diff --git a/PLAN.md b/PLAN.md
index ddeaca6..0068746 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -69,7 +69,7 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner
├── animations/ Animationen in Python (optional, E58)
├── renders/ Bilder und Videos von soma render (nicht in Git, E58)
├── .soma/
-│ ├── project.json ID, App-/Framework-Version, api_version, Stufen der Skills, Hauptdatei
+│ ├── 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
│ ├── feedback/ Screenshots und Skizzen (nicht in Git)
│ ├── anim/, results/ gebaute Animationen und Ergebnisse von soma analyze (nicht in Git, E58)
@@ -413,6 +413,12 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Nachinstallieren:** Fehlen beim Öffnen oder nach „Wiederherstellen“ Pakete aus der Liste in der Umgebung (anderer Rechner, alter Stand), installiert die App sie mit pip der Umgebung. Pakete, die die Basis hat, überspringt sie. Builds warten so lange, die Statuszeile zeigt „Installiert Pakete …“ mit den Namen. Scheitert pip (kein Netz, Paket unbekannt), erscheint ein Hinweis mit den letzten Zeilen von pip, gebaut wird trotzdem.
- **Nicht in ZIP und Git:** `.soma/env` steht in der `.gitignore` der Vorlage, bei älteren Projekten in `.git/info/exclude` und bei den Zwischenergebnissen der App (`git.ts`), dazu in den Ausschlüssen der ZIP.
+*Versionsnummer (E68, Wunsch des Nutzers; Prüfungen in `app/test/unit.mjs`, `smoke.mjs` und `packages.mjs`):*
+
+- **Eine Nummer für SOMA:** Major.minor.bugfix, Start 0.1.0, gemeinsam für App und `soma`. Sie steht in `app/package.json` und gleichlautend in `python/soma/__init__.py` (`pyproject.toml` liest sie dort, ein Unit-Test prüft, dass beide gleich sind). esbuild setzt sie beim Bauen in Hauptprozess und Oberfläche ein (`src/shared/version.ts`).
+- **Sichtbar:** auf der Startseite neben „SOMA“, im Hinweis des Logos oben links („Startseite · SOMA 0.1.0“) und bei `soma --version`.
+- **Im Modell:** `project.json` hält in `app_version` fest, mit welcher Version das Modell zuletzt gespeichert wurde (beim Anlegen und beim Speichern, steht damit auch im Snapshot). Ist sie neuer als die App, meldet der Projekt-Check das. Repariert wird nichts.
+
*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).
@@ -427,6 +433,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- 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
+- 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. Kein Changelog und keine Git-Tags bisher
+- 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)
- `requirements.txt` (E67) nennt nur Pakete, die das Modell beim Build importiert, nicht alles, was installiert ist (so passt die Liste auch nach „Wiederherstellen“ zum Stand). Pakete, die nur Animationen oder Auswertungen brauchen, fehlen darin. Ein Eintrag für ein Paket, das nicht installiert ist, bleibt stehen, auch wenn das Modell es nicht mehr braucht
- Nachinstallieren (E67) nur beim Öffnen und nach „Wiederherstellen“, nicht bei jeder Änderung der Liste. Pakete werden dabei nie entfernt. Ein Fehler erscheint als Hinweis (Toast), nicht im Projekt-Check
diff --git a/app/README.md b/app/README.md
index 69e635c..c1581e2 100644
--- a/app/README.md
+++ b/app/README.md
@@ -1,6 +1,6 @@
# SOMA: Desktop-App
-Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Plan: [../PLAN.md](../PLAN.md). Stand: **Phase 1, Schritte 1 bis 5** (Gerüst, Git und ZIP, Oberfläche nach dem Entwurf in [../design/ui-entwurf.html](../design/ui-entwurf.html), Markierung, Editor), dazu Messen, Gruppen, Schnitt, Skills, Animation, Analyse sowie Bilder und Videos über `soma render`.
+Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal. Plan: [../PLAN.md](../PLAN.md). Version **0.1.0** (Major.minor.bugfix, E68, steht in `package.json` und `../python/soma/__init__.py`). Stand: **Phase 1, Schritte 1 bis 5** (Gerüst, Git und ZIP, Oberfläche nach dem Entwurf in [../design/ui-entwurf.html](../design/ui-entwurf.html), Markierung, Editor), dazu Messen, Gruppen, Schnitt, Skills, Animation, Analyse sowie Bilder und Videos über `soma render`.
## Voraussetzungen