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 E69, Plan und README: Startseite beim Start, Aufräumen
Kai-Jungsthoefel459d0dbb8872
diff --git a/DECISIONS.md b/DECISIONS.mdindex ae13f4c..4edd822 100644--- a/DECISIONS.md+++ b/DECISIONS.md@@ -71,3 +71,4 @@| 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 |+| 69 | Startseite beim Start, Aufräumen | **Die App beginnt auf der Startseite** statt mit dem zuletzt geöffneten Modell. **Ein neues Modell, das noch genau der Vorlage entspricht und nie gespeichert wurde, verschwindet beim Verlassen von selbst.** **Jedes andere Modell lässt sich auf der Startseite entfernen:** Der Arbeitsordner kommt in den Papierkorb, bei Ungespeichertem erst nach Rückfrage | Wunsch des Nutzers („Die App soll im Home Screen starten“), dazu seine Frage, ob die vielen „Neues Modell“ den Rechner zumüllen (ja: 6 Arbeitsordner, 370 MB, nie gelöscht). Von drei Vorschlägen gewählt: „Beides“. Die Absturz-Wiederherstellung aus E21 bleibt: Der Arbeitsordner bleibt liegen, nach einem Neustart steht das Modell auf der Startseite. Umsetzung in PLAN.md Abschnitt 10 |diff --git a/PLAN.md b/PLAN.mdindex 0068746..1ac887d 100644--- a/PLAN.md+++ b/PLAN.md@@ -206,7 +206,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben- **Git pro Projekt:** Repository mit Startcommit, Identität und `core.autocrlf=false` gesetzt, damit auch der Agent committen kann. Die `AGENTS.md` verlangt Commits nach gebauten Iterationen und verbietet Umschreiben des Verlaufs.- **Speichern (E8, E21):** Strg+S baut bei Bedarf zuerst neu, legt einen Auto-Snapshot an (nur bei Änderungen an Quelltext, Eingaben oder Einstellungen) und schreibt die ZIP atomar (erst `.part`, dann umbenennen). Sie enthält `.git`, aber keine Umgebungen und Caches. Ein Marker `.soma/zip-info.json` hält den gespeicherten Stand fest. Der Modellname folgt dem Dateinamen. Ohne `.git` klappt Speichern weiter, mit Warnung.- **Öffnen (E21):** Fehlt der Arbeitsordner (anderer Rechner), wird die ZIP entpackt. Ist er identisch, wird er einfach geöffnet. Weicht er ab, fragt die App: *Arbeitsstand behalten* oder *ZIP laden*, dabei wandert der alte Arbeitsordner nach `workspace-backups/`, nichts wird gelöscht. Entpacken ist gegen bösartige Pfade abgesichert (zwei Schichten).-- **Absturz-Wiederherstellung:** Der Arbeitsordner liegt fest in den App-Daten, die App öffnet beim Start das letzte Projekt. Ungespeicherte Änderungen überleben einen harten Abbruch (getestet). Beim Schließen mit ungespeicherten Änderungen fragt die App (nicht automatisch getestet).+- **Absturz-Wiederherstellung:** Der Arbeitsordner liegt fest in den App-Daten, nach einem Neustart steht das Modell auf der Startseite unter den zuletzt geöffneten (E69, vorher öffnete die App es von selbst). Ungespeicherte Änderungen überleben einen harten Abbruch (getestet). Beim Schließen mit ungespeicherten Änderungen fragt die App (nicht automatisch getestet).- **Verlauf (E35):** Leiste unter dem Viewer, jeder Commit ein Punkt plus der Arbeitsstand, Schieber und Klick. Alte Stände sind eine schreibgeschützte Vorschau (STEP per `git show`, Basismodus). *Stand wiederherstellen* legt einen neuen Commit an und sichert vorher ungesicherte Änderungen als eigenen Stand. Kein Checkout, kein Reset, keine Branches.- **Robustheit (E28):** App-eigene Git-Schreibvorgänge laufen nacheinander und wiederholen sich bei `index.lock`, lesende Aufrufe nehmen keine Sperren. Ohne `.git` meldet der Verlauf das verständlich und bietet **keine** automatische Reparatur an.@@ -218,7 +218,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben- **Dateien und Code:** Dateibaum mit eingeklappten App-Dateien und Symbolen je Dateityp. Dateien und Ordner, die man ins Fenster zieht, landen in `inputs/`, Vorhandenes wird nie überschrieben (E33). Rechtsklick: Öffnen, Mit Standardprogramm öffnen, Im Explorer zeigen, Pfad an Agent geben, Pfad kopieren, Neue Datei, Neuer Ordner, Umbenennen (F2, direkt in der Zeile), Löschen (Entf, mit Rückfrage in den Papierkorb). Neue Datei und neuer Ordner auch oben im Panel. Markierungen aus `.soma/feedback/` stehen als eigene Gruppe „Markierungen“ im Baum, neueste zuerst. Code-Panel zum Lesen mit Hervorhebung, der Auswahl im Viewer folgend.- **Verlauf:** Punkte unterscheiden Stände der App (Commit-Trailer `Erstellt-von: SOMA`) und des Agenten, der gespeicherte Stand ist grün, die Vorschau violett mit Rahmen um den Viewer.- **Agent-Bereich:** Tabs mit Laufanzeige, „+“ startet erkannte Agenten oder ein leeres Terminal, einklappbar. Die Übergabeleiste fügt Text in die Eingabe ein (als Einfügen, ohne Enter, E11).-- **Startseite** beim allerersten Start und über das Logo: Neu, Öffnen, zuletzt geöffnete Modelle mit Vorschaubild, erkannte Agenten, Hinweis auf die Rechte des Agenten (E29).+- **Startseite** bei jedem Start (E69) und über das Logo: Neu, Öffnen, zuletzt geöffnete Modelle mit Vorschaubild, erkannte Agenten, Hinweis auf die Rechte des Agenten (E29).- **Schrift:** IBM Plex Sans und Mono liegen lokal bei (SIL Open Font License).*Schritt 4, Markierung (erledigt, E16; 53 Prüfungen im Smoke-Test, 53 im Verlaufstest, 8 Einheitentests):*@@ -419,6 +419,14 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- **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.+*Startseite und Aufräumen (E69, Wunsch des Nutzers; Prüfungen in `app/test/versions.mjs`):*++- **Start auf der Startseite:** Die App öffnet beim Start kein Modell mehr (vorher das zuletzt geöffnete, beim allerersten Start ein neues). Ohne offenes Modell lässt sich die Startseite nicht wegklicken, Strg+N und Strg+O gehen, die Agenten werden ohne Modellordner erkannt. Die Tests starten weiter gleich mit einem Modell, `SOMA_TEST_START=home` startet sie wie außerhalb der Tests.+- **Anlass:** Jedes „Neues Modell“ blieb als Arbeitsordner in `%LOCALAPPDATA%\soma\workspaces` liegen, auch unverändert und nie gespeichert. Beim Nutzer waren es 6 Ordner mit 370 MB, davon 2 unveränderte Vorlagen.+- **Unveränderte neue Modelle verschwinden beim Verlassen** (Wechsel zu einem anderen Modell, Beenden über das Fenster): nie als ZIP gespeichert, im Verlauf nur der Startcommit, nichts geändert oder hinzugekommen (auch keine Markierungen, Bilder, Ergebnisse, gebauten Animationen) und keine Sicherungen. Vorher wartet die App, bis die Shells der Terminals beendet sind, dann wird der Ordner umbenannt und gelöscht (Reste räumt der nächste Start weg). Beim Beenden fragt die App für ein solches Modell nicht mehr nach dem Speichern.+- **Entfernen auf der Startseite:** Beim Überfahren einer Karte erscheint ein Papierkorb (nicht beim geöffneten Modell). Der Arbeitsordner kommt in den Papierkorb von Windows, die Daten der App dazu (Zustand, Vorschauen, Vorschaubild) werden gelöscht, Sicherungen bleiben. Die Rückfrage sagt, was verloren geht: nichts, wenn der Stand in der ZIP steckt, sonst die Änderungen seit dem Speichern bzw. das ganze Modell, wenn es nie gespeichert wurde. Unveränderte gehen ohne Rückfrage. Hält die eben beendete Shell eines gerade verlassenen Modells den Ordner noch fest, versucht die App es bis zu 10 s lang. Die Karten zeigen „nie gespeichert“.+- **Testwerkzeug:** `window.close()` aus der Seite schließt das Fenster am Ereignis `close` vorbei (ohne Rückfrage, ohne Verlassen des Modells). Tests schließen deshalb über `window.soma.test.close()` wie mit dem Kreuz. Die Prüfung der Markierung in der Vorschau wartet bis 30 s auf die Zeichenfläche, unter Last kam der Klick auf „An Agent“ sonst zu früh und blieb wirkungslos. Nach dem Öffnen einer ZIP wartet der Test auf den Speicherstand des neuen Modells (der Build ist inzwischen oft schneller da).+*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).@@ -450,7 +458,9 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch- Oberfläche (E38): Funktionen, die noch fehlen (inzwischen nur noch Pakete, Hilfe, Optionen), stehen schon ausgegraut mit Hinweis da. Nur dunkles Farbschema. Das „⋯“-Menü aus dem Entwurf entfällt (alles steht im Dokumentmenü)- Dateien, die man irgendwo ins Fenster zieht, landen in `inputs/` (Electron würde sie sonst als Seite öffnen). Bei gleichem Namen „name (2).ext“- Gezogene Ordner kommen mit allen Unterordnern nach `inputs/<Ordner>/` (bei gleichem Namen „Ordner (2)“). Verknüpfungen und `.git`-Ordner darin bleiben draußen und werden gemeldet (ein eingebettetes Repository würde Git nur als Verweis ablegen). Grenze wie bei Dateien 500 MB, dazu höchstens 10 000 Dateien. Ist der Ordner zu groß, wird gar nichts kopiert-- Die Startseite erscheint nur beim allerersten Start und über das Logo. Sonst öffnet die App wie bisher das letzte Modell+- Die Startseite erscheint bei jedem Start und über das Logo (E69). Ein Modell, das nach einem Absturz ungespeichert liegen blieb, öffnet die App nicht mehr von selbst, es steht auf der Startseite+- Unveränderte neue Modelle (E69) verschwinden nur beim Verlassen in derselben App. Was ein Absturz oder eine ältere Version hinterlassen hat, bleibt, bis man es auf der Startseite entfernt (beim Start räumt die App nicht auf: Ohne Sperre gegen eine zweite laufende App könnte dort gerade jemand arbeiten). Verworfen wird endgültig, nicht über den Papierkorb, weil nichts darin steckt+- Entfernen (E69): Das geöffnete Modell lässt sich nicht entfernen (erst ein anderes öffnen). Sicherungen in `workspace-backups/` bleiben liegen, auch wenn ihr Modell entfernt ist- „An Agent geben“ fügt eine Zeile wie `[Auswahl: Bauteil "Lid", model.py Zeile 31, angeklickte Fläche: eben, …]` ein. Zahlen mit Punkt, damit der Agent sie eindeutig liest- `exports/` ist nicht in der `.gitignore` der Vorlage und zählt damit als Änderung, wenn der Agent `soma export` aufruft. Die App selbst schreibt seit E63 nicht mehr dorthin- Oberfläche nach E62: Beim ersten Start zeigt die Seitenleiste die Bauteile, danach die zuletzt gezeigte Ansicht. Der Code öffnet sich nicht von selbst beim Start. Hilfe und Optionen bleiben ausgegraut in der Leiste, „Pakete“ entfällt, bis es eine Paketliste gibt. Spalten-Schalter auch über Strg 1, 2, 3diff --git a/app/README.md b/app/README.mdindex c1581e2..a3b33e6 100644--- a/app/README.md+++ b/app/README.md@@ -17,7 +17,7 @@ npm start # baut und startetnpm run typechecknpm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md, Animationsdateien bauen nicht das Modell, Zwischenergebnisse nicht in Verlauf und ZIP auch in älteren Projekten, gilt der letzte Build noch, Build als Vorschau eines Commits (63 Prüfungen)npm run test:smoke # echte App, unsichtbar: Projekt, Viewer, Auswahl, Panels, Terminal, Übergabe an den Agenten, Markierung (Zeichnen, Linie, Raster, Auswählen, Verschieben, Drehen, Skalieren, Farben, Bild aus dem Dateibaum), Dateibaum (Markierungen, Menü, Anlegen, Umbenennen, Papierkorb), Auto-Build, Fehlerfall, Export, Ansichtswürfel und Drehpunkt (79 Prüfungen)-npm run test:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build (60 Prüfungen)+npm run test:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle, Öffnen ohne Neubau, Vorschau aus dem Build, Start auf der Startseite, unveränderte Modelle verschwinden, Entfernen (70 Prüfungen)npm run test:editor # Editor: Höhe und Scrollen, Speichern nur auf Wunsch mit genau einem Build (nur bei Python und inputs/), Änderungen des Agenten, Konflikte mit Sicherung, Nur lesen, CRLF, Rückfragen bei Modellwechsel und Reiter schließen, Markdown als Dokument (37 Prüfungen)npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebenen, zweier Bohrungen, zweier Punkte, Punkt zur Ebene, Verdecktes, neuer Build, Vorschau (21 Prüfungen)npm 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)